@orion-agents/orion-code 0.1.9 → 0.2.2

package/dist/framework/tool-scheduler.d.ts

@@ -1,191 +0,0 @@
-/**
- * orion code - Tool Scheduler
- *
- * Extracts tool grouping, permission checks, concurrent execution, and
- * ordered result emission from query.ts into a testable module.
- *
- * Input: tool calls from LLM + tool registry + permission context + abort signal
- * Output: execution results in original call order
- */
-import { type OrionCodeTool, type PermissionResult, type ToolContext } from './tool';
-import { type ToolExternalAssertion } from './external-assertion';
-import type { Message } from '../services/llm';
-import type { ToolAllowlistEvaluator, ToolAllowlistMatch } from '../services/tool-allowlist';
-import type { DriftCheckResult } from '../harness/types';
-type ToolCallRecord = NonNullable<Message['tool_calls']>[number];
-export interface PreparedToolCall {
-    index: number;
-    tc: ToolCallRecord;
-    args: Record<string, unknown>;
-    tool: OrionCodeTool | undefined;
-    attemptId: string;
-    /** Provider arguments rejected before policy, drift, tracking, or execution. */
-    argumentError?: string;
-    drift: DriftCheckResult | undefined;
-    permission: PermissionResult | undefined;
-    /**
-     * Winning project allowlist rule, if any.
-     * Optional so external callers constructing a PreparedToolCall stay source-compatible.
-     */
-    allowlist?: ToolAllowlistMatch;
-    canRunConcurrently: boolean;
-}
-export interface ExecutedToolCall {
-    prepared: PreparedToolCall;
-    result: string;
-    duration: number;
-    success: boolean;
-    error?: string;
-    summary?: string;
-    outputBytes?: number;
-    artifactRef?: {
-        id: string;
-        outputBytes: number;
-    };
-    externalAssertion?: ToolExternalAssertion;
-    /**
-     * Whether the executor returned the structured tool-result contract.
-     * Optional for source compatibility; missing legacy values are never trusted.
-     */
-    resultTrust?: 'structured' | 'opaque';
-    strategyResult: 'success' | 'failed';
-    strategyError?: string;
-    permissionDecision?: ToolPermissionDecision;
-}
-export type PermissionDecisionSource = 'tool_policy' | 'config_allow' | 'config_deny' | 'user' | 'missing_confirmation' | 'drift_guard' | 'mode_auto' | 'mode_accept_edits' | 'allowlist_allow' | 'allowlist_deny' | 'allowlist_ask' | 'missing_risk_metadata' | 'risk_guard' | 'config_allow_blocked';
-export interface ToolPermissionDecision {
-    behavior?: PermissionResult['behavior'];
-    approved: boolean;
-    source: PermissionDecisionSource;
-    reason?: string;
-    duration?: number;
-}
-export interface ToolSchedule {
-    parallel: PreparedToolCall[];
-    serial: PreparedToolCall[];
-}
-export interface ToolSchedulerOptions {
-    /** Tool calls from the LLM response */
-    toolCalls: NonNullable<Message['tool_calls']>;
-    /** Available tool registry */
-    tools: OrionCodeTool[];
-    /** Tool executor: (name, args, abortSignal?) => result string */
-    toolExecutor: (name: string, args: Record<string, unknown>, abortSignal?: AbortSignal) => Promise<string>;
-    /** Permission mode */
-    permissionMode?: string;
-    /** Fallback for permission checks that would need an interactive prompt */
-    toolConfirmation?: string;
-    /** Project-scoped allowlist rule engine (see services/tool-allowlist). */
-    toolAllowlist?: ToolAllowlistEvaluator;
-    /** 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;
-    /** Abort signal */
-    abortSignal?: AbortSignal;
-    /** Maximum number of concurrency-safe tools to run at once. */
-    maxParallelToolCalls?: number;
-    /** Start a tracking approach for strategy tracker (returns attemptId) */
-    startApproach?: (toolName: string) => string;
-    /** Add tool to strategy tracker */
-    addToolToTracker?: (attemptId: string, toolName: string) => void;
-    /** Harness drift check callback */
-    harnessDriftCheck?: (params: {
-        name: string;
-        args: Record<string, unknown>;
-    }) => DriftCheckResult | undefined;
-    /** Harness blocked result formatter */
-    harnessBlockedResult?: (drift: DriftCheckResult) => string;
-}
-/**
- * How a `behavior: 'ask'` permission should be resolved for the active permission mode.
- * - `allow`   : the mode itself grants approval (acceptEdits for file edits).
- * - `confirm` : fall through to toolConfirmation policy / interactive confirmation.
- */
-export type AskResolution = 'allow' | 'confirm';
-export type ToolRisk = 'read_only' | 'file_edit' | 'state_write' | 'destructive' | 'external' | 'unknown';
-/**
- * Resolve an `ask` permission against the permission mode.
- *
- * Historically this logic was inlined as `permissionMode === 'default'`, which meant
- * every non-default mode silently skipped confirmation without a complete safety
- * decision. Agent PLAN is a workflow mode, so the legacy permission value
- * `plan` follows the normal confirmation path. Auto delegates to the full
- * policy/risk gate below and never opens an interactive prompt.
- */
-export declare function resolveAskPermission(permissionMode: string | undefined, tool: OrionCodeTool | undefined, args: Record<string, unknown>): AskResolution;
-/**
- * Outcome of the full permission gate, before the `toolConfirmation` fallback
- * and interactive confirmation are considered.
- *
- * - `deny`    : hard refusal, `behavior: 'deny'` (tool policy or allowlist deny rule).
- * - `allow`   : approved without a prompt. `source` is set when the approval was
- *               an explicit escalation decision worth auditing.
- * - `confirm` : fall through to toolConfirmation / interactive confirmation.
- */
-export interface EffectivePermission {
-    outcome: 'deny' | 'allow' | 'confirm';
-    source?: PermissionDecisionSource;
-    reason?: string;
-    risk?: ToolRisk;
-}
-/**
- * Resolve the tool policy, project allowlist and permission mode into one decision.
- *
- * Precedence (most restrictive first, see services/tool-allowlist for the contract):
- *   1. tool `checkPermissions() === 'deny'`  — never overridable by config
- *   2. allowlist `deny:` rule                — project can always tighten
- *   3. auto mode                             — fully authorized; no interactive permission prompt
- *   4. allowlist `ask:` rule                 — explicit escalation in collaborative modes
- *   5. acceptEdits                           — only explicit file edits auto-run
- *   6. allowlist `allow:` rule               — explicit durable user approval
- *   7. safe read-only tools                  — auto-run in every collaborative mode
- *   8. otherwise confirm (fail closed)
- *
- * Agent PLAN is intentionally absent from this precedence list. It changes the
- * workflow prompt and lifecycle, not the available tool registry or permission
- * envelope; the legacy permission string `plan` therefore behaves like default.
- */
-export declare function resolveEffectivePermission(input: {
-    toolName: string;
-    tool?: OrionCodeTool;
-    args: Record<string, unknown>;
-    permission?: PermissionResult;
-    permissionMode?: string;
-    allowlist?: ToolAllowlistMatch;
-    toolConfirmation?: string;
-}): EffectivePermission;
-/**
- * Prepare tool calls: parse args, check drift, check permissions, determine concurrency.
- * Re-serializes tc.function.arguments to ensure valid JSON.
- */
-export declare function prepareToolCalls(options: ToolSchedulerOptions): PreparedToolCall[];
-/**
- * Execute prepared tool calls, respecting concurrency flags.
- * Parallel-safe tools run concurrently; unsafe tools run serially.
- * Results are returned in original call order.
- *
- * Returns an async generator that yields each result as it completes.
- */
-export declare function executeToolCalls(preparedCalls: PreparedToolCall[], options: {
-    toolExecutor: ToolSchedulerOptions['toolExecutor'];
-    abortSignal?: AbortSignal;
-    confirmToolUse?: ToolSchedulerOptions['confirmToolUse'];
-    permissionMode?: string;
-    toolConfirmation?: string;
-    toolAllowlist?: ToolAllowlistEvaluator;
-    harnessBlockedResult?: ToolSchedulerOptions['harnessBlockedResult'];
-    maxParallelToolCalls?: number;
-}): AsyncGenerator<ExecutedToolCall>;
-/**
- * Inspect how prepared tool calls would be scheduled.
- * Returns parallel and serial groups without executing.
- */
-export declare function inspectSchedule(preparedCalls: PreparedToolCall[]): ToolSchedule;
-export {};
-//# sourceMappingURL=tool-scheduler.d.ts.map

package/dist/framework/tool-scheduler.d.ts.map

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