@soat/sdk 0.15.2 → 0.15.3

package/dist/index.d.cts

@@ -1240,7 +1240,13 @@ type DiscussionRunRecord = {
   started_by?: {
     [key: string]: unknown;
   } | null;
+  /**
+   * Reserved for the generation that invoked this run as a tool. Not currently populated — see trace_id.
+   */
   initiator_generation_id?: string | null;
+  /**
+   * Trace of the generation that invoked this run as a tool. Null for runs started directly via POST /discussions/{discussion_id}/runs.
+   */
   trace_id?: string | null;
   completed_at?: Date | null;
   created_at?: Date;
@@ -2600,7 +2606,7 @@ type OrchestrationNode = {
   /**
    * Node execution type.
    */
-  type: 'agent' | 'tool' | 'transform' | 'knowledge' | 'memory_write' | 'condition' | 'human' | 'approval' | 'loop' | 'poll' | 'delay' | 'webhook' | 'sub_orchestration';
+  type: 'agent' | 'tool' | 'transform' | 'knowledge' | 'memory_write' | 'condition' | 'human' | 'approval' | 'loop' | 'poll' | 'delay' | 'webhook' | 'emit_event' | 'sub_orchestration';
   /**
    * For agent nodes — public ID of the agent to invoke.
    */
@@ -2720,25 +2726,15 @@ type OrchestrationNode = {
    */
   duration?: string;
   /**
-   * For webhook nodes — whether to emit or receive.
-   */
-  mode?: 'emit' | 'receive';
-  /**
-   * For webhook emit nodes — URL to POST to.
-   */
-  webhook_url?: string;
-  /**
-   * For webhook emit nodes — extra HTTP headers sent with the POST. Values support `{{secret:...}}` templating, resolved against the run's project at emit time, so an auth header can carry a secret without embedding it in the URL.
+   * For webhook nodes — parks the run awaiting an inbound callback. `receive` is the only mode; to send a notification out of a graph, use an `emit_event` node instead.
    *
    */
-  headers?: {
-    [key: string]: string;
-  };
+  mode?: 'receive';
   /**
-   * For webhook emit nodes — when set, the POST body is HMAC-SHA256 signed with this secret and the digest is sent as the `X-Soat-Signature: sha256=<hex>` header so the receiver can authenticate the payload. Supports `{{secret:...}}` templating.
+   * For emit_event nodes — the internal event type to emit (e.g. `guardrail.exception`). The node's input_mapping becomes the event `data`. Any Webhook subscribed to this event type in the run's project then delivers it — signed, retried, and tracked by the Webhooks module — so the graph holds no URL or secret of its own.
    *
    */
-  signing_secret?: string;
+  event_type?: string;
   /**
    * Public ID of the orchestration this node runs — the child orchestration for sub_orchestration nodes, and the orchestration run once per item for loop nodes.
    *
@@ -6300,6 +6296,14 @@ type ListDocumentsData = {
      * Project ID (optional)
      */
     project_id?: string;
+    /**
+     * Maximum number of results to return
+     */
+    limit?: number;
+    /**
+     * Number of results to skip
+     */
+    offset?: number;
   };
   url: '/api/v1/documents';
 };
@@ -6318,7 +6322,12 @@ type ListDocumentsResponses = {
   /**
    * List of documents
    */
-  200: Array<DocumentRecord>;
+  200: {
+    data?: Array<DocumentRecord>;
+    total?: number;
+    limit?: number;
+    offset?: number;
+  };
 };
 type ListDocumentsResponse = ListDocumentsResponses[keyof ListDocumentsResponses];
 type CreateDocumentData = {

package/dist/index.d.mts

@@ -1240,7 +1240,13 @@ type DiscussionRunRecord = {
   started_by?: {
     [key: string]: unknown;
   } | null;
+  /**
+   * Reserved for the generation that invoked this run as a tool. Not currently populated — see trace_id.
+   */
   initiator_generation_id?: string | null;
+  /**
+   * Trace of the generation that invoked this run as a tool. Null for runs started directly via POST /discussions/{discussion_id}/runs.
+   */
   trace_id?: string | null;
   completed_at?: Date | null;
   created_at?: Date;
@@ -2600,7 +2606,7 @@ type OrchestrationNode = {
   /**
    * Node execution type.
    */
-  type: 'agent' | 'tool' | 'transform' | 'knowledge' | 'memory_write' | 'condition' | 'human' | 'approval' | 'loop' | 'poll' | 'delay' | 'webhook' | 'sub_orchestration';
+  type: 'agent' | 'tool' | 'transform' | 'knowledge' | 'memory_write' | 'condition' | 'human' | 'approval' | 'loop' | 'poll' | 'delay' | 'webhook' | 'emit_event' | 'sub_orchestration';
   /**
    * For agent nodes — public ID of the agent to invoke.
    */
@@ -2720,25 +2726,15 @@ type OrchestrationNode = {
    */
   duration?: string;
   /**
-   * For webhook nodes — whether to emit or receive.
-   */
-  mode?: 'emit' | 'receive';
-  /**
-   * For webhook emit nodes — URL to POST to.
-   */
-  webhook_url?: string;
-  /**
-   * For webhook emit nodes — extra HTTP headers sent with the POST. Values support `{{secret:...}}` templating, resolved against the run's project at emit time, so an auth header can carry a secret without embedding it in the URL.
+   * For webhook nodes — parks the run awaiting an inbound callback. `receive` is the only mode; to send a notification out of a graph, use an `emit_event` node instead.
    *
    */
-  headers?: {
-    [key: string]: string;
-  };
+  mode?: 'receive';
   /**
-   * For webhook emit nodes — when set, the POST body is HMAC-SHA256 signed with this secret and the digest is sent as the `X-Soat-Signature: sha256=<hex>` header so the receiver can authenticate the payload. Supports `{{secret:...}}` templating.
+   * For emit_event nodes — the internal event type to emit (e.g. `guardrail.exception`). The node's input_mapping becomes the event `data`. Any Webhook subscribed to this event type in the run's project then delivers it — signed, retried, and tracked by the Webhooks module — so the graph holds no URL or secret of its own.
    *
    */
-  signing_secret?: string;
+  event_type?: string;
   /**
    * Public ID of the orchestration this node runs — the child orchestration for sub_orchestration nodes, and the orchestration run once per item for loop nodes.
    *
@@ -6300,6 +6296,14 @@ type ListDocumentsData = {
      * Project ID (optional)
      */
     project_id?: string;
+    /**
+     * Maximum number of results to return
+     */
+    limit?: number;
+    /**
+     * Number of results to skip
+     */
+    offset?: number;
   };
   url: '/api/v1/documents';
 };
@@ -6318,7 +6322,12 @@ type ListDocumentsResponses = {
   /**
    * List of documents
    */
-  200: Array<DocumentRecord>;
+  200: {
+    data?: Array<DocumentRecord>;
+    total?: number;
+    limit?: number;
+    offset?: number;
+  };
 };
 type ListDocumentsResponse = ListDocumentsResponses[keyof ListDocumentsResponses];
 type CreateDocumentData = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soat/sdk",
-  "version": "0.15.2",
+  "version": "0.15.3",
   "description": "TypeScript SDK for the SOAT API",
   "type": "module",
   "main": "dist/index.mjs",