@ank1015/llm-extension 0.0.1

package/dist/sdk/connect.js

@@ -0,0 +1,99 @@
+import { exec } from 'node:child_process';
+import { connect as tcpConnect } from 'node:net';
+import { DEFAULT_PORT, MAX_TCP_MESSAGE_SIZE_BYTES } from '../protocol/constants.js';
+import { ChromeClient } from './client.js';
+const DEFAULT_LAUNCH_TIMEOUT = 30_000;
+/**
+ * Connect to the Chrome RPC server over TCP.
+ *
+ * Returns a ChromeClient with the same `call()` and `subscribe()` API
+ * as the native host uses directly. The connection is multiplexed —
+ * multiple calls and subscriptions can be in-flight simultaneously.
+ *
+ * When `launch: true` is set, Chrome will be opened automatically
+ * if the connection fails, then retried until the native host is ready.
+ *
+ * @example
+ * ```ts
+ * import { connect } from '@ank1015/llm-extension';
+ *
+ * const chrome = await connect({ launch: true });
+ * const tabs = await chrome.call('tabs.query', { active: true });
+ * ```
+ */
+export async function connect(opts) {
+    const port = opts?.port ?? DEFAULT_PORT;
+    const host = opts?.host ?? '127.0.0.1';
+    try {
+        return await tryConnect(port, host);
+    }
+    catch (error) {
+        if (!opts?.launch || !isConnectionRefused(error)) {
+            throw error;
+        }
+        await launchChrome();
+        const timeout = opts.launchTimeout ?? DEFAULT_LAUNCH_TIMEOUT;
+        const deadline = Date.now() + timeout;
+        let delay = 200;
+        while (Date.now() < deadline) {
+            await sleep(delay);
+            try {
+                return await tryConnect(port, host);
+            }
+            catch (retryError) {
+                if (!isConnectionRefused(retryError))
+                    throw retryError;
+            }
+            delay = Math.min(delay * 2, 2000);
+        }
+        throw new Error(`Chrome did not become available on ${host}:${port} within ${timeout}ms. ` +
+            'Ensure the extension is installed and the native host is registered.');
+    }
+}
+function tryConnect(port, host) {
+    return new Promise((resolve, reject) => {
+        const socket = tcpConnect({ port, host }, () => {
+            const client = new ChromeClient({
+                input: socket,
+                output: socket,
+                maxIncomingMessageSizeBytes: MAX_TCP_MESSAGE_SIZE_BYTES,
+                maxOutgoingMessageSizeBytes: MAX_TCP_MESSAGE_SIZE_BYTES,
+            });
+            client.run().catch(() => {
+                // Errors propagate to pending calls via client.closed
+            });
+            resolve(client);
+        });
+        socket.once('error', reject);
+    });
+}
+function isConnectionRefused(error) {
+    return (error instanceof Error &&
+        'code' in error &&
+        error.code === 'ECONNREFUSED');
+}
+function launchChrome() {
+    const platform = process.platform;
+    let command;
+    if (platform === 'darwin') {
+        command = 'open -a "Google Chrome"';
+    }
+    else if (platform === 'linux') {
+        command = 'google-chrome --no-first-run &';
+    }
+    else {
+        throw new Error(`Auto-launch is not supported on ${platform}`);
+    }
+    return new Promise((resolve, reject) => {
+        exec(command, (error) => {
+            if (error)
+                reject(new Error(`Failed to launch Chrome: ${error.message}`));
+            else
+                resolve();
+        });
+    });
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=connect.js.map

package/dist/sdk/connect.js.map

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

package/dist/sdk/index.d.ts

@@ -0,0 +1,17 @@
+import { ChromeClient } from './client.js';
+import type { ChromeClientOptions } from './client.js';
+export { ChromeClient } from './client.js';
+export type { ChromeClientOptions } from './client.js';
+export { connect } from './connect.js';
+export type { ConnectOptions } from './connect.js';
+export { Window } from './window.js';
+export type { ObserveFilter, WindowActionOptions, WindowDownloadOptions, WindowEvaluateOptions, WindowGetPageOptions, WindowObserveOptions, WindowOpenOptions, WindowScrollBehavior, WindowScrollOptions, WindowSemanticFilter, WindowScreenshotOptions, WindowTab, WindowTypeOptions, } from './window.js';
+/**
+ * Create a ChromeClient and start the read loop.
+ *
+ * The read loop runs in the background — the client is immediately
+ * usable for `call()` and `subscribe()`. The process stays alive
+ * as long as Chrome keeps the native messaging port open.
+ */
+export declare function createChromeClient(opts?: ChromeClientOptions): ChromeClient;
+//# sourceMappingURL=index.d.ts.map

package/dist/sdk/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sdk/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EACV,aAAa,EACb,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,EACvB,SAAS,EACT,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAErB;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,YAAY,CAU3E"}

package/dist/sdk/index.js

@@ -0,0 +1,19 @@
+import { ChromeClient } from './client.js';
+export { ChromeClient } from './client.js';
+export { connect } from './connect.js';
+export { Window } from './window.js';
+/**
+ * Create a ChromeClient and start the read loop.
+ *
+ * The read loop runs in the background — the client is immediately
+ * usable for `call()` and `subscribe()`. The process stays alive
+ * as long as Chrome keeps the native messaging port open.
+ */
+export function createChromeClient(opts) {
+    const client = new ChromeClient(opts);
+    client.run().catch((error) => {
+        process.stderr.write(`[chrome-client] fatal: ${error instanceof Error ? error.message : String(error)}\n`);
+    });
+    return client;
+}
+//# sourceMappingURL=index.js.map

package/dist/sdk/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sdk/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI3C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAiBrC;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAA0B;IAC3D,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;IAEtC,MAAM,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,0BAA0B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CACrF,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/sdk/observe/helpers.d.ts

@@ -0,0 +1,16 @@
+import type { NormalizedObserveOptions, ObserveSnapshot, ObserveView, WindowObserveOptions } from './types.js';
+export declare function normalizeObserveOptions(input?: WindowObserveOptions): NormalizedObserveOptions;
+export declare function parseObserveSnapshot(raw: unknown): ObserveSnapshot;
+export declare function createObserveView(snapshot: ObserveSnapshot, options: NormalizedObserveOptions): ObserveView;
+interface RenderObserveMarkdownInput {
+    windowId: number;
+    tabId: number;
+    snapshotId: string;
+    snapshotPath: string;
+    options: NormalizedObserveOptions;
+    snapshot: ObserveSnapshot;
+    view: ObserveView;
+}
+export declare function renderObserveMarkdown(input: RenderObserveMarkdownInput): string;
+export {};
+//# sourceMappingURL=helpers.d.ts.map

package/dist/sdk/observe/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/sdk/observe/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EAGxB,eAAe,EACf,WAAW,EACX,oBAAoB,EACrB,MAAM,YAAY,CAAC;AA2EpB,wBAAgB,uBAAuB,CAAC,KAAK,CAAC,EAAE,oBAAoB,GAAG,wBAAwB,CAyB9F;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,eAAe,CAyClE;AAUD,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,wBAAwB,GAChC,WAAW,CAyCb;AAED,UAAU,0BAA0B;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,wBAAwB,CAAC;IAClC,QAAQ,EAAE,eAAe,CAAC;IAC1B,IAAI,EAAE,WAAW,CAAC;CACnB;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,0BAA0B,GAAG,MAAM,CAsI/E"}

package/dist/sdk/observe/helpers.js

@@ -0,0 +1,278 @@
+const DEFAULT_MAX = 120;
+const FILTERED_DEFAULT_MAX = 60;
+const MIN_MAX = 10;
+const MAX_MAX = 200;
+const VALID_FILTERS = [
+    'interactive',
+    'buttons',
+    'links',
+    'inputs',
+    'text',
+    'forms',
+    'media',
+    'alerts',
+];
+function clamp(value, min, max, fallback) {
+    if (typeof value !== 'number' || Number.isNaN(value)) {
+        return fallback;
+    }
+    return Math.min(Math.max(Math.floor(value), min), max);
+}
+function isObject(value) {
+    return typeof value === 'object' && value !== null;
+}
+function normalizeLine(value, max = 220) {
+    const compact = value.replace(/\s+/g, ' ').trim();
+    if (compact.length <= max)
+        return compact;
+    return `${compact.slice(0, Math.max(1, max - 3))}...`;
+}
+function formatSelectOptions(options) {
+    if (!Array.isArray(options) || options.length === 0) {
+        return '';
+    }
+    const normalizedValues = options
+        .map((option) => normalizeLine((option.value || option.label || '').trim(), 80))
+        .filter((value) => value.length > 0);
+    if (normalizedValues.length === 0) {
+        return '';
+    }
+    const limit = 8;
+    const rendered = normalizedValues
+        .slice(0, limit)
+        .map((value) => `"${value}"`)
+        .join(', ');
+    const suffix = normalizedValues.length > limit ? ` (+${normalizedValues.length - limit} more)` : '';
+    return ` | options=[${rendered}]${suffix}`;
+}
+function getLocatorText(locator) {
+    if (locator.testId)
+        return `[data-testid="${locator.testId}"]`;
+    if (locator.id)
+        return `#${locator.id}`;
+    if (locator.name)
+        return `[name="${locator.name}"]`;
+    if (locator.cssPath)
+        return locator.cssPath;
+    if (locator.role)
+        return `[role="${locator.role}"]`;
+    return '(none)';
+}
+export function normalizeObserveOptions(input) {
+    const dedup = new Set();
+    for (const filter of input?.filters ?? []) {
+        if (VALID_FILTERS.includes(filter)) {
+            dedup.add(filter);
+        }
+    }
+    const filters = Array.from(dedup);
+    const max = clamp(input?.max, MIN_MAX, MAX_MAX, DEFAULT_MAX);
+    const effectiveMax = filters.length > 0 && input?.max === undefined ? Math.min(max, FILTERED_DEFAULT_MAX) : max;
+    const semanticFilter = input?.semanticFilter?.trim() || undefined;
+    const normalized = {
+        filters,
+        max,
+        effectiveMax,
+    };
+    if (semanticFilter) {
+        normalized.semanticFilter = semanticFilter;
+    }
+    return normalized;
+}
+export function parseObserveSnapshot(raw) {
+    if (!isObject(raw)) {
+        throw new Error('Observe returned an invalid payload');
+    }
+    const page = raw.page;
+    const summary = raw.summary;
+    const interactive = raw.interactive;
+    const textBlocks = raw.textBlocks;
+    const forms = raw.forms;
+    const media = raw.media;
+    const alerts = raw.alerts;
+    const truncation = raw.truncation;
+    const warnings = raw.warnings;
+    if (!isObject(page) ||
+        !isObject(summary) ||
+        !Array.isArray(interactive) ||
+        !Array.isArray(textBlocks) ||
+        !Array.isArray(forms) ||
+        !Array.isArray(media) ||
+        !Array.isArray(alerts) ||
+        !isObject(truncation)) {
+        throw new Error('Observe payload is missing required fields');
+    }
+    return {
+        page: page,
+        summary: summary,
+        interactive: interactive,
+        textBlocks: textBlocks,
+        forms: forms,
+        media: media,
+        alerts: alerts.filter((item) => typeof item === 'string'),
+        truncation: truncation,
+        warnings: Array.isArray(warnings)
+            ? warnings.filter((item) => typeof item === 'string')
+            : [],
+    };
+}
+function getCategoryFilters(filters) {
+    const categories = new Set();
+    if (filters.includes('buttons'))
+        categories.add('button');
+    if (filters.includes('links'))
+        categories.add('link');
+    if (filters.includes('inputs'))
+        categories.add('input');
+    return Array.from(categories);
+}
+export function createObserveView(snapshot, options) {
+    const hasFilters = options.filters.length > 0;
+    const filterSet = new Set(options.filters);
+    const categoryFilters = getCategoryFilters(options.filters);
+    const includeAllInteractive = !hasFilters || filterSet.has('interactive');
+    const includeInteractive = !hasFilters ||
+        includeAllInteractive ||
+        filterSet.has('buttons') ||
+        filterSet.has('links') ||
+        filterSet.has('inputs');
+    const includeText = !hasFilters || filterSet.has('text');
+    const includeForms = !hasFilters || filterSet.has('forms');
+    const includeMedia = !hasFilters || filterSet.has('media');
+    const includeAlerts = !hasFilters || filterSet.has('alerts');
+    const interactiveBase = includeAllInteractive
+        ? snapshot.interactive
+        : snapshot.interactive.filter((element) => categoryFilters.includes(element.category));
+    const interactive = includeInteractive ? interactiveBase.slice(0, options.effectiveMax) : [];
+    const textBlocks = includeText ? snapshot.textBlocks.slice(0, options.effectiveMax) : [];
+    const forms = includeForms ? snapshot.forms.slice(0, Math.min(40, options.effectiveMax)) : [];
+    const media = includeMedia ? snapshot.media.slice(0, Math.min(40, options.effectiveMax)) : [];
+    const alerts = includeAlerts ? snapshot.alerts.slice(0, Math.min(20, options.effectiveMax)) : [];
+    return {
+        interactive,
+        textBlocks,
+        forms,
+        media,
+        alerts,
+        includeSections: {
+            interactive: includeInteractive,
+            text: includeText,
+            forms: includeForms,
+            media: includeMedia,
+            alerts: includeAlerts,
+        },
+    };
+}
+export function renderObserveMarkdown(input) {
+    const { windowId, tabId, snapshotId, snapshotPath, options, snapshot, view } = input;
+    const lines = [];
+    lines.push('# Page Observation');
+    lines.push('');
+    lines.push('## Summary');
+    lines.push(`- Title: ${normalizeLine(snapshot.page.title || '(untitled)', 180)}`);
+    lines.push(`- URL: ${snapshot.page.url || '(empty)'}`);
+    lines.push(`- Tab: ${tabId} (window ${windowId})`);
+    lines.push(`- Viewport: ${snapshot.page.viewport.width}x${snapshot.page.viewport.height}, scroll=(${snapshot.page.scroll.x}, ${snapshot.page.scroll.y}/${snapshot.page.scroll.maxY})`);
+    lines.push(`- Totals: interactive=${snapshot.summary.totalInteractiveCount}, text=${snapshot.summary.totalTextBlockCount}, forms=${snapshot.summary.formCount}, media=${snapshot.summary.mediaCount}, alerts=${snapshot.summary.alertCount}`);
+    lines.push(`- Returned: interactive=${view.interactive.length}, text=${view.textBlocks.length}, forms=${view.forms.length}, media=${view.media.length}, alerts=${view.alerts.length}`);
+    lines.push(`- Snapshot: ${snapshotId}`);
+    lines.push('');
+    if (view.includeSections.interactive) {
+        lines.push('## Interactive Elements');
+        if (view.interactive.length === 0) {
+            lines.push('- (none)');
+        }
+        else {
+            for (const element of view.interactive) {
+                const roleText = element.role ? ` role=${element.role}` : '';
+                const stateText = element.state.length > 0 ? element.state.join(', ') : 'none';
+                const groupText = element.groupId || 'G0';
+                const hrefText = element.href ? ` href=${normalizeLine(element.href, 120)}` : '';
+                const selectOptionsText = formatSelectOptions(element.selectOptions);
+                lines.push(`- **${element.id}** [${element.category}] \`${element.tag}${roleText}\` "${normalizeLine(element.name || '(unnamed)', 120)}" | actions=${element.actions.join(', ')} | state=${stateText} | locator=${normalizeLine(getLocatorText(element.locator), 120)} | group=${groupText} | box=(${element.bbox.x},${element.bbox.y},${element.bbox.width}x${element.bbox.height})${hrefText}${selectOptionsText}`);
+            }
+        }
+        lines.push('');
+    }
+    if (view.includeSections.text) {
+        lines.push('## Text Blocks');
+        if (view.textBlocks.length === 0) {
+            lines.push('- (none)');
+        }
+        else {
+            for (const block of view.textBlocks) {
+                const levelSuffix = block.level ? ` h${block.level}` : '';
+                const groupText = block.groupId || 'G0';
+                lines.push(`- **${block.id}** [${block.kind}${levelSuffix}] ${normalizeLine(block.text, 280)} | group=${groupText}`);
+            }
+        }
+        lines.push('');
+    }
+    if (view.includeSections.forms) {
+        lines.push('## Forms');
+        if (view.forms.length === 0) {
+            lines.push('- (none)');
+        }
+        else {
+            for (const form of view.forms) {
+                const fieldText = form.fields.length > 0 ? form.fields.join(', ') : '(none)';
+                const submitText = form.submitButtons.length > 0 ? form.submitButtons.join(', ') : '(none)';
+                lines.push(`- **${form.id}** ${normalizeLine(form.name || '(unnamed)', 120)} | fields=${normalizeLine(fieldText, 180)} | submit=${normalizeLine(submitText, 120)}`);
+            }
+        }
+        lines.push('');
+    }
+    if (view.includeSections.media) {
+        lines.push('## Media');
+        if (view.media.length === 0) {
+            lines.push('- (none)');
+        }
+        else {
+            for (const item of view.media) {
+                const stateText = item.state.length > 0 ? item.state.join(', ') : 'unknown';
+                lines.push(`- **${item.id}** [${item.kind}] "${normalizeLine(item.name || '(unnamed)', 120)}" | state=${stateText} | time=${item.currentTime.toFixed(1)}/${item.duration >= 0 ? item.duration.toFixed(1) : 'live/unknown'}`);
+            }
+        }
+        lines.push('');
+    }
+    if (view.includeSections.alerts) {
+        lines.push('## Alerts');
+        if (view.alerts.length === 0) {
+            lines.push('- (none)');
+        }
+        else {
+            for (const alert of view.alerts) {
+                lines.push(`- ${normalizeLine(alert, 260)}`);
+            }
+        }
+        lines.push('');
+    }
+    lines.push('## Notes');
+    if (options.filters.length > 0) {
+        lines.push(`- Applied filters: ${options.filters.join(', ')}`);
+    }
+    else {
+        lines.push('- Applied filters: none');
+    }
+    lines.push('- Items with the same group id (`group=G*`) are likely in the same visual container.');
+    if (snapshot.truncation.interactive) {
+        lines.push(`- Interactive elements truncated (${snapshot.summary.interactiveCount}/${snapshot.summary.totalInteractiveCount}).`);
+    }
+    if (snapshot.truncation.textBlocks) {
+        lines.push(`- Text blocks truncated (${snapshot.summary.textBlockCount}/${snapshot.summary.totalTextBlockCount}).`);
+    }
+    if (snapshot.truncation.hiddenFilteredCount > 0) {
+        lines.push(`- ${snapshot.truncation.hiddenFilteredCount} hidden elements were excluded.`);
+    }
+    if (snapshot.truncation.offscreenFilteredCount > 0) {
+        lines.push(`- ${snapshot.truncation.offscreenFilteredCount} offscreen elements were excluded.`);
+    }
+    if (snapshot.warnings.length > 0) {
+        for (const warning of snapshot.warnings) {
+            lines.push(`- ${normalizeLine(warning, 260)}`);
+        }
+    }
+    lines.push(`- Full snapshot file: ${snapshotPath}`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=helpers.js.map

package/dist/sdk/observe/helpers.js.map

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

package/dist/sdk/observe/index.d.ts

@@ -0,0 +1,6 @@
+export { buildObserveScript } from './script.js';
+export { createObserveView, normalizeObserveOptions, parseObserveSnapshot, renderObserveMarkdown, } from './helpers.js';
+export { getObserveLatestPath, getObserveTabDir, persistObserveSnapshot, readLatestObserveSnapshot, } from './storage.js';
+export type { ObserveSnapshotPointer, ObserveSnapshotRecord } from './storage.js';
+export type { NormalizedObserveOptions, ObserveBBox, ObserveFilter, ObserveFormSummary, ObserveInteractiveCategory, ObserveInteractiveElement, ObserveLocator, ObserveMediaElement, ObservePageInfo, ObservePageSummary, ObserveSelectOption, ObserveSnapshot, ObserveTextBlock, ObserveTruncation, ObserveView, WindowObserveOptions, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/sdk/observe/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/sdk/observe/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAClF,YAAY,EACV,wBAAwB,EACxB,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,0BAA0B,EAC1B,yBAAyB,EACzB,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,oBAAoB,GACrB,MAAM,YAAY,CAAC"}

package/dist/sdk/observe/index.js

@@ -0,0 +1,4 @@
+export { buildObserveScript } from './script.js';
+export { createObserveView, normalizeObserveOptions, parseObserveSnapshot, renderObserveMarkdown, } from './helpers.js';
+export { getObserveLatestPath, getObserveTabDir, persistObserveSnapshot, readLatestObserveSnapshot, } from './storage.js';
+//# sourceMappingURL=index.js.map

package/dist/sdk/observe/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/sdk/observe/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,cAAc,CAAC"}

package/dist/sdk/observe/script.d.ts

@@ -0,0 +1,7 @@
+interface ObserveScriptOptions {
+    maxInteractive: number;
+    maxTextBlocks: number;
+}
+export declare function buildObserveScript(options: ObserveScriptOptions): string;
+export {};
+//# sourceMappingURL=script.d.ts.map

package/dist/sdk/observe/script.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"script.d.ts","sourceRoot":"","sources":["../../../src/sdk/observe/script.ts"],"names":[],"mappings":"AAAA,UAAU,oBAAoB;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,CAuqBxE"}