@openrouter/sdk 1.4.0 → 1.4.1

package/esm/models/operations/listinterneffectivevaultsecrets.d.ts

@@ -0,0 +1,68 @@
+import * as z from "zod/v4";
+export type ListInternEffectiveVaultSecretsGlobals = {
+    /**
+     * The app identifier should be your app's URL and is used as the primary identifier for rankings.
+     *
+     * @remarks
+     * This is used to track API usage per application.
+     */
+    httpReferer?: string | undefined;
+    /**
+     * The app display name allows you to customize how your app appears in OpenRouter's dashboard.
+     *
+     * @remarks
+     */
+    appTitle?: string | undefined;
+    /**
+     * Comma-separated list of app categories (e.g. "cli-agent,cloud-agent"). Used for marketplace rankings.
+     *
+     * @remarks
+     */
+    appCategories?: string | undefined;
+};
+export type ListInternEffectiveVaultSecretsRequest = {
+    /**
+     * The app identifier should be your app's URL and is used as the primary identifier for rankings.
+     *
+     * @remarks
+     * This is used to track API usage per application.
+     */
+    httpReferer?: string | undefined;
+    /**
+     * The app display name allows you to customize how your app appears in OpenRouter's dashboard.
+     *
+     * @remarks
+     */
+    appTitle?: string | undefined;
+    /**
+     * Comma-separated list of app categories (e.g. "cli-agent,cloud-agent"). Used for marketplace rankings.
+     *
+     * @remarks
+     */
+    appCategories?: string | undefined;
+    /**
+     * UUID of an intern in the workspace selected by the API key.
+     */
+    internId: string;
+    /**
+     * Page size, 1 to 100. Defaults to 100.
+     */
+    limit?: number | undefined;
+    /**
+     * Number of secrets to skip, 0 to 10000. Defaults to 0.
+     */
+    offset?: number | undefined;
+};
+/** @internal */
+export type ListInternEffectiveVaultSecretsRequest$Outbound = {
+    "HTTP-Referer"?: string | undefined;
+    appTitle?: string | undefined;
+    appCategories?: string | undefined;
+    internId: string;
+    limit: number;
+    offset: number;
+};
+/** @internal */
+export declare const ListInternEffectiveVaultSecretsRequest$outboundSchema: z.ZodType<ListInternEffectiveVaultSecretsRequest$Outbound, ListInternEffectiveVaultSecretsRequest>;
+export declare function listInternEffectiveVaultSecretsRequestToJSON(listInternEffectiveVaultSecretsRequest: ListInternEffectiveVaultSecretsRequest): string;
+//# sourceMappingURL=listinterneffectivevaultsecrets.d.ts.map

package/esm/models/operations/listinterneffectivevaultsecrets.js

@@ -0,0 +1,23 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 8162d29b4032
+ */
+import * as z from "zod/v4";
+import { remap as remap$ } from "../../lib/primitives.js";
+/** @internal */
+export const ListInternEffectiveVaultSecretsRequest$outboundSchema = z.object({
+    httpReferer: z.string().optional(),
+    appTitle: z.string().optional(),
+    appCategories: z.string().optional(),
+    internId: z.string(),
+    limit: z.int().default(100),
+    offset: z.int().default(0),
+}).transform((v) => {
+    return remap$(v, {
+        httpReferer: "HTTP-Referer",
+    });
+});
+export function listInternEffectiveVaultSecretsRequestToJSON(listInternEffectiveVaultSecretsRequest) {
+    return JSON.stringify(ListInternEffectiveVaultSecretsRequest$outboundSchema.parse(listInternEffectiveVaultSecretsRequest));
+}
+//# sourceMappingURL=listinterneffectivevaultsecrets.js.map

package/esm/models/tokenexchangerequest.d.ts

@@ -23,13 +23,13 @@ export type RequestedTokenType = ClosedEnum<typeof RequestedTokenType>;
 /**
  * Optional; only `inference` is available.
  */
