@jinn-network/client 0.1.2 → 0.1.3-canary.2d6b2676

package/dist/harnesses/impls/claude-code-learner/plugin-path.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Resolve the claude-code-learner plugin root from the impl directory's
+ * runtime location.
+ *
+ * Layout assumption: this file lives at
+ *   <package>/<src-or-dist>/harnesses/impls/claude-code-learner/plugin-path.{ts,js}
+ * and the plugin lives at
+ *   <package>/plugins/claude-code-learner/
+ *
+ * Walks up four directories from this file (impls → harness → src/dist →
+ * package root) then descends into plugins/claude-code-learner/. Verifies the
+ * expected layout exists and throws with a clear message if not.
+ */
+export declare function resolvePluginRoot(): string;

package/dist/harnesses/impls/claude-code-learner/plugin-path.js

@@ -0,0 +1,30 @@
+import { existsSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+/**
+ * Resolve the claude-code-learner plugin root from the impl directory's
+ * runtime location.
+ *
+ * Layout assumption: this file lives at
+ *   <package>/<src-or-dist>/harnesses/impls/claude-code-learner/plugin-path.{ts,js}
+ * and the plugin lives at
+ *   <package>/plugins/claude-code-learner/
+ *
+ * Walks up four directories from this file (impls → harness → src/dist →
+ * package root) then descends into plugins/claude-code-learner/. Verifies the
+ * expected layout exists and throws with a clear message if not.
+ */
+export function resolvePluginRoot() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    const packageRoot = resolve(here, '..', '..', '..', '..');
+    const pluginRoot = join(packageRoot, 'plugins', 'claude-code-learner');
+    if (!existsSync(pluginRoot)) {
+        throw new Error(`claude-code-learner plugin not found at expected path: ${pluginRoot}. ` +
+            `Resolved from impl dir: ${here}.`);
+    }
+    if (!existsSync(join(pluginRoot, 'skills', 'coordinator', 'SKILL.md'))) {
+        throw new Error(`claude-code-learner plugin at ${pluginRoot} is missing skills/coordinator/SKILL.md`);
+    }
+    return pluginRoot;
+}
+//# sourceMappingURL=plugin-path.js.map

package/dist/harnesses/impls/claude-code-learner/plugin-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-path.js","sourceRoot":"","sources":["../../../../src/harnesses/impls/claude-code-learner/plugin-path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC1D,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,qBAAqB,CAAC,CAAC;IAEvE,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CACb,0DAA0D,UAAU,IAAI;YACtE,2BAA2B,IAAI,GAAG,CACrC,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,EAAE,aAAa,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC;QACvE,MAAM,IAAI,KAAK,CACb,iCAAiC,UAAU,yCAAyC,CACrF,CAAC;IACJ,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/harnesses/impls/claude-code-learner/test-utils/fake-plugin-outputs.d.ts

@@ -0,0 +1,19 @@
+export declare function fakeOrientSummary(workingDir: string, taskId: string, solverType: string): void;
+export declare function fakeStrategy(workingDir: string, posture: 'early-return' | 'hold-and-revise' | 'continuous-observation'): void;
+export declare function fakePlan(workingDir: string, stepCount: number): void;
+export declare function fakeExecuteSummary(workingDir: string, opts?: {
+    stepsCompleted?: string[];
+    stepsFailed?: string[];
+    returnReason?: string;
+    elapsedMs?: number;
+}): void;
+export declare function fakeDebriefAnalysis(workingDir: string, verdict: 'yes' | 'no' | 'partial'): void;
+export declare function fakeImproveSummary(workingDir: string): void;
+export declare function fakeMemoryConsolidationRecord(workingDir: string): void;
+/** Convenience: write all seven happy-path phase artifacts. */
+export declare function fakeFullPipelineRun(workingDir: string, opts?: {
+    taskId?: string;
+    solverType?: string;
+    posture?: 'early-return' | 'hold-and-revise' | 'continuous-observation';
+    verdict?: 'yes' | 'no' | 'partial';
+}): void;

package/dist/harnesses/impls/claude-code-learner/test-utils/fake-plugin-outputs.js

