qca-sdk 0.3.0 → 0.5.0

package/dist/forward/realtime/conversation.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RealtimeConversations = exports.RealtimeHistoryPage = void 0;
+const resource_js_1 = require("../../core/resource.js");
+const api_promise_js_1 = require("../../core/api-promise.js");
+const error_js_1 = require("../../core/error.js");
+const _utils_js_1 = require("../_utils.js");
+/** History uses before cursors and events, independently of ordinary list pages. */
+class RealtimeHistoryPage {
+    client;
+    conversationID;
+    params;
+    options;
+    data;
+    response;
+    conversation;
+    events;
+    page;
+    _request_id;
+    constructor(client, conversationID, params, options, data, response) {
+        this.client = client;
+        this.conversationID = conversationID;
+        this.params = params;
+        this.options = options;
+        this.data = data;
+        this.response = response;
+        for (const [key, value] of Object.entries(data))
+            if (!(key in this))
+                Object.defineProperty(this, key, { value, enumerable: true });
+        this.conversation = data.conversation;
+        this.events = data.events;
+        this.page = data.page;
+        this._request_id = response.headers.get('x-request-id') ?? response.headers.get('request-id');
+    }
+    hasNextPage() { return this.page.has_more && !!this.page.next_before; }
+    getNextPage() {
+        if (!this.hasNextPage())
+            throw new error_js_1.QoderError('No next history page; check hasNextPage() first');
+        if (this.page.next_before === this.params.before)
+            throw new error_js_1.QoderError('History cursor did not advance');
+        return new RealtimeConversations(this.client).history(this.conversationID, { ...this.params, before: this.page.next_before }, this.options);
+    }
+    async *iterPages() {
+        let current = this;
+        const seen = new Set();
+        if (this.params.before)
+            seen.add(this.params.before);
+        for (;;) {
+            yield current;
+            if (!current.hasNextPage())
+                return;
+            const cursor = current.page.next_before;
+            if (seen.has(cursor))
+                throw new error_js_1.QoderError('History cursor did not advance');
+            seen.add(cursor);
+            current = await current.getNextPage();
+        }
+    }
+    async *[Symbol.asyncIterator]() {
+        for await (const page of this.iterPages())
+            yield* page.events;
+    }
+    toJSON() { return this.data; }
+}
+exports.RealtimeHistoryPage = RealtimeHistoryPage;
+class RealtimeConversations extends resource_js_1.APIResource {
+    /** Create a Beta Realtime Conversation; use a stable key for this operation. */
+    create(params, options = {}) {
+        const { idempotency_key, ...body } = params;
+        const headers = (0, _utils_js_1.requestHeaders)({ 'Idempotency-Key': idempotency_key }, options.headers);
+        const key = options.idempotencyKey ?? headers['idempotency-key'];
+        if (typeof key !== 'string' || !key || key.trim() !== key || new TextEncoder().encode(key).length > 256 || /[\x00-\x1f\x7f]/.test(key)) {
+            throw new error_js_1.QoderError('Idempotency-Key must be 1–256 UTF-8 bytes without surrounding whitespace or control characters');
+        }
+        return this._client.request({ method: 'POST', path: 'realtime/conversations', body, ...options, headers });
+    }
+    /** Query persisted history, newest first; next_before retrieves older records. */
+    history(conversationID, params = {}, options = {}) {
+        const query = { ...params, ...options.query };
+        if (query.limit !== undefined && (!Number.isInteger(query.limit) || query.limit < 1 || query.limit > 100))
+            throw new error_js_1.QoderError('History limit must be an integer from 1 to 100');
+        if (query.before !== undefined && (typeof query.before !== 'string' || !query.before))
+            throw new error_js_1.QoderError('History before must be nonempty');
+        if (query.types !== undefined && !['message', 'work', 'message,work'].includes(query.types))
+            throw new error_js_1.QoderError('History types must be message, work, or message,work');
+        const request = this._client.request({ method: 'GET', path: `realtime/conversations/${(0, _utils_js_1.pathParam)(conversationID, 'conversation_id')}/history`, ...options, query });
+        return new api_promise_js_1.APIPromise(request.asResponse(), async (response) => {
+            const data = (await request.withResponse()).data;
+            if (!data || !Array.isArray(data.events) || !data.conversation || !data.page || typeof data.page.has_more !== 'boolean'
+                || !(data.page.next_before === null || typeof data.page.next_before === 'string') || (data.page.has_more && !data.page.next_before))
+                throw new error_js_1.QoderError('Invalid Realtime history response');
+            return new RealtimeHistoryPage(this._client, conversationID, query, { ...options, query: undefined }, data, response);
+        });
+    }
+}
+exports.RealtimeConversations = RealtimeConversations;
+//# sourceMappingURL=conversation.js.map

package/dist/forward/realtime/conversation.js.map

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

package/dist/forward/realtime/realtime.d.ts

@@ -0,0 +1,9 @@
+import { APIResource } from '../../core/resource.js';
+import { RealtimeConversations } from './conversation.js';
+import { RealtimeConnection, type RealtimeConnectOptions } from './connection.js';
+/** Forward Realtime Beta. WebSocket transport is supported on Node.js only. */
+export declare class Realtime extends APIResource {
+    readonly conversations: RealtimeConversations;
+    connect(options: RealtimeConnectOptions): Promise<RealtimeConnection>;
+}
+//# sourceMappingURL=realtime.d.ts.map

package/dist/forward/realtime/realtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime.d.ts","sourceRoot":"","sources":["../../../src/forward/realtime/realtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,KAAK,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAClF,+EAA+E;AAC/E,qBAAa,QAAS,SAAQ,WAAW;IACvC,QAAQ,CAAC,aAAa,wBAA2C;IACjE,OAAO,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,kBAAkB,CAAC;CACtE"}

package/dist/forward/realtime/realtime.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Realtime = void 0;
+const resource_js_1 = require("../../core/resource.js");
+const conversation_js_1 = require("./conversation.js");
+const connection_js_1 = require("./connection.js");
+/** Forward Realtime Beta. WebSocket transport is supported on Node.js only. */
+class Realtime extends resource_js_1.APIResource {
+    conversations = new conversation_js_1.RealtimeConversations(this._client);
+    connect(options) { return connection_js_1.RealtimeConnection.connect(this._client, options); }
+}
+exports.Realtime = Realtime;
+//# sourceMappingURL=realtime.js.map

package/dist/forward/realtime/realtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime.js","sourceRoot":"","sources":["../../../src/forward/realtime/realtime.ts"],"names":[],"mappings":";;;AAAA,wDAAqD;AACrD,uDAA0D;AAC1D,mDAAkF;AAClF,+EAA+E;AAC/E,MAAa,QAAS,SAAQ,yBAAW;IAC9B,aAAa,GAAG,IAAI,uCAAqB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACjE,OAAO,CAAC,OAA+B,IAAiC,OAAO,kCAAkB,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;CACpI;AAHD,4BAGC"}

package/dist/forward/realtime/types.d.ts

