@lota-sdk/core 0.1.48 → 0.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lota-sdk/core",
-  "version": "0.1.48",
+  "version": "0.2.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.1.48",
+    "@lota-sdk/shared": "0.2.1",
     "@mendable/firecrawl-js": "^4.18.0",
     "@surrealdb/node": "^3.0.3",
     "ai": "^6.0.141",

package/src/runtime/execution-plan.ts

@@ -4,10 +4,11 @@ type ExecutionPlanPromptSummary = Pick<SerializableExecutionPlan, 'runId' | 'tit
 
 const EXECUTION_PLAN_AGENT_PROTOCOL_PROMPT = `<execution-plan-protocol>
 - Create execution plans for multi-step work. Review existing plans before creating new ones.
+- 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.
-- Work only on active/ready nodes assigned to you. Stop at human gates.
+- 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.
-- Treat the active execution runs in <execution-plan-state> as authoritative. Do not mutate run or node status in prose.
+- 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/services/workstream-turn-preparation.service.ts

@@ -741,6 +741,9 @@ export async function prepareWorkstreamRunCore(params: WorkstreamRunCoreParams):
         const runAbort = createServerRunAbortController(
           runAbortSignals.filter((signal): signal is AbortSignal => Boolean(signal)),
         )
+        if (runAbort.signal.aborted) {
+          throw runAbort.signal.reason ?? new DOMException('The operation was aborted.', 'AbortError')
+        }
         // Plan turns run without the chat lease — don't claim the active run slot.
         if (params.kind !== 'planTurn') {
           await workstreamService.setActiveTurn(workstreamRef, serverRunId, params.streamId ?? null)
@@ -749,6 +752,11 @@ export async function prepareWorkstreamRunCore(params: WorkstreamRunCoreParams):
         runTimer.step('set-active-run+stream')
 
         try {
+          const throwIfRunAborted = () => {
+            if (!runAbort.signal.aborted) return
+            throw runAbort.signal.reason ?? new DOMException('The operation was aborted.', 'AbortError')
+          }
+
           const buildAgentMetadataPatch = (agentId: string, agentName: string): NonNullable<MessageMetadata> => ({
             agentId,
             agentName,
@@ -771,6 +779,8 @@ export async function prepareWorkstreamRunCore(params: WorkstreamRunCoreParams):
             agentName: string,
             metadataPatch?: NonNullable<MessageMetadata>,
           ) => {
+            throwIfRunAborted()
+
             const committed = withMessageCreatedAt(
               {
                 ...response,
@@ -782,6 +792,7 @@ export async function prepareWorkstreamRunCore(params: WorkstreamRunCoreParams):
             await workstreamMessageService.upsertMessages({ workstreamId: workstreamRef, messages: [committed] })
             currentMessages = upsertChatHistoryMessage(currentMessages, committed)
             allAssistantMessages = upsertChatHistoryMessage(allAssistantMessages, committed)
+            throwIfRunAborted()
 
             return committed
           }
@@ -843,6 +854,7 @@ export async function prepareWorkstreamRunCore(params: WorkstreamRunCoreParams):
             const tools = runParams.filterTools ? runParams.filterTools(rawTools) : rawTools
             visibleTimer.step('build-agent-tools')
             streamCtx.memoryBlock = memoryBlock
+            throwIfRunAborted()
             const responseMessage = await streamAgentResponse(streamCtx, {
               agentId: runParams.agentId,
               mode: runParams.mode,
@@ -902,6 +914,7 @@ export async function prepareWorkstreamRunCore(params: WorkstreamRunCoreParams):
               const wsMembers = (workstream as { members?: string[] }).members ?? []
               const members = wsMembers.length > 0 ? wsMembers : [...agentRoster]
               const fallbackAgentId = coreWorkstreamProfile?.config.agentId ?? defaultLeadAgentId
+              throwIfRunAborted()
               writeMultiAgentEvent(writer, { phase: 'routing', note: 'Routing this turn to the right agent.' })
 
               const recentContext = currentMessages
@@ -915,6 +928,7 @@ export async function prepareWorkstreamRunCore(params: WorkstreamRunCoreParams):
                 messageText,
                 recentContext,
               })
+              throwIfRunAborted()
 
               const runGroupAgent = async (
                 agentId: string,
@@ -941,6 +955,7 @@ export async function prepareWorkstreamRunCore(params: WorkstreamRunCoreParams):
               if (!triageResult) {
                 // No specialist match — fallback to owner (core) or chief (non-core), single visible turn.
                 await runGroupAgent(fallbackAgentId)
+                throwIfRunAborted()
                 writeMultiAgentEvent(writer, { phase: 'complete' })
               } else {
                 const respondedAgents: string[] = []
@@ -948,6 +963,7 @@ export async function prepareWorkstreamRunCore(params: WorkstreamRunCoreParams):
                   routingContext: triageResult.routingContext,
                 })
                 respondedAgents.push(triageResult.agentId)
+                throwIfRunAborted()
 
                 // Follow-up specialists run headless, persist their own messages,
                 // and are surfaced by transient events plus cache refresh.
@@ -960,6 +976,7 @@ export async function prepareWorkstreamRunCore(params: WorkstreamRunCoreParams):
                     respondedAgents,
                     lastResponseSummary: lastResponseText,
                   })
+                  throwIfRunAborted()
 
                   if (checkResult.done || !checkResult.agentId) break
 
@@ -982,17 +999,20 @@ export async function prepareWorkstreamRunCore(params: WorkstreamRunCoreParams):
                     ],
                     metadata: { hidden: true, createdAt: Date.now() } as MessageMetadata,
                   }
+                  throwIfRunAborted()
                   await workstreamMessageService.upsertMessages({
                     workstreamId: workstreamRef,
                     messages: [bridgeMessage],
                   })
                   currentMessages = upsertChatHistoryMessage(currentMessages, bridgeMessage)
+                  throwIfRunAborted()
 
                   lastResponse = await runGroupAgent(checkResult.agentId, {
                     routingContext: checkResult.routingContext,
                     headless: true,
                   })
                   respondedAgents.push(checkResult.agentId)
+                  throwIfRunAborted()
                   writeMultiAgentEvent(writer, {
                     phase: 'agent-message-persisted',
                     agentId: checkResult.agentId,
@@ -1001,6 +1021,7 @@ export async function prepareWorkstreamRunCore(params: WorkstreamRunCoreParams):
                   })
                 }
 
+                throwIfRunAborted()
                 writeMultiAgentEvent(writer, { phase: 'complete' })
               }
             }