@aigne/agent-runtime 1.12.0-beta.5

package/dist/agent-runners/scratchpad-afs.d.cts

@@ -0,0 +1,103 @@
+import { AFSRoot } from "@aigne/afs";
+
+//#region src/agent-runners/scratchpad-afs.d.ts
+type ScratchRetention = "run" | "session" | "forever";
+interface AFSScratchLayout {
+  /** Base dir for this run — `/modules/memory/runs/<session>/subruns/<runId>` */
+  basePath: string;
+  stateYml: string;
+  messagesJsonl: string;
+  eventsJsonl: string;
+  historyJsonl: string;
+}
+/**
+ * @deprecated Phase 2 migrates scratch to the scope-local `/scratch/` mount.
+ * Kept only for the legacy read-path (old sessions) and removed in Phase 6.
+ */
+declare const MEMORY_SCRATCH_ROOT = "/modules/memory";
+/** Root path of the scope-local scratch mount created by `projectForChild`. */
+declare const SCRATCH_SCOPE_ROOT = "/scratch";
+/**
+ * @deprecated Use `createScratchProvider` + the scope-local `/scratch/` mount.
+ * Retained for the legacy read-path and removed in Phase 6.
+ */
+declare function computeScratchLayout(session: string, runId: string): AFSScratchLayout;
+/**
+ * @deprecated Use the scope-local `/scratch/` mount (`createScratchProvider`).
+ * Kept for backwards compatibility with pre-Phase-2 callers; removed in P6.
+ */
+declare function provisionScratchViaAFS(afs: AFSRoot, session: string, runId: string): Promise<AFSScratchLayout>;
+/**
+ * @deprecated Scope teardown will manage scratch lifetime once P5 lands.
+ * Phase 2 keeps this helper for callers still operating on legacy sessions.
+ */
+declare function teardownScratchViaAFS(afs: AFSRoot, session: string, retention?: ScratchRetention): Promise<void>;
+interface ScratchProviderOptions {
+  readonly session: string;
+  readonly runId?: string;
+  readonly retention?: ScratchRetention;
+}
+/**
+ * In-memory scratch provider. Each scope gets its own instance; files stay
+ * in memory for the life of the AFS instance (process). Retention shapes
+ * teardown behavior once P5 wires it up — P2 stores the flag but the
+ * provider itself is a Map.
+ *
+ * The provider intentionally does not reach back into any real filesystem
+ * or KV — keeping scratch per-scope and in-memory is what lets concurrent
+ * sub-runs not stomp each other, and what makes scope teardown a
+ * single-reference drop.
+ */
+interface ScratchProvider {
+  readonly session: string;
+  readonly runId?: string;
+  readonly retention: ScratchRetention;
+  read(path: string): Promise<{
+    data: {
+      content: string;
+      path: string;
+    };
+    path: string;
+  } | null>;
+  write(path: string, payload: {
+    content: string;
+  }): Promise<void>;
+  list(path: string): Promise<{
+    data: Array<{
+      name: string;
+      path: string;
+      type: "file" | "dir";
+      size: number;
+    }>;
+    list: Array<{
+      name: string;
+      path: string;
+      type: "file" | "dir";
+      size: number;
+    }>;
+  }>;
+  stat(path: string): Promise<{
+    data: {
+      path: string;
+      size: number;
+      type: "file" | "dir";
+    };
+  } | null>;
+  delete(path: string, options?: {
+    recursive?: boolean;
+  }): Promise<void>;
+  clear(): void;
+}
+declare function createScratchProvider(opts: ScratchProviderOptions): ScratchProvider;
+/**
+ * Overlay `/scratch/*` reads/writes/lists/stats/deletes onto the given AFS
+ * by routing them to the scratch provider. All other paths fall through to
+ * the underlying AFS via the prototype chain (Object.create).
+ *
+ * The overlay is stateless besides its reference to the provider — two
+ * scopes with different providers never see each other's scratch.
+ */
+declare function attachScratchMount<T extends AFSRoot>(afs: T, provider: ScratchProvider): T;
+//#endregion
+export { AFSScratchLayout, MEMORY_SCRATCH_ROOT, SCRATCH_SCOPE_ROOT, ScratchProvider, ScratchProviderOptions, ScratchRetention, attachScratchMount, computeScratchLayout, createScratchProvider, provisionScratchViaAFS, teardownScratchViaAFS };
+//# sourceMappingURL=scratchpad-afs.d.cts.map

