@msg91comm/m91 0.0.0-stage → 1.2.0

package/dist/src/integrations/claude-agent-sdk.js

@@ -0,0 +1,109 @@
+/**
+ * Claude Agent SDK (`@anthropic-ai/claude-agent-sdk`): M91 as the permission
+ * prompt, and M91 as tools.
+ *
+ * **Permission prompt.** `createM91CanUseTool` is a `canUseTool` callback: the
+ * tools you name ring a phone and run only if a person approves. Everything
+ * else is allowed through untouched.
+ *
+ * ```ts
+ * import { query } from '@anthropic-ai/claude-agent-sdk';
+ * import { M91Client } from '@msg91comm/m91';
+ * import { createM91CanUseTool } from '@msg91comm/m91/integrations/claude-agent-sdk';
+ *
+ * const client = new M91Client(process.env.M91_SEND_LINK!);
+ *
+ * for await (const message of query({
+ *   prompt: 'Clean up the stale feature branches and deploy main.',
+ *   options: { canUseTool: createM91CanUseTool(client, { tools: ['Bash', 'Write'] }) },
+ * })) {
+ *   if (message.type === 'result') console.log(message);
+ * }
+ * ```
+ *
+ * `canUseTool` only runs when the SDK would otherwise ask. To gate a tool
+ * whatever the permission mode (including `bypassPermissions`), use the
+ * `PreToolUse` hook from `createM91PreToolUseHook` instead.
+ *
+ * **Tools.** `createM91McpServer` exposes `m91_request_approval` and
+ * `m91_send_alert` as an in-process MCP server, for when the agent itself
+ * should decide to ask or to wake somebody.
+ */
+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 `canUseTool` callback that asks a person on their phone before the tools
+ * in `options.tools` run.
+ */
+export function createM91CanUseTool(client, options) {
+    return async (toolName, input, { toolUseID }) => {
+        if (!(await needsHuman(options, toolName, input))) {
+            return { behavior: 'allow', updatedInput: input };
+        }
+        const decision = await decideToolCall(client, { toolName, input, callId: toolUseID }, options);
+        return decision.approved
+            ? { behavior: 'allow', updatedInput: input }
+            : { behavior: 'deny', message: decision.reason };
+    };
+}
+/**
+ * A `PreToolUse` hook matcher that asks a person before the tools in
+ * `options.tools` run, in every permission mode. Pass it as
+ * `options.hooks.PreToolUse`.
+ *
+ * ```ts
+ * query({ prompt, options: { hooks: { PreToolUse: createM91PreToolUseHook(client, { tools: ['Bash'] }) } } })
+ * ```
+ */
+export function createM91PreToolUseHook(client, options) {
+    return [
+        {
+            // The hook must outlive the wait for a human, or the SDK gives up first.
+            timeout: (options.timeoutSeconds ?? 300) + 60,
+            hooks: [
+                async (input) => {
+                    if (input.hook_event_name !== 'PreToolUse')
+                        return {};
+                    if (!(await needsHuman(options, input.tool_name, input.tool_input)))
+                        return {};
+                    const decision = await decideToolCall(client, { toolName: input.tool_name, input: input.tool_input, callId: input.tool_use_id }, options);
+                    return {
+                        hookSpecificOutput: {
+                            hookEventName: 'PreToolUse',
+                            permissionDecision: decision.approved ? 'allow' : 'deny',
+                            permissionDecisionReason: decision.reason,
+                        },
+                    };
+                },
+            ],
+        },
+    ];
+}
+async function claudeSdk() {
+    try {
+        const specifier = '@anthropic-ai/claude-agent-sdk';
+        return (await import(specifier));
+    }
+    catch (error) {
+        throw new Error('The Claude Agent SDK integration needs @anthropic-ai/claude-agent-sdk. Install it with: ' +
+            'npm install @anthropic-ai/claude-agent-sdk', { cause: error });
+    }
+}
+const text = (value) => ({ content: [{ type: 'text', text: value }] });
+/**
+ * `m91_request_approval` and `m91_send_alert` as an in-process MCP server.
+ * Register it under `mcpServers.m91`; the tools appear to Claude as
+ * `mcp__m91__m91_request_approval` and `mcp__m91__m91_send_alert`.
+ */
+export async function createM91McpServer(client, defaults = {}) {
+    const { tool, createSdkMcpServer } = await claudeSdk();
+    const z = await loadZod('Claude Agent SDK');
+    return createSdkMcpServer({
+        name: 'm91',
+        tools: [
+            tool(APPROVAL_TOOL_NAME, APPROVAL_DESCRIPTION, approvalShape(z), async (args) => text(await runApproval(client, args, defaults))),
+            tool(ALERT_TOOL_NAME, ALERT_DESCRIPTION, alertShape(z), async (args) => text(await runAlert(client, args, defaults))),
+        ],
+    });
+}
+//# sourceMappingURL=claude-agent-sdk.js.map

