@lostgradient/weft 0.11.0 → 0.13.0

package/dist/cli/generated/operation-client.generated.d.ts

@@ -1,7 +1,25 @@
 import { type CatalogWeftClient, type WeftClientConnection } from '../operation-client-runtime.ts';
-export declare const CATALOG_OPERATION_NAMES: readonly ["weft.activities.complete", "weft.activities.fail", "weft.recover.all", "weft.retention.get", "weft.reviews.decision.submit", "weft.reviews.get", "weft.reviews.list", "weft.schedules.cancel", "weft.schedules.create", "weft.schedules.get", "weft.schedules.list", "weft.schedules.pause", "weft.schedules.resume", "weft.schedules.update", "weft.system.metrics", "weft.system.registry", "weft.task.queues.list", "weft.tasks.diagnostics", "weft.updates.result.get", "weft.worker.deployments.drain", "weft.worker.deployments.resume", "weft.workers.drain", "weft.workers.list", "weft.workers.resume", "weft.workflows.aggregate", "weft.workflows.attributes.get", "weft.workflows.attributes.set", "weft.workflows.bulk.cancel", "weft.workflows.bulk.delete", "weft.workflows.bulk.retryfailed", "weft.workflows.bulk.signal", "weft.workflows.bulk.tags", "weft.workflows.cancel", "weft.workflows.checkpoints.get", "weft.workflows.checkpoints.list", "weft.workflows.events.list", "weft.workflows.fork", "weft.workflows.get", "weft.workflows.list", "weft.workflows.purge", "weft.workflows.query", "weft.workflows.replay", "weft.workflows.result.get", "weft.workflows.resume", "weft.workflows.signal", "weft.workflows.start", "weft.workflows.startorsignal", "weft.workflows.streams.chunks", "weft.workflows.suspend", "weft.workflows.tags.add", "weft.workflows.tags.remove", "weft.workflows.timeline.get", "weft.workflows.timeout", "weft.workflows.update"];
+export declare const CATALOG_OPERATION_NAMES: readonly ["weft.activities.complete", "weft.activities.fail", "weft.recover.all", "weft.retention.get", "weft.reviews.decision.submit", "weft.reviews.get", "weft.reviews.list", "weft.schedules.cancel", "weft.schedules.create", "weft.schedules.get", "weft.schedules.list", "weft.schedules.pause", "weft.schedules.resume", "weft.schedules.update", "weft.storage.capabilities", "weft.system.lease", "weft.system.metrics", "weft.system.registry", "weft.task.queues.list", "weft.tasks.diagnostics", "weft.updates.result.get", "weft.worker.deployments.drain", "weft.worker.deployments.resume", "weft.workers.drain", "weft.workers.list", "weft.workers.resume", "weft.workflows.activities.pending.list", "weft.workflows.aggregate", "weft.workflows.attributes.get", "weft.workflows.attributes.set", "weft.workflows.bulk.cancel", "weft.workflows.bulk.delete", "weft.workflows.bulk.retryfailed", "weft.workflows.bulk.signal", "weft.workflows.bulk.tags", "weft.workflows.cancel", "weft.workflows.checkpoints.get", "weft.workflows.checkpoints.list", "weft.workflows.events.list", "weft.workflows.finalizer.get", "weft.workflows.fork", "weft.workflows.get", "weft.workflows.list", "weft.workflows.purge", "weft.workflows.query", "weft.workflows.replay", "weft.workflows.result.get", "weft.workflows.resume", "weft.workflows.scheduleprovenance.get", "weft.workflows.signal", "weft.workflows.start", "weft.workflows.startorsignal", "weft.workflows.streams.chunks", "weft.workflows.suspend", "weft.workflows.tags.add", "weft.workflows.tags.remove", "weft.workflows.timeline.get", "weft.workflows.timeout", "weft.workflows.update"];
 export type CatalogOperationName = (typeof CATALOG_OPERATION_NAMES)[number];
