@bastani/atomic 0.9.12 → 0.9.13-alpha.2

package/dist/self-update-plan.js.map

@@ -1 +1 @@
-{"version":3,"file":"self-update-plan.js","sourceRoot":"","sources":["../src/self-update-plan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAwB,MAAM,0BAA0B,CAAC;AAU3G,MAAM,UAAU,mBAAmB,CAAC,OAAwB,EAAE,KAAK,GAAG,KAAK;IAC1E,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,YAAY,CAAC;IACxD,OAAO;QACN,WAAW;QACX,WAAW,EAAE,GAAG,WAAW,IAAI,OAAO,CAAC,OAAO,EAAE;QAChD,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,SAAS,EAAE,KAAK,IAAI,WAAW,KAAK,YAAY,IAAI,qBAAqB,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC;QACnG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC/C,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,KAAc;IACzD,IAAI,OAAoC,CAAC;IACzC,IAAI,CAAC;QACJ,OAAO,GAAG,MAAM,kBAAkB,EAAE,CAAC;IACtC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,MAAM,IAAI,KAAK,CAAC,8BAA8B,QAAQ,aAAa,OAAO,EAAE,CAAC,CAAC;IAC/E,CAAC;IACD,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,QAAQ,WAAW,CAAC,CAAC;IACjF,OAAO,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAY,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE;IACtF,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,IAAI,CAAC;QACJ,OAAO,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,gBAAgB,EAAE,CAAC;aACpD,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;aAC3B,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;aAC7B,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,OAAO,CAAC;IAChB,CAAC;AACF,CAAC","sourcesContent":["import { Markdown } from \"@earendil-works/pi-tui\";\nimport { APP_NAME, PACKAGE_NAME, VERSION } from \"./config.ts\";\nimport { getMarkdownTheme } from \"./modes/interactive/theme/theme.ts\";\nimport { getLatestPiRelease, isNewerPackageVersion, type LatestPiRelease } from \"./utils/version-check.ts\";\n\nexport interface SelfUpdatePlan {\n\tpackageName: string;\n\tinstallSpec: string;\n\tversion: string;\n\tshouldRun: boolean;\n\tnote?: string;\n}\n\nexport function buildSelfUpdatePlan(release: LatestPiRelease, force = false): SelfUpdatePlan {\n\tconst packageName = release.packageName ?? PACKAGE_NAME;\n\treturn {\n\t\tpackageName,\n\t\tinstallSpec: `${packageName}@${release.version}`,\n\t\tversion: release.version,\n\t\tshouldRun: force || packageName !== PACKAGE_NAME || isNewerPackageVersion(release.version, VERSION),\n\t\t...(release.note ? { note: release.note } : {}),\n\t};\n}\n\nexport async function resolveSelfUpdatePlan(force: boolean): Promise<SelfUpdatePlan> {\n\tlet release: LatestPiRelease | undefined;\n\ttry {\n\t\trelease = await getLatestPiRelease();\n\t} catch (error) {\n\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\tthrow new Error(`Could not determine latest ${APP_NAME} version: ${message}`);\n\t}\n\tif (!release) throw new Error(`Could not determine latest ${APP_NAME} version.`);\n\treturn buildSelfUpdatePlan(release, force);\n}\n\nexport function renderSelfUpdateNote(note: string, width = process.stdout.columns ?? 80): string | undefined {\n\tconst trimmed = note.trim();\n\tif (!trimmed) return undefined;\n\ttry {\n\t\treturn new Markdown(trimmed, 0, 0, getMarkdownTheme())\n\t\t\t.render(Math.max(20, width))\n\t\t\t.map((line) => line.trimEnd())\n\t\t\t.join(\"\\n\");\n\t} catch {\n\t\treturn trimmed;\n\t}\n}\n"]}
+{"version":3,"file":"self-update-plan.js","sourceRoot":"","sources":["../src/self-update-plan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,EACN,uBAAuB,EACvB,kBAAkB,EAClB,qBAAqB,GAErB,MAAM,0BAA0B,CAAC;AAUlC,MAAM,UAAU,mBAAmB,CAAC,OAAwB,EAAE,KAAK,GAAG,KAAK;IAC1E,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,YAAY,CAAC;IACxD,OAAO;QACN,WAAW;QACX,WAAW,EAAE,GAAG,WAAW,IAAI,OAAO,CAAC,OAAO,EAAE;QAChD,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,SAAS,EAAE,KAAK,IAAI,WAAW,KAAK,YAAY,IAAI,qBAAqB,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC;QACnG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC/C,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,KAAc;IACzD,IAAI,OAAoC,CAAC;IACzC,IAAI,CAAC;QACJ,OAAO,GAAG,MAAM,kBAAkB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACrD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,8BAA8B,QAAQ,aAAa,uBAAuB,CAAC,KAAK,CAAC,EAAE,EAAE;YACpG,KAAK,EAAE,KAAK;SACZ,CAAC,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,QAAQ,WAAW,CAAC,CAAC;IACjF,OAAO,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAY,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE;IACtF,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,IAAI,CAAC;QACJ,OAAO,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,gBAAgB,EAAE,CAAC;aACpD,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;aAC3B,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;aAC7B,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,OAAO,CAAC;IAChB,CAAC;AACF,CAAC","sourcesContent":["import { Markdown } from \"@earendil-works/pi-tui\";\nimport { APP_NAME, PACKAGE_NAME, VERSION } from \"./config.ts\";\nimport { getMarkdownTheme } from \"./modes/interactive/theme/theme.ts\";\nimport {\n\tformatVersionCheckError,\n\tgetLatestPiRelease,\n\tisNewerPackageVersion,\n\ttype LatestPiRelease,\n} from \"./utils/version-check.ts\";\n\nexport interface SelfUpdatePlan {\n\tpackageName: string;\n\tinstallSpec: string;\n\tversion: string;\n\tshouldRun: boolean;\n\tnote?: string;\n}\n\nexport function buildSelfUpdatePlan(release: LatestPiRelease, force = false): SelfUpdatePlan {\n\tconst packageName = release.packageName ?? PACKAGE_NAME;\n\treturn {\n\t\tpackageName,\n\t\tinstallSpec: `${packageName}@${release.version}`,\n\t\tversion: release.version,\n\t\tshouldRun: force || packageName !== PACKAGE_NAME || isNewerPackageVersion(release.version, VERSION),\n\t\t...(release.note ? { note: release.note } : {}),\n\t};\n}\n\nexport async function resolveSelfUpdatePlan(force: boolean): Promise<SelfUpdatePlan> {\n\tlet release: LatestPiRelease | undefined;\n\ttry {\n\t\trelease = await getLatestPiRelease({ retry: true });\n\t} catch (error) {\n\t\tthrow new Error(`Could not determine latest ${APP_NAME} version: ${formatVersionCheckError(error)}`, {\n\t\t\tcause: error,\n\t\t});\n\t}\n\tif (!release) throw new Error(`Could not determine latest ${APP_NAME} version.`);\n\treturn buildSelfUpdatePlan(release, force);\n}\n\nexport function renderSelfUpdateNote(note: string, width = process.stdout.columns ?? 80): string | undefined {\n\tconst trimmed = note.trim();\n\tif (!trimmed) return undefined;\n\ttry {\n\t\treturn new Markdown(trimmed, 0, 0, getMarkdownTheme())\n\t\t\t.render(Math.max(20, width))\n\t\t\t.map((line) => line.trimEnd())\n\t\t\t.join(\"\\n\");\n\t} catch {\n\t\treturn trimmed;\n\t}\n}\n"]}

package/dist/server/create-harness.d.ts

@@ -0,0 +1,53 @@
+import { AgentHarness, type AgentHarnessOptions, type ExecutionEnv, type HarnessTool } from "@earendil-works/pi-agent-core";
+import { type BuildSystemPromptOptions } from "../core/system-prompt.ts";
+export interface CodingAgentHarnessTool extends HarnessTool {
+    promptSnippet?: string;
+    promptGuidelines?: string[];
+}
+export interface CreateCodingAgentHarnessOptions extends Omit<AgentHarnessOptions, "toolContext" | "tools"> {
+    env: ExecutionEnv;
+    bashCommandPrefix?: string;
+    /** Path to the JSONL session file exposed to default bash commands as ATOMIC_SESSION_FILE and PI_SESSION_FILE. */
+    sessionFile?: string;
+    tools?: CodingAgentHarnessTool[];
+    systemPromptOptions?: Omit<BuildSystemPromptOptions, "cwd" | "promptGuidelines" | "selectedTools" | "toolSnippets">;
+}
+export interface BuildCodingAgentHarnessSystemPromptOptions {
+    cwd: string;
+    tools: readonly CodingAgentHarnessTool[];
+    activeToolNames: readonly string[];
+    systemPromptOptions?: CreateCodingAgentHarnessOptions["systemPromptOptions"];
+}
+export declare function buildCodingAgentHarnessSystemPrompt(options: BuildCodingAgentHarnessSystemPromptOptions): string;
+/**
+ * AgentHarness v2 is a configuration scaffold in pi-agent-core 0.84.1. The
+ * factory setup reaches `AgentHarness.create` (for a fresh session),
+ * `Session.getMetadata`, `getModel`, `getThinkingLevel`, `getTools`,
+ * `getActiveTools`, the default system-prompt callback, Atomic tool execution,
+ * and `close()` on the returned harness. The returned harness also exposes the
+ * implemented state/configuration getters and setters for model, thinking
+ * level, active tools, tools, resources, stream options, retry, compaction,
+ * steering, and follow-up modes. Its default tools route the primary operations
+ * for read, bash, edit, write, and find through the injected `ExecutionEnv`;
+ * read and edit still use Atomic's local path-variant probes and notebook
+ * projection; read also uses local archive, SQLite, and internal-resource
+ * selectors, while write still uses local generated-file, shebang, conflict,
+ * and resource helpers. Bash validates its cwd locally and uses Atomic's local
+ * temp storage for overflow output. URL fetches use the process network and do
+ * not persist host-local artifacts in this factory. `search` still uses Atomic's
+ * local filesystem/ripgrep pipeline
+ * until that tool gains a complete remote operations seam. It does not invoke
+ * `prompt`, `skill`,
+ * `promptFromTemplate`, `compact`, `navigateTree`, `resume`, `steer`, `followUp`,
+ * `nextRun`, `cancelQueued`, `recordUsage`, `abort`, `waitForIdle`,
+ * `runWhenIdle`, `peekAction`, `executeAction`, `runToCompletion`, `watch`,
+ * `lane`, `createLane`, `lanes`, `watchSession`, `hooks.on`, or `events.on`;
+ * those unfinished paths reject with `HarnessNotImplemented` at runtime. A
+ * session with existing records also reaches `create.restore`, which is
+ * intentionally outside this factory layer.
+ */
+export declare function createCodingAgentHarness(options: CreateCodingAgentHarnessOptions): Promise<{
+    harness: AgentHarness;
+    suspended: import("@earendil-works/pi-agent-core").SuspendedOperation[];
+}>;
+//# sourceMappingURL=create-harness.d.ts.map

package/dist/server/create-harness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-harness.d.ts","sourceRoot":"","sources":["../../src/server/create-harness.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,YAAY,EACZ,KAAK,mBAAmB,EACxB,KAAK,YAAY,EAIjB,KAAK,WAAW,EAEhB,MAAM,+BAA+B,CAAC;AAKvC,OAAO,EAAE,KAAK,wBAAwB,EAAqB,MAAM,0BAA0B,CAAC;AAK5F,MAAM,WAAW,sBAAuB,SAAQ,WAAW;IAC1D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAsPD,MAAM,WAAW,+BAAgC,SAAQ,IAAI,CAAC,mBAAmB,EAAE,aAAa,GAAG,OAAO,CAAC;IAC1G,GAAG,EAAE,YAAY,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kHAAkH;IAClH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,sBAAsB,EAAE,CAAC;IACjC,mBAAmB,CAAC,EAAE,IAAI,CAAC,wBAAwB,EAAE,KAAK,GAAG,kBAAkB,GAAG,eAAe,GAAG,cAAc,CAAC,CAAC;CACpH;AAED,MAAM,WAAW,0CAA0C;IAC1D,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACzC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,mBAAmB,CAAC,EAAE,+BAA+B,CAAC,qBAAqB,CAAC,CAAC;CAC7E;AAED,wBAAgB,mCAAmC,CAAC,OAAO,EAAE,0CAA0C,GAAG,MAAM,CAsB/G;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,wBAAwB,CAAC,OAAO,EAAE,+BAA+B;;;GAkFtF"}

package/dist/server/create-harness.js

@@ -0,0 +1,349 @@
+import { AgentHarness, } from "@earendil-works/pi-agent-core";
+import { minimatch } from "minimatch";
+import { buildSystemPrompt } from "../core/system-prompt.js";
+import { createCodingToolDefinitions } from "../core/tools/index.js";
+import { detectSupportedImageMimeType } from "../utils/mime.js";
+function createCodingAgentHarnessTool(options) {
+    const { definition, getContext } = options;
+    return {
+        ...definition,
+        promptSnippet: definition.promptSnippet,
+        promptGuidelines: definition.promptGuidelines ? [...definition.promptGuidelines] : undefined,
+        execute: async (toolCallId, params, signal, onUpdate) => definition.execute(toolCallId, params, signal, onUpdate, await getContext()),
+    };
+}
+function normalizeBashExecutionError(error, timeout) {
+    if (error.code === "aborted")
+        return new Error("aborted", { cause: error });
+    if (error.code === "timeout") {
+        const message = error.message.startsWith("timeout:") ? error.message : `timeout:${timeout ?? ""}`;
+        return new Error(message, { cause: error });
+    }
+    return error;
+}
+function unwrapFileResult(result) {
+    if (result.ok)
+        return result.value;
+    throw result.error;
+}
+function unsupportedHarnessOperation(operation) {
+    throw new Error(`Coding-agent Harness does not provide ${operation}`);
+}
+async function findExecutionEnvGlob(env, pattern, root, options) {
+    const matches = [];
+    const normalizedPattern = pattern.replaceAll("\\", "/");
+    const matchOptions = { dot: true, matchBase: !normalizedPattern.includes("/") };
+    const hasHiddenSegment = (value) => value.split("/").some((segment) => segment.startsWith(".") && segment.length > 1);
+    const isIgnored = (value, isDirectory) => options.ignore.some((ignorePattern) => minimatch(value, ignorePattern, { dot: true }) ||
+        (isDirectory && minimatch(`${value}/__entry__`, ignorePattern, { dot: true })));
+    const walk = async (directory, prefix) => {
+        if (matches.length >= options.limit)
+            return;
+        const result = await env.listDir(directory);
+        if (!result.ok)
+            return;
+        const entries = result.value.sort((left, right) => left.name.localeCompare(right.name));
+        for (const entry of entries) {
+            if (matches.length >= options.limit)
+                return;
+            const relativePath = prefix ? `${prefix}/${entry.name}` : entry.name;
+            if (!options.hidden && hasHiddenSegment(relativePath))
+                continue;
+            const isDirectory = entry.kind === "directory";
+            if (isIgnored(relativePath, isDirectory))
+                continue;
+            if (minimatch(relativePath, normalizedPattern, matchOptions))
+                matches.push(isDirectory ? `${relativePath}/` : relativePath);
+            if (isDirectory)
+                await walk(entry.path, relativePath);
+        }
+    };
+    const rootInfo = await env.fileInfo(root);
+    let walkRoot = root;
+    if (rootInfo.ok && rootInfo.value.kind === "symlink") {
+        const canonical = await env.canonicalPath(root);
+        if (canonical.ok)
+            walkRoot = canonical.value;
+    }
+    await walk(walkRoot, "");
+    return matches;
+}
+async function findExecutionEnvStat(env, path) {
+    const result = await env.fileInfo(path);
+    if (!result.ok)
+        return undefined;
+    if (result.value.kind !== "symlink") {
+        return { isFile: result.value.kind === "file", isDirectory: result.value.kind === "directory" };
+    }
+    const canonical = await env.canonicalPath(path);
+    if (!canonical.ok)
+        return undefined;
+    const target = await env.fileInfo(canonical.value);
+    if (!target.ok)
+        return undefined;
+    return { isFile: target.value.kind === "file", isDirectory: target.value.kind === "directory" };
+}
+async function toExecutionEnvDirectoryEntry(env, info) {
+    if (info.kind !== "symlink")
+        return {
+            name: info.name,
+            path: info.path,
+            isDirectory: info.kind === "directory",
+            mtimeMs: info.mtimeMs,
+            size: info.size,
+        };
+    const canonical = await env.canonicalPath(info.path);
+    if (!canonical.ok)
+        return undefined;
+    const target = await env.fileInfo(canonical.value);
+    if (!target.ok)
+        return undefined;
+    return {
+        name: info.name,
+        path: canonical.value,
+        isDirectory: target.value.kind === "directory",
+        mtimeMs: target.value.mtimeMs,
+        size: target.value.size,
+    };
+}
+async function listExecutionEnvDirectory(env, path) {
+    let result = await env.listDir(path);
+    if (!result.ok) {
+        const info = await env.fileInfo(path);
+        if (!info.ok || info.value.kind !== "symlink")
+            return undefined;
+        const canonical = await env.canonicalPath(path);
+        if (!canonical.ok)
+            return undefined;
+        result = await env.listDir(canonical.value);
+    }
+    if (!result.ok)
+        return undefined;
+    const entries = await Promise.all(result.value.map((entry) => toExecutionEnvDirectoryEntry(env, entry)));
+    return entries.filter((entry) => entry !== undefined);
+}
+function createExecutionEnvToolOptions(env, commandPrefix, sessionFile) {
+    return {
+        read: {
+            operations: {
+                readFile: async (path) => Buffer.from(unwrapFileResult(await env.readBinaryFile(path))),
+                access: async (path) => {
+                    unwrapFileResult(await env.fileInfo(path));
+                },
+                stat: (path) => findExecutionEnvStat(env, path),
+                listDir: (path) => listExecutionEnvDirectory(env, path),
+                detectImageMimeType: async (path) => detectSupportedImageMimeType(unwrapFileResult(await env.readBinaryFile(path))),
+            },
+        },
+        bash: {
+            commandPrefix,
+            // Atomic's bash tool normally hands operations the full local spawn
+            // environment. The injected ExecutionEnv owns the base environment;
+            // keep only the session and per-command overlays at this boundary.
+            spawnHook: (context) => ({ ...context, env: {} }),
+            operations: {
+                exec: async (command, cwd, options) => {
+                    const envOverrides = {};
+                    for (const [key, value] of Object.entries(options.env ?? {})) {
+                        if (typeof value === "string")
+                            envOverrides[key] = value;
+                    }
+                    if (sessionFile === undefined) {
+                        envOverrides.ATOMIC_SESSION_FILE = "";
+                        envOverrides.PI_SESSION_FILE = "";
+                    }
+                    const result = await env.exec(command, {
+                        cwd,
+                        env: envOverrides,
+                        timeout: options.timeout,
+                        abortSignal: options.signal,
+                        onStdout: (chunk) => options.onData(Buffer.from(chunk), "stdout"),
+                        onStderr: (chunk) => options.onData(Buffer.from(chunk), "stderr"),
+                    });
+                    if (!result.ok)
+                        throw normalizeBashExecutionError(result.error, options.timeout);
+                    return { exitCode: result.value.exitCode };
+                },
+            },
+        },
+        edit: {
+            operations: {
+                readFile: async (path) => Buffer.from(unwrapFileResult(await env.readBinaryFile(path))),
+                writeFile: async (path, content) => {
+                    unwrapFileResult(await env.writeFile(path, content));
+                },
+                access: async (path) => {
+                    const info = unwrapFileResult(await env.fileInfo(path));
+                    if (info.kind !== "file" && info.kind !== "symlink")
+                        throw new Error(`Cannot edit non-file path: ${path}`);
+                },
+            },
+        },
+        write: {
+            operations: {
+                writeFile: async (path, content) => {
+                    unwrapFileResult(await env.writeFile(path, content));
+                },
+                mkdir: async (path) => {
+                    unwrapFileResult(await env.createDir(path));
+                },
+            },
+        },
+        find: {
+            operations: {
+                exists: async (path) => {
+                    const result = await env.exists(path);
+                    return result.ok && result.value;
+                },
+                stat: (path) => findExecutionEnvStat(env, path),
+                glob: (pattern, cwd, globOptions) => findExecutionEnvGlob(env, pattern, cwd, globOptions),
+            },
+        },
+    };
+}
+function assertExecutionEnv(env) {
+    if (typeof env?.renameFile !== "function") {
+        throw new TypeError("Coding-agent Harness requires ExecutionEnv.renameFile() to be implemented");
+    }
+}
+function createHarnessSessionManager(metadataId, sessionFile) {
+    return {
+        getCwd: () => unsupportedHarnessOperation("sessionManager.getCwd()"),
+        // The factory has no local session directory. URL reads still use the session id for cache scope,
+        // but skip host-local artifact persistence rather than treating the ExecutionEnv cwd as local storage.
+        getSessionDir: () => "",
+        usesDefaultSessionDir: () => unsupportedHarnessOperation("sessionManager.usesDefaultSessionDir()"),
+        getSessionId: () => metadataId,
+        getSessionFile: () => sessionFile,
+        getLeafId: () => unsupportedHarnessOperation("sessionManager.getLeafId()"),
+        getLeafEntry: () => unsupportedHarnessOperation("sessionManager.getLeafEntry()"),
+        getEntry: () => unsupportedHarnessOperation("sessionManager.getEntry()"),
+        getLabel: () => unsupportedHarnessOperation("sessionManager.getLabel()"),
+        getBranch: () => unsupportedHarnessOperation("sessionManager.getBranch()"),
+        getHeader: () => unsupportedHarnessOperation("sessionManager.getHeader()"),
+        getEntries: () => unsupportedHarnessOperation("sessionManager.getEntries()"),
+        getTree: () => unsupportedHarnessOperation("sessionManager.getTree()"),
+        getSessionName: () => unsupportedHarnessOperation("sessionManager.getSessionName()"),
+    };
+}
+export function buildCodingAgentHarnessSystemPrompt(options) {
+    const activeTools = options.activeToolNames.flatMap((name) => {
+        const tool = options.tools.find((candidate) => candidate.name === name);
+        return tool ? [tool] : [];
+    });
+    const toolSnippets = Object.fromEntries(activeTools.flatMap((tool) => {
+        const promptSnippet = tool.promptSnippet
+            ?.replace(/[\r\n]+/g, " ")
+            .replace(/\s+/g, " ")
+            .trim();
+        return promptSnippet ? [[tool.name, promptSnippet]] : [];
+    }));
+    const promptGuidelines = activeTools.flatMap((tool) => tool.promptGuidelines ?? []);
+    return buildSystemPrompt({
+        ...options.systemPromptOptions,
+        cwd: options.cwd,
+        selectedTools: activeTools.map((tool) => tool.name),
+        toolSnippets,
+        promptGuidelines,
+    });
+}
+/**
+ * AgentHarness v2 is a configuration scaffold in pi-agent-core 0.84.1. The
+ * factory setup reaches `AgentHarness.create` (for a fresh session),
+ * `Session.getMetadata`, `getModel`, `getThinkingLevel`, `getTools`,
+ * `getActiveTools`, the default system-prompt callback, Atomic tool execution,
+ * and `close()` on the returned harness. The returned harness also exposes the
+ * implemented state/configuration getters and setters for model, thinking
+ * level, active tools, tools, resources, stream options, retry, compaction,
+ * steering, and follow-up modes. Its default tools route the primary operations
+ * for read, bash, edit, write, and find through the injected `ExecutionEnv`;
+ * read and edit still use Atomic's local path-variant probes and notebook
+ * projection; read also uses local archive, SQLite, and internal-resource
+ * selectors, while write still uses local generated-file, shebang, conflict,
+ * and resource helpers. Bash validates its cwd locally and uses Atomic's local
+ * temp storage for overflow output. URL fetches use the process network and do
+ * not persist host-local artifacts in this factory. `search` still uses Atomic's
+ * local filesystem/ripgrep pipeline
+ * until that tool gains a complete remote operations seam. It does not invoke
+ * `prompt`, `skill`,
+ * `promptFromTemplate`, `compact`, `navigateTree`, `resume`, `steer`, `followUp`,
+ * `nextRun`, `cancelQueued`, `recordUsage`, `abort`, `waitForIdle`,
+ * `runWhenIdle`, `peekAction`, `executeAction`, `runToCompletion`, `watch`,
+ * `lane`, `createLane`, `lanes`, `watchSession`, `hooks.on`, or `events.on`;
+ * those unfinished paths reject with `HarnessNotImplemented` at runtime. A
+ * session with existing records also reaches `create.restore`, which is
+ * intentionally outside this factory layer.
+ */
+export async function createCodingAgentHarness(options) {
+    assertExecutionEnv(options.env);
+    const { env, bashCommandPrefix, sessionFile, systemPromptOptions, tools: providedTools, activeToolNames: providedActiveToolNames, systemPrompt: providedSystemPrompt, ...harnessOptions } = options;
+    let harness;
+    const getHarness = () => {
+        if (!harness)
+            throw new Error("Coding-agent Harness callback ran before Harness initialization");
+        return harness;
+    };
+    let tools = providedTools;
+    if (tools === undefined) {
+        const metadata = await options.session.getMetadata();
+        const sessionManager = createHarnessSessionManager(metadata.id, sessionFile);
+        const getContext = async () => {
+            const currentHarness = getHarness();
+            const [model, thinkingLevel] = await Promise.all([
+                currentHarness.getModel(),
+                currentHarness.getThinkingLevel(),
+            ]);
+            const context = {
+                get ui() {
+                    return unsupportedHarnessOperation("context.ui");
+                },
+                mode: "rpc",
+                hasUI: false,
+                cwd: env.cwd,
+                sessionManager,
+                get modelRegistry() {
+                    return unsupportedHarnessOperation("context.modelRegistry");
+                },
+                model,
+                scopedModels: [],
+                thinkingLevel,
+                isIdle: () => true,
+                isProjectTrusted: () => false,
+                signal: undefined,
+                abort: () => unsupportedHarnessOperation("context.abort()"),
+                hasPendingMessages: () => false,
+                shutdown: () => unsupportedHarnessOperation("context.shutdown()"),
+                getContextUsage: () => undefined,
+                compact: () => unsupportedHarnessOperation("context.compact()"),
+                getSystemPrompt: () => unsupportedHarnessOperation("context.getSystemPrompt()"),
+            };
+            return context;
+        };
+        const toolOptions = createExecutionEnvToolOptions(env, bashCommandPrefix, sessionFile);
+        tools = createCodingToolDefinitions(env.cwd, toolOptions).map((definition) => createCodingAgentHarnessTool({ definition, getContext }));
+    }
+    const activeToolNames = [...(providedActiveToolNames ?? tools.map((tool) => tool.name))];
+    const systemPrompt = providedSystemPrompt ??
+        (async () => {
+            const currentHarness = getHarness();
+            const [currentTools, currentActiveToolNames] = await Promise.all([
+                currentHarness.getTools(),
+                currentHarness.getActiveTools(),
+            ]);
+            return buildCodingAgentHarnessSystemPrompt({
+                cwd: env.cwd,
+                tools: currentTools,
+                activeToolNames: currentActiveToolNames,
+                systemPromptOptions,
+            });
+        });
+    const created = await AgentHarness.create({
+        ...harnessOptions,
+        tools,
+        activeToolNames,
+        systemPrompt,
+    });
+    harness = created.harness;
+    return created;
+}
+//# sourceMappingURL=create-harness.js.map

package/dist/server/create-harness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-harness.js","sourceRoot":"","sources":["../../src/server/create-harness.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n\tAgentHarness,\n\ttype AgentHarnessOptions,\n\ttype ExecutionEnv,\n\ttype ExecutionError,\n\ttype FileError,\n\ttype FileInfo,\n\ttype HarnessTool,\n\ttype Result,\n} from \"@earendil-works/pi-agent-core\";\nimport { minimatch } from \"minimatch\";\nimport type { Static, TSchema } from \"typebox\";\nimport type { ExtensionContext, ToolDefinition } from \"../core/extensions/types.ts\";\nimport type { ReadonlySessionManager } from \"../core/session-manager.ts\";\nimport { type BuildSystemPromptOptions, buildSystemPrompt } from \"../core/system-prompt.ts\";\nimport type { DirectoryTreeEntry } from \"../core/tools/directory-tree.ts\";\nimport { createCodingToolDefinitions, type ToolsOptions } from \"../core/tools/index.ts\";\nimport { detectSupportedImageMimeType } from \"../utils/mime.ts\";\n\nexport interface CodingAgentHarnessTool extends HarnessTool {\n\tpromptSnippet?: string;\n\tpromptGuidelines?: string[];\n}\n\ntype CodingAgentToolDefinition<TParameters extends TSchema, TDetails> = {\n\tdefinition: ToolDefinition<TParameters, TDetails>;\n\tgetContext: () => Promise<ExtensionContext>;\n};\n\nfunction createCodingAgentHarnessTool<TParameters extends TSchema, TDetails>(\n\toptions: CodingAgentToolDefinition<TParameters, TDetails>,\n): CodingAgentHarnessTool {\n\tconst { definition, getContext } = options;\n\treturn {\n\t\t...definition,\n\t\tpromptSnippet: definition.promptSnippet,\n\t\tpromptGuidelines: definition.promptGuidelines ? [...definition.promptGuidelines] : undefined,\n\t\texecute: async (toolCallId, params, signal, onUpdate) =>\n\t\t\tdefinition.execute(toolCallId, params as Static<TParameters>, signal, onUpdate, await getContext()),\n\t};\n}\n\nfunction normalizeBashExecutionError(error: ExecutionError, timeout: number | undefined): Error {\n\tif (error.code === \"aborted\") return new Error(\"aborted\", { cause: error });\n\tif (error.code === \"timeout\") {\n\t\tconst message = error.message.startsWith(\"timeout:\") ? error.message : `timeout:${timeout ?? \"\"}`;\n\t\treturn new Error(message, { cause: error });\n\t}\n\treturn error;\n}\n\nfunction unwrapFileResult<TValue>(result: Result<TValue, FileError>): TValue {\n\tif (result.ok) return result.value;\n\tthrow result.error;\n}\n\nfunction unsupportedHarnessOperation(operation: string): never {\n\tthrow new Error(`Coding-agent Harness does not provide ${operation}`);\n}\n\nasync function findExecutionEnvGlob(\n\tenv: ExecutionEnv,\n\tpattern: string,\n\troot: string,\n\toptions: { ignore: string[]; limit: number; hidden: boolean },\n): Promise<string[]> {\n\tconst matches: string[] = [];\n\tconst normalizedPattern = pattern.replaceAll(\"\\\\\", \"/\");\n\tconst matchOptions = { dot: true, matchBase: !normalizedPattern.includes(\"/\") };\n\tconst hasHiddenSegment = (value: string): boolean =>\n\t\tvalue.split(\"/\").some((segment) => segment.startsWith(\".\") && segment.length > 1);\n\tconst isIgnored = (value: string, isDirectory: boolean): boolean =>\n\t\toptions.ignore.some(\n\t\t\t(ignorePattern) =>\n\t\t\t\tminimatch(value, ignorePattern, { dot: true }) ||\n\t\t\t\t(isDirectory && minimatch(`${value}/__entry__`, ignorePattern, { dot: true })),\n\t\t);\n\tconst walk = async (directory: string, prefix: string): Promise<void> => {\n\t\tif (matches.length >= options.limit) return;\n\t\tconst result = await env.listDir(directory);\n\t\tif (!result.ok) return;\n\t\tconst entries = result.value.sort((left, right) => left.name.localeCompare(right.name));\n\t\tfor (const entry of entries) {\n\t\t\tif (matches.length >= options.limit) return;\n\t\t\tconst relativePath = prefix ? `${prefix}/${entry.name}` : entry.name;\n\t\t\tif (!options.hidden && hasHiddenSegment(relativePath)) continue;\n\t\t\tconst isDirectory = entry.kind === \"directory\";\n\t\t\tif (isIgnored(relativePath, isDirectory)) continue;\n\t\t\tif (minimatch(relativePath, normalizedPattern, matchOptions))\n\t\t\t\tmatches.push(isDirectory ? `${relativePath}/` : relativePath);\n\t\t\tif (isDirectory) await walk(entry.path, relativePath);\n\t\t}\n\t};\n\tconst rootInfo = await env.fileInfo(root);\n\tlet walkRoot = root;\n\tif (rootInfo.ok && rootInfo.value.kind === \"symlink\") {\n\t\tconst canonical = await env.canonicalPath(root);\n\t\tif (canonical.ok) walkRoot = canonical.value;\n\t}\n\tawait walk(walkRoot, \"\");\n\treturn matches;\n}\n\nasync function findExecutionEnvStat(\n\tenv: ExecutionEnv,\n\tpath: string,\n): Promise<{ isFile: boolean; isDirectory: boolean } | undefined> {\n\tconst result = await env.fileInfo(path);\n\tif (!result.ok) return undefined;\n\tif (result.value.kind !== \"symlink\") {\n\t\treturn { isFile: result.value.kind === \"file\", isDirectory: result.value.kind === \"directory\" };\n\t}\n\tconst canonical = await env.canonicalPath(path);\n\tif (!canonical.ok) return undefined;\n\tconst target = await env.fileInfo(canonical.value);\n\tif (!target.ok) return undefined;\n\treturn { isFile: target.value.kind === \"file\", isDirectory: target.value.kind === \"directory\" };\n}\n\nasync function toExecutionEnvDirectoryEntry(\n\tenv: ExecutionEnv,\n\tinfo: FileInfo,\n): Promise<DirectoryTreeEntry | undefined> {\n\tif (info.kind !== \"symlink\")\n\t\treturn {\n\t\t\tname: info.name,\n\t\t\tpath: info.path,\n\t\t\tisDirectory: info.kind === \"directory\",\n\t\t\tmtimeMs: info.mtimeMs,\n\t\t\tsize: info.size,\n\t\t};\n\tconst canonical = await env.canonicalPath(info.path);\n\tif (!canonical.ok) return undefined;\n\tconst target = await env.fileInfo(canonical.value);\n\tif (!target.ok) return undefined;\n\treturn {\n\t\tname: info.name,\n\t\tpath: canonical.value,\n\t\tisDirectory: target.value.kind === \"directory\",\n\t\tmtimeMs: target.value.mtimeMs,\n\t\tsize: target.value.size,\n\t};\n}\n\nasync function listExecutionEnvDirectory(env: ExecutionEnv, path: string): Promise<DirectoryTreeEntry[] | undefined> {\n\tlet result = await env.listDir(path);\n\tif (!result.ok) {\n\t\tconst info = await env.fileInfo(path);\n\t\tif (!info.ok || info.value.kind !== \"symlink\") return undefined;\n\t\tconst canonical = await env.canonicalPath(path);\n\t\tif (!canonical.ok) return undefined;\n\t\tresult = await env.listDir(canonical.value);\n\t}\n\tif (!result.ok) return undefined;\n\tconst entries = await Promise.all(result.value.map((entry) => toExecutionEnvDirectoryEntry(env, entry)));\n\treturn entries.filter((entry): entry is DirectoryTreeEntry => entry !== undefined);\n}\n\nfunction createExecutionEnvToolOptions(\n\tenv: ExecutionEnv,\n\tcommandPrefix: string | undefined,\n\tsessionFile: string | undefined,\n): ToolsOptions {\n\treturn {\n\t\tread: {\n\t\t\toperations: {\n\t\t\t\treadFile: async (path) => Buffer.from(unwrapFileResult(await env.readBinaryFile(path))),\n\t\t\t\taccess: async (path) => {\n\t\t\t\t\tunwrapFileResult(await env.fileInfo(path));\n\t\t\t\t},\n\t\t\t\tstat: (path) => findExecutionEnvStat(env, path),\n\t\t\t\tlistDir: (path) => listExecutionEnvDirectory(env, path),\n\t\t\t\tdetectImageMimeType: async (path) =>\n\t\t\t\t\tdetectSupportedImageMimeType(unwrapFileResult(await env.readBinaryFile(path))),\n\t\t\t},\n\t\t},\n\t\tbash: {\n\t\t\tcommandPrefix,\n\t\t\t// Atomic's bash tool normally hands operations the full local spawn\n\t\t\t// environment. The injected ExecutionEnv owns the base environment;\n\t\t\t// keep only the session and per-command overlays at this boundary.\n\t\t\tspawnHook: (context) => ({ ...context, env: {} }),\n\t\t\toperations: {\n\t\t\t\texec: async (command, cwd, options) => {\n\t\t\t\t\tconst envOverrides: Record<string, string> = {};\n\t\t\t\t\tfor (const [key, value] of Object.entries(options.env ?? {})) {\n\t\t\t\t\t\tif (typeof value === \"string\") envOverrides[key] = value;\n\t\t\t\t\t}\n\t\t\t\t\tif (sessionFile === undefined) {\n\t\t\t\t\t\tenvOverrides.ATOMIC_SESSION_FILE = \"\";\n\t\t\t\t\t\tenvOverrides.PI_SESSION_FILE = \"\";\n\t\t\t\t\t}\n\t\t\t\t\tconst result = await env.exec(command, {\n\t\t\t\t\t\tcwd,\n\t\t\t\t\t\tenv: envOverrides,\n\t\t\t\t\t\ttimeout: options.timeout,\n\t\t\t\t\t\tabortSignal: options.signal,\n\t\t\t\t\t\tonStdout: (chunk) => options.onData(Buffer.from(chunk), \"stdout\"),\n\t\t\t\t\t\tonStderr: (chunk) => options.onData(Buffer.from(chunk), \"stderr\"),\n\t\t\t\t\t});\n\t\t\t\t\tif (!result.ok) throw normalizeBashExecutionError(result.error, options.timeout);\n\t\t\t\t\treturn { exitCode: result.value.exitCode };\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\tedit: {\n\t\t\toperations: {\n\t\t\t\treadFile: async (path) => Buffer.from(unwrapFileResult(await env.readBinaryFile(path))),\n\t\t\t\twriteFile: async (path, content) => {\n\t\t\t\t\tunwrapFileResult(await env.writeFile(path, content));\n\t\t\t\t},\n\t\t\t\taccess: async (path) => {\n\t\t\t\t\tconst info = unwrapFileResult(await env.fileInfo(path));\n\t\t\t\t\tif (info.kind !== \"file\" && info.kind !== \"symlink\")\n\t\t\t\t\t\tthrow new Error(`Cannot edit non-file path: ${path}`);\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\twrite: {\n\t\t\toperations: {\n\t\t\t\twriteFile: async (path, content) => {\n\t\t\t\t\tunwrapFileResult(await env.writeFile(path, content));\n\t\t\t\t},\n\t\t\t\tmkdir: async (path) => {\n\t\t\t\t\tunwrapFileResult(await env.createDir(path));\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\tfind: {\n\t\t\toperations: {\n\t\t\t\texists: async (path) => {\n\t\t\t\t\tconst result = await env.exists(path);\n\t\t\t\t\treturn result.ok && result.value;\n\t\t\t\t},\n\t\t\t\tstat: (path) => findExecutionEnvStat(env, path),\n\t\t\t\tglob: (pattern, cwd, globOptions) => findExecutionEnvGlob(env, pattern, cwd, globOptions),\n\t\t\t},\n\t\t},\n\t};\n}\n\nfunction assertExecutionEnv(env: ExecutionEnv): void {\n\tif (typeof env?.renameFile !== \"function\") {\n\t\tthrow new TypeError(\"Coding-agent Harness requires ExecutionEnv.renameFile() to be implemented\");\n\t}\n}\n\nfunction createHarnessSessionManager(metadataId: string, sessionFile: string | undefined): ReadonlySessionManager {\n\treturn {\n\t\tgetCwd: () => unsupportedHarnessOperation(\"sessionManager.getCwd()\"),\n\t\t// The factory has no local session directory. URL reads still use the session id for cache scope,\n\t\t// but skip host-local artifact persistence rather than treating the ExecutionEnv cwd as local storage.\n\t\tgetSessionDir: () => \"\",\n\t\tusesDefaultSessionDir: () => unsupportedHarnessOperation(\"sessionManager.usesDefaultSessionDir()\"),\n\t\tgetSessionId: () => metadataId,\n\t\tgetSessionFile: () => sessionFile,\n\t\tgetLeafId: () => unsupportedHarnessOperation(\"sessionManager.getLeafId()\"),\n\t\tgetLeafEntry: () => unsupportedHarnessOperation(\"sessionManager.getLeafEntry()\"),\n\t\tgetEntry: () => unsupportedHarnessOperation(\"sessionManager.getEntry()\"),\n\t\tgetLabel: () => unsupportedHarnessOperation(\"sessionManager.getLabel()\"),\n\t\tgetBranch: () => unsupportedHarnessOperation(\"sessionManager.getBranch()\"),\n\t\tgetHeader: () => unsupportedHarnessOperation(\"sessionManager.getHeader()\"),\n\t\tgetEntries: () => unsupportedHarnessOperation(\"sessionManager.getEntries()\"),\n\t\tgetTree: () => unsupportedHarnessOperation(\"sessionManager.getTree()\"),\n\t\tgetSessionName: () => unsupportedHarnessOperation(\"sessionManager.getSessionName()\"),\n\t};\n}\n\nexport interface CreateCodingAgentHarnessOptions extends Omit<AgentHarnessOptions, \"toolContext\" | \"tools\"> {\n\tenv: ExecutionEnv;\n\tbashCommandPrefix?: string;\n\t/** Path to the JSONL session file exposed to default bash commands as ATOMIC_SESSION_FILE and PI_SESSION_FILE. */\n\tsessionFile?: string;\n\ttools?: CodingAgentHarnessTool[];\n\tsystemPromptOptions?: Omit<BuildSystemPromptOptions, \"cwd\" | \"promptGuidelines\" | \"selectedTools\" | \"toolSnippets\">;\n}\n\nexport interface BuildCodingAgentHarnessSystemPromptOptions {\n\tcwd: string;\n\ttools: readonly CodingAgentHarnessTool[];\n\tactiveToolNames: readonly string[];\n\tsystemPromptOptions?: CreateCodingAgentHarnessOptions[\"systemPromptOptions\"];\n}\n\nexport function buildCodingAgentHarnessSystemPrompt(options: BuildCodingAgentHarnessSystemPromptOptions): string {\n\tconst activeTools = options.activeToolNames.flatMap((name) => {\n\t\tconst tool = options.tools.find((candidate) => candidate.name === name);\n\t\treturn tool ? [tool] : [];\n\t});\n\tconst toolSnippets = Object.fromEntries(\n\t\tactiveTools.flatMap((tool) => {\n\t\t\tconst promptSnippet = tool.promptSnippet\n\t\t\t\t?.replace(/[\\r\\n]+/g, \" \")\n\t\t\t\t.replace(/\\s+/g, \" \")\n\t\t\t\t.trim();\n\t\t\treturn promptSnippet ? [[tool.name, promptSnippet]] : [];\n\t\t}),\n\t);\n\tconst promptGuidelines = activeTools.flatMap((tool) => tool.promptGuidelines ?? []);\n\treturn buildSystemPrompt({\n\t\t...options.systemPromptOptions,\n\t\tcwd: options.cwd,\n\t\tselectedTools: activeTools.map((tool) => tool.name),\n\t\ttoolSnippets,\n\t\tpromptGuidelines,\n\t});\n}\n\n/**\n * AgentHarness v2 is a configuration scaffold in pi-agent-core 0.84.1. The\n * factory setup reaches `AgentHarness.create` (for a fresh session),\n * `Session.getMetadata`, `getModel`, `getThinkingLevel`, `getTools`,\n * `getActiveTools`, the default system-prompt callback, Atomic tool execution,\n * and `close()` on the returned harness. The returned harness also exposes the\n * implemented state/configuration getters and setters for model, thinking\n * level, active tools, tools, resources, stream options, retry, compaction,\n * steering, and follow-up modes. Its default tools route the primary operations\n * for read, bash, edit, write, and find through the injected `ExecutionEnv`;\n * read and edit still use Atomic's local path-variant probes and notebook\n * projection; read also uses local archive, SQLite, and internal-resource\n * selectors, while write still uses local generated-file, shebang, conflict,\n * and resource helpers. Bash validates its cwd locally and uses Atomic's local\n * temp storage for overflow output. URL fetches use the process network and do\n * not persist host-local artifacts in this factory. `search` still uses Atomic's\n * local filesystem/ripgrep pipeline\n * until that tool gains a complete remote operations seam. It does not invoke\n * `prompt`, `skill`,\n * `promptFromTemplate`, `compact`, `navigateTree`, `resume`, `steer`, `followUp`,\n * `nextRun`, `cancelQueued`, `recordUsage`, `abort`, `waitForIdle`,\n * `runWhenIdle`, `peekAction`, `executeAction`, `runToCompletion`, `watch`,\n * `lane`, `createLane`, `lanes`, `watchSession`, `hooks.on`, or `events.on`;\n * those unfinished paths reject with `HarnessNotImplemented` at runtime. A\n * session with existing records also reaches `create.restore`, which is\n * intentionally outside this factory layer.\n */\nexport async function createCodingAgentHarness(options: CreateCodingAgentHarnessOptions) {\n\tassertExecutionEnv(options.env);\n\tconst {\n\t\tenv,\n\t\tbashCommandPrefix,\n\t\tsessionFile,\n\t\tsystemPromptOptions,\n\t\ttools: providedTools,\n\t\tactiveToolNames: providedActiveToolNames,\n\t\tsystemPrompt: providedSystemPrompt,\n\t\t...harnessOptions\n\t} = options;\n\tlet harness: AgentHarness | undefined;\n\tconst getHarness = (): AgentHarness => {\n\t\tif (!harness) throw new Error(\"Coding-agent Harness callback ran before Harness initialization\");\n\t\treturn harness;\n\t};\n\tlet tools = providedTools;\n\tif (tools === undefined) {\n\t\tconst metadata = await options.session.getMetadata();\n\t\tconst sessionManager = createHarnessSessionManager(metadata.id, sessionFile);\n\t\tconst getContext = async (): Promise<ExtensionContext> => {\n\t\t\tconst currentHarness = getHarness();\n\t\t\tconst [model, thinkingLevel] = await Promise.all([\n\t\t\t\tcurrentHarness.getModel(),\n\t\t\t\tcurrentHarness.getThinkingLevel(),\n\t\t\t]);\n\t\t\tconst context = {\n\t\t\t\tget ui() {\n\t\t\t\t\treturn unsupportedHarnessOperation(\"context.ui\");\n\t\t\t\t},\n\t\t\t\tmode: \"rpc\",\n\t\t\t\thasUI: false,\n\t\t\t\tcwd: env.cwd,\n\t\t\t\tsessionManager,\n\t\t\t\tget modelRegistry() {\n\t\t\t\t\treturn unsupportedHarnessOperation(\"context.modelRegistry\");\n\t\t\t\t},\n\t\t\t\tmodel,\n\t\t\t\tscopedModels: [],\n\t\t\t\tthinkingLevel,\n\t\t\t\tisIdle: () => true,\n\t\t\t\tisProjectTrusted: () => false,\n\t\t\t\tsignal: undefined,\n\t\t\t\tabort: () => unsupportedHarnessOperation(\"context.abort()\"),\n\t\t\t\thasPendingMessages: () => false,\n\t\t\t\tshutdown: () => unsupportedHarnessOperation(\"context.shutdown()\"),\n\t\t\t\tgetContextUsage: () => undefined,\n\t\t\t\tcompact: () => unsupportedHarnessOperation(\"context.compact()\"),\n\t\t\t\tgetSystemPrompt: () => unsupportedHarnessOperation(\"context.getSystemPrompt()\"),\n\t\t\t} satisfies ExtensionContext;\n\t\t\treturn context;\n\t\t};\n\t\tconst toolOptions = createExecutionEnvToolOptions(env, bashCommandPrefix, sessionFile);\n\t\ttools = createCodingToolDefinitions(env.cwd, toolOptions).map((definition) =>\n\t\t\tcreateCodingAgentHarnessTool({ definition, getContext }),\n\t\t);\n\t}\n\tconst activeToolNames = [...(providedActiveToolNames ?? tools.map((tool) => tool.name))];\n\tconst systemPrompt =\n\t\tprovidedSystemPrompt ??\n\t\t(async () => {\n\t\t\tconst currentHarness = getHarness();\n\t\t\tconst [currentTools, currentActiveToolNames] = await Promise.all([\n\t\t\t\tcurrentHarness.getTools(),\n\t\t\t\tcurrentHarness.getActiveTools(),\n\t\t\t]);\n\t\t\treturn buildCodingAgentHarnessSystemPrompt({\n\t\t\t\tcwd: env.cwd,\n\t\t\t\ttools: currentTools,\n\t\t\t\tactiveToolNames: currentActiveToolNames,\n\t\t\t\tsystemPromptOptions,\n\t\t\t});\n\t\t});\n\tconst created = await AgentHarness.create({\n\t\t...harnessOptions,\n\t\ttools,\n\t\tactiveToolNames,\n\t\tsystemPrompt,\n\t});\n\tharness = created.harness;\n\treturn created;\n}\n"]}

