@pikku/core 0.12.83 → 0.12.84

package/src/services/index.ts

@@ -20,7 +20,7 @@ export {
 } from './queue-webhook-service.js'
 export { InMemoryQueueService } from './in-memory-queue-service.js'
 export { InMemoryTriggerService } from './in-memory-trigger-service.js'
-export { InMemoryAIRunStateService } from './in-memory-ai-run-state-service.js'
+export { InMemoryAgentRunStateService } from './in-memory-agent-run-state-service.js'
 export { LocalGatewayService } from './local-gateway-service.js'
 export type {
   ContentService,
@@ -77,19 +77,19 @@ export type {
   DeploymentInfo,
   DeploymentServiceConfig,
 } from './deployment-service.js'
-export type { AIStorageService } from './ai-storage-service.js'
+export type { AgentStorageService } from './agent-storage-service.js'
 export type {
-  AIAgentRunnerParams,
-  AIAgentRunnerResult,
-  AIAgentStepResult,
-  AIAgentRunnerService,
-} from './ai-agent-runner-service.js'
+  AgentRunnerParams,
+  AgentRunnerResult,
+  AgentStepResult,
+  AgentRunnerService,
+} from './agent-runner-service.js'
 export type { AIEmbeddingService } from './ai-embedding-service.js'
 export type {
   CreateRunInput,
   SaveScoreInput,
-  AIRunStateService,
-} from './ai-run-state-service.js'
+  AgentRunStateService,
+} from './agent-run-state-service.js'
 export type { CredentialMeta } from './typed-secret-service.js'
 export type { CredentialService } from './credential-service.js'
 export { TypedCredentialService } from './typed-credential-service.js'

package/src/services/meta-service.ts

@@ -30,7 +30,7 @@ import type {
   MiddlewareMetadata,
   PermissionMetadata,
 } from '../types/core.types.js'
