@aigne/agent-runtime 1.12.0-beta.5

package/dist/program/agent-messages-tools.cjs

@@ -0,0 +1,137 @@
+let ufo = require("ufo");
+let _aigne_afs = require("@aigne/afs");
+let _aigne_uuid = require("@aigne/uuid");
+
+//#region src/program/agent-messages-tools.ts
+/** Host-owned runtime messaging namespace. */
+const MESSAGING_ROOT = "/proc/messaging";
+/** Tool catalog mount path surfaced to agent runners. */
+const MESSAGING_TOOLS_ROOT = `${MESSAGING_ROOT}/tools`;
+/** Tool glob injected into agent scopes. */
+const MESSAGING_TOOLS_GLOB = `${MESSAGING_TOOLS_ROOT}/*`;
+/** Durable mailbox storage keyed by logical agent/blocklet id. */
+const MESSAGING_AGENTS_ROOT = `${MESSAGING_ROOT}/agents`;
+/** @deprecated use `MESSAGING_AGENTS_ROOT`. */
+const AGENTS_ROOT = MESSAGING_AGENTS_ROOT;
+const MAX_BODY_BYTES = 64 * 1024;
+function getMessagingToolDefinitions() {
+	return [{
+		type: "function",
+		function: {
+			name: "agent_post_message",
+			description: "Send an async message to another agent. Writes one JSON file per message to /proc/messaging/agents/<to>/msg/ via AFS; the recipient receives an afs:write event and wakes up without polling.",
+			parameters: {
+				type: "object",
+				properties: {
+					to: {
+						type: "string",
+						description: "Recipient agent blocklet ID"
+					},
+					body: { description: "Message body (string or JSON, max 64KB serialized)" },
+					kind: {
+						type: "string",
+						description: "Message kind (default: \"message\")"
+					}
+				},
+				required: ["to", "body"]
+			}
+		}
+	}, {
+		type: "function",
+		function: {
+			name: "agent_read_messages",
+			description: "Read messages from this agent's own /proc/messaging/agents/<self>/msg/ directory. Returns every message file parsed.",
+			parameters: {
+				type: "object",
+				properties: {},
+				required: []
+			}
+		}
+	}];
+}
+function invalidRecipient(to) {
+	if (typeof to !== "string" || to.length === 0) return "recipient must be a non-empty string";
+	if (to.includes("..") || to.includes("/") || to.includes("\\")) return "recipient must not contain path separators";
+	if (to.includes("\0")) return "recipient must not contain null bytes";
+	return null;
+}
+/** AFS directory that holds one agent's inbound messages. */
+function agentMsgDir(blockletId) {
+	return (0, ufo.joinURL)(MESSAGING_AGENTS_ROOT, blockletId, "msg");
+}
+async function handlePostMessage(ctx, args) {
+	const invalid = invalidRecipient(args.to);
+	if (invalid) return {
+		ok: false,
+		delivery: "failed",
+		error: {
+			code: "RECIPIENT_UNKNOWN",
+			message: invalid
+		}
+	};
+	if ((typeof args.body === "string" ? args.body : JSON.stringify(args.body)).length > MAX_BODY_BYTES) return {
+		ok: false,
+		delivery: "failed",
+		error: {
+			code: "PAYLOAD_TOO_LARGE",
+			message: "Message body exceeds 64KB limit"
+		}
+	};
+	if (!ctx.afs.write) return {
+		ok: false,
+		delivery: "failed",
+		error: {
+			code: "NO_WRITE",
+			message: "Host AFS does not expose a write method"
+		}
+	};
+	const messageId = (0, _aigne_uuid.v7)();
+	const entry = {
+		message_id: messageId,
+		from: ctx.blockletId,
+		to: args.to,
+		kind: args.kind ?? "message",
+		ts: (/* @__PURE__ */ new Date()).toISOString(),
+		body: args.body
+	};
+	const path = (0, ufo.joinURL)(agentMsgDir(args.to), `${messageId}.json`);
+	await ctx.afs.write(path, { content: JSON.stringify(entry) });
+	return {
+		ok: true,
+		delivery: "async",
+		message_id: messageId
+	};
+}
+async function handleReadMessages(ctx, _args) {
+	if (!ctx.afs.list || !ctx.afs.read) return [];
+	const dir = agentMsgDir(ctx.blockletId);
+	let listing;
+	try {
+		listing = await ctx.afs.list(dir);
+	} catch (err) {
+		if (err instanceof _aigne_afs.AFSNotFoundError) return [];
+		const message = err instanceof Error ? err.message : String(err);
+		if (/not found/i.test(message)) return [];
+		throw err;
+	}
+	const messages = [];
+	for (const entry of listing.data) {
+		const raw = (await ctx.afs.read(entry.path))?.data?.content;
+		if (raw == null) continue;
+		try {
+			messages.push(JSON.parse(String(raw)));
+		} catch {}
+	}
+	return messages;
+}
+
+//#endregion
+exports.AGENTS_ROOT = AGENTS_ROOT;
+exports.MESSAGING_AGENTS_ROOT = MESSAGING_AGENTS_ROOT;
+exports.MESSAGING_ROOT = MESSAGING_ROOT;
+exports.MESSAGING_TOOLS_GLOB = MESSAGING_TOOLS_GLOB;
+exports.MESSAGING_TOOLS_ROOT = MESSAGING_TOOLS_ROOT;
+exports.agentMsgDir = agentMsgDir;
+exports.getMessagingToolDefinitions = getMessagingToolDefinitions;
+exports.handlePostMessage = handlePostMessage;
+exports.handleReadMessages = handleReadMessages;

