@paraharness/claude 0.1.0 → 0.2.0

package/README.md

@@ -33,12 +33,12 @@ const seatA = claude.cliAccount('seat-a').configDir('~/.claude-seat-a');
 const apiFallback = claude.cliAccount('api-fallback').apiKey(P.env('ANTHROPIC_API_KEY'));
 
 const claudeSeats = P.pool('claude-seats')
-  .items(seatA)
+  .with(seatA)
   .strategy('soonest-reset')
   .fallback(apiFallback);
 
 const opus = claude
-  .model('opus', { id: 'claude-opus-4-6', effort: 'high' })
+  .model('claude-opus-4-6', { effort: 'high' })
   .accountPool(claudeSeats);
 
 const reviewer = P.agent('reviewer')

package/dist/builders/claude-model-options.d.ts

@@ -5,8 +5,8 @@
  * extended thinking effort budget applied across turns.
  */
 export interface ClaudeModelOptions {
-    /** Anthropic wire model identifier (such as `'claude-sonnet-4-6'` or `'claude-opus-4-6'`). */
-    readonly id: string;
+    /** Optional Anthropic wire model identifier (defaults to `alias`, such as `'claude-sonnet-4-6'`). */
+    readonly id?: string;
     /** Optional reasoning effort level controlling extended thinking budget allocation. */
     readonly effort?: 'low' | 'medium' | 'high';
 }

