@crewspaceai/adapter-pi-local 2026.412.0-canary.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 CrewSpace AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/cli/format-event.d.ts

@@ -0,0 +1,2 @@
+export declare function printPiStreamEvent(raw: string, _debug: boolean): void;
+//# sourceMappingURL=format-event.d.ts.map

package/dist/cli/format-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-event.d.ts","sourceRoot":"","sources":["../../src/cli/format-event.ts"],"names":[],"mappings":"AA4BA,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CA8ErE"}

package/dist/cli/format-event.js

@@ -0,0 +1,99 @@
+import pc from "picocolors";
+function safeJsonParse(text) {
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return null;
+    }
+}
+function asRecord(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        return null;
+    return value;
+}
+function asString(value, fallback = "") {
+    return typeof value === "string" ? value : fallback;
+}
+function extractTextContent(content) {
+    if (typeof content === "string")
+        return content;
+    if (!Array.isArray(content))
+        return "";
+    return content
+        .filter((c) => c.type === "text" && c.text)
+        .map((c) => c.text)
+        .join("");
+}
+export function printPiStreamEvent(raw, _debug) {
+    const line = raw.trim();
+    if (!line)
+        return;
+    const parsed = asRecord(safeJsonParse(line));
+    if (!parsed) {
+        console.log(line);
+        return;
+    }
+    const type = asString(parsed.type);
+    if (type === "agent_start") {
+        console.log(pc.blue("Pi agent started"));
+        return;
+    }
+    if (type === "agent_end") {
+        console.log(pc.blue("Pi agent finished"));
+        return;
+    }
+    if (type === "turn_start") {
+        console.log(pc.blue("Turn started"));
+        return;
+    }
+    if (type === "turn_end") {
+        const message = asRecord(parsed.message);
+        if (message) {
+            const content = message.content;
+            const text = extractTextContent(content);
+            if (text) {
+                console.log(pc.green(`assistant: ${text}`));
+            }
+        }
+        return;
+    }
+    if (type === "message_update") {
+        const assistantEvent = asRecord(parsed.assistantMessageEvent);
+        if (assistantEvent) {
+            const msgType = asString(assistantEvent.type);
+            if (msgType === "text_delta") {
+                const delta = asString(assistantEvent.delta);
+                if (delta) {
+                    console.log(pc.green(delta));
+                }
+            }
+        }
+        return;
+    }
+    if (type === "tool_execution_start") {
+        const toolName = asString(parsed.toolName);
+        const args = parsed.args;
+        console.log(pc.yellow(`tool_start: ${toolName}`));
+        if (args !== undefined) {
+            try {
+                console.log(pc.gray(JSON.stringify(args, null, 2)));
+            }
+            catch {
+                console.log(pc.gray(String(args)));
+            }
+        }
+        return;
+    }
+    if (type === "tool_execution_end") {
+        const result = parsed.result;
+        const isError = parsed.isError === true;
+        const output = typeof result === "string" ? result : JSON.stringify(result);
+        if (output) {
+            console.log((isError ? pc.red : pc.gray)(output));
+        }
+        return;
+    }
+    console.log(line);
+}
+//# sourceMappingURL=format-event.js.map

package/dist/cli/format-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-event.js","sourceRoot":"","sources":["../../src/cli/format-event.ts"],"names":[],"mappings":"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"}

package/dist/cli/index.d.ts

@@ -0,0 +1,2 @@
+export { printPiStreamEvent } from "./format-event.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/cli/index.js

