needle-cloud 2.5.0 → 2.6.0

package/dist/cli.esm.js

@@ -1 +1 @@
-import"node-fetch";import"@web-std/file";import"node:crypto";export{p as program}from"./cli-b841fbf0.js";import"fs";import"dotenv";import"ora";import"commander";import"child_process";import"open";import"crypto";import"buffer";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"net";import"tls";import"assert";import"tty";import"os";import"events";import"http2";import"zlib";import"node:readline/promises";import"@logto/node";import"node:readline";import"node:stream";import"node:zlib";import"express";import"ws";import"minimatch";import"body-parser";import"node:child_process";
+import"node-fetch";import"@web-std/file";import"node:crypto";export{p as program}from"./cli-65a6a5f1.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:readline/promises";import"@logto/node";import"node:readline";import"node:stream";import"node:zlib";import"express";import"ws";import"minimatch";import"body-parser";import"node:child_process";

package/dist/cli.send-logs.discovery-0e806cf7.js

@@ -0,0 +1 @@
+import{existsSync as t,readdirSync as o,statSync as r}from"node:fs";import{dirname as i,join as e}from"node:path";import{g as n}from"./cli-65a6a5f1.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:readline/promises";import"dotenv";import"@logto/node";import"node:readline";import"node:stream";import"node:zlib";import"express";import"ws";import"minimatch";import"body-parser";import"node:child_process";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(!t(s.log_location))return null;const l=s.log_location,c=function(t,i){const n=new Set([i]);try{for(const i of o(t)){if(!i.toLowerCase().endsWith(".log"))continue;const o=e(t,i);try{if(!r(o).isFile())continue}catch{continue}n.add(o)}}catch{}return[...n]}(i(l),l);return{editor:s.editor,path:l,paths:c}}export{p as findActiveEditorLog};

package/dist/index.d.ts