@@ -0,0 +1,111 @@
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * Helpers to seed workingDir with realistic plugin artifacts so tests
+ * can exercise the shim's harvest + lifecycle logic without spawning a
+ * real harness.
+ *
+ * Each function writes one phase's output. The shapes match what the
+ * plugin (Plan 1) writes per its skill/agent contracts.
+ */
+function writeJson(path, payload) {
+    const dir = path.substring(0, path.lastIndexOf('/'));
+    mkdirSync(dir, { recursive: true });
+    writeFileSync(path, JSON.stringify(payload, null, 2));
+}
+export function fakeOrientSummary(workingDir, taskId, solverType) {
+    writeJson(join(workingDir, '.orient', 'summary.json'), {
+        task: { id: taskId, solverType, window: { startTs: 0, endTs: 0 } },
+        topics: [
+            { topic: 'task-parse', artifact: 'workingDir/.orient/task-parse.json', summary: 'parsed', flags: [] },
+        ],
+        openQuestions: [],
+    });
+}
+export function fakeStrategy(workingDir, posture) {
+    writeJson(join(workingDir, '.strategize', 'strategy.json'), {
+        approach: 'fake-approach',
+        rationale: 'test',
+        successCriteria: 'fake passes if test passes',
+        timingPosture: posture,
+        constraints: [],
+        rejectedAlternatives: [],
+    });
+    writeJson(join(workingDir, '.strategize', 'constitution.json'), {
+        successCriteriaCid: 'sha256:fake',
+        timingPosture: posture,
+        skillBundleCid: 'sha256:fake',
+        implStateDirSha: 'fakeSha',
+        editableScope: [`${workingDir}/**`],
+    });
+}
+export function fakePlan(workingDir, stepCount) {
+    writeJson(join(workingDir, '.plan', 'plan.json'), {
+        successCriteria: 'fake passes if test passes',
+        timingPosture: 'early-return',
+        steps: Array.from({ length: stepCount }, (_, i) => ({
+            id: `step-${i + 1}`,
+            kind: 'work',
+            concurrency: 'sequential',
+            description: `fake step ${i + 1}`,
+            inputs: {},
+            toolsNeeded: [],
+            expectedOutputs: [],
+            successSignal: 'always',
+            abortCondition: 'never',
+        })),
+    });
+}
+export function fakeExecuteSummary(workingDir, opts = {}) {
+    writeJson(join(workingDir, '.execute', 'summary.json'), {
+        stepsCompleted: opts.stepsCompleted ?? ['step-1'],
+        stepsFailed: opts.stepsFailed ?? [],
+        decisions: [],
+        elapsedMs: opts.elapsedMs ?? 0,
+        returnReason: opts.returnReason ?? 'all-steps-completed',
+    });
+}
+export function fakeDebriefAnalysis(workingDir, verdict) {
+    writeJson(join(workingDir, '.debrief', 'analysis.json'), {
+        successCriteriaMet: verdict,
+        successCriteriaShortfall: verdict === 'yes' ? null : 'fake shortfall',
+        divergencesFromPlan: [],
+        crossOperatorSignals: [],
+        trend: { kind: 'fake', lastNRuns: 0, passRate: 1, direction: 'flat', notableFailureShapes: [] },
+        recommendationsForImprove: [],
+    });
+}
+export function fakeImproveSummary(workingDir) {
+    writeJson(join(workingDir, '.improve', 'summary.json'), {
+        implStateDirShaBefore: 'fakeShaBefore',
+        implStateDirShaAfter: 'fakeShaBefore',
+        changesAccepted: 0,
+        changesRejected: 0,
+        operatorRequests: 0,
+        rejectionsRationale: [],
+    });
+}
+export function fakeMemoryConsolidationRecord(workingDir) {
+    writeJson(join(workingDir, '.memory-consolidation', 'consolidation_record.json'), {
+        ts: Date.now(),
+        implStateDirShaBefore: 'fakeShaBefore',
+        implStateDirShaAfter: 'fakeShaBefore',
+        durable: { skillsArchived: [], promotionsReverted: [], notesCompacted: 0, conflictsResolved: [] },
+        ephemeral: { movedToPrivate: [], migratedToImplState: [] },
+    });
+}
+/** Convenience: write all seven happy-path phase artifacts. */
+export function fakeFullPipelineRun(workingDir, opts = {}) {
+    const taskId = opts.taskId ?? 'fake-task';
+    const solverType = opts.solverType ?? 'fake.solver';
+    const posture = opts.posture ?? 'early-return';
+    const verdict = opts.verdict ?? 'yes';
+    fakeOrientSummary(workingDir, taskId, solverType);
+    fakeStrategy(workingDir, posture);
+    fakePlan(workingDir, 1);
+    fakeExecuteSummary(workingDir);
+    fakeDebriefAnalysis(workingDir, verdict);
+    fakeImproveSummary(workingDir);
+    fakeMemoryConsolidationRecord(workingDir);
+}
+//# sourceMappingURL=fake-plugin-outputs.js.map

