needle-cloud 2.11.0 → 2.11.1

package/dist/cli.esm.js

@@ -1 +1 @@
-import"node-fetch";import"@web-std/file";import"node:crypto";export{p as program}from"./cli-05c1463b.js";import"fs";import"dotenv";import"ora";import"commander";import"child_process";import"open";import"path";import"node:fs";import"node:fs/promises";import"node:os";import"node:path";import"util";import"stream";import"http";import"https";import"url";import"crypto";import"net";import"tls";import"assert";import"tty";import"os";import"events";import"http2";import"zlib";import"node:console";import"node:readline/promises";import"@logto/node";import"node:readline";import"node:stream";import"node:zlib";import"express";import"ws";import"node:child_process";import"minimatch";import"node:url";import"node:util";import"body-parser";import"node:timers/promises";
+import"node-fetch";import"@web-std/file";import"node:crypto";export{p as program}from"./cli-bf2fbb2a.js";import"fs";import"dotenv";import"ora";import"commander";import"child_process";import"open";import"path";import"node:fs";import"node:fs/promises";import"node:os";import"node:path";import"util";import"stream";import"http";import"https";import"url";import"crypto";import"net";import"tls";import"assert";import"tty";import"os";import"events";import"http2";import"zlib";import"node:console";import"node:readline/promises";import"@logto/node";import"node:readline";import"node:stream";import"node:zlib";import"express";import"ws";import"node:child_process";import"minimatch";import"node:url";import"node:util";import"body-parser";import"node:timers/promises";

package/dist/{cli.send-logs.discovery-11259aaf.js → cli.send-logs.discovery-bc15f3e7.js}

@@ -1 +1 @@
-import{existsSync as o,readdirSync as t,statSync as r}from"node:fs";import{dirname as i,join as e}from"node:path";import{g as n}from"./cli-05c1463b.js";import"node-fetch";import"@web-std/file";import"node:crypto";import"commander";import"fs";import"child_process";import"open";import"path";import"ora";import"node:fs/promises";import"node:os";import"util";import"stream";import"http";import"https";import"url";import"crypto";import"net";import"tls";import"assert";import"tty";import"os";import"events";import"http2";import"zlib";import"node:console";import"node:readline/promises";import"dotenv";import"@logto/node";import"node:readline";import"node:stream";import"node:zlib";import"express";import"ws";import"node:child_process";import"minimatch";import"node:url";import"node:util";import"body-parser";import"node:timers/promises";function p(){var p;let m;try{m=n()}catch{return null}const s=null==(p=m)||null==(p=p.entries)?void 0:p[0];if(!s)return null;if(!s.log_location)return null;if("unity"!==s.editor&&"blender"!==s.editor)return null;if(!o(s.log_location))return null;const l=s.log_location,d=function(o,i){const n=new Set([i]);try{for(const i of t(o)){if(!i.toLowerCase().endsWith(".log"))continue;const t=e(o,i);try{if(!r(t).isFile())continue}catch{continue}n.add(t)}}catch{}return[...n]}(i(l),l);return{editor:s.editor,path:l,paths:d}}export{p as findActiveEditorLog};
+import{existsSync as o,readdirSync as t,statSync as r}from"node:fs";import{dirname as i,join as e}from"node:path";import{g as n}from"./cli-bf2fbb2a.js";import"node-fetch";import"@web-std/file";import"node:crypto";import"commander";import"fs";import"child_process";import"open";import"path";import"ora";import"node:fs/promises";import"node:os";import"util";import"stream";import"http";import"https";import"url";import"crypto";import"net";import"tls";import"assert";import"tty";import"os";import"events";import"http2";import"zlib";import"node:console";import"node:readline/promises";import"dotenv";import"@logto/node";import"node:readline";import"node:stream";import"node:zlib";import"express";import"ws";import"node:child_process";import"minimatch";import"node:url";import"node:util";import"body-parser";import"node:timers/promises";function p(){var p;let m;try{m=n()}catch{return null}const s=null==(p=m)||null==(p=p.entries)?void 0:p[0];if(!s)return null;if(!s.log_location)return null;if("unity"!==s.editor&&"blender"!==s.editor)return null;if(!o(s.log_location))return null;const l=s.log_location,d=function(o,i){const n=new Set([i]);try{for(const i of t(o)){if(!i.toLowerCase().endsWith(".log"))continue;const t=e(o,i);try{if(!r(t).isFile())continue}catch{continue}n.add(t)}}catch{}return[...n]}(i(l),l);return{editor:s.editor,path:l,paths:d}}export{p as findActiveEditorLog};

