@twelvehart/orcats 0.0.0-seed.0 → 0.2.3

package/dist/review/loop.d.ts

@@ -0,0 +1,117 @@
+import { type Result } from "neverthrow";
+import { type FingerprintAction, type FingerprintDetectorOptions, type TokenUsageSummary } from "../loop/termination.ts";
+import type { RuntimeError } from "../model/index.ts";
+import type { ReviewerId, ReviewerPrompt } from "./reviewers.ts";
+export type { FingerprintAction, FingerprintDetectorOptions, TokenUsageSummary, } from "../loop/termination.ts";
+/** Why the loop stopped. `converged` is the only success; the rest are
+ * non-convergence reasons that map onto a `regressed` verdict. */
+export type FixLoopStop = "converged" | "unfixable" | "stuck" | "timeout" | "ceiling" | "budget-exhausted";
+export type FixLoopFixOutcome = Result<unknown, RuntimeError>;
+export interface FixLoopSummary<I extends {
+    readonly fixable: boolean;
+} = ReviewIssue> {
+    readonly iterations: number;
+    readonly ignoredIssues: readonly I[];
+    readonly converged: boolean;
+    readonly stop: FixLoopStop;
+    readonly events: readonly string[];
+    readonly tokenUsage?: TokenUsageSummary;
+}
+export type IssueFingerprint<I extends {
+    readonly fixable: boolean;
+}> = ((issues: readonly I[]) => FingerprintAction | undefined) | (Omit<FingerprintDetectorOptions<readonly I[]>, "project"> & {
+    readonly project: (issues: readonly I[]) => FingerprintAction | undefined;
+});
+export interface FixLoopOptions<I extends {
+    readonly fixable: boolean;
+}> {
+    /** High sanity ceiling on fix iterations — a seatbelt, not the policy. */
+    readonly maxIterations?: number;
+    /** Wall-clock backstop in ms across the whole loop. */
+    readonly wallClockMs?: number;
+    /** Optional token budget across fix cycles that report backend usage. */
+    readonly tokenBudget?: number;
+    /** Stateful no-progress detector, owned by the caller. Called with the
+     * current round's issues before each fix; returning `true` stops the loop as
+     * `stuck`. Preserved for callers that already own their signature state. */
+    readonly stalled?: (issues: readonly I[]) => boolean;
+    /** Configured issue-list projection into the shared fingerprint primitive. */
+    readonly fingerprint?: IssueFingerprint<I>;
+    /** Injectable clock for deterministic tests. */
+    readonly now?: () => number;
+}
+export type FixLoopAction = FingerprintAction;
+export interface GenericFixLoopSummary<State> {
+    readonly iterations: number;
+    readonly converged: boolean;
+    readonly stop: FixLoopStop;
+    readonly lastEvaluation: State;
+    readonly events: readonly string[];
+    readonly tokenUsage?: TokenUsageSummary;
+}
+export interface GenericFixLoopOptions<State, Action extends FixLoopAction = FixLoopAction> {
+    readonly evaluate: () => Promise<Result<State, RuntimeError>>;
+    readonly converged: (state: State) => boolean;
+    readonly nextAction: (state: State) => Action | undefined;
+    readonly fix: (action: Action, state: State) => Promise<FixLoopFixOutcome>;
+    /** High sanity ceiling on fix iterations — a seatbelt, not the policy. */
+    readonly maxIterations?: number;
+    /** Wall-clock backstop in ms across the whole loop. */
+    readonly wallClockMs?: number;
+    /** Optional token budget across fix cycles that report backend usage. */
+    readonly tokenBudget?: number;
+    /** Additional caller-owned stop predicate. The built-in fingerprint guard is
+     * still the default stuck detector for generic actions. */
+    readonly stalled?: (state: State, action: Action) => boolean;
+    /** Generic actions are fingerprinted by `{identity, inputs}` by default. */
+    readonly fingerprint?: false | Omit<FingerprintDetectorOptions<{
+        readonly state: State;
+        readonly action: Action;
+    }>, "project">;
+    /** Injectable clock for deterministic tests. */
+    readonly now?: () => number;
+}
+/** Generic convergence primitive: iterate `evaluate → action → fix` until the
+ * state converges or one guard fires. The action fingerprint guard hashes
+ * `{identity, inputs}` over a sliding window, so repeated commands and A→B→A
+ * oscillation use the same primitive. */
+export declare function fixLoop<State, Action extends FixLoopAction = FixLoopAction>(options: GenericFixLoopOptions<State, Action>): Promise<Result<GenericFixLoopSummary<State>, RuntimeError>>;
+/** Issue-list overload kept for current review callers. The third argument
+ * accepts a bare iteration count for backward compatibility or a full
+ * {@link FixLoopOptions}. */
+export declare function fixLoop<I extends {
+    readonly fixable: boolean;
+}>(evaluate: () => Promise<Result<readonly I[], RuntimeError>>, fix: (issues: readonly I[]) => Promise<FixLoopFixOutcome>, options?: number | FixLoopOptions<I>): Promise<Result<FixLoopSummary<I>, RuntimeError>>;
+export interface ReviewIssue {
+    readonly reviewer: ReviewerId;
+    readonly message: string;
+    readonly fixable: boolean;
+}
+export interface ReviewTurn {
+    readonly reviewer: ReviewerId;
+    readonly issues: readonly ReviewIssue[];
+}
+export interface ReviewLoopSummary {
+    readonly selected: readonly ReviewerId[];
+    readonly issues: readonly ReviewIssue[];
+    readonly fixed: boolean;
+    readonly events: readonly string[];
+}
+export declare function runReviewersParallel<I extends ReviewIssue>(reviewers: readonly ReviewerPrompt[], review: (reviewer: ReviewerPrompt) => Promise<Result<readonly I[], RuntimeError>>): Promise<Result<readonly I[], RuntimeError>>;
+export interface ReviewAndFixOptions {
+    readonly requested?: readonly ReviewerId[];
+    readonly loadPrompts?: () => Promise<ReviewerPrompt[]>;
+    readonly review: (reviewer: ReviewerPrompt) => Promise<Result<readonly ReviewIssue[], RuntimeError>>;
+    readonly fix: (issues: readonly ReviewIssue[]) => Promise<Result<void, RuntimeError>>;
+    readonly parallel?: boolean;
+}
+/** Review-and-fix `.until()` strategy over loop execution (design D7):
+ * one review pass collects issues, then loop execution drives the fixable-issue count
+ * to zero. A two-phase state runs reviewers exactly once and applies the fix at
+ * most once, reproducing the single-pass review/fix behavior. */
+export declare function reviewAndFixStrategy(options: ReviewAndFixOptions): Promise<Result<ReviewLoopSummary, RuntimeError>>;
+/** Deprecated compatibility wrapper kept for one release (design D7): delegates to
+ * `reviewAndFixStrategy` and emits a runtime DeprecationWarning. Not tagged
+ * `@deprecated` so existing callers still using it for this release stay lint-clean. */
+export declare function runReviewAndFixLoop(options: ReviewAndFixOptions): Promise<Result<ReviewLoopSummary, RuntimeError>>;
+//# sourceMappingURL=loop.d.ts.map

