@asap-protocol/mastra 2.3.1

package/dist/commonjs/asap-mastra-agent.d.ts

@@ -0,0 +1,29 @@
+import { Agent, type AgentConfig } from "@mastra/core/agent";
+import type { AsapExecuteClient } from "@asap-protocol/client/adapters/shared";
+import { type AsapToolsForMastraOptions } from "./asap-to-mastra-tool.js";
+/** Mastra {@link Agent} model slot — sourced from Mastra's {@link AgentConfig} instead of `ConstructorParameters`. */
+export type AsapMastraAgentModel = AgentConfig["model"];
+export interface CreateAsapMastraAgentParams {
+    readonly client: AsapExecuteClient;
+    readonly capabilities: readonly string[];
+    /** Mastra model id or config (passed through to {@link Agent}). */
+    readonly model: AsapMastraAgentModel;
+    /** Optional hooks / schema overrides forwarded to {@link asapToolsForMastra}. */
+    readonly toolsOptions?: AsapToolsForMastraOptions;
+    /** Overrides {@link Agent} id (default: `asap-mastra-agent`). */
+    readonly agentId?: string;
+    /** Overrides display name (default: `ASAP Mastra Agent`). */
+    readonly name?: string;
+    /**
+     * Overrides default system instructions. When omitted, instructions list the capability URNs
+     * and tell the model to call tools with valid JSON arguments.
+     */
+    readonly instructions?: string;
+}
+/**
+ * Convenience wrapper that mounts ASAP-derived tools on a Mastra {@link Agent}.
+ *
+ * @see sprint task 3.1 for wiring {@link asapToolsForMastra}.
+ */
+export declare function createAsapMastraAgent(params: CreateAsapMastraAgentParams): Promise<Agent>;
+//# sourceMappingURL=asap-mastra-agent.d.ts.map

package/dist/commonjs/asap-mastra-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asap-mastra-agent.d.ts","sourceRoot":"","sources":["../../src/asap-mastra-agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAE7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAE/E,OAAO,EAAE,KAAK,yBAAyB,EAAsB,MAAM,0BAA0B,CAAC;AAE9F,sHAAsH;AACtH,MAAM,MAAM,oBAAoB,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;AAExD,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,mEAAmE;IACnE,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAC;IACrC,iFAAiF;IACjF,QAAQ,CAAC,YAAY,CAAC,EAAE,yBAAyB,CAAC;IAClD,iEAAiE;IACjE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAYD;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,2BAA2B,GAAG,OAAO,CAAC,KAAK,CAAC,CAgB/F"}

package/dist/commonjs/asap-mastra-agent.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAsapMastraAgent = createAsapMastraAgent;
+const agent_1 = require("@mastra/core/agent");
+const asap_to_mastra_tool_js_1 = require("./asap-to-mastra-tool.js");
+function defaultInstructions(capabilities) {
+    const list = capabilities.length > 0 ? capabilities.join(", ") : "(none configured)";
+    return [
+        "You have access to ASAP capabilities exposed as Mastra tools.",
+        "When the user asks to run a capability on the ASAP provider, call the matching tool with valid JSON arguments derived from the capability schema.",
+        `Capability URNs available on this agent: ${list}.`,
+        "Answer concisely in natural language after tools return.",
+    ].join(" ");
+}
+/**
+ * Convenience wrapper that mounts ASAP-derived tools on a Mastra {@link Agent}.
+ *
+ * @see sprint task 3.1 for wiring {@link asapToolsForMastra}.
+ */
+async function createAsapMastraAgent(params) {
+    const asapTools = await (0, asap_to_mastra_tool_js_1.asapToolsForMastra)({ ...params.client, capabilities: params.capabilities }, params.toolsOptions);
+    const tools = {};
+    for (const t of asapTools) {
+        tools[t.id] = t;
+    }
+    return new agent_1.Agent({
+        id: params.agentId ?? "asap-mastra-agent",
+        name: params.name ?? "ASAP Mastra Agent",
+        instructions: params.instructions ?? defaultInstructions(params.capabilities),
+        model: params.model,
+        tools,
+    });
+}

package/dist/commonjs/asap-to-mastra-tool.d.ts

@@ -0,0 +1,26 @@
+import { type AsapExecuteClient } from "@asap-protocol/client/adapters/shared";
+import { type Tool } from "@mastra/core/tools";
+export interface AsapToolsForMastraOptions {
+    /**
+     * Invoked when the provider returns `403` with `error.code === "capability_not_granted"`.
+     * Use this to trigger `request-capability` / host approval flows.
+     */
+    readonly requestCapability?: (requiredCapability: string) => void | Promise<void>;
+    /** Pre-fetched per-capability input schemas (parity with adapters/openai|anthropic). */
+    readonly inputSchemas?: Readonly<Record<string, unknown>>;
+    /** Pre-fetched per-capability output schemas. */
+    readonly outputSchemas?: Readonly<Record<string, unknown>>;
+}
+/**
+ * Build Mastra {@link createTool} instances for each ASAP capability on the client.
+ *
+ * When {@link AsapToolsForMastraOptions.inputSchemas} does not define a capability entry, this calls
+ * {@link describeCapability} once per capability to recover JSON Schemas and descriptions.
+ */
+export declare function asapToolsForMastra(client: AsapExecuteClient, options?: AsapToolsForMastraOptions): Promise<readonly Tool[]>;
+/**
+ * Synchronous variant for callers that already have per-capability {@link AsapToolsForMastraOptions.inputSchemas}
+ * / {@link AsapToolsForMastraOptions.outputSchemas} and want to avoid {@link describeCapability} round-trips.
+ */
+export declare function asapToolsForMastraSync(client: AsapExecuteClient, options?: AsapToolsForMastraOptions): readonly Tool[];
+//# sourceMappingURL=asap-to-mastra-tool.d.ts.map

