@twelvehart/orcats 0.0.0-seed.0 → 0.2.2

package/dist/loop/execution.d.ts

@@ -0,0 +1,68 @@
+import { type Result } from "neverthrow";
+import type { BranchObservation } from "../monitor/index.ts";
+import type { RuntimeError, Usage } from "../model/index.ts";
+import { type CompactionConfig, type CompactionStage, type Observation, type OffloadStore } from "./context/index.ts";
+import { type FingerprintAction, type FingerprintDetectorOptions, type TokenUsageSummary } from "./termination.ts";
+export type LoopExecutionStop = "converged" | "unfixable" | "stuck" | "timeout" | "ceiling" | "budget-exhausted" | "cancelled";
+export type LoopExecutionAction = FingerprintAction;
+export interface LoopContextPressure {
+    readonly offloadCount: number;
+    readonly compactionStages: readonly CompactionStage[];
+    readonly tokensBefore: number;
+    readonly tokensAfter: number;
+    readonly observationCount: number;
+}
+export interface LoopExecutionStepResult {
+    readonly usage?: Usage;
+    readonly observations?: readonly Observation[];
+    readonly branches?: readonly BranchObservation[];
+    readonly measure?: number;
+    readonly stopReason?: LoopExecutionStop;
+    readonly contextPressure?: LoopContextPressure;
+}
+export interface LoopExecutionProgress {
+    readonly iteration: number;
+    readonly usage?: Usage;
+    readonly branches?: readonly BranchObservation[];
+    readonly measure?: number;
+    readonly stopReason?: LoopExecutionStop;
+    readonly contextPressure?: LoopContextPressure;
+}
+export interface LoopExecutionContextOptions {
+    readonly root?: string;
+    readonly config?: CompactionConfig;
+    readonly offloadStore?: OffloadStore;
+    readonly observations?: readonly Observation[];
+}
+export interface LoopExecutionContextSnapshot {
+    readonly observations: readonly Observation[];
+    readonly lastPressure?: LoopContextPressure;
+}
+export interface LoopExecutionSummary<State> {
+    readonly iterations: number;
+    readonly converged: boolean;
+    readonly stop: LoopExecutionStop;
+    readonly lastEvaluation: State;
+    readonly events: readonly string[];
+    readonly tokenUsage?: TokenUsageSummary;
+    readonly context: LoopExecutionContextSnapshot;
+}
+export interface LoopExecutionOptions<State, Action extends LoopExecutionAction = LoopExecutionAction> {
+    readonly evaluate: () => Promise<Result<State, RuntimeError>>;
+    readonly converged: (state: State) => boolean;
+    readonly nextAction: (state: State) => Action | undefined;
+    readonly execute: (action: Action, state: State, iteration: number) => Promise<Result<unknown, RuntimeError>>;
+    readonly maxIterations?: number;
+    readonly wallClockMs?: number;
+    readonly tokenBudget?: number;
+    readonly stalled?: (state: State, action: Action) => boolean;
+    readonly fingerprint?: false | Omit<FingerprintDetectorOptions<{
+        readonly state: State;
+        readonly action: Action;
+    }>, "project">;
+    readonly now?: () => number;
+    readonly context?: LoopExecutionContextOptions;
+    readonly onCycle?: (progress: LoopExecutionProgress) => void;
+}
+export declare function executeLoop<State, Action extends LoopExecutionAction = LoopExecutionAction>(options: LoopExecutionOptions<State, Action>): Promise<Result<LoopExecutionSummary<State>, RuntimeError>>;
+//# sourceMappingURL=execution.d.ts.map

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

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

package/dist/loop/fanout.d.ts