package/dist/review/loop.d.ts.map

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

package/dist/review/reviewers.d.ts

@@ -0,0 +1,13 @@
+export declare const ReviewerIds: readonly ["code-functionality", "test", "readability", "code-structure", "simplicity", "performance", "security", "scala-fp"];
+export type ReviewerId = (typeof ReviewerIds)[number];
+export interface ReviewerPrompt {
+    readonly id: ReviewerId;
+    readonly name?: string;
+    readonly description?: string;
+    readonly files?: string;
+    readonly prompt: string;
+}
+export declare function loadReviewerPrompts(root?: string): Promise<ReviewerPrompt[]>;
+export declare function selectReviewers(prompts: readonly ReviewerPrompt[], requested?: readonly ReviewerId[]): ReviewerPrompt[];
+export declare function parseReviewerPrompt(id: ReviewerId, content: string): ReviewerPrompt;
+//# sourceMappingURL=reviewers.d.ts.map

package/dist/review/reviewers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviewers.d.ts","sourceRoot":"","sources":["../../src/review/reviewers.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,WAAW,+HASd,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,wBAAsB,mBAAmB,CACvC,IAAI,SAAsB,GACzB,OAAO,CAAC,cAAc,EAAE,CAAC,CAO3B;AAED,wBAAgB,eAAe,CAC7B,OAAO,EAAE,SAAS,cAAc,EAAE,EAClC,SAAS,GAAE,SAAS,UAAU,EAAkD,GAC/E,cAAc,EAAE,CASlB;AAED,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,CAoCnF"}

