@lota-sdk/shared 0.1.32 → 0.1.33

package/package.json

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

package/src/schemas/tools.ts

@@ -8,14 +8,25 @@ import { PlanNodeResultSubmissionSchema, PlanRunStatusSchema, SerializableExecut
 export const USER_QUESTIONS_TOOL_NAME = 'userQuestions' as const
 export const CONSULT_SPECIALIST_TOOL_NAME = 'consultSpecialist' as const
 export const CONSULT_TEAM_TOOL_NAME = 'consultTeam' as const
+export const EXECUTION_PLAN_TOOL_NAME = 'executionPlan' as const
+export const EXECUTION_PLAN_QUERY_TOOL_NAME = 'executionPlanQuery' as const
+export const SUBMIT_PLAN_TURN_RESULT_TOOL_NAME = 'submitPlanTurnResult' as const
+
+/** @deprecated Use EXECUTION_PLAN_TOOL_NAME */
 export const CREATE_EXECUTION_PLAN_TOOL_NAME = 'createExecutionPlan' as const
+/** @deprecated Use EXECUTION_PLAN_TOOL_NAME */
 export const CREATE_PROJECT_WITH_PLAN_TOOL_NAME = 'createProjectWithPlan' as const
+/** @deprecated Use EXECUTION_PLAN_TOOL_NAME */
 export const REPLACE_EXECUTION_PLAN_TOOL_NAME = 'replaceExecutionPlan' as const
+/** @deprecated Use EXECUTION_PLAN_TOOL_NAME */
 export const SUBMIT_EXECUTION_NODE_RESULT_TOOL_NAME = 'submitExecutionNodeResult' as const
-export const SUBMIT_PLAN_TURN_RESULT_TOOL_NAME = 'submitPlanTurnResult' as const
+/** @deprecated Use EXECUTION_PLAN_QUERY_TOOL_NAME */
 export const LIST_EXECUTION_PLANS_TOOL_NAME = 'listExecutionPlans' as const
+/** @deprecated Use EXECUTION_PLAN_QUERY_TOOL_NAME */
 export const GET_EXECUTION_PLAN_DETAILS_TOOL_NAME = 'getExecutionPlanDetails' as const
+/** @deprecated Use EXECUTION_PLAN_QUERY_TOOL_NAME */
 export const GET_ACTIVE_EXECUTION_PLAN_TOOL_NAME = 'getActiveExecutionPlan' as const
+/** @deprecated Use EXECUTION_PLAN_TOOL_NAME */
 export const RESUME_EXECUTION_PLAN_RUN_TOOL_NAME = 'resumeExecutionPlanRun' as const
 
 const UserQuestionItemSchema = z
@@ -100,6 +111,45 @@ export const GetActiveExecutionPlanArgsSchema = z
 
 export const ResumeExecutionPlanRunArgsSchema = z.object({ runId: z.string().trim().min(1) }).strict()
 
+export const ExecutionPlanActionSchema = z
+  .enum(['create', 'create-project', 'replace', 'resume'])
+  .describe(
+    'create: inline plan (1-2 nodes). create-project: plan in a dedicated project workstream (3+ nodes). replace: replace active plan. resume: resume interrupted plan.',
+  )
+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 workstream.'),
+  targetWorkstreamId: z
+    .string()
+    .trim()
+    .min(1)
+    .optional()
+    .describe('Target existing workstream. 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.'),
+}).strict()
+export type ExecutionPlanArgs = z.infer<typeof ExecutionPlanArgsSchema>
+
+export const ExecutionPlanQueryArgsSchema = z
+  .object({
+    runId: z.string().trim().min(1).optional().describe('Specific plan run to load. Omit to list all active plans.'),
+    includeEvents: z.boolean().default(true).optional(),
+    includeArtifacts: z.boolean().default(true).optional(),
+    includeApprovals: z.boolean().default(true).optional(),
+    includeCheckpoints: z.boolean().default(false).optional(),
+    includeValidationIssues: z.boolean().default(true).optional(),
+  })
+  .strict()
+export type ExecutionPlanQueryArgs = z.infer<typeof ExecutionPlanQueryArgsSchema>
+
 export const PlanSummarySchema = z
   .object({ runId: z.string(), title: z.string(), status: PlanRunStatusSchema })
   .strict()
@@ -166,12 +216,10 @@ export type CoreChatTools = {
   userQuestions: { input: UserQuestionsArgs; output: unknown }
   consultSpecialist: { input: ConsultSpecialistArgs; output: ConsultSpecialistResultData }
   consultTeam: { input: ConsultTeamArgs; output: ConsultTeamResultData }
-  createExecutionPlan: { input: CreateExecutionPlanArgs; output: ExecutionPlanToolResultData }
-  createProjectWithPlan: { input: CreateProjectWithPlanArgs; output: CreateProjectWithPlanResultData }
-  replaceExecutionPlan: { input: ReplaceExecutionPlanArgs; output: ExecutionPlanToolResultData }
-  submitExecutionNodeResult: { input: SubmitExecutionNodeResultArgs; output: ExecutionPlanToolResultData }
+  executionPlan: { input: ExecutionPlanArgs; output: ExecutionPlanToolResultData }
+  executionPlanQuery: {
+    input: ExecutionPlanQueryArgs
+    output: ExecutionPlanToolResultData | ListExecutionPlansToolResultData
+  }
   submitPlanTurnResult: { input: SubmitPlanTurnResultArgs; output: ExecutionPlanToolResultData }
-  listExecutionPlans: { input: ListExecutionPlansArgs; output: ListExecutionPlansToolResultData }
-  getExecutionPlanDetails: { input: GetActiveExecutionPlanArgs; output: ExecutionPlanToolResultData }
-  resumeExecutionPlanRun: { input: ResumeExecutionPlanRunArgs; output: ExecutionPlanToolResultData }
 }