@zarel-ai/sdk 0.6.0 → 0.7.0

package/dist/resources/entities.d.ts

@@ -1,66 +1,84 @@
 import { type FetchClient } from '../_internal/fetch-client';
-import type { EntityInput, FieldDefinitionInput } from '../types/entities';
+import type { EntityInput, EntityReplaceInput, EntityWriteInput, FieldDefinitionInput, FieldReplaceInput, FieldWriteInput } from '../types/entities';
+import type { ContractDeletedAck } from '../types/flows-contract';
 import type { LocaleOptions } from '../types/locale';
-import type { EntityListPayload, EntityPayload, EntityMutationPayload } from '../generated';
+import type { EntityFieldListPayload, EntityFieldPayload, EntityFieldRecordPayload, EntityListPayload, EntityPayload, EntityRecordPayload, FieldTransitionPayload, FieldTransitionCreatePayload, FieldTransitionWritePayload, FieldTransitionPatchPayload } from '../generated';
+/**
+ * `/contract/entities*`.
+ *
+ * Every return type here is derived from the contract API's OpenAPI document.
+ */
 export declare class EntitiesResource {
     private readonly client;
     constructor(client: FetchClient);
     /**
      * List all entities for the current tenant.
-     * spec-039: pass `{locale: 'es'}` to receive Spanish labels; omit for
+     * Pass `{locale: 'es'}` to receive Spanish labels; omit for
      * server-side fallback (JWT preferences.language → canonical).
      */
     list(options?: LocaleOptions): Promise<EntityListPayload>;
     /**
      * Create a new entity.
+     *
+     * `label` and `description` are REFUSED with 400: semantic content is written by a contract
+     * publish, never here.
      */
-    create(input: EntityInput): Promise<EntityMutationPayload>;
+    create(input: EntityInput): Promise<EntityRecordPayload>;
     /**
      * Get a single entity by name.
      */
     get(entityName: string, options?: LocaleOptions): Promise<EntityPayload>;
     /**
-     * Update an entity definition.
+     * Merge-patch an entity: an absent key is left alone, an explicit `null` clears it.
      */
-    update(entityName: string, input: Partial<EntityInput>): Promise<EntityMutationPayload>;
-    /**
-     * Delete an entity.
-     */
-    delete(entityName: string): Promise<void>;
+    update(entityName: string, input: EntityWriteInput): Promise<EntityRecordPayload>;
+    /** `ContractDeletedAck`, not `void`: this route answers `{success, data: {message}}`. */
+    delete(entityName: string): Promise<ContractDeletedAck>;
     /**
      * Add a field to an entity.
+     *
+     * The body is validated by the same rules a contract publish applies, so this reaches the SAME
+     * verdict a publish of the equivalent YAML does — including the type-linked `constraints` check
+     * and the `binding` forms.
      */
-    addField(entityName: string, field: FieldDefinitionInput): Promise<EntityMutationPayload>;
-    /**
-     * Update a field on an entity.
-     */
-    updateField(entityName: string, fieldName: string, update: Partial<FieldDefinitionInput>): Promise<EntityMutationPayload>;
+    addField(entityName: string, field: FieldDefinitionInput): Promise<EntityFieldRecordPayload>;
     /**
-     * Delete a field from an entity.
+     * Merge-patch a field. Judged on the field the patch LEAVES BEHIND, so a `constraints` block
+     * added without restating the type is validated against the STORED type.
      */
-    deleteField(entityName: string, fieldName: string): Promise<void>;
+    updateField(entityName: string, fieldName: string, update: FieldWriteInput): Promise<EntityFieldRecordPayload>;
+    /** `ContractDeletedAck`, not `void`: this route answers `{success, data: {message}}`. */
+    deleteField(entityName: string, fieldName: string): Promise<ContractDeletedAck>;
     /**
-     * Replace an entity definition wholesale (PUT). {@link update} is the partial (PATCH) counterpart.
+     * Replace an entity wholesale (PUT). {@link update} is the partial (PATCH) counterpart.
+     *
+     * A TOTAL write: every mutable declaration is REQUIRED, and `null` is how one is cleared. It
+     * does not clear by omission, because no read on this surface returns those five declarations —
+     * see `EntityReplaceInput`.
      */
-    replace(entityName: string, input: EntityInput): Promise<EntityMutationPayload>;
+    replace(entityName: string, input: EntityReplaceInput): Promise<EntityRecordPayload>;
     /**
-     * List an entity's fields. The response is `{ entity_name, fields }` — the field
-     * array is nested under `fields` (the endpoint wraps it, unlike the transition/step lists).
+     * List an entity's fields. The response is `{entity_name, fields}` — the field array is nested
+     * under `fields` (the endpoint wraps it, unlike the transition/step lists).
      */
-    listFields(entityName: string, options?: LocaleOptions): Promise<Record<string, unknown>>;
+    listFields(entityName: string, options?: LocaleOptions): Promise<EntityFieldListPayload>;
     /**
-     * Read a single field definition.
+     * Read a single field definition — the SAME shape the collection and the entity detail carry.
      */
-    getField(entityName: string, fieldName: string, options?: LocaleOptions): Promise<Record<string, unknown>>;
+    getField(entityName: string, fieldName: string, options?: LocaleOptions): Promise<EntityFieldPayload>;
     /**
-     * Replace a field definition wholesale (PUT). {@link updateField} is the partial (PATCH) counterpart.
+     * Replace a field wholesale (PUT). {@link updateField} is the partial (PATCH) counterpart.
+     *
+     * A TOTAL write — every mutable property is REQUIRED and `null` clears; see
+     * `FieldReplaceInput`.
      */
-    replaceField(entityName: string, fieldName: string, input: FieldDefinitionInput): Promise<EntityMutationPayload>;
-    listFieldTransitions(entityName: string, fieldName: string, options?: LocaleOptions): Promise<Record<string, unknown>[]>;
-    getFieldTransition(entityName: string, fieldName: string, from: string, to: string, options?: LocaleOptions): Promise<Record<string, unknown>>;
-    createFieldTransition(entityName: string, fieldName: string, input: Record<string, unknown>): Promise<Record<string, unknown>>;
-    replaceFieldTransition(entityName: string, fieldName: string, from: string, to: string, input: Record<string, unknown>): Promise<Record<string, unknown>>;
-    patchFieldTransition(entityName: string, fieldName: string, from: string, to: string, patch: Record<string, unknown>): Promise<Record<string, unknown>>;
-    deleteFieldTransition(entityName: string, fieldName: string, from: string, to: string): Promise<void>;
+    replaceField(entityName: string, fieldName: string, input: FieldReplaceInput): Promise<EntityFieldRecordPayload>;
+    listFieldTransitions(entityName: string, fieldName: string, options?: LocaleOptions): Promise<FieldTransitionPayload[]>;
+    getFieldTransition(entityName: string, fieldName: string, from: string, to: string, options?: LocaleOptions): Promise<FieldTransitionPayload>;
+    createFieldTransition(entityName: string, fieldName: string, input: FieldTransitionCreatePayload): Promise<FieldTransitionPayload>;
+    replaceFieldTransition(entityName: string, fieldName: string, from: string, to: string, input: FieldTransitionWritePayload): Promise<FieldTransitionPayload>;
+    patchFieldTransition(entityName: string, fieldName: string, from: string, to: string, patch: FieldTransitionPatchPayload): Promise<FieldTransitionPayload>;
+    /** `ContractDeletedAck`, not `void`: this route answers `{success, data: {message}}`. */
+    deleteFieldTransition(entityName: string, fieldName: string, from: string, to: string): Promise<ContractDeletedAck>;
 }
 //# sourceMappingURL=entities.d.ts.map