package/dist/review/tool.d.ts

@@ -0,0 +1,20 @@
+import type { Result } from "neverthrow";
+import type { RuntimeError } from "../model/index.ts";
+import { type ReviewAndFixOptions, type ReviewLoopSummary } from "./loop.ts";
+import type { ReviewerId, ReviewerPrompt } from "./reviewers.ts";
+export declare const DefaultReviewers: readonly ["code-functionality", "readability", "test"];
+export interface ReviewTool {
+    readonly reviewers: readonly ReviewerId[];
+    run(options: ReviewToolRunOptions): Promise<Result<ReviewLoopSummary, RuntimeError>>;
+}
+export interface ReviewToolOptions {
+    readonly reviewers?: readonly ReviewerId[];
+}
+export interface ReviewToolRunOptions {
+    readonly requested?: readonly ReviewerId[];
+    readonly loadPrompts?: () => Promise<ReviewerPrompt[]>;
+    readonly review: ReviewAndFixOptions["review"];
+    readonly fix: ReviewAndFixOptions["fix"];
+}
+export declare function createReviewTool(options?: ReviewToolOptions): ReviewTool;
+//# sourceMappingURL=tool.d.ts.map

package/dist/review/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/review/tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACvB,MAAM,WAAW,CAAC;AACnB,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEjE,eAAO,MAAM,gBAAgB,wDAAyD,CAAC;AAEvF,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,SAAS,EAAE,SAAS,UAAU,EAAE,CAAC;IAC1C,GAAG,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,YAAY,CAAC,CAAC,CAAC;CACtF;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IAC3C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IACvD,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAC/C,QAAQ,CAAC,GAAG,EAAE,mBAAmB,CAAC,KAAK,CAAC,CAAC;CAC1C;AAED,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,iBAAsB,GAAG,UAAU,CAa5E"}

package/dist/run-output/index.d.ts

