@orion-agents/orion-code 0.1.0

package/dist/framework/prompt.d.ts

@@ -0,0 +1,48 @@
+/**
+ * orion code - System Prompt Builder (segment-based)
+ *
+ * Segment-based system prompt composition with static/dynamic separation.
+ * Static sections are cacheable for API prompt caching.
+ * Dynamic sections are rebuilt each request.
+ */
+import type { OpenHorseTool } from './tool';
+/** Context for rendering prompt sections */
+export interface PromptContext {
+    cwd: string;
+    platform: string;
+    nodeVersion: string;
+    tools: OpenHorseTool[];
+    memoryContent?: string;
+    /** Pre-rendered skills section (e.g. from SkillsRegistry.generateSystemPromptInjection) */
+    skillsContent?: string;
+    /** Repository guidance loaded from files such as AGENTS.md / CLAUDE.md */
+    projectInstructionsContent?: string;
+    /** Full SKILL.md prompts activated for the current turn. */
+    activeSkillsContent?: string;
+    /** Files explicitly referenced by the user with @path in the current turn. */
+    referencedFilesContent?: string;
+    /** v0.2.24: Persistent goal context fragment (from GoalCoordinator). */
+    goalContent?: string;
+}
+/** A named prompt section */
+export interface PromptSection {
+    name: string;
+    dynamic: boolean;
+    render: (ctx: PromptContext) => string;
+}
+/**
+ * Build a system prompt from segments, separating static and dynamic parts.
+ *
+ * Returns `{ static, dynamic }` for potential API prompt caching.
+ * The two parts are joined with a separator when used as a single string.
+ */
+export declare function buildSystemPrompt(ctx: PromptContext): {
+    static: string;
+    dynamic: string;
+};
+/**
+ * Build a single system prompt string (static + dynamic joined).
+ * Convenience wrapper around buildSystemPrompt.
+ */
+export declare function getSystemPrompt(ctx: PromptContext): string;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/framework/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/framework/prompt.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAM5C,4CAA4C;AAC5C,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2FAA2F;IAC3F,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0EAA0E;IAC1E,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC,4DAA4D;IAC5D,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,8EAA8E;IAC9E,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,6BAA6B;AAC7B,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,MAAM,CAAC;CACxC;AA8HD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,aAAa,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAmBzF;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAI1D"}

package/dist/framework/prompt.js

