@msg91comm/m91 0.0.0-stage → 1.2.0

package/dist/src/integrations/specs.d.ts

@@ -0,0 +1,173 @@
+/**
+ * The tool definitions, written once and adapted per framework.
+ *
+ * A tool's name, its description and its argument docs are the entire interface
+ * a model has to M91 — they are the prompt. Four adapters each spelling their
+ * own copy is four descriptions that drift, and the drift is invisible until an
+ * agent on one framework behaves differently from the same agent on another.
+ *
+ * Every adapter therefore imports the schema and the `run` from here and does
+ * nothing but wrap it in the shape its framework expects.
+ */
+import type { M91Client } from '../client.js';
+import type { AlertResponse, Severity } from '../models.js';
+export declare const APPROVED = "approved";
+export declare const REJECTED = "rejected";
+/**
+ * `error: …` — never `approved`, whatever went wrong.
+ *
+ * The message is redacted: an M91 error can carry the URL it failed on, and
+ * that URL has the send token in its path. A tool result goes straight into a
+ * model's context and from there into logs, traces and evals.
+ */
+export declare function errorResult(error: unknown): string;
+/**
+ * `sent:delivered=N` — plus a word when nobody was actually reached.
+ *
+ * A model that reads "sent" and stops has no way to know the channel's phones
+ * were all stale. Saying so in the result is the only channel back to it.
+ */
+export declare function alertResult(alert: AlertResponse): string;
+/** JSON Schema rather than zod, so nothing here needs a dependency to exist. */
+export declare const APPROVAL_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly title: {
+            readonly type: "string";
+            readonly description: string;
+        };
+        readonly customId: {
+            readonly type: "string";
+            readonly description: string;
+        };
+        readonly description: {
+            readonly type: "string";
+            readonly description: string;
+        };
+        readonly severity: {
+            readonly type: "string";
+            readonly enum: readonly ["LOW", "MEDIUM", "HIGH", "CRITICAL"];
+            readonly description: "LOW, MEDIUM, HIGH or CRITICAL. All of them ring through Do Not Disturb; HIGH and CRITICAL also place a voice call after 45 seconds of silence. An approval that blocks you is normally HIGH.";
+        };
+        readonly approveLabel: {
+            readonly type: "string";
+            readonly description: "The yes button, 24 characters or fewer.";
+        };
+        readonly rejectLabel: {
+            readonly type: "string";
+            readonly description: "The no button, 24 characters or fewer.";
+        };
+        readonly timeoutSeconds: {
+            readonly type: "number";
+            readonly description: "How long to wait for an answer before giving up. Default 300.";
+        };
+    };
+    readonly required: readonly ["title", "customId"];
+    readonly additionalProperties: false;
+};
+export declare const ALERT_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly title: {
+            readonly type: "string";
+            readonly description: "What happened, in one line somebody can act on. 5-2000 characters.";
+        };
+        readonly customId: {
+            readonly type: "string";
+            readonly description: string;
+        };
+        readonly description: {
+            readonly type: "string";
+            readonly description: "Any detail that helps them act.";
+        };
+        readonly severity: {
+            readonly type: "string";
+            readonly enum: readonly ["LOW", "MEDIUM", "HIGH", "CRITICAL"];
+            readonly description: string;
+        };
+    };
+    readonly required: readonly ["title"];
+    readonly additionalProperties: false;
+};
+export declare const APPROVAL_TOOL_NAME = "m91_request_approval";
+export declare const ALERT_TOOL_NAME = "m91_send_alert";
+export declare const APPROVAL_DESCRIPTION: string;
+export declare const ALERT_DESCRIPTION: string;
+export interface ApprovalArgs {
+    title: string;
+    customId: string;
+    description?: string;
+    severity?: Severity;
+    approveLabel?: string;
+    rejectLabel?: string;
+    timeoutSeconds?: number;
+}
+export interface AlertArgs {
+    title: string;
+    customId?: string;
+    description?: string;
+    severity?: Severity;
+}
+/**
+ * What a deployment wants when the model does not say.
+ *
+ * Set these where the tool is built, not in the prompt. How long a person has
+ * to wake up, and what the buttons say, are operations decisions — a model
+ * choosing its own timeout is a model deciding how long somebody has to answer.
+ * It can still override per call when it has a reason.
+ */
+export interface ApprovalDefaults {
+    severity?: Severity;
+    approveLabel?: string;
+    rejectLabel?: string;
+    timeoutSeconds?: number;
+}
+export interface AlertDefaults {
+    severity?: Severity;
+}
+/** Ask, wait, and answer in a word a model cannot misread. */
+export declare function runApproval(client: M91Client, args: ApprovalArgs, defaults?: ApprovalDefaults): Promise<string>;
+export declare function runAlert(client: M91Client, args: AlertArgs, defaults?: AlertDefaults): Promise<string>;
+/**
+ * One tool call a framework is about to make, in the only three fields every
+ * framework agrees on.
+ */
+export interface GatedCall {
+    toolName: string;
+    input: unknown;
+    /** The framework's id for this call. Becomes the alert's customId. */
+    callId: string;
+}
+/** How a gate decides who gets asked, and how the question reads. */
+export interface GateOptions extends ApprovalDefaults {
+    /**
+     * Which tool calls need a human: a list of tool names, or a predicate.
+     *
+     * Required where a framework routes every call through the gate (Claude
+     * Agent SDK, Google ADK, Vercel `toolApproval`): ringing somebody's phone
+     * for every file read is how a channel gets muted.
+     */
+    tools?: readonly string[] | ((toolName: string, input: unknown) => boolean | Promise<boolean>);
+    /** Write the lock-screen question yourself. Default: "Allow <tool>?" plus the arguments. */
+    describe?: (call: GatedCall) => {
+        title: string;
+        description?: string;
+    };
+}
+export interface GateDecision {
+    approved: boolean;
+    /** Why, in words a model can repeat to the user. */
+    reason: string;
+}
+/** Does this call need a human? With no `tools`, every call that reaches the gate does. */
+export declare function needsHuman(options: GateOptions, toolName: string, input: unknown): Promise<boolean>;
+/** A customId M91 accepts, stable across a framework's retries of the same call. */
+export declare function gateCustomId(call: GatedCall): string;
+/**
+ * Ring a phone about a tool call and wait for the answer.
+ *
+ * Fails closed: an M91 error, an unreachable channel or a timeout is a no,
+ * with the reason spelled out, never a silent yes.
+ */
+export declare function decideToolCall(client: M91Client, call: GatedCall, options?: GateOptions): Promise<GateDecision>;
+//# sourceMappingURL=specs.d.ts.map

