@cadenya/cadenya 0.130.0 → 0.132.0

package/resources/tenants/tenants.d.mts

@@ -0,0 +1,158 @@
+import { APIResource } from "../../core/resource.mjs";
+import * as Shared from "../shared.mjs";
+import * as WidgetSessionsAPI from "../widget-sessions.mjs";
+import * as SubjectsAPI from "./subjects.mjs";
+import { SubjectListParams, Subjects } from "./subjects.mjs";
+import { APIPromise } from "../../core/api-promise.mjs";
+import { CursorPagination, type CursorPaginationParams, PagePromise } from "../../core/pagination.mjs";
+import { RequestOptions } from "../../internal/request-options.mjs";
+/**
+ * Read and erase tenants and the subjects under them. Tenants and subjects are
+ *  created by assertion — on objective creation or widget session mint — never
+ *  directly, so this service has no create or update: it exists to enumerate what
+ *  assertions have produced, and to destroy it on request.
+ */
+export declare class Tenants extends APIResource {
+    subjects: SubjectsAPI.Subjects;
+    /**
+     * Retrieves a tenant by its canonical id or by the `external_id:<value>` form the
+     * customer asserted it under.
+     */
+    retrieve(id: string, params?: TenantRetrieveParams | null | undefined, options?: RequestOptions): APIPromise<Tenant>;
+    /**
+     * Lists the tenants asserted in a workspace, newest first. `query` matches against
+     * a tenant's name and its external_id, for type-ahead filters.
+     */
+    list(params?: TenantListParams | null | undefined, options?: RequestOptions): PagePromise<TenantsCursorPagination, Tenant>;
+    /**
+     * Destroys the tenant, its subjects, every objective associated with it and
+     * everything reachable from those objectives, and its widget sessions. This is the
+     * full erasure hammer, wider than `DELETE /widget_sessions`, which removes only
+     * what widget sessions created. The work runs in the background: this returns the
+     * tenant in STATE_ERASING rather than a count of what was removed, since a large
+     * tenant's history cannot be destroyed inside a request. Poll the tenant to follow
+     * it — STATE_ERASING while it runs, NotFound once it finishes. Erasure is
+     * terminal; a tenant cannot be recovered once it starts.
+     */
+    delete(id: string, params?: TenantDeleteParams | null | undefined, options?: RequestOptions): APIPromise<Tenant>;
+}
+export type TenantsCursorPagination = CursorPagination<Tenant>;
+export type SubjectsCursorPagination = CursorPagination<Subject>;
+/**
+ * Subject is a person within a tenant as a readable record. Like Tenant it carries
+ * no spec — `metadata.external_id` is the customer's key for them, unique within
+ * the tenant rather than the workspace.
+ */
+export interface Subject {
+    /**
+     * Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+     */
+    metadata: Shared.ResourceMetadata;
+    /**
+     * SubjectInfo provides read-only server-derived data about a subject.
+     */
+    info?: SubjectInfo;
+}
+/**
+ * SubjectInfo provides read-only server-derived data about a subject.
+ */
+export interface SubjectInfo {
+    /**
+     * Number of objectives associated with this subject.
+     */
+    objectiveCount?: number;
+    /**
+     * TenantReference is the read-only echo of a resource's tenant association,
+     * carrying both Cadenya's canonical id and the customer's own key.
+     */
+    tenant?: WidgetSessionsAPI.TenantReference;
+}
+/**
+ * Tenant is the customer's organization as a readable record rather than an echo.
+ * It carries no spec: a tenant is never configured, only asserted, so everything
+ * about it lives in the metadata envelope — `external_id` is the key the customer
+ * asserted it under, `name` is the most recent name they asserted, and
+ * `updated_at` is therefore when the tenant was last asserted.
+ */
+export interface Tenant {
+    /**
+     * Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+     */
+    metadata: Shared.ResourceMetadata;
+    /**
+     * The current lifecycle state of the tenant. Output only.
+     */
+    state: 'STATE_UNSPECIFIED' | 'STATE_ACTIVE' | 'STATE_ERASING';
+    /**
+     * TenantInfo provides read-only server-derived data about a tenant.
+     */
+    info?: TenantInfo;
+}
+/**
+ * TenantInfo provides read-only server-derived data about a tenant.
+ */
+export interface TenantInfo {
+    /**
+     * Number of objectives associated with this tenant, across every surface — widget
+     * conversations and objectives created directly against the API alike. This is the
+     * footprint a delete would destroy, which is why it is worth the count query that
+     * populating `info` costs.
+     */
+    objectiveCount?: number;
+    /**
+     * Number of subjects asserted under this tenant.
+     */
+    subjectCount?: number;
+    /**
+     * Number of widget sessions minted for this tenant that still exist.
+     */
+    widgetSessionCount?: number;
+}
+export interface TenantRetrieveParams {
+    /**
+     * Path param: Workspace ID.
+     */
+    workspaceId?: string;
+    /**
+     * Query param: When true, the `info` field is populated.
+     */
+    includeInfo?: boolean;
+}
+export interface TenantListParams extends CursorPaginationParams {
+    /**
+     * Path param: Workspace ID.
+     */
+    workspaceId?: string;
+    /**
+     * Query param: When true, the `info` field on each returned tenant is populated.
+     * This costs several count queries per tenant, so it is off by default.
+     */
+    includeInfo?: boolean;
+    /**
+     * Query param: Filters by metadata labels. Comma-separated key=value pairs, e.g.
+     * "env=prod,team=ai". A resource matches only if every pair matches exactly (AND
+     * semantics).
+     */
+    labels?: string;
+    /**
+     * Query param: Substring match against the tenant's name and external_id. Built
+     * for type-ahead filter pickers, where the operator knows the customer's own
+     * identifier rather than Cadenya's.
+     */
+    query?: string;
+    /**
+     * Query param: Sort order for results (asc or desc by creation time).
+     */
+    sortOrder?: string;
+}
+export interface TenantDeleteParams {
+    /**
+     * Workspace ID.
+     */
+    workspaceId?: string;
+}
+export declare namespace Tenants {
+    export { type Subject as Subject, type SubjectInfo as SubjectInfo, type Tenant as Tenant, type TenantInfo as TenantInfo, type TenantsCursorPagination as TenantsCursorPagination, type TenantRetrieveParams as TenantRetrieveParams, type TenantListParams as TenantListParams, type TenantDeleteParams as TenantDeleteParams, };
+    export { Subjects as Subjects, type SubjectListParams as SubjectListParams };
+}
+//# sourceMappingURL=tenants.d.mts.map

