@marinoscar/platform-api 0.1.0-next.5 → 0.1.0-next.7

package/dist/ai/core/structured-output.d.ts

@@ -1,50 +1,4 @@
-import { z } from 'zod';
-/**
- * A JSON Schema document, as plain data.
- *
- * @stability experimental
- */
-export type AiJsonSchema = Record<string, unknown>;
-/**
- * Converts a Zod schema to the JSON Schema a provider is sent.
- *
- * Uses zod's OUTPUT view — the shape the model must PRODUCE: every
- * non-optional key is `required` and objects are closed
- * (`additionalProperties: false`), which is what strict structured-output
- * and strict function-calling modes require. The `$schema` marker is dropped
- * because it describes the document, not the value, and some providers
- * reject unknown top-level keywords.
- *
- * A schema JSON Schema cannot express (a `Date`, a `transform`, a function) is
- * a programming error in the caller; it surfaces as
- * `AiError('AI_INVALID_REQUEST')` so it follows the same error path as every
- * other AI failure instead of escaping as a raw zod error.
- *
- * @stability experimental
- */
-export declare function toJsonSchema(schema: z.ZodTypeAny): AiJsonSchema;
-/**
- * One validation problem, safe to return to a client (no model output echoed).
- *
- * @stability experimental
- */
-export interface AiStructuredOutputIssue {
-    /** Where in the output the problem is. */
-    path: Array<string | number>;
-    /** Zod's issue code. */
-    code: string;
-    /** What is wrong, in words. */
-    message: string;
-}
-/**
- * Parses a model's text output and validates it against `schema`.
- *
- * Throws `AiError('AI_STRUCTURED_OUTPUT_INVALID')` (502 — the PROVIDER
- * returned something unusable, not the caller) with the issues in
- * `details.issues`. The raw text is deliberately NOT included: it is model
- * output derived from the user's prompt, and error bodies get logged.
- *
- * @stability experimental
- */
-export declare function parseStructured<S extends z.ZodTypeAny>(schema: S, text: string): z.output<S>;
+import './ai-error';
+export { parseStructured, toJsonSchema, } from '@marinoscar/platform-ai-providers';
+export type { AiJsonSchema, AiStructuredOutputIssue, } from '@marinoscar/platform-ai-providers';
 //# sourceMappingURL=structured-output.d.ts.map

package/dist/ai/core/structured-output.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"structured-output.d.ts","sourceRoot":"","sources":["../../../src/ai/core/structured-output.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEnD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,GAAG,YAAY,CAgB/D;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,0CAA0C;IAC1C,IAAI,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAC7B,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAsC5F"}
+{"version":3,"file":"structured-output.d.ts","sourceRoot":"","sources":["../../../src/ai/core/structured-output.ts"],"names":[],"mappings":"AAKA,OAAO,YAAY,CAAC;AAEpB,OAAO,EACL,eAAe,EACf,YAAY,GACb,MAAM,mCAAmC,CAAC;AAE3C,YAAY,EACV,YAAY,EACZ,uBAAuB,GACxB,MAAM,mCAAmC,CAAC"}

package/dist/ai/core/structured-output.js

@@ -1,83 +1,12 @@
 "use strict";
