@mknightzzz/stw 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,405 @@
+import type { AgenticBackend, AgenticConfig, AgenticFallbackConfig } from './agentic-types.js';
+export declare const RUN_STATES: readonly ["pending", "planning", "plan_blocked", "plan_ready", "routing", "running", "paused", "human_review_required", "complete", "failed", "stopped"];
+export type RunState = (typeof RUN_STATES)[number];
+export declare const TERMINAL_RUN_STATES: readonly RunState[];
+export declare const TASK_STATES: readonly ["pending", "queued", "working", "diagnosing", "validating", "reviewing", "revision_requested", "retrying", "escalated", "question_pending", "waiting_for_human", "rejected", "complete", "failed", "skipped"];
+export type TaskState = (typeof TASK_STATES)[number];
+export declare const TERMINAL_TASK_STATES: readonly TaskState[];
+export type PhaseChangeState = 'pending' | 'running' | 'success' | 'failed';
+export declare const MODEL_TIERS: readonly ["cheap", "medium", "strong", "reader"];
+export type ModelTier = (typeof MODEL_TIERS)[number];
+export interface ModelEntry {
+    id: string;
+    provider: string;
+    model: string;
+    tier: ModelTier;
+    input_cost_per_mtok: number;
+    output_cost_per_mtok: number;
+}
+export type ModelsConfig = Record<string, Omit<ModelEntry, 'id'>>;
+export declare const RISK_LEVELS: readonly ["low", "medium", "high"];
+export type RiskLevel = (typeof RISK_LEVELS)[number];
+export declare const STATUS_VALUES: readonly ["in_progress", "complete", "blocked", "failed", "escalated", "question", "skipped"];
+export type StatusValue = (typeof STATUS_VALUES)[number];
+export declare const RETRY_CONTEXT_LEVELS: readonly ["minimal", "basic", "full"];
+export type RetryContextLevel = (typeof RETRY_CONTEXT_LEVELS)[number];
+export declare const EXECUTION_MODES: readonly ["conservative", "agentic"];
+export type ExecutionMode = (typeof EXECUTION_MODES)[number];
+export declare const EXECUTION_OBSERVABILITY_MODES: readonly ["conservative_only", "fallback_to_agentic", "direct_agentic"];
+export type ExecutionObservabilityMode = (typeof EXECUTION_OBSERVABILITY_MODES)[number];
+export declare const FAILURE_CATEGORIES: readonly ["scope_violation", "validation_failed", "review_rejected", "provider_error", "content_null", "budget_exceeded", "worker_crash", "diff_empty", "parse_error"];
+export type FailureCategory = (typeof FAILURE_CATEGORIES)[number];
+export declare const ACTIONABLE_FAILURE_CLASSES: readonly ["backend_invocation_or_setup_failure", "backend_unavailable_during_fallback", "no_useful_in_scope_change", "out_of_scope_mutation", "post_mutation_validation_or_review_failure", "merge_conflict_needs_retry"];
+export type ActionableFailureClass = (typeof ACTIONABLE_FAILURE_CLASSES)[number];
+/** Failure classes where retrying at a higher tier won't help — the problem is structural, not stochastic. */
+export declare const STRUCTURAL_FAILURE_CLASSES: ReadonlySet<ActionableFailureClass>;
+export declare const ACTIONABLE_FAILURE_CLASS_TO_CATEGORY: Record<ActionableFailureClass, FailureCategory>;
+export interface WorkerModeConfig {
+    enabled?: boolean;
+}
+export interface WorkerModesConfig {
+    fresh_context?: WorkerModeConfig;
+    retry_with_context?: WorkerModeConfig;
+}
+export interface ParsedSpec {
+    title: string;
+    objective: string;
+    context: string;
+    requirements: string;
+    constraints: string;
+    acceptance_criteria: string;
+    risk_assessment: string;
+    target_files?: string;
+    non_goals?: string;
+    notes_for_reviewer?: string;
+    commands_to_validate?: string;
+}
+export declare const REQUIRED_SPEC_SECTIONS: readonly ["Objective", "Context", "Requirements", "Constraints", "Acceptance Criteria", "Risk Assessment"];
+export interface RunManifest {
+    schema_version: 1;
+    run_id: string;
+    spec_path: string;
+    repo_root: string;
+    base_branch: string;
+    branch: string;
+    status: RunState;
+    pr_number: number | null;
+    created_at: string;
+    pause_reason?: string;
+    drift_detected?: boolean;
+    last_polled_comment_id?: number;
+    spec_started_at?: string;
+    spec_completed_at?: string;
+    greenfield?: boolean;
+    seedDir?: string;
+}
+export interface TaskScope {
+    files: string[];
+    new_files?: string[];
+    allow_shared_files: boolean;
+}
+export interface TaskPlannerMetadata {
+    planner_eligible?: boolean;
+    planner_reason?: string;
+    execution_mode?: ExecutionMode;
+    consolidation_signals?: string[];
+    agentic_backend?: AgenticBackend;
+    fallback_to_single_call?: boolean;
+}
+export interface Task {
+    schema_version?: 1;
+    id: string;
+    description: string;
+    task_type: string;
+    risk: RiskLevel;
+    state: TaskState;
+    scope: TaskScope;
+    dependencies: string[];
+    acceptance_checks: string[];
+    model_tier: ModelTier;
+    provider_hint?: string;
+    max_retries: number;
+    timeout_minutes: number;
+    spec_path?: string;
+    planner_metadata?: TaskPlannerMetadata;
+}
+export interface TaskGraph {
+    schema_version: 1;
+    run_id: string;
+    tasks: Task[];
+}
+export interface CompletedTaskContext {
+    task_id: string;
+    description: string;
+    status: StatusValue;
+    notes: string;
+}
+export declare const DEFAULT_MAX_PROMPT_TOKENS = 32000;
+export interface OversizedTask {
+    taskId: string;
+    estimatedTokens: number;
+    maxTokens: number;
+}
+export interface PromptSizeCheckResult {
+    oversizedTasks: OversizedTask[];
+    valid: boolean;
+}
+export interface Assignment {
+    task_id: string;
+    agent_id: string;
+    tool: string;
+    model: string;
+    tier: ModelTier;
+    reason: string;
+}
+export interface AssignmentsFile {
+    schema_version: 1;
+    run_id: string;
+    assignments: Assignment[];
+}
+export interface TaskStatus {
+    schema_version: 1;
+    task_id: string;
+    agent_id: string;
+    status: StatusValue;
+    completed_at: string;
+    notes: string;
+    question_number?: number;
+    preserved_worktree_path?: string;
+    preserved_worktree_paths?: string[];
+    stop_reason?: string;
+    stopped_at?: string;
+    stopped_by?: string;
+    execution_mode?: ExecutionObservabilityMode;
+    failure_class?: ActionableFailureClass;
+}
+export interface WorkerQuestionArtifact {
+    schema_version: 1;
+    task_id: string;
+    status: 'question';
+    question: string;
+    question_number: number;
+    created_at: string;
+}
+export interface WorkerQuestionAnswerArtifact {
+    schema_version: 1;
+    task_id: string;
+    question_number: number;
+    answer: string;
+    answered_at?: string;
+    answered_by?: string;
+}
+export interface QuestionTriageArtifact {
+    schema_version: 1;
+    task_id: string;
+    question: string;
+    question_number: number;
+    question_thread_id: string;
+    decision: 'auto_answer' | 'ask_human';
+    reason: string;
+    answer?: string;
+    confidence?: number;
+    created_at: string;
+}
+export interface ProcessedNotesCheckpointRecord {
+    schema_version: 1;
+    mr_iid: number;
+    last_seen_at: string;
+    last_processed_note_id: number | null;
+    processed_note_ids: number[];
+    updated_at: string;
+}
+export interface PricingEntry {
+    model: string;
+    input_cost_per_mtok: number;
+    output_cost_per_mtok: number;
+}
+export interface PricingConfig {
+    [model: string]: PricingEntry;
+}
+export interface CostEntry {
+    task_id: string;
+    model: string;
+    provider: string;
+    input_tokens: number;
+    output_tokens: number;
+    cost_usd: number;
+    timestamp: string;
+    tier: ModelTier;
+    latency_ms: number;
+}
+export interface CostsFile {
+    schema_version: 1;
+    run_id: string;
+    costs: CostEntry[];
+    total_cost_usd: number;
+    task_costs: Record<string, number>;
+    total_retries?: number;
+    task_retries?: Record<string, number>;
+}
+export interface TaskStateRecord {
+    schema_version: 1;
+    task_id: string;
+    state: TaskState;
+    updated_at: string;
+    updated_by: string;
+    previous_state: TaskState | null;
+}
+export interface ProviderConfig {
+    api_key_env: string;
+    base_url: string;
+    models: Partial<Record<ModelTier, string>>;
+}
+export interface RiskRuleEntry {
+    worker: ModelTier;
+    reviewer: ModelTier;
+}
+export interface RoutingPolicy {
+    require_plan_approval: boolean;
+    risk_rules?: Record<RiskLevel, RiskRuleEntry>;
+    task_type_rules?: Record<string, ModelTier>;
+    provider_preferences?: Partial<Record<ModelTier, string[]>>;
+    conservative_execution_task_types?: string[];
+}
+export interface BudgetConfig {
+    max_run_usd: number;
+    max_task_usd: number;
+    warn_threshold_pct: number;
+    on_exceed: 'warn' | 'pause';
+    max_run_retries?: number;
+}
+export interface CircuitBreakerConfig {
+    enabled?: boolean;
+    failure_threshold?: number;
+    success_threshold?: number;
+    timeout_seconds?: number;
+    half_open_max_requests?: number;
+}
+export interface TimeoutConfig {
+    task_timeout_minutes?: number;
+    api_timeout_seconds?: number;
+    poll_interval_seconds?: number;
+    overall_run_timeout_minutes?: number;
+}
+export interface CleanupConfig {
+    enabled?: boolean;
+    preserve_worktree_on_failure?: boolean;
+    cleanup_interval_minutes?: number;
+    max_worktrees_to_keep?: number;
+}
+export interface StwConfig {
+    providers: Record<string, ProviderConfig>;
+    routing_policy: RoutingPolicy;
+    defaults: {
+        poll_interval_seconds: number;
+        api_timeout_seconds: number;
+        task_timeout_minutes: number;
+        max_concurrent_workers: number;
+        max_retries: number;
+        max_questions_per_task: number;
+        max_auto_answers?: number;
+        max_prompt_tokens?: number;
+        max_scope_files_per_task?: number;
+        max_expansion_per_task?: number;
+        scope_trim_enabled?: boolean;
+        max_tasks_per_spec?: number;
+        authorized_commenters?: string[];
+        retry_context?: RetryContextLevel;
+        worker_modes?: WorkerModesConfig;
+        execution_mode?: ExecutionMode;
+        agentic_fallback?: AgenticFallbackConfig;
+        agentic?: AgenticConfig;
+        planner_max_retries?: number;
+        planner_fallback_models?: string[];
+    };
+    budget?: BudgetConfig;
+    pricing?: PricingConfig;
+    models?: ModelsConfig;
+    gitlab?: {
+        remote?: string;
+        base_branch?: string;
+        branch_prefix?: string;
+        allowed_command_users?: string[];
+    };
+    circuit_breaker?: CircuitBreakerConfig;
+    timeout?: TimeoutConfig;
+    cleanup?: CleanupConfig;
+}
+export interface ModelRequest {
+    model: string;
+    system_prompt?: string;
+    messages: Array<{
+        role: 'system' | 'user' | 'assistant';
+        content: string;
+    }>;
+    max_tokens?: number;
+    temperature?: number;
+    timeout_ms: number;
+    response_format?: 'text' | 'json';
+}
+export interface ModelResponse {
+    content: string;
+    model: string;
+    provider: string;
+    usage: {
+        input_tokens: number;
+        output_tokens: number;
+    };
+    latency_ms: number;
+    finish_reason: string;
+    raw_response_path?: string;
+}
+export type ProviderErrorCode = 'timeout';
+export declare class ProviderError extends Error {
+    readonly retryable: boolean;
+    readonly statusCode?: number;
+    readonly code?: ProviderErrorCode;
+    constructor(message: string, retryable: boolean, statusCode?: number, code?: ProviderErrorCode);
+}
+export type WorkerOutputFailureClass = 'malformed_json' | 'truncated_json' | 'missing_schema_version' | 'invalid_payload_shape' | 'provider_transport_failure';
+export interface WorkerOutputFailureEvent {
+    schema_version: 1;
+    task_id: string;
+    failure_class: WorkerOutputFailureClass;
+    message: string;
+    raw_content_length: number;
+    raw_content_preview: string;
+    timestamp: string;
+}
+export type RunEventType = 'manual_completion' | 'status_correction' | 'resume' | 'retry' | 'replan' | 'sync_repair' | 'stop' | 'answer' | 'escalation' | 'acceptance_gate_retry' | 'agentic_fallback' | 'manual_rescue';
+export type EscalationCategory = 'human_review' | 'spec_gap' | 'validation_failure' | 'integration_issue' | 'sync_issue' | 'budget' | 'drift' | 'operator_override' | 'other';
+export interface RunEvent {
+    schema_version: 1;
+    event_id: string;
+    run_id: string;
+    event_type: RunEventType;
+    created_at: string;
+    actor: string;
+    task_id?: string;
+    summary: string;
+    details?: string;
+    escalation_category?: EscalationCategory;
+    metadata?: Record<string, string | number | boolean | null>;
+}
+export interface RunEventsArtifact {
+    schema_version: 1;
+    run_id: string;
+    events: RunEvent[];
+}
+export interface RunMetricsMachine {
+    total_tasks?: number;
+    completed_tasks?: number;
+    failed_tasks?: number;
+    escalated_tasks?: number;
+    skipped_tasks?: number;
+    pending_tasks?: number;
+    total_cost_usd?: number;
+    total_input_tokens?: number;
+    total_output_tokens?: number;
+    avg_latency_ms?: number;
+    acceptance_gate_retries?: number;
+    agentic_fallback_triggers?: number;
+    manual_rescues?: number;
+    scope_trims?: number;
+    scope_trims_passed?: number;
+}
+export interface RunMetricsOperator {
+    objective_score?: number;
+    outcome_notes?: string;
+    true_cost_notes?: string;
+    intervention_notes?: string;
+}
+export interface RunMetricsArtifact {
+    schema_version: 1;
+    run_id: string;
+    machine: RunMetricsMachine;
+    operator?: RunMetricsOperator;
+    updated_at: string;
+}
+export interface SeedFileEntry {
+    relativePath: string;
+    absolutePath: string;
+    sizeBytes: number;
+    sizeHuman: string;
+    isBinary: boolean;
+}

