ncrypted 0.3.0 → 0.3.1

package/dist/ai-sdk.d.ts

@@ -974,17 +974,20 @@ export declare function ncryptedTools(options?: NcryptedToolsOptions): Partial<{
             };
             output: NoInfer<string | {
                 burned: boolean;
+                status: import("./client.js").SecretStatus;
             }>;
         }) => import("@ai-sdk/provider-utils").ToolResultOutput | PromiseLike<import("@ai-sdk/provider-utils").ToolResultOutput>) | undefined;
     } & {
         outputSchema?: import("ai").FlexibleSchema<string | {
             burned: boolean;
+            status: import("./client.js").SecretStatus;
         }> | undefined;
         execute: import("ai").ToolExecuteFunction<{
             id: string;
             receiptToken: string;
         }, string | {
             burned: boolean;
+            status: import("./client.js").SecretStatus;
         }, NoInfer<import("@ai-sdk/provider-utils").Context>>;
     } & {
         description?: string | ((options: {
@@ -1010,6 +1013,7 @@ export declare function ncryptedTools(options?: NcryptedToolsOptions): Partial<{
             receiptToken: string;
         }, string | {
             burned: boolean;
+            status: import("./client.js").SecretStatus;
         }, NoInfer<import("@ai-sdk/provider-utils").Context>>;
     }) | ({
         deferLoading?: boolean;
@@ -1043,17 +1047,20 @@ export declare function ncryptedTools(options?: NcryptedToolsOptions): Partial<{
             };
             output: NoInfer<string | {
                 burned: boolean;
+                status: import("./client.js").SecretStatus;
             }>;
         }) => import("@ai-sdk/provider-utils").ToolResultOutput | PromiseLike<import("@ai-sdk/provider-utils").ToolResultOutput>) | undefined;
     } & {
         outputSchema?: import("ai").FlexibleSchema<string | {
             burned: boolean;
+            status: import("./client.js").SecretStatus;
         }> | undefined;
         execute: import("ai").ToolExecuteFunction<{
             id: string;
             receiptToken: string;
         }, string | {
             burned: boolean;
+            status: import("./client.js").SecretStatus;
         }, NoInfer<import("@ai-sdk/provider-utils").Context>>;
     } & {
         description?: string | ((options: {
@@ -1079,6 +1086,7 @@ export declare function ncryptedTools(options?: NcryptedToolsOptions): Partial<{
             receiptToken: string;
         }, string | {
             burned: boolean;
+            status: import("./client.js").SecretStatus;
         }, NoInfer<import("@ai-sdk/provider-utils").Context>>;
     }) | ({
         deferLoading?: boolean;
@@ -1112,17 +1120,20 @@ export declare function ncryptedTools(options?: NcryptedToolsOptions): Partial<{
             };
             output: NoInfer<string | {
                 burned: boolean;
+                status: import("./client.js").SecretStatus;
             }>;
         }) => import("@ai-sdk/provider-utils").ToolResultOutput | PromiseLike<import("@ai-sdk/provider-utils").ToolResultOutput>) | undefined;
     } & {
         outputSchema?: import("ai").FlexibleSchema<string | {
             burned: boolean;
+            status: import("./client.js").SecretStatus;
         }> | undefined;
         execute: import("ai").ToolExecuteFunction<{
             id: string;
             receiptToken: string;
         }, string | {
             burned: boolean;
+            status: import("./client.js").SecretStatus;
         }, NoInfer<import("@ai-sdk/provider-utils").Context>>;
     } & {
         type: "provider";
@@ -1140,6 +1151,7 @@ export declare function ncryptedTools(options?: NcryptedToolsOptions): Partial<{
             receiptToken: string;
         }, string | {
             burned: boolean;
+            status: import("./client.js").SecretStatus;
         }, NoInfer<import("@ai-sdk/provider-utils").Context>>;
     }) | ({
         deferLoading?: boolean;
@@ -1173,17 +1185,20 @@ export declare function ncryptedTools(options?: NcryptedToolsOptions): Partial<{
             };
             output: NoInfer<string | {
                 burned: boolean;
+                status: import("./client.js").SecretStatus;
             }>;
         }) => import("@ai-sdk/provider-utils").ToolResultOutput | PromiseLike<import("@ai-sdk/provider-utils").ToolResultOutput>) | undefined;
     } & {
         outputSchema?: import("ai").FlexibleSchema<string | {
             burned: boolean;
+            status: import("./client.js").SecretStatus;
         }> | undefined;
         execute: import("ai").ToolExecuteFunction<{
             id: string;
             receiptToken: string;
         }, string | {
             burned: boolean;
+            status: import("./client.js").SecretStatus;
         }, NoInfer<import("@ai-sdk/provider-utils").Context>>;
     } & {
         type: "provider";
@@ -1201,6 +1216,7 @@ export declare function ncryptedTools(options?: NcryptedToolsOptions): Partial<{
             receiptToken: string;
         }, string | {
             burned: boolean;
+            status: import("./client.js").SecretStatus;
         }, NoInfer<import("@ai-sdk/provider-utils").Context>>;
     });
     ncrypted_to_vercel_env: ({

package/dist/ai-sdk.js

@@ -61,7 +61,10 @@ export function ncryptedTools(options = {}) {
         }),
         ncrypted_status: tool({
             description: "Check whether a secret you created has been opened (pending, read, burned or expired). Free.",
-            inputSchema: z.object({ id: z.string(), receiptToken: z.string() }),
+            inputSchema: z.object({
+                id: z.string().describe("The secret's id, returned by ncrypted_create."),
+                receiptToken: z.string().describe("The creator's receipt token, returned by ncrypted_create."),
+            }),
             execute: async ({ id, receiptToken }) => {
                 try {
                     return await nc.status(id, receiptToken);
@@ -73,11 +76,13 @@ export function ncryptedTools(options = {}) {
         }),
         ncrypted_burn: tool({
             description: "Destroy a secret you created before anyone opens it, e.g. if the link went to the wrong place. Free.",
-            inputSchema: z.object({ id: z.string(), receiptToken: z.string() }),
+            inputSchema: z.object({
+                id: z.string().describe("The secret's id, returned by ncrypted_create."),
+                receiptToken: z.string().describe("The creator's receipt token, returned by ncrypted_create."),
+            }),
             execute: async ({ id, receiptToken }) => {
                 try {
-                    await nc.burn(id, receiptToken);
-                    return { burned: true };
+                    return await nc.burn(id, receiptToken);
                 }
                 catch (e) {
                     return errorText(e);

package/dist/client.d.ts

@@ -2,7 +2,7 @@ import { type Destination, type DeliveryResult } from "./destinations.js";
 export declare const DEFAULT_BASE_URL = "https://ncrypted.ai";
 /** Hard cap on what the SDK will ever pay for one secret, whatever the server asks. */
 export declare const MAX_PRICE = "$0.01";
-export declare const SDK_VERSION = "0.3.0";
+export declare const SDK_VERSION = "0.3.1";
 export interface NcryptedOptions {
     /** API origin. Defaults to NCRYPTED_URL or the hosted service. */
     baseUrl?: string;
@@ -138,6 +138,12 @@ export declare class Ncrypted {
         readAt?: string;
         expiresAt?: string;
     }>;
-    /** Destroys an unread secret early. Needs the creator's receipt token. */
-    burn(id: string, receiptToken: string): Promise<void>;
+    /**
+     * Destroys an unread secret early. Needs the creator's receipt token. Resolves { burned: false } with the current
+     * status when there was nothing left to destroy (already read, burned or expired).
+     */
+    burn(id: string, receiptToken: string): Promise<{
+        burned: boolean;
+        status: SecretStatus;
+    }>;
 }

package/dist/client.js

@@ -9,7 +9,7 @@ import { privateKeyToAccount as accountOf } from "viem/accounts";
 export const DEFAULT_BASE_URL = "https://ncrypted.ai";
 /** Hard cap on what the SDK will ever pay for one secret, whatever the server asks. */
 export const MAX_PRICE = "$0.01";
-export const SDK_VERSION = "0.3.0";
+export const SDK_VERSION = "0.3.1";
 export class NcryptedError extends Error {
     status;
     constructor(message, status) {
@@ -291,7 +291,10 @@ export class Ncrypted {
             throw await errorFrom(res);
         return (await res.json());
     }
-    /** Destroys an unread secret early. Needs the creator's receipt token. */
+    /**
+     * Destroys an unread secret early. Needs the creator's receipt token. Resolves { burned: false } with the current
+     * status when there was nothing left to destroy (already read, burned or expired).
+     */
     async burn(id, receiptToken) {
         const res = await fetch(`${this.baseUrl}/api/v1/secrets/${id}`, {
             method: "DELETE",
@@ -299,5 +302,7 @@ export class Ncrypted {
         });
         if (!res.ok)
             throw await errorFrom(res);
+        const body = (await res.json().catch(() => ({})));
+        return { burned: body.burned ?? true, status: body.status ?? "burned" };
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ncrypted",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "One-time, end-to-end encrypted secrets for AI agents. Pay 0.005 USDC per secret via x402; the note self-destructs after one read.",
   "license": "MIT",
   "type": "module",