Skip to content

deprecation(#59): mark ImageProvider, ImageProviderConfig, IMAGE_MODELS as @deprecated#66

Merged
stackbilt-admin merged 1 commit into
mainfrom
feat/deprecate-imageprovider
May 7, 2026
Merged

deprecation(#59): mark ImageProvider, ImageProviderConfig, IMAGE_MODELS as @deprecated#66
stackbilt-admin merged 1 commit into
mainfrom
feat/deprecate-imageprovider

Conversation

@stackbilt-admin
Copy link
Copy Markdown
Member

Summary

  • Adds JSDoc @deprecated to ImageProvider, ImageProviderConfig, and IMAGE_MODELS in src/image/
  • Updates README: new "Deprecated APIs" section + updated features bullet + [Deprecated] marker in the utilities table
  • Bumps to v1.6.1 (patch — deprecation is not a breaking change)

img-forge is the org's canonical image generation service. ImageProvider is a frozen snapshot of img-forge internals extracted during an earlier coupling phase. As img-forge's model registry grows (FAL.ai, Replicate, Ideogram, Runway, Veo planned), ImageProvider will silently drift and mislead callers.

normalizeAiResponse is NOT deprecated — it has no non-image callers but is flagged for audit before Phase 2 removal.

Boundary going forward

Concern Owner
Text inference (completions, streaming, tool use) llm-providers
Vision understanding (image → text, via LLMImageInput) llm-providers
Image generation (txt2img, img2img, video) img-forge

Phase 2 (next major)

Remove src/image/ entirely. img-forge will import @stackbilt/llm-providers for intermediary text/vision inference; llm-providers should not depend on or duplicate img-forge's domain.

Note on versioning

This PR and #58 both branch from main at 1.6.0 and both claim 1.6.1. Whichever merges second should rebase and bump to 1.6.2.

Test plan

  • Existing tests pass (npm test)
  • TypeScript consumers of ImageProvider see deprecation warnings in their IDE
  • No exports removed — backward-compatible

🤖 Generated with Claude Code

…LS as @deprecated (v1.6.1)

img-forge is the org's canonical image generation service. ImageProvider
is a frozen snapshot of img-forge internals that will not track new models
or providers as img-forge's registry grows.

Phase 1 (this PR): JSDoc @deprecated on ImageProvider, ImageProviderConfig,
IMAGE_MODELS. Exports retained — no breaking change. normalizeAiResponse
left undeprecated pending Phase 2 audit.

Phase 2 (next major): remove src/image/ entirely.

Closes #59

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@stackbilt-admin stackbilt-admin force-pushed the feat/deprecate-imageprovider branch from 4a26b6d to a20ace1 Compare May 7, 2026 18:00
@stackbilt-admin stackbilt-admin merged commit 1dc45e0 into main May 7, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant