@mastra/code-sdk 0.0.0-aggregate-trace-20261015182851

package/dist/agent-connections/types.d.ts

@@ -0,0 +1,99 @@
+export declare const AGENT_CONNECTIONS_STATE_ID = "agent-connections";
+export declare const AGENT_CONNECTIONS_STATE_TYPE = "agent_connection";
+export type AgentPeerRelationship = 'none' | 'saved';
+export type AgentPeerPresence = 'advertised' | 'absent';
+export type AgentPeerDisplayStatus = 'discovered' | 'connected' | 'saved';
+export type AgentSignalPriority = 'low' | 'medium' | 'high' | 'urgent';
+export type AgentSignalRoutingAction = 'wake' | 'deliver' | 'persist' | 'discard' | 'blocked';
+export interface AgentPeerIdentity {
+    /** Stable model-facing id used by tools. Discovery ids must match the canonical routing tuple id. */
+    id?: string;
+    /** Target agent id. Defaults to the current code agent when omitted by discovery. */
+    agentId?: string;
+    resourceId: string;
+    threadId: string;
+    label?: string;
+    title?: string;
+    mode?: string;
+    pid?: number;
+    lastSeenAt?: number;
+}
+export interface AgentPeerView {
+    id: string;
+    agentId: string;
+    resourceId: string;
+    threadId: string;
+    label?: string;
+    title?: string;
+    mode?: string;
+    relationship: AgentPeerRelationship;
+    presence: AgentPeerPresence;
+    displayStatus: AgentPeerDisplayStatus;
+    canAttemptSend: boolean;
+    pid?: number;
+    connectedAt?: number;
+    lastSeenAt?: number;
+}
+export interface ConnectedAgentPeer extends AgentPeerIdentity {
+    id: string;
+    connectedAt: number;
+    lastSeenAt: number;
+}
+export interface SentAgentSignal {
+    messageId: string;
+    fingerprint: string;
+    targetId: string;
+    priority: AgentSignalPriority;
+    expectsReply: boolean;
+    replyTo?: string;
+    returnPeerId: string;
+    routingAction?: AgentSignalRoutingAction;
+    runId?: string;
+    sentAt: number;
+}
+export interface AgentConnectionsState {
+    peers: ConnectedAgentPeer[];
+    sentSignals?: SentAgentSignal[];
+}
+export interface AgentConnectionDeltaOp {
+    op: 'connect' | 'disconnect' | 'presence-change' | 'update';
+    id: string;
+    peer?: AgentPeerView;
+    presence?: AgentPeerPresence;
+    displayStatus?: AgentPeerDisplayStatus;
+}
+export interface AgentConnectionListResult {
+    content: string;
+    peers: AgentPeerView[];
+    savedCount: number;
+    isError?: boolean;
+}
+export interface AgentConnectResult {
+    content: string;
+    connected: ConnectedAgentPeer[];
+    changed: AgentConnectionDeltaOp[];
+    isError?: boolean;
+}
+export interface AgentDisconnectResult {
+    content: string;
+    connected: ConnectedAgentPeer[];
+    disconnectedIds: string[];
+    alreadyDisconnectedIds: string[];
+    changed: AgentConnectionDeltaOp[];
+    isError?: boolean;
+}
+export interface AgentSignalSendResult {
+    content: string;
+    target?: AgentPeerView;
+    priority?: AgentSignalPriority;
+    expectsReply?: boolean;
+    messageId?: string;
+    replyTo?: string;
+    returnPeerId?: string;
+    routingAction?: AgentSignalRoutingAction;
+    replyOutcome?: 'peer-unavailable';
+    runId?: string;
+    duplicate?: boolean;
+    isError?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/agent-connections/types.d.ts.map

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

package/dist/agent-connections/types.js

@@ -0,0 +1,7 @@
+//#region src/agent-connections/types.ts
+const AGENT_CONNECTIONS_STATE_ID = "agent-connections";
+const AGENT_CONNECTIONS_STATE_TYPE = "agent_connection";
+//#endregion
+export { AGENT_CONNECTIONS_STATE_ID, AGENT_CONNECTIONS_STATE_TYPE };
+
+//# sourceMappingURL=types.js.map

package/dist/agent-connections/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","names":[],"sources":["../../src/agent-connections/types.ts"],"sourcesContent":["export const AGENT_CONNECTIONS_STATE_ID = 'agent-connections';\nexport const AGENT_CONNECTIONS_STATE_TYPE = 'agent_connection';\n\nexport type AgentPeerRelationship = 'none' | 'saved';\nexport type AgentPeerPresence = 'advertised' | 'absent';\nexport type AgentPeerDisplayStatus = 'discovered' | 'connected' | 'saved';\nexport type AgentSignalPriority = 'low' | 'medium' | 'high' | 'urgent';\nexport type AgentSignalRoutingAction = 'wake' | 'deliver' | 'persist' | 'discard' | 'blocked';\n\nexport interface AgentPeerIdentity {\n  /** Stable model-facing id used by tools. Discovery ids must match the canonical routing tuple id. */\n  id?: string;\n  /** Target agent id. Defaults to the current code agent when omitted by discovery. */\n  agentId?: string;\n  resourceId: string;\n  threadId: string;\n  label?: string;\n  title?: string;\n  mode?: string;\n  pid?: number;\n  lastSeenAt?: number;\n}\n\nexport interface AgentPeerView {\n  id: string;\n  agentId: string;\n  resourceId: string;\n  threadId: string;\n  label?: string;\n  title?: string;\n  mode?: string;\n  relationship: AgentPeerRelationship;\n  presence: AgentPeerPresence;\n  displayStatus: AgentPeerDisplayStatus;\n  canAttemptSend: boolean;\n  pid?: number;\n  connectedAt?: number;\n  lastSeenAt?: number;\n}\n\nexport interface ConnectedAgentPeer extends AgentPeerIdentity {\n  id: string;\n  connectedAt: number;\n  lastSeenAt: number;\n}\n\nexport interface SentAgentSignal {\n  messageId: string;\n  fingerprint: string;\n  targetId: string;\n  priority: AgentSignalPriority;\n  expectsReply: boolean;\n  replyTo?: string;\n  returnPeerId: string;\n  routingAction?: AgentSignalRoutingAction;\n  runId?: string;\n  sentAt: number;\n}\n\nexport interface AgentConnectionsState {\n  peers: ConnectedAgentPeer[];\n  sentSignals?: SentAgentSignal[];\n}\n\nexport interface AgentConnectionDeltaOp {\n  op: 'connect' | 'disconnect' | 'presence-change' | 'update';\n  id: string;\n  peer?: AgentPeerView;\n  presence?: AgentPeerPresence;\n  displayStatus?: AgentPeerDisplayStatus;\n}\n\nexport interface AgentConnectionListResult {\n  content: string;\n  peers: AgentPeerView[];\n  savedCount: number;\n  isError?: boolean;\n}\n\nexport interface AgentConnectResult {\n  content: string;\n  connected: ConnectedAgentPeer[];\n  changed: AgentConnectionDeltaOp[];\n  isError?: boolean;\n}\n\nexport interface AgentDisconnectResult {\n  content: string;\n  connected: ConnectedAgentPeer[];\n  disconnectedIds: string[];\n  alreadyDisconnectedIds: string[];\n  changed: AgentConnectionDeltaOp[];\n  isError?: boolean;\n}\n\nexport interface AgentSignalSendResult {\n  content: string;\n  target?: AgentPeerView;\n  priority?: AgentSignalPriority;\n  expectsReply?: boolean;\n  messageId?: string;\n  replyTo?: string;\n  returnPeerId?: string;\n  routingAction?: AgentSignalRoutingAction;\n  replyOutcome?: 'peer-unavailable';\n  runId?: string;\n  duplicate?: boolean;\n  isError?: boolean;\n}\n"],"mappings":";AAAA,MAAa,6BAA6B;AAC1C,MAAa,+BAA+B"}

package/dist/agent-connections/untrusted-text.d.ts

@@ -0,0 +1,5 @@
+export declare const UNTRUSTED_PEER_ID_MAX_LENGTH = 512;
+export declare const UNTRUSTED_PEER_METADATA_MAX_LENGTH = 256;
+export declare function boundUntrustedText(value: string | undefined, maxLength: number): string | undefined;
+export declare function serializeUntrustedData(value: unknown): string;
+//# sourceMappingURL=untrusted-text.d.ts.map

package/dist/agent-connections/untrusted-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"untrusted-text.d.ts","sourceRoot":"","sources":["../../src/agent-connections/untrusted-text.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,4BAA4B,MAAM,CAAC;AAChD,eAAO,MAAM,kCAAkC,MAAM,CAAC;AAEtD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGnG;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAe7D"}

package/dist/agent-connections/untrusted-text.js

@@ -0,0 +1,22 @@
+//#region src/agent-connections/untrusted-text.ts
+const UNTRUSTED_PEER_ID_MAX_LENGTH = 512;
+const UNTRUSTED_PEER_METADATA_MAX_LENGTH = 256;
+function boundUntrustedText(value, maxLength) {
+	if (value === void 0 || value.length <= maxLength) return value;
+	return `${value.slice(0, maxLength)}…`;
+}
+function serializeUntrustedData(value) {
+	return JSON.stringify(value).replace(/[<>&\u2028\u2029]/g, (character) => {
+		switch (character) {
+			case "<": return "\\u003c";
+			case ">": return "\\u003e";
+			case "&": return "\\u0026";
+			case "\u2028": return "\\u2028";
+			default: return "\\u2029";
+		}
+	});
+}
+//#endregion
+export { UNTRUSTED_PEER_ID_MAX_LENGTH, UNTRUSTED_PEER_METADATA_MAX_LENGTH, boundUntrustedText, serializeUntrustedData };
+
+//# sourceMappingURL=untrusted-text.js.map

package/dist/agent-connections/untrusted-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"untrusted-text.js","names":[],"sources":["../../src/agent-connections/untrusted-text.ts"],"sourcesContent":["export const UNTRUSTED_PEER_ID_MAX_LENGTH = 512;\nexport const UNTRUSTED_PEER_METADATA_MAX_LENGTH = 256;\n\nexport function boundUntrustedText(value: string | undefined, maxLength: number): string | undefined {\n  if (value === undefined || value.length <= maxLength) return value;\n  return `${value.slice(0, maxLength)}…`;\n}\n\nexport function serializeUntrustedData(value: unknown): string {\n  return JSON.stringify(value).replace(/[<>&\\u2028\\u2029]/g, character => {\n    switch (character) {\n      case '<':\n        return '\\\\u003c';\n      case '>':\n        return '\\\\u003e';\n      case '&':\n        return '\\\\u0026';\n      case '\\u2028':\n        return '\\\\u2028';\n      default:\n        return '\\\\u2029';\n    }\n  });\n}\n"],"mappings":";AAAA,MAAa,+BAA+B;AAC5C,MAAa,qCAAqC;AAElD,SAAgB,mBAAmB,OAA2B,WAAuC;CACnG,IAAI,UAAU,KAAA,KAAa,MAAM,UAAU,WAAW,OAAO;CAC7D,OAAO,GAAG,MAAM,MAAM,GAAG,SAAS,EAAE;AACtC;AAEA,SAAgB,uBAAuB,OAAwB;CAC7D,OAAO,KAAK,UAAU,KAAK,CAAC,CAAC,QAAQ,uBAAsB,cAAa;EACtE,QAAQ,WAAR;GACE,KAAK,KACH,OAAO;GACT,KAAK,KACH,OAAO;GACT,KAAK,KACH,OAAO;GACT,KAAK,UACH,OAAO;GACT,SACE,OAAO;EACX;CACF,CAAC;AACH"}

