@stigmer/mcp-server 3.5.3 → 3.7.0

package/config.d.ts

@@ -9,8 +9,12 @@ export type Transport = "stdio" | "http" | "both";
  *   argument surface. This is what the runner-synthesized datastore
  *   attachment spawns over stdio (T05 R1); over HTTP the same roster is
  *   served on the /records route regardless of this setting.
+ * - "channels": only send_channel_message (proactive-messaging DD-006
+ *   D8) with the agent-facing argument surface. This is what the
+ *   runner-synthesized channel attachment spawns over stdio; over HTTP
+ *   the same roster is served on the /channels route.
  */
-export type Roster = "full" | "records";
+export type Roster = "full" | "records" | "channels";
 /**
  * OAuth 2.0 Protected Resource Metadata (RFC 9728) discovery settings.
  *

package/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAQA,OAAO,EAAO,KAAK,SAAS,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEjE,6DAA6D;AAC7D,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAElD;;;;;;;;GAQG;AACH,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAExC;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,oBAAoB,EAAE,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,eAAe,EAAE,MAAM,EAAE,CAAC;CACpC;AAED,gDAAgD;AAChD,MAAM,WAAW,MAAM;IACrB,mEAAmE;IACnE,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,kEAAkE;IAClE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,qEAAqE;IACrE,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;CAC7B;AAOD,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAkB9E;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAkDhD"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAQA,OAAO,EAAO,KAAK,SAAS,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEjE,6DAA6D;AAC7D,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAElD;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;AAErD;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,oBAAoB,EAAE,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,eAAe,EAAE,MAAM,EAAE,CAAC;CACpC;AAED,gDAAgD;AAChD,MAAM,WAAW,MAAM;IACrB,mEAAmE;IACnE,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,kEAAkE;IAClE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,qEAAqE;IACrE,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;CAC7B;AAOD,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAkB9E;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAoDhD"}

package/config.js

@@ -7,7 +7,7 @@
 // reproduces Go's hard-errors AND warnings, not just the defaults.
 import { log } from "./logger.js";
 const VALID_TRANSPORTS = ["stdio", "http", "both"];
-const VALID_ROSTERS = ["full", "records"];
+const VALID_ROSTERS = ["full", "records", "channels"];
 const VALID_LOG_FORMATS = ["text", "json"];
 const VALID_LOG_LEVELS = ["debug", "info", "warn", "error"];
 /** Reads configuration from the process environment, applying defaults. */