@@ -0,0 +1,112 @@
+import type { Usage } from "../model/index.ts";
+export type RunEvent = RunStartedEvent | RunHeartbeatEvent | RunFinishedEvent | PreflightEvent | StageEvent | AgentActivityEvent | CycleProgressEvent | OutcomeEvent | FailureEvent | ArtifactEvent;
+export interface RunStartedEvent {
+    readonly type: "run_started";
+    readonly runId?: string;
+    readonly label?: string;
+    readonly backend?: string;
+}
+export interface RunHeartbeatEvent {
+    readonly type: "run_heartbeat";
+    readonly label?: string;
+    readonly elapsedMs?: number;
+}
+export interface RunFinishedEvent {
+    readonly type: "run_finished";
+    readonly label?: string;
+    readonly status: "success" | "failed";
+    readonly stopReason?: string;
+    readonly iterations?: number;
+    readonly error?: string;
+}
+export interface PreflightEvent {
+    readonly type: "preflight";
+    readonly name: string;
+    readonly status: "started" | "passed" | "failed" | "skipped";
+    readonly reason?: string;
+}
+export interface StageEvent {
+    readonly type: "stage";
+    readonly name: string;
+    readonly status: "started" | "running" | "completed" | "failed";
+    readonly durationMs?: number;
+    readonly message?: string;
+}
+export interface AgentActivityEvent {
+    readonly type: "agent_activity";
+    readonly activity: "started" | "tool_use" | "tool_result" | "assistant_summary" | "usage";
+    readonly backend?: string;
+    readonly name?: string;
+    readonly summary?: string;
+    readonly usage?: Usage;
+}
+export interface CycleBranchEvent {
+    readonly id: string;
+    readonly status: string;
+    readonly usage?: Usage | "unknown";
+}
+export interface CycleContextPressureEvent {
+    readonly offloadCount: number;
+    readonly compactionStages: readonly string[];
+    readonly tokensBefore: number;
+    readonly tokensAfter: number;
+    readonly observationCount: number;
+}
+export interface CycleProgressEvent {
+    readonly type: "cycle_progress";
+    readonly iteration: number;
+    readonly measure?: number;
+    readonly delta?: number;
+    readonly stopStatus?: string;
+    readonly usage?: Usage | "unknown";
+    readonly branches?: readonly CycleBranchEvent[];
+    readonly contextPressure?: CycleContextPressureEvent;
+}
+export interface OutcomeEvent {
+    readonly type: "outcome";
+    readonly file: string;
+    readonly verdict: string;
+    readonly durationMs?: number;
+    readonly reason?: string;
+}
+export interface FailureEvent {
+    readonly type: "failure";
+    readonly file: string;
+    readonly category?: string;
+    readonly durationMs?: number;
+    readonly message: string;
+}
+export interface ArtifactEvent {
+    readonly type: "artifact";
+    readonly artifact: string;
+    readonly path: string;
+    readonly label?: string;
+}
+export interface RunEventSink {
+    handle(event: RunEvent): void | Promise<void>;
+}
+export interface RunReporter {
+    emit(event: RunEvent): void;
+    events(): readonly RunEvent[];
+    flush(): Promise<void>;
+}
+export interface RunReporterOptions {
+    readonly sinks?: readonly RunEventSink[];
+}
+export interface RunNarrator {
+    summarize(events: readonly RunEvent[]): string | Promise<string>;
+}
+export interface RunPresenterOptions {
+    readonly env?: Record<string, string | undefined>;
+    readonly isTTY?: boolean;
+    readonly narration?: "disabled" | "enabled";
+    readonly narrator?: RunNarrator;
+    readonly writeDiagnostic?: (text: string) => void;
+    readonly writeOutput?: (text: string) => void;
+}
+export declare function activeRunReporter(): RunReporter | undefined;
+export declare function withRunReporter<T>(reporter: RunReporter | undefined, fn: () => Promise<T> | T): Promise<T>;
+export declare function createRunReporter(options?: RunReporterOptions): RunReporter;
+export declare function createRunPresenter(options?: RunPresenterOptions): RunEventSink;
+export declare function formatRunEvent(event: RunEvent, options?: Pick<RunPresenterOptions, "env" | "isTTY">): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/run-output/index.d.ts.map

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

package/dist/runner/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./typecheck.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/runner/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runner/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC"}

package/dist/runner/typecheck.d.ts

@@ -0,0 +1,23 @@
+import { type Result } from "neverthrow";
+import type { RuntimeError } from "../model/index.ts";
+import { type QuietProcResult } from "../tools/process.ts";
+export interface CommandRunner {
+    (command: string, args: readonly string[], options: {
+        cwd: string;
+    }): Promise<Result<QuietProcResult, RuntimeError>>;
+}
+export interface TypecheckOptions {
+    readonly cwd: string;
+    readonly project?: string;
+    readonly skip?: boolean;
+    readonly runner?: CommandRunner;
+    readonly which?: (cwd: string) => string | null;
+}
+export interface TypecheckResult {
+    readonly skipped: boolean;
+    readonly stdout: string;
+    readonly stderr: string;
+    readonly reason?: "flag" | "tsc-not-found";
+}
+export declare function runTypecheck(options: TypecheckOptions): Promise<Result<TypecheckResult, RuntimeError>>;
+//# sourceMappingURL=typecheck.d.ts.map

package/dist/runner/typecheck.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typecheck.d.ts","sourceRoot":"","sources":["../../src/runner/typecheck.ts"],"names":[],"mappings":"AAEA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAY,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAErE,MAAM,WAAW,aAAa;IAC5B,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC,CAAC;CACtH;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;CACjD;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC;CAC5C;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC,CA+BhD"}

package/dist/test-utils/fakes.d.ts