package/dist/src/integrations/claude-agent-sdk.js.map

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

package/dist/src/integrations/google-adk.d.ts

@@ -0,0 +1,47 @@
+/**
+ * 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 type { BaseTool, SingleBeforeToolCallback } from '@google/adk';
+import type { M91Client } from '../client.js';
+import { type AlertDefaults, type ApprovalDefaults, type GateOptions } from './specs.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 declare function createM91BeforeToolCallback(client: M91Client, options: GateOptions & {
+    tools: NonNullable<GateOptions['tools']>;
+}): SingleBeforeToolCallback;
+/** The blocking approval tool, `m91_request_approval`, as an ADK `FunctionTool`. */
+export declare function createM91ApprovalTool(client: M91Client, defaults?: ApprovalDefaults): Promise<BaseTool>;
+/** The fire-and-forget alert tool, `m91_send_alert`, as an ADK `FunctionTool`. */
+export declare function createM91AlertTool(client: M91Client, defaults?: AlertDefaults): Promise<BaseTool>;
+/** Both tools, for an agent's `tools` array. */
+export declare function createM91Tools(client: M91Client, defaults?: ApprovalDefaults & AlertDefaults): Promise<BaseTool[]>;
+//# sourceMappingURL=google-adk.d.ts.map

package/dist/src/integrations/google-adk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"google-adk.d.ts","sourceRoot":"","sources":["../../../src/integrations/google-adk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAgB,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAEpF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAML,KAAK,aAAa,EAElB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAKjB,MAAM,YAAY,CAAC;AAGpB;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,WAAW,GAAG;IAAE,KAAK,EAAE,WAAW,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAA;CAAE,GAClE,wBAAwB,CAS1B;AAkBD,oFAAoF;AACpF,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,SAAS,EACjB,QAAQ,GAAE,gBAAqB,GAC9B,OAAO,CAAC,QAAQ,CAAC,CASnB;AAED,kFAAkF;AAClF,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,SAAS,EACjB,QAAQ,GAAE,aAAkB,GAC3B,OAAO,CAAC,QAAQ,CAAC,CASnB;AAED,gDAAgD;AAChD,wBAAsB,cAAc,CAClC,MAAM,EAAE,SAAS,EACjB,QAAQ,GAAE,gBAAgB,GAAG,aAAkB,GAC9C,OAAO,CAAC,QAAQ,EAAE,CAAC,CAErB"}

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

@@ -0,0 +1,26 @@
+/**
+ * Framework adapters, re-exported.
+ *
+ * Each one imports its framework lazily, so `npm install @msg91comm/m91` pulls in none of
+ * them and using one you have not installed says which package to install
+ * rather than failing with a bare module-not-found from three frames down.
+ *
+ * Importing a specific adapter directly is usually better —
+ * `@msg91comm/m91/integrations/langchain` — because it pulls in only what you use.
+ *
+ * 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.
+ */
+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, 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

@@ -0,0 +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;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