package/dist/program/agent-messages-tools.d.cts

@@ -0,0 +1,59 @@
+import { AFSRoot } from "@aigne/afs";
+
+//#region src/program/agent-messages-tools.d.ts
+/** Host-owned runtime messaging namespace. */
+declare const MESSAGING_ROOT = "/proc/messaging";
+/** Tool catalog mount path surfaced to agent runners. */
+declare const MESSAGING_TOOLS_ROOT = "/proc/messaging/tools";
+/** Tool glob injected into agent scopes. */
+declare const MESSAGING_TOOLS_GLOB = "/proc/messaging/tools/*";
+/** Durable mailbox storage keyed by logical agent/blocklet id. */
+declare const MESSAGING_AGENTS_ROOT = "/proc/messaging/agents";
+/** @deprecated use `MESSAGING_AGENTS_ROOT`. */
+declare const AGENTS_ROOT = "/proc/messaging/agents";
+interface MessagingContext {
+  /** Host AFS instance with write/list/read support. */
+  afs: AFSRoot;
+  /** Caller identity — becomes `from` on outbound messages and the recipient key for inbound reads. */
+  blockletId: string;
+}
+interface AgentMessage {
+  message_id: string;
+  from: string;
+  to: string;
+  kind: string;
+  ts: string;
+  body: unknown;
+}
+interface ToolDefinition {
+  type: "function";
+  function: {
+    name: string;
+    description: string;
+    parameters: {
+      type: "object";
+      properties: Record<string, Record<string, unknown>>;
+      required: string[];
+    };
+  };
+}
+declare function getMessagingToolDefinitions(): ToolDefinition[];
+/** AFS directory that holds one agent's inbound messages. */
+declare function agentMsgDir(blockletId: string): string;
+declare function handlePostMessage(ctx: MessagingContext, args: {
+  to: string;
+  body: unknown;
+  kind?: string;
+}): Promise<{
+  ok: boolean;
+  delivery: string;
+  message_id?: string;
+  error?: {
+    code: string;
+    message: string;
+  };
+}>;
+declare function handleReadMessages(ctx: MessagingContext, _args: Record<string, never>): Promise<AgentMessage[]>;
+//#endregion
+export { AGENTS_ROOT, AgentMessage, MESSAGING_AGENTS_ROOT, MESSAGING_ROOT, MESSAGING_TOOLS_GLOB, MESSAGING_TOOLS_ROOT, MessagingContext, ToolDefinition, agentMsgDir, getMessagingToolDefinitions, handlePostMessage, handleReadMessages };
+//# sourceMappingURL=agent-messages-tools.d.cts.map