package/dist/commonjs/asap-to-mastra-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asap-to-mastra-tool.d.ts","sourceRoot":"","sources":["../../src/asap-to-mastra-tool.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAc,KAAK,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAK3D,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC,kBAAkB,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClF,wFAAwF;IACxF,QAAQ,CAAC,YAAY,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1D,iDAAiD;IACjD,QAAQ,CAAC,aAAa,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC5D;AAsGD;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,iBAAiB,EACzB,OAAO,CAAC,EAAE,yBAAyB,GAClC,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAkC1B;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,iBAAiB,EACzB,OAAO,CAAC,EAAE,yBAAyB,GAClC,SAAS,IAAI,EAAE,CAejB"}

package/dist/commonjs/asap-to-mastra-tool.js

@@ -0,0 +1,127 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.asapToolsForMastra = asapToolsForMastra;
+exports.asapToolsForMastraSync = asapToolsForMastraSync;
+const client_1 = require("@asap-protocol/client");
+const shared_1 = require("@asap-protocol/client/adapters/shared");
+const tools_1 = require("@mastra/core/tools");
+const errors_js_1 = require("./errors.js");
+const json_schema_to_zod_js_1 = require("./json-schema-to-zod.js");
+function isRecord(x) {
+    return typeof x === "object" && x !== null && !Array.isArray(x);
+}
+/**
+ * Wraps a {@link CapabilityFetch} to map select provider HTTP 403 JSON error payloads into typed errors.
+ *
+ * Unary JSON only: non-403 responses are returned as-is so bodies are not buffered. Do not use this
+ * wrapper for SSE or other streaming responses; the contract assumes small JSON payloads suitable for
+ * `describeCapability` / `executeCapability`.
+ */
+function wrapFetchWithCapabilityErrors(base, options) {
+    const impl = base ?? globalThis.fetch;
+    return async (input, init) => {
+        const res = await impl(input, init);
+        if (res.status !== 403) {
+            return res;
+        }
+        const text = await res.clone().text();
+        let parsed;
+        try {
+            parsed = text.length === 0 ? {} : JSON.parse(text);
+        }
+        catch {
+            return new Response(text, { status: res.status, statusText: res.statusText, headers: res.headers });
+        }
+        if (!isRecord(parsed)) {
+            return new Response(text, { status: res.status, statusText: res.statusText, headers: res.headers });
+        }
+        if (parsed.error === "constraint_violated") {
+            return new Response(text, { status: res.status, statusText: res.statusText, headers: res.headers });
+        }
+        const errObj = parsed.error;
+        if (!isRecord(errObj)) {
+            return new Response(text, { status: res.status, statusText: res.statusText, headers: res.headers });
+        }
+        const code = errObj.code;
+        if (code === "capability_not_granted") {
+            const data = isRecord(errObj.data) ? errObj.data : undefined;
+            const required = typeof data?.required_capability === "string" ? data.required_capability : "";
+            const msg = typeof errObj.message === "string" ? errObj.message : undefined;
+            throw new errors_js_1.CapabilityNotGrantedError(required, options?.requestCapability, msg);
+        }
+        if (code === "approval_required") {
+            const msg = typeof errObj.message === "string" ? errObj.message : "Capability execution requires approval";
+            throw new errors_js_1.ApprovalRequiredError(msg, errObj.data);
+        }
+        return new Response(text, { status: res.status, statusText: res.statusText, headers: res.headers });
+    };
+}
+function buildTools(client, fetchFn, describedByCapability, options) {
+    const tools = [];
+    for (const capabilityId of client.capabilities) {
+        const id = (0, shared_1.capabilityToolKey)(capabilityId);
+        const described = describedByCapability.get(capabilityId);
+        const inputJson = (0, shared_1.jsonSchemaForCapabilityInput)(options?.inputSchemas?.[capabilityId] ?? described?.input_schema);
+        const outputRaw = options?.outputSchemas?.[capabilityId] ?? described?.output_schema;
+        const outputJson = (0, shared_1.jsonSchemaForCapabilityOutput)(outputRaw);
+        tools.push((0, tools_1.createTool)({
+            id,
+            description: described?.description ?? `ASAP capability: ${capabilityId}`,
+            inputSchema: (0, json_schema_to_zod_js_1.zodFromJsonSchema)(inputJson),
+            outputSchema: (0, json_schema_to_zod_js_1.zodFromJsonSchema)(outputJson),
+            execute: async (inputData) => {
+                const ctx = typeof inputData === "object" && inputData !== null && !Array.isArray(inputData)
+                    ? inputData
+                    : {};
+                return (0, client_1.executeCapability)(client.provider, capabilityId, ctx, {
+                    agentJwt: client.agentJwt,
+                    fetch: fetchFn,
+                });
+            },
+        }));
+    }
+    return tools;
+}
+/**
+ * Build Mastra {@link createTool} instances for each ASAP capability on the client.
+ *
+ * When {@link AsapToolsForMastraOptions.inputSchemas} does not define a capability entry, this calls
+ * {@link describeCapability} once per capability to recover JSON Schemas and descriptions.
+ */
+async function asapToolsForMastra(client, options) {
+    const fetchFn = wrapFetchWithCapabilityErrors(client.fetch, options);
+    const describedByCapability = new Map();
+    for (const capabilityId of client.capabilities) {
+        if (options?.inputSchemas?.[capabilityId] !== undefined) {
+            describedByCapability.set(capabilityId, undefined);
+            continue;
+        }
+        const described = await (0, client_1.describeCapability)(client.provider, capabilityId, {
+            fetch: fetchFn,
+            agentJwt: client.agentJwt,
+        }).catch(() => undefined);
+        if (described === undefined) {
+            describedByCapability.set(capabilityId, undefined);
+        }
+        else {
+            describedByCapability.set(capabilityId, {
+                description: described.description,
+                input_schema: described.input_schema,
+                output_schema: described.output_schema,
+            });
+        }
+    }
+    return buildTools(client, fetchFn, describedByCapability, options);
+}
+/**
+ * Synchronous variant for callers that already have per-capability {@link AsapToolsForMastraOptions.inputSchemas}
+ * / {@link AsapToolsForMastraOptions.outputSchemas} and want to avoid {@link describeCapability} round-trips.
+ */
+function asapToolsForMastraSync(client, options) {
+    const fetchFn = wrapFetchWithCapabilityErrors(client.fetch, options);
+    const describedByCapability = new Map();
+    for (const capabilityId of client.capabilities) {
+        describedByCapability.set(capabilityId, undefined);
+    }
+    return buildTools(client, fetchFn, describedByCapability, options);
+}

