@ahtmljs/agent 0.1.0

package/dist/client.d.ts

@@ -0,0 +1,53 @@
+/**
+ * AHTMLClient — the agent-side fetcher.
+ *
+ * Behaviour worth understanding:
+ *
+ *   - Defaults to Accept: application/ahtml+text (compact, token-optimal).
+ *   - Caches snapshots by URL keyed on ETag.
+ *   - On second fetch sends If-None-Match; 304 reuses cached body.
+ *   - Optional diff mode sends ?since=<etag>; reconstructs snapshot via applyDiff.
+ *   - Respects the site's TTL when deciding to skip the network entirely.
+ *
+ * No network library — uses the global fetch (Node 20+, modern browsers).
+ */
+import { type Snapshot } from '@ahtmljs/schema';
+export interface FetchOptions {
+    /** "compact" (default, token-optimal) or "json". */
+    format?: 'compact' | 'json';
+    /** Bypass the local cache. */
+    noCache?: boolean;
+    /** Allow returning a stale-but-cached snapshot if the network fails. */
+    allowStale?: boolean;
+    /** Identity header. Set this when AHTML providers gate by agent identity. */
+    agent?: string;
+    /** Auth bearer for action execution endpoints. */
+    bearer?: string;
+    /** Custom fetch override (testing). */
+    fetch?: typeof fetch;
+}
+export interface CachedSnapshot {
+    snapshot: Snapshot;
+    fetchedAt: number;
+    etag?: string;
+}
+export declare class AHTMLClient {
+    private defaults;
+    private cache;
+    constructor(defaults?: FetchOptions);
+    /**
+     * Fetch the snapshot for a URL. Uses ETag-based incremental fetch by
+     * default; falls back to the diff endpoint when the cached snapshot is
+     * stale enough that the server might prefer to send a delta.
+     */
+    fetch(url: string, opts?: FetchOptions): Promise<Snapshot>;
+    private storeFromResponse;
+    invalidate(url?: string): void;
+    /** Discover a site's manifest. Returns the parsed JSON. */
+    manifest(siteOrUrl: string, opts?: FetchOptions): Promise<unknown>;
+}
+export declare class AHTMLError extends Error {
+    status: number;
+    constructor(status: number, message: string);
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAIL,KAAK,QAAQ,EAEd,MAAM,iBAAiB,CAAC;AAEzB,MAAM,WAAW,YAAY;IAC3B,oDAAoD;IACpD,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAC5B,8BAA8B;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,wEAAwE;IACxE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,WAAW;IAGV,OAAO,CAAC,QAAQ;IAF5B,OAAO,CAAC,KAAK,CAAqC;gBAE9B,QAAQ,GAAE,YAAiB;IAE/C;;;;OAIG;IACG,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,QAAQ,CAAC;YAsEtD,iBAAiB;IAW/B,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAK9B,2DAA2D;IACrD,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,OAAO,CAAC;CAU7E;AAED,qBAAa,UAAW,SAAQ,KAAK;IAChB,MAAM,EAAE,MAAM;gBAAd,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAInD"}

package/dist/client.js

@@ -0,0 +1,142 @@
+/**
+ * AHTMLClient — the agent-side fetcher.
+ *
+ * Behaviour worth understanding:
+ *
+ *   - Defaults to Accept: application/ahtml+text (compact, token-optimal).
+ *   - Caches snapshots by URL keyed on ETag.
+ *   - On second fetch sends If-None-Match; 304 reuses cached body.
+ *   - Optional diff mode sends ?since=<etag>; reconstructs snapshot via applyDiff.
+ *   - Respects the site's TTL when deciding to skip the network entirely.
+ *
+ * No network library — uses the global fetch (Node 20+, modern browsers).
+ */
+import { fromCompact, fromJson, applyDiff, } from '@ahtmljs/schema';
+export class AHTMLClient {
+    defaults;
+    cache = new Map();
+    constructor(defaults = {}) {
+        this.defaults = defaults;
+    }
+    /**
+     * Fetch the snapshot for a URL. Uses ETag-based incremental fetch by
+     * default; falls back to the diff endpoint when the cached snapshot is
+     * stale enough that the server might prefer to send a delta.
+     */
+    async fetch(url, opts = {}) {
+        const o = { ...this.defaults, ...opts };
+        const fetcher = o.fetch ?? globalThis.fetch;
+        const cached = this.cache.get(url);
+        // 1) Fresh cache (within TTL) — skip the network entirely.
+        if (cached && !o.noCache && isFresh(cached)) {
+            return cached.snapshot;
+        }
+        const accept = o.format === 'json'
+            ? 'application/ahtml+json'
+            : 'application/ahtml+text';
+        // 2) Try a diff request if we already have a snapshot.
+        if (cached && !o.noCache) {
+            const diffUrl = url + (url.includes('?') ? '&' : '?') + 'since=' + encodeURIComponent(cached.etag ?? '');
+            const res = await fetcher(diffUrl, {
+                headers: {
+                    'accept': 'application/ahtml-diff+json, ' + accept,
+                    ...(o.agent && { 'user-agent': o.agent }),
+                },
+            }).catch((err) => failOrStale(err, cached, o));
+            if (res instanceof Response) {
+                const ct = res.headers.get('content-type') ?? '';
+                if (res.ok && ct.includes('application/ahtml-diff+json')) {
+                    const d = (await res.json());
+                    const next = applyDiff(cached.snapshot, d);
+                    const etag = res.headers.get('etag') ?? d.to_etag;
+                    this.cache.set(url, { snapshot: next, fetchedAt: Date.now(), etag });
+                    return next;
+                }
+                if (res.ok && ct.includes('application/ahtml')) {
+                    return this.storeFromResponse(url, res);
+                }
+                if (res.status === 304) {
+                    this.cache.set(url, { ...cached, fetchedAt: Date.now() });
+                    return cached.snapshot;
+                }
+                // anything else — fall through to a fresh fetch
+            }
+        }
+        // 3) Conditional or fresh GET.
+        const headers = { accept };
+        if (cached?.etag && !o.noCache)
+            headers['if-none-match'] = cached.etag;
+        if (o.agent)
+            headers['user-agent'] = o.agent;
+        let res;
+        try {
+            res = await fetcher(url, { headers });
+        }
+        catch (err) {
+            const fb = failOrStale(err, cached, o);
+            if (fb instanceof Response)
+                res = fb;
+            else
+                throw err;
+        }
+        if (res.status === 304 && cached) {
+            this.cache.set(url, { ...cached, fetchedAt: Date.now() });
+            return cached.snapshot;
+        }
+        if (!res.ok) {
+            if (cached && o.allowStale)
+                return cached.snapshot;
+            throw new AHTMLError(res.status, await res.text());
+        }
+        return this.storeFromResponse(url, res);
+    }
+    async storeFromResponse(url, res) {
+        const ct = res.headers.get('content-type') ?? '';
+        const body = await res.text();
+        const snapshot = ct.includes('application/ahtml+json')
+            ? fromJson(body)
+            : fromCompact(body);
+        const etag = res.headers.get('etag') ?? undefined;
+        this.cache.set(url, { snapshot, fetchedAt: Date.now(), etag });
+        return snapshot;
+    }
+    invalidate(url) {
+        if (url)
+            this.cache.delete(url);
+        else
+            this.cache.clear();
+    }
+    /** Discover a site's manifest. Returns the parsed JSON. */
+    async manifest(siteOrUrl, opts = {}) {
+        const fetcher = opts.fetch ?? globalThis.fetch;
+        const base = siteOrUrl.replace(/\/$/, '');
+        const url = base.endsWith('/.well-known/ahtml.json')
+            ? base
+            : base + '/.well-known/ahtml.json';
+        const res = await fetcher(url, { headers: { accept: 'application/json' } });
+        if (!res.ok)
+            throw new AHTMLError(res.status, `manifest fetch failed for ${url}`);
+        return res.json();
+    }
+}
+export class AHTMLError extends Error {
+    status;
+    constructor(status, message) {
+        super(`AHTML ${status}: ${message}`);
+        this.status = status;
+        this.name = 'AHTMLError';
+    }
+}
+function isFresh(cached) {
+    const ttl = cached.snapshot.ttl;
+    if (ttl == null)
+        return false;
+    return Date.now() - cached.fetchedAt < ttl * 1000;
+}
+function failOrStale(err, cached, o) {
+    if (cached && o.allowStale) {
+        return new Response(null, { status: 504 }); // signal caller to keep cached
+    }
+    return err;
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @ahtmljs/agent — public API.
+ */
+export { AHTMLClient, type FetchOptions, type CachedSnapshot } from './client.js';
+export { runAction, type ActionRunOptions, type ActionResult, type DryRunResult } from './workflow.js';
+export { countTokens, countTokensClaude, countTokensGpt, measure, type TokenMeasurement, } from './tokens.js';
+//# 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":"AAAA;;GAEG;AACH,OAAO,EAAE,WAAW,EAAE,KAAK,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAClF,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AACvG,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,OAAO,EACP,KAAK,gBAAgB,GACtB,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+/**
+ * @ahtmljs/agent — public API.
+ */
+export { AHTMLClient } from './client.js';
+export { runAction } from './workflow.js';
+export { countTokens, countTokensClaude, countTokensGpt, measure, } from './tokens.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,WAAW,EAA0C,MAAM,aAAa,CAAC;AAClF,OAAO,EAAE,SAAS,EAA+D,MAAM,eAAe,CAAC;AACvG,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,OAAO,GAER,MAAM,aAAa,CAAC"}

package/dist/tokens.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Token measurement using industry-standard tokenizers.
+ *
+ *   gpt-tokenizer            — OpenAI's tiktoken (cl100k_base, o200k_base) in pure JS.
+ *                              Used in the vast majority of public token-cost reports.
+ *   @anthropic-ai/tokenizer  — Claude's official BPE tokenizer.
+ *
+ * Both are peer dependencies — install whichever you need:
+ *
+ *   npm i gpt-tokenizer            # OpenAI / GPT-4 / GPT-4o / o-series
+ *   npm i @anthropic-ai/tokenizer  # Anthropic / Claude
+ *
+ * If the package is not present, the corresponding function throws a
+ * helpful error. We do NOT fall back to char/4 — that's the kind of
+ * non-rigorous measurement we want this library to be the opposite of.
+ */
+export type TokenizerModel = 'gpt-3.5-turbo' | 'gpt-4' | 'gpt-4o' | 'gpt-4o-mini' | 'o1' | 'o3-mini' | 'claude' | 'claude-haiku' | 'claude-sonnet' | 'claude-opus';
+export interface TokenMeasurement {
+    bytes: number;
+    bytes_gzip?: number;
+    tokens_openai_cl100k?: number;
+    tokens_openai_o200k?: number;
+    tokens_anthropic?: number;
+}
+/** Count tokens with the OpenAI tiktoken-compatible tokenizer. */
+export declare function countTokensGpt(text: string, encoding?: 'cl100k_base' | 'o200k_base'): Promise<number>;
+/** Count tokens with Anthropic's official Claude tokenizer. */
+export declare function countTokensClaude(text: string): Promise<number>;
+/** Best-effort count for a model name. */
+export declare function countTokens(text: string, model: TokenizerModel): Promise<number>;
+/** Take a snapshot of every metric we care about. Skips unavailable tokenizers gracefully. */
+export declare function measure(text: string, opts?: {
+    gzip?: boolean;
+}): Promise<TokenMeasurement>;
+//# sourceMappingURL=tokens.d.ts.map

package/dist/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,MAAM,cAAc,GAEtB,eAAe,GACf,OAAO,GACP,QAAQ,GACR,aAAa,GACb,IAAI,GACJ,SAAS,GAET,QAAQ,GACR,cAAc,GACd,eAAe,GACf,aAAa,CAAC;AAElB,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,kEAAkE;AAClE,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,aAAa,GAAG,YAA2B,GACpD,OAAO,CAAC,MAAM,CAAC,CAqBjB;AAED,+DAA+D;AAC/D,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAWrE;AAED,0CAA0C;AAC1C,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAMtF;AAED,8FAA8F;AAC9F,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAYpG"}

package/dist/tokens.js

@@ -0,0 +1,86 @@
+/**
+ * Token measurement using industry-standard tokenizers.
+ *
+ *   gpt-tokenizer            — OpenAI's tiktoken (cl100k_base, o200k_base) in pure JS.
+ *                              Used in the vast majority of public token-cost reports.
+ *   @anthropic-ai/tokenizer  — Claude's official BPE tokenizer.
+ *
+ * Both are peer dependencies — install whichever you need:
+ *
+ *   npm i gpt-tokenizer            # OpenAI / GPT-4 / GPT-4o / o-series
+ *   npm i @anthropic-ai/tokenizer  # Anthropic / Claude
+ *
+ * If the package is not present, the corresponding function throws a
+ * helpful error. We do NOT fall back to char/4 — that's the kind of
+ * non-rigorous measurement we want this library to be the opposite of.
+ */
+/** Count tokens with the OpenAI tiktoken-compatible tokenizer. */
+export async function countTokensGpt(text, encoding = 'o200k_base') {
+    let tok;
+    try {
+        const mod = await import('gpt-tokenizer');
+        if (encoding === 'o200k_base' && mod.encodeChat) {
+            // gpt-tokenizer v3+ exposes per-encoding sub-paths via /encoding/<name>
+            try {
+                const sub = await import(`gpt-tokenizer/encoding/${encoding}`);
+                tok = sub;
+            }
+            catch {
+                tok = mod;
+            }
+        }
+        else {
+            tok = mod;
+        }
+    }
+    catch (err) {
+        throw new Error(`gpt-tokenizer not installed. Run: npm i gpt-tokenizer\n${err.message}`);
+    }
+    return tok.encode(text).length;
+}
+/** Count tokens with Anthropic's official Claude tokenizer. */
+export async function countTokensClaude(text) {
+    let tok;
+    try {
+        const mod = await import('@anthropic-ai/tokenizer');
+        tok = mod;
+    }
+    catch (err) {
+        throw new Error(`@anthropic-ai/tokenizer not installed. Run: npm i @anthropic-ai/tokenizer\n${err.message}`);
+    }
+    return tok.countTokens(text);
+}
+/** Best-effort count for a model name. */
+export async function countTokens(text, model) {
+    if (model.startsWith('claude'))
+        return countTokensClaude(text);
+    if (model.startsWith('o') || model === 'gpt-4o' || model === 'gpt-4o-mini') {
+        return countTokensGpt(text, 'o200k_base');
+    }
+    return countTokensGpt(text, 'cl100k_base');
+}
+/** Take a snapshot of every metric we care about. Skips unavailable tokenizers gracefully. */
+export async function measure(text, opts = {}) {
+    const out = { bytes: Buffer.byteLength(text, 'utf8') };
+    if (opts.gzip !== false) {
+        try {
+            const zlib = await import('node:zlib');
+            out.bytes_gzip = zlib.gzipSync(text, { level: 9 }).length;
+        }
+        catch { }
+    }
+    try {
+        out.tokens_openai_cl100k = await countTokensGpt(text, 'cl100k_base');
+    }
+    catch { }
+    try {
+        out.tokens_openai_o200k = await countTokensGpt(text, 'o200k_base');
+    }
+    catch { }
+    try {
+        out.tokens_anthropic = await countTokensClaude(text);
+    }
+    catch { }
+    return out;
+}
+//# sourceMappingURL=tokens.js.map

package/dist/tokens.js.map

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

package/dist/workflow.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Action execution and dry-run.
+ *
+ * AHTML actions carry typed contracts (input/output schema, auth, cost,
+ * reversibility, side effects, confirmation level). This module gives
+ * agents a single function to either *simulate* the action against
+ * preview_url or *execute* it against execute_url, with policy gates
+ * applied client-side as an extra safety layer.
+ */
+import type { Action, Snapshot } from '@ahtmljs/schema';
+export interface ActionRunOptions {
+    /** Override the snapshot's confirmation level. Useful when the caller
+     *  has already confirmed with the user. */
+    confirm?: boolean;
+    /** Bearer token for auth: required actions. */
+    bearer?: string;
+    /** Don't actually call execute_url — hit preview_url and return. */
+    dryRun?: boolean;
+    /** Skip side-effect safety checks (NOT recommended for autonomous agents). */
+    skipChecks?: boolean;
+    fetch?: typeof fetch;
+}
+export interface ActionResult<T = unknown> {
+    status: 'executed';
+    output: T;
+    http_status: number;
+}
+export interface DryRunResult {
+    status: 'dry_run';
+    would_charge?: {
+        amount: number;
+        currency: string;
+    };
+    would_email?: string[];
+    would_side_effects?: string[];
+    preview?: unknown;
+}
+/** Throw when an action's contract conflicts with the agent's policy. */
+export declare class ActionRefused extends Error {
+    reason: string;
+    constructor(reason: string);
+}
+export declare function runAction<TIn, TOut>(snapshot: Snapshot, action: Action, input: TIn, opts?: ActionRunOptions): Promise<ActionResult<TOut> | DryRunResult>;
+//# sourceMappingURL=workflow.d.ts.map

package/dist/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../src/workflow.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAExD,MAAM,WAAW,gBAAgB;IAC/B;+CAC2C;IAC3C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,8EAA8E;IAC9E,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO;IACvC,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,CAAC,CAAC;IACV,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,SAAS,CAAC;IAClB,YAAY,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IACpD,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,yEAAyE;AACzE,qBAAa,aAAc,SAAQ,KAAK;IACnB,MAAM,EAAE,MAAM;gBAAd,MAAM,EAAE,MAAM;CAGlC;AAED,wBAAsB,SAAS,CAAC,GAAG,EAAE,IAAI,EACvC,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,GAAG,EACV,IAAI,GAAE,gBAAqB,GAC1B,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,CA2C5C"}

package/dist/workflow.js

@@ -0,0 +1,84 @@
+/**
+ * Action execution and dry-run.
+ *
+ * AHTML actions carry typed contracts (input/output schema, auth, cost,
+ * reversibility, side effects, confirmation level). This module gives
+ * agents a single function to either *simulate* the action against
+ * preview_url or *execute* it against execute_url, with policy gates
+ * applied client-side as an extra safety layer.
+ */
+/** Throw when an action's contract conflicts with the agent's policy. */
+export class ActionRefused extends Error {
+    reason;
+    constructor(reason) {
+        super(`ActionRefused: ${reason}`);
+        this.reason = reason;
+    }
+}
+export async function runAction(snapshot, action, input, opts = {}) {
+    const fetcher = opts.fetch ?? globalThis.fetch;
+    if (!opts.skipChecks)
+        checkPolicy(snapshot, action, opts);
+    // --- Dry run path ---
+    if (opts.dryRun || (!action.execute_url && action.preview_url)) {
+        if (!action.preview_url) {
+            return {
+                status: 'dry_run',
+                would_charge: extractCost(action),
+                would_side_effects: action.side_effects ?? [],
+            };
+        }
+        const res = await fetcher(action.preview_url, {
+            method: 'POST',
+            headers: jsonHeaders(opts.bearer),
+            body: JSON.stringify(input),
+        });
+        if (!res.ok)
+            throw new Error(`preview failed: ${res.status}`);
+        const preview = await res.json().catch(() => undefined);
+        return {
+            status: 'dry_run',
+            would_charge: extractCost(action),
+            would_side_effects: action.side_effects ?? [],
+            preview,
+        };
+    }
+    // --- Execute path ---
+    if (!action.execute_url) {
+        throw new ActionRefused(`action "${action.id}" has no execute_url`);
+    }
+    const res = await fetcher(action.execute_url, {
+        method: action.method ?? 'POST',
+        headers: jsonHeaders(opts.bearer),
+        body: JSON.stringify(input),
+    });
+    const output = (await res.json().catch(() => null));
+    if (!res.ok) {
+        throw new Error(`action "${action.id}" failed: ${res.status}`);
+    }
+    return { status: 'executed', output, http_status: res.status };
+}
+function checkPolicy(snapshot, action, opts) {
+    if (action.auth === 'required' && !opts.bearer) {
+        throw new ActionRefused(`action "${action.id}" requires auth but no bearer provided`);
+    }
+    if (action.confirmation === 'required' && !opts.confirm) {
+        throw new ActionRefused(`action "${action.id}" requires explicit confirmation — pass { confirm: true }`);
+    }
+    if (snapshot.policy?.agents_welcome === false) {
+        throw new ActionRefused(`site policy: agents_welcome=false`);
+    }
+}
+function extractCost(action) {
+    const c = action.cost;
+    if (!c || c.amount == null || !c.currency)
+        return undefined;
+    return { amount: c.amount, currency: c.currency };
+}
+function jsonHeaders(bearer) {
+    const h = { 'content-type': 'application/json' };
+    if (bearer)
+        h.authorization = `Bearer ${bearer}`;
+    return h;
+}
+//# sourceMappingURL=workflow.js.map

package/dist/workflow.js.map

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

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@ahtmljs/agent",
+  "version": "0.1.0",
+  "description": "AHTML agent SDK — fetch snapshots, cache by ETag, run actions with dry-run support, and measure token cost using industry-standard tokenizers.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": { "types": "./dist/index.d.ts", "import": "./dist/index.js" },
+    "./tokens": { "types": "./dist/tokens.d.ts", "import": "./dist/tokens.js" }
+  },
+  "files": ["dist"],
+  "publishConfig": { "access": "public" },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -p tsconfig.json --watch"
+  },
+  "dependencies": {
+    "@ahtmljs/schema": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0"
+  },
+  "peerDependencies": {
+    "gpt-tokenizer": "^3.0.0",
+    "@anthropic-ai/tokenizer": "^0.0.4"
+  },
+  "peerDependenciesMeta": {
+    "gpt-tokenizer": { "optional": true },
+    "@anthropic-ai/tokenizer": { "optional": true }
+  },
+  "keywords": ["ahtml", "agent", "mcp", "llm", "tokenizer", "crawler"],
+  "license": "MIT"
+}