@lota-sdk/core 0.1.15 → 0.1.16

package/infrastructure/schema/00_identity.surql

@@ -1,4 +1,3 @@
-# SDK identity tables.
 DEFINE TABLE IF NOT EXISTS organization SCHEMAFULL;
 DEFINE FIELD IF NOT EXISTS name ON TABLE organization TYPE string;
 DEFINE FIELD IF NOT EXISTS regularChatDigestLastWorkstreamCursorCreatedAt ON TABLE organization TYPE option<datetime>;
@@ -14,7 +13,6 @@ DEFINE FIELD IF NOT EXISTS email ON TABLE user TYPE string;
 DEFINE FIELD IF NOT EXISTS createdAt ON TABLE user TYPE datetime DEFAULT time::now() READONLY;
 DEFINE FIELD IF NOT EXISTS updatedAt ON TABLE user TYPE datetime VALUE time::now();
 
-DEFINE INDEX IF NOT EXISTS sdkUserEmailIdx ON TABLE user COLUMNS email;
 
 DEFINE TABLE IF NOT EXISTS organizationMember SCHEMAFULL TYPE RELATION IN user OUT organization;
 DEFINE FIELD IF NOT EXISTS in ON TABLE organizationMember TYPE record<user>;

package/infrastructure/schema/01_memory.surql

@@ -14,7 +14,7 @@ DEFINE FIELD IF NOT EXISTS importance ON TABLE memory TYPE float DEFAULT 1.0;
 DEFINE FIELD IF NOT EXISTS accessCount ON TABLE memory TYPE int DEFAULT 0;
 DEFINE FIELD IF NOT EXISTS lastAccessedAt ON TABLE memory TYPE option<datetime>;
 DEFINE FIELD IF NOT EXISTS createdAt ON TABLE memory TYPE datetime DEFAULT time::now() READONLY;
-DEFINE FIELD IF NOT EXISTS updatedAt ON TABLE memory TYPE option<datetime>;
+DEFINE FIELD IF NOT EXISTS updatedAt ON TABLE memory TYPE option<datetime> VALUE time::now();
 DEFINE FIELD IF NOT EXISTS validFrom ON TABLE memory TYPE datetime DEFAULT time::now();
 DEFINE FIELD IF NOT EXISTS validUntil ON TABLE memory TYPE option<datetime>;
 DEFINE FIELD IF NOT EXISTS archivedAt ON TABLE memory TYPE option<datetime>;

package/infrastructure/schema/02_execution_plan.surql

@@ -17,11 +17,17 @@ DEFINE FIELD IF NOT EXISTS edges.*.target ON TABLE planSpec TYPE string;
 DEFINE FIELD IF NOT EXISTS edges.*.when ON TABLE planSpec TYPE option<string>;
 DEFINE FIELD IF NOT EXISTS edges.*.map ON TABLE planSpec TYPE object FLEXIBLE DEFAULT {};
 DEFINE FIELD IF NOT EXISTS entryNodeIds ON TABLE planSpec TYPE array<string>;
+DEFINE FIELD IF NOT EXISTS executionMode ON TABLE planSpec TYPE string DEFAULT 'linear';
+DEFINE FIELD IF NOT EXISTS contextEnrichments ON TABLE planSpec TYPE option<array<object>> FLEXIBLE;
+DEFINE FIELD OVERWRITE contextEnrichments.* ON TABLE planSpec TYPE object FLEXIBLE;
+DEFINE FIELD IF NOT EXISTS schedule ON TABLE planSpec TYPE option<object> FLEXIBLE;
+DEFINE FIELD IF NOT EXISTS dependencies ON TABLE planSpec TYPE option<array>;
 DEFINE FIELD IF NOT EXISTS replacedSpecId ON TABLE planSpec TYPE option<record<planSpec>>;
 DEFINE FIELD IF NOT EXISTS createdAt ON TABLE planSpec TYPE datetime DEFAULT time::now() READONLY;
 DEFINE FIELD IF NOT EXISTS updatedAt ON TABLE planSpec TYPE datetime VALUE time::now();
 DEFINE FIELD IF NOT EXISTS compiledAt ON TABLE planSpec TYPE option<datetime>;
 
+DEFINE INDEX IF NOT EXISTS planSpecOrgIdx ON TABLE planSpec COLUMNS organizationId;
 DEFINE INDEX IF NOT EXISTS planSpecWorkstreamIdx ON TABLE planSpec COLUMNS workstreamId;
 DEFINE INDEX IF NOT EXISTS planSpecWorkstreamStatusIdx ON TABLE planSpec COLUMNS workstreamId, status;
 
@@ -59,6 +65,11 @@ DEFINE FIELD IF NOT EXISTS failurePolicy.*.note ON TABLE planNodeSpec TYPE strin
 DEFINE FIELD IF NOT EXISTS timeoutMs ON TABLE planNodeSpec TYPE option<int>;
 DEFINE FIELD IF NOT EXISTS toolPolicy ON TABLE planNodeSpec TYPE object FLEXIBLE;
 DEFINE FIELD IF NOT EXISTS contextPolicy ON TABLE planNodeSpec TYPE object FLEXIBLE;
