@greatlhd/ailo-endpoint-sdk 1.0.0

package/dist/blob/client.d.ts

@@ -0,0 +1,15 @@
+export interface BlobUploadResult {
+    fileRef: string;
+}
+export interface BlobClientOptions {
+    httpBase: string;
+    apiKey: string;
+}
+export declare class BlobClient {
+    private opts;
+    constructor(opts: BlobClientOptions);
+    upload(localPath: string): Promise<BlobUploadResult>;
+    download(blobUrl: string): Promise<string>;
+}
+export declare function deriveHttpBase(wsUrl: string): string;
+//# sourceMappingURL=client.d.ts.map

package/dist/blob/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/blob/client.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,UAAU;IACT,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,iBAAiB;IAErC,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAsBpD,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAgBjD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKpD"}

package/dist/blob/client.js

@@ -0,0 +1,48 @@
+import * as path from "path";
+import * as fs from "fs";
+import * as os from "os";
+export class BlobClient {
+    opts;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    async upload(localPath) {
+        const absPath = path.resolve(localPath);
+        const fileBuffer = fs.readFileSync(absPath);
+        const fileName = path.basename(absPath);
+        const form = new FormData();
+        form.append("file", new Blob([fileBuffer]), fileName);
+        const res = await fetch(`${this.opts.httpBase}/api/blob/upload`, {
+            method: "POST",
+            headers: { Authorization: `Bearer ${this.opts.apiKey}` },
+            body: form,
+        });
+        if (!res.ok) {
+            throw new Error(`blob upload failed: ${res.status} ${await res.text()}`);
+        }
+        const json = (await res.json());
+        return { fileRef: json.file_ref };
+    }
+    async download(blobUrl) {
+        const tmpDir = path.join(fs.realpathSync(fs.mkdtempSync(path.join(os.tmpdir(), 'ailo_blob_'))));
+        const fileName = blobUrl.split("/").pop() || `blob_${Date.now()}`;
+        const tmpFile = path.join(tmpDir, `${Date.now()}_${fileName}`);
+        const res = await fetch(blobUrl, {
+            headers: { Authorization: `Bearer ${this.opts.apiKey}` }
+        });
+        if (!res.ok) {
+            throw new Error(`blob download failed: ${res.status}`);
+        }
+        fs.writeFileSync(tmpFile, Buffer.from(await res.arrayBuffer()));
+        return tmpFile;
+    }
+}
+export function deriveHttpBase(wsUrl) {
+    let base = wsUrl.replace(/\/ws\/?$/, "");
+    if (base.startsWith("wss://"))
+        base = base.replace("wss://", "https://");
+    else if (base.startsWith("ws://"))
+        base = base.replace("ws://", "http://");
+    return base;
+}
+//# sourceMappingURL=client.js.map

package/dist/blob/client.js.map

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

package/dist/blob/index.d.ts

@@ -0,0 +1,3 @@
+export { BlobClient, deriveHttpBase } from './client.js';
+export type { BlobUploadResult, BlobClientOptions } from './client.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/blob/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACzD,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/dist/blob/index.js

@@ -0,0 +1,2 @@
+export { BlobClient, deriveHttpBase } from './client.js';
+//# sourceMappingURL=index.js.map

package/dist/blob/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/blob/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/dist/bootstrap.d.ts

@@ -0,0 +1,37 @@
+import { EndpointClient } from "./endpoint-client.js";
+import { type LogLevel, type LogData } from "./logger.js";
+import type { AcceptMessage, EndpointStorage, EndpointUpdateParams, ToolHandler, ToolCapability, SkillMeta } from "./types.js";
+export interface EndpointContext {
+    accept(msg: AcceptMessage): Promise<void>;
+    storage: EndpointStorage;
+    sendSignal(signal: string, data?: unknown): void;
+    onSignal(signal: string, callback: (data: unknown) => void): void;
+    uploadBlob(localPath: string): Promise<string>;
+    resolveToLocal(pathOrUrl: string): Promise<string>;
+    sendFile(localPath: string): Promise<string>;
+    update(params: EndpointUpdateParams): Promise<void>;
+    client: EndpointClient;
+    log(level: LogLevel, message: string, data?: LogData): void;
+    reportHealth(status: string): void;
+}
+export interface EndpointHandler {
+    start(ctx: EndpointContext): void | Promise<void>;
+    stop(): void | Promise<void>;
+}
+export interface EndpointConfig {
+    caps?: string[];
+    handler: EndpointHandler;
+    tools?: ToolCapability[];
+    toolHandlers?: Record<string, ToolHandler>;
+    onUnknownTool?: (name: string, args: Record<string, unknown>) => Promise<unknown>;
+    blueprints?: string[];
+    ailoWsUrl?: string;
+    ailoApiKey?: string;
+    endpointId?: string;
+    instructions?: string;
+    skillDirs?: string[];
+    skills?: SkillMeta[];
+    onConnectFailure?: (err: Error, client: EndpointClient) => void | Promise<void>;
+}
+export declare function runEndpoint(config: EndpointConfig): void;
+//# sourceMappingURL=bootstrap.d.ts.map

