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

package/dist/agent-connections/thread-state.js

@@ -0,0 +1,160 @@
+import { AGENT_CONNECTIONS_STATE_TYPE } from "./types.js";
+//#region src/agent-connections/thread-state.ts
+const AGENT_CONNECTIONS_REQUEST_CONTEXT_KEY = "mastracode.agentConnections";
+const stateWriteQueues = /* @__PURE__ */ new WeakMap();
+function isMemoryBacked(agent) {
+	return Boolean(agent?.threadId && agent?.resourceId);
+}
+function isThreadStateStore(value) {
+	return !!value && typeof value.getState === "function" && typeof value.setState === "function";
+}
+async function resolveAgentConnectionStore(context) {
+	const store = await context.mastra?.getStorage?.()?.getStore?.("threadState");
+	return isThreadStateStore(store) ? store : void 0;
+}
+function normalizeAgentConnectionsState(value) {
+	if (!value || typeof value !== "object") return { peers: [] };
+	const state = value;
+	return {
+		peers: Array.isArray(state.peers) ? normalizeConnectedPeers(state.peers) : [],
+		sentSignals: Array.isArray(state.sentSignals) ? normalizeSentAgentSignals(state.sentSignals) : []
+	};
+}
+function readString(value) {
+	return typeof value === "string" && value.length > 0 ? value : void 0;
+}
+function normalizeConnectedPeers(peers) {
+	const seen = /* @__PURE__ */ new Set();
+	const normalized = [];
+	for (const peer of peers) {
+		if (!peer || typeof peer !== "object") continue;
+		const candidate = peer;
+		if (!readString(candidate.id) || !readString(candidate.resourceId) || !readString(candidate.threadId)) continue;
+		if (candidate.agentId !== void 0 && typeof candidate.agentId !== "string") continue;
+		if (seen.has(candidate.id)) continue;
+		seen.add(candidate.id);
+		normalized.push({
+			id: candidate.id,
+			agentId: candidate.agentId,
+			resourceId: candidate.resourceId,
+			threadId: candidate.threadId,
+			label: readString(candidate.label),
+			title: readString(candidate.title),
+			mode: readString(candidate.mode),
+			pid: typeof candidate.pid === "number" ? candidate.pid : void 0,
+			connectedAt: typeof candidate.connectedAt === "number" ? candidate.connectedAt : Date.now(),
+			lastSeenAt: typeof candidate.lastSeenAt === "number" ? candidate.lastSeenAt : 0
+		});
+	}
+	return sortConnectedPeers(normalized);
+}
+function sortConnectedPeers(peers) {
+	return [...peers].sort((a, b) => a.id.localeCompare(b.id));
+}
+const agentSignalPriorities = /* @__PURE__ */ new Set([
+	"low",
+	"medium",
+	"high",
+	"urgent"
+]);
+const agentSignalRoutingActions = /* @__PURE__ */ new Set([
+	"wake",
+	"deliver",
+	"persist",
+	"discard",
+	"blocked"
+]);
+function normalizeSentAgentSignals(signals) {
+	return signals.flatMap((signal) => {
+		if (!signal || typeof signal !== "object") return [];
+		const candidate = signal;
+		const messageId = readString(candidate.messageId);
+		const fingerprint = readString(candidate.fingerprint);
+		const targetId = readString(candidate.targetId);
+		const returnPeerId = readString(candidate.returnPeerId);
+		if (!messageId || !fingerprint || !targetId || !agentSignalPriorities.has(candidate.priority) || typeof candidate.expectsReply !== "boolean" || !returnPeerId || !Number.isFinite(candidate.sentAt) || candidate.replyTo !== void 0 && !readString(candidate.replyTo) || candidate.routingAction !== void 0 && !agentSignalRoutingActions.has(candidate.routingAction) || candidate.runId !== void 0 && !readString(candidate.runId)) return [];
+		return [{
+			messageId,
+			fingerprint,
+			targetId,
+			priority: candidate.priority,
+			expectsReply: candidate.expectsReply,
+			...candidate.replyTo ? { replyTo: candidate.replyTo } : {},
+			returnPeerId,
+			...candidate.routingAction ? { routingAction: candidate.routingAction } : {},
+			...candidate.runId ? { runId: candidate.runId } : {},
+			sentAt: candidate.sentAt
+		}];
+	});
+}
+async function readAgentConnectionsState(context) {
+	const store = await resolveAgentConnectionStore(context);
+	const threadId = context.agent?.threadId;
+	if (!store || !threadId) return { peers: [] };
+	return normalizeAgentConnectionsState(await store.getState({
+		threadId,
+		type: AGENT_CONNECTIONS_STATE_TYPE
+	}));
+}
+async function readAgentConnections(context) {
+	return (await readAgentConnectionsState(context)).peers;
+}
+async function updateAgentConnections(context, update) {
+	const next = await updateAgentConnectionsState(context, (current) => ({
+		...current,
+		peers: sortConnectedPeers(update(current.peers))
+	}));
+	context.requestContext?.set(AGENT_CONNECTIONS_REQUEST_CONTEXT_KEY, next.peers);
+	return next.peers;
+}
+async function readSentAgentSignals(context) {
+	return (await readAgentConnectionsState(context)).sentSignals ?? [];
+}
+async function writeSentAgentSignals(context, sentSignals) {
+	await updateAgentConnectionsState(context, (current) => {
+		const byMessageId = new Map((current.sentSignals ?? []).map((signal) => [signal.messageId, signal]));
+		for (const signal of sentSignals) byMessageId.set(signal.messageId, signal);
+		return {
+			...current,
+			sentSignals: [...byMessageId.values()].sort((a, b) => a.sentAt - b.sentAt).slice(-100)
+		};
+	});
+}
+async function updateAgentConnectionsState(context, update) {
+	const store = await resolveAgentConnectionStore(context);
+	const threadId = context.agent?.threadId;
+	if (!store || !threadId) return update({ peers: [] });
+	const queueOwner = context.mastra ?? store;
+	let queues = stateWriteQueues.get(queueOwner);
+	if (!queues) {
+		queues = /* @__PURE__ */ new Map();
+		stateWriteQueues.set(queueOwner, queues);
+	}
+	const pending = (queues.get(threadId) ?? Promise.resolve()).catch(() => {}).then(async () => {
+		const next = update(normalizeAgentConnectionsState(await store.getState({
+			threadId,
+			type: AGENT_CONNECTIONS_STATE_TYPE
+		})));
+		await store.setState({
+			threadId,
+			type: AGENT_CONNECTIONS_STATE_TYPE,
+			value: next
+		});
+		return next;
+	});
+	const queued = pending.then(() => {}, () => {});
+	queues.set(threadId, queued);
+	try {
+		return await pending;
+	} finally {
+		if (queues.get(threadId) === queued) queues.delete(threadId);
+	}
+}
+function getCarriedAgentConnections(requestContext) {
+	const value = requestContext?.get(AGENT_CONNECTIONS_REQUEST_CONTEXT_KEY);
+	return Array.isArray(value) ? normalizeConnectedPeers(value) : void 0;
+}
+//#endregion
+export { AGENT_CONNECTIONS_REQUEST_CONTEXT_KEY, getCarriedAgentConnections, isMemoryBacked, isThreadStateStore, normalizeAgentConnectionsState, normalizeConnectedPeers, normalizeSentAgentSignals, readAgentConnections, readSentAgentSignals, resolveAgentConnectionStore, sortConnectedPeers, updateAgentConnections, writeSentAgentSignals };
+
+//# sourceMappingURL=thread-state.js.map

