@oyasmi/pipiclaw 0.4.0 → 0.5.0

package/dist/prompt-builder.js

@@ -35,6 +35,7 @@ ${workspacePath}/
 ├── skills/                      # Global CLI tools you create
 ├── events/                      # Scheduled events
 └── ${channelId}/                # This channel
+    ├── SESSION.md               # Channel working memory (runtime-managed, read on demand)
     ├── MEMORY.md                # Channel durable memory (read on demand, runtime-managed)
     ├── HISTORY.md               # Channel summarized history (read on demand, runtime-managed)
     ├── log.jsonl                # Raw message archive (cold storage)
@@ -79,12 +80,16 @@ Memory files are not preloaded into session context. Read them explicitly when m
 ### Files
 - Workspace memory: ${workspacePath}/MEMORY.md
   Stable shared background memory. Admin-managed. Read on demand.
+- Channel session memory: ${channelPath}/SESSION.md
+  Current working state for this channel. Runtime-managed. Read on demand. Prefer this when current task state matters.
 - Channel memory: ${channelPath}/MEMORY.md
-  Durable channel memory. Runtime-managed via consolidation. You may update this file manually when necessary.
+  Durable channel memory. Runtime-managed via consolidation. Prefer this for stable facts, decisions, preferences, and medium-horizon open loops.
 - Channel history: ${channelPath}/HISTORY.md
   Summarized older channel history. Runtime-managed. Read on demand. Do not maintain this file manually during normal work.
 
 ### Runtime Behavior
+- The runtime may inject a small amount of relevant memory context from SESSION.md / MEMORY.md / HISTORY.md into a turn when it is clearly useful.
+- SESSION.md is the primary runtime-managed working-state artifact for current active work.
 - The runtime automatically consolidates channel MEMORY.md and HISTORY.md before compaction or session trimming.
 - Workspace MEMORY.md is not updated by normal runtime consolidation.
 
@@ -92,7 +97,7 @@ Memory files are not preloaded into session context. Read them explicitly when m
 - ${channelPath}/log.jsonl is a raw archive. It is not normal memory and is not proactively loaded.
 - ${channelPath}/context.jsonl is a raw session archive. It is not normal memory and is not proactively loaded.
 