package/dist/index.d.ts

@@ -32,6 +32,8 @@ type LogtoUserCustomData$1 = {
 }
 
 declare namespace Auth {
+    /** @param {Pick<Console, "debug" | "info" | "warn" | "error">} output */
+    function setLogger(output: Pick<Console, "debug" | "info" | "warn" | "error">): void;
     /** @param {boolean} _debug */
     function setDebug(_debug: boolean): void;
     let baseUrl: any;
@@ -227,6 +229,15 @@ type License = NeedleEngineLicense | NeedleCloudLicense | OneTimePurchase;
 /** Current state of a subscription-backed license. */
 type LicenseSubscriptionStatus = "active" | "canceled" | "incomplete" | "incomplete_expired" | "past_due" | "paused" | "trialing" | "unpaid";
 
+/** Recovery options when the monthly AI allowance and available credits are exhausted. */
+interface AIQuotaErrorData {
+    code: 'ai_allowance_exhausted';
+    limit_reached: true;
+    message: string;
+    account_id: string;
+    actions: Array<{ kind: 'top_up' | 'view_usage'; label: string; url: string }>;
+}
+
 type AiTokenUsageInfo = {
     /** @deprecated Always 0. Use monthly_allowance_used01 for the shared AI allowance. */
     max_available: number,
@@ -246,6 +257,8 @@ type AiTokenUsageInfo = {
 type RecentChatsResponse$1 = {
     data: Array<{
         chat_id: string,
+        /** Cloud projects associated with this conversation, across project types. */
+        project_ids?: string[],
         slug: string,
         topic: string,
         created_at: string,
@@ -278,8 +291,58 @@ type ClientContext =
     | { type: "text", text: string }
     | ClientImage
 
+/**
+ * Reply to an `elicitation` stream event. Carries the `action_id` from that event
+ * plus the user's answer: `value` (a chosen option), `text` (free-text), or
+ * `canceled`. The server resumes the AI turn (for `ask`) or runs the authorized
+ * write action (for `confirm_action`) and streams the continuation.
+ */
+type AIChatRequestBody_ElicitationResponse = {
+    type: "elicitation_response",
+    slug: string,
+    action_id: string,
+    /** The chosen option value (must be one the server offered). */
+    value?: string,
+    /** Free-text answer, when the elicitation offered a text field. */
+    text?: string,
+    /** The user dismissed the request without choosing. */
+    canceled?: boolean,
+    /** Current browser session when answering a local file-edit permission request. */
+    file_edit_session_id?: string,
+    /** Current browser session when approving a local project command. */
+    local_command_session_id?: string,
+    /** Explicit Cloud opt-in to retain local file-edit tools after an answer. */
+    allow_file_edits?: boolean,
+    /** Explicit Cloud opt-in to retain local project commands after an answer. */
+    allow_local_commands?: boolean,
+    /** Current Cloud page URL for the continuation. */
+    full_url?: string,
+    stream?: boolean,
+}
+
+
+/** Rendering features explicitly supported by this chat consumer. */
+type ChatClientCapabilities$1 = { inlineToolCalls?: boolean };
+/** Update ordered inline parts before applying the event to the message's plain content. */
+declare function updateInlineChatParts(
+    current: ChatInlinePart$1[] | undefined,
+    content: string,
+    event: ChatStreamEvent,
+): ChatInlinePart$1[] | undefined;
+
+/** Vercel UIMessage-compatible subset for inline text and dynamic tools. */
+type ChatInlinePart$1 =
+    | { type: 'text', text: string, state?: 'streaming' | 'done' }
+    | ({ type: 'dynamic-tool', toolCallId: string, toolName: string, title?: string, input: unknown } & (
+        | { state: 'input-available' }
+        | { state: 'output-available', output: { result_length?: number, duration_ms?: number } }
+    ));
 
 type ChatMessageToolCall = {
+    /** Stable invocation identity, when available. */
+    toolCallId?: string,
+    /** Position in the assistant text, measured in UTF-16 code units. */
+    contentOffset?: number,
     name: string,
     /** Server-provided pretty label for the tool, when the tool author set one
      *  (streamed on the tool_call event). The UI prefers this over title-casing
@@ -315,6 +378,8 @@ type ChatMessage = {
     role: "assistant" | "tool" | "user",
     content: string,
     tool_calls?: ChatMessageToolCall[],
+    /** Ordered inline content when requested and available. */
+    parts?: ChatInlinePart$1[],
     /** Images belonging to this message. Absent on the vast majority of messages. */
     attachments?: ChatMessageAttachment[],
     metadata?: {
@@ -339,6 +404,8 @@ type ChatMessage = {
     } | null,
 }
 type AIChatGETResponse = {
+    /** Cloud projects associated with this conversation, across project types. */
+    project_ids?: string[],
     /** Null when no chat exists yet for the requested slug. */
     chat_id: string | null,
     messages: Array<ChatMessage>,
@@ -370,6 +437,8 @@ type AIChatSyncResponse = {
     role: "assistant",
     content: string,
     tool_calls?: ChatMessageToolCall[],
+    /** Ordered inline content when requested and available. */
+    parts?: ChatInlinePart$1[],
     metadata?: ChatMessage["metadata"],
     token_usage?: AiTokenUsageInfo | null,
     /** Full URL to view this chat on the Needle Cloud frontend. */
@@ -390,8 +459,7 @@ type AICompletionResponse = {
     text: string,
     token_usage: AiTokenUsageInfo,
 }
-
-/** JSON data supplied as context or instructions for an evaluation. */
+/** JSON context or instructions. Embed image_url parts with base64 PNG/JPEG data URLs. Remote image URLs are not supported. */
 type AIEvaluationValue = string | number | boolean | null | AIEvaluationValue[] | { [key: string]: AIEvaluationValue };
 type AIEvaluationState$1 = string | AIEvaluationValue[] | { [key: string]: AIEvaluationValue };
 /** A focused question to evaluate against the supplied state. */
@@ -409,6 +477,18 @@ type AIEvaluationAnswer$1 =
 type AIEvaluationResponse$1 = { answers: Record<string, AIEvaluationAnswer$1>, token_usage: AiTokenUsageInfo };
 type AIEvaluationOptions$1 = { signal?: AbortSignal };
 
+/** Metadata for one main chat provider request; byte counts are not token counts. */
+interface ChatRequestDiagnostics$1 {
+    requestIndex: number;
+    model: string;
+    requestBytes: number;
+    messagesBytes: number;
+    toolsBytes: number;
+    messageCount: number;
+    messageRoles: Record<string, number>;
+    toolCount: number;
+}
+
 /**
  * Discriminated union for events yielded by the SSE chat stream.
  *
@@ -430,6 +510,9 @@ type AIEvaluationOptions$1 = { signal?: AbortSignal };
 type ChatStreamEvent = { /** SSE event id for position tracking. */ id?: number } & (
     /** Streaming text chunk — append to the current AI message. */
     | { type: "delta", content: string }
+    | { type: 'tool-input-available', toolCallId: string, toolName: string, title?: string, input: unknown }
+    | { type: 'tool-output-available', toolCallId: string, output: { result_length?: number, duration_ms?: number } }
+    | { type: "request_diagnostics", diagnostics: ChatRequestDiagnostics$1 }
     /** Complete message text (sent once at the end, contains the full response). */
     | { type: "message", content: string }
     /** Server-assigned message ID for the AI response. */
@@ -445,7 +528,7 @@ type ChatStreamEvent = { /** SSE event id for position tracking. */ id?: number
     /** User messages joined this generation between tool rounds. Start a new assistant message after them. */
     | { type: "message_inserted", messages: Array<{ id: string, content: string }>, assistant_message_id: string }
     /** An error occurred. Display `message` to the user. */
-    | { type: "error", message: string }
+    | { type: "error", message: string, details?: AIQuotaErrorData }
     /**
      * A non-fatal problem the USER should see, rendered as its own line rather
      * than folded into the answer. First case: a step whose model cannot view
@@ -581,6 +664,7 @@ type WebSocketLike = {
  * before allowing messages. If no tools are provided, it's HTTP-only.
  */
 type ChatSessionOptions$1 = {
+    capabilities?: ChatClientCapabilities$1,
     /** Source identifier (e.g. "editor", "cli", "my-app"). Defaults to "sdk". */
     source?: string,
     /** Tools to register via WebSocket. If empty/omitted, no WS connection is made. */
@@ -641,6 +725,8 @@ type ChatSessionHandle$1 = {
      * Internally awaits `ready` before sending.
      */
     sendMessage(slug: string, message: string, options?: ChatSessionSendOptions$1): AsyncGenerator<ChatStreamEvent>,
+    /** Answer or dismiss a pending question and stream the continuation. Awaits ready before sending. */
+    sendElicitationResponse(slug: string, response: Pick<AIChatRequestBody_ElicitationResponse, 'action_id' | 'value' | 'text' | 'canceled'>, options?: ChatSessionSendOptions$1): AsyncGenerator<ChatStreamEvent>,
     /**
      * Send a message and get a single JSON response (non-streaming).
      * Internally awaits `ready` before sending.
@@ -662,8 +748,10 @@ type ChatSessionHandle$1 = {
      * arrived) and reading the finished answer via `readChat`.
      */
     reconnectChat(slug: string): Promise<AsyncGenerator<ChatStreamEvent> | null>,
+    /** Add a project association without sending a message; existing links are retained. */
+    associateProject(slug: string, projectId: string): Promise<void>,
     /** List recent chats. */
-    listChats(): Promise<RecentChatsResponse$1>,
+    listChats(options?: { projectId?: string }): Promise<RecentChatsResponse$1>,
     /**
      * Start a new chat: returns a fresh, unique slug. Pass it to `sendMessage` /
      * `sendMessageSync` to begin the conversation (the chat is created on the first message).
@@ -697,6 +785,8 @@ type ChatSessionHandle$1 = {
 
 /** Options for `ChatSessionHandle.sendMessage()` and `sendMessageSync()`. */
 type ChatSessionSendOptions$1 = {
+    /** Optional Cloud project to add to this conversation's associations, independent of project type. */
+    projectId?: string,
     /** Allow this chat to request local file edit approval. Defaults to false; this is not permission to write. */
     allowFileEdits?: boolean,
     /** Current local chat session ID used for a separate user approval. */
@@ -715,6 +805,13 @@ type ChatSessionSendOptions$1 = {
     context?: ClientContext[],
 }
 
+/** HTTP chat failure with optional quota recovery actions. */
+declare class AIChatError extends Error {
+    constructor(message: string, status: number, details?: AIQuotaErrorData | null);
+    status: number;
+    details: AIQuotaErrorData | null;
+}
+
 /**
  * @internal Needle editor cloud projects — versioned revisions of OPAQUE
  * project documents (needle-cloud plans/cloud-projects-api.md). Editor-only,
@@ -2055,10 +2152,12 @@ type Deployment = {
 
 /**
  * List recent AI chats for the authenticated user.
- * @param {ChatAuthOpts} [opts]
+ * @param {ChatAuthOpts & { projectId?: string }} [opts]
  * @returns {Promise<RecentChatsResponse>}
  */
-declare function listChats(opts?: ChatAuthOpts): Promise<RecentChatsResponse>;
+declare function listChats(opts?: ChatAuthOpts & {
+    projectId?: string;
+}): Promise<RecentChatsResponse>;
 /**
  * Create a coordinated chat session with optional WebSocket tool support.
  *
@@ -2131,6 +2230,7 @@ type ChatAuthOpts = {
 type RecentChatsResponse = RecentChatsResponse$1;
 type ChatSessionOptions = ChatSessionOptions$1;
 type ChatSessionHandle = ChatSessionHandle$1;
+type ChatRequestDiagnostics = ChatRequestDiagnostics$1;
 type ChatSessionSendOptions = ChatSessionSendOptions$1;
 type ToolDefinition = ToolDefinition$1;
 type AIEvaluationState = AIEvaluationState$1;
@@ -2139,6 +2239,8 @@ type AIEvaluationQuestions = AIEvaluationQuestions$1;
 type AIEvaluationAnswer = AIEvaluationAnswer$1;
 type AIEvaluationResponse = AIEvaluationResponse$1;
 type AIEvaluationOptions = AIEvaluationOptions$1;
+type ChatInlinePart = ChatInlinePart$1;
+type ChatClientCapabilities = ChatClientCapabilities$1;
 
 /**
  * List publicly discoverable content items on Needle Cloud.
@@ -2705,5 +2807,5 @@ declare namespace AuthScopes {
     let All: string[];
 }
 
-export { Auth, AuthScopes, NeedleLoginButton, aiComplete, aiEvaluate, archiveProject, checkProjectBlobs, checkoutProduct, cloneProject, completeProjectBlobUpload, createChatSession, createProject, deleteContent, deleteProject, generate3dAsset, getContent, getDeployments, getProductInformation, getProjectDeployments, getProjectHead, getProjectPromotions, getPublicContent, getRuntimeRelease, getRuntimeSnapshot, getUserLicenses, listChats, listContent, listProjectRevisions, listProjects, listPublicContent, ownsProduct, promoteProjectAsset, pullProjectRevision, pushProjectRevision, recordProjectDeployment, requestProjectBlobDownload, requestProjectBlobUpload, restoreProject, startCheckoutSession, unarchiveProject, updateContent, updateProject, updateProjectRevision, uploadFiles };
-export type { AIEvaluationAnswer, AIEvaluationOptions, AIEvaluationQuestion, AIEvaluationQuestions, AIEvaluationResponse, AIEvaluationState, AuthData, AuthInitOpts, ChatAuthOpts, ChatSessionHandle, ChatSessionOptions, ChatSessionSendOptions, Deployment, Filelike, LogtoUserCustomData, RecentChatsResponse, ResourceUrl, ToolDefinition, UserInfoResponse };
+export { AIChatError, Auth, AuthScopes, NeedleLoginButton, aiComplete, aiEvaluate, archiveProject, checkProjectBlobs, checkoutProduct, cloneProject, completeProjectBlobUpload, createChatSession, createProject, deleteContent, deleteProject, generate3dAsset, getContent, getDeployments, getProductInformation, getProjectDeployments, getProjectHead, getProjectPromotions, getPublicContent, getRuntimeRelease, getRuntimeSnapshot, getUserLicenses, listChats, listContent, listProjectRevisions, listProjects, listPublicContent, ownsProduct, promoteProjectAsset, pullProjectRevision, pushProjectRevision, recordProjectDeployment, requestProjectBlobDownload, requestProjectBlobUpload, restoreProject, startCheckoutSession, unarchiveProject, updateContent, updateInlineChatParts, updateProject, updateProjectRevision, uploadFiles };
+export type { AIEvaluationAnswer, AIEvaluationOptions, AIEvaluationQuestion, AIEvaluationQuestions, AIEvaluationResponse, AIEvaluationState, AuthData, AuthInitOpts, ChatAuthOpts, ChatClientCapabilities, ChatInlinePart, ChatRequestDiagnostics, ChatSessionHandle, ChatSessionOptions, ChatSessionSendOptions, Deployment, Filelike, LogtoUserCustomData, RecentChatsResponse, ResourceUrl, ToolDefinition, UserInfoResponse };