@cogenta/agents 0.1.1 → 0.2.0

package/dist/index.d.ts

@@ -2,6 +2,21 @@ export { defineAgent } from './agents/define.js';
 export type { AgentRegistry } from './agents/registry.js';
 export { createAgentRegistry } from './agents/registry.js';
 export type { AgentDeclaration, AgentMemoryConfig, AgentModelPreference, AgentTrigger, } from './agents/types.js';
+export type { ChatSource, ContentChatAnswer, ContentChatOptions } from './assist/chat.js';
+export { createContentChatTool } from './assist/chat.js';
+export type { ClassificationResult, DuplicateReport, DuplicateToolOptions, ModerationVerdict, } from './assist/classify.js';
+export { createClassifyTool, createFindDuplicatesTool, createModerateTool, MODERATION_SEVERITIES, RECOMMENDED_ACTIONS, } from './assist/classify.js';
+export type { FaqDraft, SchemaDraft, SchemaType } from './assist/faq.js';
+export { createFaqTool, createSchemaOrgTool, SCHEMA_TYPES } from './assist/faq.js';
+export type { GenerateImageResult } from './assist/images.js';
+export { createGenerateImageTool } from './assist/images.js';
+export type { AssistAgent, AssistRequest, AssistRuntime, AssistRuntimeOptions, } from './assist/runtime.js';
+export { createAssistRuntime, extractJson } from './assist/runtime.js';
+export type { Suggestion } from './assist/suggestion.js';
+export { SuggestionSchema, suggestion } from './assist/suggestion.js';
+export type { AssistCapability, AssistToolset, AssistToolsetOptions, } from './assist/toolset.js';
+export { createAssistToolset, describeCapabilities } from './assist/toolset.js';
+export { createAltTextTool, createMetaDescriptionTool, createProofreadTool, createRewriteTool, createSummariseTool, createTagsTool, createTitleTool, createTranslateTool, createWritingTools, } from './assist/writing.js';
 export type { AuditLogLike, AuditRecordInput } from './audit/types.js';
 export type { WithAuditOptions } from './audit/with-audit.js';
 export { withAudit, withAuditForManifest } from './audit/with-audit.js';
@@ -15,6 +30,10 @@ export { createKillSwitch } from './budget/kill-switch.js';
 export type { BudgetTrackerOptions } from './budget/tracker.js';
 export { createBudgetTracker } from './budget/tracker.js';
 export type { BudgetCheck, BudgetExceededReason, BudgetLimits, BudgetTracker, BudgetUsage, KillSwitch, } from './budget/types.js';
+export type { DocumentFormat, ExtractDocumentInput, ExtractedDocument, } from './documents/extract-text.js';
+export { DOCUMENT_FORMATS, extractDocumentText, MAX_DOCUMENT_BYTES, MAX_TEXT_CHARACTERS, } from './documents/extract-text.js';
+export type { DocumentExtractInput, DocumentExtractOutput, } from './documents/extract-tool.js';
+export { createDocumentExtractTool } from './documents/extract-tool.js';
 export type { EvalThresholdOptions } from './eval/assert-threshold.js';
 export { assertEvalThreshold } from './eval/assert-threshold.js';
 export type { PromptComparisonResult, PromptVersion } from './eval/compare-prompt-versions.js';
@@ -38,6 +57,14 @@ export type { AnthropicClientConfig, AnthropicRequestBody } from './providers/an
 export { buildAnthropicRequest, createAnthropicClient, parseAnthropicResponse, } from './providers/anthropic.js';
 export type { GoogleClientConfig, GoogleRequestBody } from './providers/google.js';
 export { buildGoogleRequest, createGoogleClient, parseGoogleResponse } from './providers/google.js';
+export type { OpenAiImageClientConfig, OpenAiImageRequestBody } from './providers/image/openai.js';
+export { buildOpenAiImageRequest, createOpenAiImageClient, parseOpenAiImageResponse, } from './providers/image/openai.js';
+export type { ImageProviderName, ImageProviderRegistry, ImageProviderRegistryConfig, } from './providers/image/registry.js';
+export { createImageProviderRegistry, IMAGE_PROVIDER_NAMES, } from './providers/image/registry.js';
+export type { StabilityImageClientConfig, StabilityRequestBody, } from './providers/image/stability.js';
+export { buildStabilityRequest, createStabilityImageClient, parseStabilityResponse, } from './providers/image/stability.js';
+export type { GeneratedImage, ImageGenerationOptions, ImageProviderClient, ImageRequest, ImageSize, } from './providers/image/types.js';
+export { clampCount, IMAGE_DIMENSIONS, IMAGE_SIZES } from './providers/image/types.js';
 export type { OpenAiClientConfig, OpenAiRequestBody } from './providers/openai.js';
 export { buildOpenAiRequest, createOpenAiClient, parseOpenAiResponse } from './providers/openai.js';
 export type { ProviderName, ProviderRegistryConfig } from './providers/registry.js';