@@ -41,7 +41,7 @@ export function validateConfig(cfg) {
         throw new Error(`invalid STIGMER_MCP_TRANSPORT "${cfg.transport}": must be stdio, http, or both`);
     }
     if (!VALID_ROSTERS.includes(cfg.roster)) {
-        throw new Error(`invalid STIGMER_MCP_ROSTER "${cfg.roster}": must be full or records`);
+        throw new Error(`invalid STIGMER_MCP_ROSTER "${cfg.roster}": must be full, records, or channels`);
     }
     if (cfg.stigmerServerAddress === "") {
         throw new Error("STIGMER_SERVER_ADDRESS must not be empty");

package/config.js.map

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

package/domains/channels/calls.d.ts

@@ -0,0 +1,15 @@
+/** The template arm as the model supplies it (mirrors TemplatePayload). */
+export interface TemplateArg {
+    name: string;
+    language?: string;
+    parameters?: Record<string, string>;
+    header_image_link?: string;
+}
+export interface SendArgs {
+    recipient: string;
+    text?: string;
+    template?: TemplateArg;
+    channel?: string;
+}
+export declare function sendChannelMessage(serverAddress: string, token: string, args: SendArgs): Promise<string>;
+//# sourceMappingURL=calls.d.ts.map

package/domains/channels/calls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calls.d.ts","sourceRoot":"","sources":["../../../src/domains/channels/calls.ts"],"names":[],"mappings":"AA2BA,2EAA2E;AAC3E,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,kBAAkB,CACtC,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,QAAQ,GACb,OAAO,CAAC,MAAM,CAAC,CAYjB"}

package/domains/channels/calls.js

@@ -0,0 +1,54 @@
+// Channel-messaging RPC invocations for the send_channel_message tool —
+// a 1:1 projection of ChannelMessageCommandController.sendMessage
+// (proactive-messaging DD-006 D5: the tool layer adds no semantics;
+// reach, recipient policy, caps, and the template pre-check all live in
+// the cloud handler, and the OSS edition refuses with the documented
+// FAILED_PRECONDITION).
+//
+// The records-domain calls.ts shape: build request, call, marshal. The
+// typed outcome (accepted/queued/refused + detail) rides back VERBATIM
+// as proto JSON — a refusal is an ANSWER the model adapts to (DD-002
+// D4), never a tool error.
+import { create } from "@bufbuild/protobuf";
+import { ChannelMessageCommandController, } from "@stigmer/protos/ai/stigmer/agentic/agentchannel/v1/message_command_pb";
+import { ChannelOutboundPayloadSchema, SendChannelMessageInputSchema, SendChannelMessageOutputSchema, TemplatePayloadSchema, TextPayloadSchema, } from "@stigmer/protos/ai/stigmer/agentic/agentchannel/v1/message_io_pb";
+import { withClient } from "../client.js";
+import { toProtoJson } from "../marshal.js";
+export async function sendChannelMessage(serverAddress, token, args) {
+    const request = create(SendChannelMessageInputSchema, {
+        channel: args.channel ?? "",
+        // org is deliberately never sent: a session-bound caller's org is
+        // server-derived, and an explicit value is rejected (the records
+        // T05 R3 rule applied to messaging).
+        recipient: args.recipient,
+        payload: buildPayload(args),
+    });
+    return withClient(ChannelMessageCommandController, serverAddress, token, async (client, opts) => toProtoJson(SendChannelMessageOutputSchema, await client.sendMessage(request, opts)));
+}
+/**
+ * The payload oneof from the tool's mutually exclusive arguments. The
+ * tool handler enforces exactly-one before calling; the server's
+ * required-oneof validation is the backstop.
+ */
+function buildPayload(args) {
+    if (args.template !== undefined) {
+        return create(ChannelOutboundPayloadSchema, {
+            kind: {
+                case: "template",
+                value: create(TemplatePayloadSchema, {
+                    name: args.template.name,
+                    language: args.template.language ?? "",
+                    parameters: args.template.parameters ?? {},
+                    headerImageLink: args.template.header_image_link ?? "",
+                }),
+            },
+        });
+    }
+    return create(ChannelOutboundPayloadSchema, {
+        kind: {
+            case: "text",
+            value: create(TextPayloadSchema, { body: args.text ?? "" }),
+        },
+    });
+}
+//# sourceMappingURL=calls.js.map

package/domains/channels/calls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calls.js","sourceRoot":"","sources":["../../../src/domains/channels/calls.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,kEAAkE;AAClE,oEAAoE;AACpE,wEAAwE;AACxE,qEAAqE;AACrE,wBAAwB;AACxB,EAAE;AACF,uEAAuE;AACvE,uEAAuE;AACvE,qEAAqE;AACrE,2BAA2B;AAE3B,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EACL,+BAA+B,GAChC,MAAM,uEAAuE,CAAC;AAC/E,OAAO,EACL,4BAA4B,EAC5B,6BAA6B,EAC7B,8BAA8B,EAC9B,qBAAqB,EACrB,iBAAiB,GAElB,MAAM,kEAAkE,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAiB5C,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,aAAqB,EACrB,KAAa,EACb,IAAc;IAEd,MAAM,OAAO,GAAG,MAAM,CAAC,6BAA6B,EAAE;QACpD,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,EAAE;QAC3B,kEAAkE;QAClE,iEAAiE;QACjE,qCAAqC;QACrC,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC;KAC5B,CAAC,CAAC;IACH,OAAO,UAAU,CAAC,+BAA+B,EAAE,aAAa,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAC9F,WAAW,CAAC,8BAA8B,EAAE,MAAM,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CACrF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAS,YAAY,CAAC,IAAc;IAClC,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO,MAAM,CAAC,4BAA4B,EAAE;YAC1C,IAAI,EAAE;gBACJ,IAAI,EAAE,UAAU;gBAChB,KAAK,EAAE,MAAM,CAAC,qBAAqB,EAAE;oBACnC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI;oBACxB,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,IAAI,EAAE;oBACtC,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,UAAU,IAAI,EAAE;oBAC1C,eAAe,EAAE,IAAI,CAAC,QAAQ,CAAC,iBAAiB,IAAI,EAAE;iBACvD,CAAC;aACH;SACF,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC,4BAA4B,EAAE;QAC1C,IAAI,EAAE;YACJ,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,MAAM,CAAC,iBAAiB,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;SAC5D;KACF,CAAC,CAAC;AACL,CAAC"}

package/domains/channels/errors.d.ts

@@ -0,0 +1,21 @@
+import { ConnectError } from "@connectrpc/connect";
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+/** The structured error payload channel tools return for domain errors. */
+export interface ChannelToolError {
+    /** The server's relayable message, byte-for-byte. */
+    error: string;
+    /** gRPC status name in SCREAMING_SNAKE (e.g. PERMISSION_DENIED). */
+    code: string;
+    /** ErrorInfo reason (e.g. WHATSAPP_MANAGEMENT_SCOPE_MISSING), when present. */
+    reason?: string;
+}
+/**
+ * Run a channel-tool body: a string payload becomes a text result; a
+ * domain error becomes an isError JSON result carrying the verbatim
+ * message + ErrorInfo reason; a transport error delegates to the shared
+ * classifier. The only try/catch in this domain.
+ */
+export declare function channelResult(toolContext: string, produce: () => Promise<string>): Promise<CallToolResult>;
+/** Project a domain ConnectError into the structured tool payload. */
+export declare function domainError(ce: ConnectError): ChannelToolError;
+//# sourceMappingURL=errors.d.ts.map

package/domains/channels/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/domains/channels/errors.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAQ,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAmBzE,2EAA2E;AAC3E,MAAM,WAAW,gBAAgB;IAC/B,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,GAC7B,OAAO,CAAC,cAAc,CAAC,CAazB;AAED,sEAAsE;AACtE,wBAAgB,WAAW,CAAC,EAAE,EAAE,YAAY,GAAG,gBAAgB,CAa9D"}

package/domains/channels/errors.js

@@ -0,0 +1,77 @@
+// The channels-domain error mapper — the records-domain sibling
+// (DD-004 S-7's recorded posture: siblings share the idiom, never an
+// abstraction over it; each domain documents its own contract).
+//
+// Channel-messaging domain errors carry agent-relayable messages that
+// are contract bytes (proactive-messaging DD-002 D4's error table):
+// "this agent has no proactive-messaging channel it can use", "channel
+// is required: this agent serves multiple proactive-enabled channels:
+// …", the OSS "proactive channel messaging requires Stigmer Cloud".
+// The shared ../rpcerr.ts would rewrite them into transport advice and
+// discard google.rpc.ErrorInfo; here the domain codes pass the server's
+// message through VERBATIM as isError JSON `{error, code, reason}` so
+// the model can self-correct (name the channel on INVALID_ARGUMENT;
+// stop and relay on PERMISSION_DENIED). Transport codes still delegate
+// to the shared helper, whose advice is right for them.
+//
+// Typed send outcomes (accepted/queued/refused) never reach this file:
+// they are successful responses by design (DD-002 D4 — policy refusals
+// are answers, not errors).
+import { Code, ConnectError } from "@connectrpc/connect";
+import { ErrorInfoSchema } from "@stigmer/protos/google/rpc/error_details_pb";
+import { rpcError } from "../rpcerr.js";
+import { errorResult, textResult } from "../toolresult.js";
+/**
+ * The gRPC codes whose messages are the channel-messaging domain
+ * contract: reach denials (PERMISSION_DENIED, one fail-closed text per
+ * failure class), contract misuse with corrective copy
+ * (INVALID_ARGUMENT — ambiguous channel, ambiguous template language),
+ * and actionable preconditions (FAILED_PRECONDITION — the OSS refusal,
+ * not-installed, registry misconfiguration with its ErrorInfo reason).
+ */
+const DOMAIN_CODES = new Set([
+    Code.PermissionDenied,
+    Code.InvalidArgument,
+    Code.FailedPrecondition,
+]);
+/**
+ * Run a channel-tool body: a string payload becomes a text result; a
+ * domain error becomes an isError JSON result carrying the verbatim
+ * message + ErrorInfo reason; a transport error delegates to the shared
+ * classifier. The only try/catch in this domain.
+ */
+export async function channelResult(toolContext, produce) {
+    try {
+        return textResult(await produce());
+    }
+    catch (err) {
+        const ce = ConnectError.from(err);
+        if (DOMAIN_CODES.has(ce.code)) {
+            return {
+                content: [{ type: "text", text: JSON.stringify(domainError(ce)) }],
+                isError: true,
+            };
+        }
+        return errorResult(rpcError(ce, toolContext));
+    }
+}
+/** Project a domain ConnectError into the structured tool payload. */
+export function domainError(ce) {
+    const payload = {
+        error: ce.rawMessage,
+        code: grpcStatusName(ce.code),
+    };
+    // The messaging RPCs attach google.rpc.ErrorInfo to operator-actionable
+    // preconditions (DD-005 D8); absence means the message alone carries
+    // the contract.
+    const details = ce.findDetails(ErrorInfoSchema);
+    if (details.length > 0 && details[0].reason !== "") {
+        payload.reason = details[0].reason;
+    }
+    return payload;
+}
+/** Connect's PascalCase code name → the gRPC SCREAMING_SNAKE status name. */
+function grpcStatusName(code) {
+    return Code[code].replace(/([a-z0-9])([A-Z])/g, "$1_$2").toUpperCase();
+}
+//# sourceMappingURL=errors.js.map

package/domains/channels/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/domains/channels/errors.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,qEAAqE;AACrE,gEAAgE;AAChE,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,uEAAuE;AACvE,sEAAsE;AACtE,oEAAoE;AACpE,uEAAuE;AACvE,wEAAwE;AACxE,sEAAsE;AACtE,oEAAoE;AACpE,uEAAuE;AACvE,wDAAwD;AACxD,EAAE;AACF,uEAAuE;AACvE,uEAAuE;AACvE,4BAA4B;AAE5B,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,EAAE,eAAe,EAAE,MAAM,6CAA6C,CAAC;AAC9E,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE3D;;;;;;;GAOG;AACH,MAAM,YAAY,GAAsB,IAAI,GAAG,CAAC;IAC9C,IAAI,CAAC,gBAAgB;IACrB,IAAI,CAAC,eAAe;IACpB,IAAI,CAAC,kBAAkB;CACxB,CAAC,CAAC;AAYH;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,WAAmB,EACnB,OAA8B;IAE9B,IAAI,CAAC;QACH,OAAO,UAAU,CAAC,MAAM,OAAO,EAAE,CAAC,CAAC;IACrC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;gBAClE,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QACD,OAAO,WAAW,CAAC,QAAQ,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC,CAAC;IAChD,CAAC;AACH,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,WAAW,CAAC,EAAgB;IAC1C,MAAM,OAAO,GAAqB;QAChC,KAAK,EAAE,EAAE,CAAC,UAAU;QACpB,IAAI,EAAE,cAAc,CAAC,EAAE,CAAC,IAAI,CAAC;KAC9B,CAAC;IACF,wEAAwE;IACxE,qEAAqE;IACrE,gBAAgB;IAChB,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;IAChD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QACnD,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACrC,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,6EAA6E;AAC7E,SAAS,cAAc,CAAC,IAAU;IAChC,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;AACzE,CAAC"}

package/domains/channels/tools.d.ts

@@ -0,0 +1,5 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type BackendTarget } from "../client.js";
+/** Register the channel messaging tool; returns the tool names. */
+export declare function registerChannelTools(server: McpServer, target: BackendTarget): string[];
+//# sourceMappingURL=tools.d.ts.map