-When a task depends on prior decisions, preferences, or long-running work, read channel MEMORY.md and HISTORY.md first.`);
+When a task depends on prior decisions, preferences, or long-running work, prefer SESSION.md first for current state, then MEMORY.md, then HISTORY.md.`);
     sections.push(`## System Configuration Log
 Maintain ${workspacePath}/SYSTEM.md to log all environment modifications:
 - Installed packages (apk add, npm install, pip install)

package/dist/prompt-builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"prompt-builder.js","sourceRoot":"","sources":["../src/prompt-builder.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,uBAAuB,CACtC,aAAqB,EACrB,SAAiB,EACjB,aAA4B,EAC5B,UAAqC,EAAE;IAEvC,MAAM,WAAW,GAAG,GAAG,aAAa,IAAI,SAAS,EAAE,CAAC;IACpD,MAAM,aAAa,GAAG,GAAG,aAAa,aAAa,CAAC;IACpD,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,KAAK,QAAQ,CAAC;IAEjD,MAAM,cAAc,GAAG,QAAQ;QAC9B,CAAC,CAAC;;;uCAGmC;QACrC,CAAC,CAAC;4BACwB,OAAO,CAAC,GAAG,EAAE;uCACF,CAAC;IAEvC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,QAAQ,CAAC,IAAI,CAAC;;;;;;;;;;;;;EAab,cAAc;;;EAGd,aAAa;;;;;;;MAOT,SAAS;;;;;;0DAM2C,CAAC,CAAC;IAE3D,QAAQ,CAAC,IAAI,CAAC;wHACyG,aAAa;;;;;;sCAM/F,SAAS;;;;;qCAKV,SAAS;;;;;qCAKT,SAAS,qEAAqE,IAAI,CAAC,cAAc,EAAE,CAAC,eAAe,EAAE,CAAC,QAAQ;;;;;;;6BAOtI,aAAa;;;;;;;gCAOV,CAAC,CAAC;IAEjC,QAAQ,CAAC,IAAI,CAAC;;;;sBAIO,aAAa;;oBAEf,WAAW;;qBAEV,WAAW;;;;;;;;IAQ5B,WAAW;IACX,WAAW;;wHAEyG,CAAC,CAAC;IAEzH,QAAQ,CAAC,IAAI,CAAC;WACJ,aAAa;;;;;;sDAM8B,CAAC,CAAC;IAEvD,QAAQ,CAAC,IAAI,CAAC;;;;;;;wDAOyC,CAAC,CAAC;IAEzD,QAAQ,CAAC,IAAI,CAAC;;;;6CAI8B,aAAa;EACxD,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,qCAAqC,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,uCAAuC;;;;;;;;;;;;;;;;;;;;;uFAqBvC,CAAC,CAAC;IAExF,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC9B,CAAC","sourcesContent":["import type { SandboxConfig } from \"./sandbox.js\";\n\nexport interface AppendSystemPromptOptions {\n\tsubAgentList?: string;\n}\n\nexport function buildAppendSystemPrompt(\n\tworkspacePath: string,\n\tchannelId: string,\n\tsandboxConfig: SandboxConfig,\n\toptions: AppendSystemPromptOptions = {},\n): string {\n\tconst channelPath = `${workspacePath}/${channelId}`;\n\tconst subAgentsPath = `${workspacePath}/sub-agents`;\n\tconst isDocker = sandboxConfig.type === \"docker\";\n\n\tconst envDescription = isDocker\n\t\t? `You are running inside a Docker container (Alpine Linux).\n- Bash working directory: / (use cd or absolute paths)\n- Install tools with: apk add <package>\n- Your changes persist across sessions`\n\t\t: `You are running directly on the host machine.\n- Bash working directory: ${process.cwd()}\n- Be careful with system modifications`;\n\n\tconst sections: string[] = [];\n\n\tsections.push(`## Pipiclaw Runtime\nYou are running inside Pipiclaw, a DingTalk-oriented runtime built on top of pi.\n\n## Context\n- For current date/time, use: date\n- You have access to the active session context for this session.\n- Raw transcript files are cold storage. Do not assume they are preloaded.\n\n## Formatting\nUse Markdown for formatting. DingTalk AI Card supports basic Markdown:\nBold: **text**, Italic: *text*, Code: \\`code\\`, Block: \\`\\`\\`code\\`\\`\\`, Links: [text](url)\n\n## Environment\n${envDescription}\n\n## Workspace Layout\n${workspacePath}/\n├── SOUL.md                      # Your identity/personality (read-only)\n├── AGENTS.md                    # Custom behavior instructions (read-only)\n├── MEMORY.md                    # Stable workspace memory (admin-managed, read on demand)\n├── sub-agents/                  # Predefined sub-agent definitions\n├── skills/                      # Global CLI tools you create\n├── events/                      # Scheduled events\n└── ${channelId}/                # This channel\n    ├── MEMORY.md                # Channel durable memory (read on demand, runtime-managed)\n    ├── HISTORY.md               # Channel summarized history (read on demand, runtime-managed)\n    ├── log.jsonl                # Raw message archive (cold storage)\n    ├── context.jsonl            # Raw session archive (cold storage)\n    ├── scratch/                 # Your working directory\n    └── skills/                  # Channel-specific tools`);\n\n\tsections.push(`## Events\nYou can schedule events that wake you up at specific times or when external things happen. Events are JSON files in \\`${workspacePath}/events/\\`.\n\n### Event Types\n\n**Immediate** - Triggers as soon as harness sees the file.\n\\`\\`\\`json\n{\"type\": \"immediate\", \"channelId\": \"${channelId}\", \"text\": \"New event occurred\"}\n\\`\\`\\`\n\n**One-shot** - Triggers once at a specific time.\n\\`\\`\\`json\n{\"type\": \"one-shot\", \"channelId\": \"${channelId}\", \"text\": \"Reminder\", \"at\": \"2025-12-15T09:00:00+08:00\"}\n\\`\\`\\`\n\n**Periodic** - Triggers on a cron schedule.\n\\`\\`\\`json\n{\"type\": \"periodic\", \"channelId\": \"${channelId}\", \"text\": \"Check inbox\", \"schedule\": \"0 9 * * 1-5\", \"timezone\": \"${Intl.DateTimeFormat().resolvedOptions().timeZone}\"}\n\\`\\`\\`\n\n### Cron Format\n\\`minute hour day-of-month month day-of-week\\`\n\n### Creating Events\nCreate a JSON file under \\`${workspacePath}/events/\\` with the appropriate event payload.\nPrefer the file tools for creating or editing the event file. Use shell commands only when they are the clearest option.\n\n### Silent Completion\nFor periodic events where there's nothing to report, respond with just \\`[SILENT]\\`. This deletes the status message. Use this to avoid spam when periodic checks find nothing.\n\n### Limits\nMaximum 5 events can be queued.`);\n\n\tsections.push(`## Memory\nMemory files are not preloaded into session context. Read them explicitly when memory or history matters.\n\n### Files\n- Workspace memory: ${workspacePath}/MEMORY.md\n  Stable shared background memory. Admin-managed. Read on demand.\n- Channel memory: ${channelPath}/MEMORY.md\n  Durable channel memory. Runtime-managed via consolidation. You may update this file manually when necessary.\n- Channel history: ${channelPath}/HISTORY.md\n  Summarized older channel history. Runtime-managed. Read on demand. Do not maintain this file manually during normal work.\n\n### Runtime Behavior\n- The runtime automatically consolidates channel MEMORY.md and HISTORY.md before compaction or session trimming.\n- Workspace MEMORY.md is not updated by normal runtime consolidation.\n\n### Cold Storage\n- ${channelPath}/log.jsonl is a raw archive. It is not normal memory and is not proactively loaded.\n- ${channelPath}/context.jsonl is a raw session archive. It is not normal memory and is not proactively loaded.\n\nWhen a task depends on prior decisions, preferences, or long-running work, read channel MEMORY.md and HISTORY.md first.`);\n\n\tsections.push(`## System Configuration Log\nMaintain ${workspacePath}/SYSTEM.md to log all environment modifications:\n- Installed packages (apk add, npm install, pip install)\n- Environment variables set\n- Config files modified\n- Skill dependencies installed\n\nUpdate this file whenever you modify the environment.`);\n\n\tsections.push(`## Tools\n- read: Read files\n- edit: Surgical file edits\n- write: Create or overwrite files when needed\n- bash: Run shell commands and external programs\n- subagent: Delegate a focused task to a sub-agent with its own isolated context\n\nEach tool requires a \"label\" parameter (shown to user).`);\n\n\tsections.push(`## Sub-Agents\nYou have a \\`subagent\\` tool for delegating focused work to a separate agent with an isolated context window.\n\n### Predefined Sub-Agents\nPredefined sub-agent definitions live in \\`${subAgentsPath}/\\`.\n${options.subAgentList ? `Available predefined sub-agents:\\n${options.subAgentList}` : \"Available predefined sub-agents: none\"}\n\n### Temporary Inline Sub-Agents\nIf no predefined sub-agent fits, you may define a temporary inline sub-agent directly in the \\`subagent\\` tool call by providing a focused \\`systemPrompt\\` plus optional tools, model, and budget settings.\n\nUse sub-agents when:\n- The task can be decomposed into a focused sub-problem\n- You need a fresh context for heavy file reading, shell work, or review\n- A specialized role would produce better results\n- The main conversation has grown long and you want to offload a bounded task\n\nDo not use sub-agents when:\n- The task is simple and direct\n- The task depends heavily on the full current conversation state\n- The task requires frequent user confirmation\n\nImportant rules:\n- Sub-agents cannot see your conversation history unless you include the needed context in \\`task\\`\n- The runtime injects a small fixed execution context (workspace path, channel id, sandbox), but you must still include task-specific context yourself\n- Sub-agents do not receive the \\`subagent\\` tool, so they cannot create nested agents\n- Prefer predefined sub-agents when one clearly fits\n- Use temporary inline sub-agents only when that extra flexibility is genuinely useful`);\n\n\treturn sections.join(\"\\n\\n\");\n}\n"]}
+{"version":3,"file":"prompt-builder.js","sourceRoot":"","sources":["../src/prompt-builder.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,uBAAuB,CACtC,aAAqB,EACrB,SAAiB,EACjB,aAA4B,EAC5B,UAAqC,EAAE;IAEvC,MAAM,WAAW,GAAG,GAAG,aAAa,IAAI,SAAS,EAAE,CAAC;IACpD,MAAM,aAAa,GAAG,GAAG,aAAa,aAAa,CAAC;IACpD,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,KAAK,QAAQ,CAAC;IAEjD,MAAM,cAAc,GAAG,QAAQ;QAC9B,CAAC,CAAC;;;uCAGmC;QACrC,CAAC,CAAC;4BACwB,OAAO,CAAC,GAAG,EAAE;uCACF,CAAC;IAEvC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,QAAQ,CAAC,IAAI,CAAC;;;;;;;;;;;;;EAab,cAAc;;;EAGd,aAAa;;;;;;;MAOT,SAAS;;;;;;;0DAO2C,CAAC,CAAC;IAE3D,QAAQ,CAAC,IAAI,CAAC;wHACyG,aAAa;;;;;;sCAM/F,SAAS;;;;;qCAKV,SAAS;;;;;qCAKT,SAAS,qEAAqE,IAAI,CAAC,cAAc,EAAE,CAAC,eAAe,EAAE,CAAC,QAAQ;;;;;;;6BAOtI,aAAa;;;;;;;gCAOV,CAAC,CAAC;IAEjC,QAAQ,CAAC,IAAI,CAAC;;;;sBAIO,aAAa;;4BAEP,WAAW;;oBAEnB,WAAW;;qBAEV,WAAW;;;;;;;;;;IAU5B,WAAW;IACX,WAAW;;uJAEwI,CAAC,CAAC;IAExJ,QAAQ,CAAC,IAAI,CAAC;WACJ,aAAa;;;;;;sDAM8B,CAAC,CAAC;IAEvD,QAAQ,CAAC,IAAI,CAAC;;;;;;;wDAOyC,CAAC,CAAC;IAEzD,QAAQ,CAAC,IAAI,CAAC;;;;6CAI8B,aAAa;EACxD,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,qCAAqC,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,uCAAuC;;;;;;;;;;;;;;;;;;;;;uFAqBvC,CAAC,CAAC;IAExF,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC9B,CAAC","sourcesContent":["import type { SandboxConfig } from \"./sandbox.js\";\n\nexport interface AppendSystemPromptOptions {\n\tsubAgentList?: string;\n}\n\nexport function buildAppendSystemPrompt(\n\tworkspacePath: string,\n\tchannelId: string,\n\tsandboxConfig: SandboxConfig,\n\toptions: AppendSystemPromptOptions = {},\n): string {\n\tconst channelPath = `${workspacePath}/${channelId}`;\n\tconst subAgentsPath = `${workspacePath}/sub-agents`;\n\tconst isDocker = sandboxConfig.type === \"docker\";\n\n\tconst envDescription = isDocker\n\t\t? `You are running inside a Docker container (Alpine Linux).\n- Bash working directory: / (use cd or absolute paths)\n- Install tools with: apk add <package>\n- Your changes persist across sessions`\n\t\t: `You are running directly on the host machine.\n- Bash working directory: ${process.cwd()}\n- Be careful with system modifications`;\n\n\tconst sections: string[] = [];\n\n\tsections.push(`## Pipiclaw Runtime\nYou are running inside Pipiclaw, a DingTalk-oriented runtime built on top of pi.\n\n## Context\n- For current date/time, use: date\n- You have access to the active session context for this session.\n- Raw transcript files are cold storage. Do not assume they are preloaded.\n\n## Formatting\nUse Markdown for formatting. DingTalk AI Card supports basic Markdown:\nBold: **text**, Italic: *text*, Code: \\`code\\`, Block: \\`\\`\\`code\\`\\`\\`, Links: [text](url)\n\n## Environment\n${envDescription}\n\n## Workspace Layout\n${workspacePath}/\n├── SOUL.md                      # Your identity/personality (read-only)\n├── AGENTS.md                    # Custom behavior instructions (read-only)\n├── MEMORY.md                    # Stable workspace memory (admin-managed, read on demand)\n├── sub-agents/                  # Predefined sub-agent definitions\n├── skills/                      # Global CLI tools you create\n├── events/                      # Scheduled events\n└── ${channelId}/                # This channel\n    ├── SESSION.md               # Channel working memory (runtime-managed, read on demand)\n    ├── MEMORY.md                # Channel durable memory (read on demand, runtime-managed)\n    ├── HISTORY.md               # Channel summarized history (read on demand, runtime-managed)\n    ├── log.jsonl                # Raw message archive (cold storage)\n    ├── context.jsonl            # Raw session archive (cold storage)\n    ├── scratch/                 # Your working directory\n    └── skills/                  # Channel-specific tools`);\n\n\tsections.push(`## Events\nYou can schedule events that wake you up at specific times or when external things happen. Events are JSON files in \\`${workspacePath}/events/\\`.\n\n### Event Types\n\n**Immediate** - Triggers as soon as harness sees the file.\n\\`\\`\\`json\n{\"type\": \"immediate\", \"channelId\": \"${channelId}\", \"text\": \"New event occurred\"}\n\\`\\`\\`\n\n**One-shot** - Triggers once at a specific time.\n\\`\\`\\`json\n{\"type\": \"one-shot\", \"channelId\": \"${channelId}\", \"text\": \"Reminder\", \"at\": \"2025-12-15T09:00:00+08:00\"}\n\\`\\`\\`\n\n**Periodic** - Triggers on a cron schedule.\n\\`\\`\\`json\n{\"type\": \"periodic\", \"channelId\": \"${channelId}\", \"text\": \"Check inbox\", \"schedule\": \"0 9 * * 1-5\", \"timezone\": \"${Intl.DateTimeFormat().resolvedOptions().timeZone}\"}\n\\`\\`\\`\n\n### Cron Format\n\\`minute hour day-of-month month day-of-week\\`\n\n### Creating Events\nCreate a JSON file under \\`${workspacePath}/events/\\` with the appropriate event payload.\nPrefer the file tools for creating or editing the event file. Use shell commands only when they are the clearest option.\n\n### Silent Completion\nFor periodic events where there's nothing to report, respond with just \\`[SILENT]\\`. This deletes the status message. Use this to avoid spam when periodic checks find nothing.\n\n### Limits\nMaximum 5 events can be queued.`);\n\n\tsections.push(`## Memory\nMemory files are not preloaded into session context. Read them explicitly when memory or history matters.\n\n### Files\n- Workspace memory: ${workspacePath}/MEMORY.md\n  Stable shared background memory. Admin-managed. Read on demand.\n- Channel session memory: ${channelPath}/SESSION.md\n  Current working state for this channel. Runtime-managed. Read on demand. Prefer this when current task state matters.\n- Channel memory: ${channelPath}/MEMORY.md\n  Durable channel memory. Runtime-managed via consolidation. Prefer this for stable facts, decisions, preferences, and medium-horizon open loops.\n- Channel history: ${channelPath}/HISTORY.md\n  Summarized older channel history. Runtime-managed. Read on demand. Do not maintain this file manually during normal work.\n\n### Runtime Behavior\n- The runtime may inject a small amount of relevant memory context from SESSION.md / MEMORY.md / HISTORY.md into a turn when it is clearly useful.\n- SESSION.md is the primary runtime-managed working-state artifact for current active work.\n- The runtime automatically consolidates channel MEMORY.md and HISTORY.md before compaction or session trimming.\n- Workspace MEMORY.md is not updated by normal runtime consolidation.\n\n### Cold Storage\n- ${channelPath}/log.jsonl is a raw archive. It is not normal memory and is not proactively loaded.\n- ${channelPath}/context.jsonl is a raw session archive. It is not normal memory and is not proactively loaded.\n\nWhen a task depends on prior decisions, preferences, or long-running work, prefer SESSION.md first for current state, then MEMORY.md, then HISTORY.md.`);\n\n\tsections.push(`## System Configuration Log\nMaintain ${workspacePath}/SYSTEM.md to log all environment modifications:\n- Installed packages (apk add, npm install, pip install)\n- Environment variables set\n- Config files modified\n- Skill dependencies installed\n\nUpdate this file whenever you modify the environment.`);\n\n\tsections.push(`## Tools\n- read: Read files\n- edit: Surgical file edits\n- write: Create or overwrite files when needed\n- bash: Run shell commands and external programs\n- subagent: Delegate a focused task to a sub-agent with its own isolated context\n\nEach tool requires a \"label\" parameter (shown to user).`);\n\n\tsections.push(`## Sub-Agents\nYou have a \\`subagent\\` tool for delegating focused work to a separate agent with an isolated context window.\n\n### Predefined Sub-Agents\nPredefined sub-agent definitions live in \\`${subAgentsPath}/\\`.\n${options.subAgentList ? `Available predefined sub-agents:\\n${options.subAgentList}` : \"Available predefined sub-agents: none\"}\n\n### Temporary Inline Sub-Agents\nIf no predefined sub-agent fits, you may define a temporary inline sub-agent directly in the \\`subagent\\` tool call by providing a focused \\`systemPrompt\\` plus optional tools, model, and budget settings.\n\nUse sub-agents when:\n- The task can be decomposed into a focused sub-problem\n- You need a fresh context for heavy file reading, shell work, or review\n- A specialized role would produce better results\n- The main conversation has grown long and you want to offload a bounded task\n\nDo not use sub-agents when:\n- The task is simple and direct\n- The task depends heavily on the full current conversation state\n- The task requires frequent user confirmation\n\nImportant rules:\n- Sub-agents cannot see your conversation history unless you include the needed context in \\`task\\`\n- The runtime injects a small fixed execution context (workspace path, channel id, sandbox), but you must still include task-specific context yourself\n- Sub-agents do not receive the \\`subagent\\` tool, so they cannot create nested agents\n- Prefer predefined sub-agents when one clearly fits\n- Use temporary inline sub-agents only when that extra flexibility is genuinely useful`);\n\n\treturn sections.join(\"\\n\\n\");\n}\n"]}

package/dist/session-memory-files.d.ts

@@ -0,0 +1,2 @@
+export { ensureChannelMemoryFiles, ensureChannelMemoryFilesSync, getChannelSessionPath, readChannelSession, rewriteChannelSession, } from "./memory-files.js";
+//# sourceMappingURL=session-memory-files.d.ts.map

package/dist/session-memory-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-memory-files.d.ts","sourceRoot":"","sources":["../src/session-memory-files.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,wBAAwB,EACxB,4BAA4B,EAC5B,qBAAqB,EACrB,kBAAkB,EAClB,qBAAqB,GACrB,MAAM,mBAAmB,CAAC"}

package/dist/session-memory-files.js

@@ -0,0 +1,2 @@
+export { ensureChannelMemoryFiles, ensureChannelMemoryFilesSync, getChannelSessionPath, readChannelSession, rewriteChannelSession, } from "./memory-files.js";
+//# sourceMappingURL=session-memory-files.js.map

package/dist/session-memory-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-memory-files.js","sourceRoot":"","sources":["../src/session-memory-files.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,wBAAwB,EACxB,4BAA4B,EAC5B,qBAAqB,EACrB,kBAAkB,EAClB,qBAAqB,GACrB,MAAM,mBAAmB,CAAC","sourcesContent":["export {\n\tensureChannelMemoryFiles,\n\tensureChannelMemoryFilesSync,\n\tgetChannelSessionPath,\n\treadChannelSession,\n\trewriteChannelSession,\n} from \"./memory-files.js\";\n"]}

