@mastra/livekit 0.3.0 → 0.3.1-alpha.0

package/dist/index.js

@@ -1,135 +1,182 @@
-import { DEFAULT_LIVEKIT_AGENT_NAME, serializeSessionMetadata } from './chunk-2E3MTAOA.js';
-export { DEFAULT_LIVEKIT_AGENT_NAME, pipeAgentReplyToWriter, serializeSessionMetadata } from './chunk-2E3MTAOA.js';
-import { randomUUID } from 'crypto';
-import { RoomConfiguration, RoomAgentDispatch } from '@livekit/protocol';
-import { AgentDispatchClient, AccessToken } from 'livekit-server-sdk';
-import { createTool } from '@mastra/core/tools';
-import { z } from 'zod';
-
+import { a as DEFAULT_LIVEKIT_AGENT_NAME, i as serializeSessionMetadata, n as pipeAgentReplyToWriter } from "./workflow-generator-BtfClQcM.js";
+import { randomUUID } from "crypto";
+import { RoomAgentDispatch, RoomConfiguration } from "@livekit/protocol";
+import { AccessToken, AgentDispatchClient } from "livekit-server-sdk";
+import { createTool } from "@mastra/core/tools";
+import { z } from "zod";
+//#region src/routes.ts
 function stringField(body, key) {
-  const value = body[key];
-  return typeof value === "string" && value.length > 0 ? value : void 0;
+	const value = body[key];
+	return typeof value === "string" && value.length > 0 ? value : void 0;
 }
+/**
+* An ApiRoute for `server.apiRoutes` that mints a LiveKit access token with the Mastra
+* voice agent dispatched into the room. Frontends call it to join a voice session:
+*
+* ```ts
+* export const mastra = new Mastra({
+*   agents: { support },
+*   server: { apiRoutes: [liveKitConnectionRoute({ agentName: 'mastra-voice' })] },
+* });
+* ```
+*/
 function liveKitConnectionRoute(options = {}) {
-  const handler = async (c) => {
-    const serverUrl = options.serverUrl ?? process.env.LIVEKIT_URL;
-    const apiKey = options.apiKey ?? process.env.LIVEKIT_API_KEY;
-    const apiSecret = options.apiSecret ?? process.env.LIVEKIT_API_SECRET;
-    if (!serverUrl || !apiKey || !apiSecret) {
-      return c.json(
-        {
-          error: "LiveKit is not configured. Set LIVEKIT_URL, LIVEKIT_API_KEY, and LIVEKIT_API_SECRET (or pass serverUrl/apiKey/apiSecret to liveKitConnectionRoute)."
-        },
-        500
-      );
-    }
-    const body = await c.req.json().then(
-      (parsed) => parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : {}
-    ).catch(() => ({}));
-    const args = { body, context: c };
-    const metadata = options.metadata ? await options.metadata(args) : {
-      agentId: stringField(body, "agentId"),
-      threadId: stringField(body, "threadId"),
-      resourceId: stringField(body, "resourceId")
-    };
-    const roomName = typeof options.roomName === "function" ? options.roomName(args) : options.roomName ?? `mastra-voice-${randomUUID().slice(0, 8)}`;
-    const identity = typeof options.participantIdentity === "function" ? options.participantIdentity(args) : options.participantIdentity ?? metadata.resourceId ?? `user-${randomUUID().slice(0, 8)}`;
-    metadata.threadId ??= roomName;
-    const token = new AccessToken(apiKey, apiSecret, { identity, ttl: options.ttl ?? "15m" });
-    token.addGrant({
-      room: roomName,
-      roomJoin: true,
-      canPublish: true,
-      canSubscribe: true,
-      canPublishData: true,
-      canUpdateOwnMetadata: true
-    });
-    token.roomConfig = new RoomConfiguration({
-      agents: [
-        new RoomAgentDispatch({
-          agentName: options.agentName ?? DEFAULT_LIVEKIT_AGENT_NAME,
-          metadata: serializeSessionMetadata(metadata)
-        })
-      ]
-    });
-    const details = {
-      serverUrl,
-      roomName,
-      participantName: identity,
-      participantToken: await token.toJwt()
-    };
-    return c.json(details);
-  };
-  return {
-    path: options.path ?? "/voice/livekit/connection-details",
-    method: "POST",
-    requiresAuth: options.requiresAuth,
-    handler
-  };
+	const handler = async (c) => {
+		const serverUrl = options.serverUrl ?? process.env.LIVEKIT_URL;
+		const apiKey = options.apiKey ?? process.env.LIVEKIT_API_KEY;
+		const apiSecret = options.apiSecret ?? process.env.LIVEKIT_API_SECRET;
+		if (!serverUrl || !apiKey || !apiSecret) return c.json({ error: "LiveKit is not configured. Set LIVEKIT_URL, LIVEKIT_API_KEY, and LIVEKIT_API_SECRET (or pass serverUrl/apiKey/apiSecret to liveKitConnectionRoute)." }, 500);
+		const body = await c.req.json().then((parsed) => parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : {}).catch(() => ({}));
+		const args = {
+			body,
+			context: c
+		};
+		const metadata = options.metadata ? await options.metadata(args) : {
+			agentId: stringField(body, "agentId"),
+			threadId: stringField(body, "threadId"),
+			resourceId: stringField(body, "resourceId")
+		};
+		const roomName = typeof options.roomName === "function" ? options.roomName(args) : options.roomName ?? `mastra-voice-${randomUUID().slice(0, 8)}`;
+		const identity = typeof options.participantIdentity === "function" ? options.participantIdentity(args) : options.participantIdentity ?? metadata.resourceId ?? `user-${randomUUID().slice(0, 8)}`;
+		metadata.threadId ??= roomName;
+		const token = new AccessToken(apiKey, apiSecret, {
+			identity,
+			ttl: options.ttl ?? "15m"
+		});
+		token.addGrant({
+			room: roomName,
+			roomJoin: true,
+			canPublish: true,
+			canSubscribe: true,
+			canPublishData: true,
+			canUpdateOwnMetadata: true
+		});
+		token.roomConfig = new RoomConfiguration({ agents: [new RoomAgentDispatch({
+			agentName: options.agentName ?? "mastra-voice",
+			metadata: serializeSessionMetadata(metadata)
+		})] });
+		const details = {
+			serverUrl,
+			roomName,
+			participantName: identity,
+			participantToken: await token.toJwt()
+		};
+		return c.json(details);
+	};
+	return {
+		path: options.path ?? "/voice/livekit/connection-details",
+		method: "POST",
+		requiresAuth: options.requiresAuth,
+		handler
+	};
 }
+//#endregion
+//#region src/dispatch.ts
 function toHttpUrl(url) {
-  return url.replace(/^ws/, "http");
+	return url.replace(/^ws/, "http");
 }