package/domains/channels/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/domains/channels/tools.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AA6BhE,mEAAmE;AACnE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,MAAM,EAAE,CA+DvF"}

package/domains/channels/tools.js

@@ -0,0 +1,90 @@
+// The send_channel_message tool — the ONE tool of the channels roster
+// (proactive-messaging DD-002 D7, arguments amended by DD-006 D5 to
+// mirror the ChannelOutboundPayload oneof: `text` | `template`, exactly
+// one).
+//
+// Agent audience only, by construction: this roster is what the
+// runner-synthesized channel attachment connects to, and a session-bound
+// caller's org derives from its token (an explicit org is rejected —
+// the records T05 R3 rule), so no `org` argument exists to invite
+// rejected calls. A direct-audience variant on the full roster is
+// deliberately NOT registered: operators send through the console, CLI,
+// and SDK, which carry the org+channel addressing the direct reach path
+// requires.
+//
+// The typed outcome is the tool's answer, verbatim proto JSON:
+// `accepted` (delivered to the provider), `queued` (transient failure —
+// the platform retries in the background; do NOT resend), `refused`
+// (terminal; `detail` says why — adapt, never retry the same send).
+import { z } from "zod";
+import { resolveToken } from "../client.js";
+import { sendChannelMessage } from "./calls.js";
+import { channelResult } from "./errors.js";
+import { errorResult } from "../toolresult.js";
+const templateShape = z.object({
+    name: z.string().describe("Approved template name on the channel's provider registry."),
+    language: z
+        .string()
+        .optional()
+        .describe("Template language code (e.g. en, en_US). Omit when the template exists in exactly one language."),
+    parameters: z
+        .record(z.string())
+        .optional()
+        .describe('Placeholder values. Positional templates key by position ("1", "2", …); ' +
+        'named templates key by parameter name ("member_name").'),
+    header_image_link: z
+        .string()
+        .optional()
+        .describe("Public HTTPS URL for the image header. Required exactly when the template " +
+        "declares an image header."),
+});
+/** Register the channel messaging tool; returns the tool names. */
+export function registerChannelTools(server, target) {
+    server.registerTool("send_channel_message", {
+        description: "Send a business-initiated message to a recipient on this agent's messaging channel " +
+            "(e.g. WhatsApp). Exactly one of text | template. Outside a 24-hour customer-service " +
+            "window the provider only accepts a pre-approved template, so prefer a template from " +
+            "<available_channel_templates>. The result carries a typed outcome: accepted (sent), " +
+            "queued (the platform retries in the background — do not resend), or refused " +
+            "(terminal; detail says why — adapt, never retry the same send).",
+        inputSchema: {
+            recipient: z
+                .string()
+                .describe("Recipient's key on the channel's provider, passed to the provider verbatim. " +
+                'WhatsApp: the wa_id — digits only INCLUDING the country code, no "+" or ' +
+                'separators (e.g. "919912850490"). Never reformat a wa_id another tool returned.'),
+            text: z
+                .string()
+                .optional()
+                .describe("Plain text body. Only deliverable inside an open 24-hour customer-service window."),
+            template: templateShape
+                .optional()
+                .describe("Pre-approved template send — required outside a 24-hour window."),
+            channel: z
+                .string()
+                .optional()
+                .describe("Channel slug. Only needed when this agent serves more than one " +
+                "proactive-messaging channel (a refusal will list them)."),
+        },
+    }, (args, extra) => {
+        // Exactly-one, checked here with corrective copy the model can act
+        // on immediately; the server's required-oneof validation is the
+        // backstop (DD-006 D5).
+        const hasText = args.text !== undefined && args.text !== "";
+        const hasTemplate = args.template !== undefined;
+        if (hasText === hasTemplate) {
+            return Promise.resolve(errorResult(hasText
+                ? "supply exactly one of text | template, not both"
+                : "supply exactly one of text | template — text for an open 24-hour window, " +
+                    "template otherwise"));
+        }
+        return channelResult(`message to "${args.recipient}"`, () => sendChannelMessage(target.serverAddress, resolveToken(extra, target.apiKey), {
+            recipient: args.recipient,
+            text: args.text,
+            template: args.template,
+            channel: args.channel,
+        }));
+    });
+    return ["send_channel_message"];
+}
+//# sourceMappingURL=tools.js.map

