@outfitter/contracts 0.4.2 → 0.5.0

package/dist/actions.d.ts

@@ -1,5 +1,10 @@
-import { ACTION_SURFACES, ActionApiSpec, ActionCliInputContext, ActionCliOption, ActionCliSpec, ActionMcpSpec, ActionRegistry, ActionSpec, ActionSurface, ActionTrpcSpec, AnyActionSpec, DEFAULT_REGISTRY_SURFACES, HttpMethod, createActionRegistry, defineAction } from "./shared/@outfitter/contracts-56pcsavx.js";
-import "./shared/@outfitter/contracts-0akf2sm6.js";
-import "./shared/@outfitter/contracts-3gswmhb1.js";
+import { ACTION_SURFACES, ActionApiSpec, ActionCliInputContext, ActionCliOption, ActionCliSpec, ActionMcpSpec, ActionRegistry, ActionSpec, ActionSurface, ActionTrpcSpec, AnyActionSpec, DEFAULT_REGISTRY_SURFACES, HttpMethod, createActionRegistry, defineAction } from "./shared/@outfitter/contracts-vhajx4gg.js";
+import "./shared/@outfitter/contracts-zma4mscd.js";
+import "./shared/@outfitter/contracts-msxdg52h.js";
+import "./shared/@outfitter/contracts-7a0xmwbg.js";
+import "./shared/@outfitter/contracts-735ecmbq.js";
+import "./shared/@outfitter/contracts-mehpmvwp.js";
+import "./shared/@outfitter/contracts-qpbv29bg.js";
+import "./shared/@outfitter/contracts-njb2art4.js";
 import "./shared/@outfitter/contracts-rwzqy9rn.js";
 export { defineAction, createActionRegistry, HttpMethod, DEFAULT_REGISTRY_SURFACES, AnyActionSpec, ActionTrpcSpec, ActionSurface, ActionSpec, ActionRegistry, ActionMcpSpec, ActionCliSpec, ActionCliOption, ActionCliInputContext, ActionApiSpec, ACTION_SURFACES };

package/dist/assert/index.d.ts

@@ -1,3 +1,7 @@
-import { NonEmptyArray, assertDefined, assertMatches, assertNonEmpty, isNonEmptyArray } from "../shared/@outfitter/contracts-mmg0npfk.js";
-import "../shared/@outfitter/contracts-3gswmhb1.js";
-export { isNonEmptyArray, assertNonEmpty, assertMatches, assertDefined, NonEmptyArray };
+import { NonEmptyArray, assertDefined, assertMatches, assertNonEmpty, expectErr, expectOk, isNonEmptyArray } from "../shared/@outfitter/contracts-3qmyq81n.js";
+import "../shared/@outfitter/contracts-7a0xmwbg.js";
+import "../shared/@outfitter/contracts-735ecmbq.js";
+import "../shared/@outfitter/contracts-mehpmvwp.js";
+import "../shared/@outfitter/contracts-qpbv29bg.js";
+import "../shared/@outfitter/contracts-njb2art4.js";
+export { isNonEmptyArray, expectOk, expectErr, assertNonEmpty, assertMatches, assertDefined, NonEmptyArray };

package/dist/assert/index.js

@@ -1,7 +1,7 @@
 // @bun
 import {
   AssertionError
-} from "../shared/@outfitter/contracts-phjhz5q3.js";
+} from "../shared/@outfitter/contracts-vhr2ep6b.js";
 
 // packages/contracts/src/assert/index.ts
 import { Result } from "better-result";
@@ -28,8 +28,39 @@ function assertMatches(value, predicate, message) {
   }
   return Result.ok(value);
 }