package/dist/agent-runners/scratchpad-afs.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scratchpad-afs.d.cts","names":[],"sources":["../../src/agent-runners/scratchpad-afs.ts"],"mappings":";;;KAqBY,gBAAA;AAAA,UAEK,gBAAA;EAae;EAX9B,QAAA;EACA,QAAA;EACA,aAAA;EACA,WAAA;EACA,YAAA;AAAA;;;AAkDF;;cA3Ca,mBAAA;;cAGA,kBAAA;;;;;iBAwCG,oBAAA,CAAqB,OAAA,UAAiB,KAAA,WAAgB,gBAAA;;;;;iBAiBhD,sBAAA,CACpB,GAAA,EAAK,OAAA,EACL,OAAA,UACA,KAAA,WACC,OAAA,CAAQ,gBAAA;;;;;iBAgBW,qBAAA,CACpB,GAAA,EAAK,OAAA,EACL,OAAA,UACA,SAAA,GAAW,gBAAA,GACV,OAAA;AAAA,UAkBc,sBAAA;EAAA,SACN,OAAA;EAAA,SACA,KAAA;EAAA,SACA,SAAA,GAAY,gBAAA;AAAA;AAzBvB;;;;;;;;;;;AAAA,UAuCiB,eAAA;EAAA,SACN,OAAA;EAAA,SACA,KAAA;EAAA,SACA,SAAA,EAAW,gBAAA;EACpB,IAAA,CAAK,IAAA,WAAe,OAAA;IAAU,IAAA;MAAQ,OAAA;MAAiB,IAAA;IAAA;IAAgB,IAAA;EAAA;EACvE,KAAA,CAAM,IAAA,UAAc,OAAA;IAAW,OAAA;EAAA,IAAoB,OAAA;EACnD,IAAA,CAAK,IAAA,WAAe,OAAA;IAClB,IAAA,EAAM,KAAA;MAAQ,IAAA;MAAc,IAAA;MAAc,IAAA;MAAsB,IAAA;IAAA;IAChE,IAAA,EAAM,KAAA;MAAQ,IAAA;MAAc,IAAA;MAAc,IAAA;MAAsB,IAAA;IAAA;EAAA;EAElE,IAAA,CACE,IAAA,WACC,OAAA;IAAU,IAAA;MAAQ,IAAA;MAAc,IAAA;MAAc,IAAA;IAAA;EAAA;EACjD,MAAA,CAAO,IAAA,UAAc,OAAA;IAAY,SAAA;EAAA,IAAwB,OAAA;EACzD,KAAA;AAAA;AAAA,iBAiBc,qBAAA,CAAsB,IAAA,EAAM,sBAAA,GAAyB,eAAA;;;;;;;;;iBAgHrD,kBAAA,WAA6B,OAAA,CAAA,CAAS,GAAA,EAAK,CAAA,EAAG,QAAA,EAAU,eAAA,GAAkB,CAAA"}

package/dist/agent-runners/scratchpad-afs.d.mts

@@ -0,0 +1,103 @@
+import { AFSRoot } from "@aigne/afs";
+
+//#region src/agent-runners/scratchpad-afs.d.ts
+type ScratchRetention = "run" | "session" | "forever";
+interface AFSScratchLayout {
+  /** Base dir for this run — `/modules/memory/runs/<session>/subruns/<runId>` */
+  basePath: string;
+  stateYml: string;
+  messagesJsonl: string;
+  eventsJsonl: string;
+  historyJsonl: string;
+}
+/**
+ * @deprecated Phase 2 migrates scratch to the scope-local `/scratch/` mount.
+ * Kept only for the legacy read-path (old sessions) and removed in Phase 6.
+ */
+declare const MEMORY_SCRATCH_ROOT = "/modules/memory";
+/** Root path of the scope-local scratch mount created by `projectForChild`. */
+declare const SCRATCH_SCOPE_ROOT = "/scratch";
+/**
+ * @deprecated Use `createScratchProvider` + the scope-local `/scratch/` mount.
+ * Retained for the legacy read-path and removed in Phase 6.
+ */
+declare function computeScratchLayout(session: string, runId: string): AFSScratchLayout;
+/**
+ * @deprecated Use the scope-local `/scratch/` mount (`createScratchProvider`).
+ * Kept for backwards compatibility with pre-Phase-2 callers; removed in P6.
+ */
+declare function provisionScratchViaAFS(afs: AFSRoot, session: string, runId: string): Promise<AFSScratchLayout>;
+/**
+ * @deprecated Scope teardown will manage scratch lifetime once P5 lands.
+ * Phase 2 keeps this helper for callers still operating on legacy sessions.
+ */
+declare function teardownScratchViaAFS(afs: AFSRoot, session: string, retention?: ScratchRetention): Promise<void>;
+interface ScratchProviderOptions {
+  readonly session: string;
+  readonly runId?: string;
+  readonly retention?: ScratchRetention;
+}
+/**
+ * In-memory scratch provider. Each scope gets its own instance; files stay
+ * in memory for the life of the AFS instance (process). Retention shapes
+ * teardown behavior once P5 wires it up — P2 stores the flag but the
+ * provider itself is a Map.
+ *
+ * The provider intentionally does not reach back into any real filesystem
+ * or KV — keeping scratch per-scope and in-memory is what lets concurrent
+ * sub-runs not stomp each other, and what makes scope teardown a
+ * single-reference drop.
+ */
+interface ScratchProvider {
+  readonly session: string;
+  readonly runId?: string;
+  readonly retention: ScratchRetention;
+  read(path: string): Promise<{
+    data: {
+      content: string;
+      path: string;
+    };
+    path: string;
+  } | null>;
+  write(path: string, payload: {
+    content: string;
+  }): Promise<void>;
+  list(path: string): Promise<{
+    data: Array<{
+      name: string;
+      path: string;
+      type: "file" | "dir";
+      size: number;
+    }>;
+    list: Array<{
+      name: string;
+      path: string;
+      type: "file" | "dir";
+      size: number;
+    }>;
+  }>;
+  stat(path: string): Promise<{
+    data: {
+      path: string;
+      size: number;
+      type: "file" | "dir";
+    };
+  } | null>;
+  delete(path: string, options?: {
+    recursive?: boolean;
+  }): Promise<void>;
+  clear(): void;
+}
+declare function createScratchProvider(opts: ScratchProviderOptions): ScratchProvider;
+/**
+ * Overlay `/scratch/*` reads/writes/lists/stats/deletes onto the given AFS
+ * by routing them to the scratch provider. All other paths fall through to
+ * the underlying AFS via the prototype chain (Object.create).
+ *
+ * The overlay is stateless besides its reference to the provider — two
+ * scopes with different providers never see each other's scratch.
+ */
+declare function attachScratchMount<T extends AFSRoot>(afs: T, provider: ScratchProvider): T;
+//#endregion
+export { AFSScratchLayout, MEMORY_SCRATCH_ROOT, SCRATCH_SCOPE_ROOT, ScratchProvider, ScratchProviderOptions, ScratchRetention, attachScratchMount, computeScratchLayout, createScratchProvider, provisionScratchViaAFS, teardownScratchViaAFS };
+//# sourceMappingURL=scratchpad-afs.d.mts.map