package/resources/tenants/tenants.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenants.d.mts","sourceRoot":"","sources":["../../src/resources/tenants/tenants.ts"],"names":[],"mappings":"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"}

package/resources/tenants/tenants.d.ts

@@ -0,0 +1,158 @@
+import { APIResource } from "../../core/resource.js";
+import * as Shared from "../shared.js";
+import * as WidgetSessionsAPI from "../widget-sessions.js";
+import * as SubjectsAPI from "./subjects.js";
+import { SubjectListParams, Subjects } from "./subjects.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { CursorPagination, type CursorPaginationParams, PagePromise } from "../../core/pagination.js";
+import { RequestOptions } from "../../internal/request-options.js";
+/**
+ * Read and erase tenants and the subjects under them. Tenants and subjects are
+ *  created by assertion — on objective creation or widget session mint — never
+ *  directly, so this service has no create or update: it exists to enumerate what
+ *  assertions have produced, and to destroy it on request.
+ */
+export declare class Tenants extends APIResource {
+    subjects: SubjectsAPI.Subjects;
+    /**
+     * Retrieves a tenant by its canonical id or by the `external_id:<value>` form the
+     * customer asserted it under.
+     */
+    retrieve(id: string, params?: TenantRetrieveParams | null | undefined, options?: RequestOptions): APIPromise<Tenant>;
+    /**
+     * Lists the tenants asserted in a workspace, newest first. `query` matches against
+     * a tenant's name and its external_id, for type-ahead filters.
+     */
+    list(params?: TenantListParams | null | undefined, options?: RequestOptions): PagePromise<TenantsCursorPagination, Tenant>;
+    /**
+     * Destroys the tenant, its subjects, every objective associated with it and
+     * everything reachable from those objectives, and its widget sessions. This is the
+     * full erasure hammer, wider than `DELETE /widget_sessions`, which removes only
+     * what widget sessions created. The work runs in the background: this returns the
+     * tenant in STATE_ERASING rather than a count of what was removed, since a large
+     * tenant's history cannot be destroyed inside a request. Poll the tenant to follow
+     * it — STATE_ERASING while it runs, NotFound once it finishes. Erasure is
+     * terminal; a tenant cannot be recovered once it starts.
+     */
+    delete(id: string, params?: TenantDeleteParams | null | undefined, options?: RequestOptions): APIPromise<Tenant>;
+}
+export type TenantsCursorPagination = CursorPagination<Tenant>;
+export type SubjectsCursorPagination = CursorPagination<Subject>;
+/**
+ * Subject is a person within a tenant as a readable record. Like Tenant it carries
+ * no spec — `metadata.external_id` is the customer's key for them, unique within
+ * the tenant rather than the workspace.
+ */
+export interface Subject {
+    /**
+     * Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+     */
+    metadata: Shared.ResourceMetadata;
+    /**
+     * SubjectInfo provides read-only server-derived data about a subject.
+     */
+    info?: SubjectInfo;
+}
+/**
+ * SubjectInfo provides read-only server-derived data about a subject.
+ */
+export interface SubjectInfo {
+    /**
+     * Number of objectives associated with this subject.
+     */
+    objectiveCount?: number;
+    /**
+     * TenantReference is the read-only echo of a resource's tenant association,
+     * carrying both Cadenya's canonical id and the customer's own key.
+     */
+    tenant?: WidgetSessionsAPI.TenantReference;
+}
+/**
+ * Tenant is the customer's organization as a readable record rather than an echo.
+ * It carries no spec: a tenant is never configured, only asserted, so everything
+ * about it lives in the metadata envelope — `external_id` is the key the customer
+ * asserted it under, `name` is the most recent name they asserted, and
+ * `updated_at` is therefore when the tenant was last asserted.
+ */
+export interface Tenant {
+    /**
+     * Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+     */
+    metadata: Shared.ResourceMetadata;
+    /**
+     * The current lifecycle state of the tenant. Output only.
+     */
+    state: 'STATE_UNSPECIFIED' | 'STATE_ACTIVE' | 'STATE_ERASING';
+    /**
+     * TenantInfo provides read-only server-derived data about a tenant.
+     */
+    info?: TenantInfo;
+}
+/**
+ * TenantInfo provides read-only server-derived data about a tenant.
+ */
+export interface TenantInfo {
+    /**
+     * Number of objectives associated with this tenant, across every surface — widget
+     * conversations and objectives created directly against the API alike. This is the
+     * footprint a delete would destroy, which is why it is worth the count query that
+     * populating `info` costs.
+     */
+    objectiveCount?: number;
+    /**
+     * Number of subjects asserted under this tenant.
+     */
+    subjectCount?: number;
+    /**
+     * Number of widget sessions minted for this tenant that still exist.
+     */
+    widgetSessionCount?: number;
+}
+export interface TenantRetrieveParams {
+    /**
+     * Path param: Workspace ID.
+     */
+    workspaceId?: string;
+    /**
+     * Query param: When true, the `info` field is populated.
+     */
+    includeInfo?: boolean;
+}
+export interface TenantListParams extends CursorPaginationParams {
+    /**
+     * Path param: Workspace ID.
+     */
+    workspaceId?: string;
+    /**
+     * Query param: When true, the `info` field on each returned tenant is populated.
+     * This costs several count queries per tenant, so it is off by default.
+     */
+    includeInfo?: boolean;
+    /**
+     * Query param: Filters by metadata labels. Comma-separated key=value pairs, e.g.
+     * "env=prod,team=ai". A resource matches only if every pair matches exactly (AND
+     * semantics).
+     */
+    labels?: string;
+    /**
+     * Query param: Substring match against the tenant's name and external_id. Built
+     * for type-ahead filter pickers, where the operator knows the customer's own
+     * identifier rather than Cadenya's.
+     */
+    query?: string;
+    /**
+     * Query param: Sort order for results (asc or desc by creation time).
+     */
+    sortOrder?: string;
+}
+export interface TenantDeleteParams {
+    /**
+     * Workspace ID.
+     */
+    workspaceId?: string;
+}
+export declare namespace Tenants {
+    export { type Subject as Subject, type SubjectInfo as SubjectInfo, type Tenant as Tenant, type TenantInfo as TenantInfo, type TenantsCursorPagination as TenantsCursorPagination, type TenantRetrieveParams as TenantRetrieveParams, type TenantListParams as TenantListParams, type TenantDeleteParams as TenantDeleteParams, };
+    export { Subjects as Subjects, type SubjectListParams as SubjectListParams };
+}
+//# sourceMappingURL=tenants.d.ts.map