@@ -0,0 +1,2 @@
+export { printPiStreamEvent } from "./format-event.js";
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export declare const type = "pi_local";
+export declare const label = "Pi (local)";
+export declare const models: Array<{
+    id: string;
+    label: string;
+}>;
+export declare const agentConfigurationDoc = "# pi_local agent configuration\n\nAdapter: pi_local\n\nUse when:\n- You want CrewSpace to run Pi (the AI coding agent) locally as the agent runtime\n- You want provider/model routing in Pi format (--provider <name> --model <id>)\n- You want Pi session resume across heartbeats via --session\n- You need Pi's tool set (read, bash, edit, write, grep, find, ls)\n\nDon't use when:\n- You need webhook-style external invocation (use openclaw_gateway or http)\n- You only need one-shot shell commands (use process)\n- Pi CLI is not installed on the machine\n\nCore fields:\n- cwd (string, optional): default absolute working directory fallback for the agent process (created if missing when possible)\n- instructionsFilePath (string, optional): absolute path to a markdown instructions file appended to system prompt via --append-system-prompt\n- promptTemplate (string, optional): user prompt template passed via -p flag\n- model (string, required): Pi model id in provider/model format (for example xai/grok-4)\n- thinking (string, optional): thinking level (off, minimal, low, medium, high, xhigh)\n- command (string, optional): defaults to \"pi\"\n- env (object, optional): KEY=VALUE environment variables\n\nOperational fields:\n- timeoutSec (number, optional): run timeout in seconds\n- graceSec (number, optional): SIGTERM grace period in seconds\n\nNotes:\n- Pi supports multiple providers and models. Use `pi --list-models` to list available options.\n- CrewSpace requires an explicit `model` value for `pi_local` agents.\n- Sessions are stored in ~/.pi/crewspaces/ and resumed with --session.\n- All tools (read, bash, edit, write, grep, find, ls) are enabled by default.\n- Agent instructions are appended to Pi's system prompt via --append-system-prompt, while the user task is sent via -p.\n";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,IAAI,aAAa,CAAC;AAC/B,eAAO,MAAM,KAAK,eAAe,CAAC;AAElC,eAAO,MAAM,MAAM,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAM,CAAC;AAE/D,eAAO,MAAM,qBAAqB,4wDAkCjC,CAAC"}

package/dist/index.js

@@ -0,0 +1,39 @@
+export const type = "pi_local";
+export const label = "Pi (local)";
+export const models = [];
+export const agentConfigurationDoc = `# pi_local agent configuration
+
+Adapter: pi_local
+
+Use when:
+- You want CrewSpace to run Pi (the AI coding agent) locally as the agent runtime
+- You want provider/model routing in Pi format (--provider <name> --model <id>)
+- You want Pi session resume across heartbeats via --session
+- You need Pi's tool set (read, bash, edit, write, grep, find, ls)
+
+Don't use when:
+- You need webhook-style external invocation (use openclaw_gateway or http)
+- You only need one-shot shell commands (use process)
+- Pi CLI is not installed on the machine
+
+Core fields:
+- cwd (string, optional): default absolute working directory fallback for the agent process (created if missing when possible)
+- instructionsFilePath (string, optional): absolute path to a markdown instructions file appended to system prompt via --append-system-prompt
+- promptTemplate (string, optional): user prompt template passed via -p flag
+- model (string, required): Pi model id in provider/model format (for example xai/grok-4)
+- thinking (string, optional): thinking level (off, minimal, low, medium, high, xhigh)
+- command (string, optional): defaults to "pi"
+- env (object, optional): KEY=VALUE environment variables
+
+Operational fields:
+- timeoutSec (number, optional): run timeout in seconds
+- graceSec (number, optional): SIGTERM grace period in seconds
+
+Notes:
+- Pi supports multiple providers and models. Use \`pi --list-models\` to list available options.
+- CrewSpace requires an explicit \`model\` value for \`pi_local\` agents.
+- Sessions are stored in ~/.pi/crewspaces/ and resumed with --session.
+- All tools (read, bash, edit, write, grep, find, ls) are enabled by default.
+- Agent instructions are appended to Pi's system prompt via --append-system-prompt, while the user task is sent via -p.
+`;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,IAAI,GAAG,UAAU,CAAC;AAC/B,MAAM,CAAC,MAAM,KAAK,GAAG,YAAY,CAAC;AAElC,MAAM,CAAC,MAAM,MAAM,GAAyC,EAAE,CAAC;AAE/D,MAAM,CAAC,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkCpC,CAAC"}

package/dist/server/execute.d.ts

@@ -0,0 +1,3 @@
+import { type AdapterExecutionContext, type AdapterExecutionResult } from "@crewspaceai/adapter-utils";
+export declare function execute(ctx: AdapterExecutionContext): Promise<AdapterExecutionResult>;
+//# sourceMappingURL=execute.d.ts.map

