@fgv/ts-extras 5.1.0-5 → 5.1.0-50

package/dist/packlets/ai-assist/imageGenerationClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imageGenerationClient.js","sourceRoot":"","sources":["../../../src/packlets/ai-assist/imageGenerationClient.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) 2026 Erik Fortune\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in all\n// copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n// SOFTWARE.\n\n/**\n * Image generation clients for AI assist. One dispatcher over the resolved\n * `IAiImageModelCapability.format`, the adapters it routes to (OpenAI images,\n * xAI generations and edits, Gemini image-out), their response validators, the\n * base64 attachment helpers only this modality uses, and the proxied variant.\n *\n * @packageDocumentation\n */\n\nimport { type JsonObject } from '@fgv/ts-json-base';\nimport { fail, type Logging, mapResults, Result, succeed, type Validator, Validators } from '@fgv/ts-utils';\n\nimport {\n  type IAiGeneratedImage,\n  type IAiImageAttachment,\n  type IAiImageGenerationParams,\n  type IAiImageGenerationResponse,\n  type IAiImageModelCapability,\n  type IAiProviderDescriptor,\n  type ModelSpec,\n  resolveProviderModel\n} from './model';\nimport { bearerAuthHeader, geminiAuthHeader, resolveEffectiveBaseUrl } from './endpoint';\nimport { type IAiApiConfig, fetchJson, fetchMultipart } from './http';\nimport { resolveImageCapability, supportsImageGeneration } from './registry';\nimport {\n  resolveImageOptions,\n  validateResolvedOptions,\n  type IResolvedImageOptions\n} from './imageOptionsResolver';\n\n// ============================================================================\n// Image attachment helpers\n// ============================================================================\n\n/**\n * Decodes a base64-encoded image attachment into a `Blob` suitable for use as\n * a multipart file field. On Node hands the `Buffer` straight to `Blob`\n * (Buffer extends Uint8Array) to skip an intermediate copy; falls back to\n * `atob` in browsers. Inputs come from `FileReader` or prior provider\n * responses, which are trusted to be valid. Note that Node's\n * `Buffer.from(..., 'base64')` silently strips invalid characters rather\n * than throwing, so failures are only observable in the browser path.\n * @internal\n */\nfunction attachmentToBlob(attachment: IAiImageAttachment): Result<Blob> {\n  if (typeof Buffer !== 'undefined') {\n    return succeed(new Blob([Buffer.from(attachment.base64, 'base64')], { type: attachment.mimeType }));\n  }\n  /* c8 ignore start - Browser-only fallback cannot be tested in Node.js environment */\n  try {\n    const binary = atob(attachment.base64);\n    const bytes = new Uint8Array(binary.length);\n    for (let i = 0; i < binary.length; i++) {\n      bytes[i] = binary.charCodeAt(i);\n    }\n    return succeed(new Blob([bytes], { type: attachment.mimeType }));\n  } catch (e) {\n    const message = e instanceof Error ? e.message : String(e);\n    return fail(`Invalid base64: ${message}`);\n  }\n  /* c8 ignore stop */\n}\n\n/**\n * Maps a MIME type to a sensible file extension for multipart filenames.\n * @internal\n */\nfunction extensionForMimeType(mimeType: string): string {\n  switch (mimeType) {\n    case 'image/png':\n      return 'png';\n    case 'image/jpeg':\n    case 'image/jpg':\n      return 'jpg';\n    case 'image/webp':\n      return 'webp';\n    case 'image/gif':\n      return 'gif';\n    default:\n      return 'bin';\n  }\n}\n\n// ============================================================================\n// Image generation — request types\n// ============================================================================\n\n/**\n * Parameters for an image-generation request.\n * @public\n */\nexport interface IProviderImageGenerationParams {\n  /** The provider descriptor */\n  readonly descriptor: IAiProviderDescriptor;\n  /** API key for authentication */\n  readonly apiKey: string;\n  /** The image-generation request */\n  readonly params: IAiImageGenerationParams;\n  /** Optional model override — string or context-aware map (uses descriptor.defaultModel.image otherwise) */\n  readonly modelOverride?: ModelSpec;\n  /** Optional logger for request/response observability. */\n  readonly logger?: Logging.ILogger;\n  /** Optional abort signal for cancelling the in-flight request. */\n  readonly signal?: AbortSignal;\n  /** Optional override of the descriptor's base URL; per-route suffix is appended unchanged. */\n  readonly endpoint?: string;\n}\n\n// ============================================================================\n// Image generation — response validators\n// ============================================================================\n\n// ---- OpenAI / xAI images format ----\n\n/** @internal */\ninterface IOpenAiImageItem {\n  b64_json: string;\n  revised_prompt?: string;\n}\n/** @internal */\ninterface IOpenAiImageResponse {\n  data: IOpenAiImageItem[];\n}\n\nconst openAiImageItem: Validator<IOpenAiImageItem> = Validators.object<IOpenAiImageItem>({\n  b64_json: Validators.string,\n  revised_prompt: Validators.string.optional()\n});\nconst openAiImageResponse: Validator<IOpenAiImageResponse> = Validators.object<IOpenAiImageResponse>({\n  data: Validators.arrayOf(openAiImageItem).withConstraint((arr) => arr.length > 0)\n});\n\n// ---- Gemini image-out (`:generateContent` returning image parts) format ----\n\n/** @internal */\ninterface IGeminiImageInlineData {\n  mimeType: string;\n  data: string;\n}\n/** @internal */\ninterface IGeminiImageOutPart {\n  text?: string;\n  inlineData?: IGeminiImageInlineData;\n}\n/** @internal */\ninterface IGeminiImageOutContent {\n  parts: IGeminiImageOutPart[];\n}\n/** @internal */\ninterface IGeminiImageOutCandidate {\n  content?: IGeminiImageOutContent;\n  finishReason?: string;\n  finishMessage?: string;\n}\n/** @internal */\ninterface IGeminiImageOutResponse {\n  candidates: IGeminiImageOutCandidate[];\n}\n\nconst geminiImageInlineData: Validator<IGeminiImageInlineData> = Validators.object<IGeminiImageInlineData>({\n  mimeType: Validators.string,\n  data: Validators.string\n});\nconst geminiImageOutPart: Validator<IGeminiImageOutPart> = Validators.object<IGeminiImageOutPart>({\n  text: Validators.string.optional(),\n  inlineData: geminiImageInlineData.optional()\n});\nconst geminiImageOutContent: Validator<IGeminiImageOutContent> = Validators.object<IGeminiImageOutContent>({\n  parts: Validators.arrayOf(geminiImageOutPart)\n});\nconst geminiImageOutCandidate: Validator<IGeminiImageOutCandidate> =\n  Validators.object<IGeminiImageOutCandidate>({\n    content: geminiImageOutContent.optional(),\n    finishReason: Validators.string.optional(),\n    finishMessage: Validators.string.optional()\n  });\nconst geminiImageOutResponse: Validator<IGeminiImageOutResponse> = Validators.object<IGeminiImageOutResponse>(\n  {\n    candidates: Validators.arrayOf(geminiImageOutCandidate).withConstraint((arr) => arr.length > 0)\n  }\n);\n\n// ---- Proxied image generation response ----\n\nconst proxiedGeneratedImage: Validator<IAiGeneratedImage> = Validators.object<IAiGeneratedImage>({\n  mimeType: Validators.string,\n  base64: Validators.string,\n  revisedPrompt: Validators.string.optional()\n});\nconst proxiedImageGenerationResponse: Validator<IAiImageGenerationResponse> =\n  Validators.object<IAiImageGenerationResponse>({\n    images: Validators.arrayOf(proxiedGeneratedImage).withConstraint((arr) => arr.length > 0)\n  });\n\n// ============================================================================\n// Image generation — adapters\n// ============================================================================\n\n/** Routes to /images/generations or /images/edits; handles outputParamStyle. @internal */\nasync function callOpenAiImageGeneration(\n  config: IAiApiConfig,\n  request: IAiImageGenerationParams,\n  capability: IAiImageModelCapability,\n  resolved: IResolvedImageOptions,\n  logger?: Logging.ILogger,\n  signal?: AbortSignal\n): Promise<Result<IAiImageGenerationResponse>> {\n  const refs = request.referenceImages ?? [];\n  const headers: Record<string, string> = bearerAuthHeader(config.apiKey);\n\n  const effectiveMimeType =\n    resolved.outputFormat !== undefined\n      ? `image/${resolved.outputFormat}`\n      : capability.defaultOutputMimeType ?? 'image/png';\n\n  const fetched =\n    refs.length > 0\n      ? await callOpenAiImagesEdits(config, capability, request, headers, resolved, logger, signal)\n      : await callOpenAiImagesGenerations(config, request, headers, resolved, capability, logger, signal);\n\n  return fetched.onSuccess((json) =>\n    openAiImageResponse\n      .validate(json)\n      .withErrorFormat((msg) => `OpenAI images API response: ${msg}`)\n      .onSuccess((response) =>\n        succeed({\n          images: response.data.map((item) => ({\n            mimeType: effectiveMimeType,\n            base64: item.b64_json,\n            ...(item.revised_prompt !== undefined ? { revisedPrompt: item.revised_prompt } : {})\n          }))\n        })\n      )\n  );\n}\n\n/** Builds the JSON /images/generations request; handles outputParamStyle. @internal */\nfunction callOpenAiImagesGenerations(\n  config: IAiApiConfig,\n  request: IAiImageGenerationParams,\n  headers: Record<string, string>,\n  resolved: IResolvedImageOptions,\n  capability: IAiImageModelCapability,\n  logger?: Logging.ILogger,\n  signal?: AbortSignal\n): Promise<Result<JsonObject>> {\n  const body: Record<string, unknown> = {\n    model: config.model,\n    prompt: request.prompt,\n    n: resolved.n\n  };\n\n  // Output format param — conditional on model capability\n  if (capability.outputParamStyle === 'response-format') {\n    body.response_format = 'b64_json';\n  } else if (capability.outputParamStyle === 'output-format') {\n    body.output_format = resolved.outputFormat ?? 'png';\n  }\n\n  if (resolved.size !== undefined) {\n    body.size = resolved.size;\n  }\n  if (capability.supportsQualityParam && resolved.quality !== undefined) {\n    body.quality = resolved.quality;\n  }\n  if (resolved.seed !== undefined) {\n    body.seed = resolved.seed;\n  }\n  if (resolved.background !== undefined) {\n    body.background = resolved.background;\n  }\n  if (resolved.moderation !== undefined) {\n    body.moderation = resolved.moderation;\n  }\n  if (resolved.outputCompression !== undefined) {\n    body.output_compression = resolved.outputCompression;\n  }\n  if (resolved.otherParams !== undefined) {\n    Object.assign(body, resolved.otherParams);\n  }\n  /* c8 ignore next 1 - optional logger */\n  logger?.info(`Image generation: model=${config.model}, n=${resolved.n}`);\n  return fetchJson(`${config.baseUrl}/images/generations`, headers, body, logger, signal);\n}\n\n/** Builds the multipart /images/edits request with ref images. @internal */\nasync function callOpenAiImagesEdits(\n  config: IAiApiConfig,\n  capability: IAiImageModelCapability,\n  request: IAiImageGenerationParams,\n  headers: Record<string, string>,\n  resolved: IResolvedImageOptions,\n  logger?: Logging.ILogger,\n  signal?: AbortSignal\n): Promise<Result<JsonObject>> {\n  const refs = request.referenceImages!; // callers verify refs.length > 0 before calling this function\n  const blobsResult = mapResults(\n    refs.map((ref, i) => attachmentToBlob(ref).withErrorFormat((msg) => `reference image ${i}: ${msg}`))\n  );\n  /* c8 ignore next 3 - decode failure unreachable via Node's Buffer.from (silently strips invalid input) */\n  if (blobsResult.isFailure()) {\n    return fail(blobsResult.message);\n  }\n\n  const form = new FormData();\n  form.append('model', config.model);\n  form.append('prompt', request.prompt);\n  form.append('n', String(resolved.n));\n  if (capability.outputParamStyle !== 'output-format') {\n    form.append('response_format', 'b64_json');\n  }\n  if (resolved.size !== undefined) {\n    form.append('size', resolved.size);\n  }\n  blobsResult.value.forEach((blob, i) => {\n    form.append('image[]', blob, `ref-${i}.${extensionForMimeType(refs[i].mimeType)}`);\n  });\n  /* c8 ignore next 1 - optional logger */\n  logger?.info(`Image edit: model=${config.model}, n=${resolved.n}, refs=${refs.length}`);\n  return fetchMultipart(`${config.baseUrl}/images/edits`, headers, form, logger, signal);\n}\n\n/** Calls xAI /images/edits with JSON body (not multipart); up to 3 source images. @internal */\nasync function callXaiImagesEdits(\n  config: IAiApiConfig,\n  request: IAiImageGenerationParams,\n  resolved: IResolvedImageOptions,\n  logger?: Logging.ILogger,\n  signal?: AbortSignal\n): Promise<Result<JsonObject>> {\n  /* c8 ignore next 1 - defensive: referenceImages always defined when this function is called */\n  const refs = request.referenceImages ?? [];\n  if (refs.length > 3) {\n    return fail(`xAI image edits supports at most 3 reference images; got ${refs.length}`);\n  }\n  const images = refs.map((ref) => ({\n    type: 'image_url',\n    url: `data:${ref.mimeType};base64,${ref.base64}`\n  }));\n\n  const body: Record<string, unknown> = {\n    model: config.model,\n    prompt: request.prompt,\n    n: resolved.n,\n    response_format: 'b64_json',\n    image: images\n  };\n  if (resolved.aspectRatio !== undefined) {\n    body.aspect_ratio = resolved.aspectRatio;\n  }\n  if (resolved.resolution !== undefined) {\n    body.resolution = resolved.resolution;\n  }\n  if (resolved.otherParams !== undefined) {\n    Object.assign(body, resolved.otherParams);\n  }\n  /* c8 ignore next 1 - optional logger */\n  logger?.info(`xAI image edit: model=${config.model}, n=${resolved.n}, refs=${refs.length}`);\n  return fetchJson(`${config.baseUrl}/images/edits`, bearerAuthHeader(config.apiKey), body, logger, signal);\n}\n\n/**\n * Normalizes an xAI images API response (OpenAI-shaped) into the provider-neutral\n * generated-image result.\n *\n * @remarks\n * Shared by the generations path and the edits path. These were two independent\n * copies 160 lines apart — identical but for the receiver name — so the\n * `defaultOutputMimeType` fallback and the error prefix each existed twice, and a\n * fix to one would silently have missed the other.\n * @internal\n */\nfunction normalizeXaiImageResponse(\n  json: JsonObject,\n  capability: IAiImageModelCapability\n): Result<IAiImageGenerationResponse> {\n  return openAiImageResponse\n    .validate(json)\n    .withErrorFormat((msg) => `xAI images API response: ${msg}`)\n    .onSuccess((response) =>\n      succeed({\n        images: response.data.map((item) => ({\n          mimeType: capability.defaultOutputMimeType ?? 'image/jpeg',\n          base64: item.b64_json\n        }))\n      })\n    );\n}\n\n/** Calls xAI /images/generations; uses aspect_ratio instead of size. @internal */\nasync function callXaiImageGeneration(\n  config: IAiApiConfig,\n  request: IAiImageGenerationParams,\n  capability: IAiImageModelCapability,\n  resolved: IResolvedImageOptions,\n  logger?: Logging.ILogger,\n  signal?: AbortSignal\n): Promise<Result<IAiImageGenerationResponse>> {\n  const headers: Record<string, string> = bearerAuthHeader(config.apiKey);\n  const body: Record<string, unknown> = {\n    model: config.model,\n    prompt: request.prompt,\n    n: resolved.n,\n    response_format: 'b64_json'\n  };\n  if (resolved.aspectRatio !== undefined) {\n    body.aspect_ratio = resolved.aspectRatio;\n  }\n  if (resolved.resolution !== undefined) {\n    body.resolution = resolved.resolution;\n  }\n  if (resolved.otherParams !== undefined) {\n    Object.assign(body, resolved.otherParams);\n  }\n  /* c8 ignore next 1 - optional logger */\n  logger?.info(`xAI image generation: model=${config.model}, n=${resolved.n}`);\n  const fetched = await fetchJson(`${config.baseUrl}/images/generations`, headers, body, logger, signal);\n  return fetched.onSuccess((json) => normalizeXaiImageResponse(json, capability));\n}\n\n/**\n * Gemini `finishReason` values that indicate a normal terminal completion rather\n * than a refusal. `STOP` is set on every successful generation (and on completions\n * that return a text part instead of an image); `MAX_TOKENS` is a benign truncation.\n * A candidate carrying only one of these is NOT a decline — treating it as one would\n * mislabel an ordinary no-image outcome as a policy refusal. @internal\n */\nconst benignGeminiImageFinishReasons: ReadonlySet<string> = new Set(['STOP', 'MAX_TOKENS']);\n\n/** Calls Gemini :generateContent for image output; accepts ref images as inlineData. @internal */\nasync function callGeminiImageOutGeneration(\n  config: IAiApiConfig,\n  request: IAiImageGenerationParams,\n  resolved: IResolvedImageOptions,\n  logger?: Logging.ILogger,\n  signal?: AbortSignal\n): Promise<Result<IAiImageGenerationResponse>> {\n  const url = `${config.baseUrl}/models/${config.model}:generateContent`;\n  const refs = request.referenceImages ?? [];\n  const parts: Array<Record<string, unknown>> = [{ text: request.prompt }];\n  for (const ref of refs) {\n    parts.push({ inlineData: { mimeType: ref.mimeType, data: ref.base64 } });\n  }\n\n  const generationConfig: Record<string, unknown> = {};\n  if (resolved.geminiAspectRatio !== undefined) {\n    generationConfig.imageConfig = { aspectRatio: resolved.geminiAspectRatio };\n  }\n  if (resolved.otherParams !== undefined) {\n    Object.assign(generationConfig, resolved.otherParams);\n  }\n\n  const body: Record<string, unknown> = { contents: [{ role: 'user', parts }] };\n  if (Object.keys(generationConfig).length > 0) {\n    body.generationConfig = generationConfig;\n  }\n  const headers: Record<string, string> = geminiAuthHeader(config.apiKey);\n\n  /* c8 ignore next 1 - optional logger */\n  logger?.info(`Gemini image-out: model=${config.model}, refs=${refs.length}`);\n  return (await fetchJson(url, headers, body, logger, signal)).onSuccess((json) =>\n    geminiImageOutResponse\n      .validate(json)\n      .withErrorFormat((msg) => `Gemini image API response: ${msg}`)\n      .onSuccess((response) => {\n        const images: IAiGeneratedImage[] = [];\n        for (const candidate of response.candidates) {\n          for (const part of candidate.content?.parts ?? []) {\n            if (part.inlineData) {\n              images.push({\n                mimeType: part.inlineData.mimeType,\n                base64: part.inlineData.data\n              });\n            }\n          }\n        }\n        if (images.length === 0) {\n          // A candidate with no image parts is a *decline* only when it carries a\n          // refusal-shaped finishReason — i.e. present and not a benign terminal reason\n          // (`STOP`/`MAX_TOKENS`). A normal completion that emitted text-instead-of-image\n          // carries `finishReason: 'STOP'` and must fall through to the no-image message.\n          const declined = response.candidates.find(\n            (candidate) =>\n              candidate.finishReason !== undefined &&\n              !benignGeminiImageFinishReasons.has(candidate.finishReason)\n          );\n          if (declined?.finishReason !== undefined) {\n            // Truthiness (not `!== undefined`) so an empty-string finishMessage is treated\n            // as \"no message\" and produces no dangling ` — ` separator.\n            const suffix = declined.finishMessage ? ` — ${declined.finishMessage}` : '';\n            return fail(`Gemini image generation declined: ${declined.finishReason}${suffix}`);\n          }\n          return fail('Gemini image API response: no image parts in response');\n        }\n        return succeed({ images });\n      })\n  );\n}\n\n// ============================================================================\n// Image generation — dispatcher\n// ============================================================================\n\n/**\n * Calls the appropriate image-generation API for a given provider. Routes by the\n * `format` field of the resolved {@link IAiImageModelCapability}:\n * `'openai-images'`, `'xai-images'`, `'xai-images-edits'`, or\n * `'gemini-image-out'`. Rejects up front if `referenceImages` is set but the\n * capability does not declare `acceptsImageReferenceInput`.\n * @param params - Request parameters including descriptor, API key, and prompt\n * @public\n */\nexport async function callProviderImageGeneration(\n  params: IProviderImageGenerationParams\n): Promise<Result<IAiImageGenerationResponse>> {\n  const { descriptor, apiKey, params: request, modelOverride, logger, signal, endpoint } = params;\n\n  if (!supportsImageGeneration(descriptor)) {\n    return fail(`provider \"${descriptor.id}\" does not support image generation`);\n  }\n  const baseUrlResult = resolveEffectiveBaseUrl(descriptor, endpoint);\n  if (baseUrlResult.isFailure()) {\n    return fail(baseUrlResult.message);\n  }\n\n  const modelResult = resolveProviderModel(descriptor, modelOverride, 'image');\n  if (modelResult.isFailure()) {\n    return fail(modelResult.message);\n  }\n  const model = modelResult.value;\n  const capability = resolveImageCapability(descriptor, model);\n  if (capability === undefined) {\n    return fail(`provider \"${descriptor.id}\" does not support image generation for model \"${model}\"`);\n  }\n  if ((request.referenceImages?.length ?? 0) > 0 && !capability.acceptsImageReferenceInput) {\n    return fail(`model \"${model}\" does not support reference images`);\n  }\n\n  const resolved = resolveImageOptions(model, capability, request.options);\n  const validationResult = validateResolvedOptions(model, capability, resolved);\n  if (validationResult.isFailure()) {\n    return fail<IAiImageGenerationResponse>(validationResult.message);\n  }\n  const config: IAiApiConfig = {\n    baseUrl: baseUrlResult.value,\n    apiKey,\n    model\n  };\n  /* c8 ignore next 6 - optional logger diagnostic output */\n  if (logger) {\n    logger.info(\n      `AI image generation: provider=${descriptor.id}, format=${capability.format}, ` +\n        `model=${config.model}`\n    );\n  }\n\n  switch (capability.format) {\n    case 'openai-images':\n      return callOpenAiImageGeneration(config, request, capability, resolved, logger, signal);\n    case 'xai-images':\n      return callXaiImageGeneration(config, request, capability, resolved, logger, signal);\n    case 'xai-images-edits': {\n      const refs = request.referenceImages ?? [];\n      if (refs.length > 0) {\n        const editsResult = await callXaiImagesEdits(config, request, resolved, logger, signal);\n        return editsResult.onSuccess((json) => normalizeXaiImageResponse(json, capability));\n      }\n      return callXaiImageGeneration(config, request, capability, resolved, logger, signal);\n    }\n    case 'gemini-image-out':\n      return callGeminiImageOutGeneration(config, request, resolved, logger, signal);\n    /* c8 ignore next 4 - defensive coding: exhaustive switch guaranteed by TypeScript */\n    default: {\n      const _exhaustive: never = capability.format;\n      return fail(`unsupported image API format: ${String(_exhaustive)}`);\n    }\n  }\n}\n\n// ============================================================================\n// Proxied image generation\n// ============================================================================\n\n/**\n * Calls the image-generation endpoint on a proxy server instead of calling\n * the provider API directly from the browser.\n * Endpoint: `POST ${proxyUrl}/api/ai/image-generation`. Request body:\n * `{providerId, apiKey, params, modelOverride?}`. The proxy handles descriptor\n * lookup, model resolution, provider dispatch, and response normalization\n * (including repackaging `referenceImages` for the upstream wire format).\n * Error body `{error: string}` is surfaced as `proxy: ${error}`.\n * @param proxyUrl - Base URL of the proxy server\n * @param params - Same parameters as {@link callProviderImageGeneration}\n * @public\n */\nexport async function callProxiedImageGeneration(\n  proxyUrl: string,\n  params: IProviderImageGenerationParams\n): Promise<Result<IAiImageGenerationResponse>> {\n  const { descriptor, apiKey, params: request, modelOverride, logger, signal } = params;\n\n  const body: Record<string, unknown> = {\n    providerId: descriptor.id,\n    apiKey,\n    params: request\n  };\n  if (modelOverride !== undefined) {\n    body.modelOverride = modelOverride;\n  }\n\n  /* c8 ignore next 1 - optional logger */\n  logger?.info(`AI image proxy request: provider=${descriptor.id}, proxy=${proxyUrl}`);\n\n  const url = `${proxyUrl}/api/ai/image-generation`;\n  const jsonResult = await fetchJson(url, {}, body, logger, signal);\n  if (jsonResult.isFailure()) {\n    return fail(jsonResult.message);\n  }\n\n  const response = jsonResult.value as Record<string, unknown>;\n  if (typeof response.error === 'string') {\n    return fail(`proxy: ${response.error}`);\n  }\n\n  return proxiedImageGenerationResponse\n    .validate(response)\n    .withErrorFormat((msg) => `proxy returned invalid response: ${msg}`);\n}\n"]}