-// =============================================================================
-// Structured output helpers (issue #424, epic #419)
-// =============================================================================
-//
-// A caller hands the AI layer a ZOD schema; a provider wants a JSON SCHEMA,
-// and hands back TEXT. These two functions are the whole round trip, and the
-// only place either conversion happens, so every adapter describes and
-// validates schemas identically.
-//
-// The repository is on zod v4, which converts natively (`z.toJSONSchema`), so
-// no extra dependency is needed.
-// =============================================================================
+// Moved to `@marinoscar/platform-ai-providers` (#991) so the AI provider
+// adapters and their core types run without Nest. This path re-exports the
+// names it always exported, unchanged, so platform imports keep working.
+// The side-effect import runs the `AiError` integration (ai-error.ts) first.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.toJsonSchema = toJsonSchema;
-exports.parseStructured = parseStructured;
-const zod_1 = require("zod");
-const ai_error_1 = require("./ai-error");
-/**
- * Converts a Zod schema to the JSON Schema a provider is sent.
- *
- * Uses zod's OUTPUT view — the shape the model must PRODUCE: every
- * non-optional key is `required` and objects are closed
- * (`additionalProperties: false`), which is what strict structured-output
- * and strict function-calling modes require. The `$schema` marker is dropped
- * because it describes the document, not the value, and some providers
- * reject unknown top-level keywords.
- *
- * A schema JSON Schema cannot express (a `Date`, a `transform`, a function) is
- * a programming error in the caller; it surfaces as
- * `AiError('AI_INVALID_REQUEST')` so it follows the same error path as every
- * other AI failure instead of escaping as a raw zod error.
- *
- * @stability experimental
- */
-function toJsonSchema(schema) {
-    let json;
-    try {
-        json = zod_1.z.toJSONSchema(schema, { unrepresentable: 'throw' });
-    }
-    catch (err) {
-        throw new ai_error_1.AiError('AI_INVALID_REQUEST', 'The schema cannot be represented as JSON Schema.', { cause: err, details: { detail: err instanceof Error ? err.message : String(err) } });
-    }
-    const { $schema: _ignored, ...rest } = json;
-    return rest;
-}
-/**
- * Parses a model's text output and validates it against `schema`.
- *
- * Throws `AiError('AI_STRUCTURED_OUTPUT_INVALID')` (502 — the PROVIDER
- * returned something unusable, not the caller) with the issues in
- * `details.issues`. The raw text is deliberately NOT included: it is model
- * output derived from the user's prompt, and error bodies get logged.
- *
- * @stability experimental
- */
-function parseStructured(schema, text) {
-    let value;
-    try {
-        value = JSON.parse(text);
-    }
-    catch (err) {
-        const issues = [
-            {
-                path: [],
-                code: 'invalid_json',
-                message: err instanceof Error ? err.message : 'Output is not valid JSON',
-            },
-        ];
-        throw new ai_error_1.AiError('AI_STRUCTURED_OUTPUT_INVALID', 'The model output is not valid JSON.', { cause: err, details: { issues } });
-    }
-    const result = schema.safeParse(value);
-    if (!result.success) {
-        const issues = result.error.issues.map((issue) => ({
-            path: issue.path.map((segment) => (typeof segment === 'symbol' ? String(segment) : segment)),
-            code: issue.code,
-            message: issue.message,
-        }));
-        throw new ai_error_1.AiError('AI_STRUCTURED_OUTPUT_INVALID', 'The model output does not match the requested schema.', { cause: result.error, details: { issues } });
-    }
-    return result.data;
-}
+exports.toJsonSchema = exports.parseStructured = void 0;
+require("./ai-error");
+var platform_ai_providers_1 = require("@marinoscar/platform-ai-providers");
+Object.defineProperty(exports, "parseStructured", { enumerable: true, get: function () { return platform_ai_providers_1.parseStructured; } });
+Object.defineProperty(exports, "toJsonSchema", { enumerable: true, get: function () { return platform_ai_providers_1.toJsonSchema; } });
 //# sourceMappingURL=structured-output.js.map

package/dist/ai/core/structured-output.js.map

