@yourgpt/llm-sdk 1.5.2 → 1.5.4

package/dist/index.mjs

@@ -1907,6 +1907,84 @@ function createStreamResult(generator) {
   return new StreamResult(generator);
 }
 
+// src/server/generate-result.ts
+var GenerateResult = class {
+  constructor(data) {
+    this.data = data;
+  }
+  /**
+   * Generated text content
+   */
+  get text() {
+    return this.data.text;
+  }
+  /**
+   * All messages from the conversation
+   */
+  get messages() {
+    return this.data.messages;
+  }
+  /**
+   * Tool calls made during generation
+   */
+  get toolCalls() {
+    return this.data.toolCalls;
+  }
+  /**
+   * Results from tool executions
+   */
+  get toolResults() {
+    return this.data.toolResults;
+  }
+  /**
+   * Whether client action is required (e.g., tool approval)
+   */
+  get requiresAction() {
+    return this.data.requiresAction;
+  }
+  /**
+   * Error if generation failed
+   */
+  get error() {
+    return this.data.error;
+  }
+  /**
+   * Whether generation was successful
+   */
+  get success() {
+    return !this.data.error;
+  }
+  /**
+   * Convert to CopilotChat-compatible JSON response
+   *
+   * @example
+   * ```typescript
+   * // Express
+   * res.json(result.toResponse());
+   *
+   * // Next.js
+   * return Response.json(result.toResponse());
+   * ```
+   */
+  toResponse() {
+    return {
+      success: this.success,
+      content: this.data.text,
+      messages: this.data.messages.length > 0 ? this.data.messages : void 0,
+      toolCalls: this.data.toolCalls.length > 0 ? this.data.toolCalls : void 0,
+      toolResults: this.data.toolResults.length > 0 ? this.data.toolResults : void 0,
+      requiresAction: this.data.requiresAction || void 0,
+      error: this.data.error
+    };
+  }
+  /**
+   * Convert to raw object (without methods)
+   */
+  toJSON() {
+    return { ...this.data };
+  }
+};
+
 // src/server/runtime.ts
 function buildToolResultForAI(tool2, result, args) {
   const typedResult = result;
@@ -3069,14 +3147,119 @@ var Runtime = class {
    * console.log('Response:', text);
    * res.json({ response: text });
    *
-   * // With onFinish for usage tracking
-   * const result = await runtime.chat(body, {
-   *   onFinish: ({ usage }) => console.log('Tokens:', usage?.totalTokens)
-   * });
+   * // Usage is included in result - strip before sending to client
+   * const { usage, ...clientResult } = await runtime.chat(body);
+   * await billing.record(usage);
+   * res.json(clientResult);
    * ```
    */
   async chat(request, options) {
-    return this.stream(request, options).collect();
+    return this.stream(request, { signal: options?.signal }).collect({
+      includeUsage: true
+    });
+  }
+  /**
+   * Generate a complete response (non-streaming)
+   *
+   * Like Vercel AI SDK's generateText() - clean, non-streaming API.
+   * Returns GenerateResult with .toResponse() for CopilotChat format.
+   *
+   * @example
+   * ```typescript
+   * // Simple usage
+   * const result = await runtime.generate(body);
+   * console.log(result.text);
+   *
+   * // CopilotChat format response (Express)
+   * res.json(result.toResponse());
+   *
+   * // CopilotChat format response (Next.js)
+   * return Response.json(result.toResponse());
+   *
+   * // With persistence callback
+   * const result = await runtime.generate(body, {
+   *   onFinish: async ({ messages }) => {
+   *     await db.saveMessages(messages);
+   *   },
+   * });
+   * ```
+   */
+  async generate(request, options) {
+    const generator = this.processChatWithLoop(
+      { ...request, streaming: false },
+      options?.signal,
+      void 0,
+      void 0,
+      options?.httpRequest
+    );
+    let text = "";
+    const toolCalls = [];
+    const toolResults = [];
+    let messages = [];
+    let requiresAction = false;
+    let error;
+    try {
+      for await (const event of generator) {
+        switch (event.type) {
+          case "message:delta":
+            text += event.content;
+            break;
+          case "action:start":
+            toolCalls.push({ id: event.id, name: event.name, args: {} });
+            break;
+          case "action:args": {
+            const tc = toolCalls.find((t) => t.id === event.id);
+            if (tc) {
+              try {
+                tc.args = JSON.parse(event.args || "{}");
+              } catch {
+                tc.args = {};
+              }
+            }
+            break;
+          }
+          case "action:end":
+            toolResults.push({
+              id: event.id,
+              result: event.result || event.error
+            });
+            break;
+          case "done":
+            messages = event.messages || [];
+            requiresAction = event.requiresAction || false;
+            break;
+          case "error":
+            error = { message: event.message, code: event.code };
+            break;
+        }
+      }
+    } catch (err) {
+      error = {
+        message: err instanceof Error ? err.message : "Unknown error",
+        code: "GENERATION_ERROR"
+      };
+    }
+    if (options?.onFinish && messages.length > 0 && !error) {
+      try {
+        await options.onFinish({
+          messages,
+          threadId: request.threadId
+        });
+      } catch (callbackError) {
+        console.error(
+          "[Copilot SDK] generate() onFinish callback error:",
+          callbackError
+        );
+      }
+    }
+    return new GenerateResult({
+      text,
+      messages,
+      toolCalls,
+      toolResults,
+      requiresAction,
+      error
+    });
   }
   /**
    * Create Express-compatible handler middleware
@@ -3781,6 +3964,6 @@ async function executeToolCalls(toolCalls, tools, executeServerTool, waitForClie
   return results;
 }
 
-export { DEFAULT_CAPABILITIES, DEFAULT_MAX_ITERATIONS, Runtime, StreamResult, createEventStream, createExpressHandler, createExpressMiddleware, createHonoApp, createNextHandler, createNodeHandler, createRuntime, createSSEHeaders, createSSEResponse, createStreamResult, createTextStreamHeaders, createTextStreamResponse, formatSSEData, formatToolsForAnthropic, formatToolsForGoogle, formatToolsForOpenAI, generateMessageId, generateText, generateThreadId, generateToolCallId, pipeSSEToResponse, pipeTextToResponse, runAgentLoop, streamText, tool };
+export { DEFAULT_CAPABILITIES, DEFAULT_MAX_ITERATIONS, GenerateResult, Runtime, StreamResult, createEventStream, createExpressHandler, createExpressMiddleware, createHonoApp, createNextHandler, createNodeHandler, createRuntime, createSSEHeaders, createSSEResponse, createStreamResult, createTextStreamHeaders, createTextStreamResponse, formatSSEData, formatToolsForAnthropic, formatToolsForGoogle, formatToolsForOpenAI, generateMessageId, generateText, generateThreadId, generateToolCallId, pipeSSEToResponse, pipeTextToResponse, runAgentLoop, streamText, tool };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map