@tacitprotocol/sdk 0.1.1 → 0.1.2

package/dist/index.d.mts

@@ -176,6 +176,9 @@ type TacitEvent = {
 } | {
     type: 'intent:matched';
     match: MatchResult;
+} | {
+    type: 'match';
+    match: MatchResult;
 } | {
     type: 'intent:expired';
     intentId: string;
@@ -253,10 +256,26 @@ declare class TacitAgent {
      * Returns an AgentIdentity that can be passed to the constructor.
      */
     static createIdentity(): Promise<AgentIdentity>;
+    /**
+     * Convenience factory: creates a new identity and returns a ready-to-use agent.
+     */
+    static create(options?: {
+        domain?: DomainType;
+        preferences?: Record<string, any>;
+        seeking?: string;
+        offering?: string;
+    }): Promise<TacitAgent>;
+    /** Get the agent's DID (shorthand). */
+    get did(): string;
+    /** Get the agent's Agent Card (shorthand). */
+    get card(): AgentCard;
     /**
      * Connect the agent to the Tacit network via a relay node.
+     * Pass `{ demo: true }` to simulate a match after 3 seconds (no relay needed).
      */
-    connect(): Promise<void>;
+    connect(options?: {
+        demo?: boolean;
+    }): Promise<void>;
     /**
      * Disconnect the agent from the network.
      * Active intents remain on the network until their TTL expires.

package/dist/index.d.ts

@@ -176,6 +176,9 @@ type TacitEvent = {
 } | {
     type: 'intent:matched';
     match: MatchResult;
+} | {
+    type: 'match';
+    match: MatchResult;
 } | {
     type: 'intent:expired';
     intentId: string;
@@ -253,10 +256,26 @@ declare class TacitAgent {
      * Returns an AgentIdentity that can be passed to the constructor.
      */
     static createIdentity(): Promise<AgentIdentity>;
+    /**
+     * Convenience factory: creates a new identity and returns a ready-to-use agent.
+     */
+    static create(options?: {
+        domain?: DomainType;
+        preferences?: Record<string, any>;
+        seeking?: string;
+        offering?: string;
+    }): Promise<TacitAgent>;
+    /** Get the agent's DID (shorthand). */
+    get did(): string;
+    /** Get the agent's Agent Card (shorthand). */
+    get card(): AgentCard;
     /**
      * Connect the agent to the Tacit network via a relay node.
+     * Pass `{ demo: true }` to simulate a match after 3 seconds (no relay needed).
      */
-    connect(): Promise<void>;
+    connect(options?: {
+        demo?: boolean;
+    }): Promise<void>;
     /**
      * Disconnect the agent from the network.
      * Active intents remain on the network until their TTL expires.

package/dist/index.js

@@ -340,7 +340,7 @@ var EventBus = class {
     }
   }
 };
-var TacitAgent = class {
+var TacitAgent = class _TacitAgent {
   identity = null;
   config;
   events = new EventBus();
@@ -367,7 +367,7 @@ var TacitAgent = class {
       this.identity = config.identity;
     }
   }
-  // ─── Static Factory ───────────────────────────────────────────
+  // ─── Static Factories ──────────────────────────────────────────
   /**
    * Create a new agent identity.
    * Returns an AgentIdentity that can be passed to the constructor.
@@ -375,11 +375,37 @@ var TacitAgent = class {
   static async createIdentity() {
     return createIdentity();
   }
+  /**
+   * Convenience factory: creates a new identity and returns a ready-to-use agent.
+   */
+  static async create(options = {}) {
+    const identity = await _TacitAgent.createIdentity();
+    return new _TacitAgent({
+      identity,
+      profile: {
+        name: "Tacit Agent",
+        domain: options.domain || "professional",
+        seeking: options.seeking || "",
+        offering: options.offering || ""
+      },
+      preferences: options.preferences
+    });
+  }
+  // ─── Convenience Getters ─────────────────────────────────────
+  /** Get the agent's DID (shorthand). */
+  get did() {
+    return this.getDid();
+  }
+  /** Get the agent's Agent Card (shorthand). */
+  get card() {
+    return this.getAgentCard();
+  }
   // ─── Lifecycle ────────────────────────────────────────────────
   /**
    * Connect the agent to the Tacit network via a relay node.
+   * Pass `{ demo: true }` to simulate a match after 3 seconds (no relay needed).
    */
-  async connect() {
+  async connect(options) {
     if (!this.identity) {
       this.identity = await createIdentity();
     }
@@ -388,6 +414,31 @@ var TacitAgent = class {
       type: "connection:established",
       endpoint: this.config.relayUrl
     });
+    if (options?.demo) {
+      setTimeout(async () => {
+        const simulatedMatch = {
+          matchId: `match:demo:${Date.now()}`,
+          agents: {
+            initiator: this.identity.did,
+            responder: "did:key:z6MkdemoAgent00000000000000000000000000000000"
+          },
+          score: {
+            overall: 87,
+            breakdown: {
+              intentAlignment: 0.92,
+              domainFit: 0.88,
+              authenticityCompatibility: 0.85,
+              preferenceMatch: 0.82,
+              timingFit: 0.9
+            }
+          },
+          timestamp: (/* @__PURE__ */ new Date()).toISOString()
+        };
+        await this.events.emit({ type: "match", match: simulatedMatch });
+      }, 3e3);
+      await new Promise(() => {
+      });
+    }
   }
   /**
    * Disconnect the agent from the network.

package/dist/index.mjs

@@ -305,7 +305,7 @@ var EventBus = class {
     }
   }
 };
-var TacitAgent = class {
+var TacitAgent = class _TacitAgent {
   identity = null;
   config;
   events = new EventBus();
@@ -332,7 +332,7 @@ var TacitAgent = class {
       this.identity = config.identity;
     }
   }
-  // ─── Static Factory ───────────────────────────────────────────
+  // ─── Static Factories ──────────────────────────────────────────
   /**
    * Create a new agent identity.
    * Returns an AgentIdentity that can be passed to the constructor.
@@ -340,11 +340,37 @@ var TacitAgent = class {
   static async createIdentity() {
     return createIdentity();
   }
+  /**
+   * Convenience factory: creates a new identity and returns a ready-to-use agent.
+   */
+  static async create(options = {}) {
+    const identity = await _TacitAgent.createIdentity();
+    return new _TacitAgent({
+      identity,
+      profile: {
+        name: "Tacit Agent",
+        domain: options.domain || "professional",
+        seeking: options.seeking || "",
+        offering: options.offering || ""
+      },
+      preferences: options.preferences
+    });
+  }
+  // ─── Convenience Getters ─────────────────────────────────────
+  /** Get the agent's DID (shorthand). */
+  get did() {
+    return this.getDid();
+  }
+  /** Get the agent's Agent Card (shorthand). */
+  get card() {
+    return this.getAgentCard();
+  }
   // ─── Lifecycle ────────────────────────────────────────────────
   /**
    * Connect the agent to the Tacit network via a relay node.
+   * Pass `{ demo: true }` to simulate a match after 3 seconds (no relay needed).
    */
-  async connect() {
+  async connect(options) {
     if (!this.identity) {
       this.identity = await createIdentity();
     }
@@ -353,6 +379,31 @@ var TacitAgent = class {
       type: "connection:established",
       endpoint: this.config.relayUrl
     });
+    if (options?.demo) {
+      setTimeout(async () => {
+        const simulatedMatch = {
+          matchId: `match:demo:${Date.now()}`,
+          agents: {
+            initiator: this.identity.did,
+            responder: "did:key:z6MkdemoAgent00000000000000000000000000000000"
+          },
+          score: {
+            overall: 87,
+            breakdown: {
+              intentAlignment: 0.92,
+              domainFit: 0.88,
+              authenticityCompatibility: 0.85,
+              preferenceMatch: 0.82,
+              timingFit: 0.9
+            }
+          },
+          timestamp: (/* @__PURE__ */ new Date()).toISOString()
+        };
+        await this.events.emit({ type: "match", match: simulatedMatch });
+      }, 3e3);
+      await new Promise(() => {
+      });
+    }
   }
   /**
    * Disconnect the agent from the network.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tacitprotocol/sdk",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "The Tacit Protocol SDK — verify identity, prevent fraud, and broker trusted introductions with cryptographic proof",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/core/agent.ts

@@ -91,7 +91,7 @@ export class TacitAgent {
     }
   }
 
-  // ─── Static Factory ───────────────────────────────────────────
+  // ─── Static Factories ──────────────────────────────────────────
 
   /**
    * Create a new agent identity.
@@ -101,12 +101,47 @@ export class TacitAgent {
     return createIdentity();
   }
 
+  /**
+   * Convenience factory: creates a new identity and returns a ready-to-use agent.
+   */
+  static async create(options: {
+    domain?: DomainType;
+    preferences?: Record<string, any>;
+    seeking?: string;
+    offering?: string;
+  } = {}): Promise<TacitAgent> {
+    const identity = await TacitAgent.createIdentity();
+    return new TacitAgent({
+      identity,
+      profile: {
+        name: 'Tacit Agent',
+        domain: options.domain || 'professional',
+        seeking: options.seeking || '',
+        offering: options.offering || '',
+      },
+      preferences: options.preferences as any,
+    });
+  }
+
+  // ─── Convenience Getters ─────────────────────────────────────
+
+  /** Get the agent's DID (shorthand). */
+  get did(): string {
+    return this.getDid();
+  }
+
+  /** Get the agent's Agent Card (shorthand). */
+  get card(): AgentCard {
+    return this.getAgentCard();
+  }
+
   // ─── Lifecycle ────────────────────────────────────────────────
 
   /**
    * Connect the agent to the Tacit network via a relay node.
+   * Pass `{ demo: true }` to simulate a match after 3 seconds (no relay needed).
    */
-  async connect(): Promise<void> {
+  async connect(options?: { demo?: boolean }): Promise<void> {
     if (!this.identity) {
       this.identity = await createIdentity();
     }
@@ -121,6 +156,34 @@ export class TacitAgent {
       type: 'connection:established',
       endpoint: this.config.relayUrl!,
     });
+
+    // Demo mode: simulate a match after 3 seconds
+    if (options?.demo) {
+      setTimeout(async () => {
+        const simulatedMatch: MatchResult = {
+          matchId: `match:demo:${Date.now()}`,
+          agents: {
+            initiator: this.identity!.did,
+            responder: 'did:key:z6MkdemoAgent00000000000000000000000000000000' as any,
+          },
+          score: {
+            overall: 87,
+            breakdown: {
+              intentAlignment: 0.92,
+              domainFit: 0.88,
+              authenticityCompatibility: 0.85,
+              preferenceMatch: 0.82,
+              timingFit: 0.90,
+            },
+          },
+          timestamp: new Date().toISOString(),
+        };
+        await this.events.emit({ type: 'match', match: simulatedMatch });
+      }, 3000);
+
+      // Keep the process alive
+      await new Promise(() => {});
+    }
   }
 
   /**

package/src/types/index.ts

@@ -248,6 +248,7 @@ export interface ServiceAttestation {
 export type TacitEvent =
   | { type: 'intent:published'; intent: Intent }
   | { type: 'intent:matched'; match: MatchResult }
+  | { type: 'match'; match: MatchResult }
   | { type: 'intent:expired'; intentId: string }
   | { type: 'proposal:received'; proposal: IntroProposal }
   | { type: 'proposal:accepted'; proposal: IntroProposal }