@truefoundry/trueforge-sdk 0.1.4-rc.1 → 0.1.4-rc.2

package/dist/cjs/BaseClient.js

@@ -43,8 +43,8 @@ function normalizeClientOptions(options) {
     const headers = (0, headers_js_1.mergeHeaders)({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "@truefoundry/trueforge-sdk",
-        "X-Fern-SDK-Version": "0.1.4-rc.1",
-        "User-Agent": "@truefoundry/trueforge-sdk/0.1.4-rc.1",
+        "X-Fern-SDK-Version": "0.1.4-rc.2",
+        "User-Agent": "@truefoundry/trueforge-sdk/0.1.4-rc.2",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
     }, options === null || options === void 0 ? void 0 : options.headers);

package/dist/cjs/api/resources/internal/resources/sessions/client/requests/GetOrCreateSessionByExternalIdRequest.d.ts

@@ -12,4 +12,5 @@ export interface GetOrCreateSessionByExternalIdRequest {
     agent: TrueForge.CreateSessionAgent;
     /** Caller-supplied id unique within the tenant. */
     externalId: string;
+    source?: TrueForge.SessionSourceSchedule;
 }

package/dist/cjs/api/resources/sessions/client/Client.d.ts

@@ -11,7 +11,7 @@ export declare class SessionsClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<SessionsClient.Options>;
     constructor(options: SessionsClient.Options);
     /**
-     * List the caller's sessions (newest first by default).
+     * List the sessions (newest first by default).
      *
      * @param {TrueForge.ListSessionsRequest} request
      * @param {SessionsClient.RequestOptions} requestOptions - Request-specific configuration.

package/dist/cjs/api/resources/sessions/client/Client.js

@@ -57,7 +57,7 @@ class SessionsClient {
         this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
     }
     /**
-     * List the caller's sessions (newest first by default).
+     * List the sessions (newest first by default).
      *
      * @param {TrueForge.ListSessionsRequest} request
      * @param {SessionsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -73,7 +73,7 @@ class SessionsClient {
         return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
             const list = core.HttpResponsePromise.interceptFunction((request) => __awaiter(this, void 0, void 0, function* () {
                 var _a, _b, _c, _d, _e, _f, _g, _h, _j;
-                const { limit = 25, order, pageToken, startTimestamp, endTimestamp, agentId, createdByMe } = request;
+                const { limit = 25, order, pageToken, startTimestamp, endTimestamp, agentId, createdByMe, metadata, sourceType, sourceId, } = request;
                 const _queryParams = {
                     limit,
                     order: order != null
@@ -89,6 +89,16 @@ class SessionsClient {
                     end_timestamp: endTimestamp != null ? endTimestamp === null || endTimestamp === void 0 ? void 0 : endTimestamp.toISOString() : undefined,
                     agent_id: agentId,
                     created_by_me: createdByMe,
+                    metadata,
+                    source_type: sourceType != null
+                        ? serializers.SessionSourceType.jsonOrThrow(sourceType, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            omitUndefined: true,
+                        })
+                        : undefined,
+                    source_id: sourceId,
                 };
                 const _authRequest = yield this._options.authProvider.getAuthRequest();
                 const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);

package/dist/cjs/api/resources/sessions/client/requests/ListSessionsRequest.d.ts

@@ -18,4 +18,10 @@ export interface ListSessionsRequest {
     agentId?: string;
     /** When true, only sessions created by the authenticated subject. */
     createdByMe?: boolean;
+    /** Exact metadata pairs as metadata[key]=value. Sessions must contain all pairs. */
+    metadata?: TrueForge.SessionMetadata;
+    /** When set, returns only sessions created by this source type. */
+    sourceType?: TrueForge.SessionSourceType;
+    /** When set, returns only sessions from this specific source. Requires source_type. */
+    sourceId?: string;
 }

package/dist/cjs/api/types/Session.d.ts