package/dist/packlets/ai-assist/imageOptionsResolver.js

@@ -0,0 +1,193 @@
+// Copyright (c) 2026 Erik Fortune
+//
+// Permission is hereby granted, free of charge, to any person obtaining a copy
+// of this software and associated documentation files (the "Software"), to deal
+// in the Software without restriction, including without limitation the rights
+// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the Software is
+// furnished to do so, subject to the following conditions:
+//
+// The above copyright notice and this permission notice shall be included in all
+// copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+// SOFTWARE.
+import { fail, succeed } from '@fgv/ts-utils';
+// ============================================================================
+// Provider lineage helpers
+// ============================================================================
+/** Maps AiImageApiFormat values to the corresponding IModelFamilyConfig provider discriminator. */
+function providerLineageForFormat(format) {
+    switch (format) {
+        case 'openai-images':
+            return 'openai';
+        case 'xai-images':
+        case 'xai-images-edits':
+            return 'xai';
+        case 'gemini-image-out':
+            return 'google';
+        default:
+            return undefined;
+    }
+}
+// ============================================================================
+// Type guards
+// ============================================================================
+function isGptImageModelOptions(block) {
+    return block.provider === 'openai' && block.family === 'gpt-image';
+}
+function isGrokImagineModelOptions(block) {
+    return block.provider === 'xai' && block.family === 'grok-imagine';
+}
+function isGeminiFlashImageModelOptions(block) {
+    return block.provider === 'google' && block.family === 'gemini-flash-image';
+}
+function isOtherModelOptions(block) {
+    return block.provider === 'other';
+}
+// ============================================================================
+// Merge logic
+// ============================================================================
+/**
+ * Resolves the merged image options for a given model and capability.
+ *
+ * @remarks
+ * **Merge precedence (later wins):**
+ * 1. Generic top-level options (size, count, quality, seed)
+ * 2. Family-generic blocks (models field omitted, provider matches)
+ * 3. Model-specific blocks (models array includes the resolved model name)
+ * 4. Other blocks (provider: 'other', models array includes model name)
+ *
+ * Provider-mismatch blocks are silently skipped.
+ *
+ * Within each tier, declaration order — later declaration wins.
+ *
+ * @param modelId - The resolved model string
+ * @param capability - The resolved IAiImageModelCapability for this model
+ * @param options - Caller-supplied options
+ * @returns The merged wire parameters
+ * @public
+ */
+export function resolveImageOptions(modelId, capability, options) {
+    var _a, _b;
+    const opts = options !== null && options !== void 0 ? options : {};
+    const lineage = providerLineageForFormat(capability.format);
+    // Start from generic top-level
+    let resolved = Object.assign(Object.assign(Object.assign({ n: (_a = opts.count) !== null && _a !== void 0 ? _a : 1 }, (opts.size !== undefined ? { size: opts.size } : {})), (opts.quality !== undefined ? { quality: opts.quality } : {})), (opts.seed !== undefined ? { seed: opts.seed } : {}));
+    const modelBlocks = (_b = opts.models) !== null && _b !== void 0 ? _b : [];
+    // Tier 2: family-generic blocks (models field omitted, provider matches lineage)
+    for (const block of modelBlocks) {
+        if (block.provider !== lineage && block.provider !== 'other')
+            continue;
+        if (block.provider === 'other')
+            continue; // other blocks handled in tier 4
+        if (!isApplicableBlock(block, modelId))
+            continue;
+        if (!isFamilyGenericBlock(block))
+            continue;
+        resolved = applyBlock(resolved, block);
+    }
+    // Tier 3: model-specific blocks (models array includes this model)
+    for (const block of modelBlocks) {
+        if (block.provider !== lineage && block.provider !== 'other')
+            continue;
+        if (block.provider === 'other')
+            continue;
+        if (!isApplicableBlock(block, modelId))
+            continue;
+        if (isFamilyGenericBlock(block))
+            continue;
+        resolved = applyBlock(resolved, block);
+    }
+    // Tier 4: Other blocks (same precedence as model-specific)
+    for (const block of modelBlocks) {
+        if (!isOtherModelOptions(block))
+            continue;
+        if (!block.models.includes(modelId))
+            continue;
+        resolved = applyOtherBlock(resolved, block);
+    }
+    return resolved;
+}
+function isApplicableBlock(block, modelId) {
+    /* c8 ignore next 3 - defensive coding: other blocks are filtered before isApplicableBlock is called */
+    if (isOtherModelOptions(block)) {
+        return block.models.includes(modelId);
+    }
+    // Has models array? Must include this modelId.
+    const named = block;
+    if (named.models !== undefined && named.models.length > 0) {
+        return named.models.includes(modelId);
+    }
+    // No models array = family-generic = applies to all in this family
+    return true;
+}
+function isFamilyGenericBlock(block) {
+    /* c8 ignore next 1 - defensive coding: other blocks are filtered before isFamilyGenericBlock is called */
+    if (isOtherModelOptions(block))
+        return false;
+    const named = block;
+    return named.models === undefined || named.models.length === 0;
+}
+function applyBlock(resolved, block) {
+    if (isGptImageModelOptions(block)) {
+        return Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({}, resolved), (block.config.size !== undefined ? { size: block.config.size } : {})), (block.config.quality !== undefined ? { quality: block.config.quality } : {})), (block.config.outputFormat !== undefined ? { outputFormat: block.config.outputFormat } : {})), (block.config.outputCompression !== undefined
+            ? { outputCompression: block.config.outputCompression }
+            : {})), (block.config.background !== undefined ? { background: block.config.background } : {})), (block.config.moderation !== undefined ? { moderation: block.config.moderation } : {}));
+    }
+    if (isGrokImagineModelOptions(block)) {
+        return Object.assign(Object.assign(Object.assign({}, resolved), (block.config.aspectRatio !== undefined ? { aspectRatio: block.config.aspectRatio } : {})), (block.config.resolution !== undefined ? { resolution: block.config.resolution } : {}));
+    }
+    if (isGeminiFlashImageModelOptions(block)) {
+        return Object.assign(Object.assign({}, resolved), (block.config.aspectRatio !== undefined ? { geminiAspectRatio: block.config.aspectRatio } : {}));
+    }
+    /* c8 ignore next 2 - defensive coding: exhaustive union, all family types handled above */
+    return resolved;
+}
+function applyOtherBlock(resolved, block) {
+    var _a;
+    return Object.assign(Object.assign({}, resolved), { otherParams: Object.assign(Object.assign({}, ((_a = resolved.otherParams) !== null && _a !== void 0 ? _a : {})), block.config) });
+}
+// ============================================================================
+// Runtime validation
+// ============================================================================
+/**
+ * Validates the resolved options against per-model registry constraints.
+ *
+ * @remarks
+ * Fails fast on the first violation. Error format:
+ * `model "${model}": ${field} "${value}" is not accepted; accepted values: ${JSON.stringify(accepted)}`
+ *
+ * @param modelId - The resolved model string
+ * @param capability - The resolved capability entry from the registry
+ * @param resolved - The merged options from resolveImageOptions
+ * @returns The same resolved options on success, or a failure with a contextual message
+ * @public
+ */
+export function validateResolvedOptions(modelId, capability, resolved) {
+    // Validate count
+    if (capability.maxCount !== undefined && resolved.n > capability.maxCount) {
+        return fail(`model "${modelId}": count ${resolved.n} exceeds maximum of ${capability.maxCount}`);
+    }
+    // Validate size
+    if (capability.acceptedSizes !== undefined && resolved.size !== undefined) {
+        if (!capability.acceptedSizes.includes(resolved.size)) {
+            return fail(`model "${modelId}": size "${resolved.size}" is not accepted; accepted values: ${JSON.stringify(capability.acceptedSizes)}`);
+        }
+    }
+    // Validate quality
+    if (capability.supportsQualityParam &&
+        capability.acceptedQualities !== undefined &&
+        resolved.quality !== undefined) {
+        if (!capability.acceptedQualities.includes(resolved.quality)) {
+            return fail(`model "${modelId}": quality "${resolved.quality}" is not accepted; accepted values: ${JSON.stringify(capability.acceptedQualities)}`);
+        }
+    }
+    return succeed(resolved);
+}
+//# sourceMappingURL=imageOptionsResolver.js.map

