@orion-agents/orion-code 0.1.0

package/dist/services/goal-storage.js

@@ -0,0 +1,153 @@
+"use strict";
+/**
+ * v0.2.24 — Goal Storage.
+ *
+ * Atomic sidecar persistence for Session goals. Uses compare-and-swap
+ * revision, temporary file + atomic rename, and corrupt quarantine.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GOAL_TMP_PREFIX = exports.GOAL_SIDECAR_SUFFIX = void 0;
+exports.loadGoal = loadGoal;
+exports.saveGoal = saveGoal;
+exports.deleteGoal = deleteGoal;
+exports.createGoal = createGoal;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const crypto_1 = require("crypto");
+const config_dir_1 = require("../services/config-dir");
+// ============================================================================
+// Sidecar path
+// ============================================================================
+function goalSidecarPath(projectPath, sessionId) {
+    return (0, path_1.join)((0, config_dir_1.getProjectSessionsDir)(projectPath), `${sessionId}.goal.json`);
+}
+function loadGoal(projectPath, sessionId) {
+    const path = goalSidecarPath(projectPath, sessionId);
+    if (!(0, fs_1.existsSync)(path)) {
+        return { ok: false, error: 'not_found', message: `No goal sidecar at ${path}` };
+    }
+    try {
+        const raw = (0, fs_1.readFileSync)(path, 'utf8');
+        const parsed = JSON.parse(raw);
+        if (parsed.version !== 1 || typeof parsed.goalId !== 'string' || !parsed.goalId) {
+            quarantineSidecar(path, 'invalid schema or missing goalId');
+            return { ok: false, error: 'corrupt', message: 'Goal sidecar has invalid schema' };
+        }
+        if (parsed.sessionId !== sessionId) {
+            quarantineSidecar(path, `sessionId mismatch: expected ${sessionId}, got ${parsed.sessionId}`);
+            return { ok: false, error: 'corrupt', message: 'Goal sidecar sessionId mismatch' };
+        }
+        if (typeof parsed.objective !== 'string' || !parsed.objective.trim()) {
+            quarantineSidecar(path, 'missing or empty objective');
+            return { ok: false, error: 'corrupt', message: 'Goal sidecar has empty objective' };
+        }
+        return { ok: true, value: parsed };
+    }
+    catch (err) {
+        quarantineSidecar(path, err instanceof Error ? err.message : String(err));
+        return { ok: false, error: 'corrupt', message: 'Failed to parse goal sidecar' };
+    }
+}
+function saveGoal(projectPath, sessionId, goal, expectedRevision) {
+    const path = goalSidecarPath(projectPath, sessionId);
+    const dir = (0, config_dir_1.getProjectSessionsDir)(projectPath);
+    try {
+        (0, fs_1.mkdirSync)(dir, { recursive: true, mode: 0o700 });
+    }
+    catch { /* dir exists */ }
+    // CAS: if expectedRevision is provided, validate before writing.
+    if (expectedRevision !== undefined) {
+        const existing = loadGoal(projectPath, sessionId);
+        if (existing.ok) {
+            if (existing.value.revision !== expectedRevision) {
+                return { ok: false, error: 'revision_stale', message: `Expected revision ${expectedRevision}, got ${existing.value.revision}` };
+            }
+        }
+        else if (existing.error !== 'not_found' && expectedRevision !== 0) {
+            return { ok: false, error: 'revision_stale', message: 'Goal exists but is corrupt' };
+        }
+    }
+    const tmpPath = `${path}.tmp-${(0, crypto_1.randomUUID)().slice(0, 8)}`;
+    try {
+        (0, fs_1.writeFileSync)(tmpPath, JSON.stringify(goal, null, 2), { encoding: 'utf8', mode: 0o600 });
+        (0, fs_1.renameSync)(tmpPath, path);
+        return { ok: true, value: undefined };
+    }
+    catch (err) {
+        try {
+            (0, fs_1.unlinkSync)(tmpPath);
+        }
+        catch { /* best effort */ }
+        return { ok: false, error: 'io_error', message: err instanceof Error ? err.message : String(err) };
+    }
+}
+function deleteGoal(projectPath, sessionId) {
+    const path = goalSidecarPath(projectPath, sessionId);
+    if (!(0, fs_1.existsSync)(path))
+        return { ok: true, value: undefined };
+    try {
+        (0, fs_1.unlinkSync)(path);
+        // Also clean up any stale temp files.
+        try {
+            const dir = (0, config_dir_1.getProjectSessionsDir)(projectPath);
+            // Using require here would create a circular dependency, so we use a
+            // simple readdirSync pattern that matches the tmp- prefix.
+            const { readdirSync } = require('fs');
+            for (const file of readdirSync(dir)) {
+                if (file.startsWith(`${sessionId}.goal.json.tmp-`)) {
+                    try {
+                        (0, fs_1.unlinkSync)((0, path_1.join)(dir, file));
+                    }
+                    catch { /* ok */ }
+                }
+            }
+        }
+        catch { /* ok */ }
+        return { ok: true, value: undefined };
+    }
+    catch (err) {
+        return { ok: false, error: 'io_error', message: err instanceof Error ? err.message : String(err) };
+    }
+}
+function createGoal(projectPath, sessionId, objective) {
+    const now = Date.now();
+    const goal = {
+        version: 1,
+        goalId: (0, crypto_1.randomUUID)(),
+        sessionId,
+        revision: 0,
+        objective: objective.trim(),
+        status: 'active',
+        tokensUsed: 0,
+        timeUsedMs: 0,
+        createdAt: now,
+        updatedAt: now,
+        activeSince: now,
+        continuationCount: 0,
+        noProgressCount: 0,
+    };
+    const result = saveGoal(projectPath, sessionId, goal);
+    if (!result.ok)
+        return result;
+    return { ok: true, value: goal };
+}
+// ============================================================================
+// Helpers
+// ============================================================================
+function quarantineSidecar(path, reason) {
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+    const quarantinePath = `${path}.corrupt-${timestamp}`;
+    try {
+        (0, fs_1.renameSync)(path, quarantinePath);
+        console.warn(`[goal-storage] Quarantined corrupt goal sidecar: ${path} (${reason})`);
+    }
+    catch {
+        console.warn(`[goal-storage] Failed to quarantine corrupt goal sidecar: ${path} (${reason})`);
+    }
+}
+// ============================================================================
+// Sidecar suffix for storage-maintenance
+// ============================================================================
+exports.GOAL_SIDECAR_SUFFIX = '.goal.json';
+exports.GOAL_TMP_PREFIX = '.goal.json.tmp-';
+//# sourceMappingURL=goal-storage.js.map

