@marinoscar/platform-api 0.1.0-next.3 → 0.1.0-next.4

package/dist/ai/providers/ai-provider-definition.js

@@ -0,0 +1,219 @@
+"use strict";
+// =============================================================================
+// AI provider definitions: the `ai-provider` pluggable kind (PP-14.6, #924)
+// =============================================================================
+//
+// An AI provider is two things. The ADAPTER (`AiProviderAdapter`) talks to the
+// provider's API and registers itself in `AiProviderRegistry` from a Nest
+// module's `onModuleInit`. The DEFINITION (this file) is what the rest of the
+// slice needs to KNOW about the provider before any adapter runs: its id and
+// label, the Nest module that provides the adapter, the shape of its
+// non-secret settings, whether it needs a key and an endpoint, and which SDK
+// packages it may import. The admin settings page, the `ai` settings
+// namespace, the key routes and the conformance suites are all driven by the
+// definitions, so adding a provider needs no edit to any of them.
+//
+// The five built-in providers register through `registerAiProvider` exactly as
+// an app's provider does (`./builtin-ai-providers.ts`): no private fast path.
+//
+// FRAMEWORK-LIGHT, AND A LEAF: this file imports only the pluggable-kind
+// primitive, zod and the id pattern. It must stay importable from the
+// settings declaration and the config services without pulling a provider
+// module (and its SDK) in; the built-ins' module imports live in
+// `builtin-ai-providers.ts`.
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.aiProviderKind = exports.AI_PROVIDER_KEY_SECRET = void 0;
+exports.registerAiProvider = registerAiProvider;
+exports.aiProviderDefinitions = aiProviderDefinitions;
+exports.getAiProviderDefinition = getAiProviderDefinition;
+exports.requireAiProviderDefinition = requireAiProviderDefinition;
+exports.defaultAiProviderSlot = defaultAiProviderSlot;
+exports.describeAiProvider = describeAiProvider;
+exports.aiProviderSettingsFields = aiProviderSettingsFields;
+const ai_1 = require("@marinoscar/platform-contract/ai");
+const zod_1 = require("zod");
+const index_1 = require("../../core/index");
+/** Settings field names an `ai.providers.<id>` slot may never carry (a key is not a setting). */
+const SECRET_LOOKING_FIELDS = new Set(['secretAccessKey', 'secretKey', 'sessionToken', 'secret', 'password', 'apiKey', 'apiKeys', 'key', 'token'].map((name) => name.toLowerCase()));
+/** Fields the slot owns, not the provider. */
+const RESERVED_FIELDS = new Set(['enabled', 'haskey']);
+/**
+ * The name of the one secret every keyed provider declares (the deployment's
+ * key, stored by `PUT /api/admin/ai/providers/:provider/key`).
+ *
+ * @stability experimental
+ */
+exports.AI_PROVIDER_KEY_SECRET = 'apiKey';
+/**
+ * The `ai-provider` pluggable kind. Its instances are the definitions
+ * themselves; a slot is `{ enabled } & settings`, so the implementation
+ * registered in the kind has `enabled` as its first settings field. Use
+ * {@link registerAiProvider} and the helpers below rather than the kind
+ * directly.
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+exports.aiProviderKind = (0, index_1.definePluggableKind)({
+    kind: 'ai-provider',
+    label: 'AI provider',
+});
+function isConstructor(value) {
+    return typeof value === 'function';
+}
+function assertValidDefinition(def) {
+    const where = `AI provider "${def.id}"`;
+    if (typeof def.id !== 'string' || !ai_1.AI_PROVIDER_ID_PATTERN.test(def.id)) {
+        throw new Error(`Invalid AI provider id ${JSON.stringify(def.id)}: it must match ${ai_1.AI_PROVIDER_ID_PATTERN}.`);
+    }
+    if (typeof def.label !== 'string' || def.label.trim() === '')
+        throw new Error(`${where}: label must be a non-empty string.`);
+    if (!isConstructor(def.module))
+        throw new Error(`${where}: module must be the Nest module class that registers the adapter.`);
+    if (typeof def.requiresKey !== 'boolean')
+        throw new Error(`${where}: requiresKey must be a boolean.`);
+    if (typeof def.settingsSchema !== 'object' || def.settingsSchema === null || typeof def.settingsSchema.shape !== 'object') {
+        throw new Error(`${where}: settingsSchema must be a z.object(...).`);
+    }
+    for (const field of Object.keys(def.settingsSchema.shape)) {
+        const lowered = field.toLowerCase();
+        if (RESERVED_FIELDS.has(lowered)) {
+            throw new Error(`${where}: settingsSchema may not declare "${field}": the slot owns it.`);
+        }
+        if (SECRET_LOOKING_FIELDS.has(lowered)) {
+            throw new Error(`${where}: settingsSchema declares "${field}", which looks like a secret. A key is never a setting: ` +
+                'set requiresKey and the key is stored encrypted by PUT /api/admin/ai/providers/:provider/key.');
+        }
+    }
+    if (def.requiresBaseUrl === true && !('baseUrl' in def.settingsSchema.shape)) {
+        throw new Error(`${where}: requiresBaseUrl is set but settingsSchema declares no "baseUrl" field.`);
+    }
+    if (def.sdkPackages !== undefined && !(Array.isArray(def.sdkPackages) && def.sdkPackages.every((p) => typeof p === 'string' && p !== ''))) {
+        throw new Error(`${where}: sdkPackages must be an array of package names.`);
+    }
+}
+/** The slot schema: `enabled` first, then the provider's own fields. */
+function slotSchemaOf(def) {
+    return zod_1.z.object({
+        enabled: zod_1.z.boolean().meta({ label: 'Enabled' }).describe('Switch the provider on for this deployment.'),
+        ...def.settingsSchema.shape,
+    });
+}
+/**
+ * Registers an AI provider. Call it at import time, before the application
+ * bootstraps and before `AiModule.forRoot()` is called (the reference app does
+ * it from `apps/api/src/app-registrations/ai.ts`, which `platform/ai/ai.config.ts`
+ * imports first). The five built-in providers register through this same
+ * function.
+ *
+ * Registering is all it takes: the `ai` settings namespace gains a slot for the
+ * id, `GET /api/admin/ai/config` describes it (`descriptors`, and a
+ * generated form on the admin page), the key routes and the user-key and
+ * organization-key pages list it, and `AiModule.forRoot` imports its module.
+ *
+ * @param def - the provider.
+ * @throws Error when the definition is malformed (an id that does not match the pattern, a secret-looking settings field, a default that does not parse).
+ * @throws RegistryError `DUPLICATE_ID` when the id is registered, `FROZEN` after the application bootstrapped.
+ *
+ * @example
+ * ```ts
+ * registerAiProvider({
+ *   id: 'example-transcribe',
+ *   label: 'Example Transcribe',
+ *   module: ExampleTranscribeModule,
+ *   settingsSchema: z.object({ region: z.enum(['us', 'eu']).default('us').describe('Processing region') }),
+ *   defaults: { region: 'us' },
+ *   requiresKey: true,
+ * });
+ * ```
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+function registerAiProvider(def) {
+    assertValidDefinition(def);
+    const slot = slotSchemaOf(def);
+    const defaults = { enabled: false, ...def.defaults };
+    const parsedDefaults = slot.safeParse(defaults);
+    if (!parsedDefaults.success) {
+        throw new Error(`AI provider "${def.id}": defaults do not parse with settingsSchema: ` +
+            parsedDefaults.error.issues.map((issue) => `${issue.path.join('.') || '(root)'}: ${issue.message}`).join('; '));
+    }
+    const implementation = {
+        id: def.id,
+        label: def.label,
+        ...(def.description === undefined ? {} : { description: def.description }),
+        settingsSchema: slot,
+        defaults: parsedDefaults.data,
+        secrets: def.requiresKey ? [{ name: exports.AI_PROVIDER_KEY_SECRET, label: 'API key', required: true, ...(def.help?.key ? { help: def.help.key } : {}) }] : [],
+        build: () => def,
+    };
+    exports.aiProviderKind.register(implementation);
+}
+/**
+ * Every registered AI provider definition, in registration order (the order
+ * the admin page lists them: the built-ins first).
+ *
+ * @stability experimental
+ */
+function aiProviderDefinitions() {
+    return exports.aiProviderKind.list().map((impl) => definitionOfImplementation(impl));
+}
+/**
+ * The definition registered under `id`, or `undefined`.
+ *
+ * @param id - the provider id.
+ * @stability experimental
+ */
+function getAiProviderDefinition(id) {
+    return exports.aiProviderKind.has(id) ? definitionOfImplementation(exports.aiProviderKind.get(id)) : undefined;
+}
+/**
+ * The definition registered under `id`.
+ *
+ * @param id - the provider id.
+ * @throws PluggableUnknownError when none is registered; the message names the registered ids and how to register one.
+ * @stability experimental
+ */
+function requireAiProviderDefinition(id) {
+    return definitionOfImplementation(exports.aiProviderKind.get(id));
+}
+function definitionOfImplementation(impl) {
+    return impl.build({ settings: {}, secret: async () => null });
+}
+/**
+ * A fresh slot for `id`: `enabled: false` and the provider's defaults.
+ *
+ * @param id - a registered provider id.
+ * @throws PluggableUnknownError when `id` is not registered.
+ * @stability experimental
+ */
+function defaultAiProviderSlot(id) {
+    return structuredClone(exports.aiProviderKind.parseSettings(id, {}));
+}
+/**
+ * The descriptor of one registered provider for a generated form: its
+ * `enabled` switch and settings fields, then (when it needs a key) a
+ * write-only `apiKey` secret field that carries only whether a key is stored.
+ *
+ * @param id - a registered provider id.
+ * @param hasKey - whether the deployment stores a key for it.
+ * @throws PluggableUnknownError when `id` is not registered.
+ * @stability experimental
+ */
+function describeAiProvider(id, hasKey) {
+    return exports.aiProviderKind.describe(id, { secrets: { [exports.AI_PROVIDER_KEY_SECRET]: hasKey } });
+}
+/**
+ * The settings field names `id`'s slot accepts besides `enabled`; empty for an
+ * id with no definition.
+ *
+ * @param id - the provider id.
+ * @stability experimental
+ */
+function aiProviderSettingsFields(id) {
+    const def = getAiProviderDefinition(id);
+    return def ? Object.keys(def.settingsSchema.shape) : [];
+}
+//# sourceMappingURL=ai-provider-definition.js.map

