@outfitter/contracts 0.4.1 → 0.5.0

package/README.md

@@ -34,7 +34,10 @@ import {
 } from "@outfitter/contracts";
 
 // Define a handler
-const getNote: Handler<{ id: string }, Note, NotFoundError> = async (input, ctx) => {
+const getNote: Handler<{ id: string }, Note, NotFoundError> = async (
+  input,
+  ctx
+) => {
   const note = await db.notes.find(input.id);
   if (!note) return Result.err(NotFoundError.create("note", input.id));
   return Result.ok(note);
@@ -49,21 +52,21 @@ const result = await getNote({ id: "abc123" }, ctx);
 
 All error classes provide a static `create()` factory method that generates a consistent message from structured parameters. Use `create()` for structured errors and the constructor for custom messages.
 
-| Error Class | `create()` Signature | Generated Message |
-|---|---|---|
-| `ValidationError` | `create(field, reason, context?)` | `"email: format invalid"` |
-| `ValidationError` | `fromMessage(message, context?)` | *(your message as-is)* |
-| `AmbiguousError` | `create(what, candidates, context?)` | `"Ambiguous heading: 2 matches found"` |
-| `NotFoundError` | `create(resourceType, resourceId, context?)` | `"note not found: abc123"` |
+| Error Class          | `create()` Signature                         | Generated Message                         |
+| -------------------- | -------------------------------------------- | ----------------------------------------- |
+| `ValidationError`    | `create(field, reason, context?)`            | `"email: format invalid"`                 |
+| `ValidationError`    | `fromMessage(message, context?)`             | _(your message as-is)_                    |
+| `AmbiguousError`     | `create(what, candidates, context?)`         | `"Ambiguous heading: 2 matches found"`    |
+| `NotFoundError`      | `create(resourceType, resourceId, context?)` | `"note not found: abc123"`                |
 | `AlreadyExistsError` | `create(resourceType, resourceId, context?)` | `"file already exists: notes/meeting.md"` |
-| `ConflictError` | `create(message, context?)` | *(your message as-is)* |
-| `PermissionError` | `create(message, context?)` | *(your message as-is)* |
-| `TimeoutError` | `create(operation, timeoutMs)` | `"database query timed out after 5000ms"` |
-| `RateLimitError` | `create(message, retryAfterSeconds?)` | *(your message as-is)* |
-| `NetworkError` | `create(message, context?)` | *(your message as-is)* |
-| `InternalError` | `create(message, context?)` | *(your message as-is)* |
-| `AuthError` | `create(message, reason?)` | *(your message as-is)* |
-| `CancelledError` | `create(message)` | *(your message as-is)* |
+| `ConflictError`      | `create(message, context?)`                  | _(your message as-is)_                    |
+| `PermissionError`    | `create(message, context?)`                  | _(your message as-is)_                    |
+| `TimeoutError`       | `create(operation, timeoutMs)`               | `"database query timed out after 5000ms"` |
+| `RateLimitError`     | `create(message, retryAfterSeconds?)`        | _(your message as-is)_                    |
+| `NetworkError`       | `create(message, context?)`                  | _(your message as-is)_                    |
+| `InternalError`      | `create(message, context?)`                  | _(your message as-is)_                    |
+| `AuthError`          | `create(message, reason?)`                   | _(your message as-is)_                    |
+| `CancelledError`     | `create(message)`                            | _(your message as-is)_                    |
 
 ### Message Casing
 

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/actions.js

@@ -1,10 +1,29 @@
 // @bun
-import {
-  ACTION_SURFACES,
-  DEFAULT_REGISTRY_SURFACES,
-  createActionRegistry,
-  defineAction
-} from "./shared/@outfitter/contracts-q0v44kef.js";
+// packages/contracts/src/actions.ts
+var ACTION_SURFACES = ["cli", "mcp", "api", "server"];
+var DEFAULT_REGISTRY_SURFACES = ACTION_SURFACES;
+function defineAction(action) {
+  return action;
+}
+function createActionRegistry() {
+  const actions = new Map;
+  return {
+    add(action) {
+      actions.set(action.id, action);
+      return this;
+    },
+    list() {
+      return Array.from(actions.values());
+    },
+    get(id) {
+      return actions.get(id);
+    },
+    forSurface(surface) {
+      const defaults = DEFAULT_REGISTRY_SURFACES;
+      return Array.from(actions.values()).filter((action) => (action.surfaces ?? defaults).includes(surface));
+    }
+  };
+}
 export {
   defineAction,
   createActionRegistry,

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,13 +1,66 @@
 // @bun
 import {
-  assertDefined,
-  assertMatches,
-  assertNonEmpty,
-  isNonEmptyArray
-} from "../shared/@outfitter/contracts-cp5c6dws.js";
-import"../shared/@outfitter/contracts-phjhz5q3.js";
+  AssertionError
+} from "../shared/@outfitter/contracts-vhr2ep6b.js";
+
+// packages/contracts/src/assert/index.ts
+import { Result } from "better-result";
+var isNonEmptyArray = (arr) => {
+  return arr.length > 0;
+};
+var assertDefined = (value, message) => {
+  if (value === null || value === undefined) {
+    return Result.err(new AssertionError({ message: message ?? "Value is null or undefined" }));
+  }
+  return Result.ok(value);
+};
+var assertNonEmpty = (arr, message) => {
+  if (arr.length === 0) {
+    return Result.err(new AssertionError({ message: message ?? "Array is empty" }));
+  }
+  return Result.ok(arr);
+};
+function assertMatches(value, predicate, message) {
+  if (!predicate(value)) {
+    return Result.err(new AssertionError({
+      message: message ?? "Value does not match predicate"
+    }));
+  }
+  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/capabilities.js

@@ -1,12 +1,61 @@
 // @bun
-import {
-  ACTION_CAPABILITIES,
-  CAPABILITY_SURFACES,
-  DEFAULT_ACTION_SURFACES,
-  capability,
-  capabilityAll,
-  getActionsForSurface
-} from "./shared/@outfitter/contracts-d0tq2adf.js";
+// packages/contracts/src/capabilities.ts
+var CAPABILITY_SURFACES = ["cli", "mcp", "api", "server"];
+var DEFAULT_ACTION_SURFACES = ["cli", "mcp"];
+function capability(surfaces = DEFAULT_ACTION_SURFACES, notes) {
+  return notes ? { surfaces, notes } : { surfaces };
+}
+function capabilityAll(notes) {
+  return capability(CAPABILITY_SURFACES, notes);
+}
+var ACTION_CAPABILITIES = {
+  navigate: capability(),
+  back: capability(),
+  forward: capability(),
+  reload: capability(),
+  tab: capability(),
+  tabs: capability(),
+  newTab: capability(),
+  closeTab: capability(),
+  click: capability(),
+  type: capability(),
+  select: capability(),
+  hover: capability(),
+  focus: capability(["mcp"]),
+  scroll: capability(),
+  press: capability(),
+  fill: capability(),
+  find: capability(),
+  check: capability(),
+  uncheck: capability(),
+  upload: capability(),
+  download: capability(["server"], "Server-only for now"),
+  dialog: capability(),
+  waitFor: capability(["mcp"]),
+  waitForNavigation: capability(["mcp"]),
+  wait: capability(["mcp"]),
+  snap: capability(),
+  screenshot: capability(),
+  html: capability(["mcp"]),
+  text: capability(["mcp"]),
+  marker: capability(),
+  markers: capability(),
+  markerGet: capability(),
+  markerRead: capability(["mcp"]),
+  markerCompare: capability(),
+  markerDelete: capability(),
+  markerResolve: capability(["cli"], "CLI-only for now"),
+  viewport: capability(),
+  colorScheme: capability(),
+  mode: capability(["mcp"]),
+  evaluate: capability(["mcp"]),
+  session: capability(),
+  sessions: capability(["mcp"]),
+  steps: capability()
+};
+function getActionsForSurface(surface) {
+  return Object.entries(ACTION_CAPABILITIES).filter(([, capability2]) => capability2.surfaces.includes(surface)).map(([action]) => action);
+}
 export {
   getActionsForSurface,
   capabilityAll,

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,12 +1,54 @@
 // @bun
 import {
-  toEnvelope,
-  toHttpResponse
-} from "./shared/@outfitter/contracts-85nd53s9.js";
-import"./shared/@outfitter/contracts-3wj7xghe.js";
-import"./shared/@outfitter/contracts-s15x2rs4.js";
-import"./shared/@outfitter/contracts-phjhz5q3.js";
-import"./shared/@outfitter/contracts-agmt8915.js";
+  generateRequestId
+} from "./shared/@outfitter/contracts-c3qfce25.js";
+import {
+  serializeError
+} from "./shared/@outfitter/contracts-jtt6dnmg.js";
+import {
+  statusCodeMap
+} from "./shared/@outfitter/contracts-vhr2ep6b.js";
+
+// packages/contracts/src/envelope.ts
+function buildMeta(overrides) {
+  const meta = {
+    requestId: overrides?.requestId ?? generateRequestId(),
+    timestamp: new Date().toISOString()
+  };
+  if (overrides?.durationMs !== undefined) {
+    meta.durationMs = overrides.durationMs;
+  }
+  return meta;
+}
+function toEnvelope(result, meta) {
+  const envelopeMeta = buildMeta(meta);
+  if (result.isOk()) {
+    return {
+      ok: true,
+      data: result.value,
+      meta: envelopeMeta
+    };
+  }
+  return {
+    ok: false,
+    error: serializeError(result.error),
+    meta: envelopeMeta
+  };
+}
+function toHttpResponse(result) {
+  const envelope = toEnvelope(result);
+  if (envelope.ok) {
+    return {
+      status: 200,
+      body: envelope
+    };
+  }
+  const status = statusCodeMap[envelope.error.category];
+  return {
+    status,
+    body: envelope
+  };
+}
 export {
   toHttpResponse,
   toEnvelope

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/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 { NonEmptyArray, assertDefined, assertMatches, assertNonEmpty, isNonEmptyArray } from "./shared/@outfitter/contracts-mmg0npfk.js";
-import { createValidator, validateInput } from "./shared/@outfitter/contracts-9wtm5nsw.js";
-import { ACTION_CAPABILITIES, ActionCapability, CAPABILITY_SURFACES, CapabilitySurface, DEFAULT_ACTION_SURFACES, capability, capabilityAll, getActionsForSurface } from "./shared/@outfitter/contracts-y8f0m1ze.js";
-import { DEFAULT_PATTERNS, DEFAULT_SENSITIVE_KEYS, RedactionCallback, RedactionEvent, Redactor, RedactorConfig, createRedactor } from "./shared/@outfitter/contracts-9yd4vrjg.js";
-import { BackoffOptions, getBackoffDelay, isRecoverable, isRetryable, shouldRetry } from "./shared/@outfitter/contracts-k71jqd1m.js";
-import { JsonSchema, zodToJsonSchema } from "./shared/@outfitter/contracts-t79engf9.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 { RetryOptions, TimeoutOptions, retry, withTimeout } from "./shared/@outfitter/contracts-95cc3y06.js";
 import { combine2, combine3, expect, orElse, unwrapOrElse } from "./shared/@outfitter/contracts-ar0etwtx.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 "./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 { Envelope, EnvelopeMeta, ErrorEnvelope, HttpResponse, PaginationMeta, SuccessEnvelope, toEnvelope, toHttpResponse } from "./shared/@outfitter/contracts-e4m948m7.js";
-import { SerializeErrorOptions, deserializeError, safeParse, safeStringify, serializeError } from "./shared/@outfitter/contracts-31penhwa.js";
-import { CreateContextOptions, createContext, generateRequestId } from "./shared/@outfitter/contracts-1waabxbk.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 { 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 };