@getcolter/sdk 0.1.0

package/LICENSE

@@ -0,0 +1,2 @@
+See repository license at ../../LICENSE.
+

package/README.md

@@ -0,0 +1,149 @@
+# @getcolter/sdk
+
+Official Node.js SDK for Colter.
+
+It supports:
+- Hosted API client (`/api/v1/*`): `check`, `results`, `shares` (revocable share links + PDF).
+- Local CLI runner wrapper: programmatic access to CLI-only features like `verify`, `replay`, `diff`, `export`.
+
+## Installation
+
+```bash
+npm install @getcolter/sdk
+```
+
+## Quick start
+
+```typescript
+import { ColterClient } from '@getcolter/sdk';
+
+const client = new ColterClient();
+
+const result = await client.check('example-store.com');
+
+console.log(result.verdict);       // "AGENT-READY" | "PARTIALLY AGENT-READY" | "NOT AGENT-READY"
+console.log(result.agent_ready);   // true if any protocol detected
+console.log(result.protocols.ucp); // { detected: true, endpoint: "/.well-known/ucp", ... }
+console.log(result.protocols.acp); // { detected: false, error: "...", ... }
+```
+
+## Share links (revocable + expiring)
+
+```ts
+import { ColterClient } from "@getcolter/sdk";
+
+const client = new ColterClient();
+
+const share = await client.createShare({
+  result_id: "00000000-0000-0000-0000-000000000000",
+  brand: "Acme Agency",
+  whitelabel: true,
+  client_friendly: true,
+  expires_in_days: 30,
+});
+
+console.log(share.url); // https://agenticcom.ai/s/<token>
+```
+
+## Local CLI runner (feature parity)
+
+```ts
+import { ColterCLI } from "@getcolter/sdk";
+
+const cli = new ColterCLI(); // requires `colter` on PATH (or set COLTER_PATH)
+const result = await cli.check("example.com");
+const { pack } = await cli.verify("example.com", { throwOnFail: false });
+```
+
+## Configuration
+
+```typescript
+// Custom base URL (for self-hosted or staging)
+const client = new ColterClient({
+  baseUrl: 'https://staging.agenticcom.ai',
+});
+```
+
+## API reference
+
+### `new ColterClient(options?)`
+
+Creates a new Colter API client.
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `baseUrl` | `string` | `https://agenticcom.ai` | API base URL |
+
+### `client.check(url): Promise<CheckResult>`
+
+Runs an agent-readiness check against the given store URL. The URL can be a bare domain (e.g. `"example.com"`) or include a scheme.
+
+Throws `ColterError` for HTTP errors (400, 422, 429, 5xx).
+
+### `client.getResult(id): Promise<CheckResult>`
+
+Fetch a stored result by id.
+
+### `client.getResultPdf(id, opts?): Promise<ArrayBuffer>`
+
+Download a PDF for a stored result.
+
+### `client.createShare(req): Promise<ShareCreateResponse>`
+
+Create a revocable share token for a result.
+
+### `client.resolveShare(token): Promise<ShareResolveResponse>`
+
+Resolve a share token to the result plus share metadata.
+
+### `client.getSharePdf(token): Promise<ArrayBuffer>`
+
+Download the branded PDF for a share token.
+
+### `client.revokeShare(token, revokeToken): Promise<{ ok: true; revoked: true }>`
+
+Revoke a share token.
+
+### Error handling
+
+```typescript
+import { ColterClient, ColterError } from '@getcolter/sdk';
+
+try {
+  const result = await client.check('example.com');
+} catch (err) {
+  if (err instanceof ColterError) {
+    console.error(`Status ${err.statusCode}: ${err.message}`);
+    if (err.retryAfter) {
+      console.error(`Retry in ${err.retryAfter}s`);
+    }
+  }
+}
+```
+
+### Types
+
+All response types are exported:
+
+- `CheckResult` — full readiness check response
+- `ProtocolStatus` — UCP, ACP, MCP detection results
+- `ProtocolCheck` — single protocol detection
+- `WebSignals` — JSON-LD, sitemap, robots.txt, OG tags
+- `StoreStatus` — platform, product count, detectability
+- `CoverageStatus` — Google and OpenAI ecosystem coverage
+- `PlainLanguage` — merchant, agency, developer summaries
+- `Verdict` — `"AGENT-READY" | "PARTIALLY AGENT-READY" | "NOT AGENT-READY"`
+- `ShareCreateRequest`, `ShareCreateResponse`, `ShareResolveResponse`
+
+## Requirements
+
+- Node.js >= 18.0.0 (uses native `fetch`)
+- Zero runtime dependencies
+
+## Rate limits
+
+The Colter API is rate limited to 5 requests per minute per IP. When rate limited, `check()` throws a `ColterError` with `statusCode: 429` and `retryAfter` set to the number of seconds to wait.
+
+## Docs
+
+Full documentation at [agenticcom.ai/docs](https://agenticcom.ai/docs).

package/dist/index.d.ts

@@ -0,0 +1,103 @@
+export type { CheckResult, ProtocolCheck, ProtocolStatus, StoreStatus, CoverageStatus, WebSignals, PlainLanguage, Verdict, ShareCreateRequest, ShareCreateResponse, ShareResolveResponse, } from './types.js';
+import type { CheckResult, ShareCreateRequest, ShareCreateResponse, ShareResolveResponse } from './types.js';
+/** SDK version sent in the User-Agent header. */
+export declare const VERSION = "0.1.0";
+/** Default Colter API base URL. */
+export declare const DEFAULT_BASE_URL = "https://agenticcom.ai";
+/** Options for creating a ColterClient. */
+export interface ColterClientOptions {
+    /** API base URL (no trailing slash). Defaults to `https://agenticcom.ai`. */
+    baseUrl?: string;
+}
+/**
+ * Error returned when the Colter API responds with a non-2xx status.
+ */
+export declare class ColterError extends Error {
+    /** HTTP status code from the API. */
+    readonly statusCode: number;
+    /** Seconds until the rate limit resets (only set for 429 responses). */
+    readonly retryAfter?: number;
+    constructor(statusCode: number, message: string, retryAfter?: number);
+}
+/**
+ * Client for the Colter public API.
+ *
+ * @example
+ * ```ts
+ * const client = new ColterClient();
+ * const result = await client.check('example-store.com');
+ * console.log(result.verdict);
+ * ```
+ */
+export declare class ColterClient {
+    private readonly baseUrl;
+    constructor(options?: ColterClientOptions);
+    /**
+     * Run an agent-readiness check against the given store URL.
+     *
+     * @param url - Store URL to check. Scheme is optional (defaults to `https://`).
+     * @returns Full readiness check result.
+     * @throws {ColterError} When the API returns a non-2xx response.
+     */
+    check(url: string): Promise<CheckResult>;
+    /** Fetch a stored readiness result by id. */
+    getResult(id: string): Promise<CheckResult>;
+    /** Download a PDF export for a stored readiness result. */
+    getResultPdf(id: string, opts?: {
+        brand?: string;
+        logo?: string;
+        whitelabel?: boolean;
+        client_friendly?: boolean;
+    }): Promise<ArrayBuffer>;
+    /** Create a revocable, expiring share link for a result id. */
+    createShare(req: ShareCreateRequest): Promise<ShareCreateResponse>;
+    /** Resolve a share token to a readiness result and share metadata. */
+    resolveShare(token: string): Promise<ShareResolveResponse>;
+    /** Download the branded PDF for a share token (branding comes from the share record). */
+    getSharePdf(token: string): Promise<ArrayBuffer>;
+    /** Revoke a share token using its revoke secret. */
+    revokeShare(token: string, revokeToken: string): Promise<{
+        ok: true;
+        revoked: true;
+    }>;
+}
+export declare class ColterCLIError extends Error {
+    readonly exitCode: number | null;
+    readonly stdout: string;
+    readonly stderr: string;
+    constructor(message: string, exitCode: number | null, stdout: string, stderr: string);
+}
+export interface ColterCLIOptions {
+    /** Path to the `colter` executable. If not set, uses COLTER_PATH or PATH lookup. */
+    colterPath?: string;
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+    timeoutMs?: number;
+}
+export declare class ColterCLI {
+    private readonly colterPath;
+    private readonly cwd?;
+    private readonly env?;
+    private readonly timeoutMs?;
+    constructor(opts?: ColterCLIOptions);
+    private run;
+    check(url: string): Promise<CheckResult>;
+    verify(target: string, opts?: {
+        protocols?: string[];
+        out?: string;
+        tests?: string[];
+        schemaAcp?: string;
+        schemaUcp?: string;
+        throwOnFail?: boolean;
+    }): Promise<{
+        pack: unknown;
+        exitCode: number | null;
+    }>;
+    replay(packPath: string, opts?: {
+        live?: boolean;
+    }): Promise<unknown>;
+    diff(packA: string, packB: string): Promise<unknown>;
+    exportJson(packPath: string): Promise<unknown>;
+    version(): Promise<string>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,301 @@
+import { spawn } from 'node:child_process';
+import { promisify } from 'node:util';
+import { execFile } from 'node:child_process';
+import { existsSync } from 'node:fs';
+/** SDK version sent in the User-Agent header. */
+export const VERSION = '0.1.0';
+/** Default Colter API base URL. */
+export const DEFAULT_BASE_URL = 'https://agenticcom.ai';
+/**
+ * Error returned when the Colter API responds with a non-2xx status.
+ */
+export class ColterError extends Error {
+    constructor(statusCode, message, retryAfter) {
+        super(message);
+        this.name = 'ColterError';
+        this.statusCode = statusCode;
+        this.retryAfter = retryAfter;
+    }
+}
+/**
+ * Client for the Colter public API.
+ *
+ * @example
+ * ```ts
+ * const client = new ColterClient();
+ * const result = await client.check('example-store.com');
+ * console.log(result.verdict);
+ * ```
+ */
+export class ColterClient {
+    constructor(options) {
+        this.baseUrl = options?.baseUrl ?? DEFAULT_BASE_URL;
+    }
+    /**
+     * Run an agent-readiness check against the given store URL.
+     *
+     * @param url - Store URL to check. Scheme is optional (defaults to `https://`).
+     * @returns Full readiness check result.
+     * @throws {ColterError} When the API returns a non-2xx response.
+     */
+    async check(url) {
+        const response = await fetch(`${this.baseUrl}/api/v1/check`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'User-Agent': `colter-node/${VERSION}`,
+                Accept: 'application/json',
+            },
+            body: JSON.stringify({ url }),
+        });
+        if (!response.ok) {
+            const body = await response.json().catch(() => ({ error: 'Unknown error' }));
+            const message = typeof body.error === 'string' ? body.error : 'Request failed';
+            const retryAfter = typeof body.retryAfter === 'number' ? body.retryAfter : undefined;
+            throw new ColterError(response.status, message, retryAfter);
+        }
+        return response.json();
+    }
+    /** Fetch a stored readiness result by id. */
+    async getResult(id) {
+        const response = await fetch(`${this.baseUrl}/api/v1/results/${encodeURIComponent(id)}`, {
+            method: 'GET',
+            headers: {
+                'User-Agent': `colter-node/${VERSION}`,
+                Accept: 'application/json',
+            },
+        });
+        if (!response.ok) {
+            const body = await response.json().catch(() => ({ error: 'Unknown error' }));
+            const message = typeof body.error === 'string' ? body.error : 'Request failed';
+            throw new ColterError(response.status, message);
+        }
+        return response.json();
+    }
+    /** Download a PDF export for a stored readiness result. */
+    async getResultPdf(id, opts) {
+        const qs = new URLSearchParams();
+        if (opts?.brand)
+            qs.set('brand', opts.brand);
+        if (opts?.logo)
+            qs.set('logo', opts.logo);
+        if (opts?.whitelabel)
+            qs.set('whitelabel', 'true');
+        if (opts?.client_friendly)
+            qs.set('client_friendly', 'true');
+        const url = `${this.baseUrl}/api/v1/results/${encodeURIComponent(id)}/pdf${qs.size ? `?${qs.toString()}` : ''}`;
+        const response = await fetch(url, {
+            method: 'GET',
+            headers: { 'User-Agent': `colter-node/${VERSION}`, Accept: 'application/pdf' },
+        });
+        if (!response.ok) {
+            const bodyText = await response.text().catch(() => '');
+            throw new ColterError(response.status, bodyText || 'Request failed');
+        }
+        return response.arrayBuffer();
+    }
+    /** Create a revocable, expiring share link for a result id. */
+    async createShare(req) {
+        const response = await fetch(`${this.baseUrl}/api/v1/shares`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'User-Agent': `colter-node/${VERSION}`,
+                Accept: 'application/json',
+            },
+            body: JSON.stringify(req),
+        });
+        if (!response.ok) {
+            const body = await response.json().catch(() => ({ error: 'Unknown error' }));
+            const message = typeof body.error === 'string' ? body.error : 'Request failed';
+            throw new ColterError(response.status, message);
+        }
+        return response.json();
+    }
+    /** Resolve a share token to a readiness result and share metadata. */
+    async resolveShare(token) {
+        const response = await fetch(`${this.baseUrl}/api/v1/shares/${encodeURIComponent(token)}`, {
+            method: 'GET',
+            headers: { 'User-Agent': `colter-node/${VERSION}`, Accept: 'application/json' },
+        });
+        if (!response.ok) {
+            const body = await response.json().catch(() => ({ error: 'Unknown error' }));
+            const message = typeof body.error === 'string' ? body.error : 'Request failed';
+            throw new ColterError(response.status, message);
+        }
+        return response.json();
+    }
+    /** Download the branded PDF for a share token (branding comes from the share record). */
+    async getSharePdf(token) {
+        const response = await fetch(`${this.baseUrl}/api/v1/shares/${encodeURIComponent(token)}/pdf`, {
+            method: 'GET',
+            headers: { 'User-Agent': `colter-node/${VERSION}`, Accept: 'application/pdf' },
+        });
+        if (!response.ok) {
+            const bodyText = await response.text().catch(() => '');
+            throw new ColterError(response.status, bodyText || 'Request failed');
+        }
+        return response.arrayBuffer();
+    }
+    /** Revoke a share token using its revoke secret. */
+    async revokeShare(token, revokeToken) {
+        const response = await fetch(`${this.baseUrl}/api/v1/shares/${encodeURIComponent(token)}/revoke`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'User-Agent': `colter-node/${VERSION}`,
+                Accept: 'application/json',
+            },
+            body: JSON.stringify({ revoke_token: revokeToken }),
+        });
+        if (!response.ok) {
+            const body = await response.json().catch(() => ({ error: 'Unknown error' }));
+            const message = typeof body.error === 'string' ? body.error : 'Request failed';
+            throw new ColterError(response.status, message);
+        }
+        return response.json();
+    }
+}
+export class ColterCLIError extends Error {
+    constructor(message, exitCode, stdout, stderr) {
+        super(message);
+        this.name = 'ColterCLIError';
+        this.exitCode = exitCode;
+        this.stdout = stdout;
+        this.stderr = stderr;
+    }
+}
+const execFileAsync = promisify(execFile);
+async function whichColter() {
+    const cmd = process.platform === 'win32' ? 'where' : 'which';
+    try {
+        const { stdout } = await execFileAsync(cmd, ['colter'], { encoding: 'utf8' });
+        const p = stdout.trim().split(/\r?\n/)[0];
+        return p && existsSync(p) ? p : null;
+    }
+    catch {
+        return null;
+    }
+}
+export class ColterCLI {
+    constructor(opts) {
+        this.cwd = opts?.cwd;
+        this.env = opts?.env;
+        this.timeoutMs = opts?.timeoutMs;
+        const explicit = opts?.colterPath || process.env.COLTER_PATH;
+        this.colterPath = (async () => {
+            if (explicit)
+                return explicit;
+            const resolved = await whichColter();
+            if (resolved)
+                return resolved;
+            throw new ColterCLIError('colter binary not found (set COLTER_PATH or install @getcolter/cli)', null, '', '');
+        })();
+    }
+    async run(args) {
+        const bin = await this.colterPath;
+        return new Promise((resolve, reject) => {
+            const child = spawn(bin, args, {
+                cwd: this.cwd,
+                env: { ...process.env, ...this.env },
+                stdio: ['ignore', 'pipe', 'pipe'],
+            });
+            let stdout = '';
+            let stderr = '';
+            child.stdout.setEncoding('utf8');
+            child.stderr.setEncoding('utf8');
+            child.stdout.on('data', (d) => (stdout += d));
+            child.stderr.on('data', (d) => (stderr += d));
+            let timer;
+            if (this.timeoutMs && this.timeoutMs > 0) {
+                timer = setTimeout(() => {
+                    child.kill('SIGKILL');
+                }, this.timeoutMs);
+            }
+            child.on('error', (err) => {
+                if (timer)
+                    clearTimeout(timer);
+                reject(new ColterCLIError(String(err), null, stdout, stderr));
+            });
+            child.on('close', (code) => {
+                if (timer)
+                    clearTimeout(timer);
+                resolve({ stdout, stderr, exitCode: code });
+            });
+        });
+    }
+    async check(url) {
+        const r = await this.run(['check', url, '--json']);
+        try {
+            return JSON.parse(r.stdout);
+        }
+        catch {
+            throw new ColterCLIError('failed to parse JSON output from colter check', r.exitCode, r.stdout, r.stderr);
+        }
+    }
+    async verify(target, opts) {
+        const args = ['verify', target, '--json'];
+        if (opts?.out)
+            args.push('--out', opts.out);
+        if (opts?.protocols?.length)
+            args.push('--protocols', opts.protocols.join(','));
+        if (opts?.schemaAcp)
+            args.push('--schema-acp', opts.schemaAcp);
+        if (opts?.schemaUcp)
+            args.push('--schema-ucp', opts.schemaUcp);
+        if (opts?.tests?.length) {
+            for (const t of opts.tests)
+                args.push('--tests', t);
+        }
+        const r = await this.run(args);
+        let pack;
+        try {
+            pack = JSON.parse(r.stdout);
+        }
+        catch {
+            throw new ColterCLIError('failed to parse JSON output from colter verify', r.exitCode, r.stdout, r.stderr);
+        }
+        if (opts?.throwOnFail && r.exitCode && r.exitCode !== 0) {
+            throw new ColterCLIError('colter verify failed', r.exitCode, r.stdout, r.stderr);
+        }
+        return { pack, exitCode: r.exitCode };
+    }
+    async replay(packPath, opts) {
+        const args = ['replay', packPath, '--json'];
+        if (opts?.live)
+            args.push('--live');
+        const r = await this.run(args);
+        try {
+            return JSON.parse(r.stdout);
+        }
+        catch {
+            throw new ColterCLIError('failed to parse JSON output from colter replay', r.exitCode, r.stdout, r.stderr);
+        }
+    }
+    async diff(packA, packB) {
+        const r = await this.run(['diff', packA, packB, '--json']);
+        try {
+            return JSON.parse(r.stdout);
+        }
+        catch {
+            throw new ColterCLIError('failed to parse JSON output from colter diff', r.exitCode, r.stdout, r.stderr);
+        }
+    }
+    async exportJson(packPath) {
+        const r = await this.run(['export', packPath, '--format', 'json']);
+        try {
+            return JSON.parse(r.stdout);
+        }
+        catch {
+            throw new ColterCLIError('failed to parse JSON output from colter export', r.exitCode, r.stdout, r.stderr);
+        }
+    }
+    async version() {
+        const r = await this.run(['version']);
+        if (r.exitCode && r.exitCode !== 0) {
+            throw new ColterCLIError('colter version failed', r.exitCode, r.stdout, r.stderr);
+        }
+        return r.stdout.trim();
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,iDAAiD;AACjD,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAE/B,mCAAmC;AACnC,MAAM,CAAC,MAAM,gBAAgB,GAAG,uBAAuB,CAAC;AAQxD;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IAMpC,YAAY,UAAkB,EAAE,OAAe,EAAE,UAAmB;QAClE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAED;;;;;;;;;GASG;AACH,MAAM,OAAO,YAAY;IAGvB,YAAY,OAA6B;QACvC,IAAI,CAAC,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,gBAAgB,CAAC;IACtD,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,KAAK,CAAC,GAAW;QACrB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,eAAe,EAAE;YAC3D,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,YAAY,EAAE,eAAe,OAAO,EAAE;gBACtC,MAAM,EAAE,kBAAkB;aAC3B;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,CAAC;SAC9B,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC,CAA4B,CAAC;YACxG,MAAM,OAAO,GAAG,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,gBAAgB,CAAC;YAC/E,MAAM,UAAU,GAAG,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;YACrF,MAAM,IAAI,WAAW,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;QAC9D,CAAC;QAED,OAAO,QAAQ,CAAC,IAAI,EAA0B,CAAC;IACjD,CAAC;IAED,6CAA6C;IAC7C,KAAK,CAAC,SAAS,CAAC,EAAU;QACxB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,mBAAmB,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE;YACvF,MAAM,EAAE,KAAK;YACb,OAAO,EAAE;gBACP,YAAY,EAAE,eAAe,OAAO,EAAE;gBACtC,MAAM,EAAE,kBAAkB;aAC3B;SACF,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC,CAA4B,CAAC;YACxG,MAAM,OAAO,GAAG,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,gBAAgB,CAAC;YAC/E,MAAM,IAAI,WAAW,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClD,CAAC;QACD,OAAO,QAAQ,CAAC,IAAI,EAA0B,CAAC;IACjD,CAAC;IAED,2DAA2D;IAC3D,KAAK,CAAC,YAAY,CAChB,EAAU,EACV,IAAyF;QAEzF,MAAM,EAAE,GAAG,IAAI,eAAe,EAAE,CAAC;QACjC,IAAI,IAAI,EAAE,KAAK;YAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7C,IAAI,IAAI,EAAE,IAAI;YAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,IAAI,EAAE,UAAU;YAAE,EAAE,CAAC,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;QACnD,IAAI,IAAI,EAAE,eAAe;YAAE,EAAE,CAAC,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC;QAC7D,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,mBAAmB,kBAAkB,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAChH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,EAAE,YAAY,EAAE,eAAe,OAAO,EAAE,EAAE,MAAM,EAAE,iBAAiB,EAAE;SAC/E,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YACvD,MAAM,IAAI,WAAW,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,IAAI,gBAAgB,CAAC,CAAC;QACvE,CAAC;QACD,OAAO,QAAQ,CAAC,WAAW,EAAE,CAAC;IAChC,CAAC;IAED,+DAA+D;IAC/D,KAAK,CAAC,WAAW,CAAC,GAAuB;QACvC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,gBAAgB,EAAE;YAC5D,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,YAAY,EAAE,eAAe,OAAO,EAAE;gBACtC,MAAM,EAAE,kBAAkB;aAC3B;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC;SAC1B,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC,CAA4B,CAAC;YACxG,MAAM,OAAO,GAAG,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,gBAAgB,CAAC;YAC/E,MAAM,IAAI,WAAW,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClD,CAAC;QACD,OAAO,QAAQ,CAAC,IAAI,EAAkC,CAAC;IACzD,CAAC;IAED,sEAAsE;IACtE,KAAK,CAAC,YAAY,CAAC,KAAa;QAC9B,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,kBAAkB,kBAAkB,CAAC,KAAK,CAAC,EAAE,EAAE;YACzF,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,EAAE,YAAY,EAAE,eAAe,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE;SAChF,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC,CAA4B,CAAC;YACxG,MAAM,OAAO,GAAG,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,gBAAgB,CAAC;YAC/E,MAAM,IAAI,WAAW,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClD,CAAC;QACD,OAAO,QAAQ,CAAC,IAAI,EAAmC,CAAC;IAC1D,CAAC;IAED,yFAAyF;IACzF,KAAK,CAAC,WAAW,CAAC,KAAa;QAC7B,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,kBAAkB,kBAAkB,CAAC,KAAK,CAAC,MAAM,EAAE;YAC7F,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,EAAE,YAAY,EAAE,eAAe,OAAO,EAAE,EAAE,MAAM,EAAE,iBAAiB,EAAE;SAC/E,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YACvD,MAAM,IAAI,WAAW,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,IAAI,gBAAgB,CAAC,CAAC;QACvE,CAAC;QACD,OAAO,QAAQ,CAAC,WAAW,EAAE,CAAC;IAChC,CAAC;IAED,oDAAoD;IACpD,KAAK,CAAC,WAAW,CAAC,KAAa,EAAE,WAAmB;QAClD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,kBAAkB,kBAAkB,CAAC,KAAK,CAAC,SAAS,EAAE;YAChG,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,YAAY,EAAE,eAAe,OAAO,EAAE;gBACtC,MAAM,EAAE,kBAAkB;aAC3B;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC;SACpD,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC,CAA4B,CAAC;YACxG,MAAM,OAAO,GAAG,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,gBAAgB,CAAC;YAC/E,MAAM,IAAI,WAAW,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClD,CAAC;QACD,OAAO,QAAQ,CAAC,IAAI,EAA0C,CAAC;IACjE,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,KAAK;IAKvC,YAAY,OAAe,EAAE,QAAuB,EAAE,MAAc,EAAE,MAAc;QAClF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAYD,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAE1C,KAAK,UAAU,WAAW;IACxB,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;IAC7D,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QAC9E,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1C,OAAO,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,OAAO,SAAS;IAMpB,YAAY,IAAuB;QACjC,IAAI,CAAC,GAAG,GAAG,IAAI,EAAE,GAAG,CAAC;QACrB,IAAI,CAAC,GAAG,GAAG,IAAI,EAAE,GAAG,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,IAAI,EAAE,SAAS,CAAC;QAEjC,MAAM,QAAQ,GAAG,IAAI,EAAE,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;QAC7D,IAAI,CAAC,UAAU,GAAG,CAAC,KAAK,IAAI,EAAE;YAC5B,IAAI,QAAQ;gBAAE,OAAO,QAAQ,CAAC;YAC9B,MAAM,QAAQ,GAAG,MAAM,WAAW,EAAE,CAAC;YACrC,IAAI,QAAQ;gBAAE,OAAO,QAAQ,CAAC;YAC9B,MAAM,IAAI,cAAc,CAAC,qEAAqE,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QAChH,CAAC,CAAC,EAAE,CAAC;IACP,CAAC;IAEO,KAAK,CAAC,GAAG,CAAC,IAAc;QAC9B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC;QAClC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE;gBAC7B,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE;gBACpC,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;aAClC,CAAC,CAAC;YAEH,IAAI,MAAM,GAAG,EAAE,CAAC;YAChB,IAAI,MAAM,GAAG,EAAE,CAAC;YAChB,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YACjC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YACjC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC;YAC9C,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC;YAE9C,IAAI,KAAiC,CAAC;YACtC,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC;gBACzC,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;oBACtB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACxB,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;YACrB,CAAC;YAED,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBACxB,IAAI,KAAK;oBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;gBAC/B,MAAM,CAAC,IAAI,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;YAChE,CAAC,CAAC,CAAC;YACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;gBACzB,IAAI,KAAK;oBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;gBAC/B,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;YAC9C,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,GAAW;QACrB,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC;QACnD,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAgB,CAAC;QAC7C,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,cAAc,CAAC,+CAA+C,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;QAC5G,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM,CACV,MAAc,EACd,IAA8H;QAE9H,MAAM,IAAI,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC1C,IAAI,IAAI,EAAE,GAAG;YAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QAC5C,IAAI,IAAI,EAAE,SAAS,EAAE,MAAM;YAAE,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAChF,IAAI,IAAI,EAAE,SAAS;YAAE,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAC/D,IAAI,IAAI,EAAE,SAAS;YAAE,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAC/D,IAAI,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;YACxB,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK;gBAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;QACtD,CAAC;QAED,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,IAAa,CAAC;QAClB,IAAI,CAAC;YACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,cAAc,CAAC,gDAAgD,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;QAC7G,CAAC;QAED,IAAI,IAAI,EAAE,WAAW,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;YACxD,MAAM,IAAI,cAAc,CAAC,sBAAsB,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;QACnF,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,QAAgB,EAAE,IAAyB;QACtD,MAAM,IAAI,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC5C,IAAI,IAAI,EAAE,IAAI;YAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpC,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,cAAc,CAAC,gDAAgD,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;QAC7G,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAa,EAAE,KAAa;QACrC,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC3D,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,cAAc,CAAC,8CAA8C,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;QAC3G,CAAC;IACH,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,QAAgB;QAC/B,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;QACnE,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,cAAc,CAAC,gDAAgD,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;QAC7G,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAO;QACX,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;QACtC,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,cAAc,CAAC,uBAAuB,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;QACpF,CAAC;QACD,OAAO,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACzB,CAAC;CACF"}

package/dist/types.d.ts

@@ -0,0 +1,125 @@
+/** Detection result for a single protocol endpoint. */
+export interface ProtocolCheck {
+    /** Whether the protocol endpoint was found and returned valid JSON. */
+    detected: boolean;
+    /** The well-known path probed (e.g. `/.well-known/ucp`). Empty if not found. */
+    endpoint: string;
+    /** Protocol version from the manifest, if available. */
+    version: string;
+    /** Error message if detection failed. Empty on success. */
+    error: string;
+}
+/** Detection results for all agent protocols. */
+export interface ProtocolStatus {
+    ucp: ProtocolCheck;
+    acp: ProtocolCheck;
+    mcp: ProtocolCheck;
+}
+/** Detected e-commerce platform details. */
+export interface StoreStatus {
+    /** Detected platform (e.g. `shopify`, `woocommerce`, or empty). */
+    platform: string;
+    /** Confidence score for platform detection (0..1). */
+    platform_confidence: number;
+    /** Number of products detected, or 0 if unknown. */
+    product_count: number;
+    /** Detected payment provider (if known). */
+    psp?: string;
+    /** Whether the store platform could be identified. */
+    detectable: boolean;
+}
+/** Which AI ecosystems are supported. */
+export interface CoverageStatus {
+    /** True if UCP detected (Gemini, AI Mode, Copilot). */
+    google_ecosystem: boolean;
+    /** True if ACP detected (ChatGPT, Operator). */
+    openai_ecosystem: boolean;
+}
+/** Web discoverability signals found on the store. */
+export interface WebSignals {
+    /** True if the page contains JSON-LD structured data. */
+    json_ld_found: boolean;
+    /** Schema.org types found (e.g. `["Product", "Organization"]`). */
+    json_ld_types: string[];
+    /** True if `/sitemap.xml` is accessible. */
+    sitemap_found: boolean;
+    /** True if `/robots.txt` exists and allows crawling. */
+    robots_txt_found: boolean;
+    /** True if Open Graph meta tags are present. */
+    og_tags_found: boolean;
+}
+/** Per-persona summaries of the check result. */
+export interface PlainLanguage {
+    /** Business-focused summary for store owners. */
+    merchant: string;
+    /** Portfolio-focused summary for agencies managing multiple stores. */
+    agency: string;
+    /** Technical summary with protocol pass/fail details. */
+    developer: string;
+}
+/** A structured next-step suggestion (in addition to the free-form recommendation string). */
+export interface NextStep {
+    kind: 'cli';
+    command: 'colter';
+    args: string[];
+    reason: string;
+}
+/** Overall readiness verdict. */
+export type Verdict = 'AGENT-READY' | 'PARTIALLY AGENT-READY' | 'NOT AGENT-READY';
+/** Full response from a Colter readiness check. */
+export interface CheckResult {
+    /** Normalized hostname of the store that was checked. */
+    url: string;
+    /** True if at least one protocol (UCP or ACP) is detected. */
+    agent_ready: boolean;
+    /** True if both UCP and ACP are detected. */
+    fully_covered: boolean;
+    /** Protocol detection results. */
+    protocols: ProtocolStatus;
+    /** Web discoverability signals. */
+    web_signals: WebSignals;
+    /** Detected store platform details. */
+    store: StoreStatus;
+    /** AI ecosystem coverage. */
+    coverage: CoverageStatus;
+    /** Overall readiness verdict. */
+    verdict: Verdict;
+    /** Suggested next CLI command, or empty if fully ready. */
+    recommendation: string;
+    /** Structured next-step suggestion (optional). */
+    next_step?: NextStep;
+    /** Per-persona summaries. */
+    plain_language: PlainLanguage;
+    /** ISO 8601 timestamp of when the check was performed. */
+    checked_at: string;
+    /** Unique identifier for this check result. */
+    result_id?: string;
+}
+export interface ShareCreateRequest {
+    result_id: string;
+    brand?: string;
+    logo?: string;
+    whitelabel?: boolean;
+    client_friendly?: boolean;
+    expires_in_days?: number;
+}
+export interface ShareCreateResponse {
+    token: string;
+    url: string;
+    revoke_token: string;
+    expires_at: string;
+}
+export interface ShareResolved {
+    token: string;
+    result_id: string;
+    brand?: string | null;
+    logo?: string | null;
+    whitelabel: boolean;
+    client_friendly: boolean;
+    expires_at: string;
+}
+export interface ShareResolveResponse {
+    share: ShareResolved;
+    result: CheckResult;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@getcolter/sdk",
+  "version": "0.1.0",
+  "description": "Official Colter SDK for Node.js — check if AI agents can shop your store",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepare": "npm run build",
+    "test": "npm run build && node --test test/*.test.mjs"
+  },
+  "keywords": [
+    "colter",
+    "agentic-commerce",
+    "ucp",
+    "acp",
+    "ai-agents",
+    "agent-ready",
+    "e-commerce"
+  ],
+  "author": "Colter <hello@agenticcom.ai>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mfbahc/agentic-com.git"
+  },
+  "homepage": "https://agenticcom.ai/docs",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.3.0"
+  }
+}