package/dist/harnesses/impls/claude-code-learner/test-utils/fake-plugin-outputs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake-plugin-outputs.js","sourceRoot":"","sources":["../../../../../src/harnesses/impls/claude-code-learner/test-utils/fake-plugin-outputs.ts"],"names":[],"mappings":"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"}

package/dist/harnesses/impls/claude-code-learner/test-utils/noop-adapter.d.ts

@@ -0,0 +1,22 @@
+import type { HarnessAdapter, TaskSessionInputs } from '../types.js';
+export type NoOpRunHandler = (inputs: TaskSessionInputs, pluginRoot: string) => void | Promise<void>;
+/**
+ * Test-only HarnessAdapter. By default, a runTask call simulates a
+ * full happy-path pipeline by writing all seven phase artifacts to
+ * inputs.workingDir. Tests can override via .on() to inject failures,
+ * partial completion, etc.
+ */
+export declare class NoOpHarnessAdapter implements HarnessAdapter {
+    readonly name = "noop";
+    readonly allowsHarnessSelfModification = false;
+    private handler;
+    private invocations;
+    /** Override the default happy-path simulation. */
+    on(handler: NoOpRunHandler): this;
+    /** Inspect what runTask was called with — useful for assertions. */
+    getInvocations(): ReadonlyArray<{
+        inputs: TaskSessionInputs;
+        pluginRoot: string;
+    }>;
+    runTask(inputs: TaskSessionInputs, pluginRoot: string): Promise<void>;
+}

package/dist/harnesses/impls/claude-code-learner/test-utils/noop-adapter.js

@@ -0,0 +1,35 @@
+import { fakeFullPipelineRun } from './fake-plugin-outputs.js';
+/**
+ * Test-only HarnessAdapter. By default, a runTask call simulates a
+ * full happy-path pipeline by writing all seven phase artifacts to
+ * inputs.workingDir. Tests can override via .on() to inject failures,
+ * partial completion, etc.
+ */
+export class NoOpHarnessAdapter {
+    name = 'noop';
+    allowsHarnessSelfModification = false;
+    handler = null;
+    invocations = [];
+    /** Override the default happy-path simulation. */
+    on(handler) {
+        this.handler = handler;
+        return this;
+    }
+    /** Inspect what runTask was called with — useful for assertions. */
+    getInvocations() {
+        return this.invocations;
+    }
+    async runTask(inputs, pluginRoot) {
+        this.invocations.push({ inputs, pluginRoot });
+        if (this.handler) {
+            await this.handler(inputs, pluginRoot);
+        }
+        else {
+            fakeFullPipelineRun(inputs.workingDir, {
+                taskId: inputs.taskId,
+                solverType: inputs.solverType ?? 'unknown',
+            });
+        }
+    }
+}
+//# sourceMappingURL=noop-adapter.js.map