package/dist/commonjs/errors.d.ts

@@ -0,0 +1,28 @@
+export { FatalError, RecoverableError, RemoteFatalRPCError, RemoteRecoverableRPCError, } from "@asap-protocol/client";
+/**
+ * Structured `approval_required` payload (`error.data`) from an ASAP provider JSON body.
+ */
+export interface ApprovalRequiredDetail {
+    readonly reason?: string;
+    readonly approval_url?: string;
+}
+/**
+ * Raised when the provider indicates an approval step is required before the capability can run.
+ */
+export declare class ApprovalRequiredError extends Error {
+    readonly name = "ApprovalRequiredError";
+    readonly detail?: ApprovalRequiredDetail;
+    constructor(message?: string, detail?: unknown);
+}
+/**
+ * Raised when the agent JWT is valid but the capability is not granted (HTTP 403 `capability_not_granted`).
+ * Call {@link CapabilityNotGrantedError.requestCapability} to run the optional `requestCapability` hook supplied to `asapToolsForMastra` options.
+ */
+export declare class CapabilityNotGrantedError extends Error {
+    readonly name = "CapabilityNotGrantedError";
+    readonly requiredCapability: string;
+    private readonly hook?;
+    constructor(requiredCapability: string, requestCapability?: (capability: string) => void | Promise<void>, message?: string);
+    requestCapability(): void | Promise<void>;
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/commonjs/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC;AAE/B;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAmBD;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,SAAkB,IAAI,2BAA2B;IAEjD,QAAQ,CAAC,MAAM,CAAC,EAAE,sBAAsB,CAAC;gBAE7B,OAAO,SAA2C,EAAE,MAAM,CAAC,EAAE,OAAO;CAIjF;AAED;;;GAGG;AACH,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,SAAkB,IAAI,+BAA+B;IAErD,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IAEpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAA+C;gBAGnE,kBAAkB,EAAE,MAAM,EAC1B,iBAAiB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EAChE,OAAO,CAAC,EAAE,MAAM;IAOlB,iBAAiB,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;CAG1C"}

package/dist/commonjs/errors.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CapabilityNotGrantedError = exports.ApprovalRequiredError = exports.RemoteRecoverableRPCError = exports.RemoteFatalRPCError = exports.RecoverableError = exports.FatalError = void 0;
+var client_1 = require("@asap-protocol/client");
+Object.defineProperty(exports, "FatalError", { enumerable: true, get: function () { return client_1.FatalError; } });
+Object.defineProperty(exports, "RecoverableError", { enumerable: true, get: function () { return client_1.RecoverableError; } });
+Object.defineProperty(exports, "RemoteFatalRPCError", { enumerable: true, get: function () { return client_1.RemoteFatalRPCError; } });
+Object.defineProperty(exports, "RemoteRecoverableRPCError", { enumerable: true, get: function () { return client_1.RemoteRecoverableRPCError; } });
+function approvalDetailFromUnknown(data) {
+    if (!data || typeof data !== "object" || Array.isArray(data)) {
+        return undefined;
+    }
+    const rec = data;
+    const reason = rec.reason;
+    const approval_url = rec.approval_url;
+    const detail = {};
+    if (typeof reason === "string") {
+        detail.reason = reason;
+    }
+    if (typeof approval_url === "string") {
+        detail.approval_url = approval_url;
+    }
+    return Object.keys(detail).length > 0 ? detail : undefined;
+}
+/**
+ * Raised when the provider indicates an approval step is required before the capability can run.
+ */
+class ApprovalRequiredError extends Error {
+    name = "ApprovalRequiredError";
+    detail;
+    constructor(message = "Capability execution requires approval", detail) {
+        super(message);
+        this.detail = approvalDetailFromUnknown(detail);
+    }
+}
+exports.ApprovalRequiredError = ApprovalRequiredError;
+/**
+ * Raised when the agent JWT is valid but the capability is not granted (HTTP 403 `capability_not_granted`).
+ * Call {@link CapabilityNotGrantedError.requestCapability} to run the optional `requestCapability` hook supplied to `asapToolsForMastra` options.
+ */
+class CapabilityNotGrantedError extends Error {
+    name = "CapabilityNotGrantedError";
+    requiredCapability;
+    hook;
+    constructor(requiredCapability, requestCapability, message) {
+        super(message ?? `Capability not granted: ${requiredCapability}`);
+        this.requiredCapability = requiredCapability;
+        this.hook = requestCapability;
+    }
+    requestCapability() {
+        return this.hook?.(this.requiredCapability);
+    }
+}
+exports.CapabilityNotGrantedError = CapabilityNotGrantedError;

package/dist/commonjs/index.d.ts

@@ -0,0 +1,6 @@
+/** Mastra integration: ASAP capabilities as Mastra `createTool` definitions. */
+export { asapToolsForMastra, asapToolsForMastraSync, type AsapToolsForMastraOptions, } from "./asap-to-mastra-tool.js";
+export { createAsapMastraAgent, type AsapMastraAgentModel, type CreateAsapMastraAgentParams } from "./asap-mastra-agent.js";
+export { asapStreamToMastraTextStream } from "./streaming.js";
+export * from "./errors.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/commonjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAEhF,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,KAAK,yBAAyB,GAC/B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,qBAAqB,EAAE,KAAK,oBAAoB,EAAE,KAAK,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAC5H,OAAO,EAAE,4BAA4B,EAAE,MAAM,gBAAgB,CAAC;AAC9D,cAAc,aAAa,CAAC"}

