@rigkit/engine 0.2.1 → 0.2.3

package/src/provider/types.ts

@@ -7,8 +7,6 @@ import type {
   LoadedProviderDefinition,
   LocalWorkspaceRuntime,
   MaybePromise,
-  ProviderWorkspaceContext,
-  WorkspaceRecord,
 } from "../types.ts";
 
 export type VmHandle = {
@@ -33,9 +31,7 @@ export type SshConnection = {
   command: string;
 };
 
-export interface BaseDevMachineProvider<
-  WorkspaceContext extends ProviderWorkspaceContext = ProviderWorkspaceContext,
-> {
+export interface BaseDevMachineProvider {
   readonly providerId: string;
   createVm(): Promise<VmHandle>;
   createVmFromSnapshot(input: { snapshotId: string }): Promise<VmHandle>;
@@ -44,7 +40,6 @@ export interface BaseDevMachineProvider<
   writeFile(vm: VmHandle, path: string, content: string): Promise<void>;
   snapshot(vm: VmHandle): Promise<SnapshotHandle>;
   ssh(vm: VmHandle, options?: SshOptions): Promise<SshConnection>;
-  workspaceContext?(vm: VmHandle, input: { workspace: WorkspaceRecord }): MaybePromise<WorkspaceContext>;
   deleteVm(vm: VmHandle): Promise<void>;
 }
 
@@ -78,33 +73,10 @@ export type ProviderRuntimeContext = {
   metadata(metadata: JsonObject): void;
 };
 
-export type WorkflowWorkspaceCreateResult = {
-  providerId?: string;
-  resourceId: string;
-  snapshotId?: string;
-  sourceRef?: JsonValue;
-  metadata?: JsonObject;
-};
-
-export interface WorkflowWorkspaceProvider<
-  WorkspaceContext extends ProviderWorkspaceContext = ProviderWorkspaceContext,
-> {
-  canUse(sourceRef: JsonValue): boolean;
-  createWorkspace(sourceRef: JsonValue, input: { name: string }): Promise<WorkflowWorkspaceCreateResult>;
-  deleteWorkspace(workspace: WorkspaceRecord): Promise<void>;
-  snapshotWorkspace(workspace: WorkspaceRecord): Promise<WorkflowWorkspaceCreateResult>;
-  ssh(workspaceOrResourceId: string, options?: SshOptions): Promise<SshConnection>;
-  workspaceContext?(workspace: WorkspaceRecord): MaybePromise<WorkspaceContext>;
-}
-
-export interface WorkflowProviderController<
-  Runtime = unknown,
-  WorkspaceContext extends ProviderWorkspaceContext = ProviderWorkspaceContext,
-> {
+export interface WorkflowProviderController<Runtime = unknown> {
   readonly providerId: string;
   runtime(context: ProviderRuntimeContext): MaybePromise<Runtime>;
   validateArtifact?(ref: JsonValue): MaybePromise<boolean>;
-  workspace?: WorkflowWorkspaceProvider<WorkspaceContext>;
 }
 
 export type ProviderFactoryInput = {

package/src/state.ts

@@ -1,5 +1,5 @@
 import { join } from "node:path";
-import { and, asc, desc, eq, or } from "drizzle-orm";
+import { and, asc, desc, eq } from "drizzle-orm";
 import type { ProviderStorage, ProviderStorageRecord } from "./provider/types.ts";
 import type { JsonValue, WorkspaceRecord } from "./types.ts";
 import {
@@ -96,7 +96,7 @@ export class StateStore implements StateService {
     const row = this.db
       .select()
       .from(workspaces)
-      .where(or(eq(workspaces.name, nameOrResourceId), eq(workspaces.resourceId, nameOrResourceId)))
+      .where(eq(workspaces.name, nameOrResourceId))
       .get();
     return row ? toWorkspaceRecord(row) : undefined;
   }
@@ -114,14 +114,10 @@ export class StateStore implements StateService {
         target: workspaces.name,
         set: {
           id: workspace.id,
-          providerId: workspace.providerId,
           workflow: workspace.workflow,
-          resourceId: workspace.resourceId,
-          snapshotId: workspace.snapshotId,
-          sourceRef: workspace.sourceRef,
-          context: workspace.context,
+          workflowCtx: workspace.workflowCtx,
           updatedAt: workspace.updatedAt,
-          metadata: workspace.metadata,
+          ctx: workspace.ctx,
         },
       })
       .run();
@@ -218,15 +214,11 @@ function toWorkspaceRecord(row: typeof workspaces.$inferSelect): WorkspaceRecord
   return {
     id: row.id,
     name: row.name,
-    providerId: row.providerId,
     workflow: row.workflow,
-    resourceId: row.resourceId,
-    snapshotId: row.snapshotId ?? undefined,
-    sourceRef: row.sourceRef,
-    context: row.context,
+    workflowCtx: row.workflowCtx,
     createdAt: row.createdAt,
     updatedAt: row.updatedAt,
-    metadata: row.metadata,
+    ctx: row.ctx,
   };
 }
 

package/src/types.ts

@@ -52,8 +52,6 @@ export type CommandOptions = ExecOptions & {
   name?: string;
 };
 
-export type ProviderWorkspaceContext = object;
-
 export type LocalWorkspaceRuntime = {
   open(target: string): MaybePromise<void>;
   command?(input: LocalCommandRequest): MaybePromise<LocalCommandResult>;
@@ -94,22 +92,19 @@ export type WorkflowProviderDefinition<
   ProviderId extends string = string,
   Config extends object = Record<string, unknown>,
   Runtime = unknown,
-  WorkspaceContext extends ProviderWorkspaceContext = ProviderWorkspaceContext,
 > = {
   readonly kind: "rigkit.provider";
   readonly providerId: ProviderId;
   readonly config: ResolvableObject<Config>;
   readonly plugin?: unknown;
   readonly __runtime?: Runtime;
-  readonly __workspaceContext?: WorkspaceContext;
 };
 
 export type DevProviderDefinition<
   ProviderId extends string = string,
   Config extends object = Record<string, unknown>,
   Runtime = unknown,
-  WorkspaceContext extends ProviderWorkspaceContext = ProviderWorkspaceContext,
-> = WorkflowProviderDefinition<ProviderId, Config, Runtime, WorkspaceContext>;
+> = WorkflowProviderDefinition<ProviderId, Config, Runtime>;
 
 export type LoadedProviderDefinition<
   ProviderId extends string = string,
@@ -120,18 +115,13 @@ export type LoadedProviderDefinition<
   plugin?: unknown;
 };
 
-export type WorkflowProviderMap = Record<string, WorkflowProviderDefinition<string, any, any, any>>;
+export type WorkflowProviderMap = Record<string, WorkflowProviderDefinition<string, any, any>>;
 
 export type ProviderRuntimeOf<Provider> =
-  Provider extends WorkflowProviderDefinition<any, any, infer Runtime, any>
+  Provider extends WorkflowProviderDefinition<any, any, infer Runtime>
     ? Runtime
     : never;
 
-export type ProviderWorkspaceContextOf<Provider> =
-  Provider extends WorkflowProviderDefinition<any, any, any, infer WorkspaceContext extends ProviderWorkspaceContext>
-    ? WorkspaceContext
-    : ProviderWorkspaceContext;
-
 export type ProviderRuntimeMap<Providers extends WorkflowProviderMap> = {
   readonly [Key in keyof Providers]: ProviderRuntimeOf<Providers[Key]>;
 };
@@ -160,32 +150,6 @@ export type WorkflowTaskHandler<
   Result extends WorkflowTaskResult = WorkflowTaskResult,
 > = (context: WorkflowTaskRuntime<Providers, Context>) => MaybePromise<Result>;
 
-export type WorkflowCreateRuntime<
-  Providers extends WorkflowProviderMap,
-  Context extends JsonObject,
-> = ProviderRuntimeMap<Providers> & {
-  readonly ctx: Readonly<Context>;
-  readonly name: string;
-  readonly providers: ProviderRuntimeMap<Providers>;
-  readonly local: LocalWorkspaceRuntime;
-  readonly workflow: string;
-};
-
-export type WorkflowCreateResult = JsonObject;
-
-export type WorkflowCreateHandler<
-  Providers extends WorkflowProviderMap,
-  Context extends JsonObject,
-  Result extends WorkflowCreateResult = WorkflowCreateResult,
-> = (context: WorkflowCreateRuntime<Providers, Context>) => MaybePromise<Result>;
-
-export type WorkflowCreateDefinition<
-  Providers extends WorkflowProviderMap = WorkflowProviderMap,
-  Context extends JsonObject = JsonObject,
-> = {
-  readonly handler: WorkflowCreateHandler<Providers, Context, any>;
-};
-
 export type WorkflowInputFieldKind = "workspace" | "string" | "boolean" | "number";
 
 export type WorkflowInputFieldDefinition<Value = unknown> = {
@@ -199,9 +163,7 @@ export type WorkflowInputFieldDefinition<Value = unknown> = {
 };
 
 export type WorkflowOperationWorkspaceInput<Name extends string> = {
-  [Key in Name]: WorkspaceRuntimeRecord & {
-    data: Record<string, JsonValue>;
-  };
+  [Key in Name]: WorkspaceRuntimeRecord;
 };
 
 export type WorkflowInputShape = Record<string, WorkflowInputFieldDefinition<any>>;
@@ -272,25 +234,84 @@ export type WorkflowOperationHandler<
   Result extends WorkflowOperationResult = WorkflowOperationResult,
 > = (context: WorkflowOperationRuntime<Providers, Input>) => MaybePromise<Result>;
 
-export type WorkflowHostMethodRequirement = {
-  readonly id: string;
-  readonly modes?: readonly string[];
+export type WorkflowRuntimeContext<Context extends JsonObject> = {
+  readonly name: string;
+  readonly ctx: Readonly<Context>;
 };
 
-export type WorkflowHostCapabilityRequirement = {
-  readonly id: string;
-  readonly schemaHash?: string;
+export type ReadonlyWorkspaceContext<Context extends JsonObject> = {
+  readonly [Key in keyof Context]: Context[Key];
+};
+
+export type WorkspaceCreateRuntimeRecord = {
+  readonly name: string;
 };
 
+export type WorkspaceRuntimeRecord<Context extends object = JsonObject> = {
+  readonly name: string;
+  readonly ctx: Context;
+};
+
+export type WorkflowWorkspaceCreateRuntime<
+  Providers extends WorkflowProviderMap,
+  Context extends JsonObject,
+> = ProviderRuntimeMap<Providers> & {
+  readonly workflow: WorkflowRuntimeContext<Context>;
+  readonly workspace: WorkspaceCreateRuntimeRecord;
+  readonly providers: ProviderRuntimeMap<Providers>;
+  readonly local: LocalWorkspaceRuntime;
+};
+
+export type WorkflowWorkspaceCreateHandler<
+  Providers extends WorkflowProviderMap,
+  Context extends JsonObject,
+  Data extends JsonObject,
+> = (context: WorkflowWorkspaceCreateRuntime<Providers, Context>) => MaybePromise<Data>;
+
+export type WorkflowWorkspaceRemoveRuntime<
+  Providers extends WorkflowProviderMap,
+  Context extends JsonObject,
+  Data extends JsonObject,
+> = ProviderRuntimeMap<Providers> & {
+  readonly workflow: WorkflowRuntimeContext<Context>;
+  readonly workspace: WorkspaceRuntimeRecord<ReadonlyWorkspaceContext<Data>>;
+  readonly providers: ProviderRuntimeMap<Providers>;
+  readonly local: LocalWorkspaceRuntime;
+};
+
+export type WorkflowWorkspaceRemoveHandler<
+  Providers extends WorkflowProviderMap,
+  Context extends JsonObject,
+  Data extends JsonObject,
+> = (context: WorkflowWorkspaceRemoveRuntime<Providers, Context, Data>) => MaybePromise<void>;
+
+export type WorkflowWorkspaceOperationRuntime<
+  Providers extends WorkflowProviderMap,
+  Context extends JsonObject,
+  Data extends object,
+  Input extends object,
+> = ProviderRuntimeMap<Providers> & {
+  readonly workflow: WorkflowRuntimeContext<Context>;
+  readonly input: Readonly<Input>;
+  readonly workspace: WorkspaceRuntimeRecord<Data>;
+  readonly providers: ProviderRuntimeMap<Providers>;
+  readonly local: LocalWorkspaceRuntime;
+};
+
+export type WorkflowWorkspaceOperationHandler<
+  Providers extends WorkflowProviderMap,
+  Context extends JsonObject,
+  Data extends object,
+  Input extends object,
+  Result extends WorkflowOperationResult = WorkflowOperationResult,
+> = (context: WorkflowWorkspaceOperationRuntime<Providers, Context, Data, Input>) => MaybePromise<Result>;
+
 export type WorkflowOperationOptions<
   Providers extends WorkflowProviderMap,
   Input extends object = {},
 > = {
   title?: string;
   description?: string;
-  createsWorkspace?: boolean;
-  requiredHostMethods?: readonly WorkflowHostMethodRequirement[];
-  requiredHostCapabilities?: readonly WorkflowHostCapabilityRequirement[];
   input?: WorkflowOperationInputBuilder<Input> | ((workflow: WorkflowOperationInputHelpers) => WorkflowOperationInputBuilder<Input>);
   run: WorkflowOperationHandler<Providers, Input>;
 };
@@ -302,13 +323,35 @@ export type WorkflowOperationDefinition<
   readonly id: string;
   readonly title?: string;
   readonly description?: string;
-  readonly createsWorkspace?: boolean;
-  readonly requiredHostMethods?: readonly WorkflowHostMethodRequirement[];
-  readonly requiredHostCapabilities?: readonly WorkflowHostCapabilityRequirement[];
   readonly input?: WorkflowOperationInputBuilder<Input>;
   readonly run: WorkflowOperationHandler<Providers, Input>;
 };
 
+export type WorkflowWorkspaceOperationOptions<
+  Providers extends WorkflowProviderMap,
+  Context extends JsonObject,
+  Data extends object,
+  Input extends object = {},
+> = {
+  title?: string;
+  description?: string;
+  input?: WorkflowOperationInputBuilder<Input> | ((workflow: WorkflowOperationInputHelpers) => WorkflowOperationInputBuilder<Input>);
+  run: WorkflowWorkspaceOperationHandler<Providers, Context, Data, Input>;
+};
+
+export type WorkflowWorkspaceOperationDefinition<
+  Providers extends WorkflowProviderMap = WorkflowProviderMap,
+  Context extends JsonObject = JsonObject,
+  Data extends object = JsonObject,
+  Input extends object = object,
+> = {
+  readonly id: string;
+  readonly title?: string;
+  readonly description?: string;
+  readonly input?: WorkflowOperationInputBuilder<Input>;
+  readonly run: WorkflowWorkspaceOperationHandler<Providers, Context, Data, Input>;
+};
+
 export type OutputSchema<Output extends JsonObject = JsonObject> =
   | { parse(value: unknown): Output }
   | {
@@ -389,8 +432,8 @@ export type WorkflowNodeDefinition<
   readonly name: string;
   readonly workflow: WorkflowDefinition<string, Providers>;
   readonly workspaceDefinition?: WorkflowWorkspaceDefinition<Providers, OutputContext>;
-  readonly createDefinition?: WorkflowCreateDefinition<Providers, OutputContext>;
   readonly operations?: readonly WorkflowOperationDefinition<Providers, any>[];
+  readonly workspaceOperations?: readonly WorkflowWorkspaceOperationDefinition<Providers, OutputContext, any, any>[];
   readonly __providers?: Providers;
   readonly __input?: InputContext;
   readonly __output?: OutputContext;
@@ -410,6 +453,9 @@ export type WorkflowSequenceBuilder<
   Providers extends WorkflowProviderMap,
   InputContext extends JsonObject,
   OutputContext extends JsonObject,
+  WorkspaceData extends object = JsonObject,
+  OperationIds extends string = never,
+  WorkspaceOperationIds extends string = never,
 > = WorkflowNodeDefinition<Providers, InputContext, OutputContext> & {
   readonly nodeKind: "sequence";
   readonly children: readonly WorkflowNodeDefinition<Providers, any, any>[];
@@ -417,28 +463,63 @@ export type WorkflowSequenceBuilder<
   task<Result extends WorkflowTaskResult>(
     name: string,
     handler: WorkflowTaskHandler<Providers, OutputContext, Result>,
-  ): WorkflowSequenceBuilder<Providers, InputContext, Merge<OutputContext, TaskReturnContext<Result>>>;
+  ): WorkflowSequenceBuilder<
+    Providers,
+    InputContext,
+    Merge<OutputContext, TaskReturnContext<Result>>,
+    WorkspaceData,
+    OperationIds,
+    WorkspaceOperationIds
+  >;
 
   task<Schema extends OutputSchema<JsonObject>, Result extends MaybePromise<OutputSchemaValue<Schema> | void>>(
     name: string,
     options: WorkflowTaskOptions<OutputSchemaValue<Schema>>,
     handler: WorkflowTaskHandler<Providers, OutputContext, Awaited<Result> & WorkflowTaskResult>,
-  ): WorkflowSequenceBuilder<Providers, InputContext, Merge<OutputContext, TaskReturnContext<Result>>>;
+  ): WorkflowSequenceBuilder<
+    Providers,
+    InputContext,
+    Merge<OutputContext, TaskReturnContext<Result>>,
+    WorkspaceData,
+    OperationIds,
+    WorkspaceOperationIds
+  >;
 
   step<Result extends WorkflowTaskResult>(
     name: string,
     handler: WorkflowTaskHandler<Providers, OutputContext, Result>,
-  ): WorkflowSequenceBuilder<Providers, InputContext, Merge<OutputContext, TaskReturnContext<Result>>>;
+  ): WorkflowSequenceBuilder<
+    Providers,
+    InputContext,
+    Merge<OutputContext, TaskReturnContext<Result>>,
+    WorkspaceData,
+    OperationIds,
+    WorkspaceOperationIds
+  >;
 
   step<Schema extends OutputSchema<JsonObject>, Result extends MaybePromise<OutputSchemaValue<Schema> | void>>(
     name: string,
     options: WorkflowTaskOptions<OutputSchemaValue<Schema>>,
     handler: WorkflowTaskHandler<Providers, OutputContext, Awaited<Result> & WorkflowTaskResult>,
-  ): WorkflowSequenceBuilder<Providers, InputContext, Merge<OutputContext, TaskReturnContext<Result>>>;
+  ): WorkflowSequenceBuilder<
+    Providers,
+    InputContext,
+    Merge<OutputContext, TaskReturnContext<Result>>,
+    WorkspaceData,
+    OperationIds,
+    WorkspaceOperationIds
+  >;
 
   add<Node extends WorkflowNodeDefinition<Providers, any, any>>(
     node: OutputContext extends WorkflowNodeInput<Node> ? Node : never,
-  ): WorkflowSequenceBuilder<Providers, InputContext, Merge<OutputContext, WorkflowNodeOutput<Node>>>;
+  ): WorkflowSequenceBuilder<
+    Providers,
+    InputContext,
+    Merge<OutputContext, WorkflowNodeOutput<Node>>,
+    WorkspaceData,
+    OperationIds,
+    WorkspaceOperationIds
+  >;
 
   parallel<const Branches extends Record<string, WorkflowNodeDefinition<Providers, any, any>>>(
     branches: {
@@ -446,22 +527,86 @@ export type WorkflowSequenceBuilder<
         ? Branches[Key]
         : never;
     },
-  ): WorkflowSequenceBuilder<Providers, InputContext, Merge<OutputContext, ParallelOutput<Branches>>>;
-
-  workspace(
-    definition: WorkflowWorkspaceDefinition<Providers, OutputContext>,
-  ): WorkflowSequenceBuilder<Providers, InputContext, OutputContext>;
+  ): WorkflowSequenceBuilder<
+    Providers,
+    InputContext,
+    Merge<OutputContext, ParallelOutput<Branches>>,
+    WorkspaceData,
+    OperationIds,
+    WorkspaceOperationIds
+  >;
 
-  create<Result extends WorkflowCreateResult>(
-    handler: WorkflowCreateHandler<Providers, OutputContext, Result>,
-  ): WorkflowSequenceBuilder<Providers, InputContext, OutputContext>;
+  workspace<Data extends JsonObject>(
+    definition: WorkflowWorkspaceDefinition<Providers, OutputContext, Data>,
+  ): WorkflowSequenceBuilder<
+    Providers,
+    InputContext,
+    OutputContext,
+    ReadonlyWorkspaceContext<Data>,
+    OperationIds,
+    WorkspaceOperationIds
+  >;
 
   operation<const Id extends string, Input extends object = {}>(
-    id: Id,
+    id: Id & WorkflowOperationIdConstraint<Id, OperationIds>,
     options: WorkflowOperationOptions<Providers, Input>,
-  ): WorkflowSequenceBuilder<Providers, InputContext, OutputContext>;
+  ): WorkflowSequenceBuilder<
+    Providers,
+    InputContext,
+    OutputContext,
+    WorkspaceData,
+    OperationIds | Id,
+    WorkspaceOperationIds
+  >;
+
+  workspaceOperation<const Id extends string, Input extends object = {}>(
+    id: Id & WorkflowOperationIdConstraint<Id, WorkspaceOperationIds>,
+    options: WorkflowWorkspaceOperationOptions<Providers, OutputContext, WorkspaceData, Input>,
+  ): WorkflowSequenceBuilder<
+    Providers,
+    InputContext,
+    OutputContext,
+    WorkspaceData,
+    OperationIds,
+    WorkspaceOperationIds | Id
+  >;
 };
 
