@lota-sdk/core 0.2.3 → 0.3.1

package/infrastructure/schema/00_identity.surql

@@ -1,7 +1,7 @@
 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>;
-DEFINE FIELD IF NOT EXISTS regularChatDigestLastWorkstreamCursorId ON TABLE organization TYPE option<string>;
+DEFINE FIELD IF NOT EXISTS regularChatDigestLastThreadCursorCreatedAt ON TABLE organization TYPE option<datetime>;
+DEFINE FIELD IF NOT EXISTS regularChatDigestLastThreadCursorId ON TABLE organization TYPE option<string>;
 DEFINE FIELD IF NOT EXISTS skillExtractionLastCursorId ON TABLE organization TYPE option<string>;
 DEFINE FIELD IF NOT EXISTS skillExtractionLastCursorCreatedAt ON TABLE organization TYPE option<datetime>;
 DEFINE FIELD IF NOT EXISTS createdAt ON TABLE organization TYPE datetime DEFAULT time::now() READONLY;

package/infrastructure/schema/00_thread.surql

@@ -0,0 +1,73 @@
+DEFINE TABLE IF NOT EXISTS thread SCHEMAFULL;
+
+DEFINE FIELD IF NOT EXISTS organizationId ON thread TYPE record<organization>;
+DEFINE FIELD IF NOT EXISTS userId         ON thread TYPE record<user>;
+DEFINE FIELD IF NOT EXISTS type           ON thread TYPE string
+  ASSERT $value IN ['default', 'topic', 'thread', 'group']
+  DEFAULT 'group';
+DEFINE FIELD IF NOT EXISTS agentId        ON thread TYPE option<string>;
+DEFINE FIELD IF NOT EXISTS threadType ON thread TYPE option<string>;
+DEFINE FIELD IF NOT EXISTS members        ON thread TYPE option<array<string>> DEFAULT [];
+DEFINE FIELD IF NOT EXISTS title          ON thread TYPE option<string>;
+DEFINE FIELD IF NOT EXISTS nameGenerated  ON thread TYPE bool DEFAULT false;
+DEFINE FIELD IF NOT EXISTS status         ON thread TYPE string
+  ASSERT $value IN ['active', 'archived']
+  DEFAULT 'active';
+DEFINE FIELD IF NOT EXISTS activeRunId            ON thread TYPE option<string>;
+DEFINE FIELD IF NOT EXISTS activeStreamId         ON thread TYPE option<string>;
+DEFINE FIELD IF NOT EXISTS memoryBlock            ON thread TYPE option<string>;
+DEFINE FIELD IF NOT EXISTS memoryBlockSummary     ON thread TYPE option<string>;
+DEFINE FIELD IF NOT EXISTS compactionSummary      ON thread TYPE option<string>;
+DEFINE FIELD IF NOT EXISTS lastCompactedMessageId ON thread TYPE option<string>;
+DEFINE FIELD IF NOT EXISTS isCompacting           ON thread TYPE bool DEFAULT false;
+DEFINE FIELD IF NOT EXISTS turnCount              ON thread TYPE int DEFAULT 0;
+DEFINE FIELD IF NOT EXISTS createdAt ON thread TYPE datetime DEFAULT time::now() READONLY;
+DEFINE FIELD IF NOT EXISTS updatedAt ON thread TYPE datetime DEFAULT time::now() VALUE time::now();
+
+DEFINE INDEX IF NOT EXISTS threadDefaultLookupIdx ON thread
+  FIELDS type, userId, organizationId, agentId UNIQUE;
+
+DEFINE INDEX IF NOT EXISTS threadThreadLookupIdx ON thread
+  FIELDS type, userId, organizationId, threadType UNIQUE;
+
+DEFINE INDEX IF NOT EXISTS threadOrgIdx ON thread FIELDS organizationId;
+DEFINE INDEX IF NOT EXISTS threadUserIdx ON thread FIELDS userId;
+DEFINE INDEX IF NOT EXISTS threadUserOrgTypeUpdatedIdx ON thread
+  FIELDS userId, organizationId, type, updatedAt;
+DEFINE INDEX IF NOT EXISTS threadUserOrgStatusTypeUpdatedIdx ON thread
+  FIELDS userId, organizationId, status, type, updatedAt;
+
+# Thread Message table (AI SDK UIMessage persistence).
+# parts uses OVERWRITE on the wildcard to override the implicit non-FLEXIBLE
+# definition that array<object> creates — this is the only way to allow
+# arbitrary nested object shapes inside the array on SCHEMAFULL tables.
+DEFINE TABLE IF NOT EXISTS threadMessage SCHEMAFULL;
+DEFINE FIELD IF NOT EXISTS threadId ON TABLE threadMessage TYPE record<thread> REFERENCE ON DELETE CASCADE;
+DEFINE FIELD IF NOT EXISTS messageId ON TABLE threadMessage TYPE string;
+DEFINE FIELD IF NOT EXISTS role ON TABLE threadMessage TYPE string;
+DEFINE FIELD IF NOT EXISTS parts ON TABLE threadMessage TYPE array<object> FLEXIBLE;
+DEFINE FIELD OVERWRITE parts.* ON TABLE threadMessage TYPE object FLEXIBLE;
+DEFINE FIELD IF NOT EXISTS metadata ON TABLE threadMessage TYPE option<object> FLEXIBLE;
+DEFINE FIELD IF NOT EXISTS createdAt ON TABLE threadMessage TYPE datetime DEFAULT time::now() READONLY;
+DEFINE FIELD IF NOT EXISTS updatedAt ON TABLE threadMessage TYPE datetime VALUE time::now();
+
+DEFINE INDEX IF NOT EXISTS threadMessageThreadIdx ON TABLE threadMessage COLUMNS threadId;
+DEFINE INDEX IF NOT EXISTS threadMessageThreadCreatedIdx ON TABLE threadMessage COLUMNS threadId, createdAt;
+DEFINE INDEX IF NOT EXISTS threadMessageThreadMessageUniqueIdx ON TABLE threadMessage COLUMNS threadId, messageId UNIQUE;
+
+# Thread attachments.
+DEFINE TABLE IF NOT EXISTS threadAttachment SCHEMAFULL;
+DEFINE FIELD IF NOT EXISTS threadId ON TABLE threadAttachment TYPE record<thread> REFERENCE ON DELETE CASCADE;
+DEFINE FIELD IF NOT EXISTS messageId ON TABLE threadAttachment TYPE record<threadMessage> REFERENCE ON DELETE CASCADE;
+DEFINE FIELD IF NOT EXISTS attachmentType ON TABLE threadAttachment TYPE string;
+DEFINE FIELD IF NOT EXISTS name ON TABLE threadAttachment TYPE string;
+DEFINE FIELD IF NOT EXISTS contentType ON TABLE threadAttachment TYPE string;
+DEFINE FIELD IF NOT EXISTS storageKey ON TABLE threadAttachment TYPE option<string>;
+DEFINE FIELD IF NOT EXISTS sizeBytes ON TABLE threadAttachment TYPE option<int>;
+DEFINE FIELD IF NOT EXISTS url ON TABLE threadAttachment TYPE option<string>;
+DEFINE FIELD IF NOT EXISTS createdAt ON TABLE threadAttachment TYPE datetime DEFAULT time::now() READONLY;
+DEFINE FIELD IF NOT EXISTS updatedAt ON TABLE threadAttachment TYPE datetime VALUE time::now();
+
+DEFINE INDEX IF NOT EXISTS threadAttachmentThreadIdx ON TABLE threadAttachment COLUMNS threadId;
+DEFINE INDEX IF NOT EXISTS threadAttachmentMessageIdx ON TABLE threadAttachment COLUMNS messageId;
+DEFINE INDEX IF NOT EXISTS threadAttachmentThreadMessageIdx ON TABLE threadAttachment COLUMNS threadId, messageId;

