@warlock.js/ai 4.3.0 → 4.4.0

package/CHANGELOG.md

@@ -4,6 +4,13 @@ All notable changes to `@warlock.js/ai` are documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). `@warlock.js/*` packages are released in lockstep — every package shares the same version number, so a version below may list only the changes that affected this package.
 
+## 4.4.0 - 2026-06-21
+
+### Fixed
+
+- **Planner: OpenAI strict structured-output 400.** The generated plan schema now lists every property in `required` (the optional `id` / `reason` / `dependsOn` are nullable) and no longer emits `minItems` / `maxItems`, so `ai.planner()` no longer fails with `400 Invalid schema for response_format … 'required' … Missing 'id'` against OpenAI strict `json_schema` mode. `maxSteps` and the non-empty-plan check are enforced at runtime / in `validate()`.
+- **Report / result types no longer collapse to `never` under strict TypeScript.** The narrowing report types (`PlannerReport`, `OrchestratorReport`, `SupervisorReport`, `WorkflowReport`, `ToolCall`) and the two result types that re-declare `report` (`PlannerResult`, `OrchestratorResult`) now override the discriminant via `Omit<BaseReport, "type">` / `Omit<ExecuteResult, "report">` instead of intersecting `BaseReport & { type: "…" }`, so `result.report` no longer types as `never` (*"Property 'plan' does not exist on type 'never'"*). Type-only — no runtime change.
+
 ## 4.3.0 - 2026-06-21
 
 ### ⚠ BREAKING

package/cjs/index.cjs

@@ -11747,23 +11747,20 @@ function resolvePrefix$1(prompt) {
 * (the planner still truncates the tail to `skipped` defensively).
 */
 function planSchema(capabilityNames, maxSteps) {
-	const stepsSchema = {
-		type: "array",
-		minItems: 1,
-		description: "Ordered steps to execute, one capability dispatch each.",
-		items: stepItemsSchema(capabilityNames)
-	};
-	if (maxSteps !== void 0) stepsSchema.maxItems = maxSteps;
 	const jsonSchema = {
 		type: "object",
 		properties: {
 			summary: {
-				type: "string",
+				type: ["string", "null"],
 				description: "One-line summary of the overall strategy."
 			},
-			steps: stepsSchema
+			steps: {
+				type: "array",
+				description: "Ordered steps to execute, one capability dispatch each.",
+				items: stepItemsSchema(capabilityNames)
+			}
 		},
-		required: ["steps"],
+		required: ["summary", "steps"],
 		additionalProperties: false
 	};
 	return { "~standard": {
@@ -11794,7 +11791,7 @@ function stepItemsSchema(capabilityNames) {
 		type: "object",
 		properties: {
 			id: {
-				type: "string",
+				type: ["string", "null"],
 				description: "Stable step id, referenced by dependsOn."
 			},
 			capability: {
@@ -11807,16 +11804,22 @@ function stepItemsSchema(capabilityNames) {
 				description: "Concrete input passed to the capability's execute()."
 			},
 			reason: {
-				type: "string",
+				type: ["string", "null"],
 				description: "Why this step exists."
 			},
 			dependsOn: {
-				type: "array",
+				type: ["array", "null"],
 				items: { type: "string" },
 				description: "Ids of steps this one conceptually follows."
 			}
 		},
-		required: ["capability", "input"],
+		required: [
+			"id",
+			"capability",
+			"input",
+			"reason",
+			"dependsOn"
+		],
 		additionalProperties: false
 	};
 }