@msg91comm/m91 1.1.0 → 1.2.0

package/dist/src/integrations/google-adk.js

@@ -0,0 +1,84 @@
+/**
+ * Google Agent Development Kit for TypeScript (`@google/adk`): M91 as a
+ * before-tool gate, and M91 as tools.
+ *
+ * **Gate.** `createM91BeforeToolCallback` goes in an `LlmAgent`'s
+ * `beforeToolCallback`. Calls to the tools you name ring a phone first; if the
+ * person rejects (or does not answer), the tool does not run and the agent
+ * gets the reason back as the tool's result.
+ *
+ * ```ts
+ * import { LlmAgent } from '@google/adk';
+ * import { M91Client } from '@msg91comm/m91';
+ * import { createM91BeforeToolCallback, createM91Tools } from '@msg91comm/m91/integrations/google-adk';
+ *
+ * const client = new M91Client(process.env.M91_SEND_LINK!);
+ *
+ * const agent = new LlmAgent({
+ *   name: 'support_agent',
+ *   model: 'gemini-2.5-flash',
+ *   instruction: 'Resolve refund requests.',
+ *   tools: [issueRefund, ...(await createM91Tools(client))],
+ *   beforeToolCallback: createM91BeforeToolCallback(client, { tools: ['issue_refund'] }),
+ * });
+ * ```
+ *
+ * The gate waits for the answer in-process. For approvals that take hours,
+ * use ADK's own Tool Confirmation and resume the session when M91's answer
+ * arrives.
+ */
+import { ALERT_DESCRIPTION, ALERT_TOOL_NAME, APPROVAL_DESCRIPTION, APPROVAL_TOOL_NAME, decideToolCall, needsHuman, runAlert, runApproval, } from './specs.js';
+import { alertShape, approvalShape, loadZod } from './zod-shapes.js';
+/**
+ * A `beforeToolCallback` that asks a person on their phone before the tools
+ * in `options.tools` run. Returning a result object skips the tool, which is
+ * how a rejection reaches the model.
+ */
+export function createM91BeforeToolCallback(client, options) {
+    return async ({ tool, args, context }) => {
+        const toolName = tool.name;
+        if (!(await needsHuman(options, toolName, args)))
+            return undefined;
+        const callId = context.functionCallId ?? `${context.invocationId}-${toolName}`;
+        const decision = await decideToolCall(client, { toolName, input: args, callId }, options);
+        if (decision.approved)
+            return undefined;
+        return { status: 'rejected', error: decision.reason };
+    };
+}
+async function adkModule() {
+    try {
+        const specifier = '@google/adk';
+        return (await import(specifier));
+    }
+    catch (error) {
+        throw new Error('The Google ADK integration needs @google/adk. Install it with: npm install @google/adk', { cause: error });
+    }
+}
+/** The blocking approval tool, `m91_request_approval`, as an ADK `FunctionTool`. */
+export async function createM91ApprovalTool(client, defaults = {}) {
+    const { FunctionTool } = await adkModule();
+    const z = await loadZod('Google ADK');
+    return new FunctionTool({
+        name: APPROVAL_TOOL_NAME,
+        description: APPROVAL_DESCRIPTION,
+        parameters: z.object(approvalShape(z)),
+        execute: async (args) => ({ result: await runApproval(client, args, defaults) }),
+    });
+}
+/** The fire-and-forget alert tool, `m91_send_alert`, as an ADK `FunctionTool`. */
+export async function createM91AlertTool(client, defaults = {}) {
+    const { FunctionTool } = await adkModule();
+    const z = await loadZod('Google ADK');
+    return new FunctionTool({
+        name: ALERT_TOOL_NAME,
+        description: ALERT_DESCRIPTION,
+        parameters: z.object(alertShape(z)),
+        execute: async (args) => ({ result: await runAlert(client, args, defaults) }),
+    });
+}
+/** Both tools, for an agent's `tools` array. */
+export async function createM91Tools(client, defaults = {}) {
+    return [await createM91ApprovalTool(client, defaults), await createM91AlertTool(client, defaults)];
+}
+//# sourceMappingURL=google-adk.js.map

package/dist/src/integrations/google-adk.js.map

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

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

@@ -8,7 +8,7 @@
  * Importing a specific adapter directly is usually better —
  * `@msg91comm/m91/integrations/langchain` — because it pulls in only what you use.
  *