package/infrastructure/schema/02_execution_plan.surql

@@ -2,7 +2,7 @@
 
 DEFINE TABLE IF NOT EXISTS planSpec SCHEMAFULL;
 DEFINE FIELD IF NOT EXISTS organizationId ON TABLE planSpec TYPE record<organization>;
-DEFINE FIELD IF NOT EXISTS workstreamId ON TABLE planSpec TYPE record<workstream> REFERENCE ON DELETE CASCADE;
+DEFINE FIELD IF NOT EXISTS threadId ON TABLE planSpec TYPE record<thread> REFERENCE ON DELETE CASCADE;
 DEFINE FIELD IF NOT EXISTS title ON TABLE planSpec TYPE string;
 DEFINE FIELD IF NOT EXISTS objective ON TABLE planSpec TYPE string;
 DEFINE FIELD IF NOT EXISTS version ON TABLE planSpec TYPE int;
@@ -29,8 +29,8 @@ DEFINE FIELD IF NOT EXISTS updatedAt ON TABLE planSpec TYPE datetime VALUE time:
 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;
+DEFINE INDEX IF NOT EXISTS planSpecThreadIdx ON TABLE planSpec COLUMNS threadId;
+DEFINE INDEX IF NOT EXISTS planSpecThreadStatusIdx ON TABLE planSpec COLUMNS threadId, status;
 
 DEFINE TABLE IF NOT EXISTS planNodeSpec SCHEMAFULL;
 DEFINE FIELD IF NOT EXISTS planSpecId ON TABLE planNodeSpec TYPE record<planSpec> REFERENCE ON DELETE CASCADE;