package/dist/src/integrations/specs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"specs.d.ts","sourceRoot":"","sources":["../../../src/integrations/specs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAG9C,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE5D,eAAO,MAAM,QAAQ,aAAa,CAAC;AACnC,eAAO,MAAM,QAAQ,aAAa,CAAC;AAEnC;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAIlD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAexD;AAWD,gFAAgF;AAChF,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BlB,CAAC;AAEX,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;CAkBf,CAAC;AAEX,eAAO,MAAM,kBAAkB,yBAAyB,CAAC;AACzD,eAAO,MAAM,eAAe,mBAAmB,CAAC;AAEhD,eAAO,MAAM,oBAAoB,QASW,CAAC;AAE7C,eAAO,MAAM,iBAAiB,QAQmD,CAAC;AAElF,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,8DAA8D;AAC9D,wBAAsB,WAAW,CAC/B,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,YAAY,EAClB,QAAQ,GAAE,gBAAqB,GAC9B,OAAO,CAAC,MAAM,CAAC,CAkBjB;AAED,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,SAAS,EACf,QAAQ,GAAE,aAAkB,GAC3B,OAAO,CAAC,MAAM,CAAC,CAejB;AAMD;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,sEAAsE;IACtE,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qEAAqE;AACrE,MAAM,WAAW,WAAY,SAAQ,gBAAgB;IACnD;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/F,4FAA4F;IAC5F,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACzE;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,2FAA2F;AAC3F,wBAAsB,UAAU,CAC9B,OAAO,EAAE,WAAW,EACpB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,OAAO,CAAC,CAKlB;AAED,oFAAoF;AACpF,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAGpD;AAgBD;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,SAAS,EACf,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,YAAY,CAAC,CAyBvB"}