package/dist/session-memory.d.ts

@@ -0,0 +1,22 @@
+import type { AgentMessage } from "@mariozechner/pi-agent-core";
+import type { Api, Model } from "@mariozechner/pi-ai";
+export interface SessionMemoryState {
+    title: string;
+    currentState: string[];
+    userIntent: string[];
+    activeFiles: string[];
+    decisions: string[];
+    constraints: string[];
+    errorsAndCorrections: string[];
+    nextSteps: string[];
+    worklog: string[];
+}
+export interface SessionMemoryUpdateOptions {
+    channelDir: string;
+    messages: AgentMessage[];
+    model: Model<Api>;
+    resolveApiKey: (model: Model<Api>) => Promise<string>;
+}
+export declare function renderSessionMemory(state: SessionMemoryState): string;
+export declare function updateChannelSessionMemory(options: SessionMemoryUpdateOptions): Promise<SessionMemoryState>;
+//# sourceMappingURL=session-memory.d.ts.map

package/dist/session-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-memory.d.ts","sourceRoot":"","sources":["../src/session-memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,GAAG,EAAW,KAAK,EAAE,MAAM,qBAAqB,CAAC;AA2C/D,MAAM,WAAW,kBAAkB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,0BAA0B;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IAClB,aAAa,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACtD;AA0LD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAyBrE;AAcD,wBAAsB,0BAA0B,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA4BjH"}