package/domains/channels/tools.js.map

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

package/domains/conversation/calls.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Flag the calling session's conversation for human attention. The input
+ * carries only the reason: the conversation identity derives server-side
+ * from the session-scoped credential's channel labels (the DD-003
+ * identity doctrine), so there is nothing else a caller could
+ * legitimately send.
+ */
+export declare function escalateConversation(serverAddress: string, token: string, reason: string): Promise<void>;
+//# sourceMappingURL=calls.d.ts.map

package/domains/conversation/calls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calls.d.ts","sourceRoot":"","sources":["../../../src/domains/conversation/calls.ts"],"names":[],"mappings":"AAwBA;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAKf"}

package/domains/conversation/calls.js

@@ -0,0 +1,30 @@
+// Conversation RPC invocations for the escalate_to_human tool — a 1:1
+// projection of ChannelConversationCommandController.escalate
+// (channel-conversations DD-008: the tool layer adds no semantics; the
+// reach, the idempotent writer, and the attention projection all live
+// in the cloud handler, and the OSS edition refuses with the documented
+// FAILED_PRECONDITION).
+//
+// The channels-domain calls.ts shape, with one deliberate divergence:
+// the RPC's ChannelConversation response is DISCARDED instead of
+// marshaled back as proto JSON. A15 rules the tool's answer is fixed
+// behavioral copy (tools.ts owns it) — the row's control state,
+// timestamps, and conversation key give the model nothing actionable,
+// and reflecting them would only invite the model to narrate internal
+// state to the customer.
+import { create } from "@bufbuild/protobuf";
+import { ChannelConversationCommandController, } from "@stigmer/protos/ai/stigmer/agentic/agentchannel/v1/conversation_command_pb";
+import { EscalateConversationInputSchema, } from "@stigmer/protos/ai/stigmer/agentic/agentchannel/v1/conversation_io_pb";
+import { withClient } from "../client.js";
+/**
+ * Flag the calling session's conversation for human attention. The input
+ * carries only the reason: the conversation identity derives server-side
+ * from the session-scoped credential's channel labels (the DD-003
+ * identity doctrine), so there is nothing else a caller could
+ * legitimately send.
+ */
+export async function escalateConversation(serverAddress, token, reason) {
+    const request = create(EscalateConversationInputSchema, { reason });
+    await withClient(ChannelConversationCommandController, serverAddress, token, (client, opts) => client.escalate(request, opts));
+}
+//# sourceMappingURL=calls.js.map

