@pikku/kysely 0.12.9 → 0.12.11

package/CHANGELOG.md

@@ -1,11 +1,36 @@
+## 0.12.11
+
+### Patch Changes
+
+- b9ed73e: Add deterministic workflow planned-step metadata support and SSE init stream payload generation.
+  - Persist `deterministic` and `plannedSteps` on workflow runs in core and service adapters.
+  - Expose planned-step metadata on workflow run status responses.
+  - Emit an initial `type: 'init'` SSE event for deterministic workflow streams before incremental updates.
+  - Add CLI tests covering serialized stream route output for init/update/done event behavior.
+
+- Updated dependencies [b9ed73e]
+  - @pikku/core@0.12.19
+
 ## 0.12.0
 
+## 0.12.10
+
+### Patch Changes
+
+- 311c0c4: Unify session persistence through SessionStore, remove session blob from ChannelStore
+  - PikkuSessionService now persists sessions via SessionStore on set()/clear() instead of every function call
+  - ChannelStore no longer stores session data — maps channelId to pikkuUserId only
+  - ChannelStore API: setUserSession/getChannelAndSession replaced with setPikkuUserId/getChannel
+  - Serverless channel runner resolves sessions from SessionStore using pikkuUserId from ChannelStore
+
+- Updated dependencies [311c0c4]
+  - @pikku/core@0.12.18
+
 ## 0.12.9
 
 ### Patch Changes
 
 - 624097e: Add deploy pipeline with provider-agnostic architecture
-
   - Add MetaService with explicit typed API, absorb WiringService reads
   - Add deployment service, traceId propagation, scoped logger
   - Rewrite analyzer: one function = one worker, gateways dispatch via RPC
@@ -25,7 +50,6 @@
 ### Patch Changes
 
 - f85c234: Add unified credential system with per-user OAuth and AI agent pre-flight checks
-
   - Unified CredentialService with lazy loading per user via pikkuUserId
   - wire.getCredential() for typed single credential lookup
   - MissingCredentialError with structured payload for client-side connect flows
@@ -130,7 +154,6 @@
 - Updated dependencies [62a8725]
 - Updated dependencies [62a8725]
 - Updated dependencies [62a8725]
-
   - @pikku/core@0.12.1
 
 - Updated dependencies

package/dist/src/index.d.ts

@@ -10,6 +10,7 @@ export { KyselySecretService } from './kysely-secret-service.js';
 export type { KyselySecretServiceConfig } from './kysely-secret-service.js';
 export { KyselyCredentialService } from './kysely-credential-service.js';
 export type { KyselyCredentialServiceConfig } from './kysely-credential-service.js';
+export { KyselySessionStore } from './kysely-session-store.js';
 export type { KyselyPikkuDB } from './kysely-tables.js';
 export type { WorkflowRunService } from '@pikku/core/workflow';
 export type { AgentRunService, AgentRunRow } from '@pikku/core/ai-agent';

package/dist/src/index.js

@@ -8,3 +8,4 @@ export { KyselyAgentRunService } from './kysely-ai-agent-run-service.js';
 export { KyselyAIRunStateService } from './kysely-ai-run-state-service.js';
 export { KyselySecretService } from './kysely-secret-service.js';
 export { KyselyCredentialService } from './kysely-credential-service.js';
+export { KyselySessionStore } from './kysely-session-store.js';

package/dist/src/kysely-channel-store.d.ts

@@ -1,4 +1,3 @@
-import type { CoreUserSession } from '@pikku/core';
 import type { Channel } from '@pikku/core/channel';
 import { ChannelStore } from '@pikku/core/channel';
 import type { Kysely } from 'kysely';