+export const RESERVED_WORKFLOW_OPERATION_IDS = [
+  "apply",
+  "completion",
+  "create",
+  "doctor",
+  "fork",
+  "help",
+  "init",
+  "ls",
+  "plan",
+  "projects",
+  "remove",
+  "run",
+  "version",
+] as const;
+
+export type ReservedWorkflowOperationId = typeof RESERVED_WORKFLOW_OPERATION_IDS[number];
+
+type WorkflowOperationIdError<Message extends string> = {
+  readonly __rigkitOperationIdError: Message;
+};
+
+export type WorkflowOperationIdConstraint<
+  Id extends string,
+  Existing extends string,
+> = string extends Id
+  ? unknown
+  : Id extends Existing
+    ? WorkflowOperationIdError<`Operation id "${Id}" is already defined`>
+    : Id extends ReservedWorkflowOperationId
+      ? WorkflowOperationIdError<`Operation id "${Id}" is reserved by Rigkit`>
+      : Id extends `${string}/${string}`
+        ? WorkflowOperationIdError<`Operation id "${Id}" cannot contain "/"`>
+        : unknown;
+
 export type WorkflowNodeInput<Node> =
   Node extends WorkflowNodeDefinition<any, infer Input extends JsonObject, any>
     ? Input
@@ -492,42 +637,19 @@ export type Simplify<Value> = { [Key in keyof Value]: Value[Key] } & {};
 export type WorkflowWorkspaceDefinition<
   Providers extends WorkflowProviderMap = WorkflowProviderMap,
   Context extends JsonObject = JsonObject,
