notaryos 1.0.0 → 2.1.0

package/README.md

@@ -112,15 +112,15 @@ try {
 
 ## Get an API Key
 
-1. Sign up at [notaryos.org](https://notaryos.org)
+1. Sign up at [agenttownsquare.com/notary](https://agenttownsquare.com/notary)
 2. Generate an API key from the dashboard
 3. Keys start with `notary_live_` (production) or `notary_test_` (sandbox)
 
 ## Links
 
-- [NotaryOS Documentation](https://notaryos.org/docs)
+- [NotaryOS Documentation](https://agenttownsquare.com/notary)
 - [API Reference](https://api.agenttownsquare.com/v1/notary/status)
-- [Public Verification](https://notaryos.org/verify)
+- [Public Verification](https://api.agenttownsquare.com/v1/notary/r/{hash})
 
 ## License
 

package/dist/index.d.mts

@@ -17,7 +17,7 @@
  *
  * @packageDocumentation
  */
-declare const SDK_VERSION = "1.0.0";
+declare const SDK_VERSION = "2.1.0";
 /** Client configuration options. */
 interface NotaryConfig {
     /** Your Notary API key (notary_live_xxx or notary_test_xxx). */
@@ -73,13 +73,6 @@ interface PublicKeyInfo {
     public_key_pem: string;
     verification_note: string;
 }
-/** Result of a receipt lookup by hash. */
-interface LookupResult {
-    found: boolean;
-    receipt: Receipt | null;
-    verification: VerificationResult | null;
-    meta: Record<string, unknown> | null;
-}
 /** Authenticated agent information. */
 interface AgentInfo {
     agent_id: string;
@@ -95,6 +88,17 @@ interface IssueOptions {
     /** Additional metadata. */
     metadata?: Record<string, unknown>;
 }
+/** Object-form argument for issue()/seal(). */
+interface IssueRequest {
+    /** Type of action (e.g., "data_processing", "api_call"). */
+    actionType: string;
+    /** Action payload to be receipted. */
+    payload: Record<string, unknown>;
+    /** Hash of previous receipt for chaining. */
+    previousReceiptHash?: string;
+    /** Additional metadata. */
+    metadata?: Record<string, unknown>;
+}
 /** Base error for all NotaryOS SDK errors. */
 declare class NotaryError extends Error {
     code: string;
@@ -146,19 +150,22 @@ declare class NotaryClient {
     /**
      * 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
-     * const receipt = await notary.issue('transfer', { amount: 100, to: 'agent-b' });
-     * console.log(receipt.receipt_id);
-     * console.log(receipt.verify_url); // https://...notary/r/abc123
+     * // Positional (recommended)
+     * const receipt = await notary.issue('transfer', { amount: 100 });
+     *
+     * // Object form
+     * const receipt = await notary.issue({ actionType: 'transfer', payload: { amount: 100 } });
      * ```
      */
-    issue(actionType: string, payload: Record<string, unknown>, options?: IssueOptions): Promise<Receipt>;
+    issue(actionTypeOrRequest: string | IssueRequest, payload?: Record<string, unknown>, options?: IssueOptions): Promise<Receipt>;
+    /** Alias: seal() → issue() for the 3-line integration pattern. */
+    seal: (actionTypeOrRequest: string | IssueRequest, payload?: Record<string, unknown>, options?: IssueOptions) => Promise<Receipt>;
     /**
      * Verify a receipt's signature and integrity.
      *
@@ -190,21 +197,6 @@ declare class NotaryClient {
     publicKey(): Promise<PublicKeyInfo>;
     /** Get authenticated agent info. */
     me(): Promise<AgentInfo>;
-    /**
-     * Look up a receipt by hash (public endpoint, no API key required for lookup).
-     *
-     * @param receiptHash - Full or partial receipt hash (min 16 chars)
-     * @returns Lookup result with receipt, verification, and meta
-     *
-     * @example
-     * ```typescript
-     * const result = await notary.lookup('abc123def456...');
-     * if (result.found && result.verification?.valid) {
-     *   console.log('Receipt is valid!');
-     * }
-     * ```
-     */
-    lookup(receiptHash: string): Promise<LookupResult>;
 }
 /**
  * Quick receipt verification without API key.
@@ -234,4 +226,4 @@ declare function verifyReceipt(receipt: Record<string, unknown>, baseUrl?: strin
  */
 declare function computeHash(payload: Record<string, unknown> | string): Promise<string>;
 
-export { type AgentInfo, AuthenticationError, type IssueOptions, type LookupResult, NotaryClient, type NotaryConfig, NotaryError, type PublicKeyInfo, RateLimitError, type Receipt, SDK_VERSION, type ServiceStatus, ValidationError, type VerificationResult, computeHash, verifyReceipt };
+export { type AgentInfo, AuthenticationError, type IssueOptions, type IssueRequest, NotaryClient, type NotaryConfig, NotaryError, type PublicKeyInfo, RateLimitError, type Receipt, SDK_VERSION, type ServiceStatus, ValidationError, type VerificationResult, computeHash, verifyReceipt };

package/dist/index.d.ts

@@ -17,7 +17,7 @@
  *
  * @packageDocumentation
  */
-declare const SDK_VERSION = "1.0.0";
+declare const SDK_VERSION = "2.1.0";
 /** Client configuration options. */
 interface NotaryConfig {
     /** Your Notary API key (notary_live_xxx or notary_test_xxx). */
@@ -73,13 +73,6 @@ interface PublicKeyInfo {
     public_key_pem: string;
     verification_note: string;
 }
-/** Result of a receipt lookup by hash. */
-interface LookupResult {
-    found: boolean;
-    receipt: Receipt | null;
-    verification: VerificationResult | null;
-    meta: Record<string, unknown> | null;
-}
 /** Authenticated agent information. */
 interface AgentInfo {
     agent_id: string;
@@ -95,6 +88,17 @@ interface IssueOptions {
     /** Additional metadata. */
     metadata?: Record<string, unknown>;
 }
+/** Object-form argument for issue()/seal(). */
+interface IssueRequest {
+    /** Type of action (e.g., "data_processing", "api_call"). */
+    actionType: string;
+    /** Action payload to be receipted. */
+    payload: Record<string, unknown>;
+    /** Hash of previous receipt for chaining. */
+    previousReceiptHash?: string;
+    /** Additional metadata. */
+    metadata?: Record<string, unknown>;
+}
 /** Base error for all NotaryOS SDK errors. */
 declare class NotaryError extends Error {
     code: string;
@@ -146,19 +150,22 @@ declare class NotaryClient {
     /**
      * 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
-     * const receipt = await notary.issue('transfer', { amount: 100, to: 'agent-b' });
-     * console.log(receipt.receipt_id);
-     * console.log(receipt.verify_url); // https://...notary/r/abc123
+     * // Positional (recommended)
+     * const receipt = await notary.issue('transfer', { amount: 100 });
+     *
+     * // Object form
+     * const receipt = await notary.issue({ actionType: 'transfer', payload: { amount: 100 } });
      * ```
      */
-    issue(actionType: string, payload: Record<string, unknown>, options?: IssueOptions): Promise<Receipt>;
+    issue(actionTypeOrRequest: string | IssueRequest, payload?: Record<string, unknown>, options?: IssueOptions): Promise<Receipt>;
+    /** Alias: seal() → issue() for the 3-line integration pattern. */
+    seal: (actionTypeOrRequest: string | IssueRequest, payload?: Record<string, unknown>, options?: IssueOptions) => Promise<Receipt>;
     /**
      * Verify a receipt's signature and integrity.
      *
@@ -190,21 +197,6 @@ declare class NotaryClient {
     publicKey(): Promise<PublicKeyInfo>;
     /** Get authenticated agent info. */
     me(): Promise<AgentInfo>;
-    /**
-     * Look up a receipt by hash (public endpoint, no API key required for lookup).
-     *
-     * @param receiptHash - Full or partial receipt hash (min 16 chars)
-     * @returns Lookup result with receipt, verification, and meta
-     *
-     * @example
-     * ```typescript
-     * const result = await notary.lookup('abc123def456...');
-     * if (result.found && result.verification?.valid) {
-     *   console.log('Receipt is valid!');
-     * }
-     * ```
-     */
-    lookup(receiptHash: string): Promise<LookupResult>;
 }
 /**
  * Quick receipt verification without API key.
@@ -234,4 +226,4 @@ declare function verifyReceipt(receipt: Record<string, unknown>, baseUrl?: strin
  */
 declare function computeHash(payload: Record<string, unknown> | string): Promise<string>;
 
-export { type AgentInfo, AuthenticationError, type IssueOptions, type LookupResult, NotaryClient, type NotaryConfig, NotaryError, type PublicKeyInfo, RateLimitError, type Receipt, SDK_VERSION, type ServiceStatus, ValidationError, type VerificationResult, computeHash, verifyReceipt };
+export { type AgentInfo, AuthenticationError, type IssueOptions, type IssueRequest, NotaryClient, type NotaryConfig, NotaryError, type PublicKeyInfo, RateLimitError, type Receipt, SDK_VERSION, type ServiceStatus, ValidationError, type VerificationResult, computeHash, verifyReceipt };

package/dist/index.js

@@ -30,7 +30,7 @@ __export(index_exports, {
   verifyReceipt: () => verifyReceipt
 });
 module.exports = __toCommonJS(index_exports);
-var SDK_VERSION = "1.0.0";
+var SDK_VERSION = "2.1.0";
 var NotaryError = class extends Error {
   constructor(message, code = "", status = 0, details = {}) {
     super(message);
@@ -61,6 +61,8 @@ var ValidationError = class extends NotaryError {
 };
 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(
@@ -145,22 +147,37 @@ var _NotaryClient = class _NotaryClient {
   /**
    * 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
-   * const receipt = await notary.issue('transfer', { amount: 100, to: 'agent-b' });
-   * console.log(receipt.receipt_id);
-   * console.log(receipt.verify_url); // https://...notary/r/abc123
+   * // 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;
@@ -217,54 +234,6 @@ var _NotaryClient = class _NotaryClient {
   async me() {
     return this.request("GET", "/agents/me");
   }
-  /**
-   * Look up a receipt by hash (public endpoint, no API key required for lookup).
-   *
-   * @param receiptHash - Full or partial receipt hash (min 16 chars)
-   * @returns Lookup result with receipt, verification, and meta
-   *
-   * @example
-   * ```typescript
-   * const result = await notary.lookup('abc123def456...');
-   * if (result.found && result.verification?.valid) {
-   *   console.log('Receipt is valid!');
-   * }
-   * ```
-   */
-  async lookup(receiptHash) {
-    const url = `${this.baseUrl}/v1/notary/r/${receiptHash}`;
-    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, receipt: null, verification: null, meta: null };
-      }
-      if (!response.ok) {
-        throw new NotaryError(
-          response.statusText,
-          "ERR_LOOKUP",
-          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"
-      );
-    }
-  }
 };
 _NotaryClient.DEFAULT_BASE_URL = "https://api.agenttownsquare.com";
 _NotaryClient.DEFAULT_TIMEOUT = 3e4;

package/dist/index.mjs

@@ -1,5 +1,5 @@
 // src/index.ts
-var SDK_VERSION = "1.0.0";
+var SDK_VERSION = "2.1.0";
 var NotaryError = class extends Error {
   constructor(message, code = "", status = 0, details = {}) {
     super(message);
@@ -30,6 +30,8 @@ var ValidationError = class extends NotaryError {
 };
 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(
@@ -114,22 +116,37 @@ var _NotaryClient = class _NotaryClient {
   /**
    * 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
-   * const receipt = await notary.issue('transfer', { amount: 100, to: 'agent-b' });
-   * console.log(receipt.receipt_id);
-   * console.log(receipt.verify_url); // https://...notary/r/abc123
+   * // 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;
@@ -186,54 +203,6 @@ var _NotaryClient = class _NotaryClient {
   async me() {
     return this.request("GET", "/agents/me");
   }
-  /**
-   * Look up a receipt by hash (public endpoint, no API key required for lookup).
-   *
-   * @param receiptHash - Full or partial receipt hash (min 16 chars)
-   * @returns Lookup result with receipt, verification, and meta
-   *
-   * @example
-   * ```typescript
-   * const result = await notary.lookup('abc123def456...');
-   * if (result.found && result.verification?.valid) {
-   *   console.log('Receipt is valid!');
-   * }
-   * ```
-   */
-  async lookup(receiptHash) {
-    const url = `${this.baseUrl}/v1/notary/r/${receiptHash}`;
-    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, receipt: null, verification: null, meta: null };
-      }
-      if (!response.ok) {
-        throw new NotaryError(
-          response.statusText,
-          "ERR_LOOKUP",
-          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"
-      );
-    }
-  }
 };
 _NotaryClient.DEFAULT_BASE_URL = "https://api.agenttownsquare.com";
 _NotaryClient.DEFAULT_TIMEOUT = 3e4;

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "notaryos",
-  "version": "1.0.0",
+  "version": "2.1.0",
   "description": "NotaryOS SDK - Cryptographic receipts for AI agent actions. Issue, verify, and audit agent behavior with Ed25519 signatures.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
       "import": "./dist/index.mjs",
-      "require": "./dist/index.js"
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
     }
   },
   "files": [
@@ -44,11 +44,11 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/hellothere012/notaryos"
+    "url": "https://github.com/agenttownsquare/notaryos-sdk-typescript"
   },
-  "homepage": "https://notaryos.org",
+  "homepage": "https://agenttownsquare.com/notary",
   "bugs": {
-    "url": "https://github.com/hellothere012/notaryos/issues"
+    "url": "https://github.com/agenttownsquare/notaryos-sdk-typescript/issues"
   },
   "engines": {
     "node": ">=18.0.0"