@andreroggeri/adapter-pi-local-serialized 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Paperclip 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/README.md

@@ -0,0 +1,75 @@
+# @andreroggeri/adapter-pi-local-serialized
+
+A fork of `@paperclipai/adapter-pi-local` that enforces a **global concurrency of 1** across all agents using this adapter within the same server process. Built for setups running local LLMs (e.g. ollama, llama.cpp) that can't handle parallel inference.
+
+## What it does differently
+
+A single module-level promise queue (mutex) in `src/server/concurrency.ts` ensures that only one Pi process runs at a time. All the setup work (env building, session resolution, workspace sync) still happens concurrently — only the actual `pi` process invocation that talks to the LLM is serialized. Queued runs log a `queuing "<agent-id>"...` message so you can see them waiting in the run output.
+
+## How to recreate
+
+If this package gets clobbered by merge conflicts, recreate it from the current `packages/adapters/pi-local`:
+
+1. Copy the package:
+   ```bash
+   cp -r packages/adapters/pi-local packages/adapters/pi-local-serialized
+   ```
+
+2. Update `package.json`:
+   - `name`: `@andreroggeri/adapter-pi-local-serialized`
+   - `version`: `0.1.0`
+   - `repository.directory`: `packages/adapters/pi-local-serialized`
+
+3. Update `src/index.ts`:
+   - `type`: `"pi_local_serialized"`
+   - `label`: `"Pi (local, serialized)"`
+
+4. Create `src/server/concurrency.ts`:
+
+   ```ts
+   let tail: Promise<void> = Promise.resolve();
+
+   export async function withSerializedExecution<T>(
+     label: string,
+     onLog: (stream: "stdout" | "stderr", chunk: string) => Promise<void>,
+     fn: () => Promise<T>,
+   ): Promise<T> {
+     let release!: () => void;
+     const next = new Promise<void>((resolve) => { release = resolve; });
+     const wait = tail;
+     tail = tail.then(() => next);
+
+     if (wait !== Promise.resolve()) {
+       await onLog("stdout", `[paperclip] pi_local_serialized: another run is in progress, queuing "${label}"...\n`);
+     }
+
+     await wait;
+     try {
+       return await fn();
+     } finally {
+       release();
+     }
+   }
+   ```
+
+5. In `src/server/execute.ts`:
+   - Add import: `import { withSerializedExecution } from "./concurrency.js";`
+   - Wrap the `try` block's body (the `runAttempt` calls and return) in:
+     ```ts
+     return await withSerializedExecution(agent.id, onLog, async () => { ... });
+     ```
+     Leave the `finally` block (bridge/workspace cleanup) outside the mutex.
+
+6. Run `pnpm install && pnpm build` from the repo root to verify.
+
+## Publishing
+
+```bash
+cd packages/adapters/pi-local-serialized
+npm login   # as andreroggeri
+pnpm publish --access public
+```
+
+## Keeping in sync with pi-local
+
+This package tracks `pi-local` loosely — only `execute.ts` diverges. When `pi-local` gets meaningful updates (new flags, session handling changes, etc.), apply them to this package's `execute.ts` and re-wrap the mutex around the `runAttempt` block.

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,11 @@
+import type { AdapterModelProfileDefinition } from "@paperclipai/adapter-utils";
+export declare const type = "pi_local_serialized";
+export declare const label = "Pi (local, serialized)";
+export declare const SANDBOX_INSTALL_COMMAND = "npm install -g @earendil-works/pi-coding-agent@0.74.0";
+export declare const models: Array<{
+    id: string;
+    label: string;
+}>;
+export declare const modelProfiles: AdapterModelProfileDefinition[];
+export declare const agentConfigurationDoc = "# pi_local_serialized agent configuration\n\nAdapter: pi_local_serialized\n\nLike pi_local but enforces a global concurrency of 1 across all agents using this\nadapter within the same server process. Useful when running local LLMs that cannot\nhandle parallel inference load \u2014 runs are queued and executed one at a time.\n\nUse when:\n- You want Paperclip to run Pi (the AI coding agent) locally as the agent runtime\n- Your LLM backend cannot handle concurrent requests (e.g. local ollama, llama.cpp)\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- Your LLM backend supports concurrent requests (use pi_local instead)\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 ollama/qwen2.5-coder)\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- Paperclip requires an explicit `model` value for `pi_local_serialized` agents.\n- Sessions are stored in ~/.pi/paperclips/ 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- Concurrency is enforced in-process. If you run multiple Paperclip server replicas,\n  each replica has its own queue \u2014 use a single replica when strict global serialization matters.\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,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,4BAA4B,CAAC;AAEhF,eAAO,MAAM,IAAI,wBAAwB,CAAC;AAC1C,eAAO,MAAM,KAAK,2BAA2B,CAAC;AAE9C,eAAO,MAAM,uBAAuB,0DAA0D,CAAC;AAE/F,eAAO,MAAM,MAAM,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAM,CAAC;AAE/D,eAAO,MAAM,aAAa,EAAE,6BAA6B,EAAO,CAAC;AAEjE,eAAO,MAAM,qBAAqB,84EA0CjC,CAAC"}