@@ -85,7 +85,7 @@ DEFINE INDEX IF NOT EXISTS planNodeSpecPlanPositionIdx ON TABLE planNodeSpec COL
 DEFINE TABLE IF NOT EXISTS planRun SCHEMAFULL;
 DEFINE FIELD IF NOT EXISTS planSpecId ON TABLE planRun TYPE record<planSpec> REFERENCE ON DELETE CASCADE;
 DEFINE FIELD IF NOT EXISTS organizationId ON TABLE planRun TYPE record<organization>;
-DEFINE FIELD IF NOT EXISTS workstreamId ON TABLE planRun TYPE record<workstream> REFERENCE ON DELETE CASCADE;
+DEFINE FIELD IF NOT EXISTS threadId ON TABLE planRun TYPE record<thread> REFERENCE ON DELETE CASCADE;
 DEFINE FIELD IF NOT EXISTS leadAgentId ON TABLE planRun TYPE string;
 DEFINE FIELD IF NOT EXISTS status ON TABLE planRun TYPE string;
 DEFINE FIELD IF NOT EXISTS currentNodeId ON TABLE planRun TYPE option<string>;
@@ -102,8 +102,8 @@ 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 planRunThreadIdx ON TABLE planRun COLUMNS threadId;
+DEFINE INDEX IF NOT EXISTS planRunThreadStatusIdx ON TABLE planRun COLUMNS threadId, status;
 DEFINE INDEX IF NOT EXISTS planRunSpecIdx ON TABLE planRun COLUMNS planSpecId;
 
 DEFINE TABLE IF NOT EXISTS planNodeRun SCHEMAFULL;
@@ -116,7 +116,6 @@ DEFINE FIELD IF NOT EXISTS retryCount ON TABLE planNodeRun TYPE int DEFAULT 0;
 DEFINE FIELD IF NOT EXISTS resolvedInput ON TABLE planNodeRun TYPE option<object> FLEXIBLE;
 DEFINE FIELD IF NOT EXISTS latestStructuredOutput ON TABLE planNodeRun TYPE option<object> FLEXIBLE;
 DEFINE FIELD IF NOT EXISTS latestNotes ON TABLE planNodeRun TYPE option<string>;