package/dist/src/integrations/specs.js

@@ -0,0 +1,217 @@
+/**
+ * The tool definitions, written once and adapted per framework.
+ *
+ * A tool's name, its description and its argument docs are the entire interface
+ * a model has to M91 — they are the prompt. Four adapters each spelling their
+ * own copy is four descriptions that drift, and the drift is invisible until an
+ * agent on one framework behaves differently from the same agent on another.
+ *
+ * Every adapter therefore imports the schema and the `run` from here and does
+ * nothing but wrap it in the shape its framework expects.
+ */
+import { M91Error } from '../exceptions.js';
+import { redact } from '../http.js';
+export const APPROVED = 'approved';
+export const REJECTED = 'rejected';
+/**
+ * `error: …` — never `approved`, whatever went wrong.
+ *
+ * The message is redacted: an M91 error can carry the URL it failed on, and
+ * that URL has the send token in its path. A tool result goes straight into a
+ * model's context and from there into logs, traces and evals.
+ */
+export function errorResult(error) {
+    if (error instanceof M91Error)
+        return `error: [${error.code}] ${redact(error.message)}`;
+    const message = error instanceof Error ? error.message : String(error);
+    return `error: ${redact(message) || 'unknown failure'}`;
+}
+/**
+ * `sent:delivered=N` — plus a word when nobody was actually reached.
+ *
+ * A model that reads "sent" and stops has no way to know the channel's phones
+ * were all stale. Saying so in the result is the only channel back to it.
+ */
+export function alertResult(alert) {
+    if (alert.deduplicated) {
+        return ('sent:delivered=0 (an alert with this customId is already open and already ringing — ' +
+            'nobody was disturbed a second time)');
+    }
+    if (alert.delivered === 0) {
+        return (`sent:delivered=0 WARNING: the alert was filed but no phone could be reached ` +
+            `(unregistered=${alert.unregistered.length}, noDevice=${alert.noDevice}, ` +
+            `pending=${alert.pending}). Nobody has been woken.`);
+    }
+    return `sent:delivered=${alert.delivered}`;
+}
+const SEVERITY_DOC = 'LOW, MEDIUM, HIGH or CRITICAL. All of them ring through Do Not Disturb; HIGH and ' +
+    'CRITICAL also place a voice call after 45 seconds of silence.';
+const CUSTOM_ID_DOC = 'A stable id for this exact request, derived from what is being decided ' +
+    "('refund-ORD-40122'). NEVER a timestamp, a UUID or a counter: the id is what " +
+    'deduplicates a retry and what closes the alert afterwards.';
+/** JSON Schema rather than zod, so nothing here needs a dependency to exist. */
+export const APPROVAL_SCHEMA = {
+    type: 'object',
+    properties: {
+        title: {
+            type: 'string',
+            description: 'The question, as the person reads it at 3am on a lock screen. Name the action ' +
+                "and its consequence: 'Refund 48,000 on ORD-40122?' — not 'approve action'. " +
+                '5-2000 characters.',
+        },
+        customId: { type: 'string', description: CUSTOM_ID_DOC },
+        description: {
+            type: 'string',
+            description: 'The context the person needs to answer without asking you anything back: what ' +
+                'you found, what you are about to do, and what happens if they say no.',
+        },
+        severity: {
+            type: 'string',
+            enum: ['LOW', 'MEDIUM', 'HIGH', 'CRITICAL'],
+            description: `${SEVERITY_DOC} An approval that blocks you is normally HIGH.`,
+        },
+        approveLabel: { type: 'string', description: 'The yes button, 24 characters or fewer.' },
+        rejectLabel: { type: 'string', description: 'The no button, 24 characters or fewer.' },
+        timeoutSeconds: {
+            type: 'number',
+            description: 'How long to wait for an answer before giving up. Default 300.',
+        },
+    },
+    required: ['title', 'customId'],
+    additionalProperties: false,
+};
+export const ALERT_SCHEMA = {
+    type: 'object',
+    properties: {
+        title: {
+            type: 'string',
+            description: 'What happened, in one line somebody can act on. 5-2000 characters.',
+        },
+        customId: {
+            type: 'string',
+            description: "A stable id for the CONDITION, not this occurrence — 'disk-full-node7'. Repeats " +
+                'while it is still open wake nobody a second time. Never a timestamp.',
+        },
+        description: { type: 'string', description: 'Any detail that helps them act.' },
+        severity: { type: 'string', enum: ['LOW', 'MEDIUM', 'HIGH', 'CRITICAL'], description: SEVERITY_DOC },
+    },
+    required: ['title'],
+    additionalProperties: false,
+};
+export const APPROVAL_TOOL_NAME = 'm91_request_approval';
+export const ALERT_TOOL_NAME = 'm91_send_alert';
+export const APPROVAL_DESCRIPTION = 'Ask a human for permission and wait for their answer. Use this BEFORE any ' +
+    'irreversible or consequential action: payments, refunds, deletions, deployments, ' +
+    "sending messages on someone's behalf, changing production data, or anything you " +
+    'would want a colleague to sign off on. ' +
+    'The person is woken on their phone immediately at full volume, through silent mode ' +
+    'and Do Not Disturb, and called if they do not answer within 45 seconds. ' +
+    'This call BLOCKS until they respond or the timeout passes. ' +
+    "Returns 'approved' or 'rejected'. Treat anything that is not exactly 'approved' as " +
+    'a refusal and do not perform the action.';
+export const ALERT_DESCRIPTION = 'Wake a human immediately about something that has already happened, without waiting ' +
+    'for a reply. Use for failures, anomalies, breaches, and long jobs finishing that ' +
+    'somebody is waiting on. ' +
+    'The alert rings every phone on the on-call channel at full volume through silent ' +
+    'mode and Do Not Disturb, and keeps ringing until somebody answers. ' +
+    'Do NOT use this to ask permission — use m91_request_approval, which waits. ' +
+    'Do NOT use it for anything that could wait until morning; this wakes people up. ' +
+    "Returns 'sent:delivered=N', where N is how many phones were actually reached.";
+/** Ask, wait, and answer in a word a model cannot misread. */
+export async function runApproval(client, args, defaults = {}) {
+    try {
+        const approved = await client.requestApproval(args.title, {
+            customId: args.customId,
+            description: args.description,
+            severity: args.severity ?? defaults.severity ?? 'HIGH',
+            approveLabel: args.approveLabel ?? defaults.approveLabel ?? 'Approve',
+            rejectLabel: args.rejectLabel ?? defaults.rejectLabel ?? 'Reject',
+            // `??`, not `||`: an explicit 0 means "do not wait", and `||` would turn
+            // that into five minutes.
+            timeoutMs: (args.timeoutSeconds ?? defaults.timeoutSeconds ?? 300) * 1000,
+        });
+        return approved ? APPROVED : REJECTED;
+    }
+    catch (error) {
+        // Returned, not thrown: a thrown tool error ends the agent run, and an
+        // agent that cannot ask permission should be able to say so and stop.
+        return errorResult(error);
+    }
+}
+export async function runAlert(client, args, defaults = {}) {
+    try {
+        return alertResult(await client.send(args.title, {
+            description: args.description,
+            severity: args.severity ?? defaults.severity ?? 'MEDIUM',
+            customId: args.customId,
+        }));
+    }
+    catch (error) {
+        // Includes M91DeliveryError, whose message already says nobody's phone
+        // rang. A model reading "error:" and retrying is right there; a model
+        // reading "sent" and stopping is not.
+        return errorResult(error);
+    }
+}
+/** Does this call need a human? With no `tools`, every call that reaches the gate does. */
+export async function needsHuman(options, toolName, input) {
+    const { tools } = options;
+    if (tools === undefined)
+        return true;
+    if (typeof tools === 'function')
+        return Boolean(await tools(toolName, input));
+    return tools.includes(toolName);
+}
+/** A customId M91 accepts, stable across a framework's retries of the same call. */
+export function gateCustomId(call) {
+    const raw = `tool-${call.toolName}-${call.callId}`;
+    return raw.replace(/[^A-Za-z0-9_-]/g, '-').slice(0, 100);
+}
+function defaultQuestion(call) {
+    let args;
+    try {
+        args = JSON.stringify(call.input, null, 2) ?? '';
+    }
+    catch {
+        args = String(call.input);
+    }
+    if (args.length > 1500)
+        args = `${args.slice(0, 1500)}\n… (truncated)`;
+    return {
+        title: `Allow the agent to run ${call.toolName}?`,
+        description: `The agent wants to call ${call.toolName} with:\n${args}`,
+    };
+}
+/**
+ * Ring a phone about a tool call and wait for the answer.
+ *
+ * Fails closed: an M91 error, an unreachable channel or a timeout is a no,
+ * with the reason spelled out, never a silent yes.
+ */
+export async function decideToolCall(client, call, options = {}) {
+    const question = options.describe ? options.describe(call) : defaultQuestion(call);
+    try {
+        const approved = await client.requestApproval(question.title, {
+            customId: gateCustomId(call),
+            description: question.description,
+            severity: options.severity ?? 'HIGH',
+            approveLabel: options.approveLabel ?? 'Approve',
+            rejectLabel: options.rejectLabel ?? 'Reject',
+            timeoutMs: (options.timeoutSeconds ?? 300) * 1000,
+        });
+        return approved
+            ? { approved: true, reason: 'Approved by a human via M91.' }
+            : {
+                approved: false,
+                reason: 'A human rejected this action via M91 (or did not answer in time). ' +
+                    'Do not retry it; tell the user it was not approved.',
+            };
+    }
+    catch (error) {
+        return {
+            approved: false,
+            reason: `Could not get human approval via M91, so the action was not run. ${errorResult(error)}`,
+        };
+    }
+}
+//# sourceMappingURL=specs.js.map