package/domains/conversation/calls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calls.js","sourceRoot":"","sources":["../../../src/domains/conversation/calls.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,8DAA8D;AAC9D,uEAAuE;AACvE,sEAAsE;AACtE,wEAAwE;AACxE,wBAAwB;AACxB,EAAE;AACF,sEAAsE;AACtE,iEAAiE;AACjE,qEAAqE;AACrE,gEAAgE;AAChE,sEAAsE;AACtE,sEAAsE;AACtE,yBAAyB;AAEzB,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EACL,oCAAoC,GACrC,MAAM,4EAA4E,CAAC;AACpF,OAAO,EACL,+BAA+B,GAChC,MAAM,uEAAuE,CAAC;AAC/E,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,aAAqB,EACrB,KAAa,EACb,MAAc;IAEd,MAAM,OAAO,GAAG,MAAM,CAAC,+BAA+B,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IACpE,MAAM,UAAU,CAAC,oCAAoC,EAAE,aAAa,EAAE,KAAK,EACzE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,CACjD,CAAC;AACJ,CAAC"}

package/domains/conversation/errors.d.ts

@@ -0,0 +1,19 @@
+import { ConnectError } from "@connectrpc/connect";
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+/** The structured error payload conversation tools return for domain errors. */
+export interface ConversationToolError {
+    /** The server's relayable message, byte-for-byte. */
+    error: string;
+    /** gRPC status name in SCREAMING_SNAKE (e.g. PERMISSION_DENIED). */
+    code: string;
+}
+/**
+ * Run a conversation-tool body: a string payload becomes a text result;
+ * a domain error becomes an isError JSON result carrying the verbatim
+ * message; a transport error delegates to the shared classifier. The
+ * only try/catch in this domain.
+ */
+export declare function conversationResult(toolContext: string, produce: () => Promise<string>): Promise<CallToolResult>;
+/** Project a domain ConnectError into the structured tool payload. */
+export declare function domainError(ce: ConnectError): ConversationToolError;
+//# sourceMappingURL=errors.d.ts.map