@@ -0,0 +1,148 @@
+import { type Result } from "neverthrow";
+import type { JoinPolicy } from "./builder/types.ts";
+import type { RuntimeError, Usage } from "../model/index.ts";
+import type { BranchWritableStateStore, StateHash, StateReducer, StateStore } from "./state/index.ts";
+/**
+ * What an isolated branch returns: a bounded prose summary (NEVER the raw branch state, task 6.3)
+ * plus an optional small structured payload the reducer folds. `fanOut` truncates `summary` to the
+ * configured char budget so one runaway branch cannot blow the parent loop's context window.
+ */
+export interface BranchSummary<D = unknown> {
+    readonly summary: string;
+    readonly data?: D;
+}
+/** A branch: pure work over an ISOLATED copy of the input state, returning a condensed summary. */
+export type Branch<S, D> = (isolated: S) => Promise<BranchSummary<D>> | BranchSummary<D>;
+/** A branch that threw/rejected; the message is preserved for the partial-failure report. */
+export interface BranchFailure {
+    readonly message: string;
+}
+/**
+ * Per-branch outcome captured by `fanOut`. Failure is DATA, not a thrown error, so `fanIn`'s
+ * partial-failure policy can weigh it; `elapsedMs` lets the `race` policy pick the fastest success.
+ */
+export type BranchOutcome<D = unknown> = {
+    readonly index: number;
+    readonly ok: true;
+    readonly summary: BranchSummary<D>;
+    readonly elapsedMs: number;
+} | {
+    readonly index: number;
+    readonly ok: false;
+    readonly error: BranchFailure;
+    readonly elapsedMs: number;
+};
+export interface FanOutSpec<S, D> {
+    /** Shared input state; each branch receives an isolated `structuredClone`, never the original. */
+    readonly state: S;
+    readonly branches: readonly Branch<S, D>[];
+    /** Concurrency cap (design D2/D8: in-process, ~3–10): at most this many branches run at once. */
+    readonly maxConcurrency: number;
+    /** Per-branch summary char budget; defaults to ~1.5k tokens. */
+    readonly summaryBudgetChars?: number;
+    /** Aborting interrupts in-flight branches and fails the fan-out with `cancelled`. */
+    readonly signal?: AbortSignal;
+}
+/**
+ * `fanOut` fails as a whole only on misconfiguration or hard interruption — never on a branch
+ * failure, which is captured per-branch for `fanIn`'s partial-failure policy to decide.
+ */
+export type FanOutError = {
+    readonly kind: "misconfigured";
+    readonly reason: string;
+} | {
+    readonly kind: "cancelled";
+    readonly reason: string;
+};
+/** The merge reducer — the ONLY point where branch results recombine into one state. */
+export type FanInReducer<S, D> = (summaries: readonly BranchSummary<D>[]) => S;
+/** What to do when some branches failed. */
+export type PartialFailurePolicy = {
+    readonly kind: "fail-fast";
+} | {
+    readonly kind: "tolerate";
+    readonly minSuccess: number;
+};
+export interface FanInOptions<S, D> {
+    readonly reducer: FanInReducer<S, D>;
+    /** Defaults per policy: `barrier` ⇒ fail-fast; `quorum` ⇒ tolerate(quorum); `race`/`reduce` ⇒ tolerate(1). */
+    readonly onPartialFailure?: PartialFailurePolicy;
+    /** Required for `quorum`: proceed once this many branches AGREE. */
+    readonly quorum?: number;
+    /** Agreement key for `quorum`; defaults to the branch's `data`, falling back to its `summary`. */
+    readonly agreeBy?: (summary: BranchSummary<D>) => unknown;
+}
+export type FanInError = {
+    readonly kind: "partial-failure";
+    readonly succeeded: number;
+    readonly failed: number;
+    readonly failures: readonly BranchFailure[];
+} | {
+    readonly kind: "no-success";
+    readonly failures: readonly BranchFailure[];
+} | {
+    readonly kind: "no-quorum";
+    readonly required: number;
+    readonly largestAgreement: number;
+} | {
+    readonly kind: "misconfigured";
+    readonly reason: string;
+};
+export interface StoreBackedBranchContext {
+    readonly index: number;
+    readonly branchHash: StateHash;
+}
+export interface StoreBackedBranchResult<S, D = unknown> {
+    readonly state: S;
+    readonly summary?: BranchSummary<D>;
+    readonly usage?: Usage;
+}
+export type StoreBackedBranch<S, D = unknown> = (state: S, context: StoreBackedBranchContext) => Promise<StoreBackedBranchResult<S, D>> | StoreBackedBranchResult<S, D>;
+export interface StoreBackedFanOutSpec<S, D = unknown> {
+    readonly store: BranchWritableStateStore<S>;
+    readonly from: StateHash;
+    readonly branches: readonly StoreBackedBranch<S, D>[];
+    readonly maxConcurrency: number;
+    readonly summaryBudgetChars?: number;
+    readonly signal?: AbortSignal;
+}
+export type StoreBackedBranchOutcome<D = unknown> = {
+    readonly index: number;
+    readonly ok: true;
+    readonly branchHash: StateHash;
+    readonly stateHash: StateHash;
+    readonly summary: BranchSummary<D>;
+    readonly elapsedMs: number;
+    readonly usage?: Usage;
+} | {
+    readonly index: number;
+    readonly ok: false;
+    readonly branchHash?: StateHash;
+    readonly error: BranchFailure;
+    readonly elapsedMs: number;
+    readonly usage?: Usage;
+};
+export interface StoreBackedFanInOptions<S, D = unknown> {
+    readonly store: StateStore<S>;
+    readonly reducer: StateReducer<S>;
+    readonly onPartialFailure?: PartialFailurePolicy;
+    readonly quorum?: number;
+    readonly agreeBy?: (summary: BranchSummary<D>) => unknown;
+}
+/**
+ * Bounded fan-out (tasks 6.1, 6.3). Runs each branch over an isolated `structuredClone` of `state`
+ * (copy-on-fanout: no shared-mutable across branches) with at most `maxConcurrency` running at
+ * once, and returns every branch's outcome — successes carry a condensed summary, failures carry a
+ * message — for `fanIn` to combine. The whole fan-out errs only on misconfiguration or abort.
+ */
+export declare function fanOut<S, D = unknown>(spec: FanOutSpec<S, D>): Promise<Result<readonly BranchOutcome<D>[], FanOutError>>;
+export declare function storeBackedFanOut<S, D = unknown>(spec: StoreBackedFanOutSpec<S, D>): Promise<Result<readonly StoreBackedBranchOutcome<D>[], FanOutError>>;
+export declare function storeBackedFanIn<S, D = unknown>(policy: JoinPolicy, outcomes: readonly StoreBackedBranchOutcome<D>[], options: StoreBackedFanInOptions<S, D>): Promise<Result<S, FanInError | RuntimeError>>;
+/**
+ * Join-policy fan-in (tasks 6.2, 6.4). Applies the partial-failure gate, then the join policy
+ * selects which successful summaries count, then the reducer — the ONLY merge point — folds them
+ * into one state. `barrier`/`reduce` fold every success; `race` folds the fastest; `quorum` folds
+ * the first group of `quorum` branches to agree.
+ */
+export declare function fanIn<S, D = unknown>(policy: JoinPolicy, outcomes: readonly BranchOutcome<D>[], options: FanInOptions<S, D>): Result<S, FanInError>;
+//# sourceMappingURL=fanout.d.ts.map

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

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

