@substrate-ai/core 0.19.54

package/dist/adapters/index.js

@@ -0,0 +1,14 @@
+// Export adapter types (SpawnCommand, AdapterOptions, AdapterCapabilities, etc.)
+export * from './types.js';
+// Concrete AdapterRegistry class (satisfies the AdapterRegistry interface structurally)
+export { AdapterRegistry } from './adapter-registry.js';
+// CLI adapter implementations
+export { ClaudeCodeAdapter } from './claude-adapter.js';
+export { CodexCLIAdapter } from './codex-adapter.js';
+export { GeminiCLIAdapter } from './gemini-adapter.js';
+// Zod validation schemas
+export * from './schemas.js';
+// Adapter hardening — format error and multi-strategy normalizer (story 53-10)
+export { AdapterFormatError } from './adapter-format-error.js';
+export { AdapterOutputNormalizer } from './adapter-output-normalizer.js';
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,cAAc,YAAY,CAAA;AAI1B,wFAAwF;AACxF,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACvD,8BAA8B;AAC9B,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AACtD,yBAAyB;AACzB,cAAc,cAAc,CAAA;AAC5B,+EAA+E;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAA"}

package/dist/adapters/schemas.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Zod validation schemas for WorkerAdapter types
+ * Enables runtime validation and extensibility for custom adapters (NFR13)
+ */
+import { z } from 'zod';
+/**
+ * Schema for BillingMode values
+ */
+export declare const BillingModeSchema: z.ZodEnum<{
+    subscription: "subscription";
+    api: "api";
+    free: "free";
+}>;
+/**
+ * Schema for SpawnCommand — the descriptor used to spawn a CLI agent process.
+ */
+export declare const SpawnCommandSchema: z.ZodObject<{
+    binary: z.ZodString;
+    args: z.ZodArray<z.ZodString>;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    cwd: z.ZodString;
+    stdin: z.ZodOptional<z.ZodString>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * Schema for AdapterOptions — per-invocation execution configuration.
+ */
+export declare const AdapterOptionsSchema: z.ZodObject<{
+    worktreePath: z.ZodString;
+    billingMode: z.ZodEnum<{
+        subscription: "subscription";
+        api: "api";
+        free: "free";
+    }>;
+    model: z.ZodOptional<z.ZodString>;
+    additionalFlags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    apiKey: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Schema for AdapterCapabilities — what a CLI agent supports.
+ * Custom adapters can extend this schema with additional fields (NFR13).
+ */
+export declare const AdapterCapabilitiesSchema: z.ZodObject<{
+    supportsJsonOutput: z.ZodBoolean;
+    supportsStreaming: z.ZodBoolean;
+    supportsSubscriptionBilling: z.ZodBoolean;
+    supportsApiBilling: z.ZodBoolean;
+    supportsPlanGeneration: z.ZodBoolean;
+    maxContextTokens: z.ZodNumber;
+    supportedTaskTypes: z.ZodArray<z.ZodString>;
+    supportedLanguages: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Schema for AdapterHealthResult — health check output.
+ */
+export declare const AdapterHealthResultSchema: z.ZodObject<{
+    healthy: z.ZodBoolean;
+    version: z.ZodOptional<z.ZodString>;
+    cliPath: z.ZodOptional<z.ZodString>;
+    error: z.ZodOptional<z.ZodString>;
+    detectedBillingModes: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        subscription: "subscription";
+        api: "api";
+        free: "free";
+    }>>>;
+    supportsHeadless: z.ZodBoolean;
+}, z.core.$strip>;
+/**
+ * Schema for TokenEstimate
+ */
+export declare const TokenEstimateSchema: z.ZodObject<{
+    input: z.ZodNumber;
+    output: z.ZodNumber;
+    total: z.ZodNumber;
+}, z.core.$strip>;
+/**
+ * Schema for TaskResult — normalized CLI output.
+ */
+export declare const TaskResultSchema: z.ZodObject<{
+    taskId: z.ZodOptional<z.ZodString>;
+    success: z.ZodBoolean;
+    output: z.ZodString;
+    error: z.ZodOptional<z.ZodString>;
+    exitCode: z.ZodNumber;
+    metadata: z.ZodOptional<z.ZodObject<{
+        executionTime: z.ZodOptional<z.ZodNumber>;
+        tokensUsed: z.ZodOptional<z.ZodObject<{
+            input: z.ZodNumber;
+            output: z.ZodNumber;
+            total: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Schema for PlannedTask — a single task in a generated plan.
+ */
+export declare const PlannedTaskSchema: z.ZodObject<{
+    title: z.ZodString;
+    description: z.ZodString;
+    complexity: z.ZodOptional<z.ZodNumber>;
+    dependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Schema for PlanParseResult — plan generation output.
+ */
+export declare const PlanParseResultSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    tasks: z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        description: z.ZodString;
+        complexity: z.ZodOptional<z.ZodNumber>;
+        dependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    error: z.ZodOptional<z.ZodString>;
+    rawOutput: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Generic validator that wraps Zod parse and throws AdtError on failure.
+ * @param schema  Zod schema to validate against
+ * @param data    Unknown data to parse
+ * @param label   Human-readable label for error messages
+ * @returns Parsed and typed data
+ */
+export declare function validateWithSchema<T>(schema: z.ZodType<T>, data: unknown, label: string): T;
+/**
+ * Validate a SpawnCommand object, throwing AdtError on failure.
+ */
+export declare function validateSpawnCommand(data: unknown): z.infer<typeof SpawnCommandSchema>;
+/**
+ * Validate AdapterCapabilities, throwing AdtError on failure.
+ */
+export declare function validateAdapterCapabilities(data: unknown): z.infer<typeof AdapterCapabilitiesSchema>;
+/**
+ * Validate AdapterHealthResult, throwing AdtError on failure.
+ */
+export declare function validateAdapterHealthResult(data: unknown): z.infer<typeof AdapterHealthResultSchema>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/adapters/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/adapters/schemas.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAOvB;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;EAA0C,CAAA;AAExE;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;iBAO7B,CAAA;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;iBAM/B,CAAA;AAEF;;;GAGG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;iBASpC,CAAA;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;iBAOpC,CAAA;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;iBAI9B,CAAA;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;iBAY3B,CAAA;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;iBAK5B,CAAA;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;iBAKhC,CAAA;AAMF;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAClC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EACpB,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,MAAM,GACZ,CAAC,CAaH;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAEtF;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAMpG;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAMpG"}

package/dist/adapters/schemas.js

@@ -0,0 +1,140 @@
+/**
+ * Zod validation schemas for WorkerAdapter types
+ * Enables runtime validation and extensibility for custom adapters (NFR13)
+ */
+import { z } from 'zod';
+import { AdtError } from '../config/errors.js';
+// ---------------------------------------------------------------------------
+// Base schemas
+// ---------------------------------------------------------------------------
+/**
+ * Schema for BillingMode values
+ */
+export const BillingModeSchema = z.enum(['subscription', 'api', 'free']);
+/**
+ * Schema for SpawnCommand — the descriptor used to spawn a CLI agent process.
+ */
+export const SpawnCommandSchema = z.object({
+    binary: z.string().min(1),
+    args: z.array(z.string()),
+    env: z.record(z.string(), z.string()).optional(),
+    cwd: z.string().min(1),
+    stdin: z.string().optional(),
+    timeoutMs: z.number().int().positive().optional(),
+});
+/**
+ * Schema for AdapterOptions — per-invocation execution configuration.
+ */
+export const AdapterOptionsSchema = z.object({
+    worktreePath: z.string().min(1),
+    billingMode: BillingModeSchema,
+    model: z.string().optional(),
+    additionalFlags: z.array(z.string()).optional(),
+    apiKey: z.string().optional(),
+});
+/**
+ * Schema for AdapterCapabilities — what a CLI agent supports.
+ * Custom adapters can extend this schema with additional fields (NFR13).
+ */
+export const AdapterCapabilitiesSchema = z.object({
+    supportsJsonOutput: z.boolean(),
+    supportsStreaming: z.boolean(),
+    supportsSubscriptionBilling: z.boolean(),
+    supportsApiBilling: z.boolean(),
+    supportsPlanGeneration: z.boolean(),
+    maxContextTokens: z.number().int().positive(),
+    supportedTaskTypes: z.array(z.string()),
+    supportedLanguages: z.array(z.string()),
+});
+/**
+ * Schema for AdapterHealthResult — health check output.
+ */
+export const AdapterHealthResultSchema = z.object({
+    healthy: z.boolean(),
+    version: z.string().optional(),
+    cliPath: z.string().optional(),
+    error: z.string().optional(),
+    detectedBillingModes: z.array(BillingModeSchema).optional(),
+    supportsHeadless: z.boolean(),
+});
+/**
+ * Schema for TokenEstimate
+ */
+export const TokenEstimateSchema = z.object({
+    input: z.number().int().nonnegative(),
+    output: z.number().int().nonnegative(),
+    total: z.number().int().nonnegative(),
+});
+/**
+ * Schema for TaskResult — normalized CLI output.
+ */
+export const TaskResultSchema = z.object({
+    taskId: z.string().optional(),
+    success: z.boolean(),
+    output: z.string(),
+    error: z.string().optional(),
+    exitCode: z.number().int(),
+    metadata: z
+        .object({
+        executionTime: z.number().optional(),
+        tokensUsed: TokenEstimateSchema.optional(),
+    })
+        .optional(),
+});
+/**
+ * Schema for PlannedTask — a single task in a generated plan.
+ */
+export const PlannedTaskSchema = z.object({
+    title: z.string().min(1),
+    description: z.string(),
+    complexity: z.number().int().min(1).max(10).optional(),
+    dependencies: z.array(z.string()).optional(),
+});
+/**
+ * Schema for PlanParseResult — plan generation output.
+ */
+export const PlanParseResultSchema = z.object({
+    success: z.boolean(),
+    tasks: z.array(PlannedTaskSchema),
+    error: z.string().optional(),
+    rawOutput: z.string().optional(),
+});
+// ---------------------------------------------------------------------------
+// Validator helpers
+// ---------------------------------------------------------------------------
+/**
+ * Generic validator that wraps Zod parse and throws AdtError on failure.
+ * @param schema  Zod schema to validate against
+ * @param data    Unknown data to parse
+ * @param label   Human-readable label for error messages
+ * @returns Parsed and typed data
+ */
+export function validateWithSchema(schema, data, label) {
+    const result = schema.safeParse(data);
+    if (!result.success) {
+        const issues = result.error.issues
+            .map((i) => `${i.path.join('.')}: ${i.message}`)
+            .join('; ');
+        throw new AdtError(`Validation failed for ${label}: ${issues}`, 'VALIDATION_ERROR', { label, issues: result.error.issues });
+    }
+    return result.data;
+}
+/**
+ * Validate a SpawnCommand object, throwing AdtError on failure.
+ */
+export function validateSpawnCommand(data) {
+    return validateWithSchema(SpawnCommandSchema, data, 'SpawnCommand');
+}
+/**
+ * Validate AdapterCapabilities, throwing AdtError on failure.
+ */
+export function validateAdapterCapabilities(data) {
+    return validateWithSchema(AdapterCapabilitiesSchema, data, 'AdapterCapabilities');
+}
+/**
+ * Validate AdapterHealthResult, throwing AdtError on failure.
+ */
+export function validateAdapterHealthResult(data) {
+    return validateWithSchema(AdapterHealthResultSchema, data, 'AdapterHealthResult');
+}
+//# sourceMappingURL=schemas.js.map

package/dist/adapters/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../src/adapters/schemas.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAE9C,8EAA8E;AAC9E,eAAe;AACf,8EAA8E;AAE9E;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,cAAc,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAA;AAExE;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACzB,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAChD,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACtB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAClD,CAAC,CAAA;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/B,WAAW,EAAE,iBAAiB;IAC9B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC/C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC,CAAA;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,kBAAkB,EAAE,CAAC,CAAC,OAAO,EAAE;IAC/B,iBAAiB,EAAE,CAAC,CAAC,OAAO,EAAE;IAC9B,2BAA2B,EAAE,CAAC,CAAC,OAAO,EAAE;IACxC,kBAAkB,EAAE,CAAC,CAAC,OAAO,EAAE;IAC/B,sBAAsB,EAAE,CAAC,CAAC,OAAO,EAAE;IACnC,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAC7C,kBAAkB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACvC,kBAAkB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CACxC,CAAC,CAAA;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,oBAAoB,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,QAAQ,EAAE;IAC3D,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE;CAC9B,CAAC,CAAA;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACrC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACtC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;CACtC,CAAC,CAAA;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAC1B,QAAQ,EAAE,CAAC;SACR,MAAM,CAAC;QACN,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACpC,UAAU,EAAE,mBAAmB,CAAC,QAAQ,EAAE;KAC3C,CAAC;SACD,QAAQ,EAAE;CACd,CAAC,CAAA;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IACtD,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC7C,CAAC,CAAA;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC;IACjC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAA;AAEF,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAoB,EACpB,IAAa,EACb,KAAa;IAEb,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;IACrC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM;aAC/B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;aAC/C,IAAI,CAAC,IAAI,CAAC,CAAA;QACb,MAAM,IAAI,QAAQ,CAChB,yBAAyB,KAAK,KAAK,MAAM,EAAE,EAC3C,kBAAkB,EAClB,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CACvC,CAAA;IACH,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAA;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAa;IAChD,OAAO,kBAAkB,CAAC,kBAAkB,EAAE,IAAI,EAAE,cAAc,CAAC,CAAA;AACrE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,2BAA2B,CAAC,IAAa;IACvD,OAAO,kBAAkB,CACvB,yBAAyB,EACzB,IAAI,EACJ,qBAAqB,CACtB,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,2BAA2B,CAAC,IAAa;IACvD,OAAO,kBAAkB,CACvB,yBAAyB,EACzB,IAAI,EACJ,qBAAqB,CACtB,CAAA;AACH,CAAC"}

package/dist/adapters/types.d.ts

@@ -0,0 +1,245 @@
+/**
+ * Type definitions for the WorkerAdapter subsystem
+ * All adapter types are defined here for consistency and reuse
+ */
+import type { AgentId, BillingMode, TaskId } from '../types.js';
+/**
+ * A spawn command descriptor that the orchestrator uses to invoke a CLI agent.
+ * Contains all information needed to execute an agent process.
+ */
+export interface SpawnCommand {
+    /** The binary to execute (e.g., "claude", "codex", "gemini") */
+    binary: string;
+    /** Arguments to pass to the binary */
+    args: string[];
+    /** Optional environment variable overrides */
+    env?: Record<string, string>;
+    /** Optional list of environment variable keys to unset in the child process */
+    unsetEnvKeys?: string[];
+    /** Working directory for the process */
+    cwd: string;
+    /** Optional data to pipe to stdin */
+    stdin?: string;
+    /** Optional timeout in milliseconds */
+    timeoutMs?: number;
+}
+/**
+ * Options passed to adapter methods for each invocation.
+ * Controls execution context for a specific task run.
+ */
+export interface AdapterOptions {
+    /** Path to the git worktree for this task */
+    worktreePath: string;
+    /** Billing mode to use for this execution */
+    billingMode: BillingMode;
+    /** Optional model identifier override */
+    model?: string;
+    /** Optional additional CLI flags to append */
+    additionalFlags?: string[];
+    /** Optional API key override (used when billingMode is 'api') */
+    apiKey?: string;
+    /** Optional maximum agentic turns (passed as --max-turns to Claude CLI) */
+    maxTurns?: number;
+    /**
+     * Optional OTLP endpoint URL for telemetry export (Story 27-9).
+     * When set, injects OTLP env vars into the spawned process so that
+     * Claude Code exports telemetry to the local IngestionServer.
+     * Example: "http://localhost:4318"
+     */
+    otlpEndpoint?: string;
+    /**
+     * Optional story key for OTEL resource attribute tagging.
+     * Injected as `substrate.story_key` via OTEL_RESOURCE_ATTRIBUTES
+     * so the telemetry pipeline can group spans/events per story.
+     */
+    storyKey?: string;
+    /**
+     * Optional maximum context tokens (passed as --max-context-tokens to Claude CLI).
+     * When set, constrains the context window to prevent runaway token usage.
+     * Used by efficiency-gated retry logic (Story 30-8) to cap context for stories
+     * that previously exhibited context spike patterns.
+     */
+    maxContextTokens?: number;
+    /**
+     * Optional optimization directives derived from prior stories' telemetry (Story 30-6).
+     * When set, appended to the system prompt to guide the sub-agent toward efficient patterns.
+     * Generated by TelemetryAdvisor.formatOptimizationDirectives().
+     */
+    optimizationDirectives?: string;
+    /** Dispatch context: task type (create-story, dev-story, code-review, etc.) for OTLP attribution */
+    taskType?: string;
+    /** Dispatch context: unique dispatch ID for per-dispatch telemetry correlation */
+    dispatchId?: string;
+}
+/**
+ * Capabilities reported by an adapter for this CLI agent.
+ * Used for routing and planning decisions.
+ */
+export interface AdapterCapabilities {
+    /** Whether the agent outputs structured JSON */
+    supportsJsonOutput: boolean;
+    /** Whether the agent supports streaming output */
+    supportsStreaming: boolean;
+    /** Whether the agent supports subscription-based billing */
+    supportsSubscriptionBilling: boolean;
+    /** Whether the agent supports API-key-based billing */
+    supportsApiBilling: boolean;
+    /** Whether the agent can generate task planning graphs */
+    supportsPlanGeneration: boolean;
+    /** Maximum context tokens the agent supports */
+    maxContextTokens: number;
+    /** Task types this agent can handle */
+    supportedTaskTypes: string[];
+    /** Programming languages the agent supports */
+    supportedLanguages: string[];
+    /**
+     * Timeout multiplier relative to default dispatch timeouts.
+     * Agents that are slower (e.g., Codex) declare a multiplier > 1.0
+     * so the dispatcher scales timeouts automatically.
+     * Default: 1.0 (no scaling).
+     */
+    timeoutMultiplier?: number;
+    /**
+     * Whether the agent supports a --system-prompt flag.
+     * Claude Code: true. Codex/Gemini: false.
+     * When false, system-level instructions must be embedded in the prompt itself.
+     */
+    supportsSystemPrompt?: boolean;
+    /**
+     * Whether the agent exports OTLP telemetry (spans, metrics, logs).
+     * Claude Code: true. Codex/Gemini: false.
+     * When false, telemetry is heuristic-only (character-based token estimates).
+     */
+    supportsOtlpExport?: boolean;
+    /**
+     * Whether the dispatcher should append a YAML output format reminder to prompts.
+     * Claude Code: false (follows methodology pack format instructions reliably).
+     * Codex/Gemini: true (need explicit final nudge to emit fenced YAML blocks).
+     */
+    requiresYamlSuffix?: boolean;
+    /**
+     * Default maximum review cycles for this agent backend.
+     * Claude Code: 2 (converges quickly). Codex: 3 (needs more iterations).
+     * Overridden by explicit --max-review-cycles CLI flag.
+     */
+    defaultMaxReviewCycles?: number;
+}
+/**
+ * Result returned from an adapter health check.
+ * Indicates whether the CLI binary is present and functional.
+ */
+export interface AdapterHealthResult {
+    /** Whether the adapter is considered healthy and usable */
+    healthy: boolean;
+    /** Detected version string of the CLI binary */
+    version?: string;
+    /** Full path to the CLI binary, if resolved */
+    cliPath?: string;
+    /** Error message when healthy is false */
+    error?: string;
+    /** Detected billing mode(s) available for this adapter */
+    detectedBillingModes?: BillingMode[];
+    /** Whether the CLI supports headless/non-interactive mode */
+    supportsHeadless: boolean;
+}
+/**
+ * Parsed result from a task execution.
+ * Normalized representation from CLI agent JSON output.
+ */
+export interface TaskResult {
+    /** Task identifier this result belongs to */
+    taskId?: TaskId;
+    /** Whether the task completed successfully */
+    success: boolean;
+    /** Primary output content from the agent */
+    output: string;
+    /** Error message if the task failed */
+    error?: string;
+    /** Raw exit code from the CLI process */
+    exitCode: number;
+    /** Execution metadata */
+    metadata?: {
+        executionTime?: number;
+        tokensUsed?: TokenEstimate;
+    };
+    /**
+     * True when the dispatcher's AdapterOutputNormalizer exhausted all
+     * normalization strategies without extracting parseable YAML.
+     * Authoritative signal for the 'adapter-format' root cause category (story 53-10).
+     * Optional — existing callers without the field continue to compile unchanged.
+     */
+    adapterError?: boolean;
+}
+/**
+ * Token usage estimate for budget tracking.
+ */
+export interface TokenEstimate {
+    /** Estimated input tokens */
+    input: number;
+    /** Estimated output tokens */
+    output: number;
+    /** Total token estimate */
+    total: number;
+}
+/**
+ * Request input for plan generation.
+ */
+export interface PlanRequest {
+    /** High-level goal or description of work to plan */
+    goal: string;
+    /** Additional context for the planning agent */
+    context?: string;
+    /** Maximum number of tasks to generate */
+    maxTasks?: number;
+}
+/**
+ * Parsed result from a plan generation invocation.
+ */
+export interface PlanParseResult {
+    /** Whether plan generation succeeded */
+    success: boolean;
+    /** Parsed list of planned task descriptions */
+    tasks: PlannedTask[];
+    /** Error message if plan generation failed */
+    error?: string;
+    /** Raw output for debugging */
+    rawOutput?: string;
+}
+/**
+ * A single task entry in a generated plan.
+ */
+export interface PlannedTask {
+    /** Task title */
+    title: string;
+    /** Detailed description */
+    description: string;
+    /** Estimated complexity (1-10) */
+    complexity?: number;
+    /** Other task titles this task depends on */
+    dependencies?: string[];
+}
+/**
+ * Result from a single adapter discovery attempt.
+ */
+export interface AdapterDiscoveryResult {
+    /** Adapter id that was tried */
+    adapterId: AgentId;
+    /** Display name of the adapter */
+    displayName: string;
+    /** Health check result */
+    healthResult: AdapterHealthResult;
+    /** Whether the adapter was registered (healthy) */
+    registered: boolean;
+}
+/**
+ * Summary result from discoverAndRegister().
+ */
+export interface DiscoveryReport {
+    /** Number of adapters successfully registered */
+    registeredCount: number;
+    /** Number of adapters that failed health checks */
+    failedCount: number;
+    /** Per-adapter detail results */
+    results: AdapterDiscoveryResult[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/adapters/types.d.ts.map

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

package/dist/adapters/types.js

@@ -0,0 +1,6 @@
+/**
+ * Type definitions for the WorkerAdapter subsystem
+ * All adapter types are defined here for consistency and reuse
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/adapters/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}