@outfitter/contracts 0.1.0 → 0.2.0

package/dist/actions.d.ts

@@ -1,4 +1,4 @@
-import { ACTION_SURFACES, ActionApiSpec, ActionCliInputContext, ActionCliOption, ActionCliSpec, ActionMcpSpec, ActionRegistry, ActionSpec, ActionSurface, ActionTrpcSpec, AnyActionSpec, DEFAULT_REGISTRY_SURFACES, HttpMethod, createActionRegistry, defineAction } from "./shared/@outfitter/contracts-vtrf6rbx";
-import "./shared/@outfitter/contracts-yp3derbe";
-import "./shared/@outfitter/contracts-ev4a68sg";
+import { ACTION_SURFACES, ActionApiSpec, ActionCliInputContext, ActionCliOption, ActionCliSpec, ActionMcpSpec, ActionRegistry, ActionSpec, ActionSurface, ActionTrpcSpec, AnyActionSpec, DEFAULT_REGISTRY_SURFACES, HttpMethod, createActionRegistry, defineAction } from "./shared/@outfitter/contracts-zyanj0gf";
+import "./shared/@outfitter/contracts-amd2ykn8";
+import "./shared/@outfitter/contracts-5hr9pdcq";
 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,3 @@
-import { NonEmptyArray, assertDefined, assertMatches, assertNonEmpty, isNonEmptyArray } from "../shared/@outfitter/contracts-t3j7fba3";
-import "../shared/@outfitter/contracts-ev4a68sg";
+import { NonEmptyArray, assertDefined, assertMatches, assertNonEmpty, isNonEmptyArray } from "../shared/@outfitter/contracts-jbhbyhtt";
+import "../shared/@outfitter/contracts-5hr9pdcq";
 export { isNonEmptyArray, assertNonEmpty, assertMatches, assertDefined, NonEmptyArray };

package/dist/assert/index.js

@@ -4,8 +4,8 @@ import {
   assertMatches,
   assertNonEmpty,
   isNonEmptyArray
-} from "../shared/@outfitter/contracts-d1thk8cv.js";
-import"../shared/@outfitter/contracts-jhsgc85s.js";
+} from "../shared/@outfitter/contracts-2f3khqcc.js";
+import"../shared/@outfitter/contracts-0cj49e1a.js";
 export {
   isNonEmptyArray,
   assertNonEmpty,

package/dist/context.d.ts

@@ -1,4 +1,4 @@
-import { CreateContextOptions, createContext, generateRequestId } from "./shared/@outfitter/contracts-wwkk3j4m";
-import "./shared/@outfitter/contracts-yp3derbe";
-import "./shared/@outfitter/contracts-ev4a68sg";
+import { CreateContextOptions, createContext, generateRequestId } from "./shared/@outfitter/contracts-t68dwjbk";
+import "./shared/@outfitter/contracts-amd2ykn8";
+import "./shared/@outfitter/contracts-5hr9pdcq";
 export { generateRequestId, createContext, CreateContextOptions };

package/dist/context.js

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

package/dist/envelope.d.ts

@@ -1,3 +1,3 @@
-import { Envelope, EnvelopeMeta, ErrorEnvelope, HttpResponse, PaginationMeta, SuccessEnvelope, toEnvelope, toHttpResponse } from "./shared/@outfitter/contracts-q9tjk2zp";
-import "./shared/@outfitter/contracts-ev4a68sg";
+import { Envelope, EnvelopeMeta, ErrorEnvelope, HttpResponse, PaginationMeta, SuccessEnvelope, toEnvelope, toHttpResponse } from "./shared/@outfitter/contracts-k0rhaye3";
+import "./shared/@outfitter/contracts-5hr9pdcq";
 export { toHttpResponse, toEnvelope, SuccessEnvelope, PaginationMeta, HttpResponse, ErrorEnvelope, EnvelopeMeta, Envelope };

package/dist/envelope.js

@@ -2,11 +2,11 @@
 import {
   toEnvelope,
   toHttpResponse
-} from "./shared/@outfitter/contracts-chnm7kvm.js";
-import"./shared/@outfitter/contracts-dbpj0b4k.js";
+} from "./shared/@outfitter/contracts-rtsa2s0f.js";
+import"./shared/@outfitter/contracts-agvdgx9j.js";
 import"./shared/@outfitter/contracts-s15x2rs4.js";