@@ -1 +1 @@
-{"version":3,"file":"structured-output.js","sourceRoot":"","sources":["../../../src/ai/core/structured-output.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,oDAAoD;AACpD,gFAAgF;AAChF,EAAE;AACF,4EAA4E;AAC5E,6EAA6E;AAC7E,uEAAuE;AACvE,iCAAiC;AACjC,EAAE;AACF,8EAA8E;AAC9E,iCAAiC;AACjC,gFAAgF;;AA8BhF,oCAgBC;AA0BD,0CAsCC;AA5GD,6BAAwB;AAExB,yCAAqC;AASrC;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,YAAY,CAAC,MAAoB;IAC/C,IAAI,IAAkB,CAAC;IAEvB,IAAI,CAAC;QACH,IAAI,GAAG,OAAC,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,eAAe,EAAE,OAAO,EAAE,CAAiB,CAAC;IAC9E,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,kBAAO,CACf,oBAAoB,EACpB,kDAAkD,EAClD,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,CACtF,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;IAE5C,OAAO,IAAI,CAAC;AACd,CAAC;AAgBD;;;;;;;;;GASG;AACH,SAAgB,eAAe,CAAyB,MAAS,EAAE,IAAY;IAC7E,IAAI,KAAc,CAAC;IAEnB,IAAI,CAAC;QACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,MAAM,GAA8B;YACxC;gBACE,IAAI,EAAE,EAAE;gBACR,IAAI,EAAE,cAAc;gBACpB,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,0BAA0B;aACzE;SACF,CAAC;QAEF,MAAM,IAAI,kBAAO,CACf,8BAA8B,EAC9B,qCAAqC,EACrC,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,EAAE,CACpC,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAEvC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,MAAM,GAA8B,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC5E,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;YAC5F,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC,CAAC,CAAC;QAEJ,MAAM,IAAI,kBAAO,CACf,8BAA8B,EAC9B,uDAAuD,EACvD,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,EAAE,CAC7C,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC,IAAmB,CAAC;AACpC,CAAC"}
+{"version":3,"file":"structured-output.js","sourceRoot":"","sources":["../../../src/ai/core/structured-output.ts"],"names":[],"mappings":";AAAA,yEAAyE;AACzE,2EAA2E;AAC3E,yEAAyE;AACzE,6EAA6E;;;AAE7E,sBAAoB;AAEpB,2EAG2C;AAFzC,wHAAA,eAAe,OAAA;AACf,qHAAA,YAAY,OAAA"}

package/dist/ai/core/tools.d.ts

@@ -1,94 +1,4 @@
-import type { z } from 'zod';
-import type { AiFunctionTool, AiTool } from './types/responses.types';
-/**
- * What a tool's `execute` is called with besides its arguments.
- *
- * @stability experimental
- */
-export interface AiToolExecutionContext {
-    /** The user on whose behalf the model is acting — scope every data access to it. */
-    userId: string;
-    /** Aborted when the request is. */
-    signal?: AbortSignal;
-    /** The request id, for logs. */
-    requestId?: string;
-}
-/**
- * What {@link defineTool} takes: a function tool and its implementation.
- *
- * @typeParam P - the parameters' Zod schema.
- * @typeParam R - what the implementation returns.
- *
- * @stability experimental
- */
-export interface AiToolDefinition<P extends z.ZodTypeAny, R> {
-    /** The name the model calls it by (`[a-zA-Z0-9_-]`, at most 64). */
-    name: string;
-    /** What it does, for the model. */
-    description: string;
-    /** The parameters' schema. */
-    parameters: P;
-    /** Ask the provider to enforce the schema exactly. Defaults to true. */
-    strict?: boolean;
-    /**
-     * The implementation.
-     *
-     * @param args - the validated arguments.
-     * @param ctx - the user and the signal.
-     */
-    execute(args: z.output<P>, ctx: AiToolExecutionContext): Promise<R> | R;
-}
-/**
- * The outcome of parsing a model's raw arguments.
- *
- * @typeParam P - the parameters' Zod schema.
- *
- * @stability experimental
- */
-export type AiToolArgumentsResult<P extends z.ZodTypeAny> = {
-    /** Parsed. */
-    success: true;
-    /** The validated arguments. */
-    data: z.output<P>;
-} | {
-    /** Refused. */
-    success: false;
-    /** Why, suitable for a `function_call_output`. */
-    error: string;
-};
-/**
- * A defined function tool: the request half and the implementation half.
- *
- * @typeParam P - the parameters' Zod schema.
- * @typeParam R - what the implementation returns.
- *
- * @stability experimental
- */
-export interface AiDefinedTool<P extends z.ZodTypeAny = z.ZodTypeAny, R = unknown> {
-    /** Goes into `AiResponseRequest.tools`. */
-    tool: AiFunctionTool<P>;
-    /** Runs the implementation. Always async, whatever the definition returned. */
-    execute(args: z.output<P>, ctx: AiToolExecutionContext): Promise<R>;
-    /**
-     * Parses and validates a model's raw `arguments` string. Never throws: a
-     * failure is a message suitable for a `function_call_output`.
-     */
-    parseArguments(raw: string): AiToolArgumentsResult<P>;
-}
-/**
- * Defines a function tool.
- *
- * Throws (a plain `TypeError` — this is a programming error, found at
- * definition time rather than on the first model call) when the name is not
- * provider-safe or `parameters` does not describe a JSON object.
- *
- * @stability experimental
- */
-export declare function defineTool<P extends z.ZodTypeAny, R>(def: AiToolDefinition<P, R>): AiDefinedTool<P, R>;
-/**
- * Narrows a request tool to a function tool (as opposed to a hosted one).
- *
- * @stability experimental
- */
-export declare function isFunctionTool(tool: AiTool): tool is AiFunctionTool;
+import './ai-error';
+export { defineTool, isFunctionTool, } from '@marinoscar/platform-ai-providers';
+export type { AiDefinedTool, AiToolArgumentsResult, AiToolDefinition, AiToolExecutionContext, } from '@marinoscar/platform-ai-providers';
 //# sourceMappingURL=tools.d.ts.map

package/dist/ai/core/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/ai/core/tools.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAG7B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAKtE;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,oFAAoF;IACpF,MAAM,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,EAAE,CAAC;IACzD,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,UAAU,EAAE,CAAC,CAAC;IACd,wEAAwE;IACxE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;;OAKG;IACH,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,sBAAsB,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;CACzE;AAED;;;;;;GAMG;AACH,MAAM,MAAM,qBAAqB,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,IACpD;IACE,cAAc;IACd,OAAO,EAAE,IAAI,CAAC;IACd,+BAA+B;IAC/B,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;CACnB,GACD;IACE,eAAe;IACf,OAAO,EAAE,KAAK,CAAC;IACf,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEN;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,EAAE,CAAC,GAAG,OAAO;IAC/E,2CAA2C;IAC3C,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;IACxB,+EAA+E;IAC/E,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,sBAAsB,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACpE;;;OAGG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,qBAAqB,CAAC,CAAC,CAAC,CAAC;CACvD;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,EAAE,CAAC,EAClD,GAAG,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,GAC1B,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CA+CrB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,cAAc,CAEnE"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/ai/core/tools.ts"],"names":[],"mappings":"AAKA,OAAO,YAAY,CAAC;AAEpB,OAAO,EACL,UAAU,EACV,cAAc,GACf,MAAM,mCAAmC,CAAC;AAE3C,YAAY,EACV,aAAa,EACb,qBAAqB,EACrB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,mCAAmC,CAAC"}

