Define provider-neutral image capability contract and configuration #20

Closed
opened 2026-10-27 13:34:37 +00:00 by sam · 0 comments
Owner

Scope

Define the internal image-generation capability boundary used by hosted and local providers. Keep it narrow and provider-neutral: generation, editing with input images, prompt/options, output metadata, cancellation/timeouts, and capability discovery.

Add configuration and provider selection that fit the existing model/provider conventions. A missing credential or unavailable backend must make the capability unavailable with a useful user-facing error, not prevent Archie from starting or break text chat.

Acceptance criteria

  • Typed request/result/options contract covers the agreed gpt-image-2 baseline without baking in OpenAI types.
  • Provider registry/resolution and capability discovery are testable with fakes.
  • Hosted vs local selection is explicit and cannot silently incur cost.
  • Timeouts, maximum input/output sizes, cancellation, and error taxonomy are defined and tested.
  • Configuration validation rejects unsafe/ambiguous settings and preserves existing config behavior.

Close reason

Shipped docs/prds/image-capability-contract.md plus internal/domain/image (Provider contract, Registry — no Lifecycle, provider is call-scoped) and config.ImageConfig/validateImage. Provider-neutral, tested with fakes, hosted+local both gated by explicit enabled=true. Also linked all 7 orphaned epic children (found unlinked again, same pattern as the curator/memory epics).


Imported from beads archie-core-1786748942147-2-47cd5bd1 · GitHub #497 · type task · priority P2 · created 2026-08-14 · closed 2026-09-02

## Scope Define the internal image-generation capability boundary used by hosted and local providers. Keep it narrow and provider-neutral: generation, editing with input images, prompt/options, output metadata, cancellation/timeouts, and capability discovery. Add configuration and provider selection that fit the existing model/provider conventions. A missing credential or unavailable backend must make the capability unavailable with a useful user-facing error, not prevent Archie from starting or break text chat. ## Acceptance criteria - Typed request/result/options contract covers the agreed gpt-image-2 baseline without baking in OpenAI types. - Provider registry/resolution and capability discovery are testable with fakes. - Hosted vs local selection is explicit and cannot silently incur cost. - Timeouts, maximum input/output sizes, cancellation, and error taxonomy are defined and tested. - Configuration validation rejects unsafe/ambiguous settings and preserves existing config behavior. ### Close reason Shipped docs/prds/image-capability-contract.md plus internal/domain/image (Provider contract, Registry — no Lifecycle, provider is call-scoped) and config.ImageConfig/validateImage. Provider-neutral, tested with fakes, hosted+local both gated by explicit enabled=true. Also linked all 7 orphaned epic children (found unlinked again, same pattern as the curator/memory epics). --- _Imported from beads `archie-core-1786748942147-2-47cd5bd1` · GitHub #497 · type task · priority P2 · created 2026-08-14 · closed 2026-09-02_
sam added the mediumtask labels 2026-10-27 13:34:37 +00:00
sam self-assigned this 2026-10-27 13:34:37 +00:00
sam closed this issue 2026-10-27 13:34:37 +00:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: sam/archie#20