package/dist/loop/firing.d.ts

@@ -0,0 +1,54 @@
+import type { Result } from "neverthrow";
+import type { LoopOutcome, LoopRunError, LoopStopReason } from "./builder/index.ts";
+import type { LoopDefinition } from "./serve.ts";
+import { type RunReporter } from "../run-output/index.ts";
+export declare const LOOP_EVENT_ENV = "ORCA_LOOP_EVENT";
+/** What the supervisor hands the spawner for one trigger firing. */
+export interface ChildSpec {
+    /** The loop module path or registered name the child `orcats run` resolves. */
+    readonly loop: string;
+    /** The trigger event, serialized to the child by the default spawner. */
+    readonly event: unknown;
+}
+/** A spawned ephemeral child running one loop firing; independently terminable. */
+export interface ChildHandle {
+    /** OS-level termination of a runaway child (default `SIGKILL`). */
+    kill(signal?: NodeJS.Signals): void;
+    /** Resolves when the child exits with its code (null when terminated by signal). */
+    readonly exited: Promise<number | null>;
+}
+/** Spawns one ephemeral child per trigger firing. Injectable so tests avoid real processes. */
+export type ChildSpawner = (spec: ChildSpec) => ChildHandle;
+export interface ChildProcessSpec {
+    readonly command: string;
+    readonly args: readonly string[];
+    readonly env: NodeJS.ProcessEnv;
+}
+export interface ChildProcessSpecOptions {
+    readonly argv?: readonly string[];
+    readonly env?: NodeJS.ProcessEnv;
+    readonly execPath?: string;
+}
+export interface LoopFiringResult {
+    readonly result: Result<LoopOutcome, LoopRunError>;
+    readonly exitCode: number;
+    readonly diagnostic: string;
+}
+export interface LoopFiringOptions {
+    readonly writeDiagnostic?: (message: string) => void;
+    readonly reporter?: RunReporter;
+}
+export declare function createLoopChildSpec(loop: string, event: unknown): ChildSpec;
+export declare function encodeLoopEvent(event: unknown): string | undefined;
+export declare function decodeLoopEvent(env?: NodeJS.ProcessEnv): unknown;
+export declare function buildChildProcessSpec(spec: ChildSpec, options?: ChildProcessSpecOptions): ChildProcessSpec;
+/** Default spawner: re-invoke this CLI as `orcats run --no-typecheck <loop>` in a fresh OS process. */
+export declare const spawnLoopChild: ChildSpawner;
+/** Process exit status for a stop reason: `converged` is 0, every other stop is non-zero. */
+export declare function exitCodeForStop(reason: LoopStopReason): number;
+/** Exit status for a completed run: the stop reason's code, or 70 for a build/runtime error. */
+export declare function exitCodeForRun(result: Result<LoopOutcome, LoopRunError>): number;
+export declare function runLoopFiring(definition: LoopDefinition, event: unknown, options?: LoopFiringOptions): Promise<LoopFiringResult>;
+export declare function formatLoopFiringDiagnostic(name: string, result: Result<LoopOutcome, LoopRunError>): string;
+export declare function describeLoopRunError(error: LoopRunError): string;
+//# sourceMappingURL=firing.d.ts.map

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

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