+  Data extends JsonObject = JsonObject,
 > = {
-  source?: (ctx: Readonly<Context>) => JsonValue;
-  cwd?: string | ((ctx: Readonly<Context>) => string | undefined);
-  ports?: readonly number[];
-  onCreated?: (context: WorkflowWorkspaceCreatedContext<Providers, Context>) => MaybePromise<void>;
-  onOpen?: (context: WorkflowWorkspaceOpenContext<Providers, Context>) => MaybePromise<void>;
-};
-
-export type WorkflowWorkspaceCreatedContext<
-  Providers extends WorkflowProviderMap = WorkflowProviderMap,
-  Context extends JsonObject = JsonObject,
-> = WorkflowWorkspaceLifecycleContext<Providers, Context>;
-
-export type WorkflowWorkspaceOpenContext<
-  Providers extends WorkflowProviderMap = WorkflowProviderMap,
-  Context extends JsonObject = JsonObject,
-> = WorkflowWorkspaceLifecycleContext<Providers, Context>;
-
-export type WorkflowWorkspaceLifecycleContext<
-  Providers extends WorkflowProviderMap = WorkflowProviderMap,
-  Context extends JsonObject = JsonObject,
-> = {
-  workspace: WorkspaceRuntimeRecord;
-  ctx: Readonly<Context>;
-  providers: ProviderRuntimeMap<Providers>;
-  providerContext: ProviderWorkspaceContext;
-  local: LocalWorkspaceRuntime;
+  create: WorkflowWorkspaceCreateHandler<Providers, Context, Data>;
+  remove: WorkflowWorkspaceRemoveHandler<Providers, Context, Data>;
 };
 
 export type LoadedWorkflow = {
   name: string;
   providers: Record<string, LoadedProviderDefinition>;
   root: WorkflowNodeDefinition<any, any, any>;
-  workspace?: WorkflowWorkspaceDefinition<any, any>;
-  create?: WorkflowCreateDefinition<any, any>;
+  workspace?: WorkflowWorkspaceDefinition<any, any, any>;
   operations: readonly WorkflowOperationDefinition<any, any>[];
+  workspaceOperations: readonly WorkflowWorkspaceOperationDefinition<any, any, any, any>[];
 };
 
 export type WorkflowPlanNode = {
@@ -554,19 +676,11 @@ export type MachinePlan = WorkflowPlan;
 export type WorkspaceRecord = {
   id: string;
   name: string;
-  providerId: string;
   workflow: string;
-  resourceId: string;
-  snapshotId?: string;
-  sourceRef: JsonValue;
-  context: Record<string, JsonValue>;
+  workflowCtx: Record<string, JsonValue>;
+  ctx: Record<string, JsonValue>;
   createdAt: string;
   updatedAt: string;
-  metadata: Record<string, JsonValue>;
-};
-
-export type WorkspaceRuntimeRecord = WorkspaceRecord & {
-  cwd?: string;
 };
 
 export type WorkflowEvent =
@@ -597,7 +711,7 @@ export type WorkflowEvent =
       title: string;
     }
   | { type: "artifact.created"; nodePath: string; providerId: string; kind: string; ref: JsonValue }
-  | { type: "workspace.ready"; workspaceId: string; providerId: string; resourceId: string; snapshotId?: string };
+  | { type: "workspace.ready"; workspaceId: string };
 
 export type DevMachineEvent = WorkflowEvent;
 

package/src/version.ts

@@ -1 +1 @@
-export const RIGKIT_ENGINE_VERSION = "0.2.1";
+export const RIGKIT_ENGINE_VERSION = "0.2.3";