package/dist/ai/core/tools.js

@@ -1,76 +1,12 @@
 "use strict";
-// =============================================================================
-// Function tool helper (issue #424, epic #419)
-// =============================================================================
-//
-// `defineTool()` binds a function tool's description (what the provider is
-// told) to its implementation (what runs when the model calls it) and to ONE
-// Zod schema used for both the provider-facing JSON Schema and the validation
-// of the model's arguments. The #432 agent loop consumes the result.
-//
-// Arguments from a model are untrusted input — they are validated before
-// `execute` ever sees them, and a validation failure is returned as a string
-// the loop can feed back to the model rather than thrown.
-// =============================================================================
+// Moved to `@marinoscar/platform-ai-providers` (#991) so the AI provider
+// adapters and their core types run without Nest. This path re-exports the
+// names it always exported, unchanged, so platform imports keep working.
+// The side-effect import runs the `AiError` integration (ai-error.ts) first.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.defineTool = defineTool;
-exports.isFunctionTool = isFunctionTool;
-const structured_output_1 = require("./structured-output");
-/** Names providers accept for a function tool (the strictest common subset). */
-const TOOL_NAME = /^[a-zA-Z0-9_-]{1,64}$/;
-/**
- * Defines a function tool.
- *
- * Throws (a plain `TypeError` — this is a programming error, found at
- * definition time rather than on the first model call) when the name is not
- * provider-safe or `parameters` does not describe a JSON object.
- *
- * @stability experimental
- */
-function defineTool(def) {
-    if (!TOOL_NAME.test(def.name)) {
-        throw new TypeError(`Invalid AI tool name "${def.name}": use 1-64 characters from [a-zA-Z0-9_-].`);
-    }
-    const jsonSchema = (0, structured_output_1.toJsonSchema)(def.parameters);
-    if (jsonSchema.type !== 'object') {
-        throw new TypeError(`AI tool "${def.name}" parameters must be an object schema.`);
-    }
-    const tool = {
-        type: 'function',
-        name: def.name,
-        description: def.description,
-        parameters: def.parameters,
-        strict: def.strict ?? true,
-    };
-    return {
-        tool,
-        execute: async (args, ctx) => def.execute(args, ctx),
-        parseArguments: (raw) => {
-            let value;
-            try {
-                // Some providers send an empty string for a no-argument call.
-                value = JSON.parse(raw.trim() === '' ? '{}' : raw);
-            }
-            catch {
-                return { success: false, error: `Arguments for "${def.name}" are not valid JSON.` };
-            }
-            const result = def.parameters.safeParse(value);
-            if (!result.success) {
-                const problems = result.error.issues
-                    .map((issue) => `${issue.path.length ? issue.path.join('.') : '(root)'}: ${issue.message}`)
-                    .join('; ');
-                return { success: false, error: `Invalid arguments for "${def.name}": ${problems}` };
-            }
-            return { success: true, data: result.data };
-        },
-    };
-}
-/**
- * Narrows a request tool to a function tool (as opposed to a hosted one).
- *
- * @stability experimental
- */
-function isFunctionTool(tool) {
-    return tool.type === 'function';
-}
+exports.isFunctionTool = exports.defineTool = void 0;
+require("./ai-error");
+var platform_ai_providers_1 = require("@marinoscar/platform-ai-providers");
+Object.defineProperty(exports, "defineTool", { enumerable: true, get: function () { return platform_ai_providers_1.defineTool; } });
+Object.defineProperty(exports, "isFunctionTool", { enumerable: true, get: function () { return platform_ai_providers_1.isFunctionTool; } });
 //# sourceMappingURL=tools.js.map