- * `langchain.ts` and `vercel-ai.ts` both export `createM91ApprovalTool`, so
+ * Several adapters export `createM91ApprovalTool`, so
  * they are re-exported under namespaces rather than flattened: two functions of
  * the same name doing the same job for different frameworks is exactly the pair
  * that would silently resolve to the wrong one.
@@ -16,7 +16,11 @@
 export * as langchain from './langchain.js';
 export * as langgraph from './langgraph.js';
 export * as vercelAi from './vercel-ai.js';
+export * as openaiAgents from './openai-agents.js';
+export * as claudeAgentSdk from './claude-agent-sdk.js';
+export * as googleAdk from './google-adk.js';
+export * as mastra from './mastra.js';
 export { M91InterruptNotifier, createM91ApprovalNode } from './langgraph.js';
-export { APPROVED, REJECTED, alertResult, errorResult } from './specs.js';
-export type { AlertArgs, ApprovalArgs } from './specs.js';
+export { APPROVED, REJECTED, alertResult, decideToolCall, errorResult } from './specs.js';
+export type { AlertArgs, ApprovalArgs, GateDecision, GateOptions, GatedCall } from './specs.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/integrations/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC1E,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/integrations/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,YAAY,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,cAAc,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAEtC,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC1F,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC"}

package/dist/src/integrations/index.js

@@ -8,7 +8,7 @@
  * Importing a specific adapter directly is usually better —
  * `@msg91comm/m91/integrations/langchain` — because it pulls in only what you use.
  *
- * `langchain.ts` and `vercel-ai.ts` both export `createM91ApprovalTool`, so
+ * Several adapters export `createM91ApprovalTool`, so
  * they are re-exported under namespaces rather than flattened: two functions of
  * the same name doing the same job for different frameworks is exactly the pair
  * that would silently resolve to the wrong one.
@@ -16,6 +16,10 @@
 export * as langchain from './langchain.js';
 export * as langgraph from './langgraph.js';
 export * as vercelAi from './vercel-ai.js';
+export * as openaiAgents from './openai-agents.js';
+export * as claudeAgentSdk from './claude-agent-sdk.js';
+export * as googleAdk from './google-adk.js';
+export * as mastra from './mastra.js';
 export { M91InterruptNotifier, createM91ApprovalNode } from './langgraph.js';
-export { APPROVED, REJECTED, alertResult, errorResult } from './specs.js';
+export { APPROVED, REJECTED, alertResult, decideToolCall, errorResult } from './specs.js';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/integrations/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/integrations/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,YAAY,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,cAAc,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAEtC,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

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

@@ -17,7 +17,7 @@
  *   await createM91AlertTool(client),
  *   ...myTools,
  * ];
- * const agent = createReactAgent({ llm, tools });
+ * const agent = createAgent({ model: 'openai:gpt-5-mini', tools });  // from 'langchain'
  * ```
  *
  * The factories are **async** because `@langchain/core` is an optional peer
@@ -25,19 +25,70 @@
  * install @msg91comm/m91` at zero dependencies, which matters for a package whose job is
  * to work when everything else is on fire.
  */
+import type { DynamicStructuredTool } from '@langchain/core/tools';
 import type { M91Client } from '../client.js';
-import { type AlertDefaults, type ApprovalDefaults } from './specs.js';
+import { type AlertDefaults, type ApprovalDefaults, type GateOptions } from './specs.js';
 /**
  * The blocking approval gate, as a LangChain tool named `m91_request_approval`.
  * Returns `"approved"`, `"rejected"` or `"error: …"` — and nothing but a real
  * human approval returns `"approved"`.
  */
-export declare function createM91ApprovalTool(client: M91Client, defaults?: ApprovalDefaults): Promise<unknown>;
+export declare function createM91ApprovalTool(client: M91Client, defaults?: ApprovalDefaults): Promise<DynamicStructuredTool>;
 /**
  * The fire-and-forget alert, as a LangChain tool named `m91_send_alert`.
  * Returns `"sent:delivered=N"` or `"error: …"`.
  */
-export declare function createM91AlertTool(client: M91Client, defaults?: AlertDefaults): Promise<unknown>;
+export declare function createM91AlertTool(client: M91Client, defaults?: AlertDefaults): Promise<DynamicStructuredTool>;
 /** Both, in the order an agent's `tools` array usually wants them. */