+DEFINE FIELD IF NOT EXISTS schedule ON TABLE planNodeSpec TYPE option<object> FLEXIBLE;
+DEFINE FIELD IF NOT EXISTS deadline ON TABLE planNodeSpec TYPE option<object> FLEXIBLE;
+DEFINE FIELD IF NOT EXISTS monitoringConfig ON TABLE planNodeSpec TYPE option<object> FLEXIBLE;
+DEFINE FIELD IF NOT EXISTS delayAfterPredecessorMs ON TABLE planNodeSpec TYPE option<int>;
+DEFINE FIELD IF NOT EXISTS deliberationConfig ON TABLE planNodeSpec TYPE option<object> FLEXIBLE;
 DEFINE FIELD IF NOT EXISTS upstreamNodeIds ON TABLE planNodeSpec TYPE array<string> DEFAULT [];
 DEFINE FIELD IF NOT EXISTS downstreamNodeIds ON TABLE planNodeSpec TYPE array<string> DEFAULT [];
 DEFINE FIELD IF NOT EXISTS createdAt ON TABLE planNodeSpec TYPE datetime DEFAULT time::now() READONLY;
@@ -80,11 +91,14 @@ DEFINE FIELD IF NOT EXISTS readyNodeIds ON TABLE planRun TYPE array<string> DEFA
 DEFINE FIELD IF NOT EXISTS failureCount ON TABLE planRun TYPE int DEFAULT 0;
 DEFINE FIELD IF NOT EXISTS replacedRunId ON TABLE planRun TYPE option<record<planRun>>;
 DEFINE FIELD IF NOT EXISTS lastCheckpointId ON TABLE planRun TYPE option<record<planCheckpoint>>;
+DEFINE FIELD IF NOT EXISTS scheduledAt ON TABLE planRun TYPE option<datetime>;
+DEFINE FIELD IF NOT EXISTS scheduleId ON TABLE planRun TYPE option<record<planSchedule>>;
 DEFINE FIELD IF NOT EXISTS createdAt ON TABLE planRun TYPE datetime DEFAULT time::now() READONLY;
 DEFINE FIELD IF NOT EXISTS updatedAt ON TABLE planRun TYPE datetime VALUE time::now();
 DEFINE FIELD IF NOT EXISTS startedAt ON TABLE planRun TYPE option<datetime>;
 DEFINE FIELD IF NOT EXISTS completedAt ON TABLE planRun TYPE option<datetime>;
 
+DEFINE INDEX IF NOT EXISTS planRunOrgIdx ON TABLE planRun COLUMNS organizationId;
 DEFINE INDEX IF NOT EXISTS planRunWorkstreamIdx ON TABLE planRun COLUMNS workstreamId;
 DEFINE INDEX IF NOT EXISTS planRunWorkstreamStatusIdx ON TABLE planRun COLUMNS workstreamId, status;
 DEFINE INDEX IF NOT EXISTS planRunSpecIdx ON TABLE planRun COLUMNS planSpecId;
@@ -102,6 +116,7 @@ DEFINE FIELD IF NOT EXISTS latestNotes ON TABLE planNodeRun TYPE option<string>;
 DEFINE FIELD IF NOT EXISTS latestAttemptId ON TABLE planNodeRun TYPE option<record<planNodeAttempt>>;
 DEFINE FIELD IF NOT EXISTS blockedReason ON TABLE planNodeRun TYPE option<string>;
 DEFINE FIELD IF NOT EXISTS failureClass ON TABLE planNodeRun TYPE option<string>;
+DEFINE FIELD IF NOT EXISTS scheduledAt ON TABLE planNodeRun TYPE option<datetime>;
 DEFINE FIELD IF NOT EXISTS readyAt ON TABLE planNodeRun TYPE option<datetime>;
 DEFINE FIELD IF NOT EXISTS startedAt ON TABLE planNodeRun TYPE option<datetime>;
 DEFINE FIELD IF NOT EXISTS completedAt ON TABLE planNodeRun TYPE option<datetime>;
@@ -137,7 +152,7 @@ DEFINE FIELD IF NOT EXISTS kind ON TABLE planArtifact TYPE string;
 DEFINE FIELD IF NOT EXISTS pointer ON TABLE planArtifact TYPE string;
 DEFINE FIELD IF NOT EXISTS schemaRef ON TABLE planArtifact TYPE option<string>;
 DEFINE FIELD IF NOT EXISTS description ON TABLE planArtifact TYPE option<string>;
-DEFINE FIELD IF NOT EXISTS payload ON TABLE planArtifact TYPE option<object | array> FLEXIBLE;
+DEFINE FIELD IF NOT EXISTS payload ON TABLE planArtifact TYPE option<object> FLEXIBLE;
 DEFINE FIELD IF NOT EXISTS createdAt ON TABLE planArtifact TYPE datetime DEFAULT time::now() READONLY;
 
 DEFINE INDEX IF NOT EXISTS planArtifactRunIdx ON TABLE planArtifact COLUMNS runId;
@@ -210,3 +225,49 @@ DEFINE FIELD IF NOT EXISTS createdAt ON TABLE planEvent TYPE datetime DEFAULT ti
 DEFINE INDEX IF NOT EXISTS planEventRunIdx ON TABLE planEvent COLUMNS runId;
 DEFINE INDEX IF NOT EXISTS planEventRunNodeIdx ON TABLE planEvent COLUMNS runId, nodeId;
 DEFINE INDEX IF NOT EXISTS planEventRunTimeIdx ON TABLE planEvent COLUMNS runId, createdAt;