package/dist/packlets/ai-assist/imageOptionsResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imageOptionsResolver.js","sourceRoot":"","sources":["../../../src/packlets/ai-assist/imageOptionsResolver.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) 2026 Erik Fortune\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in all\n// copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n// SOFTWARE.\n\n/**\n * Merge logic and runtime validation for image generation options.\n * @packageDocumentation\n */\n\nimport { type JsonObject } from '@fgv/ts-json-base';\nimport { fail, Result, succeed } from '@fgv/ts-utils';\n\nimport type {\n  IAiImageModelCapability,\n  IAiImageGenerationOptions,\n  IModelFamilyConfig,\n  INamedModelFamilyConfig,\n  IGptImageModelOptions,\n  IGrokImagineModelOptions,\n  IGeminiFlashImageModelOptions,\n  IOtherModelOptions\n} from './model';\n\n// ============================================================================\n// Provider lineage helpers\n// ============================================================================\n\n/** Maps AiImageApiFormat values to the corresponding IModelFamilyConfig provider discriminator. */\nfunction providerLineageForFormat(format: string): 'openai' | 'xai' | 'google' | 'other' | undefined {\n  switch (format) {\n    case 'openai-images':\n      return 'openai';\n    case 'xai-images':\n    case 'xai-images-edits':\n      return 'xai';\n    case 'gemini-image-out':\n      return 'google';\n    default:\n      return undefined;\n  }\n}\n\n// ============================================================================\n// Type guards\n// ============================================================================\n\nfunction isGptImageModelOptions(block: IModelFamilyConfig): block is IGptImageModelOptions {\n  return block.provider === 'openai' && block.family === 'gpt-image';\n}\n\nfunction isGrokImagineModelOptions(block: IModelFamilyConfig): block is IGrokImagineModelOptions {\n  return block.provider === 'xai' && block.family === 'grok-imagine';\n}\n\nfunction isGeminiFlashImageModelOptions(block: IModelFamilyConfig): block is IGeminiFlashImageModelOptions {\n  return block.provider === 'google' && block.family === 'gemini-flash-image';\n}\n\nfunction isOtherModelOptions(block: IModelFamilyConfig): block is IOtherModelOptions {\n  return block.provider === 'other';\n}\n\n// ============================================================================\n// Resolved wire shape\n// ============================================================================\n\n/**\n * The resolved, merged wire parameters for an image generation request.\n * Built from the layered options and ready for provider-specific encoding.\n * @public\n */\nexport interface IResolvedImageOptions {\n  /** Number of images to generate. */\n  readonly n: number;\n  /** Image size (OpenAI-style pixel strings). */\n  readonly size?: string;\n  /** Quality tier. */\n  readonly quality?: string;\n  /** Seed for reproducibility. */\n  readonly seed?: number;\n  // GptImage-specific\n  readonly outputFormat?: string;\n  readonly outputCompression?: number;\n  readonly background?: string;\n  readonly moderation?: string;\n  // xAI-specific\n  readonly aspectRatio?: string;\n  readonly resolution?: string;\n  // Gemini Flash-specific\n  readonly geminiAspectRatio?: string;\n  // Other-block passthroughs (merged at model-specific tier)\n  readonly otherParams?: JsonObject;\n}\n\n// ============================================================================\n// Merge logic\n// ============================================================================\n\n/**\n * Resolves the merged image options for a given model and capability.\n *\n * @remarks\n * **Merge precedence (later wins):**\n * 1. Generic top-level options (size, count, quality, seed)\n * 2. Family-generic blocks (models field omitted, provider matches)\n * 3. Model-specific blocks (models array includes the resolved model name)\n * 4. Other blocks (provider: 'other', models array includes model name)\n *\n * Provider-mismatch blocks are silently skipped.\n *\n * Within each tier, declaration order — later declaration wins.\n *\n * @param modelId - The resolved model string\n * @param capability - The resolved IAiImageModelCapability for this model\n * @param options - Caller-supplied options\n * @returns The merged wire parameters\n * @public\n */\nexport function resolveImageOptions(\n  modelId: string,\n  capability: IAiImageModelCapability,\n  options: IAiImageGenerationOptions | undefined\n): IResolvedImageOptions {\n  const opts = options ?? {};\n  const lineage = providerLineageForFormat(capability.format);\n\n  // Start from generic top-level\n  let resolved: IResolvedImageOptions = {\n    n: opts.count ?? 1,\n    ...(opts.size !== undefined ? { size: opts.size } : {}),\n    ...(opts.quality !== undefined ? { quality: opts.quality } : {}),\n    ...(opts.seed !== undefined ? { seed: opts.seed } : {})\n  };\n\n  const modelBlocks = opts.models ?? [];\n\n  // Tier 2: family-generic blocks (models field omitted, provider matches lineage)\n  for (const block of modelBlocks) {\n    if (block.provider !== lineage && block.provider !== 'other') continue;\n    if (block.provider === 'other') continue; // other blocks handled in tier 4\n    if (!isApplicableBlock(block, modelId)) continue;\n    if (!isFamilyGenericBlock(block)) continue;\n    resolved = applyBlock(resolved, block);\n  }\n\n  // Tier 3: model-specific blocks (models array includes this model)\n  for (const block of modelBlocks) {\n    if (block.provider !== lineage && block.provider !== 'other') continue;\n    if (block.provider === 'other') continue;\n    if (!isApplicableBlock(block, modelId)) continue;\n    if (isFamilyGenericBlock(block)) continue;\n    resolved = applyBlock(resolved, block);\n  }\n\n  // Tier 4: Other blocks (same precedence as model-specific)\n  for (const block of modelBlocks) {\n    if (!isOtherModelOptions(block)) continue;\n    if (!block.models.includes(modelId)) continue;\n    resolved = applyOtherBlock(resolved, block);\n  }\n\n  return resolved;\n}\n\nfunction isApplicableBlock(block: IModelFamilyConfig, modelId: string): boolean {\n  /* c8 ignore next 3 - defensive coding: other blocks are filtered before isApplicableBlock is called */\n  if (isOtherModelOptions(block)) {\n    return block.models.includes(modelId);\n  }\n  // Has models array? Must include this modelId.\n  const named = block as INamedModelFamilyConfig;\n  if (named.models !== undefined && named.models.length > 0) {\n    return named.models.includes(modelId);\n  }\n  // No models array = family-generic = applies to all in this family\n  return true;\n}\n\nfunction isFamilyGenericBlock(block: IModelFamilyConfig): boolean {\n  /* c8 ignore next 1 - defensive coding: other blocks are filtered before isFamilyGenericBlock is called */\n  if (isOtherModelOptions(block)) return false;\n  const named = block as INamedModelFamilyConfig;\n  return named.models === undefined || named.models.length === 0;\n}\n\nfunction applyBlock(resolved: IResolvedImageOptions, block: IModelFamilyConfig): IResolvedImageOptions {\n  if (isGptImageModelOptions(block)) {\n    return {\n      ...resolved,\n      ...(block.config.size !== undefined ? { size: block.config.size } : {}),\n      ...(block.config.quality !== undefined ? { quality: block.config.quality } : {}),\n      ...(block.config.outputFormat !== undefined ? { outputFormat: block.config.outputFormat } : {}),\n      ...(block.config.outputCompression !== undefined\n        ? { outputCompression: block.config.outputCompression }\n        : {}),\n      ...(block.config.background !== undefined ? { background: block.config.background } : {}),\n      ...(block.config.moderation !== undefined ? { moderation: block.config.moderation } : {})\n    };\n  }\n  if (isGrokImagineModelOptions(block)) {\n    return {\n      ...resolved,\n      ...(block.config.aspectRatio !== undefined ? { aspectRatio: block.config.aspectRatio } : {}),\n      ...(block.config.resolution !== undefined ? { resolution: block.config.resolution } : {})\n    };\n  }\n  if (isGeminiFlashImageModelOptions(block)) {\n    return {\n      ...resolved,\n      ...(block.config.aspectRatio !== undefined ? { geminiAspectRatio: block.config.aspectRatio } : {})\n    };\n  }\n  /* c8 ignore next 2 - defensive coding: exhaustive union, all family types handled above */\n  return resolved;\n}\n\nfunction applyOtherBlock(resolved: IResolvedImageOptions, block: IOtherModelOptions): IResolvedImageOptions {\n  return {\n    ...resolved,\n    otherParams: { ...(resolved.otherParams ?? {}), ...block.config }\n  };\n}\n\n// ============================================================================\n// Runtime validation\n// ============================================================================\n\n/**\n * Validates the resolved options against per-model registry constraints.\n *\n * @remarks\n * Fails fast on the first violation. Error format:\n * `model \"${model}\": ${field} \"${value}\" is not accepted; accepted values: ${JSON.stringify(accepted)}`\n *\n * @param modelId - The resolved model string\n * @param capability - The resolved capability entry from the registry\n * @param resolved - The merged options from resolveImageOptions\n * @returns The same resolved options on success, or a failure with a contextual message\n * @public\n */\nexport function validateResolvedOptions(\n  modelId: string,\n  capability: IAiImageModelCapability,\n  resolved: IResolvedImageOptions\n): Result<IResolvedImageOptions> {\n  // Validate count\n  if (capability.maxCount !== undefined && resolved.n > capability.maxCount) {\n    return fail(`model \"${modelId}\": count ${resolved.n} exceeds maximum of ${capability.maxCount}`);\n  }\n\n  // Validate size\n  if (capability.acceptedSizes !== undefined && resolved.size !== undefined) {\n    if (!capability.acceptedSizes.includes(resolved.size)) {\n      return fail(\n        `model \"${modelId}\": size \"${resolved.size}\" is not accepted; accepted values: ${JSON.stringify(\n          capability.acceptedSizes\n        )}`\n      );\n    }\n  }\n\n  // Validate quality\n  if (\n    capability.supportsQualityParam &&\n    capability.acceptedQualities !== undefined &&\n    resolved.quality !== undefined\n  ) {\n    if (!capability.acceptedQualities.includes(resolved.quality)) {\n      return fail(\n        `model \"${modelId}\": quality \"${resolved.quality}\" is not accepted; accepted values: ${JSON.stringify(\n          capability.acceptedQualities\n        )}`\n      );\n    }\n  }\n\n  return succeed(resolved);\n}\n"]}