+/**
+* Programmatically dispatches a Mastra voice agent into a LiveKit room — for
+* server-initiated sessions such as outbound calls or joining an existing room.
+*/
 async function dispatchVoiceSession(options) {
-  const serverUrl = options.serverUrl ?? process.env.LIVEKIT_URL;
-  const apiKey = options.apiKey ?? process.env.LIVEKIT_API_KEY;
-  const apiSecret = options.apiSecret ?? process.env.LIVEKIT_API_SECRET;
-  if (!serverUrl) {
-    throw new Error("@mastra/livekit: set LIVEKIT_URL or pass serverUrl to dispatchVoiceSession.");
-  }
-  if (!apiKey || !apiSecret) {
-    throw new Error(
-      "@mastra/livekit: set LIVEKIT_API_KEY and LIVEKIT_API_SECRET or pass apiKey/apiSecret to dispatchVoiceSession."
-    );
-  }
-  const client = new AgentDispatchClient(toHttpUrl(serverUrl), apiKey, apiSecret);
-  return client.createDispatch(options.roomName, options.agentName ?? DEFAULT_LIVEKIT_AGENT_NAME, {
-    metadata: serializeSessionMetadata(options.metadata ?? {})
-  });
+	const serverUrl = options.serverUrl ?? process.env.LIVEKIT_URL;
+	const apiKey = options.apiKey ?? process.env.LIVEKIT_API_KEY;
+	const apiSecret = options.apiSecret ?? process.env.LIVEKIT_API_SECRET;
+	if (!serverUrl) throw new Error("@mastra/livekit: set LIVEKIT_URL or pass serverUrl to dispatchVoiceSession.");
+	if (!apiKey || !apiSecret) throw new Error("@mastra/livekit: set LIVEKIT_API_KEY and LIVEKIT_API_SECRET or pass apiKey/apiSecret to dispatchVoiceSession.");
+	return new AgentDispatchClient(toHttpUrl(serverUrl), apiKey, apiSecret).createDispatch(options.roomName, options.agentName ?? "mastra-voice", { metadata: serializeSessionMetadata(options.metadata ?? {}) });
 }
-var DEFAULT_DESCRIPTION = "Record the caller's consent decision for a data-processing item (for example, storing a summary of the call). Call this as soon as the caller answers a consent question: granted = true if they agree, false if they decline. Do not proceed with an activity that requires consent until you have recorded the caller granting it.";
+//#endregion
+//#region src/consent.ts
+const DEFAULT_DESCRIPTION$1 = "Record the caller's consent decision for a data-processing item (for example, storing a summary of the call). Call this as soon as the caller answers a consent question: granted = true if they agree, false if they decline. Do not proceed with an activity that requires consent until you have recorded the caller granting it.";
+/**
+* Builds a Mastra tool that captures the caller's consent decisions at runtime — the companion to
+* the worker's `configuration.consentPolicy`, which only DECLARES which consents a call needs. Add
+* it to the agent that answers the call; on each call the tool reads the caller's `resourceId` /
+* `threadId` from its execution context and hands the decision to your `onGrant` store. The runtime
+* grants live only where `onGrant` put them: enforce consent by reading them back from your own
+* store — at `onCallEnd` or before any consent-gated action — cross-checking against the declared
+* requirements in `VoiceCallEndArgs.configuration.consentPolicy` (the configuration carries the
+* policy, never the grants).
+*
+* ```ts
+* // agent tools
+* recordConsent: createConsentTool({
+*   items: ['summaryStorage'],
+*   onGrant: async ({ item, granted, resourceId }) => {
+*     if (resourceId) await db.saveConsent(resourceId, item, granted);
+*   },
+* }),
+* ```
+*/
 function createConsentTool(options) {
-  const items = options.items;
-  const itemSchema = items && items.length > 0 ? z.enum([...items]) : z.string();
-  return createTool({
-    id: options.id ?? "recordConsent",
-    description: options.description ?? DEFAULT_DESCRIPTION,
-    inputSchema: z.object({
-      item: itemSchema.describe(
-        "The consent item the caller is answering for (matches the deployment's required consents)."
-      ),
-      granted: z.boolean().describe("True if the caller agreed, false if they declined.")
-    }),
-    execute: async ({ item, granted }, { agent }) => {
-      await options.onGrant({ item, granted, resourceId: agent?.resourceId, threadId: agent?.threadId });
-      return { recorded: true, item, granted };
-    }
-  });
+	const items = options.items;
+	const itemSchema = items && items.length > 0 ? z.enum([...items]) : z.string();
+	return createTool({
+		id: options.id ?? "recordConsent",
+		description: options.description ?? DEFAULT_DESCRIPTION$1,
+		inputSchema: z.object({
+			item: itemSchema.describe("The consent item the caller is answering for (matches the deployment's required consents)."),
+			granted: z.boolean().describe("True if the caller agreed, false if they declined.")
+		}),
+		execute: async ({ item, granted }, { agent }) => {
+			await options.onGrant({
+				item,
+				granted,
+				resourceId: agent?.resourceId,
+				threadId: agent?.threadId
+			});
+			return {
+				recorded: true,
+				item,
+				granted
+			};
+		}
+	});
 }
