needle-cloud 1.10.2 → 1.10.3-dev.14eac62

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

@@ -0,0 +1,99 @@
+/**
+ * List recent AI chats for the authenticated user.
+ * @param {ChatAuthOpts} [opts]
+ * @returns {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 {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 {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 {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?: 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 {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 {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 {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?: ChatAuthOpts & {
+    stream?: boolean;
+    source?: string;
+    personal?: boolean;
+    full_url?: string;
+    pathname?: string;
+    client_tools?: ClientToolDefinition[];
+    context?: ClientContext[];
+}): Promise<AIChatSyncResponse | AsyncGenerator<ChatStreamEvent>>;
+/**
+ * Interrupt an active AI generation for the given chat slug.
+ * @param {string} slug
+ * @param {ChatAuthOpts & { personal?: boolean }} [opts]
+ * @returns {Promise<void>}
+ */
+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/get.d.ts

@@ -1,21 +1,3 @@
-/**
- * Unfortunately this doesnt get properly bundles in the final output so we have to write the types below directly
- * @typedef {import("@needle-tools/cloud-sdk/types").JobType} JobType
- * @typedef {import("@needle-tools/cloud-sdk/types").JobStatus} JobStatus
- */
-/**
- * @param {{ org?:string } & ({ name?: string, view_id?:string } | { page: number, limit: number })} opts
- * @returns {Promise<Array<import("../web.types.js").Upload>>}
- */
-export function getUploads(opts: {
-    org?: string;
-} & ({
-    name?: string;
-    view_id?: string;
-} | {
-    page: number;
-    limit: number;
-})): Promise<Array<import("../web.types.js").Upload>>;
 /**
  * @param {{ org?:string } & { offset?:number, limit?: number }} opts
  * @returns {Promise<Array<Deployment>>}
@@ -45,14 +27,6 @@ export function getUserLicenses(opts: {
 export function ownsProduct(opts: {
     product?: string | string[];
 }): Promise<boolean>;
-/**
- * Unfortunately this doesnt get properly bundles in the final output so we have to write the types below directly
- */
-export type JobType = import("@needle-tools/cloud-sdk/types").JobType;
-/**
- * Unfortunately this doesnt get properly bundles in the final output so we have to write the types below directly
- */
-export type JobStatus = import("@needle-tools/cloud-sdk/types").JobStatus;
 export type Deployment = {
     name: string;
     url: string;

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

@@ -1,3 +1,4 @@
 export * from "./upload.js";
 export * from "./get.js";
+export * from "./chat.js";
 export { startCheckoutSession } from "./checkout.js";

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

@@ -5,7 +5,7 @@
 /**
  * @param {Array<Filelike>} files
  * @param {{org?:string|null} & { name?:string, abort?:AbortSignal, }} opts
- * @returns {Promise<{error:string} | {job_id:string, view_id:string, url?:string | null, skipped?:boolean}>}
+ * @returns {Promise<{error:string} | {job_id:string, content_id:string, url?:string | null, skipped?:boolean}>}
  */
 export function uploadFiles(files: Array<Filelike>, opts: {
     org?: string | null;
@@ -16,7 +16,7 @@ export function uploadFiles(files: Array<Filelike>, opts: {
     error: string;
 } | {
     job_id: string;
-    view_id: string;
+    content_id: string;
     url?: string | null;
     skipped?: boolean;
 }>;

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.2",
+  "version": "1.10.3-dev.14eac62",
   "type": "module",
   "bin": {
     "needle-cloud": "./bin/cli.js"
@@ -31,14 +31,12 @@
   "devDependencies": {
     "@needle-tools/cloud-sdk": "1.0.0-alpha",
     "concurrently": "^9.0.1",
-    "microbundle": "^0.15.1",
-    "vitest": "^2.1.1"
+    "microbundle": "^0.15.1"
   },
   "engines": {
     "node": ">= 18"
   },
   "scripts": {
-    "test": "vitest",
     "install-local-deps": "cd ../needle-share-sdk && npm install",
     "deploy:main": "npm run deploy -- --tag main",
     "deploy": "npm run dist & npm publish --access public",
@@ -48,10 +46,10 @@
     "dev:web": "microbundle watch -i ./src/index.js -o dist/index.js --format esm --generateTypes --target web --no-compress",
     "dev:node": "microbundle watch -i ./src/cli.js -o dist/cli.js --format esm --target node --no-compress",
     "dist": "npx --yes rimraf dist && npm run dist:web && npm run dist:node",
-    "dist:web": "microbundle -i ./src/index.js -o dist/index.js --format esm --generateTypes --target web --sourcemap true --compress true --define api_endpoint=https://cloud.needle.tools/api,cloud_base_url=https://cloud.needle.tools",
-    "dist:web-preview": "microbundle -i ./src/index.js -o dist/index.js --format esm --generateTypes --target web --sourcemap true --compress true --define api_endpoint=https://cloud-staging.needle.tools/api,cloud_base_url=https://cloud-staging.needle.tools",
-    "dist:node": "microbundle -i ./src/cli.js -o dist/cli.js --format esm --generateTypes --target node --sourcemap false --compress --define api_endpoint=https://cloud.needle.tools/api,cloud_base_url=https://cloud.needle.tools",
-    "dist:node-preview": "microbundle -i ./src/cli.js -o dist/cli.js --format esm --generateTypes --target node --sourcemap false --compress --define api_endpoint=https://cloud-staging.needle.tools/api,cloud_base_url=https://cloud-staging.needle.tools",
+    "dist:web": "microbundle -i ./src/index.js -o dist/index.js --format esm --generateTypes --target web --sourcemap false --compress true --define api_endpoint=https://cloud.needle.tools/api,cloud_base_url=https://cloud.needle.tools,logto_endpoint=https://auth.needle.tools,logto_app_id=2stnsoa6a1b0gwc7lra55,logto_app_secret=seV1T6iKBKLlttjdk25I2px43ZCEHnPJ",
+    "dist:web-preview": "microbundle -i ./src/index.js -o dist/index.js --format esm --generateTypes --target web --sourcemap false --compress true --define api_endpoint=https://cloud-staging.needle.tools/api,cloud_base_url=https://cloud-staging.needle.tools,logto_endpoint=https://auth.needle.tools,logto_app_id=2stnsoa6a1b0gwc7lra55,logto_app_secret=seV1T6iKBKLlttjdk25I2px43ZCEHnPJ",
+    "dist:node": "microbundle -i ./src/cli.js -o dist/cli.js --format esm --target node --generateTypes false --sourcemap false --compress --define api_endpoint=https://cloud.needle.tools/api,cloud_base_url=https://cloud.needle.tools,logto_endpoint=https://auth.needle.tools,logto_app_id=2stnsoa6a1b0gwc7lra55,logto_app_secret=seV1T6iKBKLlttjdk25I2px43ZCEHnPJ",
+    "dist:node-preview": "microbundle -i ./src/cli.js -o dist/cli.js --format esm --target node --generateTypes false --sourcemap false --compress --define api_endpoint=https://cloud-staging.needle.tools/api,cloud_base_url=https://cloud-staging.needle.tools,logto_endpoint=https://auth.needle.tools,logto_app_id=2stnsoa6a1b0gwc7lra55,logto_app_secret=seV1T6iKBKLlttjdk25I2px43ZCEHnPJ",
     "dev:mcp": "npx --yes @modelcontextprotocol/inspector mcp-inspector http://localhost:8424/mcp"
   },
   "files": [
@@ -65,4 +63,4 @@
     "access": "public",
     "registry": "https://registry.npmjs.org/"
   }
-}
+}