package/dist/loop/graph/analyze.d.ts

@@ -0,0 +1,8 @@
+import type { CycleReport, GraphInput } from "./types.ts";
+/**
+ * One-pass 3-color DFS. Declared back-edges are recorded first-class with the cycle they
+ * close (`to → … → from` over the forward DAG); accidental cycles are discovered by the DFS
+ * and named from the grey stack.
+ */
+export declare function analyzeGraph(input: GraphInput): CycleReport;
+//# sourceMappingURL=analyze.d.ts.map

package/dist/loop/graph/analyze.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.d.ts","sourceRoot":"","sources":["../../../src/loop/graph/analyze.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAY,WAAW,EAAQ,UAAU,EAAU,MAAM,YAAY,CAAC;AAiDlF;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW,CA+D3D"}

package/dist/loop/graph/index.d.ts

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

package/dist/loop/graph/index.d.ts.map

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

package/dist/loop/graph/types.d.ts

@@ -0,0 +1,35 @@
+export type NodeId = string;
+export interface Edge {
+    readonly from: NodeId;
+    readonly to: NodeId;
+}
+/**
+ * A back-edge closes a cycle. `declared` distinguishes intentional loop back-edges —
+ * first-class domain data the builder hands us (design D6) — from accidental cycles the
+ * DFS discovers in the forward subgraph. `cycle` is the node path naming the loop, used
+ * to name the offending cycle in build/lint errors. For a declared back-edge it runs
+ * `to → … → from` (the forward path the back-edge closes); for an accidental one it is
+ * the grey DFS-stack slice `to → … → from`.
+ */
+export interface BackEdge extends Edge {
+    readonly declared: boolean;
+    readonly cycle: readonly NodeId[];
+}
+/** Input to {@link analyzeGraph}: the node set, all edges, and which edges are declared loop back-edges. */
+export interface GraphInput {
+    readonly nodes: readonly NodeId[];
+    readonly edges: readonly Edge[];
+    /** Edges the builder declares as intentional loop back-edges; trusted, not rediscovered. */
+    readonly declaredBackEdges: readonly Edge[];
+}
+/**
+ * One-pass 3-color DFS output. `traversal` is the preorder visit sequence; `topoOrder` is a
+ * valid topological order of the forward DAG (reverse postorder, back-edges removed);
+ * `backEdges` holds both declared loop back-edges and discovered accidental cycles.
+ */
+export interface CycleReport {
+    readonly traversal: readonly NodeId[];
+    readonly topoOrder: readonly NodeId[];
+    readonly backEdges: readonly BackEdge[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/loop/graph/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/loop/graph/types.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC;AAE5B,MAAM,WAAW,IAAI;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,QAAS,SAAQ,IAAI;IACpC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,4GAA4G;AAC5G,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,CAAC;IAChC,4FAA4F;IAC5F,QAAQ,CAAC,iBAAiB,EAAE,SAAS,IAAI,EAAE,CAAC;CAC7C;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,SAAS,QAAQ,EAAE,CAAC;CACzC"}

package/dist/loop/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./builder/index.ts";
+export type { LoopContextPressure, LoopExecutionContextOptions } from "./execution.ts";
+export * from "./state/index.ts";
+export * from "./io/index.ts";
+export * from "./context/index.ts";
+export * from "./serve.ts";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/loop/index.ts"],"names":[],"mappings":"AAGA,cAAc,oBAAoB,CAAC;AACnC,YAAY,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AACvF,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AAGnC,cAAc,YAAY,CAAC"}

package/dist/loop/io/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./linear.ts";
+export * from "./source.ts";
+export * from "./sink.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/loop/io/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/loop/io/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC"}

package/dist/loop/io/linear.d.ts

@@ -0,0 +1,142 @@
+import { type Result } from "neverthrow";
+import { type RuntimeError } from "../../model/index.ts";
+import { type LinearExternalUrl, type LinearIssueUpdateInput, type LinearTool } from "../../tools/index.ts";
+import type { Sink } from "./sink.ts";
+import type { Source } from "./source.ts";
+export interface LinearWebhookHeaders {
+    readonly [name: string]: string | readonly string[] | undefined;
+}
+export interface LinearWebhookRequest {
+    readonly method: string;
+    readonly url: string;
+    readonly rawBody: string;
+    readonly headers: LinearWebhookHeaders;
+    readonly payload: unknown;
+}
+export interface LinearWebhookDelivery {
+    readonly accepted: boolean;
+    readonly status: number;
+    readonly error?: RuntimeError;
+}
+export type LinearWebhookRequestHandler = (request: LinearWebhookRequest) => Promise<LinearWebhookDelivery>;
+export interface LinearWebhookListener {
+    close(): Promise<void>;
+}
+export type LinearWebhookListenerFactory = (onRequest: LinearWebhookRequestHandler) => Promise<Result<LinearWebhookListener, RuntimeError>>;
+export interface LinearWebhookListenerOptions {
+    readonly port: number;
+    readonly path?: string;
+}
+export interface LinearWebhookVerificationOptions {
+    readonly request: LinearWebhookRequest;
+    readonly secret: string;
+    readonly now?: () => number;
+    readonly replayToleranceMs?: number;
+}
+export declare function linearWebhookSignature(secret: string, rawBody: string, timestamp: string): string;
+export declare function verifyLinearWebhookRequest(options: LinearWebhookVerificationOptions): Result<void, RuntimeError>;
+export declare function createLinearWebhookListenerFactory(options: LinearWebhookListenerOptions): LinearWebhookListenerFactory;
+export interface LinearActor {
+    readonly id?: string;
+    readonly name?: string;
+    readonly email?: string;
+    readonly type?: string;
+    readonly isApp?: boolean;
+}
+export interface LinearIssueTriggerEvent {
+    readonly kind: "linear.issue";
+    readonly webhookType: "Issue" | "Comment";
+    readonly action: string;
+    readonly issueId: string;
+    readonly issueIdentifier?: string;
+    readonly issueUrl?: string;
+    readonly teamId?: string;
+    readonly projectId?: string;
+    readonly workflowStateId?: string;
+    readonly labelIds: readonly string[];
+    readonly actor?: LinearActor;
+    readonly dedupeKey: string;
+    readonly raw: unknown;
+}
+export interface LinearAgentIssueContext {
+    readonly id?: string;
+    readonly identifier?: string;
+    readonly url?: string;
+    readonly title?: string;
+}
+export interface LinearAgentPromptContext {
+    readonly id?: string;
+    readonly body?: string;
+    readonly actor?: LinearActor;
+}
+export interface LinearAgentActivityContext {
+    readonly id?: string;
+    readonly type?: string;
+    readonly body?: string;
+}
+export type LinearAgentEventType = "session_created" | "session_prompted" | "activity" | "stop";
+export interface LinearAgentTriggerEvent {
+    readonly kind: "linear.agent";
+    readonly eventType: LinearAgentEventType;
+    readonly action: string;
+    readonly agentSessionId: string;
+    readonly issue?: LinearAgentIssueContext;
+    readonly prompt?: LinearAgentPromptContext;
+    readonly activity?: LinearAgentActivityContext;
+    readonly isStopSignal: boolean;
+    readonly dedupeKey: string;
+    readonly raw: unknown;
+}
+export interface LinearSourceBaseOptions {
+    readonly webhookSecret: string;
+    readonly port?: number;
+    readonly path?: string;
+    readonly listenerFactory?: LinearWebhookListenerFactory;
+    readonly replayToleranceMs?: number;
+    readonly now?: () => number;
+    readonly seenDedupeKeys?: Set<string>;
+}
+export interface LinearIssueSourceOptions extends LinearSourceBaseOptions {
+    readonly teamId?: string;
+    readonly teamIds?: readonly string[];
+    readonly projectId?: string;
+    readonly projectIds?: readonly string[];
+    readonly workflowStateId?: string;
+    readonly workflowStateIds?: readonly string[];
+    readonly labelIds?: readonly string[];
+    readonly actions?: readonly string[];
+    readonly selfActorId?: string;
+    readonly excludeActorIds?: readonly string[];
+    readonly excludeSelfActor?: boolean;
+}
+export interface LinearAgentSourceOptions extends LinearSourceBaseOptions {
+    readonly appUserId?: string;
+    readonly excludeActorIds?: readonly string[];
+}
+export declare function linearIssueSource(options: LinearIssueSourceOptions): Source<LinearIssueTriggerEvent>;
+export declare function linearAgentSource(options: LinearAgentSourceOptions): Source<LinearAgentTriggerEvent>;
+export interface LinearIssueSinkOutput {
+    readonly issueId: string;
+    readonly finalSummary?: string;
+    readonly prUrl?: string;
+    readonly commentBody?: string;
+    readonly update?: Omit<LinearIssueUpdateInput, "issueId">;
+}
+export interface LinearIssueSinkOptions {
+    readonly tool?: LinearTool;
+    readonly commentPrefix?: string;
+}
+export declare function linearIssueSink(options?: LinearIssueSinkOptions): Sink<LinearIssueSinkOutput>;
+export interface LinearAgentSinkOutput {
+    readonly agentSessionId: string;
+    readonly responseBody?: string;
+    readonly errorBody?: string;
+    readonly prUrl?: string;
+    readonly plan?: string;
+    readonly externalUrls?: readonly LinearExternalUrl[];
+}
+export interface LinearAgentSinkOptions {
+    readonly tool?: LinearTool;
+}
+export declare function linearAgentSink(options?: LinearAgentSinkOptions): Sink<LinearAgentSinkOutput>;
+//# sourceMappingURL=linear.d.ts.map

package/dist/loop/io/linear.d.ts.map

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

package/dist/loop/io/sink.d.ts

@@ -0,0 +1,47 @@
+import { type Result } from "neverthrow";
+import { type RuntimeError } from "../../model/index.ts";
+import { type GitHubTool } from "../../tools/index.ts";
+/** Bundled sink kinds. A custom output reuses the closest kind or its own structural object. */
+export type SinkKind = "pr" | "file" | "slack" | "queue" | "stdout" | "linear-issue" | "linear-agent";
+/** A loop output — the only loop-level emit boundary; Result-typed. */
+export interface Sink<A = unknown> {
+    readonly kind: SinkKind;
+    emit(output: A): Promise<Result<void, RuntimeError>>;
+}
+export interface StdoutOptions<A> {
+    readonly format?: (output: A) => string;
+    /** Write target; default: process.stdout. Injectable for tests. */
+    readonly write?: (text: string) => void;
+}
+export declare function stdout<A = unknown>(options?: StdoutOptions<A>): Sink<A>;
+export interface FileSinkOptions<A> {
+    readonly path: string;
+    readonly format?: (output: A) => string;
+}
+export declare function file<A = unknown>(options: FileSinkOptions<A>): Sink<A>;
+export interface PrSinkOptions<A> {
+    readonly title: string;
+    readonly base?: string;
+    /** Body file written before `gh pr create --body-file`; default: a tmpdir file. */
+    readonly bodyFile?: string;
+    readonly format?: (output: A) => string;
+    /** GitHub client; default: the repo gh CLI tool. Injectable for tests. */
+    readonly gh?: GitHubTool;
+}
+export declare function pr<A = unknown>(options: PrSinkOptions<A>): Sink<A>;
+/** POSTs `body` to `url`; resolves to `ok` on a 2xx, `err(RuntimeError)` otherwise. */
+export type SlackPost = (url: string, body: string) => Promise<Result<void, RuntimeError>>;
+export interface SlackOptions<A> {
+    readonly webhookUrl: string;
+    readonly format?: (output: A) => string;
+    readonly post?: SlackPost;
+}
+export declare function slack<A = unknown>(options: SlackOptions<A>): Sink<A>;
+export interface QueueProducer<A> {
+    push(message: A): Promise<Result<void, RuntimeError>>;
+}
+export interface QueueSinkOptions<A> {
+    readonly producer: QueueProducer<A>;
+}
+export declare function queueSink<A = unknown>(options: QueueSinkOptions<A>): Sink<A>;
+//# sourceMappingURL=sink.d.ts.map

package/dist/loop/io/sink.d.ts.map

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