+
+DEFINE TABLE IF NOT EXISTS planSchedule SCHEMAFULL;
+DEFINE FIELD IF NOT EXISTS organizationId ON TABLE planSchedule TYPE record<organization>;
+DEFINE FIELD IF NOT EXISTS workstreamId ON TABLE planSchedule TYPE record<workstream> REFERENCE ON DELETE CASCADE;
+DEFINE FIELD IF NOT EXISTS planSpecId ON TABLE planSchedule TYPE option<record<planSpec>>;
+DEFINE FIELD IF NOT EXISTS runId ON TABLE planSchedule TYPE option<record<planRun>>;
+DEFINE FIELD IF NOT EXISTS nodeId ON TABLE planSchedule TYPE option<string>;
+DEFINE FIELD IF NOT EXISTS scheduleSpec ON TABLE planSchedule TYPE object FLEXIBLE;
+DEFINE FIELD IF NOT EXISTS status ON TABLE planSchedule TYPE string;
+DEFINE FIELD IF NOT EXISTS fireCount ON TABLE planSchedule TYPE int DEFAULT 0;
+DEFINE FIELD IF NOT EXISTS nextFireAt ON TABLE planSchedule TYPE option<datetime>;
+DEFINE FIELD IF NOT EXISTS lastFiredAt ON TABLE planSchedule TYPE option<datetime>;
+DEFINE FIELD IF NOT EXISTS createdAt ON TABLE planSchedule TYPE datetime DEFAULT time::now() READONLY;
+DEFINE FIELD IF NOT EXISTS updatedAt ON TABLE planSchedule TYPE datetime VALUE time::now();
+DEFINE INDEX IF NOT EXISTS planScheduleStatusIdx ON TABLE planSchedule COLUMNS status;
+DEFINE INDEX IF NOT EXISTS planScheduleNextFireIdx ON TABLE planSchedule COLUMNS status, nextFireAt;
+DEFINE INDEX IF NOT EXISTS planScheduleWorkstreamIdx ON TABLE planSchedule COLUMNS workstreamId;
+
+DEFINE TABLE IF NOT EXISTS planTemplate SCHEMAFULL;
+DEFINE FIELD IF NOT EXISTS organizationId ON TABLE planTemplate TYPE record<organization>;
+DEFINE FIELD IF NOT EXISTS name ON TABLE planTemplate TYPE string;
+DEFINE FIELD IF NOT EXISTS description ON TABLE planTemplate TYPE option<string>;
+DEFINE FIELD IF NOT EXISTS draft ON TABLE planTemplate TYPE object FLEXIBLE;
+DEFINE FIELD IF NOT EXISTS tags ON TABLE planTemplate TYPE array DEFAULT [];
+DEFINE FIELD IF NOT EXISTS source ON TABLE planTemplate TYPE string DEFAULT 'user';
+DEFINE FIELD IF NOT EXISTS sourceRef ON TABLE planTemplate TYPE option<string>;
+DEFINE FIELD IF NOT EXISTS createdAt ON TABLE planTemplate TYPE datetime DEFAULT time::now() READONLY;
+DEFINE FIELD IF NOT EXISTS updatedAt ON TABLE planTemplate TYPE datetime VALUE time::now();
+DEFINE INDEX IF NOT EXISTS planTemplateOrgIdx ON TABLE planTemplate COLUMNS organizationId;
+DEFINE INDEX IF NOT EXISTS planTemplateOrgNameIdx ON TABLE planTemplate COLUMNS organizationId, name UNIQUE;
+
+DEFINE TABLE IF NOT EXISTS planCycle SCHEMAFULL;
+DEFINE FIELD IF NOT EXISTS organizationId ON TABLE planCycle TYPE record<organization>;
+DEFINE FIELD IF NOT EXISTS workstreamId ON TABLE planCycle TYPE record<workstream> REFERENCE ON DELETE CASCADE;
+DEFINE FIELD IF NOT EXISTS templateId ON TABLE planCycle TYPE record<planTemplate>;
+DEFINE FIELD IF NOT EXISTS name ON TABLE planCycle TYPE string;
+DEFINE FIELD IF NOT EXISTS schedule ON TABLE planCycle TYPE object FLEXIBLE;
+DEFINE FIELD IF NOT EXISTS carryForwardPolicy ON TABLE planCycle TYPE string DEFAULT 'incomplete-only';
+DEFINE FIELD IF NOT EXISTS status ON TABLE planCycle TYPE string;
+DEFINE FIELD IF NOT EXISTS currentIteration ON TABLE planCycle TYPE int DEFAULT 0;
+DEFINE FIELD IF NOT EXISTS currentRunId ON TABLE planCycle TYPE option<record<planRun>>;
+DEFINE FIELD IF NOT EXISTS scheduleId ON TABLE planCycle TYPE option<record<planSchedule>>;
+DEFINE FIELD IF NOT EXISTS createdAt ON TABLE planCycle TYPE datetime DEFAULT time::now() READONLY;
+DEFINE FIELD IF NOT EXISTS updatedAt ON TABLE planCycle TYPE datetime VALUE time::now();
+DEFINE INDEX IF NOT EXISTS planCycleWorkstreamIdx ON TABLE planCycle COLUMNS workstreamId;
+DEFINE INDEX IF NOT EXISTS planCycleStatusIdx ON TABLE planCycle COLUMNS status;

package/infrastructure/schema/03_learned_skill.surql

