@teamkeel/functions-runtime 0.429.1 → 0.430.0

package/dist/index.d.cts

@@ -266,6 +266,111 @@ declare class Task$1 {
     cancel(): Promise<Task$1>;
 }
 
+/**
+ * FlowsAPI provides methods for starting and managing flows via the HTTP API.
+ */
+declare class FlowsAPI {
+    /**
+     * @param {string} flowName The name of the flow
+     * @param {Object|null} identity Optional identity object for authentication
+     * @param {string|null} authToken Optional auth token for authentication
+     */
+    constructor(flowName: string, identity?: Object | null, authToken?: string | null);
+    _flowName: string;
+    _identity: Object | null;
+    _authToken: string | null;
+    /**
+     * Returns a new FlowsAPI instance that will use the given identity for authentication.
+     * @param {Object} identity The identity object
+     * @returns {FlowsAPI} A new FlowsAPI instance with the identity set
+     */
+    withIdentity(identity: Object): FlowsAPI;
+    /**
+     * Returns a new FlowsAPI instance that will use the given auth token for authentication.
+     * @param {string} token The auth token to use
+     * @returns {FlowsAPI} A new FlowsAPI instance with the auth token set
+     */
+    withAuthToken(token: string): FlowsAPI;
+    /**
+     * Starts a new flow run with the given inputs.
+     * @param {Object} inputs The flow input data
+     * @returns {Promise<FlowRun>} The created flow run
+     */
+    start(inputs?: Object): Promise<FlowRun$1>;
+    /**
+     * Gets a flow run by ID.
+     * @param {string} runId The flow run ID
+     * @returns {Promise<FlowRun>} The flow run
+     */
+    get(runId: string): Promise<FlowRun$1>;
+    /**
+     * Lists flow runs for this flow.
+     * @param {Object} options Optional pagination options
+     * @param {number} options.limit Maximum number of runs to return
+     * @param {number} options.offset Offset for pagination
+     * @returns {Promise<{results: FlowRun[], pageInfo: Object}>} List of flow runs with pagination info
+     */
+    list(options?: {
+        limit: number;
+        offset: number;
+    }): Promise<{
+        results: FlowRun$1[];
+        pageInfo: Object;
+    }>;
+}
+/**
+ * FlowRun represents a flow run instance with action methods.
+ */
+declare class FlowRun$1 {
+    /**
+     * @param {Object} data The flow run data from the API
+     * @param {string} flowName The name of the flow
+     * @param {Object|null} identity Optional identity object for authentication
+     * @param {string|null} authToken Optional auth token for authentication
+     */
+    constructor(data: Object, flowName: string, identity?: Object | null, authToken?: string | null);
+    id: any;
+    name: any;
+    status: any;
+    inputs: any;
+    outputs: any;
+    steps: any;
+    pendingStep: any;
+    createdAt: Date | undefined;
+    updatedAt: Date | undefined;
+    completedAt: Date | undefined;
+    _flowName: string;
+    _identity: Object | null;
+    _authToken: string | null;
+    /**
+     * Returns a new FlowRun instance that will use the given identity for authentication.
+     * @param {Object} identity The identity object
+     * @returns {FlowRun} A new FlowRun instance with the identity set
+     */
+    withIdentity(identity: Object): FlowRun$1;
+    /**
+     * Returns a new FlowRun instance that will use the given auth token for authentication.
+     * @param {string} token The auth token to use
+     * @returns {FlowRun} A new FlowRun instance with the auth token set
+     */
+    withAuthToken(token: string): FlowRun$1;
+    /**
+     * Converts the flow run back to API data format for creating new instances.
+     * @returns {Object} The flow run data in API format
+     */
+    _toApiData(): Object;
+    /**
+     * Refreshes the flow run state from the API.
+     * @returns {Promise<FlowRun>} The updated flow run
+     */
+    refresh(): Promise<FlowRun$1>;
+    /**
+     * Cancels the flow run.
+     * @returns {Promise<FlowRun>} The updated flow run
+     */
+    cancel(): Promise<FlowRun$1>;
+}
+
 interface RequestHeadersMap {
     [key: string]: string;
 }
@@ -1127,7 +1232,7 @@ interface FlowContext<C extends FlowConfig, E, S, Id, I, H extends NullableHardw
     ui: UI<C, H>;
     complete: Complete<C, I>;
     env: E;
