@relayfx/sdk 0.1.0 → 0.2.0

package/dist/types/relay/sqlite-migrations.d.ts

@@ -35,5 +35,20 @@ export declare const migrations: readonly [{
     readonly name: "topic_subscriptions";
     readonly file: "0007_topic_subscriptions.sql";
     readonly source: string;
+}, {
+    readonly id: 8;
+    readonly name: "child_fan_out";
+    readonly file: "0008_child_fan_out.sql";
+    readonly source: string;
+}, {
+    readonly id: 9;
+    readonly name: "workflow_definitions";
+    readonly file: "0009_workflow_definitions.sql";
+    readonly source: string;
+}, {
+    readonly id: 10;
+    readonly name: "workflow_runtime";
+    readonly file: "0010_workflow_runtime.sql";
+    readonly source: string;
 }];
-export declare const loader: Effect.Effect<(readonly [1 | 2 | 6 | 3 | 4 | 7 | 5, "baseline" | "durable_tool_placement" | "durable_inbox" | "execution_state" | "durable_entities" | "ephemeral_presence" | "topic_subscriptions", Effect.Effect<Effect.Effect<void, import("effect/unstable/sql/SqlError").SqlError, SqlClient>, never, never>])[], never, never>;
+export declare const loader: Effect.Effect<(readonly [1 | 2 | 6 | 3 | 4 | 7 | 8 | 5 | 9 | 10, "baseline" | "durable_tool_placement" | "durable_inbox" | "execution_state" | "durable_entities" | "ephemeral_presence" | "topic_subscriptions" | "child_fan_out" | "workflow_definitions" | "workflow_runtime", Effect.Effect<Effect.Effect<void, import("effect/unstable/sql/SqlError").SqlError, SqlClient>, never, never>])[], never, never>;

package/dist/types/relay/sqlite-runtime.d.ts

@@ -1,5 +1,10 @@
 import { type SqliteClientConfig } from "@effect/sql-sqlite-bun/SqliteClient";
+import { ChildFanOutRuntime, WorkflowDefinitionRuntime } from "../runtime/index";
+import { WorkflowDefinitionRepository } from "../store-sql/portable";
 import { Layer } from "effect";
-export declare const clientLayer: (options: SqliteClientConfig) => Layer.Layer<import("effect/unstable/sql/SqlClient").SqlClient | import("@effect/sql-sqlite-bun/SqliteClient").SqliteClient, never, never>;
-export declare const migrationsLayer: Layer.Layer<never, import("effect/unstable/sql/SqlError").SqlError | import("@effect/sql-sqlite-bun/SqliteMigrator").MigrationError, import("effect/unstable/sql/SqlClient").SqlClient>;
-export declare const layer: (options: SqliteClientConfig) => Layer.Layer<import("effect/unstable/sql/SqlClient").SqlClient | import("@effect/sql-sqlite-bun/SqliteClient").SqliteClient, import("effect/unstable/sql/SqlError").SqlError | import("@effect/sql-sqlite-bun/SqliteMigrator").MigrationError, never>;
+import { SqlClient } from "effect/unstable/sql/SqlClient";
+export declare const clientLayer: (options: SqliteClientConfig) => Layer.Layer<SqlClient | import("@effect/sql-sqlite-bun/SqliteClient").SqliteClient, never, never>;
+export declare const migrationsLayer: Layer.Layer<never, import("effect/unstable/sql/SqlError").SqlError | import("@effect/sql-sqlite-bun/SqliteMigrator").MigrationError, SqlClient>;
+export declare const layer: (options: SqliteClientConfig) => Layer.Layer<SqlClient, import("effect/unstable/sql/SqlError").SqlError | import("@effect/sql-sqlite-bun/SqliteMigrator").MigrationError, never>;
+export declare const workflowLayer: <E, R>(options: SqliteClientConfig, handlersLayer: Layer.Layer<WorkflowDefinitionRuntime.HandlerService, E, R>) => Layer.Layer<SqlClient | WorkflowDefinitionRepository.Service | WorkflowDefinitionRuntime.HandlerService | WorkflowDefinitionRuntime.Service, unknown, Exclude<R, SqlClient | WorkflowDefinitionRepository.Service>>;
+export declare const childFanOutLayer: <E, R>(options: SqliteClientConfig, handlersLayer: Layer.Layer<ChildFanOutRuntime.HandlerService, E, R>) => Layer.Layer<ChildFanOutRuntime.Service, unknown, R>;

package/dist/types/relay/sqlite.d.ts

@@ -1,7 +1,7 @@
 export * as Client from "./client";
 export * as Operation from "./operation";
 export * as SQLite from "./sqlite-runtime";