package/dist/program/agent-messages-tools.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-messages-tools.d.cts","names":[],"sources":["../../src/program/agent-messages-tools.ts"],"mappings":";;;AA8BA;AAAA,cANa,cAAA;;cAEA,oBAAA;;cAEA,oBAAA;;cAEA,qBAAA;;cAEA,WAAA;AAAA,UAEI,gBAAA;EAAgB;EAE/B,GAAA,EAAK,OAAA;EAAO;EAEZ,UAAA;AAAA;AAAA,UAGe,YAAA;EACf,UAAA;EACA,IAAA;EACA,EAAA;EACA,IAAA;EACA,EAAA;EACA,IAAA;AAAA;AAAA,UAGe,cAAA;EACf,IAAA;EACA,QAAA;IACE,IAAA;IACA,WAAA;IACA,UAAA;MACE,IAAA;MACA,UAAA,EAAY,MAAA,SAAe,MAAA;MAC3B,QAAA;IAAA;EAAA;AAAA;AAAA,iBAOU,2BAAA,CAAA,GAA+B,cAAA;;iBA+C/B,WAAA,CAAY,UAAA;AAAA,iBAIN,iBAAA,CACpB,GAAA,EAAK,gBAAA,EACL,IAAA;EAAQ,EAAA;EAAY,IAAA;EAAe,IAAA;AAAA,IAClC,OAAA;EACD,EAAA;EACA,QAAA;EACA,UAAA;EACA,KAAA;IAAU,IAAA;IAAc,OAAA;EAAA;AAAA;AAAA,iBA2CJ,kBAAA,CACpB,GAAA,EAAK,gBAAA,EACL,KAAA,EAAO,MAAA,kBACN,OAAA,CAAQ,YAAA"}

package/dist/program/agent-messages-tools.d.mts

@@ -0,0 +1,59 @@
+import { AFSRoot } from "@aigne/afs";
+
+//#region src/program/agent-messages-tools.d.ts
+/** Host-owned runtime messaging namespace. */
+declare const MESSAGING_ROOT = "/proc/messaging";
+/** Tool catalog mount path surfaced to agent runners. */
+declare const MESSAGING_TOOLS_ROOT = "/proc/messaging/tools";
+/** Tool glob injected into agent scopes. */
+declare const MESSAGING_TOOLS_GLOB = "/proc/messaging/tools/*";
+/** Durable mailbox storage keyed by logical agent/blocklet id. */
+declare const MESSAGING_AGENTS_ROOT = "/proc/messaging/agents";
+/** @deprecated use `MESSAGING_AGENTS_ROOT`. */
+declare const AGENTS_ROOT = "/proc/messaging/agents";
+interface MessagingContext {
+  /** Host AFS instance with write/list/read support. */
+  afs: AFSRoot;
+  /** Caller identity — becomes `from` on outbound messages and the recipient key for inbound reads. */
+  blockletId: string;
+}
+interface AgentMessage {
+  message_id: string;
+  from: string;
+  to: string;
+  kind: string;
+  ts: string;
+  body: unknown;
+}
+interface ToolDefinition {
+  type: "function";
+  function: {
+    name: string;
+    description: string;
+    parameters: {
+      type: "object";
+      properties: Record<string, Record<string, unknown>>;
+      required: string[];
+    };
+  };
+}
+declare function getMessagingToolDefinitions(): ToolDefinition[];
+/** AFS directory that holds one agent's inbound messages. */
+declare function agentMsgDir(blockletId: string): string;
+declare function handlePostMessage(ctx: MessagingContext, args: {
+  to: string;
+  body: unknown;
+  kind?: string;
+}): Promise<{
+  ok: boolean;
+  delivery: string;
+  message_id?: string;
+  error?: {
+    code: string;
+    message: string;
+  };
+}>;
+declare function handleReadMessages(ctx: MessagingContext, _args: Record<string, never>): Promise<AgentMessage[]>;
+//#endregion
+export { AGENTS_ROOT, AgentMessage, MESSAGING_AGENTS_ROOT, MESSAGING_ROOT, MESSAGING_TOOLS_GLOB, MESSAGING_TOOLS_ROOT, MessagingContext, ToolDefinition, agentMsgDir, getMessagingToolDefinitions, handlePostMessage, handleReadMessages };
+//# sourceMappingURL=agent-messages-tools.d.mts.map

