@cadenya/cadenya 1.4.0 → 1.5.0

package/dist/client.js

@@ -50,7 +50,7 @@ export class Cadenya {
             authHeader: () => ({ Authorization: `Bearer ${apiKey}` }),
             maxRetries: options.maxRetries ?? 0,
             timeout: options.timeout,
-            defaultHeaders: { ...nodeUserAgent('cadenya-typescript/1.3.0 (api 1.0)'), ...options.defaultHeaders },
+            defaultHeaders: { ...nodeUserAgent('cadenya-typescript/1.5.0 (api 1.0)'), ...options.defaultHeaders },
             fetch: options.fetch,
             logger: options.logger,
             logLevel: options.logLevel,

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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","sourcesContent":["// Generated by redwood. Do not edit by hand.\n\nimport { HttpClient } from './core/http.js';\nimport type { Logger, LogLevel } from './core/http.js';\nimport { Webhooks } from './webhooks.js';\nimport { Accounts } from './resources/accounts.js';\nimport { ApiKeys } from './resources/api-keys.js';\nimport { WorkspaceAdmin } from './resources/workspace-admin.js';\nimport { Profiles } from './resources/profiles.js';\nimport { Workspaces } from './resources/workspaces.js';\nimport { Agents } from './resources/agents.js';\nimport { AiProviderKeys } from './resources/ai-provider-keys.js';\nimport { Models } from './resources/models.js';\nimport { MemoryLayers } from './resources/memory-layers.js';\nimport { Objectives } from './resources/objectives.js';\nimport { ToolSearch } from './resources/tool-search.js';\nimport { Tenants } from './resources/tenants.js';\nimport { ToolSets } from './resources/tool-sets.js';\nimport { Uploads } from './resources/uploads.js';\nimport { WidgetSessions } from './resources/widget-sessions.js';\nimport { Widgets } from './resources/widgets.js';\nimport { WorkspaceSecrets } from './resources/workspace-secrets.js';\n\nexport interface ClientOptions {\n  /** API key. Defaults to the CADENYA_API_KEY environment variable. */\n  apiKey?: string;\n  /** Override the API base URL. Defaults to https://api.cadenya.com. */\n  baseURL?: string;\n  /** Max automatic retries for retryable failures. Defaults to 0. */\n  maxRetries?: number;\n  /**\n   * Deadline for ordinary (non-streaming) requests in milliseconds; override\n   * per request with `options.timeout`. Streams bound only response-header\n   * acquisition — body lifetime stays under the caller's AbortSignal.\n   * Defaults to 60000; a non-finite or <= 0 value disables the deadline.\n   */\n  timeout?: number;\n  /** Additional request headers. Browsers supply their own User-Agent by default. */\n  defaultHeaders?: Record<string, string>;\n  /** Custom fetch implementation. */\n  fetch?: typeof fetch;\n  /** Destination for SDK logs. Defaults to `console`. */\n  logger?: Logger;\n  /** 'debug' | 'warn' (default) | 'off'. Never logs headers or bodies. */\n  logLevel?: LogLevel;\n  /** Default `workspaceId` for every call that takes one. Defaults to the CADENYA_WORKSPACE_ID environment variable. */\n  workspaceId?: string;\n  /** Secret for webhook signature verification. Defaults to the CADENYA_WEBHOOK_SECRET environment variable. */\n  webhookSecret?: string;\n}\n\nexport class Cadenya {\n  readonly accounts: Accounts;\n  readonly apiKeys: ApiKeys;\n  readonly workspaceAdmin: WorkspaceAdmin;\n  readonly profiles: Profiles;\n  readonly workspaces: Workspaces;\n  readonly agents: Agents;\n  readonly aiProviderKeys: AiProviderKeys;\n  readonly models: Models;\n  readonly memoryLayers: MemoryLayers;\n  readonly objectives: Objectives;\n  readonly toolSearch: ToolSearch;\n  readonly tenants: Tenants;\n  readonly toolSets: ToolSets;\n  readonly uploads: Uploads;\n  readonly widgetSessions: WidgetSessions;\n  readonly widgets: Widgets;\n  readonly workspaceSecrets: WorkspaceSecrets;\n  readonly webhooks: Webhooks;\n\n  private readonly _client: HttpClient;\n\n  constructor(options: ClientOptions = {}) {\n    // Presence is not validity: empty strings from options or environment\n    // are configuration mistakes, not credentials.\n    const apiKey = resolveOption('apiKey', options.apiKey, readEnv('CADENYA_API_KEY'));\n    if (!apiKey) {\n      throw new Error(\n        \"Missing API key. Pass it with `new Cadenya({ apiKey })` or set the CADENYA_API_KEY environment variable.\",\n      );\n    }\n    this._client = new HttpClient({\n      baseURL: resolveOption('baseURL', options.baseURL, readEnv('CADENYA_BASE_URL')) ?? 'https://api.cadenya.com',\n      authHeader: () => ({ Authorization: `Bearer ${apiKey}` }),\n      maxRetries: options.maxRetries ?? 0,\n      timeout: options.timeout,\n      defaultHeaders: { ...nodeUserAgent('cadenya-typescript/1.3.0 (api 1.0)'), ...options.defaultHeaders },\n      fetch: options.fetch,\n      logger: options.logger,\n      logLevel: options.logLevel,\n      defaults: { workspaceId: resolveOption('workspaceId', options.workspaceId, readEnv('CADENYA_WORKSPACE_ID')) },\n    });\n    this.webhooks = new Webhooks(resolveOption('webhookSecret', options.webhookSecret, readEnv('CADENYA_WEBHOOK_SECRET')));\n    this.accounts = new Accounts(this._client);\n    this.apiKeys = new ApiKeys(this._client);\n    this.workspaceAdmin = new WorkspaceAdmin(this._client);\n    this.profiles = new Profiles(this._client);\n    this.workspaces = new Workspaces(this._client);\n    this.agents = new Agents(this._client);\n    this.aiProviderKeys = new AiProviderKeys(this._client);\n    this.models = new Models(this._client);\n    this.memoryLayers = new MemoryLayers(this._client);\n    this.objectives = new Objectives(this._client);\n    this.toolSearch = new ToolSearch(this._client);\n    this.tenants = new Tenants(this._client);\n    this.toolSets = new ToolSets(this._client);\n    this.uploads = new Uploads(this._client);\n    this.widgetSessions = new WidgetSessions(this._client);\n    this.widgets = new Widgets(this._client);\n    this.workspaceSecrets = new WorkspaceSecrets(this._client);\n  }\n}\n\n// Browser-authored User-Agent headers require CORS permission. Only Node-compatible\n// runtimes receive the SDK default; browsers and workers use their native header.\nfunction nodeUserAgent(value: string): Record<string, string> {\n  const nodeVersion = (globalThis as { process?: { versions?: { node?: string } } })\n    .process?.versions?.node;\n  return nodeVersion ? { 'User-Agent': value } : {};\n}\n\nfunction readEnv(name: string): string | undefined {\n  const env = (globalThis as { process?: { env?: Record<string, string | undefined> } })\n    .process?.env;\n  return env?.[name];\n}\n\n// Presence is not validity: an explicitly provided option must be usable —\n// a blank value is a configuration mistake and never silently falls back to\n// the environment or a default. Only an OMITTED option reads the env.\nfunction resolveOption(\n  label: string,\n  explicit: string | undefined,\n  env: string | undefined,\n): string | undefined {\n  if (explicit !== undefined) {\n    const value = explicit.trim();\n    if (!value) {\n      throw new Error(\n        `${label} must not be blank when provided explicitly; omit it to use the environment instead.`,\n      );\n    }\n    return value;\n  }\n  return env?.trim() || undefined;\n}\n"]}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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","sourcesContent":["// Generated by redwood. Do not edit by hand.\n\nimport { HttpClient } from './core/http.js';\nimport type { Logger, LogLevel } from './core/http.js';\nimport { Webhooks } from './webhooks.js';\nimport { Accounts } from './resources/accounts.js';\nimport { ApiKeys } from './resources/api-keys.js';\nimport { WorkspaceAdmin } from './resources/workspace-admin.js';\nimport { Profiles } from './resources/profiles.js';\nimport { Workspaces } from './resources/workspaces.js';\nimport { Agents } from './resources/agents.js';\nimport { AiProviderKeys } from './resources/ai-provider-keys.js';\nimport { Models } from './resources/models.js';\nimport { MemoryLayers } from './resources/memory-layers.js';\nimport { Objectives } from './resources/objectives.js';\nimport { ToolSearch } from './resources/tool-search.js';\nimport { Tenants } from './resources/tenants.js';\nimport { ToolSets } from './resources/tool-sets.js';\nimport { Uploads } from './resources/uploads.js';\nimport { WidgetSessions } from './resources/widget-sessions.js';\nimport { Widgets } from './resources/widgets.js';\nimport { WorkspaceSecrets } from './resources/workspace-secrets.js';\n\nexport interface ClientOptions {\n  /** API key. Defaults to the CADENYA_API_KEY environment variable. */\n  apiKey?: string;\n  /** Override the API base URL. Defaults to https://api.cadenya.com. */\n  baseURL?: string;\n  /** Max automatic retries for retryable failures. Defaults to 0. */\n  maxRetries?: number;\n  /**\n   * Deadline for ordinary (non-streaming) requests in milliseconds; override\n   * per request with `options.timeout`. Streams bound only response-header\n   * acquisition — body lifetime stays under the caller's AbortSignal.\n   * Defaults to 60000; a non-finite or <= 0 value disables the deadline.\n   */\n  timeout?: number;\n  /** Additional request headers. Browsers supply their own User-Agent by default. */\n  defaultHeaders?: Record<string, string>;\n  /** Custom fetch implementation. */\n  fetch?: typeof fetch;\n  /** Destination for SDK logs. Defaults to `console`. */\n  logger?: Logger;\n  /** 'debug' | 'warn' (default) | 'off'. Never logs headers or bodies. */\n  logLevel?: LogLevel;\n  /** Default `workspaceId` for every call that takes one. Defaults to the CADENYA_WORKSPACE_ID environment variable. */\n  workspaceId?: string;\n  /** Secret for webhook signature verification. Defaults to the CADENYA_WEBHOOK_SECRET environment variable. */\n  webhookSecret?: string;\n}\n\nexport class Cadenya {\n  readonly accounts: Accounts;\n  readonly apiKeys: ApiKeys;\n  readonly workspaceAdmin: WorkspaceAdmin;\n  readonly profiles: Profiles;\n  readonly workspaces: Workspaces;\n  readonly agents: Agents;\n  readonly aiProviderKeys: AiProviderKeys;\n  readonly models: Models;\n  readonly memoryLayers: MemoryLayers;\n  readonly objectives: Objectives;\n  readonly toolSearch: ToolSearch;\n  readonly tenants: Tenants;\n  readonly toolSets: ToolSets;\n  readonly uploads: Uploads;\n  readonly widgetSessions: WidgetSessions;\n  readonly widgets: Widgets;\n  readonly workspaceSecrets: WorkspaceSecrets;\n  readonly webhooks: Webhooks;\n\n  private readonly _client: HttpClient;\n\n  constructor(options: ClientOptions = {}) {\n    // Presence is not validity: empty strings from options or environment\n    // are configuration mistakes, not credentials.\n    const apiKey = resolveOption('apiKey', options.apiKey, readEnv('CADENYA_API_KEY'));\n    if (!apiKey) {\n      throw new Error(\n        \"Missing API key. Pass it with `new Cadenya({ apiKey })` or set the CADENYA_API_KEY environment variable.\",\n      );\n    }\n    this._client = new HttpClient({\n      baseURL: resolveOption('baseURL', options.baseURL, readEnv('CADENYA_BASE_URL')) ?? 'https://api.cadenya.com',\n      authHeader: () => ({ Authorization: `Bearer ${apiKey}` }),\n      maxRetries: options.maxRetries ?? 0,\n      timeout: options.timeout,\n      defaultHeaders: { ...nodeUserAgent('cadenya-typescript/1.5.0 (api 1.0)'), ...options.defaultHeaders },\n      fetch: options.fetch,\n      logger: options.logger,\n      logLevel: options.logLevel,\n      defaults: { workspaceId: resolveOption('workspaceId', options.workspaceId, readEnv('CADENYA_WORKSPACE_ID')) },\n    });\n    this.webhooks = new Webhooks(resolveOption('webhookSecret', options.webhookSecret, readEnv('CADENYA_WEBHOOK_SECRET')));\n    this.accounts = new Accounts(this._client);\n    this.apiKeys = new ApiKeys(this._client);\n    this.workspaceAdmin = new WorkspaceAdmin(this._client);\n    this.profiles = new Profiles(this._client);\n    this.workspaces = new Workspaces(this._client);\n    this.agents = new Agents(this._client);\n    this.aiProviderKeys = new AiProviderKeys(this._client);\n    this.models = new Models(this._client);\n    this.memoryLayers = new MemoryLayers(this._client);\n    this.objectives = new Objectives(this._client);\n    this.toolSearch = new ToolSearch(this._client);\n    this.tenants = new Tenants(this._client);\n    this.toolSets = new ToolSets(this._client);\n    this.uploads = new Uploads(this._client);\n    this.widgetSessions = new WidgetSessions(this._client);\n    this.widgets = new Widgets(this._client);\n    this.workspaceSecrets = new WorkspaceSecrets(this._client);\n  }\n}\n\n// Browser-authored User-Agent headers require CORS permission. Only Node-compatible\n// runtimes receive the SDK default; browsers and workers use their native header.\nfunction nodeUserAgent(value: string): Record<string, string> {\n  const nodeVersion = (globalThis as { process?: { versions?: { node?: string } } })\n    .process?.versions?.node;\n  return nodeVersion ? { 'User-Agent': value } : {};\n}\n\nfunction readEnv(name: string): string | undefined {\n  const env = (globalThis as { process?: { env?: Record<string, string | undefined> } })\n    .process?.env;\n  return env?.[name];\n}\n\n// Presence is not validity: an explicitly provided option must be usable —\n// a blank value is a configuration mistake and never silently falls back to\n// the environment or a default. Only an OMITTED option reads the env.\nfunction resolveOption(\n  label: string,\n  explicit: string | undefined,\n  env: string | undefined,\n): string | undefined {\n  if (explicit !== undefined) {\n    const value = explicit.trim();\n    if (!value) {\n      throw new Error(\n        `${label} must not be blank when provided explicitly; omit it to use the environment instead.`,\n      );\n    }\n    return value;\n  }\n  return env?.trim() || undefined;\n}\n"]}

package/dist/resources/widget-sessions.d.ts

@@ -124,7 +124,7 @@ export declare class WidgetSessions {
      *
      * @example
      * ```ts
-     * const widgetSession = await client.widgetSessions.create({ spec: { widgetId: 'sample' } });
+     * const widgetSession = await client.widgetSessions.create({ spec: { subject: { id: 'sample' }, tenant: { id: 'sample' }, widgetId: 'sample' } });
      * ```
      */
     create(params: WidgetSessionCreateParams, options?: RequestOptions): APIPromise<WidgetSession>;

package/dist/resources/widget-sessions.js

@@ -31,7 +31,7 @@ export class WidgetSessions {
      *
      * @example
      * ```ts
-     * const widgetSession = await client.widgetSessions.create({ spec: { widgetId: 'sample' } });
+     * const widgetSession = await client.widgetSessions.create({ spec: { subject: { id: 'sample' }, tenant: { id: 'sample' }, widgetId: 'sample' } });
      * ```
      */
     create(params, options) {

package/dist/resources/widget-sessions.js.map

@@ -1 +1 @@
-{"version":3,"file":"widget-sessions.js","sourceRoot":"","sources":["../../src/resources/widget-sessions.ts"],"names":[],"mappings":"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","sourcesContent":["// Generated by redwood. Do not edit by hand.\n\nimport { HttpClient, RequestOptions, APIPromise, pathSegment, snapshotParams } from '../core/http.js';\nimport { Page } from '../core/pagination.js';\nimport type { CreateOperationMetadata, CreateWidgetSessionRequest_Secret, DeleteTenantWidgetSessionsResponse, ListWidgetSessionsResponse, WidgetSession, WidgetSessionServiceListWidgetSessionsState, WidgetSessionSpecParam } from '../types.js';\nimport { wireWidgetSessionSpec } from '../types.js';\n\nexport interface WidgetSessionListParams {\n  /**\n   * Workspace ID.\n   * \n   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.\n   */\n  workspaceId?: string;\n  /**\n   * Maximum number of results to return.\n   */\n  limit?: number;\n  /**\n   * Pagination cursor from previous response.\n   */\n  cursor?: string;\n  /**\n   * Filter to sessions on a specific widget. Accepts the canonical `wgt_…`\n   *  form or the `external_id:<value>` form.\n   */\n  widgetId?: string;\n  /**\n   * Filter to sessions belonging to a tenant. Accepts the canonical\n   *  `tenant_…` form or the `external_id:<value>` form.\n   */\n  tenantId?: string;\n  /**\n   * Filter to sessions asserted for a subject. Accepts the canonical\n   *  `subj_…` form or the `external_id:<value>` form; the external_id form is\n   *  scoped within a tenant and requires `tenant_id` to also be set.\n   */\n  subjectId?: string;\n  /**\n   * Filter by state.\n   */\n  state?: WidgetSessionServiceListWidgetSessionsState;\n  /**\n   * Filters by metadata labels. Comma-separated key=value pairs,\n   *  e.g. \"env=prod,team=ai\". A resource matches only if every pair\n   *  matches exactly (AND semantics).\n   */\n  labels?: string;\n  /**\n   * Sort order for results (asc or desc by creation time).\n   */\n  sortOrder?: string;\n  /**\n   * When true, the `info` field on each returned session is populated.\n   *  Requests with this flag count more against your rate limit.\n   */\n  includeInfo?: boolean;\n}\n\nexport interface WidgetSessionCreateParams {\n  spec: WidgetSessionSpecParam;\n  /**\n   * Workspace ID.\n   * \n   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.\n   */\n  workspaceId?: string;\n  metadata?: CreateOperationMetadata;\n  /**\n   * Secrets to attach to the session.\n   */\n  secrets?: Array<CreateWidgetSessionRequest_Secret>;\n}\n\nexport interface WidgetSessionDeleteTenantParams {\n  /**\n   * Workspace ID.\n   * \n   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.\n   */\n  workspaceId?: string;\n  /**\n   * Tenant whose sessions to delete. Required — an empty value is rejected\n   *  rather than matching everything. Accepts the canonical `tenant_…` form or\n   *  the `external_id:<value>` form.\n   */\n  tenantId?: string;\n}\n\nexport interface WidgetSessionRetrieveParams {\n  /**\n   * Workspace ID.\n   * \n   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.\n   */\n  workspaceId?: string;\n}\n\nexport interface WidgetSessionDeleteParams {\n  /**\n   * Workspace ID.\n   * \n   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.\n   */\n  workspaceId?: string;\n}\n\nexport interface WidgetSessionRevokeParams {\n  /**\n   * Workspace ID.\n   * \n   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.\n   */\n  workspaceId?: string;\n}\n\nexport class WidgetSessions {\n  constructor(private readonly _client: HttpClient) {}\n\n  /**\n   * List widget sessions\n   * \n   * @example\n   * ```ts\n   * const page = await client.widgetSessions.list();\n   * for await (const item of page) {\n   *   // auto-fetches every page\n   * }\n   * ```\n   */\n  async list(params?: WidgetSessionListParams, options?: RequestOptions): Promise<Page<WidgetSession>> {\n    const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;\n    if (workspaceId === undefined) throw new Error(\"Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.\");\n    const _base = snapshotParams(params);\n    const response = await this._client.request<ListWidgetSessionsResponse>({ method: 'GET', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/widget_sessions`, query: { limit: params?.limit, cursor: params?.cursor, widgetId: params?.widgetId, tenantId: params?.tenantId, subjectId: params?.subjectId, state: params?.state, labels: params?.labels, sortOrder: params?.sortOrder, includeInfo: params?.includeInfo } }, options);\n    return new Page(response.items ?? [], response.pagination?.nextCursor, (cursor) => this.list({ ..._base, cursor: cursor }, options));\n  }\n\n  /**\n   * Create a widget session\n   * \n   * @example\n   * ```ts\n   * const widgetSession = await client.widgetSessions.create({ spec: { widgetId: 'sample' } });\n   * ```\n   */\n  create(params: WidgetSessionCreateParams, options?: RequestOptions): APIPromise<WidgetSession> {\n    return this._client.requestAPI<WidgetSession>(() => {\n      const workspaceId = String(params.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;\n      if (workspaceId === undefined) throw new Error(\"Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.\");\n      return { method: 'POST', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/widget_sessions`, body: { metadata: params.metadata, spec: wireWidgetSessionSpec(params.spec), secrets: params.secrets } };\n    }, options);\n  }\n\n  /**\n   * Delete all of a tenant's widget sessions\n   * \n   * @example\n   * ```ts\n   * const deleteTenantWidgetSessionsResponse = await client.widgetSessions.deleteTenant();\n   * ```\n   */\n  deleteTenant(params?: WidgetSessionDeleteTenantParams, options?: RequestOptions): APIPromise<DeleteTenantWidgetSessionsResponse> {\n    return this._client.requestAPI<DeleteTenantWidgetSessionsResponse>(() => {\n      const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;\n      if (workspaceId === undefined) throw new Error(\"Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.\");\n      return { method: 'DELETE', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/widget_sessions`, query: { tenantId: params?.tenantId } };\n    }, options);\n  }\n\n  /**\n   * Get a widget session by ID\n   * \n   * @example\n   * ```ts\n   * const widgetSession = await client.widgetSessions.retrieve('_123');\n   * ```\n   */\n  retrieve(id: string, params?: WidgetSessionRetrieveParams, options?: RequestOptions): APIPromise<WidgetSession> {\n    return this._client.requestAPI<WidgetSession>(() => {\n      const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;\n      if (workspaceId === undefined) throw new Error(\"Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.\");\n      return { method: 'GET', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/widget_sessions/${pathSegment('id', id)}` };\n    }, options);\n  }\n\n  /**\n   * Delete a widget session\n   * \n   * @example\n   * ```ts\n   * await client.widgetSessions.delete('_123');\n   * ```\n   */\n  delete(id: string, params?: WidgetSessionDeleteParams, options?: RequestOptions): APIPromise<void> {\n    return this._client.requestAPI<void>(() => {\n      const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;\n      if (workspaceId === undefined) throw new Error(\"Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.\");\n      return { method: 'DELETE', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/widget_sessions/${pathSegment('id', id)}`, void: true };\n    }, options);\n  }\n\n  /**\n   * Revoke a widget session\n   * \n   * @example\n   * ```ts\n   * const widgetSession = await client.widgetSessions.revoke('_123');\n   * ```\n   */\n  revoke(id: string, params?: WidgetSessionRevokeParams, options?: RequestOptions): APIPromise<WidgetSession> {\n    return this._client.requestAPI<WidgetSession>(() => {\n      const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;\n      if (workspaceId === undefined) throw new Error(\"Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.\");\n      return { method: 'POST', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/widget_sessions/${pathSegment('id', id)}:revoke` };\n    }, options);\n  }\n}\n"]}
+{"version":3,"file":"widget-sessions.js","sourceRoot":"","sources":["../../src/resources/widget-sessions.ts"],"names":[],"mappings":"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","sourcesContent":["// Generated by redwood. Do not edit by hand.\n\nimport { HttpClient, RequestOptions, APIPromise, pathSegment, snapshotParams } from '../core/http.js';\nimport { Page } from '../core/pagination.js';\nimport type { CreateOperationMetadata, CreateWidgetSessionRequest_Secret, DeleteTenantWidgetSessionsResponse, ListWidgetSessionsResponse, WidgetSession, WidgetSessionServiceListWidgetSessionsState, WidgetSessionSpecParam } from '../types.js';\nimport { wireWidgetSessionSpec } from '../types.js';\n\nexport interface WidgetSessionListParams {\n  /**\n   * Workspace ID.\n   * \n   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.\n   */\n  workspaceId?: string;\n  /**\n   * Maximum number of results to return.\n   */\n  limit?: number;\n  /**\n   * Pagination cursor from previous response.\n   */\n  cursor?: string;\n  /**\n   * Filter to sessions on a specific widget. Accepts the canonical `wgt_…`\n   *  form or the `external_id:<value>` form.\n   */\n  widgetId?: string;\n  /**\n   * Filter to sessions belonging to a tenant. Accepts the canonical\n   *  `tenant_…` form or the `external_id:<value>` form.\n   */\n  tenantId?: string;\n  /**\n   * Filter to sessions asserted for a subject. Accepts the canonical\n   *  `subj_…` form or the `external_id:<value>` form; the external_id form is\n   *  scoped within a tenant and requires `tenant_id` to also be set.\n   */\n  subjectId?: string;\n  /**\n   * Filter by state.\n   */\n  state?: WidgetSessionServiceListWidgetSessionsState;\n  /**\n   * Filters by metadata labels. Comma-separated key=value pairs,\n   *  e.g. \"env=prod,team=ai\". A resource matches only if every pair\n   *  matches exactly (AND semantics).\n   */\n  labels?: string;\n  /**\n   * Sort order for results (asc or desc by creation time).\n   */\n  sortOrder?: string;\n  /**\n   * When true, the `info` field on each returned session is populated.\n   *  Requests with this flag count more against your rate limit.\n   */\n  includeInfo?: boolean;\n}\n\nexport interface WidgetSessionCreateParams {\n  spec: WidgetSessionSpecParam;\n  /**\n   * Workspace ID.\n   * \n   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.\n   */\n  workspaceId?: string;\n  metadata?: CreateOperationMetadata;\n  /**\n   * Secrets to attach to the session.\n   */\n  secrets?: Array<CreateWidgetSessionRequest_Secret>;\n}\n\nexport interface WidgetSessionDeleteTenantParams {\n  /**\n   * Workspace ID.\n   * \n   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.\n   */\n  workspaceId?: string;\n  /**\n   * Tenant whose sessions to delete. Required — an empty value is rejected\n   *  rather than matching everything. Accepts the canonical `tenant_…` form or\n   *  the `external_id:<value>` form.\n   */\n  tenantId?: string;\n}\n\nexport interface WidgetSessionRetrieveParams {\n  /**\n   * Workspace ID.\n   * \n   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.\n   */\n  workspaceId?: string;\n}\n\nexport interface WidgetSessionDeleteParams {\n  /**\n   * Workspace ID.\n   * \n   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.\n   */\n  workspaceId?: string;\n}\n\nexport interface WidgetSessionRevokeParams {\n  /**\n   * Workspace ID.\n   * \n   * Defaults to the client-level `workspaceId` option or the CADENYA_WORKSPACE_ID environment variable.\n   */\n  workspaceId?: string;\n}\n\nexport class WidgetSessions {\n  constructor(private readonly _client: HttpClient) {}\n\n  /**\n   * List widget sessions\n   * \n   * @example\n   * ```ts\n   * const page = await client.widgetSessions.list();\n   * for await (const item of page) {\n   *   // auto-fetches every page\n   * }\n   * ```\n   */\n  async list(params?: WidgetSessionListParams, options?: RequestOptions): Promise<Page<WidgetSession>> {\n    const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;\n    if (workspaceId === undefined) throw new Error(\"Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.\");\n    const _base = snapshotParams(params);\n    const response = await this._client.request<ListWidgetSessionsResponse>({ method: 'GET', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/widget_sessions`, query: { limit: params?.limit, cursor: params?.cursor, widgetId: params?.widgetId, tenantId: params?.tenantId, subjectId: params?.subjectId, state: params?.state, labels: params?.labels, sortOrder: params?.sortOrder, includeInfo: params?.includeInfo } }, options);\n    return new Page(response.items ?? [], response.pagination?.nextCursor, (cursor) => this.list({ ..._base, cursor: cursor }, options));\n  }\n\n  /**\n   * Create a widget session\n   * \n   * @example\n   * ```ts\n   * const widgetSession = await client.widgetSessions.create({ spec: { subject: { id: 'sample' }, tenant: { id: 'sample' }, widgetId: 'sample' } });\n   * ```\n   */\n  create(params: WidgetSessionCreateParams, options?: RequestOptions): APIPromise<WidgetSession> {\n    return this._client.requestAPI<WidgetSession>(() => {\n      const workspaceId = String(params.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;\n      if (workspaceId === undefined) throw new Error(\"Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.\");\n      return { method: 'POST', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/widget_sessions`, body: { metadata: params.metadata, spec: wireWidgetSessionSpec(params.spec), secrets: params.secrets } };\n    }, options);\n  }\n\n  /**\n   * Delete all of a tenant's widget sessions\n   * \n   * @example\n   * ```ts\n   * const deleteTenantWidgetSessionsResponse = await client.widgetSessions.deleteTenant();\n   * ```\n   */\n  deleteTenant(params?: WidgetSessionDeleteTenantParams, options?: RequestOptions): APIPromise<DeleteTenantWidgetSessionsResponse> {\n    return this._client.requestAPI<DeleteTenantWidgetSessionsResponse>(() => {\n      const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;\n      if (workspaceId === undefined) throw new Error(\"Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.\");\n      return { method: 'DELETE', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/widget_sessions`, query: { tenantId: params?.tenantId } };\n    }, options);\n  }\n\n  /**\n   * Get a widget session by ID\n   * \n   * @example\n   * ```ts\n   * const widgetSession = await client.widgetSessions.retrieve('_123');\n   * ```\n   */\n  retrieve(id: string, params?: WidgetSessionRetrieveParams, options?: RequestOptions): APIPromise<WidgetSession> {\n    return this._client.requestAPI<WidgetSession>(() => {\n      const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;\n      if (workspaceId === undefined) throw new Error(\"Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.\");\n      return { method: 'GET', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/widget_sessions/${pathSegment('id', id)}` };\n    }, options);\n  }\n\n  /**\n   * Delete a widget session\n   * \n   * @example\n   * ```ts\n   * await client.widgetSessions.delete('_123');\n   * ```\n   */\n  delete(id: string, params?: WidgetSessionDeleteParams, options?: RequestOptions): APIPromise<void> {\n    return this._client.requestAPI<void>(() => {\n      const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;\n      if (workspaceId === undefined) throw new Error(\"Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.\");\n      return { method: 'DELETE', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/widget_sessions/${pathSegment('id', id)}`, void: true };\n    }, options);\n  }\n\n  /**\n   * Revoke a widget session\n   * \n   * @example\n   * ```ts\n   * const widgetSession = await client.widgetSessions.revoke('_123');\n   * ```\n   */\n  revoke(id: string, params?: WidgetSessionRevokeParams, options?: RequestOptions): APIPromise<WidgetSession> {\n    return this._client.requestAPI<WidgetSession>(() => {\n      const workspaceId = String(params?.workspaceId ?? this._client.defaults['workspaceId'] ?? '').trim() || undefined;\n      if (workspaceId === undefined) throw new Error(\"Missing 'workspaceId': pass it in params, set it on the client, or set the CADENYA_WORKSPACE_ID environment variable.\");\n      return { method: 'POST', path: `/v1/workspaces/${pathSegment('workspaceId', workspaceId)}/widget_sessions/${pathSegment('id', id)}:revoke` };\n    }, options);\n  }\n}\n"]}

package/dist/types.d.ts

@@ -3220,6 +3220,7 @@ export interface SetToolCallContentRequest_ImageBlock {
 export interface SetToolCallContentRequest_TextBlock {
     text: string;
 }
+export type StatusDetails = WidgetSessionErrorInfo | GoogleProtobufAny;
 /**
  * The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).
  */
@@ -3235,7 +3236,7 @@ export interface Status {
     /**
      * A list of messages that carry the error details.  There is a common set of message types for APIs to use.
      */
-    details?: Array<GoogleProtobufAny>;
+    details?: Array<StatusDetails>;
 }
 export interface SubAgentSpawned {
     agent: ResourceMetadata;
@@ -4550,8 +4551,9 @@ export type WidgetSessionState = 'STATE_UNSPECIFIED' | 'STATE_ACTIVE' | 'STATE_E
  *  a widget, minted server-to-server by the customer's backend. The session
  *  carries all customer-asserted context — tenant, subject, labels, secrets —
  *  and every conversation (objective) created through the widget inherits it.
- *  The bearer token returned at mint is short-lived and refreshed at the
- *  widget host; the session row is what makes revocation possible.
+ *  The browser renews short-lived bearer tokens at the widget host with
+ *  RenewWidgetSession, authenticated by its existing token. Renewal preserves
+ *  this bounded grant and does not extend its hard expiry.
  */
 export interface WidgetSession {
     metadata: OperationMetadata;
@@ -4568,6 +4570,44 @@ export interface WidgetSession {
      *  headers server-side — never returned by any API.
      */
     secrets: Array<WidgetSession_Secret>;
+    /**
+     * Present only on creation. The same envelope is returned by
+     *  RenewWidgetSession on the widget host. Omitted on reads, lists, and revocation.
+     *  Existing spec.token/spec.token_expires_at and info.host remain populated
+     *  on creation for v1 compatibility and agree with these credentials.
+     */
+    credentials?: WidgetSessionCredentials;
+}
+/**
+ * WidgetSessionCredentials is the only credential envelope the customer's
+ *  backend forwards to the browser. Never log or persist its token. Responses
+ *  containing credentials use Cache-Control: no-store. Both initial and later
+ *  issuance use the same schema; no refresh token or management key is included.
+ */
+export interface WidgetSessionCredentials {
+    /**
+     * Canonical wsess_ identifier. Ordinary renewal cannot change the session.
+     */
+    sessionId: string;
+    /**
+     * Authoritative hostname, without a scheme or path. Use HTTPS with this
+     *  host; never construct it or accept a host change during renewal.
+     */
+    host: string;
+    /**
+     * Short-lived bearer credential for the widget host only.
+     */
+    token: string;
+    /**
+     * Exact token expiry, at most 15 minutes after issuance and never later
+     *  than session_expires_at. Equals JWT exp without the 60-second validation
+     *  tolerance added. Renew proactively before this timestamp.
+     */
+    tokenExpiresAt: string;
+    /**
+     * Immutable hard session expiry. Issuance never extends this deadline.
+     */
+    sessionExpiresAt: string;
 }
 /**
  * WidgetSessionInfo provides read-only server-derived data about a session.
@@ -4603,7 +4643,7 @@ export interface WidgetSessionInfo {
     messageCount: number;
     /**
      * When the session last created a conversation, sent a message, or
-     *  refreshed a token.
+     *  received a newly issued token.
      */
     lastActiveAt?: string;
 }
@@ -4617,18 +4657,19 @@ export interface WidgetSessionSpec {
      */
     widgetId: string;
     /**
-     * Optional tenant assertion — the customer's org/company identifier for the
-     *  visitor. Upserts the tenant record in the workspace and tags the session
-     *  and every conversation it creates. Conversation listing at the widget
-     *  host is scoped to this tenant.
+     * Required tenant assertion — the customer's organization identifier.
+     *  Upserts the tenant record in the workspace. Every conversation created
+     *  through this session inherits the tenant and subject identity.
      */
-    tenant?: TenantAssertion;
+    tenant: TenantAssertion;
     /**
-     * Optional subject assertion — the visitor within the tenant (e.g. their
-     *  user id in the customer's namespace). Requires `tenant`; a subject
-     *  asserted without a tenant is rejected with InvalidArgument.
+     * Required subject assertion — the visitor's ID within the tenant.
+     *  Sessions with the same tenant and subject share conversation history on
+     *  the same widget and agent, subject to the current session's permissions.
+     *  A static ID deliberately shares that history; use a distinct ID per
+     *  visitor when their conversations should be separate.
      */
-    subject?: SubjectAssertion;
+    subject: SubjectAssertion;
     /**
      * Hard session expiry. Tokens never outlive it; after it passes the session
      *  transitions to STATE_EXPIRED. Defaults to a server-chosen horizon when
@@ -4636,14 +4677,14 @@ export interface WidgetSessionSpec {
      */
     expiresAt?: string;
     /**
-     * The session bearer token. Returned only on creation — subsequent reads
-     *  omit it. The token is short-lived; the widget refreshes it at the widget
-     *  host without involving the customer's backend.
+     * Legacy creation-only alias of credentials.token; omitted on reads.
+     *  Supported throughout v1. New clients should consume credentials.
+     *  The browser obtains replacements with RenewWidgetSession at the widget host.
      */
     token: string;
     /**
-     * Expiry of the token returned in `token`. Distinct from `expires_at`,
-     *  which bounds the session itself.
+     * Legacy creation-only alias of credentials.token_expires_at, supported
+     *  throughout v1. Distinct from expires_at, which bounds the session itself.
      */
     tokenExpiresAt?: string;
     /**
@@ -5317,6 +5358,22 @@ export interface ModelSpec_Capability_Caching {
     type: 'caching';
     caching: Capability_Caching;
 }
+/**
+ * TOKEN_EXPIRED identifies access-token expiry beyond the 60-second clock-skew tolerance. That token cannot renew; use already-installed newer credentials or require explicit app reauthentication. SESSION_* reasons are terminal. Never infer renewability from HTTP status alone.
+ */
+export type WidgetSessionErrorReason = 'TOKEN_EXPIRED' | 'SESSION_REVOKED' | 'SESSION_EXPIRED' | 'SESSION_EXHAUSTED';
+/**
+ * google.rpc.ErrorInfo detail for widget lifecycle failures. Match both domain and reason; ignore unknown reasons rather than renewing automatically.
+ */
+export interface WidgetSessionErrorInfo {
+    '@type': 'type.googleapis.com/google.rpc.ErrorInfo';
+    domain: 'api.cadenya.com';
+    reason: WidgetSessionErrorReason;
+    /**
+     * Optional non-sensitive context. Never contains tokens or secrets.
+     */
+    metadata?: Record<string, string>;
+}
 export type AgentServiceListAgentsState = 'STATE_UNSPECIFIED' | 'STATE_DRAFT' | 'STATE_PUBLISHED' | 'STATE_ARCHIVED';
 export type AgentServiceListAgentsVariationSelectionMode = 'VARIATION_SELECTION_MODE_UNSPECIFIED' | 'VARIATION_SELECTION_MODE_RANDOM' | 'VARIATION_SELECTION_MODE_WEIGHTED';
 export type AgentServiceListAgentFeedbackSentiment = 'FEEDBACK_SENTIMENT_UNSPECIFIED' | 'FEEDBACK_SENTIMENT_POSITIVE' | 'FEEDBACK_SENTIMENT_NEGATIVE';
@@ -5378,18 +5435,19 @@ export interface WidgetSessionSpecParam {
      */
     widgetId: string;
     /**
-     * Optional tenant assertion — the customer's org/company identifier for the
-     *  visitor. Upserts the tenant record in the workspace and tags the session
-     *  and every conversation it creates. Conversation listing at the widget
-     *  host is scoped to this tenant.
+     * Required tenant assertion — the customer's organization identifier.
+     *  Upserts the tenant record in the workspace. Every conversation created
+     *  through this session inherits the tenant and subject identity.
      */
-    tenant?: TenantAssertion;
+    tenant: TenantAssertion;
     /**
-     * Optional subject assertion — the visitor within the tenant (e.g. their
-     *  user id in the customer's namespace). Requires `tenant`; a subject
-     *  asserted without a tenant is rejected with InvalidArgument.
+     * Required subject assertion — the visitor's ID within the tenant.
+     *  Sessions with the same tenant and subject share conversation history on
+     *  the same widget and agent, subject to the current session's permissions.
+     *  A static ID deliberately shares that history; use a distinct ID per
+     *  visitor when their conversations should be separate.
      */
-    subject?: SubjectAssertion;
+    subject: SubjectAssertion;
     /**
      * Hard session expiry. Tokens never outlive it; after it passes the session
      *  transitions to STATE_EXPIRED. Defaults to a server-chosen horizon when