package/dist/harnesses/impls/claude-code-learner/test-utils/noop-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop-adapter.js","sourceRoot":"","sources":["../../../../../src/harnesses/impls/claude-code-learner/test-utils/noop-adapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAI/D;;;;;GAKG;AACH,MAAM,OAAO,kBAAkB;IACpB,IAAI,GAAG,MAAM,CAAC;IACd,6BAA6B,GAAG,KAAK,CAAC;IAEvC,OAAO,GAA0B,IAAI,CAAC;IACtC,WAAW,GAA6D,EAAE,CAAC;IAEnF,kDAAkD;IAClD,EAAE,CAAC,OAAuB;QACxB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,oEAAoE;IACpE,cAAc;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,MAAyB,EAAE,UAAkB;QACzD,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;QAC9C,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QACzC,CAAC;aAAM,CAAC;YACN,mBAAmB,CAAC,MAAM,CAAC,UAAU,EAAE;gBACrC,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,SAAS;aAC3C,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF"}

package/dist/harnesses/impls/claude-code-learner/types.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Typed allowlist of env keys the learner may inject into the harness child
+ * process. Adding a new key requires an explicit update here.
+ */
+export type KnownAdapterEnvKey = 'JINN_CLAUDE_CODE_LEARNER_PHASE_RANGE';
+/**
+ * Inputs the shim derives from HarnessContext and hands to the
+ * harness adapter. The adapter then constructs a session prompt + env
+ * for the underlying CLI / runtime.
+ */
+export interface TaskSessionInputs {
+    /** Task id from ctx.task.id */
+    taskId: string;
+    /** IPFS CID of the full Task payload (if known) for provenance */
+    taskCid?: string;
+    /** SolverType (e.g. 'portfolio.v0', 'prediction.v0') */
+    solverType?: string;
+    /** Operator-private impl-state directory; passed to the plugin via env IMPL_STATE_DIR */
+    implStateDir: string;
+    /** Ephemeral workingDir for this attempt */
+    workingDir: string;
+    /** Additional SolverPlugin package roots to pass through host plugin loading. */
+    pluginRoots?: string[];
+    /** Window timestamps (ms since epoch) */
+    windowStartTs: number;
+    windowEndTs: number;
+    /** Remaining ms in the window at adapter-invocation time */
+    msUntilEndTs: number;
+    /** Aborted when window.endTs fires */
+    abort: AbortSignal;
+    /**
+     * Full Task body from ctx.task. Passed verbatim into the initial prompt
+     * so the coordinator skill does not need to read workingDir/task.json.
+     * Includes description, solverType, spec, role, eligibility, and window.
+     */
+    taskBody?: {
+        id?: string;
+        description?: string;
+        solverType?: string;
+        spec?: Record<string, unknown>;
+        role?: string;
+        eligibility?: Record<string, unknown>;
+        window?: {
+            startTs: number;
+            endTs: number;
+        };
+        [key: string]: unknown;
+    };
+    /**
+     * Optional env vars the adapter should propagate to the harness child
+     * process IN ADDITION to its own ENV_ALLOWLIST. Used to thread
+     * phase-range hints (e.g. JINN_CLAUDE_CODE_LEARNER_PHASE_RANGE) to
+     * the coordinator skill running inside the spawned harness.
+     *
+     * Restricted to the {@link KnownAdapterEnvKey} allowlist. Pass-through only;
+     * adapters must not silently drop these.
+     */
+    adapterEnv?: Partial<Record<KnownAdapterEnvKey, string>>;
+}
+/**
+ * Adapter contract: launch the underlying agent harness with the
+ * claude-code-learner plugin loaded and the task context set up. Block
+ * until the harness exits cleanly or the abort signal fires.
+ *
+ * The adapter does NOT harvest outputs — that's the shim's job afterwards.
+ */
+export interface HarnessAdapter {
+    /** Adapter name for logs / spans (e.g. 'claude-code', 'noop'). */
+    readonly name: string;
+    /**
+     * Whether this adapter permits the plugin's Improve phase to patch
+     * harness install code (e.g. Pi.dev). Always false for closed harnesses.
+     */
+    readonly allowsHarnessSelfModification: boolean;
+    /**
+     * Run one claude-code-learner session. The adapter is responsible for:
+     * - Loading the plugin into the harness's skill/plugin directory (or
+     *   pointing the harness at it via flags).
+     * - Setting IMPL_STATE_DIR in the harness's env so the session-start
+     *   hook fires.
+     * - Constructing the initial prompt that invokes the `coordinator` skill
+     *   with the task + paths.
+     * - Blocking until the harness session exits or `inputs.abort` fires.
+     */
+    runTask(inputs: TaskSessionInputs, pluginRoot: string): Promise<void>;
+}
+/** Shim construction config. */
+export interface ClaudeCodeLearnerConfig {
+    /** Harness adapter (NoOp for tests; Claude Code adapter for production). */
+    adapter: HarnessAdapter;
+    /** Optional override for the impl name (defaults to 'claude-code-learner'). */
+    name?: string;
+    /** Semver string for envelope provenance (defaults to '0.1.0-shim'). */
+    version?: string;
+    /**
+     * Optional override for plugin root resolution. When unset, resolved from
+     * the impl directory via `plugin-path.ts`. Tests may override.
+     */
+    pluginRoot?: string;
+    /** SolverPlugin roots loaded by the daemon. */
+    solverPluginRoots?: string[];
+}