@@ -0,0 +1,25 @@
+/**
+ * Framework adapters, re-exported.
+ *
+ * Each one imports its framework lazily, so `npm install @msg91comm/m91` pulls in none of
+ * them and using one you have not installed says which package to install
+ * rather than failing with a bare module-not-found from three frames down.
+ *
+ * Importing a specific adapter directly is usually better —
+ * `@msg91comm/m91/integrations/langchain` — because it pulls in only what you use.
+ *
+ * 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.
+ */
+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, decideToolCall, errorResult } from './specs.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +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;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

@@ -0,0 +1,94 @@
+/**
+ * LangChain tools.
+ *
+ * Two of them, and the split matters more than it looks:
+ *
+ * - the approval tool **blocks**. The agent stops until a human answers on
+ *   their phone. Give it to an agent that can do something irreversible.
+ * - the alert tool does not. It wakes somebody and carries on.
+ *
+ * ```ts
+ * import { M91Client } from '@msg91comm/m91';
+ * import { createM91ApprovalTool, createM91AlertTool } from '@msg91comm/m91/integrations/langchain';
+ *
+ * const client = new M91Client(process.env.M91_SEND_LINK!);
+ * const tools = [
+ *   await createM91ApprovalTool(client),
+ *   await createM91AlertTool(client),
+ *   ...myTools,
+ * ];
+ * const agent = createAgent({ model: 'openai:gpt-5-mini', tools });  // from 'langchain'
+ * ```
+ *
+ * The factories are **async** because `@langchain/core` is an optional peer
+ * dependency, imported only when one of these is called. That keeps `npm
+ * 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, 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<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<DynamicStructuredTool>;
+/** Both, in the order an agent's `tools` array usually wants them. */
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,129 @@
+/**
+ * LangChain tools.
+ *
+ * Two of them, and the split matters more than it looks:
+ *
+ * - the approval tool **blocks**. The agent stops until a human answers on
+ *   their phone. Give it to an agent that can do something irreversible.
+ * - the alert tool does not. It wakes somebody and carries on.
+ *
+ * ```ts
+ * import { M91Client } from '@msg91comm/m91';
+ * import { createM91ApprovalTool, createM91AlertTool } from '@msg91comm/m91/integrations/langchain';
+ *
+ * const client = new M91Client(process.env.M91_SEND_LINK!);
+ * const tools = [
+ *   await createM91ApprovalTool(client),
+ *   await createM91AlertTool(client),
+ *   ...myTools,
+ * ];
+ * const agent = createAgent({ model: 'openai:gpt-5-mini', tools });  // from 'langchain'
+ * ```
+ *
+ * The factories are **async** because `@langchain/core` is an optional peer
+ * dependency, imported only when one of these is called. That keeps `npm
+ * 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, decideToolCall, runAlert, runApproval, } from './specs.js';
+async function langchainTool() {
+    try {
+        // The specifier is a variable so TypeScript does not try to resolve an
+        // optional peer dependency at build time. Compiling this package must not
+        // require every framework it can adapt to.
+        const specifier = '@langchain/core/tools';
+        const mod = (await import(specifier));
+        return mod.tool;
+    }
+    catch (error) {
+        throw new Error('The LangChain integration needs @langchain/core. Install it with: ' +
+            'npm install @langchain/core', { cause: error });
+    }
+}
+/**
+ * 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 async function createM91ApprovalTool(client, defaults = {}) {
+    const tool = await langchainTool();
+    return tool((args) => runApproval(client, args, defaults), {
+        name: APPROVAL_TOOL_NAME,
+        description: APPROVAL_DESCRIPTION,
+        schema: APPROVAL_SCHEMA,
+    });
+}
+/**
+ * The fire-and-forget alert, as a LangChain tool named `m91_send_alert`.
+ * Returns `"sent:delivered=N"` or `"error: …"`.
+ */
+export async function createM91AlertTool(client, defaults = {}) {
+    const tool = await langchainTool();
+    return tool((args) => runAlert(client, args, defaults), {
+        name: ALERT_TOOL_NAME,
+        description: ALERT_DESCRIPTION,
+        schema: ALERT_SCHEMA,
+    });
+}
+/** Both, in the order an agent's `tools` array usually wants them. */
+export async function createM91Tools(client, defaults = {}) {
+    return [
+        await createM91ApprovalTool(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

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

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

@@ -0,0 +1,79 @@
+/**
+ * LangGraph helpers for the `interrupt()` pattern.
+ *
+ * LangGraph already knows how to stop a graph and resume it. What it has no
+ * opinion about is **how the human finds out it stopped** — and the default
+ * answer is that somebody notices a paused run in a web UI. At 2am, for a graph
+ * that paused because it wants to move money, nobody does. M91 fills exactly
+ * that gap: the graph pauses, a phone rings until somebody answers, and the
+ * answer resumes the graph.
+ *
+ * Nothing here imports `@langchain/langgraph`. These are plain callables you use
+ * *around* your graph, so they work the same with `interrupt()`, with
+ * `new Command({ resume })`, or with a node you wrote by hand.
+ */
+import type { M91Client } from '../client.js';
+import type { Severity } from '../models.js';
+import { APPROVED, REJECTED } from './specs.js';
+export interface NotifyOptions {
+    title: string;
+    customId: string;
+    description?: string;
+    severity?: Severity;
+    approveLabel?: string;
+    rejectLabel?: string;
+    timeoutMs?: number;
+    pollIntervalMs?: number;
+}
+export type NotifyDefaults = Omit<NotifyOptions, 'title' | 'customId'>;
+export type Verdict = typeof APPROVED | typeof REJECTED;
+/**
+ * Wake a human about an interrupted graph and return what they said.
+ *
+ * ```ts
+ * const notifier = new M91InterruptNotifier(client);
+ *
+ * const result = await graph.invoke(state, config);
+ * if (result.__interrupt__) {
+ *   const data = result.__interrupt__[0].value;
+ *   const decision = await notifier.notify({
+ *     title: data.question,
+ *     customId: data.customId,
+ *     timeoutMs: 600_000,
+ *   });
+ *   await graph.invoke(new Command({ resume: decision }), config);
+ * }
+ * ```
+ *
+ * Resolves `"approved"` or `"rejected"` and **never anything else** — a failure
+ * to reach anybody comes back as `"rejected"`, because a graph that resumes
+ * with an ambiguous value resumes with whatever the node's `if` happens to do
+ * with it.
+ */
+export declare class M91InterruptNotifier {
+    private readonly client;
+    private readonly defaults;
+    constructor(client: M91Client, defaults?: NotifyDefaults);
+    notify(options: NotifyOptions): Promise<Verdict>;
+}
+/**
+ * Build a graph node that asks a human and writes the answer into state.
+ *
+ * ```ts
+ * builder.addNode('humanApproval', createM91ApprovalNode(client, {
+ *   approveLabel: 'Deploy Now',
+ *   rejectLabel: 'Hold Release',
+ *   timeoutMs: 600_000,
+ * }));
+ * ```
+ *
+ * The node reads `title` (or `question`) and `customId` from state and returns
+ * `{ decision, approved }` for the next edge to branch on. Anything passed here
+ * is a default the state can override per run.
+ */
+export declare function createM91ApprovalNode(client: M91Client, defaults?: NotifyDefaults): (state: unknown) => Promise<{
+    decision: Verdict;
+    approved: boolean;
+    error?: string;
+}>;
+//# sourceMappingURL=langgraph.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"langgraph.d.ts","sourceRoot":"","sources":["../../../src/integrations/langgraph.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,aAAa;IAC5B,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,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,aAAa,EAAE,OAAO,GAAG,UAAU,CAAC,CAAC;AAEvE,MAAM,MAAM,OAAO,GAAG,OAAO,QAAQ,GAAG,OAAO,QAAQ,CAAC;AAExD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;gBAE9B,MAAM,EAAE,SAAS,EAAE,QAAQ,GAAE,cAAmB;IAKtD,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;CAkBvD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,EACjB,QAAQ,GAAE,cAAmB,GAC5B,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAgCvF"}