-export declare function createM91Tools(client: M91Client, defaults?: ApprovalDefaults & AlertDefaults): Promise<unknown[]>;
+export declare function createM91Tools(client: M91Client, defaults?: ApprovalDefaults & AlertDefaults): Promise<DynamicStructuredTool[]>;
+/** One tool call the middleware paused on, as `HITLRequest.actionRequests` carries it. */
+interface ActionRequestLike {
+    name: string;
+    args: Record<string, unknown>;
+    description?: string;
+}
+/** The payload of the interrupt `humanInTheLoopMiddleware` (and Deep Agents' `interruptOn`) raises. */
+export interface HITLRequestLike {
+    actionRequests: ActionRequestLike[];
+}
+/** What the middleware expects back: one decision per action request, in order. */
+export interface M91HITLResponse {
+    decisions: Array<{
+        type: 'approve';
+    } | {
+        type: 'reject';
+        message: string;
+    }>;
+}
+/**
+ * Ask a person about every tool call in a `HITLRequest`, one phone alert per
+ * call, and build the `{ decisions }` the middleware resumes with.
+ *
+ * `"approved"` / `"rejected"` strings (what `M91InterruptNotifier` returns) are
+ * **not** a valid resume value for the middleware; this is.
+ *
+ * `threadId` makes each alert's customId stable across a retry of the same
+ * pause, so a retried resume does not ring twice.
+ */
+export declare function resolveHITLWithM91(request: HITLRequestLike, client: M91Client, options?: GateOptions & {
+    threadId?: string;
+}): Promise<M91HITLResponse>;
+/** The parts of a LangChain agent / Deep Agent / compiled graph this file calls. */
+export interface InvokableAgentLike {
+    invoke(input: any, config?: any): Promise<any>;
+}
+/**
+ * `agent.invoke()`, with every `humanInTheLoopMiddleware` pause answered on a
+ * phone through M91 and resumed with `Command({ resume: { decisions } })`.
+ * Works for `createAgent` with `humanInTheLoopMiddleware` and for Deep Agents
+ * created with `interruptOn`. Needs a checkpointer and a `thread_id`.
+ */
+export declare function invokeWithM91Approvals<TResult = any>(agent: InvokableAgentLike, input: unknown, config: {
+    configurable: {
+        thread_id: string;
+    };
+} & Record<string, unknown>, client: M91Client, options?: GateOptions & {
+    maxRounds?: number;
+}): Promise<TResult>;
+export {};
 //# sourceMappingURL=langchain.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"langchain.d.ts","sourceRoot":"","sources":["../../../src/integrations/langchain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAQL,KAAK,aAAa,EAElB,KAAK,gBAAgB,EAGtB,MAAM,YAAY,CAAC;AAmBpB;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,SAAS,EACjB,QAAQ,GAAE,gBAAqB,GAC9B,OAAO,CAAC,OAAO,CAAC,CAOlB;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,SAAS,EACjB,QAAQ,GAAE,aAAkB,GAC3B,OAAO,CAAC,OAAO,CAAC,CAOlB;AAED,sEAAsE;AACtE,wBAAsB,cAAc,CAClC,MAAM,EAAE,SAAS,EACjB,QAAQ,GAAE,gBAAgB,GAAG,aAAkB,GAC9C,OAAO,CAAC,OAAO,EAAE,CAAC,CAKpB"}
+{"version":3,"file":"langchain.d.ts","sourceRoot":"","sources":["../../../src/integrations/langchain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAQL,KAAK,aAAa,EAElB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAIjB,MAAM,YAAY,CAAC;AAmBpB;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,SAAS,EACjB,QAAQ,GAAE,gBAAqB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CAOhC;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,SAAS,EACjB,QAAQ,GAAE,aAAkB,GAC3B,OAAO,CAAC,qBAAqB,CAAC,CAOhC;AAED,sEAAsE;AACtE,wBAAsB,cAAc,CAClC,MAAM,EAAE,SAAS,EACjB,QAAQ,GAAE,gBAAgB,GAAG,aAAkB,GAC9C,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAKlC;AAMD,0FAA0F;AAC1F,UAAU,iBAAiB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,uGAAuG;AACvG,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,iBAAiB,EAAE,CAAC;CACrC;AAED,mFAAmF;AACnF,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,SAAS,CAAA;KAAE,GAAG;QAAE,IAAI,EAAE,QAAQ,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC7E;AAMD;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,eAAe,EACxB,MAAM,EAAE,SAAS,EACjB,OAAO,GAAE,WAAW,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAChD,OAAO,CAAC,eAAe,CAAC,CAY1B;AAED,oFAAoF;AACpF,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;CAChD;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAAC,OAAO,GAAG,GAAG,EACxD,KAAK,EAAE,kBAAkB,EACzB,KAAK,EAAE,OAAO,EACd,MAAM,EAAE;IAAE,YAAY,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzE,MAAM,EAAE,SAAS,EACjB,OAAO,GAAE,WAAW,GAAG;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACjD,OAAO,CAAC,OAAO,CAAC,CAclB"}

package/dist/src/integrations/langchain.js

@@ -17,7 +17,7 @@
  *   await createM91AlertTool(client),
  *   ...myTools,
  * ];