package/dist/agent-connections/thread-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-state.js","names":[],"sources":["../../src/agent-connections/thread-state.ts"],"sourcesContent":["import type { RequestContext } from '@mastra/core/request-context';\n\nimport {\n  AGENT_CONNECTIONS_STATE_TYPE,\n  type AgentConnectionsState,\n  type AgentSignalPriority,\n  type AgentSignalRoutingAction,\n  type ConnectedAgentPeer,\n  type SentAgentSignal,\n} from './types.js';\n\nexport const AGENT_CONNECTIONS_REQUEST_CONTEXT_KEY = 'mastracode.agentConnections';\n\nconst stateWriteQueues = new WeakMap<object, Map<string, Promise<void>>>();\n\nexport type ResolvedAgentConnectionStore = {\n  getState<T = unknown>(args: { threadId: string; type: string }): Promise<T | undefined>;\n  setState<T = unknown>(args: { threadId: string; type: string; value: T }): Promise<void>;\n};\n\nexport interface AgentConnectionContext {\n  agent?: { threadId?: string; resourceId?: string; agentId?: string };\n  requestContext?: RequestContext;\n  mastra?: { getStorage?: () => any };\n  runtimeAgent?: { discoverThreadPeers?: (...args: any[]) => Promise<unknown> };\n}\n\nexport function isMemoryBacked(agent: AgentConnectionContext['agent']): boolean {\n  return Boolean(agent?.threadId && agent?.resourceId);\n}\n\nexport function isThreadStateStore(value: unknown): value is ResolvedAgentConnectionStore {\n  return (\n    !!value &&\n    typeof (value as ResolvedAgentConnectionStore).getState === 'function' &&\n    typeof (value as ResolvedAgentConnectionStore).setState === 'function'\n  );\n}\n\nexport async function resolveAgentConnectionStore(\n  context: AgentConnectionContext,\n): Promise<ResolvedAgentConnectionStore | undefined> {\n  const store = await context.mastra?.getStorage?.()?.getStore?.('threadState');\n  return isThreadStateStore(store) ? store : undefined;\n}\n\nexport function normalizeAgentConnectionsState(value: unknown): AgentConnectionsState {\n  if (!value || typeof value !== 'object') return { peers: [] };\n  const state = value as { peers?: unknown; sentSignals?: unknown };\n  return {\n    peers: Array.isArray(state.peers) ? normalizeConnectedPeers(state.peers) : [],\n    sentSignals: Array.isArray(state.sentSignals) ? normalizeSentAgentSignals(state.sentSignals) : [],\n  };\n}\n\nfunction readString(value: unknown): string | undefined {\n  return typeof value === 'string' && value.length > 0 ? value : undefined;\n}\n\nexport function normalizeConnectedPeers(peers: unknown[]): ConnectedAgentPeer[] {\n  const seen = new Set<string>();\n  const normalized: ConnectedAgentPeer[] = [];\n  for (const peer of peers) {\n    if (!peer || typeof peer !== 'object') continue;\n    const candidate = peer as Partial<ConnectedAgentPeer>;\n    if (!readString(candidate.id) || !readString(candidate.resourceId) || !readString(candidate.threadId)) continue;\n    if (candidate.agentId !== undefined && typeof candidate.agentId !== 'string') continue;\n    if (seen.has(candidate.id as string)) continue;\n    seen.add(candidate.id as string);\n    normalized.push({\n      id: candidate.id as string,\n      agentId: candidate.agentId,\n      resourceId: candidate.resourceId as string,\n      threadId: candidate.threadId as string,\n      label: readString(candidate.label),\n      title: readString(candidate.title),\n      mode: readString(candidate.mode),\n      pid: typeof candidate.pid === 'number' ? candidate.pid : undefined,\n      connectedAt: typeof candidate.connectedAt === 'number' ? candidate.connectedAt : Date.now(),\n      lastSeenAt: typeof candidate.lastSeenAt === 'number' ? candidate.lastSeenAt : 0,\n    });\n  }\n  return sortConnectedPeers(normalized);\n}\n\nexport function sortConnectedPeers(peers: ConnectedAgentPeer[]): ConnectedAgentPeer[] {\n  return [...peers].sort((a, b) => a.id.localeCompare(b.id));\n}\n\nconst agentSignalPriorities = new Set<AgentSignalPriority>(['low', 'medium', 'high', 'urgent']);\nconst agentSignalRoutingActions = new Set<AgentSignalRoutingAction>([\n  'wake',\n  'deliver',\n  'persist',\n  'discard',\n  'blocked',\n]);\n\nexport function normalizeSentAgentSignals(signals: unknown[]): SentAgentSignal[] {\n  return signals.flatMap(signal => {\n    if (!signal || typeof signal !== 'object') return [];\n    const candidate = signal as Partial<SentAgentSignal>;\n    const messageId = readString(candidate.messageId);\n    const fingerprint = readString(candidate.fingerprint);\n    const targetId = readString(candidate.targetId);\n    const returnPeerId = readString(candidate.returnPeerId);\n    if (\n      !messageId ||\n      !fingerprint ||\n      !targetId ||\n      !agentSignalPriorities.has(candidate.priority as AgentSignalPriority) ||\n      typeof candidate.expectsReply !== 'boolean' ||\n      !returnPeerId ||\n      !Number.isFinite(candidate.sentAt) ||\n      (candidate.replyTo !== undefined && !readString(candidate.replyTo)) ||\n      (candidate.routingAction !== undefined &&\n        !agentSignalRoutingActions.has(candidate.routingAction as AgentSignalRoutingAction)) ||\n      (candidate.runId !== undefined && !readString(candidate.runId))\n    ) {\n      return [];\n    }\n    return [\n      {\n        messageId,\n        fingerprint,\n        targetId,\n        priority: candidate.priority as AgentSignalPriority,\n        expectsReply: candidate.expectsReply,\n        ...(candidate.replyTo ? { replyTo: candidate.replyTo } : {}),\n        returnPeerId,\n        ...(candidate.routingAction ? { routingAction: candidate.routingAction } : {}),\n        ...(candidate.runId ? { runId: candidate.runId } : {}),\n        sentAt: candidate.sentAt as number,\n      },\n    ];\n  });\n}\n\nasync function readAgentConnectionsState(context: AgentConnectionContext): Promise<AgentConnectionsState> {\n  const store = await resolveAgentConnectionStore(context);\n  const threadId = context.agent?.threadId;\n  if (!store || !threadId) return { peers: [] };\n  const state = await store.getState<AgentConnectionsState>({ threadId, type: AGENT_CONNECTIONS_STATE_TYPE });\n  return normalizeAgentConnectionsState(state);\n}\n\nexport async function readAgentConnections(context: AgentConnectionContext): Promise<ConnectedAgentPeer[]> {\n  return (await readAgentConnectionsState(context)).peers;\n}\n\nexport async function updateAgentConnections(\n  context: AgentConnectionContext,\n  update: (current: ConnectedAgentPeer[]) => ConnectedAgentPeer[],\n): Promise<ConnectedAgentPeer[]> {\n  const next = await updateAgentConnectionsState(context, current => ({\n    ...current,\n    peers: sortConnectedPeers(update(current.peers)),\n  }));\n  context.requestContext?.set(AGENT_CONNECTIONS_REQUEST_CONTEXT_KEY, next.peers);\n  return next.peers;\n}\n\nexport async function readSentAgentSignals(context: AgentConnectionContext): Promise<SentAgentSignal[]> {\n  return (await readAgentConnectionsState(context)).sentSignals ?? [];\n}\n\nexport async function writeSentAgentSignals(\n  context: AgentConnectionContext,\n  sentSignals: SentAgentSignal[],\n): Promise<void> {\n  await updateAgentConnectionsState(context, current => {\n    const byMessageId = new Map((current.sentSignals ?? []).map(signal => [signal.messageId, signal]));\n    for (const signal of sentSignals) byMessageId.set(signal.messageId, signal);\n    return {\n      ...current,\n      sentSignals: [...byMessageId.values()].sort((a, b) => a.sentAt - b.sentAt).slice(-100),\n    };\n  });\n}\n\nasync function updateAgentConnectionsState(\n  context: AgentConnectionContext,\n  update: (current: AgentConnectionsState) => AgentConnectionsState,\n): Promise<AgentConnectionsState> {\n  const store = await resolveAgentConnectionStore(context);\n  const threadId = context.agent?.threadId;\n  if (!store || !threadId) return update({ peers: [] });\n\n  const queueOwner = context.mastra ?? store;\n  let queues = stateWriteQueues.get(queueOwner);\n  if (!queues) {\n    queues = new Map();\n    stateWriteQueues.set(queueOwner, queues);\n  }\n  const previous = queues.get(threadId) ?? Promise.resolve();\n  const pending = previous\n    .catch(() => {})\n    .then(async () => {\n      const state = await store.getState<AgentConnectionsState>({ threadId, type: AGENT_CONNECTIONS_STATE_TYPE });\n      const next = update(normalizeAgentConnectionsState(state));\n      await store.setState({\n        threadId,\n        type: AGENT_CONNECTIONS_STATE_TYPE,\n        value: next,\n      });\n      return next;\n    });\n  const queued = pending.then(\n    () => {},\n    () => {},\n  );\n  queues.set(threadId, queued);\n  try {\n    return await pending;\n  } finally {\n    if (queues.get(threadId) === queued) queues.delete(threadId);\n  }\n}\n\nexport function getCarriedAgentConnections(\n  requestContext: RequestContext | undefined,\n): ConnectedAgentPeer[] | undefined {\n  const value = requestContext?.get(AGENT_CONNECTIONS_REQUEST_CONTEXT_KEY);\n  return Array.isArray(value) ? normalizeConnectedPeers(value) : undefined;\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,133 @@
+import { AgentConnectionRegistry } from './registry.js';
+export interface AgentConnectionToolsOptions {
+    registry?: AgentConnectionRegistry;
+    getAgent?: () => {
+        sendNotificationSignal?: (...args: any[]) => Promise<unknown>;
+        discoverThreadPeers?: (...args: any[]) => Promise<unknown>;
+    } | undefined;
+}
+export declare function createAgentConnectionTools(options?: AgentConnectionToolsOptions): {
+    agent_connections_list: import("@mastra/core/tools").Tool<Record<string, never>, {
+        content: string;
+        peers: {
+            id: string;
+            agentId: string;
+            resourceId: string;
+            threadId: string;
+            relationship: "none" | "saved";
+            presence: "advertised" | "absent";
+            displayStatus: "saved" | "discovered" | "connected";
+            canAttemptSend: boolean;
+            label?: string | undefined;
+            title?: string | undefined;
+            mode?: string | undefined;
+            pid?: number | undefined;
+            connectedAt?: number | undefined;
+            lastSeenAt?: number | undefined;
+        }[];
+        savedCount: number;
+        isError?: boolean | undefined;
+    }, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "agent_connections_list", unknown>;
+    agent_connect: import("@mastra/core/tools").Tool<{
+        ids: string[];
+    }, {
+        content: string;
+        connected: {
+            id: string;
+            resourceId: string;
+            threadId: string;
+            connectedAt: number;
+            lastSeenAt: number;
+            agentId?: string | undefined;
+            label?: string | undefined;
+            title?: string | undefined;
+            mode?: string | undefined;
+            pid?: number | undefined;
+        }[];
+        changed: {
+            op: string;
+            id: string;
+            peer?: {
+                id: string;
+                agentId: string;
+                resourceId: string;
+                threadId: string;
+                relationship: "none" | "saved";
+                presence: "advertised" | "absent";
+                displayStatus: "saved" | "discovered" | "connected";
+                canAttemptSend: boolean;
+                label?: string | undefined;
+                title?: string | undefined;
+                mode?: string | undefined;
+                pid?: number | undefined;
+                connectedAt?: number | undefined;
+                lastSeenAt?: number | undefined;
+            } | undefined;
+            presence?: string | undefined;
+            displayStatus?: string | undefined;
+        }[];
+        isError?: boolean | undefined;
+    }, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "agent_connect", unknown>;
+    agent_disconnect: import("@mastra/core/tools").Tool<{
+        ids: string[];
+    }, {
+        content: string;
+        connected: {
+            id: string;
+            resourceId: string;
+            threadId: string;
+            connectedAt: number;
+            lastSeenAt: number;
+            agentId?: string | undefined;
+            label?: string | undefined;
+            title?: string | undefined;
+            mode?: string | undefined;
+            pid?: number | undefined;
+        }[];
+        disconnectedIds: string[];
+        alreadyDisconnectedIds: string[];
+        changed: {
+            op: string;
+            id: string;
+        }[];
+        isError?: boolean | undefined;
+    }, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "agent_disconnect", unknown>;
+    agent_signal_send: import("@mastra/core/tools").Tool<{
+        targetId: string;
+        message: string;
+        priority: "low" | "medium" | "high" | "urgent";
+        expectsReply: boolean;
+        messageId?: string | undefined;
+        replyTo?: string | undefined;
+    }, {
+        content: string;
+        target?: {
+            id: string;
+            agentId: string;
+            resourceId: string;
+            threadId: string;
+            relationship: "none" | "saved";
+            presence: "advertised" | "absent";
+            displayStatus: "saved" | "discovered" | "connected";
+            canAttemptSend: boolean;
+            label?: string | undefined;
+            title?: string | undefined;
+            mode?: string | undefined;
+            pid?: number | undefined;
+            connectedAt?: number | undefined;
+            lastSeenAt?: number | undefined;
+        } | undefined;
+        priority?: "low" | "medium" | "high" | "urgent" | undefined;
+        expectsReply?: boolean | undefined;
+        messageId?: string | undefined;
+        replyTo?: string | undefined;
+        returnPeerId?: string | undefined;
+        routingAction?: "wake" | "deliver" | "persist" | "discard" | "blocked" | undefined;
+        replyOutcome?: "peer-unavailable" | undefined;
+        runId?: string | undefined;
+        notification?: unknown;
+        duplicate?: boolean | undefined;
+        isError?: boolean | undefined;
+    }, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "agent_signal_send", unknown>;
+};
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/agent-connections/tools.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,uBAAuB,EAAgB,MAAM,eAAe,CAAC;AA8GtE,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,EAAE,uBAAuB,CAAC;IACnC,QAAQ,CAAC,EAAE,MACP;QACE,sBAAsB,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;QAC9D,mBAAmB,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;KAC5D,GACD,SAAS,CAAC;CACf;AAED,wBAAgB,0BAA0B,CAAC,OAAO,GAAE,2BAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwanF"}