package/domains/conversation/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/domains/conversation/errors.ts"],"names":[],"mappings":"AAwBA,OAAO,EAAQ,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAmBzE,gFAAgF;AAChF,MAAM,WAAW,qBAAqB;IACpC,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,GAC7B,OAAO,CAAC,cAAc,CAAC,CAazB;AAED,sEAAsE;AACtE,wBAAgB,WAAW,CAAC,EAAE,EAAE,YAAY,GAAG,qBAAqB,CAKnE"}

package/domains/conversation/errors.js

@@ -0,0 +1,73 @@
+// The conversation-domain error mapper — the channels-domain sibling
+// (DD-004 S-7's recorded posture: siblings share the idiom, never an
+// abstraction over it; each domain documents its own contract).
+//
+// Conversation domain errors carry agent-relayable messages that are
+// contract bytes (the ChannelConversationReach refusal matrix):
+// "escalate is agent-audience only: it requires a session-scoped runner
+// credential", "conversation identity could not be verified for this
+// session", "this session is not serving a channel conversation, so
+// there is nothing to escalate", the OSS "conversation participation
+// requires Stigmer Cloud". The shared ../rpcerr.ts would rewrite them
+// into transport advice; here the domain codes pass the server's
+// message through VERBATIM as isError JSON `{error, code}` so the model
+// can stop and adapt.
+//
+// Two deliberate differences from the channels set, each this domain's
+// own contract:
+//   - NOT_FOUND is a domain code HERE: the handler's "no conversation
+//     with this key exists on channel …" is contract copy, and the
+//     shared classifier's rewrite ("Verify the org and slug are
+//     correct") names arguments escalate does not take.
+//   - No google.rpc.ErrorInfo extraction: the conversation commands
+//     attach none — the message alone carries the contract.
+import { Code, ConnectError } from "@connectrpc/connect";
+import { rpcError } from "../rpcerr.js";
+import { errorResult, textResult } from "../toolresult.js";
+/**
+ * The gRPC codes whose messages are the conversation domain contract:
+ * reach denials (PERMISSION_DENIED, one fail-closed text per failure
+ * class), contract misuse with corrective copy (INVALID_ARGUMENT — an
+ * empty or over-budget reason), actionable preconditions
+ * (FAILED_PRECONDITION — the OSS refusal, a session serving no channel
+ * conversation), and the absent-conversation answer (NOT_FOUND).
+ */
+const DOMAIN_CODES = new Set([
+    Code.PermissionDenied,
+    Code.InvalidArgument,
+    Code.FailedPrecondition,
+    Code.NotFound,
+]);
+/**
+ * Run a conversation-tool body: a string payload becomes a text result;
+ * a domain error becomes an isError JSON result carrying the verbatim
+ * message; a transport error delegates to the shared classifier. The
+ * only try/catch in this domain.
+ */
+export async function conversationResult(toolContext, produce) {
+    try {
+        return textResult(await produce());
+    }
+    catch (err) {
+        const ce = ConnectError.from(err);
+        if (DOMAIN_CODES.has(ce.code)) {
+            return {
+                content: [{ type: "text", text: JSON.stringify(domainError(ce)) }],
+                isError: true,
+            };
+        }
+        return errorResult(rpcError(ce, toolContext));
+    }
+}
+/** Project a domain ConnectError into the structured tool payload. */
+export function domainError(ce) {
+    return {
+        error: ce.rawMessage,
+        code: grpcStatusName(ce.code),
+    };
+}
+/** Connect's PascalCase code name → the gRPC SCREAMING_SNAKE status name. */
+function grpcStatusName(code) {
+    return Code[code].replace(/([a-z0-9])([A-Z])/g, "$1_$2").toUpperCase();
+}
+//# sourceMappingURL=errors.js.map

