@locusai/sdk 0.11.8 → 0.12.1

package/dist/planning/agents/cross-task-reviewer.d.ts

@@ -1,15 +1 @@
-/**
- * Cross-Task Reviewer Agent Persona
- *
- * Phase 2 (final) of the planning meeting. Reviews the Planner's
- * sprint plan for task ordering issues, dependency correctness,
- * description quality, and overall plan coherence.
- */
-export interface CrossTaskReviewerInput {
-    directive: string;
-    projectContext: string;
-    plannerOutput: string;
-    feedback?: string;
-}
-export declare function buildCrossTaskReviewerPrompt(input: CrossTaskReviewerInput): string;
 //# sourceMappingURL=cross-task-reviewer.d.ts.map

package/dist/planning/agents/cross-task-reviewer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cross-task-reviewer.d.ts","sourceRoot":"","sources":["../../../src/planning/agents/cross-task-reviewer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,sBAAsB,GAC5B,MAAM,CAkHR"}
+{"version":3,"file":"cross-task-reviewer.d.ts","sourceRoot":"","sources":["../../../src/planning/agents/cross-task-reviewer.ts"],"names":[],"mappings":""}

package/dist/planning/agents/planner.d.ts

@@ -1,15 +1,20 @@
 /**
- * Planner Agent Persona
+ * Sprint Planning Prompt
  *
- * Phase 1 of the simplified planning meeting. Combines the responsibilities
- * of the former Tech Lead, Architect, and Sprint Organizer into a single
- * pass that produces a complete, ordered sprint plan from the CEO directive.
+ * Uses XML system message structure to provide clear, structured instructions
+ * to the AI for sprint planning from a CEO directive.
+ *
+ * The AI agent writes the plan JSON file directly to the plans directory.
  */
 export interface PlannerInput {
     directive: string;
-    projectContext: string;
-    codebaseIndex: string;
     feedback?: string;
+    /** Absolute path to the plans directory (e.g. /project/.locus/plans) */
+    plansDir: string;
+    /** Pre-generated plan ID (e.g. plan-1234567890) */
+    planId: string;
+    /** File name slug derived from the plan name */
+    fileName: string;
 }
 export declare function buildPlannerPrompt(input: PlannerInput): string;
 //# sourceMappingURL=planner.d.ts.map

package/dist/planning/agents/planner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../../../src/planning/agents/planner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAyG9D"}
+{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../../../src/planning/agents/planner.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,QAAQ,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAoE9D"}

package/dist/planning/index.d.ts

@@ -1,4 +1,4 @@
 export { PlanManager } from "./plan-manager.js";
-export { PlanningMeeting, type PlanningMeetingConfig, type PlanningMeetingResult, type PlanningPhase, } from "./planning-meeting.js";
+export { PlanningMeeting, type PlanningMeetingConfig, type PlanningMeetingResult, } from "./planning-meeting.js";
 export { type PlannedTask, parseSprintPlanFromAI, plannedTasksToCreatePayloads, type SprintPlan, type SprintPlanRisk, sprintPlanToMarkdown, } from "./sprint-plan.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/planning/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/planning/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EACL,eAAe,EACf,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,aAAa,GACnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,KAAK,WAAW,EAChB,qBAAqB,EACrB,4BAA4B,EAC5B,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/planning/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EACL,eAAe,EACf,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,GAC3B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,KAAK,WAAW,EAChB,qBAAqB,EACrB,4BAA4B,EAC5B,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC"}

package/dist/planning/plan-manager.d.ts