-import"./shared/@outfitter/contracts-y8qg2nvz.js";
-import"./shared/@outfitter/contracts-jhsgc85s.js";
+import"./shared/@outfitter/contracts-agmt8915.js";
+import"./shared/@outfitter/contracts-0cj49e1a.js";
 export {
   toHttpResponse,
   toEnvelope

package/dist/errors.d.ts

@@ -1,2 +1,2 @@
-import { 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-ev4a68sg";
-export { statusCodeMap, getStatusCode, getExitCode, exitCodeMap, ValidationError, TimeoutError, SerializedError, RateLimitError, PermissionError, OutfitterError, NotFoundError, NetworkError, KitErrorProps, InternalError, ErrorCode, ErrorCategory, ERROR_CODES, ConflictError, CancelledError, AuthError, AssertionError, AnyKitError };
+import { 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-5hr9pdcq";
+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 };

package/dist/errors.js

@@ -1,5 +1,6 @@
 // @bun
 import {
+  AmbiguousError,
   AssertionError,
   AuthError,
   CancelledError,
@@ -16,7 +17,7 @@ import {
   getExitCode,
   getStatusCode,
   statusCodeMap
-} from "./shared/@outfitter/contracts-jhsgc85s.js";
+} from "./shared/@outfitter/contracts-0cj49e1a.js";
 export {
   statusCodeMap,
   getStatusCode,
@@ -33,5 +34,6 @@ export {
   ConflictError,
   CancelledError,
   AuthError,
-  AssertionError
+  AssertionError,
+  AmbiguousError
 };

package/dist/handler.d.ts

@@ -1,3 +1,3 @@
-import { Handler, HandlerContext, Logger, ResolvedConfig, SyncHandler } from "./shared/@outfitter/contracts-yp3derbe";
-import "./shared/@outfitter/contracts-ev4a68sg";
+import { Handler, HandlerContext, Logger, ResolvedConfig, SyncHandler } from "./shared/@outfitter/contracts-amd2ykn8";
+import "./shared/@outfitter/contracts-5hr9pdcq";
 export { SyncHandler, ResolvedConfig, Logger, HandlerContext, Handler };

package/dist/index.d.ts

@@ -1,18 +1,18 @@
 import { ACTION_CAPABILITIES, ActionCapability, CAPABILITY_SURFACES, CapabilitySurface, DEFAULT_ACTION_SURFACES, capability, capabilityAll, getActionsForSurface } from "./shared/@outfitter/contracts-bb4hjt8g";
 import { DEFAULT_PATTERNS, DEFAULT_SENSITIVE_KEYS, RedactionCallback, RedactionEvent, Redactor, RedactorConfig, createRedactor } from "./shared/@outfitter/contracts-e70qdasg";
-import { BackoffOptions, getBackoffDelay, isRecoverable, isRetryable, shouldRetry } from "./shared/@outfitter/contracts-47aemgd3";
-import { ACTION_SURFACES, ActionApiSpec, ActionCliInputContext, ActionCliOption, ActionCliSpec, ActionMcpSpec, ActionRegistry, ActionSpec, ActionSurface, ActionTrpcSpec, AnyActionSpec, DEFAULT_REGISTRY_SURFACES, HttpMethod, createActionRegistry, defineAction } from "./shared/@outfitter/contracts-vtrf6rbx";
-import { RetryOptions, TimeoutOptions, retry, withTimeout } from "./shared/@outfitter/contracts-37891j7e";
+import { BackoffOptions, getBackoffDelay, isRecoverable, isRetryable, shouldRetry } from "./shared/@outfitter/contracts-md2mvvyt";
+import { ACTION_SURFACES, ActionApiSpec, ActionCliInputContext, ActionCliOption, ActionCliSpec, ActionMcpSpec, ActionRegistry, ActionSpec, ActionSurface, ActionTrpcSpec, AnyActionSpec, DEFAULT_REGISTRY_SURFACES, HttpMethod, createActionRegistry, defineAction } from "./shared/@outfitter/contracts-zyanj0gf";
+import { RetryOptions, TimeoutOptions, retry, withTimeout } from "./shared/@outfitter/contracts-r64j5rsm";
 import "./shared/@outfitter/contracts-qaccq0gf";
-import { combine2, combine3, orElse, unwrapOrElse } from "./shared/@outfitter/contracts-109drsem";
-import { NonEmptyArray, assertDefined, assertMatches, assertNonEmpty, isNonEmptyArray } from "./shared/@outfitter/contracts-t3j7fba3";
+import { combine2, combine3, expect, orElse, unwrapOrElse } from "./shared/@outfitter/contracts-ar0etwtx";
+import { NonEmptyArray, assertDefined, assertMatches, assertNonEmpty, isNonEmptyArray } from "./shared/@outfitter/contracts-jbhbyhtt";
 import { AdapterAuthError, AuthAdapter, CacheAdapter, CacheError, IndexAdapter, IndexError, IndexStats, SearchOptions, SearchResult, StorageAdapter, StorageError } from "./shared/@outfitter/contracts-93dx53mt";
-import { Envelope, EnvelopeMeta, ErrorEnvelope, HttpResponse, PaginationMeta, SuccessEnvelope, toEnvelope, toHttpResponse } from "./shared/@outfitter/contracts-q9tjk2zp";
-import { SerializeErrorOptions, deserializeError, safeParse, safeStringify, serializeError } from "./shared/@outfitter/contracts-0taqjz0a";
-import { CreateContextOptions, createContext, generateRequestId } from "./shared/@outfitter/contracts-wwkk3j4m";
-import { Handler, HandlerContext, Logger, ResolvedConfig, SyncHandler } from "./shared/@outfitter/contracts-yp3derbe";
-import { createValidator, validateInput } from "./shared/@outfitter/contracts-g82822x1";
-import { 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-ev4a68sg";
+import { Envelope, EnvelopeMeta, ErrorEnvelope, HttpResponse, PaginationMeta, SuccessEnvelope, toEnvelope, toHttpResponse } from "./shared/@outfitter/contracts-k0rhaye3";
+import { SerializeErrorOptions, deserializeError, safeParse, safeStringify, serializeError } from "./shared/@outfitter/contracts-6atxbfag";
+import { CreateContextOptions, createContext, generateRequestId } from "./shared/@outfitter/contracts-t68dwjbk";
+import { Handler, HandlerContext, Logger, ResolvedConfig, SyncHandler } from "./shared/@outfitter/contracts-amd2ykn8";
+import { createValidator, validateInput } from "./shared/@outfitter/contracts-n9hb6hqt";
+import { 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-5hr9pdcq";
 import { TaggedErrorClass } from "better-result";
 import { Result, TaggedError } from "better-result";
-export { withTimeout, validateInput, unwrapOrElse, toHttpResponse, toEnvelope, statusCodeMap, shouldRetry, serializeError, safeStringify, safeParse, retry, orElse, isRetryable, isRecoverable, isNonEmptyArray, getStatusCode, getExitCode, getBackoffDelay, getActionsForSurface, generateRequestId, exitCodeMap, deserializeError, defineAction, createValidator, createRedactor, 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, Logger, KitErrorProps, 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, AdapterAuthError, ActionTrpcSpec, ActionSurface, ActionSpec, ActionRegistry, ActionMcpSpec, ActionCliSpec, ActionCliOption, ActionCliInputContext, ActionCapability, ActionApiSpec, ACTION_SURFACES, ACTION_CAPABILITIES };
+export { 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, 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, Logger, KitErrorProps, 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, AdapterAuthError, ActionTrpcSpec, ActionSurface, ActionSpec, ActionRegistry, ActionMcpSpec, ActionCliSpec, ActionCliOption, ActionCliInputContext, ActionCapability, ActionApiSpec, ACTION_SURFACES, ACTION_CAPABILITIES };

package/dist/index.js

@@ -22,30 +22,31 @@ import {
 import {
   retry,
   withTimeout
-} from "./shared/@outfitter/contracts-aq745b7n.js";
+} from "./shared/@outfitter/contracts-pdk7s4t8.js";
 import"./shared/@outfitter/contracts-37gpc56f.js";
 import {
   combine2,
   combine3,
+  expect,
   orElse,
   unwrapOrElse
-} from "./shared/@outfitter/contracts-r06bafs8.js";
+} from "./shared/@outfitter/contracts-zx72gyh1.js";
 import {
   assertDefined,
   assertMatches,
   assertNonEmpty,
   isNonEmptyArray
-} from "./shared/@outfitter/contracts-d1thk8cv.js";
+} from "./shared/@outfitter/contracts-2f3khqcc.js";
 import {
   toEnvelope,
   toHttpResponse
-} from "./shared/@outfitter/contracts-chnm7kvm.js";
+} from "./shared/@outfitter/contracts-rtsa2s0f.js";
 import {
   deserializeError,
   safeParse,
   safeStringify,
   serializeError
-} from "./shared/@outfitter/contracts-dbpj0b4k.js";
+} from "./shared/@outfitter/contracts-agvdgx9j.js";
 import {
   DEFAULT_PATTERNS,
   DEFAULT_SENSITIVE_KEYS,
@@ -54,12 +55,13 @@ import {
 import {
   createContext,
   generateRequestId
-} from "./shared/@outfitter/contracts-y8qg2nvz.js";
+} from "./shared/@outfitter/contracts-agmt8915.js";
 import {
   createValidator,
   validateInput
-} from "./shared/@outfitter/contracts-sf5p84cc.js";
+} from "./shared/@outfitter/contracts-k2jdpbb6.js";
 import {
+  AmbiguousError,
   AssertionError,
   AuthError,
   CancelledError,
@@ -76,7 +78,7 @@ import {
   getExitCode,
   getStatusCode,
   statusCodeMap
-} from "./shared/@outfitter/contracts-jhsgc85s.js";
+} from "./shared/@outfitter/contracts-0cj49e1a.js";
 
 // packages/contracts/src/index.ts
 import { Result, TaggedError } from "better-result";
@@ -101,6 +103,7 @@ export {
   getBackoffDelay,
   getActionsForSurface,
   generateRequestId,
+  expect,
   exitCodeMap,
   deserializeError,
   defineAction,
@@ -134,6 +137,7 @@ export {
   CAPABILITY_SURFACES,
   AuthError,
   AssertionError,
+  AmbiguousError,
   ACTION_SURFACES,
   ACTION_CAPABILITIES
 };

package/dist/recovery.d.ts

@@ -1,3 +1,3 @@
-import { BackoffOptions, getBackoffDelay, isRecoverable, isRetryable, shouldRetry } from "./shared/@outfitter/contracts-47aemgd3";
-import "./shared/@outfitter/contracts-ev4a68sg";
+import { BackoffOptions, getBackoffDelay, isRecoverable, isRetryable, shouldRetry } from "./shared/@outfitter/contracts-md2mvvyt";
+import "./shared/@outfitter/contracts-5hr9pdcq";
 export { shouldRetry, isRetryable, isRecoverable, getBackoffDelay, BackoffOptions };

package/dist/resilience.d.ts

@@ -1,3 +1,3 @@
-import { RetryOptions, TimeoutOptions, retry, withTimeout } from "./shared/@outfitter/contracts-37891j7e";
-import "./shared/@outfitter/contracts-ev4a68sg";
+import { RetryOptions, TimeoutOptions, retry, withTimeout } from "./shared/@outfitter/contracts-r64j5rsm";
+import "./shared/@outfitter/contracts-5hr9pdcq";
 export { withTimeout, retry, TimeoutOptions, RetryOptions };

package/dist/resilience.js

@@ -2,8 +2,8 @@
 import {
   retry,
   withTimeout
-} from "./shared/@outfitter/contracts-aq745b7n.js";
-import"./shared/@outfitter/contracts-jhsgc85s.js";
+} from "./shared/@outfitter/contracts-pdk7s4t8.js";
+import"./shared/@outfitter/contracts-0cj49e1a.js";
 export {
   withTimeout,
   retry

package/dist/result/index.d.ts

@@ -1,3 +1,3 @@
 import "../shared/@outfitter/contracts-qaccq0gf";
-import { combine2, combine3, orElse, unwrapOrElse } from "../shared/@outfitter/contracts-109drsem";
-export { unwrapOrElse, orElse, combine3, combine2 };
+import { combine2, combine3, expect, orElse, unwrapOrElse } from "../shared/@outfitter/contracts-ar0etwtx";
+export { unwrapOrElse, orElse, expect, combine3, combine2 };

package/dist/result/index.js

@@ -3,12 +3,14 @@ import"../shared/@outfitter/contracts-37gpc56f.js";
 import {
   combine2,
   combine3,
+  expect,
   orElse,
   unwrapOrElse
-} from "../shared/@outfitter/contracts-r06bafs8.js";
+} from "../shared/@outfitter/contracts-zx72gyh1.js";
 export {
   unwrapOrElse,
   orElse,
+  expect,
   combine3,
   combine2
 };

package/dist/result/utilities.d.ts

@@ -1,2 +1,2 @@
-import { combine2, combine3, orElse, unwrapOrElse } from "../shared/@outfitter/contracts-109drsem";
-export { unwrapOrElse, orElse, combine3, combine2 };
+import { combine2, combine3, expect, orElse, unwrapOrElse } from "../shared/@outfitter/contracts-ar0etwtx";
+export { unwrapOrElse, orElse, expect, combine3, combine2 };

package/dist/result/utilities.js

@@ -2,12 +2,14 @@
 import {
   combine2,
   combine3,
+  expect,
   orElse,
   unwrapOrElse
-} from "../shared/@outfitter/contracts-r06bafs8.js";
+} from "../shared/@outfitter/contracts-zx72gyh1.js";
 export {
   unwrapOrElse,
   orElse,
+  expect,
   combine3,
   combine2
 };

