notaryos 2.0.0 → 2.1.0

package/dist/index.js

@@ -21,10 +21,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   AuthenticationError: () => AuthenticationError,
-  CounterfactualClient: () => CounterfactualClient,
   NotaryClient: () => NotaryClient,
   NotaryError: () => NotaryError,
-  NotaryErrorCode: () => NotaryErrorCode,
   RateLimitError: () => RateLimitError,
   SDK_VERSION: () => SDK_VERSION,
   ValidationError: () => ValidationError,
@@ -32,27 +30,7 @@ __export(index_exports, {
   verifyReceipt: () => verifyReceipt
 });
 module.exports = __toCommonJS(index_exports);
-var SDK_VERSION = "2.0.0";
-var NotaryErrorCode = {
-  // 4xx Client Errors
-  ERR_RECEIPT_NOT_FOUND: "ERR_RECEIPT_NOT_FOUND",
-  ERR_INVALID_SIGNATURE: "ERR_INVALID_SIGNATURE",
-  ERR_INVALID_STRUCTURE: "ERR_INVALID_STRUCTURE",
-  ERR_INVALID_TIMESTAMP: "ERR_INVALID_TIMESTAMP",
-  ERR_UNKNOWN_SIGNER: "ERR_UNKNOWN_SIGNER",
-  ERR_UNSUPPORTED_ALGORITHM: "ERR_UNSUPPORTED_ALGORITHM",
-  ERR_CHAIN_BROKEN: "ERR_CHAIN_BROKEN",
-  ERR_CHAIN_MISSING: "ERR_CHAIN_MISSING",
-  ERR_PAYLOAD_TOO_LARGE: "ERR_PAYLOAD_TOO_LARGE",
-  ERR_RATE_LIMIT_EXCEEDED: "ERR_RATE_LIMIT_EXCEEDED",
-  ERR_INVALID_API_KEY: "ERR_INVALID_API_KEY",
-  ERR_INSUFFICIENT_SCOPE: "ERR_INSUFFICIENT_SCOPE",
-  ERR_VALIDATION_FAILED: "ERR_VALIDATION_FAILED",
-  // 5xx Server Errors
-  ERR_INTERNAL_ERROR: "ERR_INTERNAL_ERROR",
-  ERR_DATABASE_ERROR: "ERR_DATABASE_ERROR",
-  ERR_SIGNING_ERROR: "ERR_SIGNING_ERROR"
-};
+var SDK_VERSION = "2.1.0";
 var NotaryError = class extends Error {
   constructor(message, code = "", status = 0, details = {}) {
     super(message);
@@ -81,81 +59,10 @@ var ValidationError = class extends NotaryError {
     this.name = "ValidationError";
   }
 };
-var CounterfactualClient = class {
-  constructor(client) {
-    this.client = client;
-  }
-  /** Issue a v1 counterfactual receipt (proof of non-action). */
-  async issue(options) {
-    return this.client["request"]("POST", "/counterfactual/issue", {
-      action_not_taken: options.actionNotTaken,
-      capability_proof: options.capabilityProof,
-      opportunity_context: options.opportunityContext,
-      decision_reason: options.decisionReason,
-      declination_reason: options.declinationReason || "unknown",
-      provenance_refs: options.provenanceRefs,
-      validity_window_minutes: options.validityWindowMinutes || 60
-    });
-  }
-  /** Retrieve/verify a counterfactual receipt by hash (public). */
-  async get(receiptHash) {
-    return this.client["publicGet"](`/v1/notary/counterfactual/r/${receiptHash}`);
-  }
-  /** List counterfactual receipts for a specific agent (public). */
-  async listByAgent(agentId, limit = 50, offset = 0) {
-    return this.client["publicGet"](
-      `/v1/notary/counterfactual/agent/${agentId}?limit=${limit}&offset=${offset}`
-    );
-  }
-  /** Commit a v2 counterfactual receipt (Phase 1 of commit-reveal). */
-  async commit(options) {
-    return this.client["request"]("POST", "/counterfactual/commit", {
-      action_not_taken: options.actionNotTaken,
-      capability_proof: options.capabilityProof,
-      opportunity_context: options.opportunityContext,
-      decision_reason: options.decisionReason,
-      declination_reason: options.declinationReason || "unknown",
-      provenance_refs: options.provenanceRefs,
-      validity_window_minutes: options.validityWindowMinutes || 60,
-      min_reveal_delay_seconds: options.minRevealDelaySeconds || 300,
-      max_reveal_window_seconds: options.maxRevealWindowSeconds || 86400
-    });
-  }
-  /** Reveal a committed counterfactual receipt (Phase 2). */
-  async reveal(receiptHash, decisionReasonPlaintext) {
-    return this.client["request"]("POST", "/counterfactual/reveal", {
-      receipt_hash: receiptHash,
-      decision_reason_plaintext: decisionReasonPlaintext
-    });
-  }
-  /** Check commit-reveal lifecycle status (public). */
-  async commitStatus(receiptHash) {
-    return this.client["publicGet"](
-      `/v1/notary/counterfactual/commit-status/${receiptHash}`
-    );
-  }
-  /** Counter-sign a counterfactual receipt (corroboration). */
-  async corroborate(receiptHash, signals) {
-    return this.client["request"]("POST", "/counterfactual/corroborate", {
-      receipt_hash: receiptHash,
-      corroboration_signals: signals
-    });
-  }
-  /** Generate a compliance certificate for a counterfactual receipt (public). */
-  async certificate(receiptHash, format = "markdown") {
-    return this.client["publicGet"](
-      `/v1/notary/counterfactual/r/${receiptHash}/certificate?format=${format}`
-    );
-  }
-  /** Verify counterfactual chain continuity for an agent (public). */
-  async verifyChain(agentId) {
-    return this.client["publicGet"](
-      `/v1/notary/counterfactual/chain/${agentId}/verify`
-    );
-  }
-};
 var _NotaryClient = class _NotaryClient {
   constructor(config) {
+    /** Alias: seal() → issue() for the 3-line integration pattern. */
+    this.seal = this.issue.bind(this);
     const { apiKey, baseUrl, timeout, maxRetries } = config;
     if (!apiKey || !(apiKey.startsWith("notary_live_") || apiKey.startsWith("notary_test_"))) {
       throw new AuthenticationError(
@@ -167,13 +74,6 @@ var _NotaryClient = class _NotaryClient {
     this.timeout = timeout || _NotaryClient.DEFAULT_TIMEOUT;
     this.maxRetries = maxRetries ?? 2;
   }
-  /** Access counterfactual receipt operations (enterprise premium). */
-  get counterfactual() {
-    if (!this._counterfactual) {
-      this._counterfactual = new CounterfactualClient(this);
-    }
-    return this._counterfactual;
-  }
   async request(method, path, body) {
     const url = `${this.baseUrl}/v1/notary${path}`;
     const headers = {
@@ -241,52 +141,43 @@ var _NotaryClient = class _NotaryClient {
     }
     throw lastError || new NotaryError("Request failed", "ERR_UNKNOWN");
   }
-  /** Public GET helper (no API key in headers). */
-  async publicGet(path) {
-    const url = `${this.baseUrl}${path}`;
-    const controller = new AbortController();
-    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
-    try {
-      const response = await fetch(url, {
-        method: "GET",
-        headers: {
-          "Content-Type": "application/json",
-          "User-Agent": `notary-typescript-sdk/${SDK_VERSION}`
-        },
-        signal: controller.signal
-      });
-      clearTimeout(timeoutId);
-      if (response.status === 404) {
-        return { found: false };
-      }
-      if (!response.ok) {
-        throw new NotaryError(response.statusText, "ERR_REQUEST", response.status);
-      }
-      return await response.json();
-    } catch (err) {
-      clearTimeout(timeoutId);
-      if (err instanceof NotaryError) throw err;
-      throw new NotaryError(`Connection failed: ${err.message}`, "ERR_CONNECTION");
-    }
-  }
   sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
   }
-  // =========================================================================
-  // Core API
-  // =========================================================================
   /**
    * Issue a signed receipt for an action.
    *
-   * @param actionType - Type of action (e.g., "data_processing", "api_call")
-   * @param payload - Action payload to be receipted
-   * @param options - Optional chaining and metadata
-   * @returns A signed Receipt
+   * Supports two calling conventions:
+   * - `issue('action_type', { key: 'value' })` — positional args
+   * - `issue({ actionType: 'action_type', payload: { key: 'value' } })` — object form
+   *
+   * @example
+   * ```typescript
+   * // Positional (recommended)
+   * const receipt = await notary.issue('transfer', { amount: 100 });
+   *
+   * // Object form
+   * const receipt = await notary.issue({ actionType: 'transfer', payload: { amount: 100 } });
+   * ```
    */
-  async issue(actionType, payload, options = {}) {
+  async issue(actionTypeOrRequest, payload, options = {}) {
+    let actionType;
+    let actionPayload;
+    if (typeof actionTypeOrRequest === "object" && actionTypeOrRequest !== null) {
+      actionType = actionTypeOrRequest.actionType;
+      actionPayload = actionTypeOrRequest.payload || {};
+      options = {
+        previousReceiptHash: actionTypeOrRequest.previousReceiptHash,
+        metadata: actionTypeOrRequest.metadata,
+        ...options
+      };
+    } else {
+      actionType = actionTypeOrRequest;
+      actionPayload = payload || {};
+    }
     const body = {
       action_type: actionType,
-      payload
+      payload: actionPayload
     };
     if (options.previousReceiptHash) {
       body.previous_receipt_hash = options.previousReceiptHash;
@@ -302,7 +193,20 @@ var _NotaryClient = class _NotaryClient {
       chain_sequence: response.chain_position
     };
   }
-  /** Verify a receipt's signature and integrity. */
+  /**
+   * Verify a receipt's signature and integrity.
+   *
+   * @param receipt - Receipt object or raw receipt dict
+   * @returns VerificationResult with validity details
+   *
+   * @example
+   * ```typescript
+   * const result = await notary.verify(receipt);
+   * if (result.valid) {
+   *   console.log('Receipt is authentic');
+   * }
+   * ```
+   */
   async verify(receipt) {
     return this.request("POST", "/verify", { receipt });
   }
@@ -310,7 +214,15 @@ var _NotaryClient = class _NotaryClient {
   async verifyById(receiptId) {
     return this.request("POST", "/verify", { receipt_id: receiptId });
   }
-  /** Get Notary service status. */
+  /**
+   * Get Notary service status.
+   *
+   * @example
+   * ```typescript
+   * const status = await notary.status();
+   * console.log(status.status); // "active"
+   * ```
+   */
   async status() {
     return this.request("GET", "/status");
   }
@@ -322,150 +234,6 @@ var _NotaryClient = class _NotaryClient {
   async me() {
     return this.request("GET", "/agents/me");
   }
-  /** Look up a receipt by hash (public endpoint). */
-  async lookup(receiptHash) {
-    return this.publicGet(`/v1/notary/r/${receiptHash}`);
-  }
-  // =========================================================================
-  // History & Provenance
-  // =========================================================================
-  /**
-   * Get paginated receipt history (requires Clerk JWT).
-   *
-   * @param options - Pagination, filters, and Clerk token
-   * @returns Paginated history with items, total, totalPages
-   */
-  async history(options = {}) {
-    const params = new URLSearchParams();
-    params.set("page", String(options.page || 1));
-    params.set("page_size", String(options.pageSize || 10));
-    if (options.status) params.set("status", options.status);
-    if (options.search) params.set("search", options.search);
-    if (options.startDate) params.set("start_date", options.startDate);
-    if (options.endDate) params.set("end_date", options.endDate);
-    const url = `${this.baseUrl}/v1/notary/history?${params.toString()}`;
-    const headers = {
-      "Content-Type": "application/json",
-      "User-Agent": `notary-typescript-sdk/${SDK_VERSION}`
-    };
-    if (options.clerkToken) {
-      headers["Authorization"] = `Bearer ${options.clerkToken}`;
-    } else {
-      headers["X-API-Key"] = this.apiKey;
-    }
-    const controller = new AbortController();
-    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
-    try {
-      const response = await fetch(url, {
-        method: "GET",
-        headers,
-        signal: controller.signal
-      });
-      clearTimeout(timeoutId);
-      if (!response.ok) {
-        throw new NotaryError(response.statusText, "ERR_HISTORY", response.status);
-      }
-      return await response.json();
-    } catch (err) {
-      clearTimeout(timeoutId);
-      if (err instanceof NotaryError) throw err;
-      throw new NotaryError(`Connection failed: ${err.message}`, "ERR_CONNECTION");
-    }
-  }
-  /**
-   * Get the provenance DAG report for a receipt (public).
-   *
-   * @param receiptHash - The receipt hash to check
-   * @returns Provenance report with grounding status, ancestors, paths
-   */
-  async provenance(receiptHash) {
-    return this.publicGet(`/v1/notary/r/${receiptHash}/provenance`);
-  }
-  // =========================================================================
-  // Auto-receipting (wrap)
-  // =========================================================================
-  /**
-   * Wrap an object so method calls are automatically receipted.
-   *
-   * Uses ES6 Proxy to intercept method calls. Receipts are issued
-   * in the background via fire-and-forget (won't slow down your agent).
-   *
-   * @param obj - The agent or object to wrap
-   * @param config - Optional auto-receipt configuration
-   * @returns A proxied version of the object
-   *
-   * @example
-   * ```typescript
-   * const agent = notary.wrap(myAgent, { mode: 'all', fireAndForget: true });
-   * await agent.processData(input); // auto-receipted!
-   * ```
-   */
-  wrap(obj, config = {}) {
-    const client = this;
-    const cfg = {
-      mode: config.mode || "all",
-      sampleRate: config.sampleRate ?? 1,
-      fireAndForget: config.fireAndForget ?? true,
-      maxPayloadBytes: config.maxPayloadBytes ?? 4096,
-      dryRun: config.dryRun ?? false
-    };
-    const className = obj.constructor?.name || "UnknownAgent";
-    let lastHash;
-    return new Proxy(obj, {
-      get(target, prop, receiver) {
-        const value = Reflect.get(target, prop, receiver);
-        if (typeof value !== "function" || typeof prop !== "string" || prop.startsWith("_")) {
-          return value;
-        }
-        return async function(...args) {
-          const start = performance.now();
-          let status = "success";
-          let errorType;
-          let result;
-          try {
-            result = await value.apply(target, args);
-            return result;
-          } catch (err) {
-            status = "error";
-            errorType = err.constructor?.name || "Error";
-            throw err;
-          } finally {
-            const shouldReceipt = cfg.mode === "all" || cfg.mode === "errors_only" && status === "error" || cfg.mode === "sample" && Math.random() < cfg.sampleRate;
-            if (shouldReceipt) {
-              const durationMs = Math.round((performance.now() - start) * 100) / 100;
-              const payload = {
-                agent: className,
-                auto_receipt: true,
-                function: prop,
-                timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-                duration_ms: durationMs,
-                status,
-                error_type: errorType,
-                arguments: _safeRepr(args),
-                result_summary: _safeRepr(result)
-              };
-              if (cfg.dryRun) {
-                console.error(`[NotaryOS DRY RUN] ${String(prop)}: ${JSON.stringify(payload)}`);
-              } else if (cfg.fireAndForget) {
-                client.issue(String(prop), payload, { previousReceiptHash: lastHash }).then((r) => {
-                  if (r.receipt_hash) lastHash = r.receipt_hash;
-                }).catch(() => {
-                });
-              } else {
-                try {
-                  const r = await client.issue(String(prop), payload, {
-                    previousReceiptHash: lastHash
-                  });
-                  if (r.receipt_hash) lastHash = r.receipt_hash;
-                } catch {
-                }
-              }
-            }
-          }
-        };
-      }
-    });
-  }
 };
 _NotaryClient.DEFAULT_BASE_URL = "https://api.agenttownsquare.com";
 _NotaryClient.DEFAULT_TIMEOUT = 3e4;
@@ -495,22 +263,11 @@ async function computeHash(payload) {
   }
   return hex;
 }
-function _safeRepr(value, depth = 3) {
-  if (depth <= 0) return value != null ? "..." : null;
-  if (value === null || value === void 0) return value;
-  if (typeof value === "boolean" || typeof value === "number") return value;
-  if (typeof value === "string") return value.length > 500 ? value.slice(0, 500) : value;
-  if (Array.isArray(value)) return `<array len=${value.length}>`;
-  if (typeof value === "object") return `<object keys=${Object.keys(value).length}>`;
-  return `<${typeof value}>`;
-}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AuthenticationError,
-  CounterfactualClient,
   NotaryClient,
   NotaryError,
-  NotaryErrorCode,
   RateLimitError,
   SDK_VERSION,
   ValidationError,