@narrative.io/data-collaboration-sdk-ts 2.85.0 → 2.89.0

package/README.md

@@ -326,14 +326,14 @@ Both approaches use the SDK’s **built output** in `build/`, exactly like the p
 
 ### Prerequisites
 
-- Node & npm
+- Bun (this project uses bun as its package manager)
 - This repo builds TypeScript to `build/`
 - This repo includes `scripts/ensureBuild.js` to verify artifacts exist
 
 ```bash
 # In the SDK repo (this one)
-npm i
-npm run build              # one-time; emits build/**
+bun install
+bun run build              # one-time; emits build/**
 node scripts/ensureBuild.js
 ```
 
@@ -344,41 +344,38 @@ node scripts/ensureBuild.js
 1. **Keep the SDK building on save**
    In the SDK repo (leave this running):
    ```bash
-   npm run dev             # tsc -w → continuously updates build/**
+   bun run dev             # tsc -w → continuously updates build/**
    ```
 
 2. **Register the SDK globally**
    In the SDK repo (new terminal):
    ```bash
-   npm run link:global     # runs ensureBuild + npm link
+   bun run link:global     # runs ensureBuild + bun link
    ```
 
 3. **Link into your consumer app**
    In your app repo (e.g., Nuxt project):
    ```bash
-   # optional safety if a link exists
-   npm unlink @narrative.io/data-collaboration-sdk-ts --no-save || true
-
-   # link the globally-registered SDK into this app’s node_modules
-   npm link @narrative.io/data-collaboration-sdk-ts
+   # link the globally-registered SDK into this app's node_modules
+   bun link @narrative.io/data-collaboration-sdk-ts
    ```
 
 4. **Verify the app resolves to your local SDK**
    ```bash
    node -e "console.log(require.resolve('@narrative.io/data-collaboration-sdk-ts/package.json'))"
    ```