package/dist/ai/core/tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/ai/core/tools.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,+CAA+C;AAC/C,gFAAgF;AAChF,EAAE;AACF,2EAA2E;AAC3E,6EAA6E;AAC7E,8EAA8E;AAC9E,qEAAqE;AACrE,EAAE;AACF,yEAAyE;AACzE,6EAA6E;AAC7E,0DAA0D;AAC1D,gFAAgF;;AAoGhF,gCAiDC;AAOD,wCAEC;AA1JD,2DAAmD;AAGnD,gFAAgF;AAChF,MAAM,SAAS,GAAG,uBAAuB,CAAC;AAmF1C;;;;;;;;GAQG;AACH,SAAgB,UAAU,CACxB,GAA2B;IAE3B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,SAAS,CACjB,yBAAyB,GAAG,CAAC,IAAI,4CAA4C,CAC9E,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,IAAA,gCAAY,EAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAEhD,IAAI,UAAU,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACjC,MAAM,IAAI,SAAS,CAAC,YAAY,GAAG,CAAC,IAAI,wCAAwC,CAAC,CAAC;IACpF,CAAC;IAED,MAAM,IAAI,GAAsB;QAC9B,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,IAAI;KAC3B,CAAC;IAEF,OAAO;QACL,IAAI;QACJ,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC;QACpD,cAAc,EAAE,CAAC,GAAG,EAAE,EAAE;YACtB,IAAI,KAAc,CAAC;YAEnB,IAAI,CAAC;gBACH,8DAA8D;gBAC9D,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACrD,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,kBAAkB,GAAG,CAAC,IAAI,uBAAuB,EAAE,CAAC;YACtF,CAAC;YAED,MAAM,MAAM,GAAG,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YAE/C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM;qBACjC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;qBAC1F,IAAI,CAAC,IAAI,CAAC,CAAC;gBAEd,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,0BAA0B,GAAG,CAAC,IAAI,MAAM,QAAQ,EAAE,EAAE,CAAC;YACvF,CAAC;YAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAmB,EAAE,CAAC;QAC7D,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAgB,cAAc,CAAC,IAAY;IACzC,OAAO,IAAI,CAAC,IAAI,KAAK,UAAU,CAAC;AAClC,CAAC"}
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/ai/core/tools.ts"],"names":[],"mappings":";AAAA,yEAAyE;AACzE,2EAA2E;AAC3E,yEAAyE;AACzE,6EAA6E;;;AAE7E,sBAAoB;AAEpB,2EAG2C;AAFzC,mHAAA,UAAU,OAAA;AACV,uHAAA,cAAc,OAAA"}

package/dist/ai/core/types/file-inputs.types.d.ts