package/dist/session-memory.js

@@ -0,0 +1,274 @@
+import { serializeConversation } from "@mariozechner/pi-coding-agent";
+import { writeFile } from "fs/promises";
+import { join } from "path";
+import { parseJsonObject } from "./llm-json.js";
+import { splitLevelOneSections } from "./markdown-sections.js";
+import { readChannelMemory } from "./memory-files.js";
+import { readChannelSession, rewriteChannelSession } from "./session-memory-files.js";
+import { runSidecarTask, SidecarParseError } from "./sidecar-worker.js";
+const SESSION_TRANSCRIPT_MAX_CHARS = 20_000;
+const SESSION_MEMORY_MAX_CHARS = 4_000;
+const SESSION_ITEM_LIMIT = 12;
+const SESSION_ITEM_MAX_CHARS = 300;
+const SESSION_MEMORY_TIMEOUT_MS = 10_000;
+const SESSION_MEMORY_SYSTEM_PROMPT = `You maintain a Pipiclaw SESSION.md file.
+
+Return strict JSON only. Do not use Markdown fences.
+
+Output schema:
+{
+  "title": "string",
+  "currentState": ["string"],
+  "userIntent": ["string"],
+  "activeFiles": ["string"],
+  "decisions": ["string"],
+  "constraints": ["string"],
+  "errorsAndCorrections": ["string"],
+  "nextSteps": ["string"],
+  "worklog": ["string"]
+}
+
+Rules:
+- Prefer short, information-dense bullet-sized items.
+- Capture only the current active work state, not the full conversation history.
+- Keep durable facts out unless they are directly relevant to the current work.
+- "activeFiles" should list only files, directories, or work areas currently in focus.
+- "errorsAndCorrections" should record recent failures, fixes, or things to avoid repeating.
+- "nextSteps" should reflect the most likely immediate follow-up actions.
+- "worklog" must stay terse and recent.
+- If a field has nothing useful, return an empty string or empty array.`;
+function clipText(text, maxChars) {
+    const normalized = text.replace(/\r/g, "").trim();
+    if (normalized.length <= maxChars) {
+        return normalized;
+    }
+    const headChars = Math.floor(maxChars * 0.45);
+    const tailChars = maxChars - headChars;
+    return `${normalized.slice(0, headChars)}\n\n[... omitted middle section ...]\n\n${normalized.slice(-tailChars)}`;
+}
+function normalizeItem(value) {
+    if (typeof value !== "string") {
+        return null;
+    }
+    const normalized = value.replace(/\s+/g, " ").trim();
+    if (!normalized) {
+        return null;
+    }
+    return normalized.length > SESSION_ITEM_MAX_CHARS
+        ? `${normalized.slice(0, SESSION_ITEM_MAX_CHARS - 3)}...`
+        : normalized;
+}
+function normalizeItems(value) {
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    return value
+        .map(normalizeItem)
+        .filter((item) => !!item)
+        .slice(0, SESSION_ITEM_LIMIT);
+}
+function normalizeTitle(value) {
+    return typeof value === "string" ? value.trim().slice(0, 120) : "";
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function parseStateUpdate(text) {
+    const parsed = parseJsonObject(text);
+    if (!isRecord(parsed)) {
+        throw new Error("Session memory response was not a JSON object");
+    }
+    const next = {};
+    if ("title" in parsed)
+        next.title = normalizeTitle(parsed.title);
+    if ("currentState" in parsed)
+        next.currentState = normalizeItems(parsed.currentState);
+    if ("userIntent" in parsed)
+        next.userIntent = normalizeItems(parsed.userIntent);
+    if ("activeFiles" in parsed)
+        next.activeFiles = normalizeItems(parsed.activeFiles);
+    if ("decisions" in parsed)
+        next.decisions = normalizeItems(parsed.decisions);
+    if ("constraints" in parsed)
+        next.constraints = normalizeItems(parsed.constraints);
+    if ("errorsAndCorrections" in parsed)
+        next.errorsAndCorrections = normalizeItems(parsed.errorsAndCorrections);
+    if ("nextSteps" in parsed)
+        next.nextSteps = normalizeItems(parsed.nextSteps);
+    if ("worklog" in parsed)
+        next.worklog = normalizeItems(parsed.worklog);
+    return next;
+}
+function createEmptySessionMemoryState() {
+    return {
+        title: "",
+        currentState: [],
+        userIntent: [],
+        activeFiles: [],
+        decisions: [],
+        constraints: [],
+        errorsAndCorrections: [],
+        nextSteps: [],
+        worklog: [],
+    };
+}
+function stripHtmlComments(text) {
+    return text.replace(/<!--[\s\S]*?-->/g, "").trim();
+}
+function parseSectionItems(content) {
+    const normalized = stripHtmlComments(content);
+    if (!normalized) {
+        return [];
+    }
+    const lines = normalized
+        .split("\n")
+        .map((line) => line.trim())
+        .filter(Boolean);
+    const bulletItems = lines
+        .filter((line) => line.startsWith("- "))
+        .map((line) => normalizeItem(line.slice(2)))
+        .filter((item) => !!item);
+    if (bulletItems.length > 0) {
+        return bulletItems.slice(0, SESSION_ITEM_LIMIT);
+    }
+    return lines
+        .map(normalizeItem)
+        .filter((item) => !!item)
+        .slice(0, SESSION_ITEM_LIMIT);
+}
+function parseRenderedSessionMemory(markdown) {
+    const state = createEmptySessionMemoryState();
+    for (const section of splitLevelOneSections(markdown)) {
+        switch (section.heading.toLowerCase()) {
+            case "session title":
+                state.title = stripHtmlComments(section.content).split("\n")[0]?.trim().slice(0, 120) || "";
+                break;
+            case "current state":
+                state.currentState = parseSectionItems(section.content);
+                break;
+            case "user intent":
+                state.userIntent = parseSectionItems(section.content);
+                break;
+            case "active files":
+                state.activeFiles = parseSectionItems(section.content);
+                break;
+            case "decisions":
+                state.decisions = parseSectionItems(section.content);
+                break;
+            case "constraints":
+                state.constraints = parseSectionItems(section.content);
+                break;
+            case "errors & corrections":
+                state.errorsAndCorrections = parseSectionItems(section.content);
+                break;
+            case "next steps":
+                state.nextSteps = parseSectionItems(section.content);
+                break;
+            case "worklog":
+                state.worklog = parseSectionItems(section.content);
+                break;
+        }
+    }
+    return state;
+}
+function mergeSessionMemoryState(current, update) {
+    return {
+        title: typeof update.title === "string" ? update.title : current.title,
+        currentState: Array.isArray(update.currentState) ? update.currentState : current.currentState,
+        userIntent: Array.isArray(update.userIntent) ? update.userIntent : current.userIntent,
+        activeFiles: Array.isArray(update.activeFiles) ? update.activeFiles : current.activeFiles,
+        decisions: Array.isArray(update.decisions) ? update.decisions : current.decisions,
+        constraints: Array.isArray(update.constraints) ? update.constraints : current.constraints,
+        errorsAndCorrections: Array.isArray(update.errorsAndCorrections)
+            ? update.errorsAndCorrections
+            : current.errorsAndCorrections,
+        nextSteps: Array.isArray(update.nextSteps) ? update.nextSteps : current.nextSteps,
+        worklog: Array.isArray(update.worklog) ? update.worklog : current.worklog,
+    };
+}
+async function writeSessionMemoryDebugFile(channelDir, error, rawText) {
+    const debugPath = join(channelDir, "SESSION.invalid-response.txt");
+    const header = [
+        `timestamp: ${new Date().toISOString()}`,
+        `error: ${error instanceof Error ? error.message : String(error)}`,
+        "",
+        "raw response:",
+        "",
+    ].join("\n");
+    await writeFile(debugPath, `${header}${rawText}\n`, "utf-8");
+}
+function renderSection(heading, items) {
+    return [`# ${heading}`, "", ...items.map((item) => `- ${item}`)].join("\n");
+}
+function isStandardAgentMessage(message) {
+    return (typeof message === "object" &&
+        message !== null &&
+        "role" in message &&
+        (message.role === "user" || message.role === "assistant" || message.role === "toolResult"));
+}
+function buildMessagesForSessionMemory(messages) {
+    return messages.filter(isStandardAgentMessage);
+}
+export function renderSessionMemory(state) {
+    const sections = [];
+    if (state.title.trim()) {
+        sections.push("# Session Title", "", state.title.trim());
+    }
+    const orderedSections = [
+        ["Current State", state.currentState],
+        ["User Intent", state.userIntent],
+        ["Active Files", state.activeFiles],
+        ["Decisions", state.decisions],
+        ["Constraints", state.constraints],
+        ["Errors & Corrections", state.errorsAndCorrections],
+        ["Next Steps", state.nextSteps],
+        ["Worklog", state.worklog],
+    ];
+    for (const [heading, items] of orderedSections) {
+        if (items.length === 0 && heading === "Worklog") {
+            continue;
+        }
+        sections.push(renderSection(heading, items));
+    }
+    return `${sections.join("\n\n").trim()}\n`;
+}
+function buildSessionPrompt(currentSession, currentMemory, messages) {
+    const transcript = clipText(serializeConversation(messages), SESSION_TRANSCRIPT_MAX_CHARS);
+    return `Current SESSION.md:
+${currentSession || "(empty)"}
+
+Current channel MEMORY.md:
+${clipText(currentMemory, SESSION_MEMORY_MAX_CHARS) || "(empty)"}
+
+Recent conversation:
+${transcript || "(empty)"}`;
+}
+export async function updateChannelSessionMemory(options) {
+    const currentSession = await readChannelSession(options.channelDir);
+    const currentMemory = await readChannelMemory(options.channelDir);
+    const messages = buildMessagesForSessionMemory(options.messages);
+    const currentState = parseRenderedSessionMemory(currentSession);
+    let update;
+    try {
+        const result = await runSidecarTask({
+            name: "session-memory-update",
+            model: options.model,
+            resolveApiKey: options.resolveApiKey,
+            systemPrompt: SESSION_MEMORY_SYSTEM_PROMPT,
+            prompt: buildSessionPrompt(currentSession, currentMemory, messages),
+            parse: parseStateUpdate,
+            timeoutMs: SESSION_MEMORY_TIMEOUT_MS,
+        });
+        update = result.output;
+    }
+    catch (error) {
+        if (error instanceof SidecarParseError) {
+            await writeSessionMemoryDebugFile(options.channelDir, error.cause ?? error, error.rawText);
+        }
+        throw error;
+    }
+    const rendered = renderSessionMemory(mergeSessionMemoryState(currentState, update));
+    await rewriteChannelSession(options.channelDir, rendered);
+    return parseRenderedSessionMemory(rendered);
+}
+//# sourceMappingURL=session-memory.js.map

package/dist/session-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-memory.js","sourceRoot":"","sources":["../src/session-memory.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentMessage } from \"@mariozechner/pi-agent-core\";\nimport type { Api, Message, Model } from \"@mariozechner/pi-ai\";\nimport { serializeConversation } from \"@mariozechner/pi-coding-agent\";\nimport { writeFile } from \"fs/promises\";\nimport { join } from \"path\";\nimport { parseJsonObject } from \"./llm-json.js\";\nimport { splitLevelOneSections } from \"./markdown-sections.js\";\nimport { readChannelMemory } from \"./memory-files.js\";\nimport { readChannelSession, rewriteChannelSession } from \"./session-memory-files.js\";\nimport { runSidecarTask, SidecarParseError } from \"./sidecar-worker.js\";\n\nconst SESSION_TRANSCRIPT_MAX_CHARS = 20_000;\nconst SESSION_MEMORY_MAX_CHARS = 4_000;\nconst SESSION_ITEM_LIMIT = 12;\nconst SESSION_ITEM_MAX_CHARS = 300;\nconst SESSION_MEMORY_TIMEOUT_MS = 10_000;\n\nconst SESSION_MEMORY_SYSTEM_PROMPT = `You maintain a Pipiclaw SESSION.md file.\n\nReturn strict JSON only. Do not use Markdown fences.\n\nOutput schema:\n{\n  \"title\": \"string\",\n  \"currentState\": [\"string\"],\n  \"userIntent\": [\"string\"],\n  \"activeFiles\": [\"string\"],\n  \"decisions\": [\"string\"],\n  \"constraints\": [\"string\"],\n  \"errorsAndCorrections\": [\"string\"],\n  \"nextSteps\": [\"string\"],\n  \"worklog\": [\"string\"]\n}\n\nRules:\n- Prefer short, information-dense bullet-sized items.\n- Capture only the current active work state, not the full conversation history.\n- Keep durable facts out unless they are directly relevant to the current work.\n- \"activeFiles\" should list only files, directories, or work areas currently in focus.\n- \"errorsAndCorrections\" should record recent failures, fixes, or things to avoid repeating.\n- \"nextSteps\" should reflect the most likely immediate follow-up actions.\n- \"worklog\" must stay terse and recent.\n- If a field has nothing useful, return an empty string or empty array.`;\n\nexport interface SessionMemoryState {\n\ttitle: string;\n\tcurrentState: string[];\n\tuserIntent: string[];\n\tactiveFiles: string[];\n\tdecisions: string[];\n\tconstraints: string[];\n\terrorsAndCorrections: string[];\n\tnextSteps: string[];\n\tworklog: string[];\n}\n\nexport interface SessionMemoryUpdateOptions {\n\tchannelDir: string;\n\tmessages: AgentMessage[];\n\tmodel: Model<Api>;\n\tresolveApiKey: (model: Model<Api>) => Promise<string>;\n}\n\ntype SessionMemoryStateUpdate = Partial<Record<keyof SessionMemoryState, string[] | string>>;\n\nfunction clipText(text: string, maxChars: number): string {\n\tconst normalized = text.replace(/\\r/g, \"\").trim();\n\tif (normalized.length <= maxChars) {\n\t\treturn normalized;\n\t}\n\tconst headChars = Math.floor(maxChars * 0.45);\n\tconst tailChars = maxChars - headChars;\n\treturn `${normalized.slice(0, headChars)}\\n\\n[... omitted middle section ...]\\n\\n${normalized.slice(-tailChars)}`;\n}\n\nfunction normalizeItem(value: unknown): string | null {\n\tif (typeof value !== \"string\") {\n\t\treturn null;\n\t}\n\tconst normalized = value.replace(/\\s+/g, \" \").trim();\n\tif (!normalized) {\n\t\treturn null;\n\t}\n\treturn normalized.length > SESSION_ITEM_MAX_CHARS\n\t\t? `${normalized.slice(0, SESSION_ITEM_MAX_CHARS - 3)}...`\n\t\t: normalized;\n}\n\nfunction normalizeItems(value: unknown): string[] {\n\tif (!Array.isArray(value)) {\n\t\treturn [];\n\t}\n\treturn value\n\t\t.map(normalizeItem)\n\t\t.filter((item): item is string => !!item)\n\t\t.slice(0, SESSION_ITEM_LIMIT);\n}\n\nfunction normalizeTitle(value: unknown): string {\n\treturn typeof value === \"string\" ? value.trim().slice(0, 120) : \"\";\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null;\n}\n\nfunction parseStateUpdate(text: string): SessionMemoryStateUpdate {\n\tconst parsed = parseJsonObject(text);\n\tif (!isRecord(parsed)) {\n\t\tthrow new Error(\"Session memory response was not a JSON object\");\n\t}\n\n\tconst next: SessionMemoryStateUpdate = {};\n\tif (\"title\" in parsed) next.title = normalizeTitle(parsed.title);\n\tif (\"currentState\" in parsed) next.currentState = normalizeItems(parsed.currentState);\n\tif (\"userIntent\" in parsed) next.userIntent = normalizeItems(parsed.userIntent);\n\tif (\"activeFiles\" in parsed) next.activeFiles = normalizeItems(parsed.activeFiles);\n\tif (\"decisions\" in parsed) next.decisions = normalizeItems(parsed.decisions);\n\tif (\"constraints\" in parsed) next.constraints = normalizeItems(parsed.constraints);\n\tif (\"errorsAndCorrections\" in parsed) next.errorsAndCorrections = normalizeItems(parsed.errorsAndCorrections);\n\tif (\"nextSteps\" in parsed) next.nextSteps = normalizeItems(parsed.nextSteps);\n\tif (\"worklog\" in parsed) next.worklog = normalizeItems(parsed.worklog);\n\treturn next;\n}\n\nfunction createEmptySessionMemoryState(): SessionMemoryState {\n\treturn {\n\t\ttitle: \"\",\n\t\tcurrentState: [],\n\t\tuserIntent: [],\n\t\tactiveFiles: [],\n\t\tdecisions: [],\n\t\tconstraints: [],\n\t\terrorsAndCorrections: [],\n\t\tnextSteps: [],\n\t\tworklog: [],\n\t};\n}\n\nfunction stripHtmlComments(text: string): string {\n\treturn text.replace(/<!--[\\s\\S]*?-->/g, \"\").trim();\n}\n\nfunction parseSectionItems(content: string): string[] {\n\tconst normalized = stripHtmlComments(content);\n\tif (!normalized) {\n\t\treturn [];\n\t}\n\n\tconst lines = normalized\n\t\t.split(\"\\n\")\n\t\t.map((line) => line.trim())\n\t\t.filter(Boolean);\n\tconst bulletItems = lines\n\t\t.filter((line) => line.startsWith(\"- \"))\n\t\t.map((line) => normalizeItem(line.slice(2)))\n\t\t.filter((item): item is string => !!item);\n\tif (bulletItems.length > 0) {\n\t\treturn bulletItems.slice(0, SESSION_ITEM_LIMIT);\n\t}\n\treturn lines\n\t\t.map(normalizeItem)\n\t\t.filter((item): item is string => !!item)\n\t\t.slice(0, SESSION_ITEM_LIMIT);\n}\n\nfunction parseRenderedSessionMemory(markdown: string): SessionMemoryState {\n\tconst state = createEmptySessionMemoryState();\n\tfor (const section of splitLevelOneSections(markdown)) {\n\t\tswitch (section.heading.toLowerCase()) {\n\t\t\tcase \"session title\":\n\t\t\t\tstate.title = stripHtmlComments(section.content).split(\"\\n\")[0]?.trim().slice(0, 120) || \"\";\n\t\t\t\tbreak;\n\t\t\tcase \"current state\":\n\t\t\t\tstate.currentState = parseSectionItems(section.content);\n\t\t\t\tbreak;\n\t\t\tcase \"user intent\":\n\t\t\t\tstate.userIntent = parseSectionItems(section.content);\n\t\t\t\tbreak;\n\t\t\tcase \"active files\":\n\t\t\t\tstate.activeFiles = parseSectionItems(section.content);\n\t\t\t\tbreak;\n\t\t\tcase \"decisions\":\n\t\t\t\tstate.decisions = parseSectionItems(section.content);\n\t\t\t\tbreak;\n\t\t\tcase \"constraints\":\n\t\t\t\tstate.constraints = parseSectionItems(section.content);\n\t\t\t\tbreak;\n\t\t\tcase \"errors & corrections\":\n\t\t\t\tstate.errorsAndCorrections = parseSectionItems(section.content);\n\t\t\t\tbreak;\n\t\t\tcase \"next steps\":\n\t\t\t\tstate.nextSteps = parseSectionItems(section.content);\n\t\t\t\tbreak;\n\t\t\tcase \"worklog\":\n\t\t\t\tstate.worklog = parseSectionItems(section.content);\n\t\t\t\tbreak;\n\t\t}\n\t}\n\treturn state;\n}\n\nfunction mergeSessionMemoryState(current: SessionMemoryState, update: SessionMemoryStateUpdate): SessionMemoryState {\n\treturn {\n\t\ttitle: typeof update.title === \"string\" ? update.title : current.title,\n\t\tcurrentState: Array.isArray(update.currentState) ? update.currentState : current.currentState,\n\t\tuserIntent: Array.isArray(update.userIntent) ? update.userIntent : current.userIntent,\n\t\tactiveFiles: Array.isArray(update.activeFiles) ? update.activeFiles : current.activeFiles,\n\t\tdecisions: Array.isArray(update.decisions) ? update.decisions : current.decisions,\n\t\tconstraints: Array.isArray(update.constraints) ? update.constraints : current.constraints,\n\t\terrorsAndCorrections: Array.isArray(update.errorsAndCorrections)\n\t\t\t? update.errorsAndCorrections\n\t\t\t: current.errorsAndCorrections,\n\t\tnextSteps: Array.isArray(update.nextSteps) ? update.nextSteps : current.nextSteps,\n\t\tworklog: Array.isArray(update.worklog) ? update.worklog : current.worklog,\n\t};\n}\n\nasync function writeSessionMemoryDebugFile(channelDir: string, error: unknown, rawText: string): Promise<void> {\n\tconst debugPath = join(channelDir, \"SESSION.invalid-response.txt\");\n\tconst header = [\n\t\t`timestamp: ${new Date().toISOString()}`,\n\t\t`error: ${error instanceof Error ? error.message : String(error)}`,\n\t\t\"\",\n\t\t\"raw response:\",\n\t\t\"\",\n\t].join(\"\\n\");\n\tawait writeFile(debugPath, `${header}${rawText}\\n`, \"utf-8\");\n}\n\nfunction renderSection(heading: string, items: string[]): string {\n\treturn [`# ${heading}`, \"\", ...items.map((item) => `- ${item}`)].join(\"\\n\");\n}\n\nfunction isStandardAgentMessage(message: AgentMessage): message is Message {\n\treturn (\n\t\ttypeof message === \"object\" &&\n\t\tmessage !== null &&\n\t\t\"role\" in message &&\n\t\t(message.role === \"user\" || message.role === \"assistant\" || message.role === \"toolResult\")\n\t);\n}\n\nfunction buildMessagesForSessionMemory(messages: AgentMessage[]): Message[] {\n\treturn messages.filter(isStandardAgentMessage);\n}\n\nexport function renderSessionMemory(state: SessionMemoryState): string {\n\tconst sections: string[] = [];\n\tif (state.title.trim()) {\n\t\tsections.push(\"# Session Title\", \"\", state.title.trim());\n\t}\n\n\tconst orderedSections: Array<[string, string[]]> = [\n\t\t[\"Current State\", state.currentState],\n\t\t[\"User Intent\", state.userIntent],\n\t\t[\"Active Files\", state.activeFiles],\n\t\t[\"Decisions\", state.decisions],\n\t\t[\"Constraints\", state.constraints],\n\t\t[\"Errors & Corrections\", state.errorsAndCorrections],\n\t\t[\"Next Steps\", state.nextSteps],\n\t\t[\"Worklog\", state.worklog],\n\t];\n\n\tfor (const [heading, items] of orderedSections) {\n\t\tif (items.length === 0 && heading === \"Worklog\") {\n\t\t\tcontinue;\n\t\t}\n\t\tsections.push(renderSection(heading, items));\n\t}\n\n\treturn `${sections.join(\"\\n\\n\").trim()}\\n`;\n}\n\nfunction buildSessionPrompt(currentSession: string, currentMemory: string, messages: Message[]): string {\n\tconst transcript = clipText(serializeConversation(messages), SESSION_TRANSCRIPT_MAX_CHARS);\n\treturn `Current SESSION.md:\n${currentSession || \"(empty)\"}\n\nCurrent channel MEMORY.md:\n${clipText(currentMemory, SESSION_MEMORY_MAX_CHARS) || \"(empty)\"}\n\nRecent conversation:\n${transcript || \"(empty)\"}`;\n}\n\nexport async function updateChannelSessionMemory(options: SessionMemoryUpdateOptions): Promise<SessionMemoryState> {\n\tconst currentSession = await readChannelSession(options.channelDir);\n\tconst currentMemory = await readChannelMemory(options.channelDir);\n\tconst messages = buildMessagesForSessionMemory(options.messages);\n\tconst currentState = parseRenderedSessionMemory(currentSession);\n\n\tlet update: SessionMemoryStateUpdate;\n\ttry {\n\t\tconst result = await runSidecarTask({\n\t\t\tname: \"session-memory-update\",\n\t\t\tmodel: options.model,\n\t\t\tresolveApiKey: options.resolveApiKey,\n\t\t\tsystemPrompt: SESSION_MEMORY_SYSTEM_PROMPT,\n\t\t\tprompt: buildSessionPrompt(currentSession, currentMemory, messages),\n\t\t\tparse: parseStateUpdate,\n\t\t\ttimeoutMs: SESSION_MEMORY_TIMEOUT_MS,\n\t\t});\n\t\tupdate = result.output;\n\t} catch (error) {\n\t\tif (error instanceof SidecarParseError) {\n\t\t\tawait writeSessionMemoryDebugFile(options.channelDir, error.cause ?? error, error.rawText);\n\t\t}\n\t\tthrow error;\n\t}\n\n\tconst rendered = renderSessionMemory(mergeSessionMemoryState(currentState, update));\n\tawait rewriteChannelSession(options.channelDir, rendered);\n\treturn parseRenderedSessionMemory(rendered);\n}\n"]}

