qca-sdk 0.4.0 → 0.6.0

package/dist/esm/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/esm/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/esm/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/esm/forward/realtime/realtime.js

@@ -0,0 +1,9 @@
+import { APIResource } from '../../core/resource.js';
+import { RealtimeConversations } from './conversation.js';
+import { RealtimeConnection } from './connection.js';
+/** Forward Realtime Beta. WebSocket transport is supported on Node.js only. */
+export class Realtime extends APIResource {
+    conversations = new RealtimeConversations(this._client);
+    connect(options) { return RealtimeConnection.connect(this._client, options); }
+}
+//# sourceMappingURL=realtime.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"realtime.js","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,EAA+B,MAAM,iBAAiB,CAAC;AAClF,+EAA+E;AAC/E,MAAM,OAAO,QAAS,SAAQ,WAAW;IAC9B,aAAa,GAAG,IAAI,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACjE,OAAO,CAAC,OAA+B,IAAiC,OAAO,kBAAkB,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;CACpI"}

package/dist/esm/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/esm/forward/realtime/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/forward/realtime/types.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,eAAO,MAAM,gBAAgB,EAAG,mBAA4B,CAAC;AAC7D,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG,eAAe,GAAG,cAAc,GAAG,eAAe,GAAG,cAAc,CAAC;AAC/G,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE;YAAE,KAAK,CAAC,EAAE,aAAa,CAAC;YAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;SAAE,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IAC/F,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AACD,MAAM,WAAW,gCAAgC;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC1C,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AACD,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,oBAAoB,CAAC;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,MAAM,EAAE,cAAc,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AACD,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,cAAc,CAAC;CAC7C;AACD,MAAM,MAAM,wBAAwB,GAAG,8BAA8B,GAAG,mCAAmC,GACvG,qCAAqC,GAAG,qBAAqB,GAAG,oBAAoB,GACpF,sBAAsB,GAAG,mBAAmB,GAAG,+BAA+B,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AACnG,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,wBAAwB,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AACD,MAAM,WAAW,uBAAuB;IACtC,YAAY,EAAE;QACZ,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,qBAAqB,EAAE,MAAM,CAAC;QAC9B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B,IAAI,EAAE;QAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IAChF,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AACD,MAAM,WAAW,mBAAmB;IAAG,MAAM,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,CAAC,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE;AAClH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,mBAAmB,CAAC;IACjC,YAAY,EAAE,mBAAmB,CAAC;IAClC,YAAY,EAAE;QAAE,cAAc,EAAE,OAAO,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IAClE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AACD,MAAM,WAAW,uBAAuB;IAAG,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE;AACvF,MAAM,MAAM,oBAAoB,GAAG,oBAAoB,GAAG,YAAY,GAAG,OAAO,GAAG,mBAAmB,CAAC;AACvG,MAAM,WAAW,cAAc;IAAG,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,oBAAoB,CAAA;CAAE;AACrF,MAAM,WAAW,oBAAoB;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE;AAC7I,MAAM,WAAW,sBAAsB;IACrC,aAAa,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,aAAa,EAAE,aAAa,CAAC;IAC7B,gBAAgB,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACrC,kBAAkB,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3F,kBAAkB,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3F,aAAa,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACpC,oBAAoB,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,eAAe,EAAE;QAAE,MAAM,EAAE,UAAU,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3D,cAAc,EAAE;QAAE,MAAM,EAAE,SAAS,CAAA;KAAE,CAAC;IACtC,eAAe,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACzG,gBAAgB,EAAE;QAAE,eAAe,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACvF,gBAAgB,EAAE;QAAE,MAAM,EAAE,WAAW,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7E,aAAa,EAAE;QAAE,MAAM,EAAE,QAAQ,CAAC;QAAC,KAAK,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;SAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxG,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC5B,mBAAmB,EAAE,cAAc,CAAC;IACpC,KAAK,EAAE,oBAAoB,CAAC;CAC7B;AACD,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,gBAAgB,CAAC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AACD,MAAM,MAAM,kBAAkB,GAAG;KAAG,CAAC,IAAI,MAAM,sBAAsB,GAAG,qBAAqB,GAAG;QAC9F,IAAI,EAAE,CAAC,CAAC;QAAC,OAAO,EAAE,sBAAsB,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACvE;CAAE,CAAC,MAAM,sBAAsB,CAAC,CAAC;AAClC,sEAAsE;AACtE,MAAM,MAAM,mBAAmB,GAAG,kBAAkB,GAAG,CAAC,qBAAqB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC,CAAC;AACpI,MAAM,WAAW,mBAAmB;IAAG,OAAO,EAAE,OAAO,gBAAgB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE;AAEzH,sFAAsF;AACtF,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,sBAAsB,EAAE,KAAK,EAAE,mBAAmB,EAAE,IAAI,EAAE,CAAC,GAAG,KAAK,IAAI,OAAO,CAAC,kBAAkB,EAAE;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,CAAC,CAE9J"}

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