package/dist/program/agent-messages-tools.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-messages-tools.d.mts","names":[],"sources":["../../src/program/agent-messages-tools.ts"],"mappings":";;;AA8BA;AAAA,cANa,cAAA;;cAEA,oBAAA;;cAEA,oBAAA;;cAEA,qBAAA;;cAEA,WAAA;AAAA,UAEI,gBAAA;EAAgB;EAE/B,GAAA,EAAK,OAAA;EAAO;EAEZ,UAAA;AAAA;AAAA,UAGe,YAAA;EACf,UAAA;EACA,IAAA;EACA,EAAA;EACA,IAAA;EACA,EAAA;EACA,IAAA;AAAA;AAAA,UAGe,cAAA;EACf,IAAA;EACA,QAAA;IACE,IAAA;IACA,WAAA;IACA,UAAA;MACE,IAAA;MACA,UAAA,EAAY,MAAA,SAAe,MAAA;MAC3B,QAAA;IAAA;EAAA;AAAA;AAAA,iBAOU,2BAAA,CAAA,GAA+B,cAAA;;iBA+C/B,WAAA,CAAY,UAAA;AAAA,iBAIN,iBAAA,CACpB,GAAA,EAAK,gBAAA,EACL,IAAA;EAAQ,EAAA;EAAY,IAAA;EAAe,IAAA;AAAA,IAClC,OAAA;EACD,EAAA;EACA,QAAA;EACA,UAAA;EACA,KAAA;IAAU,IAAA;IAAc,OAAA;EAAA;AAAA;AAAA,iBA2CJ,kBAAA,CACpB,GAAA,EAAK,gBAAA,EACL,KAAA,EAAO,MAAA,kBACN,OAAA,CAAQ,YAAA"}

package/dist/program/agent-messages-tools.mjs