-   You should see a path inside your SDK repo (not a versioned folder under the app’s `node_modules`).
+   You should see a path inside your SDK repo (not a versioned folder under the app's `node_modules`).
 
 5. **Run your app**
    ```bash
-   npm run dev
+   bun run dev
    ```
    Edit files under `SDK/src/**` → the watcher writes to `build/**` → your app hot-reloads.
 
 **Revert to the registry version (in the app):**
 ```bash
-npm unlink @narrative.io/data-collaboration-sdk-ts --no-save
-npm i
+bun remove @narrative.io/data-collaboration-sdk-ts
+bun add @narrative.io/data-collaboration-sdk-ts
 ```
 
 ---
@@ -388,20 +385,20 @@ npm i
 1. **Pack the SDK (same artifact you would publish)**
    ```bash
    # in the SDK repo
-   npm run build
-   npm pack                 # creates ./<name>-<version>.tgz
+   bun run build
+   bun run pack:dist        # creates ./<name>-<version>.tgz
    ```
 
 2. **Install the tarball in the app**
    ```bash
    # in the app repo
-   npm i /ABS/PATH/TO/<name>-<version>.tgz
-   npm run dev
+   bun add /ABS/PATH/TO/<name>-<version>.tgz
+   bun run dev
    ```
 
 **Revert to a registry version (in the app):**
 ```bash
-npm i @narrative.io/data-collaboration-sdk-ts@<semver>
+bun add @narrative.io/data-collaboration-sdk-ts@<semver>
 ```
 
 ---
@@ -428,25 +425,24 @@ npm i @narrative.io/data-collaboration-sdk-ts@<semver>
 
 ```bash
 # SDK (this repo)
-npm i
-npm run build
-npm run dev
-npm run link:global
+bun install
+bun run build
+bun run dev
+bun run link:global
 
 # App (consumer repo)
-npm unlink @narrative.io/data-collaboration-sdk-ts --no-save || true
-npm link @narrative.io/data-collaboration-sdk-ts
-npm run dev
+bun link @narrative.io/data-collaboration-sdk-ts
+bun run dev
 ```
 
 Alternative (publish-parity):
 
 ```bash
 # SDK
-npm run build
-npm pack
+bun run build
+bun run pack:dist
 
 # App
-npm i /ABS/PATH/TO/*.tgz
-npm run dev
+bun add /ABS/PATH/TO/*.tgz
+bun run dev
 ```

package/build/authentication/index.d.ts

@@ -1,5 +1,5 @@
 import { BaseApi } from "../base-api";
-import type { ApiToken, LoggedInUser, LoginRequest, LoginResponse, RegisterRequest, RegisterResponse, RegistrationStatus, RegistrationStatusRequest, RegistrationStatusResponse, StytchToken, UserRole } from "./types";
+import type { ApiToken, LoggedInUser, LoginRequest, LoginResponse, RegisterRequest, RegisterResponse, RegistrationStatus, RegistrationStatusB2bRequest, RegistrationStatusRequest, RegistrationStatusResponse, StytchToken, UserRole } from "./types";
 /**
  * A class for accessing the Authentication API
  * @extends BaseApi
@@ -8,23 +8,56 @@ declare class AuthenticationApi extends BaseApi {
     /**
      * Logs in the user.
      *
+     * @see https://docs.narrative.io/open-api#tag/Authentication/paths/~1authentication~1login/post
+     *
      * @param {LoginRequest} loginRequest - The login request object.
      * @returns {Promise<LoginResponse>} - A promise that resolves to the login response.
      */
     login(loginRequest: LoginRequest): Promise<LoginResponse>;
+    /**
+     * Logs in a B2B user.
+     *
+     * @see https://docs.narrative.io/open-api#tag/Authentication/paths/~1authentication~1b2b~1login/post
+     *
+     * @param {LoginRequest} loginRequest - The login request object.
+     * @returns {Promise<LoginResponse>} - A promise that resolves to the login response.
+     */
+    loginB2b(loginRequest: LoginRequest): Promise<LoginResponse>;
     /**
      * Registers a new user.
      *
+     * @see https://docs.narrative.io/open-api#tag/Authentication/paths/~1authentication~1register/post
+     *
      * @param {RegisterRequest} registerRequest - The register request object.
      * @returns {Promise<RegisterResponse>} - A promise that resolves to the register response.
      */
     register(registerRequest: RegisterRequest): Promise<RegisterResponse>;
+    /**
+     * Registers a new B2B user.
+     *
+     * @see https://docs.narrative.io/open-api#tag/Authentication/paths/~1authentication~1b2b~1register/post
+     *
+     * @param {RegisterRequest} registerRequest - The register request object.
+     * @returns {Promise<RegisterResponse>} - A promise that resolves to the register response.
+     */
+    registerB2b(registerRequest: RegisterRequest): Promise<RegisterResponse>;
     /**
      * Checks the resgistration status of a user.
      *
-     * @param {RegistrationStatusRequest} statusRewquest - request payload of user login for whom to check status.
+     * @see https://docs.narrative.io/open-api#tag/Authentication/paths/~1authentication~1registration-status/post
+     *
+     * @param {RegistrationStatusRequest} statusRequest - request payload of user login for whom to check status.
      * @returns {Promise<RegistrationStatusResponse>} - A promise that resolves to the response.
      */
     checkRegistrationStatus(statusRequest: RegistrationStatusRequest): Promise<RegistrationStatusResponse>;
+    /**
+     * Checks the registration status of a B2B user.
+     *
+     * @see https://docs.narrative.io/open-api#tag/Authentication/paths/~1authentication~1b2b~1registration-status/post
+     *
+     * @param {RegistrationStatusB2bRequest} statusRequest - The B2B registration status request.
+     * @returns {Promise<RegistrationStatusResponse>} - A promise that resolves to the response.
+     */
+    checkRegistrationStatusB2b(statusRequest: RegistrationStatusB2bRequest): Promise<RegistrationStatusResponse>;
 }