package/dist/utils/agent-attribution.d.ts

@@ -0,0 +1,2 @@
+export declare const ATOMIC_AI_AGENT: "atomic";
+//# sourceMappingURL=agent-attribution.d.ts.map

package/dist/utils/agent-attribution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-attribution.d.ts","sourceRoot":"","sources":["../../src/utils/agent-attribution.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,EAAG,QAAiB,CAAC"}

package/dist/utils/agent-attribution.js

@@ -0,0 +1,2 @@
+export const ATOMIC_AI_AGENT = "atomic";
+//# sourceMappingURL=agent-attribution.js.map

package/dist/utils/agent-attribution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-attribution.js","sourceRoot":"","sources":["../../src/utils/agent-attribution.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAAG,QAAiB,CAAC","sourcesContent":["export const ATOMIC_AI_AGENT = \"atomic\" as const;\n"]}

package/dist/utils/child-process.d.ts

@@ -1,5 +1,8 @@
 import { type ChildProcess, type ChildProcessByStdio, type SpawnOptions, type SpawnOptionsWithStdioTuple, type SpawnSyncOptionsWithStringEncoding, type SpawnSyncReturns, type StdioNull, type StdioPipe } from "node:child_process";
 import type { Readable } from "node:stream";
+/** Build the environment for every Atomic child process. */
+export { ATOMIC_AI_AGENT } from "./agent-attribution.ts";
+export declare function createChildProcessEnvironment(overrides?: NodeJS.ProcessEnv, baseEnv?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
 type WaitForChildProcessOptions = {
     platform?: NodeJS.Platform;
     isWindowsProcessAlive?: (pid: number) => boolean;
@@ -24,5 +27,4 @@ export declare function spawnProcessSync(command: string, args: string[], option
  * so an endlessly noisy descendant cannot keep the wait pending forever.
  */
 export declare function waitForChildProcess(child: ChildProcess, options?: WaitForChildProcessOptions): Promise<number | null>;
-export {};
 //# sourceMappingURL=child-process.d.ts.map

package/dist/utils/child-process.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"child-process.d.ts","sourceRoot":"","sources":["../../src/utils/child-process.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,YAAY,EACjB,KAAK,mBAAmB,EAGxB,KAAK,YAAY,EACjB,KAAK,0BAA0B,EAC/B,KAAK,kCAAkC,EACvC,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACd,KAAK,SAAS,EACd,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAQ5C,KAAK,0BAA0B,GAAG;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,qBAAqB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IACjD,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,sBAAsB,CAAC,EAAE,MAAM,CAAC;CAChC,CAAC;AAIF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAI9D;AAED,wBAAgB,YAAY,CAC3B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,0BAA0B,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,GAClE,mBAAmB,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;AACjD,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,YAAY,GAAG,YAAY,CAAC;AAKnG,wBAAgB,gBAAgB,CAC/B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,kCAAkC,GACzC,gBAAgB,CAAC,MAAM,CAAC,CAI1B;AAQD;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAClC,KAAK,EAAE,YAAY,EACnB,OAAO,GAAE,0BAA+B,GACtC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA+IxB"}
+{"version":3,"file":"child-process.d.ts","sourceRoot":"","sources":["../../src/utils/child-process.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,YAAY,EACjB,KAAK,mBAAmB,EAGxB,KAAK,YAAY,EACjB,KAAK,0BAA0B,EAC/B,KAAK,kCAAkC,EACvC,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACd,KAAK,SAAS,EACd,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAS5C,4DAA4D;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,wBAAgB,6BAA6B,CAC5C,SAAS,CAAC,EAAE,MAAM,CAAC,UAAU,EAC7B,OAAO,GAAE,MAAM,CAAC,UAAwB,GACtC,MAAM,CAAC,UAAU,CAEnB;AAED,KAAK,0BAA0B,GAAG;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,qBAAqB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IACjD,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,sBAAsB,CAAC,EAAE,MAAM,CAAC;CAChC,CAAC;AAIF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAI9D;AAED,wBAAgB,YAAY,CAC3B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,0BAA0B,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,GAClE,mBAAmB,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;AACjD,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,YAAY,GAAG,YAAY,CAAC;AAWnG,wBAAgB,gBAAgB,CAC/B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,kCAAkC,GACzC,gBAAgB,CAAC,MAAM,CAAC,CAQ1B;AAYD;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAClC,KAAK,EAAE,YAAY,EACnB,OAAO,GAAE,0BAA+B,GACtC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA+IxB"}

package/dist/utils/child-process.js

@@ -1,10 +1,16 @@
 import { spawn as nodeSpawn, spawnSync as nodeSpawnSync, } from "node:child_process";
 import { basename } from "node:path";
 import crossSpawn from "cross-spawn";
+import { ATOMIC_AI_AGENT } from "./agent-attribution.js";
 const EXIT_STDIO_IDLE_GRACE_MS = 100;
 const EXIT_STDIO_ACTIVE_DRAIN_HARD_CAP_MS = 5_000;
 const WINDOWS_EXIT_POLL_INTERVAL_MS = 50;
 const WINDOWS_EXIT_CODE_GRACE_MS = 1_000;
+/** Build the environment for every Atomic child process. */
+export { ATOMIC_AI_AGENT } from "./agent-attribution.js";
+export function createChildProcessEnvironment(overrides, baseEnv = process.env) {
+    return { ...baseEnv, ...overrides, AI_AGENT: ATOMIC_AI_AGENT };
+}
 const WINDOWS_SHELL_COMMANDS = new Set(["bun", "npm", "npx", "pnpm", "yarn", "yarnpkg", "corepack"]);
 export function shouldUseWindowsShell(command) {
     if (process.platform !== "win32")
@@ -13,15 +19,29 @@ export function shouldUseWindowsShell(command) {
     return commandName.endsWith(".cmd") || commandName.endsWith(".bat") || WINDOWS_SHELL_COMMANDS.has(commandName);
 }
 export function spawnProcess(command, args, options) {
-    return process.platform === "win32" ? crossSpawn(command, args, options) : nodeSpawn(command, args, options);
+    const childOptions = {
+        ...options,
+        env: options.env ? createChildProcessEnvironment(undefined, options.env) : createChildProcessEnvironment(),
+    };
+    return process.platform === "win32"
+        ? crossSpawn(command, args, childOptions)
+        : nodeSpawn(command, args, childOptions);
 }
 export function spawnProcessSync(command, args, options) {
+    const childOptions = {
+        ...options,
+        env: options.env ? createChildProcessEnvironment(undefined, options.env) : createChildProcessEnvironment(),
+    };
     return process.platform === "win32"
-        ? crossSpawn.sync(command, args, options)
-        : nodeSpawnSync(command, args, options);
+        ? crossSpawn.sync(command, args, childOptions)
+        : nodeSpawnSync(command, args, childOptions);
 }
 function isWindowsProcessAlive(pid) {
-    const result = nodeSpawnSync("tasklist", ["/FI", `PID eq ${pid}`, "/NH"], { encoding: "utf-8", windowsHide: true });
+    const result = nodeSpawnSync("tasklist", ["/FI", `PID eq ${pid}`, "/NH"], {
+        encoding: "utf-8",
+        windowsHide: true,
+        env: createChildProcessEnvironment(),
+    });
     if (result.status !== 0)
         return true;
     return new RegExp(`\\b${pid}\\b`).test(result.stdout);