package/resources/tenants/tenants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenants.d.ts","sourceRoot":"","sources":["../../src/resources/tenants/tenants.ts"],"names":[],"mappings":"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"}

package/resources/tenants/tenants.js

@@ -0,0 +1,58 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Tenants = void 0;
+const tslib_1 = require("../../internal/tslib.js");
+const resource_1 = require("../../core/resource.js");
+const SubjectsAPI = tslib_1.__importStar(require("./subjects.js"));
+const subjects_1 = require("./subjects.js");
+const pagination_1 = require("../../core/pagination.js");
+const path_1 = require("../../internal/utils/path.js");
+/**
+ * Read and erase tenants and the subjects under them. Tenants and subjects are
+ *  created by assertion — on objective creation or widget session mint — never
+ *  directly, so this service has no create or update: it exists to enumerate what
+ *  assertions have produced, and to destroy it on request.
+ */
+class Tenants extends resource_1.APIResource {
+    constructor() {
+        super(...arguments);
+        this.subjects = new SubjectsAPI.Subjects(this._client);
+    }
+    /**
+     * Retrieves a tenant by its canonical id or by the `external_id:<value>` form the
+     * customer asserted it under.
+     */
+    retrieve(id, params = {}, options) {
+        const { workspaceId = this._client.workspaceID, ...query } = params ?? {};
+        return this._client.get((0, path_1.path) `/v1/workspaces/${workspaceId}/tenants/${id}`, { query, ...options });
+    }
+    /**
+     * Lists the tenants asserted in a workspace, newest first. `query` matches against
+     * a tenant's name and its external_id, for type-ahead filters.
+     */
+    list(params = {}, options) {
+        const { workspaceId = this._client.workspaceID, ...query } = params ?? {};
+        return this._client.getAPIList((0, path_1.path) `/v1/workspaces/${workspaceId}/tenants`, (pagination_1.CursorPagination), {
+            query,
+            ...options,
+        });
+    }
+    /**
+     * Destroys the tenant, its subjects, every objective associated with it and
+     * everything reachable from those objectives, and its widget sessions. This is the
+     * full erasure hammer, wider than `DELETE /widget_sessions`, which removes only
+     * what widget sessions created. The work runs in the background: this returns the
+     * tenant in STATE_ERASING rather than a count of what was removed, since a large
+     * tenant's history cannot be destroyed inside a request. Poll the tenant to follow
+     * it — STATE_ERASING while it runs, NotFound once it finishes. Erasure is
+     * terminal; a tenant cannot be recovered once it starts.
+     */
+    delete(id, params = {}, options) {
+        const { workspaceId = this._client.workspaceID } = params ?? {};
+        return this._client.delete((0, path_1.path) `/v1/workspaces/${workspaceId}/tenants/${id}`, options);
+    }
+}
+exports.Tenants = Tenants;
+Tenants.Subjects = subjects_1.Subjects;
+//# sourceMappingURL=tenants.js.map