package/dist/ai/providers/ai-provider-definition.js.map

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

package/dist/ai/providers/anthropic/anthropic-client.factory.d.ts

@@ -0,0 +1,20 @@
+import { Anthropic } from '@anthropic-ai/sdk';
+import type { AiCallContext } from '../../core/provider-adapter.interface';
+export declare const ANTHROPIC_DEFAULT_BASE_URL = "https://api.anthropic.com";
+/** A generous ceiling for one request; long extended-thinking turns take minutes. */
+export declare const ANTHROPIC_DEFAULT_TIMEOUT_MS: number;
+/** The `fetch` the SDK uses. Tests inject a mocked one; production uses the global. */
+export type AnthropicFetch = (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
+export interface AnthropicClientOptions {
+    fetch?: AnthropicFetch;
+    timeoutMs?: number;
+}
+/** DI token for `AnthropicClientOptions` (optional; tests and forks provide it). */
+export declare const ANTHROPIC_CLIENT_OPTIONS: unique symbol;
+export declare class AnthropicClientFactory {
+    private readonly options;
+    constructor(options?: AnthropicClientOptions);
+    /** The SDK client for one call. Throws `AI_KEY_INVALID` for an empty key. */
+    create(ctx: AiCallContext): Anthropic;
+}
+//# sourceMappingURL=anthropic-client.factory.d.ts.map

package/dist/ai/providers/anthropic/anthropic-client.factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic-client.factory.d.ts","sourceRoot":"","sources":["../../../../src/ai/providers/anthropic/anthropic-client.factory.ts"],"names":[],"mappings":"AA2BA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAI9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAG3E,eAAO,MAAM,0BAA0B,8BAA8B,CAAC;AAEtE,qFAAqF;AACrF,eAAO,MAAM,4BAA4B,QAAiB,CAAC;AAE3D,uFAAuF;AACvF,MAAM,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEtG,MAAM,WAAW,sBAAsB;IACrC,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,oFAAoF;AACpF,eAAO,MAAM,wBAAwB,eAAqC,CAAC;AAE3E,qBACa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;gBAES,OAAO,CAAC,EAAE,sBAAsB;IAI1F,6EAA6E;IAC7E,MAAM,CAAC,GAAG,EAAE,aAAa,GAAG,SAAS;CAoBtC"}

package/dist/ai/providers/anthropic/anthropic-client.factory.js

@@ -0,0 +1,84 @@
+"use strict";
+// =============================================================================
+// Anthropic SDK client factory (issue #446, epic #421)
+// =============================================================================
+//
+// One client PER CALL, built from that call's `AiCallContext` — the same
+// shape as `OpenAiClientFactory`, for the same reason: the key is resolved
+// per call (org key or the user's own), so a long-lived client holding one
+// key would be the wrong shape.
+//
+// Every credential and endpoint the SDK would otherwise discover on its own
+// is pinned explicitly. There is no `ANTHROPIC_API_KEY` / `ANTHROPIC_BASE_URL`
+// configuration in this application (docs/specs/ai-platform.md §2.1), and the
+// SDK's credential chain (`ANTHROPIC_AUTH_TOKEN`, an `ant auth login` profile,
+// workload identity federation) must never silently decide which account a
+// call bills: passing `apiKey` explicitly short-circuits that whole chain
+// (the SDK resolves no default credentials once `apiKey` is set), and
+// `authToken: null` keeps an ambient bearer token off the request.
+//
+// `maxRetries: 0` — retries are the caller's job (the queue for a job, the
+// user for an interactive call); the SDK retrying a 429/529 underneath would
+// multiply every attempt and hide the throttle from `toRateLimitError()`.
+//
+// An explicit `timeout` also disables the SDK's "streaming is required"
+// pre-check for a large non-streaming `max_tokens`: the adapter sizes
+// `max_tokens` itself (see `anthropic-model-catalog.ts`).
+// =============================================================================
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AnthropicClientFactory = exports.ANTHROPIC_CLIENT_OPTIONS = exports.ANTHROPIC_DEFAULT_TIMEOUT_MS = exports.ANTHROPIC_DEFAULT_BASE_URL = void 0;
+const sdk_1 = require("@anthropic-ai/sdk");
+const common_1 = require("@nestjs/common");
+const ai_error_1 = require("../../core/ai-error");
+const anthropic_errors_1 = require("./anthropic-errors");
+exports.ANTHROPIC_DEFAULT_BASE_URL = 'https://api.anthropic.com';
+/** A generous ceiling for one request; long extended-thinking turns take minutes. */
+exports.ANTHROPIC_DEFAULT_TIMEOUT_MS = 10 * 60 * 1000;
+/** DI token for `AnthropicClientOptions` (optional; tests and forks provide it). */
+exports.ANTHROPIC_CLIENT_OPTIONS = Symbol('ANTHROPIC_CLIENT_OPTIONS');
+let AnthropicClientFactory = class AnthropicClientFactory {
+    options;
+    constructor(options) {
+        this.options = options ?? {};
+    }
+    /** The SDK client for one call. Throws `AI_KEY_INVALID` for an empty key. */
+    create(ctx) {
+        if (!ctx.apiKey || ctx.apiKey.trim().length === 0) {
+            throw new ai_error_1.AiError('AI_KEY_INVALID', 'No Anthropic API key was supplied.', {
+                details: { provider: anthropic_errors_1.ANTHROPIC_PROVIDER_ID },
+            });
+        }
+        return new sdk_1.Anthropic({
+            apiKey: ctx.apiKey,
+            authToken: null,
+            webhookKey: null,
+            baseURL: ctx.baseUrl ?? exports.ANTHROPIC_DEFAULT_BASE_URL,
+            maxRetries: 0,
+            timeout: this.options.timeoutMs ?? exports.ANTHROPIC_DEFAULT_TIMEOUT_MS,
+            // The SDK's own logger writes to the console and, at debug level, the
+            // request — never let an ambient ANTHROPIC_LOG turn that on.
+            logLevel: 'off',
+            ...(this.options.fetch ? { fetch: this.options.fetch } : {}),
+        });
+    }
+};
+exports.AnthropicClientFactory = AnthropicClientFactory;
+exports.AnthropicClientFactory = AnthropicClientFactory = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Optional)()),
+    __param(0, (0, common_1.Inject)(exports.ANTHROPIC_CLIENT_OPTIONS)),
+    __metadata("design:paramtypes", [Object])
+], AnthropicClientFactory);
+//# sourceMappingURL=anthropic-client.factory.js.map

