@amtp/protocol 1.0.1

package/dist/client/amtp-client.js

@@ -0,0 +1,460 @@
+"use strict";
+/**
+ * AMTP Agent Client SDK
+ * TypeScript SDK for AI agents to interact with AMTP servers
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AutonomousAgent = exports.AMTPMarkdownParser = exports.AMTPClient = void 0;
+const crypto_1 = __importDefault(require("crypto"));
+const amtp_types_1 = require("../types/amtp.types");
+/**
+ * AMTP Agent Client
+ * Main client for agents to interact with AMTP servers
+ */
+class AMTPClient {
+    constructor(config) {
+        this.baseUrl = config.baseUrl;
+        this.sessionId = config.sessionId;
+        this.timeout = config.timeout || 30000;
+        this.maxRetries = config.maxRetries || 3;
+        this.capabilities = config.capabilities || [
+            "actions",
+            "streaming",
+            "forms",
+        ];
+    }
+    /**
+     * Set session ID
+     */
+    setSessionId(sessionId) {
+        this.sessionId = sessionId;
+    }
+    /**
+     * Get session ID
+     */
+    getSessionId() {
+        return this.sessionId;
+    }
+    /**
+     * Fetch a page (supports cursor-based pagination)
+     */
+    async getPage(path, options) {
+        let url = `${this.baseUrl}${path}`;
+        if (options?.cursor) {
+            const separator = path.includes('?') ? '&' : '?';
+            url += `${separator}cursor=${encodeURIComponent(options.cursor)}`;
+        }
+        const response = await this.fetchWithRetry(url, {
+            method: "GET",
+            headers: this.buildHeaders(),
+        });
+        if (response.status !== amtp_types_1.StatusCode.OK) {
+            throw new Error(`Failed to fetch page: ${response.status} ${response.statusText}`);
+        }
+        const markdown = await response.text();
+        const parser = new AMTPMarkdownParser();
+        return parser.parse(markdown, path);
+    }
+    /**
+     * Convenience method: fetch the next page using the pagination info from the current document.
+     * Returns null if there is no next page/cursor.
+     */
+    async getNextPage(currentDoc) {
+        const pagination = currentDoc.pagination;
+        if (!pagination)
+            return null;
+        const nextCursor = pagination.nextCursor || pagination.pageInfo?.endCursor;
+        if (!nextCursor)
+            return null;
+        // Try to extract base path from the document
+        const basePath = currentDoc.path || '/';
+        return this.getPage(basePath, { cursor: nextCursor });
+    }
+    /**
+     * Extract all media nodes (images, video, audio) from a document.
+     * These now include rich `description` from amtp-meta blocks for agents.
+     */
+    getMedia(doc) {
+        return doc.nodes.filter((n) => n.type === "image" || n.type === "video" || n.type === "audio");
+    }
+    /**
+     * Execute an action
+     */
+    async executeAction(action, parameters) {
+        const url = `${this.baseUrl}/api/amtp/action`;
+        const request = {
+            action,
+            parameters,
+            sessionId: this.sessionId || "",
+            requestId: this.generateRequestId(),
+        };
+        const response = await this.fetchWithRetry(url, {
+            method: "POST",
+            headers: this.buildHeaders("application/json"),
+            body: JSON.stringify(request),
+        });
+        return response.json();
+    }
+    /**
+     * Execute multiple actions in a single batch request (v1.1).
+     * See AMTPBatchRequest for options (atomic, continueOnError, etc.).
+     */
+    async executeBatch(actions, options) {
+        const url = `${this.baseUrl}/api/amtp/batch`;
+        const items = actions.map((a, index) => ({
+            requestId: `batch_${this.generateRequestId()}_${index}`,
+            action: a.action,
+            parameters: a.parameters,
+        }));
+        const request = {
+            actions: items,
+            options,
+            sessionId: this.sessionId,
+            metadata: {},
+        };
+        const response = await this.fetchWithRetry(url, {
+            method: "POST",
+            headers: this.buildHeaders("application/json"),
+            body: JSON.stringify(request),
+        });
+        if (response.status >= 400) {
+            throw new Error(`Batch request failed: ${response.status}`);
+        }
+        return response.json();
+    }
+    /**
+     * Execute an AMTP-QL query (v2.0) against the current document context.
+     * Returns the projected result (much smaller than full document).
+     */
+    async query(rawQuery, variables) {
+        const url = `${this.baseUrl}/api/amtp/query`;
+        const request = {
+            query: rawQuery,
+            variables,
+        };
+        const response = await this.fetchWithRetry(url, {
+            method: "POST",
+            headers: this.buildHeaders("application/json"),
+            body: JSON.stringify(request),
+        });
+        if (response.status >= 400) {
+            const err = await response.json().catch(() => ({ error: { message: "" } }));
+            throw new Error(`AMTP-QL query failed: ${response.status} ${err?.error?.message || ""}`);
+        }
+        const json = await response.json();
+        if (json.errors?.length) {
+            throw new Error(`AMTP-QL errors: ${json.errors.map(e => e.message).join("; ")}`);
+        }
+        return json.data || {};
+    }
+    /**
+     * Register a webhook for push notifications (v2.0)
+     */
+    async registerWebhook(payload) {
+        const res = await this.fetchWithRetry(`${this.baseUrl}/api/webhooks`, {
+            method: "POST",
+            headers: this.buildHeaders("application/json"),
+            body: JSON.stringify(payload),
+        });
+        return res.json();
+    }
+    /**
+     * List registered webhooks
+     */
+    async listWebhooks() {
+        const res = await this.fetchWithRetry(`${this.baseUrl}/api/webhooks`, {
+            headers: this.buildHeaders(),
+        });
+        return res.json();
+    }
+    /**
+     * Submit a form
+     */
+    async submitForm(form, values) {
+        const url = `${this.baseUrl}${form.endpoint}`;
+        const submission = {
+            formId: form.id,
+            values,
+            sessionId: this.sessionId,
+            requestId: this.generateRequestId(),
+        };
+        const response = await this.fetchWithRetry(url, {
+            method: form.method,
+            headers: this.buildHeaders("application/json"),
+            body: JSON.stringify(submission),
+        });
+        return response.json();
+    }
+    /**
+     * Navigate to a URL
+     */
+    async navigate(path) {
+        return this.getPage(path);
+    }
+    /**
+     * Click a link
+     */
+    async clickLink(url) {
+        return this.getPage(url);
+    }
+    /**
+     * Login
+     */
+    async login(username, password) {
+        const url = `${this.baseUrl}/api/amtp/login`;
+        const response = await this.fetchWithRetry(url, {
+            method: "POST",
+            headers: this.buildHeaders("application/json"),
+            body: JSON.stringify({ username, password }),
+        });
+        const data = (await response.json());
+        this.sessionId = data.sessionId;
+        return data;
+    }
+    /**
+     * Logout
+     */
+    async logout() {
+        const url = `${this.baseUrl}/api/amtp/logout`;
+        await this.fetchWithRetry(url, {
+            method: "POST",
+            headers: this.buildHeaders(),
+        });
+        this.sessionId = undefined;
+    }
+    /**
+     * Stream updates from server
+     */
+    streamUpdates(path, callback) {
+        const url = `${this.baseUrl}${path}?sessionId=${this.sessionId}`;
+        const eventSource = new EventSource(url);
+        eventSource.onmessage = (event) => {
+            const update = JSON.parse(event.data);
+            callback(update);
+        };
+        return eventSource;
+    }
+    /**
+     * Get available actions on a page
+     */
+    async getActions(path) {
+        const doc = await this.getPage(path);
+        return doc.actions;
+    }
+    /**
+     * Get available forms on a page
+     */
+    async getForms(path) {
+        const doc = await this.getPage(path);
+        return doc.forms;
+    }
+    /**
+     * Search page content
+     */
+    async search(query, limit) {
+        const path = `/search?q=${encodeURIComponent(query)}` +
+            (limit ? `&limit=${limit}` : "");
+        return this.getPage(path);
+    }
+    /**
+     * Build request headers
+     */
+    buildHeaders(contentType) {
+        const headers = {
+            Accept: "text/amtp+markdown",
+            "X-AMTP-Capabilities": this.capabilities.join(","),
+            "User-Agent": "AMTP-Agent/1.0",
+        };
+        if (contentType) {
+            headers["Content-Type"] = contentType;
+        }
+        if (this.sessionId) {
+            headers["X-Session-ID"] = this.sessionId;
+        }
+        return headers;
+    }
+    /**
+     * Fetch with retry logic
+     */
+    async fetchWithRetry(url, options, attempt = 1) {
+        try {
+            const controller = new AbortController();
+            const timeout = setTimeout(() => controller.abort(), this.timeout);
+            const response = await fetch(url, {
+                ...options,
+                signal: controller.signal,
+            });
+            clearTimeout(timeout);
+            return response;
+        }
+        catch (error) {
+            if (attempt < this.maxRetries) {
+                const backoffMs = Math.pow(2, attempt) * 1000;
+                await new Promise((resolve) => setTimeout(resolve, backoffMs));
+                return this.fetchWithRetry(url, options, attempt + 1);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Generate unique request ID
+     */
+    generateRequestId() {
+        return `req_${Date.now()}_${crypto_1.default.randomBytes(4).toString("hex")}`;
+    }
+}
+exports.AMTPClient = AMTPClient;
+/**
+ * Simple Markdown Parser for Client
+ */
+class AMTPMarkdownParser {
+    parse(markdown, path) {
+        // Simplified parser for client-side use
+        const lines = markdown.split("\n");
+        const titleMatch = lines[0]?.match(/^# (.+)$/);
+        const title = titleMatch?.[1] || "Untitled";
+        return {
+            type: "document",
+            version: "1.0",
+            title,
+            path,
+            nodes: [],
+            actions: this.extractActions(markdown),
+            forms: this.extractForms(markdown),
+            links: this.extractLinks(markdown),
+            metadata: {},
+        };
+    }
+    extractActions(markdown) {
+        const actions = [];
+        const actionRegex = /\[([A-Z_0-9]+)\]/g;
+        let match;
+        while ((match = actionRegex.exec(markdown)) !== null) {
+            const name = match[1];
+            actions.push({
+                id: name.toLowerCase(),
+                label: name,
+                method: amtp_types_1.HTTPMethod.POST,
+                endpoint: `/api/actions/${name.toLowerCase()}`,
+            });
+        }
+        return [...new Map(actions.map((a) => [a.id, a])).values()];
+    }
+    extractForms(markdown) {
+        const forms = [];
+        const formRegex = /ACTION:\s*(\w+)[\s\S]*?METHOD:\s*(\w+)[\s\S]*?ENDPOINT:\s*(\S+)/g;
+        let match;
+        while ((match = formRegex.exec(markdown)) !== null) {
+            const [, name, method, endpoint] = match;
+            forms.push({
+                id: name,
+                action: name,
+                method: method.toUpperCase(),
+                endpoint,
+                fields: [],
+            });
+        }
+        return forms;
+    }
+    extractLinks(markdown) {
+        const links = [];
+        const linkRegex = /\[([^\]]+)\]\(([^)]+)\)/g;
+        let match;
+        while ((match = linkRegex.exec(markdown)) !== null) {
+            const [, text, url] = match;
+            links.push({
+                text,
+                url,
+            });
+        }
+        return links;
+    }
+}
+exports.AMTPMarkdownParser = AMTPMarkdownParser;
+/**
+ * Autonomous Agent Workflow
+ * Example of building autonomous workflows
+ */
+class AutonomousAgent {
+    constructor(config) {
+        this.client = new AMTPClient(config);
+    }
+    /**
+     * Example: Autonomous shopping workflow
+     */
+    async autonomousShop(productQuery, maxPrice) {
+        console.log(`🤖 Starting autonomous shopping for: ${productQuery} (max: $${maxPrice})`);
+        try {
+            // Step 1: Search for products
+            console.log("📍 Step 1: Searching for products...");
+            const results = await this.client.search(productQuery, 10);
+            // Step 2: Find product within budget (leverage description for better matching in v1.1+)
+            const targetProduct = results.actions.find((a) => a.label?.toLowerCase().includes(productQuery.toLowerCase()) ||
+                a.description?.toLowerCase().includes(productQuery.toLowerCase()));
+            if (!targetProduct) {
+                throw new Error("Product not found");
+            }
+            // Step 3: View product
+            console.log(`📍 Step 2: Viewing product: ${targetProduct.label} — ${targetProduct.description || ""}`);
+            await this.client.navigate(targetProduct.endpoint || "/");
+            // Step 3: Add to cart
+            console.log("📍 Step 3: Adding to cart...");
+            await this.client.executeAction("add_to_cart", {
+                productId: targetProduct.id,
+                quantity: 1,
+            });
+            // Step 4: Navigate to checkout
+            console.log("📍 Step 4: Proceeding to checkout...");
+            await this.client.navigate("/cart");
+            // Step 5: Get checkout form
+            const forms = await this.client.getForms("/checkout");
+            console.log(`📍 Step 5: Found ${forms.length} forms`);
+            console.log("✅ Workflow completed successfully!");
+            return { success: true, product: targetProduct };
+        }
+        catch (error) {
+            console.error("❌ Workflow failed:", error);
+            return { success: false, error };
+        }
+    }
+    /**
+     * Example: Multi-step authenticated workflow
+     */
+    async authenticatedWorkflow(username, password) {
+        try {
+            // Login
+            console.log("🔐 Logging in...");
+            const session = await this.client.login(username, password);
+            console.log(`✅ Logged in as ${session.userId}`);
+            // Access dashboard
+            console.log("📊 Loading dashboard...");
+            await this.client.navigate("/dashboard");
+            // Monitor updates
+            console.log("🔔 Listening for updates...");
+            const eventSource = this.client.streamUpdates("/api/stream/orders", (update) => {
+                console.log("📬 Update:", update);
+            });
+            // Simulate work
+            await new Promise((resolve) => setTimeout(resolve, 5000));
+            // Cleanup
+            eventSource.close();
+            await this.client.logout();
+            console.log("✅ Logged out");
+            return { success: true };
+        }
+        catch (error) {
+            console.error("❌ Authenticated workflow failed:", error);
+            return { success: false, error };
+        }
+    }
+}
+exports.AutonomousAgent = AutonomousAgent;
+exports.default = {
+    AMTPClient,
+    AMTPMarkdownParser,
+    AutonomousAgent,
+};
+//# sourceMappingURL=amtp-client.js.map

package/dist/client/amtp-client.js.map

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

package/dist/client/examples/basic-client.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Basic AMTP Client / Agent Example
+ *
+ * Run with: npm run client
+ */
+export {};

package/dist/client/examples/basic-client.js

@@ -0,0 +1,35 @@
+"use strict";
+/**
+ * Basic AMTP Client / Agent Example
+ *
+ * Run with: npm run client
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const amtp_client_js_1 = require("../amtp-client.js");
+async function main() {
+    const config = {
+        baseUrl: process.env.AMTP_BASE_URL || "http://localhost:3000",
+        timeout: 10000,
+    };
+    const client = new amtp_client_js_1.AMTPClient(config);
+    console.log("🤖 AMTP Client Demo");
+    try {
+        // Fetch home page
+        const home = await client.getPage("/");
+        console.log("Home:", home.title);
+        // Fetch a product
+        const product = await client.getPage("/products/demo");
+        console.log("Product fetched:", product.title);
+        // Execute an action (note: demo impl uses /api/amtp/action)
+        const buyResult = await client.executeAction("BUY", { productId: "demo", quantity: 1 });
+        console.log("Action result:", buyResult.title || "ok");
+        // Demo autonomous agent
+        const agent = new amtp_client_js_1.AutonomousAgent(config);
+        console.log("Autonomous agent instantiated for workflows.");
+    }
+    catch (err) {
+        console.log("Demo note: Start `npm run server` in another shell for live demo. Error:", err.message);
+    }
+}
+main().catch(console.error);
+//# sourceMappingURL=basic-client.js.map

package/dist/client/examples/basic-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"basic-client.js","sourceRoot":"","sources":["../../../src/client/examples/basic-client.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAEH,sDAAgE;AAEhE,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG;QACb,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,uBAAuB;QAC7D,OAAO,EAAE,KAAK;KACf,CAAC;IACF,MAAM,MAAM,GAAG,IAAI,2BAAU,CAAC,MAAM,CAAC,CAAC;IAEtC,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;IAEnC,IAAI;QACF,kBAAkB;QAClB,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACvC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAEjC,kBAAkB;QAClB,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QACvD,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QAE/C,4DAA4D;QAC5D,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;QACxF,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,SAAS,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC;QAEvD,wBAAwB;QACxB,MAAM,KAAK,GAAG,IAAI,gCAAe,CAAC,MAAM,CAAC,CAAC;QAC1C,OAAO,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC;KAE7D;IAAC,OAAO,GAAQ,EAAE;QACjB,OAAO,CAAC,GAAG,CAAC,0EAA0E,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;KACtG;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC"}

package/dist/crawler/amtp-crawler.d.ts

@@ -0,0 +1,125 @@
+/**
+ * AMTP Crawler & Indexer
+ * Crawls AMTP-enabled websites and builds searchable index
+ */
+import { AMTPDocument, StructuredData, Link } from "../types/amtp.types";
+/**
+ * Crawler Configuration
+ */
+export interface CrawlerConfig {
+    baseUrl: string;
+    maxPages?: number;
+    maxDepth?: number;
+    respectRobotsTxt?: boolean;
+    delays?: {
+        betweenRequests: number;
+        betweenDomains: number;
+    };
+    userAgent?: string;
+    indexCallback?: (doc: AMTPDocument) => Promise<void>;
+}
+/**
+ * Crawled Page Index
+ */
+export interface CrawledPage {
+    url: string;
+    title: string;
+    content: string;
+    structuredData: StructuredData[];
+    links: Link[];
+    indexedAt: string;
+    embeddingVector?: number[];
+}
+/**
+ * Crawler Statistics
+ */
+export interface CrawlStats {
+    totalPages: number;
+    totalTime: number;
+    avgTimePerPage: number;
+    totalLinksDiscovered: number;
+    externalLinks: number;
+    errors: number;
+    startedAt: string;
+    completedAt: string;
+}
+/**
+ * AMTP Crawler
+ */
+export declare class AMTPCrawler {
+    private config;
+    private client;
+    private visited;
+    private queue;
+    private index;
+    private stats;
+    private startTime;
+    constructor(config: CrawlerConfig);
+    /**
+     * Start crawling
+     */
+    crawl(): Promise<CrawledPage[]>;
+    /**
+     * Crawl a single page
+     */
+    private crawlPage;
+    private disallowRules;
+    private crawlDelayMs;
+    /**
+     * Check robots.txt — parse rules and enforce them during crawl.
+     */
+    private checkRobotsTxt;
+    private isAllowedByRobots;
+    /**
+     * Search the index
+     */
+    search(query: string): CrawledPage[];
+    /**
+     * Get page by URL
+     */
+    getPage(url: string): CrawledPage | undefined;
+    /**
+     * Export index as JSON
+     */
+    exportIndex(): string;
+    /**
+     * Print crawl statistics
+     */
+    private printStats;
+    /**
+     * Delay execution
+     */
+    private delay;
+}
+/**
+ * Search Engine Indexer
+ * Example of building a search engine index from AMTP pages
+ */
+export declare class SearchIndexer {
+    private index;
+    /**
+     * Add pages to index
+     */
+    addPages(pages: CrawledPage[]): void;
+    /**
+     * Search index
+     */
+    search(query: string, limit?: number): CrawledPage[];
+    /**
+     * Extract keywords from content
+     */
+    private extractKeywords;
+    /**
+     * Check if word is stop word
+     */
+    private isStopWord;
+    /**
+     * Export index
+     */
+    exportIndex(): string;
+}
+declare const _default: {
+    AMTPCrawler: typeof AMTPCrawler;
+    SearchIndexer: typeof SearchIndexer;
+};
+export default _default;