@llm4ts/flow 0.1.0

package/dist/FlowContext.d.ts

@@ -0,0 +1,23 @@
+import * as Context from "effect/Context";
+import type { ConnectorCapabilities } from "@llm4ts/core/Models";
+import type { LlmServiceShape } from "@llm4ts/core/LlmService";
+import type { FlowEventsShape } from "./FlowEvents.ts";
+import type { GitToolShape } from "./GitTool.ts";
+import type { GitHubToolShape } from "./GitHubTool.ts";
+export interface FlowContextShape {
+    readonly reasoning: LlmServiceShape;
+    readonly coder: LlmServiceShape;
+    readonly git: GitToolShape;
+    readonly hosting: GitHubToolShape;
+    readonly events: FlowEventsShape;
+    readonly reviewers: ReadonlyArray<LlmServiceShape>;
+    readonly coderCapabilities: ConnectorCapabilities;
+    readonly userPrompt: string;
+    readonly workDir: string;
+    readonly workspace: string;
+}
+declare const FlowContext_base: Context.ServiceClass<FlowContext, "@llm4ts/flow/FlowContext", FlowContextShape>;
+export declare class FlowContext extends FlowContext_base {
+}
+export {};
+//# sourceMappingURL=FlowContext.d.ts.map

package/dist/FlowContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlowContext.d.ts","sourceRoot":"","sources":["../src/FlowContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AACzC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAChD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAEtD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAA;IACnC,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAA;IAC/B,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;IACjC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAA;IAChC,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,eAAe,CAAC,CAAA;IAClD,QAAQ,CAAC,iBAAiB,EAAE,qBAAqB,CAAA;IACjD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;;AAED,qBAAa,WAAY,SAAQ,gBAEhC;CAAG"}

package/dist/FlowContext.js

@@ -0,0 +1,4 @@
+import * as Context from "effect/Context";
+export class FlowContext extends Context.Service()("@llm4ts/flow/FlowContext") {
+}
+//# sourceMappingURL=FlowContext.js.map

package/dist/FlowContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlowContext.js","sourceRoot":"","sources":["../src/FlowContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AAoBzC,MAAM,OAAO,WAAY,SAAQ,OAAO,CAAC,OAAO,EAAiC,CAC/E,0BAA0B,CAC3B;CAAG"}

package/dist/FlowError.d.ts