package/domains/conversation/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/domains/conversation/errors.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,qEAAqE;AACrE,gEAAgE;AAChE,EAAE;AACF,qEAAqE;AACrE,gEAAgE;AAChE,wEAAwE;AACxE,qEAAqE;AACrE,oEAAoE;AACpE,qEAAqE;AACrE,sEAAsE;AACtE,iEAAiE;AACjE,wEAAwE;AACxE,sBAAsB;AACtB,EAAE;AACF,uEAAuE;AACvE,gBAAgB;AAChB,sEAAsE;AACtE,mEAAmE;AACnE,gEAAgE;AAChE,wDAAwD;AACxD,oEAAoE;AACpE,4DAA4D;AAE5D,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE3D;;;;;;;GAOG;AACH,MAAM,YAAY,GAAsB,IAAI,GAAG,CAAC;IAC9C,IAAI,CAAC,gBAAgB;IACrB,IAAI,CAAC,eAAe;IACpB,IAAI,CAAC,kBAAkB;IACvB,IAAI,CAAC,QAAQ;CACd,CAAC,CAAC;AAUH;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,WAAmB,EACnB,OAA8B;IAE9B,IAAI,CAAC;QACH,OAAO,UAAU,CAAC,MAAM,OAAO,EAAE,CAAC,CAAC;IACrC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;gBAClE,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QACD,OAAO,WAAW,CAAC,QAAQ,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC,CAAC;IAChD,CAAC;AACH,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,WAAW,CAAC,EAAgB;IAC1C,OAAO;QACL,KAAK,EAAE,EAAE,CAAC,UAAU;QACpB,IAAI,EAAE,cAAc,CAAC,EAAE,CAAC,IAAI,CAAC;KAC9B,CAAC;AACJ,CAAC;AAED,6EAA6E;AAC7E,SAAS,cAAc,CAAC,IAAU;IAChC,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;AACzE,CAAC"}

package/domains/conversation/tools.d.ts

@@ -0,0 +1,13 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type BackendTarget } from "../client.js";
+/**
+ * The success answer (A15): states only recorded fact and repeats the
+ * no-promise instruction at the moment of temptation — the model's next
+ * message to the customer. Deliberately does NOT claim the flag "shows
+ * in the team's console": no console surface renders needs_attention
+ * yet (the Conversations surface is T04+); add the claim when it ships.
+ */
+export declare const ESCALATION_RECORDED_COPY: string;
+/** Register the conversation participation tool; returns the tool names. */
+export declare function registerConversationTools(server: McpServer, target: BackendTarget): string[];
+//# sourceMappingURL=tools.d.ts.map

package/domains/conversation/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/domains/conversation/tools.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAiBhE;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,QAGY,CAAC;AAElD,4EAA4E;AAC5E,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,MAAM,EAAE,CAiC5F"}

package/domains/conversation/tools.js