package/resources/tenants/tenants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenants.js","sourceRoot":"","sources":["../../src/resources/tenants/tenants.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,qDAAkD;AAGlD,mEAA0C;AAC1C,4CAAyD;AAEzD,yDAAmG;AAEnG,uDAAiD;AAEjD;;;;;GAKG;AACH,MAAa,OAAQ,SAAQ,sBAAW;IAAxC;;QACE,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAgD1E,CAAC;IA9CC;;;OAGG;IACH,QAAQ,CACN,EAAU,EACV,SAAkD,EAAE,EACpD,OAAwB;QAExB,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,KAAK,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QAC1E,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,kBAAkB,WAAW,YAAY,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACpG,CAAC;IAED;;;OAGG;IACH,IAAI,CACF,SAA8C,EAAE,EAChD,OAAwB;QAExB,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,KAAK,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QAC1E,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAA,WAAI,EAAA,kBAAkB,WAAW,UAAU,EAAE,CAAA,6BAAwB,CAAA,EAAE;YACpG,KAAK;YACL,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CACJ,EAAU,EACV,SAAgD,EAAE,EAClD,OAAwB;QAExB,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QAChE,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,kBAAkB,WAAW,YAAY,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IACzF,CAAC;CACF;AAjDD,0BAiDC;AAyID,OAAO,CAAC,QAAQ,GAAG,mBAAQ,CAAC"}

