@paraharness/claude 0.0.0-stage → 0.1.0

package/dist/driver/internal/transform-claude-fork-frame.d.ts

@@ -0,0 +1,27 @@
+import type { WireFrameRecord } from '@paraharness/core';
+/**
+ * Parameters for transforming a single parent `WireFrameRecord` via `transformClaudeForkFrame()`.
+ *
+ * Controls whether cross-model tombstone substitution is active and whether the frame is the fork point.
+ */
+export interface TransformClaudeForkFrameParams {
+    /** Source parent wire frame record to clone or re-project. */
+    readonly frame: WireFrameRecord;
+    /** Whether cross-model tombstone substitution is active (`sourceModelId !== targetModelId`). */
+    readonly substituteTombstones: boolean;
+    /** Whether `frame` is the terminal fork-point message in the sliced parent chain. */
+    readonly isForkPoint: boolean;
+}
+/**
+ * Clones or re-projects a single parent `WireFrameRecord` during `'clone-transcript'` fork preparation.
+ *
+ * Preserves `rawWireFrame` with `cache_control: { type: 'ephemeral' }` on the fork point when
+ * `params.substituteTombstones` is `false`, and projects from `CanonicalMessage` (applying `compactedTombstones`)
+ * when `params.substituteTombstones` is `true`.
+ *
+ * @param {TransformClaudeForkFrameParams} params - Source frame, tombstone substitution flag, and fork-point flag.
+ *
+ * @returns {WireFrameRecord} Cloned or re-projected wire frame record.
+ */
+export declare function transformClaudeForkFrame(params: TransformClaudeForkFrameParams): WireFrameRecord;
+//# sourceMappingURL=transform-claude-fork-frame.d.ts.map

package/dist/driver/internal/transform-claude-fork-frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform-claude-fork-frame.d.ts","sourceRoot":"","sources":["../../../src/driver/internal/transform-claude-fork-frame.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAyC,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAIhG;;;;GAIG;AACH,MAAM,WAAW,8BAA8B;IAC7C,8DAA8D;IAC9D,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,gGAAgG;IAChG,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC;IACvC,qFAAqF;IACrF,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,8BAA8B,GAAG,eAAe,CAiDhG"}

package/dist/driver/internal/transform-claude-fork-frame.js

@@ -0,0 +1,61 @@
+import { projectCanonicalToAnthropicMessage } from './project-canonical-to-anthropic-message.js';
+import { decodeFrameToAnthropicMessage } from './decode-frame-to-anthropic-message.js';
+/**
+ * Clones or re-projects a single parent `WireFrameRecord` during `'clone-transcript'` fork preparation.
+ *
+ * Preserves `rawWireFrame` with `cache_control: { type: 'ephemeral' }` on the fork point when
+ * `params.substituteTombstones` is `false`, and projects from `CanonicalMessage` (applying `compactedTombstones`)
+ * when `params.substituteTombstones` is `true`.
+ *
+ * @param {TransformClaudeForkFrameParams} params - Source frame, tombstone substitution flag, and fork-point flag.
+ *
+ * @returns {WireFrameRecord} Cloned or re-projected wire frame record.
+ */
+export function transformClaudeForkFrame(params) {
+    const { frame, substituteTombstones, isForkPoint } = params;
+    if (!substituteTombstones) {
+        if (!isForkPoint) {
+            return frame;
+        }
+        const wireMessage = decodeFrameToAnthropicMessage(frame);
+        const withCache = Object.freeze({
+            ...wireMessage,
+            cache_control: Object.freeze({ type: 'ephemeral' }),
+        });
+        return Object.freeze({
+            messageId: frame.messageId,
+            parentMessageId: frame.parentMessageId,
+            vendorId: 'anthropic',
+            rawWireFrame: new TextEncoder().encode(JSON.stringify(withCache)),
+            canonical: frame.canonical,
+            prefixDigest: frame.prefixDigest,
+            compactedTombstones: frame.compactedTombstones,
+        });
+    }
+    const tombstones = frame.compactedTombstones ?? {};
+    const updatedResults = [];
+    for (const toolResult of frame.canonical.toolResults ?? []) {
+        updatedResults.push(Object.freeze({
+            callId: toolResult.callId,
+            content: tombstones[toolResult.callId] ?? toolResult.content,
+            isError: toolResult.isError,
+        }));
+    }
+    const updatedCanonical = Object.freeze({
+        role: frame.canonical.role,
+        visibleText: frame.canonical.visibleText,
+        toolCalls: frame.canonical.toolCalls,
+        toolResults: frame.canonical.toolResults !== undefined ? Object.freeze(updatedResults) : undefined,
+    });
+    const projectedWire = projectCanonicalToAnthropicMessage(updatedCanonical);
+    return Object.freeze({
+        messageId: frame.messageId,
+        parentMessageId: frame.parentMessageId,
+        vendorId: 'anthropic',
+        rawWireFrame: new TextEncoder().encode(JSON.stringify(projectedWire)),
+        canonical: updatedCanonical,
+        prefixDigest: frame.prefixDigest,
+        compactedTombstones: frame.compactedTombstones,
+    });
+}
+//# sourceMappingURL=transform-claude-fork-frame.js.map

