@rigkit/engine 0.2.7 → 0.2.8

package/src/index.ts

@@ -10,6 +10,13 @@ export type {
   EngineOperationKind,
   EngineOperationSource,
   EngineOperationSummary,
+  EngineCacheClearResult,
+  EngineCacheClearScope,
+  EngineCacheEntry,
+  EngineCacheList,
+  EngineCacheScope,
+  GlobalFragmentStateLocationInput,
+  GlobalFragmentStateLocator,
   InteractionPresenter,
   InteractionPresentationRequest,
 } from "./engine.ts";

package/src/state.ts

@@ -60,6 +60,11 @@ export interface StateService {
     upstreamRunIds: readonly string[];
   }): WorkflowNodeRunRecord | undefined;
   saveNodeRun(run: WorkflowNodeRunRecord): void;
+  clearNodeRuns(input?: {
+    workflow?: string;
+    nodePaths?: readonly string[];
+  }): number;
+  deleteNodeRunsById(ids: readonly string[]): number;
   invalidateNodeRuns(input: {
     workflow: string;
     nodePaths: readonly string[];
@@ -174,6 +179,37 @@ export class StateStore implements StateService {
     this.db.insert(workflowNodeRuns).values(run).run();
   }
 
+  clearNodeRuns(input: {
+    workflow?: string;
+    nodePaths?: readonly string[];
+  } = {}): number {
+    const nodePaths = input.nodePaths ? new Set(input.nodePaths) : undefined;
+    const rows = this.db
+      .select({ id: workflowNodeRuns.id, workflow: workflowNodeRuns.workflow, nodePath: workflowNodeRuns.nodePath })
+      .from(workflowNodeRuns)
+      .all()
+      .filter((row) =>
+        (input.workflow === undefined || row.workflow === input.workflow) &&
+        (nodePaths === undefined || nodePaths.has(row.nodePath))
+      );
+
+    for (const row of rows) {
+      this.db.delete(workflowNodeRuns).where(eq(workflowNodeRuns.id, row.id)).run();
+    }
+
+    return rows.length;
+  }
+
+  deleteNodeRunsById(ids: readonly string[]): number {
+    if (ids.length === 0) return 0;
+    let deleted = 0;
+    for (const id of ids) {
+      this.db.delete(workflowNodeRuns).where(eq(workflowNodeRuns.id, id)).run();
+      deleted += 1;
+    }
+    return deleted;
+  }
+
   invalidateNodeRuns(input: {
     workflow: string;
     nodePaths: readonly string[];

package/src/types.ts

@@ -95,7 +95,7 @@ export type LocalCommandResult = {
   stderr: string | null;
 };
 
-export type WorkflowLogStream = "stdout" | "stderr" | "info";
+export type WorkflowLogStream = "stdout" | "stderr" | "info" | "debug" | "warn";
 
 export type WorkflowProviderDefinition<
   ProviderId extends string = string,
@@ -139,7 +139,6 @@ export type WorkflowRuntimeHelpers = {
   readonly workflow: string;
   readonly nodePath: string;
   metadata(metadata: JsonObject): void;
-  log(data: string, options?: { stream?: WorkflowLogStream; label?: string }): void;
 };
 
 export const STEP_INVALIDATION_KIND = "rigkit.step.invalidate" as const;
@@ -166,9 +165,11 @@ export type WorkflowTaskRuntime<
   Providers extends WorkflowProviderMap,
   Context extends JsonObject,
   PreviousTaskIds extends string = string,
+  Config extends JsonObject = JsonObject,
 > = ProviderRuntimeMap<Providers> & {
   readonly providers: ProviderRuntimeMap<Providers>;
   readonly step: WorkflowStepRuntime<Context, PreviousTaskIds>;
+  readonly config: Readonly<Config>;
 };
 
 export type WorkflowTaskResult =
@@ -182,7 +183,8 @@ export type WorkflowTaskHandler<
   Context extends JsonObject,
   PreviousTaskIds extends string = string,
   Result extends WorkflowTaskResult = WorkflowTaskResult,
-> = (context: WorkflowTaskRuntime<Providers, Context, PreviousTaskIds>) => MaybePromise<Result>;
+  Config extends JsonObject = JsonObject,
+> = (context: WorkflowTaskRuntime<Providers, Context, PreviousTaskIds, Config>) => MaybePromise<Result>;
 
 export type WorkflowInputFieldKind = "workspace" | "string" | "boolean" | "number";
 
@@ -424,6 +426,7 @@ export type WorkflowTaskCacheTTL =
     };
 
 export type WorkflowNodeKind = "task" | "sequence" | "parallel";
+export type WorkflowCacheScope = "local" | "global";
 
 export type WorkflowDefinition<
   Name extends string = string,
@@ -490,6 +493,8 @@ export type WorkflowNodeDefinition<
   readonly nodeKind: WorkflowNodeKind;
   readonly name: string;
   readonly workflow: WorkflowDefinition<string, Providers>;
+  readonly cacheScope?: WorkflowCacheScope;
+  readonly config?: JsonObject;
   readonly workspaceDefinition?: WorkflowWorkspaceDefinition<Providers, OutputContext>;
   readonly operations?: readonly WorkflowOperationDefinition<Providers, any>[];
   readonly workspaceOperations?: readonly WorkflowWorkspaceOperationDefinition<Providers, OutputContext, any, any>[];
@@ -502,10 +507,17 @@ export type WorkflowTaskNode<
   Providers extends WorkflowProviderMap,
   InputContext extends JsonObject,
   OutputContext extends JsonObject,
+  Config extends JsonObject = {},
 > = WorkflowNodeDefinition<Providers, InputContext, OutputContext> & {
   readonly nodeKind: "task";
   readonly options?: WorkflowTaskOptions;
-  readonly handler: WorkflowTaskHandler<Providers, InputContext, string, any>;
+  readonly handler: WorkflowTaskHandler<Providers, InputContext, string, any, Config>;
+
+  global(): WorkflowTaskNode<Providers, InputContext, OutputContext, Config>;
+  local(): WorkflowTaskNode<Providers, InputContext, OutputContext, Config>;
+  configure<const NextConfig extends JsonObject>(
+    config: NextConfig,
+  ): WorkflowTaskNode<Providers, InputContext, OutputContext, Merge<Config, NextConfig>>;
 };
 
 export type WorkflowSequenceBuilder<
@@ -516,13 +528,14 @@ export type WorkflowSequenceBuilder<
   OperationIds extends string = never,
   WorkspaceOperationIds extends string = never,
   PreviousTaskIds extends string = never,
+  Config extends JsonObject = {},
 > = WorkflowNodeDefinition<Providers, InputContext, OutputContext> & {
   readonly nodeKind: "sequence";
   readonly children: readonly WorkflowNodeDefinition<Providers, any, any>[];
 
   task<const Id extends string, Result extends WorkflowTaskResult>(
     name: Id & WorkflowTaskIdConstraint<Id, PreviousTaskIds>,
-    handler: WorkflowTaskHandler<Providers, OutputContext, PreviousTaskIds, Result>,
+    handler: WorkflowTaskHandler<Providers, OutputContext, PreviousTaskIds, Result, Config>,
   ): WorkflowSequenceBuilder<
     Providers,
     InputContext,
@@ -530,7 +543,8 @@ export type WorkflowSequenceBuilder<
     WorkspaceData,
     OperationIds,
     WorkspaceOperationIds,
-    PreviousTaskIds | Id
+    PreviousTaskIds | Id,
+    Config
   >;
 
   task<
@@ -540,7 +554,7 @@ export type WorkflowSequenceBuilder<
   >(
     name: Id & WorkflowTaskIdConstraint<Id, PreviousTaskIds>,
     options: WorkflowTaskOptions<OutputSchemaValue<Schema>>,
-    handler: WorkflowTaskHandler<Providers, OutputContext, PreviousTaskIds, Awaited<Result> & WorkflowTaskResult>,
+    handler: WorkflowTaskHandler<Providers, OutputContext, PreviousTaskIds, Awaited<Result> & WorkflowTaskResult, Config>,
   ): WorkflowSequenceBuilder<
     Providers,
     InputContext,
@@ -548,12 +562,13 @@ export type WorkflowSequenceBuilder<
     WorkspaceData,
     OperationIds,
     WorkspaceOperationIds,
-    PreviousTaskIds | Id
+    PreviousTaskIds | Id,
+    Config
   >;
 
   step<const Id extends string, Result extends WorkflowTaskResult>(
     name: Id & WorkflowTaskIdConstraint<Id, PreviousTaskIds>,
-    handler: WorkflowTaskHandler<Providers, OutputContext, PreviousTaskIds, Result>,
+    handler: WorkflowTaskHandler<Providers, OutputContext, PreviousTaskIds, Result, Config>,
   ): WorkflowSequenceBuilder<
     Providers,
     InputContext,
@@ -561,7 +576,8 @@ export type WorkflowSequenceBuilder<
     WorkspaceData,
     OperationIds,
     WorkspaceOperationIds,
-    PreviousTaskIds | Id
+    PreviousTaskIds | Id,
+    Config
   >;
 
   step<
@@ -571,7 +587,7 @@ export type WorkflowSequenceBuilder<
   >(
     name: Id & WorkflowTaskIdConstraint<Id, PreviousTaskIds>,
     options: WorkflowTaskOptions<OutputSchemaValue<Schema>>,
-    handler: WorkflowTaskHandler<Providers, OutputContext, PreviousTaskIds, Awaited<Result> & WorkflowTaskResult>,
+    handler: WorkflowTaskHandler<Providers, OutputContext, PreviousTaskIds, Awaited<Result> & WorkflowTaskResult, Config>,
   ): WorkflowSequenceBuilder<
     Providers,
     InputContext,
@@ -579,7 +595,8 @@ export type WorkflowSequenceBuilder<
     WorkspaceData,
     OperationIds,
     WorkspaceOperationIds,
-    PreviousTaskIds | Id
+    PreviousTaskIds | Id,
+    Config
   >;
 
   add<Node extends WorkflowNodeDefinition<Providers, any, any>>(
@@ -591,7 +608,8 @@ export type WorkflowSequenceBuilder<
     WorkspaceData,
     OperationIds,
     WorkspaceOperationIds,
-    PreviousTaskIds
+    PreviousTaskIds,
+    Config
   >;
 
   parallel<const Branches extends Record<string, WorkflowNodeDefinition<Providers, any, any>>>(
@@ -607,7 +625,8 @@ export type WorkflowSequenceBuilder<
     WorkspaceData,
     OperationIds,
     WorkspaceOperationIds,
-    PreviousTaskIds
+    PreviousTaskIds,
+    Config
   >;
 
   workspace<Data extends JsonObject>(
@@ -619,7 +638,8 @@ export type WorkflowSequenceBuilder<
     ReadonlyWorkspaceContext<Data>,
     OperationIds,
     WorkspaceOperationIds,
-    PreviousTaskIds
+    PreviousTaskIds,
+    Config
   >;
 
   operation<const Id extends string, Input extends object = {}>(
@@ -632,7 +652,8 @@ export type WorkflowSequenceBuilder<
     WorkspaceData,
     OperationIds | Id,
     WorkspaceOperationIds,
-    PreviousTaskIds
+    PreviousTaskIds,
+    Config
   >;
 
   workspaceOperation<const Id extends string, Input extends object = {}>(
@@ -645,7 +666,41 @@ export type WorkflowSequenceBuilder<
     WorkspaceData,
     OperationIds,
     WorkspaceOperationIds | Id,
-    PreviousTaskIds
+    PreviousTaskIds,
+    Config
+  >;
+
+  global(): WorkflowSequenceBuilder<
+    Providers,
+    InputContext,
+    OutputContext,
+    WorkspaceData,
+    OperationIds,
+    WorkspaceOperationIds,
+    PreviousTaskIds,
+    Config
+  >;
+
+  local(): WorkflowSequenceBuilder<
+    Providers,
+    InputContext,
+    OutputContext,
+    WorkspaceData,
+    OperationIds,
+    WorkspaceOperationIds,
+    PreviousTaskIds,
+    Config
+  >;
+
+  configure<const NextConfig extends JsonObject>(config: NextConfig): WorkflowSequenceBuilder<
+    Providers,
+    InputContext,
+    OutputContext,
+    WorkspaceData,
+    OperationIds,
+    WorkspaceOperationIds,
+    PreviousTaskIds,
+    Merge<Config, NextConfig>
   >;
 };
 
@@ -804,7 +859,14 @@ export type WorkflowEvent =
       title: string;
     }
   | { type: "artifact.created"; nodePath: string; providerId: string; kind: string; ref: JsonValue }
-  | { type: "workspace.ready"; workspaceId: string };
+  | { type: "workflow.apply.started"; workflow: string }
+  | { type: "workflow.apply.completed"; workflow: string; nodeCount: number; cachedNodeCount: number; durationMs: number }
+  | { type: "workspace.create.started"; workspaceName: string }
+  | { type: "workspace.ready"; workspaceId: string }
+  | { type: "workspace.remove.started"; workspaceName: string }
+  | { type: "workspace.remove.completed"; workspaceName: string }
+  | { type: "workspace.operation.started"; workspaceName: string; operationId: string }
+  | { type: "workspace.operation.completed"; workspaceName: string; operationId: string };
 
 export type DevMachineEvent = WorkflowEvent;
 

package/src/version.ts

@@ -1 +1 @@
-export const RIGKIT_ENGINE_VERSION = "0.2.7";
+export const RIGKIT_ENGINE_VERSION = "0.2.8";