package/dist/builders/claude-model-options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claude-model-options.d.ts","sourceRoot":"","sources":["../../src/builders/claude-model-options.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,8FAA8F;IAC9F,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,uFAAuF;IACvF,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CAC7C"}
+{"version":3,"file":"claude-model-options.d.ts","sourceRoot":"","sources":["../../src/builders/claude-model-options.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,qGAAqG;IACrG,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,uFAAuF;IACvF,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CAC7C"}

package/dist/builders/claude-namespace-contract.d.ts

@@ -37,13 +37,13 @@ export interface ClaudeNamespace {
      *
      * Supports `.accountPool(pool)` / `.pool(pool)` and `.effort(level)` before compiling to `ClaudeModelNode`.
      *
-     * @param {string}             alias   - Logical model alias (such as `'sonnet'` or `'opus'`).
-     * @param {ClaudeModelOptions} options - Anthropic model identifier and optional thinking effort.
+     * @param {string}             alias     - Logical model alias (such as `'sonnet'` or `'claude-sonnet-4-6'`).
+     * @param {ClaudeModelOptions} [options] - Optional Anthropic model identifier (`defaults to alias`) and thinking effort.
      *
      * @returns {ClaudeModelBuilder} Fluent builder for the Claude model node.
      *
      * @throws {Error} If `alias` or `options.id` is empty or whitespace-only.
      */
-    model(alias: string, options: ClaudeModelOptions): ClaudeModelBuilder;
+    model(alias: string, options?: ClaudeModelOptions): ClaudeModelBuilder;
 }
 //# sourceMappingURL=claude-namespace-contract.d.ts.map

package/dist/builders/claude-namespace-contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claude-namespace-contract.d.ts","sourceRoot":"","sources":["../../src/builders/claude-namespace-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AACjF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAEpE;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;;;;;;OAUG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,wBAAwB,CAAC;IAEjD;;;;;;;;;;OAUG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,wBAAwB,CAAC;IAE9C;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,kBAAkB,CAAC;CACvE"}
+{"version":3,"file":"claude-namespace-contract.d.ts","sourceRoot":"","sources":["../../src/builders/claude-namespace-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AACjF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAEpE;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;;;;;;OAUG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,wBAAwB,CAAC;IAEjD;;;;;;;;;;OAUG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,wBAAwB,CAAC;IAE9C;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,kBAAkB,CAAC;CACxE"}

package/dist/builders/create-claude-model-builder.d.ts

@@ -4,16 +4,16 @@ import type { ClaudeModelOptions } from './claude-model-options.js';
 /**
  * Creates an immutable `ClaudeModelBuilder` for an Anthropic Claude model configuration.
  *
- * Validates that both `alias` and `options.id` are non-empty strings and compiles to a frozen
- * passive `ClaudeModelNode` without performing network or environment I/O.
+ * Validates that both `alias` and the resolved `modelId` (`options?.id ?? alias`) are non-empty
+ * strings and compiles to a frozen passive `ClaudeModelNode` without performing network or environment I/O.
  *
- * @param {string}                                      alias       - Logical alias of the model.
- * @param {ClaudeModelOptions}                          options     - Provider model identifier and optional effort level.
- * @param {PoolNode<ClaudeAccountSeatNode> | undefined} accountPool - Optional compiled pool of Claude account seats.
+ * @param {string}                                      alias         - Logical alias of the model.
+ * @param {ClaudeModelOptions}                          [options]     - Optional provider model identifier and effort level.
+ * @param {PoolNode<ClaudeAccountSeatNode> | undefined} [accountPool] - Optional compiled pool of Claude account seats.
  *
  * @returns {ClaudeModelBuilder} Immutable builder compiling to `ClaudeModelNode`.
  *
  * @throws {Error} If `alias` or `options.id` is empty or whitespace-only.
  */
-export declare function createClaudeModelBuilder(alias: string, options: ClaudeModelOptions, accountPool?: PoolNode<ClaudeAccountSeatNode>): ClaudeModelBuilder;
+export declare function createClaudeModelBuilder(alias: string, options?: ClaudeModelOptions, accountPool?: PoolNode<ClaudeAccountSeatNode>): ClaudeModelBuilder;
 //# sourceMappingURL=create-claude-model-builder.d.ts.map

package/dist/builders/create-claude-model-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-claude-model-builder.d.ts","sourceRoot":"","sources":["../../src/builders/create-claude-model-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,qBAAqB,EAG1B,KAAK,QAAQ,EACd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAEpE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,kBAAkB,EAC3B,WAAW,CAAC,EAAE,QAAQ,CAAC,qBAAqB,CAAC,GAC5C,kBAAkB,CA+BpB"}
+{"version":3,"file":"create-claude-model-builder.d.ts","sourceRoot":"","sources":["../../src/builders/create-claude-model-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,qBAAqB,EAG1B,KAAK,QAAQ,EACd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAEpE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,kBAAkB,EAC5B,WAAW,CAAC,EAAE,QAAQ,CAAC,qBAAqB,CAAC,GAC5C,kBAAkB,CAwCpB"}

package/dist/builders/create-claude-model-builder.js

@@ -2,12 +2,12 @@ import { extractAST, } from '@paraharness/core';
 /**
  * Creates an immutable `ClaudeModelBuilder` for an Anthropic Claude model configuration.
  *
- * Validates that both `alias` and `options.id` are non-empty strings and compiles to a frozen
- * passive `ClaudeModelNode` without performing network or environment I/O.
+ * Validates that both `alias` and the resolved `modelId` (`options?.id ?? alias`) are non-empty
+ * strings and compiles to a frozen passive `ClaudeModelNode` without performing network or environment I/O.
  *
- * @param {string}                                      alias       - Logical alias of the model.
- * @param {ClaudeModelOptions}                          options     - Provider model identifier and optional effort level.
- * @param {PoolNode<ClaudeAccountSeatNode> | undefined} accountPool - Optional compiled pool of Claude account seats.
+ * @param {string}                                      alias         - Logical alias of the model.
+ * @param {ClaudeModelOptions}                          [options]     - Optional provider model identifier and effort level.
+ * @param {PoolNode<ClaudeAccountSeatNode> | undefined} [accountPool] - Optional compiled pool of Claude account seats.
  *
  * @returns {ClaudeModelBuilder} Immutable builder compiling to `ClaudeModelNode`.
  *
@@ -17,28 +17,29 @@ export function createClaudeModelBuilder(alias, options, accountPool) {
     if (alias.trim().length === 0) {
         throw new Error('Claude model alias must be a non-empty string.');
     }
-    if (options.id.trim().length === 0) {
+    const resolvedModelId = options?.id ?? alias;
+    if (resolvedModelId.trim().length === 0) {
         throw new Error(`Claude model '${alias}' options.id must be a non-empty string.`);
     }
     const astNode = Object.freeze({
         type: 'claude:model',
         vendor: 'anthropic',
         alias,
-        modelId: options.id,
-        effort: options.effort,
+        modelId: resolvedModelId,
+        effort: options?.effort,
         accountPool,
     });
     return Object.freeze({
         alias,
-        modelId: options.id,
+        modelId: resolvedModelId,
         effort(level) {
-            return createClaudeModelBuilder(alias, { id: options.id, effort: level }, accountPool);
+            return createClaudeModelBuilder(alias, { id: resolvedModelId, effort: level }, accountPool);
         },
         accountPool(pool) {
-            return createClaudeModelBuilder(alias, options, extractAST(pool));
+            return createClaudeModelBuilder(alias, { id: resolvedModelId, effort: options?.effort }, extractAST(pool));
         },
         pool(pool) {
-            return createClaudeModelBuilder(alias, options, extractAST(pool));
+            return createClaudeModelBuilder(alias, { id: resolvedModelId, effort: options?.effort }, extractAST(pool));
         },
         toAST() {
             return astNode;

package/dist/builders/create-claude-model-builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-claude-model-builder.js","sourceRoot":"","sources":["../../src/builders/create-claude-model-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,GAKX,MAAM,mBAAmB,CAAC;AAI3B;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,wBAAwB,CACtC,KAAa,EACb,OAA2B,EAC3B,WAA6C;IAE7C,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IACD,IAAI,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,iBAAiB,KAAK,0CAA0C,CAAC,CAAC;IACpF,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAkB;QAC7C,IAAI,EAAE,cAAc;QACpB,MAAM,EAAE,WAAW;QACnB,KAAK;QACL,OAAO,EAAE,OAAO,CAAC,EAAE;QACnB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,WAAW;KACZ,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,MAAM,CAAqB;QACvC,KAAK;QACL,OAAO,EAAE,OAAO,CAAC,EAAE;QACnB,MAAM,CAAC,KAAgC;YACrC,OAAO,wBAAwB,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,WAAW,CAAC,CAAC;QACzF,CAAC;QACD,WAAW,CAAC,IAAmD;YAC7D,OAAO,wBAAwB,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;QACpE,CAAC;QACD,IAAI,CAAC,IAAmD;YACtD,OAAO,wBAAwB,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;QACpE,CAAC;QACD,KAAK;YACH,OAAO,OAAO,CAAC;QACjB,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"create-claude-model-builder.js","sourceRoot":"","sources":["../../src/builders/create-claude-model-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,GAKX,MAAM,mBAAmB,CAAC;AAI3B;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,wBAAwB,CACtC,KAAa,EACb,OAA4B,EAC5B,WAA6C;IAE7C,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IACD,MAAM,eAAe,GAAG,OAAO,EAAE,EAAE,IAAI,KAAK,CAAC;IAC7C,IAAI,eAAe,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,iBAAiB,KAAK,0CAA0C,CAAC,CAAC;IACpF,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAkB;QAC7C,IAAI,EAAE,cAAc;QACpB,MAAM,EAAE,WAAW;QACnB,KAAK;QACL,OAAO,EAAE,eAAe;QACxB,MAAM,EAAE,OAAO,EAAE,MAAM;QACvB,WAAW;KACZ,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,MAAM,CAAqB;QACvC,KAAK;QACL,OAAO,EAAE,eAAe;QACxB,MAAM,CAAC,KAAgC;YACrC,OAAO,wBAAwB,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE,eAAe,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,WAAW,CAAC,CAAC;QAC9F,CAAC;QACD,WAAW,CAAC,IAAmD;YAC7D,OAAO,wBAAwB,CAC7B,KAAK,EACL,EAAE,EAAE,EAAE,eAAe,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAChD,UAAU,CAAC,IAAI,CAAC,CACjB,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,IAAmD;YACtD,OAAO,wBAAwB,CAC7B,KAAK,EACL,EAAE,EAAE,EAAE,eAAe,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAChD,UAAU,CAAC,IAAI,CAAC,CACjB,CAAC;QACJ,CAAC;QACD,KAAK;YACH,OAAO,OAAO,CAAC;QACjB,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paraharness/claude",
-  "version": "0.1.0",
+  "version": "0.2.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",
@@ -45,7 +45,7 @@
   "dependencies": {
     "@anthropic-ai/sdk": "^1.6.0",
     "zod": "^4.6.7",
-    "@paraharness/core": "0.1.0"
+    "@paraharness/core": "0.2.0"
   },
   "devDependencies": {
     "@types/node": "^22.9.0",