package/dist/sidecar-worker.d.ts

@@ -0,0 +1,27 @@
+import type { Api, Model } from "@mariozechner/pi-ai";
+export interface SidecarTask<T> {
+    name: string;
+    model: Model<Api>;
+    resolveApiKey: (model: Model<Api>) => Promise<string>;
+    systemPrompt: string;
+    prompt: string;
+    parse: (text: string) => T;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}
+export interface SidecarResult<T> {
+    output: T;
+    rawText: string;
+}
+export declare class SidecarTimeoutError extends Error {
+    readonly taskName: string;
+    readonly timeoutMs: number;
+    constructor(taskName: string, timeoutMs: number);
+}
+export declare class SidecarParseError extends Error {
+    readonly taskName: string;
+    readonly rawText: string;
+    constructor(taskName: string, rawText: string, cause: unknown);
+}
+export declare function runSidecarTask<T>(task: SidecarTask<T>): Promise<SidecarResult<T>>;
+//# sourceMappingURL=sidecar-worker.d.ts.map

package/dist/sidecar-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidecar-worker.d.ts","sourceRoot":"","sources":["../src/sidecar-worker.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAoB,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAGxE,MAAM,WAAW,WAAW,CAAC,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IAClB,aAAa,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACtD,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,CAAC,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,aAAa,CAAC,CAAC;IAC/B,MAAM,EAAE,CAAC,CAAC;IACV,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,mBAAoB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAM/C;AAED,qBAAa,iBAAkB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBAEb,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO;CAO7D;AAaD,wBAAsB,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CA2FvF"}