-type SharedAttributesBulkConcurrenc_73ecbca6 = {
+export declare const CLIENT_OPERATION_NAMES: readonly ["weft.activities.complete", "weft.activities.fail", "weft.recover.all", "weft.retention.get", "weft.reviews.decision.submit", "weft.reviews.get", "weft.reviews.list", "weft.schedules.cancel", "weft.schedules.create", "weft.schedules.get", "weft.schedules.list", "weft.schedules.pause", "weft.schedules.resume", "weft.schedules.update", "weft.storage.capabilities", "weft.system.lease", "weft.system.metrics", "weft.system.registry", "weft.task.queues.list", "weft.tasks.diagnostics", "weft.tasks.diagnostics.deadletters.clear", "weft.updates.result.get", "weft.worker.deployments.drain", "weft.worker.deployments.resume", "weft.workers.drain", "weft.workers.list", "weft.workers.resume", "weft.workflows.activities.pending.list", "weft.workflows.aggregate", "weft.workflows.attributes.get", "weft.workflows.attributes.set", "weft.workflows.bulk.cancel", "weft.workflows.bulk.delete", "weft.workflows.bulk.retryfailed", "weft.workflows.bulk.signal", "weft.workflows.bulk.tags", "weft.workflows.cancel", "weft.workflows.checkpoints.get", "weft.workflows.checkpoints.list", "weft.workflows.events.list", "weft.workflows.finalizer.get", "weft.workflows.fork", "weft.workflows.get", "weft.workflows.list", "weft.workflows.purge", "weft.workflows.query", "weft.workflows.replay", "weft.workflows.result.get", "weft.workflows.resume", "weft.workflows.scheduleprovenance.get", "weft.workflows.signal", "weft.workflows.start", "weft.workflows.startorsignal", "weft.workflows.streams.chunks", "weft.workflows.suspend", "weft.workflows.tags.add", "weft.workflows.tags.remove", "weft.workflows.timeline.get", "weft.workflows.timeout", "weft.workflows.update"];
+export type ClientOperationName = (typeof CLIENT_OPERATION_NAMES)[number];
+export declare const CLIENT_REST_OPERATION_BINDINGS: {
+    readonly 'weft.tasks.diagnostics.deadletters.clear': {
+        readonly method: "DELETE";
+        readonly path: "/tasks/diagnostics/dead-letter/:operationId";
+        readonly inputSources: {
+            readonly operationId: {
+                readonly kind: "path";
+                readonly pathParam: "operationId";
+            };
+        };
+        readonly success: {
+            readonly kind: "json";
+            readonly status: 200;
+        };
+    };
+};
+type SharedAttributesBulkConcurrenc_f62debcf = {
     readonly attributes?: ReadonlyArray<SharedGtGteKey_896a0c41>;
     readonly bulkConcurrency?: number;
     readonly confirmationToken?: string;
@@ -12,13 +30,16 @@ type SharedAttributesBulkConcurrenc_73ecbca6 = {
     readonly idPrefix?: string;
     readonly limit?: number;
     readonly offset?: number;
+    readonly parentWorkflowExecutionToken?: string;
+    readonly parentWorkflowId?: string;
     readonly requestId?: string;
+    readonly scheduleId?: string;
     readonly status?: unknown;
     readonly tags?: ReadonlyArray<string>;
     readonly type?: string;
     readonly updatedAt?: SharedGtGteLt_d9a61361;
 };
-type SharedAttributesCreatedAtExecu_c9ba5dc6 = {
+type SharedAttributesCreatedAtExecu_2af7f9ff = {
     readonly attributes?: ReadonlyArray<SharedGtGteKey_896a0c41>;
     readonly createdAt?: SharedGtGteLt_d9a61361;
     readonly executionDeadline?: SharedGtGteLt_d9a61361;
@@ -26,6 +47,9 @@ type SharedAttributesCreatedAtExecu_c9ba5dc6 = {
     readonly idPrefix?: string;
     readonly limit?: number;
     readonly offset?: number;
+    readonly parentWorkflowExecutionToken?: string;
+    readonly parentWorkflowId?: string;
+    readonly scheduleId?: string;
     readonly status?: unknown;
     readonly tags?: ReadonlyArray<string>;
     readonly type?: string;
@@ -45,7 +69,7 @@ type SharedGtGteLt_d9a61361 = {
     readonly lt?: number;
     readonly lte?: number;
 };
-export type CatalogOperationTypes = {
+export type ClientOperationTypes = {
     'weft.activities.complete': {
         readonly input: {
             readonly result?: unknown;
@@ -87,6 +111,7 @@ export type CatalogOperationTypes = {
             readonly feedback?: unknown;
             readonly reviewId: string;
             readonly reviewer?: unknown;
+            readonly sectionDecisions?: unknown;
             readonly workflowId?: unknown;
         };
         readonly output: {
@@ -170,12 +195,43 @@ export type CatalogOperationTypes = {
     };
     'weft.schedules.update': {
         readonly input: {
+            readonly backfill?: unknown;
             readonly cronExpression?: unknown;
+            readonly description?: unknown;
             readonly every?: unknown;
+            readonly jitter?: unknown;
+            readonly overlap?: unknown;
             readonly scheduleId: string;
         };
         readonly output: null;
-        readonly faults: 'Conflict' | 'NotFound';
+        readonly faults: 'Conflict' | 'InvalidParams' | 'NotFound';
+    };
+    'weft.storage.capabilities': {
+        readonly input: {};
+        readonly output: {
+            readonly atomicBatch: boolean;
+            readonly boundedRangeDelete: boolean;
+            readonly conditionalBatch: boolean;
+            readonly persistence: 'ephemeral' | 'local' | 'remote';
+            readonly readAfterWrite: 'linearizable' | 'session' | 'eventual';
+            readonly scanConsistency: 'snapshot' | 'best-effort';
+        };
+        readonly faults: never;
+    };
+    'weft.system.lease': {
+        readonly input: {};
+        readonly output: {
+            readonly expiresAt?: number;
+            readonly fencingEpoch?: number;
+            readonly heldSince?: number;
+            readonly holderId?: string;
+            readonly holdsLease: boolean;
+            readonly lastRenewedAt?: number;
+            readonly lossReason?: 'deposed' | 'renewal-unconfirmable';
+            readonly mode: 'none' | 'lease';
+            readonly status: 'disabled' | 'healthy' | 'no-lease' | 'contested';
+        };
+        readonly faults: never;
     };
     'weft.system.metrics': {
         readonly input: {};
@@ -250,6 +306,15 @@ export type CatalogOperationTypes = {
         };
         readonly faults: never;
     };
+    'weft.tasks.diagnostics.deadletters.clear': {
+        readonly input: {
+            readonly operationId: string;
+        };
+        readonly output: {
+            readonly ok: boolean;
+        };
+        readonly faults: never;
+    };
     'weft.updates.result.get': {
         readonly input: {
             readonly updateId: string;
@@ -325,6 +390,25 @@ export type CatalogOperationTypes = {
         readonly output: unknown;
         readonly faults: 'NotFound';
     };
+    'weft.workflows.activities.pending.list': {
+        readonly input: {
+            readonly cursor?: string;
+            readonly limit: number;
+            readonly workflowId: string;
+        };
+        readonly output: {
+            readonly items: ReadonlyArray<{
+                readonly activityName: string;
+                readonly attempt: number;
+                readonly createdAt: number;
+                readonly operationId: string;
+                readonly step: number;
+                readonly token: string;
+            }>;
+            readonly nextCursor?: string;
+        };
+        readonly faults: 'InvalidParams' | 'NotFound';
+    };
     'weft.workflows.aggregate': {
         readonly input: {
             readonly attributes?: ReadonlyArray<{
@@ -341,6 +425,9 @@ export type CatalogOperationTypes = {
             readonly groupBy: unknown;
             readonly idPrefix?: string;
             readonly limit?: number;
+            readonly parentWorkflowExecutionToken?: string;
+            readonly parentWorkflowId?: string;
+            readonly scheduleId?: string;
             readonly status?: unknown;
             readonly tags?: ReadonlyArray<string>;
             readonly type?: string;
@@ -374,17 +461,17 @@ export type CatalogOperationTypes = {
         readonly faults: never;
     };
     'weft.workflows.bulk.cancel': {
-        readonly input: SharedAttributesBulkConcurrenc_73ecbca6;
+        readonly input: SharedAttributesBulkConcurrenc_f62debcf;
         readonly output: unknown;
         readonly faults: never;
     };
     'weft.workflows.bulk.delete': {
-        readonly input: SharedAttributesBulkConcurrenc_73ecbca6;
+        readonly input: SharedAttributesBulkConcurrenc_f62debcf;
         readonly output: unknown;
         readonly faults: 'Unprocessable';
     };
     'weft.workflows.bulk.retryfailed': {
-        readonly input: SharedAttributesBulkConcurrenc_73ecbca6;
+        readonly input: SharedAttributesBulkConcurrenc_f62debcf;
         readonly output: unknown;
         readonly faults: never;
     };
@@ -401,8 +488,11 @@ export type CatalogOperationTypes = {
             readonly limit?: number;
             readonly name: string;
             readonly offset?: number;
+            readonly parentWorkflowExecutionToken?: string;
+            readonly parentWorkflowId?: string;
             readonly payload?: unknown;
             readonly requestId?: string;
+            readonly scheduleId?: string;
             readonly status?: unknown;
             readonly tags?: ReadonlyArray<string>;
             readonly type?: string;
@@ -416,7 +506,7 @@ export type CatalogOperationTypes = {
             readonly bulkConcurrency?: number;
             readonly confirmationToken?: string;
             readonly dryRun?: boolean;
-            readonly filter?: SharedAttributesCreatedAtExecu_c9ba5dc6;
+            readonly filter?: SharedAttributesCreatedAtExecu_2af7f9ff;
             readonly operation: 'add' | 'remove';
             readonly requestId?: string;
             readonly tags: ReadonlyArray<string>;
@@ -453,6 +543,13 @@ export type CatalogOperationTypes = {
         readonly output: unknown;
         readonly faults: 'NotFound';
     };
+    'weft.workflows.finalizer.get': {
+        readonly input: {
+            readonly workflowId: string;
+        };
+        readonly output: unknown;
+        readonly faults: never;
+    };
     'weft.workflows.fork': {
         readonly input: {
             readonly fromStep?: unknown;
@@ -480,6 +577,9 @@ export type CatalogOperationTypes = {
             readonly include?: unknown;
             readonly limit?: number;
             readonly offset?: number;
+            readonly parentWorkflowExecutionToken?: string;
+            readonly parentWorkflowId?: string;
+            readonly scheduleId?: string;
             readonly status?: unknown;
             readonly tags?: ReadonlyArray<string>;
             readonly type?: string;
@@ -489,7 +589,7 @@ export type CatalogOperationTypes = {
         readonly faults: 'Unprocessable';
     };
     'weft.workflows.purge': {
-        readonly input: SharedAttributesCreatedAtExecu_c9ba5dc6;
+        readonly input: SharedAttributesCreatedAtExecu_2af7f9ff;
         readonly output: unknown;
         readonly faults: never;
     };
@@ -526,6 +626,13 @@ export type CatalogOperationTypes = {
         };
         readonly faults: 'Conflict' | 'NotFound';
     };
+    'weft.workflows.scheduleprovenance.get': {
+        readonly input: {
+            readonly workflowId: string;
+        };
+        readonly output: unknown;
+        readonly faults: never;
+    };
     'weft.workflows.signal': {
         readonly input: {
             readonly payload?: unknown;
@@ -644,6 +751,8 @@ export type CatalogOperationTypes = {
         readonly faults: 'Timeout' | 'Unprocessable';
     };
 };
+export type CatalogOperationTypes = Pick<ClientOperationTypes, CatalogOperationName>;
 export type WeftClient = CatalogWeftClient<CatalogOperationTypes>;
+export type ClientOperations = CatalogWeftClient<ClientOperationTypes>;
 export declare function createWeftClient(connection?: WeftClientConnection): WeftClient;
 export {};

package/dist/cli/generated/operation-client.generated.js

@@ -17,6 +17,8 @@ export const CATALOG_OPERATION_NAMES = [
   "weft.schedules.pause",
   "weft.schedules.resume",
   "weft.schedules.update",
+  "weft.storage.capabilities",
+  "weft.system.lease",
   "weft.system.metrics",
   "weft.system.registry",
   "weft.task.queues.list",
@@ -27,6 +29,7 @@ export const CATALOG_OPERATION_NAMES = [
   "weft.workers.drain",
   "weft.workers.list",
   "weft.workers.resume",
+  "weft.workflows.activities.pending.list",
   "weft.workflows.aggregate",
   "weft.workflows.attributes.get",
   "weft.workflows.attributes.set",
@@ -39,6 +42,7 @@ export const CATALOG_OPERATION_NAMES = [
   "weft.workflows.checkpoints.get",
   "weft.workflows.checkpoints.list",
   "weft.workflows.events.list",
+  "weft.workflows.finalizer.get",
   "weft.workflows.fork",
   "weft.workflows.get",
   "weft.workflows.list",
@@ -47,6 +51,7 @@ export const CATALOG_OPERATION_NAMES = [
   "weft.workflows.replay",
   "weft.workflows.result.get",
   "weft.workflows.resume",
+  "weft.workflows.scheduleprovenance.get",
   "weft.workflows.signal",
   "weft.workflows.start",
   "weft.workflows.startorsignal",
@@ -57,7 +62,75 @@ export const CATALOG_OPERATION_NAMES = [
   "weft.workflows.timeline.get",
   "weft.workflows.timeout",
   "weft.workflows.update"
-];
+], CLIENT_OPERATION_NAMES = [
+  "weft.activities.complete",
+  "weft.activities.fail",
+  "weft.recover.all",
+  "weft.retention.get",
+  "weft.reviews.decision.submit",
+  "weft.reviews.get",
+  "weft.reviews.list",
+  "weft.schedules.cancel",
+  "weft.schedules.create",
+  "weft.schedules.get",
+  "weft.schedules.list",
+  "weft.schedules.pause",
+  "weft.schedules.resume",
+  "weft.schedules.update",
+  "weft.storage.capabilities",
+  "weft.system.lease",
+  "weft.system.metrics",
+  "weft.system.registry",
+  "weft.task.queues.list",
+  "weft.tasks.diagnostics",
+  "weft.tasks.diagnostics.deadletters.clear",
+  "weft.updates.result.get",
+  "weft.worker.deployments.drain",
+  "weft.worker.deployments.resume",
+  "weft.workers.drain",
+  "weft.workers.list",
+  "weft.workers.resume",
+  "weft.workflows.activities.pending.list",
+  "weft.workflows.aggregate",
+  "weft.workflows.attributes.get",
+  "weft.workflows.attributes.set",
+  "weft.workflows.bulk.cancel",
+  "weft.workflows.bulk.delete",
+  "weft.workflows.bulk.retryfailed",
+  "weft.workflows.bulk.signal",
+  "weft.workflows.bulk.tags",
+  "weft.workflows.cancel",
+  "weft.workflows.checkpoints.get",
+  "weft.workflows.checkpoints.list",
+  "weft.workflows.events.list",
+  "weft.workflows.finalizer.get",
+  "weft.workflows.fork",
+  "weft.workflows.get",
+  "weft.workflows.list",
+  "weft.workflows.purge",
+  "weft.workflows.query",
+  "weft.workflows.replay",
+  "weft.workflows.result.get",
+  "weft.workflows.resume",
+  "weft.workflows.scheduleprovenance.get",
+  "weft.workflows.signal",
+  "weft.workflows.start",
+  "weft.workflows.startorsignal",
+  "weft.workflows.streams.chunks",
+  "weft.workflows.suspend",
+  "weft.workflows.tags.add",
+  "weft.workflows.tags.remove",
+  "weft.workflows.timeline.get",
+  "weft.workflows.timeout",
+  "weft.workflows.update"
+], CLIENT_REST_OPERATION_BINDINGS = {
+  "weft.tasks.diagnostics.deadletters.clear": {
+    method: "DELETE",
+    path: "/tasks/diagnostics/dead-letter/:operationId",
+    inputSources: { operationId: { kind: "path", pathParam: "operationId" } },
+    success: { kind: "json", status: 200 }
+  }
+};
 export function createWeftClient(connection = {}) {
   return createCatalogWeftClient(CATALOG_OPERATION_NAMES, httpJsonRpcTransport(connection));
 }

package/dist/cli/index.js

@@ -1,3 +1,4 @@
+#!/usr/bin/env bun
 export { removeRunLockfile, writeRunLockfile } from "../connection.js";
 export { executeApi } from "./api.js";
 export { executeCodegen } from "./codegen.js";

package/dist/cli/operation-catalog-snapshot.d.ts

@@ -1,5 +1,12 @@
-import type { OperationKind, TransportAvailability } from '../server/operation-catalog.ts';
+import type { ErasedOperation, OperationKind, TransportAvailability } from '../server/operation-catalog.ts';
 import type { FaultCode } from '../server/operation-fault.ts';
+import type { ParamSource, ResponseShape } from '../server/rest-binding.ts';
+export type CatalogRestBindingSnapshot = {
+    readonly method: string;
+    readonly path: string;
+    readonly inputSources: Readonly<Record<string, ParamSource>>;
+    readonly success: ResponseShape;
+};
 export type CatalogAccessSnapshot = {
     readonly kind: 'public';
 } | {
@@ -36,11 +43,13 @@ export type CatalogOperationSnapshot = {
     readonly inputSchema: Record<string, unknown>;
     readonly outputSchema: Record<string, unknown>;
     readonly eventSchema?: Record<string, unknown>;
+    /** Declarative REST route metadata for generated client transports. */
+    readonly rest?: CatalogRestBindingSnapshot;
 };
 export type CatalogSnapshot = {
     readonly generatedBy: 'weft catalog snapshot';
     readonly version: 1;
     readonly operations: ReadonlyArray<CatalogOperationSnapshot>;
 };
-export declare function createCatalogSnapshot(): CatalogSnapshot;
+export declare function createCatalogSnapshot(sourceOperations?: ReadonlyArray<ErasedOperation>): CatalogSnapshot;
 export declare function stringifyCatalogSnapshot(snapshot: CatalogSnapshot): string;

package/dist/cli/operation-catalog-snapshot.js

@@ -1,18 +1,19 @@
 import { definitionSchemaToJsonSchema } from "../core/types/definition-schema-to-json.js";
 import { compareStrings, normalizeJsonObject } from "../server/json-schema-utilities.js";
-import { createLiveOperationRegistry } from "../server/rest-bindings.js";
-export function createCatalogSnapshot() {
+import { createLiveOperationRegistry, createLiveRestBindings } from "../server/rest-bindings.js";
+export function createCatalogSnapshot(sourceOperations = createLiveOperationRegistry().list()) {
+  const restBindings = new Map(createLiveRestBindings().map((binding) => [binding.operationName, binding]));
   return {
     generatedBy: "weft catalog snapshot",
     version: 1,
-    operations: createLiveOperationRegistry().list().map(operationToSnapshot).toSorted((left, right) => compareStrings(left.name, right.name))
+    operations: sourceOperations.map((operation) => operationToSnapshot(operation, (operation.kind ?? "unary") === "unary" && operation.transports.http && !operation.transports.jsonRpcHttp && !operation.tags.includes("Storage") ? restBindings.get(operation.name) : void 0)).toSorted((left, right) => compareStrings(left.name, right.name))
   };
 }
 export function stringifyCatalogSnapshot(snapshot) {
   return `${JSON.stringify(snapshot, null, 2)}
 `;
 }
-function operationToSnapshot(operation) {
+function operationToSnapshot(operation, restBinding) {
   const eventSchema = operation.eventSchema;
   return {
     name: operation.name,
@@ -27,7 +28,15 @@ function operationToSnapshot(operation) {
     producibleFaults: [...operation.producibleFaults ?? []].toSorted(compareStrings),
     inputSchema: normalizeJsonObject(definitionSchemaToJsonSchema(operation.inputSchema, "input")),
     outputSchema: normalizeJsonObject(definitionSchemaToJsonSchema(operation.outputSchema, "output")),
-    ...eventSchema === void 0 ? {} : { eventSchema: normalizeJsonObject(definitionSchemaToJsonSchema(eventSchema, "output")) }
+    ...eventSchema === void 0 ? {} : { eventSchema: normalizeJsonObject(definitionSchemaToJsonSchema(eventSchema, "output")) },
+    ...restBinding === void 0 ? {} : {
+      rest: {
+        method: restBinding.method,
+        path: restBinding.path,
+        inputSources: Object.fromEntries(Object.entries(restBinding.inputSources).filter((entry) => entry[1] !== void 0)),
+        success: { ...restBinding.success }
+      }
+    }
   };
 }
 function parameterizedAccessToSnapshot(hint) {

package/dist/cli/operation-client-runtime.d.ts

@@ -33,6 +33,35 @@ export type WeftClientConnection = ConnectionOptions;
  * one generated surface instead of drifting apart.
  */
 export type CatalogTransport = (operationName: string, input: unknown) => Promise<unknown>;
+/** Generated metadata needed to map a typed client operation onto REST. */
+export type ClientRestOperationBinding = {
+    readonly method: string;
+    readonly path: string;
+    readonly inputSources: Readonly<Record<string, {
+        readonly kind: 'path';
+        readonly pathParam: string;
+    } | {
+        readonly kind: 'query';
+        readonly queryParam: string;
+        readonly repeating?: boolean;
+    } | {
+        readonly kind: 'header';
+        readonly headerName: string;
+    } | {
+        readonly kind: 'body';
+        readonly mediaType?: 'application/json';
+    } | {
+        readonly kind: 'body-field';
+        readonly bodyField: string;
+    }>>;
+    readonly success: {
+        readonly kind: 'json';
+        readonly status: number;
+    } | {
+        readonly kind: 'empty';
+        readonly status: number;
+    };
+};
 /**
  * Build a catalog client from a list of operation names and a transport. Each
  * name becomes a method that forwards its input through the transport, so the