package/dist/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAOtD,OAAO,EAA8B,KAAK,QAAQ,EAAE,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AACtF,OAAO,KAAK,EACV,aAAa,EAEb,eAAe,EACf,oBAAoB,EACpB,WAAW,EACX,cAAc,EACd,SAAS,EACV,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,OAAO,EAAE,eAAe,CAAC;IACzB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACjD,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;IAClE,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/C,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACnD,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,MAAM,EAAE,cAAc,CAAC;IACvB,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5D,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,IAAI,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,eAAe,CAAC;IACzB,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC3C,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAClF,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,gBAAgB,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjF;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAiJxD"}

package/dist/bootstrap.js

@@ -0,0 +1,145 @@
+import * as fs from "fs";
+import * as path from "path";
+import { EndpointClient } from "./endpoint-client.js";
+import { createLocalEndpointStorage } from "./local-endpoint-storage.js";
+import { loadSkills } from "./skill-loader.js";
+import { BlobClient, deriveHttpBase } from "./blob/client.js";
+import { autoUploadMedia, resolveFileArgsInPlace, resolveToLocal } from "./middleware/media.js";
+import { normalizeToolResult } from "./tool-dispatch/normalize.js";
+import { inferMime, classifyMedia } from "./media-util.js";
+import { ConsoleLogger } from "./logger.js";
+export function runEndpoint(config) {
+    const { handler } = config;
+    const ailoWsUrl = config.ailoWsUrl ?? process.env.AILO_WS_URL ?? "";
+    const ailoApiKey = config.ailoApiKey ?? process.env.AILO_API_KEY ?? "";
+    const endpointId = config.endpointId ?? process.env.AILO_ENDPOINT_ID ?? "";
+    const caps = config.caps ?? ["message", "tool_execute"];
+    if (!ailoWsUrl || !ailoApiKey || !endpointId) {
+        console.error("[endpoint] Missing ailoWsUrl, ailoApiKey or endpointId. " +
+            "Please pass these values in the config or set them via the config file.");
+        process.exit(1);
+    }
+    const tag = `[${endpointId}]`;
+    const logger = new ConsoleLogger(tag);
+    const skills = config.skills !== undefined
+        ? config.skills
+        : loadSkills(config.skillDirs);
+    if (skills.length > 0) {
+        logger.info('skills_loaded', { count: skills.length, names: skills.map((s) => s.name).join(", ") });
+    }
+    const client = new EndpointClient({
+        url: ailoWsUrl,
+        apiKey: ailoApiKey,
+        endpointId,
+        caps,
+        tools: config.tools,
+        instructions: config.instructions,
+        blueprints: config.blueprints,
+        skills,
+    }, { logger });
+    const shutdown = (reason = "shutdown") => {
+        logger.info('shutting_down', { reason });
+        Promise.resolve(handler.stop()).catch(() => { });
+        client.close();
+        process.exit(0);
+    };
+    process.on("SIGINT", () => shutdown("SIGINT"));
+    process.on("SIGTERM", () => shutdown("SIGTERM"));
+    client.onEvicted(() => {
+        logger.warn('evicted', { message: 'evicted by a newer instance, exiting.' });
+        Promise.resolve(handler.stop()).catch(() => { });
+        process.exit(0);
+    });
+    (async () => {
+        const ailoHttpBase = deriveHttpBase(ailoWsUrl);
+        const blobUrlPrefix = `${ailoHttpBase}/api/blob/`;
+        const blobClient = new BlobClient({ httpBase: ailoHttpBase, apiKey: ailoApiKey });
+        async function uploadBlob(localPath) {
+            const absPath = path.resolve(localPath);
+            const fileBuffer = fs.readFileSync(absPath);
+            const fileName = path.basename(absPath);
+            const form = new FormData();
+            form.append("file", new Blob([fileBuffer]), fileName);
+            const res = await fetch(`${ailoHttpBase}/api/blob/upload`, {
+                method: "POST",
+                headers: { Authorization: `Bearer ${ailoApiKey}` },
+                body: form,
+            });
+            if (!res.ok)
+                throw new Error(`blob upload failed: ${res.status} ${await res.text()}`);
+            const json = (await res.json());
+            return json.file_ref;
+        }
+        if (config.toolHandlers || config.onUnknownTool) {
+            const handlers = config.toolHandlers ?? {};
+            const onUnknown = config.onUnknownTool;
+            client.onToolRequest(async (req) => {
+                await resolveFileArgsInPlace(req.args, blobClient, blobUrlPrefix);
+                const fn = handlers[req.name];
+                if (fn) {
+                    const result = await fn(req.args);
+                    return normalizeToolResult(result, blobClient);
+                }
+                if (onUnknown) {
+                    const result = await onUnknown(req.name, req.args);
+                    return normalizeToolResult(result, blobClient);
+                }
+                throw new Error(`unknown tool: ${req.name}`);
+            });
+        }
+        const ctx = {
+            async accept(msg) {
+                await autoUploadMedia(msg.content, blobClient);
+                return client.accept(msg);
+            },
+            storage: createLocalEndpointStorage(endpointId),
+            sendSignal: (signal, data) => client.sendSignal(signal, data),
+            onSignal: (signal, callback) => {
+                client.onSignal(signal, (_sig, data) => callback(data));
+            },
+            uploadBlob,
+            resolveToLocal: (pathOrUrl) => resolveToLocal(pathOrUrl, blobClient, endpointId, blobUrlPrefix),
+            async sendFile(localPath) {
+                const absPath = path.resolve(localPath);
+                const fileRef = await uploadBlob(absPath);
+                const mime = inferMime(absPath);
+                const mediaType = classifyMedia(mime);
+                await ctx.accept({
+                    content: [{ type: mediaType, media: { type: mediaType, fileRef, mime, name: path.basename(absPath) } }],
+                    contextTags: [],
+                });
+                return fileRef;
+            },
+            update: (params) => client.update(params),
+            client,
+            log: (level, message, data) => logger[level](message, data),
+            reportHealth: (status) => logger.info('health_report', { status }),
+        };
+        for (;;) {
+            try {
+                await client.connect();
+                logger.info('connected', { message: 'Ailo WebSocket connected' });
+                break;
+            }
+            catch (err) {
+                const e = err instanceof Error ? err : new Error(String(err));
+                logger.error('connect_failed', { error: e.message });
+                if (config.onConnectFailure) {
+                    await Promise.resolve(config.onConnectFailure(e, client));
+                }
+                else {
+                    process.exit(1);
+                }
+            }
+        }
+        try {
+            await handler.start(ctx);
+            logger.info('handler_started', { message: 'handler started' });
+        }
+        catch (err) {
+            logger.error('handler_start_failed', { error: err instanceof Error ? err.message : String(err) });
+            process.exit(1);
+        }
+    })();
+}
+//# sourceMappingURL=bootstrap.js.map