package/resources/tenants/tenants.mjs

@@ -0,0 +1,53 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../core/resource.mjs";
+import * as SubjectsAPI from "./subjects.mjs";
+import { Subjects } from "./subjects.mjs";
+import { CursorPagination } from "../../core/pagination.mjs";
+import { path } from "../../internal/utils/path.mjs";
+/**
+ * Read and erase tenants and the subjects under them. Tenants and subjects are
+ *  created by assertion — on objective creation or widget session mint — never
+ *  directly, so this service has no create or update: it exists to enumerate what
+ *  assertions have produced, and to destroy it on request.
+ */
+export class Tenants extends APIResource {
+    constructor() {
+        super(...arguments);
+        this.subjects = new SubjectsAPI.Subjects(this._client);
+    }
+    /**
+     * Retrieves a tenant by its canonical id or by the `external_id:<value>` form the
+     * customer asserted it under.
+     */
+    retrieve(id, params = {}, options) {
+        const { workspaceId = this._client.workspaceID, ...query } = params ?? {};
+        return this._client.get(path `/v1/workspaces/${workspaceId}/tenants/${id}`, { query, ...options });
+    }
+    /**
+     * Lists the tenants asserted in a workspace, newest first. `query` matches against
+     * a tenant's name and its external_id, for type-ahead filters.
+     */
+    list(params = {}, options) {
+        const { workspaceId = this._client.workspaceID, ...query } = params ?? {};
+        return this._client.getAPIList(path `/v1/workspaces/${workspaceId}/tenants`, (CursorPagination), {
+            query,
+            ...options,
+        });
+    }
+    /**
+     * Destroys the tenant, its subjects, every objective associated with it and
+     * everything reachable from those objectives, and its widget sessions. This is the
+     * full erasure hammer, wider than `DELETE /widget_sessions`, which removes only
+     * what widget sessions created. The work runs in the background: this returns the
+     * tenant in STATE_ERASING rather than a count of what was removed, since a large
+     * tenant's history cannot be destroyed inside a request. Poll the tenant to follow
+     * it — STATE_ERASING while it runs, NotFound once it finishes. Erasure is
+     * terminal; a tenant cannot be recovered once it starts.
+     */
+    delete(id, params = {}, options) {
+        const { workspaceId = this._client.workspaceID } = params ?? {};
+        return this._client.delete(path `/v1/workspaces/${workspaceId}/tenants/${id}`, options);
+    }
+}
+Tenants.Subjects = Subjects;
+//# sourceMappingURL=tenants.mjs.map