package/dist/src/integrations/specs.js.map

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

package/dist/src/integrations/vercel-ai.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Vercel AI SDK: two tools, and a gate for your own tools.
+ *
+ * **Tools** the model calls when it decides to ask (`createM91Tools`).
+ *
+ * **Gate** (`createM91ToolApproval`) plugs into AI SDK 6+'s `toolApproval`
+ * option: every call to the tools you name rings a phone first, and runs only
+ * if a person approves. The model cannot skip it, because it never decides to
+ * ask: the SDK asks for it.
+ *
+ * ```ts
+ * const { text } = await generateText({
+ *   model: 'openai/gpt-5-mini',
+ *   tools: { issueRefund, deleteUser },
+ *   toolApproval: createM91ToolApproval(client, { tools: ['issueRefund', 'deleteUser'] }),
+ *   stopWhen: isStepCount(5),
+ *   prompt: 'Refund order ORD-40122.',
+ * });
+ * ```
+ *
+ * ```ts
+ * import { M91Client } from '@msg91comm/m91';
+ * import { createM91ApprovalTool, createM91AlertTool } from '@msg91comm/m91/integrations/vercel-ai';
+ *
+ * const client = new M91Client(process.env.M91_SEND_LINK!);
+ *
+ * const { text } = await generateText({
+ *   model: openai('gpt-4o'),
+ *   tools: {
+ *     m91_request_approval: await createM91ApprovalTool(client),
+ *     m91_send_alert: await createM91AlertTool(client),
+ *   },
+ *   stopWhen: isStepCount(10),
+ *   prompt: 'Look into order ORD-40122 and refund it if it checks out.',
+ * });
+ * ```
+ *
+ * The factories are **async** because `ai` is an optional peer dependency,
+ * imported only when one of these is called — `npm install @msg91comm/m91` stays at zero
+ * dependencies.
+ */
+import type { Tool, ToolApprovalStatus, ToolSet } from 'ai';
+import type { M91Client } from '../client.js';
+import { type AlertArgs, type AlertDefaults, type ApprovalArgs, type ApprovalDefaults, type GateOptions } from './specs.js';
+/**
+ * The blocking approval gate. Returns `"approved"`, `"rejected"` or
+ * `"error: …"`, and nothing but a real human approval returns `"approved"`.
+ */
+export declare function createM91ApprovalTool(client: M91Client, defaults?: ApprovalDefaults): Promise<Tool<ApprovalArgs, string>>;
+/** The fire-and-forget alert. Returns `"sent:delivered=N"` or `"error: …"`. */
+export declare function createM91AlertTool(client: M91Client, defaults?: AlertDefaults): Promise<Tool<AlertArgs, string>>;
+/** Both, keyed by tool name, ready to spread into `tools: {…}`. */
+export declare function createM91Tools(client: M91Client, defaults?: ApprovalDefaults & AlertDefaults): Promise<ToolSet>;
+/** The fields of an AI SDK tool call the gate reads. */
+interface ApprovalRequestLike {
+    toolCall: {
+        toolName: string;
+        input: unknown;
+        toolCallId: string;
+    };
+}
+/**
+ * A `toolApproval` function for `generateText` / `streamText` / `ToolLoopAgent`.
+ *
+ * Calls to the tools in `options.tools` block while M91 rings a phone, then run
+ * if a person approves and come back to the model as denied otherwise. Every
+ * other call is `not-applicable` and runs as normal. Not synchronous: it waits
+ * up to `timeoutSeconds` (default 300) for an answer.
+ */
+export declare function createM91ToolApproval(client: M91Client, options: GateOptions & {
+    tools: NonNullable<GateOptions['tools']>;
+}): (request: ApprovalRequestLike) => Promise<ToolApprovalStatus>;
+export {};
+//# sourceMappingURL=vercel-ai.d.ts.map