@@ -0,0 +1,7 @@
+/** Forward Realtime Beta protocol. Timestamp strings preserve nanosecond precision. */
+export const REALTIME_VERSION = 'voice.realtime.v1';
+/** Narrow a known event payload while continuing to allow future Beta event types. */
+export function isRealtimeEvent(event, type) {
+    return event.type === type;
+}
+//# sourceMappingURL=types.js.map

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

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

package/dist/esm/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/esm/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/esm/forward/service-account-token.js

@@ -0,0 +1,38 @@
+import { APIResource } from '../core/resource.js';
+import { mergeHeaders } from '../core/client.js';
+import { pathParam } from './_utils.js';
+/** @internal Per-call Key authentication overrides ordinary PAT/SAT authentication. */
+export 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 = 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. */
+export class ServiceAccountTokens extends 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/${pathParam(authTokenID, 'auth_token_id')}/revoke`;
+        const { saKey, ...payload } = params;
+        return this._client.request({
+            method: 'POST',
+            path,
+            body: payload,
+            ...saKeyRequestOptions(saKey, options),
+        });
+    }
+}
+//# sourceMappingURL=service-account-token.js.map

package/dist/esm/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":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAuB,MAAM,mBAAmB,CAAC;AAEtE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,uFAAuF;AACvF,MAAM,UAAU,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,YAAY,CAAC,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,MAAM,OAAO,oBAAqB,SAAQ,WAAW;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,SAAS,CAAC,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"}

package/dist/esm/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 {
     /**
      * 按状态过滤。
@@ -2591,6 +2626,8 @@ export interface TemplateListParams {
     [key: string]: unknown;
 }
 export interface TemplateNewParams {
+    /** Replaces the complete managed tool list. Null or an empty list disables it. */
+    managed_tool_config?: ManagedToolConfig | null;
     /**
      * Template 名称，1-256 个字符，租户内唯一。
      */
@@ -2659,6 +2696,8 @@ export interface TemplateNewParams {
     [key: string]: unknown;
 }
 export interface TemplateUpdateParams {
+    /** Replaces the complete managed tool list. Null or an empty list disables it. */
+    managed_tool_config?: ManagedToolConfig | null;
     /**
      * 新的 Template 名称。
      */
@@ -2751,6 +2790,8 @@ export interface TemplateCloneParams {
     [key: string]: unknown;
 }
 export interface Template {
+    /** Replaces the complete managed tool list. Null or an empty list disables it. */
+    managed_tool_config?: ManagedToolConfig | null;
     /**
      * 固定为 `template`。
      */
@@ -3024,4 +3065,82 @@ export interface TemplateUsage {
     active_seconds: number;
     credits: number;
 }
+/** Forward-managed tools. This is distinct from tools[].enabled_tools. */
+export interface ManagedToolConfig {
+    /** The complete enabled list; [] disables all managed tools. */
+    enabled_tools: Array<string>;
+    [key: string]: unknown;
+}
+/** One file or virtual directory in an Identity Drive. */
+export interface DriveEntry {
+    path: string;
+    name: string;
+    type: 'file' | 'directory';
+    /** Zero for an empty file; omitted for directories. */
+    size?: number;
+    etag?: string;
+    last_modified?: string;
+    [key: string]: unknown;
+}
+export interface DriveListEntriesResponse {
+    /** Immediate children, in the order returned by the service. */
+    entries: Array<DriveEntry>;
+    /** Omitted on the last page. Do not alter or reuse in another scope/path. */
+    next_page_token?: string;
+    [key: string]: unknown;
+}
+export interface DriveListEntriesParams {
+    /** Query parameter; required even with an Identity SAT. */
+    identity_id: string;
+    /** Relative directory; omit or use an empty string for root. */
+    path?: string;
+    /** Page size, 1–100 (default 20). */
+    limit?: number;
+    page_token?: string;
+}
+export interface DriveCreateUploadURLParams {
+    /** Query parameter, not part of the JSON body. */
+    identity_id: string;
+    path: string;
+    content_type?: string;
+}
+export interface DriveCreateDownloadURLParams {
+    identity_id: string;
+    path: string;
+}
+export interface DriveDeleteEntryParams {
+    identity_id: string;
+    path: string;
+    recursive?: boolean;
+}
+export interface DriveClearParams {
+    identity_id: string;
+}
+/** A signed storage URL, valid for 15 minutes. Treat the URL as a credential. */
+export interface DriveUploadURL {
+    url: string;
+    method: 'PUT';
+    headers: Record<string, string>;
+    expires_at: string;
+    [key: string]: unknown;
+}
+export interface DriveDownloadURL {
+    url: string;
+    method: 'GET';
+    headers: Record<string, string>;
+    expires_at: string;
+    /** May be omitted for a zero-byte file. */
+    size?: number;
+    etag?: string;
+    content_type?: string;
+    [key: string]: unknown;
+}
+export interface DriveDeleteEntryResponse {
+    deleted_count: number;
+    [key: string]: unknown;
+}
+export interface DriveClearResponse {
+    deleted_count: number;
+    [key: string]: unknown;
+}
 //# sourceMappingURL=types.d.ts.map