package/dist/commonjs/index.js

@@ -0,0 +1,26 @@
+"use strict";
+/** Mastra integration: ASAP capabilities as Mastra `createTool` definitions. */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.asapStreamToMastraTextStream = exports.createAsapMastraAgent = exports.asapToolsForMastraSync = exports.asapToolsForMastra = void 0;
+var asap_to_mastra_tool_js_1 = require("./asap-to-mastra-tool.js");
+Object.defineProperty(exports, "asapToolsForMastra", { enumerable: true, get: function () { return asap_to_mastra_tool_js_1.asapToolsForMastra; } });
+Object.defineProperty(exports, "asapToolsForMastraSync", { enumerable: true, get: function () { return asap_to_mastra_tool_js_1.asapToolsForMastraSync; } });
+var asap_mastra_agent_js_1 = require("./asap-mastra-agent.js");
+Object.defineProperty(exports, "createAsapMastraAgent", { enumerable: true, get: function () { return asap_mastra_agent_js_1.createAsapMastraAgent; } });
+var streaming_js_1 = require("./streaming.js");
+Object.defineProperty(exports, "asapStreamToMastraTextStream", { enumerable: true, get: function () { return streaming_js_1.asapStreamToMastraTextStream; } });
+__exportStar(require("./errors.js"), exports);

package/dist/commonjs/json-schema-to-zod.d.ts

@@ -0,0 +1,6 @@
+import { type ZodType } from "zod";
+/**
+ * Minimal JSON Schema → Zod bridge for adapter tool schemas (subset only; see tests for `oneOf` / `$ref`).
+ */
+export declare function zodFromJsonSchema(schema: Record<string, unknown>): ZodType<unknown>;
+//# sourceMappingURL=json-schema-to-zod.d.ts.map

package/dist/commonjs/json-schema-to-zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema-to-zod.d.ts","sourceRoot":"","sources":["../../src/json-schema-to-zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAK,KAAK,OAAO,EAAE,MAAM,KAAK,CAAC;AAEtC;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAoDnF"}

package/dist/commonjs/json-schema-to-zod.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.zodFromJsonSchema = zodFromJsonSchema;
+const zod_1 = require("zod");
+/**
+ * Minimal JSON Schema → Zod bridge for adapter tool schemas (subset only; see tests for `oneOf` / `$ref`).
+ */
+function zodFromJsonSchema(schema) {
+    if ("$ref" in schema) {
+        return zod_1.z.record(zod_1.z.string(), zod_1.z.unknown());
+    }
+    if ("oneOf" in schema && Array.isArray(schema.oneOf)) {
+        const branches = schema.oneOf
+            .filter((s) => typeof s === "object" && s !== null && !Array.isArray(s))
+            .map((s) => zodFromJsonSchema(s));
+        return branches.length === 0
+            ? zod_1.z.unknown()
+            : branches.length === 1
+                ? branches[0]
+                : zod_1.z.union(branches);
+    }
+    switch (schema.type) {
+        case "object": {
+            const maybeProps = schema.properties;
+            if (maybeProps !== undefined &&
+                typeof maybeProps === "object" &&
+                maybeProps !== null &&
+                !Array.isArray(maybeProps)) {
+                const propsRecord = maybeProps;
+                const required = new Set(Array.isArray(schema.required) ? schema.required.filter((k) => typeof k === "string") : []);
+                const shape = {};
+                for (const [key, val] of Object.entries(propsRecord)) {
+                    if (typeof val === "object" && val !== null && !Array.isArray(val)) {
+                        const child = zodFromJsonSchema(val);
+                        shape[key] = required.has(key) ? child : child.optional();
+                    }
+                }
+                if (Object.keys(shape).length > 0) {
+                    return zod_1.z.object(shape);
+                }
+            }
+            return zod_1.z.record(zod_1.z.string(), zod_1.z.unknown());
+        }
+        case "string":
+            return zod_1.z.string();
+        case "number":
+        case "integer":
+            return zod_1.z.number();
+        case "boolean":
+            return zod_1.z.boolean();
+        case "array":
+            return zod_1.z.array(zod_1.z.unknown());
+        default:
+            return zod_1.z.record(zod_1.z.string(), zod_1.z.unknown());
+    }
+}

package/dist/commonjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/dist/commonjs/streaming.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Bridge ASAP streaming payloads into Mastra-compatible text chunks.
+ *
+ * Async generator iteration propagates consumer backpressure: the upstream `source` iterator
+ * only advances after each `yield`, so a slow consumer naturally throttles reads.
+ *
+ * @see sprint task 4.1 for SSE parsing and backpressure.
+ */
+export declare function asapStreamToMastraTextStream(source: AsyncIterable<unknown>): AsyncIterable<string>;
+//# sourceMappingURL=streaming.d.ts.map

package/dist/commonjs/streaming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.d.ts","sourceRoot":"","sources":["../../src/streaming.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,wBAAuB,4BAA4B,CAAC,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,aAAa,CAAC,MAAM,CAAC,CAuBzG"}

package/dist/commonjs/streaming.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * Bridge ASAP streaming payloads into Mastra-compatible text chunks.
+ *
+ * Async generator iteration propagates consumer backpressure: the upstream `source` iterator
+ * only advances after each `yield`, so a slow consumer naturally throttles reads.
+ *
+ * @see sprint task 4.1 for SSE parsing and backpressure.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.asapStreamToMastraTextStream = asapStreamToMastraTextStream;
+function isRecord(x) {
+    return typeof x === "object" && x !== null && !Array.isArray(x);
+}
+async function* asapStreamToMastraTextStream(source) {
+    const it = source[Symbol.asyncIterator]();
+    try {
+        while (true) {
+            const { value: event, done } = await it.next();
+            if (done) {
+                return;
+            }
+            if (!isRecord(event) || event.type !== "task_stream") {
+                continue;
+            }
+            const payload = event.payload;
+            if (!isRecord(payload)) {
+                continue;
+            }
+            const chunk = payload.chunk;
+            if (typeof chunk === "string") {
+                yield chunk;
+            }
+        }
+    }
+    finally {
+        await it.return?.();
+    }
+}