package/dist/src/integrations/vercel-ai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vercel-ai.d.ts","sourceRoot":"","sources":["../../../src/integrations/vercel-ai.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAE5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAKL,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAKjB,MAAM,YAAY,CAAC;AAqBpB;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,SAAS,EACjB,QAAQ,GAAE,gBAAqB,GAC9B,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CASrC;AAED,+EAA+E;AAC/E,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,SAAS,EACjB,QAAQ,GAAE,aAAkB,GAC3B,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAOlC;AAED,mEAAmE;AACnE,wBAAsB,cAAc,CAClC,MAAM,EAAE,SAAS,EACjB,QAAQ,GAAE,gBAAgB,GAAG,aAAkB,GAC9C,OAAO,CAAC,OAAO,CAAC,CAKlB;AAED,wDAAwD;AACxD,UAAU,mBAAmB;IAC3B,QAAQ,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;CACpE;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,WAAW,GAAG;IAAE,KAAK,EAAE,WAAW,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAA;CAAE,GAClE,CAAC,OAAO,EAAE,mBAAmB,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAY/D"}

package/dist/src/integrations/vercel-ai.js

@@ -0,0 +1,102 @@
+/**
+ * Vercel AI SDK: two tools, and a gate for your own tools.
+ *
+ * **Tools** the model calls when it decides to ask (`createM91Tools`).
+ *
+ * **Gate** (`createM91ToolApproval`) plugs into AI SDK 6+'s `toolApproval`
+ * option: every call to the tools you name rings a phone first, and runs only
+ * if a person approves. The model cannot skip it, because it never decides to
+ * ask: the SDK asks for it.
+ *
+ * ```ts
+ * const { text } = await generateText({
+ *   model: 'openai/gpt-5-mini',
+ *   tools: { issueRefund, deleteUser },
+ *   toolApproval: createM91ToolApproval(client, { tools: ['issueRefund', 'deleteUser'] }),
+ *   stopWhen: isStepCount(5),
+ *   prompt: 'Refund order ORD-40122.',
+ * });
+ * ```
+ *
+ * ```ts
+ * import { M91Client } from '@msg91comm/m91';
+ * import { createM91ApprovalTool, createM91AlertTool } from '@msg91comm/m91/integrations/vercel-ai';
+ *
+ * const client = new M91Client(process.env.M91_SEND_LINK!);
+ *
+ * const { text } = await generateText({
+ *   model: openai('gpt-4o'),
+ *   tools: {
+ *     m91_request_approval: await createM91ApprovalTool(client),
+ *     m91_send_alert: await createM91AlertTool(client),
+ *   },
+ *   stopWhen: isStepCount(10),
+ *   prompt: 'Look into order ORD-40122 and refund it if it checks out.',
+ * });
+ * ```
+ *
+ * The factories are **async** because `ai` is an optional peer dependency,
+ * imported only when one of these is called — `npm install @msg91comm/m91` stays at zero
+ * dependencies.
+ */
+import { ALERT_DESCRIPTION, ALERT_SCHEMA, APPROVAL_DESCRIPTION, APPROVAL_SCHEMA, decideToolCall, needsHuman, runAlert, runApproval, } from './specs.js';
+async function aiModule() {
+    try {
+        // A variable specifier: an optional peer dependency must not be a build
+        // requirement for this package.
+        const specifier = 'ai';
+        return (await import(specifier));
+    }
+    catch (error) {
+        throw new Error('The Vercel AI SDK integration needs the `ai` package. Install it with: npm install ai', { cause: error });
+    }
+}
+/**
+ * The blocking approval gate. Returns `"approved"`, `"rejected"` or
+ * `"error: …"`, and nothing but a real human approval returns `"approved"`.
+ */
+export async function createM91ApprovalTool(client, defaults = {}) {
+    const { tool, jsonSchema } = await aiModule();
+    return tool({
+        description: APPROVAL_DESCRIPTION,
+        // JSON Schema rather than zod, so this adapter adds no dependency of its own
+        // and the argument docs stay in one file shared with every other framework.
+        inputSchema: jsonSchema(APPROVAL_SCHEMA),
+        execute: (args) => runApproval(client, args, defaults),
+    });
+}
+/** The fire-and-forget alert. Returns `"sent:delivered=N"` or `"error: …"`. */
+export async function createM91AlertTool(client, defaults = {}) {
+    const { tool, jsonSchema } = await aiModule();
+    return tool({
+        description: ALERT_DESCRIPTION,
+        inputSchema: jsonSchema(ALERT_SCHEMA),
+        execute: (args) => runAlert(client, args, defaults),
+    });
+}
+/** Both, keyed by tool name, ready to spread into `tools: {…}`. */
+export async function createM91Tools(client, defaults = {}) {
+    return {
+        m91_request_approval: await createM91ApprovalTool(client, defaults),
+        m91_send_alert: await createM91AlertTool(client, defaults),
+    };
+}
+/**
+ * A `toolApproval` function for `generateText` / `streamText` / `ToolLoopAgent`.
+ *
+ * Calls to the tools in `options.tools` block while M91 rings a phone, then run
+ * if a person approves and come back to the model as denied otherwise. Every
+ * other call is `not-applicable` and runs as normal. Not synchronous: it waits
+ * up to `timeoutSeconds` (default 300) for an answer.
+ */
+export function createM91ToolApproval(client, options) {
+    return async ({ toolCall }) => {
+        if (!(await needsHuman(options, toolCall.toolName, toolCall.input)))
+            return 'not-applicable';
+        const decision = await decideToolCall(client, { toolName: toolCall.toolName, input: toolCall.input, callId: toolCall.toolCallId }, options);
+        return decision.approved
+            ? { type: 'approved', reason: decision.reason }
+            : { type: 'denied', reason: decision.reason };
+    };
+}
+//# sourceMappingURL=vercel-ai.js.map