-    now: Date;
+    now(): Date;
     secrets: S;
     identity: Id;
 }
@@ -1203,7 +1308,7 @@ type StageConfigObject = {
 type StageConfig = string | StageConfigObject;
 declare function createFlowContext<C extends FlowConfig, E, S, Id, I, H extends NullableHardware>(runId: string, data: any, action: string | null, callback: string | null, element: string | null, spanId: string, ctx: {
     env: E;
-    now: Date;
+    now: () => Date;
     secrets: S;
     identity: Id;
 }): FlowContext<C, E, S, Id, I, H>;
@@ -1391,5 +1496,35 @@ type Task = {
 type TaskCreateOptions = {
     deferredUntil?: Date;
 };
+type FlowRunStatus = "PENDING" | "RUNNING" | "COMPLETED" | "FAILED" | "CANCELLED";
+type FlowRunStep = {
+    id: string;
+    name?: string;
+    status?: string;
+    data?: any;
+};
+type FlowRun = {
+    id: string;
+    name: string;
+    status: FlowRunStatus;
+    inputs?: any;
+    outputs?: any;
+    steps?: FlowRunStep[];
+    pendingStep?: FlowRunStep;
+    createdAt?: Date;
+    updatedAt?: Date;
+    completedAt?: Date;
+};
+type FlowListOptions = {
+    limit?: number;
+    offset?: number;
+};
+type FlowListResult = {
+    results: FlowRun[];
+    pageInfo: {
+        totalCount: number;
+        hasNextPage: boolean;
+    };
+};
 
-export { type BooleanArrayQueryWhereCondition, type BooleanArrayWhereCondition, type BooleanWhereCondition, type ContextAPI, type DateArrayQueryWhereCondition, type DateArrayWhereCondition, type DateQueryInput, type DateWhereCondition, Duration, type DurationString, type DurationWhereCondition, ErrorPresets, type Errors, type ExtractStageKeys, File, type FlowConfig, type FlowConfigAPI, type FlowContext, type FlowFunction, type FuncWithConfig, type FunctionConfig, type Hardware, type IDWhereCondition, InlineFile, ModelAPI, NonRetriableError, type NullableHardware, type NumberArrayQueryWhereCondition, type NumberArrayWhereCondition, type NumberWhereCondition, PERMISSION_STATE, type PageInfo, Permissions, type Printer, type RelativeDateString, RequestHeaders, type Response, RetryBackoffExponential, RetryBackoffLinear, RetryConstant, STEP_STATUS, STEP_TYPE, type SortDirection, type Step, type StringArrayQueryWhereCondition, type StringArrayWhereCondition, type StringWhereCondition, type Task, TaskAPI, type TaskCreateOptions, type TaskStatus, type TimestampQueryInput, type UI, type UIApiResponses, checkBuiltInPermissions, createFlowContext, handleFlow, handleJob, handleRequest, handleRoute, handleSubscriber, ksuid, tracing, useDatabase };
+export { type BooleanArrayQueryWhereCondition, type BooleanArrayWhereCondition, type BooleanWhereCondition, type ContextAPI, type DateArrayQueryWhereCondition, type DateArrayWhereCondition, type DateQueryInput, type DateWhereCondition, Duration, type DurationString, type DurationWhereCondition, ErrorPresets, type Errors, type ExtractStageKeys, File, type FlowConfig, type FlowConfigAPI, type FlowContext, type FlowFunction, type FlowListOptions, type FlowListResult, type FlowRun, type FlowRunStatus, type FlowRunStep, FlowsAPI, type FuncWithConfig, type FunctionConfig, type Hardware, type IDWhereCondition, InlineFile, ModelAPI, NonRetriableError, type NullableHardware, type NumberArrayQueryWhereCondition, type NumberArrayWhereCondition, type NumberWhereCondition, PERMISSION_STATE, type PageInfo, Permissions, type Printer, type RelativeDateString, RequestHeaders, type Response, RetryBackoffExponential, RetryBackoffLinear, RetryConstant, STEP_STATUS, STEP_TYPE, type SortDirection, type Step, type StringArrayQueryWhereCondition, type StringArrayWhereCondition, type StringWhereCondition, type Task, TaskAPI, type TaskCreateOptions, type TaskStatus, type TimestampQueryInput, type UI, type UIApiResponses, checkBuiltInPermissions, createFlowContext, handleFlow, handleJob, handleRequest, handleRoute, handleSubscriber, ksuid, tracing, useDatabase };

package/dist/index.d.ts

@@ -266,6 +266,111 @@ declare class Task$1 {
     cancel(): Promise<Task$1>;
 }
 
+/**
+ * FlowsAPI provides methods for starting and managing flows via the HTTP API.
+ */
+declare class FlowsAPI {
+    /**
+     * @param {string} flowName The name of the flow
+     * @param {Object|null} identity Optional identity object for authentication
+     * @param {string|null} authToken Optional auth token for authentication
+     */
+    constructor(flowName: string, identity?: Object | null, authToken?: string | null);
+    _flowName: string;
+    _identity: Object | null;
+    _authToken: string | null;
+    /**
+     * Returns a new FlowsAPI instance that will use the given identity for authentication.
+     * @param {Object} identity The identity object
+     * @returns {FlowsAPI} A new FlowsAPI instance with the identity set
+     */
+    withIdentity(identity: Object): FlowsAPI;
+    /**
+     * Returns a new FlowsAPI instance that will use the given auth token for authentication.
+     * @param {string} token The auth token to use
+     * @returns {FlowsAPI} A new FlowsAPI instance with the auth token set
+     */
+    withAuthToken(token: string): FlowsAPI;
+    /**
+     * Starts a new flow run with the given inputs.
+     * @param {Object} inputs The flow input data
+     * @returns {Promise<FlowRun>} The created flow run
+     */
+    start(inputs?: Object): Promise<FlowRun$1>;
+    /**
+     * Gets a flow run by ID.
+     * @param {string} runId The flow run ID
+     * @returns {Promise<FlowRun>} The flow run
+     */
+    get(runId: string): Promise<FlowRun$1>;
+    /**
+     * Lists flow runs for this flow.
+     * @param {Object} options Optional pagination options
+     * @param {number} options.limit Maximum number of runs to return
+     * @param {number} options.offset Offset for pagination
+     * @returns {Promise<{results: FlowRun[], pageInfo: Object}>} List of flow runs with pagination info
+     */
+    list(options?: {
+        limit: number;
+        offset: number;
+    }): Promise<{
+        results: FlowRun$1[];
+        pageInfo: Object;
+    }>;
+}
+/**
+ * FlowRun represents a flow run instance with action methods.
+ */
+declare class FlowRun$1 {
+    /**
+     * @param {Object} data The flow run data from the API
+     * @param {string} flowName The name of the flow
+     * @param {Object|null} identity Optional identity object for authentication
+     * @param {string|null} authToken Optional auth token for authentication
+     */
+    constructor(data: Object, flowName: string, identity?: Object | null, authToken?: string | null);
+    id: any;
+    name: any;
+    status: any;
+    inputs: any;
+    outputs: any;
+    steps: any;
+    pendingStep: any;
+    createdAt: Date | undefined;
+    updatedAt: Date | undefined;
+    completedAt: Date | undefined;
+    _flowName: string;
+    _identity: Object | null;
+    _authToken: string | null;
+    /**
+     * Returns a new FlowRun instance that will use the given identity for authentication.
+     * @param {Object} identity The identity object
+     * @returns {FlowRun} A new FlowRun instance with the identity set
+     */
+    withIdentity(identity: Object): FlowRun$1;
+    /**
+     * Returns a new FlowRun instance that will use the given auth token for authentication.
+     * @param {string} token The auth token to use
+     * @returns {FlowRun} A new FlowRun instance with the auth token set
+     */
+    withAuthToken(token: string): FlowRun$1;
+    /**
+     * Converts the flow run back to API data format for creating new instances.
+     * @returns {Object} The flow run data in API format
+     */
+    _toApiData(): Object;
+    /**
+     * Refreshes the flow run state from the API.
+     * @returns {Promise<FlowRun>} The updated flow run
+     */
+    refresh(): Promise<FlowRun$1>;
+    /**
+     * Cancels the flow run.
+     * @returns {Promise<FlowRun>} The updated flow run
+     */
+    cancel(): Promise<FlowRun$1>;
+}
+
 interface RequestHeadersMap {
     [key: string]: string;
 }
@@ -1127,7 +1232,7 @@ interface FlowContext<C extends FlowConfig, E, S, Id, I, H extends NullableHardw
     ui: UI<C, H>;
     complete: Complete<C, I>;
     env: E;
-    now: Date;
+    now(): Date;
     secrets: S;
     identity: Id;
 }
@@ -1203,7 +1308,7 @@ type StageConfigObject = {
 type StageConfig = string | StageConfigObject;
 declare function createFlowContext<C extends FlowConfig, E, S, Id, I, H extends NullableHardware>(runId: string, data: any, action: string | null, callback: string | null, element: string | null, spanId: string, ctx: {
     env: E;
-    now: Date;
+    now: () => Date;
     secrets: S;
     identity: Id;
 }): FlowContext<C, E, S, Id, I, H>;
@@ -1391,5 +1496,35 @@ type Task = {
 type TaskCreateOptions = {
     deferredUntil?: Date;
 };
+type FlowRunStatus = "PENDING" | "RUNNING" | "COMPLETED" | "FAILED" | "CANCELLED";
+type FlowRunStep = {
+    id: string;
+    name?: string;
+    status?: string;
+    data?: any;
+};
+type FlowRun = {
+    id: string;
+    name: string;
+    status: FlowRunStatus;
+    inputs?: any;
+    outputs?: any;
+    steps?: FlowRunStep[];
+    pendingStep?: FlowRunStep;
+    createdAt?: Date;
+    updatedAt?: Date;
+    completedAt?: Date;
+};
+type FlowListOptions = {
+    limit?: number;
+    offset?: number;
+};
+type FlowListResult = {
+    results: FlowRun[];
+    pageInfo: {
+        totalCount: number;
+        hasNextPage: boolean;
+    };
+};
 
-export { type BooleanArrayQueryWhereCondition, type BooleanArrayWhereCondition, type BooleanWhereCondition, type ContextAPI, type DateArrayQueryWhereCondition, type DateArrayWhereCondition, type DateQueryInput, type DateWhereCondition, Duration, type DurationString, type DurationWhereCondition, ErrorPresets, type Errors, type ExtractStageKeys, File, type FlowConfig, type FlowConfigAPI, type FlowContext, type FlowFunction, type FuncWithConfig, type FunctionConfig, type Hardware, type IDWhereCondition, InlineFile, ModelAPI, NonRetriableError, type NullableHardware, type NumberArrayQueryWhereCondition, type NumberArrayWhereCondition, type NumberWhereCondition, PERMISSION_STATE, type PageInfo, Permissions, type Printer, type RelativeDateString, RequestHeaders, type Response, RetryBackoffExponential, RetryBackoffLinear, RetryConstant, STEP_STATUS, STEP_TYPE, type SortDirection, type Step, type StringArrayQueryWhereCondition, type StringArrayWhereCondition, type StringWhereCondition, type Task, TaskAPI, type TaskCreateOptions, type TaskStatus, type TimestampQueryInput, type UI, type UIApiResponses, checkBuiltInPermissions, createFlowContext, handleFlow, handleJob, handleRequest, handleRoute, handleSubscriber, ksuid, tracing, useDatabase };
+export { type BooleanArrayQueryWhereCondition, type BooleanArrayWhereCondition, type BooleanWhereCondition, type ContextAPI, type DateArrayQueryWhereCondition, type DateArrayWhereCondition, type DateQueryInput, type DateWhereCondition, Duration, type DurationString, type DurationWhereCondition, ErrorPresets, type Errors, type ExtractStageKeys, File, type FlowConfig, type FlowConfigAPI, type FlowContext, type FlowFunction, type FlowListOptions, type FlowListResult, type FlowRun, type FlowRunStatus, type FlowRunStep, FlowsAPI, type FuncWithConfig, type FunctionConfig, type Hardware, type IDWhereCondition, InlineFile, ModelAPI, NonRetriableError, type NullableHardware, type NumberArrayQueryWhereCondition, type NumberArrayWhereCondition, type NumberWhereCondition, PERMISSION_STATE, type PageInfo, Permissions, type Printer, type RelativeDateString, RequestHeaders, type Response, RetryBackoffExponential, RetryBackoffLinear, RetryConstant, STEP_STATUS, STEP_TYPE, type SortDirection, type Step, type StringArrayQueryWhereCondition, type StringArrayWhereCondition, type StringWhereCondition, type Task, TaskAPI, type TaskCreateOptions, type TaskStatus, type TimestampQueryInput, type UI, type UIApiResponses, checkBuiltInPermissions, createFlowContext, handleFlow, handleJob, handleRequest, handleRoute, handleSubscriber, ksuid, tracing, useDatabase };

package/dist/index.js

@@ -1030,8 +1030,12 @@ var opMapping = {
   onOrBefore: { op: "<=" },
   after: { op: ">" },
   onOrAfter: { op: ">=" },
-  equals: { op: sql2`is not distinct from` },
-  notEquals: { op: sql2`is distinct from` },
+  equals: {
+    op: /* @__PURE__ */ __name((v) => v === null || Array.isArray(v) ? sql2`is not distinct from` : "=", "op")
+  },
+  notEquals: {
+    op: /* @__PURE__ */ __name((v) => v === null || Array.isArray(v) ? sql2`is distinct from` : "!=", "op")
+  },
   equalsRelative: {
     op: sql2`BETWEEN`,
     value: /* @__PURE__ */ __name((v) => sql2`${sql2.raw(
@@ -1086,7 +1090,8 @@ function applyWhereConditions(context6, qb, where = {}) {
     }
     const fieldName = `${context6.tableAlias()}.${snakeCase(key)}`;
     if (Object.prototype.toString.call(v) !== "[object Object]") {
-      qb = qb.where(fieldName, sql2`is not distinct from`, sql2`${v}`);
+      const operator = v === null || Array.isArray(v) ? sql2`is not distinct from` : "=";
+      qb = qb.where(fieldName, operator, sql2`${v}`);
       continue;
     }
     for (const op of Object.keys(v)) {
@@ -1103,9 +1108,10 @@ function applyWhereConditions(context6, qb, where = {}) {
           );
         }
       } else {
+        const operator = typeof mapping.op === "function" ? mapping.op(v[op]) : mapping.op;
         qb = qb.where(
           fieldName,
-          mapping.op,
+          operator,
           mapping.value ? mapping.value(v[op]) : sql2`${v[op]}`
         );
       }
@@ -2038,6 +2044,294 @@ var TaskAPI = class _TaskAPI {
   }
 };
 
+// src/FlowsAPI.js
+import jwt2 from "jsonwebtoken";
+function buildHeaders2(identity, authToken) {
+  const headers = { "Content-Type": "application/json" };
+  if (identity !== null) {
+    const base64pk = process.env.KEEL_PRIVATE_KEY;
+    let privateKey = void 0;
+    if (base64pk) {
+      privateKey = Buffer.from(base64pk, "base64").toString("utf8");
+    }
+    headers["Authorization"] = "Bearer " + jwt2.sign({}, privateKey, {
+      algorithm: privateKey ? "RS256" : "none",
+      expiresIn: 60 * 60 * 24,
+      subject: identity.id,
+      issuer: "https://keel.so"
+    });
+  }
+  if (authToken !== null) {
+    headers["Authorization"] = "Bearer " + authToken;
+  }
+  return headers;
+}
+__name(buildHeaders2, "buildHeaders");
+function getApiUrl2() {
+  const apiUrl = process.env.KEEL_API_URL;
+  if (!apiUrl) {
+    throw new Error("KEEL_API_URL environment variable is not set");
+  }
+  return apiUrl;
+}
+__name(getApiUrl2, "getApiUrl");
+var FlowRun = class _FlowRun {
+  static {
+    __name(this, "FlowRun");
+  }
+  /**
+   * @param {Object} data The flow run data from the API
+   * @param {string} flowName The name of the flow
+   * @param {Object|null} identity Optional identity object for authentication
+   * @param {string|null} authToken Optional auth token for authentication
+   */
+  constructor(data, flowName, identity = null, authToken = null) {
+    this.id = data.id;
+    this.name = data.name;
+    this.status = data.status;
+    this.inputs = data.inputs;
+    this.outputs = data.outputs;
+    this.steps = data.steps;
+    this.pendingStep = data.pendingStep;
+    this.createdAt = data.createdAt ? new Date(data.createdAt) : void 0;
+    this.updatedAt = data.updatedAt ? new Date(data.updatedAt) : void 0;
+    this.completedAt = data.completedAt ? new Date(data.completedAt) : void 0;
+    this._flowName = flowName;
+    this._identity = identity;
+    this._authToken = authToken;
+  }
+  /**
+   * Returns a new FlowRun instance that will use the given identity for authentication.
+   * @param {Object} identity The identity object
+   * @returns {FlowRun} A new FlowRun instance with the identity set
+   */
+  withIdentity(identity) {
+    const data = this._toApiData();
+    return new _FlowRun(data, this._flowName, identity, null);
+  }
+  /**
+   * Returns a new FlowRun instance that will use the given auth token for authentication.
+   * @param {string} token The auth token to use
+   * @returns {FlowRun} A new FlowRun instance with the auth token set
+   */
+  withAuthToken(token) {
+    const data = this._toApiData();
+    return new _FlowRun(data, this._flowName, null, token);
+  }
+  /**
+   * Converts the flow run back to API data format for creating new instances.
+   * @returns {Object} The flow run data in API format
+   */
+  _toApiData() {
+    return {
+      id: this.id,
+      name: this.name,
+      status: this.status,
+      inputs: this.inputs,
+      outputs: this.outputs,
+      steps: this.steps,
+      pendingStep: this.pendingStep,
+      createdAt: this.createdAt?.toISOString(),
+      updatedAt: this.updatedAt?.toISOString(),
+      completedAt: this.completedAt?.toISOString()
+    };
+  }
+  /**
+   * Refreshes the flow run state from the API.
+   * @returns {Promise<FlowRun>} The updated flow run
+   */
+  async refresh() {
+    const name = spanNameForModelAPI(this._flowName, "refresh");
+    return withSpan(name, async () => {
+      const apiUrl = getApiUrl2();
+      const url = `${apiUrl}/flows/json/${this._flowName}/${this.id}`;
+      const response = await fetch(url, {
+        method: "GET",
+        headers: buildHeaders2(this._identity, this._authToken)
+      });
+      if (!response.ok) {
+        const errorBody = await response.json().catch(() => ({}));
+        throw new Error(
+          `Failed to refresh flow run: ${response.status} ${response.statusText} - ${errorBody.message || JSON.stringify(errorBody)}`
+        );
+      }
+      const result = await response.json();
+      return new _FlowRun(
+        result,
+        this._flowName,
+        this._identity,
+        this._authToken
+      );
+    });
+  }
+  /**
+   * Cancels the flow run.
+   * @returns {Promise<FlowRun>} The updated flow run
+   */
+  async cancel() {
+    const name = spanNameForModelAPI(this._flowName, "cancel");
+    return withSpan(name, async () => {
+      const apiUrl = getApiUrl2();
+      const url = `${apiUrl}/flows/json/${this._flowName}/${this.id}/cancel`;
+      const response = await fetch(url, {
+        method: "POST",
+        headers: buildHeaders2(this._identity, this._authToken)
+      });
+      if (!response.ok) {
+        const errorBody = await response.json().catch(() => ({}));
+        throw new Error(
+          `Failed to cancel flow run: ${response.status} ${response.statusText} - ${errorBody.message || JSON.stringify(errorBody)}`
+        );
+      }
+      const result = await response.json();
+      return new _FlowRun(
+        result,
+        this._flowName,
+        this._identity,
+        this._authToken
+      );
+    });
+  }
+};
+var FlowsAPI = class _FlowsAPI {
+  static {
+    __name(this, "FlowsAPI");
+  }
+  /**
+   * @param {string} flowName The name of the flow
+   * @param {Object|null} identity Optional identity object for authentication
+   * @param {string|null} authToken Optional auth token for authentication
+   */
+  constructor(flowName, identity = null, authToken = null) {
+    this._flowName = flowName;
+    this._identity = identity;
+    this._authToken = authToken;
+  }
+  /**
+   * Returns a new FlowsAPI instance that will use the given identity for authentication.
+   * @param {Object} identity The identity object
+   * @returns {FlowsAPI} A new FlowsAPI instance with the identity set
+   */
+  withIdentity(identity) {
+    return new _FlowsAPI(this._flowName, identity, null);
+  }
+  /**
+   * Returns a new FlowsAPI instance that will use the given auth token for authentication.
+   * @param {string} token The auth token to use
+   * @returns {FlowsAPI} A new FlowsAPI instance with the auth token set
+   */
+  withAuthToken(token) {
+    return new _FlowsAPI(this._flowName, null, token);
+  }
+  /**
+   * Starts a new flow run with the given inputs.
+   * @param {Object} inputs The flow input data
+   * @returns {Promise<FlowRun>} The created flow run
+   */
+  async start(inputs = {}) {
+    const name = spanNameForModelAPI(this._flowName, "start");
+    return withSpan(name, async () => {
+      const apiUrl = getApiUrl2();
+      const url = `${apiUrl}/flows/json/${this._flowName}`;
+      const response = await fetch(url, {
+        method: "POST",
+        headers: buildHeaders2(this._identity, this._authToken),
+        body: JSON.stringify(inputs)
+      });
+      if (!response.ok) {
+        const errorBody = await response.json().catch(() => ({}));
+        throw new Error(
+          `Failed to start flow: ${response.status} ${response.statusText} - ${errorBody.message || JSON.stringify(errorBody)}`
+        );
+      }
+      const result = await response.json();
+      return new FlowRun(
+        result,
+        this._flowName,
+        this._identity,
+        this._authToken
+      );
+    });
+  }
+  /**
+   * Gets a flow run by ID.
+   * @param {string} runId The flow run ID
+   * @returns {Promise<FlowRun>} The flow run
+   */
+  async get(runId) {
+    const name = spanNameForModelAPI(this._flowName, "get");
+    return withSpan(name, async () => {
+      const apiUrl = getApiUrl2();
+      const url = `${apiUrl}/flows/json/${this._flowName}/${runId}`;
+      const response = await fetch(url, {
+        method: "GET",
+        headers: buildHeaders2(this._identity, this._authToken)
+      });
+      if (!response.ok) {
+        const errorBody = await response.json().catch(() => ({}));
+        throw new Error(
+          `Failed to get flow run: ${response.status} ${response.statusText} - ${errorBody.message || JSON.stringify(errorBody)}`
+        );
+      }
+      const result = await response.json();
+      return new FlowRun(
+        result,
+        this._flowName,
+        this._identity,
+        this._authToken
+      );
+    });
+  }
+  /**
+   * Lists flow runs for this flow.
+   * @param {Object} options Optional pagination options
+   * @param {number} options.limit Maximum number of runs to return
+   * @param {number} options.offset Offset for pagination
+   * @returns {Promise<{results: FlowRun[], pageInfo: Object}>} List of flow runs with pagination info
+   */
+  async list(options = {}) {
+    const name = spanNameForModelAPI(this._flowName, "list");
+    return withSpan(name, async () => {
+      const apiUrl = getApiUrl2();
+      const params = new URLSearchParams();
+      if (options.limit) params.set("limit", options.limit.toString());
+      if (options.offset) params.set("offset", options.offset.toString());
+      const url = `${apiUrl}/flows/json/${this._flowName}${params.toString() ? "?" + params.toString() : ""}`;
+      const response = await fetch(url, {
+        method: "GET",
+        headers: buildHeaders2(this._identity, this._authToken)
+      });
+      if (!response.ok) {
+        const errorBody = await response.json().catch(() => ({}));
+        throw new Error(
+          `Failed to list flow runs: ${response.status} ${response.statusText} - ${errorBody.message || JSON.stringify(errorBody)}`
+        );
+      }
+      const result = await response.json();
+      if (Array.isArray(result)) {
+        return {
+          results: result.map(
+            (run) => new FlowRun(run, this._flowName, this._identity, this._authToken)
+          ),
+          pageInfo: {
+            totalCount: result.length,
+            hasNextPage: false
+          }
+        };
+      }
+      return {
+        results: (result.results || []).map(
+          (run) => new FlowRun(run, this._flowName, this._identity, this._authToken)
+        ),
+        pageInfo: result.pageInfo || {
+          totalCount: (result.results || []).length,
+          hasNextPage: false
+        }
+      };
+    });
+  }
+};
+
 // src/RequestHeaders.ts
 var RequestHeaders = class {
   /**
@@ -2215,6 +2509,9 @@ __name(tryExecuteFunction, "tryExecuteFunction");
 // src/handleRequest.js
 import * as opentelemetry2 from "@opentelemetry/api";
 async function handleRequest(request, config) {
+  if (request.method === "__ping") {
+    return createJSONRPCSuccessResponse(request.id, { status: "ok" });
+  }
   const activeContext = opentelemetry2.propagation.extract(
     opentelemetry2.context.active(),
     request.meta?.tracing
@@ -3837,6 +4134,7 @@ export {
   Duration,
   ErrorPresets,
   File,
+  FlowsAPI,
   InlineFile,
   KSUID2 as KSUID,
   ModelAPI,