@lota-sdk/shared 0.3.1 → 0.3.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lota-sdk/shared",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "type": "module",
   "main": "./src/index.ts",
   "types": "./src/index.ts",

package/src/constants/execution-plan.ts

@@ -5,13 +5,13 @@ export const HUMAN_NODE_TYPES = ['human-input', 'human-approval', 'human-review-
 export const STRUCTURAL_NODE_TYPES = ['switch', 'join', 'deliberation-fork'] as const
 
 export const PROJECT_PLAN_ROUTING_PROMPT = `<project-plan-routing>
-- Use createExecutionPlan for small inline work inside the current thread.
-- Use createProjectWithPlan when the work needs a dedicated project thread, should stay visible in the sidebar or board, or needs 3 or more meaningful execution nodes.
-- If createExecutionPlan rejects a larger draft, immediately retry with createProjectWithPlan instead of forcing the plan inline.
+- Use executionPlan with action "create" for small inline work inside the current thread.
+- Use executionPlan with action "create-project" when the work needs a dedicated project thread, should stay visible in the sidebar or board, or needs 3 or more meaningful execution nodes.
+- Never invent other plan tool names.
 </project-plan-routing>`
 
 export const EXECUTION_PLAN_SELF_START_PROMPT = `<execution-plan-self-start>
-- When you create an execution plan with createExecutionPlan or createProjectWithPlan and the first node is assigned to you, begin executing that node immediately in the same turn. Do not wait for the user to ask.
+- When you create an execution plan with executionPlan and the first node is assigned to you, begin executing that node immediately in the same turn. Do not wait for the user to ask.
 - After completing a node, submit the result and check whether the next ready node is also yours. If so, continue working.
 - When the user's message relates to an active plan where you own ready nodes, inspect the plan state and proactively work on your ready nodes.
 - When you own a blocked or failed node, tell the user what is blocked and what resolution is needed.

package/src/schemas/tools.ts

@@ -71,24 +71,49 @@ export const ExecutionPlanActionSchema = z
   )
 export type ExecutionPlanAction = z.infer<typeof ExecutionPlanActionSchema>
 
-export const ExecutionPlanArgsSchema = AgentPlanDraftSchema.extend({
-  action: ExecutionPlanActionSchema,
-  projectTitle: z
-    .string()
-    .trim()
-    .min(1)
-    .max(200)
-    .optional()
-    .describe('Required for create-project when creating a new thread.'),
-  targetThreadId: z
-    .string()
-    .trim()
-    .min(1)
-    .optional()
-    .describe('Target existing thread. For create-project, provide either this or projectTitle.'),
-  runId: z.string().trim().min(1).optional().describe('Required for replace and resume.'),
-  reason: z.string().trim().min(1).max(1000).optional().describe('Required for replace.'),
+const projectTitleSchema = z
+  .string()
+  .trim()
+  .min(1)
+  .max(200)
+  .describe('Required for create-project when creating a new thread.')
+
+const targetThreadIdSchema = z
+  .string()
+  .trim()
+  .min(1)
+  .describe('Target existing thread. For create-project, provide either this or projectTitle.')
+
+const runIdSchema = z.string().trim().min(1)
+const replaceReasonSchema = z.string().trim().min(1).max(1000)
+
+const ExecutionPlanCreateArgsSchema = AgentPlanDraftSchema.extend({
+  action: z.literal('create'),
+  targetThreadId: targetThreadIdSchema.optional(),
 }).strict()
+
+const ExecutionPlanCreateProjectArgsSchema = AgentPlanDraftSchema.extend({
+  action: z.literal('create-project'),
+  projectTitle: projectTitleSchema.optional(),
+  targetThreadId: targetThreadIdSchema.optional(),
+}).strict()
+
+const ExecutionPlanReplaceArgsSchema = AgentPlanDraftSchema.extend({
+  action: z.literal('replace'),
+  runId: runIdSchema.describe('Required for replace and resume.'),
+  reason: replaceReasonSchema.describe('Required for replace.'),
+}).strict()
+
+const ExecutionPlanResumeArgsSchema = z
+  .object({ action: z.literal('resume'), runId: runIdSchema.describe('Required for replace and resume.') })
+  .strict()
+
+export const ExecutionPlanArgsSchema = z.discriminatedUnion('action', [
+  ExecutionPlanCreateArgsSchema,
+  ExecutionPlanCreateProjectArgsSchema,
+  ExecutionPlanReplaceArgsSchema,
+  ExecutionPlanResumeArgsSchema,
+])
 export type ExecutionPlanArgs = z.infer<typeof ExecutionPlanArgsSchema>
 
 export const ExecutionPlanQueryArgsSchema = z