package/dist/sidecar-worker.js

@@ -0,0 +1,105 @@
+import { Agent } from "@mariozechner/pi-agent-core";
+import { convertToLlm } from "@mariozechner/pi-coding-agent";
+export class SidecarTimeoutError extends Error {
+    constructor(taskName, timeoutMs) {
+        super(`Sidecar task "${taskName}" timed out after ${timeoutMs}ms`);
+        this.name = "SidecarTimeoutError";
+        this.taskName = taskName;
+        this.timeoutMs = timeoutMs;
+    }
+}
+export class SidecarParseError extends Error {
+    constructor(taskName, rawText, cause) {
+        super(`Sidecar task "${taskName}" returned invalid output`);
+        this.name = "SidecarParseError";
+        this.taskName = taskName;
+        this.rawText = rawText;
+        this.cause = cause;
+    }
+}
+function extractAssistantText(message) {
+    return message.content
+        .filter((part) => part.type === "text")
+        .map((part) => part.text)
+        .join("\n")
+        .trim();
+}
+export async function runSidecarTask(task) {
+    const apiKey = await task.resolveApiKey(task.model);
+    const worker = new Agent({
+        initialState: {
+            systemPrompt: task.systemPrompt,
+            model: task.model,
+            thinkingLevel: "off",
+            tools: [],
+        },
+        convertToLlm,
+        getApiKey: async () => apiKey,
+    });
+    const abortWorker = () => {
+        try {
+            worker.abort();
+        }
+        catch {
+            /* ignore */
+        }
+    };
+    let removeAbortListener = () => { };
+    let timeoutHandle = null;
+    const runPromise = (async () => {
+        await worker.prompt(task.prompt);
+        await worker.waitForIdle();
+        const lastMessage = worker.state.messages[worker.state.messages.length - 1];
+        if (!lastMessage || lastMessage.role !== "assistant") {
+            throw new Error(`Sidecar task "${task.name}" returned no assistant message`);
+        }
+        if (lastMessage.stopReason === "error" || lastMessage.stopReason === "aborted") {
+            throw new Error(lastMessage.errorMessage || `Sidecar task "${task.name}" failed`);
+        }
+        const rawText = extractAssistantText(lastMessage);
+        try {
+            return {
+                output: task.parse(rawText),
+                rawText,
+            };
+        }
+        catch (error) {
+            throw new SidecarParseError(task.name, rawText, error);
+        }
+    })();
+    void runPromise.catch(() => { });
+    const blockers = [];
+    if (task.timeoutMs && task.timeoutMs > 0) {
+        blockers.push(new Promise((_, reject) => {
+            timeoutHandle = setTimeout(() => {
+                abortWorker();
+                reject(new SidecarTimeoutError(task.name, task.timeoutMs));
+            }, task.timeoutMs);
+        }));
+    }
+    if (task.signal) {
+        const signal = task.signal;
+        blockers.push(new Promise((_, reject) => {
+            const abort = () => {
+                abortWorker();
+                reject(signal.reason instanceof Error ? signal.reason : new Error(`Sidecar task "${task.name}" aborted`));
+            };
+            if (signal.aborted) {
+                abort();
+                return;
+            }
+            signal.addEventListener("abort", abort, { once: true });
+            removeAbortListener = () => signal.removeEventListener("abort", abort);
+        }));
+    }
+    try {
+        return blockers.length > 0 ? await Promise.race([runPromise, ...blockers]) : await runPromise;
+    }
+    finally {
+        if (timeoutHandle) {
+            clearTimeout(timeoutHandle);
+        }
+        removeAbortListener();
+    }
+}
+//# sourceMappingURL=sidecar-worker.js.map