@@ -0,0 +1,174 @@
+"use strict";
+/**
+ * orion code - System Prompt Builder (segment-based)
+ *
+ * Segment-based system prompt composition with static/dynamic separation.
+ * Static sections are cacheable for API prompt caching.
+ * Dynamic sections are rebuilt each request.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildSystemPrompt = buildSystemPrompt;
+exports.getSystemPrompt = getSystemPrompt;
+// ============================================================================
+// 内置段落
+// ============================================================================
+const SECTIONS = [
+    {
+        name: 'intro',
+        dynamic: false,
+        render: () => `You are Orion Code, a universal AI agent powered by the Orion Code Framework.
+Your core mission is to solve the user's problem — be concise, direct, and action-oriented.`,
+    },
+    {
+        name: 'capabilities',
+        dynamic: false,
+        render: () => `Guidelines:
+- Be brief — explain only what's necessary
+- Persist through failures — try alternative approaches, don't give up easily
+- When blocked, diagnose the root cause and attempt at least 2 different fixes before asking
+- Ask clarifying questions only when the user's intent is genuinely ambiguous or there are multiple equally-valid paths
+- Write code, don't describe it
+- Output plans/proposals as workspace markdown files, not just text
+- When summarizing repository changes, only name files verified by tool output such as git_status, git diff, or direct file reads
+- Keep responses structured and short
+- Respond in the same language as the user
+
+Execution strategy:
+- For non-trivial coding tasks, make a short internal plan, then execute the first safe batch of information-gathering steps before asking the user again.
+- Prefer one well-planned tool batch over several model turns that each run a single read-only command.
+- After tool results return, continue from the evidence already gathered instead of restarting discovery.`,
+    },
+    {
+        name: 'tools',
+        dynamic: false,
+        render: (ctx) => {
+            const toolNames = ctx.tools.map(t => t.name).join(', ');
+            return `Available tools: ${toolNames}.
+Use tools when they help complete the task. Prefer the right tool for the job.
+
+Batched tool strategy:
+- When exploring, diagnosing, or reading code, call multiple independent read-only tools in the same assistant response instead of waiting for one result at a time.
+- Batch safe information gathering such as git_status, list_files, glob, grep, read_file, LSP read-only lookups, web_search/web_fetch, and read-only exec_command calls.
+- If the provider or model is likely to issue only one tool call at a time, use batch_read for up to 8 independent local exploration steps using only git_status, list_files, glob, grep, and read_file.
+- Do not put web_search, web_fetch, exec_command, LSP tools, or write/edit tools inside batch_read; call those as normal tools.
+- Do not batch file edits, writes, pushes, destructive commands, or commands that require confirmation.
+- After batched tool results return, synthesize the findings and decide the next step.`;
+        },
+    },
+    {
+        name: 'env_info',
+        dynamic: true,
+        render: (ctx) => `Current environment:
+- Working directory: ${ctx.cwd}
+- Platform: ${ctx.platform}
+- Node.js: ${ctx.nodeVersion}`,
+    },
+    {
+        name: 'project_instructions',
+        dynamic: true,
+        render: (ctx) => {
+            if (!ctx.projectInstructionsContent)
+                return '';
+            return ctx.projectInstructionsContent;
+        },
+    },
+    {
+        name: 'memory',
+        dynamic: true,
+        render: (ctx) => {
+            if (!ctx.memoryContent)
+                return '';
+            return `Project memory:\n${ctx.memoryContent}`;
+        },
+    },
+    {
+        name: 'skills',
+        dynamic: true,
+        render: (ctx) => {
+            if (!ctx.skillsContent)
+                return '';
+            return ctx.skillsContent;
+        },
+    },
+    {
+        name: 'active_skills',
+        dynamic: true,
+        render: (ctx) => {
+            if (!ctx.activeSkillsContent)
+                return '';
+            return ctx.activeSkillsContent;
+        },
+    },
+    {
+        name: 'referenced_files',
+        dynamic: true,
+        render: (ctx) => {
+            if (!ctx.referencedFilesContent)
+                return '';
+            return ctx.referencedFilesContent;
+        },
+    },
+    {
+        name: 'subagents',
+        dynamic: true,
+        render: (ctx) => {
+            // Only render when the runtime-bound `subtask` tool is exposed this turn.
+            if (!ctx.tools.some(t => t.name === 'subtask'))
+                return '';
+            return `Subagent capability:
+- You may call the \`subtask\` tool to delegate 1-3 independent, READ-ONLY investigations to subagents and receive structured conclusions (summary, findings with evidence, files, suggested commands, verification steps, risks).
+- Use it ONLY when the work genuinely splits into independent investigations: researching two+ unrelated modules, reviewing a diff AND checking test gaps in parallel, separating repo-fact retrieval from external-doc retrieval, or investigating independent failure root causes.
+- Do NOT use subtask for: single-file reads, one grep, simple Q&A, serial step-by-step work, or anything requiring edits or command execution. Subagents cannot edit, write, run shell, commit, push, publish, or create further subagents.
+- Each packet needs a bounded objective that can produce a verifiable conclusion, a reason it is independently delegable, and an optional in-project scope. Scope paths are canonicalized and cannot escape the project root.
+- Subagents share your turn budget and provider rate limits; the runtime reserves and reconciles their usage. Prefer fewer, well-scoped packets over many vague ones.
+- After results return, synthesize the structured findings yourself, keep edit/verify authority, and continue the task. Do not re-delegate the same scope.`;
+        },
+    },
+    {
+        name: 'goal',
+        dynamic: true,
+        render: (ctx) => {
+            if (!ctx.goalContent)
+                return '';
+            return ctx.goalContent;
+        },
+    },
+];
+// ============================================================================
+// buildSystemPrompt
+// ============================================================================
+/**
+ * Build a system prompt from segments, separating static and dynamic parts.
+ *
+ * Returns `{ static, dynamic }` for potential API prompt caching.
+ * The two parts are joined with a separator when used as a single string.
+ */
+function buildSystemPrompt(ctx) {
+    const staticParts = [];
+    const dynamicParts = [];
+    for (const section of SECTIONS) {
+        const content = section.render(ctx);
+        if (!content.trim())
+            continue;
+        if (section.dynamic) {
+            dynamicParts.push(content);
+        }
+        else {
+            staticParts.push(content);
+        }
+    }
+    return {
+        static: staticParts.join('\n\n'),
+        dynamic: dynamicParts.join('\n\n'),
+    };
+}
+/**
+ * Build a single system prompt string (static + dynamic joined).
+ * Convenience wrapper around buildSystemPrompt.
+ */
+function getSystemPrompt(ctx) {
+    const { static: staticPart, dynamic } = buildSystemPrompt(ctx);
+    const parts = [staticPart, dynamic].filter(Boolean);
+    return parts.join('\n\n---\n');
+}
+//# sourceMappingURL=prompt.js.map