@@ -1,103 +1,4 @@
-import type { AiBinaryPayload } from './media.types';
-/**
- * The largest image a Responses request may reference by storage object (20 MiB).
- *
- * @stability experimental
- */
-export declare const AI_STORAGE_INPUT_IMAGE_MAX_BYTES: number;
-/**
- * The largest non-image file a Responses request may reference by storage object (50 MiB).
- *
- * @stability experimental
- */
-export declare const AI_STORAGE_INPUT_FILE_MAX_BYTES: number;
-/**
- * The most storage-object parts one request may carry.
- *
- * @stability experimental
- */
-export declare const AI_STORAGE_INPUTS_MAX = 16;
-/**
- * How long a presigned input URL stays valid, in seconds (10 minutes).
- *
- * @stability experimental
- */
-export declare const AI_STORAGE_INPUT_URL_TTL_SECONDS = 600;
-/**
- * Stored objects of these MIME types are IMAGES (they need `vision_input`
- * and are capped at `AI_STORAGE_INPUT_IMAGE_MAX_BYTES`); every other type is
- * a FILE (`file_input`, `AI_STORAGE_INPUT_FILE_MAX_BYTES`).
- *
- * @stability experimental
- */
-export declare const AI_STORAGE_INPUT_IMAGE_MIME_TYPES: readonly ["image/png", "image/jpeg", "image/gif", "image/webp"];
-/**
- * What kind of input a stored object is, decided by its MIME type.
- *
- * @stability experimental
- */
-export type AiStorageInputModality = 'image' | 'file';
-/**
- * How an adapter wants a resolved storage input delivered (see the file header).
- *
- * @stability experimental
- */
-export type AiFileInputStrategy = 'presigned_url' | 'upload' | 'inline';
-/**
- * An adapter's delivery strategy per modality. Presence on the adapter IS the
- * declaration that it accepts storage-object inputs at all; an adapter
- * without one refuses them with `AI_CAPABILITY_UNSUPPORTED`.
- *
- * @stability experimental
- */
-export type AiFileInputStrategies = Readonly<Record<AiStorageInputModality, AiFileInputStrategy>>;
-/**
- * The modality of a stored object with `mimeType`.
- *
- * @stability experimental
- */
-export declare function storageInputModality(mimeType: string): AiStorageInputModality;
-/**
- * The size cap for a modality.
- *
- * @stability experimental
- */
-export declare function storageInputMaxBytes(modality: AiStorageInputModality): number;
-/**
- * One storage-object input, resolved and authorised by the runtime for one
- * provider call. Exactly what the adapter's declared strategy needs is set.
- *
- * @stability experimental
- */
-export interface AiResolvedStorageInput {
-    /** The storage object. */
-    storageObjectId: string;
-    /** Whether it is an image or a file input. */
-    modality: AiStorageInputModality;
-    /** Normalised MIME type (lower case, no parameters). */
-    mimeType: string;
-    /** The object's display name — a provider-facing filename. */
-    filename: string;
-    /** The strategy this input was prepared for (the adapter's own declaration). */
-    strategy: AiFileInputStrategy;
-    /**
-     * `presigned_url` only: a signed GET URL valid for
-     * `AI_STORAGE_INPUT_URL_TTL_SECONDS`. ⚠ Never log, persist or return it.
-     */
-    url?: string;
-    /**
-     * `upload`/`inline`: the object's bytes as a stream (a Node `Readable` in
-     * practice), failing with `AI_INVALID_REQUEST` once more than the
-     * modality's cap has arrived.
-     */
-    open?(): Promise<AsyncIterable<Uint8Array>>;
-    /** `upload`/`inline`: the bytes buffered, with the same cap. */
-    read?(): Promise<AiBinaryPayload>;
-}
-/**
- * Every resolved storage input of one call, keyed by storage object id.
- *
- * @stability experimental
- */
-export type AiResolvedStorageInputs = ReadonlyMap<string, AiResolvedStorageInput>;
+import '../ai-error';
+export { AI_STORAGE_INPUT_FILE_MAX_BYTES, AI_STORAGE_INPUT_IMAGE_MAX_BYTES, AI_STORAGE_INPUT_IMAGE_MIME_TYPES, AI_STORAGE_INPUT_URL_TTL_SECONDS, AI_STORAGE_INPUTS_MAX, storageInputMaxBytes, storageInputModality, } from '@marinoscar/platform-ai-providers';
+export type { AiFileInputStrategies, AiFileInputStrategy, AiResolvedStorageInput, AiResolvedStorageInputs, AiStorageInputModality, } from '@marinoscar/platform-ai-providers';
 //# sourceMappingURL=file-inputs.types.d.ts.map

package/dist/ai/core/types/file-inputs.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-inputs.types.d.ts","sourceRoot":"","sources":["../../../../src/ai/core/types/file-inputs.types.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,gCAAgC,QAAmB,CAAC;AAEjE;;;;GAIG;AACH,eAAO,MAAM,+BAA+B,QAAmB,CAAC;AAEhE;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC;;;;GAIG;AACH,eAAO,MAAM,gCAAgC,MAAM,CAAC;AAEpD;;;;;;GAMG;AACH,eAAO,MAAM,iCAAiC,iEAAkE,CAAC;AAEjH;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,MAAM,CAAC;AAEtD;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,eAAe,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAExE;;;;;;GAMG;AACH,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC,MAAM,CAAC,sBAAsB,EAAE,mBAAmB,CAAC,CAAC,CAAC;AAElG;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,sBAAsB,CAI7E;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,MAAM,CAE7E;AAED;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,0BAA0B;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,8CAA8C;IAC9C,QAAQ,EAAE,sBAAsB,CAAC;IACjC,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB,gFAAgF;IAChF,QAAQ,EAAE,mBAAmB,CAAC;IAC9B;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,IAAI,CAAC,IAAI,OAAO,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC;IAC5C,gEAAgE;IAChE,IAAI,CAAC,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC;CACnC;AAED;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG,WAAW,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC"}
+{"version":3,"file":"file-inputs.types.d.ts","sourceRoot":"","sources":["../../../../src/ai/core/types/file-inputs.types.ts"],"names":[],"mappings":"AAKA,OAAO,aAAa,CAAC;AAErB,OAAO,EACL,+BAA+B,EAC/B,gCAAgC,EAChC,iCAAiC,EACjC,gCAAgC,EAChC,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,mCAAmC,CAAC;AAE3C,YAAY,EACV,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,mCAAmC,CAAC"}