package/dist/sidecar-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidecar-worker.js","sourceRoot":"","sources":["../src/sidecar-worker.ts"],"names":[],"mappings":"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","sourcesContent":["import { Agent } from \"@mariozechner/pi-agent-core\";\nimport type { Api, AssistantMessage, Model } from \"@mariozechner/pi-ai\";\nimport { convertToLlm } from \"@mariozechner/pi-coding-agent\";\n\nexport interface SidecarTask<T> {\n\tname: string;\n\tmodel: Model<Api>;\n\tresolveApiKey: (model: Model<Api>) => Promise<string>;\n\tsystemPrompt: string;\n\tprompt: string;\n\tparse: (text: string) => T;\n\ttimeoutMs?: number;\n\tsignal?: AbortSignal;\n}\n\nexport interface SidecarResult<T> {\n\toutput: T;\n\trawText: string;\n}\n\nexport class SidecarTimeoutError extends Error {\n\treadonly taskName: string;\n\treadonly timeoutMs: number;\n\n\tconstructor(taskName: string, timeoutMs: number) {\n\t\tsuper(`Sidecar task \"${taskName}\" timed out after ${timeoutMs}ms`);\n\t\tthis.name = \"SidecarTimeoutError\";\n\t\tthis.taskName = taskName;\n\t\tthis.timeoutMs = timeoutMs;\n\t}\n}\n\nexport class SidecarParseError extends Error {\n\treadonly taskName: string;\n\treadonly rawText: string;\n\n\tconstructor(taskName: string, rawText: string, cause: unknown) {\n\t\tsuper(`Sidecar task \"${taskName}\" returned invalid output`);\n\t\tthis.name = \"SidecarParseError\";\n\t\tthis.taskName = taskName;\n\t\tthis.rawText = rawText;\n\t\tthis.cause = cause;\n\t}\n}\n\nfunction extractAssistantText(message: AssistantMessage): string {\n\treturn message.content\n\t\t.filter(\n\t\t\t(part): part is Extract<AssistantMessage[\"content\"][number], { type: \"text\"; text: string }> =>\n\t\t\t\tpart.type === \"text\",\n\t\t)\n\t\t.map((part) => part.text)\n\t\t.join(\"\\n\")\n\t\t.trim();\n}\n\nexport async function runSidecarTask<T>(task: SidecarTask<T>): Promise<SidecarResult<T>> {\n\tconst apiKey = await task.resolveApiKey(task.model);\n\tconst worker = new Agent({\n\t\tinitialState: {\n\t\t\tsystemPrompt: task.systemPrompt,\n\t\t\tmodel: task.model,\n\t\t\tthinkingLevel: \"off\",\n\t\t\ttools: [],\n\t\t},\n\t\tconvertToLlm,\n\t\tgetApiKey: async () => apiKey,\n\t});\n\n\tconst abortWorker = () => {\n\t\ttry {\n\t\t\tworker.abort();\n\t\t} catch {\n\t\t\t/* ignore */\n\t\t}\n\t};\n\n\tlet removeAbortListener = () => {};\n\tlet timeoutHandle: NodeJS.Timeout | null = null;\n\n\tconst runPromise = (async () => {\n\t\tawait worker.prompt(task.prompt);\n\t\tawait worker.waitForIdle();\n\n\t\tconst lastMessage = worker.state.messages[worker.state.messages.length - 1];\n\t\tif (!lastMessage || lastMessage.role !== \"assistant\") {\n\t\t\tthrow new Error(`Sidecar task \"${task.name}\" returned no assistant message`);\n\t\t}\n\n\t\tif (lastMessage.stopReason === \"error\" || lastMessage.stopReason === \"aborted\") {\n\t\t\tthrow new Error(lastMessage.errorMessage || `Sidecar task \"${task.name}\" failed`);\n\t\t}\n\n\t\tconst rawText = extractAssistantText(lastMessage);\n\t\ttry {\n\t\t\treturn {\n\t\t\t\toutput: task.parse(rawText),\n\t\t\t\trawText,\n\t\t\t};\n\t\t} catch (error) {\n\t\t\tthrow new SidecarParseError(task.name, rawText, error);\n\t\t}\n\t})();\n\tvoid runPromise.catch(() => {});\n\n\tconst blockers: Array<Promise<never>> = [];\n\tif (task.timeoutMs && task.timeoutMs > 0) {\n\t\tblockers.push(\n\t\t\tnew Promise<never>((_, reject) => {\n\t\t\t\ttimeoutHandle = setTimeout(() => {\n\t\t\t\t\tabortWorker();\n\t\t\t\t\treject(new SidecarTimeoutError(task.name, task.timeoutMs!));\n\t\t\t\t}, task.timeoutMs);\n\t\t\t}),\n\t\t);\n\t}\n\n\tif (task.signal) {\n\t\tconst signal = task.signal;\n\t\tblockers.push(\n\t\t\tnew Promise<never>((_, reject) => {\n\t\t\t\tconst abort = () => {\n\t\t\t\t\tabortWorker();\n\t\t\t\t\treject(\n\t\t\t\t\t\tsignal.reason instanceof Error ? signal.reason : new Error(`Sidecar task \"${task.name}\" aborted`),\n\t\t\t\t\t);\n\t\t\t\t};\n\n\t\t\t\tif (signal.aborted) {\n\t\t\t\t\tabort();\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\tsignal.addEventListener(\"abort\", abort, { once: true });\n\t\t\t\tremoveAbortListener = () => signal.removeEventListener(\"abort\", abort);\n\t\t\t}),\n\t\t);\n\t}\n\n\ttry {\n\t\treturn blockers.length > 0 ? await Promise.race([runPromise, ...blockers]) : await runPromise;\n\t} finally {\n\t\tif (timeoutHandle) {\n\t\t\tclearTimeout(timeoutHandle);\n\t\t}\n\t\tremoveAbortListener();\n\t}\n}\n"]}