@@ -159,10 +159,15 @@ type AiTokenUsageInfo = {
 
 type RecentChatsResponse$1 = {
     data: Array<{
+        chat_id: string,
         slug: string,
         topic: string,
         created_at: string,
         updated_at?: string,
+        /** Total saved messages in the session, including user and AI messages. */
+        message_count: number,
+        /** Person who started the shared session. */
+        started_by: { id: string; name: string | null } | null,
     }>
 }
 
@@ -228,7 +233,6 @@ type ChatMessage = {
     attachments?: ChatMessageAttachment[],
     metadata?: {
         tokens?: { input: number, output: number },
-        model?: string,
         /** True while the AI is still streaming a response. Absent or false when the message is complete. */
         is_partial?: boolean,
         /** True when the user stopped generation mid-stream. */
@@ -296,11 +300,27 @@ type AICompletionOptions = {
 /** Response of a one-shot completion (POST /v1/ai/completions). */
 type AICompletionResponse = {
     text: string,
-    /** The model that served the completion (server-resolved). */
-    model: string,
     token_usage: AiTokenUsageInfo,
 }
 
+/** JSON data supplied as context or instructions for an evaluation. */
+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. */
+type AIEvaluationQuestion$1 =
+    | { type: "boolean", instructions: AIEvaluationState$1, criteria?: { true?: string, false?: string } }
+    | { type: "choice", instructions: AIEvaluationState$1, criteria: Record<string, string | null> }
+    | { type: "score", instructions: AIEvaluationState$1, criteria: string[] };
+/** Up to 32 named questions, answered together against the same state. */
+type AIEvaluationQuestions$1 = Record<string, AIEvaluationQuestion$1>;
+type AIEvaluationAnswer$1 =
+    | { type: "boolean", probability: number }
+    | { type: "choice", choice: string, probabilities: Record<string, number>, confidence: number }
+    | { type: "score", score: number, probabilities: Record<string, number>, confidence: number };
+/** Answers use the question IDs from the request. Quota usage reflects discounted evaluation billing. */
+type AIEvaluationResponse$1 = { answers: Record<string, AIEvaluationAnswer$1>, token_usage: AiTokenUsageInfo };
+type AIEvaluationOptions$1 = { signal?: AbortSignal };
+
 /**
  * Discriminated union for events yielded by the SSE chat stream.
  *
@@ -586,13 +606,15 @@ type ChatSessionSendOptions$1 = {
 }
 
 /**
- * @typedef {{ name: string, mimetype: string, buffer:Buffer }} Filelike
+ * @typedef {{ name: string, mimetype: string, buffer:ArrayBuffer | Uint8Array }} Filelike
  * @typedef {import("../web.types.js").AuthData} AuthData
  */
 /**
  * @param {Array<Filelike>} files
  * @param {{org?:string|null} & { name?:string, abort?:AbortSignal, authToken?:string|null, type?:"upload"|"deployment",
  *   content_id?:string, thumbnail?:File,
+ *   verify?:import("@needle-tools/cloud-sdk/types").UploadFilesOptions["verify"],
+ *   progress?:(args:import("@needle-tools/cloud-sdk/types").ProgressEventArgs)=>void,
  *   metadata?:import("@needle-tools/cloud-sdk/types").JobMetadata }} opts
  *   `metadata` records where this upload came from — the change that produced it, what
  *   built it, and anything else you want to keep with it. It shows on the version in
@@ -627,6 +649,8 @@ declare function uploadFiles(files: Array<Filelike>, opts: {
     type?: "upload" | "deployment";
     content_id?: string;
     thumbnail?: File;
+    verify?: _needle_tools_cloud_sdk_types.UploadFilesOptions["verify"];
+    progress?: (args: _needle_tools_cloud_sdk_types.ProgressEventArgs) => void;
     metadata?: _needle_tools_cloud_sdk_types.JobMetadata;
 }): Promise<{
     error: string;
@@ -640,7 +664,7 @@ declare function uploadFiles(files: Array<Filelike>, opts: {
 type Filelike = {
     name: string;
     mimetype: string;
-    buffer: Buffer;
+    buffer: ArrayBuffer | Uint8Array;
 };
 type AuthData = AuthData$1;
 
@@ -817,6 +841,17 @@ declare function createChatSession(options?: ChatSessionOptions$1, authOpts?: Ch
  * @returns {Promise<import("@needle-tools/cloud-sdk/types/api.ai.js").AICompletionResponse>}
  */
 declare function aiComplete(message: string, options?: AICompletionOptions, authOpts?: ChatAuthOpts): Promise<AICompletionResponse>;
+/**
+ * Evaluate state against focused questions without creating a chat or executing actions.
+ * Evaluation usage counts toward the team's AI quota at a discounted rate.
+ * @experimental This API may change in future releases.
+ * @param {import('@needle-tools/cloud-sdk/types/api.ai.js').AIEvaluationState} state
+ * @param {import('@needle-tools/cloud-sdk/types/api.ai.js').AIEvaluationQuestions} questions
+ * @param {import('@needle-tools/cloud-sdk/types/api.ai.js').AIEvaluationOptions} [options]
+ * @param {ChatAuthOpts} [authOpts]
+ * @returns {Promise<import('@needle-tools/cloud-sdk/types/api.ai.js').AIEvaluationResponse>}
+ */
+declare function aiEvaluate(state: AIEvaluationState$1, questions: AIEvaluationQuestions$1, options?: AIEvaluationOptions$1, authOpts?: ChatAuthOpts): Promise<AIEvaluationResponse$1>;
 type ChatAuthOpts = {
     org?: string;
     authToken?: string;
@@ -826,6 +861,64 @@ type ChatSessionOptions = ChatSessionOptions$1;
 type ChatSessionHandle = ChatSessionHandle$1;
 type ChatSessionSendOptions = ChatSessionSendOptions$1;
 type ToolDefinition = ToolDefinition$1;
+type AIEvaluationState = AIEvaluationState$1;
+type AIEvaluationQuestion = AIEvaluationQuestion$1;
+type AIEvaluationQuestions = AIEvaluationQuestions$1;
+type AIEvaluationAnswer = AIEvaluationAnswer$1;
+type AIEvaluationResponse = AIEvaluationResponse$1;
+type AIEvaluationOptions = AIEvaluationOptions$1;
+
+declare type LogLevel = "none" | "info" | "debug";
+
+declare type ProgressEventArgs = {
+    /** Bytes uploaded */
+    uploadedBytes: number,
+    /** Total bytes to upload / total size of all files */
+    totalBytes: number,
+    /** Progress of total upload in normalized range */
+    progress01: number,
+    /** File that is currently being uploaded */
+    fileName: string,
+    /** The size of the file being uploaded in bytes */
+    fileSize: number,
+    /** The progress in normalized range for this file upload */
+    fileProgress01: number,
+    /** The index of the file being uploaded */
+    fileIndex: number,
+    /** The number of files being uploaded */
+    totalFiles: number,
+    /** Elapsed time since the upload started */
+    elapsedTime: number,
+    estimatedTimeLeft: number,
+    /** Estimate until finished */
+    estimatedTimeLeftDisplay: string,
+}
+
+declare type UploadFilesOptions = {
+    /** Upload to a specific view */
+    content_id?: string,
+    parent_job_id?: string,
+    /** The project name or a view id */
+    name?: string,
+    type?: Extract<JobType, "upload" | "conversion" | "deployment">,
+    /** Content type for the upload. If omitted, material-only glTF/GLB and
+     *  environment maps are detected automatically. For recognized assets,
+     *  an explicit type must match the file's contents. */
+    content_type?: Extract<ContentType, "material" | "3d-asset" | "hdri">,
+    /** Whether the upload should receive the standard post-upload processing
+     * jobs (asset optimization and related derived formats). Defaults to true.
+     * Pass false to store the files exactly as uploaded, with no jobs
+     * scheduled. */
+    optimizations?: boolean,
+    /** Verify stored file names and sizes before completion. Defaults to false.
+     * Storage listing failures are retried; exhaustion logs a warning and allows completion. */
+    verify?: boolean,
+    abort?: AbortSignal,
+    loglevel?: LogLevel,
+    onStart?: (id: string, content_id: string) => void,
+    /** The progress event is called for each file being uploaded and may be called multiple times for each file while the file is being uploaded */
+    progress?: (args: ProgressEventArgs) => void,
+}
 
 type TriggerType = "web" | "cli";
 
@@ -907,6 +1000,8 @@ declare type OptimizationParameters = {
 
 declare type UploadParameters = {
     total_files: number,
+    /** Opt in to best-effort storage verification at completion. */
+    verify?: UploadFilesOptions["verify"],
     /** Injected by createJob when a parent job is referenced */
     job_identifier?: string,
 }
@@ -1638,6 +1733,14 @@ type UpdateContentRequestBody = {
     };
 };
 
+/** Response from moving a content item to Trash.
+ * Deletion immediately frees total storage capacity but does not refund monthly usage.
+ */
+type DeleteContentResponse = {
+    identifier: string;
+    message: string;
+};
+
 /**
  * List publicly discoverable content items on Needle Cloud.
  *
@@ -1744,6 +1847,16 @@ declare function updateContent(identifier: string, data: {
 } & Omit<UpdateContentRequestBody, "upload_thumbnail" | "password" | "is_public">): Promise<{
     success: boolean;
 }>;
+/**
+ * Move a content item to the trash. It can be restored through Needle Cloud.
+ * @param {string} identifier
+ * @param {{ org?: string, authToken?: string }} [opts]
+ * @returns {Promise<import("@needle-tools/cloud-sdk/types/api.content").DeleteContentResponse>}
+ */
+declare function deleteContent(identifier: string, opts?: {
+    org?: string;
+    authToken?: string;
+}): Promise<DeleteContentResponse>;
 
 /**
  * Generate a 3D model from a text prompt and wait until it is ready.
@@ -2223,14 +2336,10 @@ declare function getProjectPromotions(project: string, opts?: {
 
 /**
  * Start the checkout process
- * @param {{ price_id:string }} args
+ * @param {import("@needle-tools/cloud-sdk/types").StartCheckoutSessionOptions} args
+ * @returns {Promise<import("@needle-tools/cloud-sdk/types").StartCheckoutSessionResult>}
  */
-declare function startCheckoutSession(args: {
-    price_id: string;
-}): Promise<{
-    ok: boolean;
-    status: number;
-}>;
+declare function startCheckoutSession(args: _needle_tools_cloud_sdk_types.StartCheckoutSessionOptions): Promise<_needle_tools_cloud_sdk_types.StartCheckoutSessionResult>;
 
 /**
  * Public price lookup. Deliberately kept in its own module, free of any auth
@@ -2287,7 +2396,7 @@ type GetProductInformationOptions = _needle_tools_cloud_sdk_types.GetProductInfo
  * @typedef {import("@needle-tools/cloud-sdk/types").CheckoutProductOptions} CheckoutProductOptions
  */
 /**
- * Start a checkout for a product and return the Stripe URL to send the buyer to.
+ * Start a checkout and return its Stripe URL and correlation identifier.
  *
  * Returns the url rather than navigating, so the caller decides: a web app can
  * assign `location.href`, an editor can open a tab and poll for the license on
@@ -2297,13 +2406,22 @@ type GetProductInformationOptions = _needle_tools_cloud_sdk_types.GetProductInfo
  * Authenticated: the server derives the buyer from the token, which is what makes
  * prefilling — and locking — the checkout email safe.
  *
+ * Track the returned checkoutId with your checkout-start event. Confirm purchases
+ * from a verified payment notification, not from opening or returning from the URL.
+ *
+ * @example
+ * const checkout = await checkoutProduct("Needle Inspector", {
+ *     tracking: { source: "export_gltf", attemptId: crypto.randomUUID() },
+ * });
+ * if (checkout) {
+ *     // Record checkout.checkoutId with your analytics, then open checkout.url.
+ * }
+ *
  * @param {string} product product name, e.g. "needle_inspector"
  * @param {CheckoutProductOptions} [options]
- * @returns {Promise<{ url: string } | null>}
+ * @returns {Promise<import("@needle-tools/cloud-sdk/types").CheckoutProductResult | null>}
  */
-declare function checkoutProduct(product: string, options?: CheckoutProductOptions): Promise<{
-    url: string;
-} | null>;
+declare function checkoutProduct(product: string, options?: CheckoutProductOptions): Promise<_needle_tools_cloud_sdk_types.CheckoutProductResult | null>;
 /**
  * Purchase flow BY PRODUCT NAME.
  *
@@ -2323,5 +2441,5 @@ declare namespace AuthScopes {
     let All: string[];
 }
 
-export { Auth, AuthScopes, NeedleLoginButton, aiComplete, archiveProject, checkProjectBlobs, checkoutProduct, cloneProject, completeProjectBlobUpload, createChatSession, createProject, deleteProject, generate3dAsset, getContent, getDeployments, getProductInformation, getProjectDeployments, getProjectHead, getProjectPromotions, getPublicContent, getUserLicenses, listChats, listContent, listProjectRevisions, listProjects, listPublicContent, ownsProduct, promoteProjectAsset, pullProjectRevision, pushProjectRevision, recordProjectDeployment, requestProjectBlobDownload, requestProjectBlobUpload, restoreProject, startCheckoutSession, unarchiveProject, updateContent, updateProject, updateProjectRevision, uploadFiles };
-export type { AuthData, AuthInitOpts, ChatAuthOpts, ChatSessionHandle, ChatSessionOptions, ChatSessionSendOptions, Deployment, Filelike, LogtoUserCustomData, RecentChatsResponse, ResourceUrl, ToolDefinition, UserInfoResponse };
+export { Auth, AuthScopes, NeedleLoginButton, aiComplete, aiEvaluate, archiveProject, checkProjectBlobs, checkoutProduct, cloneProject, completeProjectBlobUpload, createChatSession, createProject, deleteContent, deleteProject, generate3dAsset, getContent, getDeployments, getProductInformation, getProjectDeployments, getProjectHead, getProjectPromotions, getPublicContent, 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 };