stitchkit 0.70.6 → 0.71.0

package/dist/agent-runtime-harness.js

@@ -3,10 +3,10 @@ import {
   composeAgentPrompt,
   createAgentRuntime,
   createAgentRuntimeEventSink
-} from "./index-by57nwhc.js";
+} from "./index-m668wzyc.js";
 import {
   walkContainedFiles
-} from "./index-1z5xxfst.js";
+} from "./index-rqpdar1e.js";
 import {
   AgentModelDescriptorSchema
 } from "./index-tg3m2ec5.js";
@@ -16,8 +16,8 @@ import"./index-3xnq72rz.js";
 import {
   defineRuntimeTool
 } from "./index-wwst0td5.js";
-import"./index-qm87g51s.js";
-import"./index-w9m1wznn.js";
+import"./index-s4c8wy8m.js";
+import"./index-nemjkxjp.js";
 import {
   AgentMessagePartSchema,
   AgentSnapshotSchema

package/dist/agent-runtime-openrouter.d.ts

@@ -1,5 +1,7 @@
 import { type OpenRouterProviderSettings } from '@openrouter/ai-sdk-provider';
+import type { LanguageModelUsage } from 'ai';
 import { type AgentLanguageModelProvider, type AgentModelCatalog } from './agent-runtime/models.js';
+import type { AgentUsage } from './agent-runtime/schemas.js';
 export type { OpenRouterProviderSettings } from '@openrouter/ai-sdk-provider';
 export type OpenRouterCatalogFetch = (input: URL, init?: RequestInit) => Promise<Response>;
 export interface OpenRouterModelCatalogOptions {
@@ -16,4 +18,21 @@ export declare function openRouterModelCatalog(options: OpenRouterModelCatalogOp
 };
 /** Isolated OpenRouter adapter; credentials stay inside the provider instance. */
 export declare function openRouterProvider(settings: OpenRouterProviderSettings): AgentLanguageModelProvider;
+/**
+ * Read OpenRouter's token counts and cost out of one SDK step, with provenance.
+ *
+ * Exported, and that is the point of it existing here at all. The same function
+ * has always run inside `openRouterProvider`, which means it was reachable only
+ * by building the whole agent runtime — durable store, execution protocol and
+ * recovery included. An application that calls `generateText` directly, and only
+ * wants an honest number for its own ledger, could not reach it and derived it
+ * again; two of them did, and more than half of the two files agree line for
+ * line.
+ *
+ * What is easy to get wrong when deriving it again is not the arithmetic but the
+ * provenance: a number the provider reported, a number nobody reported and a
+ * zero are three different facts, and a value invented for a missing field is
+ * the one that reads as true and is not.
+ */
+export declare function normalizeOpenRouterUsage(usage: LanguageModelUsage, providerMetadata: unknown): AgentUsage;
 //# sourceMappingURL=agent-runtime-openrouter.d.ts.map

package/dist/agent-runtime-openrouter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-runtime-openrouter.d.ts","sourceRoot":"","sources":["../src/agent-runtime-openrouter.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EACL,KAAK,0BAA0B,EAE/B,KAAK,iBAAiB,EAGvB,MAAM,wBAAwB,CAAC;AAIhC,YAAY,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAkD9E,MAAM,MAAM,sBAAsB,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAE3F,MAAM,WAAW,6BAA6B;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,sBAAsB,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AAyFD,+FAA+F;AAC/F,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,6BAA6B,GAAG;IAC9E,IAAI,CAAC,KAAK,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACpE,CAyGA;AAED,kFAAkF;AAClF,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,0BAA0B,GACnC,0BAA0B,CAO5B"}
+{"version":3,"file":"agent-runtime-openrouter.d.ts","sourceRoot":"","sources":["../src/agent-runtime-openrouter.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,IAAI,CAAC;AAE7C,OAAO,EACL,KAAK,0BAA0B,EAE/B,KAAK,iBAAiB,EAGvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAG1D,YAAY,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAkD9E,MAAM,MAAM,sBAAsB,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAE3F,MAAM,WAAW,6BAA6B;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,sBAAsB,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AAyFD,+FAA+F;AAC/F,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,6BAA6B,GAAG;IAC9E,IAAI,CAAC,KAAK,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACpE,CAyGA;AAED,kFAAkF;AAClF,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,0BAA0B,GACnC,0BAA0B,CAO5B;AA0BD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,kBAAkB,EACzB,gBAAgB,EAAE,OAAO,GACxB,UAAU,CASZ"}

package/dist/agent-runtime-openrouter.js

@@ -252,5 +252,6 @@ function normalizeOpenRouterUsage(usage, providerMetadata) {
 }
 export {
   openRouterProvider,
-  openRouterModelCatalog
+  openRouterModelCatalog,
+  normalizeOpenRouterUsage
 };

package/dist/agent-runtime.d.ts

@@ -1,4 +1,4 @@
-export { type AgentCompactionContext, type AgentCompactionResult, type StructuredCompactionConfig, structuredCompaction, } from './agent-runtime/compaction.js';
+export { type AgentCompactionContext, type AgentCompactionResult, type CompactableHistory, type SelectCompactableHistoryOptions, type StructuredCompactionConfig, selectCompactableHistory, structuredCompaction, } from './agent-runtime/compaction.js';
 export { AgentContextOverflowError } from './agent-runtime/context-refusal.js';
 export { type AgentConversationMessagePage, AgentConversationMessagePageSchema, type AgentConversationPage, AgentConversationPageSchema, type AgentConversationReader, type AgentConversationSummary, AgentConversationSummarySchema, } from './agent-runtime/conversations.js';
 export { type AgentCoordinatedRun, type AgentInputPolicy, type AgentRunTicket, type AgentSessionCloseOptions, type AgentSessionCloseResult, type AgentSessionCoordinator, type AgentStopReason, createAgentSessionCoordinator, } from './agent-runtime/coordinator.js';
@@ -10,8 +10,9 @@ export { type AgentLanguageModelProvider, type AgentModelCapability, AgentModelC
 export { type AgentObservability, type AgentRunEvent, AgentRunEventSchema, type AgentRunSinkConfig, type AgentRunSinkDrop, type AgentRunSinkError, type AgentRunStartedEvent, AgentRunStartedEventSchema, type AgentRunTerminalEvent, AgentRunTerminalEventSchema, type AgentStepFinishedEvent, AgentStepFinishedEventSchema, createAgentObservability, } from './agent-runtime/observability.js';
 export { type AgentHistoryBudgetDecision, type AgentHistoryBudgetResult, type AgentPromptBudget, type AgentPromptSection, type AgentPromptSectionContext, type AgentTokenCount, AgentTokenCountSchema, type ComposeAgentPromptOptions, type ComposedAgentPrompt, composeAgentPrompt, type SelectAgentHistoryOptions, selectAgentHistory, } from './agent-runtime/prompt.js';
 export { type AgentProtocol, type AgentProtocolConfig, type AgentTerminalAcceptance, type AgentTerminalAcceptanceInput, defineAgentProtocol, hasAgentTerminalOutput, } from './agent-runtime/protocol.js';
+export { type AgentProviderFailure, type AgentProviderFailureReason, classifyProviderFailure, isToolResultFailure, } from './agent-runtime/provider-failure.js';
 export { AgentConversationPurgedError, type AgentConversationPurgeInput, AgentConversationPurgeInputSchema, type AgentConversationPurgeResult, AgentConversationPurgeResultSchema, purgeAgentConversation, } from './agent-runtime/purge.js';
-export { type AgentRuntime, type AgentRuntimeAdmission, type AgentRuntimeConfig, type AgentRuntimeInput, type AgentRuntimeInterruptInput, type AgentRuntimePrepareStep, type AgentRuntimeProtocolInput, type AgentRuntimeRecordIds, type AgentRuntimeRecoverOptions, type AgentRuntimeRecoveryDecision, type AgentRuntimeRecoveryInput, type AgentRuntimeRecoveryOutcome, type AgentRuntimeRunContext, type AgentRuntimeStopPolicy, createAgentRuntime, } from './agent-runtime/runtime.js';
+export { type AgentContextUsage, type AgentRuntime, type AgentRuntimeAdmission, type AgentRuntimeConfig, type AgentRuntimeInput, type AgentRuntimeInterruptInput, type AgentRuntimePrepareStep, type AgentRuntimeProtocolInput, type AgentRuntimeRecordIds, type AgentRuntimeRecoverOptions, type AgentRuntimeRecoveryDecision, type AgentRuntimeRecoveryInput, type AgentRuntimeRecoveryOutcome, type AgentRuntimeRunContext, type AgentRuntimeStopPolicy, createAgentRuntime, } from './agent-runtime/runtime.js';
 export type { AgentRuntimeResult } from './agent-runtime/runtime-result.js';
 export * from './agent-runtime/schemas.js';
 export { type AcceptInputAndAssignRun, AcceptInputAndAssignRunSchema, type AcquireAgentRun, AcquireAgentRunSchema, type AgentRecoverableDescriptor, AgentRecoverableDescriptorSchema, type AgentRecoverablePage, AgentRecoverablePageSchema, type AgentRuntimeStore, type AgentRunView, AgentRunViewSchema, AgentStoreAppliedSchema, AgentStoreConflictSchema, AgentStoreDuplicateSchema, type AgentStoreMutationResult, AgentStoreMutationResultSchema, AgentStoreNotFoundSchema, type CheckpointRunAssistant, CheckpointRunAssistantSchema, type CommitRunTerminal, CommitRunTerminalSchema, type RecoverAgentRun, RecoverAgentRunSchema, type ReplaceCompactedRange, ReplaceCompactedRangeSchema, type RequestRunInterrupt, RequestRunInterruptSchema, } from './agent-runtime/store.js';

package/dist/agent-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-runtime.d.ts","sourceRoot":"","sources":["../src/agent-runtime.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent-runtime.d.ts","sourceRoot":"","sources":["../src/agent-runtime.ts"],"names":[],"mappings":"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"}

package/dist/agent-runtime.js

@@ -27,7 +27,7 @@ import {
   registerDeferredToolRepair,
   repairedSearchCall,
   selectAgentHistory
-} from "./index-by57nwhc.js";
+} from "./index-m668wzyc.js";
 import {
   AgentModelCapabilitySchema,
   AgentModelCatalogEntrySchema,
@@ -86,15 +86,15 @@ import {
 import {
   buildToolManifest,
   mountAgent
-} from "./index-trrf7nch.js";
+} from "./index-ezmn6ac6.js";
 import"./index-3xnq72rz.js";
-import"./index-hxtm2xr2.js";
+import"./index-k2zczx1g.js";
 import {
   defineRuntimeTool
 } from "./index-wwst0td5.js";
-import"./index-ejv31h14.js";
-import"./index-qm87g51s.js";
-import"./index-w9m1wznn.js";
+import"./index-7qy2ex0m.js";
+import"./index-s4c8wy8m.js";
+import"./index-nemjkxjp.js";
 import {
   AgentAssistantPlaceholderSchema,
   AgentControlPartSchema,
@@ -137,7 +137,8 @@ import {
 import"./index-vj3vvpaa.js";
 import"./index-0w9abg87.js";
 import {
-  executableAgentRuntimeTools
+  executableAgentRuntimeTools,
+  isRecord
 } from "./index-qyrqwr4c.js";
 import"./index-6k1937bx.js";
 
@@ -163,13 +164,22 @@ function groupProviderTurns(messages, evidencePolicy) {
   }
   return turns;
 }
-function eligibleForCompaction(messages, keepRecentTurns, evidencePolicy) {
-  const withoutLeadingSummary = messages[0]?.role === "summary" ? messages.slice(1) : messages;
-  const turns = groupProviderTurns(withoutLeadingSummary, evidencePolicy);
+function selectCompactableHistory(options) {
+  if (!Number.isSafeInteger(options.keepRecentTurns) || options.keepRecentTurns < 0) {
+    throw new TypeError("keepRecentTurns must be a non-negative safe integer");
+  }
+  const leadingSummary = options.messages[0]?.role === "summary" ? options.messages[0] : undefined;
+  const rest = leadingSummary ? options.messages.slice(1) : options.messages;
+  const turns = groupProviderTurns(rest, options.evidencePolicy);
   const firstIncomplete = turns.findIndex((turn) => !turn.complete);
   const completeTurns = firstIncomplete === -1 ? turns : turns.slice(0, firstIncomplete);
-  const eligibleCount = Math.max(0, completeTurns.length - keepRecentTurns);
-  return completeTurns.slice(0, eligibleCount).flatMap((turn) => turn.messages);
+  const eligibleCount = Math.max(0, completeTurns.length - options.keepRecentTurns);
+  const compactable = completeTurns.slice(0, eligibleCount).flatMap((turn) => turn.messages);
+  return {
+    ...leadingSummary !== undefined && { leadingSummary },
+    compactable,
+    retained: rest.slice(compactable.length)
+  };
 }
 function mutationSnapshot(result, fallback, attempts) {
   if (result.outcome === "applied" || result.outcome === "duplicate") {
@@ -193,11 +203,14 @@ function structuredCompaction(config) {
       if (!await config.threshold(snapshot)) {
         return { outcome: "not_needed", snapshot, attempts: attempt };
       }
-      const eligibleMessages = eligibleForCompaction(snapshot.messages, config.keepRecentTurns, config.evidencePolicy);
+      const { leadingSummary, compactable: eligibleMessages } = selectCompactableHistory({
+        messages: snapshot.messages,
+        keepRecentTurns: config.keepRecentTurns,
+        ...config.evidencePolicy !== undefined && { evidencePolicy: config.evidencePolicy }
+      });
       if (eligibleMessages.length === 0) {
         return { outcome: "nothing_eligible", snapshot, attempts: attempt };
       }
-      const leadingSummary = snapshot.messages[0]?.role === "summary" ? snapshot.messages[0] : undefined;
       const previousSummary = leadingSummary && config.readPreviousSummary ? config.schema.parse(config.readPreviousSummary(leadingSummary)) : attempt === 1 ? input.previousSummary : undefined;
       const rawSummary = await config.summarize({
         conversationId: input.conversationId,
@@ -698,15 +711,105 @@ function defineAgentProtocol(config) {
     }
   };
 }
+// src/agent-runtime/provider-failure.ts
+var BY_STATUS = {
+  402: "insufficient-credits",
+  404: "model-unavailable",
+  408: "timeout",
+  413: "context-overflow",
+  429: "rate-limited"
+};
+var BY_MESSAGE = [
+  [/insufficient|not enough credit|payment required|quota exceeded/i, "insufficient-credits"],
+  [/rate.?limit|too many requests|slow down/i, "rate-limited"],
+  [
+    /no endpoints found|model not found|unknown model|no allowed providers/i,
+    "model-unavailable"
+  ],
+  [/context length|maximum context|too many tokens|prompt is too long/i, "context-overflow"],
+  [/timed? ?out|deadline exceeded|etimedout/i, "timeout"],
+  [/abort|cancell?ed/i, "cancelled"]
+];
+var RETRYABLE = new Set([
+  "rate-limited",
+  "timeout",
+  "insufficient-credits"
+]);
+function statusOf(value) {
+  if (!isRecord(value))
+    return;
+  for (const key of ["statusCode", "status", "code"]) {
+    const candidate = value[key];
+    if (typeof candidate === "number" && candidate >= 400 && candidate < 600)
+      return candidate;
+  }
+  const nested = value.cause ?? value.response ?? value.error;
+  return nested === value ? undefined : statusOf(nested);
+}
+function messageOf(value) {
+  if (value instanceof Error)
+    return value.message;
+  if (typeof value === "string")
+    return value;
+  if (isRecord(value) && typeof value.message === "string")
+    return value.message;
+  return "";
+}
+function classifyProviderFailure(error) {
+  const status = statusOf(error);
+  const byStatus = status === undefined ? undefined : BY_STATUS[status];
+  if (byStatus) {
+    return {
+      reason: byStatus,
+      status,
+      retryable: RETRYABLE.has(byStatus),
+      evidence: "status"
+    };
+  }
+  const message = messageOf(error);
+  for (const [pattern, reason] of BY_MESSAGE) {
+    if (pattern.test(message)) {
+      return {
+        reason,
+        ...status !== undefined && { status },
+        retryable: RETRYABLE.has(reason),
+        evidence: "message"
+      };
+    }
+  }
+  return {
+    reason: "unknown",
+    ...status !== undefined && { status },
+    retryable: false,
+    evidence: "none"
+  };
+}
+function isToolResultFailure(output) {
+  const parsed = typeof output === "string" ? parseJson(output) : output;
+  if (!isRecord(parsed))
+    return false;
+  if ("error" in parsed)
+    return true;
+  return isRecord(parsed.value) && "error" in parsed.value;
+}
+function parseJson(value) {
+  try {
+    return JSON.parse(value);
+  } catch {
+    return;
+  }
+}
 export {
   validateAgentModelSnapshot,
   structuredCompaction,
+  selectCompactableHistory,
   selectAgentHistory,
   searchAgentModelCatalog,
   runStateForTerminalReason,
   purgeAgentConversation,
   projectAgentHistoryDetailed,
   projectAgentHistory,
+  isToolResultFailure,
   isAssistantHistoryEvidence,
   hasAgentTerminalOutput,
   defineModelRegistry,
@@ -721,6 +824,7 @@ export {
   createAgentRuntime,
   createAgentObservability,
   composeAgentPrompt,
+  classifyProviderFailure,
   agentDurableEventId,
   advanceAgentRuntimeEventCursor,
   RequestRunInterruptSchema,

package/dist/cli.js

@@ -5,12 +5,12 @@ import {
   emitResult,
   parseCliArgs,
   pollUntilDone
-} from "./index-tnazr5tc.js";
-import"./index-hxtm2xr2.js";
+} from "./index-pz7ytdga.js";
+import"./index-k2zczx1g.js";
 import"./index-wwst0td5.js";
-import"./index-ejv31h14.js";
-import"./index-qm87g51s.js";
-import"./index-w9m1wznn.js";
+import"./index-7qy2ex0m.js";
+import"./index-s4c8wy8m.js";
+import"./index-nemjkxjp.js";
 import"./index-sbdmyz75.js";
 import"./index-22by16v6.js";
 import"./index-cby4ar3v.js";

package/dist/{index-cx84zg25.js → index-118v0z41.js}

@@ -18,7 +18,7 @@ import {
   runWithRequestContext,
   setRequestEndpoint,
   setRequestError
-} from "./index-w9m1wznn.js";
+} from "./index-nemjkxjp.js";
 import {
   ShutdownOptionsSchema,
   isStreamCancellation,

package/dist/{index-ejv31h14.js → index-7qy2ex0m.js}

@@ -1,6 +1,6 @@
 import {
   executeToolMethod
-} from "./index-qm87g51s.js";
+} from "./index-s4c8wy8m.js";
 import {
   assertToolExtensionCompatible,
   mergeSchemas,

package/dist/{index-trrf7nch.js → index-ezmn6ac6.js}

@@ -3,15 +3,15 @@ import {
 } from "./index-3xnq72rz.js";
 import {
   collectToolSurface
-} from "./index-hxtm2xr2.js";
+} from "./index-k2zczx1g.js";
 import {
   createToolRunner,
   formatToolError
-} from "./index-ejv31h14.js";
+} from "./index-7qy2ex0m.js";
 import {
   isToolExecutionControlError,
   toolResultFromError
-} from "./index-qm87g51s.js";
+} from "./index-s4c8wy8m.js";
 import {
   isRecord
 } from "./index-qyrqwr4c.js";

package/dist/{index-ekkt4gy9.js → index-jqtsc9mj.js}

@@ -1,10 +1,10 @@
 import {
   collectTools,
   createToolRunner
-} from "./index-ejv31h14.js";
+} from "./index-7qy2ex0m.js";
 import {
   toolErrorFromResult
-} from "./index-qm87g51s.js";
+} from "./index-s4c8wy8m.js";
 import {
   assertUniqueToolName
 } from "./index-22by16v6.js";

package/dist/{index-hxtm2xr2.js → index-k2zczx1g.js}

@@ -3,7 +3,7 @@ import {
 } from "./index-wwst0td5.js";
 import {
   contractToolMountable
-} from "./index-ejv31h14.js";
+} from "./index-7qy2ex0m.js";
 import {
   projectToolSurface
 } from "./index-22by16v6.js";

package/dist/{index-by57nwhc.js → index-m668wzyc.js}

@@ -15,7 +15,7 @@ import {
 import {
   ToolExecutionControlError,
   isToolExecutionControlError
-} from "./index-qm87g51s.js";
+} from "./index-s4c8wy8m.js";
 import {
   AgentAssistantPlaceholderSchema,
   AgentJsonObjectSchema,
@@ -1418,11 +1418,18 @@ function createRunExecutor(dependencies) {
           ...run.fencingToken !== undefined && { fencingToken: run.fencingToken }
         })
       });
+      let lastPromptTokens = { provenance: "unavailable" };
       const runtimeContext = {
         context: input.context,
         run,
         signal: executionSignal,
-        toolFenceLifecycle
+        toolFenceLifecycle,
+        get contextUsage() {
+          const descriptor = selectedModel?.descriptor;
+          if (!descriptor)
+            return;
+          return { usedTokens: lastPromptTokens, contextWindow: descriptor.contextWindow };
+        }
       };
       selectedModel = await config.models.resolve({
         context: input.context,
@@ -1783,6 +1790,7 @@ function createRunExecutor(dependencies) {
             usage: part.usage,
             providerMetadata: part.providerMetadata
           }) ?? normalizeSdkUsage(part.usage);
+          lastPromptTokens = stepUsage.inputTokens;
           modelUsage = addUsage(modelUsage, stepUsage);
           usage = nonModelUsage ? addUsage(nonModelUsage, modelUsage) : modelUsage;
           config.observe?.emit({

package/dist/{index-w9m1wznn.js → index-nemjkxjp.js}

@@ -59,6 +59,123 @@ function parseQueryParams(url) {
   }
   return query;
 }
+var IPV4_RESERVED = [
+  ["0.0.0.0", 8],
+  ["10.0.0.0", 8],
+  ["100.64.0.0", 10],
+  ["127.0.0.0", 8],
+  ["169.254.0.0", 16],
+  ["172.16.0.0", 12],
+  ["192.0.0.0", 24],
+  ["192.0.2.0", 24],
+  ["192.88.99.0", 24],
+  ["192.168.0.0", 16],
+  ["198.18.0.0", 15],
+  ["198.51.100.0", 24],
+  ["203.0.113.0", 24],
+  ["224.0.0.0", 4],
+  ["240.0.0.0", 4]
+];
+function parseIpv4(value) {
+  const parts = value.split(".");
+  if (parts.length !== 4)
+    return;
+  let result = 0;
+  for (const part of parts) {
+    if (!/^(0|[1-9]\d{0,2})$/.test(part))
+      return;
+    const octet = Number(part);
+    if (octet > 255)
+      return;
+    result = result * 256 + octet;
+  }
+  return result;
+}
+function parseIpv6(value) {
+  const address = value.split("%")[0] ?? "";
+  if (!address.includes(":"))
+    return;
+  const halves = address.split("::");
+  if (halves.length > 2)
+    return;
+  const groups = [];
+  const tail = [];
+  const push = (into, text) => {
+    if (text === "")
+      return true;
+    for (const piece of text.split(":")) {
+      if (piece.includes(".")) {
+        const v4 = parseIpv4(piece);
+        if (v4 === undefined)
+          return false;
+        into.push(v4 >>> 16 & 65535, v4 & 65535);
+        continue;
+      }
+      if (!/^[0-9a-fA-F]{1,4}$/.test(piece))
+        return false;
+      into.push(Number.parseInt(piece, 16));
+    }
+    return true;
+  };
+  if (!push(groups, halves[0] ?? ""))
+    return;
+  if (halves.length === 2 && !push(tail, halves[1] ?? ""))
+    return;
+  const missing = 8 - groups.length - tail.length;
+  if (halves.length === 2 ? missing < 0 : missing !== 0)
+    return;
+  const words = [
+    ...groups,
+    ...Array(halves.length === 2 ? missing : 0).fill(0),
+    ...tail
+  ];
+  if (words.length !== 8)
+    return;
+  const bytes = new Uint8Array(16);
+  words.forEach((word, index) => {
+    bytes[index * 2] = word >>> 8 & 255;
+    bytes[index * 2 + 1] = word & 255;
+  });
+  return bytes;
+}
+function hasPrefix(bytes, prefix, bits) {
+  for (let index = 0;index < bits; index += 1) {
+    const byte = bytes[index >> 3] ?? 0;
+    const against = prefix[index >> 3] ?? 0;
+    const mask = 128 >> index % 8;
+    if ((byte & mask) !== (against & mask))
+      return false;
+  }
+  return true;
+}
+function isPublicIp(value) {
+  const address = value.trim();
+  if (!address)
+    return false;
+  const v4 = parseIpv4(address);
+  if (v4 !== undefined) {
+    return !IPV4_RESERVED.some(([network, bits]) => {
+      const base = parseIpv4(network);
+      if (base === undefined)
+        return false;
+      const mask = bits === 0 ? 0 : 4294967295 << 32 - bits >>> 0;
+      return (v4 & mask) >>> 0 === (base & mask) >>> 0;
+    });
+  }
+  const bytes = parseIpv6(address);
+  if (!bytes)
+    return false;
+  if (hasPrefix(bytes, [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 255, 255], 96)) {
+    return isPublicIp(Array.from(bytes.slice(12)).join("."));
+  }
+  if (!hasPrefix(bytes, [32], 3))
+    return false;
+  if (hasPrefix(bytes, [32, 1, 0, 0], 23))
+    return false;
+  if (hasPrefix(bytes, [32, 1, 13, 184], 32))
+    return false;
+  return true;
+}
 
 // src/observability/context.ts
 import { AsyncLocalStorage } from "node:async_hooks";
@@ -114,4 +231,4 @@ function wrapInRequestContext(handler, options = {}) {
   };
 }
 
-export { generateTraceId, resolveTraceId, resolveSocketIp, extractIp, getClientInfo, parseQueryParams, runWithRequestContext, getRequestContext, getTraceId, getUserId, setRequestUser, setRequestEndpoint, setRequestDimensions, setRequestError, wrapInRequestContext };
+export { generateTraceId, resolveTraceId, resolveSocketIp, extractIp, getClientInfo, parseQueryParams, isPublicIp, runWithRequestContext, getRequestContext, getTraceId, getUserId, setRequestUser, setRequestEndpoint, setRequestDimensions, setRequestError, wrapInRequestContext };

package/dist/{index-tnazr5tc.js → index-pz7ytdga.js}

@@ -1,14 +1,14 @@
 import {
   collectToolSurface
-} from "./index-hxtm2xr2.js";
+} from "./index-k2zczx1g.js";
 import {
   createToolRunner,
   formatToolError
-} from "./index-ejv31h14.js";
+} from "./index-7qy2ex0m.js";
 import {
   coerceJsonArgs,
   toolResultFromError
-} from "./index-qm87g51s.js";
+} from "./index-s4c8wy8m.js";
 import {
   isWithinDir
 } from "./index-sbdmyz75.js";