-import type { AIAgentMeta } from '../wirings/ai-agent/ai-agent.types.js'
+import type { AgentsMeta } from '../wirings/agent/agent.types.js'
 import type { GatewaysMeta } from '../wirings/gateway/gateway.types.js'
 
 export type {
@@ -39,8 +39,8 @@ export type {
   MiddlewareMetadata as MiddlewareMeta,
   PermissionMetadata as PermissionMeta,
 }
-export type AgentsMeta = AIAgentMeta
-export type AgentMeta = AIAgentMeta[string]
+export type { AgentsMeta }
+export type AgentMeta = AgentsMeta[string]
 
 export interface MCPMeta {
   resources: MCPResourceMeta

package/src/testing/service-tests/agent-run-service-tests.ts

@@ -1,7 +1,7 @@
 import { describe, test, before } from 'node:test'
 import assert from 'node:assert/strict'
 
-import type { AgentRunService } from '../../wirings/ai-agent/ai-agent.types.js'
+import type { AgentRunService } from '../../wirings/agent/agent.types.js'
 import type { ServiceTestConfig } from '../service-tests.js'
 
 /** Conformance suite for `agentRunService`. Runs only when a backend supplies one. */
@@ -16,7 +16,7 @@ export const defineAgentRunServiceTests = (
    * only runs when a backend supplies both. Passed explicitly rather than
    * closed over, so the dependency is visible in the signature.
    */
-  aiStorageService?: ServiceTestConfig['services']['aiStorageService']
+  agentStorageService?: ServiceTestConfig['services']['agentStorageService']
 ): void => {
   const factory = agentRunService
   describe(`AgentRunService [${name}]`, () => {
@@ -31,8 +31,8 @@ export const defineAgentRunServiceTests = (
       assert.ok(Array.isArray(threads))
     })
 
-    if (aiStorageService) {
-      const storageFactory = aiStorageService
+    if (agentStorageService) {
+      const storageFactory = agentStorageService
 
       // The `owners` constraint is what keeps the generated thread-management
       // functions from leaking across tenants: a caller may only list threads

package/src/testing/service-tests/{ai-storage-service-tests.ts → agent-storage-service-tests.ts}

@@ -1,20 +1,20 @@
 import { describe, test, before } from 'node:test'
 import assert from 'node:assert/strict'
 
-import type { AIStorageService } from '../../services/ai-storage-service.js'
-import type { AIRunStateService } from '../../services/ai-run-state-service.js'
+import type { AgentStorageService } from '../../services/agent-storage-service.js'
+import type { AgentRunStateService } from '../../services/agent-run-state-service.js'
 import type { ServiceTestConfig } from '../service-tests.js'
 
-/** Conformance suite for `aiStorageService`. Runs only when a backend supplies one. */
+/** Conformance suite for `agentStorageService`. Runs only when a backend supplies one. */
 export const defineAiStorageServiceTests = (
   name: string,
-  aiStorageService: NonNullable<
-    ServiceTestConfig['services']['aiStorageService']
+  agentStorageService: NonNullable<
+    ServiceTestConfig['services']['agentStorageService']
   >
 ): void => {
-  const factory = aiStorageService
-  describe(`AIStorageService [${name}]`, () => {
-    let storage: AIStorageService & AIRunStateService
+  const factory = agentStorageService
+  describe(`AgentStorageService [${name}]`, () => {
+    let storage: AgentStorageService & AgentRunStateService
 
     before(async () => {
       storage = await factory()

package/src/testing/service-tests.ts

@@ -3,11 +3,11 @@ import type { EventHubStore } from '../wirings/channel/eventhub-store.js'
 import type { PikkuWorkflowService } from '../wirings/workflow/pikku-workflow-service.js'
 import type { WorkflowRunService } from '../wirings/workflow/workflow.types.js'
 import type { DeploymentService } from '../services/deployment-service.js'
-import type { AIStorageService } from '../services/ai-storage-service.js'
-import type { AIRunStateService } from '../services/ai-run-state-service.js'
+import type { AgentStorageService } from '../services/agent-storage-service.js'
+import type { AgentRunStateService } from '../services/agent-run-state-service.js'
 import type { SecretService } from '../services/secret-service.js'
 import type { CredentialService } from '../services/credential-service.js'
-import type { AgentRunService } from '../wirings/ai-agent/ai-agent.types.js'
+import type { AgentRunService } from '../wirings/agent/agent.types.js'
 import type { SessionStore } from '../services/session-store.js'
 
 export interface ServiceTestConfig {
@@ -20,7 +20,9 @@ export interface ServiceTestConfig {
     deploymentService?: () => Promise<
       DeploymentService & { stop(): Promise<void> }
     >
-    aiStorageService?: () => Promise<AIStorageService & AIRunStateService>
+    agentStorageService?: () => Promise<
+      AgentStorageService & AgentRunStateService
+    >
     agentRunService?: () => Promise<AgentRunService>
     secretService?: (config: {
       key: string
@@ -40,7 +42,7 @@ import { defineChannelStoreTests } from './service-tests/channel-store-tests.js'
 import { defineEventHubStoreTests } from './service-tests/event-hub-store-tests.js'
 import { defineWorkflowServiceTests } from './service-tests/workflow-service-tests.js'
 import { defineWorkflowRunServiceTests } from './service-tests/workflow-run-service-tests.js'
-import { defineAiStorageServiceTests } from './service-tests/ai-storage-service-tests.js'
+import { defineAiStorageServiceTests } from './service-tests/agent-storage-service-tests.js'
 import { defineDeploymentServiceTests } from './service-tests/deployment-service-tests.js'
 import { defineSecretServiceTests } from './service-tests/secret-service-tests.js'
 import { defineCredentialServiceTests } from './service-tests/credential-service-tests.js'
@@ -68,8 +70,8 @@ export function defineServiceTests(config: ServiceTestConfig): void {
   if (services.workflowRunService) {
     defineWorkflowRunServiceTests(name, services.workflowRunService)
   }
-  if (services.aiStorageService) {
-    defineAiStorageServiceTests(name, services.aiStorageService)
+  if (services.agentStorageService) {
+    defineAiStorageServiceTests(name, services.agentStorageService)
   }
   if (services.deploymentService) {
     defineDeploymentServiceTests(name, services.deploymentService)
@@ -84,7 +86,7 @@ export function defineServiceTests(config: ServiceTestConfig): void {
     defineAgentRunServiceTests(
       name,
       services.agentRunService,
-      services.aiStorageService
+      services.agentStorageService
     )
   }
   if (services.sessionStore) {

package/src/types/core.types.ts

@@ -33,19 +33,19 @@ import type { PikkuTrigger } from '../wirings/trigger/trigger.types.js'
 import type { PikkuGateway } from '../wirings/gateway/gateway.types.js'
 import type { SchedulerService } from '../services/scheduler-service.js'
 import type { DeploymentService } from '../services/deployment-service.js'
-import type { AIStorageService } from '../services/ai-storage-service.js'
+import type { AgentStorageService } from '../services/agent-storage-service.js'
 
 import type { ContentService } from '../services/content-service.js'
 import type {
   ScenarioPersonaOf,
   ScenarioPersonas,
 } from '../services/personas-service.js'
-import type { AIAgentRunnerService } from '../services/ai-agent-runner-service.js'
+import type { AgentRunnerService } from '../services/agent-runner-service.js'
 import type { AIEmbeddingService } from '../services/ai-embedding-service.js'
-import type { AIRunStateService } from '../services/ai-run-state-service.js'
-import type { AgentRunService } from '../wirings/ai-agent/ai-agent.types.js'
+import type { AgentRunStateService } from '../services/agent-run-state-service.js'
+import type { AgentRunService } from '../wirings/agent/agent.types.js'
 import type { VirtualUserRunStore } from '../wirings/virtual-user/virtual-user-run-store.js'
-import type { PikkuAIMiddlewareHooks } from '../wirings/ai-agent/ai-agent.types.js'
+import type { PikkuAgentMiddlewareHooks } from '../wirings/agent/agent.types.js'
 import type { WorkflowRunService } from '../wirings/workflow/workflow.types.js'
 import type { CredentialService } from '../services/credential-service.js'
 import type { EmailService } from '../services/email-service.js'
@@ -325,12 +325,12 @@ export interface CoreSingletonServices<Config extends CoreConfig = CoreConfig> {
   eventHub?: EventHubService<Record<string, any>>
   schedulerService?: SchedulerService
   deploymentService?: DeploymentService
-  aiStorage?: AIStorageService
+  agentStorage?: AgentStorageService
 
   content?: ContentService
-  aiAgentRunner?: AIAgentRunnerService
+  agentRunner?: AgentRunnerService
   aiEmbedding?: AIEmbeddingService
-  aiRunState?: AIRunStateService
+  agentRunState?: AgentRunStateService
   agentRunService?: AgentRunService
   workflowRunService?: WorkflowRunService
   credentialService?: CredentialService
@@ -547,14 +547,14 @@ export const pikkuChannelMiddlewareFactory = <In = any>(
   return factory
 }
 
-export type { PikkuAIMiddlewareHooks } from '../wirings/ai-agent/ai-agent.types.js'
+export type { PikkuAgentMiddlewareHooks } from '../wirings/agent/agent.types.js'
 
-export const pikkuAIMiddleware = <
+export const pikkuAgentMiddleware = <
   State extends Record<string, unknown> = Record<string, unknown>,
   SingletonServices extends CoreSingletonServices = CoreSingletonServices,
 >(
-  hooks: PikkuAIMiddlewareHooks<State, SingletonServices>
-): PikkuAIMiddlewareHooks<State, SingletonServices> => hooks
+  hooks: PikkuAgentMiddlewareHooks<State, SingletonServices>
+): PikkuAgentMiddlewareHooks<State, SingletonServices> => hooks
 
 export type CoreServices<SingletonServices = CoreSingletonServices> =
   SingletonServices

package/src/types/state.types.ts

@@ -25,14 +25,11 @@ import type {
   CoreMCPPrompt,
   MCPPromptMeta,
 } from '../wirings/mcp/mcp.types.js'
+import type { CoreAgent, AgentsMeta } from '../wirings/agent/agent.types.js'
 import type {
-  CoreAIAgent,
-  AIAgentMeta,
-} from '../wirings/ai-agent/ai-agent.types.js'
-import type {
-  PikkuAIScorer,
+  PikkuAgentScorer,
   ScorerMeta,
-} from '../wirings/ai-scorer/ai-scorer.types.js'
+} from '../wirings/agent-scorer/agent-scorer.types.js'
 import type {
   CoreGateway,
   GatewaysMeta,
@@ -163,9 +160,9 @@ export interface PikkuPackageState {
     promptsMeta: MCPPromptMeta
   }
   agent: {
-    agents: Map<string, CoreAIAgent>
-    agentsMeta: AIAgentMeta
-    scorers: Map<string, PikkuAIScorer>
+    agents: Map<string, CoreAgent>
+    agentsMeta: AgentsMeta
+    scorers: Map<string, PikkuAgentScorer>
     scorersMeta: ScorerMeta
     /** Alias -> `provider/model`, from the `models` table in pikku.config.json. */
     modelAliases: Record<string, string>

package/src/wirings/actor-flow/run-conversation.test.ts

@@ -7,9 +7,9 @@ import type {
   TargetAgentReply,
   ActorFlowApprovalPolicy,
 } from './actor-flow.types.js'
-import type { AIAgentStepResult } from '../../services/ai-agent-runner-service.js'
+import type { AgentStepResult } from '../../services/agent-runner-service.js'
 
-const stepResult = (object: unknown): AIAgentStepResult => ({
+const stepResult = (object: unknown): AgentStepResult => ({
   text: '',
   object,
   toolCalls: [],

package/src/wirings/actor-flow/run-conversation.ts

@@ -5,11 +5,11 @@ import type {
   TargetPendingApproval,
 } from './actor-flow.types.js'
 import type { ResolvedPersona } from '../../services/personas-service.js'
-import type { AIMessage } from '../ai-agent/ai-agent.types.js'
+import type { AgentMessage } from '../agent/agent.types.js'
 import type {
-  AIAgentRunnerParams,
-  AIAgentStepResult,
-} from '../../services/ai-agent-runner-service.js'
+  AgentRunnerParams,
+  AgentStepResult,
+} from '../../services/agent-runner-service.js'
 
 /** One turn the actor takes: the message to send and whether it's finished. */
 const ACTOR_TURN_SCHEMA = {
@@ -56,9 +56,7 @@ const DEFAULT_MAX_TURNS = 12
 const DEFAULT_MAX_APPROVAL_ROUNDS = 16
 
 /** The LLM call the actor uses for its own turns/decisions/evaluation. */
-export type ActorLLM = (
-  params: AIAgentRunnerParams
-) => Promise<AIAgentStepResult>
+export type ActorLLM = (params: AgentRunnerParams) => Promise<AgentStepResult>
 
 export interface RunConversationParams {
   /** The person being played — name, job title, personality. */
@@ -85,7 +83,7 @@ export interface RunConversationParams {
   agentName: string
 }
 
-function msg(role: AIMessage['role'], content: string): AIMessage {
+function msg(role: AgentMessage['role'], content: string): AgentMessage {
   return {
     id: globalThis.crypto.randomUUID(),
     role,
@@ -221,7 +219,7 @@ export async function runConversation(
   // Seed a kickoff so the very first actor turn has a non-empty message list
   // (providers reject an empty prompt). It's an instruction TO the actor, so
   // it never appears in the transcript.
-  const actorMessages: AIMessage[] = [
+  const actorMessages: AgentMessage[] = [
     msg(
       'user',
       'Begin the conversation now — send your first message to the assistant to work towards your goal.'