@@ -0,0 +1,76 @@
+import type { ConversationEvent, LlmResult } from "../model/index.ts";
+import { type Result } from "neverthrow";
+import type { RuntimeError } from "../model/index.ts";
+import type { LlmBackend, LlmTool } from "../backends/types.ts";
+import type { Sink, Source } from "../loop/io/index.ts";
+import type { LinearAgentActivityInput, LinearAgentSessionUpdateInput, LinearIssueUpdateInput, LinearTool } from "../tools/index.ts";
+export interface FakeSubprocess {
+    readonly lines: readonly string[];
+    readonly stderr?: string;
+    readonly exitCode?: number;
+}
+export interface FakeHttpSseTransport {
+    readonly events: readonly string[];
+}
+export interface FakeRpcTransport<Request = unknown, Response = unknown> {
+    readonly requests: Request[];
+    readonly responses: Response[];
+}
+export interface FakeAgentRun {
+    readonly events: readonly ConversationEvent[];
+    readonly result: LlmResult;
+    readonly diff?: string;
+}
+export interface ScriptedFakeAgentStep {
+    readonly events?: readonly ConversationEvent[];
+    readonly output?: string;
+    readonly diff?: string;
+    readonly failure?: RuntimeError;
+}
+export interface ScriptedFakeAgent {
+    run(prompt: string): Promise<Result<FakeAgentRun, RuntimeError>>;
+    readonly prompts: readonly string[];
+}
+export declare function scriptedSubprocess(lines: readonly string[]): FakeSubprocess;
+export declare function scriptedSse(events: readonly string[]): FakeHttpSseTransport;
+export declare function scriptedRpc<Request, Response>(responses: readonly Response[]): FakeRpcTransport<Request, Response>;
+export declare function fakeAgentRun(events: readonly ConversationEvent[], result: LlmResult): FakeAgentRun;
+export interface FakeLlmBackend extends LlmBackend<"codex"> {
+    readonly calls: readonly string[];
+}
+export declare function fakeBackend(outputs: readonly string[]): FakeLlmBackend;
+export interface EventRecorder<E = ConversationEvent> {
+    readonly push: (event: E) => void;
+    readonly events: () => readonly E[];
+}
+export declare function eventRecorder<E = ConversationEvent>(): EventRecorder<E>;
+export declare function createFakeLlmTool(fake: FakeLlmBackend): LlmTool;
+export declare function scriptedFakeAgent(steps: readonly ScriptedFakeAgentStep[]): ScriptedFakeAgent;
+export interface FakeSource<E> extends Source<E> {
+    readonly kind: "manual";
+    /** Push a trigger event to the started handler. No-op until started / after stop. */
+    fire(event: E): void;
+    /** Whether a handler is currently subscribed. */
+    isStarted(): boolean;
+}
+export declare function fakeSource<E = void>(): FakeSource<E>;
+export interface FakeSink<A> extends Sink<A> {
+    readonly kind: "stdout";
+    /** Outputs captured by each successful emit, in order. */
+    emitted(): readonly A[];
+}
+/** A capturing Sink. With `failWith`, every emit returns `err(RuntimeError)` and captures nothing. */
+export declare function fakeSink<A = unknown>(options?: {
+    failWith?: RuntimeError;
+}): FakeSink<A>;
+export interface FakeLinearTool extends LinearTool {
+    readonly issueComments: readonly {
+        readonly issueId: string;
+        readonly body: string;
+    }[];
+    readonly issueUpdates: readonly LinearIssueUpdateInput[];
+    readonly agentActivities: readonly LinearAgentActivityInput[];
+    readonly agentSessionUpdates: readonly LinearAgentSessionUpdateInput[];
+}
+export declare function createFakeLinearTool(): FakeLinearTool;
+//# sourceMappingURL=fakes.d.ts.map

package/dist/test-utils/fakes.d.ts.map

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

package/dist/test-utils/fixtures.d.ts

@@ -0,0 +1,4 @@
+export declare function readJsonFixture<T = unknown>(path: string): Promise<T>;
+export declare function assertExactJson(actual: unknown, expected: unknown): void;
+export declare function stableJson(value: unknown): string;
+//# sourceMappingURL=fixtures.d.ts.map

