needle-cloud 3.2.1 → 3.3.0

package/dist/cli.esm.js

@@ -1 +1 @@
-import"node-fetch";import"@web-std/file";import"node:crypto";export{p as program}from"./cli-b8d9cfb5.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"node:util";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:timers/promises";import"body-parser";
+import"node-fetch";import"@web-std/file";import"node:crypto";export{p as program}from"./cli-51eba1aa.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"node:util";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:timers/promises";import"body-parser";

package/dist/{cli.send-logs.discovery-65942f5e.js → cli.send-logs.discovery-29fa4e4a.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-b8d9cfb5.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"node:util";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:timers/promises";import"body-parser";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-51eba1aa.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"node:util";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:timers/promises";import"body-parser";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

@@ -141,6 +141,54 @@ declare type AuthData$1 = {
     roles_org?: Array<string>;
 }
 
+/** A bounded part of a diagnostic record, retried with the same ID and content. */
+type ProjectDiagnosticPart$1 = {
+    id: string;
+    session: string;
+    revision: number | null;
+    part: number;
+    parts: number;
+    totalBytes: number;
+    text: string;
+    firstTime: number;
+    lastTime: number;
+    build: string;
+};
+
+type ProjectDiagnosticPolicy$1 = {
+    enabled: boolean;
+    canOptOut: boolean;
+    limits: {
+        projectBytes: number;
+        teamBytes: number;
+        batchBytes: number;
+        recordBytes: number;
+        reportsPerDay: number;
+        rollingDays: number;
+        reportDays: number;
+    };
+};
+
+type ProjectBugReportRequest$1 = {
+    id: string;
+    description: string;
+    session: string;
+    revision: number | null;
+    build: string;
+    records: string[];
+    /** Capture cutoff in Unix milliseconds. Evidence attaches asynchronously when supplied. */
+    capturedAt?: number;
+    /** Optional local evidence attached only to this explicit report. */
+    evidence?: { text: string; incomplete: boolean };
+};
+
+type ProjectBugReportReceipt$1 = {
+    id: string;
+    status: 'collecting' | 'complete' | 'incomplete';
+    missingRecords: string[];
+    expiresAt: string;
+};
+
 type NeedleLicense = "basic" | "indie" | "pro" | "enterprise" | "edu"
 
 type BaseLicense = {
@@ -639,6 +687,10 @@ type ElicitationField = {
 
 /** Tool definition for registering tools via WebSocket. */
 type ToolDefinition$1 = {
+    /** Optional result schema returned by discovery. */
+    outputSchema?: Record<string, unknown>,
+    /** Guidance and invocation route used by tool discovery. */
+    discovery?: ToolDiscoveryMetadata$1,
     /** Applicability requirements (all-of), checked only when policy capabilities are supplied. */
     requires?: string[],
     /** Discovery hints; never permissions. */
@@ -664,6 +716,8 @@ type ToolDefinition$1 = {
  * than one conversation needs this to attach the result to the right one.
  */
 type ToolRequestMeta = {
+    /** SDK methods permitted for this execution; an empty array permits none. */
+    allowedSdkMethods?: string[],
     /** The chat this request belongs to; `null` if the server did not identify one. */
     chatId: string | null,
     /** Id of this request, matching the result sent back for it. */
@@ -723,6 +777,8 @@ type ChatSessionOptions$1 = {
     source?: string,
     /** Tools to register via WebSocket. If empty/omitted, no WS connection is made. */
     tools?: ToolDefinition$1[],
+    /** Full catalog used only when the server declares discovery support; tools remains the legacy fallback. */
+    toolCatalog?: ToolDefinition$1[],
     /**
      * Called when the server requests tool execution.
      * Return `{ result: ... }` on success or `{ error: "..." }` on failure.
@@ -816,7 +872,7 @@ type ChatSessionHandle$1 = {
      */
     newChat(): string,
     /** Update the tools registered with the server. No-op if no WS connection. */
-    updateTools(tools: ToolDefinition$1[]): void,
+    updateTools(tools: ToolDefinition$1[], catalog?: ToolDefinition$1[]): void,
     /** Most recent token usage info, auto-updated from `done` events. Null until first message completes. */
     readonly usage: AiTokenUsageInfo | null,
     /** Full URL to view the most recent chat on the Needle Cloud frontend. Auto-updated from `done` events and `readChat`. Null until first response. */
@@ -870,6 +926,33 @@ declare class AIChatError extends Error {
     details: AIQuotaErrorData | null;
 }
 
+/** How to invoke a discovered tool. Discovery does not grant access. */
+type ToolInvocation$1 = { kind: 'direct' } | { kind: 'sdk'; executor: string; method: string };
+/** Search metadata supplied alongside a tool's existing definition. */
+type ToolDiscoveryMetadata$1 = {
+    tags?: string[];
+    guidance?: string[];
+    invocation?: ToolInvocation$1;
+};
+type DiscoverableTool$1 = ToolDiscoveryMetadata$1 & {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    outputSchema?: Record<string, unknown>;
+};
+type ToolDiscoveryQuery$1 = { query?: string; limit?: number; offset?: number };
+type ToolDiscoveryResult$1 = {
+    /** Shared instructions for the returned page, emitted once rather than per tool. */
+    guidance?: string[];
+    tools: DiscoverableTool$1[];
+    index?: Array<{ name: string; description: string }>;
+    totalMatched: number;
+    totalAvailable: number;
+    offset: number;
+    hasMore: boolean;
+};
+declare function discoverTools(catalog: readonly DiscoverableTool$1[], options?: ToolDiscoveryQuery$1): ToolDiscoveryResult$1;
+
 type AssetVector3 = [number, number, number];
 type AssetGeometryMetadata = {
     meshes: number;
@@ -2466,6 +2549,11 @@ type ChatToolPreferences = ChatToolPreferences$1;
 type ChatToolPreferenceUpdate = ChatToolPreferenceUpdate$1;
 type ChatToolListItem = ChatToolListItem$1;
 type ChatToolUnavailableReason = ChatToolUnavailableReason$1;
+type ToolInvocation = ToolInvocation$1;
+type ToolDiscoveryMetadata = ToolDiscoveryMetadata$1;
+type DiscoverableTool = DiscoverableTool$1;
+type ToolDiscoveryQuery = ToolDiscoveryQuery$1;
+type ToolDiscoveryResult = ToolDiscoveryResult$1;
 
 /**
  * List publicly discoverable content items on Needle Cloud.
@@ -2928,6 +3016,29 @@ declare function getProjectPromotions(project: string, opts?: {
     }>;
 }>;
 
+/** @param {string} project @param {Options} [opts] @returns {Promise<import('@needle-tools/cloud-sdk/types/api.project-diagnostics.js').ProjectDiagnosticPolicy>} */
+declare function getProjectDiagnosticPolicy(project: string, opts?: Options): Promise<ProjectDiagnosticPolicy$1>;
+/** @param {string} project @param {boolean} enabled @param {Options} [opts] @returns {Promise<import('@needle-tools/cloud-sdk/types/api.project-diagnostics.js').ProjectDiagnosticPolicy>} */
+declare function setProjectDiagnosticPolicy(project: string, enabled: boolean, opts?: Options): Promise<ProjectDiagnosticPolicy$1>;
+/** @param {string} project @param {import('@needle-tools/cloud-sdk/types/api.project-diagnostics.js').ProjectDiagnosticPart} part @param {Options} [opts]
+ * @returns {Promise<{id: string, part: number, complete: boolean}>} */
+declare function uploadProjectDiagnosticPart(project: string, part: ProjectDiagnosticPart$1, opts?: Options): Promise<{
+    id: string;
+    part: number;
+    complete: boolean;
+}>;
+/** @param {string} project @param {import('@needle-tools/cloud-sdk/types/api.project-diagnostics.js').ProjectBugReportRequest} report @param {Options} [opts]
+ * @returns {Promise<import('@needle-tools/cloud-sdk/types/api.project-diagnostics.js').ProjectBugReportReceipt>} */
+declare function submitProjectBugReport(project: string, report: ProjectBugReportRequest$1, opts?: Options): Promise<ProjectBugReportReceipt$1>;
+type ProjectDiagnosticPart = ProjectDiagnosticPart$1;
+type ProjectDiagnosticPolicy = ProjectDiagnosticPolicy$1;
+type ProjectBugReportRequest = ProjectBugReportRequest$1;
+type ProjectBugReportReceipt = ProjectBugReportReceipt$1;
+type Options = {
+    org?: string;
+    authToken?: string;
+};
+
 /** Read a published runtime snapshot by its exact identifier. @param {string} hash */
 declare function getRuntimeSnapshot(hash: string): Promise<RuntimeSnapshotInfo>;
 /** Look up an exact published release. @param {string} runtime @param {string} version */
@@ -3040,5 +3151,5 @@ declare namespace AuthScopes {
     let All: string[];
 }
 
-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, ChatToolListItem, ChatToolPolicy, ChatToolPreferenceUpdate, ChatToolPreferences, ChatToolUnavailableReason, ChatToolsResponse, Deployment, Filelike, LogtoUserCustomData, RecentChatsResponse, ResourceUrl, ToolDefinition, UserInfoResponse };
+export { AIChatError, Auth, AuthScopes, NeedleLoginButton, aiComplete, aiEvaluate, archiveProject, checkProjectBlobs, checkoutProduct, cloneProject, completeProjectBlobUpload, createChatSession, createProject, deleteContent, deleteProject, discoverTools, generate3dAsset, getContent, getDeployments, getProductInformation, getProjectDeployments, getProjectDiagnosticPolicy, getProjectHead, getProjectPromotions, getPublicContent, getRuntimeRelease, getRuntimeSnapshot, getUserLicenses, listChats, listContent, listProjectRevisions, listProjects, listPublicContent, ownsProduct, promoteProjectAsset, pullProjectRevision, pushProjectRevision, recordProjectDeployment, requestProjectBlobDownload, requestProjectBlobUpload, restoreProject, setProjectDiagnosticPolicy, startCheckoutSession, submitProjectBugReport, unarchiveProject, updateContent, updateInlineChatParts, updateProject, updateProjectRevision, uploadFiles, uploadProjectDiagnosticPart };
+export type { AIEvaluationAnswer, AIEvaluationOptions, AIEvaluationQuestion, AIEvaluationQuestions, AIEvaluationResponse, AIEvaluationState, AuthData, AuthInitOpts, ChatAuthOpts, ChatClientCapabilities, ChatInlinePart, ChatRequestDiagnostics, ChatSessionHandle, ChatSessionOptions, ChatSessionSendOptions, ChatToolListItem, ChatToolPolicy, ChatToolPreferenceUpdate, ChatToolPreferences, ChatToolUnavailableReason, ChatToolsResponse, Deployment, DiscoverableTool, Filelike, LogtoUserCustomData, Options, ProjectBugReportReceipt, ProjectBugReportRequest, ProjectDiagnosticPart, ProjectDiagnosticPolicy, RecentChatsResponse, ResourceUrl, ToolDefinition, ToolDiscoveryMetadata, ToolDiscoveryQuery, ToolDiscoveryResult, ToolInvocation, UserInfoResponse };