-DEFINE FIELD IF NOT EXISTS handoffContext ON TABLE planNodeRun TYPE option<object> FLEXIBLE;
 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>;
@@ -232,7 +231,7 @@ DEFINE INDEX IF NOT EXISTS planEventRunTimeIdx ON TABLE planEvent COLUMNS runId,
 
 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 threadId ON TABLE planSchedule TYPE record<thread> 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>;
@@ -245,7 +244,7 @@ DEFINE FIELD IF NOT EXISTS createdAt ON TABLE planSchedule TYPE datetime DEFAULT
 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 INDEX IF NOT EXISTS planScheduleThreadIdx ON TABLE planSchedule COLUMNS threadId;
 
 DEFINE TABLE IF NOT EXISTS planTemplate SCHEMAFULL;
 DEFINE FIELD IF NOT EXISTS organizationId ON TABLE planTemplate TYPE record<organization>;
@@ -262,7 +261,7 @@ DEFINE INDEX IF NOT EXISTS planTemplateOrgNameIdx ON TABLE planTemplate COLUMNS
 
 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 threadId ON TABLE planCycle TYPE record<thread> 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;
@@ -273,5 +272,5 @@ DEFINE FIELD IF NOT EXISTS currentRunId ON TABLE planCycle TYPE option<record<pl
 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 planCycleThreadIdx ON TABLE planCycle COLUMNS threadId;
 DEFINE INDEX IF NOT EXISTS planCycleStatusIdx ON TABLE planCycle COLUMNS status;

package/infrastructure/schema/04_runtime_bootstrap.surql

@@ -2,6 +2,7 @@
 DEFINE TABLE IF NOT EXISTS runtimeBootstrap SCHEMAFULL;
 DEFINE FIELD IF NOT EXISTS key ON TABLE runtimeBootstrap TYPE string;
 DEFINE FIELD IF NOT EXISTS schemaFingerprint ON TABLE runtimeBootstrap TYPE string;
+DEFINE FIELD IF NOT EXISTS createdAt ON TABLE runtimeBootstrap TYPE datetime DEFAULT time::now() READONLY;
 DEFINE FIELD IF NOT EXISTS readyAt ON TABLE runtimeBootstrap TYPE datetime;
 DEFINE FIELD IF NOT EXISTS updatedAt ON TABLE runtimeBootstrap TYPE datetime VALUE time::now();
 

package/infrastructure/schema/10_autonomous_job.surql

@@ -2,7 +2,7 @@ DEFINE TABLE IF NOT EXISTS autonomousJob SCHEMAFULL;
 DEFINE FIELD IF NOT EXISTS organizationId ON TABLE autonomousJob TYPE record<organization>;
 DEFINE FIELD IF NOT EXISTS ownerUserId ON TABLE autonomousJob TYPE record<user>;
 DEFINE FIELD IF NOT EXISTS ownerUserName ON TABLE autonomousJob TYPE option<string>;
-DEFINE FIELD IF NOT EXISTS workstreamId ON TABLE autonomousJob TYPE record<workstream> REFERENCE ON DELETE CASCADE;
+DEFINE FIELD IF NOT EXISTS threadId ON TABLE autonomousJob TYPE record<thread> REFERENCE ON DELETE CASCADE;
 DEFINE FIELD IF NOT EXISTS agentId ON TABLE autonomousJob TYPE string;
 DEFINE FIELD IF NOT EXISTS title ON TABLE autonomousJob TYPE string;
 DEFINE FIELD IF NOT EXISTS prompt ON TABLE autonomousJob TYPE string;
@@ -20,12 +20,12 @@ DEFINE FIELD IF NOT EXISTS createdAt ON TABLE autonomousJob TYPE datetime DEFAUL
 DEFINE FIELD IF NOT EXISTS updatedAt ON TABLE autonomousJob TYPE datetime VALUE time::now();
 
 DEFINE INDEX IF NOT EXISTS autonomousJobOrgStatusIdx ON TABLE autonomousJob COLUMNS organizationId, status;