package/dist/ai/core/types/file-inputs.types.js

@@ -1,81 +1,17 @@
 "use strict";
-// =============================================================================
-// Storage-object inputs to a Responses request (issue #441, epic #420)
-// =============================================================================
-//
-// An `image`/`file` content part may name one of the caller's storage objects
-// (`{ type: 'file', storageObjectId }`) instead of a public URL. The RUNTIME
-// resolves it before the adapter is called — ownership, readiness, modality
-// against the model's capabilities, size — and hands the adapter what its
-// declared DELIVERY STRATEGY needs, through `AiCallContext.storageInputs`:
-//
-//   presigned_url   a short-lived signed GET URL the provider fetches itself
-//                   (`AI_STORAGE_INPUT_URL_TTL_SECONDS`); the bytes never pass
-//                   through this API.
-//   upload          the adapter streams the bytes to the provider's own file
-//                   store and deletes the provider-side copy afterwards.
-//   inline          the adapter embeds the bytes in the request (base64).
-//
-// The request itself is never rewritten: it keeps `storageObjectId`, so what
-// is logged (the opt-in prompt log), queued (`ai_runs.request`) or recorded
-// never carries a URL or bytes. A background run resolves again when it
-// executes, under the same checks, with a fresh URL.
-//
-// ⚠ A presigned URL is a bearer capability for the object: it lives only in
-// `AiCallContext.storageInputs`, for one call, and must never be logged,
-// persisted, put on a span, or returned — the same rule as `apiKey`.
-// =============================================================================
+// Moved to `@marinoscar/platform-ai-providers` (#991) so the AI provider
+// adapters and their core types run without Nest. This path re-exports the
+// names it always exported, unchanged, so platform imports keep working.
+// The side-effect import runs the `AiError` integration (ai-error.ts) first.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AI_STORAGE_INPUT_IMAGE_MIME_TYPES = exports.AI_STORAGE_INPUT_URL_TTL_SECONDS = exports.AI_STORAGE_INPUTS_MAX = exports.AI_STORAGE_INPUT_FILE_MAX_BYTES = exports.AI_STORAGE_INPUT_IMAGE_MAX_BYTES = void 0;
-exports.storageInputModality = storageInputModality;
-exports.storageInputMaxBytes = storageInputMaxBytes;
-/**
- * The largest image a Responses request may reference by storage object (20 MiB).
- *
- * @stability experimental
- */
-exports.AI_STORAGE_INPUT_IMAGE_MAX_BYTES = 20 * 1024 * 1024;
-/**
- * The largest non-image file a Responses request may reference by storage object (50 MiB).
- *
- * @stability experimental
- */
-exports.AI_STORAGE_INPUT_FILE_MAX_BYTES = 50 * 1024 * 1024;
-/**
- * The most storage-object parts one request may carry.
- *
- * @stability experimental
- */
-exports.AI_STORAGE_INPUTS_MAX = 16;
-/**
- * How long a presigned input URL stays valid, in seconds (10 minutes).
- *
- * @stability experimental
- */
-exports.AI_STORAGE_INPUT_URL_TTL_SECONDS = 600;
-/**
- * Stored objects of these MIME types are IMAGES (they need `vision_input`
- * and are capped at `AI_STORAGE_INPUT_IMAGE_MAX_BYTES`); every other type is
- * a FILE (`file_input`, `AI_STORAGE_INPUT_FILE_MAX_BYTES`).
- *
- * @stability experimental
- */
-exports.AI_STORAGE_INPUT_IMAGE_MIME_TYPES = ['image/png', 'image/jpeg', 'image/gif', 'image/webp'];
-/**
- * The modality of a stored object with `mimeType`.
- *
- * @stability experimental
- */
-function storageInputModality(mimeType) {
-    const normalised = mimeType.split(';')[0].trim().toLowerCase();
-    return exports.AI_STORAGE_INPUT_IMAGE_MIME_TYPES.includes(normalised) ? 'image' : 'file';
-}
-/**
- * The size cap for a modality.
- *
- * @stability experimental
- */
-function storageInputMaxBytes(modality) {
-    return modality === 'image' ? exports.AI_STORAGE_INPUT_IMAGE_MAX_BYTES : exports.AI_STORAGE_INPUT_FILE_MAX_BYTES;
-}
+exports.storageInputModality = exports.storageInputMaxBytes = exports.AI_STORAGE_INPUTS_MAX = exports.AI_STORAGE_INPUT_URL_TTL_SECONDS = exports.AI_STORAGE_INPUT_IMAGE_MIME_TYPES = exports.AI_STORAGE_INPUT_IMAGE_MAX_BYTES = exports.AI_STORAGE_INPUT_FILE_MAX_BYTES = void 0;
+require("../ai-error");
+var platform_ai_providers_1 = require("@marinoscar/platform-ai-providers");
+Object.defineProperty(exports, "AI_STORAGE_INPUT_FILE_MAX_BYTES", { enumerable: true, get: function () { return platform_ai_providers_1.AI_STORAGE_INPUT_FILE_MAX_BYTES; } });
+Object.defineProperty(exports, "AI_STORAGE_INPUT_IMAGE_MAX_BYTES", { enumerable: true, get: function () { return platform_ai_providers_1.AI_STORAGE_INPUT_IMAGE_MAX_BYTES; } });
+Object.defineProperty(exports, "AI_STORAGE_INPUT_IMAGE_MIME_TYPES", { enumerable: true, get: function () { return platform_ai_providers_1.AI_STORAGE_INPUT_IMAGE_MIME_TYPES; } });
+Object.defineProperty(exports, "AI_STORAGE_INPUT_URL_TTL_SECONDS", { enumerable: true, get: function () { return platform_ai_providers_1.AI_STORAGE_INPUT_URL_TTL_SECONDS; } });
+Object.defineProperty(exports, "AI_STORAGE_INPUTS_MAX", { enumerable: true, get: function () { return platform_ai_providers_1.AI_STORAGE_INPUTS_MAX; } });
+Object.defineProperty(exports, "storageInputMaxBytes", { enumerable: true, get: function () { return platform_ai_providers_1.storageInputMaxBytes; } });
+Object.defineProperty(exports, "storageInputModality", { enumerable: true, get: function () { return platform_ai_providers_1.storageInputModality; } });
 //# sourceMappingURL=file-inputs.types.js.map

