@getopencrawl/sdk 0.0.0-stage → 0.2.1

package/dist/customers.js

@@ -0,0 +1,286 @@
+import { OpenCrawlAPIError, OpenCrawlProtocolError, OpenCrawlTimeoutError, OpenCrawlValidationError } from './errors.js';
+const CUSTOMER_ID = /^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/;
+const CADENCE = { hour: 60, day: 1440, week: 10080 };
+const ACTIVE = new Set(['queued', 'running']);
+const encoder = new TextEncoder();
+/** Process-local key cache. Lost keys are recovered by rotation, so this is safe for
+ * a single process; with several processes use a shared KeyStore. */
+export function memoryKeyStore() { const keys = new Map(); return { get: id => keys.get(id), set: (id, key) => { keys.set(id, key); } }; }
+async function digest(value) { return Array.from(new Uint8Array(await crypto.subtle.digest('SHA-256', encoder.encode(value))), b => b.toString(16).padStart(2, '0')).join(''); }
+function randomKey() { return crypto.randomUUID().replace(/-/g, ''); }
+function clip(value, max) { const chars = Array.from(value.replace(/\s+/g, ' ').trim()); return chars.length > max ? chars.slice(0, max - 1).join('') + '…' : chars.join(''); }
+function publicUrl(value) { if (typeof value !== 'string' || value.length > 2048)
+    return false; try {
+    const url = new URL(value);
+    return url.protocol === 'https:' || url.protocol === 'http:';
+}
+catch {
+    return false;
+} }
+function unauthorized(error) { return error instanceof OpenCrawlAPIError && error.status === 401; }
+function cadence(minutes) { return Object.keys(CADENCE).find(k => CADENCE[k] === minutes) ?? minutes; }
+function cursorOf(signal) { return `${signal.observedAt}|${signal.id}`; }
+function after(position, cursor) { if (!cursor)
+    return true; const [at, id = ''] = cursor.split('|'); return position.observed_at > at || position.observed_at === at && position.id > id; }
+/** Deterministic description of one change for a feed or an agent. Prefers a
+ * server-generated headline when the observation carries one. */
+export function signalHeadline(event) {
+    if (typeof event.change_summary?.headline === 'string' && event.change_summary.headline)
+        return event.change_summary.headline;
+    let host = event.url;
+    try {
+        host = new URL(event.url).host.replace(/^www\./, '');
+    }
+    catch { }
+    if (event.kind === 'unavailable')
+        return `${host}: page could not be checked`;
+    if (event.kind === 'recovered')
+        return `${host}: page available again`;
+    const hunk = (event.change_summary?.changes ?? []).find(h => !h.volatile);
+    if (hunk) {
+        const added = hunk.added[0], removed = hunk.removed[0];
+        if (added && removed)
+            return `${host}: “${clip(removed, 70)}” → “${clip(added, 70)}”`;
+        if (added)
+            return `${host}: new “${clip(added, 120)}”`;
+        if (removed)
+            return `${host}: removed “${clip(removed, 120)}”`;
+    }
+    const added = event.change_summary?.added?.[0];
+    return added ? `${host}: changed “${clip(added, 120)}”` : `${host}: page changed`;
+}
+function toSignal(event, watch) {
+    const summary = event.change_summary;
+    const hunks = summary.changes;
+    return { id: event.id, watchId: watch.id, watchName: watch.name, url: event.url, kind: event.kind, observedAt: event.observed_at, previousObservedAt: event.previous_observed_at,
+        headline: signalHeadline(event), relevance: summary.relevance ?? null, relevanceReason: summary.relevance_reason ?? null,
+        changes: hunks ? hunks.filter(h => !h.volatile).map(h => ({ removed: h.removed, added: h.added })) : [{ removed: summary.removed ?? [], added: summary.added ?? [] }],
+        truncated: Boolean(summary.changes_truncated ?? summary.truncated), gap: event.gap };
+}
+function toWatch(c) { return { id: c.id, name: c.name, urls: c.seed_urls, every: cadence(c.schedule_minutes), status: c.status, lastCheckedAt: c.last_checked_at, createdAt: c.created_at }; }
+function encodeAnswerId(agentId, runId) { return `${agentId}.${runId}`; }
+function decodeAnswerId(answerId) { const match = typeof answerId === 'string' ? /^(ragent_[0-9a-f]{32})\.(job_[0-9a-f]{32})$/.exec(answerId) : null; if (!match)
+    throw new OpenCrawlValidationError('Use an answerId returned by ask().'); return { agentId: match[1], runId: match[2] }; }
+function toAnswer(agent, run) {
+    return { answerId: encodeAnswerId(agent.id, run.id), question: agent.goal, status: run.status, done: !ACTIVE.has(run.status),
+        findings: run.findings.map(f => ({ claim: f.claim, qualifiers: f.qualifiers, sources: f.citations.map(c => ({ url: c.url, title: c.title, quote: c.quote, publishedAt: c.published_at })) })),
+        gaps: run.gaps, startedAt: run.created_at, finishedAt: run.finished_at };
+}
+/** One Letter customer, isolated in its own OpenCrawl workspace. */
+export class Customer {
+    id;
+    profile;
+    #client;
+    #refresh;
+    #key;
+    constructor(profile, client, key, refresh) { this.id = profile.id; this.profile = Object.freeze({ ...profile }); this.#client = client; this.#key = key; this.#refresh = refresh; }
+    /** The underlying customer-scoped client, for anything not covered here. */
+    get client() { return this.#client; }
+    async #call(work) {
+        try {
+            return await work(this.#client);
+        }
+        catch (error) {
+            if (!unauthorized(error))
+                throw error;
+            this.#client = await this.#refresh();
+            return work(this.#client);
+        }
+    }
+    /** Watch public pages for changes. Calling again with the same name, pages and
+    * cadence returns the same watch (resuming it if it was stopped). */
+    async watch(input, options = {}) {
+        if (!input || typeof input.name !== 'string' || !input.name.trim() || input.name.length > 200)
+            throw new OpenCrawlValidationError('Give the watch a name of at most 200 characters.');
+        const urls = [...new Set(input.urls ?? [])];
+        if (!urls.length || urls.length > 50 || !urls.every(publicUrl))
+            throw new OpenCrawlValidationError('Watch 1–50 public http(s) page URLs.');
+        const every = input.every ?? 'day';
+        if (!(every in CADENCE))
+            throw new OpenCrawlValidationError('every must be hour, day or week.');
+        // The brief tells OpenCrawl what matters when it rates each change's relevance.
+        const brief = input.brief ?? clip(`Competitor and market signals for ${this.profile.name} (${this.profile.website}).${this.profile.context ? ' ' + this.profile.context : ''}`, 4000);
+        if (typeof brief !== 'string' || brief.length > 4000)
+            throw new OpenCrawlValidationError('brief must be at most 4000 characters.');
+        const key = 'watch_' + (await digest(JSON.stringify([this.id, input.name.trim(), [...urls].sort(), every, brief]))).slice(0, 48);
+        return this.#call(async (client) => {
+            const receipt = await client.collections.create({ name: input.name.trim(), brief, seed_urls: urls, page_limit: urls.length, schedule_minutes: CADENCE[every], include_media: false }, { ...options, idempotencyKey: key });
+            // A replayed receipt is the original snapshot; read the watch's current state.
+            let collection = receipt.replayed ? await client.collections.get(receipt.collection.id, options) : receipt.collection;
+            if (collection.status === 'paused')
+                collection = await client.collections.update(collection.id, { expected_revision: collection.revision, status: 'active' }, options);
+            return toWatch(collection);
+        });
+    }
+    async watches(options = {}) { return (await this.#collections(options)).map(toWatch); }
+    /** Stop checking a watch. History and earlier signals are kept. */
+    async unwatch(watchId, options = {}) {
+        return this.#call(async (client) => { const c = await client.collections.get(watchId, options); return toWatch(c.status === 'paused' ? c : await client.collections.update(c.id, { expected_revision: c.revision, status: 'paused' }, options)); });
+    }
+    async #collections(options) {
+        return this.#call(async (client) => { const all = []; let cursor; for (let page = 0; page < 20; page++) {
+            const result = await client.collections.list({ ...options, limit: 100, cursor });
+            all.push(...result.items);
+            if (!result.next_cursor)
+                break;
+            cursor = result.next_cursor;
+        } return all; });
+    }
+    /** Content changes, unavailable pages and recoveries after `since` (the cursor from the
+    * previous call), oldest first. Date-, clock- and age-only edits are left out. */
+    async signals(options = {}) {
+        const limit = options.limit ?? 50;
+        if (!Number.isSafeInteger(limit) || limit < 1 || limit > 200)
+            throw new OpenCrawlValidationError('limit must be 1–200.');
+        const since = options.since ?? null;
+        if (since !== null && (typeof since !== 'string' || since.length > 300))
+            throw new OpenCrawlValidationError('since must be a cursor returned by signals().');
+        const watches = options.watchId ? [await this.#call(client => client.collections.get(options.watchId, options))] : await this.#collections(options);
+        const found = [];
+        let more = false;
+        for (const watch of watches) {
+            let cursor;
+            pages: for (let page = 0; page < 10; page++) {
+                const result = await this.#call(client => client.collections.events(watch.id, { signal: options.signal, timeoutMs: options.timeoutMs, limit: 100, cursor, includeVolatile: false }));
+                for (const event of result.items) {
+                    if (!after(event, since))
+                        break pages;
+                    if (event.kind === 'baseline' || event.change_summary.substance === 'volatile_only')
+                        continue;
+                    found.push(toSignal(event, watch));
+                }
+                if (!result.next_cursor)
+                    break;
+                cursor = result.next_cursor;
+                if (page === 9)
+                    more = true;
+            }
+        }
+        found.sort((a, b) => a.observedAt < b.observedAt ? -1 : a.observedAt > b.observedAt ? 1 : a.id < b.id ? -1 : a.id > b.id ? 1 : 0);
+        if (found.length > limit) {
+            found.length = limit;
+            more = true;
+        }
+        return { signals: found, cursor: found.length ? cursorOf(found[found.length - 1]) : since, more };
+    }
+    /** Research a question on the public web (or on up to three named pages) and wait up
+    * to `waitMs` for cited findings. Asking the same question again reuses a recent answer. */
+    async ask(question, options = {}) {
+        if (typeof question !== 'string' || !question.trim())
+            throw new OpenCrawlValidationError('Ask a question.');
+        const urls = [...new Set(options.urls ?? [])];
+        if (urls.length > 3 || !urls.every(publicUrl))
+            throw new OpenCrawlValidationError('Name at most three public http(s) pages.');
+        const goal = urls.length ? `${question.trim()}\n\nRead these pages:\n${urls.join('\n')}\n` : question.trim();
+        if (goal.length > 4000)
+            throw new OpenCrawlValidationError('The question and pages must fit in 4000 characters.');
+        const reuse = options.reuseWithinMs ?? 6 * 3600000, waitMs = options.waitMs ?? 240000;
+        const customer = { name: this.profile.name.trim(), website: this.profile.website, context: this.profile.context ?? '' };
+        const key = 'ask_' + (await digest(JSON.stringify([this.id, goal, customer]))).slice(0, 48);
+        let { agent, run } = await this.#call(client => client.agents.create({ customer, goal, collection_ids: [] }, { signal: options.signal, timeoutMs: options.timeoutMs, idempotencyKey: key }));
+        if (agent.status === 'paused')
+            throw new OpenCrawlValidationError('This question was paused in OpenCrawl. Resume its agent to ask again.');
+        const latest = (await this.#call(client => client.agents.get(agent.id, options))).latest_run ?? run;
+        run = latest;
+        const stale = !ACTIVE.has(run.status) && (['failed', 'unknown', 'cancelled'].includes(run.status) || !run.finished_at || Date.now() - Date.parse(run.finished_at) > reuse);
+        if (stale)
+            ({ run } = await this.#call(client => client.agents.runs.create(agent.id, { expected_revision: agent.revision }, { signal: options.signal, timeoutMs: options.timeoutMs, idempotencyKey: randomKey() })));
+        return this.#wait(agent, run, waitMs, options);
+    }
+    /** Read an answer started earlier, optionally waiting for it to finish. */
+    async answer(answerId, options = {}) {
+        const { agentId, runId } = decodeAnswerId(answerId);
+        const [agent, run] = await this.#call(client => Promise.all([client.agents.get(agentId, options), client.agents.runs.get(agentId, runId, options)]));
+        return this.#wait(agent, run, options.waitMs ?? 0, options);
+    }
+    async #wait(agent, run, waitMs, options) {
+        if (!ACTIVE.has(run.status) || waitMs <= 0)
+            return toAnswer(agent, run);
+        try {
+            run = await this.#call(client => client.agents.runs.wait(agent.id, run.id, { signal: options.signal, maxWaitMs: waitMs, pollIntervalMs: 3000 }));
+        }
+        catch (error) {
+            if (!(error instanceof OpenCrawlTimeoutError))
+                throw error;
+            run = await this.#call(client => client.agents.runs.get(agent.id, run.id, options));
+        }
+        return toAnswer(agent, run);
+    }
+    /** Connection details for OpenCrawl's hosted MCP server, scoped to this customer. */
+    mcp() { return { url: this.#client.baseUrl.replace(/\/$/, '') + '/mcp', headers: { Authorization: `Bearer ${this.#key()}` } }; }
+}
+/** Customer isolation for a platform serving many end customers with one admin key. */
+export class Customers {
+    #parent;
+    #keys;
+    #make;
+    #cache = new Map();
+    constructor(parent, keys, make) { this.#parent = parent; this.#keys = keys; this.#make = make; }
+    /** Load a customer, provisioning its isolated workspace on first use. */
+    get(profile, options = {}) {
+        if (!profile || typeof profile.id !== 'string' || !CUSTOMER_ID.test(profile.id))
+            throw new OpenCrawlValidationError('Customer id must be 1–128 letters, numbers, dots, colons, underscores or hyphens.');
+        if (typeof profile.name !== 'string' || !profile.name.trim() || Array.from(profile.name).length > 120 || /[\x00-\x1f\x7f]/.test(profile.name))
+            throw new OpenCrawlValidationError('Customer name must be 1–120 printable characters.');
+        if (!publicUrl(profile.website))
+            throw new OpenCrawlValidationError('Customer website must be a public http(s) URL.');
+        if (profile.context !== undefined && (typeof profile.context !== 'string' || profile.context.length > 4000))
+            throw new OpenCrawlValidationError('Customer context must be at most 4000 characters.');
+        const cached = this.#cache.get(profile.id);
+        if (cached)
+            return cached;
+        const loading = this.#load(profile, options).catch(error => { this.#cache.delete(profile.id); throw error; });
+        this.#cache.set(profile.id, loading);
+        return loading;
+    }
+    async #load(profile, options) {
+        let key = await this.#keys.get(profile.id) ?? await this.#provision(profile, options, null);
+        const refresh = async () => { const stored = await this.#keys.get(profile.id); key = stored && stored !== key ? stored : await this.#provision(profile, options, key); return this.#make(key); };
+        return new Customer(profile, this.#make(key), () => key, refresh);
+    }
+    async #provision(profile, options, stale) {
+        let tenant = await this.#find(profile.id, options);
+        if (!tenant) {
+            try {
+                const receipt = await this.#parent.createServiceTenant({ external_customer_id: profile.id, name: profile.name.trim() }, { ...options, idempotencyKey: randomKey() });
+                if (receipt.key) {
+                    await this.#keys.set(profile.id, receipt.key);
+                    return receipt.key;
+                }
+                tenant = receipt.tenant;
+            }
+            catch (error) {
+                if (!(error instanceof OpenCrawlAPIError && error.status === 409))
+                    throw error;
+                tenant = await this.#find(profile.id, options);
+            }
+        }
+        if (!tenant)
+            throw new OpenCrawlProtocolError('The customer could not be found after provisioning.');
+        if (tenant.status !== 'active')
+            throw new OpenCrawlValidationError(`Customer ${profile.id} was removed from OpenCrawl and cannot be reused.`);
+        for (let attempt = 0; attempt < 3; attempt++) {
+            try {
+                const receipt = await this.#parent.rotateServiceTenantKey(tenant.id, { expected_revision: tenant.revision }, { ...options, idempotencyKey: randomKey() });
+                if (!receipt.key)
+                    throw new OpenCrawlProtocolError('OpenCrawl did not return the new customer key.');
+                await this.#keys.set(profile.id, receipt.key);
+                return receipt.key;
+            }
+            catch (error) {
+                if (!(error instanceof OpenCrawlAPIError && error.status === 409))
+                    throw error;
+                // Another process rotated first; use the key it stored, or retry on the new revision.
+                const stored = await this.#keys.get(profile.id);
+                if (stored && stored !== stale)
+                    return stored;
+                tenant = await this.#find(profile.id, options);
+                if (!tenant || tenant.status !== 'active')
+                    throw error;
+            }
+        }
+        throw new OpenCrawlProtocolError('The customer key changed repeatedly. Use a shared KeyStore across processes.');
+    }
+    async #find(id, options) { return (await this.#parent.listServiceTenants({ ...options, external_customer_id: id, limit: 1 })).items.find(t => t.external_customer_id === id); }
+}
+//# sourceMappingURL=customers.js.map

package/dist/customers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"customers.js","sourceRoot":"","sources":["../src/customers.ts"],"names":[],"mappings":"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"}

package/dist/errors.d.ts

@@ -0,0 +1,35 @@
+/** Errors intentionally omit request headers, response bodies and transport causes. */
+export declare class OpenCrawlError extends Error {
+    constructor(message: string);
+}
+export declare class OpenCrawlValidationError extends OpenCrawlError {
+}
+export declare class OpenCrawlProtocolError extends OpenCrawlError {
+    readonly acceptanceUnknown: boolean;
+    readonly idempotencyKey?: string | undefined;
+    constructor(message: string, acceptanceUnknown?: boolean, idempotencyKey?: string | undefined);
+}
+export declare class OpenCrawlAbortError extends OpenCrawlError {
+    readonly acceptanceUnknown: boolean;
+    readonly idempotencyKey?: string | undefined;
+    constructor(message: string, acceptanceUnknown?: boolean, idempotencyKey?: string | undefined);
+}
+export declare class OpenCrawlTimeoutError extends OpenCrawlError {
+    readonly jobId?: string | undefined;
+    readonly acceptanceUnknown: boolean;
+    readonly idempotencyKey?: string | undefined;
+    constructor(message: string, jobId?: string | undefined, acceptanceUnknown?: boolean, idempotencyKey?: string | undefined);
+}
+export declare class OpenCrawlConnectionError extends OpenCrawlError {
+    readonly acceptanceUnknown: boolean;
+    readonly idempotencyKey?: string | undefined;
+    constructor(message: string, acceptanceUnknown: boolean, idempotencyKey?: string | undefined);
+}
+export declare class OpenCrawlAPIError extends OpenCrawlError {
+    readonly status: number;
+    readonly code?: string | undefined;
+    readonly requestId?: string | undefined;
+    readonly retryAfterMs?: number | undefined;
+    constructor(message: string, status: number, code?: string | undefined, requestId?: string | undefined, retryAfterMs?: number | undefined);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,EAAC,MAAM;CAC3B;AACD,qBAAa,wBAAyB,SAAQ,cAAc;CAAG;AAC/D,qBAAa,sBAAuB,SAAQ,cAAc;IAC7B,QAAQ,CAAC,iBAAiB;IAAO,QAAQ,CAAC,cAAc,CAAC,EAAC,MAAM;gBAA/E,OAAO,EAAC,MAAM,EAAU,iBAAiB,UAAM,EAAU,cAAc,CAAC,EAAC,MAAM,YAAA;CAC5F;AACD,qBAAa,mBAAoB,SAAQ,cAAc;IAC1B,QAAQ,CAAC,iBAAiB;IAAO,QAAQ,CAAC,cAAc,CAAC,EAAC,MAAM;gBAA/E,OAAO,EAAC,MAAM,EAAU,iBAAiB,UAAM,EAAU,cAAc,CAAC,EAAC,MAAM,YAAA;CAC5F;AACD,qBAAa,qBAAsB,SAAQ,cAAc;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAC,MAAM;IAAC,QAAQ,CAAC,iBAAiB;IAAO,QAAQ,CAAC,cAAc,CAAC,EAAC,MAAM;gBAAtG,OAAO,EAAC,MAAM,EAAU,KAAK,CAAC,EAAC,MAAM,YAAA,EAAU,iBAAiB,UAAM,EAAU,cAAc,CAAC,EAAC,MAAM,YAAA;CACnH;AACD,qBAAa,wBAAyB,SAAQ,cAAc;IAC/B,QAAQ,CAAC,iBAAiB,EAAC,OAAO;IAAC,QAAQ,CAAC,cAAc,CAAC,EAAC,MAAM;gBAAjF,OAAO,EAAC,MAAM,EAAU,iBAAiB,EAAC,OAAO,EAAU,cAAc,CAAC,EAAC,MAAM,YAAA;CAC9F;AACD,qBAAa,iBAAkB,SAAQ,cAAc;IACxB,QAAQ,CAAC,MAAM,EAAC,MAAM;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAC,MAAM;IAAC,QAAQ,CAAC,SAAS,CAAC,EAAC,MAAM;IAAC,QAAQ,CAAC,YAAY,CAAC,EAAC,MAAM;gBAApH,OAAO,EAAC,MAAM,EAAU,MAAM,EAAC,MAAM,EAAU,IAAI,CAAC,EAAC,MAAM,YAAA,EAAU,SAAS,CAAC,EAAC,MAAM,YAAA,EAAU,YAAY,CAAC,EAAC,MAAM,YAAA;CACjI"}

package/dist/errors.js

@@ -0,0 +1,58 @@
+/** Errors intentionally omit request headers, response bodies and transport causes. */
+export class OpenCrawlError extends Error {
+    constructor(message) { super(message); this.name = new.target.name; }
+}
+export class OpenCrawlValidationError extends OpenCrawlError {
+}
+export class OpenCrawlProtocolError extends OpenCrawlError {
+    acceptanceUnknown;
+    idempotencyKey;
+    constructor(message, acceptanceUnknown = false, idempotencyKey) {
+        super(message);
+        this.acceptanceUnknown = acceptanceUnknown;
+        this.idempotencyKey = idempotencyKey;
+    }
+}
+export class OpenCrawlAbortError extends OpenCrawlError {
+    acceptanceUnknown;
+    idempotencyKey;
+    constructor(message, acceptanceUnknown = false, idempotencyKey) {
+        super(message);
+        this.acceptanceUnknown = acceptanceUnknown;
+        this.idempotencyKey = idempotencyKey;
+    }
+}
+export class OpenCrawlTimeoutError extends OpenCrawlError {
+    jobId;
+    acceptanceUnknown;
+    idempotencyKey;
+    constructor(message, jobId, acceptanceUnknown = false, idempotencyKey) {
+        super(message);
+        this.jobId = jobId;
+        this.acceptanceUnknown = acceptanceUnknown;
+        this.idempotencyKey = idempotencyKey;
+    }
+}
+export class OpenCrawlConnectionError extends OpenCrawlError {
+    acceptanceUnknown;
+    idempotencyKey;
+    constructor(message, acceptanceUnknown, idempotencyKey) {
+        super(message);
+        this.acceptanceUnknown = acceptanceUnknown;
+        this.idempotencyKey = idempotencyKey;
+    }
+}
+export class OpenCrawlAPIError extends OpenCrawlError {
+    status;
+    code;
+    requestId;
+    retryAfterMs;
+    constructor(message, status, code, requestId, retryAfterMs) {
+        super(message);
+        this.status = status;
+        this.code = code;
+        this.requestId = requestId;
+        this.retryAfterMs = retryAfterMs;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvC,YAAY,OAAc,IAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAA,IAAI,CAAC,IAAI,GAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAA,CAAA,CAAC;CACtE;AACD,MAAM,OAAO,wBAAyB,SAAQ,cAAc;CAAG;AAC/D,MAAM,OAAO,sBAAuB,SAAQ,cAAc;IACpB;IAAiC;IAArE,YAAY,OAAc,EAAU,oBAAkB,KAAK,EAAU,cAAsB;QAAE,KAAK,CAAC,OAAO,CAAC,CAAA;QAAvE,sBAAiB,GAAjB,iBAAiB,CAAM;QAAU,mBAAc,GAAd,cAAc,CAAQ;IAAgB,CAAC;CAC7G;AACD,MAAM,OAAO,mBAAoB,SAAQ,cAAc;IACjB;IAAiC;IAArE,YAAY,OAAc,EAAU,oBAAkB,KAAK,EAAU,cAAsB;QAAE,KAAK,CAAC,OAAO,CAAC,CAAA;QAAvE,sBAAiB,GAAjB,iBAAiB,CAAM;QAAU,mBAAc,GAAd,cAAc,CAAQ;IAAgB,CAAC;CAC7G;AACD,MAAM,OAAO,qBAAsB,SAAQ,cAAc;IACnB;IAAuB;IAAiC;IAA5F,YAAY,OAAc,EAAU,KAAa,EAAU,oBAAkB,KAAK,EAAU,cAAsB;QAAE,KAAK,CAAC,OAAO,CAAC,CAAA;QAA9F,UAAK,GAAL,KAAK,CAAQ;QAAU,sBAAiB,GAAjB,iBAAiB,CAAM;QAAU,mBAAc,GAAd,cAAc,CAAQ;IAAgB,CAAC;CACpI;AACD,MAAM,OAAO,wBAAyB,SAAQ,cAAc;IACtB;IAAmC;IAAvE,YAAY,OAAc,EAAU,iBAAyB,EAAU,cAAsB;QAAE,KAAK,CAAC,OAAO,CAAC,CAAA;QAAzE,sBAAiB,GAAjB,iBAAiB,CAAQ;QAAU,mBAAc,GAAd,cAAc,CAAQ;IAAgB,CAAC;CAC/G;AACD,MAAM,OAAO,iBAAkB,SAAQ,cAAc;IACf;IAAuB;IAAsB;IAA2B;IAA5G,YAAY,OAAc,EAAU,MAAa,EAAU,IAAY,EAAU,SAAiB,EAAU,YAAoB;QAAE,KAAK,CAAC,OAAO,CAAC,CAAA;QAA5G,WAAM,GAAN,MAAM,CAAO;QAAU,SAAI,GAAJ,IAAI,CAAQ;QAAU,cAAS,GAAT,SAAS,CAAQ;QAAU,iBAAY,GAAZ,YAAY,CAAQ;IAAgB,CAAC;CAClJ"}

package/dist/eventEvidence.d.ts

@@ -0,0 +1,10 @@
+import { Transport, type RequestOptions } from './transport.js';
+import type { ResearchEventDetail } from './types.js';
+export type EventReadOptions = RequestOptions & {
+    budget?: number;
+    beforeStart?: number;
+    afterStart?: number;
+};
+/** Reads one authorized immutable observation window; never follows continuation automatically. */
+export declare function readEvent(transport: Transport, collectionId: string, eventId: string, options?: EventReadOptions): Promise<ResearchEventDetail>;
+//# sourceMappingURL=eventEvidence.d.ts.map

package/dist/eventEvidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventEvidence.d.ts","sourceRoot":"","sources":["../src/eventEvidence.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,SAAS,EAAuB,KAAK,cAAc,EAAC,MAAM,gBAAgB,CAAC;AACnF,OAAO,KAAK,EAAC,mBAAmB,EAAqB,MAAM,YAAY,CAAC;AAExE,MAAM,MAAM,gBAAgB,GAAC,cAAc,GAAC;IAAC,MAAM,CAAC,EAAC,MAAM,CAAC;IAAA,WAAW,CAAC,EAAC,MAAM,CAAC;IAAA,UAAU,CAAC,EAAC,MAAM,CAAA;CAAC,CAAC;AAoBpG,mGAAmG;AACnG,wBAAsB,SAAS,CAAC,SAAS,EAAC,SAAS,EAAC,YAAY,EAAC,MAAM,EAAC,OAAO,EAAC,MAAM,EAAC,OAAO,GAAC,gBAAmB,GAAE,OAAO,CAAC,mBAAmB,CAAC,CAY/I"}

package/dist/eventEvidence.js

@@ -0,0 +1,52 @@
+import { OpenCrawlProtocolError } from './errors.js';
+import { boundedInteger, idPath } from './transport.js';
+const integer = (value, min = 0, max = 2_000_000) => Number.isSafeInteger(value) && Number(value) >= min && Number(value) <= max;
+const text = (value, max) => typeof value === 'string' && value.length <= max;
+const hash = (value) => typeof value === 'string' && /^[a-f0-9]{64}$/.test(value);
+const invalid = () => new OpenCrawlProtocolError('OpenCrawl returned invalid or out-of-scope retained event evidence.');
+const bytes = (value) => new TextEncoder().encode(value).byteLength;
+function validateWindow(value, offset, comparison) {
+    if (value === null) {
+        if (offset !== undefined)
+            throw invalid();
+        return 0;
+    }
+    if (!value || !text(value.version_id, 200) || !value.version_id || !hash(value.version_sha256) || !hash(value.body_sha256) || !text(value.title, 8192) || !text(value.url, 8192) || !(value.final_url === null || text(value.final_url, 65536)) || !(value.extraction_version === null || text(value.extraction_version, 65536)) || !text(value.version_observed_at, 200) || !value.version_observed_at || !text(value.text, 64000) || !integer(value.full_length) || !integer(value.start_char, 0, value.full_length) || !integer(value.end_char, value.start_char, value.full_length))
+        throw invalid();
+    const points = Array.from(value.text);
+    if (points.length !== value.end_char - value.start_char || points.some(point => point.length === 1 && /[\uD800-\uDFFF]/.test(point)) || value.next_start_char !== (value.end_char < value.full_length ? value.end_char : null) || value.omitted_before !== (value.start_char > 0) || value.omitted_after !== (value.end_char < value.full_length))
+        throw invalid();
+    if (offset !== undefined) {
+        if (value.window_origin !== 'explicit_offset' || value.start_char !== offset)
+            throw invalid();
+    }
+    else if (value.window_origin !== (comparison === 'contiguous_region' ? 'changed_region' : 'page_start') || (value.window_origin === 'page_start' && value.start_char !== 0))
+        throw invalid();
+    if (comparison === 'contiguous_region') {
+        if (!integer(value.changed_start_char, 0, value.full_length) || !integer(value.changed_end_char, value.changed_start_char, value.full_length))
+            throw invalid();
+    }
+    else if (value.changed_start_char !== null || value.changed_end_char !== null)
+        throw invalid();
+    return bytes(value.text);
+}
+/** Reads one authorized immutable observation window; never follows continuation automatically. */
+export async function readEvent(transport, collectionId, eventId, options = {}) {
+    const collection = idPath(collectionId), event = idPath(eventId), budget = boundedInteger(options.budget ?? 16000, 'budget', 256, 32000);
+    const query = new URLSearchParams({ budget: String(budget) });
+    for (const [name, value] of [['before_start', options.beforeStart], ['after_start', options.afterStart]])
+        if (value !== undefined)
+            query.set(name, String(boundedInteger(value, name, 0, 2_000_000)));
+    const value = await transport.request(`/api/research/collections/${collection}/events/${event}?${query}`, { signal: options.signal, timeoutMs: options.timeoutMs });
+    if (!value || value.id !== eventId || value.collection_id !== collectionId || !text(value.url, 8192) || !['baseline', 'changed', 'unavailable', 'recovered'].includes(value.kind) || !text(value.observed_at, 200) || !value.observed_at || !(value.previous_observed_at === null || text(value.previous_observed_at, 200)) || typeof value.gap !== 'boolean' || !['contiguous_region', 'equal_body', 'single_observation', 'no_observation'].includes(value.comparison) || value.budget !== budget || !integer(value.text_bytes, 0, budget))
+        throw invalid();
+    const count = Number(value.before !== null) + Number(value.after !== null);
+    if (count !== (value.comparison === 'no_observation' ? 0 : value.comparison === 'single_observation' ? 1 : 2))
+        throw invalid();
+    const total = validateWindow(value.before, options.beforeStart, value.comparison) + validateWindow(value.after, options.afterStart, value.comparison);
+    if (total !== value.text_bytes || total > budget || (value.comparison === 'equal_body' && value.before?.body_sha256 !== value.after?.body_sha256) || (value.comparison === 'contiguous_region' && value.before?.body_sha256 === value.after?.body_sha256))
+        throw invalid();
+    // Full-body/version hashes identify retained observations. A partial window cannot verify them.
+    return value;
+}
+//# sourceMappingURL=eventEvidence.js.map

package/dist/eventEvidence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventEvidence.js","sourceRoot":"","sources":["../src/eventEvidence.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,98 @@
+import { Customers, type KeyStore } from './customers.js';
+import { AgentPlatform } from './agentPlatform.js';
+import { Transport, type ClientOptions, type MutationOptions, type RequestOptions } from './transport.js';
+import { ResearchWebhooks } from './webhooks.js';
+import { ResearchAgents } from './agents.js';
+import { ProductMonitors } from './productMonitors.js';
+export * from './productMonitors.js';
+export type { ResearchAgentFeedbackRating, ResearchAgentFeedbackInput, ResearchAgentFeedbackReceipt } from './agents.js';
+export type { ResearchCustomer, ResearchPolicy, ResearchAgentInput, ResearchAgentRunInput, ResearchAgentWebPage, ResearchAgentCitation, ResearchAgentFinding, ResearchAgentRun, ResearchAgent, ResearchAgentReceipt, ResearchAgentPage, ResearchAgentRunPage, ResearchAgentSource, ResearchAgentSourceReceipt, ResearchAgentSchedule, ResearchAgentRepeat, ResearchAgentRepeats, AgentWaitOptions } from './agents.js';
+import { type EventReadOptions } from './eventEvidence.js';
+export type { EventReadOptions } from './eventEvidence.js';
+import type { CollectionSettings, CollectionSettingsReceipt } from './types.js';
+import type { Collection, CollectionUpdate, CollectionInput, CollectionReceipt, ContextInput, ContextResponse, CursorPage, PageOptions, RefreshInput, RefreshReceipt, ResearchEvent, ResearchJob, ResearchSearchInput, ResearchSearchResponse, ResearchPlanInput, ResearchPlanReceipt, ResearchPlannerStatus, ServiceTenant, ServiceTenantInput, ServiceTenantRevision, ServiceTenantReceipt, ServiceTenantOperation, ServiceTenantPage, ServiceTenantListOptions } from './types.js';
+export * from './errors.js';
+export * from './types.js';
+export { verifyResearchWebhook, type WebhookSignatureInput } from './webhooks.js';
+export { Customer, Customers, memoryKeyStore, signalHeadline, type KeyStore, type CustomerProfile, type Cadence, type WatchInput, type Watch, type Signal, type SignalsOptions, type SignalsResult, type Answer, type AnswerFinding, type AnswerSource, type AskOptions, type McpConnection } from './customers.js';
+export { AgentPlatform, signupOrganization, pollOrganizationSignup, type AgentSignupInput, type AgentSignup, type AgentSignupPoll, type ProjectSpec, type ProjectHandoff, type AgentTurn } from './agentPlatform.js';
+export { agentTools, type AgentTool, type AgentToolSet, type ToolOptions, type JsonSchema } from './tools.js';
+export type { ClientOptions, RequestOptions, MutationOptions, Fetch } from './transport.js';
+export type ListOptions = PageOptions & RequestOptions;
+export type IterateOptions = ListOptions & {
+    maxPages?: number;
+};
+/** includeVolatile:false omits changes whose only differences are dates, clock times, relative ages or whitespace. */
+export type EventListOptions = ListOptions & {
+    includeVolatile?: boolean;
+};
+export type WaitOptions = RequestOptions & {
+    maxWaitMs?: number;
+    pollIntervalMs?: number;
+    onProgress?: (job: ResearchJob) => void;
+};
+declare class Collections {
+    private readonly transport;
+    constructor(transport: Transport);
+    create(input: CollectionInput, options: MutationOptions): Promise<CollectionReceipt>;
+    list(options?: ListOptions): Promise<CursorPage<Collection>>;
+    get(id: string, options?: RequestOptions): Promise<Collection>;
+    update(id: string, input: CollectionUpdate, options?: RequestOptions): Promise<Collection>;
+    configure(id: string, input: CollectionSettings, options: MutationOptions): Promise<CollectionSettingsReceipt>;
+    refresh(id: string, input: RefreshInput, options: MutationOptions): Promise<RefreshReceipt>;
+    events(id: string, options?: EventListOptions): Promise<CursorPage<ResearchEvent>>;
+    event(collectionId: string, eventId: string, options?: EventReadOptions): Promise<import("./types.js").ResearchEventDetail>;
+    iterate(options?: IterateOptions): AsyncGenerator<Collection>;
+    iterateEvents(id: string, options?: IterateOptions & EventListOptions): AsyncGenerator<ResearchEvent>;
+}
+declare class Jobs {
+    private readonly transport;
+    constructor(transport: Transport);
+    get(id: string, options?: RequestOptions): Promise<ResearchJob>;
+    /** Waits for a terminal receipt. Failed/partial/cancelled jobs are returned, not disguised as success. */
+    wait(id: string, options?: WaitOptions): Promise<ResearchJob>;
+}
+declare class Plans {
+    private readonly transport;
+    constructor(transport: Transport);
+    status(options?: RequestOptions): Promise<ResearchPlannerStatus>;
+    /** Returns a proposal only. Source selection and collection creation remain explicit. */
+    create(input: ResearchPlanInput, options: MutationOptions): Promise<ResearchPlanReceipt>;
+    get(id: string, options?: RequestOptions): Promise<ResearchPlanReceipt>;
+    byKey(key: string, options?: RequestOptions): Promise<ResearchPlanReceipt>;
+}
+/** Server-only. Supply tenant-specific credentials explicitly; no environment or local config is read. */
+export declare class OpenCrawl {
+    #private;
+    readonly productMonitors: ProductMonitors;
+    readonly agents: ResearchAgents;
+    readonly collections: Collections;
+    readonly jobs: Jobs;
+    readonly webhooks: ResearchWebhooks;
+    readonly plans: Plans;
+    readonly agent: AgentPlatform;
+    readonly baseUrl: string;
+    constructor(options: ClientOptions);
+    /** Your end customers, each isolated in its own workspace and provisioned on first use.
+     * Requires a parent administrator API key. Pass a shared KeyStore when several processes
+     * serve customers; keys lost from the store are recovered by rotation. */
+    customers(options?: {
+        keys?: KeyStore;
+    }): Customers;
+    /** Requires a parent administrator API key; these writes never retry automatically. */
+    createServiceTenant(input: ServiceTenantInput, options: MutationOptions): Promise<ServiceTenantReceipt>;
+    listServiceTenants(options?: ServiceTenantListOptions & RequestOptions): Promise<ServiceTenantPage>;
+    getServiceTenant(id: string, options?: RequestOptions): Promise<ServiceTenant>;
+    rotateServiceTenantKey(id: string, input: ServiceTenantRevision, options: MutationOptions): Promise<ServiceTenantReceipt>;
+    revokeServiceTenant(id: string, input: ServiceTenantRevision, options: MutationOptions): Promise<ServiceTenantReceipt>;
+    getServiceTenantReceipt(operation: ServiceTenantOperation, options: MutationOptions): Promise<ServiceTenantReceipt>;
+    search(input: ResearchSearchInput, options?: RequestOptions): Promise<ResearchSearchResponse>;
+    /** Existing source-scoped context API; explicit [] is retained, never broadened. */
+    context(input: ContextInput, options?: RequestOptions): Promise<ContextResponse>;
+}
+export default OpenCrawl;
+export { readResearchAnswerContract, type AnswerSourceScope, type AnswerFactRef, type AnswerComponent, type AnswerContract, type AnswerContractMarker, type AnswerContractView } from './researchAnswerContract.js';
+export { readResearchCompletion, readResearchPresentation, type ResearchPresentation, type ResearchCompletion, type ResearchCompletionNoticeCode, type ResearchCompletionView } from './researchCompletion.js';
+export { readResearchAnswerView } from "./researchAnswerView.js";
+export type { AnswerAssertion, AnswerOmissionReason, ResearchAnswerView, ResearchAnswerSection, ResearchAnswerViewResult } from "./answerView.js";
+//# sourceMappingURL=index.d.ts.map