package/dist/ai/providers/anthropic/anthropic-client.factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic-client.factory.js","sourceRoot":"","sources":["../../../../src/ai/providers/anthropic/anthropic-client.factory.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,uDAAuD;AACvD,gFAAgF;AAChF,EAAE;AACF,yEAAyE;AACzE,2EAA2E;AAC3E,2EAA2E;AAC3E,gCAAgC;AAChC,EAAE;AACF,4EAA4E;AAC5E,+EAA+E;AAC/E,8EAA8E;AAC9E,+EAA+E;AAC/E,2EAA2E;AAC3E,0EAA0E;AAC1E,sEAAsE;AACtE,mEAAmE;AACnE,EAAE;AACF,2EAA2E;AAC3E,6EAA6E;AAC7E,0EAA0E;AAC1E,EAAE;AACF,wEAAwE;AACxE,sEAAsE;AACtE,0DAA0D;AAC1D,gFAAgF;;;;;;;;;;;;;;;AAEhF,2CAA8C;AAC9C,2CAA8D;AAE9D,kDAA8C;AAE9C,yDAA2D;AAE9C,QAAA,0BAA0B,GAAG,2BAA2B,CAAC;AAEtE,qFAAqF;AACxE,QAAA,4BAA4B,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAU3D,oFAAoF;AACvE,QAAA,wBAAwB,GAAG,MAAM,CAAC,0BAA0B,CAAC,CAAC;AAGpE,IAAM,sBAAsB,GAA5B,MAAM,sBAAsB;IAChB,OAAO,CAAyB;IAEjD,YAA0D,OAAgC;QACxF,IAAI,CAAC,OAAO,GAAG,OAAO,IAAI,EAAE,CAAC;IAC/B,CAAC;IAED,6EAA6E;IAC7E,MAAM,CAAC,GAAkB;QACvB,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClD,MAAM,IAAI,kBAAO,CAAC,gBAAgB,EAAE,oCAAoC,EAAE;gBACxE,OAAO,EAAE,EAAE,QAAQ,EAAE,wCAAqB,EAAE;aAC7C,CAAC,CAAC;QACL,CAAC;QAED,OAAO,IAAI,eAAS,CAAC;YACnB,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,SAAS,EAAE,IAAI;YACf,UAAU,EAAE,IAAI;YAChB,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,kCAA0B;YAClD,UAAU,EAAE,CAAC;YACb,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,oCAA4B;YAC/D,sEAAsE;YACtE,6DAA6D;YAC7D,QAAQ,EAAE,KAAK;YACf,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AA5BY,wDAAsB;iCAAtB,sBAAsB;IADlC,IAAA,mBAAU,GAAE;IAIE,WAAA,IAAA,iBAAQ,GAAE,CAAA;IAAE,WAAA,IAAA,eAAM,EAAC,gCAAwB,CAAC,CAAA;;GAH9C,sBAAsB,CA4BlC"}