+var formatValue = (value) => {
+  if (value instanceof Error) {
+    return value.message;
+  }
+  if (typeof value === "string") {
+    return value;
+  }
+  try {
+    return JSON.stringify(value);
+  } catch {
+    return String(value);
+  }
+};
+var expectOk = (result, message) => {
+  if (result.isOk()) {
+    return result.value;
+  }
+  const errorDetail = formatValue(result.error);
+  const prefix = message ? `${message}: ` : "";
+  throw new Error(`${prefix}Expected Ok, got Err: ${errorDetail}`);
+};
+var expectErr = (result, message) => {
+  if (result.isErr()) {
+    return result.error;
+  }
+  const valueDetail = formatValue(result.value);
+  const prefix = message ? `${message}: ` : "";
+  throw new Error(`${prefix}Expected Err, got Ok: ${valueDetail}`);
+};
 export {
   isNonEmptyArray,
+  expectOk,
+  expectErr,
   assertNonEmpty,
   assertMatches,
   assertDefined

package/dist/context.d.ts

@@ -1,5 +1,10 @@
-import { CreateContextOptions, createContext, generateRequestId } from "./shared/@outfitter/contracts-1waabxbk.js";
-import "./shared/@outfitter/contracts-0akf2sm6.js";
-import "./shared/@outfitter/contracts-3gswmhb1.js";
+import { CreateContextOptions, createContext, generateRequestId } from "./shared/@outfitter/contracts-drwd9ywk.js";
+import "./shared/@outfitter/contracts-zma4mscd.js";
+import "./shared/@outfitter/contracts-msxdg52h.js";
+import "./shared/@outfitter/contracts-7a0xmwbg.js";
+import "./shared/@outfitter/contracts-735ecmbq.js";
+import "./shared/@outfitter/contracts-mehpmvwp.js";
+import "./shared/@outfitter/contracts-qpbv29bg.js";
+import "./shared/@outfitter/contracts-njb2art4.js";
 import "./shared/@outfitter/contracts-rwzqy9rn.js";
 export { generateRequestId, createContext, CreateContextOptions };

package/dist/context.js

@@ -2,7 +2,7 @@
 import {
   createContext,
   generateRequestId
-} from "./shared/@outfitter/contracts-agmt8915.js";
+} from "./shared/@outfitter/contracts-c3qfce25.js";
 export {
   generateRequestId,
   createContext

package/dist/envelope.d.ts

@@ -1,3 +1,7 @@
-import { Envelope, EnvelopeMeta, ErrorEnvelope, HttpResponse, PaginationMeta, SuccessEnvelope, toEnvelope, toHttpResponse } from "./shared/@outfitter/contracts-e4m948m7.js";
-import "./shared/@outfitter/contracts-3gswmhb1.js";
+import { Envelope, EnvelopeMeta, ErrorEnvelope, HttpResponse, PaginationMeta, SuccessEnvelope, toEnvelope, toHttpResponse } from "./shared/@outfitter/contracts-t4txv24h.js";
+import "./shared/@outfitter/contracts-7a0xmwbg.js";
+import "./shared/@outfitter/contracts-735ecmbq.js";
+import "./shared/@outfitter/contracts-mehpmvwp.js";
+import "./shared/@outfitter/contracts-qpbv29bg.js";
+import "./shared/@outfitter/contracts-njb2art4.js";
 export { toHttpResponse, toEnvelope, SuccessEnvelope, PaginationMeta, HttpResponse, ErrorEnvelope, EnvelopeMeta, Envelope };

package/dist/envelope.js

@@ -1,14 +1,13 @@
 // @bun
-import {
-  serializeError
-} from "./shared/@outfitter/contracts-5k6q4n48.js";
 import {
   generateRequestId
-} from "./shared/@outfitter/contracts-agmt8915.js";
+} from "./shared/@outfitter/contracts-c3qfce25.js";
+import {
+  serializeError
+} from "./shared/@outfitter/contracts-jtt6dnmg.js";
 import {
   statusCodeMap
-} from "./shared/@outfitter/contracts-phjhz5q3.js";
-import"./shared/@outfitter/contracts-s15x2rs4.js";
+} from "./shared/@outfitter/contracts-vhr2ep6b.js";
 
 // packages/contracts/src/envelope.ts
 function buildMeta(overrides) {

package/dist/errors.d.ts

@@ -1,2 +1,6 @@
-import { AlreadyExistsError, AmbiguousError, AnyKitError, AssertionError, AuthError, CancelledError, ConflictError, ERROR_CODES, ErrorCategory, ErrorCode, InternalError, KitErrorProps, NetworkError, NotFoundError, OutfitterError, PermissionError, RateLimitError, SerializedError, TimeoutError, ValidationError, exitCodeMap, getExitCode, getStatusCode, statusCodeMap } from "./shared/@outfitter/contracts-3gswmhb1.js";
-export { statusCodeMap, getStatusCode, getExitCode, exitCodeMap, ValidationError, TimeoutError, SerializedError, RateLimitError, PermissionError, OutfitterError, NotFoundError, NetworkError, KitErrorProps, InternalError, ErrorCode, ErrorCategory, ERROR_CODES, ConflictError, CancelledError, AuthError, AssertionError, AnyKitError, AmbiguousError, AlreadyExistsError };
+import { AnyKitError, OutfitterError } from "./shared/@outfitter/contracts-7a0xmwbg.js";
+import { AuthError, CancelledError, InternalError, NetworkError, PermissionError, RateLimitError, TimeoutError } from "./shared/@outfitter/contracts-735ecmbq.js";
+import { AlreadyExistsError, AmbiguousError, AssertionError, ConflictError, NotFoundError, ValidationError } from "./shared/@outfitter/contracts-mehpmvwp.js";
+import "./shared/@outfitter/contracts-qpbv29bg.js";
+import { ERROR_CODES, ErrorCategory, ErrorCategoryMeta, ErrorCode, KitErrorProps, SerializedError, errorCategoryMeta, exitCodeMap, getExitCode, getStatusCode, jsonRpcCodeMap, retryableMap, statusCodeMap } from "./shared/@outfitter/contracts-njb2art4.js";
+export { statusCodeMap, retryableMap, jsonRpcCodeMap, getStatusCode, getExitCode, exitCodeMap, errorCategoryMeta, ValidationError, TimeoutError, SerializedError, RateLimitError, PermissionError, OutfitterError, NotFoundError, NetworkError, KitErrorProps, InternalError, ErrorCode, ErrorCategoryMeta, ErrorCategory, ERROR_CODES, ConflictError, CancelledError, AuthError, AssertionError, AnyKitError, AmbiguousError, AlreadyExistsError };

package/dist/errors.js

@@ -14,16 +14,22 @@ import {
   RateLimitError,
   TimeoutError,
   ValidationError,
+  errorCategoryMeta,
   exitCodeMap,
   getExitCode,
   getStatusCode,
+  jsonRpcCodeMap,
+  retryableMap,
   statusCodeMap
-} from "./shared/@outfitter/contracts-phjhz5q3.js";
+} from "./shared/@outfitter/contracts-vhr2ep6b.js";
 export {
   statusCodeMap,
+  retryableMap,
+  jsonRpcCodeMap,
   getStatusCode,
   getExitCode,
   exitCodeMap,
+  errorCategoryMeta,
   ValidationError,
   TimeoutError,
   RateLimitError,

package/dist/from-fetch.d.ts

@@ -0,0 +1,7 @@
+import { fromFetch } from "./shared/@outfitter/contracts-3f5k5tg5.js";
+import "./shared/@outfitter/contracts-7a0xmwbg.js";
+import "./shared/@outfitter/contracts-735ecmbq.js";
+import "./shared/@outfitter/contracts-mehpmvwp.js";
+import "./shared/@outfitter/contracts-qpbv29bg.js";
+import "./shared/@outfitter/contracts-njb2art4.js";
+export { fromFetch };

package/dist/from-fetch.js

@@ -0,0 +1,110 @@
+// @bun
+import {
+  AuthError,
+  ConflictError,
+  InternalError,
+  NetworkError,
+  NotFoundError,
+  PermissionError,
+  RateLimitError,
+  TimeoutError,
+  ValidationError,
+  statusCodeMap
+} from "./shared/@outfitter/contracts-vhr2ep6b.js";
+
+// packages/contracts/src/from-fetch.ts
+import { Result } from "better-result";
+var CANONICAL_FETCH_ERROR_CATEGORIES = [
+  "auth",
+  "permission",
+  "not_found",
+  "conflict",
+  "rate_limit",
+  "network",
+  "timeout"
+];
+var HTTP_STATUS_ALIASES = {
+  408: "timeout",
+  503: "network"
+};
+var httpStatusToCategory = {
+  ...Object.fromEntries(CANONICAL_FETCH_ERROR_CATEGORIES.map((category) => [
+    statusCodeMap[category],
+    category
+  ])),
+  ...HTTP_STATUS_ALIASES
+};
+var UNKNOWN_HTTP_TIMEOUT_MS = -1;
+function createErrorForCategory(category, status, statusText, retryAfterSeconds) {
+  const message = `HTTP ${status}${statusText ? `: ${statusText}` : ""}`;
+  switch (category) {
+    case "auth":
+      return AuthError.create(message);
+    case "permission":
+      return PermissionError.create(message);
+    case "not_found":
+      return new NotFoundError({
+        message,
+        resourceType: "resource",
+        resourceId: `HTTP ${status}`,
+        ...statusText ? { context: { statusText } } : {}
+      });
+    case "timeout":
+      return new TimeoutError({
+        message,
+        operation: "HTTP request",
+        timeoutMs: UNKNOWN_HTTP_TIMEOUT_MS
+      });
+    case "rate_limit":
+      return RateLimitError.create(message, retryAfterSeconds);
+    case "network":
+      return NetworkError.create(message);
+    case "conflict":
+      return ConflictError.create(message);
+    case "validation":
+      return ValidationError.fromMessage(message);
+    case "internal":
+      return InternalError.create(message);
+    case "cancelled":
+      return InternalError.create(message);
+  }
+}
+function parseRetryAfterSeconds(retryAfter) {
+  if (retryAfter == null)
+    return;
+  const trimmed = retryAfter.trim();
+  if (!trimmed)
+    return;
+  const delta = Number(trimmed);
+  if (Number.isFinite(delta) && delta >= 0) {
+    return Math.floor(delta);
+  }
+  const dateMs = Date.parse(trimmed);
+  if (Number.isNaN(dateMs)) {
+    return;
+  }
+  const secondsUntilDate = Math.ceil((dateMs - Date.now()) / 1000);
+  return Math.max(0, secondsUntilDate);
+}
+function fromFetch(response) {
+  const { status, statusText } = response;
+  const rateLimitStatus = statusCodeMap.rate_limit;
+  const retryAfterSeconds = status === rateLimitStatus ? parseRetryAfterSeconds(response.headers.get("Retry-After")) : undefined;
+  if (status >= 200 && status < 300) {
+    return Result.ok(response);
+  }
+  const category = httpStatusToCategory[status];
+  if (category != null) {
+    return Result.err(createErrorForCategory(category, status, statusText, retryAfterSeconds));
+  }
+  if (status >= 400 && status < 500) {
+    return Result.err(createErrorForCategory("validation", status, statusText, retryAfterSeconds));
+  }
+  if (status >= 500 && status < 600) {
+    return Result.err(createErrorForCategory("internal", status, statusText, retryAfterSeconds));
+  }
+  return Result.err(createErrorForCategory("internal", status, statusText, retryAfterSeconds));
+}
+export {
+  fromFetch
+};

package/dist/handler.d.ts

@@ -1,4 +1,9 @@
-import { Handler, HandlerContext, ResolvedConfig, SyncHandler } from "./shared/@outfitter/contracts-0akf2sm6.js";
-import "./shared/@outfitter/contracts-3gswmhb1.js";
+import { Handler, HandlerContext, ResolvedConfig, SyncHandler } from "./shared/@outfitter/contracts-zma4mscd.js";
+import "./shared/@outfitter/contracts-msxdg52h.js";
+import "./shared/@outfitter/contracts-7a0xmwbg.js";
+import "./shared/@outfitter/contracts-735ecmbq.js";
+import "./shared/@outfitter/contracts-mehpmvwp.js";
+import "./shared/@outfitter/contracts-qpbv29bg.js";
+import "./shared/@outfitter/contracts-njb2art4.js";
 import { Logger } from "./shared/@outfitter/contracts-rwzqy9rn.js";
 export { SyncHandler, ResolvedConfig, Logger, HandlerContext, Handler };

package/dist/hints.d.ts

@@ -0,0 +1,2 @@
+import { ActionHint, CLIHint, MCPHint } from "./shared/@outfitter/contracts-vbgt9rfn.js";
+export { MCPHint, CLIHint, ActionHint };

package/dist/hints.js

@@ -0,0 +1 @@
+// @bun

package/dist/index.d.ts

@@ -1,20 +1,31 @@
+import { NonEmptyArray, assertDefined, assertMatches, assertNonEmpty, expectErr, expectOk, isNonEmptyArray } from "./shared/@outfitter/contracts-3qmyq81n.js";
 import "./shared/@outfitter/contracts-qaccq0gf.js";
 import { combine2, combine3, expect, orElse, unwrapOrElse } from "./shared/@outfitter/contracts-ar0etwtx.js";
-import { ACTION_SURFACES, ActionApiSpec, ActionCliInputContext, ActionCliOption, ActionCliSpec, ActionMcpSpec, ActionRegistry, ActionSpec, ActionSurface, ActionTrpcSpec, AnyActionSpec, DEFAULT_REGISTRY_SURFACES, HttpMethod, createActionRegistry, defineAction } from "./shared/@outfitter/contracts-56pcsavx.js";
+import { ActionHint, CLIHint, MCPHint } from "./shared/@outfitter/contracts-vbgt9rfn.js";
+import { CreateContextOptions, createContext, generateRequestId } from "./shared/@outfitter/contracts-drwd9ywk.js";
+import { ErrorMapper, composeMappers, extractMessage, isOutfitterError, wrapError } from "./shared/@outfitter/contracts-zsgxsa91.js";
+import { DEFAULT_PATTERNS, DEFAULT_SENSITIVE_KEYS, RedactionCallback, RedactionEvent, Redactor, RedactorConfig, createRedactor } from "./shared/@outfitter/contracts-9yd4vrjg.js";
+import { ACTION_SURFACES, ActionApiSpec, ActionCliInputContext, ActionCliOption, ActionCliSpec, ActionMcpSpec, ActionRegistry, ActionSpec, ActionSurface, ActionTrpcSpec, AnyActionSpec, DEFAULT_REGISTRY_SURFACES, HttpMethod, createActionRegistry, defineAction } from "./shared/@outfitter/contracts-vhajx4gg.js";
+import { Handler, HandlerContext, ResolvedConfig, SyncHandler } from "./shared/@outfitter/contracts-zma4mscd.js";
 import { ACTION_CAPABILITIES, ActionCapability, CAPABILITY_SURFACES, CapabilitySurface, DEFAULT_ACTION_SURFACES, capability, capabilityAll, getActionsForSurface } from "./shared/@outfitter/contracts-y8f0m1ze.js";
-import { SerializeErrorOptions, deserializeError, safeParse, safeStringify, serializeError } from "./shared/@outfitter/contracts-31penhwa.js";
-import { JsonSchema, zodToJsonSchema } from "./shared/@outfitter/contracts-t79engf9.js";
-import { CreateContextOptions, createContext, generateRequestId } from "./shared/@outfitter/contracts-1waabxbk.js";
-import { NonEmptyArray, assertDefined, assertMatches, assertNonEmpty, isNonEmptyArray } from "./shared/@outfitter/contracts-mmg0npfk.js";
-import { Envelope, EnvelopeMeta, ErrorEnvelope, HttpResponse, PaginationMeta, SuccessEnvelope, toEnvelope, toHttpResponse } from "./shared/@outfitter/contracts-e4m948m7.js";
+import "./shared/@outfitter/contracts-f6fnz6h9.js";
+import { SerializeErrorOptions, deserializeError, serializeError } from "./shared/@outfitter/contracts-p77yjs4g.js";
+import { safeParse, safeStringify } from "./shared/@outfitter/contracts-1zzcpfyg.js";
+import { zodToJsonSchema } from "./shared/@outfitter/contracts-8cmkh2db.js";
+import { JsonSchema } from "./shared/@outfitter/contracts-w7nvcwrp.js";
+import { Envelope, EnvelopeMeta, ErrorEnvelope, HttpResponse, PaginationMeta, SuccessEnvelope, toEnvelope, toHttpResponse } from "./shared/@outfitter/contracts-t4txv24h.js";
 import { AdapterAuthError, AuthAdapter, CacheAdapter, CacheError, IndexAdapter, IndexError, IndexStats, SearchOptions, SearchResult, StorageAdapter, StorageError } from "./shared/@outfitter/contracts-c2cfj172.js";
-import { BackoffOptions, getBackoffDelay, isRecoverable, isRetryable, shouldRetry } from "./shared/@outfitter/contracts-k71jqd1m.js";
-import { RetryOptions, TimeoutOptions, retry, withTimeout } from "./shared/@outfitter/contracts-95cc3y06.js";
-import { createValidator, validateInput } from "./shared/@outfitter/contracts-9wtm5nsw.js";
-import { Handler, HandlerContext, ResolvedConfig, SyncHandler } from "./shared/@outfitter/contracts-0akf2sm6.js";
-import { AlreadyExistsError, AmbiguousError, AnyKitError, AssertionError, AuthError, CancelledError, ConflictError, ERROR_CODES, ErrorCategory, ErrorCode, InternalError, KitErrorProps, NetworkError, NotFoundError, OutfitterError, PermissionError, RateLimitError, SerializedError, TimeoutError, ValidationError, exitCodeMap, getExitCode, getStatusCode, statusCodeMap } from "./shared/@outfitter/contracts-3gswmhb1.js";
+import { ProgressCallback, StreamEvent, StreamProgressEvent, StreamStartEvent, StreamStepEvent } from "./shared/@outfitter/contracts-msxdg52h.js";
+import { BackoffOptions, getBackoffDelay, isRecoverable, isRetryable, shouldRetry } from "./shared/@outfitter/contracts-10p5q75w.js";
+import { fromFetch } from "./shared/@outfitter/contracts-3f5k5tg5.js";
+import { RetryOptions, TimeoutOptions, retry, withTimeout } from "./shared/@outfitter/contracts-mt027fqj.js";
+import { createValidator, formatZodIssues, parseInput, validateInput } from "./shared/@outfitter/contracts-x0ppyt7e.js";
+import { AnyKitError, OutfitterError } from "./shared/@outfitter/contracts-7a0xmwbg.js";
+import { AuthError, CancelledError, InternalError, NetworkError, PermissionError, RateLimitError, TimeoutError } from "./shared/@outfitter/contracts-735ecmbq.js";
+import { AlreadyExistsError, AmbiguousError, AssertionError, ConflictError, NotFoundError, ValidationError } from "./shared/@outfitter/contracts-mehpmvwp.js";
+import "./shared/@outfitter/contracts-qpbv29bg.js";
+import { ERROR_CODES, ErrorCategory, ErrorCategoryMeta, ErrorCode, KitErrorProps, SerializedError, errorCategoryMeta, exitCodeMap, getExitCode, getStatusCode, jsonRpcCodeMap, retryableMap, statusCodeMap } from "./shared/@outfitter/contracts-njb2art4.js";
 import { LogLevel, LogMetadata, LogMethod, Logger, LoggerAdapter, LoggerFactory, LoggerFactoryConfig, createLoggerFactory } from "./shared/@outfitter/contracts-rwzqy9rn.js";
-import { DEFAULT_PATTERNS, DEFAULT_SENSITIVE_KEYS, RedactionCallback, RedactionEvent, Redactor, RedactorConfig, createRedactor } from "./shared/@outfitter/contracts-9yd4vrjg.js";
 import { TaggedErrorClass } from "better-result";
 import { Result, TaggedError } from "better-result";
-export { zodToJsonSchema, withTimeout, validateInput, unwrapOrElse, toHttpResponse, toEnvelope, statusCodeMap, shouldRetry, serializeError, safeStringify, safeParse, retry, orElse, isRetryable, isRecoverable, isNonEmptyArray, getStatusCode, getExitCode, getBackoffDelay, getActionsForSurface, generateRequestId, expect, exitCodeMap, deserializeError, defineAction, createValidator, createRedactor, createLoggerFactory, createContext, createActionRegistry, combine3, combine2, capabilityAll, capability, assertNonEmpty, assertMatches, assertDefined, ValidationError, TimeoutOptions, TimeoutError, TaggedErrorClass, TaggedError, SyncHandler, SuccessEnvelope, StorageError, StorageAdapter, SerializedError, SerializeErrorOptions, SearchResult, SearchOptions, RetryOptions, Result, ResolvedConfig, RedactorConfig, Redactor, RedactionEvent, RedactionCallback, RateLimitError, PermissionError, PaginationMeta, OutfitterError, NotFoundError, NonEmptyArray, NetworkError, LoggerFactoryConfig, LoggerFactory, LoggerAdapter, Logger, LogMethod, LogMetadata, LogLevel, KitErrorProps, JsonSchema, InternalError, IndexStats, IndexError, IndexAdapter, HttpResponse, HttpMethod, HandlerContext, Handler, ErrorEnvelope, ErrorCode, ErrorCategory, EnvelopeMeta, Envelope, ERROR_CODES, DEFAULT_SENSITIVE_KEYS, DEFAULT_REGISTRY_SURFACES, DEFAULT_PATTERNS, DEFAULT_ACTION_SURFACES, CreateContextOptions, ConflictError, CapabilitySurface, CancelledError, CacheError, CacheAdapter, CAPABILITY_SURFACES, BackoffOptions, AuthError, AuthAdapter, AssertionError, AnyKitError, AnyActionSpec, AmbiguousError, AlreadyExistsError, AdapterAuthError, ActionTrpcSpec, ActionSurface, ActionSpec, ActionRegistry, ActionMcpSpec, ActionCliSpec, ActionCliOption, ActionCliInputContext, ActionCapability, ActionApiSpec, ACTION_SURFACES, ACTION_CAPABILITIES };
+export { zodToJsonSchema, wrapError, withTimeout, validateInput, unwrapOrElse, toHttpResponse, toEnvelope, statusCodeMap, shouldRetry, serializeError, safeStringify, safeParse, retryableMap, retry, parseInput, orElse, jsonRpcCodeMap, isRetryable, isRecoverable, isOutfitterError, isNonEmptyArray, getStatusCode, getExitCode, getBackoffDelay, getActionsForSurface, generateRequestId, fromFetch, formatZodIssues, extractMessage, expectOk, expectErr, expect, exitCodeMap, errorCategoryMeta, deserializeError, defineAction, createValidator, createRedactor, createLoggerFactory, createContext, createActionRegistry, composeMappers, combine3, combine2, capabilityAll, capability, assertNonEmpty, assertMatches, assertDefined, ValidationError, TimeoutOptions, TimeoutError, TaggedErrorClass, TaggedError, SyncHandler, SuccessEnvelope, StreamStepEvent, StreamStartEvent, StreamProgressEvent, StreamEvent, StorageError, StorageAdapter, SerializedError, SerializeErrorOptions, SearchResult, SearchOptions, RetryOptions, Result, ResolvedConfig, RedactorConfig, Redactor, RedactionEvent, RedactionCallback, RateLimitError, ProgressCallback, PermissionError, PaginationMeta, OutfitterError, NotFoundError, NonEmptyArray, NetworkError, MCPHint, LoggerFactoryConfig, LoggerFactory, LoggerAdapter, Logger, LogMethod, LogMetadata, LogLevel, KitErrorProps, JsonSchema, InternalError, IndexStats, IndexError, IndexAdapter, HttpResponse, HttpMethod, HandlerContext, Handler, ErrorMapper, ErrorEnvelope, ErrorCode, ErrorCategoryMeta, ErrorCategory, EnvelopeMeta, Envelope, ERROR_CODES, DEFAULT_SENSITIVE_KEYS, DEFAULT_REGISTRY_SURFACES, DEFAULT_PATTERNS, DEFAULT_ACTION_SURFACES, CreateContextOptions, ConflictError, CapabilitySurface, CancelledError, CacheError, CacheAdapter, CLIHint, CAPABILITY_SURFACES, BackoffOptions, AuthError, AuthAdapter, AssertionError, AnyKitError, AnyActionSpec, AmbiguousError, AlreadyExistsError, AdapterAuthError, ActionTrpcSpec, ActionSurface, ActionSpec, ActionRegistry, ActionMcpSpec, ActionHint, ActionCliSpec, ActionCliOption, ActionCliInputContext, ActionCapability, ActionApiSpec, ACTION_SURFACES, ACTION_CAPABILITIES };

package/dist/index.js

@@ -1,10 +1,11 @@
 export { Result, TaggedError } from "better-result";
 export { ACTION_SURFACES, createActionRegistry, DEFAULT_REGISTRY_SURFACES, defineAction } from "./actions.js";
-export { assertDefined, assertMatches, assertNonEmpty, isNonEmptyArray } from "./assert/index.js";
+export { assertDefined, assertMatches, assertNonEmpty, expectErr, expectOk, isNonEmptyArray } from "./assert/index.js";
 export { ACTION_CAPABILITIES, CAPABILITY_SURFACES, capability, capabilityAll, DEFAULT_ACTION_SURFACES, getActionsForSurface } from "./capabilities.js";
 export { createContext, generateRequestId } from "./context.js";
 export { toEnvelope, toHttpResponse } from "./envelope.js";
-export { AlreadyExistsError, AmbiguousError, AssertionError, AuthError, CancelledError, ConflictError, ERROR_CODES, exitCodeMap, getExitCode, getStatusCode, InternalError, NetworkError, NotFoundError, PermissionError, RateLimitError, statusCodeMap, TimeoutError, ValidationError } from "./errors.js";
+export { fromFetch } from "./from-fetch.js";
+export { AlreadyExistsError, AmbiguousError, AssertionError, AuthError, CancelledError, ConflictError, ERROR_CODES, errorCategoryMeta, exitCodeMap, getExitCode, getStatusCode, InternalError, jsonRpcCodeMap, NetworkError, NotFoundError, PermissionError, RateLimitError, retryableMap, statusCodeMap, TimeoutError, ValidationError } from "./errors.js";
 export { createLoggerFactory } from "./logging.js";
 export { getBackoffDelay, isRecoverable, isRetryable, shouldRetry } from "./recovery.js";
 export { createRedactor, DEFAULT_PATTERNS, DEFAULT_SENSITIVE_KEYS } from "./redactor.js";
@@ -12,4 +13,5 @@ export { retry, withTimeout } from "./resilience.js";
 export { combine2, combine3, expect, orElse, unwrapOrElse } from "./result/index.js";
 export { zodToJsonSchema } from "./schema.js";
 export { deserializeError, safeParse, safeStringify, serializeError } from "./serialization.js";
-export { createValidator, validateInput } from "./validation.js";
+export { createValidator, formatZodIssues, parseInput, validateInput } from "./validation.js";
+export { composeMappers, extractMessage, isOutfitterError, wrapError } from "./wrap-error.js";

package/dist/internal/error-base.d.ts

@@ -0,0 +1,2 @@
+import { AlreadyExistsErrorBase, AmbiguousErrorBase, AssertionErrorBase, AuthErrorBase, CancelledErrorBase, ConflictErrorBase, InternalErrorBase, NetworkErrorBase, NotFoundErrorBase, PermissionErrorBase, RateLimitErrorBase, TimeoutErrorBase, ValidationErrorBase } from "../shared/@outfitter/contracts-qpbv29bg.js";
+export { ValidationErrorBase, TimeoutErrorBase, RateLimitErrorBase, PermissionErrorBase, NotFoundErrorBase, NetworkErrorBase, InternalErrorBase, ConflictErrorBase, CancelledErrorBase, AuthErrorBase, AssertionErrorBase, AmbiguousErrorBase, AlreadyExistsErrorBase };

package/dist/internal/error-base.js

@@ -0,0 +1,31 @@
+// @bun
+import {
+  AlreadyExistsErrorBase,
+  AmbiguousErrorBase,
+  AssertionErrorBase,
+  AuthErrorBase,
+  CancelledErrorBase,
+  ConflictErrorBase,
+  InternalErrorBase,
+  NetworkErrorBase,
+  NotFoundErrorBase,
+  PermissionErrorBase,
+  RateLimitErrorBase,
+  TimeoutErrorBase,
+  ValidationErrorBase
+} from "../shared/@outfitter/contracts-jtn6b927.js";
+export {
+  ValidationErrorBase,
+  TimeoutErrorBase,
+  RateLimitErrorBase,
+  PermissionErrorBase,
+  NotFoundErrorBase,
+  NetworkErrorBase,
+  InternalErrorBase,
+  ConflictErrorBase,
+  CancelledErrorBase,
+  AuthErrorBase,
+  AssertionErrorBase,
+  AmbiguousErrorBase,
+  AlreadyExistsErrorBase
+};

package/dist/internal/error-operational.d.ts

@@ -0,0 +1,3 @@
+import { AuthError, CancelledError, InternalError, NetworkError, PermissionError, RateLimitError, TimeoutError } from "../shared/@outfitter/contracts-735ecmbq.js";
+import "../shared/@outfitter/contracts-qpbv29bg.js";
+export { TimeoutError, RateLimitError, PermissionError, NetworkError, InternalError, CancelledError, AuthError };

package/dist/internal/error-operational.js

@@ -0,0 +1,125 @@
+// @bun
+import {
+  AuthErrorBase,
+  CancelledErrorBase,
+  InternalErrorBase,
+  NetworkErrorBase,
+  PermissionErrorBase,
+  RateLimitErrorBase,
+  TimeoutErrorBase
+} from "../shared/@outfitter/contracts-jtn6b927.js";
+import {
+  getExitCode,
+  getStatusCode
+} from "../shared/@outfitter/contracts-sawwfgb5.js";
+
+// packages/contracts/src/internal/error-operational.ts
+class PermissionError extends PermissionErrorBase {
+  category = "permission";
+  static create(message, context) {
+    return new PermissionError({
+      message,
+      ...context != null && { context }
+    });
+  }
+  exitCode() {
+    return getExitCode(this.category);
+  }
+  statusCode() {
+    return getStatusCode(this.category);
+  }
+}
+
+class TimeoutError extends TimeoutErrorBase {
+  category = "timeout";
+  static create(operation, timeoutMs) {
+    return new TimeoutError({
+      message: `${operation} timed out after ${timeoutMs}ms`,
+      operation,
+      timeoutMs
+    });
+  }
+  exitCode() {
+    return getExitCode(this.category);
+  }
+  statusCode() {
+    return getStatusCode(this.category);
+  }
+}
+
+class RateLimitError extends RateLimitErrorBase {
+  category = "rate_limit";
+  static create(message, retryAfterSeconds) {
+    return new RateLimitError({
+      message,
+      ...retryAfterSeconds != null && { retryAfterSeconds }
+    });
+  }
+  exitCode() {
+    return getExitCode(this.category);
+  }
+  statusCode() {
+    return getStatusCode(this.category);
+  }
+}
+
+class NetworkError extends NetworkErrorBase {
+  category = "network";
+  static create(message, context) {
+    return new NetworkError({ message, ...context != null && { context } });
+  }
+  exitCode() {
+    return getExitCode(this.category);
+  }
+  statusCode() {
+    return getStatusCode(this.category);
+  }
+}
+
+class InternalError extends InternalErrorBase {
+  category = "internal";
+  static create(message, context) {
+    return new InternalError({ message, ...context != null && { context } });
+  }
+  exitCode() {
+    return getExitCode(this.category);
+  }
+  statusCode() {
+    return getStatusCode(this.category);
+  }
+}
+
+class AuthError extends AuthErrorBase {
+  category = "auth";
+  static create(message, reason) {
+    return new AuthError({ message, ...reason != null && { reason } });
+  }
+  exitCode() {
+    return getExitCode(this.category);
+  }
+  statusCode() {
+    return getStatusCode(this.category);
+  }
+}
+
+class CancelledError extends CancelledErrorBase {
+  category = "cancelled";
+  static create(message) {
+    return new CancelledError({ message });
+  }
+  exitCode() {
+    return getExitCode(this.category);
+  }
+  statusCode() {
+    return getStatusCode(this.category);
+  }
+}
+export {
+  TimeoutError,
+  RateLimitError,
+  PermissionError,
+  NetworkError,
+  InternalError,
+  CancelledError,
+  AuthError
+};

package/dist/internal/error-serialization.d.ts

@@ -0,0 +1,7 @@
+import { SerializeErrorOptions, deserializeError, serializeError } from "../shared/@outfitter/contracts-p77yjs4g.js";
+import "../shared/@outfitter/contracts-7a0xmwbg.js";
+import "../shared/@outfitter/contracts-735ecmbq.js";
+import "../shared/@outfitter/contracts-mehpmvwp.js";
+import "../shared/@outfitter/contracts-qpbv29bg.js";
+import "../shared/@outfitter/contracts-njb2art4.js";
+export { serializeError, deserializeError, SerializeErrorOptions };