package/dist/agent-runners/scratchpad-afs.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scratchpad-afs.d.mts","names":[],"sources":["../../src/agent-runners/scratchpad-afs.ts"],"mappings":";;;KAqBY,gBAAA;AAAA,UAEK,gBAAA;EAae;EAX9B,QAAA;EACA,QAAA;EACA,aAAA;EACA,WAAA;EACA,YAAA;AAAA;;;AAkDF;;cA3Ca,mBAAA;;cAGA,kBAAA;;;;;iBAwCG,oBAAA,CAAqB,OAAA,UAAiB,KAAA,WAAgB,gBAAA;;;;;iBAiBhD,sBAAA,CACpB,GAAA,EAAK,OAAA,EACL,OAAA,UACA,KAAA,WACC,OAAA,CAAQ,gBAAA;;;;;iBAgBW,qBAAA,CACpB,GAAA,EAAK,OAAA,EACL,OAAA,UACA,SAAA,GAAW,gBAAA,GACV,OAAA;AAAA,UAkBc,sBAAA;EAAA,SACN,OAAA;EAAA,SACA,KAAA;EAAA,SACA,SAAA,GAAY,gBAAA;AAAA;AAzBvB;;;;;;;;;;;AAAA,UAuCiB,eAAA;EAAA,SACN,OAAA;EAAA,SACA,KAAA;EAAA,SACA,SAAA,EAAW,gBAAA;EACpB,IAAA,CAAK,IAAA,WAAe,OAAA;IAAU,IAAA;MAAQ,OAAA;MAAiB,IAAA;IAAA;IAAgB,IAAA;EAAA;EACvE,KAAA,CAAM,IAAA,UAAc,OAAA;IAAW,OAAA;EAAA,IAAoB,OAAA;EACnD,IAAA,CAAK,IAAA,WAAe,OAAA;IAClB,IAAA,EAAM,KAAA;MAAQ,IAAA;MAAc,IAAA;MAAc,IAAA;MAAsB,IAAA;IAAA;IAChE,IAAA,EAAM,KAAA;MAAQ,IAAA;MAAc,IAAA;MAAc,IAAA;MAAsB,IAAA;IAAA;EAAA;EAElE,IAAA,CACE,IAAA,WACC,OAAA;IAAU,IAAA;MAAQ,IAAA;MAAc,IAAA;MAAc,IAAA;IAAA;EAAA;EACjD,MAAA,CAAO,IAAA,UAAc,OAAA;IAAY,SAAA;EAAA,IAAwB,OAAA;EACzD,KAAA;AAAA;AAAA,iBAiBc,qBAAA,CAAsB,IAAA,EAAM,sBAAA,GAAyB,eAAA;;;;;;;;;iBAgHrD,kBAAA,WAA6B,OAAA,CAAA,CAAS,GAAA,EAAK,CAAA,EAAG,QAAA,EAAU,eAAA,GAAkB,CAAA"}

package/dist/agent-runners/scratchpad-afs.mjs