package/dist/types.js

@@ -0,0 +1,101 @@
+// === State Enums ===
+export const RUN_STATES = [
+    'pending',
+    'planning',
+    'plan_blocked',
+    'plan_ready',
+    'routing',
+    'running',
+    'paused',
+    'human_review_required',
+    'complete',
+    'failed',
+    'stopped',
+];
+export const TERMINAL_RUN_STATES = ['complete', 'failed', 'stopped'];
+export const TASK_STATES = [
+    'pending',
+    'queued',
+    'working',
+    'diagnosing',
+    'validating',
+    'reviewing',
+    'revision_requested',
+    'retrying',
+    'escalated',
+    'question_pending',
+    'waiting_for_human',
+    'rejected',
+    'complete',
+    'failed',
+    'skipped',
+];
+export const TERMINAL_TASK_STATES = ['complete', 'rejected', 'failed'];
+export const MODEL_TIERS = ['cheap', 'medium', 'strong', 'reader'];
+export const RISK_LEVELS = ['low', 'medium', 'high'];
+export const STATUS_VALUES = [
+    'in_progress',
+    'complete',
+    'blocked',
+    'failed',
+    'escalated',
+    'question',
+    'skipped',
+];
+export const RETRY_CONTEXT_LEVELS = ['minimal', 'basic', 'full'];
+export const EXECUTION_MODES = ['conservative', 'agentic'];
+export const EXECUTION_OBSERVABILITY_MODES = ['conservative_only', 'fallback_to_agentic', 'direct_agentic'];
+export const FAILURE_CATEGORIES = [
+    'scope_violation',
+    'validation_failed',
+    'review_rejected',
+    'provider_error',
+    'content_null',
+    'budget_exceeded',
+    'worker_crash',
+    'diff_empty',
+    'parse_error',
+];
+export const ACTIONABLE_FAILURE_CLASSES = [
+    'backend_invocation_or_setup_failure',
+    'backend_unavailable_during_fallback',
+    'no_useful_in_scope_change',
+    'out_of_scope_mutation',
+    'post_mutation_validation_or_review_failure',
+    'merge_conflict_needs_retry',
+];
+/** Failure classes where retrying at a higher tier won't help — the problem is structural, not stochastic. */
+export const STRUCTURAL_FAILURE_CLASSES = new Set([
+    'out_of_scope_mutation',
+    'backend_unavailable_during_fallback',
+]);
+export const ACTIONABLE_FAILURE_CLASS_TO_CATEGORY = {
+    backend_invocation_or_setup_failure: 'provider_error',
+    backend_unavailable_during_fallback: 'provider_error',
+    no_useful_in_scope_change: 'diff_empty',
+    out_of_scope_mutation: 'scope_violation',
+    post_mutation_validation_or_review_failure: 'validation_failed',
+    merge_conflict_needs_retry: 'validation_failed',
+};
+export const REQUIRED_SPEC_SECTIONS = [
+    'Objective',
+    'Context',
+    'Requirements',
+    'Constraints',
+    'Acceptance Criteria',
+    'Risk Assessment',
+];
+export const DEFAULT_MAX_PROMPT_TOKENS = 32000;
+export class ProviderError extends Error {
+    retryable;
+    statusCode;
+    code;
+    constructor(message, retryable, statusCode, code) {
+        super(message);
+        this.name = 'ProviderError';
+        this.retryable = retryable;
+        this.statusCode = statusCode;
+        this.code = code;
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/utils.d.ts

@@ -0,0 +1 @@
+export declare function formatDuration(ms: number): string;

package/dist/utils.js

@@ -0,0 +1,23 @@
+export function formatDuration(ms) {
+    if (ms < 0) {
+        throw new Error('Duration cannot be negative');
+    }
+    if (ms < 1000) {
+        return `${ms}ms`;
+    }
+    const totalSeconds = ms / 1000;
+    const totalMinutes = totalSeconds / 60;
+    const totalHours = totalMinutes / 60;
+    if (totalSeconds < 60) {
+        return `${totalSeconds.toFixed(1)}s`;
+    }
+    if (totalMinutes < 60) {
+        const minutes = Math.floor(totalMinutes);
+        const seconds = Math.floor(totalSeconds % 60);
+        return `${minutes}m ${seconds}s`;
+    }
+    const hours = Math.floor(totalHours);
+    const minutes = Math.floor(totalMinutes % 60);
+    return `${hours}h ${minutes}m`;
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,cAAc,CAAC,EAAU;IACvC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACjD,CAAC;IAED,IAAI,EAAE,GAAG,IAAI,EAAE,CAAC;QACd,OAAO,GAAG,EAAE,IAAI,CAAC;IACnB,CAAC;IAED,MAAM,YAAY,GAAG,EAAE,GAAG,IAAI,CAAC;IAC/B,MAAM,YAAY,GAAG,YAAY,GAAG,EAAE,CAAC;IACvC,MAAM,UAAU,GAAG,YAAY,GAAG,EAAE,CAAC;IAErC,IAAI,YAAY,GAAG,EAAE,EAAE,CAAC;QACtB,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IACvC,CAAC;IAED,IAAI,YAAY,GAAG,EAAE,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QACzC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,EAAE,CAAC,CAAC;QAC9C,OAAO,GAAG,OAAO,KAAK,OAAO,GAAG,CAAC;IACnC,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACrC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,EAAE,CAAC,CAAC;IAC9C,OAAO,GAAG,KAAK,KAAK,OAAO,GAAG,CAAC;AACjC,CAAC"}

package/dist/validation.d.ts

@@ -0,0 +1,19 @@
+export interface ValidationCheck {
+    command: string;
+    passed: boolean;
+    exit_code: number;
+    stdout: string;
+    stderr: string;
+    duration_ms: number;
+}
+export interface ValidationResult {
+    passed: boolean;
+    checks: ValidationCheck[];
+}
+export interface ValidationOptions {
+    cwd: string;
+    commands: string[];
+    timeout_ms?: number;
+}
+export declare function needsShell(command: string): boolean;
+export declare function runValidation(options: ValidationOptions): Promise<ValidationResult>;

package/dist/validation.js

@@ -0,0 +1,73 @@
+import { execFileSync, execSync } from 'node:child_process';
+function splitCommand(command) {
+    const parts = command.trim().split(/\s+/);
+    if (parts.length === 0 || parts[0] === '') {
+        throw new Error(`Invalid empty command: "${command}"`);
+    }
+    return { file: parts[0], args: parts.slice(1) };
+}
+export function needsShell(command) {
+    const shellPattern = /[|>]|\|\||&&|;|\$\(|`/;
+    return shellPattern.test(command);
+}
+// TODO(M3): Replace execFileSync with async execFile to avoid blocking the
+// event loop. Currently safe because the task executor runs sequentially,
+// but this will block concurrent task execution if we parallelize later.
+export async function runValidation(options) {
+    const { cwd, commands, timeout_ms = 60000 } = options;
+    const checks = [];
+    for (const command of commands) {
+        const start = Date.now();
+        let passed = false;
+        let exit_code = -1;
+        let stdout = '';
+        let stderr = '';
+        const useShell = needsShell(command);
+        try {
+            if (useShell) {
+                const shellOpts = {
+                    cwd,
+                    encoding: 'utf-8',
+                    timeout: timeout_ms,
+                    shell: '/bin/sh',
+                };
+                stdout = execSync(command, shellOpts);
+            }
+            else {
+                const { file, args } = splitCommand(command);
+                const opts = {
+                    cwd,
+                    encoding: 'utf-8',
+                    stdio: ['pipe', 'pipe', 'pipe'],
+                    timeout: timeout_ms,
+                };
+                stdout = execFileSync(file, args, opts);
+            }
+            exit_code = 0;
+            passed = true;
+        }
+        catch (err) {
+            const error = err;
+            if (error.code === 'ENOENT') {
+                exit_code = 127;
+                stderr = `Command not found: ${command.split(/\s+/)[0]}`;
+            }
+            else if (error.killed || error.signal === 'SIGTERM') {
+                exit_code = error.status ?? -1;
+                stderr = `Command timed out after ${timeout_ms}ms`;
+            }
+            else {
+                exit_code = error.status ?? -1;
+                stdout = error.stdout ? String(error.stdout) : '';
+                stderr = error.stderr ? String(error.stderr) : '';
+            }
+        }
+        const duration_ms = Date.now() - start;
+        checks.push({ command, passed, exit_code, stdout: stdout.trim(), stderr: stderr.trim(), duration_ms });
+    }
+    return {
+        passed: checks.every((c) => c.passed),
+        checks,
+    };
+}
+//# sourceMappingURL=validation.js.map

package/dist/validation.js.map

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

package/dist/worker-response.d.ts

@@ -0,0 +1,12 @@
+import type { Task } from './types.js';
+export interface WorkerFileWrite {
+    path: string;
+    content: string;
+}
+export interface WorkerResponseArtifact {
+    schema_version: 1;
+    task_id: string;
+    files: WorkerFileWrite[];
+}
+export declare function stripCodeFences(content: string): string;
+export declare function parseWorkerResponse(task: Task, rawContent: string): WorkerResponseArtifact;