@paperclipai/hermes-paperclip-adapter 0.3.0

package/dist/shared/constants.js

@@ -0,0 +1,91 @@
+/**
+ * Shared constants for the Hermes Agent adapter.
+ */
+/** Adapter type identifier registered with Paperclip. */
+export const ADAPTER_TYPE = "hermes_local";
+/** Human-readable label shown in the Paperclip UI. */
+export const ADAPTER_LABEL = "Hermes Agent";
+/** Default CLI binary name. */
+export const HERMES_CLI = "hermes";
+/** Default timeout for a single execution run (seconds). */
+export const DEFAULT_TIMEOUT_SEC = 1800;
+/** Grace period after SIGTERM before SIGKILL (seconds). */
+export const DEFAULT_GRACE_SEC = 10;
+/**
+ * Default model to use if none specified.
+ *
+ * Use "auto" so that Hermes resolves the model from the user's local
+ * ~/.hermes/config.yaml — preventing the adapter from overriding a
+ * user's configured default (e.g. MiniMax, OpenRouter, etc.) with a
+ * hardcoded Anthropic model during Paperclip onboarding.
+ */
+export const DEFAULT_MODEL = "auto";
+/**
+ * Valid --provider choices for the hermes CLI.
+ * Must stay in sync with `hermes chat --help`.
+ */
+export const VALID_PROVIDERS = [
+    "auto",
+    "openrouter",
+    "nous",
+    "openai-codex",
+    "copilot",
+    "copilot-acp",
+    "anthropic",
+    "huggingface",
+    "zai",
+    "kimi-coding",
+    "minimax",
+    "minimax-cn",
+    "kilocode",
+];
+/**
+ * Model-name prefix → provider hint mapping.
+ * Used when no explicit provider is configured and we need to infer
+ * the correct provider from the model string alone.
+ *
+ * Keys are lowercased prefix patterns; values must be valid provider names.
+ * Longer prefixes are matched first (order matters).
+ */
+export const MODEL_PREFIX_PROVIDER_HINTS = [
+    // OpenAI-native models
+    ["gpt-4", "openai-codex"],
+    ["gpt-5", "copilot"],
+    ["o1-", "openai-codex"],
+    ["o3-", "openai-codex"],
+    ["o4-", "openai-codex"],
+    // Anthropic models
+    ["claude", "anthropic"],
+    // Google models (via openrouter or direct)
+    ["gemini", "auto"],
+    // Nous models
+    ["hermes-", "nous"],
+    // Z.AI / GLM models
+    ["glm-", "zai"],
+    // Kimi / Moonshot
+    ["moonshot", "kimi-coding"],
+    ["kimi", "kimi-coding"],
+    // MiniMax
+    ["minimax", "minimax"],
+    // DeepSeek
+    ["deepseek", "auto"],
+    // Meta Llama
+    ["llama", "auto"],
+    // Qwen
+    ["qwen", "auto"],
+    // Mistral
+    ["mistral", "auto"],
+    // HuggingFace models (org/model format)
+    ["huggingface/", "huggingface"],
+];
+/** Regex to extract session ID from Hermes CLI output. */
+export const SESSION_ID_REGEX = /session[_ ](?:id|saved)[:\s]+([a-zA-Z0-9_-]+)/i;
+/** Regex to extract token usage from Hermes output. */
+export const TOKEN_USAGE_REGEX = /tokens?[:\s]+(\d+)\s*(?:input|in)\b.*?(\d+)\s*(?:output|out)\b/i;
+/** Regex to extract cost from Hermes output. */
+export const COST_REGEX = /(?:cost|spent)[:\s]*\$?([\d.]+)/i;
+/** Prefix used by Hermes for tool output lines. */
+export const TOOL_OUTPUT_PREFIX = "┊";
+/** Prefix for Hermes thinking blocks. */
+export const THINKING_PREFIX = "💭";
+//# sourceMappingURL=constants.js.map