package/dist/esm/asap-mastra-agent.d.ts

@@ -0,0 +1,29 @@
+import { Agent, type AgentConfig } from "@mastra/core/agent";
+import type { AsapExecuteClient } from "@asap-protocol/client/adapters/shared";
+import { type AsapToolsForMastraOptions } from "./asap-to-mastra-tool.js";
+/** Mastra {@link Agent} model slot — sourced from Mastra's {@link AgentConfig} instead of `ConstructorParameters`. */
+export type AsapMastraAgentModel = AgentConfig["model"];
+export interface CreateAsapMastraAgentParams {
+    readonly client: AsapExecuteClient;
+    readonly capabilities: readonly string[];
+    /** Mastra model id or config (passed through to {@link Agent}). */
+    readonly model: AsapMastraAgentModel;
+    /** Optional hooks / schema overrides forwarded to {@link asapToolsForMastra}. */
+    readonly toolsOptions?: AsapToolsForMastraOptions;
+    /** Overrides {@link Agent} id (default: `asap-mastra-agent`). */
+    readonly agentId?: string;
+    /** Overrides display name (default: `ASAP Mastra Agent`). */
+    readonly name?: string;
+    /**
+     * Overrides default system instructions. When omitted, instructions list the capability URNs
+     * and tell the model to call tools with valid JSON arguments.
+     */
+    readonly instructions?: string;
+}
+/**
+ * Convenience wrapper that mounts ASAP-derived tools on a Mastra {@link Agent}.
+ *
+ * @see sprint task 3.1 for wiring {@link asapToolsForMastra}.
+ */
+export declare function createAsapMastraAgent(params: CreateAsapMastraAgentParams): Promise<Agent>;
+//# sourceMappingURL=asap-mastra-agent.d.ts.map

package/dist/esm/asap-mastra-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asap-mastra-agent.d.ts","sourceRoot":"","sources":["../../src/asap-mastra-agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAE7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAE/E,OAAO,EAAE,KAAK,yBAAyB,EAAsB,MAAM,0BAA0B,CAAC;AAE9F,sHAAsH;AACtH,MAAM,MAAM,oBAAoB,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;AAExD,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,mEAAmE;IACnE,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAC;IACrC,iFAAiF;IACjF,QAAQ,CAAC,YAAY,CAAC,EAAE,yBAAyB,CAAC;IAClD,iEAAiE;IACjE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAYD;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,2BAA2B,GAAG,OAAO,CAAC,KAAK,CAAC,CAgB/F"}

package/dist/esm/asap-mastra-agent.js

@@ -0,0 +1,30 @@
+import { Agent } from "@mastra/core/agent";
+import { asapToolsForMastra } from "./asap-to-mastra-tool.js";
+function defaultInstructions(capabilities) {
+    const list = capabilities.length > 0 ? capabilities.join(", ") : "(none configured)";
+    return [
+        "You have access to ASAP capabilities exposed as Mastra tools.",
+        "When the user asks to run a capability on the ASAP provider, call the matching tool with valid JSON arguments derived from the capability schema.",
+        `Capability URNs available on this agent: ${list}.`,
+        "Answer concisely in natural language after tools return.",
+    ].join(" ");
+}
+/**
+ * Convenience wrapper that mounts ASAP-derived tools on a Mastra {@link Agent}.
+ *
+ * @see sprint task 3.1 for wiring {@link asapToolsForMastra}.
+ */
+export async function createAsapMastraAgent(params) {
+    const asapTools = await asapToolsForMastra({ ...params.client, capabilities: params.capabilities }, params.toolsOptions);
+    const tools = {};
+    for (const t of asapTools) {
+        tools[t.id] = t;
+    }
+    return new Agent({
+        id: params.agentId ?? "asap-mastra-agent",
+        name: params.name ?? "ASAP Mastra Agent",
+        instructions: params.instructions ?? defaultInstructions(params.capabilities),
+        model: params.model,
+        tools,
+    });
+}

package/dist/esm/asap-to-mastra-tool.d.ts

@@ -0,0 +1,26 @@
+import { type AsapExecuteClient } from "@asap-protocol/client/adapters/shared";
+import { type Tool } from "@mastra/core/tools";
+export interface AsapToolsForMastraOptions {
+    /**
+     * Invoked when the provider returns `403` with `error.code === "capability_not_granted"`.
+     * Use this to trigger `request-capability` / host approval flows.
+     */
+    readonly requestCapability?: (requiredCapability: string) => void | Promise<void>;
+    /** Pre-fetched per-capability input schemas (parity with adapters/openai|anthropic). */
+    readonly inputSchemas?: Readonly<Record<string, unknown>>;
+    /** Pre-fetched per-capability output schemas. */
+    readonly outputSchemas?: Readonly<Record<string, unknown>>;
+}
+/**
+ * Build Mastra {@link createTool} instances for each ASAP capability on the client.
+ *
+ * When {@link AsapToolsForMastraOptions.inputSchemas} does not define a capability entry, this calls
+ * {@link describeCapability} once per capability to recover JSON Schemas and descriptions.
+ */
+export declare function asapToolsForMastra(client: AsapExecuteClient, options?: AsapToolsForMastraOptions): Promise<readonly Tool[]>;
+/**
+ * Synchronous variant for callers that already have per-capability {@link AsapToolsForMastraOptions.inputSchemas}
+ * / {@link AsapToolsForMastraOptions.outputSchemas} and want to avoid {@link describeCapability} round-trips.
+ */
+export declare function asapToolsForMastraSync(client: AsapExecuteClient, options?: AsapToolsForMastraOptions): readonly Tool[];
+//# sourceMappingURL=asap-to-mastra-tool.d.ts.map