package/resources/tenants/tenants.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenants.mjs","sourceRoot":"","sources":["../../src/resources/tenants/tenants.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAGlD,OAAO,KAAK,WAAW,uBAAmB;AAC1C,OAAO,EAAqB,QAAQ,EAAE,uBAAmB;AAEzD,OAAO,EAAE,gBAAgB,EAA4C,kCAA8B;AAEnG,OAAO,EAAE,IAAI,EAAE,sCAAkC;AAEjD;;;;;GAKG;AACH,MAAM,OAAO,OAAQ,SAAQ,WAAW;IAAxC;;QACE,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAgD1E,CAAC;IA9CC;;;OAGG;IACH,QAAQ,CACN,EAAU,EACV,SAAkD,EAAE,EACpD,OAAwB;QAExB,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,KAAK,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QAC1E,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,kBAAkB,WAAW,YAAY,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACpG,CAAC;IAED;;;OAGG;IACH,IAAI,CACF,SAA8C,EAAE,EAChD,OAAwB;QAExB,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,KAAK,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QAC1E,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAA,kBAAkB,WAAW,UAAU,EAAE,CAAA,gBAAwB,CAAA,EAAE;YACpG,KAAK;YACL,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CACJ,EAAU,EACV,SAAgD,EAAE,EAClD,OAAwB;QAExB,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QAChE,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,kBAAkB,WAAW,YAAY,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IACzF,CAAC;CACF;AAyID,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC"}

package/resources/tenants.d.mts

@@ -0,0 +1,2 @@
+export * from "./tenants/index.mjs";
+//# sourceMappingURL=tenants.d.mts.map

package/resources/tenants.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenants.d.mts","sourceRoot":"","sources":["../src/resources/tenants.ts"],"names":[],"mappings":"AAEA,oCAAgC"}

package/resources/tenants.d.ts

@@ -0,0 +1,2 @@
+export * from "./tenants/index.js";
+//# sourceMappingURL=tenants.d.ts.map

package/resources/tenants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenants.d.ts","sourceRoot":"","sources":["../src/resources/tenants.ts"],"names":[],"mappings":"AAEA,mCAAgC"}

package/resources/tenants.js

@@ -0,0 +1,6 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("../internal/tslib.js");
+tslib_1.__exportStar(require("./tenants/index.js"), exports);
+//# sourceMappingURL=tenants.js.map

package/resources/tenants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenants.js","sourceRoot":"","sources":["../src/resources/tenants.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,6DAAgC"}

package/resources/tenants.mjs

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+export * from "./tenants/index.mjs";
+//# sourceMappingURL=tenants.mjs.map

package/resources/tenants.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenants.mjs","sourceRoot":"","sources":["../src/resources/tenants.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,oCAAgC"}

package/src/client.ts

@@ -234,6 +234,17 @@ import {
   ToolResult,
   UserMessage,
 } from './resources/objectives/objectives';
