pounce-agent-data 1.0.0

package/README.md

@@ -0,0 +1,62 @@
+# Pounce Agent Data SDK
+
+TypeScript SDK for the [Pounce Agent Data API](https://pounce.ch/developers) - Connect your AI agents to 500k+ B2B company signals.
+
+## Installation
+
+```bash
+npm install @pounce/agent-data
+```
+
+## Quick Start
+
+```typescript
+import { PounceClient } from '@pounce/agent-data';
+
+const client = new PounceClient({ apiKey: 'pounce_live_xxx' });
+
+// Recent signals
+const { json } = await client.recentSignals({ limit: 10, category: 'saas' });
+for (const item of json.items) {
+  console.log(`${item.domain}: ${item.signal_score}`);
+}
+
+// Semantic search
+const results = await client.search('AI startups in healthcare', { limit: 20 });
+for (const item of results.json.items) {
+  console.log(`${item.domain}: similarity=${item.similarity.toFixed(2)}`);
+}
+
+// Stream new signals (real-time)
+for await (const signal of client.stream({ minScore: 70 })) {
+  console.log(`New: ${signal.domain} (score=${signal.signalScore})`);
+}
+```
+
+## API Key
+
+Get your API key:
+1. Sign up at [pounce.ch](https://pounce.ch)
+2. Subscribe to Pro ($49/month) or Business ($149/month)
+3. Generate API key in **Settings → API Access**
+
+## Rate Limits
+
+| Tier | Requests/month |
+|------|----------------|
+| Pro | 1,000 |
+| Business | 10,000 |
+
+## Documentation
+
+- [API Documentation](https://pounce.ch/developers)
+- [Skill File](https://pounce.ch/skill.md)
+- [API Reference](https://api.pounce.ch/docs#/agent-data)
+
+## Support
+
+- Email: hello@pounce.ch
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,204 @@
+/**
+ * Pounce Agent Data SDK - TypeScript Client
+ *
+ * Minimal client for the Pounce Agent Data API.
+ * Supports recent signals, semantic search, signal details, and SSE streaming.
+ *
+ * @example
+ * ```typescript
+ * import { PounceAgentDataClient } from '@pounce/agent-data';
+ *
+ * const client = new PounceAgentDataClient({ apiKey: 'pounce_live_xxx' });
+ *
+ * // Recent signals
+ * const { json, rateLimit } = await client.recentSignals({ limit: 10, category: 'saas' });
+ *
+ * // Semantic search
+ * const results = await client.search('AI companies in healthcare', { limit: 20 });
+ *
+ * // Stream new signals
+ * for await (const signal of client.stream({ minScore: 70 })) {
+ *   console.log(signal);
+ * }
+ * ```
+ */
+type RateLimitInfo = {
+    limit?: number;
+    remaining?: number;
+    resetUnix?: number;
+};
+type Signal = {
+    signalId: string;
+    domain: string;
+    companyName?: string | null;
+    category?: string | null;
+    subcategory?: string | null;
+    signalScore: number;
+    trustScore?: number | null;
+    intentTags?: string[] | null;
+    techStack?: string[] | null;
+    country?: string | null;
+    description?: string | null;
+    detectedAt?: string | null;
+    uiUrl?: string | null;
+};
+type AgentDataRecentSignal = {
+    id: number;
+    signal_id?: string;
+    domain: string;
+    tld: string;
+    title?: string | null;
+    description?: string | null;
+    h1?: string | null;
+    category?: string | null;
+    subcategory?: string | null;
+    business_type?: string | null;
+    signal_score: number;
+    signal_grade?: string | null;
+    tech_stack?: string[] | null;
+    intent_tags?: string[] | null;
+    hosting_provider?: string | null;
+    country?: string | null;
+    has_real_content: boolean;
+    scanned_at?: string | null;
+    discovered_at: string;
+    ui_url?: string | null;
+};
+type RecentSignalsResponse = {
+    items: AgentDataRecentSignal[];
+    count: number;
+    has_more?: boolean;
+};
+type SemanticSearchItem = {
+    signal_id: string;
+    domain: string;
+    company_name?: string | null;
+    category?: string | null;
+    signal_score: number;
+    similarity: number;
+    snippet?: string | null;
+    intent_tags?: string[] | null;
+    country?: string | null;
+    ui_url?: string | null;
+};
+type SemanticSearchResponse = {
+    items: SemanticSearchItem[];
+    count: number;
+    query_tokens?: number;
+};
+type SignalDetailResponse = {
+    signal_id: string;
+    domain: string;
+    company_name?: string | null;
+    category?: string | null;
+    subcategory?: string | null;
+    signal_score: number;
+    trust_score?: number | null;
+    intent_tags?: string[] | null;
+    tech_stack?: string[] | null;
+    country?: string | null;
+    description?: string | null;
+    social_links?: Record<string, string> | null;
+    detected_at?: string | null;
+    ui_url?: string | null;
+};
+type AgentDataUsageResponse = {
+    api_key_prefix: string;
+    usage: {
+        period_start: string;
+        period_end: string;
+        used: number;
+        limit: number;
+        remaining: number;
+        reset_at: string;
+    };
+};
+type RecentSignalsOptions = {
+    hours?: number;
+    limit?: number;
+    minScore?: number;
+    category?: string;
+    country?: string;
+    tlds?: string[];
+};
+type SemanticSearchOptions = {
+    limit?: number;
+    minScore?: number;
+    category?: string;
+    country?: string;
+    tlds?: string[];
+};
+type StreamOptions = {
+    minScore?: number;
+    category?: string;
+    since?: string;
+};
+declare class PounceAgentDataClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    constructor(options: {
+        apiKey: string;
+        baseUrl?: string;
+    });
+    private extractRateLimit;
+    private getJson;
+    private postJson;
+    /**
+     * Get recent B2B signals.
+     */
+    recentSignals(options?: RecentSignalsOptions): Promise<{
+        json: RecentSignalsResponse;
+        rateLimit: RateLimitInfo;
+    }>;
+    /**
+     * Semantic search for signals using natural language.
+     *
+     * @param query - Natural language search query
+     * @param options - Search options
+     *
+     * @example
+     * ```typescript
+     * const { json } = await client.search('AI startups in healthcare', { limit: 10 });
+     * for (const item of json.items) {
+     *   console.log(`${item.domain}: similarity=${item.similarity.toFixed(2)}`);
+     * }
+     * ```
+     */
+    search(query: string, options?: SemanticSearchOptions): Promise<{
+        json: SemanticSearchResponse;
+        rateLimit: RateLimitInfo;
+    }>;
+    /**
+     * Get full details for a specific signal.
+     */
+    signalDetail(signalId: string): Promise<{
+        json: SignalDetailResponse;
+        rateLimit: RateLimitInfo;
+    }>;
+    /**
+     * Get API usage information for your account.
+     */
+    usage(): Promise<{
+        json: AgentDataUsageResponse;
+        rateLimit: RateLimitInfo;
+    }>;
+    /**
+     * Stream new signals in real-time via SSE.
+     *
+     * @param options - Stream options
+     *
+     * @example
+     * ```typescript
+     * for await (const signal of client.stream({ minScore: 70 })) {
+     *   console.log(`New signal: ${signal.domain} (score=${signal.signalScore})`);
+     * }
+     * ```
+     *
+     * @note This is an async generator. Make sure to handle connection errors and reconnect if needed.
+     */
+    stream(options?: StreamOptions): AsyncGenerator<Signal, void, unknown>;
+    private parseSignal;
+}
+declare const PounceClient: typeof PounceAgentDataClient;
+
+export { type AgentDataRecentSignal, type AgentDataUsageResponse, PounceAgentDataClient, PounceClient, type RateLimitInfo, type RecentSignalsOptions, type RecentSignalsResponse, type SemanticSearchItem, type SemanticSearchOptions, type SemanticSearchResponse, type Signal, type SignalDetailResponse, type StreamOptions };

package/dist/index.d.ts

@@ -0,0 +1,204 @@
+/**
+ * Pounce Agent Data SDK - TypeScript Client
+ *
+ * Minimal client for the Pounce Agent Data API.
+ * Supports recent signals, semantic search, signal details, and SSE streaming.
+ *
+ * @example
+ * ```typescript
+ * import { PounceAgentDataClient } from '@pounce/agent-data';
+ *
+ * const client = new PounceAgentDataClient({ apiKey: 'pounce_live_xxx' });
+ *
+ * // Recent signals
+ * const { json, rateLimit } = await client.recentSignals({ limit: 10, category: 'saas' });
+ *
+ * // Semantic search
+ * const results = await client.search('AI companies in healthcare', { limit: 20 });
+ *
+ * // Stream new signals
+ * for await (const signal of client.stream({ minScore: 70 })) {
+ *   console.log(signal);
+ * }
+ * ```
+ */
+type RateLimitInfo = {
+    limit?: number;
+    remaining?: number;
+    resetUnix?: number;
+};
+type Signal = {
+    signalId: string;
+    domain: string;
+    companyName?: string | null;
+    category?: string | null;
+    subcategory?: string | null;
+    signalScore: number;
+    trustScore?: number | null;
+    intentTags?: string[] | null;
+    techStack?: string[] | null;
+    country?: string | null;
+    description?: string | null;
+    detectedAt?: string | null;
+    uiUrl?: string | null;
+};
+type AgentDataRecentSignal = {
+    id: number;
+    signal_id?: string;
+    domain: string;
+    tld: string;
+    title?: string | null;
+    description?: string | null;
+    h1?: string | null;
+    category?: string | null;
+    subcategory?: string | null;
+    business_type?: string | null;
+    signal_score: number;
+    signal_grade?: string | null;
+    tech_stack?: string[] | null;
+    intent_tags?: string[] | null;
+    hosting_provider?: string | null;
+    country?: string | null;
+    has_real_content: boolean;
+    scanned_at?: string | null;
+    discovered_at: string;
+    ui_url?: string | null;
+};
+type RecentSignalsResponse = {
+    items: AgentDataRecentSignal[];
+    count: number;
+    has_more?: boolean;
+};
+type SemanticSearchItem = {
+    signal_id: string;
+    domain: string;
+    company_name?: string | null;
+    category?: string | null;
+    signal_score: number;
+    similarity: number;
+    snippet?: string | null;
+    intent_tags?: string[] | null;
+    country?: string | null;
+    ui_url?: string | null;
+};
+type SemanticSearchResponse = {
+    items: SemanticSearchItem[];
+    count: number;
+    query_tokens?: number;
+};
+type SignalDetailResponse = {
+    signal_id: string;
+    domain: string;
+    company_name?: string | null;
+    category?: string | null;
+    subcategory?: string | null;
+    signal_score: number;
+    trust_score?: number | null;
+    intent_tags?: string[] | null;
+    tech_stack?: string[] | null;
+    country?: string | null;
+    description?: string | null;
+    social_links?: Record<string, string> | null;
+    detected_at?: string | null;
+    ui_url?: string | null;
+};
+type AgentDataUsageResponse = {
+    api_key_prefix: string;
+    usage: {
+        period_start: string;
+        period_end: string;
+        used: number;
+        limit: number;
+        remaining: number;
+        reset_at: string;
+    };
+};
+type RecentSignalsOptions = {
+    hours?: number;
+    limit?: number;
+    minScore?: number;
+    category?: string;
+    country?: string;
+    tlds?: string[];
+};
+type SemanticSearchOptions = {
+    limit?: number;
+    minScore?: number;
+    category?: string;
+    country?: string;
+    tlds?: string[];
+};
+type StreamOptions = {
+    minScore?: number;
+    category?: string;
+    since?: string;
+};
+declare class PounceAgentDataClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    constructor(options: {
+        apiKey: string;
+        baseUrl?: string;
+    });
+    private extractRateLimit;
+    private getJson;
+    private postJson;
+    /**
+     * Get recent B2B signals.
+     */
+    recentSignals(options?: RecentSignalsOptions): Promise<{
+        json: RecentSignalsResponse;
+        rateLimit: RateLimitInfo;
+    }>;
+    /**
+     * Semantic search for signals using natural language.
+     *
+     * @param query - Natural language search query
+     * @param options - Search options
+     *
+     * @example
+     * ```typescript
+     * const { json } = await client.search('AI startups in healthcare', { limit: 10 });
+     * for (const item of json.items) {
+     *   console.log(`${item.domain}: similarity=${item.similarity.toFixed(2)}`);
+     * }
+     * ```
+     */
+    search(query: string, options?: SemanticSearchOptions): Promise<{
+        json: SemanticSearchResponse;
+        rateLimit: RateLimitInfo;
+    }>;
+    /**
+     * Get full details for a specific signal.
+     */
+    signalDetail(signalId: string): Promise<{
+        json: SignalDetailResponse;
+        rateLimit: RateLimitInfo;
+    }>;
+    /**
+     * Get API usage information for your account.
+     */
+    usage(): Promise<{
+        json: AgentDataUsageResponse;
+        rateLimit: RateLimitInfo;
+    }>;
+    /**
+     * Stream new signals in real-time via SSE.
+     *
+     * @param options - Stream options
+     *
+     * @example
+     * ```typescript
+     * for await (const signal of client.stream({ minScore: 70 })) {
+     *   console.log(`New signal: ${signal.domain} (score=${signal.signalScore})`);
+     * }
+     * ```
+     *
+     * @note This is an async generator. Make sure to handle connection errors and reconnect if needed.
+     */
+    stream(options?: StreamOptions): AsyncGenerator<Signal, void, unknown>;
+    private parseSignal;
+}
+declare const PounceClient: typeof PounceAgentDataClient;
+
+export { type AgentDataRecentSignal, type AgentDataUsageResponse, PounceAgentDataClient, PounceClient, type RateLimitInfo, type RecentSignalsOptions, type RecentSignalsResponse, type SemanticSearchItem, type SemanticSearchOptions, type SemanticSearchResponse, type Signal, type SignalDetailResponse, type StreamOptions };

package/dist/index.js

@@ -0,0 +1,244 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  PounceAgentDataClient: () => PounceAgentDataClient,
+  PounceClient: () => PounceClient
+});
+module.exports = __toCommonJS(index_exports);
+var PounceAgentDataClient = class {
+  apiKey;
+  baseUrl;
+  constructor(options) {
+    this.apiKey = options.apiKey;
+    this.baseUrl = (options.baseUrl ?? "https://api.pounce.ch").replace(/\/$/, "");
+    if (!this.apiKey.startsWith("pounce_live_")) {
+      throw new Error("Invalid API key format (expected pounce_live_...)");
+    }
+  }
+  extractRateLimit(res) {
+    return {
+      limit: res.headers.get("X-RateLimit-Limit") ? Number(res.headers.get("X-RateLimit-Limit")) : void 0,
+      remaining: res.headers.get("X-RateLimit-Remaining") ? Number(res.headers.get("X-RateLimit-Remaining")) : void 0,
+      resetUnix: res.headers.get("X-RateLimit-Reset") ? Number(res.headers.get("X-RateLimit-Reset")) : void 0
+    };
+  }
+  async getJson(path, params) {
+    const url = new URL(this.baseUrl + path);
+    if (params) {
+      for (const [k, v] of Object.entries(params)) {
+        if (v !== void 0) url.searchParams.set(k, String(v));
+      }
+    }
+    const res = await fetch(url.toString(), {
+      method: "GET",
+      headers: {
+        Authorization: `Bearer ${this.apiKey}`,
+        Accept: "application/json"
+      }
+    });
+    const rateLimit = this.extractRateLimit(res);
+    if (!res.ok) {
+      const text = await res.text();
+      throw new Error(`HTTP ${res.status}: ${text}`);
+    }
+    const json = await res.json();
+    return { json, rateLimit };
+  }
+  async postJson(path, body) {
+    const url = new URL(this.baseUrl + path);
+    const res = await fetch(url.toString(), {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${this.apiKey}`,
+        Accept: "application/json",
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify(body)
+    });
+    const rateLimit = this.extractRateLimit(res);
+    if (!res.ok) {
+      const text = await res.text();
+      throw new Error(`HTTP ${res.status}: ${text}`);
+    }
+    const json = await res.json();
+    return { json, rateLimit };
+  }
+  // ---------------------------------------------------------------------------
+  // Public API Methods
+  // ---------------------------------------------------------------------------
+  /**
+   * Get recent B2B signals.
+   */
+  async recentSignals(options = {}) {
+    const { hours = 24, limit = 100, minScore = 50, category, country, tlds } = options;
+    return this.getJson("/api/v1/agent-data/recent", {
+      hours,
+      limit,
+      min_score: minScore,
+      category,
+      country,
+      tlds: tlds?.join(",")
+    });
+  }
+  /**
+   * Semantic search for signals using natural language.
+   *
+   * @param query - Natural language search query
+   * @param options - Search options
+   *
+   * @example
+   * ```typescript
+   * const { json } = await client.search('AI startups in healthcare', { limit: 10 });
+   * for (const item of json.items) {
+   *   console.log(`${item.domain}: similarity=${item.similarity.toFixed(2)}`);
+   * }
+   * ```
+   */
+  async search(query, options = {}) {
+    const { limit = 20, minScore = 50, category, country, tlds } = options;
+    const body = {
+      query,
+      limit,
+      min_score: minScore
+    };
+    const filters = {};
+    if (category) filters.category = category;
+    if (country) filters.country = country;
+    if (tlds) filters.tlds = tlds;
+    if (Object.keys(filters).length > 0) body.filters = filters;
+    return this.postJson(
+      "/api/v1/agent-data/search/semantic",
+      body
+    );
+  }
+  /**
+   * Get full details for a specific signal.
+   */
+  async signalDetail(signalId) {
+    return this.getJson(
+      `/api/v1/agent-data/signals/${encodeURIComponent(signalId)}`
+    );
+  }
+  /**
+   * Get API usage information for your account.
+   */
+  async usage() {
+    return this.getJson("/api/v1/agent-data/usage");
+  }
+  /**
+   * Stream new signals in real-time via SSE.
+   *
+   * @param options - Stream options
+   *
+   * @example
+   * ```typescript
+   * for await (const signal of client.stream({ minScore: 70 })) {
+   *   console.log(`New signal: ${signal.domain} (score=${signal.signalScore})`);
+   * }
+   * ```
+   *
+   * @note This is an async generator. Make sure to handle connection errors and reconnect if needed.
+   */
+  async *stream(options = {}) {
+    const { minScore = 50, category, since } = options;
+    const url = new URL(`${this.baseUrl}/api/v1/agent-data/streams/signals`);
+    url.searchParams.set("min_score", String(minScore));
+    if (category) url.searchParams.set("category", category);
+    if (since) url.searchParams.set("since", since);
+    const res = await fetch(url.toString(), {
+      method: "GET",
+      headers: {
+        Authorization: `Bearer ${this.apiKey}`,
+        Accept: "text/event-stream"
+      }
+    });
+    if (!res.ok) {
+      const text = await res.text();
+      throw new Error(`HTTP ${res.status}: ${text}`);
+    }
+    if (!res.body) {
+      throw new Error("Response body is null");
+    }
+    const reader = res.body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = "";
+    let eventType = null;
+    let dataBuffer = [];
+    try {
+      while (true) {
+        const { done, value } = await reader.read();
+        if (done) break;
+        buffer += decoder.decode(value, { stream: true });
+        const lines = buffer.split("\n");
+        buffer = lines.pop() ?? "";
+        for (const line of lines) {
+          const trimmed = line.replace(/\r$/, "");
+          if (!trimmed) {
+            if (eventType === "signal" && dataBuffer.length > 0) {
+              try {
+                const rawData = dataBuffer.join("\n");
+                const parsed = JSON.parse(rawData);
+                yield this.parseSignal(parsed);
+              } catch {
+              }
+            }
+            eventType = null;
+            dataBuffer = [];
+            continue;
+          }
+          if (trimmed.startsWith(":")) {
+            continue;
+          }
+          if (trimmed.startsWith("event:")) {
+            eventType = trimmed.slice(6).trim();
+          } else if (trimmed.startsWith("data:")) {
+            dataBuffer.push(trimmed.slice(5).trim());
+          }
+        }
+      }
+    } finally {
+      reader.releaseLock();
+    }
+  }
+  parseSignal(raw) {
+    return {
+      signalId: raw.signal_id ?? String(raw.id),
+      domain: raw.domain,
+      companyName: raw.title,
+      category: raw.category,
+      subcategory: raw.subcategory,
+      signalScore: raw.signal_score,
+      intentTags: raw.intent_tags,
+      techStack: raw.tech_stack,
+      country: raw.country,
+      description: raw.description,
+      detectedAt: raw.discovered_at ?? raw.scanned_at,
+      uiUrl: raw.ui_url
+    };
+  }
+};
+var PounceClient = PounceAgentDataClient;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PounceAgentDataClient,
+  PounceClient
+});

package/dist/index.mjs

@@ -0,0 +1,218 @@
+// src/index.ts
+var PounceAgentDataClient = class {
+  apiKey;
+  baseUrl;
+  constructor(options) {
+    this.apiKey = options.apiKey;
+    this.baseUrl = (options.baseUrl ?? "https://api.pounce.ch").replace(/\/$/, "");
+    if (!this.apiKey.startsWith("pounce_live_")) {
+      throw new Error("Invalid API key format (expected pounce_live_...)");
+    }
+  }
+  extractRateLimit(res) {
+    return {
+      limit: res.headers.get("X-RateLimit-Limit") ? Number(res.headers.get("X-RateLimit-Limit")) : void 0,
+      remaining: res.headers.get("X-RateLimit-Remaining") ? Number(res.headers.get("X-RateLimit-Remaining")) : void 0,
+      resetUnix: res.headers.get("X-RateLimit-Reset") ? Number(res.headers.get("X-RateLimit-Reset")) : void 0
+    };
+  }
+  async getJson(path, params) {
+    const url = new URL(this.baseUrl + path);
+    if (params) {
+      for (const [k, v] of Object.entries(params)) {
+        if (v !== void 0) url.searchParams.set(k, String(v));
+      }
+    }
+    const res = await fetch(url.toString(), {
+      method: "GET",
+      headers: {
+        Authorization: `Bearer ${this.apiKey}`,
+        Accept: "application/json"
+      }
+    });
+    const rateLimit = this.extractRateLimit(res);
+    if (!res.ok) {
+      const text = await res.text();
+      throw new Error(`HTTP ${res.status}: ${text}`);
+    }
+    const json = await res.json();
+    return { json, rateLimit };
+  }
+  async postJson(path, body) {
+    const url = new URL(this.baseUrl + path);
+    const res = await fetch(url.toString(), {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${this.apiKey}`,
+        Accept: "application/json",
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify(body)
+    });
+    const rateLimit = this.extractRateLimit(res);
+    if (!res.ok) {
+      const text = await res.text();
+      throw new Error(`HTTP ${res.status}: ${text}`);
+    }
+    const json = await res.json();
+    return { json, rateLimit };
+  }
+  // ---------------------------------------------------------------------------
+  // Public API Methods
+  // ---------------------------------------------------------------------------
+  /**
+   * Get recent B2B signals.
+   */
+  async recentSignals(options = {}) {
+    const { hours = 24, limit = 100, minScore = 50, category, country, tlds } = options;
+    return this.getJson("/api/v1/agent-data/recent", {
+      hours,
+      limit,
+      min_score: minScore,
+      category,
+      country,
+      tlds: tlds?.join(",")
+    });
+  }
+  /**
+   * Semantic search for signals using natural language.
+   *
+   * @param query - Natural language search query
+   * @param options - Search options
+   *
+   * @example
+   * ```typescript
+   * const { json } = await client.search('AI startups in healthcare', { limit: 10 });
+   * for (const item of json.items) {
+   *   console.log(`${item.domain}: similarity=${item.similarity.toFixed(2)}`);
+   * }
+   * ```
+   */
+  async search(query, options = {}) {
+    const { limit = 20, minScore = 50, category, country, tlds } = options;
+    const body = {
+      query,
+      limit,
+      min_score: minScore
+    };
+    const filters = {};
+    if (category) filters.category = category;
+    if (country) filters.country = country;
+    if (tlds) filters.tlds = tlds;
+    if (Object.keys(filters).length > 0) body.filters = filters;
+    return this.postJson(
+      "/api/v1/agent-data/search/semantic",
+      body
+    );
+  }
+  /**
+   * Get full details for a specific signal.
+   */
+  async signalDetail(signalId) {
+    return this.getJson(
+      `/api/v1/agent-data/signals/${encodeURIComponent(signalId)}`
+    );
+  }
+  /**
+   * Get API usage information for your account.
+   */
+  async usage() {
+    return this.getJson("/api/v1/agent-data/usage");
+  }
+  /**
+   * Stream new signals in real-time via SSE.
+   *
+   * @param options - Stream options
+   *
+   * @example
+   * ```typescript
+   * for await (const signal of client.stream({ minScore: 70 })) {
+   *   console.log(`New signal: ${signal.domain} (score=${signal.signalScore})`);
+   * }
+   * ```
+   *
+   * @note This is an async generator. Make sure to handle connection errors and reconnect if needed.
+   */
+  async *stream(options = {}) {
+    const { minScore = 50, category, since } = options;
+    const url = new URL(`${this.baseUrl}/api/v1/agent-data/streams/signals`);
+    url.searchParams.set("min_score", String(minScore));
+    if (category) url.searchParams.set("category", category);
+    if (since) url.searchParams.set("since", since);
+    const res = await fetch(url.toString(), {
+      method: "GET",
+      headers: {
+        Authorization: `Bearer ${this.apiKey}`,
+        Accept: "text/event-stream"
+      }
+    });
+    if (!res.ok) {
+      const text = await res.text();
+      throw new Error(`HTTP ${res.status}: ${text}`);
+    }
+    if (!res.body) {
+      throw new Error("Response body is null");
+    }
+    const reader = res.body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = "";
+    let eventType = null;
+    let dataBuffer = [];
+    try {
+      while (true) {
+        const { done, value } = await reader.read();
+        if (done) break;
+        buffer += decoder.decode(value, { stream: true });
+        const lines = buffer.split("\n");
+        buffer = lines.pop() ?? "";
+        for (const line of lines) {
+          const trimmed = line.replace(/\r$/, "");
+          if (!trimmed) {
+            if (eventType === "signal" && dataBuffer.length > 0) {
+              try {
+                const rawData = dataBuffer.join("\n");
+                const parsed = JSON.parse(rawData);
+                yield this.parseSignal(parsed);
+              } catch {
+              }
+            }
+            eventType = null;
+            dataBuffer = [];
+            continue;
+          }
+          if (trimmed.startsWith(":")) {
+            continue;
+          }
+          if (trimmed.startsWith("event:")) {
+            eventType = trimmed.slice(6).trim();
+          } else if (trimmed.startsWith("data:")) {
+            dataBuffer.push(trimmed.slice(5).trim());
+          }
+        }
+      }
+    } finally {
+      reader.releaseLock();
+    }
+  }
+  parseSignal(raw) {
+    return {
+      signalId: raw.signal_id ?? String(raw.id),
+      domain: raw.domain,
+      companyName: raw.title,
+      category: raw.category,
+      subcategory: raw.subcategory,
+      signalScore: raw.signal_score,
+      intentTags: raw.intent_tags,
+      techStack: raw.tech_stack,
+      country: raw.country,
+      description: raw.description,
+      detectedAt: raw.discovered_at ?? raw.scanned_at,
+      uiUrl: raw.ui_url
+    };
+  }
+};
+var PounceClient = PounceAgentDataClient;
+export {
+  PounceAgentDataClient,
+  PounceClient
+};

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "pounce-agent-data",
+  "version": "1.0.0",
+  "description": "TypeScript SDK for the Pounce Agent Data API - B2B company signals for AI agents",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "pounce",
+    "b2b",
+    "signals",
+    "ai",
+    "agents",
+    "api",
+    "sdk"
+  ],
+  "author": "Pounce Signal Intelligence <hello@pounce.ch>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://gitlab.pounce.ch/pounce/pounce.git",
+    "directory": "sdk/ts"
+  },
+  "homepage": "https://pounce.ch/developers",
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}