package/dist/sub-agents.d.ts

@@ -1,6 +1,10 @@
 import type { Api, Model } from "@mariozechner/pi-ai";
 declare const ALLOWED_SUB_AGENT_TOOLS: readonly ["read", "bash", "edit", "write"];
+declare const ALLOWED_CONTEXT_MODES: readonly ["isolated", "contextual"];
+declare const ALLOWED_MEMORY_MODES: readonly ["none", "session", "relevant"];
 export type SubAgentToolName = (typeof ALLOWED_SUB_AGENT_TOOLS)[number];
+export type SubAgentContextMode = (typeof ALLOWED_CONTEXT_MODES)[number];
+export type SubAgentMemoryMode = (typeof ALLOWED_MEMORY_MODES)[number];
 export interface SubAgentConfig {
     name: string;
     description: string;
@@ -12,6 +16,9 @@ export interface SubAgentConfig {
     maxToolCalls: number;
     maxWallTimeSec: number;
     bashTimeoutSec: number;
+    contextMode: SubAgentContextMode;
+    memory: SubAgentMemoryMode;
+    paths: string[];
     filePath?: string;
     source: "predefined" | "inline";
 }
@@ -34,6 +41,9 @@ export interface SubAgentInvocationOverrides {
     maxToolCalls?: number;
     maxWallTimeSec?: number;
     bashTimeoutSec?: number;
+    contextMode?: string;
+    memory?: string;
+    paths?: string[];
 }
 export declare function validateSubAgentTask(task: string): string | undefined;
 export declare function getSubAgentsDir(workspaceDir: string): string;