+import {
+  Subject,
+  SubjectInfo,
+  Tenant,
+  TenantDeleteParams,
+  TenantInfo,
+  TenantListParams,
+  TenantRetrieveParams,
+  Tenants,
+  TenantsCursorPagination,
+} from './resources/tenants/tenants';
 import {
   ApprovalRequirementFilter,
   ApprovalRequirementFilterAlways,
@@ -1140,6 +1151,13 @@ export class Cadenya {
    *  session tokens minted via WidgetSessionService.
    */
   widgets: API.Widgets = new API.Widgets(this);
+  /**
+   * Read and erase tenants and the subjects under them. Tenants and subjects are
+   *  created by assertion — on objective creation or widget session mint — never
+   *  directly, so this service has no create or update: it exists to enumerate what
+   *  assertions have produced, and to destroy it on request.
+   */
+  tenants: API.Tenants = new API.Tenants(this);
   /**
    * Mint and manage widget sessions. Session creation is server-to-server only:
    *  the customer's backend authenticates its visitor, asserts tenant/subject
@@ -1166,6 +1184,7 @@ Cadenya.Workspaces = Workspaces;
 Cadenya.WorkspaceAdmin = WorkspaceAdmin;
 Cadenya.Webhooks = Webhooks;
 Cadenya.Widgets = Widgets;
+Cadenya.Tenants = Tenants;
 Cadenya.WidgetSessions = WidgetSessions;
 
 export declare namespace Cadenya {
@@ -1455,6 +1474,18 @@ export declare namespace Cadenya {
     type WidgetUnarchiveParams as WidgetUnarchiveParams,
   };
 
+  export {
+    Tenants as Tenants,
+    type Subject as Subject,
+    type SubjectInfo as SubjectInfo,
+    type Tenant as Tenant,
+    type TenantInfo as TenantInfo,
+    type TenantsCursorPagination as TenantsCursorPagination,
+    type TenantRetrieveParams as TenantRetrieveParams,
+    type TenantListParams as TenantListParams,
+    type TenantDeleteParams as TenantDeleteParams,
+  };
+
   export {
     WidgetSessions as WidgetSessions,
     type SubjectAssertion as SubjectAssertion,

package/src/resources/index.ts

@@ -157,6 +157,18 @@ export {
   type SearchSearchToolsOrToolSetsResponse,
   type SearchSearchToolsOrToolSetsParams,
 } from './search';
+export {
+  Tenants,
+  type Subject,
+  type SubjectInfo,
+  type Tenant,
+  type TenantInfo,
+  type TenantRetrieveParams,
+  type TenantListParams,
+  type TenantDeleteParams,
+  type SubjectsCursorPagination,
+  type TenantsCursorPagination,
+} from './tenants/tenants';
 export {
   ToolSets,
   type ApprovalRequirementFilter,

package/src/resources/objectives/objectives.ts

@@ -1150,6 +1150,16 @@ export interface ObjectiveInfo {
    * carrying both Cadenya's canonical id and the customer's own key.
    */
   tenant?: WidgetSessionsAPI.TenantReference;
+
+  /**
+   * BareMetadata contains the minimal metadata for a resource: the ID and an
+   * optional human-readable name. These are used for reference fields where the full
+   * metadata (account scoping, timestamps, labels, external IDs) is not needed —
+   * e.g., the tool references inside an agent variation spec or the tools assigned
+   * to an objective. Both fields are server-populated; clients provide IDs through
+   * sibling fields rather than by constructing a BareMetadata themselves.
+   */
+  widget?: Shared.BareMetadata;
 }
 
 export interface ObjectiveSecret {
@@ -1500,6 +1510,17 @@ export interface ObjectiveListParams extends CursorPaginationParams {
    * canonical `tenant_…` form or the `external_id:<value>` form.
    */
   tenantId?: string;
+
+  /**
+   * Query param: Filter to objectives whose conversation ran through a widget.
+   * Accepts the canonical `wgt_…` form or the `external_id:<value>` form.
+   */
+  widgetId?: string;
+
+  /**
+   * Query param: Filter to objectives created by a specific widget session.
+   */
+  widgetSessionId?: string;
 }
 
 export interface ObjectiveCancelParams {

package/src/resources/tenants/index.ts

@@ -0,0 +1,15 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { Subjects, type SubjectListParams } from './subjects';
+export {
+  Tenants,
+  type Subject,
+  type SubjectInfo,
+  type Tenant,
+  type TenantInfo,
+  type TenantRetrieveParams,
+  type TenantListParams,
+  type TenantDeleteParams,
+  type SubjectsCursorPagination,
+  type TenantsCursorPagination,
+} from './tenants';