@pikku/kysely 0.12.10 → 0.12.11

package/CHANGELOG.md

@@ -1,3 +1,16 @@
+## 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
@@ -5,7 +18,6 @@
 ### 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
@@ -19,7 +31,6 @@
 ### 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
@@ -39,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
@@ -144,7 +154,6 @@
 - Updated dependencies [62a8725]
 - Updated dependencies [62a8725]
 - Updated dependencies [62a8725]
-
   - @pikku/core@0.12.1
 
 - Updated dependencies

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

@@ -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>;

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pikku/kysely",
-  "version": "0.12.10",
+  "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.18"
+    "@pikku/core": "^0.12.19"
   },
   "dependencies": {
     "kysely": "^0.28.12"

package/src/kysely-tables.ts

@@ -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>

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()