@@ -0,0 +1,130 @@
+import { joinURL } from "ufo";
+import { AFSNotFoundError } from "@aigne/afs";
+import { v7 } from "@aigne/uuid";
+
+//#region src/program/agent-messages-tools.ts
+/** Host-owned runtime messaging namespace. */
+const MESSAGING_ROOT = "/proc/messaging";
+/** Tool catalog mount path surfaced to agent runners. */
+const MESSAGING_TOOLS_ROOT = `${MESSAGING_ROOT}/tools`;
+/** Tool glob injected into agent scopes. */
+const MESSAGING_TOOLS_GLOB = `${MESSAGING_TOOLS_ROOT}/*`;
+/** Durable mailbox storage keyed by logical agent/blocklet id. */
+const MESSAGING_AGENTS_ROOT = `${MESSAGING_ROOT}/agents`;
+/** @deprecated use `MESSAGING_AGENTS_ROOT`. */
+const AGENTS_ROOT = MESSAGING_AGENTS_ROOT;
+const MAX_BODY_BYTES = 64 * 1024;
+function getMessagingToolDefinitions() {
+	return [{
+		type: "function",
+		function: {
+			name: "agent_post_message",
+			description: "Send an async message to another agent. Writes one JSON file per message to /proc/messaging/agents/<to>/msg/ via AFS; the recipient receives an afs:write event and wakes up without polling.",
+			parameters: {
+				type: "object",
+				properties: {
+					to: {
+						type: "string",
+						description: "Recipient agent blocklet ID"
+					},
+					body: { description: "Message body (string or JSON, max 64KB serialized)" },
+					kind: {
+						type: "string",
+						description: "Message kind (default: \"message\")"
+					}
+				},
+				required: ["to", "body"]
+			}
+		}
+	}, {
+		type: "function",
+		function: {
+			name: "agent_read_messages",
+			description: "Read messages from this agent's own /proc/messaging/agents/<self>/msg/ directory. Returns every message file parsed.",
+			parameters: {
+				type: "object",
+				properties: {},
+				required: []
+			}
+		}
+	}];
+}
+function invalidRecipient(to) {
+	if (typeof to !== "string" || to.length === 0) return "recipient must be a non-empty string";
+	if (to.includes("..") || to.includes("/") || to.includes("\\")) return "recipient must not contain path separators";
+	if (to.includes("\0")) return "recipient must not contain null bytes";
+	return null;
+}
+/** AFS directory that holds one agent's inbound messages. */
+function agentMsgDir(blockletId) {
+	return joinURL(MESSAGING_AGENTS_ROOT, blockletId, "msg");
+}
+async function handlePostMessage(ctx, args) {
+	const invalid = invalidRecipient(args.to);
+	if (invalid) return {
+		ok: false,
+		delivery: "failed",
+		error: {
+			code: "RECIPIENT_UNKNOWN",
+			message: invalid
+		}
+	};
+	if ((typeof args.body === "string" ? args.body : JSON.stringify(args.body)).length > MAX_BODY_BYTES) return {
+		ok: false,
+		delivery: "failed",
+		error: {
+			code: "PAYLOAD_TOO_LARGE",
+			message: "Message body exceeds 64KB limit"
+		}
+	};
+	if (!ctx.afs.write) return {
+		ok: false,
+		delivery: "failed",
+		error: {
+			code: "NO_WRITE",
+			message: "Host AFS does not expose a write method"
+		}
+	};
+	const messageId = v7();
+	const entry = {
+		message_id: messageId,
+		from: ctx.blockletId,
+		to: args.to,
+		kind: args.kind ?? "message",
+		ts: (/* @__PURE__ */ new Date()).toISOString(),
+		body: args.body
+	};
+	const path = joinURL(agentMsgDir(args.to), `${messageId}.json`);
+	await ctx.afs.write(path, { content: JSON.stringify(entry) });
+	return {
+		ok: true,
+		delivery: "async",
+		message_id: messageId
+	};
+}
+async function handleReadMessages(ctx, _args) {
+	if (!ctx.afs.list || !ctx.afs.read) return [];
+	const dir = agentMsgDir(ctx.blockletId);
+	let listing;
+	try {
+		listing = await ctx.afs.list(dir);
+	} catch (err) {
+		if (err instanceof AFSNotFoundError) return [];
+		const message = err instanceof Error ? err.message : String(err);
+		if (/not found/i.test(message)) return [];
+		throw err;
+	}
+	const messages = [];
+	for (const entry of listing.data) {
+		const raw = (await ctx.afs.read(entry.path))?.data?.content;
+		if (raw == null) continue;
+		try {
+			messages.push(JSON.parse(String(raw)));
+		} catch {}
+	}
+	return messages;
+}
+
+//#endregion
+export { AGENTS_ROOT, MESSAGING_AGENTS_ROOT, MESSAGING_ROOT, MESSAGING_TOOLS_GLOB, MESSAGING_TOOLS_ROOT, agentMsgDir, getMessagingToolDefinitions, handlePostMessage, handleReadMessages };
+//# sourceMappingURL=agent-messages-tools.mjs.map