@@ -0,0 +1,271 @@
+import { joinURL } from "ufo";
+
+//#region src/agent-runners/scratchpad-afs.ts
+/**
+* @deprecated Phase 2 migrates scratch to the scope-local `/scratch/` mount.
+* Kept only for the legacy read-path (old sessions) and removed in Phase 6.
+*/
+const MEMORY_SCRATCH_ROOT = "/modules/memory";
+/** Root path of the scope-local scratch mount created by `projectForChild`. */
+const SCRATCH_SCOPE_ROOT = "/scratch";
+function validatePathComponent(value, label) {
+	if (typeof value !== "string" || value.length === 0) throw new TypeError(`SCRATCH_INVALID_INPUT: ${label} must be a non-empty string`);
+	if (value.includes("..")) throw new Error(`SCRATCH_INVALID_INPUT: path traversal disallowed in ${label}`);
+	if (value.includes("\0")) throw new Error(`SCRATCH_INVALID_INPUT: null byte disallowed in ${label}`);
+	if (value.includes("/") || value.includes("\\")) throw new Error(`SCRATCH_INVALID_INPUT: path separator disallowed in ${label}`);
+	return value;
+}
+/**
+* Reject scratch-local paths that try to escape the `/scratch/` root or
+* smuggle control characters. Runs on every read/write/list/stat/delete
+* against the scope-local mount.
+*/
+function assertScratchPath(path) {
+	if (typeof path !== "string" || path.length === 0) throw new Error(`SCRATCH_INVALID_PATH: path must be a non-empty string`);
+	if (path.includes("\0")) throw new Error(`SCRATCH_INVALID_PATH: null byte disallowed`);
+	if (path.split("/").some((s) => s === "..")) throw new Error(`SCRATCH_INVALID_PATH: path traversal disallowed (".." segment)`);
+}
+/**
+* @deprecated Use `createScratchProvider` + the scope-local `/scratch/` mount.
+* Retained for the legacy read-path and removed in Phase 6.
+*/
+function computeScratchLayout(session, runId) {
+	const basePath = joinURL(MEMORY_SCRATCH_ROOT, "runs", validatePathComponent(session, "session"), "subruns", validatePathComponent(runId, "runId"));
+	return {
+		basePath,
+		stateYml: joinURL(basePath, "state.yml"),
+		messagesJsonl: joinURL(basePath, "messages.jsonl"),
+		eventsJsonl: joinURL(basePath, "events.jsonl"),
+		historyJsonl: joinURL(basePath, "history.jsonl")
+	};
+}
+/**
+* @deprecated Use the scope-local `/scratch/` mount (`createScratchProvider`).
+* Kept for backwards compatibility with pre-Phase-2 callers; removed in P6.
+*/
+async function provisionScratchViaAFS(afs, session, runId) {
+	if (!afs.write) throw new Error("SCRATCH_NO_WRITE: host AFS does not expose a write method");
+	const layout = computeScratchLayout(session, runId);
+	await afs.write(layout.stateYml, { content: "" });
+	await afs.write(layout.messagesJsonl, { content: "" });
+	await afs.write(layout.eventsJsonl, { content: "" });
+	await afs.write(layout.historyJsonl, { content: "" });
+	return layout;
+}
+/**
+* @deprecated Scope teardown will manage scratch lifetime once P5 lands.
+* Phase 2 keeps this helper for callers still operating on legacy sessions.
+*/
+async function teardownScratchViaAFS(afs, session, retention = "session") {
+	if (retention === "forever" || retention === "run") return;
+	const s = validatePathComponent(session, "session");
+	const anyAfs = afs;
+	if (typeof anyAfs.delete !== "function") return;
+	const sessionPath = joinURL(MEMORY_SCRATCH_ROOT, "runs", s);
+	try {
+		await anyAfs.delete(sessionPath, { recursive: true });
+	} catch {}
+}
+function normalizeScratchPath(path) {
+	assertScratchPath(path);
+	if (path === SCRATCH_SCOPE_ROOT) return SCRATCH_SCOPE_ROOT;
+	if (path.startsWith(`${SCRATCH_SCOPE_ROOT}/`)) {
+		const trimmed = path.replace(/\/+$/, "");
+		return trimmed.length < 8 ? SCRATCH_SCOPE_ROOT : trimmed;
+	}
+	throw new Error(`SCRATCH_PATH_OUT_OF_SCOPE: ${path} is not inside ${SCRATCH_SCOPE_ROOT}/`);
+}
+function isScratchPath(path) {
+	return path === SCRATCH_SCOPE_ROOT || path.startsWith(`${SCRATCH_SCOPE_ROOT}/`);
+}
+function createScratchProvider(opts) {
+	validatePathComponent(opts.session, "session");
+	if (opts.runId !== void 0) validatePathComponent(opts.runId, "runId");
+	const retention = opts.retention ?? "session";
+	const store = /* @__PURE__ */ new Map();
+	return {
+		session: opts.session,
+		runId: opts.runId,
+		retention,
+		async read(path) {
+			const norm = normalizeScratchPath(path);
+			if (!store.has(norm)) return null;
+			return {
+				data: {
+					content: store.get(norm),
+					path: norm
+				},
+				path: norm
+			};
+		},
+		async write(path, payload) {
+			const norm = normalizeScratchPath(path);
+			if (norm === SCRATCH_SCOPE_ROOT) throw new Error(`SCRATCH_INVALID_PATH: cannot write to scratch root`);
+			const content = typeof payload?.content === "string" ? payload.content : "";
+			store.set(norm, content);
+		},
+		async list(path) {
+			const norm = normalizeScratchPath(path);
+			const prefix = norm === SCRATCH_SCOPE_ROOT ? `${SCRATCH_SCOPE_ROOT}/` : `${norm}/`;
+			const files = [];
+			const dirs = /* @__PURE__ */ new Set();
+			for (const stored of store.keys()) {
+				if (!stored.startsWith(prefix)) continue;
+				const rest = stored.slice(prefix.length);
+				const slash = rest.indexOf("/");
+				if (slash === -1) {
+					const content = store.get(stored) ?? "";
+					files.push({
+						name: rest,
+						path: stored,
+						type: "file",
+						size: Buffer.byteLength(content, "utf8")
+					});
+				} else {
+					const dir = rest.slice(0, slash);
+					dirs.add(dir);
+				}
+			}
+			const list = [];
+			for (const d of dirs) list.push({
+				name: d,
+				path: `${prefix}${d}`,
+				type: "dir",
+				size: 0
+			});
+			list.push(...files);
+			return {
+				data: list,
+				list
+			};
+		},
+		async stat(path) {
+			const norm = normalizeScratchPath(path);
+			if (norm === SCRATCH_SCOPE_ROOT) return { data: {
+				path: norm,
+				size: 0,
+				type: "dir"
+			} };
+			if (store.has(norm)) {
+				const content = store.get(norm);
+				return { data: {
+					path: norm,
+					size: Buffer.byteLength(content, "utf8"),
+					type: "file"
+				} };
+			}
+			const prefix = `${norm}/`;
+			for (const k of store.keys()) if (k.startsWith(prefix)) return { data: {
+				path: norm,
+				size: 0,
+				type: "dir"
+			} };
+			return null;
+		},
+		async delete(path, options) {
+			const norm = normalizeScratchPath(path);
+			if (norm === SCRATCH_SCOPE_ROOT) {
+				if (options?.recursive) {
+					store.clear();
+					return;
+				}
+				throw new Error(`SCRATCH_INVALID_PATH: cannot delete scratch root non-recursively`);
+			}
+			if (store.has(norm)) {
+				store.delete(norm);
+				return;
+			}
+			if (options?.recursive) {
+				const prefix = `${norm}/`;
+				for (const k of Array.from(store.keys())) if (k.startsWith(prefix)) store.delete(k);
+			}
+		},
+		clear() {
+			store.clear();
+		}
+	};
+}
+/**
+* Overlay `/scratch/*` reads/writes/lists/stats/deletes onto the given AFS
+* by routing them to the scratch provider. All other paths fall through to
+* the underlying AFS via the prototype chain (Object.create).
+*
+* The overlay is stateless besides its reference to the provider — two
+* scopes with different providers never see each other's scratch.
+*/
+function attachScratchMount(afs, provider) {
+	const child = Object.create(afs);
+	Object.defineProperty(child, "read", {
+		value: async (path, options) => {
+			if (isScratchPath(path)) {
+				const result = await provider.read(path);
+				if (result) return result;
+				const err = /* @__PURE__ */ new Error(`SCRATCH_NOT_FOUND: ${path}`);
+				err.code = "NOT_FOUND";
+				throw err;
+			}
+			return afs.read.call(afs, path, options);
+		},
+		enumerable: false,
+		writable: false,
+		configurable: false
+	});
+	Object.defineProperty(child, "write", {
+		value: async (path, payload, options) => {
+			if (isScratchPath(path)) {
+				await provider.write(path, payload);
+				return {
+					success: true,
+					data: { path }
+				};
+			}
+			if (typeof afs.write !== "function") throw new Error(`SCRATCH_NO_UNDERLYING_WRITE: afs.write not available for ${path}`);
+			return afs.write.call(afs, path, payload, options);
+		},
+		enumerable: false,
+		writable: false,
+		configurable: false
+	});
+	Object.defineProperty(child, "list", {
+		value: async (path, options) => {
+			if (isScratchPath(path)) return provider.list(path);
+			return afs.list.call(afs, path, options);
+		},
+		enumerable: false,
+		writable: false,
+		configurable: false
+	});
+	Object.defineProperty(child, "stat", {
+		value: async (path, options) => {
+			if (isScratchPath(path)) {
+				const result = await provider.stat(path);
+				if (result) return result;
+				const err = /* @__PURE__ */ new Error(`SCRATCH_NOT_FOUND: ${path}`);
+				err.code = "NOT_FOUND";
+				throw err;
+			}
+			return afs.stat.call(afs, path, options);
+		},
+		enumerable: false,
+		writable: false,
+		configurable: false
+	});
+	Object.defineProperty(child, "delete", {
+		value: async (path, options) => {
+			if (isScratchPath(path)) {
+				await provider.delete(path, options);
+				return { success: true };
+			}
+			if (typeof afs.delete !== "function") return { success: false };
+			return afs.delete.call(afs, path, options);
+		},
+		enumerable: false,
+		writable: false,
+		configurable: false
+	});
+	return child;
+}
+
+//#endregion
+export { MEMORY_SCRATCH_ROOT, SCRATCH_SCOPE_ROOT, attachScratchMount, computeScratchLayout, createScratchProvider, provisionScratchViaAFS, teardownScratchViaAFS };
+//# sourceMappingURL=scratchpad-afs.mjs.map

