@paperclipai/hermes-paperclip-adapter 0.3.0

package/dist/server/execute.js

@@ -0,0 +1,482 @@
+/**
+ * Server-side execution logic for the Hermes Agent adapter.
+ *
+ * Spawns `hermes chat -q "..." -Q` as a child process, streams output,
+ * and returns structured results to Paperclip.
+ *
+ * Verified CLI flags (hermes chat):
+ *   -q/--query         single query (non-interactive)
+ *   -Q/--quiet         quiet mode (no banner/spinner, only response + session_id)
+ *   -m/--model         model name (e.g. anthropic/claude-sonnet-4)
+ *   -t/--toolsets      comma-separated toolsets to enable
+ *   --provider         inference provider (auto, openrouter, nous, etc.)
+ *   -r/--resume        resume session by ID
+ *   -w/--worktree      isolated git worktree
+ *   -v/--verbose       verbose output
+ *   --checkpoints      filesystem checkpoints
+ *   --yolo             bypass dangerous-command approval prompts (agents have no TTY)
+ *   --source           session source tag for filtering
+ */
+import fs from "node:fs/promises";
+import path from "node:path";
+import { runChildProcess, buildPaperclipEnv, renderTemplate, ensureAbsoluteDirectory, } from "@paperclipai/adapter-utils/server-utils";
+import { HERMES_CLI, DEFAULT_TIMEOUT_SEC, DEFAULT_GRACE_SEC, DEFAULT_MODEL, } from "../shared/constants.js";
+import { detectModel, resolveProvider, } from "./detect-model.js";
+// ---------------------------------------------------------------------------
+// Config helpers
+// ---------------------------------------------------------------------------
+function cfgString(v) {
+    return typeof v === "string" && v.length > 0 ? v : undefined;
+}
+function cfgNumber(v) {
+    return typeof v === "number" ? v : undefined;
+}
+function cfgBoolean(v) {
+    return typeof v === "boolean" ? v : undefined;
+}
+function cfgStringArray(v) {
+    return Array.isArray(v) && v.every((i) => typeof i === "string")
+        ? v
+        : undefined;
+}
+export function resolveHermesCommand(config) {
+    return cfgString(config.hermesCommand) || cfgString(config.command) || HERMES_CLI;
+}
+// ---------------------------------------------------------------------------
+// Wake-up prompt builder
+// ---------------------------------------------------------------------------
+const DEFAULT_PROMPT_TEMPLATE = `You are "{{agentName}}", an AI agent employee in a Paperclip-managed company.
+
+IMPORTANT: Use \`terminal\` tool with \`curl\` for ALL Paperclip API calls (web_extract and browser cannot access localhost).
+
+Your Paperclip identity:
+  Agent ID: {{agentId}}
+  Company ID: {{companyId}}
+  API Base: {{paperclipApiUrl}}
+
+{{#taskId}}
+## Assigned Task
+
+Issue ID: {{taskId}}
+Title: {{taskTitle}}
+
+{{taskBody}}
+
+## Workflow
+
+0. First, check out the issue so others know you are working on it:
+   \`curl -s -X POST -H "Authorization: Bearer $PAPERCLIP_API_KEY" -H "X-Paperclip-Run-Id: $PAPERCLIP_RUN_ID" "{{paperclipApiUrl}}/issues/{{taskId}}/checkout"\`
+1. Work on the task using your tools
+2. When done, mark the issue as completed:
+   \`curl -s -X PATCH -H "Authorization: Bearer $PAPERCLIP_API_KEY" -H "X-Paperclip-Run-Id: $PAPERCLIP_RUN_ID" "{{paperclipApiUrl}}/issues/{{taskId}}" -H "Content-Type: application/json" -d '{"status":"done"}'\`
+3. Post a completion comment on the issue summarizing what you did:
+   \`curl -s -X POST -H "Authorization: Bearer $PAPERCLIP_API_KEY" -H "X-Paperclip-Run-Id: $PAPERCLIP_RUN_ID" "{{paperclipApiUrl}}/issues/{{taskId}}/comments" -H "Content-Type: application/json" -d '{"body":"DONE: <your summary here>"}'\`
+4. If this issue has a parent (check the issue body or comments for references like TRA-XX), post a brief notification on the parent issue so the parent owner knows:
+   \`curl -s -X POST -H "Authorization: Bearer $PAPERCLIP_API_KEY" -H "X-Paperclip-Run-Id: $PAPERCLIP_RUN_ID" "{{paperclipApiUrl}}/issues/PARENT_ISSUE_ID/comments" -H "Content-Type: application/json" -d '{"body":"{{agentName}} completed {{taskId}}. Summary: <brief>"}'\`
+{{/taskId}}
+
+{{#commentId}}
+## Comment on This Issue
+
+Someone commented. Read it:
+   \`curl -s -H "Authorization: Bearer $PAPERCLIP_API_KEY" "{{paperclipApiUrl}}/issues/{{taskId}}/comments/{{commentId}}"\`
+
+You do NOT need to be assigned to this issue to comment on it.
+Address the comment, POST a reply if needed, then continue working.
+{{/commentId}}
+
+{{#noTask}}
+## Heartbeat Wake — Check for Work
+
+First, check your environment for context:
+   \`echo "TASK_ID=$PAPERCLIP_TASK_ID WAKE_REASON=$PAPERCLIP_WAKE_REASON WAKE_COMMENT_ID=$PAPERCLIP_WAKE_COMMENT_ID"\`
+
+1. List ALL open issues assigned to you (todo, backlog, in_progress):
+   \`curl -s -H "Authorization: Bearer $PAPERCLIP_API_KEY" "{{paperclipApiUrl}}/companies/{{companyId}}/issues?assigneeAgentId={{agentId}}" | python3 -c "import sys,json;issues=json.loads(sys.stdin.read());[print(f\\"{i['identifier']} {i['status']:>12} {i['priority']:>6} {i['title']}\\") for i in issues if i['status'] not in ('done','cancelled')]" \`
+
+2. If issues found, pick the highest priority one that is not done/cancelled and work on it:
+   - Read the issue details: \`curl -s -H "Authorization: Bearer $PAPERCLIP_API_KEY" "{{paperclipApiUrl}}/issues/ISSUE_ID"\`
+   - Do the work in the project directory: {{projectName}}
+   - When done, mark complete and post a comment (see Workflow steps 2-4 above)
+
+3. If no issues assigned to you, check for unassigned issues:
+   \`curl -s -H "Authorization: Bearer $PAPERCLIP_API_KEY" "{{paperclipApiUrl}}/companies/{{companyId}}/issues?status=backlog" | python3 -c "import sys,json;issues=json.loads(sys.stdin.read());[print(f\\"{i['identifier']} {i['title']}\\") for i in issues if not i.get('assigneeAgentId')]" \`
+   If you find a relevant issue, assign it to yourself:
+   \`curl -s -X PATCH -H "Authorization: Bearer $PAPERCLIP_API_KEY" -H "X-Paperclip-Run-Id: $PAPERCLIP_RUN_ID" "{{paperclipApiUrl}}/issues/ISSUE_ID" -H "Content-Type: application/json" -d '{"assigneeAgentId":"{{agentId}}","status":"todo"}'\`
+
+4. If truly nothing to do, report briefly what you checked.
+{{/noTask}}`;
+function buildPrompt(ctx, config) {
+    const template = cfgString(config.promptTemplate) || DEFAULT_PROMPT_TEMPLATE;
+    // BUG FIX: Read task/comment data from ctx.context (wake context), not ctx.config (adapter config).
+    // ctx.config only contains adapterConfig (model, provider, timeout); ctx.context has the wake payload.
+    const context = ctx.context || {};
+    const taskId = cfgString(context.taskId) || cfgString(context.issueId) || cfgString(ctx.config?.taskId);
+    const taskTitle = cfgString(context.taskTitle) || cfgString(ctx.config?.taskTitle) || "";
+    const taskBody = cfgString(context.taskBody) || cfgString(ctx.config?.taskBody) || "";
+    const commentId = cfgString(context.commentId) || cfgString(context.wakeCommentId) || cfgString(ctx.config?.commentId) || "";
+    const wakeReason = cfgString(context.wakeReason) || cfgString(ctx.config?.wakeReason) || "";
+    const agentName = ctx.agent?.name || "Hermes Agent";
+    const companyName = cfgString(context.companyName) || cfgString(ctx.config?.companyName) || "";
+    const projectName = cfgString(context.projectName) || cfgString(ctx.config?.projectName) || "";
+    // Build API URL — ensure it has the /api path
+    let paperclipApiUrl = cfgString(config.paperclipApiUrl) ||
+        process.env.PAPERCLIP_API_URL ||
+        "http://127.0.0.1:3100/api";
+    // Ensure /api suffix
+    if (!paperclipApiUrl.endsWith("/api")) {
+        paperclipApiUrl = paperclipApiUrl.replace(/\/+$/, "") + "/api";
+    }
+    const vars = {
+        agentId: ctx.agent?.id || "",
+        agentName,
+        companyId: ctx.agent?.companyId || "",
+        companyName,
+        runId: ctx.runId || "",
+        taskId: taskId || "",
+        taskTitle,
+        taskBody,
+        commentId,
+        wakeReason,
+        projectName,
+        paperclipApiUrl,
+    };
+    // Handle conditional sections: {{#key}}...{{/key}}
+    let rendered = template;
+    // {{#taskId}}...{{/taskId}} — include if task is assigned
+    rendered = rendered.replace(/\{\{#taskId\}\}([\s\S]*?)\{\{\/taskId\}\}/g, taskId ? "$1" : "");
+    // {{#noTask}}...{{/noTask}} — include if no task
+    rendered = rendered.replace(/\{\{#noTask\}\}([\s\S]*?)\{\{\/noTask\}\}/g, taskId ? "" : "$1");
+    // {{#commentId}}...{{/commentId}} — include if comment exists
+    rendered = rendered.replace(/\{\{#commentId\}\}([\s\S]*?)\{\{\/commentId\}\}/g, commentId ? "$1" : "");
+    // Replace remaining {{variable}} placeholders
+    return renderTemplate(rendered, vars);
+}
+// ---------------------------------------------------------------------------
+// Output parsing
+// ---------------------------------------------------------------------------
+/** Regex to extract session ID from Hermes quiet-mode output: "session_id: <id>" */
+const SESSION_ID_REGEX = /^session_id:\s*(\S+)/m;
+/** Regex for legacy session output format */
+const SESSION_ID_REGEX_LEGACY = /session[_ ](?:id|saved)[:\s]+([a-zA-Z0-9_-]+)/i;
+/** Regex to extract token usage from Hermes output. */
+const TOKEN_USAGE_REGEX = /tokens?[:\s]+(\d+)\s*(?:input|in)\b.*?(\d+)\s*(?:output|out)\b/i;
+/** Regex to extract cost from Hermes output. */
+const COST_REGEX = /(?:cost|spent)[:\s]*\$?([\d.]+)/i;
+// ---------------------------------------------------------------------------
+// Response cleaning
+// ---------------------------------------------------------------------------
+/** Strip noise lines from a Hermes response (tool output, system messages, etc.) */
+function cleanResponse(raw) {
+    return raw
+        .split("\n")
+        .filter((line) => {
+        const t = line.trim();
+        if (!t)
+            return true; // keep blank lines for paragraph separation
+        if (t.startsWith("[tool]") || t.startsWith("[hermes]") || t.startsWith("[paperclip]"))
+            return false;
+        if (t.startsWith("session_id:"))
+            return false;
+        if (/^\[\d{4}-\d{2}-\d{2}T/.test(t))
+            return false;
+        if (/^\[done\]\s*┊/.test(t))
+            return false;
+        if (/^┊\s*[\p{Emoji_Presentation}]/u.test(t) && !/^┊\s*💬/.test(t))
+            return false;
+        if (/^\p{Emoji_Presentation}\s*(Completed|Running|Error)?\s*$/u.test(t))
+            return false;
+        return true;
+    })
+        .map((line) => {
+        let t = line.replace(/^[\s]*┊\s*💬\s*/, "").trim();
+        t = t.replace(/^\[done\]\s*/, "").trim();
+        return t;
+    })
+        .join("\n")
+        .replace(/\n{3,}/g, "\n\n")
+        .trim();
+}
+// ---------------------------------------------------------------------------
+// Output parsing
+// ---------------------------------------------------------------------------
+function parseHermesOutput(stdout, stderr) {
+    const combined = stdout + "\n" + stderr;
+    const result = {};
+    // In quiet mode, Hermes outputs:
+    //   <response text>
+    //
+    //   session_id: <id>
+    const sessionMatch = stdout.match(SESSION_ID_REGEX);
+    if (sessionMatch?.[1]) {
+        result.sessionId = sessionMatch?.[1] ?? null;
+        // The response is everything before the session_id line
+        const sessionLineIdx = stdout.lastIndexOf("\nsession_id:");
+        if (sessionLineIdx > 0) {
+            result.response = cleanResponse(stdout.slice(0, sessionLineIdx));
+        }
+    }
+    else {
+        // Legacy format (non-quiet mode)
+        const legacyMatch = combined.match(SESSION_ID_REGEX_LEGACY);
+        if (legacyMatch?.[1]) {
+            result.sessionId = legacyMatch?.[1] ?? null;
+        }
+        // In non-quiet mode, extract clean response from stdout by
+        // filtering out tool lines, system messages, and noise
+        const cleaned = cleanResponse(stdout);
+        if (cleaned.length > 0) {
+            result.response = cleaned;
+        }
+    }
+    // Extract token usage
+    const usageMatch = combined.match(TOKEN_USAGE_REGEX);
+    if (usageMatch) {
+        result.usage = {
+            inputTokens: parseInt(usageMatch[1], 10) || 0,
+            outputTokens: parseInt(usageMatch[2], 10) || 0,
+        };
+    }
+    // Extract cost
+    const costMatch = combined.match(COST_REGEX);
+    if (costMatch?.[1]) {
+        result.costUsd = parseFloat(costMatch[1]);
+    }
+    // Check for error patterns in stderr
+    if (stderr.trim()) {
+        const errorLines = stderr
+            .split("\n")
+            .filter((line) => /error|exception|traceback|failed/i.test(line))
+            .filter((line) => !/INFO|DEBUG|warn/i.test(line)); // skip log-level noise
+        if (errorLines.length > 0) {
+            result.errorMessage = errorLines.slice(0, 5).join("\n");
+        }
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Main execute
+// ---------------------------------------------------------------------------
+export async function execute(ctx) {
+    const config = (ctx.config ?? ctx.agent?.adapterConfig ?? {});
+    // ── Resolve configuration ──────────────────────────────────────────────
+    const hermesCmd = resolveHermesCommand(config);
+    const model = cfgString(config.model) || DEFAULT_MODEL;
+    const timeoutSec = cfgNumber(config.timeoutSec) || DEFAULT_TIMEOUT_SEC;
+    const graceSec = cfgNumber(config.graceSec) || DEFAULT_GRACE_SEC;
+    const maxTurns = cfgNumber(config.maxTurnsPerRun);
+    const toolsets = cfgString(config.toolsets) || cfgStringArray(config.enabledToolsets)?.join(",");
+    const extraArgs = cfgStringArray(config.extraArgs);
+    const persistSession = cfgBoolean(config.persistSession) !== false;
+    const worktreeMode = cfgBoolean(config.worktreeMode) === true;
+    const checkpoints = cfgBoolean(config.checkpoints) === true;
+    // ── Resolve provider (defense in depth) ────────────────────────────────
+    // Priority chain:
+    //   1. Explicit provider in adapterConfig (user override)
+    //   2. Provider from ~/.hermes/config.yaml (detected at runtime)
+    //   3. Provider inferred from model name prefix
+    //   4. "auto" (let Hermes decide)
+    //
+    // This ensures that even if the agent was created before provider tracking
+    // was added, or if the model was changed without updating provider, the
+    // correct provider is still used.
+    let detectedConfig = null;
+    const explicitProvider = cfgString(config.provider);
+    if (!explicitProvider) {
+        try {
+            detectedConfig = await detectModel();
+        }
+        catch {
+            // Non-fatal — detection failure shouldn't block execution
+        }
+    }
+    const { provider: resolvedProvider, resolvedFrom } = resolveProvider({
+        explicitProvider,
+        detectedProvider: detectedConfig?.provider,
+        detectedModel: detectedConfig?.model,
+        detectedBaseUrl: detectedConfig?.baseUrl,
+        detectedHasApiKey: detectedConfig?.hasApiKey,
+        detectedApiMode: detectedConfig?.apiMode,
+        model,
+    });
+    // ── Load agent instructions file (Paperclip instruction bundles) ──────
+    // Built-in adapters (claude_local, codex_local, gemini_local) read the
+    // instructionsFilePath from adapterConfig and inject it into the agent
+    // prompt. The hermes adapter was missing this — so curated instruction
+    // files (AGENTS.md, SOUL.md, HEARTBEAT.md, TOOLS.md) were never read.
+    const instructionsFilePath = cfgString(config.instructionsFilePath);
+    let agentInstructions = "";
+    if (instructionsFilePath) {
+        try {
+            agentInstructions = await fs.readFile(instructionsFilePath, "utf-8");
+            const loadedInstructionsLength = agentInstructions.length;
+            const instructionsFileDir = path.dirname(instructionsFilePath);
+            agentInstructions += `\nThe above agent instructions were loaded from ${instructionsFilePath}. Resolve any relative file references from ${instructionsFileDir}/.`;
+            await ctx.onLog("stdout", `[hermes] Loaded agent instructions from ${instructionsFilePath} (${loadedInstructionsLength} chars)\n`);
+        }
+        catch (err) {
+            const reason = err instanceof Error ? err.message : String(err);
+            // Non-fatal: log to stdout with an explicit "Warning:" prefix so the
+            // Paperclip UI doesn't render this as a red error (stderr output is
+            // surfaced as an error signal even when execution continues).
+            await ctx.onLog("stdout", `[hermes] Warning: could not read agent instructions file "${instructionsFilePath}": ${reason}\n`);
+        }
+    }
+    // ── Build prompt ───────────────────────────────────────────────────────
+    let prompt = buildPrompt(ctx, config);
+    if (agentInstructions) {
+        prompt = agentInstructions + "\n\n---\n\n" + prompt;
+    }
+    // ── Build command args ─────────────────────────────────────────────────
+    // Use -Q (quiet) to get clean output: just response + session_id line
+    const useQuiet = cfgBoolean(config.quiet) === true; // default false
+    const args = ["chat", "-q", prompt];
+    if (useQuiet)
+        args.push("-Q");
+    if (model) {
+        args.push("-m", model);
+    }
+    // Always pass --provider when we have a resolved one (not "auto").
+    // "auto" means Hermes will decide on its own — no need to pass it.
+    if (resolvedProvider !== "auto") {
+        args.push("--provider", resolvedProvider);
+    }
+    if (toolsets) {
+        args.push("-t", toolsets);
+    }
+    if (maxTurns && maxTurns > 0) {
+        args.push("--max-turns", String(maxTurns));
+    }
+    if (worktreeMode)
+        args.push("-w");
+    if (checkpoints)
+        args.push("--checkpoints");
+    if (cfgBoolean(config.verbose) === true)
+        args.push("-v");
+    // Tag sessions as "tool" source so they don't clutter the user's session history.
+    // Requires hermes-agent >= PR #3255 (feat/session-source-tag).
+    args.push("--source", "tool");
+    // Bypass Hermes dangerous-command approval prompts.
+    // Paperclip agents run as non-interactive subprocesses with no TTY,
+    // so approval prompts would always timeout and deny legitimate commands
+    // (curl, python3 -c, etc.). Agents operate in a sandbox — the approval
+    // system is designed for human-attended interactive sessions.
+    args.push("--yolo");
+    // Session resume
+    const prevSessionId = cfgString(ctx.runtime?.sessionParams?.sessionId);
+    if (persistSession && prevSessionId) {
+        args.push("--resume", prevSessionId);
+    }
+    if (extraArgs?.length) {
+        args.push(...extraArgs);
+    }
+    // ── Build environment ──────────────────────────────────────────────────
+    const env = {
+        ...process.env,
+        ...buildPaperclipEnv(ctx.agent),
+    };
+    if (ctx.runId)
+        env.PAPERCLIP_RUN_ID = ctx.runId;
+    // BUG FIX: Inject authToken as PAPERCLIP_API_KEY (matches adapter-claude-local behavior)
+    if (ctx.authToken)
+        env.PAPERCLIP_API_KEY = ctx.authToken;
+    // BUG FIX: Read task context from ctx.context (wake context), not ctx.config (adapter config)
+    const ctxContext = ctx.context || {};
+    const envTaskId = cfgString(ctxContext.taskId) || cfgString(ctxContext.issueId) || cfgString(ctx.config?.taskId);
+    if (envTaskId)
+        env.PAPERCLIP_TASK_ID = envTaskId;
+    const envWakeReason = cfgString(ctxContext.wakeReason) || cfgString(ctx.config?.wakeReason);
+    if (envWakeReason)
+        env.PAPERCLIP_WAKE_REASON = envWakeReason;
+    const envCommentId = cfgString(ctxContext.commentId) || cfgString(ctxContext.wakeCommentId) || cfgString(ctx.config?.commentId);
+    if (envCommentId)
+        env.PAPERCLIP_WAKE_COMMENT_ID = envCommentId;
+    const userEnv = config.env;
+    if (userEnv && typeof userEnv === "object") {
+        Object.assign(env, userEnv);
+    }
+    // ── Resolve working directory ──────────────────────────────────────────
+    const cwd = cfgString(config.cwd) || cfgString(ctx.config?.workspaceDir) || ".";
+    try {
+        await ensureAbsoluteDirectory(cwd);
+    }
+    catch {
+        // Non-fatal
+    }
+    // ── Log start ──────────────────────────────────────────────────────────
+    await ctx.onLog("stdout", `[hermes] Starting Hermes Agent (model=${model}, provider=${resolvedProvider} [${resolvedFrom}], timeout=${timeoutSec}s${maxTurns ? `, max_turns=${maxTurns}` : ""})\n`);
+    if (prevSessionId) {
+        await ctx.onLog("stdout", `[hermes] Resuming session: ${prevSessionId}\n`);
+    }
+    // ── Execute ────────────────────────────────────────────────────────────
+    // Hermes writes non-error noise to stderr (MCP init, INFO logs, etc).
+    // Paperclip renders all stderr as red/error in the UI.
+    // Wrap onLog to reclassify benign stderr lines as stdout.
+    const wrappedOnLog = async (stream, chunk) => {
+        if (stream === "stderr") {
+            const trimmed = chunk.trimEnd();
+            // Benign patterns that should NOT appear as errors:
+            // - Structured log lines: [timestamp] INFO/DEBUG/WARN: ...
+            // - MCP server registration messages
+            // - Python import/site noise
+            const isBenign = /^\[?\d{4}[-/]\d{2}[-/]\d{2}T/.test(trimmed) || // structured timestamps
+                /^[A-Z]+:\s+(INFO|DEBUG|WARN|WARNING)\b/.test(trimmed) || // log levels
+                /Successfully registered all tools/.test(trimmed) ||
+                /MCP [Ss]erver/.test(trimmed) ||
+                /tool registered successfully/.test(trimmed) ||
+                /Application initialized/.test(trimmed);
+            if (isBenign) {
+                return ctx.onLog("stdout", chunk);
+            }
+        }
+        return ctx.onLog(stream, chunk);
+    };
+    const result = await runChildProcess(ctx.runId, hermesCmd, args, {
+        cwd,
+        env,
+        timeoutSec,
+        graceSec,
+        onLog: wrappedOnLog,
+    });
+    // ── Parse output ───────────────────────────────────────────────────────
+    const parsed = parseHermesOutput(result.stdout || "", result.stderr || "");
+    await ctx.onLog("stdout", `[hermes] Exit code: ${result.exitCode ?? "null"}, timed out: ${result.timedOut}\n`);
+    if (parsed.sessionId) {
+        await ctx.onLog("stdout", `[hermes] Session: ${parsed.sessionId}\n`);
+    }
+    // ── Build result ───────────────────────────────────────────────────────
+    const executionResult = {
+        exitCode: result.exitCode,
+        signal: result.signal,
+        timedOut: result.timedOut,
+        provider: resolvedProvider,
+        model,
+    };
+    if (parsed.errorMessage) {
+        executionResult.errorMessage = parsed.errorMessage;
+    }
+    if (parsed.usage) {
+        executionResult.usage = parsed.usage;
+    }
+    if (parsed.costUsd !== undefined) {
+        executionResult.costUsd = parsed.costUsd;
+    }
+    // Summary from agent response
+    if (parsed.response) {
+        executionResult.summary = parsed.response.slice(0, 2000);
+    }
+    // Set resultJson so Paperclip can persist run metadata (used for UI display + auto-comments)
+    executionResult.resultJson = {
+        result: parsed.response || "",
+        session_id: parsed.sessionId || null,
+        usage: parsed.usage || null,
+        cost_usd: parsed.costUsd ?? null,
+    };
+    // Store session ID for next run
+    if (persistSession && parsed.sessionId) {
+        executionResult.sessionParams = { sessionId: parsed.sessionId };
+        executionResult.sessionDisplayId = parsed.sessionId.slice(0, 16);
+    }
+    return executionResult;
+}
+//# sourceMappingURL=execute.js.map

package/dist/server/execute.js.map

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

package/dist/server/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Server-side adapter module exports.
+ */
+export { execute } from "./execute.js";
+export { testEnvironment } from "./test.js";
+export { detectModel, parseModelFromConfig, resolveProvider, inferProviderFromModel } from "./detect-model.js";
+export { listHermesSkills as listSkills, syncHermesSkills as syncSkills, resolveHermesDesiredSkillNames as resolveDesiredSkillNames, } from "./skills.js";
+import type { AdapterSessionCodec } from "@paperclipai/adapter-utils";
+/**
+ * Session codec for structured validation and migration of session parameters.
+ *
+ * Hermes Agent uses a single `sessionId` for cross-heartbeat session continuity
+ * via the `--resume` CLI flag. The codec validates and normalizes this field.
+ */
+export declare const sessionCodec: AdapterSessionCodec;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC/G,OAAO,EACL,gBAAgB,IAAI,UAAU,EAC9B,gBAAgB,IAAI,UAAU,EAC9B,8BAA8B,IAAI,wBAAwB,GAC3D,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAMtE;;;;;GAKG;AACH,eAAO,MAAM,YAAY,EAAE,mBAsB1B,CAAC"}

package/dist/server/index.js

@@ -0,0 +1,43 @@
+/**
+ * Server-side adapter module exports.
+ */
+export { execute } from "./execute.js";
+export { testEnvironment } from "./test.js";
+export { detectModel, parseModelFromConfig, resolveProvider, inferProviderFromModel } from "./detect-model.js";
+export { listHermesSkills as listSkills, syncHermesSkills as syncSkills, resolveHermesDesiredSkillNames as resolveDesiredSkillNames, } from "./skills.js";
+function readNonEmptyString(value) {
+    return typeof value === "string" && value.trim().length > 0 ? value.trim() : null;
+}
+/**
+ * Session codec for structured validation and migration of session parameters.
+ *
+ * Hermes Agent uses a single `sessionId` for cross-heartbeat session continuity
+ * via the `--resume` CLI flag. The codec validates and normalizes this field.
+ */
+export const sessionCodec = {
+    deserialize(raw) {
+        if (typeof raw !== "object" || raw === null || Array.isArray(raw))
+            return null;
+        const record = raw;
+        const sessionId = readNonEmptyString(record.sessionId) ??
+            readNonEmptyString(record.session_id);
+        if (!sessionId)
+            return null;
+        return { sessionId };
+    },
+    serialize(params) {
+        if (!params)
+            return null;
+        const sessionId = readNonEmptyString(params.sessionId) ??
+            readNonEmptyString(params.session_id);
+        if (!sessionId)
+            return null;
+        return { sessionId };
+    },
+    getDisplayId(params) {
+        if (!params)
+            return null;
+        return readNonEmptyString(params.sessionId) ?? readNonEmptyString(params.session_id);
+    },
+};
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC/G,OAAO,EACL,gBAAgB,IAAI,UAAU,EAC9B,gBAAgB,IAAI,UAAU,EAC9B,8BAA8B,IAAI,wBAAwB,GAC3D,MAAM,aAAa,CAAC;AAIrB,SAAS,kBAAkB,CAAC,KAAc;IACxC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACpF,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAwB;IAC/C,WAAW,CAAC,GAAY;QACtB,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QAC/E,MAAM,MAAM,GAAG,GAA8B,CAAC;QAC9C,MAAM,SAAS,GACb,kBAAkB,CAAC,MAAM,CAAC,SAAS,CAAC;YACpC,kBAAkB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACxC,IAAI,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC;QAC5B,OAAO,EAAE,SAAS,EAAE,CAAC;IACvB,CAAC;IACD,SAAS,CAAC,MAAsC;QAC9C,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QACzB,MAAM,SAAS,GACb,kBAAkB,CAAC,MAAM,CAAC,SAAS,CAAC;YACpC,kBAAkB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACxC,IAAI,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC;QAC5B,OAAO,EAAE,SAAS,EAAE,CAAC;IACvB,CAAC;IACD,YAAY,CAAC,MAAsC;QACjD,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QACzB,OAAO,kBAAkB,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,kBAAkB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACvF,CAAC;CACF,CAAC"}

package/dist/server/skills.d.ts

@@ -0,0 +1,8 @@
+import type { AdapterSkillContext, AdapterSkillSnapshot } from "@paperclipai/adapter-utils";
+export declare function listHermesSkills(ctx: AdapterSkillContext): Promise<AdapterSkillSnapshot>;
+export declare function syncHermesSkills(ctx: AdapterSkillContext, _desiredSkills: string[]): Promise<AdapterSkillSnapshot>;
+export declare function resolveHermesDesiredSkillNames(config: Record<string, unknown>, availableEntries: Array<{
+    key: string;
+    runtimeName?: string | null;
+}>): string[];
+//# sourceMappingURL=skills.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/server/skills.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,mBAAmB,EAEnB,oBAAoB,EACrB,MAAM,4BAA4B,CAAC;AAsMpC,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,mBAAmB,GACvB,OAAO,CAAC,oBAAoB,CAAC,CAE/B;AAED,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,mBAAmB,EACxB,cAAc,EAAE,MAAM,EAAE,GACvB,OAAO,CAAC,oBAAoB,CAAC,CAI/B;AAED,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,gBAAgB,EAAE,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,GACpE,MAAM,EAAE,CAEV"}