package/dist/shared/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/shared/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,yDAAyD;AACzD,MAAM,CAAC,MAAM,YAAY,GAAG,cAAc,CAAC;AAE3C,sDAAsD;AACtD,MAAM,CAAC,MAAM,aAAa,GAAG,cAAc,CAAC;AAE5C,+BAA+B;AAC/B,MAAM,CAAC,MAAM,UAAU,GAAG,QAAQ,CAAC;AAEnC,4DAA4D;AAC5D,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC;AAExC,2DAA2D;AAC3D,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAEpC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC;AAEpC;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,MAAM;IACN,YAAY;IACZ,MAAM;IACN,cAAc;IACd,SAAS;IACT,aAAa;IACb,WAAW;IACX,aAAa;IACb,KAAK;IACL,aAAa;IACb,SAAS;IACT,YAAY;IACZ,UAAU;CACF,CAAC;AAEX;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAuB;IAC7D,uBAAuB;IACvB,CAAC,OAAO,EAAE,cAAc,CAAC;IACzB,CAAC,OAAO,EAAE,SAAS,CAAC;IACpB,CAAC,KAAK,EAAE,cAAc,CAAC;IACvB,CAAC,KAAK,EAAE,cAAc,CAAC;IACvB,CAAC,KAAK,EAAE,cAAc,CAAC;IACvB,mBAAmB;IACnB,CAAC,QAAQ,EAAE,WAAW,CAAC;IACvB,2CAA2C;IAC3C,CAAC,QAAQ,EAAE,MAAM,CAAC;IAClB,cAAc;IACd,CAAC,SAAS,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,CAAC,MAAM,EAAE,KAAK,CAAC;IACf,kBAAkB;IAClB,CAAC,UAAU,EAAE,aAAa,CAAC;IAC3B,CAAC,MAAM,EAAE,aAAa,CAAC;IACvB,UAAU;IACV,CAAC,SAAS,EAAE,SAAS,CAAC;IACtB,WAAW;IACX,CAAC,UAAU,EAAE,MAAM,CAAC;IACpB,aAAa;IACb,CAAC,OAAO,EAAE,MAAM,CAAC;IACjB,OAAO;IACP,CAAC,MAAM,EAAE,MAAM,CAAC;IAChB,UAAU;IACV,CAAC,SAAS,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,CAAC,cAAc,EAAE,aAAa,CAAC;CAChC,CAAC;AAEF,0DAA0D;AAC1D,MAAM,CAAC,MAAM,gBAAgB,GAAG,gDAAgD,CAAC;AAEjF,uDAAuD;AACvD,MAAM,CAAC,MAAM,iBAAiB,GAC5B,iEAAiE,CAAC;AAEpE,gDAAgD;AAChD,MAAM,CAAC,MAAM,UAAU,GAAG,kCAAkC,CAAC;AAE7D,mDAAmD;AACnD,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAEtC,yCAAyC;AACzC,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC"}

package/dist/ui/build-config.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Build adapter configuration from UI form values.
+ *
+ * Translates Paperclip's CreateConfigValues into the adapterConfig
+ * object stored in the agent record.
+ *
+ * NOTE: Provider resolution happens at runtime in execute.ts, not here.
+ * The UI may or may not pass a provider field. If it does, we persist it
+ * as the user's explicit override. If not, execute.ts will detect it from
+ * ~/.hermes/config.yaml at runtime.
+ */
+import type { CreateConfigValues } from "@paperclipai/adapter-utils";
+/**
+ * Build a Hermes Agent adapter config from the Paperclip UI form values.
+ */
+export declare function buildHermesConfig(v: CreateConfigValues): Record<string, unknown>;
+//# sourceMappingURL=build-config.d.ts.map

package/dist/ui/build-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-config.d.ts","sourceRoot":"","sources":["../../src/ui/build-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAMrE;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,CAAC,EAAE,kBAAkB,GACpB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA+DzB"}

package/dist/ui/build-config.js