package/dist/agent-runners/scratchpad-afs.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"scratchpad-afs.mjs","names":[],"sources":["../../src/agent-runners/scratchpad-afs.ts"],"sourcesContent":["/**\n * Scratchpad — per-scope ephemeral filesystem for agent runs.\n *\n * Phase 2 (agent-runtime-afs-first): scratch is now a **per-scope mount**\n * at `/scratch/*`. `createScratchProvider` builds an in-memory store that\n * `projectForChild` overlays onto each child scope via\n * `attachScratchMount`. Runners then read/write `/scratch/state.yml`,\n * `/scratch/hook-channel.jsonl`, etc. without caring which backend holds\n * them.\n *\n * The legacy path `/modules/memory/runs/<session>/subruns/<runId>/`\n * — exposed as `MEMORY_SCRATCH_ROOT` + `provisionScratchViaAFS` +\n * `teardownScratchViaAFS` — is retained as a *read-only* legacy helper\n * so old sessions remain inspectable. New sessions must go through the\n * `/scratch/*` mount. All legacy helpers carry `@deprecated` markers and\n * disappear with Phase 6's RunnerContext sweep.\n */\n\nimport type { AFSRoot } from \"@aigne/afs\";\nimport { joinURL } from \"ufo\";\n\nexport type ScratchRetention = \"run\" | \"session\" | \"forever\";\n\nexport interface AFSScratchLayout {\n  /** Base dir for this run — `/modules/memory/runs/<session>/subruns/<runId>` */\n  basePath: string;\n  stateYml: string;\n  messagesJsonl: string;\n  eventsJsonl: string;\n  historyJsonl: string;\n}\n\n/**\n * @deprecated Phase 2 migrates scratch to the scope-local `/scratch/` mount.\n * Kept only for the legacy read-path (old sessions) and removed in Phase 6.\n */\nexport const MEMORY_SCRATCH_ROOT = \"/modules/memory\";\n\n/** Root path of the scope-local scratch mount created by `projectForChild`. */\nexport const SCRATCH_SCOPE_ROOT = \"/scratch\";\n\nfunction validatePathComponent(value: unknown, label: string): string {\n  if (typeof value !== \"string\" || value.length === 0) {\n    throw new TypeError(`SCRATCH_INVALID_INPUT: ${label} must be a non-empty string`);\n  }\n  if (value.includes(\"..\")) {\n    throw new Error(`SCRATCH_INVALID_INPUT: path traversal disallowed in ${label}`);\n  }\n  if (value.includes(\"\\0\")) {\n    throw new Error(`SCRATCH_INVALID_INPUT: null byte disallowed in ${label}`);\n  }\n  if (value.includes(\"/\") || value.includes(\"\\\\\")) {\n    throw new Error(`SCRATCH_INVALID_INPUT: path separator disallowed in ${label}`);\n  }\n  return value;\n}\n\n/**\n * Reject scratch-local paths that try to escape the `/scratch/` root or\n * smuggle control characters. Runs on every read/write/list/stat/delete\n * against the scope-local mount.\n */\nfunction assertScratchPath(path: string): void {\n  if (typeof path !== \"string\" || path.length === 0) {\n    throw new Error(`SCRATCH_INVALID_PATH: path must be a non-empty string`);\n  }\n  if (path.includes(\"\\0\")) {\n    throw new Error(`SCRATCH_INVALID_PATH: null byte disallowed`);\n  }\n  const segments = path.split(\"/\");\n  if (segments.some((s) => s === \"..\")) {\n    throw new Error(`SCRATCH_INVALID_PATH: path traversal disallowed (\"..\" segment)`);\n  }\n}\n\n/**\n * @deprecated Use `createScratchProvider` + the scope-local `/scratch/` mount.\n * Retained for the legacy read-path and removed in Phase 6.\n */\nexport function computeScratchLayout(session: string, runId: string): AFSScratchLayout {\n  const s = validatePathComponent(session, \"session\");\n  const r = validatePathComponent(runId, \"runId\");\n  const basePath = joinURL(MEMORY_SCRATCH_ROOT, \"runs\", s, \"subruns\", r);\n  return {\n    basePath,\n    stateYml: joinURL(basePath, \"state.yml\"),\n    messagesJsonl: joinURL(basePath, \"messages.jsonl\"),\n    eventsJsonl: joinURL(basePath, \"events.jsonl\"),\n    historyJsonl: joinURL(basePath, \"history.jsonl\"),\n  };\n}\n\n/**\n * @deprecated Use the scope-local `/scratch/` mount (`createScratchProvider`).\n * Kept for backwards compatibility with pre-Phase-2 callers; removed in P6.\n */\nexport async function provisionScratchViaAFS(\n  afs: AFSRoot,\n  session: string,\n  runId: string,\n): Promise<AFSScratchLayout> {\n  if (!afs.write) {\n    throw new Error(\"SCRATCH_NO_WRITE: host AFS does not expose a write method\");\n  }\n  const layout = computeScratchLayout(session, runId);\n  await afs.write(layout.stateYml, { content: \"\" });\n  await afs.write(layout.messagesJsonl, { content: \"\" });\n  await afs.write(layout.eventsJsonl, { content: \"\" });\n  await afs.write(layout.historyJsonl, { content: \"\" });\n  return layout;\n}\n\n/**\n * @deprecated Scope teardown will manage scratch lifetime once P5 lands.\n * Phase 2 keeps this helper for callers still operating on legacy sessions.\n */\nexport async function teardownScratchViaAFS(\n  afs: AFSRoot,\n  session: string,\n  retention: ScratchRetention = \"session\",\n): Promise<void> {\n  if (retention === \"forever\" || retention === \"run\") return;\n  const s = validatePathComponent(session, \"session\");\n  const anyAfs = afs as any;\n  if (typeof anyAfs.delete !== \"function\") return;\n\n  const sessionPath = joinURL(MEMORY_SCRATCH_ROOT, \"runs\", s);\n  try {\n    await anyAfs.delete(sessionPath, { recursive: true });\n  } catch {\n    // best-effort — session may not exist, or backing provider may reject\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Phase 2 — scope-local `/scratch/` provider + overlay.\n// ---------------------------------------------------------------------------\n\nexport interface ScratchProviderOptions {\n  readonly session: string;\n  readonly runId?: string;\n  readonly retention?: ScratchRetention;\n}\n\n/**\n * In-memory scratch provider. Each scope gets its own instance; files stay\n * in memory for the life of the AFS instance (process). Retention shapes\n * teardown behavior once P5 wires it up — P2 stores the flag but the\n * provider itself is a Map.\n *\n * The provider intentionally does not reach back into any real filesystem\n * or KV — keeping scratch per-scope and in-memory is what lets concurrent\n * sub-runs not stomp each other, and what makes scope teardown a\n * single-reference drop.\n */\nexport interface ScratchProvider {\n  readonly session: string;\n  readonly runId?: string;\n  readonly retention: ScratchRetention;\n  read(path: string): Promise<{ data: { content: string; path: string }; path: string } | null>;\n  write(path: string, payload: { content: string }): Promise<void>;\n  list(path: string): Promise<{\n    data: Array<{ name: string; path: string; type: \"file\" | \"dir\"; size: number }>;\n    list: Array<{ name: string; path: string; type: \"file\" | \"dir\"; size: number }>;\n  }>;\n  stat(\n    path: string,\n  ): Promise<{ data: { path: string; size: number; type: \"file\" | \"dir\" } } | null>;\n  delete(path: string, options?: { recursive?: boolean }): Promise<void>;\n  clear(): void;\n}\n\nfunction normalizeScratchPath(path: string): string {\n  assertScratchPath(path);\n  if (path === SCRATCH_SCOPE_ROOT) return SCRATCH_SCOPE_ROOT;\n  if (path.startsWith(`${SCRATCH_SCOPE_ROOT}/`)) {\n    const trimmed = path.replace(/\\/+$/, \"\");\n    return trimmed.length < SCRATCH_SCOPE_ROOT.length ? SCRATCH_SCOPE_ROOT : trimmed;\n  }\n  throw new Error(`SCRATCH_PATH_OUT_OF_SCOPE: ${path} is not inside ${SCRATCH_SCOPE_ROOT}/`);\n}\n\nfunction isScratchPath(path: string): boolean {\n  return path === SCRATCH_SCOPE_ROOT || path.startsWith(`${SCRATCH_SCOPE_ROOT}/`);\n}\n\nexport function createScratchProvider(opts: ScratchProviderOptions): ScratchProvider {\n  validatePathComponent(opts.session, \"session\");\n  if (opts.runId !== undefined) validatePathComponent(opts.runId, \"runId\");\n  const retention: ScratchRetention = opts.retention ?? \"session\";\n  const store = new Map<string, string>();\n\n  return {\n    session: opts.session,\n    runId: opts.runId,\n    retention,\n\n    async read(path) {\n      const norm = normalizeScratchPath(path);\n      if (!store.has(norm)) return null;\n      const content = store.get(norm)!;\n      return { data: { content, path: norm }, path: norm };\n    },\n\n    async write(path, payload) {\n      const norm = normalizeScratchPath(path);\n      if (norm === SCRATCH_SCOPE_ROOT) {\n        throw new Error(`SCRATCH_INVALID_PATH: cannot write to scratch root`);\n      }\n      const content = typeof payload?.content === \"string\" ? payload.content : \"\";\n      store.set(norm, content);\n    },\n\n    async list(path) {\n      const norm = normalizeScratchPath(path);\n      const prefix = norm === SCRATCH_SCOPE_ROOT ? `${SCRATCH_SCOPE_ROOT}/` : `${norm}/`;\n      const files: Array<{ name: string; path: string; type: \"file\" | \"dir\"; size: number }> = [];\n      const dirs = new Set<string>();\n      for (const stored of store.keys()) {\n        if (!stored.startsWith(prefix)) continue;\n        const rest = stored.slice(prefix.length);\n        const slash = rest.indexOf(\"/\");\n        if (slash === -1) {\n          const content = store.get(stored) ?? \"\";\n          files.push({\n            name: rest,\n            path: stored,\n            type: \"file\",\n            size: Buffer.byteLength(content, \"utf8\"),\n          });\n        } else {\n          const dir = rest.slice(0, slash);\n          dirs.add(dir);\n        }\n      }\n      const list: Array<{ name: string; path: string; type: \"file\" | \"dir\"; size: number }> = [];\n      for (const d of dirs) {\n        list.push({ name: d, path: `${prefix}${d}`, type: \"dir\", size: 0 });\n      }\n      list.push(...files);\n      return { data: list, list };\n    },\n\n    async stat(path) {\n      const norm = normalizeScratchPath(path);\n      if (norm === SCRATCH_SCOPE_ROOT) {\n        return { data: { path: norm, size: 0, type: \"dir\" } };\n      }\n      if (store.has(norm)) {\n        const content = store.get(norm)!;\n        return {\n          data: { path: norm, size: Buffer.byteLength(content, \"utf8\"), type: \"file\" },\n        };\n      }\n      const prefix = `${norm}/`;\n      for (const k of store.keys()) {\n        if (k.startsWith(prefix)) {\n          return { data: { path: norm, size: 0, type: \"dir\" } };\n        }\n      }\n      return null;\n    },\n\n    async delete(path, options) {\n      const norm = normalizeScratchPath(path);\n      if (norm === SCRATCH_SCOPE_ROOT) {\n        if (options?.recursive) {\n          store.clear();\n          return;\n        }\n        throw new Error(`SCRATCH_INVALID_PATH: cannot delete scratch root non-recursively`);\n      }\n      if (store.has(norm)) {\n        store.delete(norm);\n        return;\n      }\n      if (options?.recursive) {\n        const prefix = `${norm}/`;\n        for (const k of Array.from(store.keys())) {\n          if (k.startsWith(prefix)) store.delete(k);\n        }\n      }\n    },\n\n    clear() {\n      store.clear();\n    },\n  };\n}\n\n/**\n * Overlay `/scratch/*` reads/writes/lists/stats/deletes onto the given AFS\n * by routing them to the scratch provider. All other paths fall through to\n * the underlying AFS via the prototype chain (Object.create).\n *\n * The overlay is stateless besides its reference to the provider — two\n * scopes with different providers never see each other's scratch.\n */\nexport function attachScratchMount<T extends AFSRoot>(afs: T, provider: ScratchProvider): T {\n  const child = Object.create(afs) as T;\n\n  Object.defineProperty(child, \"read\", {\n    value: async (path: string, options?: unknown) => {\n      if (isScratchPath(path)) {\n        const result = await provider.read(path);\n        if (result) return result;\n        const err = new Error(`SCRATCH_NOT_FOUND: ${path}`);\n        (err as any).code = \"NOT_FOUND\";\n        throw err;\n      }\n      return (afs.read as any)!.call(afs, path, options);\n    },\n    enumerable: false,\n    writable: false,\n    configurable: false,\n  });\n\n  Object.defineProperty(child, \"write\", {\n    value: async (path: string, payload: { content: string }, options?: unknown) => {\n      if (isScratchPath(path)) {\n        await provider.write(path, payload);\n        return { success: true, data: { path } } as any;\n      }\n      if (typeof afs.write !== \"function\") {\n        throw new Error(`SCRATCH_NO_UNDERLYING_WRITE: afs.write not available for ${path}`);\n      }\n      return (afs.write as any)!.call(afs, path, payload, options);\n    },\n    enumerable: false,\n    writable: false,\n    configurable: false,\n  });\n\n  Object.defineProperty(child, \"list\", {\n    value: async (path: string, options?: unknown) => {\n      if (isScratchPath(path)) {\n        return provider.list(path);\n      }\n      return (afs.list as any)!.call(afs, path, options);\n    },\n    enumerable: false,\n    writable: false,\n    configurable: false,\n  });\n\n  Object.defineProperty(child, \"stat\", {\n    value: async (path: string, options?: unknown) => {\n      if (isScratchPath(path)) {\n        const result = await provider.stat(path);\n        if (result) return result;\n        const err = new Error(`SCRATCH_NOT_FOUND: ${path}`);\n        (err as any).code = \"NOT_FOUND\";\n        throw err;\n      }\n      return (afs.stat as any)!.call(afs, path, options);\n    },\n    enumerable: false,\n    writable: false,\n    configurable: false,\n  });\n\n  Object.defineProperty(child, \"delete\", {\n    value: async (path: string, options?: { recursive?: boolean }) => {\n      if (isScratchPath(path)) {\n        await provider.delete(path, options);\n        return { success: true } as any;\n      }\n      if (typeof (afs as any).delete !== \"function\") return { success: false } as any;\n      return (afs as any).delete!.call(afs, path, options);\n    },\n    enumerable: false,\n    writable: false,\n    configurable: false,\n  });\n\n  return child;\n}\n"],"mappings":"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"}