-var DEFAULT_DESCRIPTION2 = "End the phone call. Call this only after you have said goodbye and there is nothing left to do \u2014 for example the caller says goodbye, or the task is complete and you have wrapped up. Say your closing line first, then call this as your final action; the call hangs up once your words finish playing. Your closing line must be a final statement, never a question \u2014 if you are asking the caller anything (for example whether they need anything else), do NOT call this in that reply; wait for their answer. Do not call it if the caller still needs something.";
+//#endregion
+//#region src/end-call.ts
+const DEFAULT_DESCRIPTION = "End the phone call. Call this only after you have said goodbye and there is nothing left to do — for example the caller says goodbye, or the task is complete and you have wrapped up. Say your closing line first, then call this as your final action; the call hangs up once your words finish playing. Your closing line must be a final statement, never a question — if you are asking the caller anything (for example whether they need anything else), do NOT call this in that reply; wait for their answer. Do not call it if the caller still needs something.";
+/**
+* Builds a Mastra tool the agent calls to end the call itself (say goodbye → hang up). It is the
+* agent-visible half of agent-initiated hang-up: the tool only SIGNALS intent (and runs optional
+* bookkeeping) — it can't reach the LiveKit room from inside `agent.stream()`. The worker owns the
+* hang-up: with `configuration.endCall` set, it watches each turn for this tool, waits for the
+* agent's closing words to finish playing, then disconnects (running `onCallEnd` on the way out).
+* Keeping the tool inside the single agent means it stays visible/editable in Studio and works on
+* the agent and workflow reply paths alike.
+*
+* ```ts
+* // agent tools
+* endCall: createEndCallTool({
+*   onEndCall: ({ reason, resourceId }) => log.info('agent ended call', { reason, resourceId }),
+* }),
+* // worker
+* createLiveKitWorker({ mastra, agent: 'support', configuration: { endCall: {} } });
+* ```
+*/
 function createEndCallTool(options = {}) {
-  return createTool({
-    id: options.id ?? "endCall",
-    description: options.description ?? DEFAULT_DESCRIPTION2,
-    inputSchema: z.object({
-      reason: z.string().nullish().describe('Short reason the call is ending, e.g. "caller said goodbye" or "task complete".')
-    }),
-    outputSchema: z.object({ ended: z.boolean() }),
-    execute: async ({ reason }, { agent }) => {
-      try {
-        await options.onEndCall?.({
-          reason: reason ?? void 0,
-          resourceId: agent?.resourceId,
-          threadId: agent?.threadId
-        });
-      } catch (error) {
-        console.warn("@mastra/livekit: onEndCall hook threw", error);
-      }
-      return { ended: true };
-    }
-  });
+	return createTool({
+		id: options.id ?? "endCall",
+		description: options.description ?? DEFAULT_DESCRIPTION,
+		inputSchema: z.object({ reason: z.string().nullish().describe("Short reason the call is ending, e.g. \"caller said goodbye\" or \"task complete\".") }),
+		outputSchema: z.object({ ended: z.boolean() }),
+		execute: async ({ reason }, { agent }) => {
+			try {
+				await options.onEndCall?.({
+					reason: reason ?? void 0,
+					resourceId: agent?.resourceId,
+					threadId: agent?.threadId
+				});
+			} catch (error) {
+				console.warn("@mastra/livekit: onEndCall hook threw", error);
+			}
+			return { ended: true };
+		}
+	});
 }
+//#endregion
+export { DEFAULT_LIVEKIT_AGENT_NAME, createConsentTool, createEndCallTool, dispatchVoiceSession, liveKitConnectionRoute, pipeAgentReplyToWriter, serializeSessionMetadata };
 