package/dist/index.js

@@ -0,0 +1,49 @@
+export const type = "pi_local_serialized";
+export const label = "Pi (local, serialized)";
+export const SANDBOX_INSTALL_COMMAND = "npm install -g @earendil-works/pi-coding-agent@0.74.0";
+export const models = [];
+export const modelProfiles = [];
+export const agentConfigurationDoc = `# pi_local_serialized agent configuration
+
+Adapter: pi_local_serialized
+
+Like pi_local but enforces a global concurrency of 1 across all agents using this
+adapter within the same server process. Useful when running local LLMs that cannot
+handle parallel inference load — runs are queued and executed one at a time.
+
+Use when:
+- You want Paperclip to run Pi (the AI coding agent) locally as the agent runtime
+- Your LLM backend cannot handle concurrent requests (e.g. local ollama, llama.cpp)
+- 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
+- Your LLM backend supports concurrent requests (use pi_local instead)
+
+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 ollama/qwen2.5-coder)
+- 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.
+- Paperclip requires an explicit \`model\` value for \`pi_local_serialized\` agents.
+- Sessions are stored in ~/.pi/paperclips/ 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.
+- Concurrency is enforced in-process. If you run multiple Paperclip server replicas,
+  each replica has its own queue — use a single replica when strict global serialization matters.
+`;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,IAAI,GAAG,qBAAqB,CAAC;AAC1C,MAAM,CAAC,MAAM,KAAK,GAAG,wBAAwB,CAAC;AAE9C,MAAM,CAAC,MAAM,uBAAuB,GAAG,uDAAuD,CAAC;AAE/F,MAAM,CAAC,MAAM,MAAM,GAAyC,EAAE,CAAC;AAE/D,MAAM,CAAC,MAAM,aAAa,GAAoC,EAAE,CAAC;AAEjE,MAAM,CAAC,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0CpC,CAAC"}

package/dist/server/concurrency.d.ts

@@ -0,0 +1,2 @@
+export declare function withSerializedExecution<T>(label: string, onLog: (stream: "stdout" | "stderr", chunk: string) => Promise<void>, fn: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=concurrency.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency.d.ts","sourceRoot":"","sources":["../../src/server/concurrency.ts"],"names":[],"mappings":"AAMA,wBAAsB,uBAAuB,CAAC,CAAC,EAC7C,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,EACpE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAsBZ"}

package/dist/server/concurrency.js

@@ -0,0 +1,25 @@
+// Global mutex ensuring at most one pi_local_serialized execution runs at a time.
+// Implemented as a promise chain — each caller appends to the tail and waits
+// for the previous occupant to release before proceeding.
+let tail = Promise.resolve();
+export async function withSerializedExecution(label, onLog, fn) {
+    let release;
+    const next = new Promise((resolve) => {
+        release = resolve;
+    });
+    // Snapshot the current tail and atomically replace it with our waiter.
+    const wait = tail;
+    tail = tail.then(() => next);
+    if (wait !== Promise.resolve()) {
+        // There's something ahead of us — let the agent know it's queued.
+        await onLog("stdout", `[paperclip] pi_local_serialized: another run is in progress, queuing "${label}"...\n`);
+    }
+    await wait;
+    try {
+        return await fn();
+    }
+    finally {
+        release();
+    }
+}
+//# sourceMappingURL=concurrency.js.map

package/dist/server/concurrency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency.js","sourceRoot":"","sources":["../../src/server/concurrency.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,6EAA6E;AAC7E,0DAA0D;AAE1D,IAAI,IAAI,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;AAE5C,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,KAAa,EACb,KAAoE,EACpE,EAAoB;IAEpB,IAAI,OAAoB,CAAC;IACzB,MAAM,IAAI,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QACzC,OAAO,GAAG,OAAO,CAAC;IACpB,CAAC,CAAC,CAAC;IAEH,uEAAuE;IACvE,MAAM,IAAI,GAAG,IAAI,CAAC;IAClB,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IAE7B,IAAI,IAAI,KAAK,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;QAC/B,kEAAkE;QAClE,MAAM,KAAK,CAAC,QAAQ,EAAE,yEAAyE,KAAK,QAAQ,CAAC,CAAC;IAChH,CAAC;IAED,MAAM,IAAI,CAAC;IAEX,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,EAAE,CAAC;IACpB,CAAC;YAAS,CAAC;QACT,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/server/execute.d.ts

@@ -0,0 +1,3 @@
+import { type AdapterExecutionContext, type AdapterExecutionResult } from "@paperclipai/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;AAkNpI,wBAAsB,OAAO,CAAC,GAAG,EAAE,uBAAuB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CA6lB3F"}