@stack0/sdk 0.5.11 → 0.5.14

package/dist/index.js

@@ -84,6 +84,7 @@ var Audiences = class {
   constructor(http) {
     this.http = http;
   }
+  http;
   /**
    * List all audiences
    */
@@ -158,6 +159,7 @@ var Campaigns = class {
   constructor(http) {
     this.http = http;
   }
+  http;
   /**
    * List all campaigns
    */
@@ -234,6 +236,7 @@ var Contacts = class {
   constructor(http) {
     this.http = http;
   }
+  http;
   /**
    * List all contacts
    */
@@ -285,6 +288,7 @@ var Domains = class {
   constructor(http) {
     this.http = http;
   }
+  http;
   /**
    * List all domains for the organization
    */
@@ -331,6 +335,7 @@ var Events = class {
   constructor(http) {
     this.http = http;
   }
+  http;
   // ============================================================================
   // EVENT DEFINITIONS
   // ============================================================================
@@ -425,6 +430,7 @@ var Mailboxes = class {
   constructor(http) {
     this.http = http;
   }
+  http;
   /**
    * Create a new mailbox
    */
@@ -488,6 +494,7 @@ var Sequences = class {
   constructor(http) {
     this.http = http;
   }
+  http;
   // ============================================================================
   // SEQUENCE CRUD
   // ============================================================================
@@ -659,6 +666,7 @@ var Sequences = class {
     if (params.limit) searchParams.set("limit", params.limit.toString());
     if (params.offset) searchParams.set("offset", params.offset.toString());
     if (params.status) searchParams.set("status", params.status);
+    if (params.search) searchParams.set("search", params.search);
     const query = searchParams.toString();
     return this.http.get(`/mail/sequences/${id}/entries${query ? `?${query}` : ""}`);
   }
@@ -695,6 +703,7 @@ var Templates = class {
   constructor(http) {
     this.http = http;
   }
+  http;
   /**
    * List all templates
    */
@@ -797,6 +806,43 @@ var Mail = class {
   async send(request) {
     return this.http.post("/mail/send", request);
   }
+  /**
+   * Reply to an inbound email with correct RFC 5322 threading headers.
+   * Automatically derives `from`, `to`, `subject`, `inReplyTo`, and `references`
+   * from the inbound webhook payload — pass through any overrides as the second
+   * argument.
+   *
+   * @example
+   * ```typescript
+   * // In your webhook handler:
+   * await mail.reply(inboundEmail, {
+   *   text: 'Thanks for the note — talk soon.',
+   * });
+   * ```
+   */
+  async reply(inbound, body) {
+    const parentId = inbound.messageId;
+    const refs = [...inbound.references ?? [], parentId].filter(Boolean);
+    const subject = body.subject ?? (inbound.subject?.startsWith("Re:") ? inbound.subject : `Re: ${inbound.subject ?? ""}`);
+    const request = {
+      from: body.from ?? inbound.mailbox,
+      to: body.to ?? inbound.from.email,
+      subject,
+      text: body.text,
+      html: body.html,
+      replyTo: body.replyTo,
+      cc: body.cc,
+      bcc: body.bcc,
+      tags: body.tags,
+      metadata: body.metadata,
+      templateId: body.templateId,
+      templateVariables: body.templateVariables,
+      environment: body.environment,
+      inReplyTo: body.inReplyTo ?? parentId ?? void 0,
+      references: body.references ?? (refs.length ? refs.join(" ") : void 0)
+    };
+    return this.send(request);
+  }
   /**
    * Send multiple emails in a batch (up to 100)
    * Each email can have different content and recipients
@@ -1303,6 +1349,22 @@ var CDN = class {
    * });
    * console.log(`Job started: ${job.id}`);
    * ```
+   *
+   * @example Burn in a logo watermark (same config shape as image watermarks)
+   * ```typescript
+   * const job = await cdn.transcode({
+   *   projectSlug: 'my-project',
+   *   assetId: 'video-asset-id',
+   *   outputFormat: 'mp4',
+   *   variants: [{ quality: '1080p', codec: 'h264' }],
+   *   watermark: {
+   *     assetId: 'logo-asset-id',
+   *     position: 'bottom-right',
+   *     scale: 15,       // 15% of the video width
+   *     opacity: 80,
+   *   },
+   * });
+   * ```
    */
   async transcode(request) {
     const response = await this.http.post("/cdn/video/transcode", request);
@@ -3669,6 +3731,232 @@ var Webdata = class {
   }
 };
 
+// src/crawl/client.ts
+var Crawl$ = class {
+  http;
+  constructor(config) {
+    this.http = new HttpClient(config);
+  }
+  /**
+   * Start a crawl.
+   *
+   * @example
+   * ```typescript
+   * const { id } = await stack0.crawl.start({
+   *   url: 'https://docs.example.com',
+   *   maxDepth: 3,
+   *   maxPages: 200,
+   *   formats: ['markdown', 'links'],
+   * });
+   * ```
+   */
+  async start(request) {
+    return this.http.post("/webdata/crawl", request);
+  }
+  /**
+   * Get a crawl by ID. Pass `includePages: true` to include the scraped pages.
+   */
+  async get(request) {
+    const params = new URLSearchParams();
+    if (request.environment) params.set("environment", request.environment);
+    if (request.projectId) params.set("projectId", request.projectId);
+    if (request.includePages) params.set("includePages", "true");
+    const query = params.toString();
+    return this.http.get(`/webdata/crawl/${request.id}${query ? `?${query}` : ""}`);
+  }
+  async list(request = {}) {
+    const params = new URLSearchParams();
+    if (request.environment) params.set("environment", request.environment);
+    if (request.projectId) params.set("projectId", request.projectId);
+    if (request.status) params.set("status", request.status);
+    if (request.url) params.set("url", request.url);
+    if (request.limit) params.set("limit", String(request.limit));
+    if (request.cursor) params.set("cursor", request.cursor);
+    const query = params.toString();
+    return this.http.get(`/webdata/crawl${query ? `?${query}` : ""}`);
+  }
+  async listPages(request) {
+    const params = new URLSearchParams();
+    if (request.environment) params.set("environment", request.environment);
+    if (request.projectId) params.set("projectId", request.projectId);
+    if (request.limit) params.set("limit", String(request.limit));
+    if (request.cursor) params.set("cursor", request.cursor);
+    const query = params.toString();
+    return this.http.get(
+      `/webdata/crawl/${request.crawlId}/pages${query ? `?${query}` : ""}`
+    );
+  }
+  async cancel(request) {
+    return this.http.post(`/webdata/crawl/${request.id}/cancel`, {
+      environment: request.environment,
+      projectId: request.projectId
+    });
+  }
+  async delete(request) {
+    const params = new URLSearchParams();
+    if (request.environment) params.set("environment", request.environment);
+    if (request.projectId) params.set("projectId", request.projectId);
+    const query = params.toString();
+    return this.http.deleteWithBody(
+      `/webdata/crawl/${request.id}${query ? `?${query}` : ""}`,
+      request
+    );
+  }
+  /**
+   * Start a crawl and poll until it completes. Returns the full Crawl record
+   * with pages included.
+   */
+  async startAndWait(request, options = {}) {
+    const { pollInterval = 2e3, timeout = 6e5, includePages = true } = options;
+    const { id } = await this.start(request);
+    const start = Date.now();
+    while (Date.now() - start < timeout) {
+      const crawl = await this.get({
+        id,
+        environment: request.environment,
+        projectId: request.projectId,
+        includePages
+      });
+      if (crawl.status === "completed" || crawl.status === "failed" || crawl.status === "cancelled") {
+        if (crawl.status === "failed") throw new Error(crawl.error || "Crawl failed");
+        return crawl;
+      }
+      await new Promise((r) => setTimeout(r, pollInterval));
+    }
+    throw new Error("Crawl timed out");
+  }
+};
+
+// src/map/client.ts
+var Map$ = class {
+  http;
+  constructor(config) {
+    this.http = new HttpClient(config);
+  }
+  /**
+   * Start a map job.
+   *
+   * @example
+   * ```typescript
+   * const { id } = await stack0.map.create({
+   *   url: 'https://docs.example.com',
+   *   search: 'api',
+   *   limit: 1000,
+   * });
+   * ```
+   */
+  async create(request) {
+    return this.http.post("/webdata/map", request);
+  }
+  async get(request) {
+    const params = new URLSearchParams();
+    if (request.environment) params.set("environment", request.environment);
+    if (request.projectId) params.set("projectId", request.projectId);
+    const query = params.toString();
+    return this.http.get(`/webdata/map/${request.id}${query ? `?${query}` : ""}`);
+  }
+  async list(request = {}) {
+    const params = new URLSearchParams();
+    if (request.environment) params.set("environment", request.environment);
+    if (request.projectId) params.set("projectId", request.projectId);
+    if (request.status) params.set("status", request.status);
+    if (request.limit) params.set("limit", String(request.limit));
+    if (request.cursor) params.set("cursor", request.cursor);
+    const query = params.toString();
+    return this.http.get(`/webdata/map${query ? `?${query}` : ""}`);
+  }
+  async delete(request) {
+    const params = new URLSearchParams();
+    if (request.environment) params.set("environment", request.environment);
+    if (request.projectId) params.set("projectId", request.projectId);
+    const query = params.toString();
+    return this.http.deleteWithBody(
+      `/webdata/map/${request.id}${query ? `?${query}` : ""}`,
+      request
+    );
+  }
+  /**
+   * Create a map job and poll until it completes. Maps usually finish in
+   * seconds, so default timeout is generous.
+   */
+  async createAndWait(request, options = {}) {
+    const { pollInterval = 1e3, timeout = 12e4 } = options;
+    const { id } = await this.create(request);
+    const start = Date.now();
+    while (Date.now() - start < timeout) {
+      const result = await this.get({ id, environment: request.environment, projectId: request.projectId });
+      if (result.status === "completed" || result.status === "failed") {
+        if (result.status === "failed") throw new Error(result.error || "Map failed");
+        return result;
+      }
+      await new Promise((r) => setTimeout(r, pollInterval));
+    }
+    throw new Error("Map timed out");
+  }
+};
+
+// src/documents/client.ts
+var Documents = class {
+  http;
+  constructor(config) {
+    this.http = new HttpClient(config);
+  }
+  /**
+   * Parse a document from a URL or a previously-uploaded file URL.
+   *
+   * @example
+   * ```typescript
+   * const { id } = await stack0.documents.parse({
+   *   url: 'https://example.com/whitepaper.pdf',
+   * });
+   * ```
+   */
+  async parse(request) {
+    return this.http.post("/webdata/documents", request);
+  }
+  async get(request) {
+    const params = new URLSearchParams();
+    if (request.environment) params.set("environment", request.environment);
+    if (request.projectId) params.set("projectId", request.projectId);
+    const q = params.toString();
+    return this.http.get(`/webdata/documents/${request.id}${q ? `?${q}` : ""}`);
+  }
+  async list(request = {}) {
+    const params = new URLSearchParams();
+    if (request.environment) params.set("environment", request.environment);
+    if (request.projectId) params.set("projectId", request.projectId);
+    if (request.status) params.set("status", request.status);
+    if (request.limit) params.set("limit", String(request.limit));
+    if (request.cursor) params.set("cursor", request.cursor);
+    const q = params.toString();
+    return this.http.get(`/webdata/documents${q ? `?${q}` : ""}`);
+  }
+  async delete(request) {
+    const params = new URLSearchParams();
+    if (request.environment) params.set("environment", request.environment);
+    if (request.projectId) params.set("projectId", request.projectId);
+    const q = params.toString();
+    return this.http.deleteWithBody(
+      `/webdata/documents/${request.id}${q ? `?${q}` : ""}`,
+      request
+    );
+  }
+  async parseAndWait(request, options = {}) {
+    const { pollInterval = 2e3, timeout = 18e4 } = options;
+    const { id } = await this.parse(request);
+    const start = Date.now();
+    while (Date.now() - start < timeout) {
+      const doc = await this.get({ id, environment: request.environment, projectId: request.projectId });
+      if (doc.status === "completed" || doc.status === "failed") {
+        if (doc.status === "failed") throw new Error(doc.error || "Document parsing failed");
+        return doc;
+      }
+      await new Promise((r) => setTimeout(r, pollInterval));
+    }
+    throw new Error("Document parsing timed out");
+  }
+};
+
 // src/integrations/client.ts
 var CRM = class {
   http;
@@ -5273,281 +5561,19 @@ var Workflows = class {
   }
 };
 
-// src/memory/agents.ts
-var MemoryAgents = class {
-  constructor(http) {
-    this.http = http;
-  }
-  /**
-   * Create a new memory agent
-   */
-  async create(request) {
-    return this.http.post("/memory/agents", request);
-  }
-  /**
-   * List all memory agents
-   */
-  async list(params = {}) {
-    const qs = new URLSearchParams();
-    if (params.environment) qs.set("environment", params.environment);
-    const q = qs.toString();
-    return this.http.get(`/memory/agents${q ? `?${q}` : ""}`);
-  }
-  /**
-   * Get a memory agent by ID
-   */
-  async get(agentId) {
-    return this.http.get(`/memory/agents/${agentId}`);
-  }
-  /**
-   * Update a memory agent
-   */
-  async update(agentId, request) {
-    return this.http.patch(`/memory/agents/${agentId}`, request);
-  }
-  /**
-   * Delete a memory agent
-   */
-  async delete(agentId) {
-    return this.http.delete(`/memory/agents/${agentId}`);
-  }
-};
-
-// src/memory/collections.ts
-var MemoryCollections = class {
-  constructor(http) {
-    this.http = http;
-  }
-  /**
-   * Create a new collection for an agent
-   */
-  async create(request) {
-    return this.http.post(`/memory/agents/${request.agentId}/collections`, {
-      name: request.name,
-      slug: request.slug,
-      description: request.description,
-      compaction: request.compaction,
-      retention: request.retention
-    });
-  }
-  /**
-   * List all collections for an agent
-   */
-  async list(agentId) {
-    return this.http.get(`/memory/agents/${agentId}/collections`);
-  }
-  /**
-   * Get a collection by slug
-   */
-  async get(agentId, collectionSlug) {
-    return this.http.get(`/memory/agents/${agentId}/collections/${collectionSlug}`);
-  }
-  /**
-   * Update a collection
-   */
-  async update(agentId, collectionSlug, request) {
-    return this.http.patch(
-      `/memory/agents/${agentId}/collections/${collectionSlug}`,
-      request
-    );
-  }
-  /**
-   * Delete a collection
-   */
-  async delete(agentId, collectionSlug) {
-    return this.http.delete(`/memory/agents/${agentId}/collections/${collectionSlug}`);
-  }
-  /**
-   * Get collection statistics
-   */
-  async stats(agentId, collectionSlug) {
-    return this.http.get(
-      `/memory/agents/${agentId}/collections/${collectionSlug}/stats`
-    );
-  }
-  /**
-   * Trigger compaction for a collection
-   */
-  async compact(agentId, collectionSlug, request = {}) {
-    return this.http.post(
-      `/memory/agents/${agentId}/collections/${collectionSlug}/compact`,
-      request
-    );
-  }
-  /**
-   * Get a compaction job by ID
-   */
-  async getCompactionJob(agentId, collectionSlug, jobId) {
-    return this.http.get(
-      `/memory/agents/${agentId}/collections/${collectionSlug}/compact/${jobId}`
-    );
-  }
-};
-
-// src/memory/entities.ts
-var MemoryEntities = class {
-  constructor(http) {
-    this.http = http;
-  }
-  async list(params) {
-    const qs = new URLSearchParams();
-    qs.set("agentId", params.agentId);
-    if (params.type) qs.set("type", params.type);
-    if (params.limit) qs.set("limit", params.limit.toString());
-    if (params.offset) qs.set("offset", params.offset.toString());
-    const q = qs.toString();
-    return this.http.get(`/memory/entities${q ? `?${q}` : ""}`);
-  }
-  async get(entityId) {
-    return this.http.get(`/memory/entities/${entityId}`);
-  }
-  async getRelations(entityId) {
-    return this.http.get(`/memory/entities/${entityId}/relations`);
-  }
-};
-
-// src/memory/client.ts
-var Memory = class {
-  http;
-  /** Manage memory agents */
-  agents;
-  /** Manage memory collections */
-  collections;
-  /** Manage extracted entities */
-  entities;
-  constructor(config) {
-    this.http = new HttpClient(config);
-    this.agents = new MemoryAgents(this.http);
-    this.collections = new MemoryCollections(this.http);
-    this.entities = new MemoryEntities(this.http);
-  }
-  // ============================================================================
-  // MEMORY OPERATIONS
-  // ============================================================================
-  /**
-   * Store a memory
-   *
-   * @example
-   * ```typescript
-   * const memory = await stack0.memory.store({
-   *   agentId: 'agent_123',
-   *   content: 'User prefers dark mode',
-   *   type: 'preference',
-   *   tags: ['ui', 'settings'],
-   * });
-   * ```
-   */
-  async store(request) {
-    return this.http.post("/memory/memories", request);
-  }
-  /**
-   * Store multiple memories in a batch
-   *
-   * @example
-   * ```typescript
-   * const results = await stack0.memory.storeBatch({
-   *   agentId: 'agent_123',
-   *   memories: [
-   *     { content: 'User prefers dark mode', type: 'preference' },
-   *     { content: 'User is based in NYC', type: 'fact' },
-   *   ],
-   * });
-   * ```
-   */
-  async storeBatch(request) {
-    return this.http.post("/memory/memories/batch", request);
-  }
-  /**
-   * Recall memories using semantic search (vector similarity)
-   *
-   * @example
-   * ```typescript
-   * const results = await stack0.memory.recall({
-   *   agentId: 'agent_123',
-   *   query: 'What are the user preferences?',
-   *   limit: 10,
-   * });
-   * ```
-   */
-  async recall(request) {
-    return this.http.post("/memory/memories/recall", request);
-  }
-  /**
-   * Search memories using full-text search
-   *
-   * @example
-   * ```typescript
-   * const results = await stack0.memory.search({
-   *   agentId: 'agent_123',
-   *   query: 'dark mode',
-   *   limit: 20,
-   * });
-   * ```
-   */
-  async search(request) {
-    return this.http.post("/memory/memories/search", request);
-  }
-  /**
-   * Get a memory by ID
-   */
-  async get(memoryId) {
-    return this.http.get(`/memory/memories/${memoryId}`);
-  }
-  /**
-   * List memories with optional filters
-   *
-   * @example
-   * ```typescript
-   * const memories = await stack0.memory.list({
-   *   agentId: 'agent_123',
-   *   type: 'preference',
-   *   limit: 50,
-   * });
-   * ```
-   */
-  async list(params) {
-    const qs = new URLSearchParams();
-    qs.set("agentId", params.agentId);
-    if (params.collectionSlug) qs.set("collectionSlug", params.collectionSlug);
-    if (params.type) qs.set("type", params.type);
-    if (params.tier) qs.set("tier", params.tier);
-    if (params.limit) qs.set("limit", params.limit.toString());
-    if (params.offset) qs.set("offset", params.offset.toString());
-    if (params.sortBy) qs.set("sortBy", params.sortBy);
-    if (params.sortOrder) qs.set("sortOrder", params.sortOrder);
-    const q = qs.toString();
-    return this.http.get(`/memory/memories${q ? `?${q}` : ""}`);
-  }
-  /**
-   * Update a memory
-   */
-  async update(memoryId, request) {
-    return this.http.patch(`/memory/memories/${memoryId}`, request);
-  }
-  /**
-   * Delete a memory by ID
-   */
-  async delete(memoryId) {
-    return this.http.delete(`/memory/memories/${memoryId}`);
-  }
-  /**
-   * Delete multiple memories
-   */
-  async deleteMany(request) {
-    return this.http.deleteWithBody("/memory/memories", request);
-  }
-};
-
 // src/index.ts
 var Stack0 = class {
+  http;
   mail;
   cdn;
   screenshots;
   extraction;
+  crawl;
+  map;
+  documents;
   integrations;
   marketing;
   workflows;
-  memory;
   /**
    * @deprecated Use `screenshots` and `extraction` instead. Will be removed in a future version.
    */
@@ -5557,16 +5583,41 @@ var Stack0 = class {
       apiKey: config.apiKey,
       baseUrl: config.baseUrl
     };
+    this.http = new HttpClient(clientConfig);
     this.mail = new Mail(clientConfig);
     this.cdn = new CDN(clientConfig, config.cdnUrl);
     this.screenshots = new Screenshots(clientConfig);
     this.extraction = new Extraction(clientConfig);
+    this.crawl = new Crawl$(clientConfig);
+    this.map = new Map$(clientConfig);
+    this.documents = new Documents(clientConfig);
     this.integrations = new Integrations(clientConfig);
     this.marketing = new Marketing(clientConfig);
     this.workflows = new Workflows(clientConfig);
-    this.memory = new Memory(clientConfig);
     this.webdata = new Webdata(clientConfig);
   }
+  // ============================================================================
+  // PROJECTS
+  // ============================================================================
+  async listProjects() {
+    return this.http.get("/projects");
+  }
+  async getProject(id) {
+    return this.http.get(`/projects/${id}`);
+  }
+  async getProjectBySlug(slug) {
+    return this.http.get(`/projects/by-slug/${slug}`);
+  }
+  async createProject(request) {
+    return this.http.post("/projects", request);
+  }
+  async updateProject(request) {
+    const { id, ...data } = request;
+    return this.http.patch(`/projects/${id}`, data);
+  }
+  async deleteProject(id) {
+    return this.http.delete(`/projects/${id}`);
+  }
 };
 var src_default = Stack0;
 
@@ -5574,17 +5625,18 @@ exports.Audiences = Audiences;
 exports.CDN = CDN;
 exports.Campaigns = Campaigns;
 exports.Contacts = Contacts;
+exports.Crawl = Crawl$;
+exports.Crawl$ = Crawl$;
+exports.Documents = Documents;
 exports.Domains = Domains;
 exports.Events = Events;
 exports.Extraction = Extraction;
 exports.Integrations = Integrations;
 exports.Mail = Mail;
 exports.Mailboxes = Mailboxes;
+exports.Map = Map$;
+exports.Map$ = Map$;
 exports.Marketing = Marketing;
-exports.Memory = Memory;
-exports.MemoryAgents = MemoryAgents;
-exports.MemoryCollections = MemoryCollections;
-exports.MemoryEntities = MemoryEntities;
 exports.Screenshots = Screenshots;
 exports.Sequences = Sequences;
 exports.Stack0 = Stack0;