@@ -0,0 +1,69 @@
+// The escalate_to_human tool — the ONE tool of the conversation roster
+// (channel-conversations DD-008 D-b). A14 named the roster
+// stigmer-conversation, axis-named like stigmer-channels: the
+// conditioning axis is "this session IS a live channel conversation",
+// and the notes/loop-in tools DD-008 anticipates join this roster
+// instead of earning new routes.
+//
+// Agent audience only, by construction: escalate derives the
+// conversation identity server-side from the session-scoped credential
+// (the DD-003 identity doctrine), so a direct principal is always
+// refused PERMISSION_DENIED — which is why no variant exists on the
+// full roster and why the input surface is a single `reason`.
+//
+// The tool's answer is FIXED COPY, never the RPC's ChannelConversation
+// row — a deliberate divergence from the channels roster's
+// verbatim-proto-JSON convention. A15 rules the result states only what
+// the platform can keep at 3am (attention is a stored flag; no one is
+// paged; no console surface renders it yet) and instructs the agent
+// never to promise a human or a response time.
+import { z } from "zod";
+import { resolveToken } from "../client.js";
+import { escalateConversation } from "./calls.js";
+import { conversationResult } from "./errors.js";
+const ESCALATE_DESCRIPTION = [
+    "Flag this conversation for a human teammate to look at. Use this when you " +
+        "cannot resolve the customer's request yourself: you lack the information, " +
+        "the request needs a decision you are not authorized to make, or the " +
+        "customer has asked for a person.",
+    "You keep serving the conversation after calling this. Nothing is handed " +
+        "off automatically and no one is paged. Do not tell the customer a human " +
+        "will reply, and never promise a response time.",
+    "Write the reason for a teammate who has not read the conversation. " +
+        "Calling this again with a new reason is safe; the latest reason is what " +
+        "they see.",
+].join("\n\n");
+/**
+ * The success answer (A15): states only recorded fact and repeats the
+ * no-promise instruction at the moment of temptation — the model's next
+ * message to the customer. Deliberately does NOT claim the flag "shows
+ * in the team's console": no console surface renders needs_attention
+ * yet (the Conversations surface is T04+); add the claim when it ships.
+ */
+export const ESCALATION_RECORDED_COPY = "Flagged for human attention. Your reason was recorded on this " +
+    "conversation. Keep helping the customer as best you can, and do not " +
+    "tell the customer a human will reply or when.";
+/** Register the conversation participation tool; returns the tool names. */
+export function registerConversationTools(server, target) {
+    server.registerTool("escalate_to_human", {
+        description: ESCALATE_DESCRIPTION,
+        inputSchema: {
+            // Bounds mirror the protovalidate constraints on
+            // EscalateConversationInput.reason (conversation_io.proto:
+            // min_len 1, max_len 1024) so the model gets corrective feedback
+            // without an RPC; the server's validation is the backstop.
+            reason: z
+                .string()
+                .min(1)
+                .max(1024)
+                .describe("Why you are escalating, written for a teammate who has not read " +
+                "the conversation. Staff see it as the conversation's attention " +
+                "reason. 1-1024 characters."),
+        },
+    }, (args, extra) => conversationResult("escalation", async () => {
+        await escalateConversation(target.serverAddress, resolveToken(extra, target.apiKey), args.reason);
+        return ESCALATION_RECORDED_COPY;
+    }));
+    return ["escalate_to_human"];
+}
+//# sourceMappingURL=tools.js.map

package/domains/conversation/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/domains/conversation/tools.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,2DAA2D;AAC3D,8DAA8D;AAC9D,sEAAsE;AACtE,kEAAkE;AAClE,iCAAiC;AACjC,EAAE;AACF,6DAA6D;AAC7D,uEAAuE;AACvE,kEAAkE;AAClE,oEAAoE;AACpE,8DAA8D;AAC9D,EAAE;AACF,uEAAuE;AACvE,2DAA2D;AAC3D,wEAAwE;AACxE,sEAAsE;AACtE,oEAAoE;AACpE,+CAA+C;AAG/C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAsB,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,oBAAoB,GAAG;IAC3B,4EAA4E;QAC1E,4EAA4E;QAC5E,sEAAsE;QACtE,kCAAkC;IACpC,0EAA0E;QACxE,0EAA0E;QAC1E,gDAAgD;IAClD,qEAAqE;QACnE,0EAA0E;QAC1E,WAAW;CACd,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAEf;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,wBAAwB,GACnC,gEAAgE;IAChE,sEAAsE;IACtE,+CAA+C,CAAC;AAElD,4EAA4E;AAC5E,MAAM,UAAU,yBAAyB,CAAC,MAAiB,EAAE,MAAqB;IAChF,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,WAAW,EAAE,oBAAoB;QACjC,WAAW,EAAE;YACX,iDAAiD;YACjD,2DAA2D;YAC3D,iEAAiE;YACjE,2DAA2D;YAC3D,MAAM,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,GAAG,CAAC,IAAI,CAAC;iBACT,QAAQ,CACP,kEAAkE;gBAChE,iEAAiE;gBACjE,4BAA4B,CAC/B;SACJ;KACF,EACD,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACd,kBAAkB,CAAC,YAAY,EAAE,KAAK,IAAI,EAAE;QAC1C,MAAM,oBAAoB,CACxB,MAAM,CAAC,aAAa,EACpB,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAClC,IAAI,CAAC,MAAM,CACZ,CAAC;QACF,OAAO,wBAAwB,CAAC;IAClC,CAAC,CAAC,CACL,CAAC;IAEF,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAC/B,CAAC"}