package/dist/ai/core/types/file-inputs.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"file-inputs.types.js","sourceRoot":"","sources":["../../../../src/ai/core/types/file-inputs.types.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,uEAAuE;AACvE,gFAAgF;AAChF,EAAE;AACF,8EAA8E;AAC9E,6EAA6E;AAC7E,4EAA4E;AAC5E,0EAA0E;AAC1E,2EAA2E;AAC3E,EAAE;AACF,6EAA6E;AAC7E,+EAA+E;AAC/E,sCAAsC;AACtC,6EAA6E;AAC7E,yEAAyE;AACzE,0EAA0E;AAC1E,EAAE;AACF,6EAA6E;AAC7E,4EAA4E;AAC5E,wEAAwE;AACxE,qDAAqD;AACrD,EAAE;AACF,4EAA4E;AAC5E,yEAAyE;AACzE,qEAAqE;AACrE,gFAAgF;;;AAqEhF,oDAIC;AAOD,oDAEC;AA9ED;;;;GAIG;AACU,QAAA,gCAAgC,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAEjE;;;;GAIG;AACU,QAAA,+BAA+B,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAEhE;;;;GAIG;AACU,QAAA,qBAAqB,GAAG,EAAE,CAAC;AAExC;;;;GAIG;AACU,QAAA,gCAAgC,GAAG,GAAG,CAAC;AAEpD;;;;;;GAMG;AACU,QAAA,iCAAiC,GAAG,CAAC,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,CAAU,CAAC;AAyBjH;;;;GAIG;AACH,SAAgB,oBAAoB,CAAC,QAAgB;IACnD,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAE/D,OAAQ,yCAAuD,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;AAC1G,CAAC;AAED;;;;GAIG;AACH,SAAgB,oBAAoB,CAAC,QAAgC;IACnE,OAAO,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,wCAAgC,CAAC,CAAC,CAAC,uCAA+B,CAAC;AACnG,CAAC"}
+{"version":3,"file":"file-inputs.types.js","sourceRoot":"","sources":["../../../../src/ai/core/types/file-inputs.types.ts"],"names":[],"mappings":";AAAA,yEAAyE;AACzE,2EAA2E;AAC3E,yEAAyE;AACzE,6EAA6E;;;AAE7E,uBAAqB;AAErB,2EAQ2C;AAPzC,wIAAA,+BAA+B,OAAA;AAC/B,yIAAA,gCAAgC,OAAA;AAChC,0IAAA,iCAAiC,OAAA;AACjC,yIAAA,gCAAgC,OAAA;AAChC,8HAAA,qBAAqB,OAAA;AACrB,6HAAA,oBAAoB,OAAA;AACpB,6HAAA,oBAAoB,OAAA"}