@@ -54,6 +81,10 @@ export { createMemoryRagIndex } from './rag/index/memory-index.js';
 export { reciprocalRankFusion } from './rag/index/rrf.js';
 export type { HybridSearchOptions, HybridSearchQuery, HybridSearchResult, IndexedChunk, RagIndex, RankedId, } from './rag/index/types.js';
 export { vectorRank } from './rag/index/vector-rank.js';
+export type { FullTextSearchLike, SemanticHit, SemanticSearch, SemanticSearchOptions, SemanticSearchQuery, } from './rag/semantic/search.js';
+export { createSemanticSearch } from './rag/semantic/search.js';
+export type { FileVectorOptions, PgVectorDriverOptions, PgVectorOptions, VectorConfig, VectorFilter, VectorMatch, VectorRecord, VectorRegistryOptions, VectorScope, VectorSearchOptions, VectorStore, } from './rag/vector/index.js';
+export { createFileVectorStore, createMemoryVectorStore, createPgVectorStore, createVectorRegistry, fileVectorDriver, matchesFilter, memoryVectorDriver, pgVectorDriver, VECTOR_DEFAULTS, vectorLiteral, } from './rag/vector/index.js';
 export type { DiffChangeKind, DiffEntry } from './reversibility/diff.js';
 export { diffValues } from './reversibility/diff.js';
 export { createMemoryReceiptStore } from './reversibility/receipt-store.js';
