@tickernelz/paperclip-pro-hermes-paperclip-adapter 2026.925.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nous Research
+
+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,342 @@
+# Paperclip Adapters for Hermes Agent
+
+A [Paperclip](https://paperclip.ing) adapter package that lets you run [Hermes Agent](https://github.com/NousResearch/hermes-agent) as a managed employee in a Paperclip company.
+
+Hermes Agent is a full-featured AI agent by [Nous Research](https://nousresearch.com) with 30+ native tools, persistent memory, session persistence, 80+ skills, MCP support, and multi-provider model access.
+
+This package owns both built-in Hermes adapter types:
+
+- `hermes_local` runs the local Hermes CLI as a child process. The package root exports remain compatible with the original local adapter.
+- `hermes_gateway` calls an already-running Hermes API server over HTTP/SSE. Gateway entrypoints live under the `./gateway` export namespace.
+
+Choose `hermes_local` when Paperclip and Hermes run on the same trusted host
+and Paperclip should start `hermes chat` for each heartbeat. Choose
+`hermes_gateway` when Hermes is already running as an API server, often on
+another host, in Docker, or behind a private-network/TLS endpoint. The adapter
+type keys did not change during package consolidation.
+
+## Key Features
+
+This adapter provides:
+
+- **8 inference providers** — Anthropic, OpenRouter, OpenAI, Nous, OpenAI Codex, ZAI, Kimi Coding, MiniMax
+- **Skills integration** — Scans both Paperclip-managed and Hermes-native skills (`~/.hermes/skills/`), with sync/list/resolve APIs
+- **Structured transcript parsing** — Raw Hermes stdout is parsed into typed `TranscriptEntry` objects so Paperclip renders proper tool cards with status icons and expand/collapse
+- **Rich post-processing** — Converts Hermes ASCII banners, setext headings, and `+--+` table borders into clean GFM markdown
+- **Comment-driven wakes** — Agents wake to respond to issue comments, not just task assignments
+- **Auto model detection** — Reads `~/.hermes/config.yaml` to pre-populate the UI with the user's configured model
+- **Session codec** — Structured validation and migration of session state across heartbeats
+- **Benign stderr reclassification** — MCP init messages and structured logs are reclassified so they don't appear as errors in the UI
+- **Session source tagging** — Sessions are tagged as `tool` source so they don't clutter the user's interactive history
+- **Filesystem checkpoints** — Optional `--checkpoints` for rollback safety
+- **Thinking effort control** — Passes `--reasoning-effort` for thinking/reasoning models
+
+### Hermes Agent Capabilities
+
+| Feature | Claude Code | Codex | Hermes Agent |
+|---------|------------|-------|-------------|
+| Persistent memory | ❌ | ❌ | ✅ Remembers across sessions |
+| Native tools | ~5 | ~5 | 30+ (terminal, file, web, browser, vision, git, etc.) |
+| Skills system | ❌ | ❌ | ✅ 80+ loadable skills |
+| Session search | ❌ | ❌ | ✅ FTS5 search over past conversations |
+| Sub-agent delegation | ❌ | ❌ | ✅ Parallel sub-tasks |
+| Context compression | ❌ | ❌ | ✅ Auto-compresses long conversations |
+| MCP client | ❌ | ❌ | ✅ Connect to any MCP server |
+| Multi-provider | Anthropic only | OpenAI only | ✅ 8 providers out of the box |
+
+## Installation
+
+This package ships with Paperclip core as the built-in `hermes_local` and
+`hermes_gateway` adapters. No Adapter manager installation is required for
+normal Paperclip use.
+
+### Prerequisites
+
+- [Hermes Agent](https://github.com/NousResearch/hermes-agent) installed (`pip install hermes-agent`)
+- Python 3.10+
+- At least one LLM API key (Anthropic, OpenRouter, or OpenAI)
+
+## Quick Start
+
+### 1. Optional: override the built-in for adapter development
+
+For local adapter development, install the package from a local path in Adapter
+manager, or add an entry to `~/.paperclip-pro/adapter-plugins.json` and restart
+Paperclip. The external package can override either built-in Hermes adapter
+while it is enabled:
+
+```json
+[
+  {
+    "packageName": "@tickernelz/paperclip-pro-hermes-paperclip-adapter",
+    "localPath": "/absolute/path/to/paperclip/packages/adapters/hermes",
+    "type": "hermes_local",
+    "installedAt": "2026-06-23T00:00:00.000Z"
+  }
+]
+```
+
+Use `"type": "hermes_gateway"` with the same package when testing a gateway
+override.
+
+The package root exports `createServerAdapter()` for the local server adapter,
+a declarative config schema for the generic agent form, and `./ui-parser` for
+local run transcript parsing. Gateway entrypoints are exported from `./gateway`,
+`./gateway/server`, `./gateway/ui`, `./gateway/cli`, and `./gateway/ui-parser`.
+Paperclip core imports these same package entrypoints for built-in adapter
+registration.
+
+### 2. Create a local Hermes agent in Paperclip
+
+In the Paperclip UI or via API, create an agent with adapter type `hermes_local`:
+
+```json
+{
+  "name": "Hermes Engineer",
+  "adapterType": "hermes_local",
+  "adapterConfig": {
+    "model": "anthropic/claude-sonnet-4",
+    "maxIterations": 50,
+    "timeoutSec": 300,
+    "persistSession": true,
+    "enabledToolsets": ["terminal", "file", "web"]
+  }
+}
+```
+
+This mode shells out to the local `hermes` CLI. Paperclip injects runtime
+environment variables and captures stdout/stderr from the child process.
+
+### 3. Create a Hermes gateway agent in Paperclip
+
+Start Hermes with its API server enabled first:
+
+```bash
+API_SERVER_ENABLED=true \
+API_SERVER_KEY=<generated-secret> \
+hermes gateway run --replace --accept-hooks
+```
+
+Then create an agent with adapter type `hermes_gateway`:
+
+```json
+{
+  "name": "Hermes Gateway Engineer",
+  "adapterType": "hermes_gateway",
+  "adapterConfig": {
+    "apiBaseUrl": "http://127.0.0.1:8642",
+    "apiKey": "<same-value-as-API_SERVER_KEY>",
+    "paperclipApiUrl": "http://127.0.0.1:3100",
+    "sessionKeyStrategy": "issue",
+    "timeoutSec": 600
+  }
+}
+```
+
+If the URL you have is the default Hermes dashboard at
+`http://127.0.0.1:9119` or the default chat URL at
+`http://127.0.0.1:9119/chat`, Paperclip maps it to
+`http://127.0.0.1:9119/api` before calling Hermes API routes. `/chat` and the
+dashboard root are browser UI routes; Paperclip tests `/api/health` and starts
+runs with `/api/v1/runs` after mapping them to the API base.
+
+This mode does not start Hermes. It creates runs with `POST /v1/runs`, streams
+Hermes events with SSE, polls run status as a fallback, and stops timed-out runs
+with `POST /v1/runs/{run_id}/stop`.
+
+### Compatibility with the old gateway package
+
+`@tickernelz/paperclip-pro-adapter-hermes-gateway` remains as a deprecated compatibility shim
+for one release. It re-exports the gateway entrypoints from
+`@tickernelz/paperclip-pro-hermes-paperclip-adapter/gateway` and preserves the legacy exports
+for existing plugin installs. New installs and built-in Paperclip registrations
+should use `@tickernelz/paperclip-pro-hermes-paperclip-adapter`; the adapter type remains
+`hermes_gateway`.
+
+### Runtime API guidance
+
+Hermes receives Paperclip runtime identity through environment variables:
+
+- `PAPERCLIP_API_URL`
+- `PAPERCLIP_API_KEY`
+- `PAPERCLIP_RUN_ID`
+
+Prompts should reference those variables directly. Command output may redact
+secret values, so do not copy printed tokens into comments or config. Use
+`Authorization: Bearer $PAPERCLIP_API_KEY` on Paperclip API requests and
+`X-Paperclip-Run-Id: $PAPERCLIP_RUN_ID` on mutating issue requests. For
+multiline comments or status updates, preserve newlines with a heredoc plus
+`jq --arg`.
+
+### Hermes-originated Paperclip tasks
+
+The package includes a Hermes skill/helper for the reverse direction: a user
+starts in Hermes and asks Hermes to create or update Paperclip work. This is not
+the same as Paperclip waking Hermes through `hermes_local` or `hermes_gateway`.
+
+Configure Paperclip access in Hermes env/profile secrets, not prompt text:
+
+```bash
+PAPERCLIP_API_URL=http://127.0.0.1:3100/api
+PAPERCLIP_BRIDGE_API_KEY=<task-bridge-scoped-agent-api-key>
+```
+
+Optional env values:
+
+- `PAPERCLIP_COMPANY_ID`
+- `PAPERCLIP_AGENT_ID`
+- `PAPERCLIP_RUN_ID`
+
+The bundled `paperclip-task-bridge` skill provides deterministic helper
+commands:
+
+```bash
+node ./paperclip-task.mjs list-assigned
+node ./paperclip-task.mjs create-task --parent-id "<approved-parent-issue-id>" --title "Investigate checkout failures" --description "Capture failing request and root cause."
+node ./paperclip-task.mjs comment --issue PAP-123 --body "Found the failing request path."
+node ./paperclip-task.mjs update-status --issue PAP-123 --status in_review --comment "Ready for review."
+```
+
+The helper reads credentials from environment variables and prints only JSON
+summaries. It supports `create-task`, `comment`, `update-status`, and
+`list-assigned`.
+
+Create the bridge key with `scope.kind = "task_bridge"` plus a `parentIssueId`
+or `projectId` boundary. Do not use a normal claimed agent API key for
+internet-facing Hermes chat/webhook task-bridge operations.
+
+### 4. Assign work
+
+Create issues in Paperclip and assign them to your Hermes agent. On each heartbeat, Hermes will:
+
+1. Receive the task instructions
+2. Use its full tool suite to complete the work
+3. Report results back to Paperclip
+4. Persist session state for continuity
+
+## Configuration Reference
+
+### Core
+
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `model` | string | `anthropic/claude-sonnet-4` | Model in `provider/model` format |
+| `provider` | string | *(auto-detected)* | API provider: `auto`, `openrouter`, `nous`, `openai-codex`, `zai`, `kimi-coding`, `minimax`, `minimax-cn` |
+| `timeoutSec` | number | `300` | Execution timeout in seconds |
+| `graceSec` | number | `10` | Grace period before SIGKILL |
+
+### Tools
+
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `toolsets` | string | *(all)* | Comma-separated toolsets to enable (e.g. `"terminal,file,web"`) |
+
+Available toolsets: `terminal`, `file`, `web`, `browser`, `code_execution`, `vision`, `mcp`, `creative`, `productivity`
+
+### Session & Workspace
+
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `persistSession` | boolean | `true` | Resume sessions across heartbeats |
+| `worktreeMode` | boolean | `false` | Git worktree isolation |
+| `checkpoints` | boolean | `false` | Enable filesystem checkpoints for rollback |
+
+### Advanced
+
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `hermesCommand` | string | `hermes` | Custom CLI binary path |
+| `verbose` | boolean | `false` | Enable verbose output |
+| `quiet` | boolean | `true` | Quiet mode (clean output, no banner/spinner) |
+| `extraArgs` | string[] | `[]` | Additional CLI arguments |
+| `env` | object | `{}` | Extra environment variables |
+| `promptTemplate` | string | *(built-in)* | Custom prompt template |
+| `paperclipApiUrl` | string | `http://127.0.0.1:3100/api` | Paperclip API base URL |
+
+### Prompt Template Variables
+
+Use `{{variable}}` syntax in `promptTemplate`:
+
+| Variable | Description |
+|----------|-------------|
+| `{{agentId}}` | Paperclip agent ID |
+| `{{agentName}}` | Agent display name |
+| `{{companyId}}` | Company ID |
+| `{{companyName}}` | Company name |
+| `{{runId}}` | Current heartbeat run ID |
+| `{{taskId}}` | Assigned task/issue ID |
+| `{{taskTitle}}` | Task title |
+| `{{taskBody}}` | Task instructions |
+| `{{projectName}}` | Project name |
+| `{{paperclipApiUrl}}` | Paperclip API base URL |
+| `{{commentId}}` | Comment ID (when woken by a comment) |
+| `{{wakeReason}}` | Reason this run was triggered |
+
+Conditional sections:
+
+- `{{#taskId}}...{{/taskId}}` — included only when a task is assigned
+- `{{#noTask}}...{{/noTask}}` — included only when no task (heartbeat check)
+- `{{#commentId}}...{{/commentId}}` — included only when woken by a comment
+
+## Architecture
+
+```
+Paperclip                          Hermes Agent
+┌──────────────────┐               ┌──────────────────┐
+│  Heartbeat       │               │                  │
+│  Scheduler       │───execute()──▶│  hermes chat -q  │
+│                  │               │                  │
+│  Issue System    │               │  30+ Tools       │
+│  Comment Wakes   │◀──results─────│  Memory System   │
+│                  │               │  Session DB      │
+│  Cost Tracking   │               │  Skills          │
+│                  │               │  MCP Client      │
+│  Skill Sync      │◀──snapshot────│  ~/.hermes/skills│
+│  Org Chart       │               │                  │
+└──────────────────┘               └──────────────────┘
+```
+
+The adapter spawns Hermes Agent's CLI in single-query mode (`-q`). Hermes
+processes the task using its full tool suite, then exits. The adapter:
+
+1. **Captures** stdout/stderr and parses token usage, session IDs, and cost
+2. **Parses** raw output into structured `TranscriptEntry` objects (tool cards with status icons)
+3. **Post-processes** Hermes ASCII formatting (banners, setext headings, table borders) into clean GFM markdown
+4. **Reclassifies** benign stderr (MCP init, structured logs) so they don't show as errors
+5. **Tags** sessions as `tool` source to keep them separate from interactive usage
+6. **Reports** results back to Paperclip with cost, usage, and session state
+
+Session persistence works via Hermes's `--resume` flag — each run picks
+up where the last one left off, maintaining conversation context,
+memories, and tool state across heartbeats. The `sessionCodec` validates
+and migrates session state between runs.
+
+### Skills Integration
+
+The adapter scans two skill sources and merges them:
+
+- **Paperclip-managed skills** — bundled with the adapter, togglable from the UI
+- **Hermes-native skills** — from `~/.hermes/skills/`, read-only, always loaded
+
+The `listSkills` / `syncSkills` APIs expose a unified snapshot so the
+Paperclip UI can display both managed and native skills in one view.
+
+## Development
+
+```bash
+git clone https://github.com/paperclipai/paperclip
+cd paperclip/packages/adapters/hermes
+pnpm install
+pnpm build
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE)
+
+## Links
+
+- [Hermes Agent](https://github.com/NousResearch/hermes-agent) — The AI agent this adapter runs
+- [Paperclip](https://github.com/paperclipai/paperclip) — The orchestration platform
+- [Nous Research](https://nousresearch.com) — The team behind Hermes
+- [Paperclip Docs](https://docs.paperclip.ing) — Paperclip documentation

package/dist/cli/format-event.d.ts

@@ -0,0 +1,14 @@
+/**
+ * CLI output formatting for Hermes Agent adapter.
+ *
+ * Pretty-prints Hermes output lines in the terminal when running
+ * Paperclip's CLI tools.
+ */
+/**
+ * Format a Hermes Agent stdout event for terminal display.
+ *
+ * @param raw    Raw stdout line from Hermes
+ * @param debug  If true, show extra metadata with color coding
+ */
+export declare function printHermesStreamEvent(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":"AAAA;;;;;GAKG;AAIH;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CA6CxE"}

package/dist/cli/format-event.js

@@ -0,0 +1,52 @@
+/**
+ * CLI output formatting for Hermes Agent adapter.
+ *
+ * Pretty-prints Hermes output lines in the terminal when running
+ * Paperclip's CLI tools.
+ */
+import pc from "picocolors";
+/**
+ * Format a Hermes Agent stdout event for terminal display.
+ *
+ * @param raw    Raw stdout line from Hermes
+ * @param debug  If true, show extra metadata with color coding
+ */
+export function printHermesStreamEvent(raw, debug) {
+    const line = raw.trim();
+    if (!line)
+        return;
+    if (!debug) {
+        console.log(line);
+        return;
+    }
+    // Adapter log lines
+    if (line.startsWith("[hermes]")) {
+        console.log(pc.blue(line));
+        return;
+    }
+    // Tool output (┊ prefix)
+    if (line.startsWith("┊")) {
+        console.log(pc.cyan(line));
+        return;
+    }
+    // Thinking
+    if (line.includes("💭") || line.startsWith("<thinking>")) {
+        console.log(pc.dim(line));
+        return;
+    }
+    // Errors
+    if (line.startsWith("Error:") ||
+        line.startsWith("ERROR:") ||
+        line.startsWith("Traceback")) {
+        console.log(pc.red(line));
+        return;
+    }
+    // Session info
+    if (/session/i.test(line) && /id|saved|resumed/i.test(line)) {
+        console.log(pc.green(line));
+        return;
+    }
+    // Default: gray in debug mode
+    console.log(pc.gray(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":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,GAAW,EAAE,KAAc;IAChE,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACxB,IAAI,CAAC,IAAI;QAAE,OAAO;IAElB,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClB,OAAO;IACT,CAAC;IAED,oBAAoB;IACpB,IAAI,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAChC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3B,OAAO;IACT,CAAC;IAED,yBAAyB;IACzB,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3B,OAAO;IACT,CAAC;IAED,WAAW;IACX,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QACzD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;QAC1B,OAAO;IACT,CAAC;IAED,SAAS;IACT,IACE,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QACzB,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QACzB,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAC5B,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;QAC1B,OAAO;IACT,CAAC;IAED,eAAe;IACf,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5D,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5B,OAAO;IACT,CAAC;IAED,8BAA8B;IAC9B,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAC7B,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * CLI module exports — used by Paperclip's CLI for terminal formatting.
+ */
+export { printHermesStreamEvent } 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;;GAEG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/cli/index.js

@@ -0,0 +1,5 @@
+/**
+ * CLI module exports — used by Paperclip's CLI for terminal formatting.
+ */
+export { printHermesStreamEvent } 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;;GAEG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/gateway/cli/format-event.d.ts

@@ -0,0 +1,2 @@
+export declare function printHermesGatewayStreamEvent(line: string, debug: boolean): void;
+//# sourceMappingURL=format-event.d.ts.map

package/dist/gateway/cli/format-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-event.d.ts","sourceRoot":"","sources":["../../../src/gateway/cli/format-event.ts"],"names":[],"mappings":"AAAA,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAYhF"}

package/dist/gateway/cli/format-event.js

@@ -0,0 +1,16 @@
+export function printHermesGatewayStreamEvent(line, debug) {
+    const trimmed = line.trim();
+    if (!trimmed)
+        return;
+    if (trimmed.startsWith("[hermes-gateway:event]")) {
+        console.log(trimmed);
+        return;
+    }
+    if (trimmed.startsWith("[hermes-gateway]")) {
+        console.log(trimmed);
+        return;
+    }
+    if (debug)
+        console.log(line);
+}
+//# sourceMappingURL=format-event.js.map

package/dist/gateway/cli/format-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-event.js","sourceRoot":"","sources":["../../../src/gateway/cli/format-event.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,6BAA6B,CAAC,IAAY,EAAE,KAAc;IACxE,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,CAAC,OAAO;QAAE,OAAO;IACrB,IAAI,OAAO,CAAC,UAAU,CAAC,wBAAwB,CAAC,EAAE,CAAC;QACjD,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IACD,IAAI,OAAO,CAAC,UAAU,CAAC,kBAAkB,CAAC,EAAE,CAAC;QAC3C,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IACD,IAAI,KAAK;QAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC"}

package/dist/gateway/cli/index.d.ts

@@ -0,0 +1,2 @@
+export { printHermesGatewayStreamEvent as formatStdoutEvent } from "./format-event.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/gateway/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/gateway/cli/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,IAAI,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/gateway/cli/index.js

@@ -0,0 +1,2 @@
+export { printHermesGatewayStreamEvent as formatStdoutEvent } from "./format-event.js";
+//# sourceMappingURL=index.js.map

package/dist/gateway/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/gateway/cli/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,IAAI,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/gateway/index.d.ts

@@ -0,0 +1,10 @@
+import type { ServerAdapterModule } from "@tickernelz/paperclip-pro-adapter-utils";
+export declare const type = "hermes_gateway";
+export declare const label = "Hermes Gateway";
+export declare const models: {
+    id: string;
+    label: string;
+}[];
+export declare const agentConfigurationDoc = "# hermes_gateway agent configuration\n\nAdapter: hermes_gateway\n\nUse when:\n- Hermes Agent runs on another host or process that exposes the Hermes API server.\n- Paperclip should create Hermes runs through POST /v1/runs and observe them through SSE events.\n- You need remote Hermes session continuity with X-Hermes-Session-Key.\n\nDon't use when:\n- Hermes should run as a local child process on the Paperclip host; use hermes_local instead.\n- The Hermes API server is not enabled or is only reachable over an unsafe public HTTP endpoint.\n- You need Hermes-originated Paperclip task creation only; that is a Paperclip skill/API bridge, not this wake adapter.\n\nRequired fields:\n- apiBaseUrl (string): Hermes API server base URL, for example http://127.0.0.1:8642.\n  The default Hermes dashboard root or chat URL, for example http://127.0.0.1:9119 or http://127.0.0.1:9119/chat, is also accepted and maps to /api.\n- apiKey (string): Hermes API_SERVER_KEY. Sent as Authorization: Bearer <apiKey>.\n\nOptional fields:\n- headers (object or JSON string): extra noncritical headers. Authorization, Content-Type, Accept, Idempotency-Key, and X-Hermes-Session-Key are generated by the adapter.\n- paperclipApiUrl (string): Paperclip API URL reachable from the Hermes host. This is not a credential.\n- sessionKeyStrategy (issue | agent | run | none): defaults to issue.\n- timeoutSec (number): defaults to 600.\n- eventReconnectMs (number): defaults to 2000.\n- instructions (string): stable Hermes instructions sent separately from wake input.\n\nRuntime mapping:\n- Creates runs with POST /v1/runs.\n- Sends Idempotency-Key equal to the Paperclip run id for correlation only; Hermes v0.16.0 did not dedupe duplicate creates.\n- Streams GET /v1/runs/{run_id}/events and polls GET /v1/runs/{run_id} as fallback.\n- Calls POST /v1/runs/{run_id}/stop on timeout.\n\nSecurity guidance:\n- Prefer HTTPS or a private overlay network for non-loopback hosts.\n- Do not put Hermes apiKey or Paperclip bearer tokens in prompts, comments, logs, or result JSON.\n- Keep the default issue-scoped session strategy unless shared agent memory is intentional.\n";
+export declare function createServerAdapter(): ServerAdapterModule;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/gateway/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA4B,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAI7G,eAAO,MAAM,IAAI,mBAAe,CAAC;AACjC,eAAO,MAAM,KAAK,mBAAgB,CAAC;AACnC,eAAO,MAAM,MAAM,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAO,CAAC;AAa1D,eAAO,MAAM,qBAAqB,wmEAqCjC,CAAC;AAEF,wBAAgB,mBAAmB,IAAI,mBAAmB,CAczD"}

package/dist/gateway/index.js

@@ -0,0 +1,69 @@
+import { ADAPTER_LABEL, ADAPTER_TYPE } from "./shared/constants.js";
+import { execute, getConfigSchema, sessionCodec, testEnvironment } from "./server/index.js";
+export const type = ADAPTER_TYPE;
+export const label = ADAPTER_LABEL;
+export const models = [];
+const sessionManagement = {
+    supportsSessionResume: true,
+    nativeContextManagement: "confirmed",
+    defaultSessionCompaction: {
+        enabled: true,
+        maxSessionRuns: 0,
+        maxRawInputTokens: 0,
+        maxSessionAgeHours: 0,
+    },
+};
+export const agentConfigurationDoc = `# hermes_gateway agent configuration
+
+Adapter: hermes_gateway
+
+Use when:
+- Hermes Agent runs on another host or process that exposes the Hermes API server.
+- Paperclip should create Hermes runs through POST /v1/runs and observe them through SSE events.
+- You need remote Hermes session continuity with X-Hermes-Session-Key.
+
+Don't use when:
+- Hermes should run as a local child process on the Paperclip host; use hermes_local instead.
+- The Hermes API server is not enabled or is only reachable over an unsafe public HTTP endpoint.
+- You need Hermes-originated Paperclip task creation only; that is a Paperclip skill/API bridge, not this wake adapter.
+
+Required fields:
+- apiBaseUrl (string): Hermes API server base URL, for example http://127.0.0.1:8642.
+  The default Hermes dashboard root or chat URL, for example http://127.0.0.1:9119 or http://127.0.0.1:9119/chat, is also accepted and maps to /api.
+- apiKey (string): Hermes API_SERVER_KEY. Sent as Authorization: Bearer <apiKey>.
+
+Optional fields:
+- headers (object or JSON string): extra noncritical headers. Authorization, Content-Type, Accept, Idempotency-Key, and X-Hermes-Session-Key are generated by the adapter.
+- paperclipApiUrl (string): Paperclip API URL reachable from the Hermes host. This is not a credential.
+- sessionKeyStrategy (issue | agent | run | none): defaults to issue.
+- timeoutSec (number): defaults to 600.
+- eventReconnectMs (number): defaults to 2000.
+- instructions (string): stable Hermes instructions sent separately from wake input.
+
+Runtime mapping:
+- Creates runs with POST /v1/runs.
+- Sends Idempotency-Key equal to the Paperclip run id for correlation only; Hermes v0.16.0 did not dedupe duplicate creates.
+- Streams GET /v1/runs/{run_id}/events and polls GET /v1/runs/{run_id} as fallback.
+- Calls POST /v1/runs/{run_id}/stop on timeout.
+
+Security guidance:
+- Prefer HTTPS or a private overlay network for non-loopback hosts.
+- Do not put Hermes apiKey or Paperclip bearer tokens in prompts, comments, logs, or result JSON.
+- Keep the default issue-scoped session strategy unless shared agent memory is intentional.
+`;
+export function createServerAdapter() {
+    return {
+        type,
+        execute,
+        testEnvironment,
+        sessionCodec,
+        sessionManagement,
+        models,
+        supportsLocalAgentJwt: false,
+        supportsInstructionsBundle: false,
+        requiresMaterializedRuntimeSkills: false,
+        agentConfigurationDoc,
+        getConfigSchema,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/gateway/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/gateway/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAE5F,MAAM,CAAC,MAAM,IAAI,GAAG,YAAY,CAAC;AACjC,MAAM,CAAC,MAAM,KAAK,GAAG,aAAa,CAAC;AACnC,MAAM,CAAC,MAAM,MAAM,GAAoC,EAAE,CAAC;AAE1D,MAAM,iBAAiB,GAA6B;IAClD,qBAAqB,EAAE,IAAI;IAC3B,uBAAuB,EAAE,WAAW;IACpC,wBAAwB,EAAE;QACxB,OAAO,EAAE,IAAI;QACb,cAAc,EAAE,CAAC;QACjB,iBAAiB,EAAE,CAAC;QACpB,kBAAkB,EAAE,CAAC;KACtB;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCpC,CAAC;AAEF,MAAM,UAAU,mBAAmB;IACjC,OAAO;QACL,IAAI;QACJ,OAAO;QACP,eAAe;QACf,YAAY;QACZ,iBAAiB;QACjB,MAAM;QACN,qBAAqB,EAAE,KAAK;QAC5B,0BAA0B,EAAE,KAAK;QACjC,iCAAiC,EAAE,KAAK;QACxC,qBAAqB;QACrB,eAAe;KAChB,CAAC;AACJ,CAAC"}

package/dist/gateway/server/config-schema.d.ts

@@ -0,0 +1,3 @@
+import type { AdapterConfigSchema } from "@tickernelz/paperclip-pro-adapter-utils";
+export declare function getConfigSchema(): AdapterConfigSchema;
+//# sourceMappingURL=config-schema.d.ts.map

package/dist/gateway/server/config-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-schema.d.ts","sourceRoot":"","sources":["../../../src/gateway/server/config-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAInF,wBAAgB,eAAe,IAAI,mBAAmB,CAuErD"}