package/dist/framework/prompt.js.map

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

package/dist/framework/query.d.ts

@@ -0,0 +1,250 @@
+/**
+ * orion code - Query Loop (async generator)
+ *
+ * Generator-based query loop replacing the callback-based chatWithTools.
+ * Yields typed events: request_start, tool_call, tool_result, message, complete.
+ *
+ * Note: Streaming text chunks are handled via onChunk callback in llm.chatStream(),
+ * not yielded as events (callbacks cannot yield). The handleChat consumer writes
+ * chunks directly to stdout via the callback.
+ */
+import type { LLMRequestDiagnostics, LLMService, Message, StreamCallbacks } from '../services/llm';
+import type { ProviderErrorType } from '../services/provider-diagnostics';
+import type { OpenHorseTool, ToolContext } from './tool';
+import type { PermissionMode } from '../commands/types';
+import type { CostTracker } from '../core/cost-tracker';
+import type { ToolConfirmationPolicy } from '../services/config';
+import { type StrategyTracker } from '../core/strategy-tracker';
+import type { CompactCoordinator } from '../services/compact/coordinator';
+import type { ContextHarness } from '../harness';
+import { type ToolPermissionDecision } from './tool-scheduler';
+import { type ContextUsageSnapshot } from '../services/model-context';
+export declare const DEFAULT_MAX_MODEL_VISIBLE_TOOL_RESULT_BYTES = 4096;
+export type LoopFinishReason = 'completed' | 'cancelled' | 'failed' | 'blocked' | 'max_turns' | 'completion_gate' | 'budget_exceeded' | 'running';
+export type LoopBudgetBaseProfile = 'default' | 'complex' | 'release';
+export type LoopBudgetSource = LoopBudgetBaseProfile | 'config';
+export type LoopContinuationAction = 'reply_continue' | 'narrow_instruction' | 'inspect_loop_stats' | 'raise_budget';
+export interface LoopBudget {
+    /** Maximum LLM requests allowed for one user turn before stopping. */
+    maxLlmRequestsPerUserTurn: number;
+    /** Maximum tool calls allowed for one user turn before stopping. */
+    maxToolCallsPerUserTurn: number;
+    /** Consecutive single read-only tool turns before injecting a batch_read hint. */
+    maxReadOnlyFragmentation: number;
+    /** Maximum aggregate tool-result bytes exposed to the model in one user turn. */
+    maxModelVisibleToolBytes: number;
+    /** Budget source after config overrides are applied. */
+    profile?: LoopBudgetSource;
+    /** Adaptive profile selected before config overrides, when applicable. */
+    baseProfile?: LoopBudgetBaseProfile;
+    /** Whether user/global/env config changed one or more numeric budget fields. */
+    configOverride?: boolean;
+}
+export declare const DEFAULT_LOOP_BUDGET: LoopBudget;
+export interface LoopStats {
+    turnsStarted: number;
+    llmRequests: number;
+    toolCalls: number;
+    readOnlyToolCalls: number;
+    unsafeToolCalls: number;
+    toolResultBytes: number;
+    modelVisibleToolBytes: number;
+    summarizedBytes: number;
+    compactTrigger?: 'pre_turn' | 'post_turn';
+    finishReason: LoopFinishReason;
+    budgetExceededReason?: string;
+    loopBudgetSource?: LoopBudgetSource;
+    loopBudgetBaseProfile?: LoopBudgetBaseProfile;
+    loopBudgetMaxLlmRequests?: number;
+    loopBudgetMaxToolCalls?: number;
+    loopBudgetMaxReadOnlyFragmentation?: number;
+    loopBudgetMaxModelVisibleBytes?: number;
+    loopBudgetConfigOverride?: boolean;
+    providerRetryCount?: number;
+    providerRetryDelayMs?: number;
+    providerRetryErrorTypes?: ProviderErrorType[];
+    providerLastRetryErrorType?: ProviderErrorType;
+    providerLastRetryStatus?: number;
+    providerFallbackCount?: number;
+    providerFallbackFromModel?: string;
+    providerFallbackToModel?: string;
+    providerFinalModel?: string;
+    providerUsingFallback?: boolean;
+    continuationActions?: LoopContinuationAction[];
+    continuationHint?: string;
+    verificationProfile?: string;
+    verificationRequired?: boolean;
+    verificationClaimAllowed?: boolean;
+    verificationPassedCommands?: string[];
+    verificationFailedCommands?: string[];
+    verificationMissingCommands?: string[];
+    verificationSkippedReason?: string;
+    singleReadOnlyStreak: number;
+    batchReadSuggestionCount: number;
+    localFastPathUsed: boolean;
+}
+export declare class QueryLoopError extends Error {
+    readonly originalError: unknown;
+    readonly stats: LoopStats;
+    constructor(error: unknown, stats: LoopStats);
+}
+export declare function createLocalFastPathLoopStats(overrides?: Partial<LoopStats>): LoopStats;
+export declare function createFailedLoopStats(options?: Partial<LoopStats> & {
+    loopBudget?: Partial<LoopBudget>;
+    diagnostics?: LLMRequestDiagnostics;
+}): LoopStats;
+export type QueryEvent = {
+    type: 'request_start';
+    model: string;
+    turn: number;
+} | {
+    type: 'prompt_assembly';
+    modelId: string;
+    estimatedTokens: number;
+    budgetTokens: number;
+    coreTokens: number;
+    evidenceBudgetTokens: number;
+    recentTurnBudgetTokens: number;
+    sections: string[];
+    includedEvidence: string[];
+    omittedEvidence: string[];
+    includedEvidenceCount: number;
+    omittedEvidenceCount: number;
+} | {
+    type: 'assistant_tool_calls';
+    content: string;
+    toolCalls: NonNullable<Message['tool_calls']>;
+} | {
+    type: 'tool_call';
+    name: string;
+    args: Record<string, unknown>;
+    callId: string;
+    batchCount?: number;
+    batchIndex?: number;
+} | {
+    type: 'permission_decision';
+    name: string;
+    args: Record<string, unknown>;
+    callId: string;
+    decision: ToolPermissionDecision;
+    batchCount?: number;
+    batchIndex?: number;
+} | {
+    type: 'tool_result';
+    name: string;
+    args: Record<string, unknown>;
+    callId: string;
+    result: string;
+    modelVisibleResult: string;
+    duration: number;
+    success: boolean;
+    artifactRef?: {
+        id: string;
+        outputBytes: number;
+    };
+    error?: string;
+    summary?: string;
+    outputBytes?: number;
+    batchCount?: number;
+    batchIndex?: number;
+} | {
+    type: 'strategy_exhausted';
+    suggestion: string;
+} | {
+    type: 'message';
+    role: 'assistant';
+    content: string;
+} | {
+    type: 'complete';
+    content: string;
+    usage?: {
+        promptTokens: number;
+        completionTokens: number;
+    };
+    model: string;
+    stats?: LoopStats;
+    compact?: QueryCompactCommit;
+};
+export interface QueryCompactCommit {
+    mode: 'predictive' | 'threshold';
+    modelHistory: Message[];
+    summary: {
+        text: string;
+        generatedAt: number;
+        source: 'llm' | 'heuristic';
+    };
+    before: ContextUsageSnapshot;
+    after: ContextUsageSnapshot;
+}
+export interface QueryParams {
+    /** Conversation history (must include system prompt as first message) */
+    messages: Message[];
+    /** Available tools */
+    tools: OpenHorseTool[];
+    /** Tool executor: (name, args, abortSignal?) => result string
+     *  Issue #32 #3.2: 支持 abortSignal 透传 */
+    toolExecutor: (name: string, args: Record<string, unknown>, abortSignal?: AbortSignal) => Promise<string>;
+    /** LLM service instance */
+    llm: LLMService;
+    /** Maximum turns (default: no limit, relies on safety mechanisms) */
+    maxTurns?: number;
+    /** Abort signal for cancellation */
+    abortSignal?: AbortSignal;
+    /** Streaming callbacks (onChunk writes to stdout, etc.) */
+    streamCallbacks?: StreamCallbacks;
+    /** Permission mode for tool execution */
+    permissionMode?: PermissionMode;
+    /** Fallback for permission checks that would need an interactive prompt. */
+    toolConfirmation?: ToolConfirmationPolicy;
+    /** Optional UI confirmation hook for tools whose permission check returns ask. */
+    confirmToolUse?: (request: {
+        name: string;
+        args: Record<string, unknown>;
+        reason?: string;
+        abortSignal?: AbortSignal;
+    }) => Promise<boolean>;
+    /** Tool execution context */
+    toolContext?: ToolContext;
+    /** Cost tracker for recording usage */
+    costTracker?: CostTracker;
+    /** Strategy tracker for alternative approaches */
+    strategyTracker?: StrategyTracker;
+    /** Optional Context Harness for turn-level context, ledger, and completion gates */
+    harness?: ContextHarness;
+    /** Current user input, used by Context Harness for evidence ranking */
+    input?: string;
+    /** Maximum number of concurrency-safe tools to execute at once (default 6). */
+    maxParallelToolCalls?: number;
+    /** Maximum bytes of one tool result to expose to the next model request. */
+    maxModelVisibleToolResultBytes?: number;
+    /** Per-user-turn budget guardrails for model requests, tools, and model-visible tool output. */
+    loopBudget?: Partial<LoopBudget>;
+    /** Runtime observer for current context pressure. Renderers consume Store state instead. */
+    onContextUsage?: (usage: ContextUsageSnapshot) => void;
+    /** Runtime observer for autonomous core compaction. */
+    onAutoCompact?: (notice: AutoCompactNotice) => void;
+    /** Runtime-owned compact policy and provider calibration. */
+    compactCoordinator?: CompactCoordinator;
+}
+export interface AutoCompactNotice {
+    mode: 'predictive' | 'threshold';
+    before: ContextUsageSnapshot;
+    after: ContextUsageSnapshot;
+}
+/**
+ * Generator-based agentic loop.
+ *
+ * LLM → stream (via callback) → tool_call → execute → tool_result → repeat
+ *
+ * @example
+ * for await (const event of query({
+ *   messages, tools, toolExecutor, llm,
+ *   streamCallbacks: { onChunk: (t) => process.stdout.write(t) },
+ * })) {
+ *   switch (event.type) {
+ *     case 'complete': console.log(event.usage); break;
+ *   }
+ * }
+ */
+export declare function query(params: QueryParams): AsyncGenerator<QueryEvent>;
+//# sourceMappingURL=query.d.ts.map

package/dist/framework/query.d.ts.map

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