package/dist/server/execute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../src/server/execute.ts"],"names":[],"mappings":"AAIA,OAAO,EAA+B,KAAK,uBAAuB,EAAE,KAAK,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAyGpI,wBAAsB,OAAO,CAAC,GAAG,EAAE,uBAAuB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAwY3F"}

package/dist/server/execute.js

@@ -0,0 +1,407 @@
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { inferOpenAiCompatibleBiller } from "@crewspaceai/adapter-utils";
+import { asString, asNumber, asStringArray, parseObject, buildCrewSpaceEnv, joinPromptSections, buildInvocationEnvForLogs, ensureAbsoluteDirectory, ensureCommandResolvable, ensureCrewSpaceSkillSymlink, ensurePathInEnv, readCrewSpaceRuntimeSkillEntries, resolveCommandForLogs, resolveCrewSpaceDesiredSkillNames, removeMaintainerOnlySkillSymlinks, renderTemplate, runChildProcess, sanitizeCwd, } from "@crewspaceai/adapter-utils/server-utils";
+import { isPiUnknownSessionError, parsePiJsonl } from "./parse.js";
+import { ensurePiModelConfiguredAndAvailable } from "./models.js";
+const __moduleDir = path.dirname(fileURLToPath(import.meta.url));
+const CREWSPACE_SESSIONS_DIR = path.join(os.homedir(), ".pi", "crewspaces");
+const PI_AGENT_SKILLS_DIR = path.join(os.homedir(), ".pi", "agent", "skills");
+function firstNonEmptyLine(text) {
+    return (text
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .find(Boolean) ?? "");
+}
+function parseModelProvider(model) {
+    if (!model)
+        return null;
+    const trimmed = model.trim();
+    if (!trimmed.includes("/"))
+        return null;
+    return trimmed.slice(0, trimmed.indexOf("/")).trim() || null;
+}
+function parseModelId(model) {
+    if (!model)
+        return null;
+    const trimmed = model.trim();
+    if (!trimmed.includes("/"))
+        return trimmed || null;
+    return trimmed.slice(trimmed.indexOf("/") + 1).trim() || null;
+}
+async function ensurePiSkillsInjected(onLog, skillsEntries, desiredSkillNames) {
+    const desiredSet = new Set(desiredSkillNames ?? skillsEntries.map((entry) => entry.key));
+    const selectedEntries = skillsEntries.filter((entry) => desiredSet.has(entry.key));
+    if (selectedEntries.length === 0)
+        return;
+    await fs.mkdir(PI_AGENT_SKILLS_DIR, { recursive: true });
+    const removedSkills = await removeMaintainerOnlySkillSymlinks(PI_AGENT_SKILLS_DIR, selectedEntries.map((entry) => entry.runtimeName));
+    for (const skillName of removedSkills) {
+        await onLog("stderr", `[crewspace] Removed maintainer-only Pi skill "${skillName}" from ${PI_AGENT_SKILLS_DIR}\n`);
+    }
+    for (const entry of selectedEntries) {
+        const target = path.join(PI_AGENT_SKILLS_DIR, entry.runtimeName);
+        try {
+            const result = await ensureCrewSpaceSkillSymlink(entry.source, target);
+            if (result === "skipped")
+                continue;
+            await onLog("stderr", `[crewspace] ${result === "repaired" ? "Repaired" : "Injected"} Pi skill "${entry.runtimeName}" into ${PI_AGENT_SKILLS_DIR}\n`);
+        }
+        catch (err) {
+            await onLog("stderr", `[crewspace] Failed to inject Pi skill "${entry.runtimeName}" into ${PI_AGENT_SKILLS_DIR}: ${err instanceof Error ? err.message : String(err)}\n`);
+        }
+    }
+}
+function resolvePiBiller(env, provider) {
+    return inferOpenAiCompatibleBiller(env, null) ?? provider ?? "unknown";
+}
+async function ensureSessionsDir() {
+    await fs.mkdir(CREWSPACE_SESSIONS_DIR, { recursive: true });
+    return CREWSPACE_SESSIONS_DIR;
+}
+function buildSessionPath(agentId, timestamp) {
+    const safeTimestamp = timestamp.replace(/[:.]/g, "-");
+    return path.join(CREWSPACE_SESSIONS_DIR, `${safeTimestamp}-${agentId}.jsonl`);
+}
+export async function execute(ctx) {
+    const { runId, agent, runtime, config, context, onLog, onMeta, onSpawn, authToken } = ctx;
+    const promptTemplate = asString(config.promptTemplate, "You are agent {{agent.id}} ({{agent.name}}). Continue your CrewSpace work.");
+    const command = asString(config.command, "pi");
+    const model = asString(config.model, "").trim();
+    const thinking = asString(config.thinking, "").trim();
+    // Parse model into provider and model id
+    const provider = parseModelProvider(model);
+    const modelId = parseModelId(model);
+    const workspaceContext = parseObject(context.crewspaceWorkspace);
+    const workspaceCwd = asString(workspaceContext.cwd, "");
+    const workspaceSource = asString(workspaceContext.source, "");
+    const workspaceId = asString(workspaceContext.workspaceId, "");
+    const workspaceRepoUrl = asString(workspaceContext.repoUrl, "");
+    const workspaceRepoRef = asString(workspaceContext.repoRef, "");
+    const agentHome = asString(workspaceContext.agentHome, "");
+    const workspaceHints = Array.isArray(context.crewspaceWorkspaces)
+        ? context.crewspaceWorkspaces.filter((value) => typeof value === "object" && value !== null)
+        : [];
+    const configuredCwd = asString(config.cwd, "");
+    const useConfiguredInsteadOfAgentHome = workspaceSource === "agent_home" && configuredCwd.length > 0;
+    const effectiveWorkspaceCwd = useConfiguredInsteadOfAgentHome ? "" : workspaceCwd;
+    const cwd = sanitizeCwd(effectiveWorkspaceCwd || configuredCwd || process.cwd());
+    await ensureAbsoluteDirectory(cwd, { createIfMissing: true });
+    // Ensure sessions directory exists
+    await ensureSessionsDir();
+    // Inject skills
+    const piSkillEntries = await readCrewSpaceRuntimeSkillEntries(config, __moduleDir);
+    const desiredPiSkillNames = resolveCrewSpaceDesiredSkillNames(config, piSkillEntries);
+    await ensurePiSkillsInjected(onLog, piSkillEntries, desiredPiSkillNames);
+    // Build environment
+    const envConfig = parseObject(config.env);
+    const hasExplicitApiKey = typeof envConfig.CREWSPACE_API_KEY === "string" && envConfig.CREWSPACE_API_KEY.trim().length > 0;
+    const env = { ...buildCrewSpaceEnv(agent) };
+    env.CREWSPACE_RUN_ID = runId;
+    const wakeTaskId = (typeof context.taskId === "string" && context.taskId.trim().length > 0 && context.taskId.trim()) ||
+        (typeof context.issueId === "string" && context.issueId.trim().length > 0 && context.issueId.trim()) ||
+        null;
+    const wakeReason = typeof context.wakeReason === "string" && context.wakeReason.trim().length > 0
+        ? context.wakeReason.trim()
+        : null;
+    const wakeCommentId = (typeof context.wakeCommentId === "string" && context.wakeCommentId.trim().length > 0 && context.wakeCommentId.trim()) ||
+        (typeof context.commentId === "string" && context.commentId.trim().length > 0 && context.commentId.trim()) ||
+        null;
+    const approvalId = typeof context.approvalId === "string" && context.approvalId.trim().length > 0
+        ? context.approvalId.trim()
+        : null;
+    const approvalStatus = typeof context.approvalStatus === "string" && context.approvalStatus.trim().length > 0
+        ? context.approvalStatus.trim()
+        : null;
+    const linkedIssueIds = Array.isArray(context.issueIds)
+        ? context.issueIds.filter((value) => typeof value === "string" && value.trim().length > 0)
+        : [];
+    if (wakeTaskId)
+        env.CREWSPACE_TASK_ID = wakeTaskId;
+    if (wakeReason)
+        env.CREWSPACE_WAKE_REASON = wakeReason;
+    if (wakeCommentId)
+        env.CREWSPACE_WAKE_COMMENT_ID = wakeCommentId;
+    if (approvalId)
+        env.CREWSPACE_APPROVAL_ID = approvalId;
+    if (approvalStatus)
+        env.CREWSPACE_APPROVAL_STATUS = approvalStatus;
+    if (linkedIssueIds.length > 0)
+        env.CREWSPACE_LINKED_ISSUE_IDS = linkedIssueIds.join(",");
+    if (workspaceCwd)
+        env.CREWSPACE_WORKSPACE_CWD = workspaceCwd;
+    if (workspaceSource)
+        env.CREWSPACE_WORKSPACE_SOURCE = workspaceSource;
+    if (workspaceId)
+        env.CREWSPACE_WORKSPACE_ID = workspaceId;
+    if (workspaceRepoUrl)
+        env.CREWSPACE_WORKSPACE_REPO_URL = workspaceRepoUrl;
+    if (workspaceRepoRef)
+        env.CREWSPACE_WORKSPACE_REPO_REF = workspaceRepoRef;
+    if (agentHome)
+        env.AGENT_HOME = agentHome;
+    if (workspaceHints.length > 0)
+        env.CREWSPACE_WORKSPACES_JSON = JSON.stringify(workspaceHints);
+    for (const [key, value] of Object.entries(envConfig)) {
+        if (typeof value === "string")
+            env[key] = value;
+    }
+    if (!hasExplicitApiKey && authToken) {
+        env.CREWSPACE_API_KEY = authToken;
+    }
+    const runtimeEnv = Object.fromEntries(Object.entries(ensurePathInEnv({ ...process.env, ...env })).filter((entry) => typeof entry[1] === "string"));
+    await ensureCommandResolvable(command, cwd, runtimeEnv);
+    const resolvedCommand = await resolveCommandForLogs(command, cwd, runtimeEnv);
+    const loggedEnv = buildInvocationEnvForLogs(env, {
+        runtimeEnv,
+        includeRuntimeKeys: ["HOME"],
+        resolvedCommand,
+    });
+    // Validate model is available before execution
+    await ensurePiModelConfiguredAndAvailable({
+        model,
+        command,
+        cwd,
+        env: runtimeEnv,
+    });
+    const timeoutSec = asNumber(config.timeoutSec, 0);
+    const graceSec = asNumber(config.graceSec, 20);
+    const extraArgs = (() => {
+        const fromExtraArgs = asStringArray(config.extraArgs);
+        if (fromExtraArgs.length > 0)
+            return fromExtraArgs;
+        return asStringArray(config.args);
+    })();
+    // Handle session
+    const runtimeSessionParams = parseObject(runtime.sessionParams);
+    const runtimeSessionId = asString(runtimeSessionParams.sessionId, runtime.sessionId ?? "");
+    const runtimeSessionCwd = asString(runtimeSessionParams.cwd, "");
+    const canResumeSession = runtimeSessionId.length > 0 &&
+        (runtimeSessionCwd.length === 0 || path.resolve(runtimeSessionCwd) === path.resolve(cwd));
+    const sessionPath = canResumeSession ? runtimeSessionId : buildSessionPath(agent.id, new Date().toISOString());
+    if (runtimeSessionId && !canResumeSession) {
+        await onLog("stdout", `[crewspace] Pi session "${runtimeSessionId}" was saved for cwd "${runtimeSessionCwd}" and will not be resumed in "${cwd}".\n`);
+    }
+    // Ensure session file exists (Pi requires this on first run)
+    if (!canResumeSession) {
+        try {
+            await fs.writeFile(sessionPath, "", { flag: "wx" });
+        }
+        catch (err) {
+            // File may already exist, that's ok
+            if (err.code !== "EEXIST") {
+                throw err;
+            }
+        }
+    }
+    // Handle instructions file and build system prompt extension
+    const instructionsFilePath = asString(config.instructionsFilePath, "").trim();
+    const resolvedInstructionsFilePath = instructionsFilePath
+        ? path.resolve(cwd, instructionsFilePath)
+        : "";
+    const instructionsFileDir = instructionsFilePath ? `${path.dirname(instructionsFilePath)}/` : "";
+    let systemPromptExtension = "";
+    let instructionsReadFailed = false;
+    if (resolvedInstructionsFilePath) {
+        try {
+            const instructionsContents = await fs.readFile(resolvedInstructionsFilePath, "utf8");
+            systemPromptExtension =
+                `${instructionsContents}\n\n` +
+                    `The above agent instructions were loaded from ${resolvedInstructionsFilePath}. ` +
+                    `Resolve any relative file references from ${instructionsFileDir}.\n\n` +
+                    `You are agent {{agent.id}} ({{agent.name}}). Continue your CrewSpace work.`;
+        }
+        catch (err) {
+            instructionsReadFailed = true;
+            const reason = err instanceof Error ? err.message : String(err);
+            await onLog("stdout", `[crewspace] Warning: could not read agent instructions file "${resolvedInstructionsFilePath}": ${reason}\n`);
+            // Fall back to base prompt template
+            systemPromptExtension = promptTemplate;
+        }
+    }
+    else {
+        systemPromptExtension = promptTemplate;
+    }
+    const bootstrapPromptTemplate = asString(config.bootstrapPromptTemplate, "");
+    const templateData = {
+        agentId: agent.id,
+        companyId: agent.companyId,
+        runId,
+        company: { id: agent.companyId },
+        agent,
+        run: { id: runId, source: "on_demand" },
+        context,
+    };
+    const renderedSystemPromptExtension = renderTemplate(systemPromptExtension, templateData);
+    const renderedHeartbeatPrompt = renderTemplate(promptTemplate, templateData);
+    const renderedBootstrapPrompt = !canResumeSession && bootstrapPromptTemplate.trim().length > 0
+        ? renderTemplate(bootstrapPromptTemplate, templateData).trim()
+        : "";
+    const sessionHandoffNote = asString(context.crewspaceSessionHandoffMarkdown, "").trim();
+    const userPrompt = joinPromptSections([
+        renderedBootstrapPrompt,
+        sessionHandoffNote,
+        renderedHeartbeatPrompt,
+    ]);
+    const promptMetrics = {
+        systemPromptChars: renderedSystemPromptExtension.length,
+        promptChars: userPrompt.length,
+        bootstrapPromptChars: renderedBootstrapPrompt.length,
+        sessionHandoffChars: sessionHandoffNote.length,
+        heartbeatPromptChars: renderedHeartbeatPrompt.length,
+    };
+    const commandNotes = (() => {
+        if (!resolvedInstructionsFilePath)
+            return [];
+        if (instructionsReadFailed) {
+            return [
+                `Configured instructionsFilePath ${resolvedInstructionsFilePath}, but file could not be read; continuing without injected instructions.`,
+            ];
+        }
+        return [
+            `Loaded agent instructions from ${resolvedInstructionsFilePath}`,
+            `Appended instructions + path directive to system prompt (relative references from ${instructionsFileDir}).`,
+        ];
+    })();
+    const buildArgs = (sessionFile) => {
+        const args = [];
+        // Use JSON mode for structured output with print mode (non-interactive)
+        args.push("--mode", "json");
+        args.push("-p"); // Non-interactive mode: process prompt and exit
+        // Use --append-system-prompt to extend Pi's default system prompt
+        args.push("--append-system-prompt", renderedSystemPromptExtension);
+        if (provider)
+            args.push("--provider", provider);
+        if (modelId)
+            args.push("--model", modelId);
+        if (thinking)
+            args.push("--thinking", thinking);
+        args.push("--tools", "read,bash,edit,write,grep,find,ls");
+        args.push("--session", sessionFile);
+        // Add CrewSpace skills directory so Pi can load the crewspace skill
+        args.push("--skill", PI_AGENT_SKILLS_DIR);
+        if (extraArgs.length > 0)
+            args.push(...extraArgs);
+        // Add the user prompt as the last argument
+        args.push(userPrompt);
+        return args;
+    };
+    const runAttempt = async (sessionFile) => {
+        const args = buildArgs(sessionFile);
+        if (onMeta) {
+            await onMeta({
+                adapterType: "pi_local",
+                command: resolvedCommand,
+                cwd,
+                commandNotes,
+                commandArgs: args,
+                env: loggedEnv,
+                prompt: userPrompt,
+                promptMetrics,
+                context,
+            });
+        }
+        // Buffer stdout by lines to handle partial JSON chunks
+        let stdoutBuffer = "";
+        const bufferedOnLog = async (stream, chunk) => {
+            if (stream === "stderr") {
+                // Pass stderr through immediately (not JSONL)
+                await onLog(stream, chunk);
+                return;
+            }
+            // Buffer stdout and emit only complete lines
+            stdoutBuffer += chunk;
+            const lines = stdoutBuffer.split("\n");
+            // Keep the last (potentially incomplete) line in the buffer
+            stdoutBuffer = lines.pop() || "";
+            // Emit complete lines
+            for (const line of lines) {
+                if (line) {
+                    await onLog(stream, line + "\n");
+                }
+            }
+        };
+        const proc = await runChildProcess(runId, command, args, {
+            cwd,
+            env: runtimeEnv,
+            timeoutSec,
+            graceSec,
+            onSpawn,
+            onLog: bufferedOnLog,
+        });
+        // Flush any remaining buffer content
+        if (stdoutBuffer) {
+            await onLog("stdout", stdoutBuffer);
+        }
+        return {
+            proc,
+            rawStderr: proc.stderr,
+            parsed: parsePiJsonl(proc.stdout),
+        };
+    };
+    const toResult = (attempt, clearSessionOnMissingSession = false) => {
+        if (attempt.proc.timedOut) {
+            return {
+                exitCode: attempt.proc.exitCode,
+                signal: attempt.proc.signal,
+                timedOut: true,
+                errorMessage: `Timed out after ${timeoutSec}s`,
+                clearSession: clearSessionOnMissingSession,
+            };
+        }
+        const resolvedSessionId = clearSessionOnMissingSession ? null : sessionPath;
+        const resolvedSessionParams = resolvedSessionId
+            ? { sessionId: resolvedSessionId, cwd }
+            : null;
+        const stderrLine = firstNonEmptyLine(attempt.proc.stderr);
+        const rawExitCode = attempt.proc.exitCode;
+        const fallbackErrorMessage = stderrLine || `Pi exited with code ${rawExitCode ?? -1}`;
+        return {
+            exitCode: rawExitCode,
+            signal: attempt.proc.signal,
+            timedOut: false,
+            errorMessage: (rawExitCode ?? 0) === 0 ? null : fallbackErrorMessage,
+            usage: {
+                inputTokens: attempt.parsed.usage.inputTokens,
+                outputTokens: attempt.parsed.usage.outputTokens,
+                cachedInputTokens: attempt.parsed.usage.cachedInputTokens,
+            },
+            sessionId: resolvedSessionId,
+            sessionParams: resolvedSessionParams,
+            sessionDisplayId: resolvedSessionId,
+            provider: provider,
+            biller: resolvePiBiller(runtimeEnv, provider),
+            model: model,
+            billingType: "unknown",
+            costUsd: attempt.parsed.usage.costUsd,
+            resultJson: {
+                stdout: attempt.proc.stdout,
+                stderr: attempt.proc.stderr,
+            },
+            summary: attempt.parsed.finalMessage ?? attempt.parsed.messages.join("\n\n").trim(),
+            clearSession: Boolean(clearSessionOnMissingSession),
+        };
+    };
+    const initial = await runAttempt(sessionPath);
+    const initialFailed = !initial.proc.timedOut && ((initial.proc.exitCode ?? 0) !== 0 || initial.parsed.errors.length > 0);
+    if (canResumeSession &&
+        initialFailed &&
+        isPiUnknownSessionError(initial.proc.stdout, initial.rawStderr)) {
+        await onLog("stdout", `[crewspace] Pi session "${runtimeSessionId}" is unavailable; retrying with a fresh session.\n`);
+        const newSessionPath = buildSessionPath(agent.id, new Date().toISOString());
+        try {
+            await fs.writeFile(newSessionPath, "", { flag: "wx" });
+        }
+        catch (err) {
+            if (err.code !== "EEXIST") {
+                throw err;
+            }
+        }
+        const retry = await runAttempt(newSessionPath);
+        return toResult(retry, true);
+    }
+    return toResult(initial);
+}
+//# sourceMappingURL=execute.js.map