package/dist/packlets/ai-assist/index.js

@@ -2,9 +2,17 @@
  * AI assist packlet - provider registry, prompt class, settings, and API client.
  * @packageDocumentation
  */
-export { AiPrompt, DEFAULT_AI_ASSIST, allModelSpecKeys, MODEL_SPEC_BASE_KEY, resolveModel } from './model';
-export { allProviderIds, getProviderDescriptors, getProviderDescriptor } from './registry';
-export { callProviderCompletion, callProxiedCompletion } from './apiClient';
-export { aiProviderId, aiServerToolType, aiWebSearchToolConfig, aiServerToolConfig, aiToolEnablement, aiAssistProviderConfig, aiAssistSettings, modelSpecKey, modelSpec } from './converters';
+export { AiPrompt, allModelCapabilities, DEFAULT_ANTHROPIC_MAX_TOKENS, DEFAULT_AI_ASSIST, providerApiKeySecretName, allModelSpecKeys, MODEL_SPEC_BASE_KEY, resolveModel, MODEL_ALIAS_SIGIL, resolveModelAlias, resolveProviderModel, isResponsesOnlyModel, isAdaptiveThinkingModel, usesMaxCompletionTokensField, toDataUrl } from './model';
+export { resolveImageOptions, validateResolvedOptions } from './imageOptionsResolver';
+export { allProviderIds, getProviderDescriptors, getProviderDescriptor, resolveImageCapability, supportsImageGeneration, resolveEmbeddingCapability, supportsEmbedding, DEFAULT_MODEL_CAPABILITY_CONFIG } from './registry';
+export { callProviderCompletion, callProxiedCompletion } from './completionClient';
+export { callProviderImageGeneration, callProxiedImageGeneration } from './imageGenerationClient';
+export { callProviderListModels, callProxiedListModels } from './listModelsClient';
+export { callProviderEmbedding, callProxiedEmbedding } from './embeddingClient';
+export { callProviderCompletionStream, callProxiedCompletionStream, executeClientToolTurn } from './streamingClient';
+export { aiProviderId, aiServerToolType, aiWebSearchToolConfig, aiServerToolConfig, aiToolAnnotations, aiClientToolConfig, aiToolEnablement, aiAssistProviderConfig, aiAssistSettings, modelSpecKey, modelSpec } from './converters';
 export { resolveEffectiveTools } from './toolFormats';
