Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions .github/workflows/release.yml
Original file line number Diff line number Diff line change
Expand Up @@ -43,16 +43,16 @@ jobs:
run: |
set -euo pipefail
swift package --allow-writing-to-directory ./public generate-documentation \
--target ImagePlaygroundBridge \
--target IntelligenceBridge \
--disable-indexing \
--output-path ./public \
--transform-for-static-hosting \
--hosting-base-path image-playground-bridge
--hosting-base-path intelligence-bridge

cat > ./public/index.html <<'INDEX'
<!doctype html>
<meta http-equiv="refresh" content="0; url=/image-playground-bridge/documentation/imageplaygroundbridge/" />
<title>ImagePlaygroundBridge Documentation</title>
<meta http-equiv="refresh" content="0; url=/intelligence-bridge/documentation/intelligencebridge/" />
<title>IntelligenceBridge Documentation</title>
INDEX

- name: Upload Pages Artifact
Expand Down
11 changes: 6 additions & 5 deletions AGENTS.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
# ImagePlaygroundBridge
# IntelligenceBridge

## Context

ImagePlaygroundBridge integrates Apple's system-managed Image Playground experience. Read [README.md](README.md) and the DocC catalog before changing public behavior.
IntelligenceBridge provides focused integrations with Apple intelligence capabilities. Image Playground is its first capability; read [README.md](README.md) and the DocC catalog before changing public behavior.

Keep application persistence, host media storage, and product-specific UI outside the package. Limit main-actor isolation to framework presentation boundaries and keep portable values `Sendable`.

Expand Down Expand Up @@ -96,9 +96,9 @@ Replace these examples with exact repository paths:

| Role | Physical folder |
|---|---|
| Package sources | `Sources/ImagePlaygroundBridge/` |
| DocC catalog | `Sources/ImagePlaygroundBridge/ImagePlaygroundBridge.docc/` |
| Unit tests | `Tests/ImagePlaygroundBridgeTests/` |
| Package sources | `Sources/IntelligenceBridge/` |
| DocC catalog | `Sources/IntelligenceBridge/IntelligenceBridge.docc/` |
| Unit tests | `Tests/IntelligenceBridgeTests/` |

## Stack

Expand All @@ -109,6 +109,7 @@ Replace these examples with exact repository paths:

## Local specialization

- IntelligenceBridge's canonical logging emoji is 🧠, and its logging subsystem is `com.thatfactory.intelligencebridge`.
- Use Apple Image Playground APIs only on their supported platforms and preserve runtime capability checks.
- Do not introduce headless generation, persistence, or provider abstractions without a concrete consumer requirement.

Expand Down

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

7 changes: 7 additions & 0 deletions AgentGuidelines/CHANGELOG.md

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

4 changes: 4 additions & 0 deletions AgentGuidelines/Guidelines/Packages.md

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

4 changes: 2 additions & 2 deletions AgentGuidelines/README.md

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

12 changes: 12 additions & 0 deletions AgentGuidelines/Scripts/validate_guidelines.swift

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

38 changes: 38 additions & 0 deletions AgentGuidelines/Tests/run_tests.swift

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion AgentGuidelines/VERSION

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

11 changes: 8 additions & 3 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,12 @@
# Changelog

All notable changes to ImagePlaygroundBridge are documented here.
All notable changes to IntelligenceBridge are documented here.

## Unreleased

### Changed

- Rename the package, product, module, documentation, repository-facing links, logging subsystem, and canonical emoji to IntelligenceBridge 🧠 while preserving the Image Playground-specific public API.

## 0.1.1 — 2026-09-19

Expand All @@ -10,8 +16,7 @@ All notable changes to ImagePlaygroundBridge are documented here.
- Declared Swift 6, warnings as errors, and the required upcoming language features for every package target.
- Made imports and existential types explicit where required by the stricter compiler policy without intentionally changing runtime behavior.


## Unreleased
## 0.1.0 — 2026-09-19

### Changed

Expand Down
12 changes: 6 additions & 6 deletions Package.swift
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ let strictSwiftSettings: [SwiftSetting] = [
]