-DEFINE INDEX IF NOT EXISTS autonomousJobWorkstreamIdx ON TABLE autonomousJob COLUMNS workstreamId;
+DEFINE INDEX IF NOT EXISTS autonomousJobThreadIdx ON TABLE autonomousJob COLUMNS threadId;
 DEFINE INDEX IF NOT EXISTS autonomousJobOwnerIdx ON TABLE autonomousJob COLUMNS ownerUserId;
 
 DEFINE TABLE IF NOT EXISTS autonomousJobRun SCHEMAFULL;
 DEFINE FIELD IF NOT EXISTS autonomousJobId ON TABLE autonomousJobRun TYPE record<autonomousJob> REFERENCE ON DELETE CASCADE;
-DEFINE FIELD IF NOT EXISTS workstreamId ON TABLE autonomousJobRun TYPE record<workstream> REFERENCE ON DELETE CASCADE;
+DEFINE FIELD IF NOT EXISTS threadId ON TABLE autonomousJobRun TYPE record<thread> REFERENCE ON DELETE CASCADE;
 DEFINE FIELD IF NOT EXISTS queueJobId ON TABLE autonomousJobRun TYPE option<record<queueJob>>;
 DEFINE FIELD IF NOT EXISTS status ON TABLE autonomousJobRun TYPE string;
 DEFINE FIELD IF NOT EXISTS inputMessageId ON TABLE autonomousJobRun TYPE option<string>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lota-sdk/core",
-  "version": "0.2.3",
+  "version": "0.3.1",
   "type": "module",
   "main": "./src/index.ts",
   "types": "./src/index.ts",
@@ -32,7 +32,7 @@
     "@chat-adapter/slack": "^4.23.0",
     "@chat-adapter/state-ioredis": "^4.23.0",
     "@logtape/logtape": "^2.0.5",
-    "@lota-sdk/shared": "0.2.3",
+    "@lota-sdk/shared": "0.3.1",
     "@mendable/firecrawl-js": "^4.18.1",
     "@surrealdb/node": "^3.0.3",
     "ai": "^6.0.145",

package/src/ai/definitions.ts