@@ -0,0 +1,69 @@
+/**
+ * Build adapter configuration from UI form values.
+ *
+ * Translates Paperclip's CreateConfigValues into the adapterConfig
+ * object stored in the agent record.
+ *
+ * NOTE: Provider resolution happens at runtime in execute.ts, not here.
+ * The UI may or may not pass a provider field. If it does, we persist it
+ * as the user's explicit override. If not, execute.ts will detect it from
+ * ~/.hermes/config.yaml at runtime.
+ */
+import { DEFAULT_TIMEOUT_SEC, } from "../shared/constants.js";
+/**
+ * Build a Hermes Agent adapter config from the Paperclip UI form values.
+ */
+export function buildHermesConfig(v) {
+    const ac = {};
+    // Model
+    if (v.model.trim()) {
+        ac.model = v.model.trim();
+    }
+    // NOTE: Provider is NOT set here because the Paperclip UI form
+    // (CreateConfigValues) does not expose a provider field.
+    // Instead, provider is resolved at runtime in execute.ts using
+    // a priority chain:
+    //   1. adapterConfig.provider (if set via API directly)
+    //   2. ~/.hermes/config.yaml detection
+    //   3. Model-name prefix inference
+    //   4. "auto" fallback
+    // This ensures correct provider routing even for agents created
+    // before provider tracking existed.
+    // Execution limits — let the user configure these from the Paperclip UI.
+    // timeoutSec: wall-clock kill timeout for the hermes child process.
+    // maxTurnsPerRun: maps to Hermes's --max-turns (agent tool-calling iterations).
+    ac.timeoutSec = DEFAULT_TIMEOUT_SEC;
+    if (v.maxTurnsPerRun > 0) {
+        ac.maxTurnsPerRun = v.maxTurnsPerRun;
+        // Scale timeout to match: ~20s per tool turn is generous headroom.
+        // Never go below the default (1800s / 30 min).
+        ac.timeoutSec = Math.max(DEFAULT_TIMEOUT_SEC, v.maxTurnsPerRun * 20);
+    }
+    // Session persistence (default: on)
+    ac.persistSession = true;
+    // Working directory
+    if (v.cwd) {
+        ac.cwd = v.cwd;
+    }
+    // Custom hermes binary path
+    if (v.command) {
+        ac.hermesCommand = v.command;
+    }
+    // Extra CLI arguments
+    if (v.extraArgs) {
+        ac.extraArgs = v.extraArgs.split(/\s+/).filter(Boolean);
+    }
+    // Thinking/reasoning effort
+    if (v.thinkingEffort) {
+        const existing = ac.extraArgs || [];
+        existing.push("--reasoning-effort", String(v.thinkingEffort));
+        ac.extraArgs = existing;
+    }
+    // Prompt template
+    if (v.promptTemplate) {
+        ac.promptTemplate = v.promptTemplate;
+    }
+    // Heartbeat config is handled by Paperclip itself
+    return ac;
+}
+//# sourceMappingURL=build-config.js.map