-export { Address, Agent, Content, Entity, Envelope, Execution, Ids, Schedule, Shared, Skill, Tool, } from "../schema/index";
+export { Address, Agent, Content, Entity, Envelope, Execution, Ids, Schedule, Shared, Skill, Tool, Workflow, } from "../schema/index";
 export * as AddressBook from "../runtime/address/address-book-service";
 export * as AddressResolution from "../runtime/address/address-resolution-service";
 export * as AgentLoop from "../runtime/agent/agent-loop-service";
@@ -10,6 +10,7 @@ export * as ActivityVersionRegistry from "../runtime/workflow/activity-version-r
 export * as ArtifactStore from "../runtime/content/artifact-store-service";
 export * as BlobStore from "../runtime/content/blob-store-service";
 export * as ChildRunService from "../runtime/child/child-run-service";
+export * as ChildFanOutRuntime from "../runtime/child/child-fan-out-runtime";
 export * as EnvelopeService from "../runtime/envelope/envelope-service";
 export * as EventLog from "../runtime/execution/event-log-service";
 export * as ExecutionEntity from "../runtime/cluster/execution-entity";
@@ -24,4 +25,5 @@ export * as SchemaRegistry from "../runtime/schema-registry/schema-registry-serv
 export * as SkillRegistry from "../runtime/skill/skill-registry-service";
 export * as ToolRuntime from "../runtime/tool/tool-runtime-service";
 export * as WaitService from "../runtime/wait/wait-service";
+export * as WorkflowDefinitionRuntime from "../runtime/workflow/definition-runtime";
 export declare const relaySqlitePackage = "@relayfx/sdk/sqlite";

package/dist/types/runtime/child/child-fan-out-admission-service.d.ts