package/dist/test-utils/fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../../src/test-utils/fixtures.ts"],"names":[],"mappings":"AAIA,wBAAsB,eAAe,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAE3E;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI,CAExE;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEjD"}

package/dist/test-utils/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./fakes.ts";
+export * from "./fixtures.ts";
+export * from "./tier2.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/test-utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/test-utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC"}

package/dist/test-utils/tier2.d.ts

@@ -0,0 +1,8 @@
+export interface Tier2Golden {
+    readonly commits: readonly string[];
+    readonly planFiles: Readonly<Record<string, string>>;
+    readonly terminal: readonly string[];
+    readonly events: readonly unknown[];
+}
+export declare function assertTier2Golden(actual: Tier2Golden, expected: Tier2Golden): void;
+//# sourceMappingURL=tier2.d.ts.map

package/dist/test-utils/tier2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tier2.d.ts","sourceRoot":"","sources":["../../src/test-utils/tier2.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACrD,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,CAAC;CACrC;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,GAAG,IAAI,CAElF"}

package/dist/tools/fs.d.ts

@@ -0,0 +1,11 @@
+import { type Result } from "neverthrow";
+import type { RuntimeError } from "../model/index.ts";
+export interface FsTool {
+    readText(path: string): Promise<Result<string, RuntimeError>>;
+    writeText(path: string, content: string, options?: {
+        readonly mode?: number;
+    }): Promise<Result<void, RuntimeError>>;
+    exists(path: string): Promise<boolean>;
+}
+export declare function createFsTool(): FsTool;
+//# sourceMappingURL=fs.d.ts.map

package/dist/tools/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/tools/fs.ts"],"names":[],"mappings":"AAEA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;IAC9D,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC;IACpH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACxC;AAED,wBAAgB,YAAY,IAAI,MAAM,CAgCrC"}

package/dist/tools/git.d.ts

@@ -0,0 +1,10 @@
+import { type Result } from "neverthrow";
+import type { RuntimeError } from "../model/index.ts";
+import { type QuietProcResult } from "./process.ts";
+export interface GitTool {
+    status(): Promise<Result<string, RuntimeError>>;
+    add(paths: readonly string[]): Promise<Result<void, RuntimeError>>;
+    commit(message: string): Promise<Result<QuietProcResult, RuntimeError>>;
+}
+export declare function createGitTool(cwd: string): GitTool;
+//# sourceMappingURL=git.d.ts.map

package/dist/tools/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/tools/git.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAY,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAE9D,MAAM,WAAW,OAAO;IACtB,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;IAChD,GAAG,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC;IACnE,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC,CAAC;CACzE;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAuBlD"}

package/dist/tools/github.d.ts

@@ -0,0 +1,13 @@
+import type { Result } from "neverthrow";
+import type { RuntimeError } from "../model/index.ts";
+import { type QuietProcResult } from "./process.ts";
+export interface PullRequestInput {
+    readonly title: string;
+    readonly bodyFile: string;
+    readonly base?: string;
+}
+export interface GitHubTool {
+    createPullRequest(input: PullRequestInput): Promise<Result<QuietProcResult, RuntimeError>>;
+}
+export declare function createGitHubTool(cwd: string): GitHubTool;
+//# sourceMappingURL=github.d.ts.map

package/dist/tools/github.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../../src/tools/github.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAY,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAE9D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC,CAAC;CAC5F;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAUxD"}

package/dist/tools/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./fs.ts";
+export * from "./git.ts";
+export * from "./github.ts";
+export * from "./linear.ts";
+export * from "./process.ts";
+export * from "./terminal.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC"}

package/dist/tools/linear.d.ts