@@ -19,7 +19,7 @@ DEFINE FIELD IF NOT EXISTS supersedes ON TABLE learnedSkill TYPE option<record<l
 DEFINE FIELD IF NOT EXISTS embedding ON TABLE learnedSkill TYPE array<float>;
 DEFINE FIELD IF NOT EXISTS hash ON TABLE learnedSkill TYPE string;
 DEFINE FIELD IF NOT EXISTS createdAt ON TABLE learnedSkill TYPE datetime DEFAULT time::now() READONLY;
-DEFINE FIELD IF NOT EXISTS updatedAt ON TABLE learnedSkill TYPE option<datetime>;
+DEFINE FIELD IF NOT EXISTS updatedAt ON TABLE learnedSkill TYPE option<datetime> VALUE time::now();
 DEFINE FIELD IF NOT EXISTS lastUsedAt ON TABLE learnedSkill TYPE option<datetime>;
 DEFINE FIELD IF NOT EXISTS archivedAt ON TABLE learnedSkill TYPE option<datetime>;
 

package/infrastructure/schema/06_playbook.surql

@@ -0,0 +1,25 @@
+# Playbook tables for compound intelligence.
+
+DEFINE TABLE IF NOT EXISTS playbook SCHEMAFULL;
+DEFINE FIELD IF NOT EXISTS organizationId ON TABLE playbook TYPE record<organization>;
+DEFINE FIELD IF NOT EXISTS name ON TABLE playbook TYPE string;
+DEFINE FIELD IF NOT EXISTS objective ON TABLE playbook TYPE string;
+DEFINE FIELD IF NOT EXISTS currentVersionId ON TABLE playbook TYPE record<playbookVersion>;
+DEFINE FIELD IF NOT EXISTS previousVersionId ON TABLE playbook TYPE option<record<playbookVersion>>;
+DEFINE FIELD IF NOT EXISTS cycleCount ON TABLE playbook TYPE int DEFAULT 0;
+DEFINE FIELD IF NOT EXISTS createdAt ON TABLE playbook TYPE datetime DEFAULT time::now() READONLY;
+DEFINE FIELD IF NOT EXISTS updatedAt ON TABLE playbook TYPE datetime VALUE time::now();
+
+DEFINE INDEX IF NOT EXISTS playbookOrgIdx ON TABLE playbook COLUMNS organizationId;
+
+DEFINE TABLE IF NOT EXISTS playbookVersion SCHEMAFULL;
+DEFINE FIELD IF NOT EXISTS playbookId ON TABLE playbookVersion TYPE record<playbook> REFERENCE ON DELETE CASCADE;
+DEFINE FIELD IF NOT EXISTS version ON TABLE playbookVersion TYPE int;
+DEFINE FIELD IF NOT EXISTS parentVersionId ON TABLE playbookVersion TYPE option<record<playbookVersion>>;
+DEFINE FIELD IF NOT EXISTS appliedRecommendations ON TABLE playbookVersion TYPE array<string> DEFAULT [];
+DEFINE FIELD IF NOT EXISTS qualityScore ON TABLE playbookVersion TYPE option<float>;
+DEFINE FIELD IF NOT EXISTS status ON TABLE playbookVersion TYPE string;
+DEFINE FIELD IF NOT EXISTS createdAt ON TABLE playbookVersion TYPE datetime DEFAULT time::now() READONLY;
+
+DEFINE INDEX IF NOT EXISTS playbookVersionPlaybookIdx ON TABLE playbookVersion COLUMNS playbookId;
+DEFINE INDEX IF NOT EXISTS playbookVersionUniqueIdx ON TABLE playbookVersion COLUMNS playbookId, version UNIQUE;

package/infrastructure/schema/07_institutional_memory.surql

@@ -0,0 +1,13 @@
+# Institutional memory for compound intelligence.
+
+DEFINE TABLE IF NOT EXISTS institutionalMemory SCHEMAFULL;
+DEFINE FIELD IF NOT EXISTS organizationId ON TABLE institutionalMemory TYPE record<organization>;
+DEFINE FIELD IF NOT EXISTS type ON TABLE institutionalMemory TYPE string;
+DEFINE FIELD IF NOT EXISTS pattern ON TABLE institutionalMemory TYPE object FLEXIBLE;
+DEFINE FIELD IF NOT EXISTS confidence ON TABLE institutionalMemory TYPE float;
+DEFINE FIELD IF NOT EXISTS sampleCount ON TABLE institutionalMemory TYPE int;
+DEFINE FIELD IF NOT EXISTS createdAt ON TABLE institutionalMemory TYPE datetime DEFAULT time::now() READONLY;
+DEFINE FIELD IF NOT EXISTS updatedAt ON TABLE institutionalMemory TYPE datetime VALUE time::now();
+
+DEFINE INDEX IF NOT EXISTS institutionalMemoryOrgIdx ON TABLE institutionalMemory COLUMNS organizationId;
+DEFINE INDEX IF NOT EXISTS institutionalMemoryOrgTypeIdx ON TABLE institutionalMemory COLUMNS organizationId, type;

package/infrastructure/schema/08_quality_metrics.surql