package/dist/esm/asap-to-mastra-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asap-to-mastra-tool.d.ts","sourceRoot":"","sources":["../../src/asap-to-mastra-tool.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAc,KAAK,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAK3D,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC,kBAAkB,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClF,wFAAwF;IACxF,QAAQ,CAAC,YAAY,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1D,iDAAiD;IACjD,QAAQ,CAAC,aAAa,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC5D;AAsGD;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,iBAAiB,EACzB,OAAO,CAAC,EAAE,yBAAyB,GAClC,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAkC1B;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,iBAAiB,EACzB,OAAO,CAAC,EAAE,yBAAyB,GAClC,SAAS,IAAI,EAAE,CAejB"}

package/dist/esm/asap-to-mastra-tool.js

@@ -0,0 +1,123 @@
+import { describeCapability, executeCapability } from "@asap-protocol/client";
+import { capabilityToolKey, jsonSchemaForCapabilityInput, jsonSchemaForCapabilityOutput, } from "@asap-protocol/client/adapters/shared";
+import { createTool } from "@mastra/core/tools";
+import { ApprovalRequiredError, CapabilityNotGrantedError } from "./errors.js";
+import { zodFromJsonSchema } from "./json-schema-to-zod.js";
+function isRecord(x) {
+    return typeof x === "object" && x !== null && !Array.isArray(x);
+}
+/**
+ * Wraps a {@link CapabilityFetch} to map select provider HTTP 403 JSON error payloads into typed errors.
+ *
+ * Unary JSON only: non-403 responses are returned as-is so bodies are not buffered. Do not use this
+ * wrapper for SSE or other streaming responses; the contract assumes small JSON payloads suitable for
+ * `describeCapability` / `executeCapability`.
+ */
+function wrapFetchWithCapabilityErrors(base, options) {
+    const impl = base ?? globalThis.fetch;
+    return async (input, init) => {
+        const res = await impl(input, init);
+        if (res.status !== 403) {
+            return res;
+        }
+        const text = await res.clone().text();
+        let parsed;
+        try {
+            parsed = text.length === 0 ? {} : JSON.parse(text);
+        }
+        catch {
+            return new Response(text, { status: res.status, statusText: res.statusText, headers: res.headers });
+        }
+        if (!isRecord(parsed)) {
+            return new Response(text, { status: res.status, statusText: res.statusText, headers: res.headers });
+        }
+        if (parsed.error === "constraint_violated") {
+            return new Response(text, { status: res.status, statusText: res.statusText, headers: res.headers });
+        }
+        const errObj = parsed.error;
+        if (!isRecord(errObj)) {
+            return new Response(text, { status: res.status, statusText: res.statusText, headers: res.headers });
+        }
+        const code = errObj.code;
+        if (code === "capability_not_granted") {
+            const data = isRecord(errObj.data) ? errObj.data : undefined;
+            const required = typeof data?.required_capability === "string" ? data.required_capability : "";
+            const msg = typeof errObj.message === "string" ? errObj.message : undefined;
+            throw new CapabilityNotGrantedError(required, options?.requestCapability, msg);
+        }
+        if (code === "approval_required") {
+            const msg = typeof errObj.message === "string" ? errObj.message : "Capability execution requires approval";
+            throw new ApprovalRequiredError(msg, errObj.data);
+        }
+        return new Response(text, { status: res.status, statusText: res.statusText, headers: res.headers });
+    };
+}
+function buildTools(client, fetchFn, describedByCapability, options) {
+    const tools = [];
+    for (const capabilityId of client.capabilities) {
+        const id = capabilityToolKey(capabilityId);
+        const described = describedByCapability.get(capabilityId);
+        const inputJson = jsonSchemaForCapabilityInput(options?.inputSchemas?.[capabilityId] ?? described?.input_schema);
+        const outputRaw = options?.outputSchemas?.[capabilityId] ?? described?.output_schema;
+        const outputJson = jsonSchemaForCapabilityOutput(outputRaw);
+        tools.push(createTool({
+            id,
+            description: described?.description ?? `ASAP capability: ${capabilityId}`,
+            inputSchema: zodFromJsonSchema(inputJson),
+            outputSchema: zodFromJsonSchema(outputJson),
+            execute: async (inputData) => {
+                const ctx = typeof inputData === "object" && inputData !== null && !Array.isArray(inputData)
+                    ? inputData
+                    : {};
+                return executeCapability(client.provider, capabilityId, ctx, {
+                    agentJwt: client.agentJwt,
+                    fetch: fetchFn,
+                });
+            },
+        }));
+    }
+    return tools;
+}
+/**
+ * Build Mastra {@link createTool} instances for each ASAP capability on the client.
+ *
+ * When {@link AsapToolsForMastraOptions.inputSchemas} does not define a capability entry, this calls
+ * {@link describeCapability} once per capability to recover JSON Schemas and descriptions.
+ */
+export async function asapToolsForMastra(client, options) {
+    const fetchFn = wrapFetchWithCapabilityErrors(client.fetch, options);
+    const describedByCapability = new Map();
+    for (const capabilityId of client.capabilities) {
+        if (options?.inputSchemas?.[capabilityId] !== undefined) {
+            describedByCapability.set(capabilityId, undefined);
+            continue;
+        }
+        const described = await describeCapability(client.provider, capabilityId, {
+            fetch: fetchFn,
+            agentJwt: client.agentJwt,
+        }).catch(() => undefined);
+        if (described === undefined) {
+            describedByCapability.set(capabilityId, undefined);
+        }
+        else {
+            describedByCapability.set(capabilityId, {
+                description: described.description,
+                input_schema: described.input_schema,
+                output_schema: described.output_schema,
+            });
+        }
+    }
+    return buildTools(client, fetchFn, describedByCapability, options);
+}
+/**
+ * Synchronous variant for callers that already have per-capability {@link AsapToolsForMastraOptions.inputSchemas}
+ * / {@link AsapToolsForMastraOptions.outputSchemas} and want to avoid {@link describeCapability} round-trips.
+ */
+export function asapToolsForMastraSync(client, options) {
+    const fetchFn = wrapFetchWithCapabilityErrors(client.fetch, options);
+    const describedByCapability = new Map();
+    for (const capabilityId of client.capabilities) {
+        describedByCapability.set(capabilityId, undefined);
+    }
+    return buildTools(client, fetchFn, describedByCapability, options);
+}