+export { classifyJsonParseFailure, extractJsonText, fencedStringifiedJson } from './jsonResponse';
+export { generateJsonCompletion, SMART_JSON_PROMPT_HINT } from './jsonCompletion';
+export { anthropicEffortToBudgetTokens } from './thinkingOptionsResolver';
 //# sourceMappingURL=index.js.map

package/dist/packlets/ai-assist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/ai-assist/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,QAAQ,EAER,oBAAoB,EAcpB,4BAA4B,EAe5B,iBAAiB,EAEjB,wBAAwB,EAoCxB,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,EAEZ,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,4BAA4B,EAC5B,SAAS,EAiBV,MAAM,SAAS,CAAC;AAEjB,OAAO,EAEL,mBAAmB,EACnB,uBAAuB,EACxB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,cAAc,EACd,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,0BAA0B,EAC1B,iBAAiB,EACjB,+BAA+B,EAChC,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EAEtB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,2BAA2B,EAC3B,0BAA0B,EAE3B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EAEtB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EAErB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,4BAA4B,EAC5B,2BAA2B,EAE3B,qBAAqB,EAItB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,EAChB,YAAY,EACZ,SAAS,EACV,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAEtD,OAAO,EACL,wBAAwB,EACxB,eAAe,EACf,qBAAqB,EAKtB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EAIvB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,6BAA6B,EAAgC,MAAM,2BAA2B,CAAC","sourcesContent":["/**\n * AI assist packlet - provider registry, prompt class, settings, and API client.\n * @packageDocumentation\n */\n\nexport {\n  AiPrompt,\n  type AiModelCapability,\n  allModelCapabilities,\n  type AiProviderId,\n  type AiServerToolType,\n  type AiServerToolConfig,\n  type AiToolConfig,\n  type IAiWebSearchToolConfig,\n  type IAiClientToolConfig,\n  type IAiToolAnnotations,\n  type IAiClientTool,\n  type IAiClientToolCallSummary,\n  type IAiClientToolContinuation,\n  type IAiClientToolTurnResult,\n  type IAiToolEnablement,\n  type IAiCompletionResponse,\n  DEFAULT_ANTHROPIC_MAX_TOKENS,\n  type IChatMessage,\n  type IChatRequest,\n  type AiApiFormat,\n  type AiImageApiFormat,\n  type AiEmbeddingApiFormat,\n  type AiEmbeddingTaskType,\n  type IAiEmbeddingModelCapability,\n  type IAiEmbeddingParams,\n  type IAiEmbeddingUsage,\n  type IAiEmbeddingResult,\n  type IAiImageModelCapability,\n  type IAiProviderDescriptor,\n  type IAiAssistProviderConfig,\n  type IAiAssistSettings,\n  DEFAULT_AI_ASSIST,\n  type IAiAssistKeyStore,\n  providerApiKeySecretName,\n  type IAiImageAttachment,\n  type IAiImageData,\n  type AiImageSize,\n  type AiImageQuality,\n  type GptImageSize,\n  type GptImageQuality,\n  type GptImageModelNames,\n  type GrokImagineModelNames,\n  type GeminiFlashImageModelNames,\n  type IGptImageGenerationConfig,\n  type IGrokImagineImageGenerationConfig,\n  type IGeminiFlashImageGenerationConfig,\n  type IGptImageModelOptions,\n  type IGrokImagineModelOptions,\n  type IGeminiFlashImageModelOptions,\n  type IOtherModelOptions,\n  type IModelFamilyConfig,\n  type IAiImageGenerationOptions,\n  type IAiImageGenerationParams,\n  type IAiGeneratedImage,\n  type IAiImageGenerationResponse,\n  type IAiModelCapabilityRule,\n  type IAiModelCapabilityConfig,\n  type IAiModelInfo,\n  type IAiStreamEvent,\n  type IAiStreamTextDelta,\n  type IAiStreamToolEvent,\n  type IAiStreamToolUseStart,\n  type IAiStreamToolUseDelta,\n  type IAiStreamToolUseComplete,\n  type IAiStreamDone,\n  type IAiStreamError,\n  type ModelSpec,\n  type ModelSpecKey,\n  type IModelSpecMap,\n  allModelSpecKeys,\n  MODEL_SPEC_BASE_KEY,\n  resolveModel,\n  type IModelAliasMap,\n  MODEL_ALIAS_SIGIL,\n  resolveModelAlias,\n  resolveProviderModel,\n  isResponsesOnlyModel,\n  isAdaptiveThinkingModel,\n  usesMaxCompletionTokensField,\n  toDataUrl,\n  type AiThinkingMode,\n  type IThinkingConfig,\n  type IThinkingProviderConfig,\n  type IAnthropicThinkingOptions,\n  type IOpenAiThinkingOptions,\n  type IGeminiThinkingOptions,\n  type IXAiThinkingOptions,\n  type IOtherThinkingOptions,\n  type IAnthropicThinkingConfig,\n  type IOpenAiThinkingConfig,\n  type IGeminiThinkingConfig,\n  type IXAiThinkingConfig,\n  type AnthropicThinkingModelNames,\n  type OpenAiThinkingModelNames,\n  type GeminiThinkingModelNames,\n  type XAiThinkingModelNames\n} from './model';\n\nexport {\n  type IResolvedImageOptions,\n  resolveImageOptions,\n  validateResolvedOptions\n} from './imageOptionsResolver';\n\nexport {\n  allProviderIds,\n  getProviderDescriptors,\n  getProviderDescriptor,\n  resolveImageCapability,\n  supportsImageGeneration,\n  resolveEmbeddingCapability,\n  supportsEmbedding,\n  DEFAULT_MODEL_CAPABILITY_CONFIG\n} from './registry';\n\nexport {\n  callProviderCompletion,\n  callProxiedCompletion,\n  type IProviderCompletionParams\n} from './completionClient';\n\nexport {\n  callProviderImageGeneration,\n  callProxiedImageGeneration,\n  type IProviderImageGenerationParams\n} from './imageGenerationClient';\n\nexport {\n  callProviderListModels,\n  callProxiedListModels,\n  type IProviderListModelsParams\n} from './listModelsClient';\n\nexport {\n  callProviderEmbedding,\n  callProxiedEmbedding,\n  type IProviderEmbeddingParams\n} from './embeddingClient';\n\nexport {\n  callProviderCompletionStream,\n  callProxiedCompletionStream,\n  type IProviderCompletionStreamParams,\n  executeClientToolTurn,\n  type IExecuteClientToolTurnParams,\n  type IExecuteClientToolTurnResult,\n  type IToolExecutionDecision\n} from './streamingClient';\n\nexport {\n  aiProviderId,\n  aiServerToolType,\n  aiWebSearchToolConfig,\n  aiServerToolConfig,\n  aiToolAnnotations,\n  aiClientToolConfig,\n  aiToolEnablement,\n  aiAssistProviderConfig,\n  aiAssistSettings,\n  modelSpecKey,\n  modelSpec\n} from './converters';\n\nexport { resolveEffectiveTools } from './toolFormats';\n\nexport {\n  classifyJsonParseFailure,\n  extractJsonText,\n  fencedStringifiedJson,\n  type IFencedStringifiedJsonExtractorOptions,\n  type IFencedStringifiedJsonOptions,\n  type JsonParseFailureReason,\n  type JsonTextExtractor\n} from './jsonResponse';\n\nexport {\n  generateJsonCompletion,\n  SMART_JSON_PROMPT_HINT,\n  type IGenerateJsonCompletionParams,\n  type IGenerateJsonCompletionResult,\n  type JsonPromptHint\n} from './jsonCompletion';\n\nexport { anthropicEffortToBudgetTokens, type IResolvedThinkingConfig } from './thinkingOptionsResolver';\n"]}