package/dist/ui/build-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-config.js","sourceRoot":"","sources":["../../src/ui/build-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EACL,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAEhC;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,CAAqB;IAErB,MAAM,EAAE,GAA4B,EAAE,CAAC;IAEvC,QAAQ;IACR,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;QACnB,EAAE,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IAC5B,CAAC;IAED,+DAA+D;IAC/D,yDAAyD;IACzD,+DAA+D;IAC/D,oBAAoB;IACpB,wDAAwD;IACxD,uCAAuC;IACvC,mCAAmC;IACnC,uBAAuB;IACvB,gEAAgE;IAChE,oCAAoC;IAEpC,yEAAyE;IACzE,oEAAoE;IACpE,gFAAgF;IAChF,EAAE,CAAC,UAAU,GAAG,mBAAmB,CAAC;IACpC,IAAI,CAAC,CAAC,cAAc,GAAG,CAAC,EAAE,CAAC;QACzB,EAAE,CAAC,cAAc,GAAG,CAAC,CAAC,cAAc,CAAC;QACrC,mEAAmE;QACnE,+CAA+C;QAC/C,EAAE,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,mBAAmB,EAAE,CAAC,CAAC,cAAc,GAAG,EAAE,CAAC,CAAC;IACvE,CAAC;IAED,oCAAoC;IACpC,EAAE,CAAC,cAAc,GAAG,IAAI,CAAC;IAEzB,oBAAoB;IACpB,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC;QACV,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC;IACjB,CAAC;IAED,4BAA4B;IAC5B,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;QACd,EAAE,CAAC,aAAa,GAAG,CAAC,CAAC,OAAO,CAAC;IAC/B,CAAC;IAED,sBAAsB;IACtB,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;QAChB,EAAE,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC1D,CAAC;IAED,4BAA4B;IAC5B,IAAI,CAAC,CAAC,cAAc,EAAE,CAAC;QACrB,MAAM,QAAQ,GAAI,EAAE,CAAC,SAAsB,IAAI,EAAE,CAAC;QAClD,QAAQ,CAAC,IAAI,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC;QAC9D,EAAE,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC1B,CAAC;IAED,kBAAkB;IAClB,IAAI,CAAC,CAAC,cAAc,EAAE,CAAC;QACrB,EAAE,CAAC,cAAc,GAAG,CAAC,CAAC,cAAc,CAAC;IACvC,CAAC;IAED,kDAAkD;IAElD,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/ui/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * UI module exports — used by Paperclip's dashboard for run viewing
+ * and agent configuration forms.
+ */
+export { parseHermesStdoutLine } from "./parse-stdout.js";
+export { buildHermesConfig } from "./build-config.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/ui/index.js

@@ -0,0 +1,7 @@
+/**
+ * UI module exports — used by Paperclip's dashboard for run viewing
+ * and agent configuration forms.
+ */
+export { parseHermesStdoutLine } from "./parse-stdout.js";
+export { buildHermesConfig } from "./build-config.js";
+//# sourceMappingURL=index.js.map

package/dist/ui/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/ui/parse-stdout.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Parse Hermes Agent stdout into TranscriptEntry objects for the Paperclip UI.
+ *
+ * Hermes CLI quiet-mode output patterns:
+ *   Assistant:  "  ┊ 💬 {text}"
+ *   Tool (TTY): "  ┊ {emoji} {verb:9} {detail}  {duration}"
+ *   Tool (pipe): "  [done] ┊ {emoji} {verb:9} {detail}  {duration} ({total})"
+ *   System:     "[hermes] ..."
+ *
+ * We emit structured tool_call/tool_result pairs so Paperclip renders proper
+ * tool cards (with status icons, expand/collapse) instead of raw stdout blocks.
+ */
+import type { TranscriptEntry } from "@paperclipai/adapter-utils";
+/**
+ * Parse a single line of Hermes stdout into transcript entries.
+ *
+ * Emits structured tool_call/tool_result pairs (with synthetic IDs) so
+ * Paperclip renders proper tool cards with status icons and expand/collapse.
+ *
+ * @param line  Raw stdout line from Hermes CLI
+ * @param ts    ISO timestamp for the entry
+ * @returns     Array of TranscriptEntry objects (may be empty)
+ */
+export declare function parseHermesStdoutLine(line: string, ts: string): TranscriptEntry[];
+//# sourceMappingURL=parse-stdout.d.ts.map

package/dist/ui/parse-stdout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-stdout.d.ts","sourceRoot":"","sources":["../../src/ui/parse-stdout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AA8JlE;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,GACT,eAAe,EAAE,CAiGnB"}

package/dist/ui/parse-stdout.js