package/dist/agent-runners/stream-router.cjs

@@ -0,0 +1,72 @@
+let ufo = require("ufo");
+
+//#region src/agent-runners/stream-router.ts
+const UI_SESSION_RE = /^\/(?:dev\/)?ui\/[^/]+\/sessions\/([^/]+)/;
+function detectUISessionPath(session) {
+	if (!session) return null;
+	const trimmed = session.replace(/\/+$/, "");
+	const match = UI_SESSION_RE.exec(trimmed);
+	if (!match) return null;
+	const [full] = match;
+	return full;
+}
+function createStreamProgressRouter(opts) {
+	const sessionPath = opts.sessionPath ?? null;
+	if (!sessionPath || !opts.nodeId) return null;
+	const patchPath = (0, ufo.joinURL)(sessionPath, ".actions", "aup_patch");
+	const throttleMs = opts.throttleMs ?? 150;
+	const state = {
+		streamingText: "",
+		thinkingText: "",
+		dirty: false
+	};
+	let timer = null;
+	let lastFlush = Promise.resolve();
+	const sendPatch = async () => {
+		if (!state.dirty) return;
+		state.dirty = false;
+		const patchState = {};
+		if (state.streamingText) patchState.streamingText = state.streamingText;
+		if (state.thinkingText) patchState.thinkingText = state.thinkingText;
+		const ops = [{
+			op: "update",
+			id: opts.nodeId,
+			state: patchState
+		}];
+		try {
+			await opts.afs.exec(patchPath, { ops }, {});
+		} catch {}
+	};
+	const scheduleFlush = () => {
+		if (timer) return;
+		timer = setTimeout(() => {
+			timer = null;
+			lastFlush = sendPatch();
+		}, throttleMs);
+	};
+	return {
+		onProgress: (event) => {
+			if (event.type === "llm_delta" && typeof event.text === "string") {
+				state.streamingText += event.text;
+				state.dirty = true;
+				scheduleFlush();
+			} else if (event.type === "thinking_delta" && typeof event.text === "string") {
+				state.thinkingText += event.text;
+				state.dirty = true;
+				scheduleFlush();
+			}
+		},
+		flush: async () => {
+			if (timer) {
+				clearTimeout(timer);
+				timer = null;
+			}
+			await lastFlush;
+			await sendPatch();
+		}
+	};
+}
+
+//#endregion
+exports.createStreamProgressRouter = createStreamProgressRouter;
+exports.detectUISessionPath = detectUISessionPath;