package/dist/serialization.d.ts

@@ -1,3 +1,3 @@
-import { SerializeErrorOptions, deserializeError, safeParse, safeStringify, serializeError } from "./shared/@outfitter/contracts-0taqjz0a";
-import "./shared/@outfitter/contracts-ev4a68sg";
+import { SerializeErrorOptions, deserializeError, safeParse, safeStringify, serializeError } from "./shared/@outfitter/contracts-6atxbfag";
+import "./shared/@outfitter/contracts-5hr9pdcq";
 export { serializeError, safeStringify, safeParse, deserializeError, SerializeErrorOptions };

package/dist/serialization.js

@@ -4,9 +4,9 @@ import {
   safeParse,
   safeStringify,
   serializeError
-} from "./shared/@outfitter/contracts-dbpj0b4k.js";
+} from "./shared/@outfitter/contracts-agvdgx9j.js";
 import"./shared/@outfitter/contracts-s15x2rs4.js";
-import"./shared/@outfitter/contracts-jhsgc85s.js";
+import"./shared/@outfitter/contracts-0cj49e1a.js";
 export {
   serializeError,
   safeStringify,

package/dist/shared/@outfitter/{contracts-jhsgc85s.js → contracts-0cj49e1a.js}

@@ -30,7 +30,8 @@ var ERROR_CODES = {
     FIELD_REQUIRED: 1001,
     INVALID_FORMAT: 1002,
     OUT_OF_RANGE: 1003,
-    TYPE_MISMATCH: 1004
+    TYPE_MISMATCH: 1004,
+    AMBIGUOUS_MATCH: 1005
   },
   not_found: {
     RESOURCE_NOT_FOUND: 2001,
@@ -76,6 +77,7 @@ function getStatusCode(category) {
   return statusCodeMap[category];
 }
 var ValidationErrorBase = TaggedError("ValidationError")();
+var AmbiguousErrorBase = TaggedError("AmbiguousError")();
 var AssertionErrorBase = TaggedError("AssertionError")();
 var NotFoundErrorBase = TaggedError("NotFoundError")();
 var ConflictErrorBase = TaggedError("ConflictError")();
@@ -89,6 +91,30 @@ var CancelledErrorBase = TaggedError("CancelledError")();
 
 class ValidationError extends ValidationErrorBase {
   category = "validation";
+  static create(field, reason, context) {
+    return new ValidationError({
+      message: `${field}: ${reason}`,
+      field,
+      ...context != null && { context }
+    });
+  }
+  exitCode() {
+    return getExitCode(this.category);
+  }
+  statusCode() {
+    return getStatusCode(this.category);
+  }
+}
+
+class AmbiguousError extends AmbiguousErrorBase {
+  category = "validation";
+  static create(what, candidates, context) {
+    return new AmbiguousError({
+      message: `Ambiguous ${what}: ${candidates.length} matches found`,
+      candidates,
+      ...context != null && { context }
+    });
+  }
   exitCode() {
     return getExitCode(this.category);
   }
@@ -109,6 +135,14 @@ class AssertionError extends AssertionErrorBase {
 
 class NotFoundError extends NotFoundErrorBase {
   category = "not_found";
+  static create(resourceType, resourceId, context) {
+    return new NotFoundError({
+      message: `${resourceType} not found: ${resourceId}`,
+      resourceType,
+      resourceId,
+      ...context != null && { context }
+    });
+  }
   exitCode() {
     return getExitCode(this.category);
   }
@@ -119,6 +153,9 @@ class NotFoundError extends NotFoundErrorBase {
 
 class ConflictError extends ConflictErrorBase {
   category = "conflict";
+  static create(message, context) {
+    return new ConflictError({ message, ...context != null && { context } });
+  }
   exitCode() {
     return getExitCode(this.category);
   }
@@ -129,6 +166,12 @@ class ConflictError extends ConflictErrorBase {
 
 class PermissionError extends PermissionErrorBase {
   category = "permission";
+  static create(message, context) {
+    return new PermissionError({
+      message,
+      ...context != null && { context }
+    });
+  }
   exitCode() {
     return getExitCode(this.category);
   }
@@ -139,6 +182,13 @@ class PermissionError extends PermissionErrorBase {
 
 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);
   }
@@ -149,6 +199,12 @@ class TimeoutError extends TimeoutErrorBase {
 
 class RateLimitError extends RateLimitErrorBase {
   category = "rate_limit";
+  static create(message, retryAfterSeconds) {
+    return new RateLimitError({
+      message,
+      ...retryAfterSeconds != null && { retryAfterSeconds }
+    });
+  }
   exitCode() {
     return getExitCode(this.category);
   }
@@ -159,6 +215,9 @@ class RateLimitError extends RateLimitErrorBase {
 
 class NetworkError extends NetworkErrorBase {
   category = "network";
+  static create(message, context) {
+    return new NetworkError({ message, ...context != null && { context } });
+  }
   exitCode() {
     return getExitCode(this.category);
   }
@@ -169,6 +228,9 @@ class NetworkError extends NetworkErrorBase {
 
 class InternalError extends InternalErrorBase {
   category = "internal";
+  static create(message, context) {
+    return new InternalError({ message, ...context != null && { context } });
+  }
   exitCode() {
     return getExitCode(this.category);
   }
@@ -179,6 +241,9 @@ class InternalError extends InternalErrorBase {
 
 class AuthError extends AuthErrorBase {
   category = "auth";
+  static create(message, reason) {
+    return new AuthError({ message, ...reason != null && { reason } });
+  }
   exitCode() {
     return getExitCode(this.category);
   }
@@ -189,6 +254,9 @@ class AuthError extends AuthErrorBase {
 
 class CancelledError extends CancelledErrorBase {
   category = "cancelled";
+  static create(message) {
+    return new CancelledError({ message });
+  }
   exitCode() {
     return getExitCode(this.category);
   }
@@ -197,4 +265,4 @@ class CancelledError extends CancelledErrorBase {
   }
 }
 
-export { exitCodeMap, statusCodeMap, ERROR_CODES, getExitCode, getStatusCode, ValidationError, AssertionError, NotFoundError, ConflictError, PermissionError, TimeoutError, RateLimitError, NetworkError, InternalError, AuthError, CancelledError };
+export { exitCodeMap, statusCodeMap, ERROR_CODES, getExitCode, getStatusCode, ValidationError, AmbiguousError, AssertionError, NotFoundError, ConflictError, PermissionError, TimeoutError, RateLimitError, NetworkError, InternalError, AuthError, CancelledError };

package/dist/shared/@outfitter/{contracts-d1thk8cv.js → contracts-2f3khqcc.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   AssertionError
-} from "./contracts-jhsgc85s.js";
+} from "./contracts-0cj49e1a.js";
 
 // packages/contracts/src/assert/index.ts
 import { Result } from "better-result";

package/dist/shared/@outfitter/{contracts-ev4a68sg.d.ts → contracts-5hr9pdcq.d.ts}

@@ -40,6 +40,7 @@ declare const ERROR_CODES: {
 		readonly INVALID_FORMAT: 1002;
 		readonly OUT_OF_RANGE: 1003;
 		readonly TYPE_MISMATCH: 1004;
+		readonly AMBIGUOUS_MATCH: 1005;
 	};
 	readonly not_found: {
 		readonly RESOURCE_NOT_FOUND: 2001;
@@ -112,6 +113,12 @@ declare function getStatusCode(category: ErrorCategory): number;
 declare const ValidationErrorBase: TaggedErrorClass<"ValidationError", {
 	message: string;
 	field?: string;
+	context?: Record<string, unknown>;
+}>;
+declare const AmbiguousErrorBase: TaggedErrorClass<"AmbiguousError", {
+	message: string;
+	candidates: string[];
+	context?: Record<string, unknown>;
 }>;
 declare const AssertionErrorBase: TaggedErrorClass<"AssertionError", {
 	message: string;
@@ -120,6 +127,7 @@ declare const NotFoundErrorBase: TaggedErrorClass<"NotFoundError", {
 	message: string;
 	resourceType: string;
 	resourceId: string;
+	context?: Record<string, unknown>;
 }>;
 declare const ConflictErrorBase: TaggedErrorClass<"ConflictError", {
 	message: string;
@@ -159,10 +167,40 @@ declare const CancelledErrorBase: TaggedErrorClass<"CancelledError", {
 * @example
 * ```typescript
 * new ValidationError({ message: "Email format invalid", field: "email" });
+* new ValidationError({
+*   message: "Value out of range",
+*   field: "age",
+*   context: { min: 0, max: 150, received: -1 },
+* });
 * ```
 */
 declare class ValidationError extends ValidationErrorBase {
 	readonly category: "validation";
+	/** Create a ValidationError with auto-generated message from field name. */
+	static create(field: string, reason: string, context?: Record<string, unknown>): ValidationError;
+	exitCode(): number;
+	statusCode(): number;
+}
+/**
+* Multiple matches found — user must disambiguate.
+*
+* Used in search/resolution systems where partial input matches
+* multiple candidates. Carries the candidate list so transport
+* layers can prompt disambiguation.
+*
+* @example
+* ```typescript
+* new AmbiguousError({
+*   message: "Multiple headings match 'Intro'",
+*   candidates: ["Introduction", "Intro to APIs"],
+* });
+* AmbiguousError.create("heading", ["Introduction", "Intro to APIs"]);
+* ```
+*/
+declare class AmbiguousError extends AmbiguousErrorBase {
+	readonly category: "validation";
+	/** Create an AmbiguousError with auto-generated message. */
+	static create(what: string, candidates: string[], context?: Record<string, unknown>): AmbiguousError;
 	exitCode(): number;
 	statusCode(): number;
 }
@@ -202,10 +240,18 @@ declare class AssertionError extends AssertionErrorBase {
 * @example
 * ```typescript
 * new NotFoundError({ message: "note not found: abc123", resourceType: "note", resourceId: "abc123" });
+* new NotFoundError({
+*   message: "Heading not found",
+*   resourceType: "heading",
+*   resourceId: "h:Intro",
+*   context: { availableHeadings: ["Introduction", "Getting Started"] },
+* });
 * ```
 */
 declare class NotFoundError extends NotFoundErrorBase {
 	readonly category: "not_found";
+	/** Create a NotFoundError with auto-generated message. */
+	static create(resourceType: string, resourceId: string, context?: Record<string, unknown>): NotFoundError;
 	exitCode(): number;
 	statusCode(): number;
 }
@@ -219,6 +265,8 @@ declare class NotFoundError extends NotFoundErrorBase {
 */
 declare class ConflictError extends ConflictErrorBase {
 	readonly category: "conflict";
+	/** Create a ConflictError with optional context. */
+	static create(message: string, context?: Record<string, unknown>): ConflictError;
 	exitCode(): number;
 	statusCode(): number;
 }
@@ -232,6 +280,8 @@ declare class ConflictError extends ConflictErrorBase {
 */
 declare class PermissionError extends PermissionErrorBase {
 	readonly category: "permission";
+	/** Create a PermissionError with optional context. */
+	static create(message: string, context?: Record<string, unknown>): PermissionError;
 	exitCode(): number;
 	statusCode(): number;
 }
@@ -245,6 +295,8 @@ declare class PermissionError extends PermissionErrorBase {
 */
 declare class TimeoutError extends TimeoutErrorBase {
 	readonly category: "timeout";
+	/** Create a TimeoutError with auto-generated message. */
+	static create(operation: string, timeoutMs: number): TimeoutError;
 	exitCode(): number;
 	statusCode(): number;
 }
@@ -258,6 +310,8 @@ declare class TimeoutError extends TimeoutErrorBase {
 */
 declare class RateLimitError extends RateLimitErrorBase {
 	readonly category: "rate_limit";
+	/** Create a RateLimitError with optional retry hint. */
+	static create(message: string, retryAfterSeconds?: number): RateLimitError;
 	exitCode(): number;
 	statusCode(): number;
 }
@@ -271,6 +325,8 @@ declare class RateLimitError extends RateLimitErrorBase {
 */
 declare class NetworkError extends NetworkErrorBase {
 	readonly category: "network";
+	/** Create a NetworkError with optional context. */
+	static create(message: string, context?: Record<string, unknown>): NetworkError;
 	exitCode(): number;
 	statusCode(): number;
 }
@@ -284,6 +340,8 @@ declare class NetworkError extends NetworkErrorBase {
 */
 declare class InternalError extends InternalErrorBase {
 	readonly category: "internal";
+	/** Create an InternalError with optional context. */
+	static create(message: string, context?: Record<string, unknown>): InternalError;
 	exitCode(): number;
 	statusCode(): number;
 }
@@ -297,6 +355,8 @@ declare class InternalError extends InternalErrorBase {
 */
 declare class AuthError extends AuthErrorBase {
 	readonly category: "auth";
+	/** Create an AuthError with optional reason. */
+	static create(message: string, reason?: "missing" | "invalid" | "expired"): AuthError;
 	exitCode(): number;
 	statusCode(): number;
 }
@@ -310,16 +370,18 @@ declare class AuthError extends AuthErrorBase {
 */
 declare class CancelledError extends CancelledErrorBase {
 	readonly category: "cancelled";
+	/** Create a CancelledError. */
+	static create(message: string): CancelledError;
 	exitCode(): number;
 	statusCode(): number;
 }
 /**
 * Union type of all concrete error class instances.
 */
-type AnyKitError = InstanceType<typeof ValidationError> | InstanceType<typeof AssertionError> | InstanceType<typeof NotFoundError> | InstanceType<typeof ConflictError> | InstanceType<typeof PermissionError> | InstanceType<typeof TimeoutError> | InstanceType<typeof RateLimitError> | InstanceType<typeof NetworkError> | InstanceType<typeof InternalError> | InstanceType<typeof AuthError> | InstanceType<typeof CancelledError>;
+type AnyKitError = InstanceType<typeof ValidationError> | InstanceType<typeof AmbiguousError> | InstanceType<typeof AssertionError> | InstanceType<typeof NotFoundError> | InstanceType<typeof ConflictError> | InstanceType<typeof PermissionError> | InstanceType<typeof TimeoutError> | InstanceType<typeof RateLimitError> | InstanceType<typeof NetworkError> | InstanceType<typeof InternalError> | InstanceType<typeof AuthError> | InstanceType<typeof CancelledError>;
 /**
 * Type alias for backwards compatibility with handler signatures.
 * Use AnyKitError for the union type.
 */
 type OutfitterError = AnyKitError;
-export { ErrorCategory, exitCodeMap, statusCodeMap, ERROR_CODES, ErrorCode, SerializedError, KitErrorProps, getExitCode, getStatusCode, ValidationError, AssertionError, NotFoundError, ConflictError, PermissionError, TimeoutError, RateLimitError, NetworkError, InternalError, AuthError, CancelledError, AnyKitError, OutfitterError };
+export { ErrorCategory, exitCodeMap, statusCodeMap, ERROR_CODES, ErrorCode, SerializedError, KitErrorProps, getExitCode, getStatusCode, ValidationError, AmbiguousError, AssertionError, NotFoundError, ConflictError, PermissionError, TimeoutError, RateLimitError, NetworkError, InternalError, AuthError, CancelledError, AnyKitError, OutfitterError };

package/dist/shared/@outfitter/{contracts-0taqjz0a.d.ts → contracts-6atxbfag.d.ts}

@@ -1,4 +1,4 @@
-import { OutfitterError, SerializedError, ValidationError } from "./contracts-ev4a68sg";
+import { OutfitterError, SerializedError, ValidationError } from "./contracts-5hr9pdcq";
 import { Result } from "better-result";
 import { z } from "zod";
 /**

package/dist/shared/@outfitter/{contracts-y8qg2nvz.js → contracts-agmt8915.js}

@@ -1,12 +1,12 @@
 // @bun
 // packages/contracts/src/context.ts
 var noopLogger = {
-  trace: () => {},
-  debug: () => {},
-  info: () => {},
-  warn: () => {},
-  error: () => {},
-  fatal: () => {},
+  trace: (..._args) => {},
+  debug: (..._args) => {},
+  info: (..._args) => {},
+  warn: (..._args) => {},
+  error: (..._args) => {},
+  fatal: (..._args) => {},
   child: () => noopLogger
 };
 function createContext(options) {

package/dist/shared/@outfitter/{contracts-dbpj0b4k.js → contracts-agvdgx9j.js}

@@ -5,6 +5,8 @@ import {
   createRedactor
 } from "./contracts-s15x2rs4.js";
 import {
+  AmbiguousError,
+  AssertionError,
   AuthError,
   CancelledError,
   ConflictError,
@@ -15,12 +17,14 @@ import {
   RateLimitError,
   TimeoutError,
   ValidationError
-} from "./contracts-jhsgc85s.js";
+} from "./contracts-0cj49e1a.js";
 
 // packages/contracts/src/serialization.ts
 import { Result } from "better-result";
 var errorRegistry = {
   ValidationError,
+  AmbiguousError,
+  AssertionError,
   NotFoundError,
   ConflictError,
   PermissionError,
@@ -70,6 +74,13 @@ function extractContext(error) {
       }
       break;
     }
+    case "AmbiguousError": {
+      const amb = error;
+      context["candidates"] = amb.candidates;
+      break;
+    }
+    case "AssertionError":
+      break;
     case "ConflictError":
     case "PermissionError":
     case "NetworkError":
@@ -196,6 +207,15 @@ function deserializeError(data) {
       }
       return new AuthError(props);
     }
+    case "AmbiguousError":
+      return new AmbiguousError({
+        message: data.message,
+        candidates: context["candidates"] ?? []
+      });
+    case "AssertionError":
+      return new AssertionError({
+        message: data.message
+      });
     case "CancelledError":
       return new CancelledError({
         message: data.message

package/dist/shared/@outfitter/{contracts-yp3derbe.d.ts → contracts-amd2ykn8.d.ts}

@@ -1,4 +1,4 @@
-import { OutfitterError } from "./contracts-ev4a68sg";
+import { OutfitterError } from "./contracts-5hr9pdcq";
 import { Result } from "better-result";
 /**
 * Logger interface for handler context.
@@ -9,11 +9,17 @@ import { Result } from "better-result";
 */
 interface Logger {
 	trace(message: string, metadata?: Record<string, unknown>): void;
+	trace(metadata: Record<string, unknown>, message: string): never;
 	debug(message: string, metadata?: Record<string, unknown>): void;
+	debug(metadata: Record<string, unknown>, message: string): never;
 	info(message: string, metadata?: Record<string, unknown>): void;
+	info(metadata: Record<string, unknown>, message: string): never;
 	warn(message: string, metadata?: Record<string, unknown>): void;
+	warn(metadata: Record<string, unknown>, message: string): never;
 	error(message: string, metadata?: Record<string, unknown>): void;
+	error(metadata: Record<string, unknown>, message: string): never;
 	fatal(message: string, metadata?: Record<string, unknown>): void;
+	fatal(metadata: Record<string, unknown>, message: string): never;
 	/**
 	* Creates a child logger with additional context.
 	*

package/dist/shared/@outfitter/{contracts-109drsem.d.ts → contracts-ar0etwtx.d.ts}

@@ -100,4 +100,26 @@ declare const combine3: <
 	T3,
 	E
 >(r1: Result<T1, E>, r2: Result<T2, E>, r3: Result<T3, E>) => Result<[T1, T2, T3], E>;
-export { unwrapOrElse, orElse, combine2, combine3 };
+/**
+* Extract value from Ok, or throw with a contextual error message.
+*
+* Like `unwrap()` but with a caller-provided message for better
+* debugging context. Use at system boundaries (CLI adapters, MCP
+* handlers) where you need the value and want a clear error.
+*
+* @param result - The Result to unwrap
+* @param message - Context message prepended to the error
+* @returns The success value
+* @throws Error with contextual message if Result is Err
+*
+* @example
+* ```typescript
+* const config = expect(loadConfig(), "Failed to load config");
+* // On Err, throws: "Failed to load config: <error details>"
+* ```
+*/
+declare const expect: <
+	T,
+	E
+>(result: Result<T, E>, message: string) => T;
+export { unwrapOrElse, orElse, combine2, combine3, expect };

package/dist/shared/@outfitter/{contracts-t3j7fba3.d.ts → contracts-jbhbyhtt.d.ts}

@@ -1,4 +1,4 @@
-import { AssertionError } from "./contracts-ev4a68sg";
+import { AssertionError } from "./contracts-5hr9pdcq";
 import { Result } from "better-result";
 /**
 * Array type guaranteed to have at least one element.

package/dist/shared/@outfitter/{contracts-q9tjk2zp.d.ts → contracts-k0rhaye3.d.ts}

@@ -1,4 +1,4 @@
-import { OutfitterError, SerializedError } from "./contracts-ev4a68sg";
+import { OutfitterError, SerializedError } from "./contracts-5hr9pdcq";
 import { Result } from "better-result";
 /**
 * Metadata attached to every response envelope.

package/dist/shared/@outfitter/{contracts-sf5p84cc.js → contracts-k2jdpbb6.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   ValidationError
-} from "./contracts-jhsgc85s.js";
+} from "./contracts-0cj49e1a.js";
 
 // packages/contracts/src/validation.ts
 import { Result } from "better-result";

package/dist/shared/@outfitter/{contracts-47aemgd3.d.ts → contracts-md2mvvyt.d.ts}

@@ -1,4 +1,4 @@
-import { ErrorCategory } from "./contracts-ev4a68sg";
+import { ErrorCategory } from "./contracts-5hr9pdcq";
 /**
 * Backoff strategy configuration options
 */

package/dist/shared/@outfitter/{contracts-g82822x1.d.ts → contracts-n9hb6hqt.d.ts}

@@ -1,4 +1,4 @@
-import { ValidationError } from "./contracts-ev4a68sg";
+import { ValidationError } from "./contracts-5hr9pdcq";
 import { Result } from "better-result";
 import { z } from "zod";
 /**

package/dist/shared/@outfitter/{contracts-aq745b7n.js → contracts-pdk7s4t8.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   TimeoutError
-} from "./contracts-jhsgc85s.js";
+} from "./contracts-0cj49e1a.js";
 
 // packages/contracts/src/resilience.ts
 import { Result } from "better-result";

package/dist/shared/@outfitter/{contracts-37891j7e.d.ts → contracts-r64j5rsm.d.ts}

@@ -1,4 +1,4 @@
-import { OutfitterError, TimeoutError } from "./contracts-ev4a68sg";
+import { OutfitterError, TimeoutError } from "./contracts-5hr9pdcq";
 import { Result } from "better-result";
 /**
 * Options for retry behavior.

package/dist/shared/@outfitter/{contracts-chnm7kvm.js → contracts-rtsa2s0f.js}

@@ -1,13 +1,13 @@
 // @bun
 import {
   serializeError
-} from "./contracts-dbpj0b4k.js";
+} from "./contracts-agvdgx9j.js";
 import {
   generateRequestId
-} from "./contracts-y8qg2nvz.js";
+} from "./contracts-agmt8915.js";
 import {
   statusCodeMap
-} from "./contracts-jhsgc85s.js";
+} from "./contracts-0cj49e1a.js";
 
 // packages/contracts/src/envelope.ts
 function buildMeta(overrides) {

package/dist/shared/@outfitter/{contracts-wwkk3j4m.d.ts → contracts-t68dwjbk.d.ts}

@@ -1,4 +1,4 @@
-import { HandlerContext, Logger, ResolvedConfig } from "./contracts-yp3derbe";
+import { HandlerContext, Logger, ResolvedConfig } from "./contracts-amd2ykn8";
 /**
 * Options for creating a handler context.
 */

package/dist/shared/@outfitter/{contracts-r06bafs8.js → contracts-zx72gyh1.js}

@@ -23,5 +23,10 @@ var combine3 = (r1, r2, r3) => {
     return r3;
   return Result.ok([r1.value, r2.value, r3.value]);
 };
+var expect = (result, message) => {
+  if (result.isOk())
+    return result.value;
+  throw new Error(`${message}: ${String(result.error)}`);
+};
 
-export { unwrapOrElse, orElse, combine2, combine3 };
+export { unwrapOrElse, orElse, combine2, combine3, expect };

package/dist/shared/@outfitter/{contracts-vtrf6rbx.d.ts → contracts-zyanj0gf.d.ts}

@@ -1,5 +1,5 @@
-import { Handler, SyncHandler } from "./contracts-yp3derbe";
-import { OutfitterError } from "./contracts-ev4a68sg";
+import { Handler, SyncHandler } from "./contracts-amd2ykn8";
+import { OutfitterError } from "./contracts-5hr9pdcq";
 import { z } from "zod";
 declare const ACTION_SURFACES: readonly ["cli", "mcp", "api", "server"];
 type ActionSurface = (typeof ACTION_SURFACES)[number];

package/dist/validation.d.ts

@@ -1,3 +1,3 @@
-import { createValidator, validateInput } from "./shared/@outfitter/contracts-g82822x1";
-import "./shared/@outfitter/contracts-ev4a68sg";
+import { createValidator, validateInput } from "./shared/@outfitter/contracts-n9hb6hqt";
+import "./shared/@outfitter/contracts-5hr9pdcq";
 export { validateInput, createValidator };

package/dist/validation.js

@@ -2,8 +2,8 @@
 import {
   createValidator,
   validateInput
-} from "./shared/@outfitter/contracts-sf5p84cc.js";
-import"./shared/@outfitter/contracts-jhsgc85s.js";
+} from "./shared/@outfitter/contracts-k2jdpbb6.js";
+import"./shared/@outfitter/contracts-0cj49e1a.js";
 export {
   validateInput,
   createValidator

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@outfitter/contracts",
   "description": "Result/Error patterns, error taxonomy, and handler contracts for Outfitter",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "type": "module",
   "files": [
     "dist"