package/dist/esm/errors.d.ts

@@ -0,0 +1,28 @@
+export { FatalError, RecoverableError, RemoteFatalRPCError, RemoteRecoverableRPCError, } from "@asap-protocol/client";
+/**
+ * Structured `approval_required` payload (`error.data`) from an ASAP provider JSON body.
+ */
+export interface ApprovalRequiredDetail {
+    readonly reason?: string;
+    readonly approval_url?: string;
+}
+/**
+ * Raised when the provider indicates an approval step is required before the capability can run.
+ */
+export declare class ApprovalRequiredError extends Error {
+    readonly name = "ApprovalRequiredError";
+    readonly detail?: ApprovalRequiredDetail;
+    constructor(message?: string, detail?: unknown);
+}
+/**
+ * Raised when the agent JWT is valid but the capability is not granted (HTTP 403 `capability_not_granted`).
+ * Call {@link CapabilityNotGrantedError.requestCapability} to run the optional `requestCapability` hook supplied to `asapToolsForMastra` options.
+ */
+export declare class CapabilityNotGrantedError extends Error {
+    readonly name = "CapabilityNotGrantedError";
+    readonly requiredCapability: string;
+    private readonly hook?;
+    constructor(requiredCapability: string, requestCapability?: (capability: string) => void | Promise<void>, message?: string);
+    requestCapability(): void | Promise<void>;
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/esm/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC;AAE/B;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAmBD;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,SAAkB,IAAI,2BAA2B;IAEjD,QAAQ,CAAC,MAAM,CAAC,EAAE,sBAAsB,CAAC;gBAE7B,OAAO,SAA2C,EAAE,MAAM,CAAC,EAAE,OAAO;CAIjF;AAED;;;GAGG;AACH,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,SAAkB,IAAI,+BAA+B;IAErD,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IAEpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAA+C;gBAGnE,kBAAkB,EAAE,MAAM,EAC1B,iBAAiB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EAChE,OAAO,CAAC,EAAE,MAAM;IAOlB,iBAAiB,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;CAG1C"}

package/dist/esm/errors.js

@@ -0,0 +1,45 @@
+export { FatalError, RecoverableError, RemoteFatalRPCError, RemoteRecoverableRPCError, } from "@asap-protocol/client";
+function approvalDetailFromUnknown(data) {
+    if (!data || typeof data !== "object" || Array.isArray(data)) {
+        return undefined;
+    }
+    const rec = data;
+    const reason = rec.reason;
+    const approval_url = rec.approval_url;
+    const detail = {};
+    if (typeof reason === "string") {
+        detail.reason = reason;
+    }
+    if (typeof approval_url === "string") {
+        detail.approval_url = approval_url;
+    }
+    return Object.keys(detail).length > 0 ? detail : undefined;
+}
+/**
+ * Raised when the provider indicates an approval step is required before the capability can run.
+ */
+export class ApprovalRequiredError extends Error {
+    name = "ApprovalRequiredError";
+    detail;
+    constructor(message = "Capability execution requires approval", detail) {
+        super(message);
+        this.detail = approvalDetailFromUnknown(detail);
+    }
+}
+/**
+ * Raised when the agent JWT is valid but the capability is not granted (HTTP 403 `capability_not_granted`).
+ * Call {@link CapabilityNotGrantedError.requestCapability} to run the optional `requestCapability` hook supplied to `asapToolsForMastra` options.
+ */
+export class CapabilityNotGrantedError extends Error {
+    name = "CapabilityNotGrantedError";
+    requiredCapability;
+    hook;
+    constructor(requiredCapability, requestCapability, message) {
+        super(message ?? `Capability not granted: ${requiredCapability}`);
+        this.requiredCapability = requiredCapability;
+        this.hook = requestCapability;
+    }
+    requestCapability() {
+        return this.hook?.(this.requiredCapability);
+    }
+}

package/dist/esm/index.d.ts

@@ -0,0 +1,6 @@
+/** Mastra integration: ASAP capabilities as Mastra `createTool` definitions. */
+export { asapToolsForMastra, asapToolsForMastraSync, type AsapToolsForMastraOptions, } from "./asap-to-mastra-tool.js";
+export { createAsapMastraAgent, type AsapMastraAgentModel, type CreateAsapMastraAgentParams } from "./asap-mastra-agent.js";
+export { asapStreamToMastraTextStream } from "./streaming.js";
+export * from "./errors.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAEhF,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,KAAK,yBAAyB,GAC/B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,qBAAqB,EAAE,KAAK,oBAAoB,EAAE,KAAK,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAC5H,OAAO,EAAE,4BAA4B,EAAE,MAAM,gBAAgB,CAAC;AAC9D,cAAc,aAAa,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,5 @@
+/** Mastra integration: ASAP capabilities as Mastra `createTool` definitions. */
+export { asapToolsForMastra, asapToolsForMastraSync, } from "./asap-to-mastra-tool.js";
+export { createAsapMastraAgent } from "./asap-mastra-agent.js";
+export { asapStreamToMastraTextStream } from "./streaming.js";
+export * from "./errors.js";

package/dist/esm/json-schema-to-zod.d.ts

@@ -0,0 +1,6 @@
+import { type ZodType } from "zod";
+/**
+ * Minimal JSON Schema → Zod bridge for adapter tool schemas (subset only; see tests for `oneOf` / `$ref`).
+ */
+export declare function zodFromJsonSchema(schema: Record<string, unknown>): ZodType<unknown>;
+//# sourceMappingURL=json-schema-to-zod.d.ts.map

package/dist/esm/json-schema-to-zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema-to-zod.d.ts","sourceRoot":"","sources":["../../src/json-schema-to-zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAK,KAAK,OAAO,EAAE,MAAM,KAAK,CAAC;AAEtC;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAoDnF"}

package/dist/esm/json-schema-to-zod.js

@@ -0,0 +1,53 @@
+import { z } from "zod";
+/**
+ * Minimal JSON Schema → Zod bridge for adapter tool schemas (subset only; see tests for `oneOf` / `$ref`).
+ */
+export function zodFromJsonSchema(schema) {
+    if ("$ref" in schema) {
+        return z.record(z.string(), z.unknown());
+    }
+    if ("oneOf" in schema && Array.isArray(schema.oneOf)) {
+        const branches = schema.oneOf
+            .filter((s) => typeof s === "object" && s !== null && !Array.isArray(s))
+            .map((s) => zodFromJsonSchema(s));
+        return branches.length === 0
+            ? z.unknown()
+            : branches.length === 1
+                ? branches[0]
+                : z.union(branches);
+    }
+    switch (schema.type) {
+        case "object": {
+            const maybeProps = schema.properties;
+            if (maybeProps !== undefined &&
+                typeof maybeProps === "object" &&
+                maybeProps !== null &&
+                !Array.isArray(maybeProps)) {
+                const propsRecord = maybeProps;
+                const required = new Set(Array.isArray(schema.required) ? schema.required.filter((k) => typeof k === "string") : []);
+                const shape = {};
+                for (const [key, val] of Object.entries(propsRecord)) {
+                    if (typeof val === "object" && val !== null && !Array.isArray(val)) {
+                        const child = zodFromJsonSchema(val);
+                        shape[key] = required.has(key) ? child : child.optional();
+                    }
+                }
+                if (Object.keys(shape).length > 0) {
+                    return z.object(shape);
+                }
+            }
+            return z.record(z.string(), z.unknown());
+        }
+        case "string":
+            return z.string();
+        case "number":
+        case "integer":
+            return z.number();
+        case "boolean":
+            return z.boolean();
+        case "array":
+            return z.array(z.unknown());
+        default:
+            return z.record(z.string(), z.unknown());
+    }
+}

package/dist/esm/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}

