@amykit/plugin-claude 0.6.0 → 0.7.1

package/README.md

@@ -4,13 +4,25 @@
 
 The claude CLI as the agent, over its JSON envelope.
 
-A plugin for [amy](https://github.com/nicolasmelo1/amy). It provides `claude` in the `harness` collection.
+A plugin for [amy](https://github.com/nicolasmelo1/amy). It provides `claude` in the `harness` collection and `Claude` in the `usage` collection.
+
+Use it when the agent should be Claude Code, run through the claude CLI. It contributes a harness and a usage reader to agent-relay instead of mounting the agent port itself, so install agent-relay with it, and list codex or hermes-agent too when the relay should have somewhere to fall back. Claude reports what each run cost, so a ceiling in money works without a row in the price table.
+
+## What it extends
+
+|  |  |
+| :-- | :-- |
+| Ports | _none_ |
+| Actions | _none_ |
+| Operations | _none_ |
+| Commands | _none_ |
+| Events | _none_ |
+| Environment | `CLAUDE_CODE_OAUTH_TOKEN` |
 
 ## Install
 
 ```sh
-# Add @amykit/plugin-claude to amy.yaml, then install configured plugins:
-amy init --install
+amy add @amykit/plugin-claude
 ```
 
 Then name it in `~/.amy/config.yaml`:
@@ -42,9 +54,17 @@ Every field is checked at boot against the schema this package declares. A key t
 not one of the above is a refusal naming the plugin and the key, not a setting that
 silently never applied.
 
+## Environment
+
+This package reads the following, which `amy doctor` checks for you:
+
+| Variable |  |
+| :-- | :-- |
+| `CLAUDE_CODE_OAUTH_TOKEN` | required at mount |
+
 ## Where the reasoning is
 
-- [Writing a plugin](https://github.com/nicolasmelo1/amy/tree/main/docs/build/write-a-plugin.md)
+- [Writing a plugin](https://github.com/nicolasmelo1/amy/tree/main/docs/guides/write-a-plugin.md)
 - [Reference: plugins](https://github.com/nicolasmelo1/amy/tree/main/docs/reference/plugins.md)
 - [Ports and the registry](https://github.com/nicolasmelo1/amy/tree/main/docs/concepts/ports.md)
 

package/dist/ClaudeHarness.d.ts

@@ -1,9 +1,32 @@
-import { CommandRunner, Harness, HarnessReply } from "@amykit/core";
+import { AskContext, CommandRunner, Harness, HarnessReply } from "@amykit/core";
 export interface ClaudeHarnessConfig {
     /** Passed to the CLI as --model. Omit to use whatever the CLI defaults to. */
     model?: string;
     timeoutMs?: number;
 }
+/**
+ * What keeps a run apart from the operator's own Claude.
+ *
+ * Without these a ticket run read the operator's personal CLAUDE.md, every
+ * skill they had installed, their hooks and plugins, and kept a session and
+ * an auto-memory under `~/.claude/projects`. The repository's own settings —
+ * `project` and `local` — still load: they belong to the code being worked
+ * on, not to the person running amy.
+ */
+export declare const ISOLATED: readonly ["--setting-sources", "project,local", "--strict-mcp-config", "--no-session-persistence"];
+/**
+ * Lends one skill to a run: a fresh directory whose `.claude/skills/<name>`
+ * links to where the skill is installed, for `--add-dir`.
+ *
+ * Dropping the user setting source drops `~/.claude/skills` with it, so the
+ * skill a step was addressed to is handed over by place, and nothing else of
+ * the operator's comes along. A skill whose directory is gone is not lent,
+ * and the run goes ahead without it.
+ */
+export declare function lend(tmpDir: string, skill: {
+    name: string;
+    path: string;
+}): string | undefined;
 /**
  * The `claude` CLI, and everything knowable about what a call to it took.
  *
@@ -14,9 +37,10 @@ export interface ClaudeHarnessConfig {
 export declare class ClaudeHarness implements Harness {
     private readonly runner;
     private readonly config;
+    private readonly tmpDir;
     readonly name = "claude";
-    constructor(runner: CommandRunner, config?: ClaudeHarnessConfig);
-    ask(prompt: string, cwd: string): Promise<HarnessReply>;
+    constructor(runner: CommandRunner, config?: ClaudeHarnessConfig, tmpDir?: string);
+    ask(prompt: string, cwd: string, context?: AskContext): Promise<HarnessReply>;
     /**
      * Turns a parsed run into the account the engine logs and the budget spends.
      *

package/dist/ClaudeHarness.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ClaudeHarness.d.ts","sourceRoot":"","sources":["../src/ClaudeHarness.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,aAAa,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAI9E,MAAM,WAAW,mBAAmB;IAClC,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,qBAAa,aAAc,YAAW,OAAO;IAIzC,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJzB,QAAQ,CAAC,IAAI,YAAY;gBAGN,MAAM,EAAE,aAAa,EACrB,MAAM,GAAE,mBAAwB;IAG7C,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAoB7D;;;;;;;OAOG;IACH,OAAO,CAAC,OAAO;CAuBhB"}
+{"version":3,"file":"ClaudeHarness.d.ts","sourceRoot":"","sources":["../src/ClaudeHarness.ts"],"names":[],"mappings":"AAGA,OAAO,EAAY,UAAU,EAAE,aAAa,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAI1F,MAAM,WAAW,mBAAmB;IAClC,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,QAAQ,oGAKX,CAAC;AAEX;;;;;;;;GAQG;AACH,wBAAgB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,GAAG,SAAS,CAW9F;AAED;;;;;;GAMG;AACH,qBAAa,aAAc,YAAW,OAAO;IAIzC,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IALzB,QAAQ,CAAC,IAAI,YAAY;gBAGN,MAAM,EAAE,aAAa,EACrB,MAAM,GAAE,mBAAwB,EAChC,MAAM,GAAE,MAAoB;IAGzC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,UAAe,GAAG,OAAO,CAAC,YAAY,CAAC;IA+BvF;;;;;;;OAOG;IACH,OAAO,CAAC,OAAO;CAuBhB"}

package/dist/ClaudeHarness.js

@@ -1,5 +1,44 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
 import { costOf, specFor } from "@amykit/model-specs";
 import { parseRun } from "./envelope.js";
+/**
+ * What keeps a run apart from the operator's own Claude.
+ *
+ * Without these a ticket run read the operator's personal CLAUDE.md, every
+ * skill they had installed, their hooks and plugins, and kept a session and
+ * an auto-memory under `~/.claude/projects`. The repository's own settings —
+ * `project` and `local` — still load: they belong to the code being worked
+ * on, not to the person running amy.
+ */
+export const ISOLATED = [
+    "--setting-sources",
+    "project,local",
+    "--strict-mcp-config",
+    "--no-session-persistence",
+];
+/**
+ * Lends one skill to a run: a fresh directory whose `.claude/skills/<name>`
+ * links to where the skill is installed, for `--add-dir`.
+ *
+ * Dropping the user setting source drops `~/.claude/skills` with it, so the
+ * skill a step was addressed to is handed over by place, and nothing else of
+ * the operator's comes along. A skill whose directory is gone is not lent,
+ * and the run goes ahead without it.
+ */
+export function lend(tmpDir, skill) {
+    // Absolute, since a link is read from where it lies: a relative skill root
+    // would otherwise point inside the lent directory and lend nothing.
+    const source = path.resolve(skill.path);
+    if (!fs.existsSync(path.join(source, "SKILL.md")))
+        return undefined;
+    const root = fs.mkdtempSync(path.join(tmpDir, "amy-claude-skill-"));
+    const skills = path.join(root, ".claude", "skills");
+    fs.mkdirSync(skills, { recursive: true });
+    fs.symlinkSync(source, path.join(skills, skill.name), "dir");
+    return root;
+}
 /**
  * The `claude` CLI, and everything knowable about what a call to it took.
  *
@@ -10,24 +49,40 @@ import { parseRun } from "./envelope.js";
 export class ClaudeHarness {
     runner;
     config;
+    tmpDir;
     name = "claude";
-    constructor(runner, config = {}) {
+    constructor(runner, config = {}, tmpDir = os.tmpdir()) {
         this.runner = runner;
         this.config = config;
+        this.tmpDir = tmpDir;
     }
-    async ask(prompt, cwd) {
+    async ask(prompt, cwd, context = {}) {
         const asked = this.config.model ?? "";
         const args = [];
         if (this.config.model) {
             args.push("--model", this.config.model);
         }
+        // Plan mode reads and does not edit or run anything, enforced by the CLI.
+        if (context.readOnly)
+            args.push("--permission-mode", "plan");
+        args.push(...ISOLATED);
+        const lent = context.skill ? lend(this.tmpDir, context.skill) : undefined;
+        if (lent)
+            args.push("--add-dir", lent);
         args.push("--output-format", "json", "-p");
         const started = Date.now();
-        const result = await this.runner.run("claude", args, {
-            cwd,
-            stdin: prompt,
-            timeoutMs: this.config.timeoutMs,
-        });
+        let result;
+        try {
+            result = await this.runner.run("claude", args, {
+                cwd,
+                stdin: prompt,
+                timeoutMs: this.config.timeoutMs,
+            });
+        }
+        finally {
+            if (lent)
+                fs.rmSync(lent, { recursive: true, force: true });
+        }
         const elapsed = Date.now() - started;
         const parsed = parseRun(result.stdout, result.ok, asked);
         return { text: parsed.text, run: this.account(parsed, elapsed, result.stderr) };

package/dist/ClaudeHarness.js.map

@@ -1 +1 @@
-{"version":3,"file":"ClaudeHarness.js","sourceRoot":"","sources":["../src/ClaudeHarness.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAa,QAAQ,EAAE,MAAM,eAAe,CAAC;AAQpD;;;;;;GAMG;AACH,MAAM,OAAO,aAAa;IAIL;IACA;IAJV,IAAI,GAAG,QAAQ,CAAC;IAEzB,YACmB,MAAqB,EACrB,SAA8B,EAAE;QADhC,WAAM,GAAN,MAAM,CAAe;QACrB,WAAM,GAAN,MAAM,CAA0B;IAChD,CAAC;IAEJ,KAAK,CAAC,GAAG,CAAC,MAAc,EAAE,GAAW;QACnC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;QACtC,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YACtB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC1C,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;QAE3C,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE;YACnD,GAAG;YACH,KAAK,EAAE,MAAM;YACb,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;SACjC,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC;QAErC,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QACzD,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;IAClF,CAAC;IAED;;;;;;;OAOG;IACK,OAAO,CAAC,MAAiB,EAAE,SAAiB,EAAE,MAAc;QAClE,IAAI,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC7B,IAAI,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;QAEnC,IAAI,OAAO,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAC3C,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACnC,IAAI,IAAI,EAAE,CAAC;gBACT,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;gBACtC,UAAU,GAAG,UAAU,CAAC;YAC1B,CAAC;QACH,CAAC;QAED,OAAO;YACL,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,OAAO,EAAE,IAAI,CAAC,IAAI;YAClB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,OAAO;YACP,UAAU;YACV,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,SAAS;YAC1C,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE;SAChE,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"ClaudeHarness.js","sourceRoot":"","sources":["../src/ClaudeHarness.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAa,QAAQ,EAAE,MAAM,eAAe,CAAC;AAQpD;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,mBAAmB;IACnB,eAAe;IACf,qBAAqB;IACrB,0BAA0B;CAClB,CAAC;AAEX;;;;;;;;GAQG;AACH,MAAM,UAAU,IAAI,CAAC,MAAc,EAAE,KAAqC;IACxE,2EAA2E;IAC3E,oEAAoE;IACpE,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IAEpE,MAAM,IAAI,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC;IACpE,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IACpD,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,EAAE,CAAC,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;IAC7D,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,OAAO,aAAa;IAIL;IACA;IACA;IALV,IAAI,GAAG,QAAQ,CAAC;IAEzB,YACmB,MAAqB,EACrB,SAA8B,EAAE,EAChC,SAAiB,EAAE,CAAC,MAAM,EAAE;QAF5B,WAAM,GAAN,MAAM,CAAe;QACrB,WAAM,GAAN,MAAM,CAA0B;QAChC,WAAM,GAAN,MAAM,CAAsB;IAC5C,CAAC;IAEJ,KAAK,CAAC,GAAG,CAAC,MAAc,EAAE,GAAW,EAAE,UAAsB,EAAE;QAC7D,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;QACtC,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YACtB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC1C,CAAC;QACD,0EAA0E;QAC1E,IAAI,OAAO,CAAC,QAAQ;YAAE,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC;QAC7D,IAAI,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC;QAEvB,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC1E,IAAI,IAAI;YAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;QAE3C,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC3B,IAAI,MAAiD,CAAC;QACtD,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE;gBAC7C,GAAG;gBACH,KAAK,EAAE,MAAM;gBACb,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;aACjC,CAAC,CAAC;QACL,CAAC;gBAAS,CAAC;YACT,IAAI,IAAI;gBAAE,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9D,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC;QAErC,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QACzD,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;IAClF,CAAC;IAED;;;;;;;OAOG;IACK,OAAO,CAAC,MAAiB,EAAE,SAAiB,EAAE,MAAc;QAClE,IAAI,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC7B,IAAI,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;QAEnC,IAAI,OAAO,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAC3C,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACnC,IAAI,IAAI,EAAE,CAAC;gBACT,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;gBACtC,UAAU,GAAG,UAAU,CAAC;YAC1B,CAAC;QACH,CAAC;QAED,OAAO;YACL,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,OAAO,EAAE,IAAI,CAAC,IAAI;YAClB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,OAAO;YACP,UAAU;YACV,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,SAAS;YAC1C,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE;SAChE,CAAC;IACJ,CAAC;CACF"}

package/dist/config.d.ts

@@ -1,4 +1,19 @@
-import { ConfigSchema } from "@amykit/core";
 /** What this plugin needs told to it, and nothing more. */
-export declare const configSchema: ConfigSchema;
+export declare const configSchema: {
+    model: {
+        type: "string";
+        description: string;
+        default: string;
+    };
+    models: {
+        type: "string[]";
+        description: string;
+        default: never[];
+    };
+    timeoutMs: {
+        type: "number";
+        description: string;
+        default: number;
+    };
+};
 //# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,2DAA2D;AAC3D,eAAO,MAAM,YAAY,EAAE,YAiB1B,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,2DAA2D;AAC3D,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;CAiBD,CAAC"}

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,2DAA2D;AAC3D,MAAM,CAAC,MAAM,YAAY,GAAiB;IACxC,KAAK,EAAE;QACL,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,4DAA4D;QACzE,OAAO,EAAE,EAAE;KACZ;IACD,MAAM,EAAE;QACN,IAAI,EAAE,UAAU;QAChB,WAAW,EACT,yJAAyJ;QAC3J,OAAO,EAAE,EAAE;KACZ;IACD,SAAS,EAAE;QACT,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,0DAA0D;QACvE,OAAO,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI;KACxB;CACF,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,2DAA2D;AAC3D,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,KAAK,EAAE;QACL,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,4DAA4D;QACzE,OAAO,EAAE,EAAE;KACZ;IACD,MAAM,EAAE;QACN,IAAI,EAAE,UAAU;QAChB,WAAW,EACT,yJAAyJ;QAC3J,OAAO,EAAE,EAAE;KACZ;IACD,SAAS,EAAE;QACT,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,0DAA0D;QACvE,OAAO,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI;KACxB;CACqB,CAAC"}

package/dist/index.d.ts

@@ -1,7 +1,9 @@
-export { ClaudeHarness } from "./ClaudeHarness.js";
+export { ClaudeHarness, ISOLATED, lend } from "./ClaudeHarness.js";
 export type { ClaudeHarnessConfig } from "./ClaudeHarness.js";
 export { classify, modelOf, parseEnvelope, parseRun, tokensOf } from "./envelope.js";
 export type { ClaudeEnvelope, ParsedRun } from "./envelope.js";
 export { configSchema } from "./config.js";
 export { plugin } from "./plugin.js";
+export { ClaudeUsageReader, parseClaudeUsage } from "./usage.js";
+export type { ClaudeUsageReaderOptions } from "./usage.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACrF,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AACnE,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACrF,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACjE,YAAY,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,5 +1,6 @@
-export { ClaudeHarness } from "./ClaudeHarness.js";
+export { ClaudeHarness, ISOLATED, lend } from "./ClaudeHarness.js";
 export { classify, modelOf, parseEnvelope, parseRun, tokensOf } from "./envelope.js";
 export { configSchema } from "./config.js";
 export { plugin } from "./plugin.js";
+export { ClaudeUsageReader, parseClaudeUsage } from "./usage.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAErF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAEnE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAErF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/plugin.d.ts

@@ -1,3 +1,2 @@
-import { Plugin } from "@amykit/core";
-export declare const plugin: Plugin;
+export declare const plugin: import("@amykit/core").Plugin;
 //# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAKtC,eAAO,MAAM,MAAM,EAAE,MAwBpB,CAAC"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,MAAM,+BAwBjB,CAAC"}

package/dist/plugin.js

@@ -1,9 +1,10 @@
-import { contributeTiers } from "@amykit/agent-kit";
+import { definePlugin } from "@amykit/core";
+import { contributeTiers, contributeUsage } from "@amykit/agent-kit";
 import { ClaudeHarness } from "./ClaudeHarness.js";
 import { configSchema } from "./config.js";
-export const plugin = {
+import { ClaudeUsageReader } from "./usage.js";
+export const plugin = definePlugin({
     name: "@amykit/plugin-claude",
-    version: "0.1.0",
     configSchema,
     register(registry, ctx) {
         const tiers = ctx.config.models;
@@ -16,12 +17,13 @@ export const plugin = {
             // reported beats anything a table could work out, so a missing row
             // never leaves a ceiling in money with nothing to spend against it.
             pricesItsOwnRuns: true,
-            models: tiers.length > 0 ? tiers : [ctx.config.model || ""],
+            models: tiers.length > 0 ? tiers : [(ctx.config.model) || ""],
             make: (model) => new ClaudeHarness(ctx.runner, {
                 model: model || undefined,
                 timeoutMs: ctx.config.timeoutMs,
             }),
         });
+        contributeUsage(registry, new ClaudeUsageReader(ctx.runner, { timeoutMs: ctx.config.timeoutMs }));
     },
-};
+});
 //# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,CAAC,MAAM,MAAM,GAAW;IAC5B,IAAI,EAAE,uBAAuB;IAC7B,OAAO,EAAE,OAAO;IAChB,YAAY;IACZ,QAAQ,CAAC,QAAQ,EAAE,GAAG;QACpB,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,MAAkB,CAAC;QAE5C,uEAAuE;QACvE,yEAAyE;QACzE,0EAA0E;QAC1E,eAAe,CAAC,QAAQ,EAAE;YACxB,OAAO,EAAE,QAAQ;YACjB,gEAAgE;YAChE,mEAAmE;YACnE,oEAAoE;YACpE,gBAAgB,EAAE,IAAI;YACtB,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAE,GAAG,CAAC,MAAM,CAAC,KAAgB,IAAI,EAAE,CAAC;YACvE,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CACd,IAAI,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE;gBAC5B,KAAK,EAAE,KAAK,IAAI,SAAS;gBACzB,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,SAAmB;aAC1C,CAAC;SACL,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,CAAC,MAAM,MAAM,GAAG,YAAY,CAAsB;IACtD,IAAI,EAAE,uBAAuB;IAC7B,YAAY;IACZ,QAAQ,CAAC,QAAQ,EAAE,GAAG;QACpB,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC;QAEhC,uEAAuE;QACvE,yEAAyE;QACzE,0EAA0E;QAC1E,eAAe,CAAC,QAAQ,EAAE;YACxB,OAAO,EAAE,QAAQ;YACjB,gEAAgE;YAChE,mEAAmE;YACnE,oEAAoE;YACpE,gBAAgB,EAAE,IAAI;YACtB,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YAC7D,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CACd,IAAI,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE;gBAC5B,KAAK,EAAE,KAAK,IAAI,SAAS;gBACzB,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS;aAChC,CAAC;SACL,CAAC,CAAC;QACH,eAAe,CAAC,QAAQ,EAAE,IAAI,iBAAiB,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;IACpG,CAAC;CACF,CAAC,CAAC"}

package/dist/usage.d.ts

@@ -0,0 +1,23 @@
+import { CommandRunner } from "@amykit/core";
+import type { UsageReader, UsageResult } from "@amykit/agent-kit";
+export interface ClaudeUsageReaderOptions {
+    readonly timeoutMs?: number;
+    readonly token?: () => string | undefined;
+    /** Where Claude Code keeps its login off macOS; a test points it elsewhere. */
+    readonly credentialsFile?: string;
+    /** The platform whose credential store is asked; macOS also has the Keychain. */
+    readonly platform?: NodeJS.Platform;
+}
+/** Reads Claude's account windows without asking Claude to run an agent turn. */
+export declare class ClaudeUsageReader implements UsageReader {
+    private readonly runner;
+    private readonly options;
+    readonly label = "Claude";
+    constructor(runner: CommandRunner, options?: ClaudeUsageReaderOptions);
+    read(): Promise<UsageResult>;
+    /** The login Claude Code keeps: the environment, its credentials file, then on macOS the Keychain. */
+    private oauthToken;
+}
+/** Normalizes the account endpoint's percentage measurements. */
+export declare function parseClaudeUsage(json: string): UsageResult;
+//# sourceMappingURL=usage.d.ts.map

package/dist/usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../src/usage.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAYlE,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IAC1C,+EAA+E;IAC/E,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,iFAAiF;IACjF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;CACrC;AAKD,iFAAiF;AACjF,qBAAa,iBAAkB,YAAW,WAAW;IAIjD,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJ1B,QAAQ,CAAC,KAAK,YAAY;gBAGP,MAAM,EAAE,aAAa,EACrB,OAAO,GAAE,wBAA6B;IAGnD,IAAI,IAAI,OAAO,CAAC,WAAW,CAAC;IAsBlC,sGAAsG;YACxF,UAAU;CAazB;AAED,iEAAiE;AACjE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAc1D"}

package/dist/usage.js

@@ -0,0 +1,92 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+/** The Keychain item Claude Code writes its login to on macOS. */
+const KEYCHAIN_SERVICE = "Claude Code-credentials";
+/** Reads Claude's account windows without asking Claude to run an agent turn. */
+export class ClaudeUsageReader {
+    runner;
+    options;
+    label = "Claude";
+    constructor(runner, options = {}) {
+        this.runner = runner;
+        this.options = options;
+    }
+    async read() {
+        const token = this.options.token?.() ?? (await this.oauthToken());
+        if (!token)
+            return { unavailable: "Claude usage is unavailable: no OAuth token is configured" };
+        try {
+            const result = await this.runner.run("curl", ["--disable", "--fail", "--silent", "--show-error", "--config", "-", "https://api.anthropic.com/api/oauth/usage"], {
+                // A curl config on stdin keeps the bearer token out of argv and process listings.
+                // The endpoint refuses an OAuth bearer without the beta that enables it.
+                stdin: `header = "Authorization: Bearer ${token}"\nheader = "anthropic-beta: oauth-2025-04-20"\n`,
+                timeoutMs: this.options.timeoutMs,
+            });
+            if (!result.ok)
+                return { unavailable: "Claude usage is unavailable" };
+            return parseClaudeUsage(result.stdout);
+        }
+        catch {
+            return { unavailable: "Claude usage is unavailable" };
+        }
+    }
+    /** The login Claude Code keeps: the environment, its credentials file, then on macOS the Keychain. */
+    async oauthToken() {
+        if (process.env.CLAUDE_CODE_OAUTH_TOKEN)
+            return process.env.CLAUDE_CODE_OAUTH_TOKEN;
+        const file = this.options.credentialsFile ?? path.join(os.homedir(), ".claude", ".credentials.json");
+        const stored = readCredentials(() => fs.readFileSync(file, "utf8"));
+        if (stored || (this.options.platform ?? process.platform) !== "darwin")
+            return stored;
+        try {
+            // Read-only: prints the item's secret, the same JSON the file holds elsewhere.
+            const result = await this.runner.run("security", ["find-generic-password", "-s", KEYCHAIN_SERVICE, "-w"], { timeoutMs: this.options.timeoutMs });
+            return result.ok ? readCredentials(() => result.stdout) : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
+}
+/** Normalizes the account endpoint's percentage measurements. */
+export function parseClaudeUsage(json) {
+    let document;
+    try {
+        const parsed = JSON.parse(json);
+        if (typeof parsed === "object" && parsed !== null && !Array.isArray(parsed))
+            document = parsed;
+    }
+    catch {
+        return { unavailable: "Claude usage returned invalid JSON" };
+    }
+    if (!document)
+        return { unavailable: "Claude usage returned invalid JSON" };
+    const windows = [
+        windowOf("five-hour", document.five_hour),
+        windowOf("seven-day", document.seven_day),
+    ].flatMap((window) => window ? [window] : []);
+    return windows.length > 0 ? { windows } : { unavailable: "Claude usage returned no measured windows" };
+}
+function windowOf(label, period) {
+    if (!period || typeof period.utilization !== "number" || !Number.isFinite(period.utilization))
+        return undefined;
+    const resetsAt = typeof period.resets_at === "string" && !Number.isNaN(Date.parse(period.resets_at))
+        ? period.resets_at
+        : undefined;
+    return {
+        label,
+        usedPercent: Math.max(0, Math.min(100, period.utilization)),
+        ...(resetsAt ? { resetsAt } : {}),
+    };
+}
+function readCredentials(read) {
+    try {
+        const credentials = JSON.parse(read());
+        return typeof credentials.claudeAiOauth?.accessToken === "string" ? credentials.claudeAiOauth.accessToken : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=usage.js.map

package/dist/usage.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amykit/plugin-claude",
-  "version": "0.6.0",
+  "version": "0.7.1",
   "description": "The claude CLI as the agent, over its JSON envelope.",
   "type": "module",
   "license": "MIT",
@@ -27,10 +27,13 @@
   "files": [
     "dist"
   ],
+  "amy": {
+    "about": "Use it when the agent should be Claude Code, run through the claude CLI. It contributes a harness and a usage reader to agent-relay instead of mounting the agent port itself, so install agent-relay with it, and list codex or hermes-agent too when the relay should have somewhere to fall back. Claude reports what each run cost, so a ceiling in money works without a row in the price table."
+  },
   "dependencies": {
-    "@amykit/agent-kit": "^0.6.0",
-    "@amykit/core": "^0.6.0",
-    "@amykit/model-specs": "^0.6.0"
+    "@amykit/agent-kit": "^0.7.1",
+    "@amykit/core": "^0.7.1",
+    "@amykit/model-specs": "^0.7.1"
   },
   "devDependencies": {
     "@amykit/test-fixtures": "^0.1.0"