package/dist/resources/entities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entities.d.ts","sourceRoot":"","sources":["../../src/resources/entities.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"entities.d.ts","sourceRoot":"","sources":["../../src/resources/entities.ts"],"names":[],"mappings":"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"}

package/dist/resources/entities.js

@@ -1,7 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EntitiesResource = void 0;
+// SPDX-License-Identifier: MIT
+// Copyright 2026 Nicolas Moreno
 const fetch_client_1 = require("../_internal/fetch-client");
+/**
+ * `/contract/entities*`.
+ *
+ * Every return type here is derived from the contract API's OpenAPI document.
+ */
 class EntitiesResource {
     client;
     constructor(client) {
@@ -9,97 +16,109 @@ class EntitiesResource {
     }
     /**
      * List all entities for the current tenant.
-     * spec-039: pass `{locale: 'es'}` to receive Spanish labels; omit for
+     * Pass `{locale: 'es'}` to receive Spanish labels; omit for
      * server-side fallback (JWT preferences.language → canonical).
      */
     async list(options) {
-        return this.client.get('/contract/entities', (0, fetch_client_1.localeQuery)(options), { operationId: 'listEntities' });
+        return await this.client.get('/contract/entities', (0, fetch_client_1.localeQuery)(options), { operationId: 'listEntities' });
     }
     /**
      * Create a new entity.
+     *
+     * `label` and `description` are REFUSED with 400: semantic content is written by a contract
+     * publish, never here.
      */
     async create(input) {
-        return this.client.post('/contract/entities', input, { operationId: 'createEntity' });
+        return await this.client.post('/contract/entities', input, { operationId: 'createEntity' });
     }
     /**
      * Get a single entity by name.
      */
     async get(entityName, options) {
-        return this.client.get(`/contract/entities/${entityName}`, (0, fetch_client_1.localeQuery)(options), { operationId: 'getEntity' });
+        return await this.client.get(`/contract/entities/${entityName}`, (0, fetch_client_1.localeQuery)(options), { operationId: 'getEntity' });
     }
     /**
-     * Update an entity definition.
+     * Merge-patch an entity: an absent key is left alone, an explicit `null` clears it.
      */
     async update(entityName, input) {
-        return this.client.patch(`/contract/entities/${entityName}`, input, { operationId: 'patchEntity' });
+        return await this.client.patch(`/contract/entities/${entityName}`, input, { operationId: 'patchEntity' });
     }
-    /**
-     * Delete an entity.
-     */
+    /** `ContractDeletedAck`, not `void`: this route answers `{success, data: {message}}`. */
     async delete(entityName) {
-        await this.client.del(`/contract/entities/${entityName}`, { operationId: 'deleteEntity' });
+        return await this.client.del(`/contract/entities/${entityName}`, { operationId: 'deleteEntity' });
     }
     /**
      * Add a field to an entity.
+     *
+     * The body is validated by the same rules a contract publish applies, so this reaches the SAME
+     * verdict a publish of the equivalent YAML does — including the type-linked `constraints` check
+     * and the `binding` forms.
      */
     async addField(entityName, field) {
-        return this.client.post(`/contract/entities/${entityName}/fields`, field, { operationId: 'createEntityField' });
+        return await this.client.post(`/contract/entities/${entityName}/fields`, field, { operationId: 'createEntityField' });
     }
     /**
-     * Update a field on an entity.
+     * Merge-patch a field. Judged on the field the patch LEAVES BEHIND, so a `constraints` block
+     * added without restating the type is validated against the STORED type.
      */
     async updateField(entityName, fieldName, update) {
-        return this.client.patch(`/contract/entities/${entityName}/fields/${fieldName}`, update, { operationId: 'patchEntityField' });
+        return await this.client.patch(`/contract/entities/${entityName}/fields/${fieldName}`, update, { operationId: 'patchEntityField' });
     }
-    /**
-     * Delete a field from an entity.
-     */
+    /** `ContractDeletedAck`, not `void`: this route answers `{success, data: {message}}`. */
     async deleteField(entityName, fieldName) {
-        await this.client.del(`/contract/entities/${entityName}/fields/${fieldName}`, { operationId: 'deleteEntityField' });
+        return await this.client.del(`/contract/entities/${entityName}/fields/${fieldName}`, { operationId: 'deleteEntityField' });
     }
     /**
-     * Replace an entity definition wholesale (PUT). {@link update} is the partial (PATCH) counterpart.
+     * Replace an entity wholesale (PUT). {@link update} is the partial (PATCH) counterpart.
+     *
+     * A TOTAL write: every mutable declaration is REQUIRED, and `null` is how one is cleared. It
+     * does not clear by omission, because no read on this surface returns those five declarations —
+     * see `EntityReplaceInput`.
      */
     async replace(entityName, input) {
-        return this.client.put(`/contract/entities/${entityName}`, input, { operationId: 'replaceEntity' });
+        return await this.client.put(`/contract/entities/${entityName}`, input, { operationId: 'replaceEntity' });
     }
     /**
-     * List an entity's fields. The response is `{ entity_name, fields }` — the field
-     * array is nested under `fields` (the endpoint wraps it, unlike the transition/step lists).
+     * List an entity's fields. The response is `{entity_name, fields}` — the field array is nested
+     * under `fields` (the endpoint wraps it, unlike the transition/step lists).
      */
     async listFields(entityName, options) {
-        return this.client.get(`/contract/entities/${entityName}/fields`, (0, fetch_client_1.localeQuery)(options), { operationId: 'listEntityFields' });
+        return await this.client.get(`/contract/entities/${entityName}/fields`, (0, fetch_client_1.localeQuery)(options), { operationId: 'listEntityFields' });
     }
     /**
-     * Read a single field definition.
+     * Read a single field definition — the SAME shape the collection and the entity detail carry.
      */
     async getField(entityName, fieldName, options) {
-        return this.client.get(`/contract/entities/${entityName}/fields/${fieldName}`, (0, fetch_client_1.localeQuery)(options), { operationId: 'getEntityField' });
+        return await this.client.get(`/contract/entities/${entityName}/fields/${fieldName}`, (0, fetch_client_1.localeQuery)(options), { operationId: 'getEntityField' });
     }
     /**
-     * Replace a field definition wholesale (PUT). {@link updateField} is the partial (PATCH) counterpart.
+     * Replace a field wholesale (PUT). {@link updateField} is the partial (PATCH) counterpart.
+     *
+     * A TOTAL write — every mutable property is REQUIRED and `null` clears; see
+     * `FieldReplaceInput`.
      */
     async replaceField(entityName, fieldName, input) {
-        return this.client.put(`/contract/entities/${entityName}/fields/${fieldName}`, input, { operationId: 'replaceEntityField' });
+        return await this.client.put(`/contract/entities/${entityName}/fields/${fieldName}`, input, { operationId: 'replaceEntityField' });
     }
     // ── Field transitions — state-machine rules on a field, addressed by (entity, field, from, to) ──
     async listFieldTransitions(entityName, fieldName, options) {
-        return this.client.get(`/contract/entities/${entityName}/fields/${fieldName}/transitions`, (0, fetch_client_1.localeQuery)(options), { operationId: 'listFieldTransitions' });
+        return await this.client.get(`/contract/entities/${entityName}/fields/${fieldName}/transitions`, (0, fetch_client_1.localeQuery)(options), { operationId: 'listFieldTransitions' });
     }
     async getFieldTransition(entityName, fieldName, from, to, options) {
-        return this.client.get(`/contract/entities/${entityName}/fields/${fieldName}/transitions/${from}/${to}`, (0, fetch_client_1.localeQuery)(options), { operationId: 'getFieldTransition' });
+        return await this.client.get(`/contract/entities/${entityName}/fields/${fieldName}/transitions/${from}/${to}`, (0, fetch_client_1.localeQuery)(options), { operationId: 'getFieldTransition' });
     }
     async createFieldTransition(entityName, fieldName, input) {
-        return this.client.post(`/contract/entities/${entityName}/fields/${fieldName}/transitions`, input, { operationId: 'createFieldTransition' });
+        return await this.client.post(`/contract/entities/${entityName}/fields/${fieldName}/transitions`, input, { operationId: 'createFieldTransition' });
     }
     async replaceFieldTransition(entityName, fieldName, from, to, input) {
-        return this.client.put(`/contract/entities/${entityName}/fields/${fieldName}/transitions/${from}/${to}`, input, { operationId: 'replaceFieldTransition' });
+        return await this.client.put(`/contract/entities/${entityName}/fields/${fieldName}/transitions/${from}/${to}`, input, { operationId: 'replaceFieldTransition' });
     }
     async patchFieldTransition(entityName, fieldName, from, to, patch) {
-        return this.client.patch(`/contract/entities/${entityName}/fields/${fieldName}/transitions/${from}/${to}`, patch, { operationId: 'patchFieldTransition' });
+        return await this.client.patch(`/contract/entities/${entityName}/fields/${fieldName}/transitions/${from}/${to}`, patch, { operationId: 'patchFieldTransition' });
     }
+    /** `ContractDeletedAck`, not `void`: this route answers `{success, data: {message}}`. */
     async deleteFieldTransition(entityName, fieldName, from, to) {
-        await this.client.del(`/contract/entities/${entityName}/fields/${fieldName}/transitions/${from}/${to}`, { operationId: 'deleteFieldTransition' });
+        return await this.client.del(`/contract/entities/${entityName}/fields/${fieldName}/transitions/${from}/${to}`, { operationId: 'deleteFieldTransition' });
     }
 }
 exports.EntitiesResource = EntitiesResource;

package/dist/resources/entities.js.map

@@ -1 +1 @@
-{"version":3,"file":"entities.js","sourceRoot":"","sources":["../../src/resources/entities.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"entities.js","sourceRoot":"","sources":["../../src/resources/entities.ts"],"names":[],"mappings":"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"}

package/dist/resources/events.d.ts

@@ -6,8 +6,8 @@ export declare class EventsResource {
     private readonly client;
     constructor(client: FetchClient);
     /**
-     * G3 — open a typed Server-Sent-Events stream of live tenant events
-     * (`GET /runtime/events/stream`, ADR-0104). Delivers typed `conversation.turn_created`
+     * Open a typed Server-Sent-Events stream of live tenant events
+     * (`GET /runtime/events/stream`). Delivers typed `conversation.turn_created`
      * events (and a generic fallback for other named events) to `handlers.onEvent`;
      * reconnects across transient disconnects. Returns a teardown handle.
      */
@@ -22,9 +22,8 @@ export declare class EventsResource {
      */
     iterate(options?: EventIterateOptions): AsyncIterableIterator<RuntimeStreamEvent>;
     /**
-     * List event deliveries (the runtime log of dispatched webhook events).
-     * Renamed from `.list()` in P12 to reflect the canonical
-     * `/runtime/events/delivery` surface.
+     * List event deliveries (the runtime log of dispatched webhook events,
+     * `GET /runtime/events/delivery`).
      */
     listDeliveries(options?: LocaleOptions): Promise<EventListResponse>;
     /**

package/dist/resources/events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/resources/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAA0B,MAAM,2BAA2B,CAAC;AACrF,OAAO,KAAK,EACR,iBAAiB,EACjB,sBAAsB,EACtB,yBAAyB,EACzB,6BAA6B,EAC7B,mCAAmC,EACtC,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EACR,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EACrB,MAAM,wBAAwB,CAAC;AAGhC,qBAAa,cAAc;IACX,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAEhD;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,iBAAiB;IAItF;;;;;;;OAOG;IACH,OAAO,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,qBAAqB,CAAC,kBAAkB,CAAC;IAcjF;;;;OAIG;IACG,cAAc,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAOzE;;OAEG;IACG,SAAS,CACX,KAAK,EAAE,sBAAsB,EAC7B,cAAc,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAC1C,OAAO,CAAC,yBAAyB,CAAC;IAIrC;;OAEG;IACG,iBAAiB,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAOxF;;OAEG;IACG,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,mCAAmC,CAAC;CAG1G"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/resources/events.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,WAAW,EAA0B,MAAM,2BAA2B,CAAC;AACrF,OAAO,KAAK,EACR,iBAAiB,EACjB,sBAAsB,EACtB,yBAAyB,EACzB,6BAA6B,EAC7B,mCAAmC,EACtC,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EACR,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EACrB,MAAM,wBAAwB,CAAC;AAGhC,qBAAa,cAAc;IACX,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAEhD;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,iBAAiB;IAItF;;;;;;;OAOG;IACH,OAAO,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,qBAAqB,CAAC,kBAAkB,CAAC;IAcjF;;;OAGG;IACG,cAAc,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAOzE;;OAEG;IACG,SAAS,CACX,KAAK,EAAE,sBAAsB,EAC7B,cAAc,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAC1C,OAAO,CAAC,yBAAyB,CAAC;IAIrC;;OAEG;IACG,iBAAiB,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAOxF;;OAEG;IACG,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,mCAAmC,CAAC;CAG1G"}

package/dist/resources/events.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EventsResource = void 0;
+// SPDX-License-Identifier: MIT
+// Copyright 2026 Nicolas Moreno
 const fetch_client_1 = require("../_internal/fetch-client");
 const event_iterator_1 = require("../_internal/event-iterator");
 class EventsResource {
@@ -9,8 +11,8 @@ class EventsResource {
         this.client = client;
     }
     /**
-     * G3 — open a typed Server-Sent-Events stream of live tenant events
-     * (`GET /runtime/events/stream`, ADR-0104). Delivers typed `conversation.turn_created`
+     * Open a typed Server-Sent-Events stream of live tenant events
+     * (`GET /runtime/events/stream`). Delivers typed `conversation.turn_created`
      * events (and a generic fallback for other named events) to `handlers.onEvent`;
      * reconnects across transient disconnects. Returns a teardown handle.
      */
@@ -35,21 +37,20 @@ class EventsResource {
         return (0, event_iterator_1.createEventIterator)((handlers, streamOpts) => this.client.openEventStream('/runtime/events/stream', handlers, streamOpts), config);
     }
     /**
-     * List event deliveries (the runtime log of dispatched webhook events).
-     * Renamed from `.list()` in P12 to reflect the canonical
-     * `/runtime/events/delivery` surface.
+     * List event deliveries (the runtime log of dispatched webhook events,
+     * `GET /runtime/events/delivery`).
      */
     async listDeliveries(options) {
         const q = (0, fetch_client_1.localeQueryOrUndefined)(options);
         return q
-            ? this.client.get('/runtime/events/delivery', q, { operationId: 'listEventDeliveries' })
-            : this.client.get('/runtime/events/delivery', undefined, { operationId: 'listEventDeliveries' });
+            ? await this.client.get('/runtime/events/delivery', q, { operationId: 'listEventDeliveries' })
+            : await this.client.get('/runtime/events/delivery', undefined, { operationId: 'listEventDeliveries' });
     }
     /**
      * Create a webhook event subscription.
      */
     async subscribe(input, requestOptions) {
-        return this.client.post('/runtime/events/subscriptions', input, { operationId: 'createEventSubscription', ...requestOptions });
+        return await this.client.post('/runtime/events/subscriptions', input, { operationId: 'createEventSubscription', ...requestOptions });
     }
     /**
      * List all event subscriptions.
@@ -57,14 +58,14 @@ class EventsResource {
     async listSubscriptions(options) {
         const q = (0, fetch_client_1.localeQueryOrUndefined)(options);
         return q
-            ? this.client.get('/runtime/events/subscriptions', q, { operationId: 'listEventSubscriptions' })
-            : this.client.get('/runtime/events/subscriptions', undefined, { operationId: 'listEventSubscriptions' });
+            ? await this.client.get('/runtime/events/subscriptions', q, { operationId: 'listEventSubscriptions' })
+            : await this.client.get('/runtime/events/subscriptions', undefined, { operationId: 'listEventSubscriptions' });
     }
     /**
      * Deactivate a webhook subscription.
      */
     async deleteSubscription(subscriptionId) {
-        return this.client.del(`/runtime/events/subscriptions/${subscriptionId}`, { operationId: 'deactivateEventSubscription' });
+        return await this.client.del(`/runtime/events/subscriptions/${subscriptionId}`, { operationId: 'deactivateEventSubscription' });
     }
 }
 exports.EventsResource = EventsResource;

package/dist/resources/events.js.map

@@ -1 +1 @@
-{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/resources/events.ts"],"names":[],"mappings":";;;AAAA,4DAAqF;AAgBrF,gEAAkE;AAElE,MAAa,cAAc;IACM;IAA7B,YAA6B,MAAmB;QAAnB,WAAM,GAAN,MAAM,CAAa;IAAG,CAAC;IAEpD;;;;;OAKG;IACH,MAAM,CAAC,QAA6B,EAAE,OAA4B;QAC9D,OAAO,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,wBAAwB,EAAE,QAAQ,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC;IAC1F,CAAC;IAED;;;;;;;OAOG;IACH,OAAO,CAAC,OAA6B;QACjC,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,aAAa,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;QAClE,MAAM,MAAM,GAAG;YACX,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnD,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjD,aAAa;SAChB,CAAC;QACF,OAAO,IAAA,oCAAmB,EACtB,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,CACrB,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,wBAAwB,EAAE,QAAQ,EAAE,UAAU,CAAC,EAC/E,MAAM,CACT,CAAC;IACN,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,cAAc,CAAC,OAAuB;QACxC,MAAM,CAAC,GAAG,IAAA,qCAAsB,EAAC,OAAO,CAAC,CAAC;QAC1C,OAAO,CAAC;YACJ,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAoB,0BAA0B,EAAE,CAAC,EAAE,EAAE,WAAW,EAAE,qBAAqB,EAAE,CAAC;YAC3G,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAoB,0BAA0B,EAAE,SAAS,EAAE,EAAE,WAAW,EAAE,qBAAqB,EAAE,CAAC,CAAC;IAC5H,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS,CACX,KAA6B,EAC7B,cAAyC;QAEzC,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAA4B,+BAA+B,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,yBAAyB,EAAE,GAAG,cAAc,EAAE,CAAC,CAAC;IAC9J,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,iBAAiB,CAAC,OAAuB;QAC3C,MAAM,CAAC,GAAG,IAAA,qCAAsB,EAAC,OAAO,CAAC,CAAC;QAC1C,OAAO,CAAC;YACJ,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAgC,+BAA+B,EAAE,CAAC,EAAE,EAAE,WAAW,EAAE,wBAAwB,EAAE,CAAC;YAC/H,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAgC,+BAA+B,EAAE,SAAS,EAAE,EAAE,WAAW,EAAE,wBAAwB,EAAE,CAAC,CAAC;IAChJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,kBAAkB,CAAC,cAA+B;QACpD,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAsC,iCAAiC,cAAc,EAAE,EAAE,EAAE,WAAW,EAAE,6BAA6B,EAAE,CAAC,CAAC;IACnK,CAAC;CACJ;AAzED,wCAyEC"}
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/resources/events.ts"],"names":[],"mappings":";;;AAAA,+BAA+B;AAC/B,gCAAgC;AAChC,4DAAqF;AAgBrF,gEAAkE;AAElE,MAAa,cAAc;IACM;IAA7B,YAA6B,MAAmB;QAAnB,WAAM,GAAN,MAAM,CAAa;IAAG,CAAC;IAEpD;;;;;OAKG;IACH,MAAM,CAAC,QAA6B,EAAE,OAA4B;QAC9D,OAAO,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,wBAAwB,EAAE,QAAQ,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC;IAC1F,CAAC;IAED;;;;;;;OAOG;IACH,OAAO,CAAC,OAA6B;QACjC,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,aAAa,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;QAClE,MAAM,MAAM,GAAG;YACX,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnD,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjD,aAAa;SAChB,CAAC;QACF,OAAO,IAAA,oCAAmB,EACtB,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,CACrB,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,wBAAwB,EAAE,QAAQ,EAAE,UAAU,CAAC,EAC/E,MAAM,CACT,CAAC;IACN,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,cAAc,CAAC,OAAuB;QACxC,MAAM,CAAC,GAAG,IAAA,qCAAsB,EAAC,OAAO,CAAC,CAAC;QAC1C,OAAO,CAAC;YACJ,CAAC,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAoB,0BAA0B,EAAE,CAAC,EAAE,EAAE,WAAW,EAAE,qBAAqB,EAAE,CAAC;YACjH,CAAC,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAoB,0BAA0B,EAAE,SAAS,EAAE,EAAE,WAAW,EAAE,qBAAqB,EAAE,CAAC,CAAC;IAClI,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS,CACX,KAA6B,EAC7B,cAAyC;QAEzC,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAA4B,+BAA+B,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,yBAAyB,EAAE,GAAG,cAAc,EAAE,CAAC,CAAC;IACpK,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,iBAAiB,CAAC,OAAuB;QAC3C,MAAM,CAAC,GAAG,IAAA,qCAAsB,EAAC,OAAO,CAAC,CAAC;QAC1C,OAAO,CAAC;YACJ,CAAC,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAgC,+BAA+B,EAAE,CAAC,EAAE,EAAE,WAAW,EAAE,wBAAwB,EAAE,CAAC;YACrI,CAAC,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAgC,+BAA+B,EAAE,SAAS,EAAE,EAAE,WAAW,EAAE,wBAAwB,EAAE,CAAC,CAAC;IACtJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,kBAAkB,CAAC,cAA+B;QACpD,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAsC,iCAAiC,cAAc,EAAE,EAAE,EAAE,WAAW,EAAE,6BAA6B,EAAE,CAAC,CAAC;IACzK,CAAC;CACJ;AAxED,wCAwEC"}

package/dist/resources/flows.d.ts

@@ -1,6 +1,5 @@
 import { type FetchClient } from '../_internal/fetch-client';
-import type { FlowEventListResponse, FlowEventResponse, FlowInstanceListResponse, FlowInstanceResponse } from '../types/flows';
-import type { FlowCallbackResponse } from '../types/platform';
+import type { FlowCallbackListResponse, FlowCallbackResolution, FlowCallbackResponse, FlowEventListResponse, FlowEventResponse, FlowInstanceListResponse, FlowInstanceResponse } from '../types/flows';
 import type { LocaleOptions } from '../types/locale';
 /**
  * Runtime flow instances, events, and callbacks.
@@ -17,16 +16,12 @@ export declare class FlowsResource {
     }): Promise<FlowInstanceListResponse>;
     getInstance(instanceId: string, options?: LocaleOptions): Promise<FlowInstanceResponse>;
     /**
-     * The appended flow lifecycle log — where per-step history lives.
-     *
-     * `GET /runtime/flows/events` has existed and been declared in the OpenAPI
-     * (`listFlowEvents`) the whole time; this resource simply never bound it, so
-     * the only per-step data the platform keeps was unreachable from the SDK.
-     * That is why consumers reached for `FlowInstance.steps`, a field the route
-     * has never sent.
+     * The appended flow lifecycle log — where per-step history lives
+     * (`GET /runtime/flows/events`). A flow instance carries no per-step data;
+     * read it here.
      *
      * Pass `instanceId` for one run's trace. Events come back in CHAIN order
-     * (`seq`), not `created_at` — rows appended in one transaction share a
+     * (`seq`), not `created_at` — events appended together can share a
      * timestamp, so only `seq` is a total order.
      */
     listEvents(options?: LocaleOptions & {
@@ -34,12 +29,20 @@ export declare class FlowsResource {
         eventType?: string;
     }): Promise<FlowEventListResponse>;
     getEvent(eventId: string, options?: LocaleOptions): Promise<FlowEventResponse>;
+    /** The tenant's flow callbacks — a suspended run's resumption points. */
+    listCallbacks(options?: LocaleOptions): Promise<FlowCallbackListResponse>;
+    /** One flow callback. */
+    getCallback(callbackId: string, options?: LocaleOptions): Promise<FlowCallbackResponse>;
     /**
-     * Resolve a pending flow callback. The `callbackId` is the opaque
-     * capability token supplied to the external system at flow registration;
-     * the server accepts the PATCH without a JWT, so this is typically
-     * invoked by external workers rather than authenticated clients.
+     * Resolve a pending flow callback with `{action: 'complete', payload}` or
+     * `{action: 'fail', reason?}`. Answers the resolved callback.
+     *
+     * REQUIRES A TOKEN: a token-less PATCH is refused `401`, so an external worker
+     * resolving a callback must authenticate like any other caller.
+     *
+     * The response is the canonical envelope carrying the resolved `FlowCallback`;
+     * the transport unwraps it, so this returns the `FlowCallback` itself.
      */
-    resolveCallback(callbackId: string, payload: Record<string, unknown>): Promise<FlowCallbackResponse>;
+    resolveCallback(callbackId: string, resolution: FlowCallbackResolution): Promise<FlowCallbackResponse>;
 }
 //# sourceMappingURL=flows.d.ts.map

package/dist/resources/flows.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flows.d.ts","sourceRoot":"","sources":["../../src/resources/flows.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAA0B,MAAM,2BAA2B,CAAC;AACrF,OAAO,KAAK,EACR,qBAAqB,EACrB,iBAAiB,EACjB,wBAAwB,EACxB,oBAAoB,EACvB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;;;;;GAMG;AACH,qBAAa,aAAa;IACV,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAE1C,aAAa,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAW7F,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAQ7F;;;;;;;;;;;;OAYG;IACG,UAAU,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAUjH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAQpF;;;;;OAKG;IACG,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAU7G"}
+{"version":3,"file":"flows.d.ts","sourceRoot":"","sources":["../../src/resources/flows.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,WAAW,EAA0B,MAAM,2BAA2B,CAAC;AACrF,OAAO,KAAK,EACR,wBAAwB,EACxB,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,wBAAwB,EACxB,oBAAoB,EACvB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;;;;;GAMG;AACH,qBAAa,aAAa;IACV,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAE1C,aAAa,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAW7F,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAQ7F;;;;;;;;OAQG;IACG,UAAU,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAUjH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAQpF,yEAAyE;IACnE,aAAa,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAO/E,yBAAyB;IACnB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAQ7F;;;;;;;;;OASG;IACG,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,sBAAsB,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAO/G"}

package/dist/resources/flows.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FlowsResource = void 0;
+// SPDX-License-Identifier: MIT
+// Copyright 2026 Nicolas Moreno
 const fetch_client_1 = require("../_internal/fetch-client");
 /**
  * Runtime flow instances, events, and callbacks.
@@ -15,35 +17,31 @@ class FlowsResource {
         this.client = client;
     }
     async listInstances(options) {
-        // Sub-spec A (A4) gap-fill: optional `flow` filter (`?flow={name}`) for
-        // the per-flow runs view, alongside the existing locale query.
+        // Optional `flow` filter (`?flow={name}`) narrows the list to one
+        // flow's runs; it combines with the locale query.
         const q = {};
         if (options?.locale)
             q.locale = options.locale;
         if (options?.flow)
             q.flow = options.flow;
         return Object.keys(q).length > 0
-            ? this.client.get('/runtime/flows/instances', q, { operationId: 'listFlowInstances' })
-            : this.client.get('/runtime/flows/instances', undefined, { operationId: 'listFlowInstances' });
+            ? await this.client.get('/runtime/flows/instances', q, { operationId: 'listFlowInstances' })
+            : await this.client.get('/runtime/flows/instances', undefined, { operationId: 'listFlowInstances' });
     }
     async getInstance(instanceId, options) {
         const path = `/runtime/flows/instances/${encodeURIComponent(instanceId)}`;
         const q = (0, fetch_client_1.localeQueryOrUndefined)(options);
         return q
-            ? this.client.get(path, q, { operationId: 'getFlowInstance' })
-            : this.client.get(path, undefined, { operationId: 'getFlowInstance' });
+            ? await this.client.get(path, q, { operationId: 'getFlowInstance' })
+            : await this.client.get(path, undefined, { operationId: 'getFlowInstance' });
     }
     /**
-     * The appended flow lifecycle log — where per-step history lives.
-     *
-     * `GET /runtime/flows/events` has existed and been declared in the OpenAPI
-     * (`listFlowEvents`) the whole time; this resource simply never bound it, so
-     * the only per-step data the platform keeps was unreachable from the SDK.
-     * That is why consumers reached for `FlowInstance.steps`, a field the route
-     * has never sent.
+     * The appended flow lifecycle log — where per-step history lives
+     * (`GET /runtime/flows/events`). A flow instance carries no per-step data;
+     * read it here.
      *
      * Pass `instanceId` for one run's trace. Events come back in CHAIN order
-     * (`seq`), not `created_at` — rows appended in one transaction share a
+     * (`seq`), not `created_at` — events appended together can share a
      * timestamp, so only `seq` is a total order.
      */
     async listEvents(options) {
@@ -55,27 +53,43 @@ class FlowsResource {
         if (options?.eventType)
             q.event_type = options.eventType;
         return Object.keys(q).length > 0
-            ? this.client.get('/runtime/flows/events', q, { operationId: 'listFlowEvents' })
-            : this.client.get('/runtime/flows/events', undefined, { operationId: 'listFlowEvents' });
+            ? await this.client.get('/runtime/flows/events', q, { operationId: 'listFlowEvents' })
+            : await this.client.get('/runtime/flows/events', undefined, { operationId: 'listFlowEvents' });
     }
     async getEvent(eventId, options) {
         const path = `/runtime/flows/events/${encodeURIComponent(eventId)}`;
         const q = (0, fetch_client_1.localeQueryOrUndefined)(options);
         return q
-            ? this.client.get(path, q, { operationId: 'getFlowEvent' })
-            : this.client.get(path, undefined, { operationId: 'getFlowEvent' });
+            ? await this.client.get(path, q, { operationId: 'getFlowEvent' })
+            : await this.client.get(path, undefined, { operationId: 'getFlowEvent' });
+    }
+    /** The tenant's flow callbacks — a suspended run's resumption points. */
+    async listCallbacks(options) {
+        const q = (0, fetch_client_1.localeQueryOrUndefined)(options);
+        return q
+            ? await this.client.get('/runtime/flows/callbacks', q, { operationId: 'listFlowCallbacks' })
+            : await this.client.get('/runtime/flows/callbacks', undefined, { operationId: 'listFlowCallbacks' });
+    }
+    /** One flow callback. */
+    async getCallback(callbackId, options) {
+        const path = `/runtime/flows/callbacks/${encodeURIComponent(callbackId)}`;
+        const q = (0, fetch_client_1.localeQueryOrUndefined)(options);
+        return q
+            ? await this.client.get(path, q, { operationId: 'getFlowCallback' })
+            : await this.client.get(path, undefined, { operationId: 'getFlowCallback' });
     }
     /**
-     * Resolve a pending flow callback. The `callbackId` is the opaque
-     * capability token supplied to the external system at flow registration;
-     * the server accepts the PATCH without a JWT, so this is typically
-     * invoked by external workers rather than authenticated clients.
+     * Resolve a pending flow callback with `{action: 'complete', payload}` or
+     * `{action: 'fail', reason?}`. Answers the resolved callback.
+     *
+     * REQUIRES A TOKEN: a token-less PATCH is refused `401`, so an external worker
+     * resolving a callback must authenticate like any other caller.
+     *
+     * The response is the canonical envelope carrying the resolved `FlowCallback`;
+     * the transport unwraps it, so this returns the `FlowCallback` itself.
      */
-    async resolveCallback(callbackId, payload) {
-        // FlowCallbackResponse is a FLAT `{success, message?}` body (no `data`)
-        // — indistinguishable from a canonical no-data envelope by key shape, so
-        // opt out of the unwrap to return the whole body (G1).
-        return this.client.patch(`/runtime/flows/callbacks/${encodeURIComponent(callbackId)}`, payload, { operationId: 'resolveFlowCallback' });
+    async resolveCallback(callbackId, resolution) {
+        return await this.client.patch(`/runtime/flows/callbacks/${encodeURIComponent(callbackId)}`, resolution, { operationId: 'resolveFlowCallback' });
     }
 }
 exports.FlowsResource = FlowsResource;