@theokit/sdk 3.2.0 → 3.2.3

package/dist/index.js

@@ -4754,7 +4754,14 @@ var init_env_policy = __esm({
       /[_-]PWD/i,
       /CREDENTIAL/i,
       /PRIVATE/i,
-      /_AUTH/i
+      /_AUTH/i,
+      // #54-a — value-embedded-secret conventions (no generic `*_URL` — see keep-list test).
+      /DSN/i,
+      /WEBHOOK/i,
+      /COOKIE/i,
+      /CONNECTION[_-]?STRING/i,
+      // Known DB / message-broker connection-string vars (carry `user:pass@`).
+      /(?:^|[_-])(?:DATABASE|DB|REDIS|MONGO(?:DB)?|POSTGRES(?:QL)?|MYSQL|MARIADB|AMQP|RABBITMQ|CLICKHOUSE|ELASTIC(?:SEARCH)?|CASSANDRA|COUCHDB|MEMCACHED|NATS|KAFKA)[_-]?(?:URL|URI|DSN|CONNECTION)/i
     ];
     CORE_VARS = [
       "PATH",
@@ -5163,12 +5170,23 @@ var init_objective_coerce = __esm({
 // src/internal/persistence/pagination.ts
 function paginate(items, opts) {
   if (opts === void 0 || opts.offset === void 0 && opts.limit === void 0) return items;
-  const start = Math.max(0, opts.offset ?? 0);
-  const end = opts.limit === void 0 ? items.length : start + Math.max(0, opts.limit);
+  const start = opts.offset === void 0 ? 0 : requireNonNegativeInt(opts.offset, "offset");
+  const limit = opts.limit === void 0 ? void 0 : requireNonNegativeInt(opts.limit, "limit");
+  const end = limit === void 0 ? items.length : start + limit;
   return items.slice(start, end);
 }
+function requireNonNegativeInt(value, field) {
+  if (!Number.isInteger(value) || value < 0) {
+    throw new ConfigurationError(
+      `Invalid pagination ${field}: expected a non-negative integer, got ${value}`,
+      { code: "pagination_invalid" }
+    );
+  }
+  return value;
+}
 var init_pagination = __esm({
   "src/internal/persistence/pagination.ts"() {
+    init_errors();
   }
 });
 
@@ -7751,15 +7769,19 @@ async function collectChildToolResults(run) {
 ${lines.join("\n")}
 </subagent-tool-results>`;
 }
-async function runChildAgent(spec, input, signal, maxSteps, inherited) {
-  const { Agent: Agent2 } = await Promise.resolve().then(() => (init_agent(), agent_exports));
+function buildChildCreateOptions(spec, inherited) {
   const model = spec.model ? { id: spec.model } : inherited?.model;
-  const agent = await Agent2.create({
+  return {
     ...inherited?.apiKey !== void 0 ? { apiKey: inherited.apiKey } : {},
     ...model !== void 0 ? { model } : {},
+    ...inherited?.plugins !== void 0 ? { plugins: inherited.plugins } : {},
     systemPrompt: spec.instructions,
     tools: spec.tools ?? []
-  });
+  };
+}
+async function runChildAgent(spec, input, signal, maxSteps, inherited) {
+  const { Agent: Agent2 } = await Promise.resolve().then(() => (init_agent(), agent_exports));
+  const agent = await Agent2.create(buildChildCreateOptions(spec, inherited));
   try {
     const sendOptions = {
       ...signal !== void 0 ? { signal } : {},
@@ -9662,7 +9684,10 @@ async function runAgentLoop(inputs) {
       }
       budget.consume();
       inputs.budgetTracker?.nextIteration?.();
-      if (inputs.signal?.aborted === true) break;
+      if (inputs.signal?.aborted === true) {
+        ctx.finalStatus = "cancelled";
+        break;
+      }
     }
     if (lastTurnDecision === "continue" && budget.shouldContinue() === false) {
       ctx.stoppedAtIterationLimit = true;
@@ -9847,15 +9872,15 @@ async function guardAndTransformToolResults(inputs, raw, ctx) {
 }
 async function continueOrTerminate(inputs, ctx, llmOutput) {
   if (llmOutput.errored) return "error";
-  if (llmOutput.text.length > 0) {
-    await emitAssistantTextStep(inputs, ctx, llmOutput.text);
+  const tCtx = { agentId: inputs.agentId, runId: inputs.runId };
+  const text = llmOutput.text.length > 0 ? await transformLlmOutputText(inputs, llmOutput.text, tCtx) : llmOutput.text;
+  if (text.length > 0) {
+    await emitAssistantTextStep(inputs, ctx, text);
   }
   if (llmOutput.stopReason !== "tool_use" || llmOutput.toolCalls.length === 0) {
     return finishOrReflect(inputs, ctx, llmOutput);
   }
-  const tCtx = { agentId: inputs.agentId, runId: inputs.runId };
-  const outText = await transformLlmOutputText(inputs, llmOutput.text, tCtx);
-  ctx.messages.push(buildAssistantTurn(outText, llmOutput.toolCalls));
+  ctx.messages.push(buildAssistantTurn(text, llmOutput.toolCalls));
   const rawResults = await dispatchTools(
     // SE12 — forward a read-only text projection of the transcript-so-far to tool
     // handlers via `ctx.messages` (consumed by defineSubAgent's messageFilter).
@@ -10333,6 +10358,8 @@ function parseRetryAfter(headers) {
   if (raw === null) return void 0;
   const n = Number(raw);
   if (Number.isFinite(n) && n >= 0) return Math.ceil(n);
+  const dateMs = Date.parse(raw);
+  if (Number.isFinite(dateMs)) return Math.max(0, Math.ceil((dateMs - Date.now()) / 1e3));
   return void 0;
 }
 function truncateRaw(body) {
@@ -10653,6 +10680,7 @@ function buildAnthropicBody(request) {
 var AnthropicClient, AnthropicStreamAccumulator;
 var init_anthropic3 = __esm({
   "src/internal/llm/anthropic.ts"() {
+    init_errors();
     init_anthropic2();
     init_anthropic_shared();
     init_finish();
@@ -10706,12 +10734,23 @@ var init_anthropic3 = __esm({
           const events = accumulator.consume(parsed);
           for (const event of events) yield event;
         }
+        if (!accumulator.finishReasonSeen) {
+          throw new NetworkError("Anthropic SSE stream truncated (no stop_reason)", {
+            code: "stream_truncated"
+          });
+        }
         return accumulator.finish();
       }
     };
     AnthropicStreamAccumulator = class {
       text = "";
       stopReason = "end_turn";
+      /**
+       * M2 #61 — whether a `message_delta` carrying a real `stop_reason` was seen.
+       * A stream that closes before it is a truncation (server FIN / proxy hiccup),
+       * not a clean `end_turn` — the caller throws `stream_truncated` on `false`.
+       */
+      sawStopReason = false;
       inputTokens;
       outputTokens;
       cacheReadTokens;
@@ -10758,6 +10797,9 @@ var init_anthropic3 = __esm({
        * spinning the SSE parser.
        */
       handleMessageDelta(md) {
+        if (md.delta.stop_reason !== void 0 && md.delta.stop_reason !== null) {
+          this.sawStopReason = true;
+        }
         this.stopReason = mapAnthropicStopReason(md.delta.stop_reason);
         if (md.usage?.input_tokens !== void 0) this.inputTokens = md.usage.input_tokens;
         if (md.usage?.output_tokens !== void 0) this.outputTokens = md.usage.output_tokens;
@@ -10768,6 +10810,10 @@ var init_anthropic3 = __esm({
           this.cacheReadTokens = md.usage.cache_read_input_tokens;
         }
       }
+      /** M2 #61 — whether the terminal `message_delta` (stop_reason) was seen. */
+      get finishReasonSeen() {
+        return this.sawStopReason;
+      }
       finish() {
         const toolCalls = [];
         for (const [index, tool] of this.toolCalls.entries()) {
@@ -13001,7 +13047,6 @@ var init_client = __esm({
       // concurrent request so parallel tool dispatch after a drop awaits one handshake
       // instead of racing (or spuriously failing with mcp_not_init).
       dropped = false;
-      reconnectAttempts = 0;
       reconnectPromise;
       get timeoutMs() {
         return this.config.requestTimeoutMs ?? DEFAULT_MCP_TIMEOUT_MS;
@@ -13054,15 +13099,22 @@ var init_client = __esm({
         return this.reconnectPromise;
       }
       async reconnect() {
-        if (this.reconnectAttempts >= MAX_RECONNECT_ATTEMPTS) {
-          throw new NetworkError(`MCP ${this.name} reconnect exhausted`, { code: "mcp_disconnected" });
+        let lastErr;
+        for (let attempt = 0; attempt < MAX_RECONNECT_ATTEMPTS; attempt += 1) {
+          await reconnectDelay(attempt);
+          this.spawnChild();
+          try {
+            await super.initialize();
+            this.dropped = false;
+            return;
+          } catch (err) {
+            lastErr = err;
+          }
         }
-        await reconnectDelay(this.reconnectAttempts);
-        this.reconnectAttempts += 1;
-        this.spawnChild();
-        await super.initialize();
-        this.dropped = false;
-        this.reconnectAttempts = 0;
+        throw new NetworkError(`MCP ${this.name} reconnect exhausted`, {
+          code: "mcp_disconnected",
+          ...lastErr instanceof Error ? { cause: lastErr } : {}
+        });
       }
       async close() {
         this.rejectAllPending(new NetworkError(`MCP ${this.name} closed`, { code: "mcp_closed" }));
@@ -13193,7 +13245,12 @@ var init_client = __esm({
             code: "mcp_http_error"
           });
         }
-        return await response.json();
+        try {
+          return await response.json();
+        } catch (cause) {
+          if (isAbortLike(cause)) throw mcpTimeoutError(this.name, timeoutMs);
+          throw cause;
+        }
       }
     };
   }
@@ -13433,9 +13490,11 @@ function declarativeSubagentTools(agentOptions, parentTools) {
   return subAgentToolsFromDefinitions(agents2, parentTools);
 }
 function bindParentCredentials(tools, agentOptions) {
+  const parentPlugins = Array.isArray(agentOptions.plugins) ? agentOptions.plugins : void 0;
   const credentials = {
     ...agentOptions.apiKey !== void 0 ? { apiKey: agentOptions.apiKey } : {},
-    ...typeof agentOptions.model === "object" ? { model: agentOptions.model } : {}
+    ...typeof agentOptions.model === "object" ? { model: agentOptions.model } : {},
+    ...parentPlugins !== void 0 ? { plugins: parentPlugins } : {}
   };
   for (const tool of tools) inheritSubAgentCredentials(tool, credentials);
 }
@@ -15969,10 +16028,11 @@ var init_local_agent_memory = __esm({
       }
       buildTelemetryRecallArgs(telemetry) {
         const userId = typeof this.options.memoryContext?.userId === "string" ? this.options.memoryContext.userId : void 0;
+        const tenantId = typeof this.options.memoryContext?.tenantId === "string" ? this.options.memoryContext.tenantId : void 0;
         return {
           ...telemetry !== void 0 ? { telemetry } : {},
           ...userId !== void 0 ? { userId } : {},
-          namespace: "default",
+          namespace: tenantId ?? "default",
           scope: "session"
         };
       }
@@ -22242,8 +22302,10 @@ var JobQueue = class {
     const job = this.jobs.get(id);
     if (!job) return false;
     if (job.status === "pending" || job.status === "running") {
+      const wasRunning = job.status === "running";
       job.status = "cancelled";
       this.controllers.get(id)?.abort();
+      if (wasRunning) this.#release(id);
       return true;
     }
     return false;
@@ -22261,8 +22323,14 @@ var JobQueue = class {
       });
     });
   }
-  /** Release a slot + clean up the controller; start the next waiting job. */
+  /**
+   * Release a slot + clean up the controller; start the next waiting job.
+   * Idempotent — keyed on the controller's presence, so a running job that was
+   * cancelled (released early) does not double-decrement when its `.finally`
+   * eventually fires.
+   */
   #release(id) {
+    if (!this.controllers.has(id)) return;
     this.controllers.delete(id);
     this.running -= 1;
     const next = this.waiting.shift();