@@ -0,0 +1,204 @@
+/** Forward Realtime Beta protocol. Timestamp strings preserve nanosecond precision. */
+export declare const REALTIME_VERSION: "voice.realtime.v1";
+export type RealtimeVoice = 'longanqian' | 'longanlingxin' | 'longanlingxi' | 'longanxiaoxin' | 'longanlufeng';
+export interface RealtimeConfig {
+    audio?: {
+        output?: {
+            voice?: RealtimeVoice;
+            [key: string]: unknown;
+        };
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+export interface RealtimeConversationCreateParams {
+    identity_id: string;
+    template_id: string;
+    /** Required header, omitted from the JSON body. */
+    idempotency_key: string;
+    title?: string | null;
+    metadata?: Record<string, unknown> | null;
+    config?: RealtimeConfig;
+}
+export interface RealtimeConversation {
+    id: string;
+    type: 'voice.conversation';
+    status: 'ready';
+    title: string | null;
+    metadata: Record<string, unknown>;
+    config: RealtimeConfig;
+    created_at: string;
+    updated_at: string;
+    [key: string]: unknown;
+}
+export interface RealtimeHistoryParams {
+    limit?: number;
+    before?: string;
+    types?: 'message' | 'work' | 'message,work';
+}
+export type RealtimeHistoryEventType = 'voice.user_message.completed' | 'voice.assistant_message.completed' | 'voice.assistant_message.interrupted' | 'voice.work.accepted' | 'voice.work.running' | 'voice.work.completed' | 'voice.work.failed' | 'voice.work.final_announcement' | (string & {});
+export interface RealtimeHistoryEvent {
+    id: string;
+    type: RealtimeHistoryEventType;
+    status: string;
+    occurred_at: string;
+    role?: string;
+    text?: string;
+    work_id?: string;
+    objective?: string;
+    result?: string;
+    error?: {
+        code: string;
+        [key: string]: unknown;
+    };
+    turn_id?: string;
+    user_message_event_id?: string;
+    announcement_id?: string;
+    milestone_type?: string;
+    [key: string]: unknown;
+}
+export interface RealtimeHistoryResponse {
+    conversation: {
+        id: string;
+        title: string | null;
+        initialization_status: string;
+        metadata: Record<string, unknown>;
+        created_at: string;
+        updated_at: string;
+        [key: string]: unknown;
+    };
+    events: RealtimeHistoryEvent[];
+    page: {
+        next_before: string | null;
+        has_more: boolean;
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+export interface RealtimeAudioFormat {
+    format: 'pcm16';
+    sample_rate: number;
+    channels: 1;
+    [key: string]: unknown;
+}
+export interface RealtimeReady {
+    config: RealtimeConfig;
+    provider: string;
+    input_audio: RealtimeAudioFormat;
+    output_audio: RealtimeAudioFormat;
+    capabilities: {
+        graceful_close: boolean;
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+export interface RealtimePlaybackReceipt {
+    work_id?: string;
+    announcement_id?: string;
+}
+export type RealtimeCloseOutcome = 'no_active_response' | 'no_content' | 'saved' | 'saved_interrupted';
+export interface RealtimeClosed {
+    request_id: string;
+    outcome: RealtimeCloseOutcome;
+}
+export interface RealtimeErrorPayload {
+    code: string;
+    message: string;
+    retryable?: boolean;
+    retry_after_ms?: number;
+    [key: string]: unknown;
+}
+export interface RealtimeServerPayloads {
+    'voice.state': {
+        state: string;
+    };
+    'voice.ready': RealtimeReady;
+    'voice.replaced': {
+        reason: string;
+    };
+    'transcript.delta': {
+        role: string;
+        text: string;
+        item_id?: string;
+        response_id?: string;
+    };
+    'transcript.final': {
+        role: string;
+        text: string;
+        item_id?: string;
+        response_id?: string;
+    };
+    'audio.delta': {
+        audio: string;
+    };
+    'audio.done': Record<string, never>;
+    'playback.interrupt': {
+        reason: string;
+    };
+    'work.accepted': {
+        status: 'accepted';
+        objective: string;
+    };
+    'work.running': {
+        status: 'running';
+    };
+    'work.progress': {
+        kind: string;
+        detail: string;
+        title?: string;
+        is_error?: boolean;
+        event_id?: string;
+    };
+    'work.milestone': {
+        announcement_id: string;
+        milestone_type: string;
+        summary: string;
+    };
+    'work.completed': {
+        status: 'completed';
+        result: string;
+        event_id?: string;
+    };
+    'work.failed': {
+        status: 'failed';
+        error: {
+            code: string;
+            [key: string]: unknown;
+        };
+        event_id?: string;
+    };
+    pong: Record<string, never>;
+    'connection.closed': RealtimeClosed;
+    error: RealtimeErrorPayload;
+}
+export interface RealtimeEventEnvelope {
+    version: typeof REALTIME_VERSION;
+    event_id: string;
+    sequence: number;
+    conversation_id: string;
+    timestamp: string;
+    work_id?: string;
+    announcement_id?: string;
+    [key: string]: unknown;
+}
+export type RealtimeKnownEvent = {
+    [K in keyof RealtimeServerPayloads]: RealtimeEventEnvelope & {
+        type: K;
+        payload: RealtimeServerPayloads[K] & Record<string, unknown>;
+    };
+}[keyof RealtimeServerPayloads];
+/** Unknown Beta events retain their envelope and complete payload. */
+export type RealtimeServerEvent = RealtimeKnownEvent | (RealtimeEventEnvelope & {
+    type: string;
+    payload: Record<string, unknown>;
+});
+export interface RealtimeClientEvent {
+    version: typeof REALTIME_VERSION;
+    type: string;
+    payload: Record<string, unknown>;
+}
+/** Narrow a known event payload while continuing to allow future Beta event types. */
+export declare function isRealtimeEvent<K extends keyof RealtimeServerPayloads>(event: RealtimeServerEvent, type: K): event is Extract<RealtimeKnownEvent, {
+    type: K;
+}>;
+//# sourceMappingURL=types.d.ts.map

package/dist/forward/realtime/types.d.ts.map

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

package/dist/forward/realtime/types.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REALTIME_VERSION = void 0;
+exports.isRealtimeEvent = isRealtimeEvent;
+/** Forward Realtime Beta protocol. Timestamp strings preserve nanosecond precision. */
+exports.REALTIME_VERSION = 'voice.realtime.v1';
+/** Narrow a known event payload while continuing to allow future Beta event types. */
+function isRealtimeEvent(event, type) {
+    return event.type === type;
+}
+//# sourceMappingURL=types.js.map

package/dist/forward/realtime/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/forward/realtime/types.ts"],"names":[],"mappings":";;;AAoHA,0CAEC;AAtHD,uFAAuF;AAC1E,QAAA,gBAAgB,GAAG,mBAA4B,CAAC;AAkH7D,sFAAsF;AACtF,SAAgB,eAAe,CAAyC,KAA0B,EAAE,IAAO;IACzG,OAAO,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;AAC7B,CAAC"}

package/dist/forward/service-account-token.d.ts

@@ -0,0 +1,15 @@
+import { APIResource } from '../core/resource.js';
+import { type RequestOptions } from '../core/client.js';
+import type { APIPromise } from '../core/api-promise.js';
+import type { ServiceAccountToken, ServiceAccountTokenCreateParams, ServiceAccountTokenRevokeParams, ServiceAccountTokenRevokeResponse } from './types.js';
+/** @internal Per-call Key authentication overrides ordinary PAT/SAT authentication. */
+export declare function saKeyRequestOptions(saKey: string, options?: RequestOptions): RequestOptions;
+/** Forward SAT issuance and revocation require an explicit SA Key per call. */
+export declare class ServiceAccountTokens extends APIResource {
+    /** Issue an admin SAT. Automatic retries are disabled to avoid duplicate issuance. */
+    create(params: ServiceAccountTokenCreateParams, options?: RequestOptions): APIPromise<ServiceAccountToken>;
+    /** Revoke a Forward SAT binding from the same SA. Creation metadata disambiguates the target. */
+    revoke(authTokenID: string, params: ServiceAccountTokenRevokeParams, options?: RequestOptions): APIPromise<ServiceAccountTokenRevokeResponse>;
+}
+export type { ServiceAccountToken, ServiceAccountTokenCreateParams, ServiceAccountTokenRevokeParams, ServiceAccountTokenRevokeResponse } from './types.js';
+//# sourceMappingURL=service-account-token.d.ts.map

package/dist/forward/service-account-token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-account-token.d.ts","sourceRoot":"","sources":["../../src/forward/service-account-token.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,+BAA+B,EAAE,+BAA+B,EAAE,iCAAiC,EAAE,MAAM,YAAY,CAAC;AAE3J,uFAAuF;AACvF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,cAAc,CAQ3F;AAED,+EAA+E;AAC/E,qBAAa,oBAAqB,SAAQ,WAAW;IACnD,sFAAsF;IACtF,MAAM,CAAC,MAAM,EAAE,+BAA+B,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,mBAAmB,CAAC;IAU1G,iGAAiG;IACjG,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,+BAA+B,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,iCAAiC,CAAC;CAU9I;AAED,YAAY,EAAE,mBAAmB,EAAE,+BAA+B,EAAE,+BAA+B,EAAE,iCAAiC,EAAE,MAAM,YAAY,CAAC"}

package/dist/forward/service-account-token.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServiceAccountTokens = void 0;
+exports.saKeyRequestOptions = saKeyRequestOptions;
+const resource_js_1 = require("../core/resource.js");
+const client_js_1 = require("../core/client.js");
+const _utils_js_1 = require("./_utils.js");
+/** @internal Per-call Key authentication overrides ordinary PAT/SAT authentication. */
+function saKeyRequestOptions(saKey, options) {
+    if (typeof saKey !== 'string' || saKey.length === 0 || /[\u0000-\u0020\u007f]/.test(saKey)) {
+        throw new Error('saKey must be non-empty and contain no whitespace or control characters');
+    }
+    const headers = (0, client_js_1.mergeHeaders)(options?.headers);
+    headers.set('Authorization', `Bearer ${saKey}`);
+    headers.set('Content-Type', 'application/json');
+    return { ...options, headers, maxRetries: 0 };
+}
+/** Forward SAT issuance and revocation require an explicit SA Key per call. */
+class ServiceAccountTokens extends resource_js_1.APIResource {
+    /** Issue an admin SAT. Automatic retries are disabled to avoid duplicate issuance. */
+    create(params, options) {
+        const { saKey, ...payload } = params;
+        return this._client.request({
+            method: 'POST',
+            path: 'service_account_tokens',
+            body: payload,
+            ...saKeyRequestOptions(saKey, options),
+        });
+    }
+    /** Revoke a Forward SAT binding from the same SA. Creation metadata disambiguates the target. */
+    revoke(authTokenID, params, options) {
+        const path = `service_account_tokens/${(0, _utils_js_1.pathParam)(authTokenID, 'auth_token_id')}/revoke`;
+        const { saKey, ...payload } = params;
+        return this._client.request({
+            method: 'POST',
+            path,
+            body: payload,
+            ...saKeyRequestOptions(saKey, options),
+        });
+    }
+}
+exports.ServiceAccountTokens = ServiceAccountTokens;
+//# sourceMappingURL=service-account-token.js.map

package/dist/forward/service-account-token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-account-token.js","sourceRoot":"","sources":["../../src/forward/service-account-token.ts"],"names":[],"mappings":";;;AAOA,kDAQC;AAfD,qDAAkD;AAClD,iDAAsE;AAEtE,2CAAwC;AAGxC,uFAAuF;AACvF,SAAgB,mBAAmB,CAAC,KAAa,EAAE,OAAwB;IACzE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,uBAAuB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3F,MAAM,IAAI,KAAK,CAAC,yEAAyE,CAAC,CAAC;IAC7F,CAAC;IACD,MAAM,OAAO,GAAG,IAAA,wBAAY,EAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC/C,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,UAAU,KAAK,EAAE,CAAC,CAAC;IAChD,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;IAChD,OAAO,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;AAChD,CAAC;AAED,+EAA+E;AAC/E,MAAa,oBAAqB,SAAQ,yBAAW;IACnD,sFAAsF;IACtF,MAAM,CAAC,MAAuC,EAAE,OAAwB;QACtE,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,GAAG,MAAM,CAAC;QACrC,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAsB;YAC/C,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,wBAAwB;YAC9B,IAAI,EAAE,OAAO;YACb,GAAG,mBAAmB,CAAC,KAAK,EAAE,OAAO,CAAC;SACvC,CAAC,CAAC;IACL,CAAC;IAED,iGAAiG;IACjG,MAAM,CAAC,WAAmB,EAAE,MAAuC,EAAE,OAAwB;QAC3F,MAAM,IAAI,GAAG,0BAA0B,IAAA,qBAAS,EAAC,WAAW,EAAE,eAAe,CAAC,SAAS,CAAC;QACxF,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,GAAG,MAAM,CAAC;QACrC,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAoC;YAC7D,MAAM,EAAE,MAAM;YACd,IAAI;YACJ,IAAI,EAAE,OAAO;YACb,GAAG,mBAAmB,CAAC,KAAK,EAAE,OAAO,CAAC;SACvC,CAAC,CAAC;IACL,CAAC;CACF;AAvBD,oDAuBC"}

package/dist/forward/types.d.ts

@@ -1,4 +1,39 @@
 import type { Uploadable } from '../core/uploads.js';
+export interface ServiceAccountTokenCreateParams {
+    /** SA Key sent only in this request's Authorization header; not part of the JSON body. */
+    saKey: string;
+    /** Lifetime in seconds, 1-43200. Omit to use the issuer's default. */
+    ttl_seconds?: number;
+    /** Business audit metadata; do not include credentials or other secrets. */
+    metadata?: Record<string, unknown>;
+}
+export interface ServiceAccountTokenRevokeParams {
+    /** SA Key used only for this request. */
+    saKey: string;
+    target_credential_id?: string;
+    /** RFC 3339 expiry from the issuance response. */
+    target_expires_at?: string;
+    reason?: string;
+}
+/** A newly issued Forward SAT. Treat access_token and serialized responses as secrets. */
+export interface ServiceAccountToken {
+    type: 'service_account_token';
+    access_token: string;
+    token_type: 'Bearer';
+    expires_in: number;
+    expires_at: string;
+    auth_token_id: string;
+    service_account_id: string;
+    credential_id: string;
+    subject_type: 'admin' | 'identity';
+    /** Absent for admin tokens. */
+    identity_id?: string;
+    [key: string]: unknown;
+}
+export interface ServiceAccountTokenRevokeResponse {
+    revoked: boolean;
+    [key: string]: unknown;
+}
 export interface BatchListParams {
     /**
      * 按状态过滤。