@tickernelz/paperclip-pro-adapter-omp-local 2026.925.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 Paperclip AI
+Copyright (c) 2026 Zhafron Adani Kautsar (paperclip-pro fork modifications)
+
+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 printOmpStreamEvent(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":"AAQA,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAgDrE"}

package/dist/cli/format-event.js

@@ -0,0 +1,56 @@
+import pc from "picocolors";
+import { parseOmpStdoutLine } from "../ui/parse-stdout.js";
+function truncate(text, max) {
+    const collapsed = text.replace(/\s+/g, " ").trim();
+    return collapsed.length > max ? `${collapsed.slice(0, max)}…` : collapsed;
+}
+export function printOmpStreamEvent(raw, debug) {
+    const line = raw.trim();
+    if (!line)
+        return;
+    const entries = parseOmpStdoutLine(line, new Date().toISOString());
+    for (const entry of entries) {
+        switch (entry.kind) {
+            case "init":
+                console.log(pc.dim(`⎿ omp session ${entry.sessionId}${entry.model ? ` · ${entry.model}` : ""}`));
+                break;
+            case "assistant":
+                process.stdout.write(entry.text);
+                break;
+            case "thinking":
+                if (debug)
+                    process.stdout.write(pc.dim(entry.text));
+                break;
+            case "tool_call":
+                console.log(pc.cyan(`→ ${entry.name}`) + pc.dim(` ${truncate(JSON.stringify(entry.input) ?? "", 160)}`));
+                break;
+            case "tool_result":
+                if (entry.delta)
+                    break;
+                console.log(entry.isError
+                    ? pc.red(`← ${entry.toolName ?? "tool"} failed: ${truncate(entry.content, 200)}`)
+                    : pc.dim(`← ${entry.toolName ?? "tool"} ${truncate(entry.content, 200)}`));
+                break;
+            case "result":
+                console.log(entry.isError
+                    ? pc.red(`✗ ${entry.subtype}${entry.text ? `: ${truncate(entry.text, 400)}` : ""}`)
+                    : pc.green(`✓ ${entry.subtype} · ${entry.inputTokens}in/${entry.outputTokens}out · $${entry.costUsd.toFixed(4)}`));
+                break;
+            case "stderr":
+                console.log(pc.red(entry.text));
+                break;
+            case "system":
+                console.log(pc.dim(entry.text));
+                break;
+            case "stdout":
+                if (debug)
+                    console.log(entry.text);
+                break;
+            default:
+                if (debug)
+                    console.log(pc.dim(JSON.stringify(entry)));
+                break;
+        }
+    }
+}
+//# 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 { printOmpStreamEvent } 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,mBAAmB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/cli/index.js

@@ -0,0 +1,2 @@
+export { printOmpStreamEvent } 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,mBAAmB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { agentConfigurationDoc, label, models, OMP_INSTALL_COMMAND, type, } from "./metadata.js";
+//# 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,EACL,qBAAqB,EACrB,KAAK,EACL,MAAM,EACN,mBAAmB,EACnB,IAAI,GACL,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { agentConfigurationDoc, label, models, OMP_INSTALL_COMMAND, type, } from "./metadata.js";
+//# 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,OAAO,EACL,qBAAqB,EACrB,KAAK,EACL,MAAM,EACN,mBAAmB,EACnB,IAAI,GACL,MAAM,eAAe,CAAC"}

package/dist/metadata.d.ts

@@ -0,0 +1,9 @@
+export declare const type = "omp_local";
+export declare const label = "Oh My Pi (OMP)";
+export declare const OMP_INSTALL_COMMAND = "npm install -g @oh-my-pi/pi-coding-agent@latest";
+export declare const models: Array<{
+    id: string;
+    label: string;
+}>;
+export declare const agentConfigurationDoc = "# omp_local agent configuration\n\nUse when:\n- Paperclip should run the local Oh My Pi (OMP) coding-agent CLI with its complete headless tool, skill, rule, hook, extension, task/subagent, memory, and model-provider stack\n- You need local OMP sessions resumed across Paperclip heartbeats\n- You need built-in, fetched, custom models, custom providers, local engines, or extension-registered providers discovered by OMP itself\n\nDon't use when:\n- You need a webhook or hosted agent endpoint rather than a CLI process\n- You need live mid-turn steering or interactive OMP dialogs; Paperclip's external adapter contract is heartbeat-oriented\n- OMP is unavailable in the selected execution environment\n\nCore fields:\n- model: exact OMP selector (provider/model); free text is accepted for custom providers\n- command: OMP executable, default omp\n- cwd: fallback working directory when Paperclip has no execution workspace\n- profile / agentDir: select local OMP auth, settings, sessions, models.yml, and caches; remote runs upload sanitized configuration only\n- modelsYaml: optional isolated inline models.yml; provide credentials through Paperclip environment secret bindings\n- thinking: off, minimal, low, medium, high, xhigh, max, or auto\n- smolModel / slowModel / planModel: role overrides used by OMP's auxiliary work\n- tools / noTools: optional comma-separated allowlist and explicit default-tool disable; blank preserves OMP's complete default toolset\n- modelCycle: optional selectors passed to OMP --models\n- approvalMode: yolo, write, or always-ask; always passed to OMP, defaulting to yolo for headless runs\n- extensions / hooks / pluginDirs / configFiles: newline-separated OMP paths\n- advisor, prewalk/noPrewalk, planYolo, skills, rules, LSP, PTY, title, allowHome, and ephemeral-session controls map directly to OMP flags\n- systemPrompt replaces OMP's base prompt while Paperclip's execution contract remains appended\n- timeoutSec / graceSec / maxTime: Paperclip process deadline, termination grace, and OMP in-session deadline\n\nModel behavior:\n- Paperclip model listing calls omp models --json and refresh calls omp models refresh --json\n- OMP returns available models only; unavailable models remain enterable manually\n- Active ~/.omp/agent/models.yml, profile-specific config, runtime discovery, and extension providers are authoritative\n\nOperational behavior:\n- Each heartbeat runs omp --mode json -p under Paperclip process supervision\n- Local sessions use an adapter-owned --session-dir and exact --resume id; remote runs are deliberately ephemeral because Paperclip remote runtime directories are per run\n- Raw OMP JSONL is streamed unchanged; unknown events fall back to raw transcript output\n- Paperclip skills are linked into OMP's active agent skills directory without modifying the project workspace\n";
+//# sourceMappingURL=metadata.d.ts.map

package/dist/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,IAAI,cAAc,CAAC;AAChC,eAAO,MAAM,KAAK,mBAAmB,CAAC;AACtC,eAAO,MAAM,mBAAmB,oDAAoD,CAAC;AAErF,eAAO,MAAM,MAAM,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAM,CAAC;AAE/D,eAAO,MAAM,qBAAqB,uyFAsCjC,CAAC"}

package/dist/metadata.js

@@ -0,0 +1,44 @@
+export const type = "omp_local";
+export const label = "Oh My Pi (OMP)";
+export const OMP_INSTALL_COMMAND = "npm install -g @oh-my-pi/pi-coding-agent@latest";
+export const models = [];
+export const agentConfigurationDoc = `# omp_local agent configuration
+
+Use when:
+- Paperclip should run the local Oh My Pi (OMP) coding-agent CLI with its complete headless tool, skill, rule, hook, extension, task/subagent, memory, and model-provider stack
+- You need local OMP sessions resumed across Paperclip heartbeats
+- You need built-in, fetched, custom models, custom providers, local engines, or extension-registered providers discovered by OMP itself
+
+Don't use when:
+- You need a webhook or hosted agent endpoint rather than a CLI process
+- You need live mid-turn steering or interactive OMP dialogs; Paperclip's external adapter contract is heartbeat-oriented
+- OMP is unavailable in the selected execution environment
+
+Core fields:
+- model: exact OMP selector (provider/model); free text is accepted for custom providers
+- command: OMP executable, default omp
+- cwd: fallback working directory when Paperclip has no execution workspace
+- profile / agentDir: select local OMP auth, settings, sessions, models.yml, and caches; remote runs upload sanitized configuration only
+- modelsYaml: optional isolated inline models.yml; provide credentials through Paperclip environment secret bindings
+- thinking: off, minimal, low, medium, high, xhigh, max, or auto
+- smolModel / slowModel / planModel: role overrides used by OMP's auxiliary work
+- tools / noTools: optional comma-separated allowlist and explicit default-tool disable; blank preserves OMP's complete default toolset
+- modelCycle: optional selectors passed to OMP --models
+- approvalMode: yolo, write, or always-ask; always passed to OMP, defaulting to yolo for headless runs
+- extensions / hooks / pluginDirs / configFiles: newline-separated OMP paths
+- advisor, prewalk/noPrewalk, planYolo, skills, rules, LSP, PTY, title, allowHome, and ephemeral-session controls map directly to OMP flags
+- systemPrompt replaces OMP's base prompt while Paperclip's execution contract remains appended
+- timeoutSec / graceSec / maxTime: Paperclip process deadline, termination grace, and OMP in-session deadline
+
+Model behavior:
+- Paperclip model listing calls omp models --json and refresh calls omp models refresh --json
+- OMP returns available models only; unavailable models remain enterable manually
+- Active ~/.omp/agent/models.yml, profile-specific config, runtime discovery, and extension providers are authoritative
+
+Operational behavior:
+- Each heartbeat runs omp --mode json -p under Paperclip process supervision
+- Local sessions use an adapter-owned --session-dir and exact --resume id; remote runs are deliberately ephemeral because Paperclip remote runtime directories are per run
+- Raw OMP JSONL is streamed unchanged; unknown events fall back to raw transcript output
+- Paperclip skills are linked into OMP's active agent skills directory without modifying the project workspace
+`;
+//# sourceMappingURL=metadata.js.map

package/dist/metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,IAAI,GAAG,WAAW,CAAC;AAChC,MAAM,CAAC,MAAM,KAAK,GAAG,gBAAgB,CAAC;AACtC,MAAM,CAAC,MAAM,mBAAmB,GAAG,iDAAiD,CAAC;AAErF,MAAM,CAAC,MAAM,MAAM,GAAyC,EAAE,CAAC;AAE/D,MAAM,CAAC,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsCpC,CAAC"}

package/dist/server/config.d.ts

@@ -0,0 +1,22 @@
+import type { AdapterConfigSchema } from "@tickernelz/paperclip-pro-adapter-utils";
+export interface PreparedOmpRuntimeConfig {
+    agentDir: string | null;
+    profile: string | null;
+    profileSpecified: boolean;
+    materialized: boolean;
+    notes: string[];
+    cleanup(): Promise<void>;
+}
+export declare function resolveOmpCommand(config: unknown): string;
+export declare function detectionEnv(): Record<string, string>;
+export declare function detectModel(): Promise<{
+    model: string;
+    provider: string;
+    source: string;
+    candidates?: string[];
+} | null>;
+export declare function getConfigSchema(): Promise<AdapterConfigSchema>;
+export declare function prepareOmpRuntimeConfig(config: unknown, options?: {
+    forceMaterialized?: boolean;
+}): Promise<PreparedOmpRuntimeConfig>;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/server/config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,mBAAmB,EAIpB,MAAM,yCAAyC,CAAC;AA2BjD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAuED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAEzD;AAkBD,wBAAgB,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAarD;AAiCD,wBAAsB,WAAW,IAAI,OAAO,CAAC;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB,GAAG,IAAI,CAAC,CAsCR;AAsCD,wBAAsB,eAAe,IAAI,OAAO,CAAC,mBAAmB,CAAC,CA4QpE;AA0ID,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,OAAO,EACf,OAAO,GAAE;IAAE,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAAO,GAC5C,OAAO,CAAC,wBAAwB,CAAC,CA+DnC"}