package/dist/packlets/ai-assist/jsonCompletion.js

@@ -0,0 +1,93 @@
+// Copyright (c) 2026 Erik Fortune
+//
+// Permission is hereby granted, free of charge, to any person obtaining a copy
+// of this software and associated documentation files (the "Software"), to deal
+// in the Software without restriction, including without limitation the rights
+// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the Software is
+// furnished to do so, subject to the following conditions:
+//
+// The above copyright notice and this permission notice shall be included in all
+// copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+// SOFTWARE.
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+/**
+ * `generateJsonCompletion<T>` — request a JSON-shaped completion from any
+ * provider supported by AiAssist and validate it against a caller-supplied
+ * `Converter<T>` or `Validator<T>`. Wraps fence/preamble tolerance + parsing +
+ * validation into a single call so consumers don't reinvent the pipeline.
+ *
+ * @packageDocumentation
+ */
+import { fail, succeed } from '@fgv/ts-utils';
+import { callProviderCompletion } from './completionClient';
+import { fencedStringifiedJson } from './jsonResponse';
+/**
+ * Default system-prompt suffix appended when {@link AiAssist.IGenerateJsonCompletionParams.promptHint}
+ * is `'smart'` (the default). Designed to discourage code fences and prose in
+ * the model's response while still tolerating them via the read-side extractor.
+ * @public
+ */
+export const SMART_JSON_PROMPT_HINT = 'Respond with raw JSON only — no Markdown code fences, no explanatory prose, ' +
+    'no preamble or trailing commentary. The response must parse with JSON.parse.';
+function applyPromptHint(system, hint) {
+    if (hint === 'none') {
+        return system;
+    }
+    const suffix = hint === 'smart' ? SMART_JSON_PROMPT_HINT : hint;
+    return system !== undefined && system.length > 0 ? `${system}\n\n${suffix}` : suffix;
+}
+/**
+ * Calls {@link AiAssist.callProviderCompletion}, then runs the response text
+ * through a tolerant JSON converter (default:
+ * {@link AiAssist.fencedStringifiedJson}) and the caller's
+ * `converter`/`validator`. Returns the validated value plus the raw text and
+ * underlying completion response for diagnostics.
+ *
+ * @remarks
+ * The default smart prompt hint asks the model to emit raw JSON. The read-side
+ * extractor still tolerates fences and prose, so models that ignore the hint
+ * are still handled.
+ *
+ * Either `converter` or `jsonConverter` must be provided; passing both lets
+ * `jsonConverter` win.
+ *
+ * @param params - Provider parameters plus JSON validation options.
+ * @returns The validated value, the raw text, and the underlying response.
+ * @public
+ */
+export async function generateJsonCompletion(params) {
+    const { converter, jsonConverter, promptHint = 'smart', system } = params, rest = __rest(params, ["converter", "jsonConverter", "promptHint", "system"]);
+    if (jsonConverter === undefined && converter === undefined) {
+        return fail('generateJsonCompletion: either converter or jsonConverter must be provided.');
+    }
+    const pipeline = jsonConverter !== null && jsonConverter !== void 0 ? jsonConverter : fencedStringifiedJson({ inner: converter });
+    const augmentedSystem = applyPromptHint(system, promptHint);
+    const response = await callProviderCompletion(Object.assign(Object.assign({}, rest), { system: augmentedSystem }));
+    if (response.isFailure()) {
+        return fail(response.message);
+    }
+    const completion = response.value;
+    return pipeline
+        .convert(completion.content)
+        .withErrorFormat((msg) => `generateJsonCompletion: ${msg}`)
+        .onSuccess((value) => succeed({ value, raw: completion.content, response: completion }));
+}
+//# sourceMappingURL=jsonCompletion.js.map