@@ -10,9 +9,9 @@ export declare class KyselyChannelStore extends ChannelStore {
     init(): Promise<void>;
     addChannel({ channelId, channelName, openingData, }: Channel): Promise<void>;
     removeChannels(channelIds: string[]): Promise<void>;
-    setUserSession(channelId: string, session: CoreUserSession | null): Promise<void>;
-    getChannelAndSession(channelId: string): Promise<Channel & {
-        session: CoreUserSession;
+    setPikkuUserId(channelId: string, pikkuUserId: string | null): Promise<void>;
+    getChannel(channelId: string): Promise<Channel & {
+        pikkuUserId?: string;
     }>;
     close(): Promise<void>;
 }

package/dist/src/kysely-channel-store.js

@@ -19,7 +19,7 @@ export class KyselyChannelStore extends ChannelStore {
             .addColumn('channel_name', 'text', (col) => col.notNull())
             .addColumn('created_at', 'timestamp', (col) => col.defaultTo(sql `CURRENT_TIMESTAMP`).notNull())
             .addColumn('opening_data', 'text', (col) => col.notNull().defaultTo('{}'))
-            .addColumn('user_session', 'text')
+            .addColumn('pikku_user_id', 'text')
             .addColumn('last_wire', 'timestamp', (col) => col.defaultTo(sql `CURRENT_TIMESTAMP`).notNull())
             .execute();
         await this.db.schema
@@ -53,17 +53,17 @@ export class KyselyChannelStore extends ChannelStore {
             .where('channelId', 'in', channelIds)
             .execute();
     }
-    async setUserSession(channelId, session) {
+    async setPikkuUserId(channelId, pikkuUserId) {
         await this.db
             .updateTable('channels')
-            .set({ userSession: session ? JSON.stringify(session) : null })
+            .set({ pikkuUserId })
             .where('channelId', '=', channelId)
             .execute();
     }
-    async getChannelAndSession(channelId) {
+    async getChannel(channelId) {
         const row = await this.db
             .selectFrom('channels')
-            .select(['channelId', 'channelName', 'openingData', 'userSession'])
+            .select(['channelId', 'channelName', 'openingData', 'pikkuUserId'])
             .where('channelId', '=', channelId)
             .executeTakeFirst();
         if (!row) {
@@ -73,7 +73,7 @@ export class KyselyChannelStore extends ChannelStore {
             channelId: row.channelId,
             channelName: row.channelName,
             openingData: parseJson(row.openingData) ?? {},
-            session: (parseJson(row.userSession) ?? {}),
+            pikkuUserId: row.pikkuUserId ?? undefined,
         };
     }
     async close() { }

package/dist/src/kysely-session-store.d.ts

@@ -0,0 +1,13 @@
+import type { CoreUserSession } from '@pikku/core';
+import type { SessionStore } from '@pikku/core/services';
+import type { Kysely } from 'kysely';
+import type { KyselyPikkuDB } from './kysely-tables.js';
+export declare class KyselySessionStore implements SessionStore {
+    private db;
+    private initialized;
+    constructor(db: Kysely<KyselyPikkuDB>);
+    init(): Promise<void>;
+    get(pikkuUserId: string): Promise<CoreUserSession | undefined>;
+    set(pikkuUserId: string, session: CoreUserSession): Promise<void>;
+    clear(pikkuUserId: string): Promise<void>;
+}

package/dist/src/kysely-session-store.js

@@ -0,0 +1,54 @@
+import { sql } from 'kysely';
+import { parseJson } from './kysely-json.js';
+export class KyselySessionStore {
+    db;
+    initialized = false;
+    constructor(db) {
+        this.db = db;
+    }
+    async init() {
+        if (this.initialized) {
+            return;
+        }
+        await this.db.schema
+            .createTable('pikku_user_sessions')
+            .ifNotExists()
+            .addColumn('pikku_user_id', 'text', (col) => col.primaryKey())
+            .addColumn('session', 'text', (col) => col.notNull())
+            .addColumn('created_at', 'timestamp', (col) => col.defaultTo(sql `CURRENT_TIMESTAMP`).notNull())
+            .addColumn('updated_at', 'timestamp', (col) => col.defaultTo(sql `CURRENT_TIMESTAMP`).notNull())
+            .execute();
+        this.initialized = true;
+    }
+    async get(pikkuUserId) {
+        const row = await this.db
+            .selectFrom('pikkuUserSessions')
+            .select(['session'])
+            .where('pikkuUserId', '=', pikkuUserId)
+            .executeTakeFirst();
+        if (!row) {
+            return undefined;
+        }
+        return (parseJson(row.session) ?? undefined);
+    }
+    async set(pikkuUserId, session) {
+        await this.db
+            .insertInto('pikkuUserSessions')
+            .values({
+            pikkuUserId,
+            session: JSON.stringify(session),
+            updatedAt: new Date(),
+        })
+            .onConflict((oc) => oc.column('pikkuUserId').doUpdateSet({
+            session: JSON.stringify(session),
+            updatedAt: new Date(),
+        }))
+            .execute();
+    }
+    async clear(pikkuUserId) {
+        await this.db
+            .deleteFrom('pikkuUserSessions')
+            .where('pikkuUserId', '=', pikkuUserId)
+            .execute();
+    }
+}

package/dist/src/kysely-tables.d.ts

@@ -5,7 +5,7 @@ export interface ChannelsTable {
     channelName: string;
     createdAt: Generated<Date>;
     openingData: string;
-    userSession: string | null;
+    pikkuUserId: string | null;
     lastWire: Generated<Date>;
 }
 export interface ChannelSubscriptionsTable {
@@ -22,6 +22,8 @@ export interface WorkflowRunsTable {
     state: Generated<string>;
     inline: Generated<boolean>;
     graphHash: string | null;
+    deterministic: Generated<boolean>;
+    plannedSteps: string | null;
     wire: string | null;
     createdAt: Generated<Date>;
     updatedAt: Generated<Date>;
@@ -153,6 +155,12 @@ export interface CredentialsAuditTable {
     action: string;
     performedAt: Generated<Date>;
 }
+export interface UserSessionsTable {
+    pikkuUserId: string;
+    session: string;
+    createdAt: Generated<Date>;
+    updatedAt: Generated<Date>;
+}
 export interface KyselyPikkuDB {
     channels: ChannelsTable;
     channelSubscriptions: ChannelSubscriptionsTable;
@@ -171,4 +179,5 @@ export interface KyselyPikkuDB {
     secretsAudit: SecretsAuditTable;
     credentials: CredentialsTable;
     credentialsAudit: CredentialsAuditTable;
+    pikkuUserSessions: UserSessionsTable;
 }

package/dist/src/kysely-workflow-run-service.js

@@ -17,6 +17,8 @@ export class KyselyWorkflowRunService {
             'error',
             'inline',
             'graphHash',
+            'deterministic',
+            'plannedSteps',
             'wire',
             'createdAt',
             'updatedAt',
@@ -46,6 +48,8 @@ export class KyselyWorkflowRunService {
             'error',
             'inline',
             'graphHash',
+            'deterministic',
+            'plannedSteps',
             'wire',
             'createdAt',
             'updatedAt',
@@ -204,6 +208,8 @@ export class KyselyWorkflowRunService {
             error: parseJson(row.error),
             inline: row.inline,
             graphHash: row.graphHash,
+            deterministic: row.deterministic,
+            plannedSteps: parseJson(row.plannedSteps),
             wire: parseJson(row.wire) ?? { type: 'unknown' },
             createdAt: new Date(row.createdAt),
             updatedAt: new Date(row.updatedAt),

package/dist/src/kysely-workflow-service.d.ts

@@ -1,5 +1,5 @@
 import type { SerializedError } from '@pikku/core';
-import { PikkuWorkflowService, type WorkflowRun, type WorkflowRunWire, type StepState, type WorkflowStatus, type WorkflowVersionStatus } from '@pikku/core/workflow';
+import { PikkuWorkflowService, type WorkflowPlannedStep, type WorkflowRun, type WorkflowRunWire, type StepState, type WorkflowStatus, type WorkflowVersionStatus } from '@pikku/core/workflow';
 import type { Kysely } from 'kysely';
 import type { KyselyPikkuDB } from './kysely-tables.js';
 export declare class KyselyWorkflowService extends PikkuWorkflowService {
@@ -8,7 +8,10 @@ export declare class KyselyWorkflowService extends PikkuWorkflowService {
     private runService;
     constructor(db: Kysely<KyselyPikkuDB>);
     init(): Promise<void>;
-    createRun(workflowName: string, input: any, inline: boolean, graphHash: string, wire: WorkflowRunWire): Promise<string>;
+    createRun(workflowName: string, input: any, inline: boolean, graphHash: string, wire: WorkflowRunWire, options?: {
+        deterministic?: boolean;
+        plannedSteps?: WorkflowPlannedStep[];
+    }): Promise<string>;
     getRun(id: string): Promise<WorkflowRun | null>;
     updateRunStatus(id: string, status: WorkflowStatus, output?: any, error?: SerializedError): Promise<void>;
     insertStepState(runId: string, stepName: string, rpcName: string | null, data: any, stepOptions?: {

package/dist/src/kysely-workflow-service.js

@@ -29,6 +29,8 @@ export class KyselyWorkflowService extends PikkuWorkflowService {
             .addColumn('state', 'text', (col) => col.defaultTo('{}'))
             .addColumn('inline', 'boolean', (col) => col.defaultTo(false))
             .addColumn('graph_hash', 'text')
+            .addColumn('deterministic', 'boolean', (col) => col.defaultTo(false))
+            .addColumn('planned_steps', 'text')
             .addColumn('wire', 'text')
             .addColumn('created_at', 'timestamp', (col) => col.defaultTo(sql `CURRENT_TIMESTAMP`).notNull())
             .addColumn('updated_at', 'timestamp', (col) => col.defaultTo(sql `CURRENT_TIMESTAMP`).notNull())
@@ -95,7 +97,7 @@ export class KyselyWorkflowService extends PikkuWorkflowService {
             .execute();
         this.initialized = true;
     }
-    async createRun(workflowName, input, inline, graphHash, wire) {
+    async createRun(workflowName, input, inline, graphHash, wire, options) {
         const id = crypto.randomUUID();
         await this.db
             .insertInto('workflowRuns')
@@ -106,6 +108,10 @@ export class KyselyWorkflowService extends PikkuWorkflowService {
             input: JSON.stringify(input),
             inline,
             graphHash: graphHash ?? null,
+            deterministic: options?.deterministic ?? false,
+            plannedSteps: options?.plannedSteps
+                ? JSON.stringify(options.plannedSteps)
+                : null,
             wire: wire ? JSON.stringify(wire) : null,
         })
             .execute();

package/dist/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"root":["../src/index.ts","../src/kysely-ai-agent-run-service.ts","../src/kysely-ai-run-state-service.ts","../src/kysely-ai-storage-service.ts","../src/kysely-channel-store.ts","../src/kysely-credential-service.ts","../src/kysely-deployment-service.ts","../src/kysely-eventhub-store.ts","../src/kysely-json.ts","../src/kysely-secret-service.ts","../src/kysely-tables.ts","../src/kysely-workflow-run-service.ts","../src/kysely-workflow-service.ts","../bin/pikku-kysely-pure.ts"],"version":"5.9.3"}
+{"root":["../src/index.ts","../src/kysely-ai-agent-run-service.ts","../src/kysely-ai-run-state-service.ts","../src/kysely-ai-storage-service.ts","../src/kysely-channel-store.ts","../src/kysely-credential-service.ts","../src/kysely-deployment-service.ts","../src/kysely-eventhub-store.ts","../src/kysely-json.ts","../src/kysely-secret-service.ts","../src/kysely-session-store.ts","../src/kysely-tables.ts","../src/kysely-workflow-run-service.ts","../src/kysely-workflow-service.ts","../bin/pikku-kysely-pure.ts"],"version":"5.9.3"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pikku/kysely",
-  "version": "0.12.9",
+  "version": "0.12.11",
   "author": "yasser.fadl@gmail.com",
   "license": "MIT",
   "module": "dist/src/index.js",
@@ -20,7 +20,7 @@
     "prepublishOnly": "yarn build"
   },
   "peerDependencies": {
-    "@pikku/core": "^0.12.15"
+    "@pikku/core": "^0.12.19"
   },
   "dependencies": {
     "kysely": "^0.28.12"

package/src/index.ts

@@ -10,6 +10,7 @@ export { KyselySecretService } from './kysely-secret-service.js'
 export type { KyselySecretServiceConfig } from './kysely-secret-service.js'
 export { KyselyCredentialService } from './kysely-credential-service.js'
 export type { KyselyCredentialServiceConfig } from './kysely-credential-service.js'
+export { KyselySessionStore } from './kysely-session-store.js'
 
 export type { KyselyPikkuDB } from './kysely-tables.js'
 export type { WorkflowRunService } from '@pikku/core/workflow'

package/src/kysely-channel-store.ts

@@ -1,4 +1,3 @@
-import type { CoreUserSession } from '@pikku/core'
 import type { Channel } from '@pikku/core/channel'
 import { ChannelStore } from '@pikku/core/channel'
 import type { Kysely } from 'kysely'
@@ -27,7 +26,7 @@ export class KyselyChannelStore extends ChannelStore {
         col.defaultTo(sql`CURRENT_TIMESTAMP`).notNull()
       )
       .addColumn('opening_data', 'text', (col) => col.notNull().defaultTo('{}'))
-      .addColumn('user_session', 'text')
+      .addColumn('pikku_user_id', 'text')
       .addColumn('last_wire', 'timestamp', (col) =>
         col.defaultTo(sql`CURRENT_TIMESTAMP`).notNull()
       )
@@ -75,23 +74,23 @@ export class KyselyChannelStore extends ChannelStore {
       .execute()
   }
 
-  public async setUserSession(
+  public async setPikkuUserId(
     channelId: string,
-    session: CoreUserSession | null
+    pikkuUserId: string | null
   ): Promise<void> {
     await this.db
       .updateTable('channels')
-      .set({ userSession: session ? JSON.stringify(session) : null })
+      .set({ pikkuUserId })
       .where('channelId', '=', channelId)
       .execute()
   }
 
-  public async getChannelAndSession(
+  public async getChannel(
     channelId: string
-  ): Promise<Channel & { session: CoreUserSession }> {
+  ): Promise<Channel & { pikkuUserId?: string }> {
     const row = await this.db
       .selectFrom('channels')
-      .select(['channelId', 'channelName', 'openingData', 'userSession'])
+      .select(['channelId', 'channelName', 'openingData', 'pikkuUserId'])
       .where('channelId', '=', channelId)
       .executeTakeFirst()
 
@@ -103,7 +102,7 @@ export class KyselyChannelStore extends ChannelStore {
       channelId: row.channelId,
       channelName: row.channelName,
       openingData: parseJson(row.openingData) ?? {},
-      session: (parseJson(row.userSession) ?? {}) as CoreUserSession,
+      pikkuUserId: row.pikkuUserId ?? undefined,
     }
   }
 

package/src/kysely-services.test.ts

@@ -17,6 +17,7 @@ import { KyselyAIStorageService } from './kysely-ai-storage-service.js'
 import { KyselyAgentRunService } from './kysely-ai-agent-run-service.js'
 import { KyselySecretService } from './kysely-secret-service.js'
 import { KyselyCredentialService } from './kysely-credential-service.js'
+import { KyselySessionStore } from './kysely-session-store.js'
 
 function createSqliteDb(): Kysely<KyselyPikkuDB> {
   return new Kysely<KyselyPikkuDB>({
@@ -109,6 +110,11 @@ function registerTests(
         await s.init()
         return s
       },
+      sessionStore: async () => {
+        const s = new KyselySessionStore(getDb())
+        await s.init()
+        return s
+      },
     },
   })
 

package/src/kysely-session-store.ts

@@ -0,0 +1,73 @@
+import type { CoreUserSession } from '@pikku/core'
+import type { SessionStore } from '@pikku/core/services'
+import type { Kysely } from 'kysely'
+import { sql } from 'kysely'
+import type { KyselyPikkuDB } from './kysely-tables.js'
+import { parseJson } from './kysely-json.js'
+
+export class KyselySessionStore implements SessionStore {
+  private initialized = false
+
+  constructor(private db: Kysely<KyselyPikkuDB>) {}
+
+  public async init(): Promise<void> {
+    if (this.initialized) {
+      return
+    }
+
+    await this.db.schema
+      .createTable('pikku_user_sessions')
+      .ifNotExists()
+      .addColumn('pikku_user_id', 'text', (col) => col.primaryKey())
+      .addColumn('session', 'text', (col) => col.notNull())
+      .addColumn('created_at', 'timestamp', (col) =>
+        col.defaultTo(sql`CURRENT_TIMESTAMP`).notNull()
+      )
+      .addColumn('updated_at', 'timestamp', (col) =>
+        col.defaultTo(sql`CURRENT_TIMESTAMP`).notNull()
+      )
+      .execute()
+
+    this.initialized = true
+  }
+
+  async get(pikkuUserId: string): Promise<CoreUserSession | undefined> {
+    const row = await this.db
+      .selectFrom('pikkuUserSessions')
+      .select(['session'])
+      .where('pikkuUserId', '=', pikkuUserId)
+      .executeTakeFirst()
+
+    if (!row) {
+      return undefined
+    }
+
+    return (parseJson(row.session) ?? undefined) as
+      | CoreUserSession
+      | undefined
+  }
+
+  async set(pikkuUserId: string, session: CoreUserSession): Promise<void> {
+    await this.db
+      .insertInto('pikkuUserSessions')
+      .values({
+        pikkuUserId,
+        session: JSON.stringify(session),
+        updatedAt: new Date(),
+      })
+      .onConflict((oc) =>
+        oc.column('pikkuUserId').doUpdateSet({
+          session: JSON.stringify(session),
+          updatedAt: new Date(),
+        })
+      )
+      .execute()
+  }
+
+  async clear(pikkuUserId: string): Promise<void> {
+    await this.db
+      .deleteFrom('pikkuUserSessions')
+      .where('pikkuUserId', '=', pikkuUserId)
+      .execute()
+  }
+}

package/src/kysely-tables.ts

@@ -10,7 +10,7 @@ export interface ChannelsTable {
   channelName: string
   createdAt: Generated<Date>
   openingData: string
-  userSession: string | null
+  pikkuUserId: string | null
   lastWire: Generated<Date>
 }
 
@@ -29,6 +29,8 @@ export interface WorkflowRunsTable {
   state: Generated<string>
   inline: Generated<boolean>
   graphHash: string | null
+  deterministic: Generated<boolean>
+  plannedSteps: string | null
   wire: string | null
   createdAt: Generated<Date>
   updatedAt: Generated<Date>
@@ -175,6 +177,13 @@ export interface CredentialsAuditTable {
   performedAt: Generated<Date>
 }
 
+export interface UserSessionsTable {
+  pikkuUserId: string
+  session: string
+  createdAt: Generated<Date>
+  updatedAt: Generated<Date>
+}
+
 export interface KyselyPikkuDB {
   channels: ChannelsTable
   channelSubscriptions: ChannelSubscriptionsTable
@@ -193,4 +202,5 @@ export interface KyselyPikkuDB {
   secretsAudit: SecretsAuditTable
   credentials: CredentialsTable
   credentialsAudit: CredentialsAuditTable
+  pikkuUserSessions: UserSessionsTable
 }

package/src/kysely-workflow-run-service.ts

@@ -30,6 +30,8 @@ export class KyselyWorkflowRunService implements WorkflowRunService {
         'error',
         'inline',
         'graphHash',
+        'deterministic',
+        'plannedSteps',
         'wire',
         'createdAt',
         'updatedAt',
@@ -64,6 +66,8 @@ export class KyselyWorkflowRunService implements WorkflowRunService {
         'error',
         'inline',
         'graphHash',
+        'deterministic',
+        'plannedSteps',
         'wire',
         'createdAt',
         'updatedAt',
@@ -255,6 +259,8 @@ export class KyselyWorkflowRunService implements WorkflowRunService {
       error: parseJson(row.error),
       inline: row.inline as boolean | undefined,
       graphHash: row.graphHash as string | undefined,
+      deterministic: row.deterministic as boolean | undefined,
+      plannedSteps: parseJson(row.plannedSteps),
       wire: parseJson(row.wire) ?? { type: 'unknown' },
       createdAt: new Date(row.createdAt as string),
       updatedAt: new Date(row.updatedAt as string),

package/src/kysely-workflow-service.ts

@@ -1,6 +1,7 @@
 import type { SerializedError } from '@pikku/core'
 import {
   PikkuWorkflowService,
+  type WorkflowPlannedStep,
   type WorkflowRun,
   type WorkflowRunWire,
   type StepState,
@@ -43,6 +44,8 @@ export class KyselyWorkflowService extends PikkuWorkflowService {
       .addColumn('state', 'text', (col) => col.defaultTo('{}'))
       .addColumn('inline', 'boolean', (col) => col.defaultTo(false))
       .addColumn('graph_hash', 'text')
+      .addColumn('deterministic', 'boolean', (col) => col.defaultTo(false))
+      .addColumn('planned_steps', 'text')
       .addColumn('wire', 'text')
       .addColumn('created_at', 'timestamp', (col) =>
         col.defaultTo(sql`CURRENT_TIMESTAMP`).notNull()
@@ -139,7 +142,11 @@ export class KyselyWorkflowService extends PikkuWorkflowService {
     input: any,
     inline: boolean,
     graphHash: string,
-    wire: WorkflowRunWire
+    wire: WorkflowRunWire,
+    options?: {
+      deterministic?: boolean
+      plannedSteps?: WorkflowPlannedStep[]
+    }
   ): Promise<string> {
     const id = crypto.randomUUID()
     await this.db
@@ -151,6 +158,10 @@ export class KyselyWorkflowService extends PikkuWorkflowService {
         input: JSON.stringify(input),
         inline,
         graphHash: graphHash ?? null,
+        deterministic: options?.deterministic ?? false,
+        plannedSteps: options?.plannedSteps
+          ? JSON.stringify(options.plannedSteps)
+          : null,
         wire: wire ? JSON.stringify(wire) : null,
       })
       .execute()