@@ -69,6 +100,25 @@ export type { ExecutableTool, RunAgentLoopInput, RunResult, RunStopReason, StepR
 export type { SandboxCallResult } from './sandbox/types.js';
 export type { WithSandboxOptions } from './sandbox/with-sandbox.js';
 export { withSandbox, withSandboxForManifest } from './sandbox/with-sandbox.js';
+export type { AnalyseBriefOptions, AnalyseBriefResult } from './site-plan/analyse-brief.js';
+export { analyseBrief } from './site-plan/analyse-brief.js';
+export type { ApprovedPlan, PlanDecisions, PlanItem, PlanItemDecision, PlanSection, PlanSectionId, } from './site-plan/approval.js';
+export { PLAN_SECTIONS, resolveApprovedPlan, summarisePlan } from './site-plan/approval.js';
+export type { ConstraintKind, ConstraintTopic, DetectConstraintsInput, DetectedConstraint, } from './site-plan/constraints.js';
+export { CONSTRAINT_KINDS, CONSTRAINT_TOPICS, detectConstraints } from './site-plan/constraints.js';
+export type { ProposeContentModelOptions, ProposeContentModelResult, } from './site-plan/content-model.js';
+export { proposeContentModel } from './site-plan/content-model.js';
+export type { DemoContentRejection, ProposeDemoContentOptions, ProposeDemoContentResult, } from './site-plan/demo-content.js';
+export { proposeDemoContent } from './site-plan/demo-content.js';
+export type { SitePlanStore, StoredSitePlan } from './site-plan/draft-store.js';
+export { createFileSitePlanStore, createMemorySitePlanStore, } from './site-plan/draft-store.js';
+export type { EnforcementResult } from './site-plan/enforce.js';
+export { enforceOnContentModel, enforceOnLanguages, enforceOnPages, } from './site-plan/enforce.js';
+export type { PlanStage, ProposeSitePlanOptions, ProposeSitePlanResult, } from './site-plan/propose-plan.js';
+export { proposeSitePlan } from './site-plan/propose-plan.js';
+export type { GenerateSkinCandidatesOptions, GenerateSkinCandidatesResult, SkinCandidateFailure, SkinDirection, } from './site-plan/skin-candidates.js';
+export { generateSkinCandidates, MAX_SKIN_CANDIDATES, MIN_SKIN_CANDIDATES, SKIN_DIRECTIONS, } from './site-plan/skin-candidates.js';
+export type { BriefContentType, BriefPage, BriefSource, ConstraintViolation, ContentModelProposal, DemoEntry, ProposedCollection, ProposedPage, SiteBrief, SitePlanDraft, SkinCandidate, } from './site-plan/types.js';
 export { createFileSkillStore } from './skills/file-store.js';
 export { parseSkillFile } from './skills/frontmatter.js';
 export type { Skill, SkillMetadata, SkillStore } from './skills/types.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC1D,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,YAAY,GACb,MAAM,mBAAmB,CAAA;AAC1B,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACtE,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAC7D,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AACvE,YAAY,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAA;AAC9E,OAAO,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAA;AACxE,YAAY,EACV,aAAa,EACb,eAAe,EACf,oBAAoB,EACpB,cAAc,EACd,cAAc,EACd,aAAa,GACd,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AACtE,OAAO,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAA;AACnF,YAAY,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC1D,YAAY,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AACzD,YAAY,EACV,WAAW,EACX,oBAAoB,EACpB,YAAY,EACZ,aAAa,EACb,WAAW,EACX,UAAU,GACX,MAAM,mBAAmB,CAAA;AAC1B,YAAY,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAChE,YAAY,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAA;AAC9F,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAA;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAC9F,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAA;AAC9D,YAAY,EACV,aAAa,EACb,oBAAoB,EACpB,gBAAgB,EAChB,QAAQ,EACR,WAAW,EACX,WAAW,GACZ,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AAC9D,YAAY,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAA;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAA;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAC5D,YAAY,EACV,sBAAsB,EACtB,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,WAAW,EACX,UAAU,GACX,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAA;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AACrD,YAAY,EAAE,kBAAkB,EAAE,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAChG,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAA;AAC3F,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,0BAA0B,CAAA;AACjC,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAClF,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AACnG,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAClF,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AACnG,YAAY,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAA;AACnF,OAAO,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAChF,YAAY,EACV,WAAW,EACX,WAAW,EACX,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,EACV,UAAU,GACX,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAA;AAChE,YAAY,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AAClE,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAA;AACxE,YAAY,EAAE,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AACvF,OAAO,EAAE,8BAA8B,EAAE,MAAM,sCAAsC,CAAA;AACrF,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AACtF,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AACzD,YAAY,EACV,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,EACZ,QAAQ,EACR,QAAQ,GACT,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAA;AACvD,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AACxE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AACpD,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAA;AAC3E,YAAY,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AACzD,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AACnF,YAAY,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAA;AAC3E,OAAO,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAA;AACxF,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AACzD,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChE,YAAY,EACV,cAAc,EACd,iBAAiB,EACjB,SAAS,EACT,aAAa,EACb,UAAU,EACV,eAAe,EACf,oBAAoB,GACrB,MAAM,oBAAoB,CAAA;AAC3B,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,YAAY,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AACnE,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAA;AAC/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AACxD,YAAY,EAAE,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AACzE,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AACzD,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AAC/D,YAAY,EACV,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,gCAAgC,CAAA;AACvC,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAA;AACxE,YAAY,EACV,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,yBAAyB,CAAA;AAChC,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,qBAAqB,EACrB,2BAA2B,GAC5B,MAAM,yBAAyB,CAAA;AAChC,YAAY,EACV,cAAc,EACd,eAAe,EACf,oBAAoB,GACrB,MAAM,4BAA4B,CAAA;AACnC,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAChE,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AACjF,YAAY,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAA;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AACxD,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AACzF,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAA;AAChE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,10 +1,20 @@
 export { defineAgent } from './agents/define.js';
 export { createAgentRegistry } from './agents/registry.js';
+export { createContentChatTool } from './assist/chat.js';
+export { createClassifyTool, createFindDuplicatesTool, createModerateTool, MODERATION_SEVERITIES, RECOMMENDED_ACTIONS, } from './assist/classify.js';
+export { createFaqTool, createSchemaOrgTool, SCHEMA_TYPES } from './assist/faq.js';
+export { createGenerateImageTool } from './assist/images.js';
+export { createAssistRuntime, extractJson } from './assist/runtime.js';
+export { SuggestionSchema, suggestion } from './assist/suggestion.js';
+export { createAssistToolset, describeCapabilities } from './assist/toolset.js';
+export { createAltTextTool, createMetaDescriptionTool, createProofreadTool, createRewriteTool, createSummariseTool, createTagsTool, createTitleTool, createTranslateTool, createWritingTools, } from './assist/writing.js';
 export { withAudit, withAuditForManifest } from './audit/with-audit.js';
 export { createMemoryApprovalQueue } from './autonomy/approval-queue.js';
 export { withAutonomy, withAutonomyForManifest } from './autonomy/with-autonomy.js';
 export { createKillSwitch } from './budget/kill-switch.js';
 export { createBudgetTracker } from './budget/tracker.js';
+export { DOCUMENT_FORMATS, extractDocumentText, MAX_DOCUMENT_BYTES, MAX_TEXT_CHARACTERS, } from './documents/extract-text.js';
+export { createDocumentExtractTool } from './documents/extract-tool.js';
 export { assertEvalThreshold } from './eval/assert-threshold.js';
 export { comparePromptVersions } from './eval/compare-prompt-versions.js';
 export { runEvalSuite } from './eval/run-suite.js';
@@ -19,6 +29,10 @@ export { redactFields } from './privacy/redact-fields.js';
 export { redactText } from './privacy/redact-text.js';
 export { buildAnthropicRequest, createAnthropicClient, parseAnthropicResponse, } from './providers/anthropic.js';
 export { buildGoogleRequest, createGoogleClient, parseGoogleResponse } from './providers/google.js';
+export { buildOpenAiImageRequest, createOpenAiImageClient, parseOpenAiImageResponse, } from './providers/image/openai.js';
+export { createImageProviderRegistry, IMAGE_PROVIDER_NAMES, } from './providers/image/registry.js';
+export { buildStabilityRequest, createStabilityImageClient, parseStabilityResponse, } from './providers/image/stability.js';
+export { clampCount, IMAGE_DIMENSIONS, IMAGE_SIZES } from './providers/image/types.js';
 export { buildOpenAiRequest, createOpenAiClient, parseOpenAiResponse } from './providers/openai.js';
 export { createProviderRegistry, PROVIDER_NAMES } from './providers/registry.js';
 export { chunkDocument } from './rag/chunking/chunk-document.js';
@@ -28,6 +42,8 @@ export { bm25Rank } from './rag/index/bm25.js';
 export { createMemoryRagIndex } from './rag/index/memory-index.js';
 export { reciprocalRankFusion } from './rag/index/rrf.js';
 export { vectorRank } from './rag/index/vector-rank.js';
+export { createSemanticSearch } from './rag/semantic/search.js';
+export { createFileVectorStore, createMemoryVectorStore, createPgVectorStore, createVectorRegistry, fileVectorDriver, matchesFilter, memoryVectorDriver, pgVectorDriver, VECTOR_DEFAULTS, vectorLiteral, } from './rag/vector/index.js';
 export { diffValues } from './reversibility/diff.js';
 export { createMemoryReceiptStore } from './reversibility/receipt-store.js';
 export { revertReceipt } from './reversibility/revert.js';
@@ -36,6 +52,15 @@ export { runAgentLoop } from './runtime/loop.js';
 export { RepetitionGuard } from './runtime/repetition.js';
 export { retryModelCall, withTimeout } from './runtime/retry.js';
 export { withSandbox, withSandboxForManifest } from './sandbox/with-sandbox.js';
+export { analyseBrief } from './site-plan/analyse-brief.js';
+export { PLAN_SECTIONS, resolveApprovedPlan, summarisePlan } from './site-plan/approval.js';
+export { CONSTRAINT_KINDS, CONSTRAINT_TOPICS, detectConstraints } from './site-plan/constraints.js';
+export { proposeContentModel } from './site-plan/content-model.js';
+export { proposeDemoContent } from './site-plan/demo-content.js';
+export { createFileSitePlanStore, createMemorySitePlanStore, } from './site-plan/draft-store.js';
+export { enforceOnContentModel, enforceOnLanguages, enforceOnPages, } from './site-plan/enforce.js';
+export { proposeSitePlan } from './site-plan/propose-plan.js';
+export { generateSkinCandidates, MAX_SKIN_CANDIDATES, MIN_SKIN_CANDIDATES, SKIN_DIRECTIONS, } from './site-plan/skin-candidates.js';
 export { createFileSkillStore } from './skills/file-store.js';
 export { parseSkillFile } from './skills/frontmatter.js';
 export { generateSkin } from './skin/generate.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/providers/image/openai.d.ts

@@ -0,0 +1,28 @@
+import { type GeneratedImage, type ImageProviderClient, type ImageRequest } from './types.js';
+export interface OpenAiImageRequestBody {
+    readonly model: string;
+    readonly prompt: string;
+    readonly n: number;
+    readonly size: string;
+    readonly response_format: 'b64_json';
+}
+interface OpenAiImageResponseBody {
+    readonly data?: readonly {
+        readonly b64_json?: string;
+        readonly revised_prompt?: string;
+    }[];
+}
+/** Pure — no network. Exported so the wire shape is testable without a key. */
+export declare function buildOpenAiImageRequest(model: string, request: ImageRequest): OpenAiImageRequestBody;
+/** Pure — no network. */
+export declare function parseOpenAiImageResponse(body: OpenAiImageResponseBody): readonly GeneratedImage[];
+export interface OpenAiImageClientConfig {
+    readonly apiKey: string;
+    readonly model: string;
+    readonly baseUrl?: string;
+    readonly fetchImpl?: typeof fetch;
+}
+/** API key injected at the runtime boundary — never in a prompt or a tool input (R7). */
+export declare function createOpenAiImageClient(config: OpenAiImageClientConfig): ImageProviderClient;
+export {};
+//# sourceMappingURL=openai.d.ts.map

package/dist/providers/image/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../../src/providers/image/openai.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,cAAc,EAGnB,KAAK,mBAAmB,EACxB,KAAK,YAAY,EAClB,MAAM,YAAY,CAAA;AAInB,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,eAAe,EAAE,UAAU,CAAA;CACrC;AAED,UAAU,uBAAuB;IAC/B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS;QACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;QAC1B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KACjC,EAAE,CAAA;CACJ;AAED,+EAA+E;AAC/E,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,YAAY,GACpB,sBAAsB,CASxB;AAED,yBAAyB;AACzB,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,uBAAuB,GAAG,SAAS,cAAc,EAAE,CAmBjG;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;CAClC;AAED,yFAAyF;AACzF,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,uBAAuB,GAAG,mBAAmB,CA4C5F"}

package/dist/providers/image/openai.js

@@ -0,0 +1,80 @@
+import { CogentaError } from '@cogenta/core';
+import { clampCount, IMAGE_DIMENSIONS, } from './types.js';
+const DEFAULT_BASE_URL = 'https://api.openai.com/v1/images/generations';
+/** Pure — no network. Exported so the wire shape is testable without a key. */
+export function buildOpenAiImageRequest(model, request) {
+    const { width, height } = IMAGE_DIMENSIONS[request.size ?? 'square'];
+    return {
+        model,
+        prompt: request.prompt,
+        n: clampCount(request.count),
+        size: `${width}x${height}`,
+        response_format: 'b64_json',
+    };
+}
+/** Pure — no network. */
+export function parseOpenAiImageResponse(body) {
+    const entries = body.data ?? [];
+    const images = [];
+    for (const entry of entries) {
+        if (entry.b64_json === undefined || entry.b64_json.length === 0)
+            continue;
+        images.push({
+            contentType: 'image/png',
+            base64: entry.b64_json,
+            ...(entry.revised_prompt === undefined ? {} : { revisedPrompt: entry.revised_prompt }),
+        });
+    }
+    if (images.length === 0) {
+        throw new CogentaError({
+            code: 'PROVIDER_RESPONSE_INVALID',
+            message: 'OpenAI returned no image data.',
+            hint: 'Retry the request; this is not something the caller can fix by rewording alone.',
+        });
+    }
+    return images;
+}
+/** API key injected at the runtime boundary — never in a prompt or a tool input (R7). */
+export function createOpenAiImageClient(config) {
+    const doFetch = config.fetchImpl ?? fetch;
+    const url = config.baseUrl ?? DEFAULT_BASE_URL;
+    return {
+        name: 'openai',
+        model: config.model,
+        async generate(request, options) {
+            const response = await doFetch(url, {
+                method: 'POST',
+                headers: {
+                    'content-type': 'application/json',
+                    authorization: `Bearer ${config.apiKey}`,
+                },
+                body: JSON.stringify(buildOpenAiImageRequest(config.model, request)),
+                ...(options?.signal === undefined ? {} : { signal: options.signal }),
+            }).catch((cause) => {
+                throw new CogentaError({
+                    code: 'PROVIDER_REQUEST_FAILED',
+                    message: 'The image request to OpenAI could not be sent.',
+                    hint: 'Check network connectivity and COGENTA_OPENAI_API_KEY.',
+                    cause,
+                });
+            });
+            if (response.status === 429) {
+                throw new CogentaError({
+                    code: 'PROVIDER_RATE_LIMITED',
+                    message: 'OpenAI rate-limited this image request.',
+                    hint: 'Wait and try again — image generation is rate-limited far more tightly than text.',
+                });
+            }
+            if (!response.ok) {
+                throw new CogentaError({
+                    code: 'PROVIDER_REQUEST_FAILED',
+                    message: `OpenAI returned status ${response.status} for an image request.`,
+                    hint: 'Check the prompt and COGENTA_OPENAI_API_KEY. A refused prompt is reported this way too.',
+                    details: { status: response.status },
+                });
+            }
+            return parseOpenAiImageResponse((await response.json()));
+        },
+    };
+}
+//# sourceMappingURL=openai.js.map

package/dist/providers/image/openai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.js","sourceRoot":"","sources":["../../../src/providers/image/openai.ts"],"names":[],"mappings":"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"}

package/dist/providers/image/registry.d.ts

@@ -0,0 +1,30 @@
+import type { ImageProviderClient } from './types.js';
+export declare const IMAGE_PROVIDER_NAMES: readonly ['openai', 'stability'];
+export type ImageProviderName = (typeof IMAGE_PROVIDER_NAMES)[number];
+export interface ImageProviderRegistryConfig {
+    readonly openai?: {
+        readonly apiKey: string;
+        readonly model: string;
+        readonly baseUrl?: string;
+    };
+    readonly stability?: {
+        readonly apiKey: string;
+        readonly model: string;
+        readonly baseUrl?: string;
+    };
+}
+export interface ImageProviderRegistry {
+    readonly names: readonly ImageProviderName[];
+    readonly has: (name: ImageProviderName) => boolean;
+    readonly get: (name: ImageProviderName) => ImageProviderClient;
+    /** The first configured provider, or `null` for a site that configured none. */
+    readonly first: () => ImageProviderClient | null;
+}
+/**
+ * One client per configured vendor, exactly as `createProviderRegistry` does for
+ * text. A site with no image vendor gets an empty registry: nothing here fails
+ * to construct, `first()` answers `null`, and the image tool is simply never
+ * built (R2).
+ */
+export declare function createImageProviderRegistry(config: ImageProviderRegistryConfig): ImageProviderRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/providers/image/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/providers/image/registry.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAErD,eAAO,MAAM,oBAAoB,YAAI,QAAQ,EAAE,WAAW,CAAU,CAAA;AACpE,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAA;AAErE,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAChG,QAAQ,CAAC,SAAS,CAAC,EAAE;QACnB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;QACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;QACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAC1B,CAAA;CACF;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,EAAE,SAAS,iBAAiB,EAAE,CAAA;IAC5C,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,OAAO,CAAA;IAClD,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,mBAAmB,CAAA;IAC9D,gFAAgF;IAChF,QAAQ,CAAC,KAAK,EAAE,MAAM,mBAAmB,GAAG,IAAI,CAAA;CACjD;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,2BAA2B,GAClC,qBAAqB,CAyBvB"}

package/dist/providers/image/registry.js

@@ -0,0 +1,36 @@
+import { CogentaError } from '@cogenta/core';
+import { createOpenAiImageClient } from './openai.js';
+import { createStabilityImageClient } from './stability.js';
+export const IMAGE_PROVIDER_NAMES = ['openai', 'stability'];
+/**
+ * One client per configured vendor, exactly as `createProviderRegistry` does for
+ * text. A site with no image vendor gets an empty registry: nothing here fails
+ * to construct, `first()` answers `null`, and the image tool is simply never
+ * built (R2).
+ */
+export function createImageProviderRegistry(config) {
+    const clients = new Map();
+    if (config.openai !== undefined) {
+        clients.set('openai', createOpenAiImageClient(config.openai));
+    }
+    if (config.stability !== undefined) {
+        clients.set('stability', createStabilityImageClient(config.stability));
+    }
+    return {
+        names: [...clients.keys()],
+        has: (name) => clients.has(name),
+        first: () => [...clients.values()][0] ?? null,
+        get(name) {
+            const client = clients.get(name);
+            if (client === undefined) {
+                throw new CogentaError({
+                    code: 'PROVIDER_UNKNOWN',
+                    message: `No image provider named "${name}" is configured for this site.`,
+                    hint: 'Set the matching API key in the environment, or choose a configured provider.',
+                });
+            }
+            return client;
+        },
+    };
+}
+//# sourceMappingURL=registry.js.map

package/dist/providers/image/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/providers/image/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAC5C,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AACrD,OAAO,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAA;AAG3D,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,QAAQ,EAAE,WAAW,CAAU,CAAA;AAoBpE;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CACzC,MAAmC;IAEnC,MAAM,OAAO,GAAG,IAAI,GAAG,EAA0C,CAAA;IACjE,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,uBAAuB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAA;IAC/D,CAAC;IACD,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,0BAA0B,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAA;IACxE,CAAC;IAED,OAAO;QACL,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAC1B,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;QAChC,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI;QAC7C,GAAG,CAAC,IAAI;YACN,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;YAChC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,MAAM,IAAI,YAAY,CAAC;oBACrB,IAAI,EAAE,kBAAkB;oBACxB,OAAO,EAAE,4BAA4B,IAAI,gCAAgC;oBACzE,IAAI,EAAE,+EAA+E;iBACtF,CAAC,CAAA;YACJ,CAAC;YACD,OAAO,MAAM,CAAA;QACf,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/providers/image/stability.d.ts

@@ -0,0 +1,39 @@
+import { type GeneratedImage, type ImageProviderClient, type ImageRequest } from './types.js';
+export interface StabilityRequestBody {
+    readonly text_prompts: readonly {
+        readonly text: string;
+        readonly weight: number;
+    }[];
+    readonly width: number;
+    readonly height: number;
+    readonly samples: number;
+}
+interface StabilityResponseBody {
+    readonly artifacts?: readonly {
+        readonly base64?: string;
+        readonly finishReason?: string;
+    }[];
+}
+/**
+ * The second implementation the lot asks for by name — "plusieurs
+ * implémentations, jamais un seul fournisseur en dur".
+ *
+ * Stability's v1 text-to-image endpoint rather than v2beta on purpose: v1 speaks
+ * JSON in both directions, v2beta wants `multipart/form-data` and answers with
+ * raw bytes, and picking the JSON one keeps the adapter free of a form-encoding
+ * dependency for no gain in what Cogenta actually needs (R9).
+ */
+/** Pure — no network. */
+export declare function buildStabilityRequest(request: ImageRequest): StabilityRequestBody;
+/** Pure — no network. */
+export declare function parseStabilityResponse(body: StabilityResponseBody): readonly GeneratedImage[];
+export interface StabilityImageClientConfig {
+    readonly apiKey: string;
+    /** The engine id, e.g. `stable-diffusion-xl-1024-v1-0`. */
+    readonly model: string;
+    readonly baseUrl?: string;
+    readonly fetchImpl?: typeof fetch;
+}
+export declare function createStabilityImageClient(config: StabilityImageClientConfig): ImageProviderClient;
+export {};
+//# sourceMappingURL=stability.d.ts.map

package/dist/providers/image/stability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stability.d.ts","sourceRoot":"","sources":["../../../src/providers/image/stability.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,cAAc,EAGnB,KAAK,mBAAmB,EACxB,KAAK,YAAY,EAClB,MAAM,YAAY,CAAA;AAInB,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,YAAY,EAAE,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IACpF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS;QAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;QACxB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAC/B,EAAE,CAAA;CACJ;AAED;;;;;;;;GAQG;AAEH,yBAAyB;AACzB,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,YAAY,GAAG,oBAAoB,CAQjF;AAED,yBAAyB;AACzB,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,qBAAqB,GAAG,SAAS,cAAc,EAAE,CAkB7F;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;CAClC;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,0BAA0B,GACjC,mBAAmB,CA6CrB"}

package/dist/providers/image/stability.js

@@ -0,0 +1,88 @@
+import { CogentaError } from '@cogenta/core';
+import { clampCount, IMAGE_DIMENSIONS, } from './types.js';
+const DEFAULT_BASE_URL = 'https://api.stability.ai/v1/generation';
+/**
+ * The second implementation the lot asks for by name — "plusieurs
+ * implémentations, jamais un seul fournisseur en dur".
+ *
+ * Stability's v1 text-to-image endpoint rather than v2beta on purpose: v1 speaks
+ * JSON in both directions, v2beta wants `multipart/form-data` and answers with
+ * raw bytes, and picking the JSON one keeps the adapter free of a form-encoding
+ * dependency for no gain in what Cogenta actually needs (R9).
+ */
+/** Pure — no network. */
+export function buildStabilityRequest(request) {
+    const { width, height } = IMAGE_DIMENSIONS[request.size ?? 'square'];
+    return {
+        text_prompts: [{ text: request.prompt, weight: 1 }],
+        width,
+        height,
+        samples: clampCount(request.count),
+    };
+}
+/** Pure — no network. */
+export function parseStabilityResponse(body) {
+    const images = [];
+    for (const artifact of body.artifacts ?? []) {
+        // `CONTENT_FILTERED` comes back as an artifact with a blank or black image.
+        // Dropping it is more honest than showing an editor a black square and
+        // letting them wonder what went wrong.
+        if (artifact.finishReason === 'CONTENT_FILTERED')
+            continue;
+        if (artifact.base64 === undefined || artifact.base64.length === 0)
+            continue;
+        images.push({ contentType: 'image/png', base64: artifact.base64 });
+    }
+    if (images.length === 0) {
+        throw new CogentaError({
+            code: 'PROVIDER_RESPONSE_INVALID',
+            message: 'Stability returned no usable image.',
+            hint: 'Every candidate was filtered or empty. Reword the prompt and try again.',
+        });
+    }
+    return images;
+}
+export function createStabilityImageClient(config) {
+    const doFetch = config.fetchImpl ?? fetch;
+    const base = config.baseUrl ?? DEFAULT_BASE_URL;
+    return {
+        name: 'stability',
+        model: config.model,
+        async generate(request, options) {
+            const response = await doFetch(`${base}/${encodeURIComponent(config.model)}/text-to-image`, {
+                method: 'POST',
+                headers: {
+                    'content-type': 'application/json',
+                    accept: 'application/json',
+                    authorization: `Bearer ${config.apiKey}`,
+                },
+                body: JSON.stringify(buildStabilityRequest(request)),
+                ...(options?.signal === undefined ? {} : { signal: options.signal }),
+            }).catch((cause) => {
+                throw new CogentaError({
+                    code: 'PROVIDER_REQUEST_FAILED',
+                    message: 'The image request to Stability could not be sent.',
+                    hint: 'Check network connectivity and COGENTA_STABILITY_API_KEY.',
+                    cause,
+                });
+            });
+            if (response.status === 429) {
+                throw new CogentaError({
+                    code: 'PROVIDER_RATE_LIMITED',
+                    message: 'Stability rate-limited this image request.',
+                    hint: 'Wait and try again.',
+                });
+            }
+            if (!response.ok) {
+                throw new CogentaError({
+                    code: 'PROVIDER_REQUEST_FAILED',
+                    message: `Stability returned status ${response.status} for an image request.`,
+                    hint: 'Check the prompt, the engine id and COGENTA_STABILITY_API_KEY.',
+                    details: { status: response.status },
+                });
+            }
+            return parseStabilityResponse((await response.json()));
+        },
+    };
+}
+//# sourceMappingURL=stability.js.map

package/dist/providers/image/stability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stability.js","sourceRoot":"","sources":["../../../src/providers/image/stability.ts"],"names":[],"mappings":"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"}

package/dist/providers/image/types.d.ts

@@ -0,0 +1,50 @@
+/**
+ * L18 task 4 — the image provider abstraction.
+ *
+ * Shaped exactly like `ProviderClient` (L4) and for the same stated reason:
+ * "un fournisseur d'image (driver, comme les fournisseurs LLM existants —
+ * plusieurs implémentations, jamais un seul fournisseur en dur)". Vendors
+ * disagree on nearly everything above the wire — OpenAI returns
+ * `data[].b64_json`, Stability returns `artifacts[].base64`, sizes are a
+ * `"1024x1024"` string in one and a width/height pair in the other — and this
+ * interface is the one place that difference is allowed to live.
+ *
+ * Unlike cache or storage there is **no degraded tier**, and there deliberately
+ * is no `Driver`/registry-with-fallback here: there is no local, service-free
+ * way to draw a picture from a sentence, so the honest degradation is that the
+ * feature is absent, not that it is slower. `createImageProviderRegistry`
+ * returns an empty registry for a site that configured none, and the tool is
+ * never built.
+ */
+/** Deliberately a small closed set: every vendor supports these three shapes. */
+export declare const IMAGE_SIZES: readonly ['square', 'landscape', 'portrait'];
+export type ImageSize = (typeof IMAGE_SIZES)[number];
+export interface ImageRequest {
+    readonly prompt: string;
+    readonly size?: ImageSize;
+    /** How many candidates to produce. Vendors cap this; adapters clamp rather than fail. */
+    readonly count?: number;
+}
+export interface GeneratedImage {
+    /** `image/png` or `image/webp` — whatever the vendor actually returned. */
+    readonly contentType: string;
+    /** Base64, without a data-URI prefix. The bytes are never written anywhere by this layer. */
+    readonly base64: string;
+    /** Some vendors rewrite the prompt before drawing; surfacing it is the only way an editor can tell. */
+    readonly revisedPrompt?: string;
+}
+export interface ImageGenerationOptions {
+    readonly signal?: AbortSignal;
+}
+export interface ImageProviderClient {
+    readonly name: string;
+    readonly model: string;
+    generate(request: ImageRequest, options?: ImageGenerationOptions): Promise<readonly GeneratedImage[]>;
+}
+export declare function clampCount(count: number | undefined): number;
+/** Pixel dimensions for the three named shapes. One table, so two adapters cannot disagree. */
+export declare const IMAGE_DIMENSIONS: Readonly<Record<ImageSize, {
+    readonly width: number;
+    readonly height: number;
+}>>;
+//# sourceMappingURL=types.d.ts.map

package/dist/providers/image/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/providers/image/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,iFAAiF;AACjF,eAAO,MAAM,WAAW,YAAI,QAAQ,EAAE,WAAW,EAAE,UAAU,CAAU,CAAA;AACvE,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAA;AAEpD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAA;IACzB,yFAAyF;IACzF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,2EAA2E;IAC3E,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,6FAA6F;IAC7F,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,uGAAuG;IACvG,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAChC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAC9B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CACN,OAAO,EAAE,YAAY,EACrB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,SAAS,cAAc,EAAE,CAAC,CAAA;CACtC;AAID,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAG5D;AAED,+FAA+F;AAC/F,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CACrC,MAAM,CAAC,SAAS,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAKtE,CAAA"}