@lota-sdk/core 0.2.3 → 0.3.1

package/src/queues/title-generation.queue.ts

@@ -3,18 +3,18 @@ import type { Job } from 'bullmq'
 import { ensureRecordId } from '../db/record-id'
 import { databaseService } from '../db/service'
 import { recentActivityTitleService } from '../services/recent-activity-title.service'
-import { workstreamTitleService } from '../services/workstream-title.service'
+import { threadTitleService } from '../services/thread-title.service'
 import { createQueueFactory } from './queue-factory'
 
 export const TITLE_GENERATION_QUEUE = 'title-generation'
 
-// This queue merges workstream title generation and recent-activity title
+// This queue merges thread title generation and recent-activity title
 // refinement because both are short-lived title synthesis jobs with the same
 // operational shape.
 
-interface WorkstreamTitleGenerationJob {
-  kind: 'workstream-title'
-  workstreamId: string
+interface ThreadTitleGenerationJob {
+  kind: 'thread-title'
+  threadId: string
   sourceText: string
 }
 
@@ -23,12 +23,12 @@ interface RecentActivityTitleRefinementJob {
   activityId: string
 }
 
-type TitleGenerationJob = WorkstreamTitleGenerationJob | RecentActivityTitleRefinementJob
+type TitleGenerationJob = ThreadTitleGenerationJob | RecentActivityTitleRefinementJob
 
 async function processTitleGenerationJob(job: Job<TitleGenerationJob>): Promise<void> {
   await databaseService.connect()
-  if (job.data.kind === 'workstream-title') {
-    await workstreamTitleService.generateAndPersistTitle(ensureRecordId(job.data.workstreamId), job.data.sourceText)
+  if (job.data.kind === 'thread-title') {
+    await threadTitleService.generateAndPersistTitle(ensureRecordId(job.data.threadId), job.data.sourceText)
     return
   }
 
@@ -45,11 +45,8 @@ const titleGeneration = createQueueFactory<TitleGenerationJob>({
   processor: processTitleGenerationJob,
 })
 
-export function enqueueWorkstreamTitleGeneration(job: Omit<WorkstreamTitleGenerationJob, 'kind'>) {
-  return titleGeneration.enqueue(
-    { kind: 'workstream-title', ...job },
-    { jobId: `workstream-title:${job.workstreamId}` },
-  )
+export function enqueueThreadTitleGeneration(job: Omit<ThreadTitleGenerationJob, 'kind'>) {
+  return titleGeneration.enqueue({ kind: 'thread-title', ...job }, { jobId: `thread-title:${job.threadId}` })
 }
 
 export function enqueueRecentActivityTitleRefinement(job: Omit<RecentActivityTitleRefinementJob, 'kind'>) {

package/src/redis/index.ts

@@ -9,7 +9,7 @@ export {
 } from './connection-accessor'
 export { withOrgMemoryLock } from './org-memory-lock'
 export { LeaseLockLostError, withRedisLeaseLock } from './redis-lease-lock'
-export { closeSharedSubscriber, createWorkstreamResumableContext } from './stream-context'
+export { closeSharedSubscriber, createThreadResumableContext } from './stream-context'
 
 export { createRedisConnectionManager }
 export type { RedisConnectionManager }

package/src/redis/stream-context.ts

@@ -55,7 +55,7 @@ export async function closeSharedSubscriber(): Promise<void> {
   }
 }
 
-export function createWorkstreamResumableContext() {
+export function createThreadResumableContext() {
   const redis = getRedisConnection()
   return createResumableStreamContext({
     waitUntil: null,

package/src/runtime/agent-identity-overrides.ts

@@ -1,5 +1,5 @@
 import { agentDisplayNames } from '../config/agent-defaults'
-import { asRecord, readOptionalString } from './workstream-chat-helpers'
+import { asRecord, readOptionalString } from './thread-chat-helpers'
 
 interface RuntimeAgentIdentityOverrides {
   displayNamesById: Partial<Record<string, string>>

package/src/runtime/agent-runtime-policy.ts

@@ -7,7 +7,7 @@ import type {
 } from '@lota-sdk/shared'
 
 import { getLeadAgentId } from '../config/agent-defaults'
-import { resolveOnboardingOwnerAgentId } from '../config/workstream-defaults'
+import { resolveOnboardingOwnerAgentId } from '../config/thread-defaults'
 import type { ChatMode } from './agent-types'
 export interface AgentRuntimeConfig<TAgent extends string> {
   id: TAgent
@@ -73,15 +73,13 @@ function buildOwnershipDispatchArtifactPayload(artifacts: PlanArtifactSubmission
   return artifacts.map((artifact) => ({
     name: artifact.name,
     kind: artifact.kind,
-    pointer: artifact.pointer,
-    ...(artifact.schemaRef ? { schemaRef: artifact.schemaRef } : {}),
     ...(artifact.description ? { description: artifact.description } : {}),
     ...(artifact.payload !== undefined ? { payload: artifact.payload } : {}),
   }))
 }
 
-export function toChatMode(workstreamMode: 'direct' | 'group'): ChatMode {
-  return workstreamMode === 'direct' ? 'fixedWorkstreamMode' : 'workstreamMode'
+export function toChatMode(threadType: string): ChatMode {
+  return threadType === 'default' ? 'fixedThreadMode' : 'threadMode'
 }
 
 function toMemoryBlockSection(memoryBlock: string | undefined): string | undefined {
@@ -92,13 +90,13 @@ function toMemoryBlockSection(memoryBlock: string | undefined): string | undefin
 
 export function resolveActiveAgentSkills<TAgent extends string, TSkill extends PropertyKey>(params: {
   agentId: TAgent
-  workstreamMode: 'direct' | 'group'
+  threadType: string
   mode?: ChatMode
   onboardingActive: boolean
   linearInstalled: boolean
   getAgentSkills: (agentId: TAgent, mode: ChatMode) => TSkill[]
 }): TSkill[] {
-  const mode = params.mode ?? toChatMode(params.workstreamMode)
+  const mode = params.mode ?? toChatMode(params.threadType)
   return params
     .getAgentSkills(params.agentId, mode)
     .filter((skill) => (params.linearInstalled ? true : skill !== ('linear' as TSkill)))
@@ -107,7 +105,7 @@ export function resolveActiveAgentSkills<TAgent extends string, TSkill extends P
 export function buildAgentRuntimeConfig<TAgent extends string, TSkill extends PropertyKey>(params: {
   agentId: TAgent
   displayNameByAgent: Record<TAgent, string>
-  workstreamMode: 'direct' | 'group'
+  threadType: string
   mode?: ChatMode
   skills?: TSkill[]
   onboardingActive: boolean
@@ -115,7 +113,7 @@ export function buildAgentRuntimeConfig<TAgent extends string, TSkill extends Pr
   systemWorkspaceDetails?: string
   preSeededMemoriesSection?: string
   retrievedKnowledgeSection?: string
-  workstreamMemoryBlock?: string
+  threadMemoryBlock?: string
   responseGuardSection?: string
   learnedSkillsSection?: string
   additionalInstructionSections?: string[]
@@ -125,7 +123,7 @@ export function buildAgentRuntimeConfig<TAgent extends string, TSkill extends Pr
   buildSkillInstructionSection: (skills: TSkill[]) => string
   buildOnboardingPromptSection: () => string
 }): AgentRuntimeConfig<TAgent> {
-  const mode = params.mode ?? toChatMode(params.workstreamMode)
+  const mode = params.mode ?? toChatMode(params.threadType)
   const rulesSection = params.buildGlobalRuleInstructionSection(params.ruleOptions)
   const skillsSection =
     params.skills && params.skills.length > 0 ? params.buildSkillInstructionSection(params.skills) : ''
@@ -138,7 +136,7 @@ export function buildAgentRuntimeConfig<TAgent extends string, TSkill extends Pr
     params.systemWorkspaceDetails?.trim(),
     params.preSeededMemoriesSection?.trim(),
     params.retrievedKnowledgeSection?.trim(),
-    toMemoryBlockSection(params.workstreamMemoryBlock),
+    toMemoryBlockSection(params.threadMemoryBlock),
     ...(params.additionalInstructionSections?.map((section) => section.trim()) ?? []),
     params.responseGuardSection?.trim(),
     params.onboardingActive ? 'Onboarding is active. Keep responses onboarding-focused and concise.' : undefined,
@@ -154,9 +152,9 @@ export function buildAgentRuntimeConfig<TAgent extends string, TSkill extends Pr
   }
 }
 
-export function buildWorkstreamAgentToolPolicy<TAgent extends string, TSkill extends PropertyKey>(params: {
+export function buildThreadAgentToolPolicy<TAgent extends string, TSkill extends PropertyKey>(params: {
   agentId: TAgent
-  workstreamMode: 'direct' | 'group'
+  threadType: string
   mode?: ChatMode
   onboardingActive: boolean
   linearInstalled: boolean
@@ -164,11 +162,11 @@ export function buildWorkstreamAgentToolPolicy<TAgent extends string, TSkill ext
   provideRepoTool: boolean
   getAgentSkills: (agentId: TAgent, mode: ChatMode) => TSkill[]
 }): AgentToolPolicy<TSkill> {
-  const resolvedMode = params.mode ?? toChatMode(params.workstreamMode)
+  const resolvedMode = params.mode ?? toChatMode(params.threadType)
   const onboardingOwnerAgentId = resolveOnboardingOwnerAgentId(getLeadAgentId()) as TAgent
   const skills = resolveActiveAgentSkills({
     agentId: params.agentId,
-    workstreamMode: params.workstreamMode,
+    threadType: params.threadType,
     mode: resolvedMode,
     onboardingActive: params.onboardingActive,
     linearInstalled: params.linearInstalled,
@@ -203,7 +201,7 @@ export function buildTeamConsultationAgentToolPolicy({
   provideRepoTool: boolean
 }): AgentToolPolicy<string> & { blockedToolNames: Set<string> } {
   return {
-    resolvedMode: 'fixedWorkstreamMode',
+    resolvedMode: 'fixedThreadMode',
     skills: [],
     includeMemorySearch: false,
     includeConversationSearch: false,
@@ -249,9 +247,9 @@ export function buildOwnershipDispatchContextSection(params: {
   return [
     '<ownership-dispatch-execution>',
     'You are executing a single isolated execution-plan node.',
-    'Do not ask the user questions. Do not reference any hidden or prior workstream chat history.',
-    'Use only the provided node context, resolved input, input artifacts, and upstream handoff context.',
-    'Return only the final structured node result that satisfies the required output contract, including durable handoffContext for downstream nodes.',
+    'Do not ask the user questions. Do not reference any hidden or prior thread chat history.',
+    'Use only the provided node context, resolved input, input artifacts, and upstream summaries.',
+    'Return only the final structured node result that satisfies the required output contract.',
     JSON.stringify(payload, null, 2),
     '</ownership-dispatch-execution>',
   ].join('\n')
@@ -268,14 +266,14 @@ export function buildOwnershipDispatchResponseGuard(params: {
     return [
       '<ownership-dispatch-result-contract>',
       'Return a single JSON object with this exact shape:',
-      '{"structuredOutput"?: object, "artifacts": Array<{ "name": string, "kind": "json"|"markdown"|"file"|"external-ref"|"record", "pointer": string, "schemaRef"?: string, "description"?: string, "payload"?: object|array }>, "notes"?: string, "handoffContext"?: { "summary": string, "keyDecisions"?: string[], "openQuestions"?: string[], "risks"?: string[], "recommendations"?: string[], "references"?: string[] }}',
+      '{"notes": string, "structuredOutput"?: object, "artifacts": Array<{ "name": string, "kind": "json"|"markdown"|"file"|"external-ref"|"record", "description"?: string, "payload"?: object|array }>}',
       'Do not wrap the JSON in markdown or code fences.',
       `Node label: ${params.node.label}`,
       `Required deliverables: ${params.node.deliverables.length > 0 ? params.node.deliverables.map((item) => item.name).join(', ') : 'none'}`,
       ...(completionCheckHints.length > 0
         ? ['Structured output fields required by completion checks:', ...completionCheckHints]
         : []),
-      'If downstream nodes depend on this work, include handoffContext.',
+      'notes is required. Include a concise summary of what was done, key decisions, and any context downstream nodes need.',
       '</ownership-dispatch-result-contract>',
     ].join('\n')
   }

package/src/runtime/chat-request-routing.ts

@@ -8,7 +8,7 @@ export type RoutedChatRequest =
   | { kind: 'turn'; inputMessage: ChatMessage }
   | { kind: 'invalid'; message: string }
 
-export function routeWorkstreamChatMessages(messages: ChatMessage[]): RoutedChatRequest {
+export function routeThreadChatMessages(messages: ChatMessage[]): RoutedChatRequest {
   if (isApprovalContinuationRequest(messages)) {
     if (isNativeToolApprovalRequest(messages)) {
       return { kind: 'native-tool-approval', messages }

package/src/runtime/context-compaction-constants.ts

@@ -10,4 +10,4 @@ export const SUMMARY_ROLLUP_MAX_TOKENS = 80_000
 export const CONTEXT_COMPACTION_INCLUDED_TOOL_NAMES = ['userQuestions', 'proceedInOnboarding'] as const
 export const CONTEXT_COMPACTION_INCLUDED_TOOL_PREFIXES = ['linear'] as const
 export const CONTEXT_WINDOW_TOKENS = 200_000
-export const WORKSTREAM_RAW_TAIL_MESSAGES = 6
+export const THREAD_RAW_TAIL_MESSAGES = 6

package/src/runtime/context-compaction.ts

@@ -198,7 +198,7 @@ export function buildContextCompactionPrompt(params: ContextCompactionPromptPara
 export function buildMemoryBlockCompactionPrompt(params: MemoryBlockCompactionPromptParams): string {
   return [
     '<memory-block-compaction>',
-    'Produce a compact replacement summary for the workstream memory block.',
+    'Produce a compact replacement summary for the thread memory block.',
     'Preserve constraints, commitments, unresolved risks, and ownership.',
     'Blend the previous summary with the new raw entries into one updated summary.',
     'Return plain text only.',

package/src/runtime/execution-plan.ts

@@ -7,7 +7,7 @@ const EXECUTION_PLAN_AGENT_PROTOCOL_PROMPT = `<execution-plan-protocol>
 - The active execution runs in <execution-plan-state> are a summary inventory only. They list runId and title, not node-level state.
 - The runtime executor owns lifecycle truth. Do not claim node completion until the executor confirms.
 - Do not invent or restate run/node lifecycle details that are not present in the prompt or tool results.
-- During plan-triggered turns, use the dedicated result-submission tool. Include handoffContext.
+- During plan-triggered turns, use the dedicated result-submission tool.
 - Treat the active execution runs in <execution-plan-state> as authoritative for whether a plan already exists.
 - If contracts or criteria materially change, replace the plan.
 </execution-plan-protocol>`

package/src/runtime/index.ts

@@ -24,4 +24,4 @@ export * from './social-chat'
 export * from './team-consultation-orchestrator'
 export * from './team-consultation-prompts'
 export * from './turn-lifecycle'
-export * from './workstream-chat-helpers'
+export * from './thread-chat-helpers'

package/src/runtime/memory-digest-policy.ts

@@ -11,7 +11,7 @@ export function shouldEnqueueOnboardingPostChatMemory(params: {
   return params.userMessageText.trim().length > 0 || params.hasAttachmentContext
 }
 
-export function shouldEnqueueRegularDigestForWorkstream(params: {
+export function shouldEnqueueRegularDigestForThread(params: {
   onboardingActive: boolean
   turnCount?: number
 }): boolean {

package/src/runtime/plugin-types.ts

@@ -9,7 +9,7 @@ export interface LotaPluginContributions {
 
 export interface PluginNodeExecutorContext {
   organizationId: string
-  workstreamId: string
+  threadId: string
   planId: string
   nodeId: string
   userId?: RecordIdRef

package/src/runtime/post-turn-side-effects.ts

@@ -10,22 +10,22 @@ import {
   shouldEnqueueMemoryConsolidation,
   shouldEnqueueMemoryExtraction,
   shouldEnqueueOnboardingPostChatMemory,
-  shouldEnqueueRegularDigestForWorkstream,
+  shouldEnqueueRegularDigestForThread,
 } from '../runtime/memory-digest-policy'
 import { getRuntimeAdapters } from '../runtime/runtime-extensions'
 import { shouldEnqueueSkillExtraction } from '../runtime/skill-extraction-policy'
 import {
-  appendPersistedWorkstreamContextToHistoryMessages,
+  appendPersistedThreadContextToHistoryMessages,
   buildAgentHistoryMessages,
   buildConversationSummary,
   buildReadableUploadMetadataContext,
   extractMessageText,
   readOptionalString,
   toHistoryMessages,
-} from '../runtime/workstream-chat-helpers'
+} from '../runtime/thread-chat-helpers'
 import { recentActivityService } from '../services/recent-activity.service'
-import { workstreamService } from '../services/workstream.service'
-import type { NormalizedWorkstream, WorkstreamRecord } from '../services/workstream.types'
+import { threadService } from '../services/thread.service'
+import type { NormalizedThread, ThreadRecord } from '../services/thread.types'
 import { safeEnqueue } from '../utils/async'
 import { toIsoDateTimeString } from '../utils/date-time'
 
@@ -41,37 +41,37 @@ function resolveDisplayName(agentId: string, overrides?: Partial<Record<string,
 }
 
 function buildRecentActivityChatDeepLink(params: {
-  workstream: NormalizedWorkstream
-  workstreamId: string
+  thread: NormalizedThread
+  threadId: string
   visibleAgentId: string
 }): { route: string; search: Record<string, string> } {
-  if (params.workstream.mode === 'direct') {
-    return { route: 'direct-workstream', search: { workstreamId: params.workstreamId, agentId: params.visibleAgentId } }
+  if (params.thread.type === 'default') {
+    return { route: 'direct-thread', search: { threadId: params.threadId, agentId: params.visibleAgentId } }
   }
 
-  return { route: 'group-workstream', search: { workstreamId: params.workstreamId } }
+  return { route: 'group-thread', search: { threadId: params.threadId } }
 }
 
 function buildRecentActivityChatSystemTitle(params: {
-  workstream: NormalizedWorkstream
+  thread: NormalizedThread
   visibleAgentId: string
   agentDisplayNamesById?: Partial<Record<string, string>>
 }): string {
-  if (params.workstream.mode === 'direct') {
+  if (params.thread.type === 'default') {
     return `Conversation with ${resolveDisplayName(params.visibleAgentId, params.agentDisplayNamesById)}`
   }
 
-  return params.workstream.title.trim() || 'Workstream update'
+  return params.thread.title.trim() || 'Thread update'
 }
 
 interface PostTurnSideEffectsParams {
-  workstream: NormalizedWorkstream
-  workstreamRef: RecordIdRef
+  thread: NormalizedThread
+  threadRef: RecordIdRef
   orgRef: RecordIdRef
   userRef: RecordIdRef
   userName?: string | null
   orgIdString: string
-  workstreamIdString: string
+  threadIdString: string
   onboardingActive: boolean
   workspace: unknown
   allAssistantMessages: ChatMessage[]
@@ -85,19 +85,19 @@ interface PostTurnSideEffectsParams {
     storageKey: string
   }>
   memoryBlock: string
-  visibleWorkstreamAgentId: string | null | undefined
+  visibleThreadAgentId: string | null | undefined
   defaultLeadAgentId: string
-  latestWorkstreamRecord: WorkstreamRecord
+  latestThreadRecord: ThreadRecord
   isUserTurn: boolean
   agentDisplayNamesById?: Partial<Record<string, string>>
 }
 
 export async function runPostTurnSideEffects(params: PostTurnSideEffectsParams): Promise<void> {
   const recentHistory = await params.loadRecentHistory()
-  const turnCount = await workstreamService.incrementTurnCount(params.workstreamRef)
+  const turnCount = await threadService.incrementTurnCount(params.threadRef)
   const agentMessages = buildAgentHistoryMessages(params.allAssistantMessages)
-  const historyMessagesForMemory = appendPersistedWorkstreamContextToHistoryMessages(toHistoryMessages(recentHistory), {
-    compactionSummary: params.latestWorkstreamRecord.compactionSummary,
+  const historyMessagesForMemory = appendPersistedThreadContextToHistoryMessages(toHistoryMessages(recentHistory), {
+    compactionSummary: params.latestThreadRecord.compactionSummary,
   })
 
   const userMessageText = params.referenceUserMessage ? extractMessageText(params.referenceUserMessage).trim() : ''
@@ -120,7 +120,7 @@ export async function runPostTurnSideEffects(params: PostTurnSideEffectsParams):
       () =>
         enqueuePostChatMemory({
           orgId: params.orgIdString,
-          workstreamId: params.workstreamIdString,
+          threadId: params.threadIdString,
           sourceId: params.referenceUserMessageId,
           onboardStatus: readOptionalString((params.workspace as { onboardStatus?: unknown }).onboardStatus),
           userMessage: memoryUserMessage,
@@ -139,7 +139,7 @@ export async function runPostTurnSideEffects(params: PostTurnSideEffectsParams):
       assistantMessages: params.allAssistantMessages,
     })
     if (conversationSummary) {
-      const effectiveAgentId = params.visibleWorkstreamAgentId ?? params.defaultLeadAgentId
+      const effectiveAgentId = params.visibleThreadAgentId ?? params.defaultLeadAgentId
       const recentActivityResult = await recentActivityService.recordEvent({
         orgId: params.orgRef,
         userId: params.userRef,
@@ -147,27 +147,27 @@ export async function runPostTurnSideEffects(params: PostTurnSideEffectsParams):
         event: {
           sourceEventId: `chat-turn:${params.referenceUserMessageId}`,
           kind: 'chat.turn.completed',
-          targetKind: 'workstream',
-          targetId: params.workstreamIdString,
-          mergeKey: `workstream:${params.workstreamIdString}`,
+          targetKind: 'thread',
+          targetId: params.threadIdString,
+          mergeKey: `thread:${params.threadIdString}`,
           title: buildRecentActivityChatSystemTitle({
-            workstream: params.workstream,
+            thread: params.thread,
             visibleAgentId: effectiveAgentId,
             agentDisplayNamesById: params.agentDisplayNamesById,
           }),
           sourceLabel: resolveDisplayName(effectiveAgentId, params.agentDisplayNamesById),
           deepLink: buildRecentActivityChatDeepLink({
-            workstream: params.workstream,
-            workstreamId: params.workstreamIdString,
+            thread: params.thread,
+            threadId: params.threadIdString,
             visibleAgentId: effectiveAgentId,
           }),
           metadata: {
             agentId: effectiveAgentId,
             agentName: resolveDisplayName(effectiveAgentId, params.agentDisplayNamesById),
-            workstreamId: params.workstreamIdString,
-            workstreamTitle: params.latestWorkstreamRecord.title ?? params.workstream.title,
-            workstreamMode: params.workstream.mode,
-            ...(params.workstream.coreType ? { coreType: params.workstream.coreType } : {}),
+            threadId: params.threadIdString,
+            threadTitle: params.latestThreadRecord.title ?? params.thread.title,
+            threadType: params.thread.type,
+            ...(params.thread.threadType ? { coreType: params.thread.threadType } : {}),
             userMessageText,
             assistantSummary: conversationSummary,
             messageId: params.referenceUserMessageId,
@@ -186,7 +186,7 @@ export async function runPostTurnSideEffects(params: PostTurnSideEffectsParams):
 
           await enqueuePostChatOrgAction({
             orgId: params.orgIdString,
-            workstreamId: params.workstreamIdString,
+            threadId: params.threadIdString,
             sourceId: params.referenceUserMessageId,
             sourceCreatedAt,
             conversationSummary,
@@ -203,7 +203,7 @@ export async function runPostTurnSideEffects(params: PostTurnSideEffectsParams):
     }
   }
 
-  if (shouldEnqueueRegularDigestForWorkstream({ onboardingActive: params.onboardingActive, turnCount })) {
+  if (shouldEnqueueRegularDigestForThread({ onboardingActive: params.onboardingActive, turnCount })) {
     await safeEnqueue(() => enqueueRegularChatMemoryDigest({ orgId: params.orgIdString }), {
       operationName: 'regular chat memory digest enqueue',
     })

package/src/runtime/runtime-config.ts

@@ -1,9 +1,9 @@
 import type { ToolSet } from 'ai'
 import { z } from 'zod'
 
-import type { CoreWorkstreamProfile } from '../config/agent-defaults'
+import type { CoreThreadProfile } from '../config/agent-defaults'
 import type { AgentFactory, AgentRuntimeConfigProvider, AgentToolBuilder } from '../config/agent-types'
-import type { LotaWorkstreamConfig, WorkstreamBootstrapWelcomeConfig } from '../config/workstream-defaults'
+import type { LotaThreadConfig, ThreadBootstrapWelcomeConfig } from '../config/thread-defaults'
 import type { RecordIdRef } from '../db/record-id'
 import type { NotificationService } from '../services/notification.service'
 import { isRecord } from '../utils/string'
@@ -144,24 +144,27 @@ function isSocialChatConfig(value: unknown): value is LotaRuntimeSocialChatConfi
   return true
 }
 
-const workstreamBootstrapWelcomeConfigSchema = z.object({
-  directAgentId: z.string().trim().min(1),
-  buildMessageText: z.custom<WorkstreamBootstrapWelcomeConfig['buildMessageText']>(isFunction, {
+const threadBootstrapWelcomeConfigSchema = z.object({
+  defaultAgentId: z.string().trim().min(1),
+  buildMessageText: z.custom<ThreadBootstrapWelcomeConfig['buildMessageText']>(isFunction, {
     error: 'onboardingWelcome.buildMessageText must be a function',
   }),
 })
 
-const workstreamConfigSchema = z.object({
-  bootstrap: z
-    .object({
-      onboardingDirectAgents: z.array(z.string().trim().min(1)).optional(),
-      completedDirectAgents: z.array(z.string().trim().min(1)).optional(),
-      coreTypesAfterOnboarding: z.array(z.string().trim().min(1)).optional(),
-      ensureDefaultGroupOnCompleted: z.boolean().optional(),
-      onboardingWelcome: workstreamBootstrapWelcomeConfigSchema.optional(),
-    })
-    .optional(),
-})
+const threadConfigSchema = z
+  .object({
+    bootstrap: z
+      .object({
+        onboardingDefaultAgents: z.array(z.string().trim().min(1)).optional(),
+        completedDefaultAgents: z.array(z.string().trim().min(1)).optional(),
+        threadTypesAfterOnboarding: z.array(z.string().trim().min(1)).optional(),
+        ensureDefaultGroupOnCompleted: z.boolean().optional(),
+        onboardingWelcome: threadBootstrapWelcomeConfigSchema.optional(),
+      })
+      .strict()
+      .optional(),
+  })
+  .strict()
 
 const agentsConfigSchema = z
   .object({
@@ -178,9 +181,9 @@ const agentsConfigSchema = z
       .optional(),
     routerModelId: z.string().trim().min(1).optional(),
     teamConsultParticipants: z.array(z.string().trim().min(1)),
-    getCoreWorkstreamProfile: z
-      .custom<(coreType: string) => CoreWorkstreamProfile>(isFunction, {
-        error: 'agents.getCoreWorkstreamProfile must be a function',
+    getCoreThreadProfile: z
+      .custom<(coreType: string) => CoreThreadProfile>(isFunction, {
+        error: 'agents.getCoreThreadProfile must be a function',
       })
       .optional(),
     createAgent: z
@@ -249,7 +252,7 @@ export const LotaRuntimeConfigSchema = z.object({
       embeddingCacheTtlSeconds: z.coerce.number().int().positive().default(7200),
     })
     .default({ searchK: 6, embeddingCacheTtlSeconds: 7200 }),
-  workstreams: workstreamConfigSchema.default({}),
+  threads: threadConfigSchema.default({}),
   agents: agentsConfigSchema,
   toolProviders: z.custom<Record<string, unknown>>(isToolProviderRecord).optional(),
   extraSchemaFiles: z.array(z.custom<string | URL>(isStringOrUrl)).optional(),
@@ -319,4 +322,4 @@ export function parseWorkerBootstrapEnv(env: Record<string, string | undefined>)
   return WORKER_BOOTSTRAP_ENV_SCHEMA.parse(env)
 }
 
-export type { LotaWorkstreamConfig }
+export type { LotaThreadConfig }

package/src/runtime/runtime-extensions.ts

@@ -74,7 +74,7 @@ export interface LotaRuntimeTeamThinkToolsParams {
   workspaceId: RecordIdRef
   userId: RecordIdRef
   workspaceIdString: string
-  workstreamId: RecordIdRef
+  threadId: RecordIdRef
   githubInstalled: boolean
   provideRepoTool: boolean
   availableUploads: ReadableUploadMetadata[]
@@ -90,7 +90,7 @@ export interface LotaRuntimePlanEventEnvelope {
   nodeSpec?: PlanNodeSpecRecord
   nodeRun?: PlanNodeRunRecord
   organizationId: string
-  workstreamId: string
+  threadId: string
   runId: string
   planSpecId: string
   userId?: string
@@ -102,8 +102,8 @@ export interface LotaRuntimePlanEventAdapter {
 }
 
 export interface BuildContextParams {
-  workstream: unknown
-  workstreamRef: RecordIdRef
+  thread: unknown
+  threadRef: RecordIdRef
   orgRef: RecordIdRef
   userRef: RecordIdRef
   userName?: string | null
@@ -123,15 +123,15 @@ export interface BuildContextParams {
 }
 
 export interface AfterTurnParams {
-  workstream: unknown
-  workstreamRef: RecordIdRef
+  thread: unknown
+  threadRef: RecordIdRef
   orgRef: RecordIdRef
   userRef: RecordIdRef
   userName?: string | null
   onboardingActive: boolean
   referenceUserMessage: unknown
   assistantMessages: unknown[]
-  latestWorkstreamRecord: unknown
+  latestThreadRecord: unknown
   context: Record<string, unknown> | null
   [key: string]: unknown
 }
@@ -139,8 +139,8 @@ export interface AfterTurnParams {
 export interface ResolveAgentParams {
   agentId: string
   mode: string
-  workstream: unknown
-  workstreamRef: RecordIdRef
+  thread: unknown
+  threadRef: RecordIdRef
   orgRef: RecordIdRef
   userRef: RecordIdRef
   userName?: string | null
@@ -154,8 +154,8 @@ export interface ResolveAgentParams {
 }
 
 export interface BuildExtraInstructionSectionsParams {
-  workstream: unknown
-  workstreamRef: RecordIdRef
+  thread: unknown
+  threadRef: RecordIdRef
   orgRef: RecordIdRef
   userRef: RecordIdRef
   userName?: string | null

package/src/runtime/social-chat-agent-runner.ts

@@ -59,8 +59,8 @@ export function withLoggedSocialToolSet(
 
 export async function runSocialAgentTurn(params: {
   agentId: string
-  mode: 'fixedWorkstreamMode' | 'workstreamMode'
-  workstreamMode: 'group'
+  mode: 'fixedThreadMode' | 'threadMode'
+  threadType: 'group'
   onboardingActive: boolean
   linearInstalled: boolean
   systemWorkspaceDetails?: string
@@ -75,7 +75,7 @@ export async function runSocialAgentTurn(params: {
 }): Promise<{ text: string; displayName: string }> {
   const runtimeConfig = getAgentRuntimeConfig({
     agentId: params.agentId,
-    workstreamMode: params.workstreamMode,
+    threadType: params.threadType,
     mode: params.mode,
     onboardingActive: params.onboardingActive,
     linearInstalled: params.linearInstalled,

package/src/runtime/social-chat-history.ts

@@ -2,7 +2,7 @@ import { stripSlackToolExecutionNoticeMarkdown } from '@lota-sdk/shared'
 import type { Message, Thread } from 'chat'
 
 import type { SocialChatHistoryMessage } from '../services/social-chat-history.service'
-import { toHistoryMessages, toOptionalTrimmedString } from './workstream-chat-helpers'
+import { toHistoryMessages, toOptionalTrimmedString } from './thread-chat-helpers'
 
 export function readSlackAuthorName(message: Message): string | undefined {
   return (