@@ -0,0 +1,17 @@
+# Quality metrics for compound intelligence.
+
+DEFINE TABLE IF NOT EXISTS qualityMetric SCHEMAFULL;
+DEFINE FIELD IF NOT EXISTS organizationId ON TABLE qualityMetric TYPE record<organization>;
+DEFINE FIELD IF NOT EXISTS runId ON TABLE qualityMetric TYPE record<planRun>;
+DEFINE FIELD IF NOT EXISTS nodeId ON TABLE qualityMetric TYPE option<string>;
+DEFINE FIELD IF NOT EXISTS ownerRef ON TABLE qualityMetric TYPE string;
+DEFINE FIELD IF NOT EXISTS ownerType ON TABLE qualityMetric TYPE string;
+DEFINE FIELD IF NOT EXISTS nodeType ON TABLE qualityMetric TYPE string;
+DEFINE FIELD IF NOT EXISTS executionTimeMs ON TABLE qualityMetric TYPE int;
+DEFINE FIELD IF NOT EXISTS attemptCount ON TABLE qualityMetric TYPE int;
+DEFINE FIELD IF NOT EXISTS artifactCount ON TABLE qualityMetric TYPE int;
+DEFINE FIELD IF NOT EXISTS validationIssueCount ON TABLE qualityMetric TYPE int;
+DEFINE FIELD IF NOT EXISTS createdAt ON TABLE qualityMetric TYPE datetime DEFAULT time::now() READONLY;
+
+DEFINE INDEX IF NOT EXISTS qualityMetricOrgIdx ON TABLE qualityMetric COLUMNS organizationId;
+DEFINE INDEX IF NOT EXISTS qualityMetricRunIdx ON TABLE qualityMetric COLUMNS runId;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lota-sdk/core",
-  "version": "0.1.15",
+  "version": "0.1.16",
   "type": "module",
   "main": "./src/index.ts",
   "types": "./src/index.ts",
@@ -28,14 +28,15 @@
   },
   "dependencies": {
     "@ai-sdk/devtools": "^0.0.15",
-    "@ai-sdk/openai": "^3.0.47",
-    "@logtape/logtape": "^2.0.4",
-    "@lota-sdk/shared": "0.1.15",
-    "@mendable/firecrawl-js": "^4.16.0",
+    "@ai-sdk/openai": "^3.0.48",
+    "@logtape/logtape": "^2.0.5",
+    "@lota-sdk/shared": "0.1.16",
+    "@mendable/firecrawl-js": "^4.17.0",
     "@surrealdb/node": "^3.0.3",
-    "ai": "^6.0.134",
+    "ai": "^6.0.137",
     "bullmq": "^5.71.0",
-    "hono": "^4.12.8",
+    "cron-parser": "^5.5.0",
+    "hono": "^4.12.9",
     "ioredis": "5.9.3",
     "mammoth": "^1.12.0",
     "pdf-parse": "^2.4.5",

package/src/ai/definitions.ts

@@ -50,7 +50,6 @@ export function renderSkillInstructions(skills: readonly SkillDefinition[]): str
   return ['<skills>', ...sections, '</skills>'].join('\n\n')
 }
 
-/** @lintignore */
 export interface LearnedSkillEntry {
   name: string
   instructions: string
@@ -173,7 +172,7 @@ Do NOT use when:
 - For broad research, call 2-3 \`researchTopic\` instances **in parallel** with different focused tasks (e.g., one for market sizing, one for competitor analysis, one for pricing benchmarks).
 - Each \`researchTopic\` call returns a synthesized markdown report with sources — you do not need to search or fetch pages yourself.
 - Use \`fetchWebpage\` **only** when the user shares a specific URL they want you to read. Do not use it for general research.
-- Use \`inspectWebsite\` when the user wants a structured analysis of a specific website or landing page. Give it the exact URL and what you need to learn from the page.
+- Use \`inspectWebsite\` when the user wants a structured analysis of a specific website or landing page. Pass the exact URL in the tool's \`url\` field and the learning goal in \`task\`.
 - When the user asks to refresh, re-run, or overwrite existing website extraction, call \`inspectWebsite\` with \`forceRefresh: true\`.
 </how-to-research>
 
@@ -201,6 +200,85 @@ Do NOT use when:
 </output-structure>`,
 })
 
