bem-ai-sdk 0.27.0 → 0.28.0

package/src/resources/knowledge-graph.ts

@@ -98,6 +98,13 @@ export namespace KnowledgeGraphRetrieveResponse {
      */
     canonical: string;
 
+    /**
+     * Hops from the center node when the request centers the graph on one entity
+     * (`nodeID`). The center is depth 0. When the request is uncentered (no `nodeID`),
+     * this is 0 for every node.
+     */
+    depth: number;
+
     /**
      * Total mentions of this entity across all parsed documents.
      */
@@ -127,6 +134,20 @@ export interface KnowledgeGraphRetrieveParams {
    */
   limit?: number;
 
+  /**
+   * Maximum hops from the center node. Only meaningful with `nodeID`. Defaults to 2
+   * and is clamped down to a system maximum (5).
+   */
+  maxDepth?: number;
+
+  /**
+   * Center the graph on this entity (`ent_...`) and only return the subgraph within
+   * `maxDepth` hops of it; every node then carries its `depth` (hops from the
+   * center, center = 0). Omit for the uncentered whole-graph view. `rootNodeID` and
+   * `focusNodeID` are accepted as aliases.
+   */
+  nodeID?: string;
+
   /**
    * Case-insensitive substring match on canonical names. Both endpoints of an edge
    * must match for the edge (and its nodes) to be returned.

package/src/resources/outputs.ts

@@ -85,7 +85,8 @@ export type Event =
   | Event.PayloadShapingEvent
   | Event.EvaluationEvent
   | Event.CollectionProcessingEvent
-  | Event.SendEvent;
+  | Event.SendEvent
+  | Event.RenderEvent;
 
 export namespace Event {
   export interface TransformEvent {
@@ -1836,6 +1837,103 @@ export namespace Event {
       httpStatusCode: number;
     }
   }
+
+  export interface RenderEvent {
+    /**
+     * Wall-clock seconds spent generating the output docx through the template.
+     */
+    docxRenderSeconds: number;
+
+    /**
+     * Unique ID generated by bem to identify the event.
+     */
+    eventID: string;
+
+    /**
+     * Unique identifier of function that this event is associated with.
+     */
+    functionID: string;
+
+    /**
+     * Unique name of function that this event is associated with.
+     */
+    functionName: string;
+
+    /**
+     * Short-lived presigned HTTPS URL the recipient can GET to download the rendered
+     * docx. Bearer-token semantics: possession equals access. Treat as a credential —
+     * do not log full URLs or store beyond the delivery window. The URL expires after
+     * the platform-configured TTL; the next API serialization mints a fresh one.
+     */
+    outputDownloadURL: string;
+
+    /**
+     * The unique ID you use internally to refer to this data point, propagated from
+     * the original function input.
+     */
+    referenceID: string;
+
+    /**
+     * Wall-clock seconds spent validating the upstream JSON against the doc-type
+     * schema.
+     */
+    validationSeconds: number;
+
+    /**
+     * Unique identifier of workflow call that this event is associated with.
+     */
+    callID?: string;
+
+    /**
+     * Timestamp indicating when the event was created.
+     */
+    createdAt?: string;
+
+    eventType?: 'render';
+
+    /**
+     * Unique identifier of function call that this event is associated with.
+     */
+    functionCallID?: string;
+
+    /**
+     * The attempt number of the function call that created this event. 1 indexed.
+     */
+    functionCallTryNumber?: number;
+
+    /**
+     * Version number of function that this event is associated with.
+     */
+    functionVersionNum?: number;
+
+    /**
+     * The inbound email that triggered this event.
+     */
+    inboundEmail?: ErrorsAPI.InboundEmailEvent;
+
+    metadata?: RenderEvent.Metadata;
+
+    /**
+     * Unique identifier of workflow that this event is associated with.
+     */
+    workflowID?: string;
+
+    /**
+     * Name of workflow that this event is associated with.
+     */
+    workflowName?: string;
+
+    /**
+     * Version number of workflow that this event is associated with.
+     */
+    workflowVersionNum?: number;
+  }
+
+  export namespace RenderEvent {
+    export interface Metadata {
+      durationFunctionToEventSeconds?: number;
+    }
+  }
 }
 
 /**
@@ -1851,7 +1949,9 @@ export type InputType =
   | 'json'
   | 'heif'
   | 'm4a'
+  | 'mov'
   | 'mp3'
+  | 'mp4'
   | 'pdf'
   | 'png'
   | 'text'

package/src/resources/workflows/workflows.ts

@@ -803,6 +803,15 @@ export interface WorkflowCallParams {
    */
   wait?: boolean;
 
+  /**
+   * Body param: Optional bucket NAME that entities extracted by the workflow's parse
+   * function(s) land in. Resolution precedence: this call-level bucket > the parse
+   * function's configured `defaultBucket` > the account+environment default bucket.
+   * A non-existent bucket name returns 400, but only when the workflow contains a
+   * parse function; on a parse-free workflow it is ignored.
+   */
+  bucket?: string;
+
   /**
    * Body param: Your reference ID for tracking this call.
    */

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.27.0'; // x-release-please-version
+export const VERSION = '0.28.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.27.0";
+export declare const VERSION = "0.28.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.27.0";
+export declare const VERSION = "0.28.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.27.0'; // x-release-please-version
+exports.VERSION = '0.28.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.27.0'; // x-release-please-version
+export const VERSION = '0.28.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map