let package = Package(
name: "ImagePlaygroundBridge",
name: "IntelligenceBridge",
platforms: [
.iOS(.v26),
.macOS(.v26),
Expand All @@ -21,8 +21,8 @@ let package = Package(
],
products: [
.library(
name: "ImagePlaygroundBridge",
targets: ["ImagePlaygroundBridge"]
name: "IntelligenceBridge",
targets: ["IntelligenceBridge"]
)
],
dependencies: [
Expand All @@ -31,14 +31,14 @@ let package = Package(
],
targets: [
.target(
name: "ImagePlaygroundBridge",
name: "IntelligenceBridge",
dependencies: [
.product(name: "AppLogger", package: "applogger")
]
),
.testTarget(
name: "ImagePlaygroundBridgeTests",
dependencies: ["ImagePlaygroundBridge"]
name: "IntelligenceBridgeTests",
dependencies: ["IntelligenceBridge"]
),
]
)
Expand Down
16 changes: 10 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,17 +3,21 @@
<a href="https://developer.apple.com/xcode/"><img alt="Xcode Version" src="https://img.shields.io/badge/Xcode-27-50ace8.svg?logo=xcode&logoColor=white"></a>
<a href="https://developer.apple.com/documentation/imageplayground"><img alt="Platforms" src="https://img.shields.io/badge/iOS%20%7C%20macOS%20%7C%20visionOS-26%2B-lightgrey.svg?logo=apple&logoColor=white"></a>
<a href="https://developer.apple.com/documentation/xcode/swift-packages"><img alt="SPM" src="https://img.shields.io/badge/SPM-ready-b68f6a.svg?logo=gitlfs&logoColor=white"></a>
<a href="https://thatfactory.github.io/image-playground-bridge/documentation/imageplaygroundbridge/"><img alt="DocC" src="https://img.shields.io/badge/DocC-documentation-0288D1.svg?logo=bookstack&logoColor=white"></a>
<a href="https://thatfactory.github.io/intelligence-bridge/documentation/intelligencebridge/"><img alt="DocC" src="https://img.shields.io/badge/DocC-documentation-0288D1.svg?logo=bookstack&logoColor=white"></a>
<a href="https://en.wikipedia.org/wiki/MIT_License"><img alt="License" src="https://img.shields.io/badge/License-MIT-67ac5b.svg?logo=googledocs&logoColor=white"></a>
<a href="https://github.com/thatfactory/image-playground-bridge/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/thatfactory/image-playground-bridge/actions/workflows/ci.yml/badge.svg"></a>
<a href="https://github.com/thatfactory/image-playground-bridge/actions/workflows/release.yml"><img alt="Release" src="https://github.com/thatfactory/image-playground-bridge/actions/workflows/release.yml/badge.svg"></a>
<a href="https://github.com/thatfactory/intelligence-bridge/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/thatfactory/intelligence-bridge/actions/workflows/ci.yml/badge.svg"></a>
<a href="https://github.com/thatfactory/intelligence-bridge/actions/workflows/release.yml"><img alt="Release" src="https://github.com/thatfactory/intelligence-bridge/actions/workflows/release.yml/badge.svg"></a>
</p>

# ImagePlaygroundBridge
# IntelligenceBridge

ImagePlaygroundBridge is a reusable Apple-platform integration layer for the system-managed Image Playground experience. It centralizes availability checks, concept setup, SwiftUI presentation wiring, cancellation, and temporary result handling while leaving persistence to the host application.
IntelligenceBridge is a focused Apple-platform integration layer for Apple intelligence capabilities such as Image Playground. It makes platform availability, framework integration, and presentation seams consistent without hiding Apple's frameworks or taking ownership of product prompts and persistence. 🧠

Image Playground is the package's first capability. Its existing API centralizes availability checks, concept setup, SwiftUI presentation wiring, cancellation, and temporary result handling while leaving generated-media persistence to the host application.

```swift
import IntelligenceBridge

let request = ImagePlaygroundBridgeRequest(concepts: [.text("a small red house")])

content
Expand All @@ -30,7 +34,7 @@ The presentation API is available on Apple platforms that support Image Playgrou

## Documentation

API documentation is published with DocC after a GitHub release. See the [ImagePlaygroundBridge documentation](https://thatfactory.github.io/image-playground-bridge/documentation/imageplaygroundbridge/).
API documentation is published with DocC after a GitHub release. See the [IntelligenceBridge documentation](https://thatfactory.github.io/intelligence-bridge/documentation/intelligencebridge/).

## Requirements

Expand Down
Loading