package/dist/agent-runners/stream-router.d.cts

@@ -0,0 +1,22 @@
+import { AFSRoot } from "@aigne/afs";
+
+//#region src/agent-runners/stream-router.d.ts
+declare function detectUISessionPath(session: string | undefined | null): string | null;
+interface StreamProgressRouterOptions {
+  afs: AFSRoot;
+  sessionPath: string | null | undefined;
+  nodeId?: string;
+  throttleMs?: number;
+}
+interface StreamProgressRouter {
+  onProgress: (event: {
+    type: string;
+    round?: number;
+    text?: string;
+  }) => void;
+  flush: () => Promise<void>;
+}
+declare function createStreamProgressRouter(opts: StreamProgressRouterOptions): StreamProgressRouter | null;
+//#endregion
+export { StreamProgressRouter, StreamProgressRouterOptions, createStreamProgressRouter, detectUISessionPath };
+//# sourceMappingURL=stream-router.d.cts.map

package/dist/agent-runners/stream-router.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-router.d.cts","names":[],"sources":["../../src/agent-runners/stream-router.ts"],"mappings":";;;iBAuBgB,mBAAA,CAAoB,OAAA;AAAA,UAUnB,2BAAA;EACf,GAAA,EAAK,OAAA;EACL,WAAA;EACA,MAAA;EACA,UAAA;AAAA;AAAA,UAGe,oBAAA;EACf,UAAA,GAAa,KAAA;IAAS,IAAA;IAAc,KAAA;IAAgB,IAAA;EAAA;EACpD,KAAA,QAAa,OAAA;AAAA;AAAA,iBASC,0BAAA,CACd,IAAA,EAAM,2BAAA,GACL,oBAAA"}