-export { createConsentTool, createEndCallTool, dispatchVoiceSession, liveKitConnectionRoute };
-//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/routes.ts","../src/dispatch.ts","../src/consent.ts","../src/end-call.ts"],"names":["DEFAULT_DESCRIPTION","createTool","z"],"mappings":"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","file":"index.js","sourcesContent":["import { randomUUID } from 'node:crypto';\nimport { RoomAgentDispatch, RoomConfiguration } from '@livekit/protocol';\nimport type { ContextWithMastra, ApiRoute } from '@mastra/core/server';\nimport { AccessToken } from 'livekit-server-sdk';\nimport { DEFAULT_LIVEKIT_AGENT_NAME } from './constants';\nimport { serializeSessionMetadata } from './metadata';\nimport type { LiveKitSessionMetadata } from './metadata';\n\n/** Response body of the connection-details route. Matches LiveKit's frontend starter contract. */\nexport interface LiveKitConnectionDetails {\n  serverUrl: string;\n  roomName: string;\n  participantName: string;\n  participantToken: string;\n}\n\nexport interface ConnectionRequestArgs {\n  body: Record<string, unknown>;\n  context: ContextWithMastra;\n}\n\nexport interface LiveKitConnectionRouteOptions {\n  /**\n   * Route path. Defaults to `/voice/livekit/connection-details`. Mastra reserves the\n   * `/api` prefix for built-in routes, so custom paths must not start with `/api`.\n   */\n  path?: string;\n  /** LiveKit server URL (`wss://...`). Defaults to `LIVEKIT_URL`. */\n  serverUrl?: string;\n  /** Defaults to `LIVEKIT_API_KEY`. */\n  apiKey?: string;\n  /** Defaults to `LIVEKIT_API_SECRET`. */\n  apiSecret?: string;\n  /** LiveKit agent name for explicit dispatch. Must match the worker's `agentName`. */\n  agentName?: string;\n  /** Token time-to-live. Defaults to `'15m'`. */\n  ttl?: string | number;\n  /** Defaults to `true` (Mastra custom routes require auth unless opted out). */\n  requiresAuth?: boolean;\n  roomName?: string | ((args: ConnectionRequestArgs) => string);\n  participantIdentity?: string | ((args: ConnectionRequestArgs) => string);\n  /**\n   * Session metadata delivered to the worker via agent dispatch. Defaults to passing\n   * through `agentId`, `threadId`, and `resourceId` from the request body.\n   */\n  metadata?: (args: ConnectionRequestArgs) => LiveKitSessionMetadata | Promise<LiveKitSessionMetadata>;\n}\n\nfunction stringField(body: Record<string, unknown>, key: string): string | undefined {\n  const value = body[key];\n  return typeof value === 'string' && value.length > 0 ? value : undefined;\n}\n\n/**\n * An ApiRoute for `server.apiRoutes` that mints a LiveKit access token with the Mastra\n * voice agent dispatched into the room. Frontends call it to join a voice session:\n *\n * ```ts\n * export const mastra = new Mastra({\n *   agents: { support },\n *   server: { apiRoutes: [liveKitConnectionRoute({ agentName: 'mastra-voice' })] },\n * });\n * ```\n */\nexport function liveKitConnectionRoute(options: LiveKitConnectionRouteOptions = {}): ApiRoute {\n  const handler = async (c: ContextWithMastra) => {\n    const serverUrl = options.serverUrl ?? process.env.LIVEKIT_URL;\n    const apiKey = options.apiKey ?? process.env.LIVEKIT_API_KEY;\n    const apiSecret = options.apiSecret ?? process.env.LIVEKIT_API_SECRET;\n    if (!serverUrl || !apiKey || !apiSecret) {\n      return c.json(\n        {\n          error:\n            'LiveKit is not configured. Set LIVEKIT_URL, LIVEKIT_API_KEY, and LIVEKIT_API_SECRET ' +\n            '(or pass serverUrl/apiKey/apiSecret to liveKitConnectionRoute).',\n        },\n        500,\n      );\n    }\n\n    const body: Record<string, unknown> = await c.req\n      .json()\n      .then((parsed: unknown) =>\n        parsed && typeof parsed === 'object' && !Array.isArray(parsed) ? (parsed as Record<string, unknown>) : {},\n      )\n      .catch(() => ({}));\n    const args: ConnectionRequestArgs = { body, context: c };\n\n    const metadata: LiveKitSessionMetadata = options.metadata\n      ? await options.metadata(args)\n      : {\n          agentId: stringField(body, 'agentId'),\n          threadId: stringField(body, 'threadId'),\n          resourceId: stringField(body, 'resourceId'),\n        };\n\n    const roomName =\n      typeof options.roomName === 'function'\n        ? options.roomName(args)\n        : (options.roomName ?? `mastra-voice-${randomUUID().slice(0, 8)}`);\n    const identity =\n      typeof options.participantIdentity === 'function'\n        ? options.participantIdentity(args)\n        : (options.participantIdentity ?? metadata.resourceId ?? `user-${randomUUID().slice(0, 8)}`);\n    // One memory thread per room unless the caller pins a thread explicitly.\n    metadata.threadId ??= roomName;\n\n    const token = new AccessToken(apiKey, apiSecret, { identity, ttl: options.ttl ?? '15m' });\n    token.addGrant({\n      room: roomName,\n      roomJoin: true,\n      canPublish: true,\n      canSubscribe: true,\n      canPublishData: true,\n      canUpdateOwnMetadata: true,\n    });\n    token.roomConfig = new RoomConfiguration({\n      agents: [\n        new RoomAgentDispatch({\n          agentName: options.agentName ?? DEFAULT_LIVEKIT_AGENT_NAME,\n          metadata: serializeSessionMetadata(metadata),\n        }),\n      ],\n    });\n\n    const details: LiveKitConnectionDetails = {\n      serverUrl,\n      roomName,\n      participantName: identity,\n      participantToken: await token.toJwt(),\n    };\n    return c.json(details);\n  };\n\n  return {\n    path: options.path ?? '/voice/livekit/connection-details',\n    method: 'POST',\n    requiresAuth: options.requiresAuth,\n    handler,\n  } as ApiRoute;\n}\n","import { AgentDispatchClient } from 'livekit-server-sdk';\nimport { DEFAULT_LIVEKIT_AGENT_NAME } from './constants';\nimport { serializeSessionMetadata } from './metadata';\nimport type { LiveKitSessionMetadata } from './metadata';\n\nexport interface DispatchVoiceSessionOptions {\n  /** Room to dispatch the agent into (created on demand). */\n  roomName: string;\n  /** Must match the worker's `agentName`. Defaults to `'mastra-voice'`. */\n  agentName?: string;\n  metadata?: LiveKitSessionMetadata;\n  /** Defaults to `LIVEKIT_URL`. */\n  serverUrl?: string;\n  /** Defaults to `LIVEKIT_API_KEY`. */\n  apiKey?: string;\n  /** Defaults to `LIVEKIT_API_SECRET`. */\n  apiSecret?: string;\n}\n\nfunction toHttpUrl(url: string): string {\n  return url.replace(/^ws/, 'http');\n}\n\n/**\n * Programmatically dispatches a Mastra voice agent into a LiveKit room — for\n * server-initiated sessions such as outbound calls or joining an existing room.\n */\nexport async function dispatchVoiceSession(options: DispatchVoiceSessionOptions) {\n  const serverUrl = options.serverUrl ?? process.env.LIVEKIT_URL;\n  const apiKey = options.apiKey ?? process.env.LIVEKIT_API_KEY;\n  const apiSecret = options.apiSecret ?? process.env.LIVEKIT_API_SECRET;\n  if (!serverUrl) {\n    throw new Error('@mastra/livekit: set LIVEKIT_URL or pass serverUrl to dispatchVoiceSession.');\n  }\n  if (!apiKey || !apiSecret) {\n    throw new Error(\n      '@mastra/livekit: set LIVEKIT_API_KEY and LIVEKIT_API_SECRET or pass apiKey/apiSecret to dispatchVoiceSession.',\n    );\n  }\n  const client = new AgentDispatchClient(toHttpUrl(serverUrl), apiKey, apiSecret);\n  return client.createDispatch(options.roomName, options.agentName ?? DEFAULT_LIVEKIT_AGENT_NAME, {\n    metadata: serializeSessionMetadata(options.metadata ?? {}),\n  });\n}\n","// Server-safe: only depends on `@mastra/core` + zod, never the `@livekit/agents` runtime — so it\n// can be added to agents defined in server/shared code and re-exported from the root entry\n// (`index.ts`). `index.test.ts` enforces that boundary.\nimport { createTool } from '@mastra/core/tools';\nimport { z } from 'zod';\n\n/** A consent decision captured from the caller during a call. */\nexport interface ConsentGrant {\n  /**\n   * The consent item, matching a key in the worker's `configuration.consentPolicy` (e.g.\n   * `'summaryStorage'`).\n   */\n  item: string;\n  /** `true` if the caller agreed, `false` if they declined. */\n  granted: boolean;\n  /** The caller the grant belongs to (the memory `resource`), when the call is memory-scoped. */\n  resourceId?: string;\n  /** The call thread the grant was captured on, when the call is memory-scoped. */\n  threadId?: string;\n}\n\nexport interface ConsentToolOptions {\n  /**\n   * Persist the caller's decision to YOUR system of record (database, CRM, consent ledger). Called\n   * each time the caller answers a consent question — keep it quick, it runs inside the turn. This\n   * tool owns extracting the caller's identity from the tool execution context; you own storage, so\n   * consent lives in a durable, compliant place rather than an opaque plugin store. Read those\n   * grants back at `onCallEnd` (or before any consent-gated step) to enforce the requirement.\n   */\n  onGrant: (grant: ConsentGrant) => void | Promise<void>;\n  /** Tool id the agent calls. Defaults to `'recordConsent'`. */\n  id?: string;\n  /** Override the description the model sees when deciding to call the tool. */\n  description?: string;\n  /** Restrict the accepted consent items to this set (becomes an enum). Defaults to any string. */\n  items?: readonly string[];\n}\n\nconst DEFAULT_DESCRIPTION =\n  \"Record the caller's consent decision for a data-processing item (for example, storing a summary \" +\n  'of the call). Call this as soon as the caller answers a consent question: granted = true if they ' +\n  'agree, false if they decline. Do not proceed with an activity that requires consent until you ' +\n  'have recorded the caller granting it.';\n\n/**\n * Builds a Mastra tool that captures the caller's consent decisions at runtime — the companion to\n * the worker's `configuration.consentPolicy`, which only DECLARES which consents a call needs. Add\n * it to the agent that answers the call; on each call the tool reads the caller's `resourceId` /\n * `threadId` from its execution context and hands the decision to your `onGrant` store. The runtime\n * grants live only where `onGrant` put them: enforce consent by reading them back from your own\n * store — at `onCallEnd` or before any consent-gated action — cross-checking against the declared\n * requirements in `VoiceCallEndArgs.configuration.consentPolicy` (the configuration carries the\n * policy, never the grants).\n *\n * ```ts\n * // agent tools\n * recordConsent: createConsentTool({\n *   items: ['summaryStorage'],\n *   onGrant: async ({ item, granted, resourceId }) => {\n *     if (resourceId) await db.saveConsent(resourceId, item, granted);\n *   },\n * }),\n * ```\n */\nexport function createConsentTool(options: ConsentToolOptions) {\n  const items = options.items;\n  const itemSchema = items && items.length > 0 ? z.enum([...items] as [string, ...string[]]) : z.string();\n  return createTool({\n    id: options.id ?? 'recordConsent',\n    description: options.description ?? DEFAULT_DESCRIPTION,\n    inputSchema: z.object({\n      item: itemSchema.describe(\n        \"The consent item the caller is answering for (matches the deployment's required consents).\",\n      ),\n      granted: z.boolean().describe('True if the caller agreed, false if they declined.'),\n    }),\n    execute: async ({ item, granted }, { agent }) => {\n      await options.onGrant({ item, granted, resourceId: agent?.resourceId, threadId: agent?.threadId });\n      return { recorded: true as const, item, granted };\n    },\n  });\n}\n","// Server-safe: only depends on `@mastra/core` + zod, never the `@livekit/agents` runtime — so it\n// can be added to agents defined in server/shared code and re-exported from the root entry\n// (`index.ts`). `index.test.ts` enforces that boundary.\nimport { createTool } from '@mastra/core/tools';\nimport { z } from 'zod';\n\n/** Details of the agent's decision to end the call, handed to {@link EndCallToolOptions.onEndCall}. */\nexport interface EndCallRequest {\n  /** Short reason the agent gave for ending the call, if any (e.g. \"caller said goodbye\"). */\n  reason?: string;\n  /** The caller the call belongs to (the memory `resource`), when the call is memory-scoped. */\n  resourceId?: string;\n  /** The call thread, when the call is memory-scoped. */\n  threadId?: string;\n}\n\nexport interface EndCallToolOptions {\n  /**\n   * Tool id the agent calls to end the call. Must match the worker's\n   * `configuration.endCall.tool` (both default to `'endCall'`), since that's the name the worker\n   * watches for to hang up.\n   */\n  id?: string;\n  /** Override the description the model sees when deciding to call the tool. */\n  description?: string;\n  /**\n   * Optional bookkeeping hook, called when the agent invokes the tool (records the reason, marks\n   * the call resolved in your CRM, …). Runs inside the turn — keep it quick. It does NOT hang up\n   * the call; the worker does that once the agent's final words finish playing. The tool reads the\n   * caller's identity from its execution context and passes it here.\n   */\n  onEndCall?: (request: EndCallRequest) => void | Promise<void>;\n}\n\nconst DEFAULT_DESCRIPTION =\n  'End the phone call. Call this only after you have said goodbye and there is nothing left to do — ' +\n  'for example the caller says goodbye, or the task is complete and you have wrapped up. Say your ' +\n  'closing line first, then call this as your final action; the call hangs up once your words finish ' +\n  'playing. Your closing line must be a final statement, never a question — if you are asking the ' +\n  'caller anything (for example whether they need anything else), do NOT call this in that reply; ' +\n  'wait for their answer. Do not call it if the caller still needs something.';\n\n/**\n * Builds a Mastra tool the agent calls to end the call itself (say goodbye → hang up). It is the\n * agent-visible half of agent-initiated hang-up: the tool only SIGNALS intent (and runs optional\n * bookkeeping) — it can't reach the LiveKit room from inside `agent.stream()`. The worker owns the\n * hang-up: with `configuration.endCall` set, it watches each turn for this tool, waits for the\n * agent's closing words to finish playing, then disconnects (running `onCallEnd` on the way out).\n * Keeping the tool inside the single agent means it stays visible/editable in Studio and works on\n * the agent and workflow reply paths alike.\n *\n * ```ts\n * // agent tools\n * endCall: createEndCallTool({\n *   onEndCall: ({ reason, resourceId }) => log.info('agent ended call', { reason, resourceId }),\n * }),\n * // worker\n * createLiveKitWorker({ mastra, agent: 'support', configuration: { endCall: {} } });\n * ```\n */\nexport function createEndCallTool(options: EndCallToolOptions = {}) {\n  return createTool({\n    id: options.id ?? 'endCall',\n    description: options.description ?? DEFAULT_DESCRIPTION,\n    inputSchema: z.object({\n      reason: z\n        .string()\n        .nullish()\n        .describe('Short reason the call is ending, e.g. \"caller said goodbye\" or \"task complete\".'),\n    }),\n    outputSchema: z.object({ ended: z.boolean() }),\n    execute: async ({ reason }, { agent }) => {\n      try {\n        await options.onEndCall?.({\n          reason: reason ?? undefined,\n          resourceId: agent?.resourceId,\n          threadId: agent?.threadId,\n        });\n      } catch (error) {\n        // Bookkeeping is best-effort — the tool must still signal `{ ended: true }` so the worker's\n        // end-call detector runs and the call actually hangs up.\n        console.warn('@mastra/livekit: onEndCall hook threw', error);\n      }\n      return { ended: true as const };\n    },\n  });\n}\n"]}
+{"version":3,"file":"index.js","names":["DEFAULT_DESCRIPTION"],"sources":["../src/routes.ts","../src/dispatch.ts","../src/consent.ts","../src/end-call.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport { RoomAgentDispatch, RoomConfiguration } from '@livekit/protocol';\nimport type { ContextWithMastra, ApiRoute } from '@mastra/core/server';\nimport { AccessToken } from 'livekit-server-sdk';\nimport { DEFAULT_LIVEKIT_AGENT_NAME } from './constants';\nimport { serializeSessionMetadata } from './metadata';\nimport type { LiveKitSessionMetadata } from './metadata';\n\n/** Response body of the connection-details route. Matches LiveKit's frontend starter contract. */\nexport interface LiveKitConnectionDetails {\n  serverUrl: string;\n  roomName: string;\n  participantName: string;\n  participantToken: string;\n}\n\nexport interface ConnectionRequestArgs {\n  body: Record<string, unknown>;\n  context: ContextWithMastra;\n}\n\nexport interface LiveKitConnectionRouteOptions {\n  /**\n   * Route path. Defaults to `/voice/livekit/connection-details`. Mastra reserves the\n   * `/api` prefix for built-in routes, so custom paths must not start with `/api`.\n   */\n  path?: string;\n  /** LiveKit server URL (`wss://...`). Defaults to `LIVEKIT_URL`. */\n  serverUrl?: string;\n  /** Defaults to `LIVEKIT_API_KEY`. */\n  apiKey?: string;\n  /** Defaults to `LIVEKIT_API_SECRET`. */\n  apiSecret?: string;\n  /** LiveKit agent name for explicit dispatch. Must match the worker's `agentName`. */\n  agentName?: string;\n  /** Token time-to-live. Defaults to `'15m'`. */\n  ttl?: string | number;\n  /** Defaults to `true` (Mastra custom routes require auth unless opted out). */\n  requiresAuth?: boolean;\n  roomName?: string | ((args: ConnectionRequestArgs) => string);\n  participantIdentity?: string | ((args: ConnectionRequestArgs) => string);\n  /**\n   * Session metadata delivered to the worker via agent dispatch. Defaults to passing\n   * through `agentId`, `threadId`, and `resourceId` from the request body.\n   */\n  metadata?: (args: ConnectionRequestArgs) => LiveKitSessionMetadata | Promise<LiveKitSessionMetadata>;\n}\n\nfunction stringField(body: Record<string, unknown>, key: string): string | undefined {\n  const value = body[key];\n  return typeof value === 'string' && value.length > 0 ? value : undefined;\n}\n\n/**\n * An ApiRoute for `server.apiRoutes` that mints a LiveKit access token with the Mastra\n * voice agent dispatched into the room. Frontends call it to join a voice session:\n *\n * ```ts\n * export const mastra = new Mastra({\n *   agents: { support },\n *   server: { apiRoutes: [liveKitConnectionRoute({ agentName: 'mastra-voice' })] },\n * });\n * ```\n */\nexport function liveKitConnectionRoute(options: LiveKitConnectionRouteOptions = {}): ApiRoute {\n  const handler = async (c: ContextWithMastra) => {\n    const serverUrl = options.serverUrl ?? process.env.LIVEKIT_URL;\n    const apiKey = options.apiKey ?? process.env.LIVEKIT_API_KEY;\n    const apiSecret = options.apiSecret ?? process.env.LIVEKIT_API_SECRET;\n    if (!serverUrl || !apiKey || !apiSecret) {\n      return c.json(\n        {\n          error:\n            'LiveKit is not configured. Set LIVEKIT_URL, LIVEKIT_API_KEY, and LIVEKIT_API_SECRET ' +\n            '(or pass serverUrl/apiKey/apiSecret to liveKitConnectionRoute).',\n        },\n        500,\n      );\n    }\n\n    const body: Record<string, unknown> = await c.req\n      .json()\n      .then((parsed: unknown) =>\n        parsed && typeof parsed === 'object' && !Array.isArray(parsed) ? (parsed as Record<string, unknown>) : {},\n      )\n      .catch(() => ({}));\n    const args: ConnectionRequestArgs = { body, context: c };\n\n    const metadata: LiveKitSessionMetadata = options.metadata\n      ? await options.metadata(args)\n      : {\n          agentId: stringField(body, 'agentId'),\n          threadId: stringField(body, 'threadId'),\n          resourceId: stringField(body, 'resourceId'),\n        };\n\n    const roomName =\n      typeof options.roomName === 'function'\n        ? options.roomName(args)\n        : (options.roomName ?? `mastra-voice-${randomUUID().slice(0, 8)}`);\n    const identity =\n      typeof options.participantIdentity === 'function'\n        ? options.participantIdentity(args)\n        : (options.participantIdentity ?? metadata.resourceId ?? `user-${randomUUID().slice(0, 8)}`);\n    // One memory thread per room unless the caller pins a thread explicitly.\n    metadata.threadId ??= roomName;\n\n    const token = new AccessToken(apiKey, apiSecret, { identity, ttl: options.ttl ?? '15m' });\n    token.addGrant({\n      room: roomName,\n      roomJoin: true,\n      canPublish: true,\n      canSubscribe: true,\n      canPublishData: true,\n      canUpdateOwnMetadata: true,\n    });\n    token.roomConfig = new RoomConfiguration({\n      agents: [\n        new RoomAgentDispatch({\n          agentName: options.agentName ?? DEFAULT_LIVEKIT_AGENT_NAME,\n          metadata: serializeSessionMetadata(metadata),\n        }),\n      ],\n    });\n\n    const details: LiveKitConnectionDetails = {\n      serverUrl,\n      roomName,\n      participantName: identity,\n      participantToken: await token.toJwt(),\n    };\n    return c.json(details);\n  };\n\n  return {\n    path: options.path ?? '/voice/livekit/connection-details',\n    method: 'POST',\n    requiresAuth: options.requiresAuth,\n    handler,\n  } as ApiRoute;\n}\n","import { AgentDispatchClient } from 'livekit-server-sdk';\nimport { DEFAULT_LIVEKIT_AGENT_NAME } from './constants';\nimport { serializeSessionMetadata } from './metadata';\nimport type { LiveKitSessionMetadata } from './metadata';\n\nexport interface DispatchVoiceSessionOptions {\n  /** Room to dispatch the agent into (created on demand). */\n  roomName: string;\n  /** Must match the worker's `agentName`. Defaults to `'mastra-voice'`. */\n  agentName?: string;\n  metadata?: LiveKitSessionMetadata;\n  /** Defaults to `LIVEKIT_URL`. */\n  serverUrl?: string;\n  /** Defaults to `LIVEKIT_API_KEY`. */\n  apiKey?: string;\n  /** Defaults to `LIVEKIT_API_SECRET`. */\n  apiSecret?: string;\n}\n\nfunction toHttpUrl(url: string): string {\n  return url.replace(/^ws/, 'http');\n}\n\n/**\n * Programmatically dispatches a Mastra voice agent into a LiveKit room — for\n * server-initiated sessions such as outbound calls or joining an existing room.\n */\nexport async function dispatchVoiceSession(options: DispatchVoiceSessionOptions) {\n  const serverUrl = options.serverUrl ?? process.env.LIVEKIT_URL;\n  const apiKey = options.apiKey ?? process.env.LIVEKIT_API_KEY;\n  const apiSecret = options.apiSecret ?? process.env.LIVEKIT_API_SECRET;\n  if (!serverUrl) {\n    throw new Error('@mastra/livekit: set LIVEKIT_URL or pass serverUrl to dispatchVoiceSession.');\n  }\n  if (!apiKey || !apiSecret) {\n    throw new Error(\n      '@mastra/livekit: set LIVEKIT_API_KEY and LIVEKIT_API_SECRET or pass apiKey/apiSecret to dispatchVoiceSession.',\n    );\n  }\n  const client = new AgentDispatchClient(toHttpUrl(serverUrl), apiKey, apiSecret);\n  return client.createDispatch(options.roomName, options.agentName ?? DEFAULT_LIVEKIT_AGENT_NAME, {\n    metadata: serializeSessionMetadata(options.metadata ?? {}),\n  });\n}\n","// Server-safe: only depends on `@mastra/core` + zod, never the `@livekit/agents` runtime — so it\n// can be added to agents defined in server/shared code and re-exported from the root entry\n// (`index.ts`). `index.test.ts` enforces that boundary.\nimport { createTool } from '@mastra/core/tools';\nimport { z } from 'zod';\n\n/** A consent decision captured from the caller during a call. */\nexport interface ConsentGrant {\n  /**\n   * The consent item, matching a key in the worker's `configuration.consentPolicy` (e.g.\n   * `'summaryStorage'`).\n   */\n  item: string;\n  /** `true` if the caller agreed, `false` if they declined. */\n  granted: boolean;\n  /** The caller the grant belongs to (the memory `resource`), when the call is memory-scoped. */\n  resourceId?: string;\n  /** The call thread the grant was captured on, when the call is memory-scoped. */\n  threadId?: string;\n}\n\nexport interface ConsentToolOptions {\n  /**\n   * Persist the caller's decision to YOUR system of record (database, CRM, consent ledger). Called\n   * each time the caller answers a consent question — keep it quick, it runs inside the turn. This\n   * tool owns extracting the caller's identity from the tool execution context; you own storage, so\n   * consent lives in a durable, compliant place rather than an opaque plugin store. Read those\n   * grants back at `onCallEnd` (or before any consent-gated step) to enforce the requirement.\n   */\n  onGrant: (grant: ConsentGrant) => void | Promise<void>;\n  /** Tool id the agent calls. Defaults to `'recordConsent'`. */\n  id?: string;\n  /** Override the description the model sees when deciding to call the tool. */\n  description?: string;\n  /** Restrict the accepted consent items to this set (becomes an enum). Defaults to any string. */\n  items?: readonly string[];\n}\n\nconst DEFAULT_DESCRIPTION =\n  \"Record the caller's consent decision for a data-processing item (for example, storing a summary \" +\n  'of the call). Call this as soon as the caller answers a consent question: granted = true if they ' +\n  'agree, false if they decline. Do not proceed with an activity that requires consent until you ' +\n  'have recorded the caller granting it.';\n\n/**\n * Builds a Mastra tool that captures the caller's consent decisions at runtime — the companion to\n * the worker's `configuration.consentPolicy`, which only DECLARES which consents a call needs. Add\n * it to the agent that answers the call; on each call the tool reads the caller's `resourceId` /\n * `threadId` from its execution context and hands the decision to your `onGrant` store. The runtime\n * grants live only where `onGrant` put them: enforce consent by reading them back from your own\n * store — at `onCallEnd` or before any consent-gated action — cross-checking against the declared\n * requirements in `VoiceCallEndArgs.configuration.consentPolicy` (the configuration carries the\n * policy, never the grants).\n *\n * ```ts\n * // agent tools\n * recordConsent: createConsentTool({\n *   items: ['summaryStorage'],\n *   onGrant: async ({ item, granted, resourceId }) => {\n *     if (resourceId) await db.saveConsent(resourceId, item, granted);\n *   },\n * }),\n * ```\n */\nexport function createConsentTool(options: ConsentToolOptions) {\n  const items = options.items;\n  const itemSchema = items && items.length > 0 ? z.enum([...items] as [string, ...string[]]) : z.string();\n  return createTool({\n    id: options.id ?? 'recordConsent',\n    description: options.description ?? DEFAULT_DESCRIPTION,\n    inputSchema: z.object({\n      item: itemSchema.describe(\n        \"The consent item the caller is answering for (matches the deployment's required consents).\",\n      ),\n      granted: z.boolean().describe('True if the caller agreed, false if they declined.'),\n    }),\n    execute: async ({ item, granted }, { agent }) => {\n      await options.onGrant({ item, granted, resourceId: agent?.resourceId, threadId: agent?.threadId });\n      return { recorded: true as const, item, granted };\n    },\n  });\n}\n","// Server-safe: only depends on `@mastra/core` + zod, never the `@livekit/agents` runtime — so it\n// can be added to agents defined in server/shared code and re-exported from the root entry\n// (`index.ts`). `index.test.ts` enforces that boundary.\nimport { createTool } from '@mastra/core/tools';\nimport { z } from 'zod';\n\n/** Details of the agent's decision to end the call, handed to {@link EndCallToolOptions.onEndCall}. */\nexport interface EndCallRequest {\n  /** Short reason the agent gave for ending the call, if any (e.g. \"caller said goodbye\"). */\n  reason?: string;\n  /** The caller the call belongs to (the memory `resource`), when the call is memory-scoped. */\n  resourceId?: string;\n  /** The call thread, when the call is memory-scoped. */\n  threadId?: string;\n}\n\nexport interface EndCallToolOptions {\n  /**\n   * Tool id the agent calls to end the call. Must match the worker's\n   * `configuration.endCall.tool` (both default to `'endCall'`), since that's the name the worker\n   * watches for to hang up.\n   */\n  id?: string;\n  /** Override the description the model sees when deciding to call the tool. */\n  description?: string;\n  /**\n   * Optional bookkeeping hook, called when the agent invokes the tool (records the reason, marks\n   * the call resolved in your CRM, …). Runs inside the turn — keep it quick. It does NOT hang up\n   * the call; the worker does that once the agent's final words finish playing. The tool reads the\n   * caller's identity from its execution context and passes it here.\n   */\n  onEndCall?: (request: EndCallRequest) => void | Promise<void>;\n}\n\nconst DEFAULT_DESCRIPTION =\n  'End the phone call. Call this only after you have said goodbye and there is nothing left to do — ' +\n  'for example the caller says goodbye, or the task is complete and you have wrapped up. Say your ' +\n  'closing line first, then call this as your final action; the call hangs up once your words finish ' +\n  'playing. Your closing line must be a final statement, never a question — if you are asking the ' +\n  'caller anything (for example whether they need anything else), do NOT call this in that reply; ' +\n  'wait for their answer. Do not call it if the caller still needs something.';\n\n/**\n * Builds a Mastra tool the agent calls to end the call itself (say goodbye → hang up). It is the\n * agent-visible half of agent-initiated hang-up: the tool only SIGNALS intent (and runs optional\n * bookkeeping) — it can't reach the LiveKit room from inside `agent.stream()`. The worker owns the\n * hang-up: with `configuration.endCall` set, it watches each turn for this tool, waits for the\n * agent's closing words to finish playing, then disconnects (running `onCallEnd` on the way out).\n * Keeping the tool inside the single agent means it stays visible/editable in Studio and works on\n * the agent and workflow reply paths alike.\n *\n * ```ts\n * // agent tools\n * endCall: createEndCallTool({\n *   onEndCall: ({ reason, resourceId }) => log.info('agent ended call', { reason, resourceId }),\n * }),\n * // worker\n * createLiveKitWorker({ mastra, agent: 'support', configuration: { endCall: {} } });\n * ```\n */\nexport function createEndCallTool(options: EndCallToolOptions = {}) {\n  return createTool({\n    id: options.id ?? 'endCall',\n    description: options.description ?? DEFAULT_DESCRIPTION,\n    inputSchema: z.object({\n      reason: z\n        .string()\n        .nullish()\n        .describe('Short reason the call is ending, e.g. \"caller said goodbye\" or \"task complete\".'),\n    }),\n    outputSchema: z.object({ ended: z.boolean() }),\n    execute: async ({ reason }, { agent }) => {\n      try {\n        await options.onEndCall?.({\n          reason: reason ?? undefined,\n          resourceId: agent?.resourceId,\n          threadId: agent?.threadId,\n        });\n      } catch (error) {\n        // Bookkeeping is best-effort — the tool must still signal `{ ended: true }` so the worker's\n        // end-call detector runs and the call actually hangs up.\n        console.warn('@mastra/livekit: onEndCall hook threw', error);\n      }\n      return { ended: true as const };\n    },\n  });\n}\n"],"mappings":"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"}

