@lota-sdk/core 0.1.13 → 0.1.15

package/src/runtime/workstream-routing-policy.ts

@@ -36,36 +36,6 @@ export function uniqueMentionOrder(message: string): string[] {
   return ordered
 }
 
-const GTM_STRONG_INTENT_PATTERNS: RegExp[] = [
-  /\bgo[-\s]?to[-\s]?market\b/i,
-  /\bgtm\b/i,
-  /\bcontent\s+marketing\b/i,
-  /\bcontent\s+strategy\b/i,
-  /\bdemand\s+generation\b/i,
-  /\bdistribution\s+strategy\b/i,
-  /\bpositioning\s+strategy\b/i,
-  /\blaunch\s+strategy\b/i,
-  /\blaunch\s+plan\b/i,
-]
-
-const GTM_WEAK_INTENT_PATTERNS: RegExp[] = [/\blaunch\b/i, /\bcommunity\b/i, /\bdistribution\b/i, /\bpositioning\b/i]
-
-export function isGtmIntentMessage(message: string): boolean {
-  const text = message.trim()
-  if (!text) return false
-
-  if (GTM_STRONG_INTENT_PATTERNS.some((pattern) => pattern.test(text))) {
-    return true
-  }
-
-  let weakMatches = 0
-  for (const pattern of GTM_WEAK_INTENT_PATTERNS) {
-    if (pattern.test(text)) weakMatches += 1
-    if (weakMatches >= 2) return true
-  }
-  return false
-}
-
 const HIGH_IMPACT_CLASS_PATTERNS: Array<{ className: HighImpactResponseClass; patterns: RegExp[] }> = [
   {
     className: 'architecture-recommendation',

package/src/runtime/workstream-state.ts

@@ -238,13 +238,23 @@ export interface CompactionOutput {
   stateDelta: WorkstreamStateDelta
 }
 
-export const WORKSTREAM_STATE_MAX_KEY_DECISIONS = 8
-export const WORKSTREAM_STATE_MAX_ACTIVE_CONSTRAINTS = 6
-export const WORKSTREAM_STATE_MAX_TASKS = 10
-export const WORKSTREAM_STATE_MAX_OPEN_QUESTIONS = 5
-export const WORKSTREAM_STATE_MAX_RISKS = 5
-export const WORKSTREAM_STATE_MAX_ARTIFACTS = 10
-export const WORKSTREAM_STATE_MAX_AGENT_CONTRIBUTIONS = 6
+const WORKSTREAM_STATE_MAX_KEY_DECISIONS = 8
+const WORKSTREAM_STATE_MAX_ACTIVE_CONSTRAINTS = 6
+const WORKSTREAM_STATE_MAX_TASKS = 10
+const WORKSTREAM_STATE_MAX_OPEN_QUESTIONS = 5
+const WORKSTREAM_STATE_MAX_RISKS = 5
+const WORKSTREAM_STATE_MAX_ARTIFACTS = 10
+const WORKSTREAM_STATE_MAX_AGENT_CONTRIBUTIONS = 6
+
+export function applyWorkstreamStateCaps(state: WorkstreamState): void {
+  state.keyDecisions = state.keyDecisions.slice(-WORKSTREAM_STATE_MAX_KEY_DECISIONS)
+  state.activeConstraints = state.activeConstraints.slice(-WORKSTREAM_STATE_MAX_ACTIVE_CONSTRAINTS)
+  state.tasks = state.tasks.slice(-WORKSTREAM_STATE_MAX_TASKS)
+  state.openQuestions = state.openQuestions.slice(-WORKSTREAM_STATE_MAX_OPEN_QUESTIONS)
+  state.risks = state.risks.slice(-WORKSTREAM_STATE_MAX_RISKS)
+  state.artifacts = state.artifacts.slice(-WORKSTREAM_STATE_MAX_ARTIFACTS)
+  state.agentContributions = state.agentContributions.slice(-WORKSTREAM_STATE_MAX_AGENT_CONTRIBUTIONS)
+}
 
 export function createEmptyWorkstreamState(now = Date.now()): WorkstreamState {
   return {

package/src/services/attachment.service.ts

@@ -3,7 +3,7 @@ import { recordIdToString } from '../db/record-id'
 import { TABLES } from '../db/tables'
 import { attachmentStorageService } from '../storage/attachment-storage.service'
 import type { UploadedWorkstreamAttachment as SdkUploadedWorkstreamAttachment } from '../storage/attachment-storage.service'
-import type { MessagePartLike, ReadableUploadMetadata as SdkReadableUploadMetadata } from '../storage/attachments.types'
+import type { MessagePartLike, ReadableUploadMetadata as SdkReadableUploadMetadata } from '../storage/attachment-types'
 
 export type ReadableUploadMetadata = SdkReadableUploadMetadata
 

package/src/services/context-compaction.service.ts

@@ -6,9 +6,9 @@ import { recordIdToString } from '../db/record-id'
 import { databaseService } from '../db/service'
 import { TABLES } from '../db/tables'
 import { parseWorkstreamState, toStateFieldsUpdated } from '../runtime/context-compaction'
-import { CONTEXT_SIZE, WORKSTREAM_RAW_TAIL_MESSAGES } from '../runtime/context-compaction-constants'
+import { CONTEXT_WINDOW_TOKENS, WORKSTREAM_RAW_TAIL_MESSAGES } from '../runtime/context-compaction-constants'
 import type { WorkstreamState } from '../runtime/workstream-state'
-import { compactMemoryBlockSummary, contextCompactionRuntime } from './context-compaction-runtime'
+import { compactMemoryBlockSummary, contextCompactionRuntime } from './context-compaction-runtime.singleton'
 import { workstreamMessageService } from './workstream-message.service'
 import { WorkstreamSchema } from './workstream.types'
 
@@ -35,7 +35,7 @@ class ContextCompactionService {
     return contextCompactionRuntime.formatWorkstreamStateForPrompt(state)
   }
 
-  estimateThreshold(contextSize = CONTEXT_SIZE): number {
+  estimateThreshold(contextSize = CONTEXT_WINDOW_TOKENS): number {
     return contextCompactionRuntime.estimateThreshold(contextSize)
   }
 

package/src/services/document-chunk.service.ts

@@ -3,6 +3,7 @@ import { createHash } from 'node:crypto'
 import { chunkMarkdownDocument, chunkPagedDocument, chunkPlainTextDocument } from '../document/org-document-chunking'
 import type { ParsedDocumentChunk } from '../document/org-document-chunking'
 import { getDefaultEmbeddings } from '../embeddings/provider'
+import { CHARS_PER_TOKEN_ESTIMATE } from '../utils/string'
 
 type DocumentChunkEmbeddings = {
   embedDocuments(documents: string[]): Promise<number[][]>
@@ -58,8 +59,10 @@ export class DocumentChunkService {
     return createHash('sha256').update(content).digest('hex')
   }
 
+  // Uses 4 chars/token (conservative estimate for document content which tends
+  // to have longer words than conversational text where 3 chars/token is used).
   estimateTokenCount(content: string): number {
-    return Math.max(1, Math.ceil(content.length / 4))
+    return Math.max(1, Math.ceil(content.length / (CHARS_PER_TOKEN_ESTIMATE + 1)))
   }
 
   async embedQuery(query: string): Promise<number[]> {
@@ -95,37 +98,39 @@ export class DocumentChunkService {
 
     await params.archive(staleVersionRows)
 
-    for (const [index, chunk] of params.chunks.entries()) {
-      const contentHash = this.hashContent(chunk.content)
-      const existingRow = existingByChunkKey.get(chunk.chunkKey)
-      const payload = params.buildPayload({
-        chunk,
-        embedding: embeddings[index] ?? [],
-        contentHash,
-        tokenEstimate: this.estimateTokenCount(chunk.content),
-      })
-
-      seenChunkKeys.add(chunk.chunkKey)
-
-      if (!existingRow) {
-        await params.create(payload)
-        continue
-      }
-
-      const current = params.selectShape(existingRow)
-      const hasChanged =
-        current.contentHash !== contentHash ||
-        current.chunkIndex !== chunk.chunkIndex ||
-        (current.sectionPath ?? null) !== (chunk.sectionPath ?? null) ||
-        (current.pageStart ?? null) !== (chunk.pageStart ?? null) ||
-        (current.pageEnd ?? null) !== (chunk.pageEnd ?? null)
-
-      if (!hasChanged) {
-        continue
-      }
-
-      await params.update(existingRow, payload)
-    }
+    await Promise.all(
+      params.chunks.map(async (chunk, index) => {
+        const contentHash = this.hashContent(chunk.content)
+        const existingRow = existingByChunkKey.get(chunk.chunkKey)
+        const payload = params.buildPayload({
+          chunk,
+          embedding: embeddings[index] ?? [],
+          contentHash,
+          tokenEstimate: this.estimateTokenCount(chunk.content),
+        })
+
+        seenChunkKeys.add(chunk.chunkKey)
+
+        if (!existingRow) {
+          await params.create(payload)
+          return
+        }
+
+        const current = params.selectShape(existingRow)
+        const hasChanged =
+          current.contentHash !== contentHash ||
+          current.chunkIndex !== chunk.chunkIndex ||
+          (current.sectionPath ?? null) !== (chunk.sectionPath ?? null) ||
+          (current.pageStart ?? null) !== (chunk.pageStart ?? null) ||
+          (current.pageEnd ?? null) !== (chunk.pageEnd ?? null)
+
+        if (!hasChanged) {
+          return
+        }
+
+        await params.update(existingRow, payload)
+      }),
+    )
 
     const removedCurrentVersionRows = existingRows.filter((row) => {
       const current = params.selectShape(row)

package/src/services/execution-plan.service.ts

@@ -612,6 +612,7 @@ class ExecutionPlanService {
   ): Promise<PlanNodeSpecRecord[]> {
     const createdRecords: PlanNodeSpecRecord[] = []
 
+    // Sequential: SurrealDB transactions require ordered operations
     for (const compiledNode of nodes) {
       const nodeSpecId = new RecordId(TABLES.PLAN_NODE_SPEC, Bun.randomUUIDv7())
       const created = await tx
@@ -657,6 +658,7 @@ class ExecutionPlanService {
     nodeSpecs: PlanNodeSpecRecord[],
   ): Promise<PlanNodeRunRecord[]> {
     const createdNodeRuns: PlanNodeRunRecord[] = []
+    // Sequential: SurrealDB transactions require ordered operations
     for (const nodeSpec of nodeSpecs) {
       const nodeRunId = new RecordId(TABLES.PLAN_NODE_RUN, Bun.randomUUIDv7())
       const created = await tx

package/src/services/learned-skill.service.ts

@@ -16,6 +16,7 @@ const embeddings = getDefaultEmbeddings()
 const PROMOTION_MIN_USES = 5
 const PROMOTION_MIN_SUCCESS_RATE = 0.6
 
+const ACTIVE_SKILL_FILTER = "AND status IN ['learned', 'verified', 'promoted'] AND archivedAt IS NONE"
 const SKILL_EXISTS_TTL_SECONDS = 120
 const SKILL_EXISTS_KEY_PREFIX = 'skill-exists'
 
@@ -176,8 +177,7 @@ class LearnedSkillService {
       new BoundQuery(
         `SELECT id FROM ${TABLES.LEARNED_SKILL}
          WHERE organizationId = $orgRef
-           AND status IN ['learned', 'verified', 'promoted']
-           AND archivedAt IS NONE
+           ${ACTIVE_SKILL_FILTER}
            AND (agentId IS NONE OR agentId = $agentId)
          LIMIT 1`,
         { orgRef, agentId },
@@ -227,8 +227,7 @@ class LearnedSkillService {
         vector::similarity::cosine(embedding, $embedding) AS similarity
       FROM ${TABLES.LEARNED_SKILL}
       WHERE organizationId = $organizationId
-        AND status IN ['learned', 'verified', 'promoted']
-        AND archivedAt IS NONE
+        ${ACTIVE_SKILL_FILTER}
         AND confidence >= $minConfidence
         AND (agentId IS NONE OR agentId = $agentId)
         AND embedding <|${params.limit}|> $embedding
@@ -311,8 +310,7 @@ class LearnedSkillService {
         vector::similarity::cosine(embedding, $embedding) AS similarity
       FROM ${TABLES.LEARNED_SKILL}
       WHERE organizationId = $organizationId
-        AND status IN ['learned', 'verified', 'promoted']
-        AND archivedAt IS NONE
+        ${ACTIVE_SKILL_FILTER}
         AND embedding <|3|> $embedding
       ORDER BY similarity DESC
       LIMIT 1
@@ -333,8 +331,7 @@ class LearnedSkillService {
         `SELECT *, type::string(id) AS id, type::string(organizationId) AS organizationId
          FROM ${TABLES.LEARNED_SKILL}
          WHERE organizationId = $organizationId
-           AND status IN ['learned', 'verified', 'promoted']
-           AND archivedAt IS NONE
+           ${ACTIVE_SKILL_FILTER}
          ORDER BY createdAt DESC`,
         { organizationId: orgRef },
       ),
@@ -357,8 +354,7 @@ class LearnedSkillService {
          FROM ${TABLES.LEARNED_SKILL}
          WHERE organizationId = $organizationId
            AND hash = $hash
-           AND status IN ['learned', 'verified', 'promoted']
-           AND archivedAt IS NONE
+           ${ACTIVE_SKILL_FILTER}
          LIMIT 1`,
         { organizationId: orgRef, hash },
       ),

package/src/services/{memory.utils.ts → memory-utils.ts}

@@ -1,22 +1,18 @@
 import { MEMORY } from '../config/constants'
 import { VECTOR_SEARCH_OVERFETCH_MULTIPLIER } from '../config/search'
 import type { MemorySearchResult } from '../db/memory-types'
-import { resolveCandidateLimit } from '../runtime/retrieval-pipeline'
+import { compactWhitespace } from '../utils/string'
 import type { MemoryRerankOutput } from './memory.service'
 
 export function getCandidateLimit(limit: number): number {
-  return resolveCandidateLimit({
-    limit,
-    multiplier: VECTOR_SEARCH_OVERFETCH_MULTIPLIER,
-    minimum: MEMORY.DEFAULT_CANDIDATE_LIMIT,
-  })
+  return Math.max(limit * VECTOR_SEARCH_OVERFETCH_MULTIPLIER, MEMORY.DEFAULT_CANDIDATE_LIMIT)
 }
 
 export function formatMemoryResults(results: MemorySearchResult[]): string {
   if (results.length === 0) return 'No stored memories.'
 
   const normalize = (value: string) => {
-    const trimmed = value.replace(/\s+/g, ' ').trim()
+    const trimmed = compactWhitespace(value)
     if (trimmed.length <= 400) return trimmed
     return `${trimmed.slice(0, 400)}...`
   }
@@ -65,7 +61,7 @@ export function formatRerankedResults(
       used.add(candidate.id)
       total += 1
       const reason = item.relevance ? ` — ${item.relevance}` : ''
-      const trimmed = candidate.content.replace(/\s+/g, ' ').trim()
+      const trimmed = compactWhitespace(candidate.content)
       const content = trimmed.length <= 400 ? trimmed : `${trimmed.slice(0, 400)}...`
       lines.push(`- ${content}${reason}`)
       if (total >= limit) break

package/src/services/memory.service.ts

@@ -24,10 +24,12 @@ import {
   scopedRetrievalToMap,
 } from '../runtime/retrieval-adapters'
 import { getRuntimeConfig } from '../runtime/runtime-config'
-import { createMemoryRerankerAgent, memoryRerankerPrompt } from '../system-agents/memory-reranker.agent'
-import { createOrgMemoryAgent, orgMemoryPrompt } from '../system-agents/memory.agent'
+import { createMemoryRerankerAgent, MEMORY_RERANKER_PROMPT } from '../system-agents/memory-reranker.agent'
+import { createOrgMemoryAgent, ORG_MEMORY_PROMPT } from '../system-agents/memory.agent'
+import { toError } from '../utils/errors'
+import { compactWhitespace } from '../utils/string'
 import { assessMemoryImportance, clampMemoryImportance } from './memory-assessment.service'
-import { formatMemoryResults, formatRerankedResults, getCandidateLimit } from './memory.utils'
+import { formatMemoryResults, formatRerankedResults, getCandidateLimit } from './memory-utils'
 
 const ORG_MEMORY_TYPE = 'fact'
 const RERANK_CANDIDATE_MAX_CHARS = 500
@@ -72,7 +74,7 @@ class MemoryService {
     const cached = cache.get(cacheKey)
     if (cached) return cached
 
-    const memory = new Memory({ createAgent: createOrgMemoryAgent }, { customPrompt: orgMemoryPrompt })
+    const memory = new Memory({ createAgent: createOrgMemoryAgent }, { customPrompt: ORG_MEMORY_PROMPT })
 
     cache.set(cacheKey, memory)
     aiLogger.debug`Memory client created and cached for ${cacheKey}`
@@ -85,7 +87,7 @@ class MemoryService {
   }
 
   private truncateCandidateText(value: string): string {
-    const normalized = value.replace(/\s+/g, ' ').trim()
+    const normalized = compactWhitespace(value)
     if (normalized.length <= RERANK_CANDIDATE_MAX_CHARS) return normalized
     return `${normalized.slice(0, RERANK_CANDIDATE_MAX_CHARS)}...`
   }
@@ -125,7 +127,7 @@ class MemoryService {
   }
 
   private normalizeConversationText(value: string, maxChars: number): string {
-    const normalized = value.replace(/\s+/g, ' ').trim()
+    const normalized = compactWhitespace(value)
     if (!normalized) return ''
     if (normalized.length <= maxChars) return normalized
     return `${normalized.slice(0, maxChars - 3)}...`
@@ -146,7 +148,7 @@ class MemoryService {
   }
 
   private normalizePreSeededMemoryText(value: string): string {
-    const normalized = value.replace(/\s+/g, ' ').trim()
+    const normalized = compactWhitespace(value)
     if (normalized.length <= PRESEEDED_MEMORY_MAX_CHARS) return normalized
     return `${normalized.slice(0, PRESEEDED_MEMORY_MAX_CHARS - 3)}...`
   }
@@ -232,7 +234,7 @@ class MemoryService {
       return await helperModelRuntime.generateHelperStructured({
         tag: 'memory-reranker',
         createAgent: createMemoryRerankerAgent,
-        defaultSystemPrompt: memoryRerankerPrompt,
+        defaultSystemPrompt: MEMORY_RERANKER_PROMPT,
         messages: [
           {
             role: 'user',
@@ -269,7 +271,7 @@ class MemoryService {
       return await helperModelRuntime.generateHelperStructured({
         tag: 'memory-reranker-multi-scope',
         createAgent: createMemoryRerankerAgent,
-        defaultSystemPrompt: memoryRerankerPrompt,
+        defaultSystemPrompt: MEMORY_RERANKER_PROMPT,
         messages: [
           {
             role: 'user',
@@ -334,7 +336,7 @@ class MemoryService {
       aiLogger.debug`Organization memory search completed (resultLength: ${results.length}, preview: ${results.slice(0, 100)})`
       return results
     } catch (error: unknown) {
-      const normalizedError = error instanceof Error ? error : new Error(String(error))
+      const normalizedError = toError(error)
       aiLogger.error`Organization memory search failed: ${normalizedError}`
       throw normalizedError
     }
@@ -348,7 +350,8 @@ class MemoryService {
       if (stale.length === 0) return ''
       const items = stale.map((m) => `- [NEEDS REVIEW] ${m.content}`).join('\n')
       return `Memories flagged for review (parent fact was superseded):\n${items}`
-    } catch {
+    } catch (error) {
+      aiLogger.warn`Failed to get stale memories: ${error}`
       return ''
     }
   }
@@ -359,7 +362,7 @@ class MemoryService {
     options?: { fastMode?: boolean; limit?: number },
   ): Promise<string> {
     const orgScopeId = scopeId(ORG_SCOPE_PREFIX, orgId)
-    aiLogger.info`[MEMORY_DEBUG] searchOrganizationMemoriesRaw - orgId: "${orgId}", scopeId: "${orgScopeId}"`
+    aiLogger.debug`searchOrganizationMemoriesRaw - orgId: "${orgId}", scopeId: "${orgScopeId}"`
     const memory = this.getOrgMemory(orgId)
     const fastMode = options?.fastMode ?? true
     const searchK = getRuntimeConfig().memory.searchK
@@ -376,7 +379,7 @@ class MemoryService {
       aiLogger.debug`Organization memory search (raw) completed (candidates: ${candidates.length})`
       return formatMemoryResults(candidates)
     } catch (error: unknown) {
-      const normalizedError = error instanceof Error ? error : new Error(String(error))
+      const normalizedError = toError(error)
       aiLogger.error`Organization memory search (raw) failed: ${normalizedError}`
       throw normalizedError
     }
@@ -397,7 +400,7 @@ class MemoryService {
       aiLogger.debug`Agent memory search completed (agentName: ${agentName}, resultLength: ${results.length}, preview: ${results.slice(0, 100)})`
       return results
     } catch (error: unknown) {
-      const normalizedError = error instanceof Error ? error : new Error(String(error))
+      const normalizedError = toError(error)
       aiLogger.error`Agent memory search failed: ${normalizedError}`
       throw normalizedError
     }
@@ -467,7 +470,7 @@ class MemoryService {
     const deduped: MemoryRecord[] = []
     const seen = new Set<string>()
     for (const memory of combined) {
-      const normalizedKey = memory.content.replace(/\s+/g, ' ').trim().toLowerCase()
+      const normalizedKey = compactWhitespace(memory.content).toLowerCase()
       if (!normalizedKey || seen.has(normalizedKey)) continue
       seen.add(normalizedKey)
       deduped.push(memory)
@@ -594,7 +597,7 @@ class MemoryService {
     durability?: MemoryRecord['durability']
   }): Promise<string> {
     const orgScopeId = scopeId(ORG_SCOPE_PREFIX, orgId)
-    aiLogger.info`[MEMORY_DEBUG] createOrganizationMemory - orgId: "${orgId}", scopeId: "${orgScopeId}", content preview: "${content.slice(0, 50)}"`
+    aiLogger.debug`createOrganizationMemory - orgId: "${orgId}", scopeId: "${orgScopeId}", content preview: "${content.slice(0, 50)}"`
     const memory = this.getOrgMemory(orgId)
     try {
       return await memory.insert(content, {
@@ -762,7 +765,7 @@ class MemoryService {
     }
 
     const orgScopeId = scopeId(ORG_SCOPE_PREFIX, orgId)
-    aiLogger.info`[MEMORY_DEBUG] addConversationMemories - orgId: "${orgId}", scopeId: "${orgScopeId}", sourceId: ${sourceId ?? 'none'}`
+    aiLogger.debug`addConversationMemories - orgId: "${orgId}", scopeId: "${orgScopeId}", sourceId: ${sourceId ?? 'none'}`
 
     const orgMemory = this.getOrgMemory(orgId)
     let assessedImportance: number | undefined
@@ -833,7 +836,7 @@ class MemoryService {
       })
       aiLogger.debug`Conversation memories added to ${scopes.length} scope(s) from ${messages.length} message(s)`
     } catch (error: unknown) {
-      const normalizedError = error instanceof Error ? error : new Error(String(error))
+      const normalizedError = toError(error)
       aiLogger.error`Memory write failed: ${normalizedError}`
       throw normalizedError
     }

package/src/services/organization-member.service.ts

@@ -23,7 +23,7 @@ const sdkOrganizationMemberSchema = z.object({
   createdAt: z.iso.datetime(),
 })
 
-export type SdkOrganizationMemberRecord = z.infer<typeof organizationMemberRecordSchema>
+type SdkOrganizationMemberRecord = z.infer<typeof organizationMemberRecordSchema>
 export type SdkOrganizationMember = z.infer<typeof sdkOrganizationMemberSchema>
 
 class OrganizationMemberService extends BaseService<typeof organizationMemberRecordSchema> {

package/src/services/plan-artifact.service.ts

@@ -17,6 +17,7 @@ class PlanArtifactService {
   }): Promise<PlanArtifactRecord[]> {
     const records: PlanArtifactRecord[] = []
 
+    // Sequential: SurrealDB transactions require ordered operations
     for (const artifact of params.artifacts) {
       const artifactId = new RecordId(TABLES.PLAN_ARTIFACT, Bun.randomUUIDv7())
       const created = await params.tx

package/src/services/plan-executor.service.ts

@@ -26,9 +26,11 @@ import { ensureRecordId, recordIdToString } from '../db/record-id'
 import { databaseService } from '../db/service'
 import type { DatabaseTransaction } from '../db/service'
 import { TABLES } from '../db/tables'
+import { isRecord } from '../utils/string'
 import { planApprovalService } from './plan-approval.service'
 import { planArtifactService } from './plan-artifact.service'
 import { planCheckpointService } from './plan-checkpoint.service'
+import { readPathValue } from './plan-helpers'
 import { planRunService } from './plan-run.service'
 import type { PlanValidationIssueInput } from './plan-validator.service'
 import { planValidatorService } from './plan-validator.service'
@@ -37,24 +39,6 @@ const SUCCESSFUL_TERMINAL_NODE_STATUSES = new Set(['completed', 'partial', 'skip
 const HUMAN_NODE_TYPES = new Set(['human-input', 'human-approval', 'human-review-edit', 'human-decision'])
 const STRUCTURAL_NODE_TYPES = new Set(['switch', 'join'])
 
-function isRecord(value: unknown): value is Record<string, unknown> {
-  return Boolean(value) && typeof value === 'object' && !Array.isArray(value)
-}
-
-function readPathValue(source: unknown, path: string): unknown {
-  if (!path.trim()) return source
-
-  let current: unknown = source
-  for (const segment of path
-    .split('.')
-    .map((part) => part.trim())
-    .filter(Boolean)) {
-    if (!isRecord(current)) return undefined
-    current = current[segment]
-  }
-  return current
-}
-
 function setPathValue(target: Record<string, unknown>, path: string, value: unknown) {
   const segments = path
     .split('.')

package/src/services/plan-helpers.ts

@@ -0,0 +1,15 @@
+import { isRecord } from '../utils/string'
+
+export function readPathValue(source: unknown, path: string): unknown {
+  if (!path.trim()) return source
+
+  let current: unknown = source
+  for (const segment of path
+    .split('.')
+    .map((part) => part.trim())
+    .filter(Boolean)) {
+    if (!isRecord(current)) return undefined
+    current = current[segment]
+  }
+  return current
+}

package/src/services/plan-validator.service.ts

@@ -8,6 +8,9 @@ import type {
   PlanValidationIssueSeverity,
 } from '@lota-sdk/shared'
 
+import { isRecord } from '../utils/string'
+import { readPathValue } from './plan-helpers'
+
 const STRUCTURAL_NODE_TYPES = new Set(['switch', 'join'])
 const HUMAN_NODE_TYPES = new Set(['human-input', 'human-approval', 'human-review-edit', 'human-decision'])
 
@@ -46,24 +49,6 @@ function createIssue(params: {
   }
 }
 
-function isRecord(value: unknown): value is Record<string, unknown> {
-  return Boolean(value) && typeof value === 'object' && !Array.isArray(value)
-}
-
-function readPathValue(source: unknown, path: string): unknown {
-  if (!path.trim()) return source
-
-  let current: unknown = source
-  for (const segment of path
-    .split('.')
-    .map((part) => part.trim())
-    .filter(Boolean)) {
-    if (!isRecord(current)) return undefined
-    current = current[segment]
-  }
-  return current
-}
-
 function hasAllFields(value: unknown, fields: string[]): boolean {
   if (!isRecord(value)) return false
   return fields.every((field) => readPathValue(value, field) !== undefined)

package/src/services/recent-activity-title.service.ts

@@ -1,20 +1,13 @@
 import { createHelperModelRuntime } from '../runtime/helper-model'
+import { normalizeTitle } from '../runtime/title-helpers'
 import {
   createRecentActivityTitleRefinerAgent,
-  recentActivityTitleRefinerPrompt,
+  RECENT_ACTIVITY_TITLE_REFINER_PROMPT,
 } from '../system-agents/recent-activity-title-refiner.agent'
-import { compactWhitespace } from '../utils/string'
 import { recentActivityService } from './recent-activity.service'
 
 const RECENT_ACTIVITY_TITLE_TIMEOUT_MS = 60_000
 
-function normalizeTitle(value: string): string {
-  const normalized = compactWhitespace(value)
-    .replace(/^["'`]+|["'`]+$/g, '')
-    .replace(/[.!?,;:]+$/g, '')
-  return normalized.length <= 80 ? normalized : normalized.slice(0, 80).trim()
-}
-
 function buildRefinementPromptInput(
   candidate: Awaited<ReturnType<typeof recentActivityService.getRefinementCandidate>>,
 ) {
@@ -52,7 +45,7 @@ class RecentActivityTitleService {
       await this.helperRuntime.generateHelperText({
         tag: 'recent-activity-title-refinement',
         createAgent: createRecentActivityTitleRefinerAgent,
-        defaultSystemPrompt: recentActivityTitleRefinerPrompt,
+        defaultSystemPrompt: RECENT_ACTIVITY_TITLE_REFINER_PROMPT,
         timeoutMs: RECENT_ACTIVITY_TITLE_TIMEOUT_MS,
         messages: [{ role: 'user', content: promptInput }],
       }),

package/src/services/recent-activity.service.ts

@@ -166,18 +166,12 @@ class RecentActivityService {
   }): Promise<RecentActivity[]> {
     await databaseService.connect()
 
-    const items: RecentActivity[] = []
-    for (const candidate of params.events) {
-      const recorded = await this.recordEvent({
-        orgId: params.orgId,
-        userId: params.userId,
-        source: params.source,
-        event: candidate,
-      })
-      items.push(recorded.item)
-    }
-
-    return items
+    const results = await Promise.all(
+      params.events.map((candidate) =>
+        this.recordEvent({ orgId: params.orgId, userId: params.userId, source: params.source, event: candidate }),
+      ),
+    )
+    return results.map((r) => r.item)
   }
 
   async recordEvent(params: {