package/dist/ai/providers/anthropic/anthropic-errors.d.ts

@@ -0,0 +1,16 @@
+import { AiError, AiErrorCode } from '../../core/ai-error';
+export declare const ANTHROPIC_PROVIDER_ID = "anthropic";
+/** The generic, secret-free message this adapter uses for `code`. */
+export declare function anthropicErrorMessage(code: AiErrorCode): string;
+/** Classifies an Anthropic error `type` (from a body or a stream `error` frame). */
+export declare function classifyAnthropicErrorType(type: string | null | undefined): AiErrorCode;
+/** The provider's requested back-off, from the standard `retry-after` header. */
+export declare function anthropicRetryAfter(headers: Headers | undefined): number | undefined;
+/** Which `AiErrorCode` an SDK error means. Pure — exported for the table spec. */
+export declare function anthropicErrorCode(err: unknown): AiErrorCode;
+/**
+ * Turns anything an Anthropic call threw into an `AiError`. An `AiError` is
+ * returned unchanged (the mapper's own `AI_CAPABILITY_UNSUPPORTED`, for one).
+ */
+export declare function mapAnthropicError(err: unknown): AiError;
+//# sourceMappingURL=anthropic-errors.d.ts.map

package/dist/ai/providers/anthropic/anthropic-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic-errors.d.ts","sourceRoot":"","sources":["../../../../src/ai/providers/anthropic/anthropic-errors.ts"],"names":[],"mappings":"AAyCA,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAG3D,eAAO,MAAM,qBAAqB,cAAc,CAAC;AAoBjD,qEAAqE;AACrE,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAE/D;AAED,oFAAoF;AACpF,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,WAAW,CAiBvF;AAED,iFAAiF;AACjF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAEpF;AAED,kFAAkF;AAClF,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,WAAW,CA2B5D;AAMD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CA0BvD"}