@@ -6,7 +6,6 @@ import { type SprintPlan } from "./sprint-plan.js";
  * save, load, list, approve, reject, cancel.
  */
 export declare class PlanManager {
-    private projectPath;
     private plansDir;
     constructor(projectPath: string);
     /**

package/dist/planning/plan-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plan-manager.d.ts","sourceRoot":"","sources":["../../src/planning/plan-manager.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,EAEL,KAAK,UAAU,EAEhB,MAAM,kBAAkB,CAAC;AAE1B;;;GAGG;AACH,qBAAa,WAAW;IAGV,OAAO,CAAC,WAAW;IAF/B,OAAO,CAAC,QAAQ,CAAS;gBAEL,WAAW,EAAE,MAAM;IAIvC;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM;IAa9B;;OAEG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAoBzC;;OAEG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC,QAAQ,CAAC,GAAG,UAAU,EAAE;IA4BjD;;;OAGG;IACG,OAAO,CACX,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,WAAW,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,IAAI,EAAE,CAAA;KAAE,CAAC;IA+C7C;;;OAGG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU;IAmBtD;;OAEG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAW9B;;OAEG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IA6B9B;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAM5C,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,OAAO;CAMhB"}
+{"version":3,"file":"plan-manager.d.ts","sourceRoot":"","sources":["../../src/planning/plan-manager.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAEL,KAAK,UAAU,EAEhB,MAAM,kBAAkB,CAAC;AAE1B;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAS;gBAEb,WAAW,EAAE,MAAM;IAI/B;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM;IAa9B;;OAEG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAoBzC;;OAEG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC,QAAQ,CAAC,GAAG,UAAU,EAAE;IA4BjD;;;OAGG;IACG,OAAO,CACX,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,WAAW,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,IAAI,EAAE,CAAA;KAAE,CAAC;IAoC7C;;;OAGG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU;IAmBtD;;OAEG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAW9B;;OAEG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IA6B9B;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAM5C,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,OAAO;CAMhB"}

package/dist/planning/planning-meeting.d.ts

@@ -1,6 +1,5 @@
 import type { AiRunner } from "../ai/runner.js";
-import { type SprintPlan } from "./sprint-plan.js";
-export type PlanningPhase = "planner" | "review" | "complete";
+import type { SprintPlan } from "./sprint-plan.js";
 export interface PlanningMeetingConfig {
     projectPath: string;
     aiRunner: AiRunner;
@@ -8,17 +7,15 @@ export interface PlanningMeetingConfig {
 }
 export interface PlanningMeetingResult {
     plan: SprintPlan;
-    /** Raw outputs from each phase for debugging/transparency */
-    phaseOutputs: {
-        planner: string;
-        review: string;
-    };
+    /** Raw output from the planning team for debugging/transparency */
+    rawOutput: string;
 }
 /**
- * Orchestrates a two-phase planning meeting where AI agent personas
- * collaborate to produce a sprint plan.
+ * Orchestrates a single-phase planning meeting where 3 AI team members
+ * (Architect, Tech Lead, Sprint Organizer) collaborate in one pass
+ * to produce a sprint plan.
  *
- * Flow: CEO Directive → Planner → Cross-Task Review → Sprint Plan
+ * Flow: CEO Directive → Planning Team (Architect + Tech Lead + Sprint Organizer) → Sprint Plan
  */
 export declare class PlanningMeeting {
     private projectPath;
@@ -26,10 +23,11 @@ export declare class PlanningMeeting {
     private log;
     constructor(config: PlanningMeetingConfig);
     /**
-     * Run the full planning meeting pipeline.
+     * Run the planning meeting.
+     *
+     * The AI agent writes the plan JSON file directly to .locus/plans/
+     * using its file writing tools. We then read it back from disk.
      */
     run(directive: string, feedback?: string): Promise<PlanningMeetingResult>;
-    private getProjectContext;
-    private getCodebaseIndex;
 }
 //# sourceMappingURL=planning-meeting.d.ts.map

package/dist/planning/planning-meeting.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"planning-meeting.d.ts","sourceRoot":"","sources":["../../src/planning/planning-meeting.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAKhD,OAAO,EAAyB,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE1E,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE9D,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,QAAQ,CAAC;IACnB,GAAG,CAAC,EAAE,CACJ,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,KAC1C,IAAI,CAAC;CACX;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,UAAU,CAAC;IACjB,6DAA6D;IAC7D,YAAY,EAAE;QACZ,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,GAAG,CAGD;gBAEE,MAAM,EAAE,qBAAqB;IAMzC;;OAEG;IACG,GAAG,CACP,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,qBAAqB,CAAC;IA6CjC,OAAO,CAAC,iBAAiB;IAKzB,OAAO,CAAC,gBAAgB;CA8BzB"}
+{"version":3,"file":"planning-meeting.d.ts","sourceRoot":"","sources":["../../src/planning/planning-meeting.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAGhD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,QAAQ,CAAC;IACnB,GAAG,CAAC,EAAE,CACJ,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,KAC1C,IAAI,CAAC;CACX;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,UAAU,CAAC;IACjB,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,GAAG,CAGD;gBAEE,MAAM,EAAE,qBAAqB;IAMzC;;;;;OAKG;IACG,GAAG,CACP,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,qBAAqB,CAAC;CAsDlC"}

package/dist/planning/sprint-plan.d.ts

@@ -39,9 +39,13 @@ export declare function sprintPlanToMarkdown(plan: SprintPlan): string;
  */
 export declare function plannedTasksToCreatePayloads(plan: SprintPlan, sprintId: string): CreateTask[];
 /**
- * Parse a sprint plan from a JSON string (as returned by AI).
- * Validates required fields, assigns defaults, and ensures tasks
- * are topologically sorted by their dependencies.
+ * Parse a sprint plan from raw LLM output text.
+ *
+ * Uses Zod schemas to validate the JSON structure instead of manual
+ * type assertions. This provides:
+ * - Clear error messages when the LLM produces malformed output
+ * - Automatic defaults for missing fields
+ * - Type-safe parsing without manual casting
  */
 export declare function parseSprintPlanFromAI(raw: string, directive: string): SprintPlan;
 //# sourceMappingURL=sprint-plan.d.ts.map

package/dist/planning/sprint-plan.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sprint-plan.d.ts","sourceRoot":"","sources":["../../src/planning/sprint-plan.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,YAAY,EAElB,MAAM,iBAAiB,CAAC;AAGzB,MAAM,WAAW,WAAW;IAC1B,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,YAAY,CAAC;IAC3B,QAAQ,EAAE,YAAY,CAAC;IACvB,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CACrC;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,CAAC;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAiE7D;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,UAAU,EAChB,QAAQ,EAAE,MAAM,GACf,UAAU,EAAE,CAgBd;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,GAChB,UAAU,CAkDZ"}
+{"version":3,"file":"sprint-plan.d.ts","sourceRoot":"","sources":["../../src/planning/sprint-plan.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,YAAY,EAElB,MAAM,iBAAiB,CAAC;AA8CzB,MAAM,WAAW,WAAW;IAC1B,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,YAAY,CAAC;IAC3B,QAAQ,EAAE,YAAY,CAAC;IACvB,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CACrC;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,CAAC;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAiE7D;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,UAAU,EAChB,QAAQ,EAAE,MAAM,GACf,UAAU,EAAE,CAgBd;AAMD;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,GAChB,UAAU,CAiCZ"}

package/dist/utils/json-extractor.d.ts

@@ -1,6 +1,10 @@
 /**
- * Extract a JSON object string from LLM output that may contain
- * surrounding prose, markdown code blocks, or other non-JSON text.
+ * Extract a JSON object string from LLM output.
+ *
+ * Handles common LLM output patterns:
+ * - Pure JSON
+ * - JSON wrapped in markdown code fences
+ * - JSON preceded/followed by prose text
  */
 export declare function extractJsonFromLLMOutput(raw: string): string;
 //# sourceMappingURL=json-extractor.d.ts.map

package/dist/utils/json-extractor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"json-extractor.d.ts","sourceRoot":"","sources":["../../src/utils/json-extractor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAmD5D"}
+{"version":3,"file":"json-extractor.d.ts","sourceRoot":"","sources":["../../src/utils/json-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAiD5D"}

package/dist/utils/structured-output.d.ts

@@ -0,0 +1,14 @@
+import { z } from "zod";
+/**
+ * Parse raw LLM output into a typed object validated by a Zod schema.
+ *
+ * Steps:
+ * 1. Extract JSON from the raw LLM text (handles markdown blocks, surrounding prose)
+ * 2. Parse the extracted string with JSON.parse
+ * 3. Validate + coerce through the provided Zod schema
+ *
+ * On failure, throws with an actionable error message that includes
+ * the Zod validation issues so callers can log or surface them.
+ */
+export declare function parseJsonWithSchema<T extends z.ZodType>(raw: string, schema: T): z.output<T>;
+//# sourceMappingURL=structured-output.d.ts.map

package/dist/utils/structured-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured-output.d.ts","sourceRoot":"","sources":["../../src/utils/structured-output.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EACrD,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,CAAC,GACR,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CA2Bb"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@locusai/sdk",
-  "version": "0.11.8",
+  "version": "0.12.1",
   "type": "module",
   "main": "./src/index.ts",
   "types": "./src/index.ts",
@@ -23,17 +23,18 @@
     "README.md"
   ],
   "scripts": {
-    "build": "bun build ./src/index.ts ./src/index-node.ts ./src/agent/worker.ts --outdir ./dist --target node --format cjs --external axios --external events --external globby --external @locusai/shared && tsc -p tsconfig.build.json --emitDeclarationOnly",
+    "build": "bun build ./src/index.ts ./src/index-node.ts ./src/agent/worker.ts --outdir ./dist --target node --format cjs --external axios --external events --external globby --external @locusai/shared --external zod && tsc -p tsconfig.build.json --emitDeclarationOnly",
     "dev": "tsc --watch",
     "lint": "biome lint .",
     "typecheck": "tsc --noEmit",
     "clean": "rm -rf node_modules"
   },
   "dependencies": {
-    "@locusai/shared": "^0.11.8",
+    "@locusai/shared": "^0.12.1",
     "axios": "^1.13.2",
     "events": "^3.3.0",
-    "globby": "^14.0.2"
+    "globby": "^14.0.2",
+    "zod": "^4.3.6"
   },
   "devDependencies": {
     "typescript": "^5.8.3",

package/dist/project/knowledge-base.d.ts

@@ -1,24 +0,0 @@
-export interface ProjectInfo {
-    name: string;
-    mission: string;
-    techStack: string[];
-}
-export interface ProgressEntry {
-    role: "user" | "assistant";
-    content: string;
-    timestamp?: Date;
-}
-export declare class KnowledgeBase {
-    private contextPath;
-    private progressPath;
-    constructor(projectPath: string);
-    readContext(): string;
-    readProgress(): string;
-    updateContext(content: string): void;
-    updateProgress(entry: ProgressEntry): void;
-    getFullContext(): string;
-    initialize(info: ProjectInfo): void;
-    get exists(): boolean;
-    private ensureDir;
-}
-//# sourceMappingURL=knowledge-base.d.ts.map

package/dist/project/knowledge-base.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"knowledge-base.d.ts","sourceRoot":"","sources":["../../src/project/knowledge-base.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,YAAY,CAAS;gBAEjB,WAAW,EAAE,MAAM;IAK/B,WAAW,IAAI,MAAM;IAOrB,YAAY,IAAI,MAAM;IAOtB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKpC,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAa1C,cAAc,IAAI,MAAM;IAiBxB,UAAU,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IA+BnC,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,OAAO,CAAC,SAAS;CAMlB"}

package/dist/worktree/index.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=index.d.ts.map

package/dist/worktree/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/worktree/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC"}

package/dist/worktree/worktree-config.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=worktree-config.d.ts.map

package/dist/worktree/worktree-config.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"worktree-config.d.ts","sourceRoot":"","sources":["../../src/worktree/worktree-config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC"}

package/dist/worktree/worktree-manager.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=worktree-manager.d.ts.map

package/dist/worktree/worktree-manager.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"worktree-manager.d.ts","sourceRoot":"","sources":["../../src/worktree/worktree-manager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC"}