package/dist/esm/streaming.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Bridge ASAP streaming payloads into Mastra-compatible text chunks.
+ *
+ * Async generator iteration propagates consumer backpressure: the upstream `source` iterator
+ * only advances after each `yield`, so a slow consumer naturally throttles reads.
+ *
+ * @see sprint task 4.1 for SSE parsing and backpressure.
+ */
+export declare function asapStreamToMastraTextStream(source: AsyncIterable<unknown>): AsyncIterable<string>;
+//# sourceMappingURL=streaming.d.ts.map

package/dist/esm/streaming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.d.ts","sourceRoot":"","sources":["../../src/streaming.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,wBAAuB,4BAA4B,CAAC,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,aAAa,CAAC,MAAM,CAAC,CAuBzG"}

package/dist/esm/streaming.js

@@ -0,0 +1,36 @@
+/**
+ * Bridge ASAP streaming payloads into Mastra-compatible text chunks.
+ *
+ * Async generator iteration propagates consumer backpressure: the upstream `source` iterator
+ * only advances after each `yield`, so a slow consumer naturally throttles reads.
+ *
+ * @see sprint task 4.1 for SSE parsing and backpressure.
+ */
+function isRecord(x) {
+    return typeof x === "object" && x !== null && !Array.isArray(x);
+}
+export async function* asapStreamToMastraTextStream(source) {
+    const it = source[Symbol.asyncIterator]();
+    try {
+        while (true) {
+            const { value: event, done } = await it.next();
+            if (done) {
+                return;
+            }
+            if (!isRecord(event) || event.type !== "task_stream") {
+                continue;
+            }
+            const payload = event.payload;
+            if (!isRecord(payload)) {
+                continue;
+            }
+            const chunk = payload.chunk;
+            if (typeof chunk === "string") {
+                yield chunk;
+            }
+        }
+    }
+    finally {
+        await it.return?.();
+    }
+}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@asap-protocol/mastra",
+  "version": "2.3.1",
+  "description": "ASAP Protocol capabilities as Mastra tools (@mastra/core)",
+  "type": "module",
+  "license": "Apache-2.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/adriannoes/asap-protocol"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "peerDependencies": {
+    "@asap-protocol/client": "^2.3.0",
+    "@mastra/core": "^1.5.0",
+    "zod": "^3.25.76 || ^4.1.8"
+  },
+  "dependencies": {},
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tshy",
+    "test": "vitest run --coverage",
+    "test:no-coverage": "vitest run",
+    "lint": "eslint .",
+    "check:treeshake": "pnpm run build && agadoo ./dist/esm/index.js",
+    "typecheck": "tsc --noEmit -p tsconfig.json"
+  },
+  "devDependencies": {
+    "@asap-protocol/client": "workspace:*",
+    "@eslint/js": "9.18.0",
+    "@mastra/core": "^1.35.0",
+    "@types/node": "^20.19.0",
+    "@vitest/coverage-v8": "4.1.5",
+    "agadoo": "3.0.0",
+    "eslint": "9.18.0",
+    "tshy": "^3.3.2",
+    "typescript": "^5.8.3",
+    "typescript-eslint": "8.59.1",
+    "vitest": "^4.1.1",
+    "zod": "^3.25.76"
+  },
+  "tshy": {
+    "project": "./tsconfig.build.json",
+    "exports": {
+      ".": "./src/index.ts"
+    }
+  },
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/esm/index.d.ts",
+        "default": "./dist/esm/index.js"
+      },
+      "require": {
+        "types": "./dist/commonjs/index.d.ts",
+        "default": "./dist/commonjs/index.js"
+      }
+    }
+  },
+  "main": "./dist/commonjs/index.js",
+  "types": "./dist/commonjs/index.d.ts",
+  "module": "./dist/esm/index.js"
+}