+const surrealDbSkillTools = [] as const
+
+export const surrealDbSkill = defineSkill({
+  name: 'surrealdb',
+  description:
+    'Design and query SurrealDB correctly for Lota SDK tables, record IDs, relations, vector indexes, full-text search, and DB-boundary rules. Use this whenever the task touches SurrealQL schema files, DB services, query patterns, or SurrealDB modeling decisions.',
+  tools: surrealDbSkillTools,
+  instructions: `# surrealdb
+
+## Description
+
+Use this skill for any Lota SDK task that changes SurrealQL schema files, DB services, record IDs, relations, vector search, or full-text search.
+
+## Details
+
+<schema-rules>
+- Default schema files to \`IF NOT EXISTS\`. Do not add migration DML, compatibility branches, or fallback logic.
+- Avoid \`OVERWRITE\` unless SurrealDB itself requires a specific wildcard exception on a fresh database shape, such as \`workstreamMessage.parts.*\` or \`planSpec.contextEnrichments.*\`.
+- Treat the database as fresh. Replace incorrect definitions directly instead of layering migrations.
+- Let SurrealDB own \`updatedAt\` when the schema uses \`VALUE time::now()\`. Do not write that field from application code.
+- Keep flexible object fields explicit, for example \`TYPE option<object> FLEXIBLE\` or \`TYPE array<object> FLEXIBLE\`.
+</schema-rules>
+
+<id-rules>
+- Keep DB-boundary record IDs structural. Normalize \`string | { tb, id }\` inputs at the SDK boundary instead of relying on nominal \`RecordId\` identity across packages.
+- Use array/object record IDs only when exact-key lookup or record-range access is the real model requirement. Do not invent composite IDs for ordinary references.
+- Parameterize record IDs and all user-controlled values with bindings. Never concatenate them into SurrealQL.
+- \`NONE\` removes a field. \`null\` stores a real NULL value. JavaScript \`null\` is not a synonym for \`NONE\`.
+- For JavaScript SDK mutation payloads (\`create\`, \`update\`, \`upsert\`, \`insert\`, \`content\`, \`merge\`), clear top-level optional fields by omitting them or using \`undefined\`. Use explicit raw \`NONE\` only when you are writing bound SurrealQL directly.
+</id-rules>
+
+<modeling>
+- Use record links for simple references and ownership fields when the link itself does not need properties or graph traversal semantics.
+- Use \`TYPE RELATION\` tables and \`RELATE\` when the edge is first-class, needs metadata, or will be traversed as graph data.
+- Use vector indexes for embedding similarity and BM25 full-text indexes for lexical retrieval. Reach for both when hybrid retrieval materially improves recall.
+</modeling>
+
+<sdk-querying>
+- Prefer JavaScript SDK select chains for straightforward reads, for example \`db.select(new Table('users')).where(...).start(...).limit(...)\`.
+- Fall back to bound SQL only when the SDK builder cannot express the query clearly.
+- Any identifier that must enter a raw query string must be validated explicitly first.
+</sdk-querying>`,
+})
+
+const zodSchemaSkillTools = [] as const
+
+export const zodSchemaSkill = defineSkill({
+  name: 'zod-schema-boundaries',
+  description:
+    'Define Zod schemas that keep SurrealDB row parsing separate from API/tool contracts. Use this whenever shared schemas, DB row schemas, tool arguments, or serialized execution-plan payloads are added or changed.',
+  tools: zodSchemaSkillTools,
+  instructions: `# zod-schema-boundaries
+
+## Description
+
+Use this skill whenever you touch shared schemas, DB record parsers, tool contracts, or serialized API payloads.
+
+## Details
+
+<datetime-boundary>
+- DB row schemas use \`z.coerce.date()\` for SurrealDB datetime fields such as \`createdAt\`, \`updatedAt\`, and stored schedule timestamps.
+- Tool and API schemas that must remain JSON Schema compatible use ISO datetime strings, typically \`z.iso.datetime()\`.
+- Do not blur the boundary with \`z.union([z.string(), z.date()])\`, preprocess hacks, or mixed-type public contracts.
+</datetime-boundary>
+
+<serialization-boundary>
+- Parse DB records at the SDK boundary, then serialize outward deliberately.
+- Shared host-facing contracts should expose plain JSON values and strings, not Surreal SDK classes or runtime-only objects.
+- Reuse existing shared schema fragments before inventing another timestamp or record-id representation.
+</serialization-boundary>
+
+<shape-rules>
+- Keep public contracts explicit and small.
+- Prefer strict object schemas for tool arguments and serialized payloads.
+- Use flexible object fields only where the domain genuinely requires open-ended storage.
+- Reuse shared helpers like \`recordIdSchema\` for current host-facing string-or-\`{ tb, id }\` record-id contracts, and keep richer array/object record IDs internal unless the public API truly needs them.
+</shape-rules>`,
+})
+
 export const generalRule = defineRule({
   name: 'general',
   instructions: `# General Rules

package/src/ai/index.ts

@@ -1,4 +1,2 @@
 export * from './definitions'
 export * from './embedding-cache'
-// Re-exported for backwards compatibility — embeddings provider is part of the AI module surface
-export * from '../embeddings/provider'

package/src/bifrost/bifrost.ts

@@ -3,6 +3,7 @@ import { createOpenAI } from '@ai-sdk/openai'
 import { wrapLanguageModel } from 'ai'
 import type { LanguageModelMiddleware } from 'ai'
 
+import { getRequiredEnv } from '../utils/env'
 import { isRecord, readString } from '../utils/string'
 
 type BifrostLanguageModel = Parameters<typeof wrapLanguageModel>[0]['model']
@@ -21,9 +22,7 @@ const OPENROUTER_RESPONSE_HEALING_EXTRA_PARAMS = {
 } as const satisfies BifrostExtraParams
 
 function readRequiredGatewayEnv(name: 'AI_GATEWAY_KEY' | 'AI_GATEWAY_URL'): string {
-  const value = process.env[name]?.trim()
-  if (value) return value
-  throw new Error(`[bifrost] Missing ${name}.`)
+  return getRequiredEnv(name).trim()
 }
 
 function readReasoningDetailsText(value: unknown): string | null {
@@ -248,10 +247,6 @@ function createBifrostProvider(extraParams?: BifrostExtraParams) {
 }
 
 function withBifrostDevTools<TModel extends BifrostLanguageModel>(model: TModel): TModel {
-  if (process.env.NODE_ENV === 'production') {
-    return model
-  }
-
   return wrapLanguageModel({ model, middleware: devToolsMiddleware() }) as TModel
 }
 

package/src/config/agent-defaults.ts

@@ -1,4 +1,4 @@
-type LotaAgentFactoryRegistry = Record<string, (...args: unknown[]) => unknown>
+import type { AgentFactory, AgentRuntimeConfigProvider, AgentToolBuilder } from './agent-types'
 
 function defaultBuildAgentTools(): Record<string, never> {
   return {}
@@ -49,10 +49,15 @@ export function configureAgents(config: {
   if (config.getCoreWorkstreamProfile) {
     getCoreWorkstreamProfile = config.getCoreWorkstreamProfile
   }
+  _agentRosterSet = null
+  _aliasMap = null
 }
 
+let _agentRosterSet: Set<string> | null = null
+
 export function isAgentName(value: unknown): value is string {
-  return typeof value === 'string' && new Set(agentRoster).has(value)
+  _agentRosterSet ??= new Set(agentRoster)
+  return typeof value === 'string' && _agentRosterSet.has(value)
 }
 
 export function getLeadAgentId(): string {
@@ -63,31 +68,36 @@ export function getLeadAgentDisplayName(): string {
   return agentDisplayNames[leadAgentId] ?? leadAgentId
 }
 
+let _aliasMap: Map<string, string> | null = null
+
 export function resolveAgentNameAlias(value: unknown): string | undefined {
   if (typeof value !== 'string') return undefined
   const lowered = value.trim().toLowerCase()
-  const aliasMap = new Map<string, string>()
-  for (const agent of agentRoster) {
-    aliasMap.set(agent.toLowerCase(), agent)
-    const displayName = agentDisplayNames[agent]
-    if (displayName) aliasMap.set(displayName.toLowerCase(), agent)
-    const shortName = agentShortDisplayNames[agent]
-    if (shortName) aliasMap.set(shortName.toLowerCase(), agent)
-  }
-  return aliasMap.get(lowered)
+  _aliasMap ??= (() => {
+    const map = new Map<string, string>()
+    for (const agent of agentRoster) {
+      map.set(agent.toLowerCase(), agent)
+      const displayName = agentDisplayNames[agent]
+      if (displayName) map.set(displayName.toLowerCase(), agent)
+      const shortName = agentShortDisplayNames[agent]
+      if (shortName) map.set(shortName.toLowerCase(), agent)
+    }
+    return map
+  })()
+  return _aliasMap.get(lowered)
 }
 
-export let createAgent: LotaAgentFactoryRegistry = {}
+export let createAgent: AgentFactory = {}
 
-export let buildAgentTools: (...args: unknown[]) => unknown = defaultBuildAgentTools
-export let getAgentRuntimeConfig: (...args: unknown[]) => unknown = defaultGetAgentRuntimeConfig
-export let pluginRuntime: unknown = undefined
+export let buildAgentTools: AgentToolBuilder = defaultBuildAgentTools
+export let getAgentRuntimeConfig: AgentRuntimeConfigProvider = defaultGetAgentRuntimeConfig
+export let pluginRuntime: Record<string, unknown> | undefined = undefined
 
 export function configureAgentFactory(config: {
-  createAgent?: LotaAgentFactoryRegistry
-  buildAgentTools?: (...args: unknown[]) => unknown
-  getAgentRuntimeConfig?: (...args: unknown[]) => unknown
-  pluginRuntime?: unknown
+  createAgent?: AgentFactory
+  buildAgentTools?: AgentToolBuilder
+  getAgentRuntimeConfig?: AgentRuntimeConfigProvider
+  pluginRuntime?: Record<string, unknown>
 }): void {
   createAgent = config.createAgent ?? {}
   buildAgentTools = config.buildAgentTools ?? defaultBuildAgentTools
@@ -110,8 +120,8 @@ export function extractAgentMentions(message: string): AgentMentionMatch[] {
 
   const regex = new RegExp(AGENT_MENTION_REGEX)
   for (const rawMatch of message.matchAll(regex)) {
-    const prefix = rawMatch[1] ?? ''
-    const rawAgent = (rawMatch[2] ?? '').toLowerCase()
+    const prefix = rawMatch[1]
+    const rawAgent = rawMatch[2].toLowerCase()
     if (!isAgentName(rawAgent)) continue
 
     const index = rawMatch.index + prefix.length

package/src/config/agent-types.ts

@@ -0,0 +1,11 @@
+/**
+ * Registry of agent factory functions keyed by agent name.
+ * Each factory receives runtime args and returns an agent instance.
+ */
+export type AgentFactory = Record<string, (...args: unknown[]) => unknown>
+
+/** Builds the tool set for a given agent. */
+export type AgentToolBuilder = (...args: unknown[]) => unknown
+
+/** Returns runtime configuration for a given agent. */
+export type AgentRuntimeConfigProvider = (...args: unknown[]) => unknown

package/src/config/constants.ts

@@ -1,24 +1,12 @@
 import { z } from 'zod'
 
-// ============================================================================
-// Memory System Constants
-// ============================================================================
-
 export const MEMORY = {
-  /** Default number of memory candidates to fetch */
   DEFAULT_CANDIDATE_LIMIT: 12,
-  /** Maximum KNN limit for safety */
+  /** Safety cap to prevent runaway KNN queries */
   MAX_KNN_LIMIT: 100,
 } as const
 
-// ============================================================================
-// Validation Helpers
-// ============================================================================
-
-/**
- * Validates that a value is a safe integer for KNN queries
- * Throws if validation fails
- */
+/** Validates that a value is a safe integer for KNN queries. Throws if validation fails. */
 export function validateKnnLimit(limit: unknown): number {
   return z.number().int().positive().max(MEMORY.MAX_KNN_LIMIT).parse(limit)
 }

package/src/config/debug-logger.ts

@@ -1,6 +1,10 @@
 import { chatLogger } from './logger'
 
-const isDebug = () => process.env.LOG_LEVEL === 'debug' || process.env.LOTA_DEBUG === '1'
+const isDebug = (): boolean => {
+  const level = process.env.LOG_LEVEL
+  const flag = process.env.LOTA_DEBUG
+  return level === 'debug' || flag === '1'
+}
 
 interface DebugTimer {
   step(name: string): void

package/src/config/index.ts

@@ -1,5 +1,8 @@
 export * from './agent-defaults'
+export * from './agent-types'
 export * from './background-processing'
+export * from './constants'
 export * from './logger'
 export * from './model-constants'
+export * from './search'
 export * from './workstream-defaults'

package/src/config/model-constants.ts

@@ -1,34 +1,16 @@
-export const OPENAI_REASONING_MODEL_ID = 'openai/gpt-5.4' as const
-
-export const OPENROUTER_TEAM_AGENT_MODEL_ID = 'openrouter/google/gemini-3.1-pro-preview' as const
-export const OPENROUTER_STRUCTURED_HELPER_MODEL_ID = 'openrouter/google/gemini-3-flash-preview:exacto' as const
-export const OPENROUTER_DELEGATED_REASONING_MODEL_ID = 'openrouter/google/gemini-3-flash-preview:exacto' as const
-export const OPENROUTER_WEB_RESEARCH_MODEL_ID = 'openrouter/stepfun/step-3.5-flash' as const
-export const OPENROUTER_FAST_REASONING_MODEL_ID = 'openrouter/openai/gpt-oss-120b:nitro' as const
-export const OPENROUTER_STRUCTURED_REASONING_MODEL_ID = 'openrouter/openai/gpt-oss-120b:exacto' as const
-
-export const BIFROST_REASONING_SUMMARY_LEVEL = 'detailed' as const
-
-export const OPENAI_HIGH_REASONING_PROVIDER_OPTIONS = {
-  openai: { forceReasoning: true, reasoningEffort: 'high', reasoningSummary: BIFROST_REASONING_SUMMARY_LEVEL },
-} as const
-
-export const OPENROUTER_HIGH_REASONING_PROVIDER_OPTIONS = {
-  openai: { forceReasoning: true, reasoningEffort: 'high', reasoningSummary: BIFROST_REASONING_SUMMARY_LEVEL },
-} as const
-
-export const OPENROUTER_XHIGH_REASONING_PROVIDER_OPTIONS = {
-  openai: { forceReasoning: true, reasoningEffort: 'xhigh', reasoningSummary: BIFROST_REASONING_SUMMARY_LEVEL },
-} as const
-
-export const OPENROUTER_MEDIUM_REASONING_PROVIDER_OPTIONS = {
-  openai: { forceReasoning: true, reasoningEffort: 'medium', reasoningSummary: BIFROST_REASONING_SUMMARY_LEVEL },
-} as const
-
-export const OPENROUTER_LOW_REASONING_PROVIDER_OPTIONS = {
-  openai: { forceReasoning: true, reasoningEffort: 'low', reasoningSummary: BIFROST_REASONING_SUMMARY_LEVEL },
-} as const
-
-export const OPENROUTER_MINIMAL_REASONING_PROVIDER_OPTIONS = {
-  openai: { forceReasoning: true, reasoningEffort: 'minimal', reasoningSummary: BIFROST_REASONING_SUMMARY_LEVEL },
-} as const
+export {
+  BIFROST_REASONING_SUMMARY_LEVEL,
+  OPENAI_HIGH_REASONING_PROVIDER_OPTIONS,
+  OPENAI_REASONING_MODEL_ID,
+  OPENROUTER_DELEGATED_REASONING_MODEL_ID,
+  OPENROUTER_FAST_REASONING_MODEL_ID,
+  OPENROUTER_HIGH_REASONING_PROVIDER_OPTIONS,
+  OPENROUTER_LOW_REASONING_PROVIDER_OPTIONS,
+  OPENROUTER_MEDIUM_REASONING_PROVIDER_OPTIONS,
+  OPENROUTER_MINIMAL_REASONING_PROVIDER_OPTIONS,
+  OPENROUTER_STRUCTURED_HELPER_MODEL_ID,
+  OPENROUTER_STRUCTURED_REASONING_MODEL_ID,
+  OPENROUTER_TEAM_AGENT_MODEL_ID,
+  OPENROUTER_WEB_RESEARCH_MODEL_ID,
+  OPENROUTER_XHIGH_REASONING_PROVIDER_OPTIONS,
+} from '@lota-sdk/shared'

package/src/config/search.ts

@@ -1,17 +1,3 @@
-/**
- * Search-related constants for vector search and hybrid search
- */
+export { VECTOR_SEARCH_OVERFETCH_MULTIPLIER } from '@lota-sdk/shared'
 
-/**
- * Multiplier for vector search fetch limit.
- * We fetch more candidates than needed (limit * multiplier) to allow for:
- * - RRF (Reciprocal Rank Fusion) re-ranking
- * - Hybrid search combining vector + full-text results
- * - Filtering out low-quality matches before returning final results
- */
-export const VECTOR_SEARCH_OVERFETCH_MULTIPLIER = 2
-
-/**
- * Default limit for memory search queries
- */
 export const DEFAULT_MEMORY_SEARCH_LIMIT = 10