package/dist/packlets/ai-assist/jsonCompletion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonCompletion.js","sourceRoot":"","sources":["../../../src/packlets/ai-assist/jsonCompletion.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAClC,EAAE;AACF,+EAA+E;AAC/E,gFAAgF;AAChF,+EAA+E;AAC/E,4EAA4E;AAC5E,wEAAwE;AACxE,2DAA2D;AAC3D,EAAE;AACF,iFAAiF;AACjF,kDAAkD;AAClD,EAAE;AACF,6EAA6E;AAC7E,2EAA2E;AAC3E,8EAA8E;AAC9E,yEAAyE;AACzE,gFAAgF;AAChF,gFAAgF;AAChF,YAAY;;;;;;;;;;;;AAEZ;;;;;;;GAOG;AAEH,OAAO,EAAkB,IAAI,EAAU,OAAO,EAAkB,MAAM,eAAe,CAAC;AAEtF,OAAO,EAAE,sBAAsB,EAAkC,MAAM,oBAAoB,CAAC;AAC5F,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAGvD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GACjC,8EAA8E;IAC9E,8EAA8E,CAAC;AA6DjF,SAAS,eAAe,CAAC,MAA0B,EAAE,IAAoB;IACvE,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACpB,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,IAAI,CAAC;IAChE,OAAO,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,OAAO,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;AACvF,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,MAAwC;IAExC,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,GAAG,OAAO,EAAE,MAAM,KAAc,MAAM,EAAf,IAAI,UAAK,MAAM,EAA5E,sDAAmE,CAAS,CAAC;IAEnF,IAAI,aAAa,KAAK,SAAS,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC3D,OAAO,IAAI,CAAC,6EAA6E,CAAC,CAAC;IAC7F,CAAC;IAED,MAAM,QAAQ,GAAiB,aAAa,aAAb,aAAa,cAAb,aAAa,GAAI,qBAAqB,CAAI,EAAE,KAAK,EAAE,SAAU,EAAE,CAAC,CAAC;IAChG,MAAM,eAAe,GAAG,eAAe,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAE5D,MAAM,QAAQ,GAAG,MAAM,sBAAsB,iCAAM,IAAI,KAAE,MAAM,EAAE,eAAe,IAAG,CAAC;IACpF,IAAI,QAAQ,CAAC,SAAS,EAAE,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;IACD,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC;IAElC,OAAO,QAAQ;SACZ,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC;SAC3B,eAAe,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,2BAA2B,GAAG,EAAE,CAAC;SAC1D,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,UAAU,CAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;AAC7F,CAAC","sourcesContent":["// Copyright (c) 2026 Erik Fortune\n//\n// Permission is hereby granted, free of charge, to any person obtaining a copy\n// of this software and associated documentation files (the \"Software\"), to deal\n// in the Software without restriction, including without limitation the rights\n// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n// copies of the Software, and to permit persons to whom the Software is\n// furnished to do so, subject to the following conditions:\n//\n// The above copyright notice and this permission notice shall be included in all\n// copies or substantial portions of the Software.\n//\n// THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n// SOFTWARE.\n\n/**\n * `generateJsonCompletion<T>` — request a JSON-shaped completion from any\n * provider supported by AiAssist and validate it against a caller-supplied\n * `Converter<T>` or `Validator<T>`. Wraps fence/preamble tolerance + parsing +\n * validation into a single call so consumers don't reinvent the pipeline.\n *\n * @packageDocumentation\n */\n\nimport { type Converter, fail, Result, succeed, type Validator } from '@fgv/ts-utils';\n\nimport { callProviderCompletion, type IProviderCompletionParams } from './completionClient';\nimport { fencedStringifiedJson } from './jsonResponse';\nimport { type IAiCompletionResponse } from './model';\n\n/**\n * Default system-prompt suffix appended when {@link AiAssist.IGenerateJsonCompletionParams.promptHint}\n * is `'smart'` (the default). Designed to discourage code fences and prose in\n * the model's response while still tolerating them via the read-side extractor.\n * @public\n */\nexport const SMART_JSON_PROMPT_HINT: string =\n  'Respond with raw JSON only — no Markdown code fences, no explanatory prose, ' +\n  'no preamble or trailing commentary. The response must parse with JSON.parse.';\n\n/**\n * Controls the optional system-prompt augmentation applied by\n * {@link AiAssist.generateJsonCompletion}.\n *\n * - `'smart'` (default): append {@link AiAssist.SMART_JSON_PROMPT_HINT}.\n * - `'none'`: do not modify the prompt.\n * - A string: append the supplied text verbatim.\n *\n * @remarks\n * The `string & {}` branch is the standard TypeScript trick that prevents\n * the literal members from being widened away — callers still get\n * autocomplete for `'smart'` and `'none'` while accepting any string.\n *\n * @public\n */\nexport type JsonPromptHint = 'smart' | 'none' | (string & {});\n\n/**\n * Parameters for {@link AiAssist.generateJsonCompletion}. Extends\n * {@link AiAssist.IProviderCompletionParams} with JSON-validation knobs.\n * @public\n */\nexport interface IGenerateJsonCompletionParams<T> extends IProviderCompletionParams {\n  /**\n   * Caller-supplied `Converter<T>` or `Validator<T>` applied to the parsed\n   * JSON value. Wrapped internally in {@link AiAssist.fencedStringifiedJson}\n   * unless {@link AiAssist.IGenerateJsonCompletionParams.jsonConverter} is\n   * provided.\n   */\n  readonly converter?: Converter<T> | Validator<T>;\n\n  /**\n   * Full string-to-`T` pipeline override. When supplied, takes precedence over\n   * {@link AiAssist.IGenerateJsonCompletionParams.converter} and lets the\n   * caller plug in a custom extractor or skip the default fence tolerance\n   * entirely.\n   */\n  readonly jsonConverter?: Converter<T>;\n\n  /**\n   * Controls the optional system-prompt augmentation. Defaults to `'smart'`.\n   * Pass `'none'` to disable, or a string to append custom guidance.\n   */\n  readonly promptHint?: JsonPromptHint;\n}\n\n/**\n * Successful result of {@link AiAssist.generateJsonCompletion}.\n * @public\n */\nexport interface IGenerateJsonCompletionResult<T> {\n  /** The validated JSON value. */\n  readonly value: T;\n  /** The raw response text returned by the provider. */\n  readonly raw: string;\n  /** The full underlying completion response. */\n  readonly response: IAiCompletionResponse;\n}\n\nfunction applyPromptHint(system: string | undefined, hint: JsonPromptHint): string | undefined {\n  if (hint === 'none') {\n    return system;\n  }\n  const suffix = hint === 'smart' ? SMART_JSON_PROMPT_HINT : hint;\n  return system !== undefined && system.length > 0 ? `${system}\\n\\n${suffix}` : suffix;\n}\n\n/**\n * Calls {@link AiAssist.callProviderCompletion}, then runs the response text\n * through a tolerant JSON converter (default:\n * {@link AiAssist.fencedStringifiedJson}) and the caller's\n * `converter`/`validator`. Returns the validated value plus the raw text and\n * underlying completion response for diagnostics.\n *\n * @remarks\n * The default smart prompt hint asks the model to emit raw JSON. The read-side\n * extractor still tolerates fences and prose, so models that ignore the hint\n * are still handled.\n *\n * Either `converter` or `jsonConverter` must be provided; passing both lets\n * `jsonConverter` win.\n *\n * @param params - Provider parameters plus JSON validation options.\n * @returns The validated value, the raw text, and the underlying response.\n * @public\n */\nexport async function generateJsonCompletion<T>(\n  params: IGenerateJsonCompletionParams<T>\n): Promise<Result<IGenerateJsonCompletionResult<T>>> {\n  const { converter, jsonConverter, promptHint = 'smart', system, ...rest } = params;\n\n  if (jsonConverter === undefined && converter === undefined) {\n    return fail('generateJsonCompletion: either converter or jsonConverter must be provided.');\n  }\n\n  const pipeline: Converter<T> = jsonConverter ?? fencedStringifiedJson<T>({ inner: converter! });\n  const augmentedSystem = applyPromptHint(system, promptHint);\n\n  const response = await callProviderCompletion({ ...rest, system: augmentedSystem });\n  if (response.isFailure()) {\n    return fail(response.message);\n  }\n  const completion = response.value;\n\n  return pipeline\n    .convert(completion.content)\n    .withErrorFormat((msg) => `generateJsonCompletion: ${msg}`)\n    .onSuccess((value) => succeed({ value, raw: completion.content, response: completion }));\n}\n"]}