package/dist/agent-runners/stream-router.d.mts

@@ -0,0 +1,22 @@
+import { AFSRoot } from "@aigne/afs";
+
+//#region src/agent-runners/stream-router.d.ts
+declare function detectUISessionPath(session: string | undefined | null): string | null;
+interface StreamProgressRouterOptions {
+  afs: AFSRoot;
+  sessionPath: string | null | undefined;
+  nodeId?: string;
+  throttleMs?: number;
+}
+interface StreamProgressRouter {
+  onProgress: (event: {
+    type: string;
+    round?: number;
+    text?: string;
+  }) => void;
+  flush: () => Promise<void>;
+}
+declare function createStreamProgressRouter(opts: StreamProgressRouterOptions): StreamProgressRouter | null;
+//#endregion
+export { StreamProgressRouter, StreamProgressRouterOptions, createStreamProgressRouter, detectUISessionPath };
+//# sourceMappingURL=stream-router.d.mts.map

package/dist/agent-runners/stream-router.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-router.d.mts","names":[],"sources":["../../src/agent-runners/stream-router.ts"],"mappings":";;;iBAuBgB,mBAAA,CAAoB,OAAA;AAAA,UAUnB,2BAAA;EACf,GAAA,EAAK,OAAA;EACL,WAAA;EACA,MAAA;EACA,UAAA;AAAA;AAAA,UAGe,oBAAA;EACf,UAAA,GAAa,KAAA;IAAS,IAAA;IAAc,KAAA;IAAgB,IAAA;EAAA;EACpD,KAAA,QAAa,OAAA;AAAA;AAAA,iBASC,0BAAA,CACd,IAAA,EAAM,2BAAA,GACL,oBAAA"}