needle-cloud 1.10.3-dev.5aa26d7 → 1.10.3-dev.a391912

package/dist/web/auth.d.ts

@@ -62,6 +62,11 @@ export namespace Auth {
      * Initiate the sign-in process
      */
     function signIn(): Promise<void>;
+    /**
+     * Get the user's default team/org ID from their Logto custom_data.
+     * @returns {string | undefined}
+     */
+    function getDefaultTeamId(): string;
     /**
      * Sign out the current user
      */

package/dist/web/functions/chat.d.ts

@@ -1,74 +1,99 @@
 /**
  * List recent AI chats for the authenticated user.
- * @param {{ org?: string }} [opts]
+ * @param {ChatAuthOpts} [opts]
  * @returns {Promise<import("@needle-tools/cloud-sdk/types/api.ai").RecentChatsResponse>}
  */
-export function listChats(opts?: {
-    org?: string;
-}): Promise<import("@needle-tools/cloud-sdk/types/api.ai").RecentChatsResponse>;
+export function listChats(opts?: ChatAuthOpts): Promise<import("@needle-tools/cloud-sdk/types/api.ai").RecentChatsResponse>;
 /**
  * Read an AI chat by slug. Returns JSON with messages by default.
  * When `reconnect: true`, attempts to reconnect to an active SSE stream.
  * @overload
  * @param {string} slug
- * @param {{ org?: string, offset?: number, limit?: number, personal?: boolean, reconnect?: false }} [opts]
+ * @param {ChatAuthOpts & { offset?: number, limit?: number, personal?: boolean, reconnect?: false }} [opts]
  * @returns {Promise<import("@needle-tools/cloud-sdk/types/api.ai").AIChatGETResponse>}
  */
 /**
  * @overload
  * @param {string} slug
- * @param {{ org?: string, personal?: boolean, reconnect: true, signal?: AbortSignal }} opts
+ * @param {ChatAuthOpts & { personal?: boolean, reconnect: true, signal?: AbortSignal }} opts
  * @returns {Promise<AsyncGenerator<import("@needle-tools/cloud-sdk/types/api.ai").ChatStreamEvent> | null>}
  */
 /**
  * @param {string} slug
- * @param {{ org?: string, offset?: number, limit?: number, personal?: boolean, reconnect?: boolean, signal?: AbortSignal }} [opts]
+ * @param {ChatAuthOpts & { offset?: number, limit?: number, personal?: boolean, reconnect?: boolean, signal?: AbortSignal }} [opts]
  * @returns {Promise<import("@needle-tools/cloud-sdk/types/api.ai").AIChatGETResponse | AsyncGenerator<import("@needle-tools/cloud-sdk/types/api.ai").ChatStreamEvent> | null>}
  */
-export function readChat(slug: string, opts?: {
-    org?: string;
+export function readChat(slug: string, opts?: ChatAuthOpts & {
     offset?: number;
     limit?: number;
     personal?: boolean;
     reconnect?: boolean;
     signal?: AbortSignal;
 }): Promise<import("@needle-tools/cloud-sdk/types/api.ai").AIChatGETResponse | AsyncGenerator<import("@needle-tools/cloud-sdk/types/api.ai").ChatStreamEvent> | null>;
+/**
+ * @typedef {import("@needle-tools/cloud-sdk/types/api.ai").ClientToolDefinition} ClientToolDefinition
+ * @typedef {import("@needle-tools/cloud-sdk/types/api.ai").ClientContext} ClientContext
+ * @typedef {import("@needle-tools/cloud-sdk/types/api.ai").ChatStreamEvent} ChatStreamEvent
+ * @typedef {import("@needle-tools/cloud-sdk/types/api.ai").AIChatSyncResponse} AIChatSyncResponse
+ */
 /**
  * Send a message to an AI chat.
  * @overload
  * @param {string} slug
  * @param {string} message
- * @param {{ org?: string, stream?: false, source?: string, personal?: boolean, full_url?: string, pathname?: string }} [opts]
- * @returns {Promise<import("@needle-tools/cloud-sdk/types/api.ai").AIChatSyncResponse>}
+ * @param {ChatAuthOpts & { stream?: false, source?: string, personal?: boolean, full_url?: string, pathname?: string, client_tools?: ClientToolDefinition[], context?: ClientContext[] }} [opts]
+ * @returns {Promise<AIChatSyncResponse>}
  */
 /**
  * @overload
  * @param {string} slug
  * @param {string} message
- * @param {{ org?: string, stream: true, source?: string, personal?: boolean, full_url?: string, pathname?: string }} opts
- * @returns {Promise<AsyncGenerator<import("@needle-tools/cloud-sdk/types/api.ai").ChatStreamEvent>>}
+ * @param {ChatAuthOpts & { stream: true, source?: string, personal?: boolean, full_url?: string, pathname?: string, client_tools?: ClientToolDefinition[], context?: ClientContext[] }} opts
+ * @returns {Promise<AsyncGenerator<ChatStreamEvent>>}
  */
 /**
  * @param {string} slug
  * @param {string} message
- * @param {{ org?: string, stream?: boolean, source?: string, personal?: boolean, full_url?: string, pathname?: string }} [opts]
- * @returns {Promise<import("@needle-tools/cloud-sdk/types/api.ai").AIChatSyncResponse | AsyncGenerator<import("@needle-tools/cloud-sdk/types/api.ai").ChatStreamEvent>>}
+ * @param {ChatAuthOpts & { stream?: boolean, source?: string, personal?: boolean, full_url?: string, pathname?: string, client_tools?: ClientToolDefinition[], context?: ClientContext[] }} [opts]
+ * @returns {Promise<AIChatSyncResponse | AsyncGenerator<ChatStreamEvent>>}
  */
-export function sendChatMessage(slug: string, message: string, opts?: {
-    org?: string;
+export function sendChatMessage(slug: string, message: string, opts?: ChatAuthOpts & {
     stream?: boolean;
     source?: string;
     personal?: boolean;
     full_url?: string;
     pathname?: string;
-}): Promise<import("@needle-tools/cloud-sdk/types/api.ai").AIChatSyncResponse | AsyncGenerator<import("@needle-tools/cloud-sdk/types/api.ai").ChatStreamEvent>>;
+    client_tools?: ClientToolDefinition[];
+    context?: ClientContext[];
+}): Promise<AIChatSyncResponse | AsyncGenerator<ChatStreamEvent>>;
 /**
  * Interrupt an active AI generation for the given chat slug.
  * @param {string} slug
- * @param {{ org?: string, personal?: boolean }} [opts]
+ * @param {ChatAuthOpts & { personal?: boolean }} [opts]
  * @returns {Promise<void>}
  */
-export function interruptChat(slug: string, opts?: {
-    org?: string;
+export function interruptChat(slug: string, opts?: ChatAuthOpts & {
     personal?: boolean;
 }): Promise<void>;
+/**
+ * Submit a client-side tool execution result back to the server.
+ * Call this when you receive a `client_tool_request` event from the SSE stream.
+ * @param {string} requestId - The `request_id` from the `client_tool_request` event
+ * @param {{ result?: any, error?: string }} outcome - The tool result or error
+ * @param {ChatAuthOpts & { personal?: boolean }} [opts]
+ * @returns {Promise<void>}
+ */
+export function submitToolResult(requestId: string, outcome: {
+    result?: any;
+    error?: string;
+}, opts?: ChatAuthOpts & {
+    personal?: boolean;
+}): Promise<void>;
+export type ChatAuthOpts = {
+    org?: string;
+    authToken?: string;
+};
+export type ClientToolDefinition = import("@needle-tools/cloud-sdk/types/api.ai").ClientToolDefinition;
+export type ClientContext = import("@needle-tools/cloud-sdk/types/api.ai").ClientContext;
+export type ChatStreamEvent = import("@needle-tools/cloud-sdk/types/api.ai").ChatStreamEvent;
+export type AIChatSyncResponse = import("@needle-tools/cloud-sdk/types/api.ai").AIChatSyncResponse;

package/dist/web/functions/utils.d.ts

@@ -1,5 +1,6 @@
 /**
  * @param {string | null | undefined} [org]
+ * @param {string | null | undefined} [authToken] - Explicit auth token. If provided, skips Auth.requestAccessToken().
  * @returns {Promise<import("../web.types").AuthData>}
  */
-export function getAuthHeader(org?: string | null | undefined): Promise<import("../web.types").AuthData>;
+export function getAuthHeader(org?: string | null | undefined, authToken?: string | null | undefined): Promise<import("../web.types").AuthData>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "needle-cloud",
-  "version": "1.10.3-dev.5aa26d7",
+  "version": "1.10.3-dev.a391912",
   "type": "module",
   "bin": {
     "needle-cloud": "./bin/cli.js"