package/dist/harnesses/impls/claude-code-learner/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/harnesses/impls/claude-code-learner/types.ts"],"names":[],"mappings":""}

package/dist/{restorer → harnesses}/impls/claude-mcp-hyperliquid/api-wallet.d.ts

@@ -41,7 +41,7 @@ export interface ApiWalletState {
     /**
      * The HL master that approved this agent, captured during the operator's
      * approve-agent setup. When present, the impl cross-checks this against
-     * the intent's `spec.account.masterAddress` on every run — if they
+     * the task's `spec.account.masterAddress` on every run — if they
      * disagree, it aborts with `E_MASTER_MISMATCH` rather than silently
      * routing trades to the wrong master.
      */

package/dist/harnesses/impls/claude-mcp-hyperliquid/api-wallet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-wallet.js","sourceRoot":"","sources":["../../../../src/harnesses/impls/claude-mcp-hyperliquid/api-wallet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAyBpD,kFAAkF;AAElF,MAAM,UAAU,eAAe,CAAC,YAAoB;IAClD,OAAO,IAAI,CAAC,YAAY,EAAE,iBAAiB,CAAC,CAAC;AAC/C,CAAC;AAED,kFAAkF;AAElF,MAAM,UAAU,kBAAkB,CAAC,YAAoB;IACrD,MAAM,IAAI,GAAG,eAAe,CAAC,YAAY,CAAC,CAAC;IAC3C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAmB,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,YAAoB,EAAE,KAAqB;IAC5E,MAAM,IAAI,GAAG,eAAe,CAAC,YAAY,CAAC,CAAC;IAC3C,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AAC1F,CAAC;AAED,kFAAkF;AAElF;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,YAAoB;IACrD,MAAM,QAAQ,GAAG,kBAAkB,CAAC,YAAY,CAAC,CAAC;IAClD,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAE9B,uCAAuC;IACvC,MAAM,eAAe,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC;IACxC,MAAM,UAAU,GAAG,KAAK,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAmB,CAAC;IAE3E,MAAM,OAAO,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;IAEhD,MAAM,KAAK,GAAmB;QAC5B,UAAU;QACV,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,QAAQ,EAAE,KAAK;QACf,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACtB,CAAC;IAEF,kBAAkB,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IACxC,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,YAAoB;IACxD,MAAM,QAAQ,GAAG,kBAAkB,CAAC,YAAY,CAAC,CAAC;IAClD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,6EAA6E,CAAC,CAAC;IACjG,CAAC;IAED,MAAM,OAAO,GAAmB;QAC9B,GAAG,QAAQ;QACX,QAAQ,EAAE,IAAI;QACd,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE;KACvB,CAAC;IAEF,kBAAkB,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAC1C,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/{restorer → harnesses}/impls/claude-mcp-hyperliquid/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * claude-mcp-hyperliquid — Reference RestorerImpl for portfolio.v0 — §8.
+ * claude-mcp-hyperliquid — Reference Harness for portfolio.v0 — §8.
  *
  * Spawns Claude Code session(s) with HL-specific MCP tools (§8.2).
  * Safety rails enforced at the tool boundary (§8.3).
@@ -18,14 +18,14 @@
  *
  *   Programmatic approval is a §8.5 future item.
  */
-import type { RestorerImpl, RestorationContext, RestorationOutput, ReadyStatus, EnableResult, IntentEnableMetadata } from '../../types.js';
-import type { DesiredState } from '../../../types/desired-state.js';
+import type { Harness, HarnessContext, Solution, ReadyStatus, EnableResult, HarnessEnableMetadata } from '../../types.js';
+import type { Task } from '../../../types/task.js';
 import { HyperliquidClient } from '../../../venues/hyperliquid/client.js';
 import type { SafetyConfig } from './safety-rails.js';
 export interface ClaudeMcpHyperliquidConfig {
     claudePath?: string;
     claudeModel?: string;
-    /** Per-intent safety override (from intent context) */
+    /** Per-task safety override (from task context) */
     safetyConfig?: Partial<SafetyConfig>;
     /** Cadence between sessions in ms. Default: 30 min */
     cadenceMs?: number;
@@ -33,13 +33,13 @@ export interface ClaudeMcpHyperliquidConfig {
     sessionMaxMs?: number;
     /**
      * Impl state directory — used by `isReady` and `onEnable` to locate
-     * the api-wallet file outside of a running intent context. Defaults under
+     * the api-wallet file outside of a running task context. Defaults under
      * `~/.jinn-client/engine/impl-state/claude-mcp-hyperliquid` (see `config.engine`).
      */
     implStateDir?: string;
     /** Injected deps for testing */
     _testDeps?: TestDeps;
-    /** CLI `jinn intents` registry without a live fleet */
+    /** CLI `jinn solver-nets` registry without a live fleet */
     stub?: boolean;
 }
 export interface TestDeps {
@@ -49,16 +49,16 @@ export interface TestDeps {
     }>;
     hlClient?: HyperliquidClient;
 }
-export declare class ClaudeMcpHyperliquidImpl implements RestorerImpl {
+export declare class ClaudeMcpHyperliquidImpl implements Harness {
     readonly name = "claude-mcp-hyperliquid";
     readonly version = "1.0.0";
     private config;
     constructor(config?: ClaudeMcpHyperliquidConfig);
     supports(ctx: {
-        kind: string;
-        type?: 'restoration' | 'evaluation';
+        solverType: string;
+        role?: 'restoration' | 'evaluation';
     }): boolean;
-    canAttempt(intent: DesiredState): Promise<{
+    canAttempt(task: Task): Promise<{
         ok: true;
     } | {
         ok: false;
@@ -69,10 +69,12 @@ export declare class ClaudeMcpHyperliquidImpl implements RestorerImpl {
     /** Exposed for tests and operator diagnostics; same as internal resolve path. */
     resolvedImplStateDir(): string;
     isReady(): Promise<ReadyStatus>;
-    enableMetadata(): IntentEnableMetadata;
-    onEnable(args: Record<string, string | undefined>): Promise<EnableResult>;
+    enableMetadata(): HarnessEnableMetadata;
+    onEnable(ctx: {
+        args: Record<string, string | undefined>;
+    }): Promise<EnableResult>;
     onDisable(): Promise<void>;
-    run(ctx: RestorationContext): Promise<RestorationOutput>;
+    run(ctx: HarnessContext): Promise<Solution>;
 }
 interface HlServerConfig {
     hlBaseUrl: string;
@@ -94,7 +96,7 @@ interface HlServerConfig {
  * The import path is resolved at write-time from __dirname (this module's
  * location) so it always points to the compiled mcp-tools.js alongside this
  * file. The daemon MUST run from a compiled build (dist/) — `yarn build`
- * produces `dist/restorer/impls/claude-mcp-hyperliquid/mcp-tools.js`, which
+ * produces `dist/harnesses/impls/claude-mcp-hyperliquid/mcp-tools.js`, which
  * this wrapper imports by absolute path from plain Node. Running from tsx
  * against src/ would leave mcp-tools.js non-existent and cause Claude to
  * silently spawn with no HL tools loaded — hence the explicit existence