package/dist/driver/internal/transform-claude-fork-frame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform-claude-fork-frame.js","sourceRoot":"","sources":["../../../src/driver/internal/transform-claude-fork-frame.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kCAAkC,EAAE,MAAM,6CAA6C,CAAC;AACjG,OAAO,EAAE,6BAA6B,EAAE,MAAM,wCAAwC,CAAC;AAgBvF;;;;;;;;;;GAUG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAsC;IAC7E,MAAM,EAAE,KAAK,EAAE,oBAAoB,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;IAC5D,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAC1B,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,WAAW,GAAG,6BAA6B,CAAC,KAAK,CAAC,CAAC;QACzD,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC;YAC9B,GAAG,WAAW;YACd,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;SACpD,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,MAAM,CAAkB;YACpC,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,eAAe,EAAE,KAAK,CAAC,eAAe;YACtC,QAAQ,EAAE,WAAW;YACrB,YAAY,EAAE,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;YACjE,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,mBAAmB,EAAE,KAAK,CAAC,mBAAmB;SAC/C,CAAC,CAAC;IACL,CAAC;IACD,MAAM,UAAU,GAAG,KAAK,CAAC,mBAAmB,IAAI,EAAE,CAAC;IACnD,MAAM,cAAc,GAA0B,EAAE,CAAC;IACjD,KAAK,MAAM,UAAU,IAAI,KAAK,CAAC,SAAS,CAAC,WAAW,IAAI,EAAE,EAAE,CAAC;QAC3D,cAAc,CAAC,IAAI,CACjB,MAAM,CAAC,MAAM,CAAsB;YACjC,MAAM,EAAE,UAAU,CAAC,MAAM;YACzB,OAAO,EAAE,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,UAAU,CAAC,OAAO;YAC5D,OAAO,EAAE,UAAU,CAAC,OAAO;SAC5B,CAAC,CACH,CAAC;IACJ,CAAC;IACD,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,CAAmB;QACvD,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC,IAAI;QAC1B,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW;QACxC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,SAAS;QACpC,WAAW,EACT,KAAK,CAAC,SAAS,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,SAAS;KACxF,CAAC,CAAC;IACH,MAAM,aAAa,GAAG,kCAAkC,CAAC,gBAAgB,CAAC,CAAC;IAC3E,OAAO,MAAM,CAAC,MAAM,CAAkB;QACpC,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,QAAQ,EAAE,WAAW;QACrB,YAAY,EAAE,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QACrE,SAAS,EAAE,gBAAgB;QAC3B,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,mBAAmB,EAAE,KAAK,CAAC,mBAAmB;KAC/C,CAAC,CAAC;AACL,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export type { ClaudeAccountSeatNode, ClaudeModelNode } from '@paraharness/core';
+export type { ClaudeAccountSeatBuilder } from './builders/claude-account-seat-builder.js';
+export type { ClaudeModelBuilder } from './builders/claude-model-builder.js';
+export type { ClaudeModelOptions } from './builders/claude-model-options.js';
+export type { ClaudeNamespace } from './builders/claude-namespace-contract.js';
+export { claude } from './builders/claude-namespace.js';
+export { createClaudeAccountSeatBuilder } from './builders/create-claude-account-seat-builder.js';
+export { createClaudeModelBuilder } from './builders/create-claude-model-builder.js';
+export { claudeExecutors } from './driver/claude-executors.constants.js';
+export type { ClaudeHttpRequest } from './driver/claude-http-request.js';
+export type { ClaudeHttpResponse } from './driver/claude-http-response.js';
+export type { ClaudeHttpTransport } from './driver/claude-http-transport.js';
+export { ClaudeModelDriver } from './driver/claude-model-driver.js';
+export { createClaudeExecutors } from './driver/create-claude-executors.js';
+export { defaultClaudeHttpTransport } from './driver/default-claude-http-transport.constants.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAChF,YAAY,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AAC1F,YAAY,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,YAAY,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,YAAY,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAC/E,OAAO,EAAE,MAAM,EAAE,MAAM,gCAAgC,CAAC;AACxD,OAAO,EAAE,8BAA8B,EAAE,MAAM,kDAAkD,CAAC;AAClG,OAAO,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AACrF,OAAO,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AACzE,YAAY,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACzE,YAAY,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,YAAY,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,EAAE,0BAA0B,EAAE,MAAM,qDAAqD,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export { claude } from './builders/claude-namespace.js';
+export { createClaudeAccountSeatBuilder } from './builders/create-claude-account-seat-builder.js';
+export { createClaudeModelBuilder } from './builders/create-claude-model-builder.js';
+export { claudeExecutors } from './driver/claude-executors.constants.js';
+export { ClaudeModelDriver } from './driver/claude-model-driver.js';
+export { createClaudeExecutors } from './driver/create-claude-executors.js';
+export { defaultClaudeHttpTransport } from './driver/default-claude-http-transport.constants.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,MAAM,EAAE,MAAM,gCAAgC,CAAC;AACxD,OAAO,EAAE,8BAA8B,EAAE,MAAM,kDAAkD,CAAC;AAClG,OAAO,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AACrF,OAAO,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AAIzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,EAAE,0BAA0B,EAAE,MAAM,qDAAqD,CAAC"}

package/package.json

@@ -1,6 +1,67 @@
 {
   "name": "@paraharness/claude",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Anthropic Claude ModelDriver and AST builders for Paraharness supporting API key and CLI OAuth subscription seats, KV prefix caching, and thinking signature preservation.",
+  "keywords": [
+    "paraharness",
+    "anthropic",
+    "claude",
+    "llm",
+    "model-driver",
+    "ai-agents"
+  ],
+  "author": "Tornike Tsomaia",
+  "license": "MIT",
+  "homepage": "https://paraharness.github.io/paraharness/modules/_paraharness_claude.html",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/paraharness/paraharness.git",
+    "directory": "packages/claude"
+  },
+  "bugs": {
+    "url": "https://github.com/paraharness/paraharness/issues"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^1.6.0",
+    "zod": "^4.6.7",
+    "@paraharness/core": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.9.0",
+    "typescript": "^5.8.2",
+    "vitest": "^3.2.0"
+  },
+  "typedocOptions": {
+    "entryPoints": [
+      "src/index.ts"
+    ],
+    "tsconfig": "tsconfig.build.json"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "lint": "eslint \"{src,test}/**/*.ts\"",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --config ../../vitest.config.ts --dir . --passWithNoTests"
+  }
 }