@@ -8,6 +8,7 @@ export interface Session {
     id: string;
     metadata: TrueForge.SessionMetadata;
     metrics: TrueForge.SessionMetrics;
+    source: TrueForge.SessionSource | null;
     /** Optional human-readable title; null until set. */
     title: string | null;
     /** ISO 8601 last-update timestamp. */

package/dist/cjs/api/types/SessionMetrics.d.ts

@@ -2,7 +2,8 @@
  * Rolled-up cost, duration, and turn counters for a session.
  */
 export interface SessionMetrics {
-    totalCostInUsd: number;
+    /** Estimated total cost in USD for this session */
+    totalCostInUsd?: number;
     totalDurationMs: number;
     totalTurns: number;
 }

package/dist/cjs/api/types/SessionSource.d.ts

@@ -0,0 +1,11 @@
+/**
+ * How this session was created (e.g. a schedule run). Null for interactive sessions.
+ */
+export interface SessionSource {
+    /** Schedule id. */
+    id: string;
+    /** Schedule run id. */
+    runId: string;
+    /** Session was created by a schedule run. */
+    type: "schedule";
+}

package/dist/cjs/api/types/SessionSource.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/SessionSourceSchedule.d.ts

@@ -0,0 +1,8 @@
+export interface SessionSourceSchedule {
+    /** Schedule id. */
+    id: string;
+    /** Schedule run id. */
+    runId: string;
+    /** Session was created by a schedule run. */
+    type: "schedule";
+}

package/dist/cjs/api/types/SessionSourceSchedule.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/SessionSourceType.d.ts

@@ -0,0 +1,4 @@
+/**
+ * When set, returns only sessions created by this source type.
+ */
+export type SessionSourceType = "schedule";

package/dist/cjs/api/types/SessionSourceType.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/index.d.ts

@@ -172,6 +172,9 @@ export * from "./SessionMetricsMeter.js";
 export * from "./SessionMetricsMeterName.js";
 export * from "./SessionMetricsMeterResponse.js";
 export * from "./SessionMetricsPoint.js";
+export * from "./SessionSource.js";
+export * from "./SessionSourceSchedule.js";
+export * from "./SessionSourceType.js";
 export * from "./SettingsCapability.js";
 export * from "./Skill.js";
 export * from "./SkillCapability.js";

package/dist/cjs/api/types/index.js

@@ -188,6 +188,9 @@ __exportStar(require("./SessionMetricsMeter.js"), exports);
 __exportStar(require("./SessionMetricsMeterName.js"), exports);
 __exportStar(require("./SessionMetricsMeterResponse.js"), exports);
 __exportStar(require("./SessionMetricsPoint.js"), exports);
+__exportStar(require("./SessionSource.js"), exports);
+__exportStar(require("./SessionSourceSchedule.js"), exports);
+__exportStar(require("./SessionSourceType.js"), exports);
 __exportStar(require("./SettingsCapability.js"), exports);
 __exportStar(require("./Skill.js"), exports);
 __exportStar(require("./SkillCapability.js"), exports);

package/dist/cjs/serialization/resources/internal/resources/sessions/client/requests/GetOrCreateSessionByExternalIdRequest.d.ts

@@ -2,10 +2,12 @@ import type * as TrueForge from "../../../../../../../api/index.js";
 import * as core from "../../../../../../../core/index.js";
 import type * as serializers from "../../../../../../index.js";
 import { CreateSessionAgent } from "../../../../../../types/CreateSessionAgent.js";
+import { SessionSourceSchedule } from "../../../../../../types/SessionSourceSchedule.js";
 export declare const GetOrCreateSessionByExternalIdRequest: core.serialization.Schema<serializers.internal.GetOrCreateSessionByExternalIdRequest.Raw, TrueForge.internal.GetOrCreateSessionByExternalIdRequest>;
 export declare namespace GetOrCreateSessionByExternalIdRequest {
     interface Raw {
         agent: CreateSessionAgent.Raw;
         external_id: string;
+        source?: SessionSourceSchedule.Raw | null;
     }
 }

package/dist/cjs/serialization/resources/internal/resources/sessions/client/requests/GetOrCreateSessionByExternalIdRequest.js

@@ -37,7 +37,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.GetOrCreateSessionByExternalIdRequest = void 0;
 const core = __importStar(require("../../../../../../../core/index.js"));
 const CreateSessionAgent_js_1 = require("../../../../../../types/CreateSessionAgent.js");
+const SessionSourceSchedule_js_1 = require("../../../../../../types/SessionSourceSchedule.js");
 exports.GetOrCreateSessionByExternalIdRequest = core.serialization.object({
     agent: CreateSessionAgent_js_1.CreateSessionAgent,
     externalId: core.serialization.property("external_id", core.serialization.string()),
+    source: SessionSourceSchedule_js_1.SessionSourceSchedule.optional(),
 });

package/dist/cjs/serialization/types/Session.d.ts

@@ -5,6 +5,7 @@ import { CreatedBySubject } from "./CreatedBySubject.js";
 import { SessionAgent } from "./SessionAgent.js";
 import { SessionMetadata } from "./SessionMetadata.js";
 import { SessionMetrics } from "./SessionMetrics.js";
+import { SessionSource } from "./SessionSource.js";
 export declare const Session: core.serialization.ObjectSchema<serializers.Session.Raw, TrueForge.Session>;
 export declare namespace Session {
     interface Raw {
@@ -14,6 +15,7 @@ export declare namespace Session {
         id: string;
         metadata: SessionMetadata.Raw;
         metrics: SessionMetrics.Raw;
+        source?: SessionSource.Raw | null;
         title?: string | null;
         updated_at: string;
     }

package/dist/cjs/serialization/types/Session.js

@@ -40,6 +40,7 @@ const CreatedBySubject_js_1 = require("./CreatedBySubject.js");
 const SessionAgent_js_1 = require("./SessionAgent.js");
 const SessionMetadata_js_1 = require("./SessionMetadata.js");
 const SessionMetrics_js_1 = require("./SessionMetrics.js");
+const SessionSource_js_1 = require("./SessionSource.js");
 exports.Session = core.serialization.object({
     agent: SessionAgent_js_1.SessionAgent,
     createdAt: core.serialization.property("created_at", core.serialization.string()),
@@ -47,6 +48,7 @@ exports.Session = core.serialization.object({
     id: core.serialization.string(),
     metadata: SessionMetadata_js_1.SessionMetadata,
     metrics: SessionMetrics_js_1.SessionMetrics,
+    source: SessionSource_js_1.SessionSource.nullable(),
     title: core.serialization.string().nullable(),
     updatedAt: core.serialization.property("updated_at", core.serialization.string()),
 });

package/dist/cjs/serialization/types/SessionMetrics.d.ts

@@ -4,7 +4,7 @@ import type * as serializers from "../index.js";
 export declare const SessionMetrics: core.serialization.ObjectSchema<serializers.SessionMetrics.Raw, TrueForge.SessionMetrics>;
 export declare namespace SessionMetrics {
     interface Raw {
-        total_cost_in_usd: number;
+        total_cost_in_usd?: number | null;
         total_duration_ms: number;
         total_turns: number;
     }

package/dist/cjs/serialization/types/SessionMetrics.js

@@ -37,7 +37,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SessionMetrics = void 0;
 const core = __importStar(require("../../core/index.js"));
 exports.SessionMetrics = core.serialization.object({
-    totalCostInUsd: core.serialization.property("total_cost_in_usd", core.serialization.number()),
+    totalCostInUsd: core.serialization.property("total_cost_in_usd", core.serialization.number().optional()),
     totalDurationMs: core.serialization.property("total_duration_ms", core.serialization.number()),
     totalTurns: core.serialization.property("total_turns", core.serialization.number()),
 });

package/dist/cjs/serialization/types/SessionSource.d.ts

@@ -0,0 +1,11 @@
+import type * as TrueForge from "../../api/index.js";
+import * as core from "../../core/index.js";
+import type * as serializers from "../index.js";
+export declare const SessionSource: core.serialization.ObjectSchema<serializers.SessionSource.Raw, TrueForge.SessionSource>;
+export declare namespace SessionSource {
+    interface Raw {
+        id: string;
+        run_id: string;
+        type: "schedule";
+    }
+}

package/dist/cjs/serialization/types/SessionSource.js

@@ -0,0 +1,43 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionSource = void 0;
+const core = __importStar(require("../../core/index.js"));
+exports.SessionSource = core.serialization.object({
+    id: core.serialization.string(),
+    runId: core.serialization.property("run_id", core.serialization.string()),
+    type: core.serialization.stringLiteral("schedule"),
+});

package/dist/cjs/serialization/types/SessionSourceSchedule.d.ts

@@ -0,0 +1,11 @@
+import type * as TrueForge from "../../api/index.js";
+import * as core from "../../core/index.js";
+import type * as serializers from "../index.js";
+export declare const SessionSourceSchedule: core.serialization.ObjectSchema<serializers.SessionSourceSchedule.Raw, TrueForge.SessionSourceSchedule>;
+export declare namespace SessionSourceSchedule {
+    interface Raw {
+        id: string;
+        run_id: string;
+        type: "schedule";
+    }
+}

package/dist/cjs/serialization/types/SessionSourceSchedule.js

@@ -0,0 +1,43 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionSourceSchedule = void 0;
+const core = __importStar(require("../../core/index.js"));
+exports.SessionSourceSchedule = core.serialization.object({
+    id: core.serialization.string(),
+    runId: core.serialization.property("run_id", core.serialization.string()),
+    type: core.serialization.stringLiteral("schedule"),
+});

package/dist/cjs/serialization/types/SessionSourceType.d.ts

@@ -0,0 +1,7 @@
+import type * as TrueForge from "../../api/index.js";
+import * as core from "../../core/index.js";
+import type * as serializers from "../index.js";
+export declare const SessionSourceType: core.serialization.Schema<serializers.SessionSourceType.Raw, TrueForge.SessionSourceType>;
+export declare namespace SessionSourceType {
+    type Raw = "schedule";
+}

package/dist/cjs/serialization/types/SessionSourceType.js

@@ -0,0 +1,39 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionSourceType = void 0;
+const core = __importStar(require("../../core/index.js"));
+exports.SessionSourceType = core.serialization.stringLiteral("schedule");

package/dist/cjs/serialization/types/index.d.ts

@@ -172,6 +172,9 @@ export * from "./SessionMetricsMeter.js";
 export * from "./SessionMetricsMeterName.js";
 export * from "./SessionMetricsMeterResponse.js";
 export * from "./SessionMetricsPoint.js";
+export * from "./SessionSource.js";
+export * from "./SessionSourceSchedule.js";
+export * from "./SessionSourceType.js";
 export * from "./SettingsCapability.js";
 export * from "./Skill.js";
 export * from "./SkillCapability.js";

package/dist/cjs/serialization/types/index.js

@@ -188,6 +188,9 @@ __exportStar(require("./SessionMetricsMeter.js"), exports);
 __exportStar(require("./SessionMetricsMeterName.js"), exports);
 __exportStar(require("./SessionMetricsMeterResponse.js"), exports);
 __exportStar(require("./SessionMetricsPoint.js"), exports);
+__exportStar(require("./SessionSource.js"), exports);
+__exportStar(require("./SessionSourceSchedule.js"), exports);
+__exportStar(require("./SessionSourceType.js"), exports);
 __exportStar(require("./SettingsCapability.js"), exports);
 __exportStar(require("./Skill.js"), exports);
 __exportStar(require("./SkillCapability.js"), exports);

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.1.4-rc.1";
+export declare const SDK_VERSION = "0.1.4-rc.2";

package/dist/cjs/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "0.1.4-rc.1";
+exports.SDK_VERSION = "0.1.4-rc.2";

package/dist/esm/BaseClient.mjs

@@ -6,8 +6,8 @@ export function normalizeClientOptions(options) {
     const headers = mergeHeaders({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "@truefoundry/trueforge-sdk",
-        "X-Fern-SDK-Version": "0.1.4-rc.1",
-        "User-Agent": "@truefoundry/trueforge-sdk/0.1.4-rc.1",
+        "X-Fern-SDK-Version": "0.1.4-rc.2",
+        "User-Agent": "@truefoundry/trueforge-sdk/0.1.4-rc.2",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
     }, options === null || options === void 0 ? void 0 : options.headers);

package/dist/esm/api/resources/internal/resources/sessions/client/requests/GetOrCreateSessionByExternalIdRequest.d.mts

@@ -12,4 +12,5 @@ export interface GetOrCreateSessionByExternalIdRequest {
     agent: TrueForge.CreateSessionAgent;
     /** Caller-supplied id unique within the tenant. */
     externalId: string;
+    source?: TrueForge.SessionSourceSchedule;
 }

package/dist/esm/api/resources/sessions/client/Client.d.mts

@@ -11,7 +11,7 @@ export declare class SessionsClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<SessionsClient.Options>;
     constructor(options: SessionsClient.Options);
     /**
-     * List the caller's sessions (newest first by default).
+     * List the sessions (newest first by default).
      *
      * @param {TrueForge.ListSessionsRequest} request
      * @param {SessionsClient.RequestOptions} requestOptions - Request-specific configuration.

package/dist/esm/api/resources/sessions/client/Client.mjs

@@ -21,7 +21,7 @@ export class SessionsClient {
         this._options = normalizeClientOptionsWithAuth(options);
     }
     /**
-     * List the caller's sessions (newest first by default).
+     * List the sessions (newest first by default).
      *
      * @param {TrueForge.ListSessionsRequest} request
      * @param {SessionsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -37,7 +37,7 @@ export class SessionsClient {
         return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
             const list = core.HttpResponsePromise.interceptFunction((request) => __awaiter(this, void 0, void 0, function* () {
                 var _a, _b, _c, _d, _e, _f, _g, _h, _j;
-                const { limit = 25, order, pageToken, startTimestamp, endTimestamp, agentId, createdByMe } = request;
+                const { limit = 25, order, pageToken, startTimestamp, endTimestamp, agentId, createdByMe, metadata, sourceType, sourceId, } = request;
                 const _queryParams = {
                     limit,
                     order: order != null
@@ -53,6 +53,16 @@ export class SessionsClient {
                     end_timestamp: endTimestamp != null ? endTimestamp === null || endTimestamp === void 0 ? void 0 : endTimestamp.toISOString() : undefined,
                     agent_id: agentId,
                     created_by_me: createdByMe,
+                    metadata,
+                    source_type: sourceType != null
+                        ? serializers.SessionSourceType.jsonOrThrow(sourceType, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            omitUndefined: true,
+                        })
+                        : undefined,
+                    source_id: sourceId,
                 };
                 const _authRequest = yield this._options.authProvider.getAuthRequest();
                 const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);

package/dist/esm/api/resources/sessions/client/requests/ListSessionsRequest.d.mts

@@ -18,4 +18,10 @@ export interface ListSessionsRequest {
     agentId?: string;
     /** When true, only sessions created by the authenticated subject. */
     createdByMe?: boolean;
+    /** Exact metadata pairs as metadata[key]=value. Sessions must contain all pairs. */
+    metadata?: TrueForge.SessionMetadata;
+    /** When set, returns only sessions created by this source type. */
+    sourceType?: TrueForge.SessionSourceType;
+    /** When set, returns only sessions from this specific source. Requires source_type. */
+    sourceId?: string;
 }

package/dist/esm/api/types/Session.d.mts

@@ -8,6 +8,7 @@ export interface Session {
     id: string;
     metadata: TrueForge.SessionMetadata;
     metrics: TrueForge.SessionMetrics;
+    source: TrueForge.SessionSource | null;
     /** Optional human-readable title; null until set. */
     title: string | null;
     /** ISO 8601 last-update timestamp. */

package/dist/esm/api/types/SessionMetrics.d.mts

@@ -2,7 +2,8 @@
  * Rolled-up cost, duration, and turn counters for a session.
  */
 export interface SessionMetrics {
-    totalCostInUsd: number;
+    /** Estimated total cost in USD for this session */
+    totalCostInUsd?: number;
     totalDurationMs: number;
     totalTurns: number;
 }

package/dist/esm/api/types/SessionSource.d.mts

@@ -0,0 +1,11 @@
+/**
+ * How this session was created (e.g. a schedule run). Null for interactive sessions.
+ */
+export interface SessionSource {
+    /** Schedule id. */
+    id: string;
+    /** Schedule run id. */
+    runId: string;
+    /** Session was created by a schedule run. */
+    type: "schedule";
+}

package/dist/esm/api/types/SessionSource.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/SessionSourceSchedule.d.mts

@@ -0,0 +1,8 @@
+export interface SessionSourceSchedule {
+    /** Schedule id. */
+    id: string;
+    /** Schedule run id. */
+    runId: string;
+    /** Session was created by a schedule run. */
+    type: "schedule";
+}

package/dist/esm/api/types/SessionSourceSchedule.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/SessionSourceType.d.mts

@@ -0,0 +1,4 @@
+/**
+ * When set, returns only sessions created by this source type.
+ */
+export type SessionSourceType = "schedule";

package/dist/esm/api/types/SessionSourceType.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/index.d.mts

@@ -172,6 +172,9 @@ export * from "./SessionMetricsMeter.mjs";
 export * from "./SessionMetricsMeterName.mjs";
 export * from "./SessionMetricsMeterResponse.mjs";
 export * from "./SessionMetricsPoint.mjs";
+export * from "./SessionSource.mjs";
+export * from "./SessionSourceSchedule.mjs";
+export * from "./SessionSourceType.mjs";
 export * from "./SettingsCapability.mjs";
 export * from "./Skill.mjs";
 export * from "./SkillCapability.mjs";

package/dist/esm/api/types/index.mjs

@@ -172,6 +172,9 @@ export * from "./SessionMetricsMeter.mjs";
 export * from "./SessionMetricsMeterName.mjs";
 export * from "./SessionMetricsMeterResponse.mjs";
 export * from "./SessionMetricsPoint.mjs";
+export * from "./SessionSource.mjs";
+export * from "./SessionSourceSchedule.mjs";
+export * from "./SessionSourceType.mjs";
 export * from "./SettingsCapability.mjs";
 export * from "./Skill.mjs";
 export * from "./SkillCapability.mjs";

package/dist/esm/serialization/resources/internal/resources/sessions/client/requests/GetOrCreateSessionByExternalIdRequest.d.mts

@@ -2,10 +2,12 @@ import type * as TrueForge from "../../../../../../../api/index.mjs";
 import * as core from "../../../../../../../core/index.mjs";
 import type * as serializers from "../../../../../../index.mjs";
 import { CreateSessionAgent } from "../../../../../../types/CreateSessionAgent.mjs";
+import { SessionSourceSchedule } from "../../../../../../types/SessionSourceSchedule.mjs";
 export declare const GetOrCreateSessionByExternalIdRequest: core.serialization.Schema<serializers.internal.GetOrCreateSessionByExternalIdRequest.Raw, TrueForge.internal.GetOrCreateSessionByExternalIdRequest>;
 export declare namespace GetOrCreateSessionByExternalIdRequest {
     interface Raw {
         agent: CreateSessionAgent.Raw;
         external_id: string;
+        source?: SessionSourceSchedule.Raw | null;
     }
 }

package/dist/esm/serialization/resources/internal/resources/sessions/client/requests/GetOrCreateSessionByExternalIdRequest.mjs

@@ -1,7 +1,9 @@
 // This file was auto-generated by Fern from our API Definition.
 import * as core from "../../../../../../../core/index.mjs";
 import { CreateSessionAgent } from "../../../../../../types/CreateSessionAgent.mjs";
+import { SessionSourceSchedule } from "../../../../../../types/SessionSourceSchedule.mjs";
 export const GetOrCreateSessionByExternalIdRequest = core.serialization.object({
     agent: CreateSessionAgent,
     externalId: core.serialization.property("external_id", core.serialization.string()),
+    source: SessionSourceSchedule.optional(),
 });

package/dist/esm/serialization/types/Session.d.mts

@@ -5,6 +5,7 @@ import { CreatedBySubject } from "./CreatedBySubject.mjs";
 import { SessionAgent } from "./SessionAgent.mjs";
 import { SessionMetadata } from "./SessionMetadata.mjs";
 import { SessionMetrics } from "./SessionMetrics.mjs";
+import { SessionSource } from "./SessionSource.mjs";
 export declare const Session: core.serialization.ObjectSchema<serializers.Session.Raw, TrueForge.Session>;
 export declare namespace Session {
     interface Raw {
@@ -14,6 +15,7 @@ export declare namespace Session {
         id: string;
         metadata: SessionMetadata.Raw;
         metrics: SessionMetrics.Raw;
+        source?: SessionSource.Raw | null;
         title?: string | null;
         updated_at: string;
     }

package/dist/esm/serialization/types/Session.mjs

@@ -4,6 +4,7 @@ import { CreatedBySubject } from "./CreatedBySubject.mjs";
 import { SessionAgent } from "./SessionAgent.mjs";
 import { SessionMetadata } from "./SessionMetadata.mjs";
 import { SessionMetrics } from "./SessionMetrics.mjs";
+import { SessionSource } from "./SessionSource.mjs";
 export const Session = core.serialization.object({
     agent: SessionAgent,
     createdAt: core.serialization.property("created_at", core.serialization.string()),
@@ -11,6 +12,7 @@ export const Session = core.serialization.object({
     id: core.serialization.string(),
     metadata: SessionMetadata,
     metrics: SessionMetrics,
+    source: SessionSource.nullable(),
     title: core.serialization.string().nullable(),
     updatedAt: core.serialization.property("updated_at", core.serialization.string()),
 });

package/dist/esm/serialization/types/SessionMetrics.d.mts

@@ -4,7 +4,7 @@ import type * as serializers from "../index.mjs";
 export declare const SessionMetrics: core.serialization.ObjectSchema<serializers.SessionMetrics.Raw, TrueForge.SessionMetrics>;
 export declare namespace SessionMetrics {
     interface Raw {
-        total_cost_in_usd: number;
+        total_cost_in_usd?: number | null;
         total_duration_ms: number;
         total_turns: number;
     }

package/dist/esm/serialization/types/SessionMetrics.mjs

@@ -1,7 +1,7 @@
 // This file was auto-generated by Fern from our API Definition.
 import * as core from "../../core/index.mjs";
 export const SessionMetrics = core.serialization.object({
-    totalCostInUsd: core.serialization.property("total_cost_in_usd", core.serialization.number()),
+    totalCostInUsd: core.serialization.property("total_cost_in_usd", core.serialization.number().optional()),
     totalDurationMs: core.serialization.property("total_duration_ms", core.serialization.number()),
     totalTurns: core.serialization.property("total_turns", core.serialization.number()),
 });

package/dist/esm/serialization/types/SessionSource.d.mts

@@ -0,0 +1,11 @@
+import type * as TrueForge from "../../api/index.mjs";
+import * as core from "../../core/index.mjs";
+import type * as serializers from "../index.mjs";
+export declare const SessionSource: core.serialization.ObjectSchema<serializers.SessionSource.Raw, TrueForge.SessionSource>;
+export declare namespace SessionSource {
+    interface Raw {
+        id: string;
+        run_id: string;
+        type: "schedule";
+    }
+}

package/dist/esm/serialization/types/SessionSource.mjs

@@ -0,0 +1,7 @@
+// This file was auto-generated by Fern from our API Definition.
+import * as core from "../../core/index.mjs";
+export const SessionSource = core.serialization.object({
+    id: core.serialization.string(),
+    runId: core.serialization.property("run_id", core.serialization.string()),
+    type: core.serialization.stringLiteral("schedule"),
+});

package/dist/esm/serialization/types/SessionSourceSchedule.d.mts

@@ -0,0 +1,11 @@
+import type * as TrueForge from "../../api/index.mjs";
+import * as core from "../../core/index.mjs";
+import type * as serializers from "../index.mjs";
+export declare const SessionSourceSchedule: core.serialization.ObjectSchema<serializers.SessionSourceSchedule.Raw, TrueForge.SessionSourceSchedule>;
+export declare namespace SessionSourceSchedule {
+    interface Raw {
+        id: string;
+        run_id: string;
+        type: "schedule";
+    }
+}

package/dist/esm/serialization/types/SessionSourceSchedule.mjs

@@ -0,0 +1,7 @@
+// This file was auto-generated by Fern from our API Definition.
+import * as core from "../../core/index.mjs";
+export const SessionSourceSchedule = core.serialization.object({
+    id: core.serialization.string(),
+    runId: core.serialization.property("run_id", core.serialization.string()),
+    type: core.serialization.stringLiteral("schedule"),
+});

package/dist/esm/serialization/types/SessionSourceType.d.mts

@@ -0,0 +1,7 @@
+import type * as TrueForge from "../../api/index.mjs";
+import * as core from "../../core/index.mjs";
+import type * as serializers from "../index.mjs";
+export declare const SessionSourceType: core.serialization.Schema<serializers.SessionSourceType.Raw, TrueForge.SessionSourceType>;
+export declare namespace SessionSourceType {
+    type Raw = "schedule";
+}

package/dist/esm/serialization/types/SessionSourceType.mjs

@@ -0,0 +1,3 @@
+// This file was auto-generated by Fern from our API Definition.
+import * as core from "../../core/index.mjs";
+export const SessionSourceType = core.serialization.stringLiteral("schedule");

package/dist/esm/serialization/types/index.d.mts

@@ -172,6 +172,9 @@ export * from "./SessionMetricsMeter.mjs";
 export * from "./SessionMetricsMeterName.mjs";
 export * from "./SessionMetricsMeterResponse.mjs";
 export * from "./SessionMetricsPoint.mjs";
+export * from "./SessionSource.mjs";
+export * from "./SessionSourceSchedule.mjs";
+export * from "./SessionSourceType.mjs";
 export * from "./SettingsCapability.mjs";
 export * from "./Skill.mjs";
 export * from "./SkillCapability.mjs";

package/dist/esm/serialization/types/index.mjs

@@ -172,6 +172,9 @@ export * from "./SessionMetricsMeter.mjs";
 export * from "./SessionMetricsMeterName.mjs";
 export * from "./SessionMetricsMeterResponse.mjs";
 export * from "./SessionMetricsPoint.mjs";
+export * from "./SessionSource.mjs";
+export * from "./SessionSourceSchedule.mjs";
+export * from "./SessionSourceType.mjs";
 export * from "./SettingsCapability.mjs";
 export * from "./Skill.mjs";
 export * from "./SkillCapability.mjs";

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.1.4-rc.1";
+export declare const SDK_VERSION = "0.1.4-rc.2";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "0.1.4-rc.1";
+export const SDK_VERSION = "0.1.4-rc.2";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@truefoundry/trueforge-sdk",
-  "version": "0.1.4-rc.1",
+  "version": "0.1.4-rc.2",
   "private": false,
   "type": "commonjs",
   "main": "./dist/cjs/index.js",

package/reference.md

@@ -1235,7 +1235,7 @@ await client.schedules.listRuns("schedule_id");
 <dl>
 <dd>
 
-List the caller's sessions (newest first by default).
+List the sessions (newest first by default).
 </dd>
 </dl>
 </dd>