@mknightzzz/stw 0.1.0

package/dist/provider.js

@@ -0,0 +1,278 @@
+import { CircuitBreaker } from './circuit-breaker.js';
+import { ProviderError } from './types.js';
+const TRANSIENT_STATUS_CODES = new Set([429, 500, 502, 503, 504, 529]);
+const NON_TRANSIENT_STATUS_CODES = new Set([400, 401, 403, 422]);
+const MODEL_DATE_SUFFIX_PATTERN = /-\d{4,8}[a-zA-Z]*$/;
+const DEFAULT_TIER_TIMEOUTS = {
+    cheap: 120000,
+    medium: 300000,
+    strong: 600000,
+    reader: 300000,
+};
+const providerCircuitBreaker = new CircuitBreaker();
+function getTierTimeoutMs(tier, config) {
+    const timeoutConfig = config.timeout?.api_timeout_seconds;
+    const tierTimeoutOverride = config.defaults.api_timeout_seconds;
+    if (timeoutConfig && typeof timeoutConfig === 'object') {
+        const tierMs = timeoutConfig[tier];
+        if (typeof tierMs === 'number' && tierMs > 0) {
+            return tierMs;
+        }
+    }
+    const defaultMs = DEFAULT_TIER_TIMEOUTS[tier];
+    if (typeof defaultMs === 'number') {
+        return defaultMs;
+    }
+    return tierTimeoutOverride ? tierTimeoutOverride * 1000 : defaultMs;
+}
+export { getTierTimeoutMs };
+function getApiKey(envVar) {
+    const key = process.env[envVar];
+    if (!key) {
+        throw new ProviderError(`API key environment variable "${envVar}" is not set`, false);
+    }
+    return key;
+}
+function buildRequestBody(request) {
+    const messages = request.system_prompt
+        ? [{ role: 'system', content: request.system_prompt }, ...request.messages]
+        : request.messages;
+    const body = {
+        model: request.model,
+        messages,
+        max_tokens: request.max_tokens,
+        temperature: request.temperature,
+    };
+    if (request.response_format === 'json') {
+        body.response_format = { type: 'json_object' };
+    }
+    return body;
+}
+function logTimeoutWarning(provider, model, timeoutMs) {
+    const warning = {
+        event: 'provider_timeout',
+        provider,
+        model,
+        timeout_ms: timeoutMs,
+    };
+    console.warn(JSON.stringify(warning));
+}
+function createTimeoutError() {
+    return new ProviderError('Provider timeout exceeded', true, undefined, 'timeout');
+}
+function isAbortError(err) {
+    return err instanceof Error && err.name === 'AbortError';
+}
+async function doFetch(url, apiKey, body, signal) {
+    try {
+        return await fetch(url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${apiKey}`,
+            },
+            body: JSON.stringify(body),
+            signal,
+        });
+    }
+    catch (err) {
+        if (isAbortError(err)) {
+            throw createTimeoutError();
+        }
+        throw err;
+    }
+}
+async function readJsonWithTimeout(response, signal) {
+    try {
+        return (await Promise.race([
+            response.json(),
+            new Promise((_, reject) => {
+                signal.addEventListener('abort', () => reject(createTimeoutError()), { once: true });
+            }),
+        ]));
+    }
+    catch (err) {
+        if (err instanceof ProviderError) {
+            throw err;
+        }
+        if (isAbortError(err)) {
+            throw createTimeoutError();
+        }
+        throw err;
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function isTransientErrorStatus(statusCode) {
+    if (NON_TRANSIENT_STATUS_CODES.has(statusCode))
+        return false;
+    return TRANSIENT_STATUS_CODES.has(statusCode);
+}
+function isTransientError(error) {
+    if (error instanceof ProviderError) {
+        if (error.statusCode !== undefined) {
+            return isTransientErrorStatus(error.statusCode);
+        }
+        return error.retryable;
+    }
+    return false;
+}
+function preprocessModelName(name) {
+    return name.replace(MODEL_DATE_SUFFIX_PATTERN, '');
+}
+function buildModelNormalizationTable(configuredModels) {
+    return configuredModels.map((canonical) => {
+        const preprocessedCanonical = preprocessModelName(canonical);
+        const aliases = new Set([canonical, preprocessedCanonical]);
+        const canonicalParts = preprocessedCanonical.split('/');
+        const modelName = canonicalParts[1];
+        if (modelName !== undefined && canonical.startsWith('anthropic/')) {
+            aliases.add(modelName);
+        }
+        return {
+            canonical,
+            aliases: [...aliases],
+        };
+    });
+}
+export function normalizeModelName(rawName, configuredModels) {
+    const preprocessedRawName = preprocessModelName(rawName);
+    const normalizationTable = buildModelNormalizationTable(configuredModels);
+    const matchingConfiguredModels = normalizationTable
+        .filter((entry) => entry.aliases.some((alias) => alias === rawName || preprocessModelName(alias) === preprocessedRawName))
+        .map((entry) => entry.canonical);
+    if (matchingConfiguredModels.length > 1) {
+        // Multiple matches — deduplicate (same canonical can appear via pricing + models registry)
+        const unique = [...new Set(matchingConfiguredModels)];
+        if (unique.length === 1) {
+            return unique[0];
+        }
+        // True collision — pick first match but warn
+        console.warn(`Model name collision detected for "${rawName}": multiple configured models match preprocessed name "${preprocessedRawName}"`);
+        return unique[0] ?? rawName;
+    }
+    if (matchingConfiguredModels.length === 1) {
+        const [matchedModel] = matchingConfiguredModels;
+        if (matchedModel !== undefined) {
+            return matchedModel;
+        }
+    }
+    console.warn(`Model name not found in configured models: "${rawName}"`);
+    return rawName;
+}
+export function isProviderCircuitAvailable(provider, tier) {
+    return providerCircuitBreaker.isAvailable(provider, tier);
+}
+export function recordProviderCircuitSuccess(provider, tier) {
+    providerCircuitBreaker.recordSuccess(provider, tier);
+}
+export function recordProviderCircuitFailure(provider, tier) {
+    providerCircuitBreaker.recordFailure(provider, tier);
+}
+export function createCircuitsOpenPause(run) {
+    return {
+        ...run,
+        status: 'paused',
+        pause_reason: 'circuits_open',
+    };
+}
+export async function callProvider(request, config, defaults, tier = 'strong', fullConfig) {
+    if (!providerCircuitBreaker.isAvailable(config.base_url, tier)) {
+        throw new ProviderError('All circuits open', true);
+    }
+    const apiKey = getApiKey(config.api_key_env);
+    const url = `${config.base_url.replace(/\/+$/, '')}/chat/completions`;
+    const body = buildRequestBody(request);
+    const timeoutMs = request.timeout_ms || (fullConfig ? getTierTimeoutMs(tier, fullConfig) : defaults.api_timeout_seconds * 1000);
+    const maxRetries = defaults.max_retries;
+    let lastError;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        if (attempt > 0) {
+            const backoffMs = Math.min(1000 * 2 ** (attempt - 1), 30000);
+            await sleep(backoffMs);
+        }
+        const startTime = Date.now();
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeoutMs);
+        const cancelTimeout = () => clearTimeout(timer);
+        let response;
+        try {
+            response = await doFetch(url, apiKey, body, controller.signal);
+        }
+        catch (err) {
+            cancelTimeout();
+            if (err instanceof ProviderError) {
+                lastError = err;
+                if (err.code === 'timeout') {
+                    logTimeoutWarning(config.base_url, request.model, timeoutMs);
+                }
+            }
+            else {
+                const message = err instanceof Error ? err.message : String(err);
+                lastError = new ProviderError(`Network error: ${message}`, true);
+            }
+            if (isTransientError(lastError)) {
+                providerCircuitBreaker.recordFailure(config.base_url, tier);
+            }
+            if (attempt < maxRetries && isTransientError(lastError))
+                continue;
+            throw lastError;
+        }
+        if (!response.ok) {
+            const retryable = isTransientErrorStatus(response.status);
+            const responseText = await response.text().catch(() => '');
+            cancelTimeout();
+            lastError = new ProviderError(`HTTP ${response.status}: ${responseText}`, retryable, response.status);
+            if (isTransientError(lastError)) {
+                providerCircuitBreaker.recordFailure(config.base_url, tier);
+            }
+            if (!retryable)
+                throw lastError;
+            if (attempt < maxRetries)
+                continue;
+            throw lastError;
+        }
+        let data;
+        try {
+            data = await readJsonWithTimeout(response, controller.signal);
+        }
+        catch (err) {
+            cancelTimeout();
+            if (err instanceof ProviderError) {
+                lastError = err;
+                if (err.code === 'timeout') {
+                    logTimeoutWarning(config.base_url, request.model, timeoutMs);
+                }
+                if (isTransientError(lastError)) {
+                    providerCircuitBreaker.recordFailure(config.base_url, tier);
+                }
+                if (attempt < maxRetries && isTransientError(lastError))
+                    continue;
+                throw lastError;
+            }
+            throw err;
+        }
+        cancelTimeout();
+        const choice = data.choices?.[0];
+        if (!choice) {
+            throw new ProviderError('No choices in response', false);
+        }
+        providerCircuitBreaker.recordSuccess(config.base_url, tier);
+        const configuredModels = Object.values(config.models).filter((model) => typeof model === 'string');
+        const normalizedModel = normalizeModelName(data.model, configuredModels);
+        return {
+            content: choice.message.content,
+            model: normalizedModel,
+            provider: config.base_url,
+            usage: {
+                input_tokens: data.usage.prompt_tokens,
+                output_tokens: data.usage.completion_tokens,
+            },
+            latency_ms: Date.now() - startTime,
+            finish_reason: choice.finish_reason,
+        };
+    }
+    throw lastError ?? new ProviderError('Unexpected: no attempts made', false);
+}
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

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

package/dist/question-handler.d.ts

@@ -0,0 +1,18 @@
+import type { Task, TaskState, StwConfig } from './types.js';
+import type { Logger } from './logger.js';
+export interface WorkerQuestionResponse {
+    status: 'question';
+    question: string;
+}
+export declare function readWorkerQuestionResponse(taskDir: string): WorkerQuestionResponse | null;
+export declare function handleWorkerQuestion(input: {
+    questionResponse: WorkerQuestionResponse;
+    task: Task;
+    config: StwConfig;
+    taskDir: string;
+    stwRoot?: string;
+    runId?: string;
+    log?: Logger;
+    tryTransition: (stwRoot: string, runId: string, taskId: string, state: TaskState, updatedBy: string) => void;
+}): 'auto_answered' | 'waiting_for_human';
+export declare function loadPersistedQuestionAnswers(taskDir: string, taskId: string): Record<number, string>;

package/dist/question-handler.js

@@ -0,0 +1,154 @@
+import { join } from 'node:path';
+import { existsSync, readdirSync } from 'node:fs';
+import { writeRunState } from './status.js';
+import { readText, writeJson } from './storage.js';
+import { triageQuestion } from './question-triage.js';
+export function readWorkerQuestionResponse(taskDir) {
+    const rawPath = join(taskDir, 'response_raw.txt');
+    if (!existsSync(rawPath)) {
+        return null;
+    }
+    try {
+        const raw = readText(rawPath).trim();
+        if (raw.length === 0) {
+            return null;
+        }
+        const parsed = JSON.parse(raw);
+        if (parsed.status === 'question' && typeof parsed.question === 'string' && parsed.question.trim().length > 0) {
+            return {
+                status: 'question',
+                question: parsed.question.trim(),
+            };
+        }
+    }
+    catch {
+        return null;
+    }
+    return null;
+}
+export function handleWorkerQuestion(input) {
+    const { questionResponse, task, config, taskDir, stwRoot, runId, log, tryTransition } = input;
+    const questionNumber = getNextQuestionNumber(taskDir);
+    const questionArtifact = {
+        schema_version: 1,
+        task_id: task.id,
+        status: 'question',
+        question: questionResponse.question,
+        question_number: questionNumber,
+        created_at: new Date().toISOString(),
+    };
+    writeJson(join(taskDir, 'question.json'), questionArtifact);
+    if (stwRoot && runId) {
+        tryTransition(stwRoot, runId, task.id, 'question_pending', 'task-executor');
+    }
+    const maxAutoAnswers = config.defaults.max_auto_answers ?? 2;
+    const triage = triageQuestion({
+        question: questionResponse.question,
+        task,
+        config,
+        taskDir,
+        evidence: buildAutoAnswerEvidence(task, questionResponse.question),
+        confidence: 0.95,
+        questionNumber,
+        maxAutoAnswers,
+    });
+    if (triage.decision === 'auto_answer' && triage.answer) {
+        const answerArtifact = {
+            schema_version: 1,
+            task_id: task.id,
+            question_number: questionNumber,
+            answer: triage.answer,
+            answered_at: new Date().toISOString(),
+            answered_by: 'task-executor',
+        };
+        writeJson(join(taskDir, `answer-${questionNumber}.json`), answerArtifact);
+        if (stwRoot && runId) {
+            tryTransition(stwRoot, runId, task.id, 'working', 'task-executor');
+        }
+        log?.info('Auto-answered worker question', {
+            question_number: questionNumber,
+            question_thread_id: triage.question_thread_id,
+        });
+        return 'auto_answered';
+    }
+    if (stwRoot && runId) {
+        tryTransition(stwRoot, runId, task.id, 'waiting_for_human', 'task-executor');
+        try {
+            writeRunState(stwRoot, runId, 'paused', {
+                pause_reason: 'human_review',
+            });
+        }
+        catch (err) {
+            console.warn(`[question] Failed to pause run for human review: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    log?.info('Worker question requires human review', {
+        question_number: questionNumber,
+        question_thread_id: triage.question_thread_id,
+    });
+    return 'waiting_for_human';
+}
+function getNextQuestionNumber(taskDir) {
+    const questionPath = join(taskDir, 'question.json');
+    if (existsSync(questionPath)) {
+        try {
+            const existing = JSON.parse(readText(questionPath));
+            if (typeof existing.question_number === 'number' && Number.isFinite(existing.question_number)) {
+                return existing.question_number + 1;
+            }
+        }
+        catch {
+            // Corrupt question.json — fall through to default
+        }
+    }
+    let maxAnswerNumber = 0;
+    try {
+        for (const entry of readdirSync(taskDir, { withFileTypes: true })) {
+            if (!entry.isFile()) {
+                continue;
+            }
+            const match = entry.name.match(/^answer-(\d+)\.json$/);
+            if (!match) {
+                continue;
+            }
+            const num = Number(match[1]);
+            if (Number.isFinite(num) && num > maxAnswerNumber) {
+                maxAnswerNumber = num;
+            }
+        }
+    }
+    catch { }
+    return maxAnswerNumber + 1;
+}
+export function loadPersistedQuestionAnswers(taskDir, taskId) {
+    const answers = {};
+    try {
+        for (const entry of readdirSync(taskDir, { withFileTypes: true })) {
+            if (!entry.isFile()) {
+                continue;
+            }
+            const match = entry.name.match(/^answer-(\d+)\.json$/);
+            if (!match) {
+                continue;
+            }
+            const filePath = join(taskDir, entry.name);
+            try {
+                const artifact = JSON.parse(readText(filePath));
+                if (artifact.task_id !== taskId) {
+                    continue;
+                }
+                if (typeof artifact.question_number !== 'number' || typeof artifact.answer !== 'string') {
+                    continue;
+                }
+                answers[artifact.question_number] = artifact.answer;
+            }
+            catch { }
+        }
+    }
+    catch { }
+    return answers;
+}
+function buildAutoAnswerEvidence(task, question) {
+    return `Use the task description and declared scope as the source of truth. Task: ${task.description}. Question: ${question}`;
+}
+//# sourceMappingURL=question-handler.js.map

package/dist/question-handler.js.map

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

package/dist/question-triage.d.ts

@@ -0,0 +1,31 @@
+import type { Task, StwConfig } from './types.js';
+export type TriageDecision = 'auto_answer' | 'ask_human';
+export interface TriageResult {
+    decision: TriageDecision;
+    answer?: string;
+    confidence?: number;
+    question_thread_id: string;
+    reason: string;
+}
+export interface QuestionTriageInput {
+    question: string;
+    task: Task;
+    config: StwConfig;
+    taskDir: string;
+    evidence?: string;
+    confidence?: number;
+    questionNumber?: number;
+    maxAutoAnswers?: number;
+}
+/**
+ * Normalizes question text for deterministic hashing.
+ * Lowercases, collapses whitespace, strips punctuation at boundaries.
+ */
+export declare function normalizeQuestionText(text: string): string;
+/**
+ * Computes a deterministic question_thread_id from normalized question text.
+ * Uses SHA-256, returns first 16 hex chars prefixed with 'qt_'.
+ */
+export declare function computeQuestionThreadId(question: string): string;
+export declare function triageDecisionPath(taskDir: string): string;
+export declare function triageQuestion(input: QuestionTriageInput): TriageResult;