@theokit/sdk 2.18.0 → 2.19.0

package/CHANGELOG.md

@@ -1,5 +1,36 @@
 # Changelog
 
+## 2.19.0
+
+### Minor Changes
+
+- `GenerateObjectOptions.errorStrategy` (`"throw" | "return-partial" | "return-raw"`, default `"throw"`) — controls what `Agent.generateObject` does when the model's output still fails schema validation after all retries. `"return-raw"` resolves with the raw unvalidated input; `"return-partial"` salvages best-effort (object schemas keep only fields that individually validate). Additive + backward-compatible (M14).
+
+## 2.18.1
+
+### Patch Changes
+
+- fc09700: Label the cloud-only surfaces as pre-release in `docs.md` (M7). The README already
+  carried a "Cloud runtime — pre-release" banner; `docs.md` (the canonical API
+  contract) only labeled artifacts. It now carries an explicit cloud pre-release
+  banner in the Overview and inline "cloud-only, pre-release" labels on `cloud.envVars`,
+  `cloud.autoCreatePR`, and `result.git` — matching the SDK's pre-release-honesty
+  contract (cloud depends on Theo PaaS, currently pre-release; every cloud API
+  describes the contract for when PaaS reaches GA, validated by the SDK's cloud
+  contract/golden tests against a stub, not a live endpoint). No API or behavior
+  change; no GA claim. Also fixed a teardown race in the cloud runtime contract test
+  (dispose flushes the fire-and-forget session appends before the temp workspace is
+  removed, so `rm(recursive)` no longer races an in-flight write into `ENOTEMPTY`).
+- e132c2d: Strengthen the README cross-pillar front door (M8 GA-readiness): the "Where this
+  fits" section now explains the 4-pillar OPEN-STACK composition (UI · Harness ·
+  Skills · Runtime), how they compose end-to-end (local agent + tools/plugins +
+  `useAgentStream` render, zero Theo-backend dependency), the honest per-pillar status
+  (Runtime/cloud pre-release), and the validated cross-pillar wiring (Skills↔Harness +
+  UI↔Harness green vs SDK 2.18.0; Runtime↔Harness contract-only). Also fixes a stale
+  reference to the removed `referencia/` directory (study peers are cloned on demand
+  under `.claude/knowledge-base/reference/`). Docs-only; no API/behavior change; no GA
+  claim.
+
 ## 2.18.0
 
 ### Minor Changes

package/dist/a2a/index.cjs

@@ -7863,22 +7863,23 @@ async function executeTool(inputs, resolved, call) {
     return { stdout: "", stderr: `Unknown tool ${call.name}`, exitCode: 127 };
   }
   if (resolved.origin === "shell") return runShellTool(inputs, call);
-  if (resolved.origin === "memory") return runMemoryTool(resolved, call);
-  if (resolved.origin === "custom") return runCustomTool(resolved, call, inputs.signal);
+  if (resolved.origin === "memory") return runMemoryTool(resolved, call, inputs.context);
+  if (resolved.origin === "custom")
+    return runCustomTool(resolved, call, inputs.signal, inputs.context);
   return runMcpTool(inputs, resolved, call);
 }
-async function runMemoryTool(resolved, call) {
-  return runHandlerTool("memory", resolved.memoryHandler, call);
+async function runMemoryTool(resolved, call, context) {
+  return runHandlerTool("memory", resolved.memoryHandler, call, void 0, context);
 }
-async function runCustomTool(resolved, call, signal) {
-  return runHandlerTool("custom", resolved.customHandler, call, signal);
+async function runCustomTool(resolved, call, signal, context) {
+  return runHandlerTool("custom", resolved.customHandler, call, signal, context);
 }
-async function runHandlerTool(kind, handler, call, signal) {
+async function runHandlerTool(kind, handler, call, signal, context) {
   if (handler === void 0) {
     return { stdout: "", stderr: `${kind} tool ${call.name} has no handler`, exitCode: 127 };
   }
   try {
-    const stdout = await handler(call.input, { signal });
+    const stdout = await handler(call.input, { signal, context });
     return { stdout, stderr: "", exitCode: 0 };
   } catch (cause) {
     const message = cause instanceof Error ? cause.message : String(cause);
@@ -12383,6 +12384,9 @@ function buildLoopInputs(options, runId, userText) {
     // D318 — forward SendOptions.signal to the agent loop so streamLlmTurn
     // can attach it to the LLM `fetch({ signal })` call.
     ...options.sendOptions.signal !== void 0 ? { signal: options.sendOptions.signal } : {},
+    // M7 — forward SendOptions.context to the loop so every tool handler receives
+    // it on `ctx.context` (shared run config set once, e.g. projectRoot).
+    ...options.sendOptions.context !== void 0 ? { context: options.sendOptions.context } : {},
     // #58 / #57 — forward the per-tool timeout + tool-result guard so a consumer
     // can enable them via SendOptions (not only internal AgentLoopInputs).
     ...options.sendOptions.perToolTimeoutMs !== void 0 ? { perToolTimeoutMs: options.sendOptions.perToolTimeoutMs } : {},
@@ -17153,6 +17157,19 @@ __export(generate_object_exports, {
   GenerateObjectError: () => GenerateObjectError,
   generateObjectImpl: () => generateObjectImpl
 });
+function salvagePartial(schema, raw) {
+  if (typeof raw !== "object" || raw === null) return raw;
+  const shape = schema.shape;
+  if (shape === void 0 || typeof shape !== "object") return raw;
+  const rawObj = raw;
+  const out = {};
+  for (const [key, fieldSchema] of Object.entries(shape)) {
+    if (typeof fieldSchema?.safeParse !== "function") continue;
+    const parsed = fieldSchema.safeParse(rawObj[key]);
+    if (parsed.success) out[key] = parsed.data;
+  }
+  return out;
+}
 async function generateObjectImpl(options, deps) {
   const { jsonSchema, maxRetries, initialUsage } = setupStructuredOutput(
     options.schema,
@@ -17219,6 +17236,22 @@ async function generateObjectImpl(options, deps) {
       }
       lastParseError = parsed.error;
     }
+    if (options.errorStrategy === "return-raw") {
+      return {
+        object: capturedRaw,
+        raw: capturedRaw,
+        usage: lastUsage,
+        finishReason: "tool_use"
+      };
+    }
+    if (options.errorStrategy === "return-partial") {
+      return {
+        object: salvagePartial(options.schema, capturedRaw),
+        raw: capturedRaw,
+        usage: lastUsage,
+        finishReason: "tool_use"
+      };
+    }
     throw new GenerateObjectError(
       "parse_failed",
       "Schema parse failed after all retries.",