@@ -129,7 +129,7 @@ Use this skill for any Lota SDK task that changes SurrealQL schema files, DB ser
 
 <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.*\`.
+- Avoid \`OVERWRITE\` unless SurrealDB itself requires a specific wildcard exception on a fresh database shape, such as \`threadMessage.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\`.

package/src/config/agent-defaults.ts

@@ -17,7 +17,7 @@ export let agentRoster: readonly string[] = []
 export let leadAgentId = ''
 export let teamConsultParticipants: readonly string[] = []
 
-export interface CoreWorkstreamProfile {
+export interface CoreThreadProfile {
   config: { coreType: string; agentId: string; title: string }
   members: readonly string[]
   tools: readonly string[]
@@ -25,7 +25,7 @@ export interface CoreWorkstreamProfile {
   instructions: string
 }
 
-export let getCoreWorkstreamProfile: (coreType: string) => CoreWorkstreamProfile = (_coreType) => ({
+export let getCoreThreadProfile: (coreType: string) => CoreThreadProfile = (_coreType) => ({
   config: { coreType: _coreType, agentId: '', title: '' },
   members: [],
   tools: [],
@@ -41,7 +41,7 @@ export function configureAgents(config: {
   descriptions?: Record<string, string>
   routerModelId?: string
   teamConsultParticipants: readonly string[]
-  getCoreWorkstreamProfile?: (coreType: string) => CoreWorkstreamProfile
+  getCoreThreadProfile?: (coreType: string) => CoreThreadProfile
 }): void {
   if (!config.roster.includes(config.leadAgentId)) {
     throw new Error(`Lead agent "${config.leadAgentId}" must be present in the configured roster.`)
@@ -54,8 +54,8 @@ export function configureAgents(config: {
   agentDescriptions = config.descriptions ?? {}
   routerModelId = config.routerModelId
   teamConsultParticipants = config.teamConsultParticipants
-  if (config.getCoreWorkstreamProfile) {
-    getCoreWorkstreamProfile = config.getCoreWorkstreamProfile
+  if (config.getCoreThreadProfile) {
+    getCoreThreadProfile = config.getCoreThreadProfile
   }
   _agentRosterSet = null
   _aliasMap = null

package/src/config/index.ts

@@ -5,4 +5,4 @@ export * from './constants'
 export * from './logger'
 export * from './model-constants'
 export * from './search'
-export * from './workstream-defaults'
+export * from './thread-defaults'

package/src/config/thread-defaults.ts

@@ -0,0 +1,72 @@
+export interface ThreadBootstrapWelcomeConfig {
+  defaultAgentId: string
+  buildMessageText: (params: { userName?: string | null }) => string
+}
+
+export interface LotaThreadBootstrapConfig {
+  onboardingDefaultAgents?: readonly string[]
+  completedDefaultAgents?: readonly string[]
+  threadTypesAfterOnboarding?: readonly string[]
+  ensureDefaultGroupOnCompleted?: boolean
+  onboardingWelcome?: ThreadBootstrapWelcomeConfig
+}
+
+export interface LotaThreadConfig {
+  bootstrap?: LotaThreadBootstrapConfig
+}
+
+interface ResolvedThreadBootstrapConfig {
+  onboardingDefaultAgents: readonly string[]
+  completedDefaultAgents: readonly string[]
+  threadTypesAfterOnboarding: readonly string[]
+  ensureDefaultGroupOnCompleted: boolean
+  onboardingWelcome?: ThreadBootstrapWelcomeConfig
+}
+
+const DEFAULT_THREAD_BOOTSTRAP_CONFIG: ResolvedThreadBootstrapConfig = {
+  onboardingDefaultAgents: [],
+  completedDefaultAgents: [],
+  threadTypesAfterOnboarding: [],
+  ensureDefaultGroupOnCompleted: true,
+}
+
+let resolvedThreadBootstrapConfig: ResolvedThreadBootstrapConfig = DEFAULT_THREAD_BOOTSTRAP_CONFIG
+
+function withDedupedStrings(values: readonly string[]): string[] {
+  const seen = new Set<string>()
+  const deduped: string[] = []
+
+  for (const value of values) {
+    const normalized = value.trim()
+    if (!normalized || seen.has(normalized)) continue
+    seen.add(normalized)
+    deduped.push(normalized)
+  }
+
+  return deduped
+}
+
+export function configureThreads(params: { agentRoster: readonly string[]; config?: LotaThreadConfig }): void {
+  const bootstrap = params.config?.bootstrap
+  const onboardingWelcome = bootstrap?.onboardingWelcome
+  const onboardingDefaultAgents = withDedupedStrings([
+    ...(bootstrap?.onboardingDefaultAgents ?? params.agentRoster),
+    ...(onboardingWelcome ? [onboardingWelcome.defaultAgentId] : []),
+  ])
+
+  resolvedThreadBootstrapConfig = {
+    onboardingDefaultAgents,
+    completedDefaultAgents: withDedupedStrings(bootstrap?.completedDefaultAgents ?? params.agentRoster),
+    threadTypesAfterOnboarding: withDedupedStrings(bootstrap?.threadTypesAfterOnboarding ?? []),
+    ensureDefaultGroupOnCompleted: bootstrap?.ensureDefaultGroupOnCompleted ?? true,
+    ...(onboardingWelcome ? { onboardingWelcome } : {}),
+  }
+}
+
+export function getThreadBootstrapConfig(): ResolvedThreadBootstrapConfig {
+  return resolvedThreadBootstrapConfig
+}
+
+export function resolveOnboardingOwnerAgentId(defaultLeadAgentId: string): string {
+  return resolvedThreadBootstrapConfig.onboardingWelcome?.defaultAgentId ?? defaultLeadAgentId
+}