stitchkit 0.41.0 → 0.42.0

package/dist/cli.js

@@ -4,10 +4,10 @@ import {
   emitResult,
   parseCliArgs,
   pollUntilDone
-} from "./index-ncqqn1bc.js";
+} from "./index-p9vkwns1.js";
 import"./index-frfyw9fa.js";
 import"./index-x3fcszf8.js";
-import"./index-sc67e454.js";
+import"./index-gex6gxhe.js";
 export {
   pollUntilDone,
   parseCliArgs,

package/dist/contract/errors-factory.d.ts

@@ -1,18 +1,91 @@
-/** A typed thrower — throws an `AppError` with the declared code and status. */
-export type ErrorThrower = (message?: string, details?: Record<string, unknown>, hint?: string) => never;
-/** The handle `defineErrors` returns. `TDef` maps `CODE → HTTP status`. */
-export interface DefinedErrors<TDef extends Record<string, number>> {
-    /** One thrower per code — `errors.CODE(message?)` throws the matching `AppError`. */
-    errors: {
-        [K in keyof TDef]: ErrorThrower;
+/**
+ * Declare an application's domain errors once. Each definition owns its HTTP
+ * status and optional Zod schema for structured details; generated factories
+ * construct (but do not throw) branded `AppError` instances.
+ *
+ * ```ts
+ * export const appErrors = defineErrors({
+ *   SESSION_NOT_FOUND: { status: 404 },
+ *   QUOTA_EXCEEDED: {
+ *     status: 429,
+ *     details: z.object({ retryAfterSeconds: z.number().int().positive() }),
+ *   },
+ * })
+ *
+ * throw appErrors.errors.SESSION_NOT_FOUND({ message: 'No such session' })
+ * throw appErrors.errors.QUOTA_EXCEEDED({
+ *   details: { retryAfterSeconds: 30 },
+ *   hint: 'Wait for the current window to expire',
+ * })
+ * ```
+ */
+import { z } from 'zod';
+import { AppError } from './errors';
+/** Supported structured-details schemas: a required or optional Zod object. */
+export type ErrorDetailsSchema = z.ZodObject | z.ZodOptional<z.ZodObject>;
+/** One domain error definition. Omitting `details` forbids structured details. */
+export type ErrorDefinition = {
+    readonly status: number;
+    readonly details?: never;
+} | {
+    readonly status: number;
+    readonly details: ErrorDetailsSchema;
+};
+export type ErrorDefinitions = Record<string, ErrorDefinition>;
+/** Parsed details retained by the constructed `AppError`. */
+export type ErrorDetailsOutput<TDefinition extends ErrorDefinition> = TDefinition extends {
+    details: infer TSchema extends ErrorDetailsSchema;
+} ? Extract<z.output<TSchema>, Record<string, unknown> | undefined> : undefined;
+/** AppError instance with required details refined when its schema is required. */
+export type DefinedAppError<TCode extends string, TDefinition extends ErrorDefinition> = AppError<TCode, ErrorDetailsOutput<TDefinition>> & (TDefinition extends {
+    details: infer TSchema extends ErrorDetailsSchema;
+} ? undefined extends z.output<TSchema> ? object : {
+    readonly details: ErrorDetailsOutput<TDefinition>;
+} : object);
+/**
+ * Factory arguments inferred from the definition: details are forbidden,
+ * required or optional according to the declared schema.
+ */
+export type ErrorFactoryArguments<TDefinition extends ErrorDefinition> = TDefinition extends {
+    details: infer TSchema extends ErrorDetailsSchema;
+} ? undefined extends z.input<TSchema> ? [
+    options?: {
+        message?: string;
+        details?: Exclude<z.input<TSchema>, undefined>;
+        hint?: string;
+    }
+] : [
+    options: {
+        message?: string;
+        details: z.input<TSchema>;
+        hint?: string;
+    }
+] : [options?: {
+    message?: string;
+    details?: never;
+    hint?: string;
+}];
+/** Typed constructor for one declared domain error code. */
+export type ErrorFactory<TCode extends string, TDefinition extends ErrorDefinition> = (...args: ErrorFactoryArguments<TDefinition>) => DefinedAppError<TCode, TDefinition>;
+export type ErrorFactories<TDefinitions extends ErrorDefinitions> = {
+    readonly [TCode in keyof TDefinitions]: ErrorFactory<TCode & string, TDefinitions[TCode]>;
+};
+export type FrozenErrorDefinitions<TDefinitions extends ErrorDefinitions> = {
+    readonly [TCode in keyof TDefinitions]: Readonly<TDefinitions[TCode]>;
+};
+/** The immutable handle returned by `defineErrors`. */
+export interface DefinedErrors<TDefinitions extends ErrorDefinitions> {
+    /** One typed `AppError` constructor per code. The caller chooses when to throw. */
+    readonly errors: ErrorFactories<TDefinitions>;
+    /** Code literals for client-side matching without magic strings. */
+    readonly codes: {
+        readonly [TCode in keyof TDefinitions]: TCode & string;
     };
-    /** The code literals — `codes.CODE === 'CODE'`, for client-side matching. */
-    codes: {
-        readonly [K in keyof TDef]: K;
-    };
-    /** Type guard — is `code` one of this app's declared codes? */
-    isCode: (code: string) => code is keyof TDef & string;
+    /** Read-only definitions; status and details schemas remain one source of truth. */
+    readonly definitions: FrozenErrorDefinitions<TDefinitions>;
+    /** Type guard — is `code` one of this application's declared codes? */
+    readonly isCode: (code: string) => code is Extract<keyof TDefinitions, string>;
 }
-/** Declare a set of domain error codes (`{ CODE: httpStatus }`). */
-export declare function defineErrors<const TDef extends Record<string, number>>(defs: TDef): DefinedErrors<TDef>;
+/** Declare an immutable, Zod-first domain error vocabulary. */
+export declare function defineErrors<const TDefinitions extends ErrorDefinitions>(source: TDefinitions): DefinedErrors<TDefinitions>;
 //# sourceMappingURL=errors-factory.d.ts.map

package/dist/contract/errors-factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors-factory.d.ts","sourceRoot":"","sources":["../../src/contract/errors-factory.ts"],"names":[],"mappings":"AA8BA,gFAAgF;AAChF,MAAM,MAAM,YAAY,GAAG,CACzB,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,IAAI,CAAC,EAAE,MAAM,KACV,KAAK,CAAC;AAEX,2EAA2E;AAC3E,MAAM,WAAW,aAAa,CAAC,IAAI,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAChE,qFAAqF;IACrF,MAAM,EAAE;SAAG,CAAC,IAAI,MAAM,IAAI,GAAG,YAAY;KAAE,CAAC;IAC5C,6EAA6E;IAC7E,KAAK,EAAE;QAAE,QAAQ,EAAE,CAAC,IAAI,MAAM,IAAI,GAAG,CAAC;KAAE,CAAC;IACzC,+DAA+D;IAC/D,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,IAAI,MAAM,IAAI,GAAG,MAAM,CAAC;CACvD;AAED,oEAAoE;AACpE,wBAAgB,YAAY,CAAC,KAAK,CAAC,IAAI,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACpE,IAAI,EAAE,IAAI,GACT,aAAa,CAAC,IAAI,CAAC,CAgBrB"}
+{"version":3,"file":"errors-factory.d.ts","sourceRoot":"","sources":["../../src/contract/errors-factory.ts"],"names":[],"mappings":"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"}

package/dist/contract/errors.d.ts

@@ -21,12 +21,12 @@ export interface ErrorEnvelope {
  * structured `details` and a `hint`. `toJSON()` renders the public error
  * envelope. Throw it directly, or via the typed helpers below.
  */
-export declare class AppError extends Error {
-    readonly code: string;
+export declare class AppError<TCode extends string = string, TDetails extends Record<string, unknown> | undefined = Record<string, unknown> | undefined> extends Error {
+    readonly code: TCode;
     readonly status: number;
-    readonly details?: Record<string, unknown> | undefined;
+    readonly details?: TDetails | undefined;
     readonly hint?: string | undefined;
-    constructor(code: string, message?: string, status?: number, details?: Record<string, unknown> | undefined, hint?: string | undefined);
+    constructor(code: TCode, message?: string, status?: number, details?: TDetails | undefined, hint?: string | undefined);
     static is(err: unknown): err is AppError;
     toJSON(): ErrorEnvelope;
 }

package/dist/contract/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/contract/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE;QACL,2CAA2C;QAC3C,IAAI,EAAE,MAAM,CAAC;QACb,8BAA8B;QAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,gCAAgC;QAChC,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,0BAA0B;QAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAcD;;;;GAIG;AACH,qBAAa,QAAS,SAAQ,KAAK;aAEf,IAAI,EAAE,MAAM;aAEZ,MAAM,EAAE,MAAM;aACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;aACjC,IAAI,CAAC,EAAE,MAAM;IAL/B,YACkB,IAAI,EAAE,MAAM,EAC5B,OAAO,CAAC,EAAE,MAAM,EACA,MAAM,GAAE,MAAY,EACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA,EACjC,IAAI,CAAC,EAAE,MAAM,YAAA,EAQ9B;IAED,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,QAAQ,CAEvC;IAED,MAAM,IAAI,aAAa,CAStB;CACF;AAED,qCAAqC;AACrC,wBAAgB,QAAQ,CAAC,OAAO,SAAc,GAAG,KAAK,CAErD;AAED,6EAA6E;AAC7E,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,KAAK,CAEpF;AAED,wCAAwC;AACxC,wBAAgB,YAAY,CAAC,OAAO,SAAiB,GAAG,KAAK,CAE5D;AAED,qCAAqC;AACrC,wBAAgB,SAAS,CAAC,OAAO,SAAc,GAAG,KAAK,CAEtD;AAED,0EAA0E;AAC1E,wBAAgB,QAAQ,CAAC,OAAO,SAAa,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,KAAK,CAEvF;AAED,wCAAwC;AACxC,wBAAgB,WAAW,CAAC,OAAO,SAAsB,GAAG,KAAK,CAEhE;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;CAUE,CAAC;AAEnC,mFAAmF;AACnF,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,mBAAmB,CAAC;AAE/D,iEAAiE;AACjE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,eAAe,CAEvE;AAED,+FAA+F;AAC/F,wBAAgB,QAAQ,CACtB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,KAAK,CAOP"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/contract/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE;QACL,2CAA2C;QAC3C,IAAI,EAAE,MAAM,CAAC;QACb,8BAA8B;QAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,gCAAgC;QAChC,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,0BAA0B;QAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAcD;;;;GAIG;AACH,qBAAa,QAAQ,CACnB,KAAK,SAAS,MAAM,GAAG,MAAM,EAC7B,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAC1F,SAAQ,KAAK;aAEK,IAAI,EAAE,KAAK;aAEX,MAAM,EAAE,MAAM;aACd,OAAO,CAAC,EAAE,QAAQ;aAClB,IAAI,CAAC,EAAE,MAAM;IAL/B,YACkB,IAAI,EAAE,KAAK,EAC3B,OAAO,CAAC,EAAE,MAAM,EACA,MAAM,GAAE,MAAY,EACpB,OAAO,CAAC,EAAE,QAAQ,YAAA,EAClB,IAAI,CAAC,EAAE,MAAM,YAAA,EAQ9B;IAED,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,QAAQ,CAEvC;IAED,MAAM,IAAI,aAAa,CAStB;CACF;AAED,qCAAqC;AACrC,wBAAgB,QAAQ,CAAC,OAAO,SAAc,GAAG,KAAK,CAErD;AAED,6EAA6E;AAC7E,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,KAAK,CAEpF;AAED,wCAAwC;AACxC,wBAAgB,YAAY,CAAC,OAAO,SAAiB,GAAG,KAAK,CAE5D;AAED,qCAAqC;AACrC,wBAAgB,SAAS,CAAC,OAAO,SAAc,GAAG,KAAK,CAEtD;AAED,0EAA0E;AAC1E,wBAAgB,QAAQ,CAAC,OAAO,SAAa,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,KAAK,CAEvF;AAED,wCAAwC;AACxC,wBAAgB,WAAW,CAAC,OAAO,SAAsB,GAAG,KAAK,CAEhE;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;CAUE,CAAC;AAEnC,mFAAmF;AACnF,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,mBAAmB,CAAC;AAE/D,iEAAiE;AACjE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,eAAe,CAEvE;AAED,+FAA+F;AAC/F,wBAAgB,QAAQ,CACtB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,KAAK,CAOP"}

package/dist/contract/index.d.ts

@@ -1,6 +1,6 @@
 export { ALL_TRANSPORTS, type BodyHttpSuccessStatus, type ContractDef, type ContractMeta, defineContract, type EndpointDef, type EndpointFn, type EndpointResponseMeta, type EndpointToolAnnotations, type EndpointUiMeta, type FileDescriptor, type HandlerContext, type HeadEndpointDef, type HttpMethod, type HttpSuccessStatus, type MultipartFile, type ResponseMetadata, type RuntimeContext, type ScopedEndpointFn, type ScopedHttpClient, type ScopedUrlBuilder, type ScopedUrlFn, type Transport, type TransportSource, type TypedClient, type TypedHttpClient, type TypedUrlBuilder, } from './define';
 export { AppError, appError, badRequest, conflict, type ErrorEnvelope, forbidden, isStitchErrorCode, notFound, rateLimited, STITCH_ERROR_STATUS, type StitchErrorCode, unauthorized, } from './errors';
-export { type DefinedErrors, defineErrors, type ErrorThrower, } from './errors-factory';
+export { type DefinedAppError, type DefinedErrors, defineErrors, type ErrorDefinition, type ErrorDefinitions, type ErrorDetailsOutput, type ErrorDetailsSchema, type ErrorFactories, type ErrorFactory, type ErrorFactoryArguments, type FrozenErrorDefinitions, } from './errors-factory';
 export { createContractFactory, type ScopedDefineContract } from './factory';
 export { decodeCursor, encodeCursor, type Paginated, paginatedSchema, } from './pagination';
 //# sourceMappingURL=index.d.ts.map

package/dist/contract/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contract/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,KAAK,qBAAqB,EAC1B,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,cAAc,EACd,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC5B,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,eAAe,GACrB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,KAAK,aAAa,EAClB,SAAS,EACT,iBAAiB,EACjB,QAAQ,EACR,WAAW,EACX,mBAAmB,EACnB,KAAK,eAAe,EACpB,YAAY,GACb,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,KAAK,aAAa,EAClB,YAAY,EACZ,KAAK,YAAY,GAClB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,qBAAqB,EAAE,KAAK,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAE7E,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,KAAK,SAAS,EACd,eAAe,GAChB,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contract/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,KAAK,qBAAqB,EAC1B,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,cAAc,EACd,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC5B,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,eAAe,GACrB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,KAAK,aAAa,EAClB,SAAS,EACT,iBAAiB,EACjB,QAAQ,EACR,WAAW,EACX,mBAAmB,EACnB,KAAK,eAAe,EACpB,YAAY,GACb,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,YAAY,EACZ,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,GAC5B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,qBAAqB,EAAE,KAAK,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAE7E,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,KAAK,SAAS,EACd,eAAe,GAChB,MAAM,cAAc,CAAC"}

package/dist/contract/index.js

@@ -16,8 +16,8 @@ import {
   paginatedSchema,
   rateLimited,
   unauthorized
-} from "../index-xax049k6.js";
-import"../index-809wc1tt.js";
+} from "../index-11x5dts2.js";
+import"../index-s4qsmgwe.js";
 export {
   unauthorized,
   rateLimited,

package/dist/{index-xax049k6.js → index-11x5dts2.js}

@@ -1,6 +1,6 @@
 import {
-  mapObject
-} from "./index-809wc1tt.js";
+  mapObjectTypeBoundary
+} from "./index-s4qsmgwe.js";
 
 // src/contract/define.ts
 import { z } from "zod";
@@ -237,17 +237,48 @@ function appError(code, message, details) {
   throw new AppError(code, message, isStitchErrorCode(code) ? STITCH_ERROR_STATUS[code] : 500, details);
 }
 // src/contract/errors-factory.ts
-function defineErrors(defs) {
-  const errors = mapObject(defs, (code, status) => (message, details, hint) => {
-    throw new AppError(String(code), message, status, details, hint);
+import { z as z2 } from "zod";
+function isErrorDetailsSchema(value) {
+  return value instanceof z2.ZodObject || value instanceof z2.ZodOptional && value.unwrap() instanceof z2.ZodObject;
+}
+function validateDefinition(code, definition) {
+  if (!Number.isInteger(definition.status) || definition.status < 400 || definition.status > 599) {
+    throw new Error(`[stitchkit] Error "${code}" must declare an integer HTTP status from 400 to 599`);
+  }
+  if (definition.details !== undefined && !isErrorDetailsSchema(definition.details)) {
+    throw new Error(`[stitchkit] Error "${code}" details must be a Zod object or optional Zod object`);
+  }
+}
+function defineErrors(source) {
+  const definitions = mapObjectTypeBoundary(source, (code, definition) => {
+    const name = String(code);
+    validateDefinition(name, definition);
+    return Object.freeze({ ...definition });
   });
-  const codes = mapObject(defs, (code) => code);
-  const known = new Set(Object.keys(defs));
-  return {
+  Object.freeze(definitions);
+  const errors = mapObjectTypeBoundary(definitions, (code, definition) => {
+    const name = String(code);
+    return (options = {}) => {
+      if (definition.details === undefined) {
+        if ("details" in options) {
+          throw new Error(`[stitchkit] Error "${name}" does not declare details`);
+        }
+        return new AppError(name, options.message, definition.status, undefined, options.hint);
+      }
+      const details = definition.details.parse(options.details);
+      return new AppError(name, options.message, definition.status, details, options.hint);
+    };
+  });
+  Object.freeze(errors);
+  const codes = mapObjectTypeBoundary(definitions, (code) => String(code));
+  Object.freeze(codes);
+  const known = new Set(Object.keys(definitions));
+  return Object.freeze({
     errors,
     codes,
+    definitions,
     isCode: (code) => known.has(code)
-  };
+  });
 }
 // src/contract/factory.ts
 function createContractFactory() {
@@ -262,7 +293,7 @@ function createContractFactory() {
   };
 }
 // src/contract/pagination.ts
-import { z as z2 } from "zod";
+import { z as z3 } from "zod";
 
 // src/internal/base64url.ts
 function bytesToBase64Url(bytes) {
@@ -282,9 +313,9 @@ function base64UrlToBytes(segment) {
 
 // src/contract/pagination.ts
 function paginatedSchema(itemSchema) {
-  return z2.object({
-    items: z2.array(itemSchema),
-    nextCursor: z2.string().nullable()
+  return z3.object({
+    items: z3.array(itemSchema),
+    nextCursor: z3.string().nullable()
   });
 }
 function toBase64Url(str) {

package/dist/{index-4e1c0hsw.js → index-181aebw8.js}

@@ -28,7 +28,7 @@ import {
   setRequestError,
   typedEntries,
   validateDeclaredOutput
-} from "./index-sc67e454.js";
+} from "./index-gex6gxhe.js";
 
 // src/server/multipart.ts
 var DEFAULT_MAX_UPLOAD_BYTES = 25 * 1024 * 1024;

package/dist/{index-dnkefke9.js → index-310bfer5.js}

@@ -6,7 +6,7 @@ import {
   isUnsafeKey,
   safeJsonParse,
   unauthorized
-} from "./index-sc67e454.js";
+} from "./index-gex6gxhe.js";
 
 // src/server/middleware/cookies.ts
 function parseCookies(header) {

package/dist/{index-sc67e454.js → index-gex6gxhe.js}

@@ -121,6 +121,9 @@ function mergeMeta(contractMeta, endpointMeta) {
     return { ...contractMeta };
   return { ...contractMeta, ...endpointMeta };
 }
+// src/contract/errors-factory.ts
+import { z as z2 } from "zod";
+
 // src/internal/typed.ts
 function typedEntries(value) {
   return Object.entries(value);
@@ -129,7 +132,7 @@ function isRecord(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 // src/contract/pagination.ts
-import { z as z2 } from "zod";
+import { z as z3 } from "zod";
 
 // src/internal/base64url.ts
 function bytesToBase64Url(bytes) {
@@ -147,7 +150,7 @@ function base64UrlToBytes(segment) {
   return Uint8Array.from(atob(padded), (c) => c.charCodeAt(0));
 }
 // src/internal/errors.ts
-import { z as z3 } from "zod";
+import { z as z4 } from "zod";
 function issuePath(path) {
   return path.length > 0 ? path.map(String).join(".") : "(root)";
 }
@@ -170,7 +173,7 @@ var MAX_DETAIL_ISSUES = 20;
 function errorCode(err) {
   if (AppError.is(err))
     return err.code;
-  if (err instanceof z3.ZodError)
+  if (err instanceof z4.ZodError)
     return "VALIDATION_ERROR";
   return;
 }
@@ -186,7 +189,7 @@ function recordedErrorMessage(code, envelopeMessage, thrown) {
 function normalizeError(err) {
   if (AppError.is(err))
     return err;
-  if (err instanceof z3.ZodError) {
+  if (err instanceof z4.ZodError) {
     return new AppError("VALIDATION_ERROR", formatZodError(err), 400, {
       issues: zodIssues(err).slice(0, MAX_DETAIL_ISSUES)
     });

package/dist/{index-ncqqn1bc.js → index-p9vkwns1.js}

@@ -17,7 +17,7 @@ import {
   runWithRequestContext,
   safeJsonParse,
   validateDeclaredOutput
-} from "./index-sc67e454.js";
+} from "./index-gex6gxhe.js";
 
 // src/tools/coerce.ts
 import { z } from "zod";
@@ -717,7 +717,7 @@ function toToolName(serviceName, methodName) {
 }
 function assertUniqueToolName(name, taken, surface) {
   if (taken) {
-    throw new Error(`Duplicate ${surface} "${name}" across mounted services`);
+    throw new Error(`Duplicate ${surface} "${name}" across mounted operations`);
   }
 }
 

package/dist/{index-809wc1tt.js → index-s4qsmgwe.js}

@@ -14,5 +14,8 @@ function mapObject(source, mapper) {
   }
   return result;
 }
+function mapObjectTypeBoundary(source, mapper) {
+  return mapObject(source, (key, value) => mapper(key, value));
+}
 
-export { typedEntries, isRecord, mapObject };
+export { typedEntries, isRecord, mapObject, mapObjectTypeBoundary };

package/dist/index.js

@@ -17,12 +17,12 @@ import {
   parseTrailingWildcard,
   rateLimited,
   unauthorized
-} from "./index-xax049k6.js";
+} from "./index-11x5dts2.js";
 import {
   isRecord,
   mapObject,
   typedEntries
-} from "./index-809wc1tt.js";
+} from "./index-s4qsmgwe.js";
 
 // src/browser/client-multipart.ts
 function isFileDescriptor(value) {

package/dist/internal/typed.d.ts

@@ -6,4 +6,12 @@ export declare function isRecord(value: unknown): value is Record<string, unknow
 export declare function mapObject<TSource extends object, TResult extends {
     [K in keyof TSource]?: unknown;
 }>(source: TSource, mapper: <K extends keyof TSource>(key: K, value: TSource[K]) => TResult[K] | undefined): TResult;
+/**
+ * Dynamic key-wise factory bridge. Use when runtime construction preserves a
+ * mapped type's key/value relation but TypeScript cannot express the dependent
+ * callback return. The assertion is intentionally isolated at this boundary.
+ */
+export declare function mapObjectTypeBoundary<TSource extends object, TResult extends {
+    [K in keyof TSource]?: unknown;
+}>(source: TSource, mapper: (key: keyof TSource, value: TSource[keyof TSource]) => unknown): TResult;
 //# sourceMappingURL=typed.d.ts.map

package/dist/internal/typed.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"typed.d.ts","sourceRoot":"","sources":["../../src/internal/typed.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,EAC3C,KAAK,EAAE,CAAC,GACP,KAAK,CAAC;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAE/C;AAED,4EAA4E;AAC5E,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED,wBAAgB,SAAS,CACvB,OAAO,SAAS,MAAM,EACtB,OAAO,SAAS;KAAG,CAAC,IAAI,MAAM,OAAO,CAAC,CAAC,EAAE,OAAO;CAAE,EAElD,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,SAAS,GACrF,OAAO,CAOT"}
+{"version":3,"file":"typed.d.ts","sourceRoot":"","sources":["../../src/internal/typed.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,EAC3C,KAAK,EAAE,CAAC,GACP,KAAK,CAAC;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAE/C;AAED,4EAA4E;AAC5E,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED,wBAAgB,SAAS,CACvB,OAAO,SAAS,MAAM,EACtB,OAAO,SAAS;KAAG,CAAC,IAAI,MAAM,OAAO,CAAC,CAAC,EAAE,OAAO;CAAE,EAElD,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,SAAS,GACrF,OAAO,CAOT;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,SAAS,MAAM,EACtB,OAAO,SAAS;KAAG,CAAC,IAAI,MAAM,OAAO,CAAC,CAAC,EAAE,OAAO;CAAE,EAElD,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,OAAO,CAAC,KAAK,OAAO,GACrE,OAAO,CAKT"}

package/dist/node.js

@@ -3,7 +3,7 @@ import {
   createImplement,
   createSocketIOServer,
   implement
-} from "./index-4e1c0hsw.js";
+} from "./index-181aebw8.js";
 import"./index-6jypn22c.js";
 import"./index-x3fcszf8.js";
 import {
@@ -15,7 +15,7 @@ import {
   notFound,
   rateLimited,
   unauthorized
-} from "./index-sc67e454.js";
+} from "./index-gex6gxhe.js";
 // src/server/node.ts
 import { serve } from "srvx";
 async function serveNode(config) {

package/dist/observability/index.js

@@ -16,7 +16,7 @@ import {
   setRequestError,
   setRequestUser,
   wrapInRequestContext
-} from "../index-sc67e454.js";
+} from "../index-gex6gxhe.js";
 
 // src/observability/sanitize.ts
 var DEFAULT_SENSITIVE_KEYS = /(password|passwd|pwd|secret|token|apikey|api[-_ ]?key|auth|authorization|bearer|session|cookie|init[-_ ]?data|credential|private[-_ ]?key)/i;

package/dist/react.js

@@ -1,6 +1,6 @@
 import {
   isRecord
-} from "./index-809wc1tt.js";
+} from "./index-s4qsmgwe.js";
 
 // src/react/cache-bridge.ts
 function createCacheBridge(config) {

package/dist/server/error-hook.d.ts

@@ -33,7 +33,7 @@
  */
 import type { RuntimeContext } from '../contract';
 import { type StitchErrorCode } from '../contract';
-import type { LifecycleHooks } from './types';
+import type { LifecycleHooks, MethodDef } from './types';
 /** The normalised error handed to `render` — code already remapped. */
 export interface ResolvedError {
     /** Wire code — the app code from `codeMap` for a stitch error, else the thrown code. */
@@ -62,9 +62,13 @@ export interface ErrorHookConfig<TWireCode extends string = string> {
      * in the envelope, which is the ordinary reason to have one. Declaring the
      * parameter is optional: a one-argument `render` stays assignable.
      */
-    render: (info: ResolvedError, ctx: RuntimeContext) => unknown;
-    /** Observe the raw thrown value before rendering — logging / metrics. */
-    onError?: (error: unknown, info: ResolvedError, ctx: RuntimeContext) => void;
+    render: (info: ResolvedError, ctx: RuntimeContext, endpoint?: MethodDef) => unknown | Promise<unknown>;
+    /**
+     * Observe the raw thrown value before rendering — logging, metrics or
+     * asynchronous request attribution. The matched endpoint is absent for
+     * failures that happen before the router resolves an operation.
+     */
+    onError?: (error: unknown, info: ResolvedError, ctx: RuntimeContext, endpoint?: MethodDef) => unknown | Promise<unknown>;
 }
 /** Build an `onError` hook from a code map + envelope renderer. */
 export declare function createErrorHook<TWireCode extends string = string>(config: ErrorHookConfig<TWireCode>): NonNullable<LifecycleHooks['onError']>;

package/dist/server/error-hook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-hook.d.ts","sourceRoot":"","sources":["../../src/server/error-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAqB,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAEtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,uEAAuE;AACvE,MAAM,WAAW,aAAa;IAC5B,wFAAwF;IACxF,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,+FAA+F;IAC/F,OAAO,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,6DAA6D;IAC7D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,oCAAoC;AACpC,MAAM,WAAW,eAAe,CAAC,SAAS,SAAS,MAAM,GAAG,MAAM;IAChE;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC;IAC7C,uDAAuD;IACvD;;;;;OAKG;IACH,MAAM,EAAE,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC;IAC9D,yEAAyE;IACzE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE,cAAc,KAAK,IAAI,CAAC;CAC9E;AAED,mEAAmE;AACnE,wBAAgB,eAAe,CAAC,SAAS,SAAS,MAAM,GAAG,MAAM,EAC/D,MAAM,EAAE,eAAe,CAAC,SAAS,CAAC,GACjC,WAAW,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAyBxC"}
+{"version":3,"file":"error-hook.d.ts","sourceRoot":"","sources":["../../src/server/error-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAqB,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAEtE,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzD,uEAAuE;AACvE,MAAM,WAAW,aAAa;IAC5B,wFAAwF;IACxF,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,+FAA+F;IAC/F,OAAO,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,6DAA6D;IAC7D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,oCAAoC;AACpC,MAAM,WAAW,eAAe,CAAC,SAAS,SAAS,MAAM,GAAG,MAAM;IAChE;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC;IAC7C,uDAAuD;IACvD;;;;;OAKG;IACH,MAAM,EAAE,CACN,IAAI,EAAE,aAAa,EACnB,GAAG,EAAE,cAAc,EACnB,QAAQ,CAAC,EAAE,SAAS,KACjB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC;;;;OAIG;IACH,OAAO,CAAC,EAAE,CACR,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,aAAa,EACnB,GAAG,EAAE,cAAc,EACnB,QAAQ,CAAC,EAAE,SAAS,KACjB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACjC;AAED,mEAAmE;AACnE,wBAAgB,eAAe,CAAC,SAAS,SAAS,MAAM,GAAG,MAAM,EAC/D,MAAM,EAAE,eAAe,CAAC,SAAS,CAAC,GACjC,WAAW,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CA0BxC"}

package/dist/server/index.js

@@ -9,7 +9,7 @@ import {
   socketIoLane,
   staticRoute,
   webSocketLane
-} from "../index-4e1c0hsw.js";
+} from "../index-181aebw8.js";
 import {
   createAuthHook,
   createBearerResolver,
@@ -22,7 +22,7 @@ import {
   signJwt,
   verifyJwt,
   verifyPkce
-} from "../index-dnkefke9.js";
+} from "../index-310bfer5.js";
 import {
   DEFAULT_CORS_ALLOW_HEADERS,
   DEFAULT_CORS_EXPOSE_HEADERS,
@@ -59,7 +59,7 @@ import {
   resolveTraceId,
   unauthorized,
   zodIssues
-} from "../index-sc67e454.js";
+} from "../index-gex6gxhe.js";
 // src/server/bun.ts
 function createServer(config) {
   const { routes, websocket, development, bun: bunExtra, port = 3000, hostname } = config;
@@ -140,7 +140,7 @@ function cacheHeaders(maxAge, scope = "public") {
 }
 // src/server/error-hook.ts
 function createErrorHook(config) {
-  return (ctx, error) => {
+  return async (ctx, error, endpoint) => {
     const appErr = normalizeError(error);
     const code = config.codeMap && isStitchErrorCode(appErr.code) ? config.codeMap[appErr.code] : appErr.code;
     const info = {
@@ -150,8 +150,9 @@ function createErrorHook(config) {
       details: appErr.details,
       hint: appErr.hint
     };
-    config.onError?.(error, info, ctx);
-    return new Response(JSON.stringify(config.render(info, ctx)), {
+    await config.onError?.(error, info, ctx, endpoint);
+    const body = await config.render(info, ctx, endpoint);
+    return new Response(JSON.stringify(body), {
       status: info.status,
       headers: { "content-type": "application/json" }
     });

package/dist/tools/agent.d.ts

@@ -2,7 +2,7 @@ import type { ToolSet } from 'ai';
 import type { ServiceDef } from '../server/types';
 import { type ErrorHintFn, type ToolCallHooks, type ToolLifecycle } from './execute';
 import { type ToolExtend } from './mount';
-import { type RuntimeToolDefinition } from './runtime-tool';
+import type { RuntimeToolDefinition } from './runtime-tool';
 export interface AgentContext {
     [key: string]: unknown;
 }

package/dist/tools/agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/tools/agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAGlC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,aAAa,EAEnB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAmD,KAAK,UAAU,EAAE,MAAM,SAAS,CAAC;AAE3F,OAAO,EACL,KAAK,qBAAqB,EAG3B,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,YAAY;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,qCAAqC;IACrC,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB;;;;OAIG;IACH,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,+EAA+E;IAC/E,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,mEAAmE;IACnE,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAC5D,+EAA+E;IAC/E,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,gEAAgE;IAChE,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,2EAA2E;IAC3E,YAAY,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;CACjD;AAED,wBAAgB,UAAU,CACxB,QAAQ,EAAE,UAAU,GAAG,UAAU,EAAE,EACnC,MAAM,GAAE,gBAAqB,GAC5B,OAAO,CAuGT"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/tools/agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAGlC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,aAAa,EAEnB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAqC,KAAK,UAAU,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAG5D,MAAM,WAAW,YAAY;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,qCAAqC;IACrC,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB;;;;OAIG;IACH,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,+EAA+E;IAC/E,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,mEAAmE;IACnE,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAC5D,+EAA+E;IAC/E,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,gEAAgE;IAChE,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,2EAA2E;IAC3E,YAAY,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;CACjD;AAED,wBAAgB,UAAU,CACxB,QAAQ,EAAE,UAAU,GAAG,UAAU,EAAE,EACnC,MAAM,GAAE,gBAAqB,GAC5B,OAAO,CAwET"}

package/dist/tools/list-names.d.ts

@@ -7,13 +7,15 @@
  * consumer's build instead. Also the mechanical "what changed" diff when
  * migrating a service between contract shapes.
  *
- * Built on `collectTools`, the exact resolver `mountMcp` / `mountAgent` /
- * `createCli` use — the listing can never drift from what actually mounts.
+ * Built on the mixed-surface collector used by the mounts — the listing cannot
+ * drift when pathless runtime tools sit beside contract operations.
  */
 import type { Transport } from '../contract';
-import type { ServiceDef } from '../server/types';
+import { type ToolSurfaceDefinition } from './surface';
 /** One mounted tool name and where it comes from. */
 export interface ToolNameEntry {
+    /** Whether the operation comes from a contract or a pathless runtime definition. */
+    kind: 'contract' | 'runtime';
     /** Final tool name — the `toolName` override, else derived from service + method. */
     name: string;
     /** Owning service (`ServiceDef.name` — the contract's prefix). */
@@ -24,11 +26,11 @@ export interface ToolNameEntry {
     transports: Transport[];
 }
 /**
- * Resolve every tool name the given services expose, sorted by name (then
- * service) — a stable shape to snapshot. Multipart and raw-response endpoints
+ * Resolve every tool name the surface exposes, sorted by name (then service) —
+ * a stable shape to snapshot. Multipart and raw-response endpoints
  * are absent
  * (never mounted as tools) and CLI appears only where `expose` opts in,
  * mirroring the real mounts.
  */
-export declare function listToolNames(services: ServiceDef[]): ToolNameEntry[];
+export declare function listToolNames(surface: ToolSurfaceDefinition): ToolNameEntry[];
 //# sourceMappingURL=list-names.d.ts.map

package/dist/tools/list-names.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-names.d.ts","sourceRoot":"","sources":["../../src/tools/list-names.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAGlD,qDAAqD;AACrD,MAAM,WAAW,aAAa;IAC5B,qFAAqF;IACrF,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf,6EAA6E;IAC7E,UAAU,EAAE,SAAS,EAAE,CAAC;CACzB;AAID;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,aAAa,EAAE,CA2BrE"}
+{"version":3,"file":"list-names.d.ts","sourceRoot":"","sources":["../../src/tools/list-names.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAEL,KAAK,qBAAqB,EAE3B,MAAM,WAAW,CAAC;AAEnB,qDAAqD;AACrD,MAAM,WAAW,aAAa;IAC5B,oFAAoF;IACpF,IAAI,EAAE,UAAU,GAAG,SAAS,CAAC;IAC7B,qFAAqF;IACrF,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf,6EAA6E;IAC7E,UAAU,EAAE,SAAS,EAAE,CAAC;CACzB;AAID;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,qBAAqB,GAAG,aAAa,EAAE,CA6B7E"}

package/dist/tools/manifest.d.ts

@@ -1,17 +1,25 @@
-import type { MountableTool } from './mount';
+import type { CollectToolsConfig } from './mount';
+import type { RuntimeToolTransport } from './runtime-tool';
+import { type ToolSurfaceDefinition } from './surface';
 export interface ToolManifestEntry {
     name: string;
     description: string;
     inputSchema: Record<string, unknown>;
 }
+export interface ToolManifestConfig extends ToolSurfaceDefinition {
+    /** Model-facing surface whose exposure rules the manifest must mirror. */
+    transport: RuntimeToolTransport;
+    extend?: CollectToolsConfig['extend'];
+    flattenUnionInput?: boolean;
+}
 /**
- * Build a searchable manifest from collected tools — name, description and
- * JSON Schema for each. Use it to power a `tool_search` native tool: the app
- * decides the search algorithm and the unlock mechanism.
+ * Build a searchable manifest from the complete contract/runtime surface —
+ * name, description and JSON Schema for each. Use it to power a `tool_search`
+ * tool: the app decides the search algorithm and the unlock mechanism.
  *
  * A tool whose schema cannot be represented as JSON Schema still appears —
  * with an empty `inputSchema` — so it stays discoverable by name / description
  * rather than crashing the whole manifest.
  */
-export declare function buildToolManifest(tools: MountableTool[]): ToolManifestEntry[];
+export declare function buildToolManifest(config: ToolManifestConfig): ToolManifestEntry[];
 //# sourceMappingURL=manifest.d.ts.map