@@ -0,0 +1,237 @@
+/**
+ * Parse Hermes Agent stdout into TranscriptEntry objects for the Paperclip UI.
+ *
+ * Hermes CLI quiet-mode output patterns:
+ *   Assistant:  "  ┊ 💬 {text}"
+ *   Tool (TTY): "  ┊ {emoji} {verb:9} {detail}  {duration}"
+ *   Tool (pipe): "  [done] ┊ {emoji} {verb:9} {detail}  {duration} ({total})"
+ *   System:     "[hermes] ..."
+ *
+ * We emit structured tool_call/tool_result pairs so Paperclip renders proper
+ * tool cards (with status icons, expand/collapse) instead of raw stdout blocks.
+ */
+import { TOOL_OUTPUT_PREFIX } from "../shared/constants.js";
+// ── Kaomoji / noise stripping ──────────────────────────────────────────────
+/**
+ * Strip kawaii faces and decorative emoji from a tool summary line.
+ * Leaves meaningful emoji (💻 for terminal, 🔍 for search, etc.) intact
+ * by only stripping parenthesized kaomoji like (｡◕‿◕｡).
+ */
+function stripKaomoji(text) {
+    // Strip parenthesized kaomoji faces: (｡◕‿◕｡), (★ω★), etc.
+    return text.replace(/[(][^()]{2,20}[)]\s*/gu, "").trim();
+}
+// ── Line classification ────────────────────────────────────────────────────
+/** Check if a ┊ line is an assistant message (┊ 💬 ...). */
+function isAssistantToolLine(stripped) {
+    return /^┊\s*💬/.test(stripped);
+}
+/** Extract assistant text from a ┊ 💬 line. */
+function extractAssistantText(line) {
+    return line.replace(/^[\s┊]*💬\s*/, "").trim();
+}
+/**
+ * Parse a tool completion line into structured data.
+ *
+ * Handles both TTY and pipe formats:
+ *   TTY:  ┊ 💻 $         curl -s "..."  0.1s
+ *   Pipe: [done] ┊ 💻 $   curl -s "..."  0.1s (0.5s)
+ */
+function parseToolCompletionLine(line) {
+    // Strip leading whitespace and [done] prefix
+    let cleaned = line.trim().replace(/^\[done\]\s*/, "");
+    // Must start with ┊
+    if (!cleaned.startsWith(TOOL_OUTPUT_PREFIX))
+        return null;
+    // Remove ┊ prefix and any leading kaomoji face
+    cleaned = cleaned.slice(TOOL_OUTPUT_PREFIX.length);
+    cleaned = stripKaomoji(cleaned).trim();
+    // Now format is: "{emoji} {verb:9} {detail}  {duration}" or "{emoji} {verb:9} {detail}  {duration} ({total})"
+    // Example: "💻 $         curl -s ..." or "🔍 search    pattern  0.1s"
+    // The verb+detail are separated by whitespace, duration is at the end
+    // Match: emoji + verb + detail + duration
+    // Duration pattern: N.Ns (possibly followed by (N.Ns))
+    const durationMatch = cleaned.match(/([\d.]+s)\s*(?:\([\d.]+s\))?\s*$/);
+    const duration = durationMatch ? durationMatch[1] : "";
+    // Remove duration from the end to get verb + detail
+    let verbAndDetail = durationMatch
+        ? cleaned.slice(0, cleaned.lastIndexOf(durationMatch[0])).trim()
+        : cleaned;
+    // Check for error suffixes
+    const hasError = /\[(?:exit \d+|error|full)\]/.test(verbAndDetail) ||
+        /\[error\]\s*$/.test(cleaned);
+    // The first token (after emoji) is the verb, rest is detail
+    // Verbs are always a single word or symbol ($ for terminal)
+    const parts = verbAndDetail.match(/^(\S+)\s+(.*)/);
+    if (!parts) {
+        return { name: "tool", detail: verbAndDetail, duration, hasError };
+    }
+    const verb = parts[1];
+    const detail = parts[2].trim();
+    // Map Hermes verbs to readable tool names
+    const nameMap = {
+        "$": "shell",
+        "exec": "shell",
+        "terminal": "shell",
+        "search": "search",
+        "fetch": "fetch",
+        "crawl": "crawl",
+        "navigate": "browser",
+        "snapshot": "browser",
+        "click": "browser",
+        "type": "browser",
+        "scroll": "browser",
+        "back": "browser",
+        "press": "browser",
+        "close": "browser",
+        "images": "browser",
+        "vision": "browser",
+        "read": "read",
+        "write": "write",
+        "patch": "patch",
+        "grep": "search",
+        "find": "search",
+        "plan": "plan",
+        "recall": "recall",
+        "proc": "process",
+        "delegate": "delegate",
+        "todo": "todo",
+        "memory": "memory",
+        "clarify": "clarify",
+        "session_search": "recall",
+        "code": "execute",
+        "execute": "execute",
+        "web_search": "search",
+        "web_extract": "fetch",
+        "browser_navigate": "browser",
+        "browser_click": "browser",
+        "browser_type": "browser",
+        "browser_snapshot": "browser",
+        "browser_vision": "browser",
+        "browser_scroll": "browser",
+        "browser_press": "browser",
+        "browser_back": "browser",
+        "browser_close": "browser",
+        "browser_get_images": "browser",
+        "read_file": "read",
+        "write_file": "write_file",
+        "search_files": "search",
+        "patch_file": "patch",
+        "execute_code": "execute",
+    };
+    const name = nameMap[verb.toLowerCase()] || verb;
+    return { name, detail, duration, hasError };
+}
+// ── Synthetic tool ID generation ────────────────────────────────────────────
+let toolCallCounter = 0;
+/**
+ * Generate a synthetic toolUseId for pairing tool_call with tool_result.
+ * Paperclip uses this to match them in normalizeTranscript.
+ */
+function syntheticToolUseId() {
+    return `hermes-tool-${++toolCallCounter}`;
+}
+// ── Thinking detection ─────────────────────────────────────────────────────
+function isThinkingLine(line) {
+    return (line.includes("💭") ||
+        line.startsWith("<thinking>") ||
+        line.startsWith("</thinking>") ||
+        line.startsWith("Thinking:"));
+}
+// ── Main parser ────────────────────────────────────────────────────────────
+/**
+ * Parse a single line of Hermes stdout into transcript entries.
+ *
+ * Emits structured tool_call/tool_result pairs (with synthetic IDs) so
+ * Paperclip renders proper tool cards with status icons and expand/collapse.
+ *
+ * @param line  Raw stdout line from Hermes CLI
+ * @param ts    ISO timestamp for the entry
+ * @returns     Array of TranscriptEntry objects (may be empty)
+ */
+export function parseHermesStdoutLine(line, ts) {
+    const trimmed = line.trim();
+    if (!trimmed)
+        return [];
+    // ── System/adapter messages ────────────────────────────────────────────
+    if (trimmed.startsWith("[hermes]") || trimmed.startsWith("[paperclip]")) {
+        return [{ kind: "system", ts, text: trimmed }];
+    }
+    // ── Non-quiet mode tool start lines: [tool] (kaomoji) emoji verb ... ──
+    // These are redundant — the tool_call/tool_result pair arrives later from
+    // the ┊ completion line. Skip them to avoid duplicate entries.
+    if (trimmed.startsWith("[tool]")) {
+        return [];
+    }
+    // ── MCP / server init noise reclassified from stderr by wrappedOnLog ──
+    // Pattern: [2026-03-25T10:40:53.941Z] INFO: ...
+    // Emit as stderr so Paperclip groups them into the amber accordion.
+    if (/^\[\d{4}-\d{2}-\d{2}T/.test(trimmed)) {
+        return [{ kind: "stderr", ts, text: trimmed }];
+    }
+    // ── Standalone spinner remnants: "💻 Completed", "💻\nCompleted", etc. ─
+    // These are non-quiet mode spinner frame leftovers — skip them.
+    if (/^\p{Emoji_Presentation}\s*(Completed|Running|Error)?\s*$/u.test(trimmed)) {
+        return [];
+    }
+    // ── Session info line ────────────────────────────────────────────────
+    if (trimmed.startsWith("session_id:")) {
+        return [{ kind: "system", ts, text: trimmed }];
+    }
+    // ── Quiet-mode tool/message lines (prefixed with ┊) ────────────────────
+    if (trimmed.includes(TOOL_OUTPUT_PREFIX)) {
+        // Assistant message: ┊ 💬 {text}
+        if (isAssistantToolLine(trimmed)) {
+            return [{ kind: "assistant", ts, text: extractAssistantText(trimmed) }];
+        }
+        // Tool completion: ┊ {emoji} {verb} {detail} {duration}
+        const toolInfo = parseToolCompletionLine(trimmed);
+        if (toolInfo) {
+            const id = syntheticToolUseId();
+            const detailText = toolInfo.duration
+                ? `${toolInfo.detail}  ${toolInfo.duration}`
+                : toolInfo.detail;
+            return [
+                {
+                    kind: "tool_call",
+                    ts,
+                    name: toolInfo.name,
+                    input: { detail: toolInfo.detail },
+                    toolUseId: id,
+                },
+                {
+                    kind: "tool_result",
+                    ts,
+                    toolUseId: id,
+                    content: detailText,
+                    isError: toolInfo.hasError,
+                },
+            ];
+        }
+        // Fallback: raw ┊ line that doesn't match tool format
+        const stripped = trimmed
+            .replace(/^\[done\]\s*/, "")
+            .replace(new RegExp(`^${TOOL_OUTPUT_PREFIX.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}\\s*`), "")
+            .trim();
+        return [{ kind: "stdout", ts, text: stripped }];
+    }
+    // ── Thinking blocks ────────────────────────────────────────────────────
+    if (isThinkingLine(trimmed)) {
+        return [
+            {
+                kind: "thinking",
+                ts,
+                text: trimmed.replace(/^💭\s*/, ""),
+            },
+        ];
+    }
+    // ── Error output ───────────────────────────────────────────────────────
+    if (trimmed.startsWith("Error:") ||
+        trimmed.startsWith("ERROR:") ||
+        trimmed.startsWith("Traceback")) {
+        return [{ kind: "stderr", ts, text: trimmed }];
+    }
+    // ── Regular assistant output ───────────────────────────────────────────
+    return [{ kind: "assistant", ts, text: trimmed }];
+}
+//# sourceMappingURL=parse-stdout.js.map

package/dist/ui/parse-stdout.js.map

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

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "@paperclipai/hermes-paperclip-adapter",
+  "version": "0.3.0",
+  "description": "Paperclip adapter for Hermes Agent — run Hermes as a managed employee in a Paperclip company",
+  "type": "module",
+  "license": "MIT",
+  "author": "Paperclip",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/paperclipai/paperclip.git",
+    "directory": "packages/adapters/hermes-local"
+  },
+  "bugs": {
+    "url": "https://github.com/paperclipai/paperclip/issues"
+  },
+  "homepage": "https://github.com/paperclipai/paperclip/tree/master/packages/adapters/hermes-local#readme",
+  "keywords": [
+    "paperclip",
+    "hermes",
+    "hermes-agent",
+    "ai-agent",
+    "adapter",
+    "orchestration"
+  ],
+  "exports": {
+    ".": "./src/index.ts",
+    "./server": "./src/server/index.ts",
+    "./ui": "./src/ui/index.ts",
+    "./cli": "./src/cli/index.ts"
+  },
+  "publishConfig": {
+    "access": "public",
+    "exports": {
+      ".": {
+        "types": "./dist/index.d.ts",
+        "import": "./dist/index.js"
+      },
+      "./server": {
+        "types": "./dist/server/index.d.ts",
+        "import": "./dist/server/index.js"
+      },
+      "./ui": {
+        "types": "./dist/ui/index.d.ts",
+        "import": "./dist/ui/index.js"
+      },
+      "./cli": {
+        "types": "./dist/cli/index.d.ts",
+        "import": "./dist/cli/index.js"
+      }
+    },
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "provenance": true
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "lint": "eslint src/",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:command-resolution": "vitest run src/server/command-resolution.test.ts",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@paperclipai/adapter-utils": "workspace:*",
+    "picocolors": "^1.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.21",
+    "typescript": "^5.7.3"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}