@t2000/sdk 5.15.0 → 5.16.0

package/dist/index.d.cts

@@ -33,6 +33,9 @@ interface ChatResult {
     content: string;
     model: string;
     usage?: ChatUsage;
+    /** Confidential calls (`phala/*`) return a TEE attestation receipt id —
+     *  fetch + verify it at `/v1/aci/receipts/{id}`. Absent for ZDR models. */
+    receiptId?: string;
     /** The verbatim OpenAI-shaped response body. */
     raw: unknown;
 }
@@ -49,7 +52,9 @@ interface ApiModel {
 declare function chatCompletion(params: ChatParams): Promise<ChatResult>;
 /** Streaming chat completion — yields assistant text deltas as they arrive
  *  (parses the OpenAI SSE `data:` frames). */
-declare function chatCompletionStream(params: ChatParams): AsyncGenerator<string, void, unknown>;
+declare function chatCompletionStream(params: ChatParams): AsyncGenerator<string, {
+    receiptId?: string;
+}, unknown>;
 /** List the Private API model catalog (`GET /v1/models`). The key is sent when
  *  available but not required (the catalog may be public). */
 declare function listModels(opts?: {
@@ -210,8 +215,11 @@ declare class T2000 extends EventEmitter<T2000Events> {
     pay(options: PayOptions): Promise<PayResult>;
     /** Non-streaming chat completion against the Private API. */
     chat(params: ChatParams): Promise<ChatResult>;
-    /** Streaming chat completion — async-iterate the assistant text deltas. */
-    chatStream(params: ChatParams): AsyncGenerator<string, void, unknown>;
+    /** Streaming chat completion — async-iterate the assistant text deltas;
+     *  the generator returns `{ receiptId }` (confidential attestation) at the end. */
+    chatStream(params: ChatParams): AsyncGenerator<string, {
+        receiptId?: string;
+    }, unknown>;
     /** The Private API model catalog (`GET /v1/models`). */
     models(opts?: {
         apiKey?: string;

package/dist/index.d.ts

@@ -33,6 +33,9 @@ interface ChatResult {
     content: string;
     model: string;
     usage?: ChatUsage;
+    /** Confidential calls (`phala/*`) return a TEE attestation receipt id —
+     *  fetch + verify it at `/v1/aci/receipts/{id}`. Absent for ZDR models. */
+    receiptId?: string;
     /** The verbatim OpenAI-shaped response body. */
     raw: unknown;
 }
@@ -49,7 +52,9 @@ interface ApiModel {
 declare function chatCompletion(params: ChatParams): Promise<ChatResult>;
 /** Streaming chat completion — yields assistant text deltas as they arrive
  *  (parses the OpenAI SSE `data:` frames). */
-declare function chatCompletionStream(params: ChatParams): AsyncGenerator<string, void, unknown>;
+declare function chatCompletionStream(params: ChatParams): AsyncGenerator<string, {
+    receiptId?: string;
+}, unknown>;
 /** List the Private API model catalog (`GET /v1/models`). The key is sent when
  *  available but not required (the catalog may be public). */
 declare function listModels(opts?: {
@@ -210,8 +215,11 @@ declare class T2000 extends EventEmitter<T2000Events> {
     pay(options: PayOptions): Promise<PayResult>;
     /** Non-streaming chat completion against the Private API. */
     chat(params: ChatParams): Promise<ChatResult>;
-    /** Streaming chat completion — async-iterate the assistant text deltas. */
-    chatStream(params: ChatParams): AsyncGenerator<string, void, unknown>;
+    /** Streaming chat completion — async-iterate the assistant text deltas;
+     *  the generator returns `{ receiptId }` (confidential attestation) at the end. */
+    chatStream(params: ChatParams): AsyncGenerator<string, {
+        receiptId?: string;
+    }, unknown>;
     /** The Private API model catalog (`GET /v1/models`). */
     models(opts?: {
         apiKey?: string;

package/dist/index.js

@@ -1928,7 +1928,9 @@ function body(params, stream) {
   return JSON.stringify({
     model: params.model,
     messages: params.messages,
-    ...stream ? { stream: true } : {},
+    // include_usage → the final stream chunk carries usage + x_receipt_id
+    // (the confidential attestation receipt) so we can surface it after a stream.
+    ...stream ? { stream: true, stream_options: { include_usage: true } } : {},
     ...params.maxTokens != null ? { max_tokens: params.maxTokens } : {},
     ...params.temperature != null ? { temperature: params.temperature } : {}
   });
@@ -1944,12 +1946,14 @@ async function chatCompletion(params) {
   if (!res.ok) {
     await failBody(res);
   }
+  const receiptId = res.headers.get("x-receipt-id") ?? void 0;
   const raw = await res.json();
   const content = raw?.choices?.[0]?.message?.content ?? "";
   return {
     content,
     model: raw?.model ?? params.model,
     usage: usageOf(raw),
+    receiptId,
     raw
   };
 }
@@ -1963,11 +1967,12 @@ async function* chatCompletionStream(params) {
   });
   if (!(res.ok && res.body)) {
     await failBody(res);
-    return;
+    return {};
   }
   const reader = res.body.getReader();
   const decoder = new TextDecoder();
   let buffer = "";
+  let receiptId;
   while (true) {
     const { done, value } = await reader.read();
     if (done) {
@@ -1983,10 +1988,13 @@ async function* chatCompletionStream(params) {
       }
       const data = trimmed.slice(5).trim();
       if (data === "[DONE]") {
-        return;
+        return { receiptId };
       }
       try {
         const json = JSON.parse(data);
+        if (json.x_receipt_id) {
+          receiptId = json.x_receipt_id;
+        }
         const delta = json.choices?.[0]?.delta?.content;
         if (typeof delta === "string" && delta) {
           yield delta;
@@ -1995,6 +2003,7 @@ async function* chatCompletionStream(params) {
       }
     }
   }
+  return { receiptId };
 }
 async function listModels(opts) {
   const base = opts?.apiBase ?? DEFAULT_API_BASE;
@@ -2291,7 +2300,8 @@ var T2000 = class _T2000 extends EventEmitter {
   async chat(params) {
     return chatCompletion(params);
   }
-  /** Streaming chat completion — async-iterate the assistant text deltas. */
+  /** Streaming chat completion — async-iterate the assistant text deltas;
+   *  the generator returns `{ receiptId }` (confidential attestation) at the end. */
   chatStream(params) {
     return chatCompletionStream(params);
   }