@@ -0,0 +1,117 @@
+import { type Result } from "neverthrow";
+import { type RuntimeError } from "../model/index.ts";
+export type LinearAuth = {
+    readonly kind: "apiKey";
+    readonly token: string;
+} | {
+    readonly kind: "oauth";
+    readonly token: string;
+};
+export interface LinearGraphQLRequest {
+    readonly endpoint: string;
+    readonly query: string;
+    readonly variables?: Record<string, unknown>;
+    readonly headers: Record<string, string>;
+    readonly operationName?: string;
+}
+export interface LinearGraphQLError {
+    readonly message: string;
+    readonly path?: readonly (string | number)[];
+    readonly extensions?: Record<string, unknown>;
+}
+export interface LinearGraphQLResponse<TData = unknown> {
+    readonly data?: TData | null;
+    readonly errors?: readonly LinearGraphQLError[];
+}
+export type LinearGraphQLTransport = <TData = unknown>(request: LinearGraphQLRequest) => Promise<Result<LinearGraphQLResponse<TData>, RuntimeError>>;
+export interface LinearTeamRef {
+    readonly id: string;
+    readonly key?: string | null;
+    readonly name?: string | null;
+}
+export interface LinearProjectRef {
+    readonly id: string;
+    readonly name?: string | null;
+}
+export interface LinearWorkflowState {
+    readonly id: string;
+    readonly name: string;
+    readonly type?: string | null;
+}
+export interface LinearIssue {
+    readonly id: string;
+    readonly identifier?: string | null;
+    readonly title?: string | null;
+    readonly description?: string | null;
+    readonly url?: string | null;
+    readonly team?: LinearTeamRef | null;
+    readonly project?: LinearProjectRef | null;
+    readonly state?: LinearWorkflowState | null;
+}
+export interface LinearIssueUpdateInput {
+    readonly issueId: string;
+    readonly title?: string;
+    readonly description?: string;
+    readonly stateId?: string;
+    readonly assigneeId?: string | null;
+    readonly projectId?: string | null;
+    readonly priority?: number | null;
+    readonly labelIds?: readonly string[];
+}
+export interface LinearIssueComment {
+    readonly id: string;
+    readonly body?: string | null;
+    readonly url?: string | null;
+}
+export interface LinearAgentActivity {
+    readonly id: string;
+    readonly type?: string | null;
+    readonly body?: string | null;
+}
+export interface LinearExternalUrl {
+    readonly label?: string;
+    readonly url: string;
+}
+export interface LinearAgentSession {
+    readonly id: string;
+    readonly plan?: string | null;
+    readonly externalUrl?: string | null;
+    readonly externalUrls?: readonly LinearExternalUrl[];
+}
+export interface LinearAgentActivityInput {
+    readonly agentSessionId: string;
+    readonly type?: "action" | "response" | "error";
+    readonly body: string;
+    readonly metadata?: Record<string, unknown>;
+}
+export interface LinearAgentSessionUpdateInput {
+    readonly agentSessionId: string;
+    readonly plan?: string;
+    readonly externalUrl?: string;
+    readonly externalUrls?: readonly LinearExternalUrl[];
+}
+export interface LinearTool {
+    fetchIssue(input: {
+        readonly issueId: string;
+    }): Promise<Result<LinearIssue | null, RuntimeError>>;
+    updateIssue(input: LinearIssueUpdateInput): Promise<Result<LinearIssue, RuntimeError>>;
+    createIssueComment(input: {
+        readonly issueId: string;
+        readonly body: string;
+    }): Promise<Result<LinearIssueComment, RuntimeError>>;
+    createAgentActivity(input: LinearAgentActivityInput): Promise<Result<LinearAgentActivity, RuntimeError>>;
+    updateAgentSession(input: LinearAgentSessionUpdateInput): Promise<Result<LinearAgentSession, RuntimeError>>;
+    getTeamWorkflowStates(input: {
+        readonly teamId: string;
+    }): Promise<Result<readonly LinearWorkflowState[], RuntimeError>>;
+}
+export interface LinearToolOptions {
+    readonly auth?: LinearAuth;
+    readonly endpoint?: string;
+    readonly transport?: LinearGraphQLTransport;
+    readonly env?: Record<string, string | undefined>;
+}
+export declare function linearAuthFromEnv(env?: Record<string, string | undefined>): LinearAuth | undefined;
+export declare function createFetchLinearGraphQLTransport(fetchImpl?: typeof fetch): LinearGraphQLTransport;
+export declare function createLinearTool(options?: LinearToolOptions): LinearTool;
+//# sourceMappingURL=linear.d.ts.map