-export { type LoginRequest, type LoginResponse, type RegisterRequest, type RegisterResponse, type LoggedInUser, type StytchToken, type ApiToken, type UserRole, type RegistrationStatus, type RegistrationStatusRequest, type RegistrationStatusResponse, AuthenticationApi, };
+export { type LoginRequest, type LoginResponse, type RegisterRequest, type RegisterResponse, type LoggedInUser, type StytchToken, type ApiToken, type UserRole, type RegistrationStatus, type RegistrationStatusB2bRequest, type RegistrationStatusRequest, type RegistrationStatusResponse, AuthenticationApi, };

package/build/authentication/index.js

@@ -14,29 +14,68 @@ class AuthenticationApi extends BaseApi {
     /**
      * Logs in the user.
      *
+     * @see https://docs.narrative.io/open-api#tag/Authentication/paths/~1authentication~1login/post
+     *
      * @param {LoginRequest} loginRequest - The login request object.
      * @returns {Promise<LoginResponse>} - A promise that resolves to the login response.
      */
     async login(loginRequest) {
         return await this.post(`${resourceName}/login`, loginRequest);
     }
+    /**
+     * Logs in a B2B user.
+     *
+     * @see https://docs.narrative.io/open-api#tag/Authentication/paths/~1authentication~1b2b~1login/post
+     *
+     * @param {LoginRequest} loginRequest - The login request object.
+     * @returns {Promise<LoginResponse>} - A promise that resolves to the login response.
+     */
+    async loginB2b(loginRequest) {
+        return await this.post(`${resourceName}/b2b/login`, loginRequest);
+    }
     /**
      * Registers a new user.
      *
+     * @see https://docs.narrative.io/open-api#tag/Authentication/paths/~1authentication~1register/post
+     *
      * @param {RegisterRequest} registerRequest - The register request object.
      * @returns {Promise<RegisterResponse>} - A promise that resolves to the register response.
      */
     async register(registerRequest) {
         return await this.post(`${resourceName}/register`, registerRequest);
     }
+    /**
+     * Registers a new B2B user.
+     *
+     * @see https://docs.narrative.io/open-api#tag/Authentication/paths/~1authentication~1b2b~1register/post
+     *
+     * @param {RegisterRequest} registerRequest - The register request object.
+     * @returns {Promise<RegisterResponse>} - A promise that resolves to the register response.
+     */
+    async registerB2b(registerRequest) {
+        return await this.post(`${resourceName}/b2b/register`, registerRequest);
+    }
     /**
      * Checks the resgistration status of a user.
      *
-     * @param {RegistrationStatusRequest} statusRewquest - request payload of user login for whom to check status.
+     * @see https://docs.narrative.io/open-api#tag/Authentication/paths/~1authentication~1registration-status/post
+     *
+     * @param {RegistrationStatusRequest} statusRequest - request payload of user login for whom to check status.
      * @returns {Promise<RegistrationStatusResponse>} - A promise that resolves to the response.
      */
     async checkRegistrationStatus(statusRequest) {
         return await this.post(`${resourceName}/registration-status`, statusRequest);
     }
+    /**
+     * Checks the registration status of a B2B user.
+     *
+     * @see https://docs.narrative.io/open-api#tag/Authentication/paths/~1authentication~1b2b~1registration-status/post
+     *
+     * @param {RegistrationStatusB2bRequest} statusRequest - The B2B registration status request.
+     * @returns {Promise<RegistrationStatusResponse>} - A promise that resolves to the response.
+     */
+    async checkRegistrationStatusB2b(statusRequest) {
+        return await this.post(`${resourceName}/b2b/registration-status`, statusRequest);
+    }
 }
 export { AuthenticationApi, };

package/build/authentication/types.d.ts

@@ -44,6 +44,10 @@ export interface RegistrationStatusRequest {
     stytch_token: StytchToken;
     session_duration_minutes?: number;
 }
