@pikku/kysely 0.13.15 → 0.13.18

package/src/kysely-services.test.ts

@@ -13,8 +13,8 @@ import { KyselyEventHubStore } from './kysely-eventhub-store.js'
 import { KyselyWorkflowService } from './kysely-workflow-service.js'
 import { KyselyWorkflowRunService } from './kysely-workflow-run-service.js'
 import { KyselyDeploymentService } from './kysely-deployment-service.js'
-import { KyselyAIStorageService } from './kysely-ai-storage-service.js'
-import { KyselyAgentRunService } from './kysely-ai-agent-run-service.js'
+import { KyselyAgentStorageService } from './kysely-agent-storage-service.js'
+import { KyselyAgentRunService } from './kysely-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'
@@ -42,12 +42,12 @@ async function dropAllTables(db: Kysely<KyselyPikkuDB>): Promise<void> {
   const tables = [
     'pikku_deployment_functions',
     'pikku_deployments',
-    'ai_tool_call',
-    'ai_message',
-    'ai_run_score',
-    'ai_run',
-    'ai_working_memory',
-    'ai_threads',
+    'agent_tool_call',
+    'agent_message',
+    'agent_run_score',
+    'agent_run',
+    'agent_working_memory',
+    'agent_threads',
     'channel_subscriptions',
     'channels',
     'workflow_step_history',
@@ -97,8 +97,8 @@ function registerTests(
         await s.init()
         return s
       },
-      aiStorageService: async () => {
-        const s = new KyselyAIStorageService(getDb())
+      agentStorageService: async () => {
+        const s = new KyselyAgentStorageService(getDb())
         await s.init()
         return s
       },

package/src/kysely-session-store.ts

@@ -1,5 +1,5 @@
-import type { CoreUserSession } from '@pikku/core'
 import type { SessionStore } from '@pikku/core/services'
+import type { CoreUserSession } from '@pikku/core/types'
 import type { Kysely } from 'kysely'
 import type { KyselyPikkuDB } from './kysely-tables.js'
 import { parseJson } from './kysely-json.js'

package/src/kysely-tables.ts

@@ -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,7 +151,7 @@ export interface AIRunTable {
   updatedAt: Generated<Date>
 }
 
-export interface AIRunScoreTable {
+export interface AgentRunScoreTable {
   id: string
   runId: string
   scorerName: string
@@ -336,12 +336,12 @@ export interface KyselyPikkuDB {
   workflowStep: WorkflowStepTable
   workflowStepHistory: WorkflowStepHistoryTable
   workflowVersions: WorkflowVersionsTable
-  aiThreads: AIThreadsTable
-  aiMessage: AIMessageTable
-  aiToolCall: AIToolCallTable
-  aiWorkingMemory: AIWorkingMemoryTable
-  aiRun: AIRunTable
-  aiRunScore: AIRunScoreTable
+  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,7 +1,7 @@
 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,

package/src/kysely-webhook-service.test.ts

@@ -2,7 +2,7 @@ import { describe, test, beforeEach } from 'node:test'
 import assert from 'node:assert/strict'
 import { CamelCasePlugin, Kysely, SqliteDialect } from 'kysely'
 import Database from 'better-sqlite3'
-import { setSingletonServices } from '@pikku/core/ecosystem'
+import { setSingletonServices } from '@pikku/core/state'
 
 import type { KyselyPikkuDB } from './kysely-tables.js'
 import { SerializePlugin } from './serialize-plugin.js'

package/src/kysely-webhook-service.ts

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

package/src/kysely-workflow-mirror.ts

@@ -1,4 +1,4 @@
-import type { SerializedError } from '@pikku/core'
+import type { SerializedError } from '@pikku/core/errors'
 import type {
   StepState,
   WorkflowRunMirror,

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

@@ -428,4 +428,3 @@ describe('KyselyWorkflowService — a transition that addresses no history row',
     assert.equal(history[0]!.status, 'succeeded')
   })
 })
-

package/src/kysely-workflow-service.ts

@@ -1,14 +1,14 @@
-import type { SerializedError } from '@pikku/core'
-import {
-  PikkuWorkflowService,
-  type WorkflowPlannedStep,
-  type WorkflowQueueOptions,
-  type WorkflowRun,
-  type WorkflowRunWire,
-  type StepState,
-  type StepStatus,
-  type WorkflowStatus,
-  type WorkflowVersionStatus,
+import type { SerializedError } from '@pikku/core/errors'
+import { PikkuWorkflowService } from '@pikku/core/workflow'
+import type {
+  WorkflowPlannedStep,
+  WorkflowQueueOptions,
+  WorkflowRun,
+  WorkflowRunWire,
+  StepState,
+  StepStatus,
+  WorkflowStatus,
+  WorkflowVersionStatus,
 } from '@pikku/core/workflow'
 import { sql, type Kysely } from 'kysely'
 import type { KyselyPikkuDB } from './kysely-tables.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,16 +133,16 @@ 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('aiRunScore')
+        .createTable('agentRunScore')
         .addColumn('id', 'varchar(36)', (col) => col.primaryKey())
         .addColumn('runId', 'varchar(36)', (col) =>
-          col.notNull().references('aiRun.runId').onDelete('cascade')
+          col.notNull().references('agentRun.runId').onDelete('cascade')
         )
         .addColumn('scorerName', 'varchar(255)', (col) => col.notNull())
         .addColumn('score', 'real', (col) => col.notNull())
@@ -154,8 +154,8 @@ export const aiSchema: PikkuSchema = {
 
     (db) =>
       db.schema
-        .createIndex('idx_ai_run_score_run')
-        .on('aiRunScore')
+        .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