package/dist/services/goal-storage.js.map

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

package/dist/services/llm.d.ts

@@ -0,0 +1,190 @@
+/**
+ * orion code - LLM 服务层
+ *
+ * 封装 OpenAI 兼容 API，支持流式和非流式调用。
+ * 兼容 OpenAI、Claude (via proxy)、本地 Ollama 等。
+ * 支持工具调用（function calling）和 agentic 循环。
+ * 支持重试机制和 fallback model。
+ */
+import type { ProviderErrorType } from './provider-diagnostics';
+export { LLMProviderError } from './provider-diagnostics';
+export type { ProviderErrorDiagnostic, ProviderErrorType } from './provider-diagnostics';
+/** LLM 配置 — 用户只需关注 3 项 */
+export interface LLMConfig {
+    /** API Key */
+    apiKey: string;
+    /** API Base URL（兼容第三方） */
+    baseUrl?: string;
+    /** 模型名称 */
+    model: string;
+    /** 备用模型（主模型失败时切换） */
+    fallbackModel?: string;
+    /** 请求超时 (ms) */
+    timeout?: number;
+}
+/** 重试配置 */
+export interface RetryConfig {
+    /** 最大重试次数 */
+    maxRetries: number;
+    /** 基础延迟 ms */
+    baseDelayMs: number;
+    /** 最大延迟 ms */
+    maxDelayMs?: number;
+    /** Abort retries and retry backoff when the current turn is interrupted */
+    abortSignal?: AbortSignal;
+    /** 重试回调 */
+    onRetry?: (attempt: number, error: Error, delayMs: number) => void;
+}
+export interface LLMRequestDiagnostics {
+    retryCount: number;
+    retryDelayMs: number;
+    retryErrorTypes: ProviderErrorType[];
+    lastRetryErrorType?: ProviderErrorType;
+    lastRetryStatus?: number;
+    fallbackTriggered: boolean;
+    fallbackFromModel?: string;
+    fallbackToModel?: string;
+    finalModel: string;
+    usingFallback: boolean;
+}
+/** Fallback 触发错误 */
+export declare class FallbackTriggeredError extends Error {
+    readonly originalModel: string;
+    readonly fallbackModel: string;
+    constructor(originalModel: string, fallbackModel: string);
+}
+/** Cache control hint for provider-level prompt caching */
+export interface CacheControl {
+    type: 'ephemeral';
+}
+/** Provider-agnostic cache control content part.
+ *  Appended to content arrays when cacheControl is set on a message.
+ *  Supported by Anthropic (via OpenAI-compatible) — silently ignored by OpenAI. */
+export interface CacheControlContentPart {
+    type: 'text';
+    text: '';
+    cache_control: {
+        type: 'ephemeral';
+    };
+}
+/** 对话消息 */
+export interface Message {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string;
+    tool_calls?: Array<{
+        id: string;
+        type: 'function';
+        function: {
+            name: string;
+            arguments: string;
+        };
+    }>;
+    tool_call_id?: string;
+    /** Provider-level prompt caching hint. Set on messages expected to be identical
+     *  across consecutive requests (e.g. static system prompt prefix). */
+    cacheControl?: CacheControl;
+}
+/** 工具定义 */
+export interface Tool {
+    type: 'function';
+    function: {
+        name: string;
+        description: string;
+        parameters: Record<string, unknown>;
+    };
+}
+/** LLM 响应 */
+export interface LLMUsage {
+    promptTokens: number;
+    completionTokens: number;
+    cachedPromptTokens?: number;
+    /** Provider-reported billed cost in USD, when supplied by the API. */
+    costUsd?: number;
+    /** Provider request id, or a locally generated id when omitted. */
+    requestId?: string;
+}
+export interface LLMUsageEvent {
+    usage: LLMUsage;
+    model: string;
+    operation: 'chat' | 'chat_stream';
+}
+export interface LLMResponse {
+    /** 回复内容 */
+    content: string;
+    /** Token 用量 */
+    usage?: LLMUsage;
+    /** 使用的模型 */
+    model: string;
+    /** 工具调用 */
+    toolCalls?: Array<{
+        id: string;
+        type: 'function';
+        function: {
+            name: string;
+            arguments: string;
+        };
+    }>;
+}
+/** 流式回调 */
+export type StreamCallback = (chunk: string) => void;
+/** 工具回调 — LLM 流式输出时的钩子 */
+export interface StreamCallbacks {
+    /** 文本块回调 */
+    onChunk?: StreamCallback;
+    /** 思考提示回调（流式开始前） */
+    onThinking?: () => void;
+}
+export interface StreamOptions {
+    abortSignal?: AbortSignal;
+}
+export declare class LLMService {
+    private client;
+    private config;
+    private consecutive529Errors;
+    private usingFallback;
+    private lastRequestDiagnostics;
+    private usageObservers;
+    /** v0.2.25: injected resilience coordinator (optional — falls back to old withRetry if absent). */
+    resilience?: import('./provider-resilience').ProviderResilienceCoordinator;
+    constructor(config: LLMConfig);
+    /** 是否正在使用 fallback model */
+    isUsingFallback(): boolean;
+    getLastRequestDiagnostics(): LLMRequestDiagnostics;
+    /** Observe every successful provider call, including compact summaries. */
+    subscribeUsage(observer: (event: LLMUsageEvent) => void): () => void;
+    /** 触发 fallback */
+    triggerFallback(): void;
+    /** 重置为原始 model */
+    resetToPrimary(): void;
+    /**
+     * 非流式对话
+     */
+    chat(messages: Message[], tools?: Tool[]): Promise<LLMResponse>;
+    /**
+     * 流式对话（带重试）
+     */
+    chatStream(messages: Message[], callbacks?: StreamCallbacks | StreamCallback, tools?: Tool[], options?: StreamOptions): Promise<LLMResponse>;
+    private publishUsage;
+    /**
+     * 带工具调用的 agentic 循环
+     */
+    chatWithTools(messages: Message[], tools: Tool[], toolExecutor: (name: string, args: Record<string, unknown>) => Promise<string>, callbacks?: StreamCallbacks, maxIterations?: number): Promise<LLMResponse>;
+    /**
+     * 切换模型
+     */
+    setModel(model: string): void;
+    /**
+     * 获取当前模型
+     */
+    getModel(): string;
+    /** Maximum completion tokens requested from the provider for each call. */
+    getMaxTokens(): number;
+    /**
+     * 获取当前配置摘要
+     */
+    getConfigSummary(): Record<string, string>;
+    private createRequestDiagnostics;
+    /** 转换为 OpenAI SDK 消息格式 */
+    private toOpenAIMessages;
+}
+//# sourceMappingURL=llm.d.ts.map

package/dist/services/llm.d.ts.map

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