package/dist/src/integrations/vercel-ai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vercel-ai.js","sourceRoot":"","sources":["../../../src/integrations/vercel-ai.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAKH,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,oBAAoB,EACpB,eAAe,EAMf,cAAc,EACd,UAAU,EACV,QAAQ,EACR,WAAW,GACZ,MAAM,YAAY,CAAC;AAOpB,KAAK,UAAU,QAAQ;IACrB,IAAI,CAAC;QACH,wEAAwE;QACxE,gCAAgC;QAChC,MAAM,SAAS,GAAG,IAAI,CAAC;QACvB,OAAO,CAAC,MAAM,MAAM,CAAC,SAAS,CAAC,CAAwB,CAAC;IAC1D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,uFAAuF,EACvF,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,MAAiB,EACjB,WAA6B,EAAE;IAE/B,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,MAAM,QAAQ,EAAE,CAAC;IAC9C,OAAO,IAAI,CAAC;QACV,WAAW,EAAE,oBAAoB;QACjC,6EAA6E;QAC7E,4EAA4E;QAC5E,WAAW,EAAE,UAAU,CAAC,eAAe,CAAC;QACxC,OAAO,EAAE,CAAC,IAAkB,EAAE,EAAE,CAAC,WAAW,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC;KACrE,CAA+B,CAAC;AACnC,CAAC;AAED,+EAA+E;AAC/E,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAiB,EACjB,WAA0B,EAAE;IAE5B,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,MAAM,QAAQ,EAAE,CAAC;IAC9C,OAAO,IAAI,CAAC;QACV,WAAW,EAAE,iBAAiB;QAC9B,WAAW,EAAE,UAAU,CAAC,YAAY,CAAC;QACrC,OAAO,EAAE,CAAC,IAAe,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC;KAC/D,CAA4B,CAAC;AAChC,CAAC;AAED,mEAAmE;AACnE,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAiB,EACjB,WAA6C,EAAE;IAE/C,OAAO;QACL,oBAAoB,EAAE,MAAM,qBAAqB,CAAC,MAAM,EAAE,QAAQ,CAAC;QACnE,cAAc,EAAE,MAAM,kBAAkB,CAAC,MAAM,EAAE,QAAQ,CAAC;KAC3D,CAAC;AACJ,CAAC;AAOD;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CACnC,MAAiB,EACjB,OAAmE;IAEnE,OAAO,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;QAC5B,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;YAAE,OAAO,gBAAgB,CAAC;QAC7F,MAAM,QAAQ,GAAG,MAAM,cAAc,CACnC,MAAM,EACN,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,UAAU,EAAE,EACnF,OAAO,CACR,CAAC;QACF,OAAO,QAAQ,CAAC,QAAQ;YACtB,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE;YAC/C,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;IAClD,CAAC,CAAC;AACJ,CAAC"}