+export interface RegistrationStatusB2bRequest {
+    stytch_token: string;
+    session_duration_minutes: number;
+}
 export interface RegistrationStatusResponse {
     status: RegistrationStatus;
     email: string;

package/build/datasets/index.d.ts

@@ -44,6 +44,30 @@ export declare class DatasetApi extends BaseApi {
      * @returns {Promise<Dataset>} A promise that resolves with the newly created dataset.
      */
     createDataset(request: CreateDatasetRequest): Promise<Dataset>;
+    /**
+     * Adds tags to an existing dataset without removing existing tags.
+     * Duplicate tags will be ignored.
+     *
+     * **Note**: This method performs a read-modify-write operation.
+     * Concurrent calls may result in lost updates.
+     *
+     * @param {number} datasetId - The ID of the dataset to add tags to.
+     * @param {string[]} tags - The tags to add to the dataset. Empty array returns the dataset unchanged.
+     * @returns {Promise<Dataset>} A promise that resolves with the updated dataset.
+     */
+    addTags(datasetId: number, tags: string[]): Promise<Dataset>;
+    /**
+     * Removes specified tags from an existing dataset.
+     * Tags that don't exist on the dataset will be ignored.
+     *
+     * **Note**: This method performs a read-modify-write operation.
+     * Concurrent calls may result in lost updates.
+     *
+     * @param {number} datasetId - The ID of the dataset to remove tags from.
+     * @param {string[]} tags - The tags to remove from the dataset. Empty array returns the dataset unchanged.
+     * @returns {Promise<Dataset>} A promise that resolves with the updated dataset.
+     */
+    removeTags(datasetId: number, tags: string[]): Promise<Dataset>;
     /**
      * Activates a dataset with the specified dataset ID.
      *

package/build/datasets/index.js

@@ -51,6 +51,53 @@ export class DatasetApi extends BaseApi {
     async createDataset(request) {
         return await this.post(`${resourceName}`, request);
     }
+    /**
+     * Adds tags to an existing dataset without removing existing tags.
+     * Duplicate tags will be ignored.
+     *
+     * **Note**: This method performs a read-modify-write operation.
+     * Concurrent calls may result in lost updates.
+     *
+     * @param {number} datasetId - The ID of the dataset to add tags to.
+     * @param {string[]} tags - The tags to add to the dataset. Empty array returns the dataset unchanged.
+     * @returns {Promise<Dataset>} A promise that resolves with the updated dataset.
+     */
+    async addTags(datasetId, tags) {
+        if (tags.length === 0) {
+            return await this.getDataset(datasetId);
+        }
+        const dataset = await this.getDataset(datasetId);
+        const existingTags = dataset.tags ?? [];
+        const uniqueNewTags = tags.filter((tag) => !existingTags.includes(tag));
+        const updatedTags = [...existingTags, ...uniqueNewTags];
+        return await this.updateDataset({
+            dataset_id: datasetId,
+            tags: updatedTags,
+        });
+    }
+    /**
+     * Removes specified tags from an existing dataset.
+     * Tags that don't exist on the dataset will be ignored.
+     *
+     * **Note**: This method performs a read-modify-write operation.
+     * Concurrent calls may result in lost updates.
+     *
+     * @param {number} datasetId - The ID of the dataset to remove tags from.
+     * @param {string[]} tags - The tags to remove from the dataset. Empty array returns the dataset unchanged.
+     * @returns {Promise<Dataset>} A promise that resolves with the updated dataset.
+     */
+    async removeTags(datasetId, tags) {
+        if (tags.length === 0) {
+            return await this.getDataset(datasetId);
+        }
+        const dataset = await this.getDataset(datasetId);
+        const existingTags = dataset.tags ?? [];
+        const updatedTags = existingTags.filter((tag) => !tags.includes(tag));
+        return await this.updateDataset({
+            dataset_id: datasetId,
+            tags: updatedTags,
+        });
+    }
     /**
      * Activates a dataset with the specified dataset ID.
      *

package/build/index.d.ts

@@ -24,6 +24,7 @@ export * from "./jobs";
 export { default as JsonBigNumber } from "./json-big-number";
 export * from "./mappings";
 export * from "./mappings/types";
+export * from "./model-inference";
 export * from "./model-training";
 export * from "./models";
 export * from "./nql";
@@ -65,6 +66,7 @@ import { HealthCheckApi } from "./health";
 import { InstallationsApi } from "./installations";
 import { JobsApi } from "./jobs";
 import { MappingsApi } from "./mappings";
+import { ModelInferenceApi } from "./model-inference";
 import { ModelTrainingApi } from "./model-training";
 import { ModelsApi } from "./models";
 import { NqlApi } from "./nql";
@@ -78,6 +80,6 @@ import { ViewsApi } from "./views";
 import { WhoAmIApi } from "./whoami";
 declare class NarrativeApi extends BaseApi {
 }
-interface NarrativeApi extends BaseApi, HealthCheckApi, AccessTokensApi, DataPlaneApi, DatasetApi, RosettaStoneApi, AttributeApi, AttributeApiV2, PingApi, CompanyInfoApi, InstallationsApi, ConnectionsApi, UploadsApi, ResourceApi, NqlApi, DataStreamsApi, ForecastApi, ContractsApi, AuthenticationApi, MappingsApi, AccessRulesApi, AppsApi, SubscriptionsApi, JobsApi, QueriesApi, ViewsApi, ModelsApi, ModelTrainingApi, EncryptionMaterialApi, WhoAmIApi {
+interface NarrativeApi extends BaseApi, HealthCheckApi, AccessTokensApi, DataPlaneApi, DatasetApi, RosettaStoneApi, AttributeApi, AttributeApiV2, PingApi, CompanyInfoApi, InstallationsApi, ConnectionsApi, UploadsApi, ResourceApi, NqlApi, DataStreamsApi, ForecastApi, ContractsApi, AuthenticationApi, MappingsApi, AccessRulesApi, AppsApi, SubscriptionsApi, JobsApi, QueriesApi, ViewsApi, ModelsApi, ModelTrainingApi, ModelInferenceApi, EncryptionMaterialApi, WhoAmIApi {
 }
 export { NarrativeApi };

package/build/index.js

@@ -25,6 +25,7 @@ export * from "./jobs";
 export { default as JsonBigNumber } from "./json-big-number";
 export * from "./mappings";
 export * from "./mappings/types";
+export * from "./model-inference";
 export * from "./model-training";
 export * from "./models";
 export * from "./nql";
@@ -66,6 +67,7 @@ import { HealthCheckApi } from "./health";
 import { InstallationsApi } from "./installations";
 import { JobsApi } from "./jobs";
 import { MappingsApi } from "./mappings";
+import { ModelInferenceApi } from "./model-inference";
 import { ModelTrainingApi } from "./model-training";
 import { ModelsApi } from "./models";
 import { NqlApi } from "./nql";
@@ -109,6 +111,7 @@ applyMixins(NarrativeApi, [
     ViewsApi,
     ModelsApi,
     ModelTrainingApi,
+    ModelInferenceApi,
     EncryptionMaterialApi,
     WhoAmIApi,
 ]);

package/build/jobs/index.d.ts

@@ -1,6 +1,6 @@
 import { BaseApi } from "../base-api";
 import type { ApiRecords } from "../types";
-import type { ColumnDetails, DatasetsCalculateColumnStatsJob, DatasetsDeleteTableJob, DatasetsDeliverDataJob, DatasetsSampleJob, DeleteInput, DeliverInput, ExplainInput, ExplainJob, ExplainOutput, ForecastInput, ForecastJob, Job, JobRequestSource, JobRequestSourceApiUser, JobRequestSourceProcess, MaterializedViewInput, MaterializedViewJob, MaterializedViewOutput, ModelsDeliverModelInput, ModelsDeliverModelJob, ModelTrainingRunInput, ModelTrainingRunJob, SampleInput, StatsInput } from "./types";
+import type { ColumnDetails, DatasetsCalculateColumnStatsJob, DatasetsDeleteTableJob, DatasetsDeliverDataJob, DatasetsSampleJob, DeleteInput, DeliverInput, ExplainInput, ExplainJob, ExplainOutput, ForecastInput, ForecastJob, Job, JobRequestSource, JobRequestSourceApiUser, JobRequestSourceProcess, MaterializedViewInput, MaterializedViewJob, MaterializedViewOutput, ModelInferenceRunInput, ModelInferenceRunJob, ModelInferenceRunJobResult, ModelsDeliverModelInput, ModelsDeliverModelJob, ModelTrainingRunInput, ModelTrainingRunJob, SampleInput, StatsInput } from "./types";
 interface GetJobsParameters extends Record<string, string | number | boolean | undefined> {
     dataset_id?: number;
     per_page?: number;
@@ -31,4 +31,4 @@ declare class JobsApi extends BaseApi {
      */
     cancelJob(jobId: string): Promise<void>;
 }
-export { type Job, type JobRequestSource, type JobRequestSourceApiUser, type JobRequestSourceProcess, type ForecastInput, type ForecastJob, type ExplainInput, type ExplainJob, type ExplainOutput, type MaterializedViewInput, type MaterializedViewJob, type MaterializedViewOutput, type DeleteInput, type DatasetsDeleteTableJob, type DeliverInput, type DatasetsDeliverDataJob, type SampleInput, type DatasetsSampleJob, type ColumnDetails, type StatsInput, type DatasetsCalculateColumnStatsJob, type ModelTrainingRunInput, type ModelTrainingRunJob, type ModelsDeliverModelInput, type ModelsDeliverModelJob, type GetJobsParameters, JobsApi, };
+export { type Job, type JobRequestSource, type JobRequestSourceApiUser, type JobRequestSourceProcess, type ForecastInput, type ForecastJob, type ExplainInput, type ExplainJob, type ExplainOutput, type MaterializedViewInput, type MaterializedViewJob, type MaterializedViewOutput, type DeleteInput, type DatasetsDeleteTableJob, type DeliverInput, type DatasetsDeliverDataJob, type SampleInput, type DatasetsSampleJob, type ColumnDetails, type StatsInput, type DatasetsCalculateColumnStatsJob, type ModelTrainingRunInput, type ModelTrainingRunJob, type ModelsDeliverModelInput, type ModelsDeliverModelJob, type ModelInferenceRunInput, type ModelInferenceRunJob, type ModelInferenceRunJobResult, type GetJobsParameters, JobsApi, };

package/build/jobs/types.d.ts

@@ -1,7 +1,7 @@
 import type { ForecastResult, JobState } from "src/forecast";
 import type { DataStreamPurchaseDetails, ForecastDimensions, MarketplaceForecastDetails } from "src/forecast/types";
 import type { NqlBudget } from "src/nql/types";
-export type JobType = "forecast" | "nql-forecast" | "materialize-view" | "datasets_calculate_column_stats" | "datasets_delete_table" | "datasets_deliver_data" | "datasets_sample" | "models_deliver_model" | "models_train_classifier" | "model_training_run";
+export type JobType = "forecast" | "nql-forecast" | "materialize-view" | "datasets_calculate_column_stats" | "datasets_delete_table" | "datasets_deliver_data" | "datasets_sample" | "models_deliver_model" | "models_train_classifier" | "model_training_run" | "model_inference_run";
 export interface JobRequestSource {
     type: string;
     company_id: number;
@@ -170,7 +170,34 @@ export interface ModelsTrainClassifierJob extends BaseJob {
     type: "models_train_classifier";
     result: ModelsTrainClassifierResults;
 }
-export type Job = ForecastJob | ExplainJob | MaterializedViewJob | DatasetsDeleteTableJob | DatasetsDeliverDataJob | DatasetsSampleJob | DatasetsCalculateColumnStatsJob | ModelTrainingRunJob | ModelsDeliverModelJob | ModelsTrainClassifierJob | UnknownJob;
+export interface ModelInferenceRunInput {
+    model: string;
+    messages: Array<{
+        role: string;
+        text: string;
+    }>;
+    inference_config: {
+        output_format_schema: Record<string, unknown>;
+        max_tokens?: number | null;
+        temperature?: number | null;
+        top_p?: number | null;
+        stop_sequences?: string[] | null;
+    };
+}
+export interface ModelInferenceRunJobResult {
+    usage: {
+        total_tokens: number;
+        prompt_tokens: number;
+        completion_tokens: number;
+    };
+    structured_output: unknown;
+}
+export interface ModelInferenceRunJob extends BaseJob {
+    type: "model_inference_run";
+    input: ModelInferenceRunInput;
+    result?: ModelInferenceRunJobResult;
+}
+export type Job = ForecastJob | ExplainJob | MaterializedViewJob | DatasetsDeleteTableJob | DatasetsDeliverDataJob | DatasetsSampleJob | DatasetsCalculateColumnStatsJob | ModelTrainingRunJob | ModelsDeliverModelJob | ModelsTrainClassifierJob | ModelInferenceRunJob | UnknownJob;
 export interface ModelsTrainClassifierTrainingSummary {
     total_features: number;
     feature_types: Record<"text" | "categorical" | "embedding" | "numeric", number>;

package/build/model-inference/index.d.ts

@@ -0,0 +1,18 @@
+import { BaseApi } from "../base-api";
+import type { ModelInferenceRunJob } from "../jobs";
+import type { InferenceConfig, InferenceMessage, InferenceModel, InferenceUsage, MessageRole, ModelInferenceRunRequest, ModelInferenceRunResult } from "./types";
+/**
+ * @module ModelInferenceApi
+ * @description This module provides methods for running model inference jobs.
+ * @extends BaseApi
+ */
+declare class ModelInferenceApi extends BaseApi {
+    /**
+     * Run a model inference job.
+     * Creates a job that sends messages to a specified model and returns structured output.
+     * @param request - The inference request parameters
+     * @returns Promise resolving with the created job
+     */
+    runModelInference(request: ModelInferenceRunRequest): Promise<ModelInferenceRunJob>;
+}
+export { ModelInferenceApi, type InferenceConfig, type InferenceMessage, type InferenceModel, type InferenceUsage, type MessageRole, type ModelInferenceRunRequest, type ModelInferenceRunResult, };

package/build/model-inference/index.js

@@ -0,0 +1,19 @@
+import { BaseApi } from "../base-api";
+const resourceName = "model-inference";
+/**
+ * @module ModelInferenceApi
+ * @description This module provides methods for running model inference jobs.
+ * @extends BaseApi
+ */
+class ModelInferenceApi extends BaseApi {
+    /**
+     * Run a model inference job.
+     * Creates a job that sends messages to a specified model and returns structured output.
+     * @param request - The inference request parameters
+     * @returns Promise resolving with the created job
+     */
+    async runModelInference(request) {
+        return await this.post(`${resourceName}/run`, request);
+    }
+}
+export { ModelInferenceApi, };

package/build/model-inference/types.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Model identifiers supported by the Narrative model inference API.
+ * Maps to Scala ModelInferenceRunJobInput.Model
+ */
+export type InferenceModel = "anthropic.claude-haiku-4.5" | "anthropic.claude-sonnet-4.5" | "anthropic.claude-opus-4.5" | "openai.gpt-oss-120b" | "openai.gpt-4.1" | "openai.o4-mini";
+/**
+ * Message role for inference requests.
+ * Maps to Scala ModelInferenceRunJobInput.Role
+ */
+export type MessageRole = "user" | "assistant" | "system";
+/**
+ * A message in the inference conversation.
+ * Maps to Scala ModelInferenceRunJobInput.Message
+ */
+export interface InferenceMessage {
+    role: MessageRole;
+    text: string;
+}
+/**
+ * Configuration for the inference request.
+ * Maps to Scala ModelInferenceRunJobInput.InferenceConfig
+ */
+export interface InferenceConfig {
+    /** JSON Schema defining the expected output format */
+    output_format_schema: Record<string, unknown>;
+    /** Maximum number of tokens to generate */
+    max_tokens?: number;
+    /** Sampling temperature (0-1) */
+    temperature?: number;
+    /** Top-p (nucleus) sampling parameter (0-1) */
+    top_p?: number;
+    /** Sequences that will stop generation */
+    stop_sequences?: string[];
+}
+/**
+ * Request body for running a model inference job.
+ * Maps to Scala RunRequest
+ */
+export interface ModelInferenceRunRequest {
+    /** The data plane ID to run the inference on */
+    data_plane_id: string;
+    /** The model to use for inference */
+    model: InferenceModel;
+    /** The conversation messages */
+    messages: InferenceMessage[];
+    /** Configuration for the inference */
+    inference_config: InferenceConfig;
+    /** Optional tags for the job */
+    tags?: string[];
+}
+/**
+ * Token usage metrics from the inference.
+ */
+export interface InferenceUsage {
+    total_tokens: number;
+    prompt_tokens: number;
+    completion_tokens: number;
+}
+/**
+ * Result from a model inference job.
+ * @template T - The type of the structured output, defaults to unknown
+ */
+export interface ModelInferenceRunResult<T = unknown> {
+    /** Token usage metrics */
+    usage: InferenceUsage;
+    /** The structured output matching the output_format_schema */
+    structured_output: T;
+}

package/build/model-inference/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,44 +1,45 @@
 {
 	"name": "@narrative.io/data-collaboration-sdk-ts",
-	"version": "2.85.0",
+	"version": "2.89.0",
 	"main": "build/index.js",
 	"repository": "github:narrative-io/data-collaboration-sdk-ts",
 	"source": "src/index.ts",
 	"types": "build/index.d.ts",
 	"description": "",
+	"packageManager": "bun@1.2.21",
 	"scripts": {
 		"build": "tsc",
-		"lint": "npx @biomejs/biome check --write ./src",
-		"prepare": "npx @biomejs/biome check --write ./src && npm run build",
-		"prepublishOnly": "npm test && npm run lint",
-		"preversion": "npm run lint",
-		"version": "npm run && git add -A src",
+		"lint": "bunx @biomejs/biome check --write ./src",
+		"prepare": "bunx @biomejs/biome check --write ./src && bun run build",
+		"prepublishOnly": "bun run test && bun run lint",
+		"preversion": "bun run lint",
+		"version": "bun run && git add -A src",
 		"postversion": "git push && git push --tags",
 		"test": "jest --coverage",
 		"dev": "tsc -w",
 		"check:built": "node scripts/ensureBuild.js",
-		"link:global": "npm run check:built && npm link",
-		"pack:dist": "npm run check:built && npm pack"
+		"link:global": "bun run check:built && bun link",
+		"pack:dist": "bun run check:built && bun pm pack"
 	},
 	"keywords": [],
 	"author": "",
 	"license": "ISC",
 	"devDependencies": {
-		"@babel/core": "7.28.4",
-		"@babel/preset-env": "7.28.3",
-		"@babel/preset-typescript": "7.27.1",
-		"@biomejs/biome": "2.2.7",
+		"@babel/core": "7.28.5",
+		"@babel/preset-env": "7.28.5",
+		"@babel/preset-typescript": "7.28.5",
+		"@biomejs/biome": "2.3.8",
 		"@commitlint/cli": "20.1.0",
 		"@commitlint/config-conventional": "20.0.0",
 		"@types/jest": "30.0.0",
 		"babel-jest": "30.2.0",
 		"jest": "30.2.0",
-		"lefthook": "2.0.0",
-		"ts-jest": "29.4.5"
+		"lefthook": "2.0.7",
+		"ts-jest": "29.4.6"
 	},
 	"dependencies": {
 		"mande": "2.0.9",
-		"zod": "4.1.12",
+		"zod": "4.1.13",
 		"bignumber.js": "9.3.1"
 	},
 	"overrides": {