package/dist/ai/providers/anthropic/anthropic-errors.js

@@ -0,0 +1,156 @@
+"use strict";
+// =============================================================================
+// Anthropic SDK error -> AiError (issue #446, epic #421)
+// =============================================================================
+//
+// The one place an Anthropic SDK failure becomes an `AiError` — the exact
+// counterpart of `openai-errors.ts`, and for the same reasons: every `catch`
+// in this adapter funnels through `mapAnthropicError`, so a raw SDK exception
+// never crosses the `AiProviderAdapter` boundary (the conformance kit asserts
+// it) and one provider condition cannot surface as two codes.
+//
+// ⚠ SECRETS. The SDK's own `message` is never copied into the `AiError`: it
+// is the provider's text, and a provider's text can echo request details.
+// What travels in `details` is short machine-readable metadata only — the
+// HTTP status, Anthropic's error `type` (`rate_limit_error`, ...) and its
+// request id. The SDK error is kept as the non-enumerable `cause`.
+//
+// THE TABLE (pinned by `anthropic-errors.spec.ts`):
+//
+//   401 authentication_error         AI_KEY_INVALID
+//   403 permission_error             AI_MODEL_NOT_REACHABLE  (the key may not use it)
+//   404 not_found_error              AI_MODEL_NOT_REACHABLE  (Messages' only 404 is the model)
+//   402 billing_error                AI_RATE_LIMITED         (OpenAI's `insufficient_quota` precedent)
+//   429 rate_limit_error             AI_RATE_LIMITED, with `retry-after`
+//   529 overloaded_error / 5xx / 408 AI_PROVIDER_UNAVAILABLE (with `retry-after` when named)
+//   400/409/413/422                  AI_INVALID_REQUEST
+//   abort (APIUserAbortError)        AI_PROVIDER_UNAVAILABLE, details.aborted — as OpenAI's
+//   connection / timeout             AI_PROVIDER_UNAVAILABLE, details.transport
+//
+// A mid-stream `event: error` frame has no HTTP status; the SDK raises it as a
+// status-less `APIError` whose `type` is the body's `error.type`, classified by
+// the same table.
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ANTHROPIC_PROVIDER_ID = void 0;
+exports.anthropicErrorMessage = anthropicErrorMessage;
+exports.classifyAnthropicErrorType = classifyAnthropicErrorType;
+exports.anthropicRetryAfter = anthropicRetryAfter;
+exports.anthropicErrorCode = anthropicErrorCode;
+exports.mapAnthropicError = mapAnthropicError;
+const sdk_1 = require("@anthropic-ai/sdk");
+const ai_error_1 = require("../../core/ai-error");
+const index_1 = require("../../../jobs/index");
+exports.ANTHROPIC_PROVIDER_ID = 'anthropic';
+const MESSAGES = {
+    AI_DISABLED: 'AI is disabled.',
+    AI_PROVIDER_DISABLED: 'The AI provider is disabled.',
+    AI_KEY_REQUIRED: 'An API key is required for this AI provider.',
+    AI_KEY_INVALID: 'The Anthropic API key was rejected.',
+    AI_MODEL_NOT_ENABLED: 'The model is not enabled.',
+    AI_MODEL_NOT_REACHABLE: 'The Anthropic model is not reachable with this API key.',
+    AI_CAPABILITY_UNSUPPORTED: 'The request uses a capability Anthropic does not support here.',
+    AI_TOOL_DISABLED: 'The requested tool is not enabled in this deployment.',
+    AI_REALTIME_DISABLED: 'Realtime sessions are not enabled in this deployment.',
+    AI_RATE_LIMITED: 'Anthropic rate-limited the request.',
+    AI_PROVIDER_UNAVAILABLE: 'Anthropic is unavailable or the request failed.',
+    AI_CONTENT_FILTERED: 'Anthropic refused the request.',
+    AI_INVALID_REQUEST: 'Anthropic rejected the request as invalid.',
+    AI_STRUCTURED_OUTPUT_INVALID: 'The model output does not match the requested schema.',
+    AI_STORAGE_UNAVAILABLE: 'Object storage is unavailable.',
+};
+/** The generic, secret-free message this adapter uses for `code`. */
+function anthropicErrorMessage(code) {
+    return MESSAGES[code];
+}
+/** Classifies an Anthropic error `type` (from a body or a stream `error` frame). */
+function classifyAnthropicErrorType(type) {
+    switch (type) {
+        case 'authentication_error':
+            return 'AI_KEY_INVALID';
+        case 'permission_error':
+        case 'not_found_error':
+            return 'AI_MODEL_NOT_REACHABLE';
+        case 'rate_limit_error':
+        case 'billing_error':
+            return 'AI_RATE_LIMITED';
+        case 'invalid_request_error':
+        case 'request_too_large':
+            return 'AI_INVALID_REQUEST';
+        default:
+            // overloaded_error, api_error, timeout_error, anything unknown.
+            return 'AI_PROVIDER_UNAVAILABLE';
+    }
+}
+/** The provider's requested back-off, from the standard `retry-after` header. */
+function anthropicRetryAfter(headers) {
+    return (0, index_1.parseRetryAfterMs)(headers?.get('retry-after') ?? null) ?? undefined;
+}
+/** Which `AiErrorCode` an SDK error means. Pure — exported for the table spec. */
+function anthropicErrorCode(err) {
+    if (err instanceof ai_error_1.AiError)
+        return err.code;
+    // Subclasses before their parents: both extend APIError.
+    if (err instanceof sdk_1.APIUserAbortError)
+        return 'AI_PROVIDER_UNAVAILABLE';
+    if (err instanceof sdk_1.APIConnectionError)
+        return 'AI_PROVIDER_UNAVAILABLE';
+    if (err instanceof sdk_1.APIError) {
+        const status = err.status;
+        if (typeof status === 'number') {
+            if (status === 401)
+                return 'AI_KEY_INVALID';
+            if (status === 402)
+                return 'AI_RATE_LIMITED';
+            if (status === 403 || status === 404)
+                return 'AI_MODEL_NOT_REACHABLE';
+            if (status === 429)
+                return 'AI_RATE_LIMITED';
+            if (status === 408 || status >= 500)
+                return 'AI_PROVIDER_UNAVAILABLE';
+            if (status >= 400)
+                return 'AI_INVALID_REQUEST';
+        }
+        return classifyAnthropicErrorType(err.type);
+    }
+    // Any other SDK error (a malformed SSE frame, "streaming required", ...),
+    // a fetch/socket failure, anything else.
+    if (err instanceof sdk_1.AnthropicError)
+        return 'AI_PROVIDER_UNAVAILABLE';
+    return 'AI_PROVIDER_UNAVAILABLE';
+}
+function stringOrUndefined(value) {
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+/**
+ * Turns anything an Anthropic call threw into an `AiError`. An `AiError` is
+ * returned unchanged (the mapper's own `AI_CAPABILITY_UNSUPPORTED`, for one).
+ */
+function mapAnthropicError(err) {
+    if (err instanceof ai_error_1.AiError)
+        return err;
+    const code = anthropicErrorCode(err);
+    const details = { provider: exports.ANTHROPIC_PROVIDER_ID };
+    let retryAfterMs;
+    if (err instanceof sdk_1.APIUserAbortError) {
+        details.aborted = true;
+    }
+    else if (err instanceof sdk_1.APIConnectionError) {
+        details.transport = err instanceof sdk_1.APIConnectionTimeoutError ? 'timeout' : 'connection';
+    }
+    else if (err instanceof sdk_1.APIError) {
+        if (typeof err.status === 'number')
+            details.status = err.status;
+        const providerType = stringOrUndefined(err.type);
+        const providerRequestId = stringOrUndefined(err.requestID);
+        if (providerType)
+            details.providerType = providerType;
+        if (providerRequestId)
+            details.providerRequestId = providerRequestId;
+        if (code === 'AI_RATE_LIMITED' || code === 'AI_PROVIDER_UNAVAILABLE') {
+            retryAfterMs = anthropicRetryAfter(err.headers);
+        }
+    }
+    return new ai_error_1.AiError(code, anthropicErrorMessage(code), { cause: err, details, retryAfterMs });
+}
+//# sourceMappingURL=anthropic-errors.js.map

package/dist/ai/providers/anthropic/anthropic-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic-errors.js","sourceRoot":"","sources":["../../../../src/ai/providers/anthropic/anthropic-errors.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,yDAAyD;AACzD,gFAAgF;AAChF,EAAE;AACF,0EAA0E;AAC1E,6EAA6E;AAC7E,8EAA8E;AAC9E,8EAA8E;AAC9E,8DAA8D;AAC9D,EAAE;AACF,4EAA4E;AAC5E,0EAA0E;AAC1E,0EAA0E;AAC1E,0EAA0E;AAC1E,mEAAmE;AACnE,EAAE;AACF,oDAAoD;AACpD,EAAE;AACF,oDAAoD;AACpD,sFAAsF;AACtF,+FAA+F;AAC/F,uGAAuG;AACvG,yEAAyE;AACzE,6FAA6F;AAC7F,wDAAwD;AACxD,4FAA4F;AAC5F,gFAAgF;AAChF,EAAE;AACF,+EAA+E;AAC/E,gFAAgF;AAChF,kBAAkB;AAClB,gFAAgF;;;AAkChF,sDAEC;AAGD,gEAiBC;AAGD,kDAEC;AAGD,gDA2BC;AAUD,8CA0BC;AA7HD,2CAM2B;AAE3B,kDAA2D;AAC3D,+CAAwD;AAE3C,QAAA,qBAAqB,GAAG,WAAW,CAAC;AAEjD,MAAM,QAAQ,GAAgC;IAC5C,WAAW,EAAE,iBAAiB;IAC9B,oBAAoB,EAAE,8BAA8B;IACpD,eAAe,EAAE,8CAA8C;IAC/D,cAAc,EAAE,qCAAqC;IACrD,oBAAoB,EAAE,2BAA2B;IACjD,sBAAsB,EAAE,yDAAyD;IACjF,yBAAyB,EAAE,gEAAgE;IAC3F,gBAAgB,EAAE,uDAAuD;IACzE,oBAAoB,EAAE,uDAAuD;IAC7E,eAAe,EAAE,qCAAqC;IACtD,uBAAuB,EAAE,iDAAiD;IAC1E,mBAAmB,EAAE,gCAAgC;IACrD,kBAAkB,EAAE,4CAA4C;IAChE,4BAA4B,EAAE,uDAAuD;IACrF,sBAAsB,EAAE,gCAAgC;CACzD,CAAC;AAEF,qEAAqE;AACrE,SAAgB,qBAAqB,CAAC,IAAiB;IACrD,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC;AAED,oFAAoF;AACpF,SAAgB,0BAA0B,CAAC,IAA+B;IACxE,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,sBAAsB;YACzB,OAAO,gBAAgB,CAAC;QAC1B,KAAK,kBAAkB,CAAC;QACxB,KAAK,iBAAiB;YACpB,OAAO,wBAAwB,CAAC;QAClC,KAAK,kBAAkB,CAAC;QACxB,KAAK,eAAe;YAClB,OAAO,iBAAiB,CAAC;QAC3B,KAAK,uBAAuB,CAAC;QAC7B,KAAK,mBAAmB;YACtB,OAAO,oBAAoB,CAAC;QAC9B;YACE,gEAAgE;YAChE,OAAO,yBAAyB,CAAC;IACrC,CAAC;AACH,CAAC;AAED,iFAAiF;AACjF,SAAgB,mBAAmB,CAAC,OAA4B;IAC9D,OAAO,IAAA,yBAAiB,EAAC,OAAO,EAAE,GAAG,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC,IAAI,SAAS,CAAC;AAC7E,CAAC;AAED,kFAAkF;AAClF,SAAgB,kBAAkB,CAAC,GAAY;IAC7C,IAAI,GAAG,YAAY,kBAAO;QAAE,OAAO,GAAG,CAAC,IAAI,CAAC;IAE5C,yDAAyD;IACzD,IAAI,GAAG,YAAY,uBAAiB;QAAE,OAAO,yBAAyB,CAAC;IACvE,IAAI,GAAG,YAAY,wBAAkB;QAAE,OAAO,yBAAyB,CAAC;IAExE,IAAI,GAAG,YAAY,cAAQ,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;QAE1B,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC/B,IAAI,MAAM,KAAK,GAAG;gBAAE,OAAO,gBAAgB,CAAC;YAC5C,IAAI,MAAM,KAAK,GAAG;gBAAE,OAAO,iBAAiB,CAAC;YAC7C,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG;gBAAE,OAAO,wBAAwB,CAAC;YACtE,IAAI,MAAM,KAAK,GAAG;gBAAE,OAAO,iBAAiB,CAAC;YAC7C,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,IAAI,GAAG;gBAAE,OAAO,yBAAyB,CAAC;YACtE,IAAI,MAAM,IAAI,GAAG;gBAAE,OAAO,oBAAoB,CAAC;QACjD,CAAC;QAED,OAAO,0BAA0B,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9C,CAAC;IAED,0EAA0E;IAC1E,yCAAyC;IACzC,IAAI,GAAG,YAAY,oBAAc;QAAE,OAAO,yBAAyB,CAAC;IAEpE,OAAO,yBAAyB,CAAC;AACnC,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAc;IACvC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3E,CAAC;AAED;;;GAGG;AACH,SAAgB,iBAAiB,CAAC,GAAY;IAC5C,IAAI,GAAG,YAAY,kBAAO;QAAE,OAAO,GAAG,CAAC;IAEvC,MAAM,IAAI,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACrC,MAAM,OAAO,GAA4B,EAAE,QAAQ,EAAE,6BAAqB,EAAE,CAAC;IAC7E,IAAI,YAAgC,CAAC;IAErC,IAAI,GAAG,YAAY,uBAAiB,EAAE,CAAC;QACrC,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IACzB,CAAC;SAAM,IAAI,GAAG,YAAY,wBAAkB,EAAE,CAAC;QAC7C,OAAO,CAAC,SAAS,GAAG,GAAG,YAAY,+BAAyB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC;IAC1F,CAAC;SAAM,IAAI,GAAG,YAAY,cAAQ,EAAE,CAAC;QACnC,IAAI,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ;YAAE,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;QAEhE,MAAM,YAAY,GAAG,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjD,MAAM,iBAAiB,GAAG,iBAAiB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAE3D,IAAI,YAAY;YAAE,OAAO,CAAC,YAAY,GAAG,YAAY,CAAC;QACtD,IAAI,iBAAiB;YAAE,OAAO,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;QAErE,IAAI,IAAI,KAAK,iBAAiB,IAAI,IAAI,KAAK,yBAAyB,EAAE,CAAC;YACrE,YAAY,GAAG,mBAAmB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED,OAAO,IAAI,kBAAO,CAAC,IAAI,EAAE,qBAAqB,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC;AAC/F,CAAC"}

package/dist/ai/providers/anthropic/anthropic-messages.mapper.d.ts

@@ -0,0 +1,80 @@
+import type { ContentBlock, Message, MessageCreateParamsBase, RedactedThinkingBlockParam, StopReason, ThinkingBlockParam, Usage } from '@anthropic-ai/sdk/resources/messages/messages';
+import type { AiStorageInputModality } from '../../core/types/file-inputs.types';
+import { type AiOutputItem, type AiReasoningItem, type AiResponse, type AiResponseRequest, type AiUsage } from '../../core/types/responses.types';
+import { type AnthropicModelProfile } from './anthropic-model-catalog';
+/** The request body minus `stream`, which the port sets. */
+export type AnthropicRequestBody = Omit<MessageCreateParamsBase, 'stream'>;
+/** The signed / encrypted thinking blocks a reasoning item replays. */
+export type AnthropicThinkingBlock = ThinkingBlockParam | RedactedThinkingBlockParam;
+/** What `AI_PROVIDER_STATE.data` holds for an Anthropic reasoning item. */
+export interface AnthropicReasoningState {
+    blocks: AnthropicThinkingBlock[];
+}
+/**
+ * How one storage-object input reached Anthropic (#441): a presigned URL
+ * Anthropic fetches (images), or the bytes inline (documents). ⚠ `url` may be
+ * presigned — it goes into the request body and nowhere else.
+ */
+export interface AnthropicStorageDelivery {
+    modality: AiStorageInputModality;
+    mimeType: string;
+    filename: string;
+    url?: string;
+    data?: Uint8Array;
+}
+/** Deliveries keyed by storage object id. */
+export type AnthropicStorageDeliveries = ReadonlyMap<string, AnthropicStorageDelivery>;
+/**
+ * What the request mapper decided that the response mapper must know: the
+ * name of the forced structured-output tool, when that path was taken.
+ */
+export interface AnthropicRequestPlan {
+    body: AnthropicRequestBody;
+    structuredToolName?: string;
+}
+/** Every storage object id `req` names, in order, each once. */
+export declare function anthropicStorageObjectIds(req: AiResponseRequest): string[];
+/** The thinking blocks an Anthropic reasoning item carries, or `[]`. */
+export declare function anthropicReasoningBlocks(item: AiReasoningItem): AnthropicThinkingBlock[];
+/**
+ * Builds the Anthropic request body for `req`.
+ *
+ * `profile` is the model's classifier profile (or `null` when unclassified);
+ * `storage` is what the adapter delivered for each storage-object part.
+ * Throws `AiError` (never an SDK error): see the file header.
+ */
+export declare function toAnthropicRequest(req: AiResponseRequest, profile: AnthropicModelProfile | null, storage?: AnthropicStorageDeliveries): AnthropicRequestPlan;
+/** A reasoning item for replayable thinking blocks: summary text out, signature in the symbol state. */
+export declare function anthropicReasoningItem(block: AnthropicThinkingBlock): AiReasoningItem;
+/**
+ * Maps one content block. `null` for a block type this contract does not
+ * model (server-tool blocks, which this adapter never requests).
+ */
+export declare function fromAnthropicContentBlock(block: ContentBlock, structuredTool?: string): AiOutputItem | null;
+/** Usage, normalised: `inputTokens` includes cached tokens, as OpenAI's does. */
+export declare function anthropicUsage(usage: Partial<Pick<Usage, 'input_tokens' | 'output_tokens' | 'cache_read_input_tokens' | 'cache_creation_input_tokens' | 'output_tokens_details'>> | null | undefined): AiUsage;
+export interface FromAnthropicOptions {
+    /** The originating request; its `structuredOutput` drives `parsed`. */
+    request: AiResponseRequest;
+    /** The `request-id` Anthropic answered with. */
+    providerRequestId?: string | null;
+}
+export interface AnthropicResponseParts {
+    id: string;
+    model: string;
+    output: AiOutputItem[];
+    stopReason: StopReason | null | undefined;
+    usage: AiUsage;
+}
+/**
+ * The `AiResponse` for mapped parts — shared by `create` and the stream. When
+ * the request asked for structured output and the model finished its turn,
+ * the text is validated with `parseStructured` (a mismatch throws
+ * `AI_STRUCTURED_OUTPUT_INVALID`).
+ */
+export declare function finishAnthropicResponse(parts: AnthropicResponseParts, opts: FromAnthropicOptions): AiResponse;
+/** Maps a finished SDK `Message` to an `AiResponse`. */
+export declare function fromAnthropicMessage(message: Message, opts: FromAnthropicOptions & {
+    structuredToolName?: string;
+}): AiResponse;
+//# sourceMappingURL=anthropic-messages.mapper.d.ts.map

package/dist/ai/providers/anthropic/anthropic-messages.mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic-messages.mapper.d.ts","sourceRoot":"","sources":["../../../../src/ai/providers/anthropic/anthropic-messages.mapper.ts"],"names":[],"mappings":"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"}