@ordewell/core 0.10.5 → 0.10.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/{IRunner-Crkt3tHD.d.ts → IFileSystem-C4_mpfze.d.ts} +97 -14
- package/dist/{IRunner-lMQIa5Wc.d.mts → IFileSystem-DUgeWWQN.d.mts} +97 -14
- package/dist/{ModeResolver-B4hhABNf.d.mts → ModeResolver-4qNjxcDs.d.mts} +1 -1
- package/dist/{ModeResolver-CUR5jCSU.d.ts → ModeResolver-DGK2rWHE.d.ts} +1 -1
- package/dist/{Task-D4QHjdGv.d.mts → Task-C0o4i3Nn.d.mts} +23 -4
- package/dist/{Task-D4QHjdGv.d.ts → Task-C0o4i3Nn.d.ts} +23 -4
- package/dist/{chunk-6LEA6WAM.mjs → chunk-DMG4ISUG.mjs} +923 -45
- package/dist/chunk-DMG4ISUG.mjs.map +1 -0
- package/dist/{chunk-RT4NQ2BZ.mjs → chunk-EEE2GBLG.mjs} +114 -27
- package/dist/chunk-EEE2GBLG.mjs.map +1 -0
- package/dist/chunk-H7QX32BH.mjs +647 -0
- package/dist/chunk-H7QX32BH.mjs.map +1 -0
- package/dist/{chunk-F3KIX7WR.mjs → chunk-LTHKFBKM.mjs} +4 -4
- package/dist/chunk-LTHKFBKM.mjs.map +1 -0
- package/dist/index.d.mts +278 -1701
- package/dist/index.d.ts +278 -1701
- package/dist/index.js +2744 -1915
- package/dist/index.js.map +1 -1
- package/dist/index.mjs +2186 -1535
- package/dist/index.mjs.map +1 -1
- package/dist/parsing.d.mts +2 -2
- package/dist/parsing.d.ts +2 -2
- package/dist/parsing.js +231 -75
- package/dist/parsing.js.map +1 -1
- package/dist/parsing.mjs +3 -3
- package/dist/plan-utils.d.mts +20 -4
- package/dist/plan-utils.d.ts +20 -4
- package/dist/plan-utils.js +255 -97
- package/dist/plan-utils.js.map +1 -1
- package/dist/plan-utils.mjs +33 -19
- package/dist/{plan-utils-wI8MuDBC.d.mts → runSettingsText-BgOmLxdw.d.mts} +1941 -108
- package/dist/{plan-utils-BVJCzNvm.d.ts → runSettingsText-BgXvajj2.d.ts} +1941 -108
- package/dist/testing.d.mts +2 -3
- package/dist/testing.d.ts +2 -3
- package/dist/testing.js.map +1 -1
- package/dist/testing.mjs +1 -1
- package/package.json +1 -1
- package/dist/IFileSystem-ClBdp59f.d.ts +0 -78
- package/dist/IFileSystem-Db34maxC.d.mts +0 -78
- package/dist/chunk-4QLFM73A.mjs +0 -1407
- package/dist/chunk-4QLFM73A.mjs.map +0 -1
- package/dist/chunk-6LEA6WAM.mjs.map +0 -1
- package/dist/chunk-F3KIX7WR.mjs.map +0 -1
- package/dist/chunk-RT4NQ2BZ.mjs.map +0 -1
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { ChildProcess } from 'child_process';
|
|
2
|
-
import {
|
|
2
|
+
import { a4 as RunnerId, av as UsageRecord, ag as SubagentOutcome, a5 as RunnerSessionCost, d as DiscoveredModel, ap as TaskSkillSnapshot } from './Task-C0o4i3Nn.js';
|
|
3
3
|
import { z } from 'zod/v4';
|
|
4
4
|
|
|
5
5
|
/**
|
|
@@ -1101,22 +1101,28 @@ interface UsageLimitSignal {
|
|
|
1101
1101
|
*/
|
|
1102
1102
|
type AgentEvent =
|
|
1103
1103
|
/**
|
|
1104
|
-
* A complete run of the assistant's reply
|
|
1105
|
-
*
|
|
1106
|
-
*
|
|
1107
|
-
* appended after them.
|
|
1104
|
+
* A complete run of the assistant's reply — one text block, message or
|
|
1105
|
+
* part — under `runId`, the runner's own id for it. It is the authoritative
|
|
1106
|
+
* copy of the deltas streamed under the same id: it replaces them wherever
|
|
1107
|
+
* they now sit, it is not appended after them. No run carries the
|
|
1108
|
+
* paragraph break between it and the one before; a consumer joining runs
|
|
1109
|
+
* puts one there itself.
|
|
1108
1110
|
*/
|
|
1109
1111
|
{
|
|
1110
1112
|
type: 'assistant_text';
|
|
1113
|
+
runId: string;
|
|
1111
1114
|
text: string;
|
|
1112
1115
|
}
|
|
1113
1116
|
/**
|
|
1114
|
-
* An incremental piece of the
|
|
1115
|
-
*
|
|
1116
|
-
*
|
|
1117
|
+
* An incremental piece of the run `runId`, for agents that stream partial
|
|
1118
|
+
* messages. A run's first delta marks where it began, which is where it
|
|
1119
|
+
* stays when its complete copy arrives after later steps. The planner's own
|
|
1120
|
+
* text only: a subagent's words never arrive here, so they can never
|
|
1121
|
+
* become the reply.
|
|
1117
1122
|
*/
|
|
1118
1123
|
| {
|
|
1119
1124
|
type: 'assistant_text_delta';
|
|
1125
|
+
runId: string;
|
|
1120
1126
|
text: string;
|
|
1121
1127
|
}
|
|
1122
1128
|
/**
|
|
@@ -1443,9 +1449,10 @@ interface AgentAdapter {
|
|
|
1443
1449
|
/**
|
|
1444
1450
|
* Answer an open `permission_request`. False when the id is not open — it
|
|
1445
1451
|
* was answered, cancelled, or never asked. Absent on an adapter that leaves
|
|
1446
|
-
* no planner request open.
|
|
1452
|
+
* no planner request open. HTTP replies resolve only after delivery and
|
|
1453
|
+
* reject on failure, leaving the request open for another attempt.
|
|
1447
1454
|
*/
|
|
1448
|
-
answerPermission?(id: string, decision: ApprovalDecision): boolean
|
|
1455
|
+
answerPermission?(id: string, decision: ApprovalDecision): boolean | Promise<boolean>;
|
|
1449
1456
|
}
|
|
1450
1457
|
/** What an adapter adds to run a task rather than a planner (ADR-0018). */
|
|
1451
1458
|
interface TaskModeAgentAdapter extends AgentAdapter {
|
|
@@ -1479,7 +1486,7 @@ interface TaskModeAgentAdapter extends AgentAdapter {
|
|
|
1479
1486
|
* mid-turn.
|
|
1480
1487
|
*/
|
|
1481
1488
|
steer?(id: string, text: string): Promise<boolean>;
|
|
1482
|
-
answerPermission(id: string, decision: ApprovalDecision): boolean
|
|
1489
|
+
answerPermission(id: string, decision: ApprovalDecision): boolean | Promise<boolean>;
|
|
1483
1490
|
/**
|
|
1484
1491
|
* The slash commands the runner offers this session — its built-ins, the
|
|
1485
1492
|
* user's and the project's skills and custom commands (#66) — as it
|
|
@@ -1833,9 +1840,10 @@ interface IRunnerSession {
|
|
|
1833
1840
|
invokeCommand(name: string, args?: string): string;
|
|
1834
1841
|
/**
|
|
1835
1842
|
* Answer a `permission_request` this session emitted, by its event id. False
|
|
1836
|
-
* when it is no longer open — answered, withdrawn, or never asked.
|
|
1843
|
+
* when it is no longer open — answered, withdrawn, or never asked. An HTTP
|
|
1844
|
+
* answer settles after delivery; on failure it stays open and returns false.
|
|
1837
1845
|
*/
|
|
1838
|
-
answerPermission(id: string, decision: ApprovalDecision): boolean
|
|
1846
|
+
answerPermission(id: string, decision: ApprovalDecision): boolean | Promise<boolean>;
|
|
1839
1847
|
/**
|
|
1840
1848
|
* The runner's `task_complete` calls on this attempt's token (ADR-0022):
|
|
1841
1849
|
* the only completion evidence, for `VerdictEngine` to weigh.
|
|
@@ -1905,4 +1913,79 @@ interface IRunner {
|
|
|
1905
1913
|
activeCount: number;
|
|
1906
1914
|
}
|
|
1907
1915
|
|
|
1908
|
-
|
|
1916
|
+
interface ToolOutcome {
|
|
1917
|
+
success: boolean;
|
|
1918
|
+
output: string;
|
|
1919
|
+
truncated: boolean;
|
|
1920
|
+
}
|
|
1921
|
+
interface ReadFileOpts {
|
|
1922
|
+
maxBytes?: number;
|
|
1923
|
+
offset?: number;
|
|
1924
|
+
limit?: number;
|
|
1925
|
+
}
|
|
1926
|
+
/**
|
|
1927
|
+
* `content` returns matching lines, `files` only the paths that matched, and
|
|
1928
|
+
* `count` a per-file tally. Cheap models otherwise grep and then read whole
|
|
1929
|
+
* files to answer "which files touch this", burning rounds against the budget.
|
|
1930
|
+
*/
|
|
1931
|
+
type GrepOutputMode = 'content' | 'files' | 'count';
|
|
1932
|
+
interface GrepOptions {
|
|
1933
|
+
/** File glob filter, e.g. `*.ts`. */
|
|
1934
|
+
include?: string;
|
|
1935
|
+
/** Search root. Relative to the workspace unless approved as external. */
|
|
1936
|
+
path?: string;
|
|
1937
|
+
outputMode?: GrepOutputMode;
|
|
1938
|
+
/** Lines of context around each match (`content` mode only). */
|
|
1939
|
+
contextBefore?: number;
|
|
1940
|
+
contextAfter?: number;
|
|
1941
|
+
/** Treat the pattern as a literal string rather than a regex. */
|
|
1942
|
+
literal?: boolean;
|
|
1943
|
+
caseInsensitive?: boolean;
|
|
1944
|
+
/** Global cap on returned rows. Defaults to {@link GREP_DEFAULT_HEAD_LIMIT}. */
|
|
1945
|
+
headLimit?: number;
|
|
1946
|
+
}
|
|
1947
|
+
interface GlobOptions {
|
|
1948
|
+
/** Search root. Relative to the workspace unless approved as external. */
|
|
1949
|
+
path?: string;
|
|
1950
|
+
headLimit?: number;
|
|
1951
|
+
}
|
|
1952
|
+
interface FindSymbolOptions {
|
|
1953
|
+
/** Language id or file extension, e.g. `typescript` or `.go`. Narrows the keyword set. */
|
|
1954
|
+
language?: string;
|
|
1955
|
+
/** Search root. Relative to the workspace unless approved as external. */
|
|
1956
|
+
path?: string;
|
|
1957
|
+
}
|
|
1958
|
+
/** Global row cap for grep. A per-file cap is not a budget — see PoolFileSystem. */
|
|
1959
|
+
declare const GREP_DEFAULT_HEAD_LIMIT = 100;
|
|
1960
|
+
/**
|
|
1961
|
+
* Directories that are never interesting to a planner and would otherwise eat
|
|
1962
|
+
* the result budget. Applied by every search entry point, not just `glob` —
|
|
1963
|
+
* `dist/` and `.ordewell/` are frequently not gitignored.
|
|
1964
|
+
*/
|
|
1965
|
+
declare const SEARCH_EXCLUSIONS: string[];
|
|
1966
|
+
interface IFileSystem {
|
|
1967
|
+
readFile(path: string, opts?: ReadFileOpts): Promise<ToolOutcome>;
|
|
1968
|
+
readFiles(paths: string[]): Promise<ToolOutcome>;
|
|
1969
|
+
glob(pattern: string, opts?: GlobOptions): Promise<ToolOutcome>;
|
|
1970
|
+
grep(pattern: string, opts?: GrepOptions): Promise<ToolOutcome>;
|
|
1971
|
+
listDir(path: string, depth?: number): Promise<ToolOutcome>;
|
|
1972
|
+
/**
|
|
1973
|
+
* `signal` stops the planning turn this command belongs to: adapters kill
|
|
1974
|
+
* the spawned child rather than let it run out its own timeout. The other
|
|
1975
|
+
* tools here are short enough that the loop's between-call abort check is
|
|
1976
|
+
* indistinguishable from cancelling them mid-flight; a `bash` call is not.
|
|
1977
|
+
*/
|
|
1978
|
+
bash(command: string, signal?: AbortSignal): Promise<ToolOutcome>;
|
|
1979
|
+
/** Definition-first lookup for one symbol. See `symbolPatterns.ts`. */
|
|
1980
|
+
findSymbol(symbol: string, opts?: FindSymbolOptions): Promise<ToolOutcome>;
|
|
1981
|
+
getWorkspaceRoot(): string;
|
|
1982
|
+
/**
|
|
1983
|
+
* Inject the human-approval channel for out-of-envelope access. Optional so
|
|
1984
|
+
* test doubles stay small; every adapter extending `BaseFileSystem` has it.
|
|
1985
|
+
*/
|
|
1986
|
+
setApproval?(approval: IApproval): void;
|
|
1987
|
+
/** Held credentials read live by the outbound secret check. */
|
|
1988
|
+
setOutboundSecrets?(secrets: () => Iterable<string>): void;
|
|
1989
|
+
}
|
|
1990
|
+
|
|
1991
|
+
export { ORCHESTRATOR_SHORTCUTS as $, AUTO_COMMANDS as A, type GlobOptions as B, type CatalogModel as C, DEFAULT_PLANNER_ALLOWLIST as D, type EditPlanArgs as E, type FetchAllProviderModelsOptions as F, GIT_READONLY_SUBCOMMANDS as G, type GrepOptions as H, type GrepOutputMode as I, type IApproval as J, type IConfig as K, type IFileSystem as L, type IRunner as M, type IRunnerSession as N, type InvokedCommand as O, LineBuffer as P, type ListModelsArgs as Q, type ListRunnersArgs as R, type LoadSkillArgs as S, type McpClientConfig as T, type McpCredential as U, type McpTool as V, type McpToolContext as W, type McpToolReply as X, type MessageTaskArgs as Y, ModelCatalog as Z, type ModelShortcut as _, type AgentAdapter as a, effectiveApprovalMode as a$, ORDEWELL_MCP_PATH as a0, ORDEWELL_MCP_SERVER_NAME as a1, type OneTaskArgs as a2, type OrchestratorOption as a3, OrdewellMcpServer as a4, type OwnerOnlyFile as a5, PLANNER_EXECUTION_TOOLS as a6, PLANNER_TOOLS as a7, type PlannerAllowlist as a8, type PlannerBackendId as a9, type ShellDialect as aA, type SpawnFn as aB, type StandingDecision as aC, type StructuredEvent as aD, type StructuredTurnEnd as aE, type SubmitPlanArgs as aF, TASK_COMPLETE_TOOL as aG, TASK_COMPLETION_CONTRACT as aH, TASK_TOOLS as aI, type TaskCompleteArgs as aJ, type TaskDiffArgs as aK, type TaskMessageFrom as aL, type TaskModeAgentAdapter as aM, TaskModeUnsupportedError as aN, type TaskOutputArgs as aO, type TaskQueryArgs as aP, type TaskRunnerFlags as aQ, type TaskStartOptions as aR, type TaskTokenScope as aS, type TaskToolHandler as aT, type ToolOutcome as aU, type UsageLimitSignal as aV, approvalScopes as aW, classifyCommand as aX, clearResearchShellCache as aY, collectProviderCredentials as aZ, commandAllowedBy as a_, type PlannerStartOptions as aa, type PlannerTokenScope as ab, type PlannerToolHandler as ac, type ProjectMcpServer as ad, type ProviderCredentialSource as ae, type ProviderModelLists as af, type ProviderModelsResult as ag, type QueuedTaskMessage as ah, REFUSED_COMMANDS as ai, type ReadFileOpts as aj, type ResearchShell as ak, type ResearchShellDeps as al, type RetryTaskArgs as am, type RunCommandArgs as an, type RunPlanArgs as ao, type RunnerCommand as ap, type RunnerCommandKind as aq, type RunnerEntry as ar, type RunnerFeatures as as, type RunnerManifest as at, type RunnerMcpServer as au, type RunnerMode as av, type RunnerModelDiscovery as aw, type RunnerModelRef as ax, RunnerRegistry as ay, SEARCH_EXCLUSIONS as az, type AgentAdapterFactory as b, enabledRunners as b0, fetchAllProviderModels as b1, findRunnerCommand as b2, isGranted as b3, isRunnerApproval as b4, knownModelId as b5, mcpClientConfig as b6, ownerOnlyConfigFile as b7, parseAllowlist as b8, parseApprovalModeSetting as b9, researchShellWarning as ba, researchToolsPath as bb, resolveModelShortcut as bc, resolveProvider as bd, resolveResearchShell as be, scopeAllowed as bf, sharedMcpServer as bg, toApprovalDecision as bh, toOrchestratorOptions as bi, toolAllowed as bj, type AgentEvent as c, type AgentProcessDeps as d, type AgentStartOptions as e, type AiProvider as f, type AllProviderModels as g, type AnswerApprovalArgs as h, type ApprovalAnswer as i, type ApprovalDecision as j, type ApprovalKind as k, type ApprovalMode as l, type ApprovalModeSetting as m, ApprovalPolicy as n, type ApprovalPolicyOptions as o, type ApprovalRequest as p, type ApprovalSource as q, type CheckpointAnswer as r, type CheckpointArgs as s, type CommandClassification as t, type CommandTier as u, type CommandWords as v, DENY_ALL as w, type DiscoveryCommand as x, type FindSymbolOptions as y, GREP_DEFAULT_HEAD_LIMIT as z };
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { ChildProcess } from 'child_process';
|
|
2
|
-
import {
|
|
2
|
+
import { a4 as RunnerId, av as UsageRecord, ag as SubagentOutcome, a5 as RunnerSessionCost, d as DiscoveredModel, ap as TaskSkillSnapshot } from './Task-C0o4i3Nn.mjs';
|
|
3
3
|
import { z } from 'zod/v4';
|
|
4
4
|
|
|
5
5
|
/**
|
|
@@ -1101,22 +1101,28 @@ interface UsageLimitSignal {
|
|
|
1101
1101
|
*/
|
|
1102
1102
|
type AgentEvent =
|
|
1103
1103
|
/**
|
|
1104
|
-
* A complete run of the assistant's reply
|
|
1105
|
-
*
|
|
1106
|
-
*
|
|
1107
|
-
* appended after them.
|
|
1104
|
+
* A complete run of the assistant's reply — one text block, message or
|
|
1105
|
+
* part — under `runId`, the runner's own id for it. It is the authoritative
|
|
1106
|
+
* copy of the deltas streamed under the same id: it replaces them wherever
|
|
1107
|
+
* they now sit, it is not appended after them. No run carries the
|
|
1108
|
+
* paragraph break between it and the one before; a consumer joining runs
|
|
1109
|
+
* puts one there itself.
|
|
1108
1110
|
*/
|
|
1109
1111
|
{
|
|
1110
1112
|
type: 'assistant_text';
|
|
1113
|
+
runId: string;
|
|
1111
1114
|
text: string;
|
|
1112
1115
|
}
|
|
1113
1116
|
/**
|
|
1114
|
-
* An incremental piece of the
|
|
1115
|
-
*
|
|
1116
|
-
*
|
|
1117
|
+
* An incremental piece of the run `runId`, for agents that stream partial
|
|
1118
|
+
* messages. A run's first delta marks where it began, which is where it
|
|
1119
|
+
* stays when its complete copy arrives after later steps. The planner's own
|
|
1120
|
+
* text only: a subagent's words never arrive here, so they can never
|
|
1121
|
+
* become the reply.
|
|
1117
1122
|
*/
|
|
1118
1123
|
| {
|
|
1119
1124
|
type: 'assistant_text_delta';
|
|
1125
|
+
runId: string;
|
|
1120
1126
|
text: string;
|
|
1121
1127
|
}
|
|
1122
1128
|
/**
|
|
@@ -1443,9 +1449,10 @@ interface AgentAdapter {
|
|
|
1443
1449
|
/**
|
|
1444
1450
|
* Answer an open `permission_request`. False when the id is not open — it
|
|
1445
1451
|
* was answered, cancelled, or never asked. Absent on an adapter that leaves
|
|
1446
|
-
* no planner request open.
|
|
1452
|
+
* no planner request open. HTTP replies resolve only after delivery and
|
|
1453
|
+
* reject on failure, leaving the request open for another attempt.
|
|
1447
1454
|
*/
|
|
1448
|
-
answerPermission?(id: string, decision: ApprovalDecision): boolean
|
|
1455
|
+
answerPermission?(id: string, decision: ApprovalDecision): boolean | Promise<boolean>;
|
|
1449
1456
|
}
|
|
1450
1457
|
/** What an adapter adds to run a task rather than a planner (ADR-0018). */
|
|
1451
1458
|
interface TaskModeAgentAdapter extends AgentAdapter {
|
|
@@ -1479,7 +1486,7 @@ interface TaskModeAgentAdapter extends AgentAdapter {
|
|
|
1479
1486
|
* mid-turn.
|
|
1480
1487
|
*/
|
|
1481
1488
|
steer?(id: string, text: string): Promise<boolean>;
|
|
1482
|
-
answerPermission(id: string, decision: ApprovalDecision): boolean
|
|
1489
|
+
answerPermission(id: string, decision: ApprovalDecision): boolean | Promise<boolean>;
|
|
1483
1490
|
/**
|
|
1484
1491
|
* The slash commands the runner offers this session — its built-ins, the
|
|
1485
1492
|
* user's and the project's skills and custom commands (#66) — as it
|
|
@@ -1833,9 +1840,10 @@ interface IRunnerSession {
|
|
|
1833
1840
|
invokeCommand(name: string, args?: string): string;
|
|
1834
1841
|
/**
|
|
1835
1842
|
* Answer a `permission_request` this session emitted, by its event id. False
|
|
1836
|
-
* when it is no longer open — answered, withdrawn, or never asked.
|
|
1843
|
+
* when it is no longer open — answered, withdrawn, or never asked. An HTTP
|
|
1844
|
+
* answer settles after delivery; on failure it stays open and returns false.
|
|
1837
1845
|
*/
|
|
1838
|
-
answerPermission(id: string, decision: ApprovalDecision): boolean
|
|
1846
|
+
answerPermission(id: string, decision: ApprovalDecision): boolean | Promise<boolean>;
|
|
1839
1847
|
/**
|
|
1840
1848
|
* The runner's `task_complete` calls on this attempt's token (ADR-0022):
|
|
1841
1849
|
* the only completion evidence, for `VerdictEngine` to weigh.
|
|
@@ -1905,4 +1913,79 @@ interface IRunner {
|
|
|
1905
1913
|
activeCount: number;
|
|
1906
1914
|
}
|
|
1907
1915
|
|
|
1908
|
-
|
|
1916
|
+
interface ToolOutcome {
|
|
1917
|
+
success: boolean;
|
|
1918
|
+
output: string;
|
|
1919
|
+
truncated: boolean;
|
|
1920
|
+
}
|
|
1921
|
+
interface ReadFileOpts {
|
|
1922
|
+
maxBytes?: number;
|
|
1923
|
+
offset?: number;
|
|
1924
|
+
limit?: number;
|
|
1925
|
+
}
|
|
1926
|
+
/**
|
|
1927
|
+
* `content` returns matching lines, `files` only the paths that matched, and
|
|
1928
|
+
* `count` a per-file tally. Cheap models otherwise grep and then read whole
|
|
1929
|
+
* files to answer "which files touch this", burning rounds against the budget.
|
|
1930
|
+
*/
|
|
1931
|
+
type GrepOutputMode = 'content' | 'files' | 'count';
|
|
1932
|
+
interface GrepOptions {
|
|
1933
|
+
/** File glob filter, e.g. `*.ts`. */
|
|
1934
|
+
include?: string;
|
|
1935
|
+
/** Search root. Relative to the workspace unless approved as external. */
|
|
1936
|
+
path?: string;
|
|
1937
|
+
outputMode?: GrepOutputMode;
|
|
1938
|
+
/** Lines of context around each match (`content` mode only). */
|
|
1939
|
+
contextBefore?: number;
|
|
1940
|
+
contextAfter?: number;
|
|
1941
|
+
/** Treat the pattern as a literal string rather than a regex. */
|
|
1942
|
+
literal?: boolean;
|
|
1943
|
+
caseInsensitive?: boolean;
|
|
1944
|
+
/** Global cap on returned rows. Defaults to {@link GREP_DEFAULT_HEAD_LIMIT}. */
|
|
1945
|
+
headLimit?: number;
|
|
1946
|
+
}
|
|
1947
|
+
interface GlobOptions {
|
|
1948
|
+
/** Search root. Relative to the workspace unless approved as external. */
|
|
1949
|
+
path?: string;
|
|
1950
|
+
headLimit?: number;
|
|
1951
|
+
}
|
|
1952
|
+
interface FindSymbolOptions {
|
|
1953
|
+
/** Language id or file extension, e.g. `typescript` or `.go`. Narrows the keyword set. */
|
|
1954
|
+
language?: string;
|
|
1955
|
+
/** Search root. Relative to the workspace unless approved as external. */
|
|
1956
|
+
path?: string;
|
|
1957
|
+
}
|
|
1958
|
+
/** Global row cap for grep. A per-file cap is not a budget — see PoolFileSystem. */
|
|
1959
|
+
declare const GREP_DEFAULT_HEAD_LIMIT = 100;
|
|
1960
|
+
/**
|
|
1961
|
+
* Directories that are never interesting to a planner and would otherwise eat
|
|
1962
|
+
* the result budget. Applied by every search entry point, not just `glob` —
|
|
1963
|
+
* `dist/` and `.ordewell/` are frequently not gitignored.
|
|
1964
|
+
*/
|
|
1965
|
+
declare const SEARCH_EXCLUSIONS: string[];
|
|
1966
|
+
interface IFileSystem {
|
|
1967
|
+
readFile(path: string, opts?: ReadFileOpts): Promise<ToolOutcome>;
|
|
1968
|
+
readFiles(paths: string[]): Promise<ToolOutcome>;
|
|
1969
|
+
glob(pattern: string, opts?: GlobOptions): Promise<ToolOutcome>;
|
|
1970
|
+
grep(pattern: string, opts?: GrepOptions): Promise<ToolOutcome>;
|
|
1971
|
+
listDir(path: string, depth?: number): Promise<ToolOutcome>;
|
|
1972
|
+
/**
|
|
1973
|
+
* `signal` stops the planning turn this command belongs to: adapters kill
|
|
1974
|
+
* the spawned child rather than let it run out its own timeout. The other
|
|
1975
|
+
* tools here are short enough that the loop's between-call abort check is
|
|
1976
|
+
* indistinguishable from cancelling them mid-flight; a `bash` call is not.
|
|
1977
|
+
*/
|
|
1978
|
+
bash(command: string, signal?: AbortSignal): Promise<ToolOutcome>;
|
|
1979
|
+
/** Definition-first lookup for one symbol. See `symbolPatterns.ts`. */
|
|
1980
|
+
findSymbol(symbol: string, opts?: FindSymbolOptions): Promise<ToolOutcome>;
|
|
1981
|
+
getWorkspaceRoot(): string;
|
|
1982
|
+
/**
|
|
1983
|
+
* Inject the human-approval channel for out-of-envelope access. Optional so
|
|
1984
|
+
* test doubles stay small; every adapter extending `BaseFileSystem` has it.
|
|
1985
|
+
*/
|
|
1986
|
+
setApproval?(approval: IApproval): void;
|
|
1987
|
+
/** Held credentials read live by the outbound secret check. */
|
|
1988
|
+
setOutboundSecrets?(secrets: () => Iterable<string>): void;
|
|
1989
|
+
}
|
|
1990
|
+
|
|
1991
|
+
export { ORCHESTRATOR_SHORTCUTS as $, AUTO_COMMANDS as A, type GlobOptions as B, type CatalogModel as C, DEFAULT_PLANNER_ALLOWLIST as D, type EditPlanArgs as E, type FetchAllProviderModelsOptions as F, GIT_READONLY_SUBCOMMANDS as G, type GrepOptions as H, type GrepOutputMode as I, type IApproval as J, type IConfig as K, type IFileSystem as L, type IRunner as M, type IRunnerSession as N, type InvokedCommand as O, LineBuffer as P, type ListModelsArgs as Q, type ListRunnersArgs as R, type LoadSkillArgs as S, type McpClientConfig as T, type McpCredential as U, type McpTool as V, type McpToolContext as W, type McpToolReply as X, type MessageTaskArgs as Y, ModelCatalog as Z, type ModelShortcut as _, type AgentAdapter as a, effectiveApprovalMode as a$, ORDEWELL_MCP_PATH as a0, ORDEWELL_MCP_SERVER_NAME as a1, type OneTaskArgs as a2, type OrchestratorOption as a3, OrdewellMcpServer as a4, type OwnerOnlyFile as a5, PLANNER_EXECUTION_TOOLS as a6, PLANNER_TOOLS as a7, type PlannerAllowlist as a8, type PlannerBackendId as a9, type ShellDialect as aA, type SpawnFn as aB, type StandingDecision as aC, type StructuredEvent as aD, type StructuredTurnEnd as aE, type SubmitPlanArgs as aF, TASK_COMPLETE_TOOL as aG, TASK_COMPLETION_CONTRACT as aH, TASK_TOOLS as aI, type TaskCompleteArgs as aJ, type TaskDiffArgs as aK, type TaskMessageFrom as aL, type TaskModeAgentAdapter as aM, TaskModeUnsupportedError as aN, type TaskOutputArgs as aO, type TaskQueryArgs as aP, type TaskRunnerFlags as aQ, type TaskStartOptions as aR, type TaskTokenScope as aS, type TaskToolHandler as aT, type ToolOutcome as aU, type UsageLimitSignal as aV, approvalScopes as aW, classifyCommand as aX, clearResearchShellCache as aY, collectProviderCredentials as aZ, commandAllowedBy as a_, type PlannerStartOptions as aa, type PlannerTokenScope as ab, type PlannerToolHandler as ac, type ProjectMcpServer as ad, type ProviderCredentialSource as ae, type ProviderModelLists as af, type ProviderModelsResult as ag, type QueuedTaskMessage as ah, REFUSED_COMMANDS as ai, type ReadFileOpts as aj, type ResearchShell as ak, type ResearchShellDeps as al, type RetryTaskArgs as am, type RunCommandArgs as an, type RunPlanArgs as ao, type RunnerCommand as ap, type RunnerCommandKind as aq, type RunnerEntry as ar, type RunnerFeatures as as, type RunnerManifest as at, type RunnerMcpServer as au, type RunnerMode as av, type RunnerModelDiscovery as aw, type RunnerModelRef as ax, RunnerRegistry as ay, SEARCH_EXCLUSIONS as az, type AgentAdapterFactory as b, enabledRunners as b0, fetchAllProviderModels as b1, findRunnerCommand as b2, isGranted as b3, isRunnerApproval as b4, knownModelId as b5, mcpClientConfig as b6, ownerOnlyConfigFile as b7, parseAllowlist as b8, parseApprovalModeSetting as b9, researchShellWarning as ba, researchToolsPath as bb, resolveModelShortcut as bc, resolveProvider as bd, resolveResearchShell as be, scopeAllowed as bf, sharedMcpServer as bg, toApprovalDecision as bh, toOrchestratorOptions as bi, toolAllowed as bj, type AgentEvent as c, type AgentProcessDeps as d, type AgentStartOptions as e, type AiProvider as f, type AllProviderModels as g, type AnswerApprovalArgs as h, type ApprovalAnswer as i, type ApprovalDecision as j, type ApprovalKind as k, type ApprovalMode as l, type ApprovalModeSetting as m, ApprovalPolicy as n, type ApprovalPolicyOptions as o, type ApprovalRequest as p, type ApprovalSource as q, type CheckpointAnswer as r, type CheckpointArgs as s, type CommandClassification as t, type CommandTier as u, type CommandWords as v, DENY_ALL as w, type DiscoveryCommand as x, type FindSymbolOptions as y, GREP_DEFAULT_HEAD_LIMIT as z };
|
|
@@ -744,7 +744,7 @@ type ExecutionActor = {
|
|
|
744
744
|
| {
|
|
745
745
|
kind: 'autorun';
|
|
746
746
|
};
|
|
747
|
-
type ExecutionCommandName = 'run_plan' | 'run_task' | 'stop_task' | 'stop_run' | 'retry_task' | 'message_task' | 'answer_approval' | 'merge_all' | 'skip_task';
|
|
747
|
+
type ExecutionCommandName = 'run_plan' | 'run_task' | 'stop_task' | 'stop_run' | 'retry_task' | 'message_task' | 'answer_approval' | 'merge_all' | 'skip_task' | 'force_start' | 'mark_complete' | 'mark_not_done' | 'interrupt_task' | 'force_send_queued' | 'remove_queued' | 'cancel_resume' | 'answer_checkpoint' | 'approve_review';
|
|
748
748
|
/**
|
|
749
749
|
* One call at the command seam as the timeline keeps it: what was asked, by
|
|
750
750
|
* whom, about which task, and how it ended — done, refused by the seam, or
|
|
@@ -992,9 +992,11 @@ type TaskType = 'ai' | 'user';
|
|
|
992
992
|
/**
|
|
993
993
|
* `skipped` is terminal and verdict-less: the task will not be waited for, and
|
|
994
994
|
* nothing it did lands. Its dependents go ahead without it once the work it
|
|
995
|
-
* waited on is done.
|
|
995
|
+
* waited on is done. There is no stored `blocked`: a task is blocked when a
|
|
996
|
+
* failed dependency says so (ADR-0034), and a file that kept the old status
|
|
997
|
+
* loads as pending.
|
|
996
998
|
*/
|
|
997
|
-
type TaskStatus = 'pending' | 'approved' | 'in_progress' | 'completed' | 'failed' | '
|
|
999
|
+
type TaskStatus = 'pending' | 'approved' | 'in_progress' | 'completed' | 'failed' | 'awaiting_user' | 'skipped';
|
|
998
1000
|
type TaskMode = string;
|
|
999
1001
|
/**
|
|
1000
1002
|
* Why an `awaiting_user` task waits (ADR-0018, W1): a structured turn that
|
|
@@ -1257,6 +1259,23 @@ interface ConversationMessage {
|
|
|
1257
1259
|
execution?: ExecutionRecord;
|
|
1258
1260
|
/** A user's message that was force sent, stopping the turn before it (ADR-0023). */
|
|
1259
1261
|
forced?: true;
|
|
1262
|
+
/**
|
|
1263
|
+
* What a reply showed, run by run, where each began (ADR-0017 A1). Beside
|
|
1264
|
+
* `content`, which stays the reply as the planner is told it. Absent on
|
|
1265
|
+
* entries saved before runs were kept, which reload as one message.
|
|
1266
|
+
*/
|
|
1267
|
+
runs?: ReplyRun[];
|
|
1268
|
+
}
|
|
1269
|
+
/**
|
|
1270
|
+
* One run of a planner reply's text: the segment it streamed under, its
|
|
1271
|
+
* settled text, and when it began. A run that never streamed (a message the
|
|
1272
|
+
* conversation wrote in the planner's place) has a segment no stream used.
|
|
1273
|
+
*/
|
|
1274
|
+
interface ReplyRun {
|
|
1275
|
+
segmentId: string;
|
|
1276
|
+
text: string;
|
|
1277
|
+
/** ISO timestamp. */
|
|
1278
|
+
startedAt: string;
|
|
1260
1279
|
}
|
|
1261
1280
|
/**
|
|
1262
1281
|
* A skill's SKILL.md as it was when loaded into a planner conversation. A
|
|
@@ -1467,4 +1486,4 @@ type ApprovalRecord = Pick<LegacyPlanState, 'approved' | 'approvedTasks'>;
|
|
|
1467
1486
|
*/
|
|
1468
1487
|
declare function waitsForApproval(task: Pick<Task, 'id' | 'type' | 'status'>, record: ApprovalRecord): boolean;
|
|
1469
1488
|
|
|
1470
|
-
export { type
|
|
1489
|
+
export { type ResearchProgress as $, type ApprovalRecord as A, BUILTIN_SKILL_NAMES as B, type ConversationMessage as C, DEFAULT_RUNNERS as D, type ExecutionActor as E, type IsolationTaskStatus as F, type GuardTarget as G, type IsolationView as H, type IWorktreeIsolation as I, type PlanIsolation as J, type PlanState as K, type LegacyPlanState as L, type ModelUsage as M, type PlanStatus as N, type PlanUsage as O, type PendingPlanTurn as P, type PlannerResendState as Q, type PlannerUsage as R, type PrepareIntent as S, type PreparedTask as T, type PreservedWork as U, type PreviousWork as V, type RefusedRemoval as W, type RepairEvidence as X, type ReplyRun as Y, type RepoGroupLayout as Z, type ResearchLogEntry as _, type AttemptUsage as a, type ResearchStep as a0, type ResearchStepOutcome as a1, type ResearchToolType as a2, type RunSettings as a3, type RunnerId as a4, type RunnerSessionCost as a5, type SetupFailure as a6, type ShadowedSkill as a7, type SkillAppliesTo as a8, type SkillCatalog as a9, addModelUsage as aA, addPlannerUsage as aB, addUsage as aC, addUsageTotals as aD, countedSessionCost as aE, createEmptyPlan as aF, createSkillsService as aG, createTask as aH, endAttemptUsage as aI, flattenTasks as aJ, flattenTasksWithParents as aK, isAwaitingReason as aL, isMeasured as aM, isSupervisorLevel as aN, isUserMessage as aO, migratePlanState as aP, partedPromptUsage as aQ, pausedOnLimit as aR, planUsage as aS, plannerContextFill as aT, rejoinPlanTree as aU, resumedSessionWindow as aV, startAttemptUsage as aW, taskUsageSummary as aX, usageLine as aY, waitsForApproval as aZ, type SkillInfo as aa, type SkillLoad as ab, type SkillLoadNotice as ac, type SkillMetadata as ad, type SkillSource as ae, SkillsService as af, type SubagentOutcome as ag, type SupervisorLevel as ah, type Task as ai, type TaskDiffRead as aj, type TaskDiffResult as ak, type TaskIsolation as al, type TaskIsolationState as am, type TaskModelAssignment as an, type TaskSkillNotice as ao, type TaskSkillSnapshot as ap, type TaskSnapshot as aq, type TaskStatus as ar, type TaskUsageSummary as as, type TreeSnapshot as at, type UsageLine as au, type UsageRecord as av, type UsageTotals as aw, type Verdict as ax, type VerificationCheck as ay, addAttemptUsage as az, type AwaitingReason as b, DEFAULT_SUPERVISOR_RETRY_LIMIT as c, type DiscoveredModel as d, type ExecutionCommandName as e, type ExecutionRecord as f, type GuardTrip as g, type IntegrationDisposal as h, type InvalidSkill as i, type IsolationAvailability as j, type IsolationHandoff as k, type IsolationHandoffRepo as l, type IsolationInactiveReason as m, type IsolationLandedTask as n, type IsolationLanding as o, type IsolationMergeBlock as p, type IsolationMergeBlockReason as q, type IsolationMergeResult as r, type IsolationOutcome as s, type IsolationPruneResult as t, type IsolationRemoval as u, type IsolationRepo as v, type IsolationRun as w, type IsolationTaskRecord as x, type IsolationTaskRef as y, type IsolationTaskRepo as z };
|
|
@@ -744,7 +744,7 @@ type ExecutionActor = {
|
|
|
744
744
|
| {
|
|
745
745
|
kind: 'autorun';
|
|
746
746
|
};
|
|
747
|
-
type ExecutionCommandName = 'run_plan' | 'run_task' | 'stop_task' | 'stop_run' | 'retry_task' | 'message_task' | 'answer_approval' | 'merge_all' | 'skip_task';
|
|
747
|
+
type ExecutionCommandName = 'run_plan' | 'run_task' | 'stop_task' | 'stop_run' | 'retry_task' | 'message_task' | 'answer_approval' | 'merge_all' | 'skip_task' | 'force_start' | 'mark_complete' | 'mark_not_done' | 'interrupt_task' | 'force_send_queued' | 'remove_queued' | 'cancel_resume' | 'answer_checkpoint' | 'approve_review';
|
|
748
748
|
/**
|
|
749
749
|
* One call at the command seam as the timeline keeps it: what was asked, by
|
|
750
750
|
* whom, about which task, and how it ended — done, refused by the seam, or
|
|
@@ -992,9 +992,11 @@ type TaskType = 'ai' | 'user';
|
|
|
992
992
|
/**
|
|
993
993
|
* `skipped` is terminal and verdict-less: the task will not be waited for, and
|
|
994
994
|
* nothing it did lands. Its dependents go ahead without it once the work it
|
|
995
|
-
* waited on is done.
|
|
995
|
+
* waited on is done. There is no stored `blocked`: a task is blocked when a
|
|
996
|
+
* failed dependency says so (ADR-0034), and a file that kept the old status
|
|
997
|
+
* loads as pending.
|
|
996
998
|
*/
|
|
997
|
-
type TaskStatus = 'pending' | 'approved' | 'in_progress' | 'completed' | 'failed' | '
|
|
999
|
+
type TaskStatus = 'pending' | 'approved' | 'in_progress' | 'completed' | 'failed' | 'awaiting_user' | 'skipped';
|
|
998
1000
|
type TaskMode = string;
|
|
999
1001
|
/**
|
|
1000
1002
|
* Why an `awaiting_user` task waits (ADR-0018, W1): a structured turn that
|
|
@@ -1257,6 +1259,23 @@ interface ConversationMessage {
|
|
|
1257
1259
|
execution?: ExecutionRecord;
|
|
1258
1260
|
/** A user's message that was force sent, stopping the turn before it (ADR-0023). */
|
|
1259
1261
|
forced?: true;
|
|
1262
|
+
/**
|
|
1263
|
+
* What a reply showed, run by run, where each began (ADR-0017 A1). Beside
|
|
1264
|
+
* `content`, which stays the reply as the planner is told it. Absent on
|
|
1265
|
+
* entries saved before runs were kept, which reload as one message.
|
|
1266
|
+
*/
|
|
1267
|
+
runs?: ReplyRun[];
|
|
1268
|
+
}
|
|
1269
|
+
/**
|
|
1270
|
+
* One run of a planner reply's text: the segment it streamed under, its
|
|
1271
|
+
* settled text, and when it began. A run that never streamed (a message the
|
|
1272
|
+
* conversation wrote in the planner's place) has a segment no stream used.
|
|
1273
|
+
*/
|
|
1274
|
+
interface ReplyRun {
|
|
1275
|
+
segmentId: string;
|
|
1276
|
+
text: string;
|
|
1277
|
+
/** ISO timestamp. */
|
|
1278
|
+
startedAt: string;
|
|
1260
1279
|
}
|
|
1261
1280
|
/**
|
|
1262
1281
|
* A skill's SKILL.md as it was when loaded into a planner conversation. A
|
|
@@ -1467,4 +1486,4 @@ type ApprovalRecord = Pick<LegacyPlanState, 'approved' | 'approvedTasks'>;
|
|
|
1467
1486
|
*/
|
|
1468
1487
|
declare function waitsForApproval(task: Pick<Task, 'id' | 'type' | 'status'>, record: ApprovalRecord): boolean;
|
|
1469
1488
|
|
|
1470
|
-
export { type
|
|
1489
|
+
export { type ResearchProgress as $, type ApprovalRecord as A, BUILTIN_SKILL_NAMES as B, type ConversationMessage as C, DEFAULT_RUNNERS as D, type ExecutionActor as E, type IsolationTaskStatus as F, type GuardTarget as G, type IsolationView as H, type IWorktreeIsolation as I, type PlanIsolation as J, type PlanState as K, type LegacyPlanState as L, type ModelUsage as M, type PlanStatus as N, type PlanUsage as O, type PendingPlanTurn as P, type PlannerResendState as Q, type PlannerUsage as R, type PrepareIntent as S, type PreparedTask as T, type PreservedWork as U, type PreviousWork as V, type RefusedRemoval as W, type RepairEvidence as X, type ReplyRun as Y, type RepoGroupLayout as Z, type ResearchLogEntry as _, type AttemptUsage as a, type ResearchStep as a0, type ResearchStepOutcome as a1, type ResearchToolType as a2, type RunSettings as a3, type RunnerId as a4, type RunnerSessionCost as a5, type SetupFailure as a6, type ShadowedSkill as a7, type SkillAppliesTo as a8, type SkillCatalog as a9, addModelUsage as aA, addPlannerUsage as aB, addUsage as aC, addUsageTotals as aD, countedSessionCost as aE, createEmptyPlan as aF, createSkillsService as aG, createTask as aH, endAttemptUsage as aI, flattenTasks as aJ, flattenTasksWithParents as aK, isAwaitingReason as aL, isMeasured as aM, isSupervisorLevel as aN, isUserMessage as aO, migratePlanState as aP, partedPromptUsage as aQ, pausedOnLimit as aR, planUsage as aS, plannerContextFill as aT, rejoinPlanTree as aU, resumedSessionWindow as aV, startAttemptUsage as aW, taskUsageSummary as aX, usageLine as aY, waitsForApproval as aZ, type SkillInfo as aa, type SkillLoad as ab, type SkillLoadNotice as ac, type SkillMetadata as ad, type SkillSource as ae, SkillsService as af, type SubagentOutcome as ag, type SupervisorLevel as ah, type Task as ai, type TaskDiffRead as aj, type TaskDiffResult as ak, type TaskIsolation as al, type TaskIsolationState as am, type TaskModelAssignment as an, type TaskSkillNotice as ao, type TaskSkillSnapshot as ap, type TaskSnapshot as aq, type TaskStatus as ar, type TaskUsageSummary as as, type TreeSnapshot as at, type UsageLine as au, type UsageRecord as av, type UsageTotals as aw, type Verdict as ax, type VerificationCheck as ay, addAttemptUsage as az, type AwaitingReason as b, DEFAULT_SUPERVISOR_RETRY_LIMIT as c, type DiscoveredModel as d, type ExecutionCommandName as e, type ExecutionRecord as f, type GuardTrip as g, type IntegrationDisposal as h, type InvalidSkill as i, type IsolationAvailability as j, type IsolationHandoff as k, type IsolationHandoffRepo as l, type IsolationInactiveReason as m, type IsolationLandedTask as n, type IsolationLanding as o, type IsolationMergeBlock as p, type IsolationMergeBlockReason as q, type IsolationMergeResult as r, type IsolationOutcome as s, type IsolationPruneResult as t, type IsolationRemoval as u, type IsolationRepo as v, type IsolationRun as w, type IsolationTaskRecord as x, type IsolationTaskRef as y, type IsolationTaskRepo as z };
|