@pikku/kysely 0.13.13 → 0.13.16

package/src/kysely-tables.ts

@@ -3,7 +3,7 @@ import type {
   WorkflowStatus,
   StepStatus,
   WorkflowVersionStatus,
-} from '@pikku/core/workflow'
+} from '@pikku/core/ecosystem/workflow'
 
 export interface ChannelsTable {
   channelId: string
@@ -86,7 +86,7 @@ export interface WorkflowVersionsTable {
   createdAt: Generated<Date>
 }
 
-export interface AIThreadsTable {
+export interface AgentThreadsTable {
   id: string
   resourceId: string
   title: string | null
@@ -95,7 +95,7 @@ export interface AIThreadsTable {
   updatedAt: Generated<Date>
 }
 
-export interface AIMessageTable {
+export interface AgentMessageTable {
   id: string
   threadId: string
   role: 'system' | 'user' | 'assistant' | 'tool'
@@ -103,7 +103,7 @@ export interface AIMessageTable {
   createdAt: Generated<Date>
 }
 
-export interface AIToolCallTable {
+export interface AgentToolCallTable {
   id: string
   threadId: string
   messageId: string
@@ -119,14 +119,14 @@ export interface AIToolCallTable {
   createdAt: Generated<Date>
 }
 
-export interface AIWorkingMemoryTable {
+export interface AgentWorkingMemoryTable {
   id: string
   scope: string
   data: string
   updatedAt: Generated<Date>
 }
 
-export interface AIRunTable {
+export interface AgentRunTable {
   runId: Generated<string>
   agentName: string
   threadId: string
@@ -151,6 +151,18 @@ export interface AIRunTable {
   updatedAt: Generated<Date>
 }
 
+export interface AgentRunScoreTable {
+  id: string
+  runId: string
+  scorerName: string
+  /** 0..1, so grades are comparable across scorers. */
+  score: number
+  reason: string | null
+  /** JSON-serialized structured detail the scorer returned alongside the score. */
+  metadata: string | null
+  createdAt: Generated<Date>
+}
+
 export interface PikkuDeploymentsTable {
   deploymentId: string
   endpoint: string
@@ -324,11 +336,12 @@ export interface KyselyPikkuDB {
   workflowStep: WorkflowStepTable
   workflowStepHistory: WorkflowStepHistoryTable
   workflowVersions: WorkflowVersionsTable
-  aiThreads: AIThreadsTable
-  aiMessage: AIMessageTable
-  aiToolCall: AIToolCallTable
-  aiWorkingMemory: AIWorkingMemoryTable
-  aiRun: AIRunTable
+  agentThreads: AgentThreadsTable
+  agentMessage: AgentMessageTable
+  agentToolCall: AgentToolCallTable
+  agentWorkingMemory: AgentWorkingMemoryTable
+  agentRun: AgentRunTable
+  agentRunScore: AgentRunScoreTable
   pikkuDeployments: PikkuDeploymentsTable
   pikkuDeploymentFunctions: PikkuDeploymentFunctionsTable
   secrets: SecretsTable

package/src/kysely-virtual-user-run-store.ts

@@ -1,12 +1,12 @@
 import type { Kysely, Selectable } from 'kysely'
 import { randomUUID } from 'node:crypto'
+import type { VirtualUserDisposition } from '@pikku/core/virtual-user'
 import type {
-  VirtualUserDisposition,
   VirtualUserRunOutcome,
   VirtualUserRunRecord,
   VirtualUserRunStart,
   VirtualUserRunStore,
-} from '@pikku/core/virtual-user'
+} from '@pikku/core/ecosystem/virtual-user'
 import type { KyselyPikkuDB, VirtualUserRunTable } from './kysely-tables.js'
 import { parseJson } from './kysely-json.js'
 import { ensurePikkuSchema } from './schema/index.js'

package/src/kysely-webhook-service.ts

@@ -1,12 +1,12 @@
+import { QueueWebhookService } from '@pikku/core/services'
 import {
   PIKKU_OUTGOING_WEBHOOK_QUEUE_NAME,
-  QueueWebhookService,
   type SendWebhookInput,
   type SendWebhookResult,
   type WebhookAttemptResult,
   type WebhookDeliveryRecord,
   type WebhookDeliveryWithAttempts,
-} from '@pikku/core/services'
+} from '@pikku/core/ecosystem/services'
 import type { QueueService } from '@pikku/core/queue'
 import type { Kysely } from 'kysely'
 import type { KyselyPikkuDB } from './kysely-tables.js'

package/src/kysely-workflow-mirror.ts

@@ -1,4 +1,4 @@
-import type { SerializedError } from '@pikku/core'
+import type { SerializedError } from '@pikku/core/ecosystem/types'
 import type {
   StepState,
   WorkflowRunMirror,
@@ -6,7 +6,7 @@ import type {
   WorkflowStatus,
   WorkflowPlannedStep,
   WorkflowVersionStatus,
-} from '@pikku/core/workflow'
+} from '@pikku/core/ecosystem/workflow'
 import type { Kysely } from 'kysely'
 import type { KyselyPikkuDB } from './kysely-tables.js'
 import { ensurePikkuSchema } from './schema/index.js'

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

@@ -3,7 +3,7 @@ import type {
   StepState,
   WorkflowStatus,
   WorkflowRunService,
-} from '@pikku/core/workflow'
+} from '@pikku/core/ecosystem/workflow'
 import type { Kysely } from 'kysely'
 import type { KyselyPikkuDB } from './kysely-tables.js'
 import { parseJson } from './kysely-json.js'

package/src/kysely-workflow-service.ts

@@ -1,15 +1,6 @@
-import type { SerializedError } from '@pikku/core'
-import {
-  PikkuWorkflowService,
-  type WorkflowPlannedStep,
-  type WorkflowQueueOptions,
-  type WorkflowRun,
-  type WorkflowRunWire,
-  type StepState,
-  type StepStatus,
-  type WorkflowStatus,
-  type WorkflowVersionStatus,
-} from '@pikku/core/workflow'
+import type { SerializedError } from '@pikku/core/ecosystem/types'
+import { PikkuWorkflowService } from '@pikku/core/workflow'
+import type { WorkflowPlannedStep, WorkflowQueueOptions, WorkflowRun, WorkflowRunWire, StepState, StepStatus, WorkflowStatus, WorkflowVersionStatus } from '@pikku/core/ecosystem/workflow'
 import { sql, type Kysely } from 'kysely'
 import type { KyselyPikkuDB } from './kysely-tables.js'
 import { KyselyWorkflowRunService } from './kysely-workflow-run-service.js'

package/src/schema/{ai.schema.ts → agent.schema.ts}

@@ -4,19 +4,19 @@ import type { PikkuSchema } from './pikku-schema.types.js'
 /**
  * Threads, messages, tool calls, working memory and agent runs.
  *
- * `aiRun` carries `pendingApprovals` even though the two services that used to
- * create this table disagreed about it: `KyselyAIStorageService` omitted the
- * column while `KyselyAIRunStateService` declared it and read it back through
+ * `agentRun` carries `pendingApprovals` even though the two services that used to
+ * create this table disagreed about it: `KyselyAgentStorageService` omitted the
+ * column while `KyselyAgentRunStateService` declared it and read it back through
  * casts. Whichever service happened to run first decided the shape, and on a
  * database where the storage service won, resolving an approval failed. One
  * declaration ends that — the column is here because live code reads it.
  */
-export const aiSchema: PikkuSchema = {
-  name: 'ai',
+export const agentSchema: PikkuSchema = {
+  name: 'agent',
   statements: [
     (db) =>
       db.schema
-        .createTable('aiThreads')
+        .createTable('agentThreads')
         .addColumn('id', 'varchar(36)', (col) => col.primaryKey())
         .addColumn('resourceId', 'varchar(255)', (col) => col.notNull())
         .addColumn('title', 'text')
@@ -30,16 +30,16 @@ export const aiSchema: PikkuSchema = {
 
     (db) =>
       db.schema
-        .createIndex('idx_ai_threads_resource')
-        .on('aiThreads')
+        .createIndex('idx_agent_threads_resource')
+        .on('agentThreads')
         .column('resourceId'),
 
     (db) =>
       db.schema
-        .createTable('aiMessage')
+        .createTable('agentMessage')
         .addColumn('id', 'varchar(36)', (col) => col.primaryKey())
         .addColumn('threadId', 'varchar(36)', (col) =>
-          col.notNull().references('aiThreads.id').onDelete('cascade')
+          col.notNull().references('agentThreads.id').onDelete('cascade')
         )
         .addColumn('role', 'varchar(50)', (col) => col.notNull())
         .addColumn('content', 'text')
@@ -49,19 +49,19 @@ export const aiSchema: PikkuSchema = {
 
     (db) =>
       db.schema
-        .createIndex('idx_ai_message_thread')
-        .on('aiMessage')
+        .createIndex('idx_agent_message_thread')
+        .on('agentMessage')
         .columns(['threadId', 'createdAt']),
 
     (db) =>
       db.schema
-        .createTable('aiToolCall')
+        .createTable('agentToolCall')
         .addColumn('id', 'varchar(36)', (col) => col.primaryKey())
         .addColumn('threadId', 'varchar(36)', (col) =>
-          col.notNull().references('aiThreads.id').onDelete('cascade')
+          col.notNull().references('agentThreads.id').onDelete('cascade')
         )
         .addColumn('messageId', 'varchar(36)', (col) =>
-          col.notNull().references('aiMessage.id').onDelete('cascade')
+          col.notNull().references('agentMessage.id').onDelete('cascade')
         )
         .addColumn('runId', 'varchar(36)')
         .addColumn('toolName', 'varchar(255)', (col) => col.notNull())
@@ -78,34 +78,34 @@ export const aiSchema: PikkuSchema = {
 
     (db) =>
       db.schema
-        .createIndex('idx_ai_tool_call_thread')
-        .on('aiToolCall')
+        .createIndex('idx_agent_tool_call_thread')
+        .on('agentToolCall')
         .column('threadId'),
 
     (db) =>
       db.schema
-        .createIndex('idx_ai_tool_call_message')
-        .on('aiToolCall')
+        .createIndex('idx_agent_tool_call_message')
+        .on('agentToolCall')
         .column('messageId'),
 
     (db) =>
       db.schema
-        .createTable('aiWorkingMemory')
+        .createTable('agentWorkingMemory')
         .addColumn('id', 'varchar(255)', (col) => col.notNull())
         .addColumn('scope', 'varchar(50)', (col) => col.notNull())
         .addColumn('data', 'text', (col) => col.notNull())
         .addColumn('updatedAt', 'timestamp', (col) =>
           col.defaultTo(sql`CURRENT_TIMESTAMP`).notNull()
         )
-        .addPrimaryKeyConstraint('ai_working_memory_pk', ['id', 'scope']),
+        .addPrimaryKeyConstraint('agent_working_memory_pk', ['id', 'scope']),
 
     (db) =>
       db.schema
-        .createTable('aiRun')
+        .createTable('agentRun')
         .addColumn('runId', 'varchar(36)', (col) => col.primaryKey())
         .addColumn('agentName', 'varchar(255)', (col) => col.notNull())
         .addColumn('threadId', 'varchar(36)', (col) =>
-          col.notNull().references('aiThreads.id').onDelete('cascade')
+          col.notNull().references('agentThreads.id').onDelete('cascade')
         )
         .addColumn('resourceId', 'varchar(255)', (col) => col.notNull())
         .addColumn('status', 'varchar(50)', (col) =>
@@ -133,8 +133,29 @@ export const aiSchema: PikkuSchema = {
 
     (db) =>
       db.schema
-        .createIndex('idx_ai_run_thread')
-        .on('aiRun')
+        .createIndex('idx_agent_run_thread')
+        .on('agentRun')
         .columns(['threadId', 'createdAt']),
+
+    (db) =>
+      db.schema
+        .createTable('agentRunScore')
+        .addColumn('id', 'varchar(36)', (col) => col.primaryKey())
+        .addColumn('runId', 'varchar(36)', (col) =>
+          col.notNull().references('agentRun.runId').onDelete('cascade')
+        )
+        .addColumn('scorerName', 'varchar(255)', (col) => col.notNull())
+        .addColumn('score', 'real', (col) => col.notNull())
+        .addColumn('reason', 'text')
+        .addColumn('metadata', 'text')
+        .addColumn('createdAt', 'timestamp', (col) =>
+          col.defaultTo(sql`CURRENT_TIMESTAMP`).notNull()
+        ),
+
+    (db) =>
+      db.schema
+        .createIndex('idx_agent_run_score_run')
+        .on('agentRunScore')
+        .columns(['runId', 'createdAt']),
   ],
 }

package/src/schema/index.ts

@@ -6,7 +6,7 @@ import {
   type SchemaContext,
   type SchemaRequirement,
 } from './pikku-schema.types.js'
-import { aiSchema } from './ai.schema.js'
+import { agentSchema } from './agent.schema.js'
 import { channelSchema } from './channel.schema.js'
 import { credentialSchema } from './credential.schema.js'
 import { deploymentSchema } from './deployment.schema.js'
@@ -53,7 +53,7 @@ export const pikkuSchemas: PikkuSchema[] = [
   deploymentSchema,
   webhookSchema,
   workflowSchema,
-  aiSchema,
+  agentSchema,
   scopeSchema,
 ]
 
@@ -62,8 +62,8 @@ export const pikkuSchemas: PikkuSchema[] = [
  *
  * The plugin is applied here rather than trusted to the caller. Declarations
  * name tables and columns the way the rest of the codebase queries them
- * (`aiThreads.resourceId`), and it is `CamelCasePlugin` that turns those into
- * the physical `ai_threads.resource_id`. Without it the same declaration
+ * (`agentThreads.resourceId`), and it is `CamelCasePlugin` that turns those into
+ * the physical `agent_threads.resource_id`. Without it the same declaration
  * silently creates quoted camelCase tables that nothing can read.
  */
 const bind = (db: Kysely<any>) => db.withPlugin(new CamelCasePlugin())

package/src/schema/schema.test.ts

@@ -60,13 +60,13 @@ describe('pikku runtime schema', () => {
   test('declares logical names and compiles them to physical ones', () => {
     const sql = compileFor('postgres')
 
-    // The declaration says `aiThreads.resourceId`, matching how every query in
-    // the package addresses it; the plugin is what makes the table `ai_threads`.
-    assert.match(sql, /create table "ai_threads"/)
+    // The declaration says `agentThreads.resourceId`, matching how every query in
+    // the package addresses it; the plugin is what makes the table `agent_threads`.
+    assert.match(sql, /create table "agent_threads"/)
     assert.match(sql, /"resource_id" varchar\(255\) not null/)
     assert.doesNotMatch(
       sql,
-      /"aiThreads"/,
+      /"agentThreads"/,
       'a camelCase table name means the plugin was not applied'
     )
   })
@@ -74,7 +74,7 @@ describe('pikku runtime schema', () => {
   test('rewrites foreign key targets too', () => {
     assert.match(
       compileFor('postgres'),
-      /references "ai_threads" \("id"\)/,
+      /references "agent_threads" \("id"\)/,
       'an unrewritten reference target points at a table that does not exist'
     )
   })
@@ -87,7 +87,7 @@ describe('pikku runtime schema', () => {
     }
   })
 
-  test('carries the ai_run column the two old declarations disagreed on', () => {
+  test('carries the agent_run column the two old declarations disagreed on', () => {
     assert.match(compileFor('postgres'), /"pending_approvals" text/)
   })
 

package/src/serialize-plugin.ts

@@ -231,8 +231,3 @@ export class SerializePlugin extends BaseSerializePlugin {
     super(serializer, deserializer, skipNodeKind)
   }
 }
-
-/**
- * @deprecated use {@link SerializePlugin} instead
- */
-export const SqliteSerializePlugin = SerializePlugin