@flue/sdk 0.4.1 → 0.5.0

package/dist/{mcp-DM6yv_Qc.mjs → mcp-DwLSoSxp.mjs}

@@ -1,22 +1,23 @@
 import { u as discoverSessionContext } from "./result-K1IRhWKM.mjs";
 import { n as createCallHandle } from "./abort-Bg3qsAkU.mjs";
-import { a as assertRoleExists, n as Session, r as deleteSessionTree } from "./session-CFOByKnM.mjs";
+import { a as assertRoleExists, n as Session, r as deleteSessionTree } from "./session-CRFfAJDq.mjs";
 import { createCwdSessionEnv, createFlueFs } from "./sandbox.mjs";
 import { Client } from "@modelcontextprotocol/sdk/client/index.js";
 import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
 
-//#region src/agent-client.ts
-const DEFAULT_SESSION_ID = "default";
-var AgentClient = class {
+//#region src/harness.ts
+const DEFAULT_SESSION_NAME = "default";
+var Harness = class {
 	sessions = {
-		get: (id, options) => this.openSession(id, "get", options),
-		create: (id, options) => this.openSession(id, "create", options),
-		delete: (id) => this.deleteSession(id)
+		get: (name, options) => this.openSession(name, "get", options),
+		create: (name, options) => this.openSession(name, "create", options),
+		delete: (name) => this.deleteSession(name)
 	};
 	fs;
 	openSessions = /* @__PURE__ */ new Map();
-	constructor(id, config, env, store, eventCallback, agentTools = []) {
-		this.id = id;
+	constructor(instanceId, name, config, env, store, eventCallback, agentTools = []) {
+		this.instanceId = instanceId;
+		this.name = name;
 		this.config = config;
 		this.env = env;
 		this.store = store;
@@ -24,8 +25,8 @@ var AgentClient = class {
 		this.agentTools = agentTools;
 		this.fs = createFlueFs(env);
 	}
-	async session(id, options) {
-		return this.openSession(id, "get-or-create", options);
+	async session(name, options) {
+		return this.openSession(name, "get-or-create", options);
 	}
 	shell(command, options) {
 		return createCallHandle(options?.signal, async (signal) => {
@@ -41,53 +42,53 @@ var AgentClient = class {
 			};
 		});
 	}
-	async openSession(id, mode, options) {
+	async openSession(name, mode, options) {
 		assertRoleExists(this.config.roles, options?.role);
-		const sessionId = normalizeSessionId(id);
-		const open = this.openSessions.get(sessionId);
+		const sessionName = normalizeSessionName(name);
+		const open = this.openSessions.get(sessionName);
 		if (open) {
-			if (mode === "create") throw new Error(`[flue] Session "${sessionId}" already exists for agent "${this.id}".`);
-			if (options?.role !== void 0 && options.role !== open.role) throw new Error(`[flue] Session "${sessionId}" is already open with role ${JSON.stringify(open.role ?? null)}; cannot reopen with role ${JSON.stringify(options.role)}.`);
+			if (mode === "create") throw new Error(`[flue] Session "${sessionName}" already exists in harness "${this.name}".`);
+			if (options?.role !== void 0 && options.role !== open.role) throw new Error(`[flue] Session "${sessionName}" is already open with role ${JSON.stringify(open.role ?? null)}; cannot reopen with role ${JSON.stringify(options.role)}.`);
 			return open;
 		}
-		const storageKey = createSessionStorageKey(this.id, sessionId);
+		const storageKey = createSessionStorageKey(this.instanceId, this.name, sessionName);
 		const existingData = await this.store.load(storageKey);
-		if (mode === "get" && !existingData) throw new Error(`[flue] Session "${sessionId}" does not exist for agent "${this.id}".`);
-		if (mode === "create" && existingData) throw new Error(`[flue] Session "${sessionId}" already exists for agent "${this.id}".`);
+		if (mode === "get" && !existingData) throw new Error(`[flue] Session "${sessionName}" does not exist in harness "${this.name}".`);
+		if (mode === "create" && existingData) throw new Error(`[flue] Session "${sessionName}" already exists in harness "${this.name}".`);
 		let data = existingData;
 		if (!data && mode !== "get") {
 			data = createEmptySessionData();
 			await this.store.save(storageKey, data);
 		}
 		const session = new Session({
-			id: sessionId,
+			name: sessionName,
 			storageKey,
 			config: this.config,
 			env: this.env,
 			store: this.store,
 			existingData: data,
-			onAgentEvent: this.eventCallback,
+			onAgentEvent: this.decorateEventCallback(this.eventCallback),
 			agentTools: this.agentTools,
 			sessionRole: options?.role,
 			taskDepth: 0,
 			createTaskSession: (taskOptions) => this.createTaskSession(taskOptions),
-			onDelete: () => this.openSessions.delete(sessionId)
+			onDelete: () => this.openSessions.delete(sessionName)
 		});
-		this.openSessions.set(sessionId, session);
+		this.openSessions.set(sessionName, session);
 		return session;
 	}
-	async deleteSession(id) {
-		const sessionId = normalizeSessionId(id);
-		const open = this.openSessions.get(sessionId);
+	async deleteSession(name) {
+		const sessionName = normalizeSessionName(name);
+		const open = this.openSessions.get(sessionName);
 		if (open) {
 			await open.delete();
 			return;
 		}
-		await deleteSessionTree(this.store, createSessionStorageKey(this.id, sessionId));
+		await deleteSessionTree(this.store, createSessionStorageKey(this.instanceId, this.name, sessionName));
 	}
 	async createTaskSession(options) {
 		assertRoleExists(this.config.roles, options.role);
-		const sessionId = `task:${options.parentSessionId}:${options.taskId}`;
+		const sessionName = `task:${options.parentSession}:${options.taskId}`;
 		const taskEnv = options.cwd ? createCwdSessionEnv(options.parentEnv, options.parentEnv.resolvePath(options.cwd)) : options.parentEnv;
 		const localContext = await discoverSessionContext(taskEnv);
 		const taskConfig = {
@@ -95,10 +96,10 @@ var AgentClient = class {
 			systemPrompt: localContext.systemPrompt,
 			skills: localContext.skills
 		};
-		const storageKey = createSessionStorageKey(this.id, sessionId);
+		const storageKey = createSessionStorageKey(this.instanceId, this.name, sessionName);
 		const data = createEmptySessionData();
 		data.metadata = {
-			parentSessionId: options.parentSessionId,
+			parentSession: options.parentSession,
 			taskId: options.taskId,
 			cwd: taskEnv.cwd,
 			role: options.role,
@@ -108,12 +109,13 @@ var AgentClient = class {
 		const eventCallback = this.eventCallback ? (event) => {
 			this.eventCallback?.({
 				...event,
-				parentSessionId: event.parentSessionId ?? options.parentSessionId,
+				harness: event.harness ?? this.name,
+				parentSession: event.parentSession ?? options.parentSession,
 				taskId: event.taskId ?? options.taskId
 			});
 		} : void 0;
 		return new Session({
-			id: sessionId,
+			name: sessionName,
 			storageKey,
 			config: taskConfig,
 			env: taskEnv,
@@ -126,17 +128,29 @@ var AgentClient = class {
 			createTaskSession: (childOptions) => this.createTaskSession(childOptions)
 		});
 	}
+	decorateEventCallback(callback) {
+		return callback ? (event) => {
+			callback({
+				...event,
+				harness: event.harness ?? this.name
+			});
+		} : void 0;
+	}
 };
-function normalizeSessionId(id) {
-	return id ?? DEFAULT_SESSION_ID;
+function normalizeSessionName(name) {
+	return name ?? DEFAULT_SESSION_NAME;
 }
-function createSessionStorageKey(agentId, sessionId) {
-	return `agent-session:${JSON.stringify([agentId, sessionId])}`;
+function createSessionStorageKey(instanceId, harness, sessionName) {
+	return `agent-session:${JSON.stringify([
+		instanceId,
+		harness,
+		sessionName
+	])}`;
 }
 function createEmptySessionData() {
 	const now = (/* @__PURE__ */ new Date()).toISOString();
 	return {
-		version: 2,
+		version: 3,
 		entries: [],
 		leafId: null,
 		metadata: {},
@@ -269,4 +283,4 @@ function formatMcpResult(result) {
 }
 
 //#endregion
-export { AgentClient as n, connectMcpServer as t };
+export { Harness as n, connectMcpServer as t };

package/dist/node/index.d.mts

@@ -1,4 +1,4 @@
-import { O as SessionEnv } from "../types-BAmV4f3Q.mjs";
+import { O as SessionEnv } from "../types-Cdcq_ET2.mjs";
 
 //#region src/node/local-env.d.ts
 interface LocalSessionEnvOptions {

package/dist/{providers-DeFRIwp0.mjs → providers-BjEEoKLy.mjs}

@@ -1,5 +1,15 @@
 import { registerApiProvider } from "@mariozechner/pi-ai";
+import { ulid } from "ulidx";
 
+//#region src/runtime/ids.ts
+function generateRunId() {
+	return `run_${ulid()}`;
+}
+function generateOperationId() {
+	return `op_${ulid()}`;
+}
+
+//#endregion
 //#region src/cloudflare-model.ts
 /** Pi-ai `Api` slug for the binding-backed Workers AI provider. */
 const CLOUDFLARE_AI_BINDING_API = "cloudflare-ai-binding";
@@ -155,4 +165,4 @@ function effectiveProviderSlug(name, def) {
 }
 
 //#endregion
-export { registerApiProvider$1 as a, CLOUDFLARE_AI_BINDING_API as c, getRegisteredApiKey as i, getModelBinding as n, registerProvider as o, getProviderConfiguration as r, resolveRegisteredModel as s, configureProvider as t };
+export { registerApiProvider$1 as a, CLOUDFLARE_AI_BINDING_API as c, getRegisteredApiKey as i, generateOperationId as l, getModelBinding as n, registerProvider as o, getProviderConfiguration as r, resolveRegisteredModel as s, configureProvider as t, generateRunId as u };

package/dist/sandbox.d.mts

@@ -1,4 +1,4 @@
-import { E as SandboxFactory, M as ShellResult, O as SessionEnv, h as FlueFs, i as BashFactory, u as FileStat } from "./types-BAmV4f3Q.mjs";
+import { E as SandboxFactory, M as ShellResult, O as SessionEnv, i as BashFactory, m as FlueFs, u as FileStat } from "./types-Cdcq_ET2.mjs";
 
 //#region src/sandbox.d.ts
 /** Adapt a SessionEnv to the public FlueFs surface. */

package/dist/sandbox.mjs

@@ -1,7 +1,7 @@
 import "./result-K1IRhWKM.mjs";
-import "./providers-DeFRIwp0.mjs";
+import "./providers-BjEEoKLy.mjs";
 import { t as abortErrorFor } from "./abort-Bg3qsAkU.mjs";
-import { i as normalizePath } from "./session-CFOByKnM.mjs";
+import { i as normalizePath } from "./session-CRFfAJDq.mjs";
 
 //#region src/sandbox.ts
 /** Adapt a SessionEnv to the public FlueFs surface. */