@paperclipai/hermes-paperclip-adapter 0.3.0

package/dist/server/detect-model.js

@@ -0,0 +1,158 @@
+/**
+ * Detect the current model and provider from the user's Hermes config.
+ *
+ * Reads ~/.hermes/config.yaml and extracts the default model,
+ * provider, base_url, api_key presence, and api_mode settings.
+ *
+ * Also provides provider resolution logic that merges explicit config,
+ * Hermes config detection, and model-name prefix inference.
+ */
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { MODEL_PREFIX_PROVIDER_HINTS, VALID_PROVIDERS } from "../shared/constants.js";
+/**
+ * Read the Hermes config file and extract the default model config.
+ */
+export async function detectModel(configPath) {
+    const filePath = configPath ?? join(homedir(), ".hermes", "config.yaml");
+    let content;
+    try {
+        content = await readFile(filePath, "utf-8");
+    }
+    catch {
+        return null;
+    }
+    return parseModelFromConfig(content);
+}
+/**
+ * Parse model.default, model.provider, model.base_url, model.api_key, and model.api_mode
+ * from raw YAML content. Uses simple regex parsing to avoid a YAML dependency.
+ */
+export function parseModelFromConfig(content) {
+    const lines = content.split("\n");
+    let model = "";
+    let provider = "";
+    let baseUrl = "";
+    let hasApiKey = false;
+    let apiMode = "";
+    let inModelSection = false;
+    let modelSectionIndent = 0;
+    for (const line of lines) {
+        const trimmed = line.trimEnd();
+        const indent = line.length - line.trimStart().length;
+        // Track model: section (indent 0)
+        if (/^model:\s*$/.test(trimmed) && indent === 0) {
+            inModelSection = true;
+            modelSectionIndent = 0;
+            continue;
+        }
+        // We left the model section if indent drops back to the section level or below
+        if (inModelSection && indent <= modelSectionIndent && trimmed && !trimmed.startsWith("#")) {
+            inModelSection = false;
+        }
+        if (inModelSection) {
+            const match = trimmed.match(/^\s*(\w+)\s*:\s*(.+)$/);
+            if (match) {
+                const key = match[1];
+                const val = match[2].trim().replace(/#.*$/, "").trim().replace(/^['"]|['"]$/g, "");
+                if (key === "default")
+                    model = val;
+                if (key === "provider")
+                    provider = val;
+                if (key === "base_url")
+                    baseUrl = val;
+                if (key === "api_key")
+                    hasApiKey = val.length > 0;
+                if (key === "api_mode")
+                    apiMode = val;
+            }
+        }
+    }
+    if (!model)
+        return null;
+    return { model, provider, baseUrl, hasApiKey, apiMode, source: "config" };
+}
+/**
+ * Infer a provider from the model name using prefix-based hints.
+ *
+ * For example:
+ *   "gpt-5.4"       → "copilot"
+ *   "claude-sonnet-4" → "anthropic"
+ *   "glm-5-turbo"   → "zai"
+ *
+ * Returns undefined if no hint matches (caller should fall back to "auto").
+ */
+export function inferProviderFromModel(model) {
+    const lower = model.toLowerCase();
+    // Strip provider/ prefix if present (e.g. "anthropic/claude-sonnet-4")
+    const bareName = lower.includes("/") ? lower.split("/").pop() : lower;
+    for (const [prefix, hint] of MODEL_PREFIX_PROVIDER_HINTS) {
+        if (bareName.startsWith(prefix)) {
+            return hint;
+        }
+    }
+    return undefined;
+}
+/**
+ * Resolve the correct provider for a model, using a priority chain:
+ *
+ *   1. Explicit provider from adapterConfig (highest priority — user override)
+ *   2. Provider from Hermes config file — ONLY if the config model matches
+ *      the requested model (otherwise the config provider is for a different model)
+ *   3. If Hermes config matches the requested model but uses runtime settings that
+ *      the adapter cannot represent directly, return "auto" and let Hermes resolve it itself
+ *   4. Provider inferred from model name prefix
+ *   5. "auto" (let Hermes figure it out — lowest priority)
+ *
+ * Always returns a valid provider string.
+ * The `resolvedFrom` field indicates which source was used, useful for logging.
+ */
+export function resolveProvider(options) {
+    const { explicitProvider, detectedProvider, detectedModel, detectedBaseUrl, detectedHasApiKey, detectedApiMode, model, } = options;
+    // 1. Explicit provider from adapterConfig — user override, always wins
+    if (explicitProvider && VALID_PROVIDERS.includes(explicitProvider)) {
+        return { provider: explicitProvider, resolvedFrom: "adapterConfig" };
+    }
+    const supportedProviders = VALID_PROVIDERS;
+    const configMatchesRequestedModel = !!detectedModel &&
+        !!model &&
+        detectedModel.toLowerCase() === model.toLowerCase();
+    // 2. Provider from Hermes config file — but ONLY if the config model matches
+    //    the requested model. Otherwise the config provider is for a different model
+    //    and would cause exactly the kind of routing bug we're fixing.
+    if (configMatchesRequestedModel &&
+        !!detectedProvider &&
+        supportedProviders.includes(detectedProvider)) {
+        return { provider: detectedProvider, resolvedFrom: "hermesConfig" };
+    }
+    const hasRuntimeSignals = !!detectedBaseUrl || !!detectedHasApiKey || !!detectedApiMode;
+    // 3a. Matching Hermes config with an unsupported provider (for example "custom")
+    //     should not fall through to model-name inference, because that can route to
+    //     the wrong provider entirely. Defer back to Hermes's own runtime resolution.
+    if (configMatchesRequestedModel && !!detectedProvider && !supportedProviders.includes(detectedProvider)) {
+        return {
+            provider: "auto",
+            resolvedFrom: `hermesConfigUnsupported:${detectedProvider}`,
+        };
+    }
+    // 3b. Matching Hermes config may omit provider entirely while still specifying
+    //     enough runtime information (base_url, api_key, api_mode) for Hermes itself.
+    //     In that case, also defer to Hermes instead of doing a wrong prefix inference.
+    if (configMatchesRequestedModel && !detectedProvider && hasRuntimeSignals) {
+        return {
+            provider: "auto",
+            resolvedFrom: "hermesConfigRuntime",
+        };
+    }
+    // 4. Infer from model name prefix
+    if (model) {
+        const inferred = inferProviderFromModel(model);
+        if (inferred) {
+            return { provider: inferred, resolvedFrom: "modelInference" };
+        }
+    }
+    // 5. Let Hermes auto-detect
+    return { provider: "auto", resolvedFrom: "auto" };
+}
+//# sourceMappingURL=detect-model.js.map

package/dist/server/detect-model.js.map

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

package/dist/server/detect-model.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=detect-model.test.d.ts.map

package/dist/server/detect-model.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-model.test.d.ts","sourceRoot":"","sources":["../../src/server/detect-model.test.ts"],"names":[],"mappings":""}

package/dist/server/detect-model.test.js

@@ -0,0 +1,166 @@
+import { mkdir, mkdtemp, rm, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { afterEach, expect, test } from "vitest";
+import { parseModelFromConfig, resolveProvider } from "./detect-model.js";
+import { testEnvironment } from "./test.js";
+const providerEnvKeys = [
+    "ANTHROPIC_API_KEY",
+    "OPENROUTER_API_KEY",
+    "OPENAI_API_KEY",
+    "ZAI_API_KEY",
+    "KIMI_API_KEY",
+    "MINIMAX_API_KEY",
+];
+const previousEnv = {
+    HOME: process.env.HOME,
+    USERPROFILE: process.env.USERPROFILE,
+    HOMEDRIVE: process.env.HOMEDRIVE,
+    HOMEPATH: process.env.HOMEPATH,
+    ...Object.fromEntries(providerEnvKeys.map((key) => [key, process.env[key]])),
+};
+afterEach(async () => {
+    for (const [key, value] of Object.entries(previousEnv)) {
+        if (value === undefined) {
+            delete process.env[key];
+        }
+        else {
+            process.env[key] = value;
+        }
+    }
+});
+test("parseModelFromConfig tracks api_key presence without exposing the raw secret", () => {
+    const parsed = parseModelFromConfig([
+        "model:",
+        "  default: oca/gpt-5.4",
+        "  provider: custom",
+        "  base_url: https://example.invalid/litellm",
+        "  api_key: super-secret-value",
+        "",
+    ].join("\n"));
+    expect(parsed).toBeTruthy();
+    expect(parsed?.hasApiKey).toBe(true);
+    expect(Object.hasOwn(parsed ?? {}, "apiKey")).toBe(false);
+});
+test("resolveProvider does not fall through to model inference when Hermes config provider is unsupported but matches the requested model", () => {
+    expect(resolveProvider({
+        explicitProvider: undefined,
+        detectedProvider: "custom",
+        detectedModel: "oca/gpt-5.4",
+        detectedBaseUrl: "https://example.invalid/litellm",
+        detectedHasApiKey: true,
+        model: "oca/gpt-5.4",
+    })).toEqual({
+        provider: "auto",
+        resolvedFrom: "hermesConfigUnsupported:custom",
+    });
+});
+test("resolveProvider also defers to Hermes runtime when the matching config omits provider but includes runtime signals", () => {
+    expect(resolveProvider({
+        explicitProvider: undefined,
+        detectedProvider: "",
+        detectedModel: "oca/gpt-5.4",
+        detectedBaseUrl: "https://example.invalid/litellm",
+        detectedHasApiKey: true,
+        model: "oca/gpt-5.4",
+    })).toEqual({
+        provider: "auto",
+        resolvedFrom: "hermesConfigRuntime",
+    });
+});
+test("resolveProvider still infers from the requested model when Hermes config is for a different model", () => {
+    expect(resolveProvider({
+        explicitProvider: undefined,
+        detectedProvider: "custom",
+        detectedModel: "oca/gpt-5.4",
+        detectedBaseUrl: "https://example.invalid/litellm",
+        detectedHasApiKey: true,
+        model: "claude-sonnet-4",
+    })).toEqual({
+        provider: "anthropic",
+        resolvedFrom: "modelInference",
+    });
+});
+async function withHermesHomeConfig(configLines, fn) {
+    const tempHome = await mkdtemp(join(tmpdir(), "hermes-paperclip-adapter-"));
+    const hermesDir = join(tempHome, ".hermes");
+    const configPath = join(hermesDir, "config.yaml");
+    await mkdir(hermesDir, { recursive: true });
+    await writeFile(configPath, `${configLines.join("\n")}\n`, "utf8");
+    process.env.HOME = tempHome;
+    process.env.USERPROFILE = tempHome;
+    delete process.env.HOMEDRIVE;
+    delete process.env.HOMEPATH;
+    for (const key of providerEnvKeys) {
+        delete process.env[key];
+    }
+    try {
+        await fn();
+    }
+    finally {
+        await rm(tempHome, { recursive: true, force: true });
+    }
+}
+test("testEnvironment does not warn about missing API keys when Hermes config provides a supported provider api_key", async () => {
+    await withHermesHomeConfig([
+        "model:",
+        "  default: openrouter/gpt-4.1-mini",
+        "  provider: openrouter",
+        "  api_key: test-secret",
+    ], async () => {
+        const result = await testEnvironment({
+            companyId: "company-test",
+            adapterType: "hermes_local",
+            config: {
+                hermesCommand: "python3",
+                model: "openrouter/gpt-4.1-mini",
+            },
+        });
+        const codes = result.checks.map((check) => check.code);
+        expect(codes.includes("hermes_no_api_keys")).toBe(false);
+        expect(result.status).toBe("pass");
+    });
+});
+test("testEnvironment describes provider-omitted runtime config without inventing provider auto", async () => {
+    await withHermesHomeConfig([
+        "model:",
+        "  default: oca/gpt-5.4",
+        "  base_url: https://example.invalid/litellm",
+        "  api_key: test-secret",
+    ], async () => {
+        const result = await testEnvironment({
+            companyId: "company-test",
+            adapterType: "hermes_local",
+            config: {
+                hermesCommand: "python3",
+                model: "oca/gpt-5.4",
+            },
+        });
+        const apiKeyCheck = result.checks.find((check) => check.code === "hermes_api_key_in_config");
+        expect(apiKeyCheck).toBeTruthy();
+        expect(apiKeyCheck?.message).toMatch(/without an explicit provider/i);
+        expect(apiKeyCheck?.message).not.toMatch(/provider "auto"/i);
+    });
+});
+test("testEnvironment does not warn about missing API keys when Hermes config provides a custom provider base_url and api_key", async () => {
+    await withHermesHomeConfig([
+        "model:",
+        "  default: oca/gpt-5.4",
+        "  provider: custom",
+        "  base_url: https://example.invalid/litellm",
+        "  api_key: test-secret",
+    ], async () => {
+        const result = await testEnvironment({
+            companyId: "company-test",
+            adapterType: "hermes_local",
+            config: {
+                hermesCommand: "python3",
+                model: "oca/gpt-5.4",
+            },
+        });
+        const codes = result.checks.map((check) => check.code);
+        expect(codes.includes("hermes_no_api_keys")).toBe(false);
+        expect(result.status).toBe("pass");
+    });
+});
+//# sourceMappingURL=detect-model.test.js.map

package/dist/server/detect-model.test.js.map

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

package/dist/server/execute.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 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 type { AdapterExecutionContext, AdapterExecutionResult } from "@paperclipai/adapter-utils";
+export declare function resolveHermesCommand(config: Record<string, unknown>): string;
+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":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAKH,OAAO,KAAK,EACV,uBAAuB,EACvB,sBAAsB,EAEvB,MAAM,4BAA4B,CAAC;AAyCpC,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAE5E;AAiQD,wBAAsB,OAAO,CAC3B,GAAG,EAAE,uBAAuB,GAC3B,OAAO,CAAC,sBAAsB,CAAC,CAsQjC"}