package/dist/bootstrap.js.map

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

package/dist/config-io.d.ts

@@ -0,0 +1,6 @@
+export declare function readConfig<T = Record<string, unknown>>(configPath: string): Partial<T>;
+export declare function writeConfig<T = Record<string, unknown>>(configPath: string, data: T): void;
+declare function getNestedValue(obj: Record<string, unknown>, path: string): unknown;
+declare function setNestedValue(obj: Record<string, unknown>, path: string, value: unknown): void;
+export { getNestedValue, setNestedValue };
+//# sourceMappingURL=config-io.d.ts.map

package/dist/config-io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-io.d.ts","sourceRoot":"","sources":["../src/config-io.ts"],"names":[],"mappings":"AAIA,wBAAgB,UAAU,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAOtF;AAED,wBAAgB,WAAW,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAM1F;AAED,iBAAS,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAQ3E;AAED,iBAAS,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CASxF;AAED,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,CAAC"}

package/dist/config-io.js

@@ -0,0 +1,43 @@
+import { readFileSync, writeFileSync, mkdirSync, renameSync, existsSync } from "fs";
+import { dirname, join } from "path";
+import { randomBytes } from "crypto";
+export function readConfig(configPath) {
+    try {
+        const raw = readFileSync(configPath, "utf-8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return {};
+    }
+}
+export function writeConfig(configPath, data) {
+    const dir = dirname(configPath);
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    const tmp = join(dir, `.config-${randomBytes(4).toString("hex")}.tmp`);
+    writeFileSync(tmp, JSON.stringify(data, null, 2) + "\n", "utf-8");
+    renameSync(tmp, configPath);
+}
+function getNestedValue(obj, path) {
+    const parts = path.split(".");
+    let cur = obj;
+    for (const p of parts) {
+        if (cur == null || typeof cur !== "object")
+            return undefined;
+        cur = cur[p];
+    }
+    return cur;
+}
+function setNestedValue(obj, path, value) {
+    const parts = path.split(".");
+    let cur = obj;
+    for (let i = 0; i < parts.length - 1; i++) {
+        const p = parts[i];
+        if (cur[p] == null || typeof cur[p] !== "object")
+            cur[p] = {};
+        cur = cur[p];
+    }
+    cur[parts[parts.length - 1]] = value;
+}
+export { getNestedValue, setNestedValue };
+//# sourceMappingURL=config-io.js.map

package/dist/config-io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-io.js","sourceRoot":"","sources":["../src/config-io.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AACpF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAErC,MAAM,UAAU,UAAU,CAA8B,UAAkB;IACxE,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAC9C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAe,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAgB,CAAC;IAC1B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAA8B,UAAkB,EAAE,IAAO;IAClF,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAChC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,WAAW,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACvE,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;IAClE,UAAU,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;AAC9B,CAAC;AAED,SAAS,cAAc,CAAC,GAA4B,EAAE,IAAY;IAChE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,GAAG,GAAY,GAAG,CAAC;IACvB,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,GAAG,IAAI,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC;QAC7D,GAAG,GAAI,GAA+B,CAAC,CAAC,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,cAAc,CAAC,GAA4B,EAAE,IAAY,EAAE,KAAc;IAChF,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,GAAG,GAAG,GAAG,CAAC;IACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACnB,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC,KAAK,QAAQ;YAAE,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;QAC9D,GAAG,GAAG,GAAG,CAAC,CAAC,CAA4B,CAAC;IAC1C,CAAC;IACD,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;AACvC,CAAC;AAED,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,CAAC"}

package/dist/connection-state.d.ts

@@ -0,0 +1,24 @@
+export type ConnectionState = 'disconnected' | 'connecting' | 'connected' | 'reconnecting' | 'closing';
+export interface StateTransition {
+    from: ConnectionState;
+    to: ConnectionState;
+    timestamp: number;
+    reason?: string;
+}
+export type StateChangeListener = (transition: StateTransition) => void;
+export declare class ConnectionFSM {
+    private _state;
+    private listeners;
+    private history;
+    get state(): ConnectionState;
+    get isConnected(): boolean;
+    get isConnecting(): boolean;
+    get isDisconnected(): boolean;
+    canTransitionTo(newState: ConnectionState): boolean;
+    transition(newState: ConnectionState, reason?: string): boolean;
+    forceTransition(newState: ConnectionState, reason?: string): void;
+    onStateChange(listener: StateChangeListener): () => void;
+    getHistory(): StateTransition[];
+    reset(): void;
+}
+//# sourceMappingURL=connection-state.d.ts.map

package/dist/connection-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-state.d.ts","sourceRoot":"","sources":["../src/connection-state.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GACvB,cAAc,GACd,YAAY,GACZ,WAAW,GACX,cAAc,GACd,SAAS,CAAC;AAEd,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,eAAe,CAAC;IACtB,EAAE,EAAE,eAAe,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,mBAAmB,GAAG,CAAC,UAAU,EAAE,eAAe,KAAK,IAAI,CAAC;AAExE,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAmC;IACjD,OAAO,CAAC,SAAS,CAA6B;IAC9C,OAAO,CAAC,OAAO,CAAyB;IAExC,IAAI,KAAK,IAAI,eAAe,CAE3B;IAED,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED,IAAI,cAAc,IAAI,OAAO,CAE5B;IAED,eAAe,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO;IAWnD,UAAU,CAAC,QAAQ,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO;IA0B/D,eAAe,CAAC,QAAQ,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAoBjE,aAAa,CAAC,QAAQ,EAAE,mBAAmB,GAAG,MAAM,IAAI;IAQxD,UAAU,IAAI,eAAe,EAAE;IAI/B,KAAK,IAAI,IAAI;CAId"}

package/dist/connection-state.js

@@ -0,0 +1,83 @@
+export class ConnectionFSM {
+    _state = 'disconnected';
+    listeners = [];
+    history = [];
+    get state() {
+        return this._state;
+    }
+    get isConnected() {
+        return this._state === 'connected';
+    }
+    get isConnecting() {
+        return this._state === 'connecting' || this._state === 'reconnecting';
+    }
+    get isDisconnected() {
+        return this._state === 'disconnected';
+    }
+    canTransitionTo(newState) {
+        const allowed = {
+            disconnected: ['connecting'],
+            connecting: ['connected', 'disconnected', 'reconnecting'],
+            connected: ['disconnected', 'reconnecting', 'closing'],
+            reconnecting: ['connected', 'disconnected', 'connecting'],
+            closing: ['disconnected'],
+        };
+        return allowed[this._state].includes(newState);
+    }
+    transition(newState, reason) {
+        if (!this.canTransitionTo(newState)) {
+            return false;
+        }
+        const transition = {
+            from: this._state,
+            to: newState,
+            timestamp: Date.now(),
+            reason,
+        };
+        this.history.push(transition);
+        this._state = newState;
+        for (const listener of this.listeners) {
+            try {
+                listener(transition);
+            }
+            catch {
+                // ignore listener errors
+            }
+        }
+        return true;
+    }
+    forceTransition(newState, reason) {
+        const transition = {
+            from: this._state,
+            to: newState,
+            timestamp: Date.now(),
+            reason,
+        };
+        this.history.push(transition);
+        this._state = newState;
+        for (const listener of this.listeners) {
+            try {
+                listener(transition);
+            }
+            catch {
+                // ignore listener errors
+            }
+        }
+    }
+    onStateChange(listener) {
+        this.listeners.push(listener);
+        return () => {
+            const idx = this.listeners.indexOf(listener);
+            if (idx >= 0)
+                this.listeners.splice(idx, 1);
+        };
+    }
+    getHistory() {
+        return [...this.history];
+    }
+    reset() {
+        this._state = 'disconnected';
+        this.history = [];
+    }
+}
+//# sourceMappingURL=connection-state.js.map

package/dist/connection-state.js.map

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

package/dist/connection-util.d.ts

@@ -0,0 +1,12 @@
+export interface AiloConnectionConfig {
+    url: string;
+    apiKey: string;
+    endpointId: string;
+}
+export declare function hasValidConfig(c: AiloConnectionConfig): boolean;
+/**
+ * Exponential backoff delay with optional jitter.
+ * @param attempt 0-based attempt count
+ */
+export declare function backoffDelayMs(attempt: number, baseMs?: number, maxMs?: number, jitter?: boolean): number;
+//# sourceMappingURL=connection-util.d.ts.map

package/dist/connection-util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-util.d.ts","sourceRoot":"","sources":["../src/connection-util.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAE/D;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,MAAM,SAAO,EACb,KAAK,SAAS,EACd,MAAM,UAAO,GACZ,MAAM,CAKR"}

package/dist/connection-util.js

@@ -0,0 +1,15 @@
+export function hasValidConfig(c) {
+    return !!(c.url && c.apiKey && c.endpointId);
+}
+/**
+ * Exponential backoff delay with optional jitter.
+ * @param attempt 0-based attempt count
+ */
+export function backoffDelayMs(attempt, baseMs = 1000, maxMs = 60_000, jitter = true) {
+    const raw = Math.min(baseMs * 2 ** attempt, maxMs);
+    if (!jitter)
+        return raw;
+    const spread = raw * 0.1 * (Math.random() * 2 - 1);
+    return Math.max(100, Math.round(raw + spread));
+}
+//# sourceMappingURL=connection-util.js.map

package/dist/connection-util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-util.js","sourceRoot":"","sources":["../src/connection-util.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,cAAc,CAAC,CAAuB;IACpD,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC;AAC/C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAC5B,OAAe,EACf,MAAM,GAAG,IAAI,EACb,KAAK,GAAG,MAAM,EACd,MAAM,GAAG,IAAI;IAEb,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,EAAE,KAAK,CAAC,CAAC;IACnD,IAAI,CAAC,MAAM;QAAE,OAAO,GAAG,CAAC;IACxB,MAAM,MAAM,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IACnD,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC;AACjD,CAAC"}

package/dist/endpoint-client.d.ts

@@ -0,0 +1,92 @@
+import type { AcceptMessage, ToolResponsePayload, WorldEnrichmentPayload, IntentPayload, ToolRequestPayload, StreamPayload, ToolCapability, SkillMeta, EndpointUpdateParams } from "./types.js";
+import type { Logger } from "./logger.js";
+import { type ConnectionState, type StateChangeListener } from "./connection-state.js";
+export interface EndpointClientOptions {
+    handshakeTimeout?: number;
+    heartbeatInterval?: number;
+    heartbeatTimeout?: number;
+    reconnectBaseDelay?: number;
+    reconnectMaxDelay?: number;
+    offlineBufferSize?: number;
+    logger?: Logger;
+}
+export declare const RECONNECT_COOLDOWN_MS = 1000;
+export type ToolRequestHandler = (payload: ToolRequestPayload) => Promise<unknown>;
+export type IntentHandler = (payload: IntentPayload) => void;
+export type WorldEnrichmentHandler = (payload: WorldEnrichmentPayload) => void;
+export type StreamHandler = (payload: StreamPayload) => void;
+export type SignalHandler = (signal: string, data: unknown) => void;
+export type EvictedHandler = () => void;
+export interface EndpointClientConfig {
+    url: string;
+    apiKey: string;
+    endpointId: string;
+    caps: string[];
+    tools?: ToolCapability[];
+    instructions?: string;
+    blueprints?: string[];
+    skills?: SkillMeta[];
+    offlineBufferSize?: number;
+}
+export type ConnectionOverrides = Partial<Pick<EndpointClientConfig, "url" | "apiKey" | "endpointId">>;
+export declare class EndpointClient {
+    private ws;
+    private cfg;
+    private opts;
+    private fsm;
+    private reqId;
+    private pending;
+    private heartbeatTimer;
+    private pongTimer;
+    private reconnectTimer;
+    private reconnectAttempt;
+    private offlineBuffer;
+    private readonly offlineBufferMax;
+    private toolRequestHandler;
+    private intentHandler;
+    private worldEnrichmentHandler;
+    private streamHandler;
+    private signalHandlers;
+    private evictedHandler;
+    private fsProbeMarker;
+    private reconnectWaiters;
+    constructor(config: EndpointClientConfig, options?: EndpointClientOptions);
+    get state(): ConnectionState;
+    get isConnected(): boolean;
+    onStateChange(listener: StateChangeListener): () => void;
+    setLogger(logger: Logger): void;
+    connect(): Promise<void>;
+    close(): void;
+    reconnect(skills?: SkillMeta[], connectionOverrides?: ConnectionOverrides, tools?: ToolCapability[], blueprints?: string[]): Promise<void>;
+    update(params: EndpointUpdateParams): Promise<void>;
+    onToolRequest(handler: ToolRequestHandler): this;
+    onIntent(handler: IntentHandler): this;
+    onWorldEnrichment(handler: WorldEnrichmentHandler): this;
+    onStream(handler: StreamHandler): this;
+    onSignal(signal: string, handler: SignalHandler): this;
+    onEvicted(handler: EvictedHandler): this;
+    accept(msg: AcceptMessage): Promise<void>;
+    toolResponse(payload: ToolResponsePayload): Promise<void>;
+    sendSignal(signal: string, data?: unknown): void;
+    private dial;
+    private handshake;
+    private attachHandlers;
+    private handleEvent;
+    private request;
+    private acceptDirect;
+    private flushOfflineBuffer;
+    private startHeartbeat;
+    private stopHeartbeat;
+    private waitForConnection;
+    private resolveReconnectWaiters;
+    private rejectReconnectWaiters;
+    private onDisconnect;
+    private rejectAllPending;
+    private handleFileFetch;
+    private handleDirList;
+    private handleFilePush;
+    private handleFsProbe;
+    private writeFsProbeFile;
+    private scheduleReconnect;
+}
+//# sourceMappingURL=endpoint-client.d.ts.map

package/dist/endpoint-client.d.ts.map

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