-export declare const Scope: {
+export declare const TokenExchangeRequestScope: {
     readonly Inference: "inference";
 };
 /**
  * Optional; only `inference` is available.
  */
-export type Scope = ClosedEnum<typeof Scope>;
+export type TokenExchangeRequestScope = ClosedEnum<typeof TokenExchangeRequestScope>;
 /**
  * Must be `urn:ietf:params:oauth:token-type:jwt`.
  */
@@ -59,7 +59,7 @@ export type TokenExchangeRequest = {
     /**
      * Optional; only `inference` is available.
      */
-    scope?: Scope | undefined;
+    scope?: TokenExchangeRequestScope | undefined;
     /**
      * The JWT issued by your identity provider.
      */
@@ -74,7 +74,7 @@ export declare const GrantType$outboundSchema: z.ZodEnum<typeof GrantType>;
 /** @internal */
 export declare const RequestedTokenType$outboundSchema: z.ZodEnum<typeof RequestedTokenType>;
 /** @internal */
-export declare const Scope$outboundSchema: z.ZodEnum<typeof Scope>;
+export declare const TokenExchangeRequestScope$outboundSchema: z.ZodEnum<typeof TokenExchangeRequestScope>;
 /** @internal */
 export declare const SubjectTokenType$outboundSchema: z.ZodEnum<typeof SubjectTokenType>;
 /** @internal */

package/esm/models/tokenexchangerequest.js

@@ -19,7 +19,7 @@ export const RequestedTokenType = {
 /**
  * Optional; only `inference` is available.
  */
-export const Scope = {
+export const TokenExchangeRequestScope = {
     Inference: "inference",
 };
 /**
@@ -33,7 +33,7 @@ export const GrantType$outboundSchema = z.enum(GrantType);
 /** @internal */
 export const RequestedTokenType$outboundSchema = z.enum(RequestedTokenType);
 /** @internal */
-export const Scope$outboundSchema = z.enum(Scope);
+export const TokenExchangeRequestScope$outboundSchema = z.enum(TokenExchangeRequestScope);
 /** @internal */
 export const SubjectTokenType$outboundSchema = z.enum(SubjectTokenType);
 /** @internal */
@@ -41,7 +41,7 @@ export const TokenExchangeRequest$outboundSchema = z.object({
     federationPolicyId: z.string(),
     grantType: GrantType$outboundSchema,
     requestedTokenType: RequestedTokenType$outboundSchema.optional(),
-    scope: Scope$outboundSchema.optional(),
+    scope: TokenExchangeRequestScope$outboundSchema.optional(),
     subjectToken: z.string(),
     subjectTokenType: SubjectTokenType$outboundSchema,
 }).transform((v) => {

package/esm/models/vaulteffectivesecret.d.ts

@@ -0,0 +1,35 @@
+import * as z from "zod/v4";
+import { OpenEnum } from "../types/enums.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import { SDKValidationError } from "./errors/sdkvalidationerror.js";
+/**
+ * Where the delivered secret is stored: `intern` for the intern's own vault, `attached` for a vault attached to the intern, `workspace` for the workspace vault.
+ */
+export declare const VaultEffectiveSecretScope: {
+    readonly Intern: "intern";
+    readonly Attached: "attached";
+    readonly Workspace: "workspace";
+};
+/**
+ * Where the delivered secret is stored: `intern` for the intern's own vault, `attached` for a vault attached to the intern, `workspace` for the workspace vault.
+ */
+export type VaultEffectiveSecretScope = OpenEnum<typeof VaultEffectiveSecretScope>;
+/**
+ * Metadata for the one secret the intern's outbound requests receive under this name. The secret value is never returned. The intern receives it only on requests to a hostname in `hosts`, or on any request when `hosts` is `null`; a request to any other hostname receives no secret under this name, even when another vault holds one. `fingerprint` is comparable only within one vault.
+ */
+export type VaultEffectiveSecret = {
+    createdAt: Date;
+    fingerprint: string | null;
+    hosts: Array<string> | null;
+    name: string;
+    /**
+     * Where the delivered secret is stored: `intern` for the intern's own vault, `attached` for a vault attached to the intern, `workspace` for the workspace vault.
+     */
+    scope: VaultEffectiveSecretScope;
+};
+/** @internal */
+export declare const VaultEffectiveSecretScope$inboundSchema: z.ZodType<VaultEffectiveSecretScope, unknown>;
+/** @internal */
+export declare const VaultEffectiveSecret$inboundSchema: z.ZodType<VaultEffectiveSecret, unknown>;
+export declare function vaultEffectiveSecretFromJSON(jsonString: string): SafeParseResult<VaultEffectiveSecret, SDKValidationError>;
+//# sourceMappingURL=vaulteffectivesecret.d.ts.map

package/esm/models/vaulteffectivesecret.js

@@ -0,0 +1,34 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 0e9a217f3be7
+ */
+import * as z from "zod/v4";
+import { remap as remap$ } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import * as openEnums from "../types/enums.js";
+/**
+ * Where the delivered secret is stored: `intern` for the intern's own vault, `attached` for a vault attached to the intern, `workspace` for the workspace vault.
+ */
+export const VaultEffectiveSecretScope = {
+    Intern: "intern",
+    Attached: "attached",
+    Workspace: "workspace",
+};
+/** @internal */
+export const VaultEffectiveSecretScope$inboundSchema = openEnums.inboundSchema(VaultEffectiveSecretScope);
+/** @internal */
+export const VaultEffectiveSecret$inboundSchema = z.object({
+    created_at: z.iso.datetime({ offset: true }).transform(v => new Date(v)),
+    fingerprint: z.nullable(z.string()),
+    hosts: z.nullable(z.array(z.string())),
+    name: z.string(),
+    scope: VaultEffectiveSecretScope$inboundSchema,
+}).transform((v) => {
+    return remap$(v, {
+        "created_at": "createdAt",
+    });
+});
+export function vaultEffectiveSecretFromJSON(jsonString) {
+    return safeParse(jsonString, (x) => VaultEffectiveSecret$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'VaultEffectiveSecret' from JSON`);
+}
+//# sourceMappingURL=vaulteffectivesecret.js.map

package/esm/models/vaulteffectivesecretlistresponse.d.ts

@@ -0,0 +1,18 @@
+import * as z from "zod/v4";
+import { Result as SafeParseResult } from "../types/fp.js";
+import { SDKValidationError } from "./errors/sdkvalidationerror.js";
+import { VaultEffectiveSecret } from "./vaulteffectivesecret.js";
+/**
+ * One page of the secrets an intern receives, one entry per name.
+ */
+export type VaultEffectiveSecretListResponse = {
+    data: Array<VaultEffectiveSecret>;
+    /**
+     * True when more secrets exist beyond this page. Request the next page with `offset` increased by the number of returned entries.
+     */
+    hasMore: boolean;
+};
+/** @internal */
+export declare const VaultEffectiveSecretListResponse$inboundSchema: z.ZodType<VaultEffectiveSecretListResponse, unknown>;
+export declare function vaultEffectiveSecretListResponseFromJSON(jsonString: string): SafeParseResult<VaultEffectiveSecretListResponse, SDKValidationError>;
+//# sourceMappingURL=vaulteffectivesecretlistresponse.d.ts.map

package/esm/models/vaulteffectivesecretlistresponse.js

@@ -0,0 +1,21 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 053f6551d3f4
+ */
+import * as z from "zod/v4";
+import { remap as remap$ } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import { VaultEffectiveSecret$inboundSchema, } from "./vaulteffectivesecret.js";
+/** @internal */
+export const VaultEffectiveSecretListResponse$inboundSchema = z.object({
+    data: z.array(VaultEffectiveSecret$inboundSchema),
+    has_more: z.boolean(),
+}).transform((v) => {
+    return remap$(v, {
+        "has_more": "hasMore",
+    });
+});
+export function vaultEffectiveSecretListResponseFromJSON(jsonString) {
+    return safeParse(jsonString, (x) => VaultEffectiveSecretListResponse$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'VaultEffectiveSecretListResponse' from JSON`);
+}
+//# sourceMappingURL=vaulteffectivesecretlistresponse.js.map

package/esm/sdk/interns.d.ts

@@ -6,49 +6,49 @@ export declare class Interns extends ClientSDK {
      * List interns
      *
      * @remarks
-     * Lists interns visible to the authenticated key, newest first. Filter by workspace and one or more lifecycle statuses. The API key selects the caller, workspace and visible interns. There is no default workspace fallback. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.
+     * Lists interns visible to the authenticated key, newest first. Filter by workspace and one or more lifecycle statuses. The API key selects the caller, workspace and visible interns. An intern's own API key sees only that intern: the collection and every other intern answer 404 to it. There is no default workspace fallback. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.
      */
     listInterns(request?: operations.ListInternsRequest | undefined, options?: RequestOptions): Promise<models.InternListResponse>;
     /**
      * Create an intern
      *
      * @remarks
-     * Creates an intern in an explicit workspace. The operation also creates its private vault. It can start provisioning immediately or wait for a later provision call. A retry with the same idempotency key and body resumes unfinished work. The request body is capped at 1048576 bytes and a larger body is refused with 413. A non-empty body must declare `Content-Type: application/json` or it is refused with 415. The API key selects the caller, workspace and visible interns. There is no default workspace fallback. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.
+     * Creates an intern in an explicit workspace. The operation also creates its private vault. It can start provisioning immediately or wait for a later provision call. A retry with the same idempotency key and body resumes unfinished work. The request body is capped at 1048576 bytes and a larger body is refused with 413. A non-empty body must declare `Content-Type: application/json` or it is refused with 415. The API key selects the caller, workspace and visible interns. An intern's own API key sees only that intern: the collection and every other intern answer 404 to it. There is no default workspace fallback. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.
      */
     createIntern(request: operations.CreateInternRequest, options?: RequestOptions): Promise<models.Intern>;
     /**
      * Delete an intern
      *
      * @remarks
-     * Starts safe teardown of the intern, its runtime and its private vault. The body is optional. Send `{"acknowledge_workspace_loss": true}` to delete a `destroy_failed` intern whose `last_failure_message` names `workspace_archive_failed`, accepting that its workspace is not backed up. The request body is capped at 1048576 bytes and a larger body is refused with 413. A non-empty body must declare `Content-Type: application/json` or it is refused with 415. The API key selects the caller, workspace and visible interns. There is no default workspace fallback. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.
+     * Starts safe teardown of the intern, its runtime and its private vault. The body is optional. Send `{"acknowledge_workspace_loss": true}` to delete a `destroy_failed` intern whose `last_failure_message` names `workspace_archive_failed`, accepting that its workspace is not backed up. The request body is capped at 1048576 bytes and a larger body is refused with 413. A non-empty body must declare `Content-Type: application/json` or it is refused with 415. The API key selects the caller, workspace and visible interns. An intern's own API key sees only that intern: the collection and every other intern answer 404 to it. There is no default workspace fallback. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.
      */
     deleteIntern(request: operations.DeleteInternRequest, options?: RequestOptions): Promise<models.DeleteInternResponse>;
     /**
      * Get an intern
      *
      * @remarks
-     * Returns the public lifecycle state and settings for one visible intern. The API key selects the caller, workspace and visible interns. There is no default workspace fallback. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.
+     * Returns the public lifecycle state and settings for one visible intern. The API key selects the caller, workspace and visible interns. An intern's own API key sees only that intern: the collection and every other intern answer 404 to it. There is no default workspace fallback. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.
      */
     getIntern(request: operations.GetInternRequest, options?: RequestOptions): Promise<models.Intern>;
     /**
      * Update an intern
      *
      * @remarks
-     * Changes the intern name, description, instructions or model. Omitted fields stay unchanged. The request body is capped at 1048576 bytes and a larger body is refused with 413. A non-empty body must declare `Content-Type: application/json` or it is refused with 415. The API key selects the caller, workspace and visible interns. There is no default workspace fallback. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.
+     * Changes the intern name, description, instructions or model. Omitted fields stay unchanged. The request body is capped at 1048576 bytes and a larger body is refused with 413. A non-empty body must declare `Content-Type: application/json` or it is refused with 415. The API key selects the caller, workspace and visible interns. An intern's own API key sees only that intern: the collection and every other intern answer 404 to it. There is no default workspace fallback. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.
      */
     updateIntern(request: operations.UpdateInternRequest, options?: RequestOptions): Promise<models.Intern>;
     /**
      * Get an intern's daemon access
      *
      * @remarks
-     * Returns the origin and daemon token that attach `ori tui --host` to one visible, running intern. The token is a credential: the response is sent with `Cache-Control: no-store`, and each reveal is logged by caller and intern. The API key selects the caller, workspace and visible interns. There is no default workspace fallback. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.
+     * Returns the origin and daemon token that attach `ori tui --host` to one visible, running intern. The token is a credential: the response is sent with `Cache-Control: no-store`, and each reveal is logged by caller and intern. The API key selects the caller, workspace and visible interns. An intern's own API key sees only that intern: the collection and every other intern answer 404 to it. There is no default workspace fallback. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.
      */
     getInternDaemon(request: operations.GetInternDaemonRequest, options?: RequestOptions): Promise<models.InternDaemonAccess>;
     /**
      * Get an intern's daemon access (deprecated alias)
      *
      * @remarks
-     * Deprecated alias of `GET /interns/{internId}/daemon` with the same request, response, and errors. The API key selects the caller, workspace and visible interns. There is no default workspace fallback. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.
+     * Deprecated alias of `GET /interns/{internId}/daemon` with the same request, response, and errors. The API key selects the caller, workspace and visible interns. An intern's own API key sees only that intern: the collection and every other intern answer 404 to it. There is no default workspace fallback. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.
      *
      * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
      */
@@ -57,14 +57,14 @@ export declare class Interns extends ClientSDK {
      * Provision an intern
      *
      * @remarks
-     * Starts the first boot, or resumes an intern after suspension. This operation takes no request body. A body carrying any field is refused with 400 rather than ignored. The API key selects the caller, workspace and visible interns. There is no default workspace fallback. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.
+     * Starts the first boot, or resumes an intern after suspension. This operation takes no request body. A body carrying any field is refused with 400 rather than ignored. The API key selects the caller, workspace and visible interns. An intern's own API key sees only that intern: the collection and every other intern answer 404 to it. There is no default workspace fallback. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.
      */
     provisionIntern(request: operations.ProvisionInternRequest, options?: RequestOptions): Promise<models.ProvisionInternResponse>;
     /**
      * Suspend an intern
      *
      * @remarks
-     * Stops the intern runtime while keeping its disk and configuration for a later provision call. This operation takes no request body. A body carrying any field is refused with 400 rather than ignored. The API key selects the caller, workspace and visible interns. There is no default workspace fallback. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.
+     * Stops the intern runtime while keeping its disk and configuration for a later provision call. This operation takes no request body. A body carrying any field is refused with 400 rather than ignored. The API key selects the caller, workspace and visible interns. An intern's own API key sees only that intern: the collection and every other intern answer 404 to it. There is no default workspace fallback. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.
      */
     suspendIntern(request: operations.SuspendInternRequest, options?: RequestOptions): Promise<models.SuspendInternResponse>;
     /**

package/esm/sdk/interns.js

@@ -20,7 +20,7 @@ export class Interns extends ClientSDK {
      * List interns
      *
      * @remarks
-     * Lists interns visible to the authenticated key, newest first. Filter by workspace and one or more lifecycle statuses. The API key selects the caller, workspace and visible interns. There is no default workspace fallback. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.
+     * Lists interns visible to the authenticated key, newest first. Filter by workspace and one or more lifecycle statuses. The API key selects the caller, workspace and visible interns. An intern's own API key sees only that intern: the collection and every other intern answer 404 to it. There is no default workspace fallback. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.
      */
     async listInterns(request, options) {
         return unwrapAsync(internsListInterns(this, request, options));
@@ -29,7 +29,7 @@ export class Interns extends ClientSDK {
      * Create an intern
      *
      * @remarks
-     * Creates an intern in an explicit workspace. The operation also creates its private vault. It can start provisioning immediately or wait for a later provision call. A retry with the same idempotency key and body resumes unfinished work. The request body is capped at 1048576 bytes and a larger body is refused with 413. A non-empty body must declare `Content-Type: application/json` or it is refused with 415. The API key selects the caller, workspace and visible interns. There is no default workspace fallback. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.
+     * Creates an intern in an explicit workspace. The operation also creates its private vault. It can start provisioning immediately or wait for a later provision call. A retry with the same idempotency key and body resumes unfinished work. The request body is capped at 1048576 bytes and a larger body is refused with 413. A non-empty body must declare `Content-Type: application/json` or it is refused with 415. The API key selects the caller, workspace and visible interns. An intern's own API key sees only that intern: the collection and every other intern answer 404 to it. There is no default workspace fallback. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.
      */
     async createIntern(request, options) {
         return unwrapAsync(internsCreateIntern(this, request, options));
@@ -38,7 +38,7 @@ export class Interns extends ClientSDK {
      * Delete an intern
      *
      * @remarks
-     * Starts safe teardown of the intern, its runtime and its private vault. The body is optional. Send `{"acknowledge_workspace_loss": true}` to delete a `destroy_failed` intern whose `last_failure_message` names `workspace_archive_failed`, accepting that its workspace is not backed up. The request body is capped at 1048576 bytes and a larger body is refused with 413. A non-empty body must declare `Content-Type: application/json` or it is refused with 415. The API key selects the caller, workspace and visible interns. There is no default workspace fallback. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.
+     * Starts safe teardown of the intern, its runtime and its private vault. The body is optional. Send `{"acknowledge_workspace_loss": true}` to delete a `destroy_failed` intern whose `last_failure_message` names `workspace_archive_failed`, accepting that its workspace is not backed up. The request body is capped at 1048576 bytes and a larger body is refused with 413. A non-empty body must declare `Content-Type: application/json` or it is refused with 415. The API key selects the caller, workspace and visible interns. An intern's own API key sees only that intern: the collection and every other intern answer 404 to it. There is no default workspace fallback. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.
      */
     async deleteIntern(request, options) {
         return unwrapAsync(internsDeleteIntern(this, request, options));
@@ -47,7 +47,7 @@ export class Interns extends ClientSDK {
      * Get an intern
      *
      * @remarks
-     * Returns the public lifecycle state and settings for one visible intern. The API key selects the caller, workspace and visible interns. There is no default workspace fallback. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.
+     * Returns the public lifecycle state and settings for one visible intern. The API key selects the caller, workspace and visible interns. An intern's own API key sees only that intern: the collection and every other intern answer 404 to it. There is no default workspace fallback. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.
      */
     async getIntern(request, options) {
         return unwrapAsync(internsGetIntern(this, request, options));
@@ -56,7 +56,7 @@ export class Interns extends ClientSDK {
      * Update an intern
      *
      * @remarks
-     * Changes the intern name, description, instructions or model. Omitted fields stay unchanged. The request body is capped at 1048576 bytes and a larger body is refused with 413. A non-empty body must declare `Content-Type: application/json` or it is refused with 415. The API key selects the caller, workspace and visible interns. There is no default workspace fallback. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.
+     * Changes the intern name, description, instructions or model. Omitted fields stay unchanged. The request body is capped at 1048576 bytes and a larger body is refused with 413. A non-empty body must declare `Content-Type: application/json` or it is refused with 415. The API key selects the caller, workspace and visible interns. An intern's own API key sees only that intern: the collection and every other intern answer 404 to it. There is no default workspace fallback. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.
      */
     async updateIntern(request, options) {
         return unwrapAsync(internsUpdateIntern(this, request, options));
@@ -65,7 +65,7 @@ export class Interns extends ClientSDK {
      * Get an intern's daemon access
      *
      * @remarks
-     * Returns the origin and daemon token that attach `ori tui --host` to one visible, running intern. The token is a credential: the response is sent with `Cache-Control: no-store`, and each reveal is logged by caller and intern. The API key selects the caller, workspace and visible interns. There is no default workspace fallback. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.
+     * Returns the origin and daemon token that attach `ori tui --host` to one visible, running intern. The token is a credential: the response is sent with `Cache-Control: no-store`, and each reveal is logged by caller and intern. The API key selects the caller, workspace and visible interns. An intern's own API key sees only that intern: the collection and every other intern answer 404 to it. There is no default workspace fallback. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.
      */
     async getInternDaemon(request, options) {
         return unwrapAsync(internsGetInternDaemon(this, request, options));
@@ -74,7 +74,7 @@ export class Interns extends ClientSDK {
      * Get an intern's daemon access (deprecated alias)
      *
      * @remarks
-     * Deprecated alias of `GET /interns/{internId}/daemon` with the same request, response, and errors. The API key selects the caller, workspace and visible interns. There is no default workspace fallback. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.
+     * Deprecated alias of `GET /interns/{internId}/daemon` with the same request, response, and errors. The API key selects the caller, workspace and visible interns. An intern's own API key sees only that intern: the collection and every other intern answer 404 to it. There is no default workspace fallback. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.
      *
      * @deprecated method: This will be removed in a future release, please migrate away from it as soon as possible.
      */
@@ -85,7 +85,7 @@ export class Interns extends ClientSDK {
      * Provision an intern
      *
      * @remarks
-     * Starts the first boot, or resumes an intern after suspension. This operation takes no request body. A body carrying any field is refused with 400 rather than ignored. The API key selects the caller, workspace and visible interns. There is no default workspace fallback. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.
+     * Starts the first boot, or resumes an intern after suspension. This operation takes no request body. A body carrying any field is refused with 400 rather than ignored. The API key selects the caller, workspace and visible interns. An intern's own API key sees only that intern: the collection and every other intern answer 404 to it. There is no default workspace fallback. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.
      */
     async provisionIntern(request, options) {
         return unwrapAsync(internsProvisionIntern(this, request, options));
@@ -94,7 +94,7 @@ export class Interns extends ClientSDK {
      * Suspend an intern
      *
      * @remarks
-     * Stops the intern runtime while keeping its disk and configuration for a later provision call. This operation takes no request body. A body carrying any field is refused with 400 rather than ignored. The API key selects the caller, workspace and visible interns. There is no default workspace fallback. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.
+     * Stops the intern runtime while keeping its disk and configuration for a later provision call. This operation takes no request body. A body carrying any field is refused with 400 rather than ignored. The API key selects the caller, workspace and visible interns. An intern's own API key sees only that intern: the collection and every other intern answer 404 to it. There is no default workspace fallback. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.
      */
     async suspendIntern(request, options) {
         return unwrapAsync(internsSuspendIntern(this, request, options));

package/esm/sdk/vault.d.ts

@@ -2,53 +2,60 @@ import { ClientSDK, RequestOptions } from "../lib/sdks.js";
 import * as models from "../models/index.js";
 import * as operations from "../models/operations/index.js";
 export declare class Vault extends ClientSDK {
+    /**
+     * List the secrets an intern receives
+     *
+     * @remarks
+     * Lists, one entry per name, the secret the intern's outbound requests receive: its own secrets, secrets from an attached vault, and workspace secrets, including ones stored before workspace-scoped storage. Where several vaults hold a name, the entry is the one that wins, in the order intern, attached, workspace. The same resolution decides what outbound requests receive, so this list and the intern's requests agree. `scope` says which vault the entry comes from. Responses carry metadata only, never values. Results are ordered by name and paginated with `limit` and `offset`. Returns 404 when the intern's attached vault is no longer available, since the intern then receives no secrets. The scope is selected by the API key: workspace routes act on the key's active workspace and intern routes act on one intern inside that workspace. There is no default workspace and no fallback to another scope. Every vault route, including reads, requires access to the Intern API programme and returns 404 outside it. An intern's own API key is confined to that intern: it can always read the intern's secrets and effective secrets, writes to them follow the rules above, and every other intern and every workspace route answers 404. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.
+     */
+    listInternEffectiveVaultSecrets(request: operations.ListInternEffectiveVaultSecretsRequest, options?: RequestOptions): Promise<models.VaultEffectiveSecretListResponse>;
     /**
      * List intern secrets
      *
      * @remarks
-     * Lists secret metadata stored for one intern. Responses contain names, bound hosts, fingerprints and creation times, never secret values. Results are ordered by name and paginated with `limit` and `offset`. The scope is selected by the API key: workspace routes act on the key's active workspace and intern routes act on one intern inside that workspace. There is no default workspace and no fallback to another scope. Every vault route, including reads, requires access to the Intern API programme and returns 404 outside it. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.
+     * Lists secret metadata stored for one intern. The list includes secrets stored from the dashboard or at provisioning before workspace-scoped storage; where both exist under one name, the one stored through this API is listed. Those older secrets cannot be deleted or copied through this API, and storing the same name through this API replaces them. Responses contain names, bound hosts, fingerprints and creation times, never secret values. Results are ordered by name and paginated with `limit` and `offset`. The scope is selected by the API key: workspace routes act on the key's active workspace and intern routes act on one intern inside that workspace. There is no default workspace and no fallback to another scope. Every vault route, including reads, requires access to the Intern API programme and returns 404 outside it. An intern's own API key is confined to that intern: it can always read the intern's secrets and effective secrets, writes to them follow the rules above, and every other intern and every workspace route answers 404. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.
      */
     listInternVaultSecrets(request: operations.ListInternVaultSecretsRequest, options?: RequestOptions): Promise<models.VaultSecretListResponse>;
     /**
      * Delete an intern secret
      *
      * @remarks
-     * Deletes a secret stored for one intern. Returns 204 with no body on success and 404 when the secret does not exist in the selected scope. Writes return 503 while vault writes are disabled for the caller. The scope is selected by the API key: workspace routes act on the key's active workspace and intern routes act on one intern inside that workspace. There is no default workspace and no fallback to another scope. Every vault route, including reads, requires access to the Intern API programme and returns 404 outside it. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.
+     * Deletes a secret stored for one intern. Returns 204 with no body on success and 404 when the secret does not exist in the selected scope. Writes return 503 while vault writes are disabled for the caller. The scope is selected by the API key: workspace routes act on the key's active workspace and intern routes act on one intern inside that workspace. There is no default workspace and no fallback to another scope. Every vault route, including reads, requires access to the Intern API programme and returns 404 outside it. An intern's own API key is confined to that intern: it can always read the intern's secrets and effective secrets, writes to them follow the rules above, and every other intern and every workspace route answers 404. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.
      */
     deleteInternVaultSecret(request: operations.DeleteInternVaultSecretRequest, options?: RequestOptions): Promise<void>;
     /**
      * Store an intern secret
      *
      * @remarks
-     * Creates or replaces a secret stored for one intern. The value is encrypted at rest and released only to the exact hostnames in `hosts`. The response carries metadata only. Writes return 503 while vault writes are disabled for the caller. The scope is selected by the API key: workspace routes act on the key's active workspace and intern routes act on one intern inside that workspace. There is no default workspace and no fallback to another scope. Every vault route, including reads, requires access to the Intern API programme and returns 404 outside it. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.
+     * Creates or replaces a secret stored for one intern. The value is encrypted at rest and released only to the exact hostnames in `hosts`. The response carries metadata only. Writes return 503 while vault writes are disabled for the caller. The scope is selected by the API key: workspace routes act on the key's active workspace and intern routes act on one intern inside that workspace. There is no default workspace and no fallback to another scope. Every vault route, including reads, requires access to the Intern API programme and returns 404 outside it. An intern's own API key is confined to that intern: it can always read the intern's secrets and effective secrets, writes to them follow the rules above, and every other intern and every workspace route answers 404. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.
      */
     storeInternVaultSecret(request: operations.StoreInternVaultSecretRequest, options?: RequestOptions): Promise<models.VaultSecretResponse>;
     /**
      * Copy workspace secrets to an intern
      *
      * @remarks
-     * Copies the named workspace secrets into one intern's scope, replacing any intern secret with the same name. Each copy keeps the source value and host bindings. Every name must exist in the workspace scope or the request fails with 404 and nothing is copied. A workspace secret whose `hosts` is `null` cannot be copied: the request fails with 409 and nothing is copied until that secret is stored again with hosts. The response carries metadata only. Writes return 503 while vault writes are disabled for the caller. The scope is selected by the API key: workspace routes act on the key's active workspace and intern routes act on one intern inside that workspace. There is no default workspace and no fallback to another scope. Every vault route, including reads, requires access to the Intern API programme and returns 404 outside it. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.
+     * Copies the named workspace secrets into one intern's scope, replacing any intern secret with the same name. Each copy keeps the source value and host bindings. Every name must exist in the workspace scope or the request fails with 404 and nothing is copied. A workspace secret whose `hosts` is `null` cannot be copied: the request fails with 409 and nothing is copied until that secret is stored again with hosts. The response carries metadata only. Writes return 503 while vault writes are disabled for the caller. The scope is selected by the API key: workspace routes act on the key's active workspace and intern routes act on one intern inside that workspace. There is no default workspace and no fallback to another scope. Every vault route, including reads, requires access to the Intern API programme and returns 404 outside it. An intern's own API key is confined to that intern: it can always read the intern's secrets and effective secrets, writes to them follow the rules above, and every other intern and every workspace route answers 404. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.
      */
     copyVaultSecretsToIntern(request: operations.CopyVaultSecretsToInternRequest, options?: RequestOptions): Promise<models.VaultSecretCopyResponse>;
     /**
      * List workspace secrets
      *
      * @remarks
-     * Lists secret metadata for the workspace of the authenticated API key. Responses contain names, bound hosts, fingerprints and creation times, never secret values. Results are ordered by name and paginated with `limit` and `offset`. The scope is selected by the API key: workspace routes act on the key's active workspace and intern routes act on one intern inside that workspace. There is no default workspace and no fallback to another scope. Every vault route, including reads, requires access to the Intern API programme and returns 404 outside it. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.
+     * Lists secret metadata for the workspace of the authenticated API key. The list includes secrets stored from the dashboard or at provisioning before workspace-scoped storage; where both exist under one name, the one stored through this API is listed. Those older secrets cannot be deleted or copied through this API, and storing the same name through this API replaces them. Responses contain names, bound hosts, fingerprints and creation times, never secret values. Results are ordered by name and paginated with `limit` and `offset`. The scope is selected by the API key: workspace routes act on the key's active workspace and intern routes act on one intern inside that workspace. There is no default workspace and no fallback to another scope. Every vault route, including reads, requires access to the Intern API programme and returns 404 outside it. An intern's own API key is confined to that intern: it can always read the intern's secrets and effective secrets, writes to them follow the rules above, and every other intern and every workspace route answers 404. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.
      */
     listVaultSecrets(request?: operations.ListVaultSecretsRequest | undefined, options?: RequestOptions): Promise<models.VaultSecretListResponse>;
     /**
      * Delete a workspace secret
      *
      * @remarks
-     * Deletes a secret from the workspace of the authenticated API key. Returns 204 with no body on success and 404 when the secret does not exist in the selected scope. Writes return 503 while vault writes are disabled for the caller. The scope is selected by the API key: workspace routes act on the key's active workspace and intern routes act on one intern inside that workspace. There is no default workspace and no fallback to another scope. Every vault route, including reads, requires access to the Intern API programme and returns 404 outside it. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.
+     * Deletes a secret from the workspace of the authenticated API key. Returns 204 with no body on success and 404 when the secret does not exist in the selected scope. Writes return 503 while vault writes are disabled for the caller. The scope is selected by the API key: workspace routes act on the key's active workspace and intern routes act on one intern inside that workspace. There is no default workspace and no fallback to another scope. Every vault route, including reads, requires access to the Intern API programme and returns 404 outside it. An intern's own API key is confined to that intern: it can always read the intern's secrets and effective secrets, writes to them follow the rules above, and every other intern and every workspace route answers 404. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.
      */
     deleteVaultSecret(request: operations.DeleteVaultSecretRequest, options?: RequestOptions): Promise<void>;
     /**
      * Store a workspace secret
      *
      * @remarks
-     * Creates or replaces a secret in the workspace of the authenticated API key. The value is encrypted at rest and released only to the exact hostnames in `hosts`. The response carries metadata only. Writes return 503 while vault writes are disabled for the caller. The scope is selected by the API key: workspace routes act on the key's active workspace and intern routes act on one intern inside that workspace. There is no default workspace and no fallback to another scope. Every vault route, including reads, requires access to the Intern API programme and returns 404 outside it. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.
+     * Creates or replaces a secret in the workspace of the authenticated API key. The value is encrypted at rest and released only to the exact hostnames in `hosts`. The response carries metadata only. Writes return 503 while vault writes are disabled for the caller. The scope is selected by the API key: workspace routes act on the key's active workspace and intern routes act on one intern inside that workspace. There is no default workspace and no fallback to another scope. Every vault route, including reads, requires access to the Intern API programme and returns 404 outside it. An intern's own API key is confined to that intern: it can always read the intern's secrets and effective secrets, writes to them follow the rules above, and every other intern and every workspace route answers 404. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.
      */
     storeVaultSecret(request: operations.StoreVaultSecretRequest, options?: RequestOptions): Promise<models.VaultSecretResponse>;
 }