Chaim
45341a0bc8
A/B test (2026-05-05) showed DeepSeek V4-Pro is 2-3x faster and ~20x cheaper than Sonnet for style/lexicon pattern analysis, with comparable quality. Adds adapters/deepseek-paperclip-adapter/ package, documents adapter requirements (env injection, run-id headers), updates CLAUDE.md with adapter integration notes, and records lessons from ערר 1200-25 (block order for 1xxx, "להלן מתוך" pattern, expanded factual background, bridge planning analysis, flat heading structure). Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
100 lines
4.0 KiB
JavaScript
100 lines
4.0 KiB
JavaScript
/**
|
|
* DeepSeek (via Hermes) — external Paperclip adapter.
|
|
*
|
|
* Loaded by Paperclip's plugin-loader. Contract:
|
|
* The package's main module must export createServerAdapter() returning
|
|
* a single ServerAdapterModule object with all fields wired in.
|
|
*
|
|
* Runtime: spawns the local `hermes` CLI with HERMES_HOME pinned to a
|
|
* DeepSeek profile that defines model.base_url=https://api.deepseek.com/v1
|
|
* and model.key_env=DEEPSEEK_API_KEY.
|
|
*/
|
|
|
|
import {
|
|
ADAPTER_TYPE,
|
|
ADAPTER_LABEL,
|
|
DEEPSEEK_MODELS,
|
|
DEFAULT_PROFILE_HOME,
|
|
} from "./shared/constants.js";
|
|
import { execute } from "./server/execute.js";
|
|
import { testEnvironment } from "./server/test.js";
|
|
import { sessionCodec } from "./server/session-codec.js";
|
|
import { listSkills, syncSkills } from "./server/skills.js";
|
|
|
|
const AGENT_CONFIGURATION_DOC = `# DeepSeek (via Hermes) — Agent Configuration
|
|
|
|
DeepSeek-pinned variant of the Hermes adapter. Runs the local \`hermes\` CLI
|
|
with \`HERMES_HOME\` pointed at a DeepSeek profile (\`config.yaml\` declares
|
|
\`base_url=https://api.deepseek.com/v1\` and \`key_env=DEEPSEEK_API_KEY\`).
|
|
|
|
## Prerequisites
|
|
|
|
- Hermes Agent installed (\`pip install hermes-agent\`) — \`hermes --version\` works.
|
|
- DeepSeek profile dir exists (default: \`/home/chaim/.hermes/profiles/deepseek\`)
|
|
with \`config.yaml\` + \`.env\` (containing \`DEEPSEEK_API_KEY\`).
|
|
|
|
## Core Configuration
|
|
|
|
| Field | Type | Default | Description |
|
|
|-------|------|---------|-------------|
|
|
| model | string | \`deepseek-v4-pro\` | DeepSeek model id (\`deepseek-v4-pro\` or \`deepseek-v4-flash\`). |
|
|
| provider | string | \`custom\` | Hermes provider name. The DeepSeek profile defines \`provider: custom\` so \`custom\` is the right value. |
|
|
| hermesProfileHome | string | \`/home/chaim/.hermes/profiles/deepseek\` | Absolute path to a Hermes profile dir. Set per-agent if you maintain multiple DeepSeek profiles. |
|
|
| timeoutSec | number | 1800 | Execution timeout in seconds. |
|
|
| graceSec | number | 30 | SIGTERM grace period in seconds. |
|
|
|
|
## Tools / Workspace
|
|
|
|
| Field | Type | Default | Description |
|
|
|-------|------|---------|-------------|
|
|
| toolsets | string | (profile default) | Comma-separated toolsets to enable. |
|
|
| persistSession | boolean | true | Resume sessions across heartbeats via \`--resume\`. |
|
|
| worktreeMode | boolean | false | Use git worktree for isolated changes. |
|
|
| checkpoints | boolean | false | Enable filesystem checkpoints. |
|
|
|
|
## Advanced
|
|
|
|
| Field | Type | Default | Description |
|
|
|-------|------|---------|-------------|
|
|
| hermesCommand | string | \`hermes\` | Path to the hermes binary. |
|
|
| verbose | boolean | false | Enable verbose Hermes logs. |
|
|
| extraArgs | string[] | [] | Extra CLI args appended after standard flags. |
|
|
| env | object | {} | Extra environment variables passed to Hermes. \`HERMES_HOME\` here overrides \`hermesProfileHome\`. |
|
|
| promptTemplate | string | (default) | Override the default Paperclip wakeup prompt. |
|
|
| paperclipApiUrl | string | \`http://127.0.0.1:3100/api\` | Paperclip API URL injected into the prompt template. |
|
|
|
|
## Available template variables
|
|
|
|
\`{{agentId}}\`, \`{{agentName}}\`, \`{{companyId}}\`, \`{{companyName}}\`,
|
|
\`{{runId}}\`, \`{{taskId}}\`, \`{{taskTitle}}\`, \`{{taskBody}}\`,
|
|
\`{{commentId}}\`, \`{{wakeReason}}\`, \`{{projectName}}\`, \`{{paperclipApiUrl}}\`.
|
|
`;
|
|
|
|
export function createServerAdapter() {
|
|
return {
|
|
type: ADAPTER_TYPE,
|
|
label: ADAPTER_LABEL,
|
|
models: DEEPSEEK_MODELS,
|
|
agentConfigurationDoc: AGENT_CONFIGURATION_DOC,
|
|
|
|
execute,
|
|
testEnvironment,
|
|
sessionCodec,
|
|
listSkills,
|
|
syncSkills,
|
|
|
|
// Capability flags
|
|
supportsLocalAgentJwt: true,
|
|
supportsInstructionsBundle: false,
|
|
requiresMaterializedRuntimeSkills: false,
|
|
};
|
|
}
|
|
|
|
// Also export the loose constants for any caller that wants to inspect
|
|
// the package without invoking createServerAdapter (e.g., test harnesses).
|
|
export const type = ADAPTER_TYPE;
|
|
export const label = ADAPTER_LABEL;
|
|
export const models = DEEPSEEK_MODELS;
|
|
export const agentConfigurationDoc = AGENT_CONFIGURATION_DOC;
|
|
export const defaultProfileHome = DEFAULT_PROFILE_HOME;
|