package/dist/llm-plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"llm-plugin.d.ts","sourceRoot":"","sources":["../src/llm-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,GAAG,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,KAAK,EAAE,KAAK,IAAI,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D,OAAO,KAAK,EACV,sBAAsB,EACtB,mBAAmB,EACnB,aAAa,EACb,qBAAqB,EAGtB,MAAM,UAAU,CAAC;AAGlB,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAEzD,YAAY,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kFAAkF;IAClF,MAAM,CAAC,EAAE,wBAAwB,CAAC;IAClC,oEAAoE;IACpE,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,+FAA+F;IAC/F,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAE/B;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,EAAE,sBAAsB,GAAG,KAAK,CAAC;IACxC,4EAA4E;IAC5E,cAAc,CAAC,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE1D,qGAAqG;IACrG,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IACtE,qGAAqG;IACrG,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,IAAI,CAAC;IAC/C,mGAAmG;IACnG,cAAc,CAAC,EAAE,qBAAqB,CAAC;CACxC;AAiCD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,SAAU,SAAQ,GAAG,CAAC,GAAG;;gBAaxB,OAAO,EAAE,gBAAgB;IAuCrC,KAAK,IAAI,MAAM;IAIf,IAAa,KAAK,IAAI,MAAM,CAE3B;IAED,IAAa,QAAQ,IAAI,MAAM,CAE9B;IAED;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAUf,IAAI,CAAC,EACZ,OAAO,EACP,OAAO,EACP,WAAyC,GAC1C,EAAE;QACD,OAAO,EAAE,GAAG,CAAC,WAAW,CAAC;QACzB,OAAO,CAAC,EAAE,GAAG,CAAC,WAAW,CAAC;QAC1B,WAAW,CAAC,EAAE,iBAAiB,CAAC;QAChC,iBAAiB,CAAC,EAAE,OAAO,CAAC;QAC5B,UAAU,CAAC,EAAE,GAAG,CAAC,UAAU,CAAC;QAC5B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACvC,GAAG,GAAG,CAAC,SAAS;IAsBjB,+FAA+F;IACtF,OAAO,IAAI,IAAI;CACzB;AAED,UAAU,sBAAsB;IAC9B,OAAO,EAAE,GAAG,CAAC,WAAW,CAAC;IACzB,OAAO,CAAC,EAAE,GAAG,CAAC,WAAW,CAAC;IAC1B,WAAW,EAAE,iBAAiB,CAAC;IAC/B,SAAS,EAAE,mBAAmB,CAAC;IAC/B,MAAM,EAAE,sBAAsB,GAAG,KAAK,CAAC;IACvC,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED;;;;;GAKG;AACH,cAAM,eAAgB,SAAQ,GAAG,CAAC,SAAS;;gBAK7B,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,sBAAsB;cAOjD,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAgDrC;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}
+{"version":3,"file":"llm-plugin.d.ts","sourceRoot":"","sources":["../src/llm-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,GAAG,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,KAAK,EAAE,KAAK,IAAI,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D,OAAO,KAAK,EACV,sBAAsB,EACtB,mBAAmB,EACnB,aAAa,EACb,qBAAqB,EAGtB,MAAM,UAAU,CAAC;AAGlB,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAEzD,YAAY,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kFAAkF;IAClF,MAAM,CAAC,EAAE,wBAAwB,CAAC;IAClC,oEAAoE;IACpE,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,+FAA+F;IAC/F,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAE/B;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,EAAE,sBAAsB,GAAG,KAAK,CAAC;IACxC,4EAA4E;IAC5E,cAAc,CAAC,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE1D,qGAAqG;IACrG,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IACtE,qGAAqG;IACrG,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,IAAI,CAAC;IAC/C,mGAAmG;IACnG,cAAc,CAAC,EAAE,qBAAqB,CAAC;CACxC;AAiCD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,SAAU,SAAQ,GAAG,CAAC,GAAG;;IAapC,YAAY,OAAO,EAAE,gBAAgB,EAqCpC;IAED,KAAK,IAAI,MAAM,CAEd;IAED,IAAa,KAAK,IAAI,MAAM,CAE3B;IAED,IAAa,QAAQ,IAAI,MAAM,CAE9B;IAED;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAUf,IAAI,CAAC,EACZ,OAAO,EACP,OAAO,EACP,WAAyC,GAC1C,EAAE;QACD,OAAO,EAAE,GAAG,CAAC,WAAW,CAAC;QACzB,OAAO,CAAC,EAAE,GAAG,CAAC,WAAW,CAAC;QAC1B,WAAW,CAAC,EAAE,iBAAiB,CAAC;QAChC,iBAAiB,CAAC,EAAE,OAAO,CAAC;QAC5B,UAAU,CAAC,EAAE,GAAG,CAAC,UAAU,CAAC;QAC5B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACvC,GAAG,GAAG,CAAC,SAAS,CAoBhB;IAED,+FAA+F;IACtF,OAAO,IAAI,IAAI,CAAG;CAC5B;AAED,UAAU,sBAAsB;IAC9B,OAAO,EAAE,GAAG,CAAC,WAAW,CAAC;IACzB,OAAO,CAAC,EAAE,GAAG,CAAC,WAAW,CAAC;IAC1B,WAAW,EAAE,iBAAiB,CAAC;IAC/B,SAAS,EAAE,mBAAmB,CAAC;IAC/B,MAAM,EAAE,sBAAsB,GAAG,KAAK,CAAC;IACvC,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED;;;;;GAKG;AACH,cAAM,eAAgB,SAAQ,GAAG,CAAC,SAAS;;IAKzC,YAAY,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,sBAAsB,EAKhE;IAED,UAAgB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CA+CnC;CACF;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}