- * const agent = createReactAgent({ llm, tools });
+ * const agent = createAgent({ model: 'openai:gpt-5-mini', tools });  // from 'langchain'
  * ```
  *
  * The factories are **async** because `@langchain/core` is an optional peer
@@ -25,7 +25,7 @@
  * install @msg91comm/m91` at zero dependencies, which matters for a package whose job is
  * to work when everything else is on fire.
  */
-import { ALERT_DESCRIPTION, ALERT_SCHEMA, ALERT_TOOL_NAME, APPROVAL_DESCRIPTION, APPROVAL_SCHEMA, APPROVAL_TOOL_NAME, runAlert, runApproval, } from './specs.js';
+import { ALERT_DESCRIPTION, ALERT_SCHEMA, ALERT_TOOL_NAME, APPROVAL_DESCRIPTION, APPROVAL_SCHEMA, APPROVAL_TOOL_NAME, decideToolCall, runAlert, runApproval, } from './specs.js';
 async function langchainTool() {
     try {
         // The specifier is a variable so TypeScript does not try to resolve an
@@ -72,4 +72,58 @@ export async function createM91Tools(client, defaults = {}) {
         await createM91AlertTool(client, defaults),
     ];
 }
+function isHITLRequest(value) {
+    return Array.isArray(value?.actionRequests);
+}
+/**
+ * Ask a person about every tool call in a `HITLRequest`, one phone alert per
+ * call, and build the `{ decisions }` the middleware resumes with.
+ *
+ * `"approved"` / `"rejected"` strings (what `M91InterruptNotifier` returns) are
+ * **not** a valid resume value for the middleware; this is.
+ *
+ * `threadId` makes each alert's customId stable across a retry of the same
+ * pause, so a retried resume does not ring twice.
+ */
+export async function resolveHITLWithM91(request, client, options = {}) {
+    const decisions = [];
+    for (const [index, action] of request.actionRequests.entries()) {
+        const callId = `${options.threadId ?? 'run'}-${index}`;
+        const decision = await decideToolCall(client, { toolName: action.name, input: action.args, callId }, options);
+        decisions.push(decision.approved ? { type: 'approve' } : { type: 'reject', message: decision.reason });
+    }
+    return { decisions };
+}
+/**
+ * `agent.invoke()`, with every `humanInTheLoopMiddleware` pause answered on a
+ * phone through M91 and resumed with `Command({ resume: { decisions } })`.
+ * Works for `createAgent` with `humanInTheLoopMiddleware` and for Deep Agents
+ * created with `interruptOn`. Needs a checkpointer and a `thread_id`.
+ */
+export async function invokeWithM91Approvals(agent, input, config, client, options = {}) {
+    const { Command } = await langgraphModule();
+    const { maxRounds = 20, ...gate } = options;
+    let result = await agent.invoke(input, config);
+    for (let round = 0; round < maxRounds; round += 1) {
+        const pending = result?.__interrupt__?.[0]?.value;
+        if (!isHITLRequest(pending))
+            break;
+        const response = await resolveHITLWithM91(pending, client, {
+            ...gate,
+            threadId: `${config.configurable.thread_id}-${round}`,
+        });
+        result = await agent.invoke(new Command({ resume: response }), config);
+    }
+    return result;
+}
+async function langgraphModule() {
+    try {
+        const specifier = '@langchain/langgraph';
+        return (await import(specifier));
+    }
+    catch (error) {
+        throw new Error('Resuming a LangChain / Deep Agents interrupt needs @langchain/langgraph. Install it with: ' +
+            'npm install @langchain/langgraph', { cause: error });
+    }
+}
 //# sourceMappingURL=langchain.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"langchain.js","sourceRoot":"","sources":["../../../src/integrations/langchain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,eAAe,EACf,oBAAoB,EACpB,eAAe,EACf,kBAAkB,EAKlB,QAAQ,EACR,WAAW,GACZ,MAAM,YAAY,CAAC;AAEpB,KAAK,UAAU,aAAa;IAC1B,IAAI,CAAC;QACH,uEAAuE;QACvE,0EAA0E;QAC1E,2CAA2C;QAC3C,MAAM,SAAS,GAAG,uBAAuB,CAAC;QAC1C,MAAM,GAAG,GAAG,CAAC,MAAM,MAAM,CAAC,SAAS,CAAC,CAAwD,CAAC;QAC7F,OAAO,GAAG,CAAC,IAAI,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,oEAAoE;YAClE,6BAA6B,EAC/B,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,MAAiB,EACjB,WAA6B,EAAE;IAE/B,MAAM,IAAI,GAAG,MAAM,aAAa,EAAE,CAAC;IACnC,OAAO,IAAI,CAAC,CAAC,IAAkB,EAAE,EAAE,CAAC,WAAW,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE;QACvE,IAAI,EAAE,kBAAkB;QACxB,WAAW,EAAE,oBAAoB;QACjC,MAAM,EAAE,eAAe;KACxB,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAiB,EACjB,WAA0B,EAAE;IAE5B,MAAM,IAAI,GAAG,MAAM,aAAa,EAAE,CAAC;IACnC,OAAO,IAAI,CAAC,CAAC,IAAe,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE;QACjE,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,iBAAiB;QAC9B,MAAM,EAAE,YAAY;KACrB,CAAC,CAAC;AACL,CAAC;AAED,sEAAsE;AACtE,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAiB,EACjB,WAA6C,EAAE;IAE/C,OAAO;QACL,MAAM,qBAAqB,CAAC,MAAM,EAAE,QAAQ,CAAC;QAC7C,MAAM,kBAAkB,CAAC,MAAM,EAAE,QAAQ,CAAC;KAC3C,CAAC;AACJ,CAAC"}
+{"version":3,"file":"langchain.js","sourceRoot":"","sources":["../../../src/integrations/langchain.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,75 @@
+/**
+ * Mastra (`@mastra/core`): M91 as the approver for `requireApproval` tools,
+ * and M91 as tools.
+ *
+ * **Approver.** Mark your risky tools `requireApproval: true`. Mastra suspends
+ * the run when the agent calls one; `generateWithM91Approvals` rings a phone
+ * for each suspended call and approves or declines it with the person's
+ * answer until the run finishes.
+ *
+ * ```ts
+ * import { Agent } from '@mastra/core/agent';
+ * import { createTool } from '@mastra/core/tools';
+ * import { M91Client } from '@msg91comm/m91';
+ * import { generateWithM91Approvals } from '@msg91comm/m91/integrations/mastra';
+ *
+ * const issueRefund = createTool({
+ *   id: 'issue-refund',
+ *   description: 'Refund an order.',
+ *   inputSchema: z.object({ orderId: z.string(), amount: z.number() }),
+ *   requireApproval: true,
+ *   execute: async ({ orderId, amount }) => refunds.create(orderId, amount),
+ * });
+ *
+ * const agent = new Agent({ id: 'support', name: 'Support', instructions: '…',
+ *   model: 'openai/gpt-5-mini', tools: { issueRefund } });
+ * const client = new M91Client(process.env.M91_SEND_LINK!);
+ *
+ * const output = await generateWithM91Approvals(agent, 'Refund ORD-40122.', client);
+ * console.log(output.text);
+ * ```
+ *
+ * Mastra keeps suspended runs in its storage, so configure a storage provider
+ * on your `Mastra` instance for approvals to resume.
+ */
+import type { Tool } from '@mastra/core/tools';
+import type { M91Client } from '../client.js';
+import { type AlertDefaults, type ApprovalDefaults, type GateOptions } from './specs.js';
+/** The parts of a Mastra `generate()` result this file reads. */
+export interface MastraOutputLike {
+    text: string;
+    finishReason?: unknown;
+    runId?: string;
+    suspendPayload?: unknown;
+}
+/** The parts of a Mastra `Agent` this file calls. */
+export interface MastraAgentLike<TOutput extends MastraOutputLike = MastraOutputLike> {
+    generate(prompt: any, options?: any): Promise<TOutput>;
+    approveToolCallGenerate(options: {
+        runId: string;
+        toolCallId?: string;
+    }): Promise<TOutput>;
+    declineToolCallGenerate(options: {
+        runId: string;
+        toolCallId?: string;
+        reason?: string;
+    }): Promise<TOutput>;
+}
+/**
+ * `agent.generate()`, with every tool approval the run suspends for answered
+ * on a phone through M91. Approvals for tools outside `options.tools` are
+ * returned still suspended, for your own code.
+ */
+export declare function generateWithM91Approvals<TOutput extends MastraOutputLike>(agent: MastraAgentLike<TOutput>, prompt: unknown, client: M91Client, options?: GateOptions & {
+    generateOptions?: Record<string, unknown>;
+    maxRounds?: number;
+}): Promise<TOutput>;
+/** A Mastra tool, typed loosely enough to drop into any agent's `tools`. */
+export type M91MastraTool = Tool<any, any, any, any, any, string, any>;
+/** The blocking approval tool, `m91_request_approval`, as a Mastra tool. */
+export declare function createM91ApprovalTool(client: M91Client, defaults?: ApprovalDefaults): Promise<M91MastraTool>;
+/** The fire-and-forget alert tool, `m91_send_alert`, as a Mastra tool. */
+export declare function createM91AlertTool(client: M91Client, defaults?: AlertDefaults): Promise<M91MastraTool>;
+/** Both tools, keyed for an `Agent`'s `tools` object. */
+export declare function createM91Tools(client: M91Client, defaults?: ApprovalDefaults & AlertDefaults): Promise<Record<string, M91MastraTool>>;
+//# sourceMappingURL=mastra.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mastra.d.ts","sourceRoot":"","sources":["../../../src/integrations/mastra.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAE/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAML,KAAK,aAAa,EAElB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAKjB,MAAM,YAAY,CAAC;AAGpB,iEAAiE;AACjE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,qDAAqD;AACrD,MAAM,WAAW,eAAe,CAAC,OAAO,SAAS,gBAAgB,GAAG,gBAAgB;IAClF,QAAQ,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvD,uBAAuB,CAAC,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3F,uBAAuB,CAAC,OAAO,EAAE;QAC/B,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACtB;AAeD;;;;GAIG;AACH,wBAAsB,wBAAwB,CAAC,OAAO,SAAS,gBAAgB,EAC7E,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,EAC/B,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,SAAS,EACjB,OAAO,GAAE,WAAW,GAAG;IAAE,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAC5F,OAAO,CAAC,OAAO,CAAC,CAqBlB;AAiBD,4EAA4E;AAC5E,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;AAEvE,4EAA4E;AAC5E,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,SAAS,EACjB,QAAQ,GAAE,gBAAqB,GAC9B,OAAO,CAAC,aAAa,CAAC,CASxB;AAED,0EAA0E;AAC1E,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,SAAS,EACjB,QAAQ,GAAE,aAAkB,GAC3B,OAAO,CAAC,aAAa,CAAC,CASxB;AAED,yDAAyD;AACzD,wBAAsB,cAAc,CAClC,MAAM,EAAE,SAAS,EACjB,QAAQ,GAAE,gBAAgB,GAAG,aAAkB,GAC9C,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAKxC"}

package/dist/src/integrations/mastra.js

@@ -0,0 +1,109 @@
+/**
+ * Mastra (`@mastra/core`): M91 as the approver for `requireApproval` tools,
+ * and M91 as tools.
+ *
+ * **Approver.** Mark your risky tools `requireApproval: true`. Mastra suspends
+ * the run when the agent calls one; `generateWithM91Approvals` rings a phone
+ * for each suspended call and approves or declines it with the person's
+ * answer until the run finishes.
+ *
+ * ```ts
+ * import { Agent } from '@mastra/core/agent';
+ * import { createTool } from '@mastra/core/tools';
+ * import { M91Client } from '@msg91comm/m91';
+ * import { generateWithM91Approvals } from '@msg91comm/m91/integrations/mastra';
+ *
+ * const issueRefund = createTool({
+ *   id: 'issue-refund',
+ *   description: 'Refund an order.',
+ *   inputSchema: z.object({ orderId: z.string(), amount: z.number() }),
+ *   requireApproval: true,
+ *   execute: async ({ orderId, amount }) => refunds.create(orderId, amount),
+ * });
+ *
+ * const agent = new Agent({ id: 'support', name: 'Support', instructions: '…',
+ *   model: 'openai/gpt-5-mini', tools: { issueRefund } });
+ * const client = new M91Client(process.env.M91_SEND_LINK!);
+ *
+ * const output = await generateWithM91Approvals(agent, 'Refund ORD-40122.', client);
+ * console.log(output.text);
+ * ```
+ *
+ * Mastra keeps suspended runs in its storage, so configure a storage provider
+ * on your `Mastra` instance for approvals to resume.
+ */
+import { ALERT_DESCRIPTION, ALERT_TOOL_NAME, APPROVAL_DESCRIPTION, APPROVAL_TOOL_NAME, decideToolCall, needsHuman, runAlert, runApproval, } from './specs.js';
+import { alertShape, approvalShape, loadZod } from './zod-shapes.js';
+function pendingApproval(output) {
+    if (output.finishReason !== 'suspended' || !output.runId)
+        return null;
+    const payload = output.suspendPayload;
+    if (!payload?.toolCallId || !payload.toolName)
+        return null;
+    return { toolCallId: payload.toolCallId, toolName: payload.toolName, args: payload.args };
+}
+/**
+ * `agent.generate()`, with every tool approval the run suspends for answered
+ * on a phone through M91. Approvals for tools outside `options.tools` are
+ * returned still suspended, for your own code.
+ */
+export async function generateWithM91Approvals(agent, prompt, client, options = {}) {
+    const { generateOptions, maxRounds = 20, ...gate } = options;
+    let output = await agent.generate(prompt, generateOptions);
+    for (let round = 0; round < maxRounds; round += 1) {
+        const pending = pendingApproval(output);
+        if (!pending || !(await needsHuman(gate, pending.toolName, pending.args)))
+            break;
+        const runId = output.runId;
+        const decision = await decideToolCall(client, { toolName: pending.toolName, input: pending.args, callId: pending.toolCallId }, gate);
+        output = decision.approved
+            ? await agent.approveToolCallGenerate({ runId, toolCallId: pending.toolCallId })
+            : await agent.declineToolCallGenerate({
+                runId,
+                toolCallId: pending.toolCallId,
+                reason: decision.reason,
+            });
+    }
+    return output;
+}
+async function mastraTools() {
+    try {
+        const specifier = '@mastra/core/tools';
+        return (await import(specifier));
+    }
+    catch (error) {
+        throw new Error('The Mastra integration needs @mastra/core. Install it with: npm install @mastra/core', {
+            cause: error,
+        });
+    }
+}
+/** The blocking approval tool, `m91_request_approval`, as a Mastra tool. */
+export async function createM91ApprovalTool(client, defaults = {}) {
+    const { createTool } = await mastraTools();
+    const z = await loadZod('Mastra');
+    return createTool({
+        id: APPROVAL_TOOL_NAME,
+        description: APPROVAL_DESCRIPTION,
+        inputSchema: z.object(approvalShape(z)),
+        execute: async (args) => ({ result: await runApproval(client, args, defaults) }),
+    });
+}
+/** The fire-and-forget alert tool, `m91_send_alert`, as a Mastra tool. */
+export async function createM91AlertTool(client, defaults = {}) {
+    const { createTool } = await mastraTools();
+    const z = await loadZod('Mastra');
+    return createTool({
+        id: ALERT_TOOL_NAME,
+        description: ALERT_DESCRIPTION,
+        inputSchema: z.object(alertShape(z)),
+        execute: async (args) => ({ result: await runAlert(client, args, defaults) }),
+    });
+}
+/** Both tools, keyed for an `Agent`'s `tools` object. */
+export async function createM91Tools(client, defaults = {}) {
+    return {
+        [APPROVAL_TOOL_NAME]: await createM91ApprovalTool(client, defaults),
+        [ALERT_TOOL_NAME]: await createM91AlertTool(client, defaults),
+    };
+}
+//# sourceMappingURL=mastra.js.map

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

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

package/dist/src/integrations/openai-agents.d.ts

@@ -0,0 +1,61 @@
+/**
+ * OpenAI Agents SDK (`@openai/agents`): two tools, and M91 as the approver.
+ *
+ * **Approver.** Mark your risky tools `needsApproval: true`. The SDK pauses the
+ * run and returns `result.interruptions`; `runWithM91Approvals` rings a phone
+ * for each one, approves or rejects it on the run state with the person's
+ * answer, and resumes the same run until it finishes.
+ *
+ * ```ts
+ * import { Agent, tool } from '@openai/agents';
+ * import { M91Client } from '@msg91comm/m91';
+ * import { runWithM91Approvals } from '@msg91comm/m91/integrations/openai-agents';
+ *
+ * const issueRefund = tool({
+ *   name: 'issue_refund',
+ *   description: 'Refund an order.',
+ *   parameters: z.object({ orderId: z.string(), amount: z.number() }),
+ *   needsApproval: true,
+ *   execute: async ({ orderId, amount }) => refunds.create(orderId, amount),
+ * });
+ *
+ * const agent = new Agent({ name: 'Support', instructions: '…', tools: [issueRefund] });
+ * const client = new M91Client(process.env.M91_SEND_LINK!);
+ *
+ * const result = await runWithM91Approvals(agent, 'Refund ORD-40122, it never arrived.', client);
+ * console.log(result.finalOutput);
+ * ```
+ *
+ * **Tools** (`createM91Tools`) are for when the model itself should decide to
+ * ask, or to wake somebody about something that happened.
+ *
+ * `@openai/agents` is an optional peer dependency, imported only when one of
+ * these is called.
+ */
+import type { Agent, FunctionTool, RunResult } from '@openai/agents';
+import type { M91Client } from '../client.js';
+import { type AlertDefaults, type ApprovalDefaults, type GateOptions } from './specs.js';
+/** The blocking approval tool, `m91_request_approval`. Returns `"approved"`, `"rejected"` or `"error: …"`. */
+export declare function createM91ApprovalTool(client: M91Client, defaults?: ApprovalDefaults): Promise<FunctionTool>;
+/** The fire-and-forget alert tool, `m91_send_alert`. Returns `"sent:delivered=N"` or `"error: …"`. */
+export declare function createM91AlertTool(client: M91Client, defaults?: AlertDefaults): Promise<FunctionTool>;
+/** Both tools, for an agent's `tools` array. */
+export declare function createM91Tools(client: M91Client, defaults?: ApprovalDefaults & AlertDefaults): Promise<FunctionTool[]>;
+/**
+ * Ask a person about every pending approval on a paused run, and record the
+ * answers on its state. Returns how many were decided; resume with
+ * `run(agent, result.state)`.
+ *
+ * Interruptions for tools outside `options.tools` are left pending for your
+ * own code to decide.
+ */
+export declare function approveInterruptionsWithM91(result: Pick<RunResult<any, any>, 'interruptions' | 'state'>, client: M91Client, options?: GateOptions): Promise<number>;
+/**
+ * `run()`, with every approval the run pauses for answered on a phone through
+ * M91, until the run finishes or nothing left to decide is M91's.
+ */
+export declare function runWithM91Approvals<TAgent extends Agent<any, any>>(agent: TAgent, input: string | Parameters<typeof import('@openai/agents').run>[1], client: M91Client, options?: GateOptions & {
+    runOptions?: Record<string, unknown>;
+    maxRounds?: number;
+}): Promise<RunResult<any, TAgent>>;
+//# sourceMappingURL=openai-agents.d.ts.map

package/dist/src/integrations/openai-agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-agents.d.ts","sourceRoot":"","sources":["../../../src/integrations/openai-agents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAiC,MAAM,gBAAgB,CAAC;AAEpG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAQL,KAAK,aAAa,EAElB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAKjB,MAAM,YAAY,CAAC;AAmBpB,8GAA8G;AAC9G,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,SAAS,EACjB,QAAQ,GAAE,gBAAqB,GAC9B,OAAO,CAAC,YAAY,CAAC,CAUvB;AAED,sGAAsG;AACtG,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,SAAS,EACjB,QAAQ,GAAE,aAAkB,GAC3B,OAAO,CAAC,YAAY,CAAC,CASvB;AAED,gDAAgD;AAChD,wBAAsB,cAAc,CAClC,MAAM,EAAE,SAAS,EACjB,QAAQ,GAAE,gBAAgB,GAAG,aAAkB,GAC9C,OAAO,CAAC,YAAY,EAAE,CAAC,CAEzB;AAiBD;;;;;;;GAOG;AACH,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,EAC5D,MAAM,EAAE,SAAS,EACjB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,MAAM,CAAC,CAajB;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,SAAS,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC,EACtE,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GAAG,UAAU,CAAC,cAAc,gBAAgB,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,EAClE,MAAM,EAAE,SAAS,EACjB,OAAO,GAAE,WAAW,GAAG;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACvF,OAAO,CAAC,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CASjC"}