@@ -0,0 +1,30 @@
+import { ChildOrchestration, Execution, Ids } from "../../schema/index";
+import { ChildFanOutRepository } from "../../store-sql/portable";
+import { Context, Effect, Layer, Schema } from "effect";
+import { Service as ChildRunService, type AgentContext } from "./child-run-service";
+declare const ChildFanOutAdmissionError_base: Schema.Class<ChildFanOutAdmissionError, Schema.TaggedStruct<"ChildFanOutAdmissionError", {
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+export declare class ChildFanOutAdmissionError extends ChildFanOutAdmissionError_base {
+}
+export interface AdmitInput {
+    readonly fanOutId: Ids.ChildFanOutId;
+    readonly parent: AgentContext;
+    readonly eventSequence: Execution.ExecutionEventSequence;
+    readonly admittedAt: number;
+}
+export interface Interface {
+    readonly admit: (input: AdmitInput) => Effect.Effect<ReadonlyArray<Execution.ChildRunAccepted>, ChildFanOutAdmissionError>;
+    readonly recover: (input: AdmitInput) => Effect.Effect<ReadonlyArray<Execution.ChildRunAccepted>, ChildFanOutAdmissionError>;
+    readonly recoverAll: (inputFor: (fanOut: ChildOrchestration.FanOutState) => AdmitInput) => Effect.Effect<ReadonlyArray<Execution.ChildRunAccepted>, ChildFanOutAdmissionError>;
+}
+declare const Service_base: Context.ServiceClass<Service, "@relayfx/runtime/ChildFanOutAdmissionService", Interface>;
+export declare class Service extends Service_base {
+}
+export declare const layer: Layer.Layer<Service, never, ChildFanOutRepository.Service | ChildRunService>;
+export declare const memoryLayer: Layer.Layer<Service, never, never>;
+export declare const testLayer: (implementation: Interface) => Layer.Layer<Service, never, never>;
+export declare const admit: (input: AdmitInput) => Effect.Effect<readonly Execution.ChildRunAccepted[], ChildFanOutAdmissionError, Service>;
+export declare const recover: (input: AdmitInput) => Effect.Effect<readonly Execution.ChildRunAccepted[], ChildFanOutAdmissionError, Service>;
+export declare const recoverAll: (inputFor: (fanOut: ChildOrchestration.FanOutState) => AdmitInput) => Effect.Effect<readonly Execution.ChildRunAccepted[], ChildFanOutAdmissionError, Service>;
+export {};

package/dist/types/runtime/child/child-fan-out-runtime.d.ts

@@ -0,0 +1,34 @@
+import { ChildOrchestration, Content, Ids } from "../../schema/index";
+import { ChildFanOutRepository } from "../../store-sql/portable";
+import { Context, Effect, Layer, Schema } from "effect";
+import { Service as TransitionService } from "./child-fan-out-transition-service";
+export interface ChildResult {
+    readonly status: "completed" | "failed" | "cancelled";
+    readonly output: ReadonlyArray<Content.Part>;
+    readonly error?: string;
+    readonly completedAt?: number;
+}
+export interface Handlers {
+    readonly execute: (child: ChildOrchestration.FanOutChild, fanOut: ChildOrchestration.FanOutState, idempotencyKey: string) => Effect.Effect<ChildResult, unknown>;
+    readonly cancel: (childExecutionId: Ids.ChildExecutionId, reason: string) => Effect.Effect<void, unknown>;
+}
+declare const HandlerService_base: Context.ServiceClass<HandlerService, "@relayfx/runtime/ChildFanOutRuntimeHandlers", Handlers>;
+export declare class HandlerService extends HandlerService_base {
+}
+declare const ChildFanOutRuntimeError_base: Schema.Class<ChildFanOutRuntimeError, Schema.TaggedStruct<"ChildFanOutRuntimeError", {
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+export declare class ChildFanOutRuntimeError extends ChildFanOutRuntimeError_base {
+}
+export interface Interface {
+    readonly create: (definition: ChildOrchestration.FanOutDefinition) => Effect.Effect<ChildOrchestration.FanOutState, ChildFanOutRuntimeError>;
+    readonly recover: () => Effect.Effect<ReadonlyArray<Ids.ChildFanOutId>, ChildFanOutRuntimeError>;
+    readonly cancel: (fanOutId: Ids.ChildFanOutId, cancelledAt: number, reason: string) => Effect.Effect<ChildOrchestration.FanOutState | undefined, ChildFanOutRuntimeError>;
+    readonly inspect: (fanOutId: Ids.ChildFanOutId) => Effect.Effect<ChildOrchestration.FanOutState | undefined, ChildFanOutRuntimeError>;
+}
+declare const Service_base: Context.ServiceClass<Service, "@relayfx/runtime/ChildFanOutRuntime", Interface>;
+export declare class Service extends Service_base {
+}
+export declare const layer: Layer.Layer<Service, ChildFanOutRuntimeError, ChildFanOutRepository.Service | TransitionService | HandlerService>;
+export declare const testHandlersLayer: (handlers: Handlers) => Layer.Layer<HandlerService, never, never>;
+export {};

package/dist/types/runtime/child/child-fan-out-transition-service.d.ts

@@ -0,0 +1,25 @@
+import { Content, Ids } from "../../schema/index";
+import { ChildFanOutRepository } from "../../store-sql/portable";
+import { Context, Effect, Layer, Schema } from "effect";
+import { Service as EventLogService } from "../execution/event-log-service";
+declare const ChildFanOutTransitionError_base: Schema.Class<ChildFanOutTransitionError, Schema.TaggedStruct<"ChildFanOutTransitionError", {
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+export declare class ChildFanOutTransitionError extends ChildFanOutTransitionError_base {
+}
+export interface TerminalInput {
+    readonly childExecutionId: Ids.ChildExecutionId;
+    readonly status: "completed" | "failed" | "cancelled";
+    readonly output: ReadonlyArray<Content.Part>;
+    readonly error?: string;
+    readonly completedAt: number;
+}
+export interface Interface {
+    readonly terminal: (input: TerminalInput) => Effect.Effect<ChildFanOutRepository.RecordTerminalResult | undefined, ChildFanOutTransitionError>;
+}
+declare const Service_base: Context.ServiceClass<Service, "@relayfx/runtime/ChildFanOutTransitionService", Interface>;
+export declare class Service extends Service_base {
+}
+export declare const layer: Layer.Layer<Service, never, ChildFanOutRepository.Service | EventLogService>;
+export declare const terminal: (input: TerminalInput) => Effect.Effect<ChildFanOutRepository.RecordTerminalResult | undefined, ChildFanOutTransitionError, Service>;
+export {};

package/dist/types/runtime/cluster/execution-entity.d.ts

@@ -5,9 +5,11 @@ import type { WorkflowEngine } from "effect/unstable/workflow";
 import { Schema } from "effect";
 import type { Effect } from "effect";
 import { ExecutionWorkflowFailed, StartInput, StartResult } from "../workflow/execution-workflow";
+import type { Service as ActiveExecutionRegistryService } from "../execution/active-execution-registry";
 import type { Service as EventLogService } from "../execution/event-log-service";
-import type { Service as WaitServiceService } from "../wait/wait-service";
+import type { Service as ExecutionServiceService } from "../execution/execution-service";
 import type { Service as ToolTransitionCoordinatorService } from "../tool/tool-transition-coordinator";
+import type { Service as WaitServiceService } from "../wait/wait-service";
 export declare const Start: Rpc.Rpc<"start", typeof StartInput, typeof StartResult, typeof ExecutionWorkflowFailed>;
 export declare const SignalWait: Rpc.Rpc<"signalWait", Schema.Struct<{
     readonly workflow_execution_id: Schema.String;
@@ -32,6 +34,6 @@ export declare const Cancel: Rpc.Rpc<"cancel", Schema.Struct<{
 }>, typeof ExecutionWorkflowFailed, never, never>;
 type ExecutionRpc = typeof Start | typeof Dispatch | typeof SignalWait | typeof Cancel;
 export declare const entity: Entity.Entity<"Relay/Execution", ExecutionRpc>;
-export declare const layer: import("effect/Layer").Layer<never, never, ChildExecutionRepository.Service | EnvelopeRepository.Service | ExecutionRepository.Service | ToolCallRepository.Service | EventLogService | WaitServiceService | ToolTransitionCoordinatorService | WorkflowEngine.WorkflowEngine | import("effect/unstable/cluster/Sharding").Sharding>;
+export declare const layer: import("effect/Layer").Layer<never, never, ChildExecutionRepository.Service | EnvelopeRepository.Service | ExecutionRepository.Service | ToolCallRepository.Service | EventLogService | WaitServiceService | ExecutionServiceService | ActiveExecutionRegistryService | ToolTransitionCoordinatorService | WorkflowEngine.WorkflowEngine | import("effect/unstable/cluster/Sharding").Sharding>;
 export declare const client: Effect.Effect<(entityId: string) => import("effect/unstable/rpc/RpcClient").RpcClient.From<ExecutionRpc, import("effect/unstable/cluster/ClusterError").MailboxFull | import("effect/unstable/cluster/ClusterError").AlreadyProcessingMessage | import("effect/unstable/cluster/ClusterError").PersistenceError>, never, import("effect/unstable/cluster/Sharding").Sharding>;
 export {};

package/dist/types/runtime/execution/active-execution-registry.d.ts

@@ -0,0 +1,12 @@
+import { Ids } from "../../schema/index";
+import { Context, Effect, Layer } from "effect";
+export interface Interface {
+    readonly run: <A, E, R>(executionId: Ids.ExecutionId, effect: Effect.Effect<A, E, R>) => Effect.Effect<A, E, R>;
+    readonly interrupt: (executionId: Ids.ExecutionId) => Effect.Effect<boolean>;
+}
+declare const Service_base: Context.ServiceClass<Service, "@relayfx/runtime/ActiveExecutionRegistry", Interface>;
+export declare class Service extends Service_base {
+}
+export declare const layer: Layer.Layer<Service, never, never>;
+export declare const testLayer: Layer.Layer<Service, never, never>;
+export {};

package/dist/types/runtime/execution/execution-service.d.ts

@@ -41,6 +41,7 @@ export interface CancelInput {
     readonly eventSequence: Execution.ExecutionEventSequence;
     readonly cancelledAt: number;
     readonly reason?: string;
+    readonly metadata?: Shared.Metadata;
 }
 export interface Interface {
     readonly accept: (input: AcceptInput) => Effect.Effect<Execution.Execution, ExecutionServiceError>;

package/dist/types/runtime/index.d.ts

@@ -5,6 +5,9 @@ export * as AgentRegistry from "./agent/agent-registry-service";
 export * as ArtifactStore from "./content/artifact-store-service";
 export * as BlobStore from "./content/blob-store-service";
 export * as ChildRunService from "./child/child-run-service";
+export * as ChildFanOutAdmission from "./child/child-fan-out-admission-service";
+export * as ChildFanOutTransition from "./child/child-fan-out-transition-service";
+export * as ChildFanOutRuntime from "./child/child-fan-out-runtime";
 export * as SpawnChildRunTool from "./child/spawn-child-run-tool";
 export * as ExecutionEntity from "./cluster/execution-entity";
 export * as EnvelopeService from "./envelope/envelope-service";
@@ -16,6 +19,7 @@ export * as PublishToTopicTool from "./topic/publish-to-topic-tool";
 export * as SendMessageTool from "./inbox/send-message-tool";
 export * as WaitForMessagesTool from "./inbox/wait-for-messages-tool";
 export * as EventLog from "./execution/event-log-service";
+export * as ActiveExecutionRegistry from "./execution/active-execution-registry";
 export * as ExecutionWatch from "./execution/execution-watch-service";
 export * as ExecutionService from "./execution/execution-service";
 export * as SessionStream from "./execution/session-stream-service";
@@ -47,5 +51,6 @@ export * as WorkspacePlanner from "./workspace/workspace-planner-service";
 export * as WorkspaceProvider from "./workspace/workspace-provider-service";
 export * as WorkspaceRuntime from "./workspace/workspace-runtime-service";
 export * as ExecutionWorkflow from "./workflow/execution-workflow";
+export * as WorkflowDefinitionRuntime from "./workflow/definition-runtime";
 export * as ActivityVersionRegistry from "./workflow/activity-version-registry";
 export declare const runtimePackage = "./index";