package/dist/src/integrations/zod-shapes.d.ts

@@ -0,0 +1,19 @@
+/**
+ * The approval and alert arguments as zod shapes, for frameworks that only
+ * take zod (Claude Agent SDK, Mastra, Google ADK).
+ *
+ * Built from the zod the caller already has, passed in, so this package never
+ * imports zod itself and the descriptions stay the ones in `specs.ts`.
+ */
+/** The slice of zod this file uses; v3 and v4 both satisfy it. */
+export interface ZodLike {
+    string(): any;
+    number(): any;
+    enum(values: readonly [string, ...string[]]): any;
+    object(shape: Record<string, any>): any;
+}
+export declare function approvalShape(z: ZodLike): Record<string, any>;
+export declare function alertShape(z: ZodLike): Record<string, any>;
+/** zod is an optional peer dependency: import it only when asked, and say so if it is missing. */
+export declare function loadZod(framework: string): Promise<ZodLike>;
+//# sourceMappingURL=zod-shapes.d.ts.map

package/dist/src/integrations/zod-shapes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-shapes.d.ts","sourceRoot":"","sources":["../../../src/integrations/zod-shapes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,kEAAkE;AAClE,MAAM,WAAW,OAAO;IACtB,MAAM,IAAI,GAAG,CAAC;IACd,MAAM,IAAI,GAAG,CAAC;IACd,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,GAAG,GAAG,CAAC;IAClD,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC;CACzC;AAID,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAW7D;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAQ1D;AAED,kGAAkG;AAClG,wBAAsB,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAUjE"}