@@ -0,0 +1,80 @@
+import * as Schema from "effect/Schema";
+import { LlmError } from "@llm4ts/core/Errors";
+declare const PersistenceError_base: Schema.Class<PersistenceError, Schema.TaggedStruct<"Persistence", {
+    readonly message: Schema.String;
+    readonly cause: Schema.optionalKey<Schema.Defect>;
+}>, import("effect/Cause").YieldableError>;
+export declare class PersistenceError extends PersistenceError_base {
+}
+declare const PlanParseError_base: Schema.Class<PlanParseError, Schema.TaggedStruct<"PlanParse", {
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+export declare class PlanParseError extends PlanParseError_base {
+}
+declare const UnsupportedSchemaVersion_base: Schema.Class<UnsupportedSchemaVersion, Schema.TaggedStruct<"UnsupportedSchemaVersion", {
+    readonly path: Schema.String;
+    readonly expected: Schema.Int;
+    readonly actual: Schema.Int;
+}>, import("effect/Cause").YieldableError>;
+export declare class UnsupportedSchemaVersion extends UnsupportedSchemaVersion_base {
+    get message(): string;
+}
+declare const WorkspacePathError_base: Schema.Class<WorkspacePathError, Schema.TaggedStruct<"WorkspacePath", {
+    readonly path: Schema.String;
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+export declare class WorkspacePathError extends WorkspacePathError_base {
+}
+declare const WorkspaceLimitError_base: Schema.Class<WorkspaceLimitError, Schema.TaggedStruct<"WorkspaceLimit", {
+    readonly operation: Schema.String;
+    readonly limit: Schema.Int;
+    readonly actual: Schema.Int;
+}>, import("effect/Cause").YieldableError>;
+export declare class WorkspaceLimitError extends WorkspaceLimitError_base {
+    get message(): string;
+}
+declare const WorkspaceIoError_base: Schema.Class<WorkspaceIoError, Schema.TaggedStruct<"WorkspaceIo", {
+    readonly operation: Schema.String;
+    readonly path: Schema.String;
+    readonly message: Schema.String;
+    readonly cause: Schema.optionalKey<Schema.Defect>;
+}>, import("effect/Cause").YieldableError>;
+export declare class WorkspaceIoError extends WorkspaceIoError_base {
+}
+declare const FlowAborted_base: Schema.Class<FlowAborted, Schema.TaggedStruct<"Aborted", {
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+export declare class FlowAborted extends FlowAborted_base {
+}
+declare const ProcessError_base: Schema.Class<ProcessError, Schema.TaggedStruct<"Process", {
+    readonly message: Schema.String;
+    readonly detail: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+export declare class ProcessError extends ProcessError_base {
+}
+declare const FlowLlmError_base: Schema.Class<FlowLlmError, Schema.TaggedStruct<"Llm", {
+    readonly message: Schema.String;
+    readonly cause: Schema.optionalKey<Schema.Union<readonly [typeof import("@llm4ts/core/Errors").ProviderError, typeof import("@llm4ts/core/Errors").UsageLimitError, typeof import("@llm4ts/core/Errors").AuthenticationError, typeof import("@llm4ts/core/Errors").InvalidRequestError, typeof import("@llm4ts/core/Errors").ParseError, typeof import("@llm4ts/core/Errors").ToolError, typeof import("@llm4ts/core/Errors").ConfigError, typeof import("@llm4ts/core/Errors").RateLimitError, typeof import("@llm4ts/core/Errors").TimeoutError, typeof import("@llm4ts/core/Errors").TurnLimitError]>>;
+}>, import("effect/Cause").YieldableError>;
+export declare class FlowLlmError extends FlowLlmError_base {
+    static readonly from: (cause?: typeof LlmError.Type) => FlowLlmError;
+}
+declare const FlowCapabilityDenied_base: Schema.Class<FlowCapabilityDenied, Schema.TaggedStruct<"CapabilityDenied", {
+    readonly capability: Schema.Union<readonly [typeof import("@llm4ts/core/Capability").GitRead, typeof import("@llm4ts/core/Capability").GitWrite, typeof import("@llm4ts/core/Capability").GitPush, typeof import("@llm4ts/core/Capability").GhRead, typeof import("@llm4ts/core/Capability").GhWrite, typeof import("@llm4ts/core/Capability").AdoRead, typeof import("@llm4ts/core/Capability").AdoWrite, typeof import("@llm4ts/core/Capability").Exec, typeof import("@llm4ts/core/Capability").UseCoder, typeof import("@llm4ts/core/Capability").UseReasoning, typeof import("@llm4ts/core/Capability").Declassify]>;
+    readonly operation: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+export declare class FlowCapabilityDenied extends FlowCapabilityDenied_base {
+    get message(): string;
+}
+declare const BudgetExceeded_base: Schema.Class<BudgetExceeded, Schema.TaggedStruct<"BudgetExceeded", {
+    readonly metric: Schema.Literals<readonly ["tokens", "costUsd"]>;
+    readonly limit: Schema.Number;
+    readonly actual: Schema.Number;
+}>, import("effect/Cause").YieldableError>;
+export declare class BudgetExceeded extends BudgetExceeded_base {
+    get message(): string;
+}
+export declare const FlowError: Schema.Union<readonly [typeof PersistenceError, typeof PlanParseError, typeof UnsupportedSchemaVersion, typeof WorkspacePathError, typeof WorkspaceLimitError, typeof WorkspaceIoError, typeof FlowAborted, typeof ProcessError, typeof FlowLlmError, typeof FlowCapabilityDenied, typeof BudgetExceeded]>;
+export type FlowError = typeof FlowError.Type;
+export {};
+//# sourceMappingURL=FlowError.d.ts.map

package/dist/FlowError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlowError.d.ts","sourceRoot":"","sources":["../src/FlowError.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;;;;;AAE9C,qBAAa,gBAAiB,SAAQ,qBAGpC;CAAG;;;;AAEL,qBAAa,cAAe,SAAQ,mBAElC;CAAG;;;;;;AAEL,qBAAa,wBAAyB,SAAQ,6BAO7C;IACC,IAAI,OAAO,IAAI,MAAM,CAEpB;CACF;;;;;AAED,qBAAa,kBAAmB,SAAQ,uBAMvC;CAAG;;;;;;AAEJ,qBAAa,mBAAoB,SAAQ,wBAOxC;IACC,IAAI,OAAO,IAAI,MAAM,CAEpB;CACF;;;;;;;AAED,qBAAa,gBAAiB,SAAQ,qBAKpC;CAAG;;;;AAEL,qBAAa,WAAY,SAAQ,gBAE/B;CAAG;;;;;AAEL,qBAAa,YAAa,SAAQ,iBAGhC;CAAG;;;;;AAEL,qBAAa,YAAa,SAAQ,iBAGhC;IACA,MAAM,CAAC,QAAQ,CAAC,IAAI,GAAI,QAAQ,OAAO,QAAQ,CAAC,IAAI,KAAG,YAAY,CAI/D;CACL;;;;;AAED,qBAAa,oBAAqB,SAAQ,yBAMzC;IACC,IAAI,OAAO,IAAI,MAAM,CAIpB;CACF;;;;;;AAED,qBAAa,cAAe,SAAQ,mBAIlC;IACA,IAAI,OAAO,IAAI,MAAM,CAEpB;CACF;AAED,eAAO,MAAM,SAAS,4SAYpB,CAAA;AACF,MAAM,MAAM,SAAS,GAAG,OAAO,SAAS,CAAC,IAAI,CAAA"}

package/dist/FlowError.js

@@ -0,0 +1,92 @@
+import * as Schema from "effect/Schema";
+import { Capability } from "@llm4ts/core/Capability";
+import { LlmError } from "@llm4ts/core/Errors";
+export class PersistenceError extends Schema.TaggedErrorClass()("Persistence", {
+    message: Schema.String,
+    cause: Schema.optionalKey(Schema.Defect())
+}) {
+}
+export class PlanParseError extends Schema.TaggedErrorClass()("PlanParse", {
+    message: Schema.String
+}) {
+}
+export class UnsupportedSchemaVersion extends Schema.TaggedErrorClass()("UnsupportedSchemaVersion", {
+    path: Schema.String,
+    expected: Schema.Int,
+    actual: Schema.Int
+}) {
+    get message() {
+        return `unsupported schema version in ${this.path}: expected ${this.expected}, received ${this.actual}`;
+    }
+}
+export class WorkspacePathError extends Schema.TaggedErrorClass()("WorkspacePath", {
+    path: Schema.String,
+    message: Schema.String
+}) {
+}
+export class WorkspaceLimitError extends Schema.TaggedErrorClass()("WorkspaceLimit", {
+    operation: Schema.String,
+    limit: Schema.Int,
+    actual: Schema.Int
+}) {
+    get message() {
+        return `${this.operation} exceeded limit ${this.limit}; received ${this.actual}`;
+    }
+}
+export class WorkspaceIoError extends Schema.TaggedErrorClass()("WorkspaceIo", {
+    operation: Schema.String,
+    path: Schema.String,
+    message: Schema.String,
+    cause: Schema.optionalKey(Schema.Defect())
+}) {
+}
+export class FlowAborted extends Schema.TaggedErrorClass()("Aborted", {
+    message: Schema.String
+}) {
+}
+export class ProcessError extends Schema.TaggedErrorClass()("Process", {
+    message: Schema.String,
+    detail: Schema.String
+}) {
+}
+export class FlowLlmError extends Schema.TaggedErrorClass()("Llm", {
+    message: Schema.String,
+    cause: Schema.optionalKey(LlmError)
+}) {
+    static from = (cause) => FlowLlmError.make({
+        message: cause?.message ?? "LLM request failed",
+        ...(cause === undefined ? {} : { cause })
+    });
+}
+export class FlowCapabilityDenied extends Schema.TaggedErrorClass()("CapabilityDenied", {
+    capability: Capability,
+    operation: Schema.String
+}) {
+    get message() {
+        const capability = this.capability._tag === "Exec" ? `Exec(${this.capability.command})` : this.capability._tag;
+        return `capability ${capability} denied for ${this.operation}`;
+    }
+}
+export class BudgetExceeded extends Schema.TaggedErrorClass()("BudgetExceeded", {
+    metric: Schema.Literals(["tokens", "costUsd"]),
+    limit: Schema.Number,
+    actual: Schema.Number
+}) {
+    get message() {
+        return `${this.metric} budget exceeded: limit ${this.limit}, actual ${this.actual}`;
+    }
+}
+export const FlowError = Schema.Union([
+    PersistenceError,
+    PlanParseError,
+    UnsupportedSchemaVersion,
+    WorkspacePathError,
+    WorkspaceLimitError,
+    WorkspaceIoError,
+    FlowAborted,
+    ProcessError,
+    FlowLlmError,
+    FlowCapabilityDenied,
+    BudgetExceeded
+]);
+//# sourceMappingURL=FlowError.js.map

package/dist/FlowError.js.map

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

package/dist/FlowEvents.d.ts

@@ -0,0 +1,101 @@
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as PubSub from "effect/PubSub";
+import * as Schema from "effect/Schema";
+import type * as Scope from "effect/Scope";
+import * as Stream from "effect/Stream";
+import { TokenUsage } from "@llm4ts/core/Models";
+declare const StageStarted_base: Schema.Class<StageStarted, Schema.TaggedStruct<"StageStarted", {
+    readonly stage: Schema.String;
+}>, {}>;
+export declare class StageStarted extends StageStarted_base {
+}
+declare const StageCompleted_base: Schema.Class<StageCompleted, Schema.TaggedStruct<"StageCompleted", {
+    readonly stage: Schema.String;
+}>, {}>;
+export declare class StageCompleted extends StageCompleted_base {
+}
+declare const StageFailed_base: Schema.Class<StageFailed, Schema.TaggedStruct<"StageFailed", {
+    readonly stage: Schema.String;
+    readonly message: Schema.String;
+}>, {}>;
+export declare class StageFailed extends StageFailed_base {
+}
+declare const Aborted_base: Schema.Class<Aborted, Schema.TaggedStruct<"Aborted", {
+    readonly message: Schema.String;
+}>, {}>;
+export declare class Aborted extends Aborted_base {
+}
+declare const Info_base: Schema.Class<Info, Schema.TaggedStruct<"Info", {
+    readonly message: Schema.String;
+}>, {}>;
+export declare class Info extends Info_base {
+}
+declare const ToolUse_base: Schema.Class<ToolUse, Schema.TaggedStruct<"ToolUse", {
+    readonly tool: Schema.String;
+    readonly args: Schema.String;
+}>, {}>;
+export declare class ToolUse extends ToolUse_base {
+}
+declare const AssistantMessage_base: Schema.Class<AssistantMessage, Schema.TaggedStruct<"AssistantMessage", {
+    readonly text: Schema.String;
+}>, {}>;
+export declare class AssistantMessage extends AssistantMessage_base {
+}
+declare const TokensUsed_base: Schema.Class<TokensUsed, Schema.TaggedStruct<"TokensUsed", {
+    readonly agent: Schema.String;
+    readonly model: Schema.optionalKey<Schema.String>;
+    readonly usage: typeof TokenUsage;
+}>, {}>;
+export declare class TokensUsed extends TokensUsed_base {
+}
+declare const CapabilityUsedEvent_base: Schema.Class<CapabilityUsedEvent, Schema.TaggedStruct<"CapabilityUsed", {
+    readonly capability: Schema.String;
+    readonly operation: Schema.String;
+}>, {}>;
+export declare class CapabilityUsedEvent extends CapabilityUsedEvent_base {
+}
+declare const CapabilityDeniedEvent_base: Schema.Class<CapabilityDeniedEvent, Schema.TaggedStruct<"CapabilityDenied", {
+    readonly capability: Schema.String;
+    readonly operation: Schema.String;
+}>, {}>;
+export declare class CapabilityDeniedEvent extends CapabilityDeniedEvent_base {
+}
+declare const CapabilityUnenforceable_base: Schema.Class<CapabilityUnenforceable, Schema.TaggedStruct<"CapabilityUnenforceable", {
+    readonly detail: Schema.String;
+}>, {}>;
+export declare class CapabilityUnenforceable extends CapabilityUnenforceable_base {
+}
+declare const Declassified_base: Schema.Class<Declassified, Schema.TaggedStruct<"Declassified", {
+    readonly label: Schema.String;
+}>, {}>;
+export declare class Declassified extends Declassified_base {
+}
+export declare const FlowEvent: Schema.Union<readonly [typeof StageStarted, typeof StageCompleted, typeof StageFailed, typeof Aborted, typeof Info, typeof ToolUse, typeof AssistantMessage, typeof TokensUsed, typeof CapabilityUsedEvent, typeof CapabilityDeniedEvent, typeof CapabilityUnenforceable, typeof Declassified]>;
+export type FlowEvent = typeof FlowEvent.Type;
+export declare const FlowEventsValues: Readonly<{
+    CapabilityUsed: (capability: string, operation: string) => CapabilityUsedEvent;
+    CapabilityDenied: (capability: string, operation: string) => CapabilityDeniedEvent;
+    CapabilityUnenforceable: (detail: string) => CapabilityUnenforceable;
+    Declassified: (label: string) => Declassified;
+}>;
+export interface FlowEventsShape {
+    readonly publish: (event: FlowEvent) => Effect.Effect<void>;
+}
+declare const FlowEvents_base: Context.ServiceClass<FlowEvents, "@llm4ts/flow/FlowEvents", FlowEventsShape>;
+export declare class FlowEvents extends FlowEvents_base {
+}
+export declare const FlowEventsNoop: Layer.Layer<FlowEvents, never, never>;
+export interface CollectingFlowEvents extends FlowEventsShape {
+    readonly recorded: Effect.Effect<ReadonlyArray<FlowEvent>>;
+}
+export declare const makeCollectingFlowEvents: Effect.Effect<CollectingFlowEvents>;
+export interface FlowEventHub extends FlowEventsShape {
+    readonly subscribe: Effect.Effect<PubSub.Subscription<FlowEvent>, never, Scope.Scope>;
+    readonly stream: Stream.Stream<FlowEvent>;
+    readonly publishedCount: Effect.Effect<number>;
+}
+export declare const makeFlowEventHub: (capacity?: any) => Effect.Effect<FlowEventHub, never, never>;
+export {};
+//# sourceMappingURL=FlowEvents.d.ts.map

package/dist/FlowEvents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlowEvents.d.ts","sourceRoot":"","sources":["../src/FlowEvents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AACzC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,KAAK,KAAK,MAAM,cAAc,CAAA;AAC1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;;;;AAEhD,qBAAa,YAAa,SAAQ,iBAEhC;CAAG;;;;AAEL,qBAAa,cAAe,SAAQ,mBAElC;CAAG;;;;;AAEL,qBAAa,WAAY,SAAQ,gBAG/B;CAAG;;;;AAEL,qBAAa,OAAQ,SAAQ,YAE3B;CAAG;;;;AAEL,qBAAa,IAAK,SAAQ,SAExB;CAAG;;;;;AAEL,qBAAa,OAAQ,SAAQ,YAG3B;CAAG;;;;AAEL,qBAAa,gBAAiB,SAAQ,qBAEpC;CAAG;;;;;;AAEL,qBAAa,UAAW,SAAQ,eAI9B;CAAG;;;;;AAEL,qBAAa,mBAAoB,SAAQ,wBAMxC;CAAG;;;;;AAEJ,qBAAa,qBAAsB,SAAQ,0BAM1C;CAAG;;;;AAEJ,qBAAa,uBAAwB,SAAQ,4BAK5C;CAAG;;;;AAEJ,qBAAa,YAAa,SAAQ,iBAEhC;CAAG;AAEL,eAAO,MAAM,SAAS,iSAapB,CAAA;AACF,MAAM,MAAM,SAAS,GAAG,OAAO,SAAS,CAAC,IAAI,CAAA;AAE7C,eAAO,MAAM,gBAAgB;iCACE,MAAM,aAAa,MAAM,KAAG,mBAAmB;mCAE7C,MAAM,aAAa,MAAM,KAAG,qBAAqB;sCAE9C,MAAM,KAAG,uBAAuB;0BAE5C,MAAM,KAAG,YAAY;EAC3C,CAAA;AAEF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;CAC5D;;AAED,qBAAa,UAAW,SAAQ,eAE/B;CAAG;AAMJ,eAAO,MAAM,cAAc,uCAA4C,CAAA;AAEvE,MAAM,WAAW,oBAAqB,SAAQ,eAAe;IAC3D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAA;CAC3D;AAED,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAMxE,CAAA;AAED,MAAM,WAAW,YAAa,SAAQ,eAAe;IACnD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;IACrF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;IACzC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;CAC/C;AAED,eAAO,MAAM,gBAAgB,+DAe3B,CAAA"}

package/dist/FlowEvents.js

@@ -0,0 +1,103 @@
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as PubSub from "effect/PubSub";
+import * as Ref from "effect/Ref";
+import * as Schema from "effect/Schema";
+import * as Stream from "effect/Stream";
+import { TokenUsage } from "@llm4ts/core/Models";
+export class StageStarted extends Schema.TaggedClass()("StageStarted", {
+    stage: Schema.String
+}) {
+}
+export class StageCompleted extends Schema.TaggedClass()("StageCompleted", {
+    stage: Schema.String
+}) {
+}
+export class StageFailed extends Schema.TaggedClass()("StageFailed", {
+    stage: Schema.String,
+    message: Schema.String
+}) {
+}
+export class Aborted extends Schema.TaggedClass()("Aborted", {
+    message: Schema.String
+}) {
+}
+export class Info extends Schema.TaggedClass()("Info", {
+    message: Schema.String
+}) {
+}
+export class ToolUse extends Schema.TaggedClass()("ToolUse", {
+    tool: Schema.String,
+    args: Schema.String
+}) {
+}
+export class AssistantMessage extends Schema.TaggedClass()("AssistantMessage", {
+    text: Schema.String
+}) {
+}
+export class TokensUsed extends Schema.TaggedClass()("TokensUsed", {
+    agent: Schema.String,
+    model: Schema.optionalKey(Schema.String),
+    usage: TokenUsage
+}) {
+}
+export class CapabilityUsedEvent extends Schema.TaggedClass()("CapabilityUsed", {
+    capability: Schema.String,
+    operation: Schema.String
+}) {
+}
+export class CapabilityDeniedEvent extends Schema.TaggedClass()("CapabilityDenied", {
+    capability: Schema.String,
+    operation: Schema.String
+}) {
+}
+export class CapabilityUnenforceable extends Schema.TaggedClass()("CapabilityUnenforceable", {
+    detail: Schema.String
+}) {
+}
+export class Declassified extends Schema.TaggedClass()("Declassified", {
+    label: Schema.String
+}) {
+}
+export const FlowEvent = Schema.Union([
+    StageStarted,
+    StageCompleted,
+    StageFailed,
+    Aborted,
+    Info,
+    ToolUse,
+    AssistantMessage,
+    TokensUsed,
+    CapabilityUsedEvent,
+    CapabilityDeniedEvent,
+    CapabilityUnenforceable,
+    Declassified
+]);
+export const FlowEventsValues = Object.freeze({
+    CapabilityUsed: (capability, operation) => new CapabilityUsedEvent({ capability, operation }),
+    CapabilityDenied: (capability, operation) => new CapabilityDeniedEvent({ capability, operation }),
+    CapabilityUnenforceable: (detail) => new CapabilityUnenforceable({ detail }),
+    Declassified: (label) => new Declassified({ label })
+});
+export class FlowEvents extends Context.Service()("@llm4ts/flow/FlowEvents") {
+}
+const noopFlowEvents = FlowEvents.of({
+    publish: (_event) => Effect.void
+});
+export const FlowEventsNoop = Layer.succeed(FlowEvents)(noopFlowEvents);
+export const makeCollectingFlowEvents = Effect.map(Ref.make([]), (events) => ({
+    publish: (event) => Ref.update(events, (recorded) => [...recorded, event]),
+    recorded: Ref.get(events)
+}));
+export const makeFlowEventHub = Effect.fn("@llm4ts/flow/FlowEvents.makeHub")(function* (capacity = 64) {
+    const events = yield* PubSub.bounded(capacity);
+    const published = yield* Ref.make(0);
+    return {
+        publish: (event) => Ref.update(published, (count) => count + 1).pipe(Effect.andThen(PubSub.publish(events, event)), Effect.asVoid),
+        subscribe: PubSub.subscribe(events),
+        stream: Stream.fromPubSub(events),
+        publishedCount: Ref.get(published)
+    };
+});
+//# sourceMappingURL=FlowEvents.js.map

package/dist/FlowEvents.js.map

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

package/dist/FlowRecorder.d.ts

@@ -0,0 +1,26 @@
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+import type * as Scope from "effect/Scope";
+import type { StreamRecorder } from "@llm4ts/core/observability/StreamRecorder";
+import type { FlowEvent, FlowEventHub } from "./FlowEvents.ts";
+import type { PlainFileStoreShape } from "./Persistence.ts";
+declare const TraceLine_base: Schema.Class<TraceLine, Schema.Struct<{
+    readonly schemaVersion: Schema.optionalKey<Schema.Int>;
+    readonly seq: Schema.Int;
+    readonly timestamp: Schema.Number;
+    readonly runId: Schema.String;
+    readonly kind: Schema.String;
+    readonly fields: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+}>, {}>;
+export declare class TraceLine extends TraceLine_base {
+}
+export interface FlowRecorderShape extends StreamRecorder {
+    readonly runId: string;
+    readonly tracePath: string;
+    readonly record: (event: FlowEvent) => Effect.Effect<void>;
+    readonly consume: (hub: FlowEventHub) => Effect.Effect<void, never, Scope.Scope>;
+    readonly awaitDrained: (hub: FlowEventHub) => Effect.Effect<void>;
+}
+export declare const makeFlowRecorder: (files: PlainFileStoreShape, tracePath: string, runId: string) => Effect.Effect<FlowRecorderShape, never, never>;
+export {};
+//# sourceMappingURL=FlowRecorder.d.ts.map

package/dist/FlowRecorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlowRecorder.d.ts","sourceRoot":"","sources":["../src/FlowRecorder.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,OAAO,KAAK,KAAK,KAAK,MAAM,cAAc,CAAA;AAE1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAA;AAE/E,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;;;;;;;;;AAE3D,qBAAa,SAAU,SAAQ,cAO7B;CAAG;AAEL,MAAM,WAAW,iBAAkB,SAAQ,cAAc;IACvD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAC1D,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;IAChF,QAAQ,CAAC,YAAY,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;CAClE;AAYD,eAAO,MAAM,gBAAgB,kHA4E3B,CAAA"}

package/dist/FlowRecorder.js

@@ -0,0 +1,74 @@
+import * as Clock from "effect/Clock";
+import * as Effect from "effect/Effect";
+import * as Ref from "effect/Ref";
+import * as Schema from "effect/Schema";
+import * as Semaphore from "effect/Semaphore";
+import * as Stream from "effect/Stream";
+export class TraceLine extends Schema.Class("TraceLine")({
+    schemaVersion: Schema.optionalKey(Schema.Int),
+    seq: Schema.Int,
+    timestamp: Schema.Number,
+    runId: Schema.String,
+    kind: Schema.String,
+    fields: Schema.Record(Schema.String, Schema.Json)
+}) {
+}
+const encode = (line) => JSON.stringify({
+    schemaVersion: line.schemaVersion,
+    seq: line.seq,
+    timestamp: line.timestamp,
+    runId: line.runId,
+    kind: line.kind,
+    fields: line.fields
+});
+export const makeFlowRecorder = Effect.fn("@llm4ts/flow/FlowRecorder.make")(function* (files, tracePath, runId) {
+    const sequence = yield* Ref.make(0);
+    const consumed = yield* Ref.make(0);
+    const lock = yield* Semaphore.make(1);
+    const degraded = yield* Ref.make(false);
+    const append = (kind, fields) => lock.withPermit(Effect.gen(function* () {
+        if (yield* Ref.get(degraded)) {
+            return;
+        }
+        const seq = yield* Ref.getAndUpdate(sequence, (current) => current + 1);
+        const timestamp = yield* Clock.currentTimeMillis;
+        const line = TraceLine.make({
+            schemaVersion: 1,
+            seq,
+            timestamp,
+            runId,
+            kind,
+            fields
+        });
+        yield* files
+            .append(tracePath, `${encode(line)}\n`)
+            .pipe(Effect.catch(() => Ref.set(degraded, true)));
+    }));
+    const record = (event) => append(event._tag, { event: JSON.stringify(event) });
+    const recorder = {
+        runId,
+        tracePath,
+        record,
+        rawLine: (provider, model, line) => append("RawLine", {
+            provider,
+            ...(model === undefined ? {} : { model }),
+            line
+        }),
+        streamError: (provider, model, message) => append("StreamError", {
+            provider,
+            ...(model === undefined ? {} : { model }),
+            message
+        }),
+        consume: (hub) => Effect.gen(function* () {
+            const subscription = yield* hub.subscribe;
+            yield* Stream.fromSubscription(subscription).pipe(Stream.runForEach((event) => record(event).pipe(Effect.andThen(Ref.update(consumed, (count) => count + 1)))), Effect.forkScoped, Effect.asVoid);
+        }),
+        awaitDrained: (hub) => Effect.gen(function* () {
+            const target = yield* hub.publishedCount;
+            const drain = Effect.suspend(() => Ref.get(consumed).pipe(Effect.flatMap((count) => count >= target ? Effect.void : Effect.yieldNow.pipe(Effect.andThen(drain)))));
+            yield* drain;
+        })
+    };
+    return recorder;
+});
+//# sourceMappingURL=FlowRecorder.js.map

package/dist/FlowRecorder.js.map

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

package/dist/GitHubTool.d.ts

@@ -0,0 +1,53 @@
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+import type { ProcessExecutorShape } from "@llm4ts/core/ProcessExecutor";
+import { ProcessError, type FlowError } from "./FlowError.ts";
+import type { FlowEventsShape } from "./FlowEvents.ts";
+declare const IssueRef_base: Schema.Class<IssueRef, Schema.Struct<{
+    readonly owner: Schema.String;
+    readonly repo: Schema.String;
+    readonly number: Schema.Int;
+}>, {}>;
+export declare class IssueRef extends IssueRef_base {
+    get shortRef(): string;
+}
+export declare const parseIssueRef: (input: string) => IssueRef | undefined;
+declare const Issue_base: Schema.Class<Issue, Schema.Struct<{
+    readonly title: Schema.String;
+    readonly body: Schema.String;
+    readonly author: Schema.String;
+}>, {}>;
+export declare class Issue extends Issue_base {
+}
+declare const PullRequest_base: Schema.Class<PullRequest, Schema.Struct<{
+    readonly owner: Schema.String;
+    readonly repo: Schema.String;
+    readonly number: Schema.Int;
+    readonly url: Schema.String;
+}>, {}>;
+export declare class PullRequest extends PullRequest_base {
+    get shortRef(): string;
+}
+export declare const BuildOutcome: Schema.Literals<readonly ["Success", "Failure", "Pending", "TimedOut"]>;
+export type BuildOutcome = typeof BuildOutcome.Type;
+export declare const parsePullRequestUrl: (url: string) => PullRequest | undefined;
+export declare const prViewArgs: string[];
+export declare const prCreateArgs: (title: string, body: string, base: string | undefined, draft: boolean) => ReadonlyArray<string>;
+export declare const issueViewArgs: (ref: IssueRef) => ReadonlyArray<string>;
+export declare const issueCommentArgs: (ref: IssueRef, body: string) => ReadonlyArray<string>;
+export declare const prCommentArgs: (pr: PullRequest, body: string) => ReadonlyArray<string>;
+export declare const prPatchArgs: (pr: PullRequest, title: string, body: string) => ReadonlyArray<string>;
+export declare const prChecksArgs: (pr: PullRequest) => ReadonlyArray<string>;
+export declare const parseIssue: (json: string) => Effect.Effect<Issue, ProcessError>;
+export declare const outcomeFromChecksJson: (json: string) => Effect.Effect<BuildOutcome, ProcessError>;
+export interface GitHubToolShape {
+    readonly createPr: (title: string, body: string, base?: string, draft?: boolean) => Effect.Effect<PullRequest, FlowError>;
+    readonly readIssue: (ref: IssueRef) => Effect.Effect<Issue, FlowError>;
+    readonly writeIssueComment: (ref: IssueRef, body: string) => Effect.Effect<void, FlowError>;
+    readonly writePrComment: (pr: PullRequest, body: string) => Effect.Effect<void, FlowError>;
+    readonly updatePr: (pr: PullRequest, title: string, body: string) => Effect.Effect<void, FlowError>;
+    readonly prChecks: (pr: PullRequest) => Effect.Effect<BuildOutcome, FlowError>;
+}
+export declare const makeGitHubTool: (process: ProcessExecutorShape, workDir: string, events: FlowEventsShape) => GitHubToolShape;
+export {};
+//# sourceMappingURL=GitHubTool.d.ts.map

package/dist/GitHubTool.d.ts.map

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