package/dist/agents/background-completion-events.d.ts

@@ -0,0 +1,16 @@
+export interface BackgroundCompletionEvent {
+    id: string;
+    taskId: string;
+    originRunId: string;
+    originToolCallId: string;
+    resourceId: string;
+    threadId: string;
+    toolName: string;
+    status: 'completed' | 'failed' | 'cancelled';
+}
+export interface BackgroundCompletionEvents {
+    publish(event: BackgroundCompletionEvent): void;
+    subscribe(listener: (event: BackgroundCompletionEvent) => void): () => void;
+}
+export declare function createBackgroundCompletionEvents(): BackgroundCompletionEvents;
+//# sourceMappingURL=background-completion-events.d.ts.map

package/dist/agents/background-completion-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-completion-events.d.ts","sourceRoot":"","sources":["../../src/agents/background-completion-events.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;CAC9C;AAED,MAAM,WAAW,0BAA0B;IACzC,OAAO,CAAC,KAAK,EAAE,yBAAyB,GAAG,IAAI,CAAC;IAChD,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,yBAAyB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAC7E;AAED,wBAAgB,gCAAgC,IAAI,0BAA0B,CAkB7E"}

package/dist/agents/background-completion-events.js

@@ -0,0 +1,19 @@
+//#region src/agents/background-completion-events.ts
+function createBackgroundCompletionEvents() {
+	const listeners = /* @__PURE__ */ new Set();
+	return {
+		publish(event) {
+			for (const listener of listeners) try {
+				listener(event);
+			} catch {}
+		},
+		subscribe(listener) {
+			listeners.add(listener);
+			return () => listeners.delete(listener);
+		}
+	};
+}
+//#endregion
+export { createBackgroundCompletionEvents };
+
+//# sourceMappingURL=background-completion-events.js.map

