groundswell 0.0.2 → 1.0.0

package/dist/examples/tdd-orchestrator.js

@@ -0,0 +1,121 @@
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+import { Workflow } from '../core/workflow.js';
+import { Step } from '../decorators/step.js';
+import { Task } from '../decorators/task.js';
+import { ObservedState } from '../decorators/observed-state.js';
+import { TestCycleWorkflow } from './test-cycle-workflow.js';
+/**
+ * Example parent workflow demonstrating TDD orchestration
+ */
+let TDDOrchestrator = (() => {
+    let _classSuper = Workflow;
+    let _instanceExtraInitializers = [];
+    let _cycleCount_decorators;
+    let _cycleCount_initializers = [];
+    let _cycleCount_extraInitializers = [];
+    let _maxCycles_decorators;
+    let _maxCycles_initializers = [];
+    let _maxCycles_extraInitializers = [];
+    let _apiKey_decorators;
+    let _apiKey_initializers = [];
+    let _apiKey_extraInitializers = [];
+    let _setupEnvironment_decorators;
+    let _runCycle_decorators;
+    return class TDDOrchestrator extends _classSuper {
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _cycleCount_decorators = [ObservedState()];
+            _maxCycles_decorators = [ObservedState()];
+            _apiKey_decorators = [ObservedState({ redact: true })];
+            _setupEnvironment_decorators = [Step({ logStart: true, logFinish: true })];
+            _runCycle_decorators = [Task()];
+            __esDecorate(this, null, _setupEnvironment_decorators, { kind: "method", name: "setupEnvironment", static: false, private: false, access: { has: obj => "setupEnvironment" in obj, get: obj => obj.setupEnvironment }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _runCycle_decorators, { kind: "method", name: "runCycle", static: false, private: false, access: { has: obj => "runCycle" in obj, get: obj => obj.runCycle }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(null, null, _cycleCount_decorators, { kind: "field", name: "cycleCount", static: false, private: false, access: { has: obj => "cycleCount" in obj, get: obj => obj.cycleCount, set: (obj, value) => { obj.cycleCount = value; } }, metadata: _metadata }, _cycleCount_initializers, _cycleCount_extraInitializers);
+            __esDecorate(null, null, _maxCycles_decorators, { kind: "field", name: "maxCycles", static: false, private: false, access: { has: obj => "maxCycles" in obj, get: obj => obj.maxCycles, set: (obj, value) => { obj.maxCycles = value; } }, metadata: _metadata }, _maxCycles_initializers, _maxCycles_extraInitializers);
+            __esDecorate(null, null, _apiKey_decorators, { kind: "field", name: "apiKey", static: false, private: false, access: { has: obj => "apiKey" in obj, get: obj => obj.apiKey, set: (obj, value) => { obj.apiKey = value; } }, metadata: _metadata }, _apiKey_initializers, _apiKey_extraInitializers);
+            if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        }
+        cycleCount = (__runInitializers(this, _instanceExtraInitializers), __runInitializers(this, _cycleCount_initializers, 0));
+        maxCycles = (__runInitializers(this, _cycleCount_extraInitializers), __runInitializers(this, _maxCycles_initializers, 3));
+        apiKey = (__runInitializers(this, _maxCycles_extraInitializers), __runInitializers(this, _apiKey_initializers, 'secret-key'));
+        async setupEnvironment() {
+            this.logger.info('Setting up TDD environment');
+            // Simulate environment setup
+            await this.delay(50);
+            this.logger.debug('Environment ready');
+        }
+        async runCycle() {
+            this.cycleCount++;
+            this.logger.info(`Starting cycle ${this.cycleCount}/${this.maxCycles}`);
+            return new TestCycleWorkflow(`Cycle-${this.cycleCount}`, this);
+        }
+        async run() {
+            this.setStatus('running');
+            this.logger.info('TDD Orchestrator starting');
+            try {
+                await this.setupEnvironment();
+                while (this.cycleCount < this.maxCycles) {
+                    try {
+                        const cycle = await this.runCycle();
+                        await cycle.run();
+                        this.logger.info(`Cycle ${this.cycleCount} completed successfully`);
+                    }
+                    catch (error) {
+                        this.logger.warn(`Cycle ${this.cycleCount} failed, continuing...`);
+                        // In real implementation, analyze error and potentially restart
+                    }
+                }
+                this.setStatus('completed');
+                this.logger.info('TDD Orchestrator completed all cycles');
+            }
+            catch (error) {
+                this.setStatus('failed');
+                this.logger.error('TDD Orchestrator failed', { error });
+                throw error;
+            }
+        }
+        delay(ms) {
+            return new Promise((resolve) => setTimeout(resolve, ms));
+        }
+        constructor() {
+            super(...arguments);
+            __runInitializers(this, _apiKey_extraInitializers);
+        }
+    };
+})();
+export { TDDOrchestrator };
+//# sourceMappingURL=tdd-orchestrator.js.map

package/dist/examples/tdd-orchestrator.js.map

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

package/dist/examples/test-cycle-workflow.d.ts

@@ -0,0 +1,14 @@
+import { Workflow } from '../core/workflow.js';
+/**
+ * Example child workflow demonstrating test cycle
+ */
+export declare class TestCycleWorkflow extends Workflow {
+    currentTest: string;
+    testResult: 'pending' | 'passed' | 'failed';
+    generateTest(): Promise<string>;
+    runTest(): Promise<boolean>;
+    updateImplementation(): Promise<void>;
+    run(): Promise<void>;
+    private delay;
+}
+//# sourceMappingURL=test-cycle-workflow.d.ts.map

package/dist/examples/test-cycle-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-cycle-workflow.d.ts","sourceRoot":"","sources":["../../src/examples/test-cycle-workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAI/C;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,QAAQ;IAE7C,WAAW,EAAE,MAAM,CAAM;IAGzB,UAAU,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAa;IAGlD,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAS/B,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAiB3B,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IAKrC,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAc1B,OAAO,CAAC,KAAK;CAGd"}

package/dist/examples/test-cycle-workflow.js

@@ -0,0 +1,116 @@
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+import { Workflow } from '../core/workflow.js';
+import { Step } from '../decorators/step.js';
+import { ObservedState } from '../decorators/observed-state.js';
+/**
+ * Example child workflow demonstrating test cycle
+ */
+let TestCycleWorkflow = (() => {
+    let _classSuper = Workflow;
+    let _instanceExtraInitializers = [];
+    let _currentTest_decorators;
+    let _currentTest_initializers = [];
+    let _currentTest_extraInitializers = [];
+    let _testResult_decorators;
+    let _testResult_initializers = [];
+    let _testResult_extraInitializers = [];
+    let _generateTest_decorators;
+    let _runTest_decorators;
+    let _updateImplementation_decorators;
+    return class TestCycleWorkflow extends _classSuper {
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _currentTest_decorators = [ObservedState()];
+            _testResult_decorators = [ObservedState()];
+            _generateTest_decorators = [Step({ snapshotState: true, trackTiming: true, logStart: true })];
+            _runTest_decorators = [Step({ trackTiming: true })];
+            _updateImplementation_decorators = [Step({ snapshotState: true })];
+            __esDecorate(this, null, _generateTest_decorators, { kind: "method", name: "generateTest", static: false, private: false, access: { has: obj => "generateTest" in obj, get: obj => obj.generateTest }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _runTest_decorators, { kind: "method", name: "runTest", static: false, private: false, access: { has: obj => "runTest" in obj, get: obj => obj.runTest }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _updateImplementation_decorators, { kind: "method", name: "updateImplementation", static: false, private: false, access: { has: obj => "updateImplementation" in obj, get: obj => obj.updateImplementation }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(null, null, _currentTest_decorators, { kind: "field", name: "currentTest", static: false, private: false, access: { has: obj => "currentTest" in obj, get: obj => obj.currentTest, set: (obj, value) => { obj.currentTest = value; } }, metadata: _metadata }, _currentTest_initializers, _currentTest_extraInitializers);
+            __esDecorate(null, null, _testResult_decorators, { kind: "field", name: "testResult", static: false, private: false, access: { has: obj => "testResult" in obj, get: obj => obj.testResult, set: (obj, value) => { obj.testResult = value; } }, metadata: _metadata }, _testResult_initializers, _testResult_extraInitializers);
+            if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        }
+        currentTest = (__runInitializers(this, _instanceExtraInitializers), __runInitializers(this, _currentTest_initializers, ''));
+        testResult = (__runInitializers(this, _currentTest_extraInitializers), __runInitializers(this, _testResult_initializers, 'pending'));
+        async generateTest() {
+            this.logger.info('Generating test case');
+            this.currentTest = `test_${Date.now()}`;
+            // Simulate test generation
+            await this.delay(100);
+            return this.currentTest;
+        }
+        async runTest() {
+            this.logger.info(`Running test: ${this.currentTest}`);
+            // Simulate test execution
+            await this.delay(200);
+            // Randomly pass or fail for demonstration
+            const passed = Math.random() > 0.3;
+            this.testResult = passed ? 'passed' : 'failed';
+            if (!passed) {
+                throw new Error(`Test ${this.currentTest} failed`);
+            }
+            return true;
+        }
+        async updateImplementation() {
+            this.logger.info('Updating implementation based on test results');
+            await this.delay(150);
+        }
+        async run() {
+            this.setStatus('running');
+            try {
+                await this.generateTest();
+                await this.runTest();
+                await this.updateImplementation();
+                this.setStatus('completed');
+            }
+            catch (error) {
+                this.setStatus('failed');
+                throw error;
+            }
+        }
+        delay(ms) {
+            return new Promise((resolve) => setTimeout(resolve, ms));
+        }
+        constructor() {
+            super(...arguments);
+            __runInitializers(this, _testResult_extraInitializers);
+        }
+    };
+})();
+export { TestCycleWorkflow };
+//# sourceMappingURL=test-cycle-workflow.js.map

package/dist/examples/test-cycle-workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-cycle-workflow.js","sourceRoot":"","sources":["../../src/examples/test-cycle-workflow.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAEhE;;GAEG;IACU,iBAAiB;sBAAS,QAAQ;;;;;;;;;;;iBAAlC,iBAAkB,SAAQ,WAAQ;;;uCAC5C,aAAa,EAAE;sCAGf,aAAa,EAAE;wCAGf,IAAI,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;mCAShE,IAAI,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;gDAiB3B,IAAI,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;YAzB9B,uLAAM,YAAY,6DAMjB;YAGD,wKAAM,OAAO,6DAcZ;YAGD,+MAAM,oBAAoB,6DAGzB;YAnCD,mLAAA,WAAW,6BAAX,WAAW,iGAAc;YAGzB,gLAAA,UAAU,6BAAV,UAAU,+FAA8C;;;QAHxD,WAAW,IAFA,mDAAiB,qDAEN,EAAE,GAAC;QAGzB,UAAU,+GAAoC,SAAS,GAAC;QAGxD,KAAK,CAAC,YAAY;YAChB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;YACzC,IAAI,CAAC,WAAW,GAAG,QAAQ,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YACxC,2BAA2B;YAC3B,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACtB,OAAO,IAAI,CAAC,WAAW,CAAC;QAC1B,CAAC;QAGD,KAAK,CAAC,OAAO;YACX,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,iBAAiB,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;YACtD,0BAA0B;YAC1B,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAEtB,0CAA0C;YAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC;YACnC,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;YAE/C,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,IAAI,KAAK,CAAC,QAAQ,IAAI,CAAC,WAAW,SAAS,CAAC,CAAC;YACrD,CAAC;YAED,OAAO,IAAI,CAAC;QACd,CAAC;QAGD,KAAK,CAAC,oBAAoB;YACxB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;YAClE,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACxB,CAAC;QAED,KAAK,CAAC,GAAG;YACP,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;YAE1B,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;gBAC1B,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;gBACrB,MAAM,IAAI,CAAC,oBAAoB,EAAE,CAAC;gBAClC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;YAC9B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;gBACzB,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;QAEO,KAAK,CAAC,EAAU;YACtB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;QAC3D,CAAC;;;;;;;SAvDU,iBAAiB"}

package/dist/harnesses/claude-code-harness.d.ts

@@ -0,0 +1,391 @@
+/**
+ * Claude Code harness implementation (PRD §7.1)
+ *
+ * Wraps the @anthropic-ai/claude-agent-sdk to provide Anthropic Claude
+ * model access through the unified Harness interface.
+ *
+ * ## Capabilities
+ *
+ * - **MCP**: Model Context Protocol integration via createSdkMcpServer
+ * - **Skills**: System prompt-based skill loading
+ * - **LSP**: Language Server Protocol via MCP plugins
+ * - **Streaming**: Streaming response support
+ * - **Sessions**: Session-based state via abstraction layer
+ * - **Extended Thinking**: maxThinkingTokens for extended reasoning
+ *
+ * ## SDK Integration
+ *
+ * Uses lazy loading for the Anthropic SDK. The SDK is imported dynamically
+ * in the initialize() method to support optional dependencies.
+ *
+ * @example
+ * ```ts
+ * import { ClaudeCodeHarness } from 'groundswell';
+ *
+ * const harness = new ClaudeCodeHarness();
+ * await harness.initialize({ apiKey: 'sk-...' });
+ *
+ * const result = await harness.execute(
+ *   { prompt: 'Hello, Claude!', options: {} },
+ *   toolExecutor
+ * );
+ * ```
+ *
+ * @see {@link https://docs.anthropic.com/en/api/messages | Anthropic Messages API}
+ * @see {@link https://www.npmjs.com/package/@anthropic-ai/claude-agent-sdk | Agent SDK Package}
+ */
+import type { Harness, HarnessId, HarnessCapabilities, HarnessOptions, HarnessRequest, HarnessHookEvents, ToolExecutionRequest, ToolExecutionResult, ModelSpec } from "../types/harnesses.js";
+import type { SessionState } from "../types/providers.js";
+import type { AgentResponse } from "../types/agent.js";
+import type { Tool, MCPServer, Skill } from "../types/sdk-primitives.js";
+import { type SessionStore } from "./session-store.js";
+import type { StreamEvent } from "../types/streaming.js";
+/**
+ * Claude Code harness options (PRD §7.5).
+ * Extends {@link HarnessOptions} with adapter-internal session-store configuration that the
+ * slimmed base contract intentionally omits.
+ */
+export interface ClaudeCodeHarnessOptions extends HarnessOptions {
+    /** Direct session-store injection (mutually exclusive with sessionPersistence). */
+    sessionStore?: SessionStore<SessionState>;
+    /** Declarative store selection; constructs the appropriate SessionStore. */
+    sessionPersistence?: "memory" | "file" | "redis";
+    /** Session TTL in ms (default 86400000 = 24h). */
+    sessionTtl?: number;
+    /** Directory for FileSessionStore (default './sessions'). Only when sessionPersistence='file'. */
+    sessionPath?: string;
+}
+/**
+ * Thrown when a harness receives a configuration it cannot honour — e.g. a model
+ * provider it cannot run (ClaudeCodeHarness + non-anthropic, PRD §7.8). Carries a
+ * machine-readable `code` (default `AGENT_ERROR_CODES.CONFIG_ERROR`) so callers and
+ * Agent retry logic can branch structurally rather than parsing message text.
+ *
+ * @see AGENT_ERROR_CODES
+ */
+export declare class ConfigError extends Error {
+    readonly code: string;
+    readonly details?: Record<string, unknown>;
+    constructor(message: string, options?: {
+        code?: string;
+        details?: Record<string, unknown>;
+    });
+}
+export declare class ClaudeCodeHarness implements Harness {
+    /**
+     * Unique harness identifier (PRD §7.2)
+     *
+     * @readonly
+     */
+    readonly id: HarnessId;
+    /**
+     * Provider capability flags
+     *
+     * Anthropic SDK v0.1.77 capabilities:
+     * - MCP via createSdkMcpServer
+     * - Skills via system prompt
+     * - LSP via MCP plugins
+     * - Streaming responses
+     * - No native sessions (stateless)
+     * - Extended thinking via maxThinkingTokens
+     *
+     * @readonly
+     */
+    readonly capabilities: HarnessCapabilities;
+    /**
+     * Check if a specific capability is supported
+     *
+     * @param capability - The capability to check
+     * @returns true if the capability is supported
+     */
+    supports(capability: keyof HarnessCapabilities): boolean;
+    /**
+     * Check if all specified features are supported
+     *
+     * @param features - Array of capability keys to check
+     * @returns true if all features are supported
+     */
+    requiresFeatures(features: (keyof HarnessCapabilities)[]): boolean;
+    /**
+     * Anthropic SDK module (lazy loaded)
+     *
+     * Dynamically imported in initialize() to support optional dependencies.
+     * Typed using typeof import() pattern for accurate module types.
+     *
+     * @internal
+     */
+    private sdk;
+    /**
+     * MCP handler for server registration and tool management
+     *
+     * Manages MCP server connections and converts tools to SDK format.
+     * Created on first use and reused for subsequent registrations.
+     *
+     * @internal
+     */
+    private mcpHandler;
+    /**
+     * SDK MCP server configuration for use in execute()
+     *
+     * Stores the converted SDK server config from registerMCPs().
+     * Used in sdkOptions.mcpServers during execute() calls.
+     *
+     * @internal
+     */
+    private mcpServerConfig;
+    /**
+     * Combined skills prompt for injection into system prompts
+     *
+     * Stores the formatted skills content from loadSkills() for injection
+     * into system prompts during execute() calls. Skills are combined with
+     * markdown headers and separators.
+     *
+     * @internal
+     */
+    private skillsPrompt;
+    /**
+     * Session storage backend
+     *
+     * Manages session state using pluggable storage backends. Defaults to
+     * in-memory storage but can be configured with file-based, Redis, or
+     * custom implementations via ProviderOptions or setSessionStore().
+     *
+     * @internal
+     */
+    private sessionStore;
+    /**
+     * Session TTL in milliseconds from ProviderOptions
+     *
+     * @internal
+     */
+    private sessionTtl?;
+    /**
+     * Initialize the Anthropic provider
+     *
+     * Loads the Anthropic SDK and initializes the client.
+     *
+     * @param options - Optional provider configuration (apiKey, endpoint, sessionPersistence, etc.)
+     * @remarks Session storage defaults to MemorySessionStore if not specified.
+     * Implemented in P2.M1.T1.S2
+     */
+    initialize(options?: ClaudeCodeHarnessOptions): Promise<void>;
+    /**
+     * Terminate the provider and cleanup resources
+     *
+     * Clears the SDK module reference to allow garbage collection.
+     * The Anthropic SDK is stateless and manages its own resources internally.
+     *
+     * @remarks
+     * Implemented in P2.M1.T1.S3
+     */
+    terminate(): Promise<void>;
+    /**
+     * Execute a prompt request
+     *
+     * Constructs the SDK query from ProviderRequest and executes it via the Anthropic SDK.
+     *
+     * When options.streaming is true, returns an AsyncGenerator that yields StreamEvent objects.
+     * When options.streaming is false or undefined, returns a complete AgentResponse.
+     *
+     * @param request - Provider request with prompt and options
+     * @param toolExecutor - Callback for executing tools (used in P2.M1.T1.S6)
+     * @param hooks - Optional lifecycle hooks (adapter in P2.M1.T2.S1)
+     * @returns Typed agent response or AsyncGenerator for streaming
+     * @throws {ConfigError} (code CONFIG_ERROR) if request.options.model resolves to a
+     *   non-anthropic provider (PRD §7.8) — enforced via normalizeModel.
+     * @remarks
+     * P2.M1.T1.S5: Query construction - builds AgentSDKOptions and calls SDK query()
+     * P2.M1.T1.S6: Message iteration - iterates AsyncGenerator and builds AgentResponse
+     * Streaming: Returns AsyncGenerator<StreamEvent> when options.streaming = true
+     */
+    execute<T>(request: HarnessRequest, toolExecutor: (req: ToolExecutionRequest) => Promise<ToolExecutionResult>, hooks?: HarnessHookEvents): Promise<AgentResponse<T>> | AsyncGenerator<StreamEvent, AgentResponse<T>, unknown>;
+    /**
+     * Execute a prompt request with streaming
+     *
+     * Returns an AsyncGenerator that yields StreamEvent objects during execution.
+     * Implements streaming mode for real-time response generation.
+     *
+     * @param request - Provider request with prompt and options
+     * @param toolExecutor - Callback for executing tools
+     * @param hooks - Optional lifecycle hooks
+     * @returns AsyncGenerator yielding StreamEvent objects, returning final AgentResponse
+     * @private
+     * @remarks
+     * Streaming mode implementation following PRP P4.M2.T1.S4 specification.
+     */
+    private executeStreaming;
+    /**
+     * Register MCP servers and return available tools
+     *
+     * Registers MCP servers with the internal MCPHandler and returns
+     * discovered tools in MCP format. Also converts tools to SDK format
+     * and stores the configuration for use in execute().
+     *
+     * @param servers - Array of MCP server configurations (required)
+     * @returns Array of discovered tools in MCP format (serverName__toolName)
+     * @remarks Modifies internal MCP handler state, converts tools to SDK format.
+     * Implemented in P2.M1.T1.S7
+     *
+     * @example
+     * ```ts
+     * const provider = new AnthropicProvider();
+     * await provider.initialize();
+     *
+     * const tools = await provider.registerMCPs([
+     *   {
+     *     name: 'filesystem',
+     *     transport: 'inprocess',
+     *     tools: [
+     *       {
+     *         name: 'read_file',
+     *         description: 'Read a file',
+     *         input_schema: {
+     *           type: 'object',
+     *           properties: { path: { type: 'string' } },
+     *           required: ['path']
+     *         }
+     *       }
+     *     ]
+     *   }
+     * ]);
+     *
+     * console.log(tools); // [{ name: 'filesystem__read_file', ... }]
+     * ```
+     */
+    registerMCPs(servers: MCPServer[]): Promise<Tool[]>;
+    /**
+     * Load skills into the provider
+     *
+     * Skills are read from SKILL.md files in each skill directory and combined
+     * into a formatted system prompt fragment for injection during execute().
+     *
+     * @param skills - Array of skill definitions with name and path (empty array clears existing skills)
+     * @throws {Error} When SDK is not initialized
+     * @throws {Error} When SKILL.md file cannot be read
+     * @remarks Each skill directory must contain a SKILL.md file. Skills are combined
+     * with markdown headers (### Skill Name) and separators (---).
+     *
+     * @example
+     * ```ts
+     * const provider = new AnthropicProvider();
+     * await provider.initialize();
+     * await provider.loadSkills([
+     *   { name: 'math-expert', path: '/skills/math' },
+     *   { name: 'code-reviewer', path: '/skills/code' }
+     * ]);
+     * ```
+     */
+    loadSkills(skills: Skill[]): Promise<void>;
+    /**
+     * Build system prompt with skills injected
+     *
+     * Combines the base system prompt with loaded skills for injection into
+     * the Anthropic SDK's systemPrompt parameter.
+     *
+     * @param baseSystemPrompt - Optional base system prompt to enhance with skills
+     * @returns Enhanced system prompt with skills section, or base prompt unchanged if no skills loaded
+     * @internal
+     * @remarks
+     * Three handling cases:
+     * 1. No skills loaded - returns basePrompt unchanged
+     * 2. No base prompt - returns skills-only prompt with default header
+     * 3. Both exist - combines with "## Available Skills" section
+     */
+    private buildSystemPromptWithSkills;
+    /**
+     * Build Agent SDK hooks from Provider hook events
+     *
+     * Adapts ProviderHookEvents to Anthropic Agent SDK-compatible hook format.
+     * Transforms signatures between Provider and SDK hook formats and handles
+     * async/sync hook execution.
+     *
+     * @param hooks - Optional provider hook events to adapt
+     * @returns SDK-compatible hooks object with HookCallbackMatcher arrays
+     * @internal
+     * @remarks
+     * Hook mapping:
+     * - onToolStart → PreToolUse
+     * - onToolEnd → PostToolUse
+     * - onSessionStart → SessionStart
+     * - onSessionEnd → SessionEnd
+     *
+     * Each adapter returns { continue: true } for SDK compatibility.
+     * Duration values are set to 0 as SDK doesn't provide them in hook input.
+     */
+    private buildAgentSDKHooks;
+    /**
+     * Normalize a model string to a ModelSpec
+     *
+     * Parses model strings in two formats:
+     * - Plain: "claude-sonnet-4" → { provider: 'anthropic', model: 'claude-sonnet-4', raw: 'claude-sonnet-4' }
+     * - Qualified: "anthropic/claude-opus-4" → { provider: 'anthropic', model: 'claude-opus-4', raw: 'anthropic/claude-opus-4' }
+     *
+     * Delegates to {@link parseModelSpec} for parsing and validation.
+     * Validates that the provider is 'anthropic'.
+     *
+     * @param model - Model string to normalize (required)
+     * @returns Parsed ModelSpec with provider='anthropic'
+     * @throws {Error} When model specification is invalid (delegated to parseModelSpec)
+     * @throws {ConfigError} When provider is not 'anthropic' (code === AGENT_ERROR_CODES.CONFIG_ERROR)
+     *
+     * @example
+     * ```ts
+     * const provider = new AnthropicProvider();
+     *
+     * // Plain format
+     * provider.normalizeModel('claude-sonnet-4');
+     * // Returns: { provider: 'anthropic', model: 'claude-sonnet-4', raw: 'claude-sonnet-4' }
+     *
+     * // Qualified format
+     * provider.normalizeModel('anthropic/claude-opus-4');
+     * // Returns: { provider: 'anthropic', model: 'claude-opus-4', raw: 'anthropic/claude-opus-4' }
+     *
+     * // Error: wrong provider
+     * provider.normalizeModel('openai/gpt-4');
+     * // Throws: "Cannot normalize openai/gpt-4 with ClaudeCodeHarness..."
+     * ```
+     */
+    normalizeModel(model: string): ModelSpec;
+    /**
+     * Create a new session with the specified ID
+     *
+     * Initializes empty session state for the given session ID.
+     * If session already exists, this is a no-op (idempotent).
+     *
+     * @param sessionId - Unique identifier for the session (required)
+     * @throws {Error} If SDK is not initialized
+     * @remarks Idempotent: if session exists, this is a no-op.
+     * Session will be used when execute() receives matching sessionId in options.
+     */
+    createSession(sessionId: string): Promise<void>;
+    /**
+     * Get session state for the specified ID
+     *
+     * Retrieves the current session state including conversation history
+     * and last result. Returns undefined if session doesn't exist.
+     *
+     * @param sessionId - Session identifier to retrieve (required)
+     * @returns Session state or undefined if not found
+     * @remarks Updates lastAccessedAt timestamp and saves back to persistent stores.
+     */
+    getSession(sessionId: string): Promise<SessionState | undefined>;
+    /**
+     * Delete a session
+     *
+     * Removes the session from storage. If the session doesn't exist,
+     * returns false.
+     *
+     * @param sessionId - Session identifier to delete (required)
+     * @returns true if deleted, false if not found
+     * @throws {Error} If SDK is not initialized
+     * @remarks Destructive operation: deleted sessions cannot be recovered
+     * unless the store has backup/retention policies.
+     */
+    deleteSession(sessionId: string): Promise<boolean>;
+}
+/**
+ * @deprecated Since v1.2. Use {@link ClaudeCodeHarness}. Renamed as part of the
+ * Harness/Provider split (PRD §7). Identity preserved for backward compatibility.
+ */
+export declare const AnthropicProvider: typeof ClaudeCodeHarness;
+//# sourceMappingURL=claude-code-harness.d.ts.map

package/dist/harnesses/claude-code-harness.d.ts.map

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