package/dist/program/agent-messages-tools.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-messages-tools.mjs","names":[],"sources":["../../src/program/agent-messages-tools.ts"],"sourcesContent":["/**\n * Built-in messaging tools for inter-agent communication (S14, rewritten on AFS).\n *\n * Each post is a single JSON file under\n * `/proc/messaging/agents/<to>/msg/<uuid>.json` written\n * through `afs.write`. The write automatically dispatches an `afs:write` event\n * through the AFS EventBus (see packages/core/src/afs.ts:notifyChange), so a\n * receiver can subscribe with\n *   `{ type: \"afs:write\", path: \"/proc/messaging/agents/<self>/msg\" }`\n * and wake up on every new message without polling. Reading messages is\n * `afs.list` + `afs.read`; acking is `afs.delete` on the entry path.\n *\n * Path rationale: messaging is host-owned runtime state, not a blocklet root\n * namespace, so it lives under `/proc/messaging`. The transport remains\n * addressed by logical agent/blocklet id for now, which keeps the delivery\n * semantics unchanged while removing the root-level `/agents` leak.\n */\n\nimport type { AFSRoot } from \"@aigne/afs\";\nimport { AFSNotFoundError } from \"@aigne/afs\";\nimport { v7 } from \"@aigne/uuid\";\nimport { joinURL } from \"ufo\";\n\n/** Host-owned runtime messaging namespace. */\nexport const MESSAGING_ROOT = \"/proc/messaging\";\n/** Tool catalog mount path surfaced to agent runners. */\nexport const MESSAGING_TOOLS_ROOT = `${MESSAGING_ROOT}/tools`;\n/** Tool glob injected into agent scopes. */\nexport const MESSAGING_TOOLS_GLOB = `${MESSAGING_TOOLS_ROOT}/*`;\n/** Durable mailbox storage keyed by logical agent/blocklet id. */\nexport const MESSAGING_AGENTS_ROOT = `${MESSAGING_ROOT}/agents`;\n/** @deprecated use `MESSAGING_AGENTS_ROOT`. */\nexport const AGENTS_ROOT = MESSAGING_AGENTS_ROOT;\n\nexport interface MessagingContext {\n  /** Host AFS instance with write/list/read support. */\n  afs: AFSRoot;\n  /** Caller identity — becomes `from` on outbound messages and the recipient key for inbound reads. */\n  blockletId: string;\n}\n\nexport interface AgentMessage {\n  message_id: string;\n  from: string;\n  to: string;\n  kind: string;\n  ts: string;\n  body: unknown;\n}\n\nexport interface ToolDefinition {\n  type: \"function\";\n  function: {\n    name: string;\n    description: string;\n    parameters: {\n      type: \"object\";\n      properties: Record<string, Record<string, unknown>>;\n      required: string[];\n    };\n  };\n}\n\nconst MAX_BODY_BYTES = 64 * 1024;\n\nexport function getMessagingToolDefinitions(): ToolDefinition[] {\n  return [\n    {\n      type: \"function\",\n      function: {\n        name: \"agent_post_message\",\n        description:\n          \"Send an async message to another agent. Writes one JSON file per message to /proc/messaging/agents/<to>/msg/ via AFS; the recipient receives an afs:write event and wakes up without polling.\",\n        parameters: {\n          type: \"object\",\n          properties: {\n            to: { type: \"string\", description: \"Recipient agent blocklet ID\" },\n            body: { description: \"Message body (string or JSON, max 64KB serialized)\" },\n            kind: {\n              type: \"string\",\n              description: 'Message kind (default: \"message\")',\n            },\n          },\n          required: [\"to\", \"body\"],\n        },\n      },\n    },\n    {\n      type: \"function\",\n      function: {\n        name: \"agent_read_messages\",\n        description:\n          \"Read messages from this agent's own /proc/messaging/agents/<self>/msg/ directory. Returns every message file parsed.\",\n        parameters: {\n          type: \"object\",\n          properties: {},\n          required: [],\n        },\n      },\n    },\n  ];\n}\n\nfunction invalidRecipient(to: unknown): string | null {\n  if (typeof to !== \"string\" || to.length === 0) return \"recipient must be a non-empty string\";\n  if (to.includes(\"..\") || to.includes(\"/\") || to.includes(\"\\\\\"))\n    return \"recipient must not contain path separators\";\n  if (to.includes(\"\\0\")) return \"recipient must not contain null bytes\";\n  return null;\n}\n\n/** AFS directory that holds one agent's inbound messages. */\nexport function agentMsgDir(blockletId: string): string {\n  return joinURL(MESSAGING_AGENTS_ROOT, blockletId, \"msg\");\n}\n\nexport async function handlePostMessage(\n  ctx: MessagingContext,\n  args: { to: string; body: unknown; kind?: string },\n): Promise<{\n  ok: boolean;\n  delivery: string;\n  message_id?: string;\n  error?: { code: string; message: string };\n}> {\n  const invalid = invalidRecipient(args.to);\n  if (invalid) {\n    return {\n      ok: false,\n      delivery: \"failed\",\n      error: { code: \"RECIPIENT_UNKNOWN\", message: invalid },\n    };\n  }\n\n  const bodyStr = typeof args.body === \"string\" ? args.body : JSON.stringify(args.body);\n  if (bodyStr.length > MAX_BODY_BYTES) {\n    return {\n      ok: false,\n      delivery: \"failed\",\n      error: { code: \"PAYLOAD_TOO_LARGE\", message: \"Message body exceeds 64KB limit\" },\n    };\n  }\n\n  if (!ctx.afs.write) {\n    return {\n      ok: false,\n      delivery: \"failed\",\n      error: { code: \"NO_WRITE\", message: \"Host AFS does not expose a write method\" },\n    };\n  }\n\n  const messageId = v7();\n  const entry: AgentMessage = {\n    message_id: messageId,\n    from: ctx.blockletId,\n    to: args.to,\n    kind: args.kind ?? \"message\",\n    ts: new Date().toISOString(),\n    body: args.body,\n  };\n  const path = joinURL(agentMsgDir(args.to), `${messageId}.json`);\n  await ctx.afs.write(path, { content: JSON.stringify(entry) });\n\n  return { ok: true, delivery: \"async\", message_id: messageId };\n}\n\nexport async function handleReadMessages(\n  ctx: MessagingContext,\n  _args: Record<string, never>,\n): Promise<AgentMessage[]> {\n  if (!ctx.afs.list || !ctx.afs.read) return [];\n\n  const dir = agentMsgDir(ctx.blockletId);\n  let listing: Awaited<ReturnType<AFSRoot[\"list\"] & {}>>;\n  try {\n    listing = await ctx.afs.list(dir);\n  } catch (err) {\n    // An unwritten-to msg dir is \"empty\", not an error. `afs.list` wraps the\n    // underlying provider's AFSNotFoundError in a generic Error whose message\n    // still contains the original \"Path not found\" fragment (see afs.ts's\n    // _list wrapper). Match both shapes so callers don't have to pre-stat.\n    if (err instanceof AFSNotFoundError) return [];\n    const message = err instanceof Error ? err.message : String(err);\n    if (/not found/i.test(message)) return [];\n    throw err;\n  }\n\n  const messages: AgentMessage[] = [];\n  for (const entry of listing.data) {\n    const read = await ctx.afs.read(entry.path);\n    const raw = read?.data?.content;\n    if (raw == null) continue;\n    try {\n      messages.push(JSON.parse(String(raw)) as AgentMessage);\n    } catch {\n      // skip unreadable entries — a malformed file must not block the rest\n    }\n  }\n  return messages;\n}\n"],"mappings":"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"}