package/dist/agents/background-completion-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-completion-events.js","names":[],"sources":["../../src/agents/background-completion-events.ts"],"sourcesContent":["export interface BackgroundCompletionEvent {\n  id: string;\n  taskId: string;\n  originRunId: string;\n  originToolCallId: string;\n  resourceId: string;\n  threadId: string;\n  toolName: string;\n  status: 'completed' | 'failed' | 'cancelled';\n}\n\nexport interface BackgroundCompletionEvents {\n  publish(event: BackgroundCompletionEvent): void;\n  subscribe(listener: (event: BackgroundCompletionEvent) => void): () => void;\n}\n\nexport function createBackgroundCompletionEvents(): BackgroundCompletionEvents {\n  const listeners = new Set<(event: BackgroundCompletionEvent) => void>();\n\n  return {\n    publish(event) {\n      for (const listener of listeners) {\n        try {\n          listener(event);\n        } catch {\n          // A listener must not prevent other subscribers from receiving the completion.\n        }\n      }\n    },\n    subscribe(listener) {\n      listeners.add(listener);\n      return () => listeners.delete(listener);\n    },\n  };\n}\n"],"mappings":";AAgBA,SAAgB,mCAA+D;CAC7E,MAAM,4BAAY,IAAI,IAAgD;CAEtE,OAAO;EACL,QAAQ,OAAO;GACb,KAAK,MAAM,YAAY,WACrB,IAAI;IACF,SAAS,KAAK;GAChB,QAAQ,CAER;EAEJ;EACA,UAAU,UAAU;GAClB,UAAU,IAAI,QAAQ;GACtB,aAAa,UAAU,OAAO,QAAQ;EACxC;CACF;AACF"}

package/dist/agents/background-completion.d.ts

@@ -0,0 +1,9 @@
+import type { Session } from '@mastra/core/agent-controller';
+import type { BackgroundTaskManagerConfig } from '@mastra/core/background-tasks';
+import type { BackgroundCompletionEvents } from './background-completion-events.js';
+interface BackgroundCompletionRouter {
+    getSessionByResource(resourceId: string): Promise<Session<unknown> | undefined>;
+}
+export declare function createBackgroundCompletionCallbacks(getController: () => BackgroundCompletionRouter, events?: BackgroundCompletionEvents): Pick<BackgroundTaskManagerConfig, 'onTaskComplete' | 'onTaskFailed' | 'onTaskCancelled'>;
+export {};
+//# sourceMappingURL=background-completion.d.ts.map

package/dist/agents/background-completion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-completion.d.ts","sourceRoot":"","sources":["../../src/agents/background-completion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,KAAK,EAAkB,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AACjG,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAEpF,UAAU,0BAA0B;IAClC,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC,CAAC;CACjF;AAwCD,wBAAgB,mCAAmC,CACjD,aAAa,EAAE,MAAM,0BAA0B,EAC/C,MAAM,CAAC,EAAE,0BAA0B,GAClC,IAAI,CAAC,2BAA2B,EAAE,gBAAgB,GAAG,cAAc,GAAG,iBAAiB,CAAC,CAyB1F"}

package/dist/agents/background-completion.js

@@ -0,0 +1,59 @@
+//#region src/agents/background-completion.ts
+async function persistBackgroundCompletion(controller, task, status) {
+	if (!task.resourceId || !task.threadId) return;
+	const session = await controller.getSessionByResource(task.resourceId);
+	if (!session) return;
+	const eventId = `background-task:${task.id}:${status}`;
+	await session.sendSignalToThread({
+		id: eventId,
+		type: "notification",
+		tagName: "notification",
+		contents: `${task.toolName} ${status} in background`,
+		attributes: {
+			source: "background-work",
+			kind: `background-task-${status}`,
+			priority: status === "failed" ? "high" : "low",
+			status
+		},
+		metadata: { backgroundCompletion: {
+			eventId,
+			taskId: task.id,
+			originRunId: task.runId,
+			originToolCallId: task.toolCallId,
+			toolName: task.toolName,
+			status
+		} }
+	}, {
+		resourceId: task.resourceId,
+		threadId: task.threadId
+	}).accepted;
+}
+function createBackgroundCompletionCallbacks(getController, events) {
+	const deliver = async (task, status) => {
+		if (!task.resourceId || !task.threadId) return;
+		const event = {
+			id: `background-task:${task.id}:${status}`,
+			taskId: task.id,
+			originRunId: task.runId,
+			originToolCallId: task.toolCallId,
+			resourceId: task.resourceId,
+			threadId: task.threadId,
+			toolName: task.toolName,
+			status
+		};
+		try {
+			await persistBackgroundCompletion(getController(), task, status);
+		} finally {
+			events?.publish(event);
+		}
+	};
+	return {
+		onTaskComplete: (task) => deliver(task, "completed"),
+		onTaskFailed: (task) => deliver(task, "failed"),
+		onTaskCancelled: (task) => deliver(task, "cancelled")
+	};
+}
+//#endregion
+export { createBackgroundCompletionCallbacks };
+
+//# sourceMappingURL=background-completion.js.map

package/dist/agents/background-completion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-completion.js","names":[],"sources":["../../src/agents/background-completion.ts"],"sourcesContent":["import type { Session } from '@mastra/core/agent-controller';\nimport type { BackgroundTask, BackgroundTaskManagerConfig } from '@mastra/core/background-tasks';\nimport type { BackgroundCompletionEvents } from './background-completion-events.js';\n\ninterface BackgroundCompletionRouter {\n  getSessionByResource(resourceId: string): Promise<Session<unknown> | undefined>;\n}\n\nasync function persistBackgroundCompletion(\n  controller: BackgroundCompletionRouter,\n  task: BackgroundTask,\n  status: 'completed' | 'failed' | 'cancelled',\n): Promise<void> {\n  if (!task.resourceId || !task.threadId) return;\n\n  const session = await controller.getSessionByResource(task.resourceId);\n  if (!session) return;\n\n  const eventId = `background-task:${task.id}:${status}`;\n  await session.sendSignalToThread(\n    {\n      id: eventId,\n      type: 'notification',\n      tagName: 'notification',\n      contents: `${task.toolName} ${status} in background`,\n      attributes: {\n        source: 'background-work',\n        kind: `background-task-${status}`,\n        priority: status === 'failed' ? 'high' : 'low',\n        status,\n      },\n      metadata: {\n        backgroundCompletion: {\n          eventId,\n          taskId: task.id,\n          originRunId: task.runId,\n          originToolCallId: task.toolCallId,\n          toolName: task.toolName,\n          status,\n        },\n      },\n    },\n    { resourceId: task.resourceId, threadId: task.threadId },\n  ).accepted;\n}\n\nexport function createBackgroundCompletionCallbacks(\n  getController: () => BackgroundCompletionRouter,\n  events?: BackgroundCompletionEvents,\n): Pick<BackgroundTaskManagerConfig, 'onTaskComplete' | 'onTaskFailed' | 'onTaskCancelled'> {\n  const deliver = async (task: BackgroundTask, status: 'completed' | 'failed' | 'cancelled') => {\n    if (!task.resourceId || !task.threadId) return;\n    const event = {\n      id: `background-task:${task.id}:${status}`,\n      taskId: task.id,\n      originRunId: task.runId,\n      originToolCallId: task.toolCallId,\n      resourceId: task.resourceId,\n      threadId: task.threadId,\n      toolName: task.toolName,\n      status,\n    };\n    try {\n      await persistBackgroundCompletion(getController(), task, status);\n    } finally {\n      events?.publish(event);\n    }\n  };\n\n  return {\n    onTaskComplete: task => deliver(task, 'completed'),\n    onTaskFailed: task => deliver(task, 'failed'),\n    onTaskCancelled: task => deliver(task, 'cancelled'),\n  };\n}\n"],"mappings":";AAQA,eAAe,4BACb,YACA,MACA,QACe;CACf,IAAI,CAAC,KAAK,cAAc,CAAC,KAAK,UAAU;CAExC,MAAM,UAAU,MAAM,WAAW,qBAAqB,KAAK,UAAU;CACrE,IAAI,CAAC,SAAS;CAEd,MAAM,UAAU,mBAAmB,KAAK,GAAG,GAAG;CAC9C,MAAM,QAAQ,mBACZ;EACE,IAAI;EACJ,MAAM;EACN,SAAS;EACT,UAAU,GAAG,KAAK,SAAS,GAAG,OAAO;EACrC,YAAY;GACV,QAAQ;GACR,MAAM,mBAAmB;GACzB,UAAU,WAAW,WAAW,SAAS;GACzC;EACF;EACA,UAAU,EACR,sBAAsB;GACpB;GACA,QAAQ,KAAK;GACb,aAAa,KAAK;GAClB,kBAAkB,KAAK;GACvB,UAAU,KAAK;GACf;EACF,EACF;CACF,GACA;EAAE,YAAY,KAAK;EAAY,UAAU,KAAK;CAAS,CACzD,CAAC,CAAC;AACJ;AAEA,SAAgB,oCACd,eACA,QAC0F;CAC1F,MAAM,UAAU,OAAO,MAAsB,WAAiD;EAC5F,IAAI,CAAC,KAAK,cAAc,CAAC,KAAK,UAAU;EACxC,MAAM,QAAQ;GACZ,IAAI,mBAAmB,KAAK,GAAG,GAAG;GAClC,QAAQ,KAAK;GACb,aAAa,KAAK;GAClB,kBAAkB,KAAK;GACvB,YAAY,KAAK;GACjB,UAAU,KAAK;GACf,UAAU,KAAK;GACf;EACF;EACA,IAAI;GACF,MAAM,4BAA4B,cAAc,GAAG,MAAM,MAAM;EACjE,UAAU;GACR,QAAQ,QAAQ,KAAK;EACvB;CACF;CAEA,OAAO;EACL,iBAAgB,SAAQ,QAAQ,MAAM,WAAW;EACjD,eAAc,SAAQ,QAAQ,MAAM,QAAQ;EAC5C,kBAAiB,SAAQ,QAAQ,MAAM,WAAW;CACpD;AACF"}

package/dist/agents/context-audit.d.ts

@@ -0,0 +1,84 @@
+import type { PromptSection } from './prompts/index.js';
+/** A single measured contributor to the context window. */
+export interface ContextAuditEntry {
+    id: string;
+    label: string;
+    /** Provenance: file path, server name, model id — whatever identifies the source. */
+    detail?: string;
+    tokens: number;
+    characters: number;
+    /** Share of the audit total, 0-100. */
+    percent: number;
+}
+/** A category of contributors (e.g. all agent instruction files). */
+export interface ContextAuditGroup {
+    id: string;
+    label: string;
+    tokens: number;
+    /** Share of the audit total, 0-100. */
+    percent: number;
+    entries: ContextAuditEntry[];
+    /** Shown alongside the group when its numbers need qualifying. */
+    note?: string;
+}
+export interface ContextAudit {
+    /** Context present before the first message: system prompt, skills, tools. */
+    startup: {
+        tokens: number;
+        percent: number;
+        groups: ContextAuditGroup[];
+    };
+    /** Context accumulated by the session: conversation and observation memory. */
+    accumulated: {
+        tokens: number;
+        percent: number;
+        groups: ContextAuditGroup[];
+    };
+    /** Startup + accumulated. Percentages elsewhere are shares of this. */
+    totalTokens: number;
+    /** Estimated rather than measured: token counts come from a heuristic estimator. */
+    estimated: true;
+}
+/** A tool definition as advertised to the model. */
+export interface ContextAuditTool {
+    name: string;
+    description?: string;
+    /** JSON schema (or any serializable shape) sent with the definition. */
+    parameters?: unknown;
+    /** MCP server that provides the tool, when it is not built in. */
+    server?: string;
+}
+export interface ContextAuditInput {
+    /** Labeled sections of the assembled system prompt. */
+    promptSections?: PromptSection[];
+    /** Labeled sections of the per-request dynamic instructions. */
+    instructionSections?: PromptSection[];
+    /** The skills catalog exactly as injected into the system message. */
+    skillsCatalog?: string;
+    /** Tool definitions advertised to the model. */
+    tools?: ContextAuditTool[];
+    /**
+     * Observation memory currently occupying the context window, either as the
+     * injected text or as a token count reported by the memory subsystem.
+     *
+     * Only observations that are actually in the context belong here.
+     * Observations that merely sit in storage cost nothing until recalled, and
+     * conflating the two is exactly the confusion this audit exists to resolve.
+     */
+    injectedObservations?: string | {
+        tokens: number;
+    };
+    /** Prompt tokens the provider reported for the most recent request. */
+    conversation?: {
+        promptTokens?: number;
+    };
+}
+/**
+ * Build a context audit from already-collected context.
+ *
+ * Percentages are shares of the audited total, not of the model's context
+ * window: window size is not exposed by the model registry, and inventing one
+ * would make every number wrong for models that disagree with the guess.
+ */
+export declare function buildContextAudit(input: ContextAuditInput): ContextAudit;
+//# sourceMappingURL=context-audit.d.ts.map

package/dist/agents/context-audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-audit.d.ts","sourceRoot":"","sources":["../../src/agents/context-audit.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,2DAA2D;AAC3D,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,qFAAqF;IACrF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qEAAqE;AACrE,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,8EAA8E;IAC9E,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,iBAAiB,EAAE,CAAA;KAAE,CAAC;IAC1E,+EAA+E;IAC/E,WAAW,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,iBAAiB,EAAE,CAAA;KAAE,CAAC;IAC9E,uEAAuE;IACvE,WAAW,EAAE,MAAM,CAAC;IACpB,oFAAoF;IACpF,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,oDAAoD;AACpD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,uDAAuD;IACvD,cAAc,CAAC,EAAE,aAAa,EAAE,CAAC;IACjC,gEAAgE;IAChE,mBAAmB,CAAC,EAAE,aAAa,EAAE,CAAC;IACtC,sEAAsE;IACtE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gDAAgD;IAChD,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC3B;;;;;;;OAOG;IACH,oBAAoB,CAAC,EAAE,MAAM,GAAG;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,uEAAuE;IACvE,YAAY,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1C;AA2CD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,GAAG,YAAY,CAsFxE"}

package/dist/agents/context-audit.js

@@ -0,0 +1,118 @@
+import { tokenEstimate } from "../utils/token-estimator.js";
+//#region src/agents/context-audit.ts
+/**
+* Context audit — accounts for what occupies the model's context window.
+*
+* Deliberately pure: callers collect the real strings (prompt sections, the
+* injected skills catalog, tool definitions) and this module only measures and
+* groups them. That keeps the audit honest — it reports on the same text the
+* model receives rather than a description of it — and keeps it testable
+* without a live session.
+*
+* Nothing here reads file contents or secrets: entries carry labels, origins
+* and sizes only, never the underlying text, so an audit can be shown or
+* pasted without leaking whatever the context happens to contain.
+*/
+function measure(id, label, content, detail) {
+	return {
+		id,
+		label,
+		detail,
+		tokens: tokenEstimate(content),
+		characters: content.length,
+		percent: 0
+	};
+}
+function sectionEntries(sections, prefix) {
+	return sections.filter((section) => section.content.length > 0).map((section) => measure(`${prefix}:${section.id}`, section.label, section.content, section.detail));
+}
+function group(id, label, entries, note) {
+	if (entries.length === 0) return void 0;
+	return {
+		id,
+		label,
+		tokens: entries.reduce((sum, entry) => sum + entry.tokens, 0),
+		percent: 0,
+		entries,
+		note
+	};
+}
+/**
+* Group tool definitions by their provider so a chatty MCP server is visible as
+* one line rather than fifty. Per-tool entries stay available underneath.
+*/
+function toolEntries(tools) {
+	return tools.map((tool) => {
+		const serialized = [
+			tool.name,
+			tool.description ?? "",
+			tool.parameters ? JSON.stringify(tool.parameters) : ""
+		].join("\n");
+		return measure(`tool:${tool.server ?? "built-in"}:${tool.name}`, tool.name, serialized, tool.server);
+	});
+}
+function withPercent(items, total) {
+	for (const item of items) item.percent = total > 0 ? item.tokens / total * 100 : 0;
+	return items;
+}
+function sumTokens(groups) {
+	return groups.reduce((sum, entry) => sum + entry.tokens, 0);
+}
+/**
+* Build a context audit from already-collected context.
+*
+* Percentages are shares of the audited total, not of the model's context
+* window: window size is not exposed by the model registry, and inventing one
+* would make every number wrong for models that disagree with the guess.
+*/
+function buildContextAudit(input) {
+	const startupGroups = [
+		group("system-prompt", "System prompt", sectionEntries(input.promptSections ?? [], "prompt")),
+		group("dynamic-instructions", "Dynamic instructions", sectionEntries(input.instructionSections ?? [], "dynamic")),
+		group("skills", "Skills catalog", input.skillsCatalog ? [measure("skills:catalog", "Available skills", input.skillsCatalog)] : [], "Skill instructions are loaded on demand and are not counted here."),
+		group("tools", "Tool definitions", toolEntries(input.tools ?? []))
+	].filter((entry) => entry !== void 0);
+	const observationEntries = [];
+	if (typeof input.injectedObservations === "string") observationEntries.push(measure("observations:injected", "Injected into context", input.injectedObservations));
+	else if (input.injectedObservations && input.injectedObservations.tokens > 0) observationEntries.push({
+		id: "observations:injected",
+		label: "Injected into context",
+		tokens: input.injectedObservations.tokens,
+		characters: 0,
+		percent: 0
+	});
+	const startupTokens = sumTokens(startupGroups);
+	const injectedObservationTokens = observationEntries.reduce((sum, entry) => sum + entry.tokens, 0);
+	const promptTokens = input.conversation?.promptTokens ?? 0;
+	const conversationTokens = Math.max(0, promptTokens - startupTokens - injectedObservationTokens);
+	const accumulatedGroups = [group("conversation", "Conversation", promptTokens > 0 ? [{
+		id: "conversation:messages",
+		label: "Messages, tool calls and results",
+		tokens: conversationTokens,
+		characters: 0,
+		percent: 0
+	}] : [], `Derived from the provider's last request (~${promptTokens} prompt tokens) minus the startup context measured above.`), group("observations", "Observation memory", observationEntries, "Observations kept only in storage are not counted: they cost nothing until recalled.")].filter((entry) => entry !== void 0);
+	const accumulatedTokens = sumTokens(accumulatedGroups);
+	const totalTokens = startupTokens + accumulatedTokens;
+	for (const entry of [...startupGroups, ...accumulatedGroups]) withPercent(entry.entries, totalTokens);
+	withPercent(startupGroups, totalTokens);
+	withPercent(accumulatedGroups, totalTokens);
+	return {
+		startup: {
+			tokens: startupTokens,
+			percent: totalTokens > 0 ? startupTokens / totalTokens * 100 : 0,
+			groups: startupGroups
+		},
+		accumulated: {
+			tokens: accumulatedTokens,
+			percent: totalTokens > 0 ? accumulatedTokens / totalTokens * 100 : 0,
+			groups: accumulatedGroups
+		},
+		totalTokens,
+		estimated: true
+	};
+}
+//#endregion
+export { buildContextAudit };
+
+//# sourceMappingURL=context-audit.js.map

package/dist/agents/context-audit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-audit.js","names":[],"sources":["../../src/agents/context-audit.ts"],"sourcesContent":["/**\n * Context audit — accounts for what occupies the model's context window.\n *\n * Deliberately pure: callers collect the real strings (prompt sections, the\n * injected skills catalog, tool definitions) and this module only measures and\n * groups them. That keeps the audit honest — it reports on the same text the\n * model receives rather than a description of it — and keeps it testable\n * without a live session.\n *\n * Nothing here reads file contents or secrets: entries carry labels, origins\n * and sizes only, never the underlying text, so an audit can be shown or\n * pasted without leaking whatever the context happens to contain.\n */\nimport { tokenEstimate } from '../utils/token-estimator.js';\nimport type { PromptSection } from './prompts/index.js';\n\n/** A single measured contributor to the context window. */\nexport interface ContextAuditEntry {\n  id: string;\n  label: string;\n  /** Provenance: file path, server name, model id — whatever identifies the source. */\n  detail?: string;\n  tokens: number;\n  characters: number;\n  /** Share of the audit total, 0-100. */\n  percent: number;\n}\n\n/** A category of contributors (e.g. all agent instruction files). */\nexport interface ContextAuditGroup {\n  id: string;\n  label: string;\n  tokens: number;\n  /** Share of the audit total, 0-100. */\n  percent: number;\n  entries: ContextAuditEntry[];\n  /** Shown alongside the group when its numbers need qualifying. */\n  note?: string;\n}\n\nexport interface ContextAudit {\n  /** Context present before the first message: system prompt, skills, tools. */\n  startup: { tokens: number; percent: number; groups: ContextAuditGroup[] };\n  /** Context accumulated by the session: conversation and observation memory. */\n  accumulated: { tokens: number; percent: number; groups: ContextAuditGroup[] };\n  /** Startup + accumulated. Percentages elsewhere are shares of this. */\n  totalTokens: number;\n  /** Estimated rather than measured: token counts come from a heuristic estimator. */\n  estimated: true;\n}\n\n/** A tool definition as advertised to the model. */\nexport interface ContextAuditTool {\n  name: string;\n  description?: string;\n  /** JSON schema (or any serializable shape) sent with the definition. */\n  parameters?: unknown;\n  /** MCP server that provides the tool, when it is not built in. */\n  server?: string;\n}\n\nexport interface ContextAuditInput {\n  /** Labeled sections of the assembled system prompt. */\n  promptSections?: PromptSection[];\n  /** Labeled sections of the per-request dynamic instructions. */\n  instructionSections?: PromptSection[];\n  /** The skills catalog exactly as injected into the system message. */\n  skillsCatalog?: string;\n  /** Tool definitions advertised to the model. */\n  tools?: ContextAuditTool[];\n  /**\n   * Observation memory currently occupying the context window, either as the\n   * injected text or as a token count reported by the memory subsystem.\n   *\n   * Only observations that are actually in the context belong here.\n   * Observations that merely sit in storage cost nothing until recalled, and\n   * conflating the two is exactly the confusion this audit exists to resolve.\n   */\n  injectedObservations?: string | { tokens: number };\n  /** Prompt tokens the provider reported for the most recent request. */\n  conversation?: { promptTokens?: number };\n}\n\nfunction measure(id: string, label: string, content: string, detail?: string): ContextAuditEntry {\n  return { id, label, detail, tokens: tokenEstimate(content), characters: content.length, percent: 0 };\n}\n\nfunction sectionEntries(sections: PromptSection[], prefix: string): ContextAuditEntry[] {\n  return sections\n    .filter(section => section.content.length > 0)\n    .map(section => measure(`${prefix}:${section.id}`, section.label, section.content, section.detail));\n}\n\nfunction group(id: string, label: string, entries: ContextAuditEntry[], note?: string): ContextAuditGroup | undefined {\n  if (entries.length === 0) return undefined;\n  return { id, label, tokens: entries.reduce((sum, entry) => sum + entry.tokens, 0), percent: 0, entries, note };\n}\n\n/**\n * Group tool definitions by their provider so a chatty MCP server is visible as\n * one line rather than fifty. Per-tool entries stay available underneath.\n */\nfunction toolEntries(tools: ContextAuditTool[]): ContextAuditEntry[] {\n  return tools.map(tool => {\n    // Approximates the serialized definition: name, description and schema are\n    // what a provider sends, and the exact wire framing is provider-specific.\n    const serialized = [tool.name, tool.description ?? '', tool.parameters ? JSON.stringify(tool.parameters) : ''].join(\n      '\\n',\n    );\n    return measure(`tool:${tool.server ?? 'built-in'}:${tool.name}`, tool.name, serialized, tool.server);\n  });\n}\n\nfunction withPercent<T extends { tokens: number; percent: number }>(items: T[], total: number): T[] {\n  for (const item of items) {\n    item.percent = total > 0 ? (item.tokens / total) * 100 : 0;\n  }\n  return items;\n}\n\nfunction sumTokens(groups: ContextAuditGroup[]): number {\n  return groups.reduce((sum, entry) => sum + entry.tokens, 0);\n}\n\n/**\n * Build a context audit from already-collected context.\n *\n * Percentages are shares of the audited total, not of the model's context\n * window: window size is not exposed by the model registry, and inventing one\n * would make every number wrong for models that disagree with the guess.\n */\nexport function buildContextAudit(input: ContextAuditInput): ContextAudit {\n  const startupGroups = [\n    group('system-prompt', 'System prompt', sectionEntries(input.promptSections ?? [], 'prompt')),\n    group('dynamic-instructions', 'Dynamic instructions', sectionEntries(input.instructionSections ?? [], 'dynamic')),\n    group(\n      'skills',\n      'Skills catalog',\n      input.skillsCatalog ? [measure('skills:catalog', 'Available skills', input.skillsCatalog)] : [],\n      'Skill instructions are loaded on demand and are not counted here.',\n    ),\n    group('tools', 'Tool definitions', toolEntries(input.tools ?? [])),\n  ].filter((entry): entry is ContextAuditGroup => entry !== undefined);\n\n  const observationEntries: ContextAuditEntry[] = [];\n  if (typeof input.injectedObservations === 'string') {\n    observationEntries.push(measure('observations:injected', 'Injected into context', input.injectedObservations));\n  } else if (input.injectedObservations && input.injectedObservations.tokens > 0) {\n    observationEntries.push({\n      id: 'observations:injected',\n      label: 'Injected into context',\n      tokens: input.injectedObservations.tokens,\n      characters: 0,\n      percent: 0,\n    });\n  }\n\n  const startupTokens = sumTokens(startupGroups);\n  const injectedObservationTokens = observationEntries.reduce((sum, entry) => sum + entry.tokens, 0);\n\n  // The provider's prompt token count covers the whole request — startup\n  // context and injected observations included — so the conversation's own\n  // contribution is what is left after subtracting everything already\n  // accounted for. Using the raw prompt count would double-count all of it.\n  const promptTokens = input.conversation?.promptTokens ?? 0;\n  const conversationTokens = Math.max(0, promptTokens - startupTokens - injectedObservationTokens);\n  const conversationEntries: ContextAuditEntry[] =\n    promptTokens > 0\n      ? [\n          {\n            id: 'conversation:messages',\n            label: 'Messages, tool calls and results',\n            tokens: conversationTokens,\n            characters: 0,\n            percent: 0,\n          },\n        ]\n      : [];\n\n  const accumulatedGroups = [\n    group(\n      'conversation',\n      'Conversation',\n      conversationEntries,\n      `Derived from the provider's last request (~${promptTokens} prompt tokens) minus the startup context measured above.`,\n    ),\n    group(\n      'observations',\n      'Observation memory',\n      observationEntries,\n      'Observations kept only in storage are not counted: they cost nothing until recalled.',\n    ),\n  ].filter((entry): entry is ContextAuditGroup => entry !== undefined);\n\n  const accumulatedTokens = sumTokens(accumulatedGroups);\n  const totalTokens = startupTokens + accumulatedTokens;\n\n  for (const entry of [...startupGroups, ...accumulatedGroups]) {\n    withPercent(entry.entries, totalTokens);\n  }\n  withPercent(startupGroups, totalTokens);\n  withPercent(accumulatedGroups, totalTokens);\n\n  return {\n    startup: {\n      tokens: startupTokens,\n      percent: totalTokens > 0 ? (startupTokens / totalTokens) * 100 : 0,\n      groups: startupGroups,\n    },\n    accumulated: {\n      tokens: accumulatedTokens,\n      percent: totalTokens > 0 ? (accumulatedTokens / totalTokens) * 100 : 0,\n      groups: accumulatedGroups,\n    },\n    totalTokens,\n    estimated: true,\n  };\n}\n"],"mappings":"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"}

package/dist/agents/credential-resolver.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Per-tenant credential resolution seam for deployed (multi-user) servers.
+ *
+ * Locally, model resolution reads the server-global file-backed `AuthStorage`.
+ * A deployed web host registers a {@link CredentialStoreProvider} at boot; from
+ * then on `resolveModel` uses the host's trusted execution policy, never mutable
+ * session state. Factory scope reads organization credentials only. User scope reads
+ * the Factory session owner's credentials only, or the authenticated principal
+ * for project-less personal sessions.
+ *
+ * When no provider is registered (TUI, local web), everything falls through to
+ * the existing global behavior unchanged.
+ */
+import type { RequestContext } from '@mastra/core/request-context';
+import type { CredentialStore } from '../auth/types.js';
+export type CredentialScope = 'factory' | 'user';
+/** The identity and exclusive scope a credential lookup is resolved against. */
+export interface CredentialTenant {
+    /** Org tenant; absent for personal accounts (store impls may synthesize one). */
+    orgId?: string;
+    /** Stable user id used for user-scoped credentials and tenant cache keys. */
+    userId: string;
+    /** Exclusive credential scope for this request. */
+    credentialScope: CredentialScope;
+}
+/**
+ * Returns a tenant-scoped {@link CredentialStore}, or `undefined` when tenant
+ * storage is unavailable. Must be synchronous — implementations serve from a
+ * primed snapshot and do authoritative async work inside `getApiKey`.
+ */
+export type CredentialStoreProvider = (tenant: CredentialTenant) => CredentialStore | undefined;
+export type CredentialTenantResolver = (requestContext: RequestContext) => Promise<CredentialTenant | undefined>;
+/** Register (or clear) the tenant credential store provider. Deployed-web only. */
+export declare function setCredentialStoreProvider(provider: CredentialStoreProvider | undefined, resolveTenant?: CredentialTenantResolver): void;
+/** Refresh authority before a fresh model invocation; cloned contexts inherit only an opaque token. */
+export declare function prepareCredentialTenant(requestContext?: RequestContext): Promise<void>;
+export declare function withCredentialTenantPreparation<T>(resolve: (ctx: {
+    requestContext: RequestContext;
+}) => T): (ctx: {
+    requestContext: RequestContext;
+}) => Promise<T>;
+/**
+ * Whether a tenant provider is registered. Used to disable the
+ * `loadStoredApiKeysIntoEnv` side-channel in deployed mode — per-tenant
+ * credentials must never leak into process-global env vars.
+ */
+export declare function hasCredentialStoreProvider(): boolean;
+export declare function hasCredentialTenantResolver(): boolean;
+export declare function resolveCredentialScope(requestContext?: RequestContext): CredentialScope;
+/**
+ * Derive the calling tenant from a request context, if an authenticated web
+ * user was stashed on it. Mirrors the web layer's stable-id resolution
+ * (`workosId` falling back to the provider `id`).
+ *
+ * Session state and HTTP-supplied policy values never establish credential authority.
+ */
+export declare function resolveTenantFromRequestContext(requestContext?: RequestContext): CredentialTenant | undefined;
+/** Authenticated principal only, for hosts resolving durable session ownership. */
+export declare function resolveAuthenticatedCredentialTenant(requestContext?: RequestContext): CredentialTenant | undefined;
+/**
+ * Resolve the credential store for a request. Local mode returns `undefined`
+ * and keeps the global `AuthStorage` behavior. Once deployed web registers a
+ * provider, missing tenant identity or unavailable tenant storage fails closed
+ * through an empty store that also disables process-environment fallback.
+ */
+export declare function resolveCredentialStore(requestContext?: RequestContext): CredentialStore | undefined;
+//# sourceMappingURL=credential-resolver.d.ts.map

package/dist/agents/credential-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credential-resolver.d.ts","sourceRoot":"","sources":["../../src/agents/credential-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExD,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,MAAM,CAAC;AAEjD,gFAAgF;AAChF,MAAM,WAAW,gBAAgB;IAC/B,iFAAiF;IACjF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6EAA6E;IAC7E,MAAM,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,eAAe,EAAE,eAAe,CAAC;CAClC;AAED;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,MAAM,EAAE,gBAAgB,KAAK,eAAe,GAAG,SAAS,CAAC;AAEhG,MAAM,MAAM,wBAAwB,GAAG,CAAC,cAAc,EAAE,cAAc,KAAK,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAAC;AAqBjH,mFAAmF;AACnF,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,uBAAuB,GAAG,SAAS,EAC7C,aAAa,CAAC,EAAE,wBAAwB,GACvC,IAAI,CAIN;AAED,uGAAuG;AACvG,wBAAsB,uBAAuB,CAAC,cAAc,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAiB5F;AA0BD,wBAAgB,+BAA+B,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE;IAAE,cAAc,EAAE,cAAc,CAAA;CAAE,KAAK,CAAC,IAC1F,KAAK;IAAE,cAAc,EAAE,cAAc,CAAA;CAAE,KAAG,OAAO,CAAC,CAAC,CAAC,CAInE;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,IAAI,OAAO,CAEpD;AAED,wBAAgB,2BAA2B,IAAI,OAAO,CAErD;AAkBD,wBAAgB,sBAAsB,CAAC,cAAc,CAAC,EAAE,cAAc,GAAG,eAAe,CAEvF;AAED;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAAC,cAAc,CAAC,EAAE,cAAc,GAAG,gBAAgB,GAAG,SAAS,CAI7G;AAED,mFAAmF;AACnF,wBAAgB,oCAAoC,CAAC,cAAc,CAAC,EAAE,cAAc,GAAG,gBAAgB,GAAG,SAAS,CAclH;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,cAAc,CAAC,EAAE,cAAc,GAAG,eAAe,GAAG,SAAS,CAsBnG"}