wispy-ai 0.1.0

package/dist/security/isolation.js

@@ -0,0 +1,37 @@
+const PERMISSIONS = {
+    main: {
+        canAccessMemory: true,
+        canAccessMainHistory: true,
+        canUseWallet: true,
+        canSendExternal: true,
+        canAccessPersonalInfo: true,
+    },
+    cron: {
+        canAccessMemory: false,
+        canAccessMainHistory: false,
+        canUseWallet: false,
+        canSendExternal: true,
+        canAccessPersonalInfo: false,
+    },
+    group: {
+        canAccessMemory: false,
+        canAccessMainHistory: false,
+        canUseWallet: false,
+        canSendExternal: true,
+        canAccessPersonalInfo: false,
+    },
+    sub: {
+        canAccessMemory: false,
+        canAccessMainHistory: false,
+        canUseWallet: false,
+        canSendExternal: false,
+        canAccessPersonalInfo: false,
+    },
+};
+export function getPermissions(sessionType) {
+    return PERMISSIONS[sessionType];
+}
+export function buildSessionKey(agentId, sessionType, peerId) {
+    return `agent:${agentId}:${sessionType}:${peerId}`;
+}
+//# sourceMappingURL=isolation.js.map

package/dist/security/isolation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isolation.js","sourceRoot":"","sources":["../../src/security/isolation.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,GAA4C;IAC3D,IAAI,EAAE;QACJ,eAAe,EAAE,IAAI;QACrB,oBAAoB,EAAE,IAAI;QAC1B,YAAY,EAAE,IAAI;QAClB,eAAe,EAAE,IAAI;QACrB,qBAAqB,EAAE,IAAI;KAC5B;IACD,IAAI,EAAE;QACJ,eAAe,EAAE,KAAK;QACtB,oBAAoB,EAAE,KAAK;QAC3B,YAAY,EAAE,KAAK;QACnB,eAAe,EAAE,IAAI;QACrB,qBAAqB,EAAE,KAAK;KAC7B;IACD,KAAK,EAAE;QACL,eAAe,EAAE,KAAK;QACtB,oBAAoB,EAAE,KAAK;QAC3B,YAAY,EAAE,KAAK;QACnB,eAAe,EAAE,IAAI;QACrB,qBAAqB,EAAE,KAAK;KAC7B;IACD,GAAG,EAAE;QACH,eAAe,EAAE,KAAK;QACtB,oBAAoB,EAAE,KAAK;QAC3B,YAAY,EAAE,KAAK;QACnB,eAAe,EAAE,KAAK;QACtB,qBAAqB,EAAE,KAAK;KAC7B;CACF,CAAC;AAEF,MAAM,UAAU,cAAc,CAAC,WAAwB;IACrD,OAAO,WAAW,CAAC,WAAW,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,OAAe,EACf,WAAwB,EACxB,MAAc;IAEd,OAAO,SAAS,OAAO,IAAI,WAAW,IAAI,MAAM,EAAE,CAAC;AACrD,CAAC"}

package/dist/skills/loader.d.ts

@@ -0,0 +1,17 @@
+export interface SkillManifest {
+    name: string;
+    description: string;
+    version: string;
+    author?: string;
+    tools: Array<{
+        name: string;
+        description: string;
+        parameters: Record<string, unknown>;
+    }>;
+    requires?: {
+        env?: string[];
+        bins?: string[];
+    };
+}
+export declare function loadSkills(soulDir: string): SkillManifest[];
+//# sourceMappingURL=loader.d.ts.map

package/dist/skills/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/skills/loader.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACrC,CAAC,CAAC;IACH,QAAQ,CAAC,EAAE;QACT,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;KACjB,CAAC;CACH;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,EAAE,CAuB3D"}

package/dist/skills/loader.js

@@ -0,0 +1,68 @@
+import { readdirSync, existsSync } from "fs";
+import { resolve } from "path";
+import { readMD } from "../utils/file.js";
+import { createLogger } from "../infra/logger.js";
+const log = createLogger("skill-loader");
+export function loadSkills(soulDir) {
+    const skillsDir = resolve(soulDir, "skills");
+    if (!existsSync(skillsDir))
+        return [];
+    const skills = [];
+    const dirs = readdirSync(skillsDir, { withFileTypes: true })
+        .filter((d) => d.isDirectory());
+    for (const dir of dirs) {
+        const skillPath = resolve(skillsDir, dir.name, "SKILL.md");
+        const content = readMD(skillPath);
+        if (!content)
+            continue;
+        try {
+            const manifest = parseSkillMd(content, dir.name);
+            skills.push(manifest);
+            log.info("Loaded skill: %s", manifest.name);
+        }
+        catch (err) {
+            log.warn("Failed to parse skill %s: %s", dir.name, err);
+        }
+    }
+    return skills;
+}
+function parseSkillMd(content, dirName) {
+    // Parse frontmatter-style SKILL.md
+    const lines = content.split("\n");
+    const manifest = {
+        name: dirName,
+        description: "",
+        version: "0.1.0",
+        tools: [],
+    };
+    let inTools = false;
+    let currentTool = null;
+    for (const line of lines) {
+        if (line.startsWith("# ")) {
+            manifest.name = line.slice(2).trim();
+        }
+        else if (line.startsWith("## Description")) {
+            // Next non-empty line is description
+        }
+        else if (line.startsWith("## Tools")) {
+            inTools = true;
+        }
+        else if (inTools && line.startsWith("### ")) {
+            if (currentTool)
+                manifest.tools.push(currentTool);
+            currentTool = { name: line.slice(4).trim(), description: "", parameters: {} };
+        }
+        else if (currentTool && line.trim() && !line.startsWith("#")) {
+            if (!currentTool.description) {
+                currentTool.description = line.trim();
+            }
+        }
+        else if (!line.startsWith("#") && line.trim() && !inTools && !manifest.description) {
+            manifest.description = line.trim();
+        }
+    }
+    if (currentTool)
+        manifest.tools.push(currentTool);
+    return manifest;
+}
+//# sourceMappingURL=loader.js.map

package/dist/skills/loader.js.map

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

package/dist/token/estimator.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Token estimation and budget management.
+ *
+ * Solves the #1 complaint with agent platforms: excessive token usage.
+ * Estimates tokens before sending, enforces budgets, and optimizes context.
+ */
+interface TokenEstimate {
+    inputTokens: number;
+    estimatedOutputTokens: number;
+    totalTokens: number;
+    estimatedCostUsd: number;
+    withinBudget: boolean;
+    model: string;
+}
+export interface TokenBudget {
+    maxTokensPerRequest: number;
+    maxTokensPerSession: number;
+    maxTokensPerDay: number;
+    warnAtPercentage: number;
+}
+export declare class TokenManager {
+    private budget;
+    private sessionUsage;
+    private dailyUsage;
+    constructor(budget?: Partial<TokenBudget>);
+    /**
+     * Estimate token count for a string using character-based approximation.
+     * More accurate than most heuristics for English/code mixed content.
+     */
+    estimateTokens(text: string): number;
+    /**
+     * Estimate tokens for a full request (system prompt + messages + tools).
+     */
+    estimateRequest(model: string, systemPrompt: string, messages: Array<{
+        role: string;
+        content: string;
+    }>, toolDeclarations?: unknown[]): TokenEstimate;
+    /**
+     * Record actual token usage after a request completes.
+     */
+    recordUsage(model: string, inputTokens: number, outputTokens: number): void;
+    /**
+     * Apply context windowing: trim message history to fit within token budget.
+     * Keeps system prompt + most recent messages that fit.
+     */
+    windowMessages(messages: Array<{
+        role: string;
+        content: string;
+    }>, maxTokens: number, systemPromptTokens: number): Array<{
+        role: string;
+        content: string;
+    }>;
+    /**
+     * Recommend the cheapest model that can handle the task.
+     */
+    recommendModel(inputTokens: number, requiresTools: boolean, requiresThinking: boolean): string;
+    getSessionTotal(): number;
+    getDailyTotal(): number;
+    getSessionCost(): number;
+    getDailyCost(): number;
+    getStats(): {
+        sessionTokens: number;
+        sessionCost: number;
+        dailyTokens: number;
+        dailyCost: number;
+        requestCount: number;
+        budget: TokenBudget;
+    };
+    resetSession(): void;
+}
+export {};
+//# sourceMappingURL=estimator.d.ts.map

package/dist/token/estimator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"estimator.d.ts","sourceRoot":"","sources":["../../src/token/estimator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA2BH,UAAU,aAAa;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;CACf;AAUD,MAAM,WAAW,WAAW;IAC1B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AASD,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,YAAY,CAAoB;IACxC,OAAO,CAAC,UAAU,CAAoB;gBAE1B,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC;IAIzC;;;OAGG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAKpC;;OAEG;IACH,eAAe,CACb,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,EAClD,gBAAgB,CAAC,EAAE,OAAO,EAAE,GAC3B,aAAa;IA+DhB;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IA0B3E;;;OAGG;IACH,cAAc,CACZ,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,EAClD,SAAS,EAAE,MAAM,EACjB,kBAAkB,EAAE,MAAM,GACzB,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAyB3C;;OAEG;IACH,cAAc,CACZ,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,OAAO,EACtB,gBAAgB,EAAE,OAAO,GACxB,MAAM;IAUT,eAAe,IAAI,MAAM;IAIzB,aAAa,IAAI,MAAM;IAOvB,cAAc,IAAI,MAAM;IAIxB,YAAY,IAAI,MAAM;IAOtB,QAAQ,IAAI;QACV,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,WAAW,CAAC;KACrB;IAWD,YAAY,IAAI,IAAI;CAGrB"}

package/dist/token/estimator.js

@@ -0,0 +1,165 @@
+/**
+ * Token estimation and budget management.
+ *
+ * Solves the #1 complaint with agent platforms: excessive token usage.
+ * Estimates tokens before sending, enforces budgets, and optimizes context.
+ */
+import { createLogger } from "../infra/logger.js";
+const log = createLogger("token");
+/** Approximate tokens per character ratio for English text. */
+const CHARS_PER_TOKEN = 4;
+/** Model context limits and pricing (per 1M tokens). */
+const MODEL_SPECS = {
+    "gemini-2.5-pro": { contextWindow: 1_000_000, inputCostPer1M: 1.25, outputCostPer1M: 10.0 },
+    "gemini-2.5-flash": { contextWindow: 1_000_000, inputCostPer1M: 0.15, outputCostPer1M: 0.60 },
+    "gemini-2.0-flash": { contextWindow: 1_000_000, inputCostPer1M: 0.10, outputCostPer1M: 0.40 },
+    "gemma-3-27b": { contextWindow: 128_000, inputCostPer1M: 0, outputCostPer1M: 0 },
+    "gemma-3-12b": { contextWindow: 128_000, inputCostPer1M: 0, outputCostPer1M: 0 },
+    "gpt-4o": { contextWindow: 128_000, inputCostPer1M: 2.50, outputCostPer1M: 10.0 },
+    "claude-opus-4": { contextWindow: 200_000, inputCostPer1M: 15.0, outputCostPer1M: 75.0 },
+    "claude-sonnet-4": { contextWindow: 200_000, inputCostPer1M: 3.0, outputCostPer1M: 15.0 },
+};
+const DEFAULT_BUDGET = {
+    maxTokensPerRequest: 100_000,
+    maxTokensPerSession: 500_000,
+    maxTokensPerDay: 2_000_000,
+    warnAtPercentage: 80,
+};
+export class TokenManager {
+    budget;
+    sessionUsage = [];
+    dailyUsage = [];
+    constructor(budget) {
+        this.budget = { ...DEFAULT_BUDGET, ...budget };
+    }
+    /**
+     * Estimate token count for a string using character-based approximation.
+     * More accurate than most heuristics for English/code mixed content.
+     */
+    estimateTokens(text) {
+        if (!text)
+            return 0;
+        return Math.ceil(text.length / CHARS_PER_TOKEN);
+    }
+    /**
+     * Estimate tokens for a full request (system prompt + messages + tools).
+     */
+    estimateRequest(model, systemPrompt, messages, toolDeclarations) {
+        const spec = MODEL_SPECS[model] || MODEL_SPECS["gemini-2.5-pro"];
+        let inputTokens = this.estimateTokens(systemPrompt);
+        for (const msg of messages) {
+            inputTokens += this.estimateTokens(msg.content) + 4; // role overhead
+        }
+        if (toolDeclarations) {
+            inputTokens += this.estimateTokens(JSON.stringify(toolDeclarations));
+        }
+        // Estimate output as 25% of input (typical for conversational AI)
+        const estimatedOutputTokens = Math.min(Math.ceil(inputTokens * 0.25), 8192);
+        const totalTokens = inputTokens + estimatedOutputTokens;
+        const estimatedCostUsd = (inputTokens / 1_000_000) * spec.inputCostPer1M +
+            (estimatedOutputTokens / 1_000_000) * spec.outputCostPer1M;
+        const sessionTotal = this.getSessionTotal() + totalTokens;
+        const dailyTotal = this.getDailyTotal() + totalTokens;
+        const withinBudget = totalTokens <= this.budget.maxTokensPerRequest &&
+            sessionTotal <= this.budget.maxTokensPerSession &&
+            dailyTotal <= this.budget.maxTokensPerDay;
+        if (!withinBudget) {
+            log.warn("Token budget exceeded: request=%d, session=%d/%d, daily=%d/%d", totalTokens, sessionTotal, this.budget.maxTokensPerSession, dailyTotal, this.budget.maxTokensPerDay);
+        }
+        const warnThreshold = this.budget.maxTokensPerDay * (this.budget.warnAtPercentage / 100);
+        if (dailyTotal > warnThreshold) {
+            log.warn("Token usage at %d%% of daily budget (%d/%d)", Math.round((dailyTotal / this.budget.maxTokensPerDay) * 100), dailyTotal, this.budget.maxTokensPerDay);
+        }
+        return {
+            inputTokens,
+            estimatedOutputTokens,
+            totalTokens,
+            estimatedCostUsd,
+            withinBudget,
+            model,
+        };
+    }
+    /**
+     * Record actual token usage after a request completes.
+     */
+    recordUsage(model, inputTokens, outputTokens) {
+        const spec = MODEL_SPECS[model] || MODEL_SPECS["gemini-2.5-pro"];
+        const costUsd = (inputTokens / 1_000_000) * spec.inputCostPer1M +
+            (outputTokens / 1_000_000) * spec.outputCostPer1M;
+        const usage = {
+            inputTokens,
+            outputTokens,
+            totalTokens: inputTokens + outputTokens,
+            costUsd,
+            timestamp: new Date().toISOString(),
+        };
+        this.sessionUsage.push(usage);
+        this.dailyUsage.push(usage);
+        log.debug("Token usage: in=%d out=%d total=%d cost=$%s", inputTokens, outputTokens, usage.totalTokens, costUsd.toFixed(4));
+    }
+    /**
+     * Apply context windowing: trim message history to fit within token budget.
+     * Keeps system prompt + most recent messages that fit.
+     */
+    windowMessages(messages, maxTokens, systemPromptTokens) {
+        const available = maxTokens - systemPromptTokens - 2000; // reserve for output
+        let used = 0;
+        const windowed = [];
+        // Always include the most recent message
+        for (let i = messages.length - 1; i >= 0; i--) {
+            const tokens = this.estimateTokens(messages[i].content) + 4;
+            if (used + tokens > available && windowed.length > 0)
+                break;
+            used += tokens;
+            windowed.unshift(messages[i]);
+        }
+        if (windowed.length < messages.length) {
+            log.debug("Context windowed: %d → %d messages (%d tokens)", messages.length, windowed.length, used);
+        }
+        return windowed;
+    }
+    /**
+     * Recommend the cheapest model that can handle the task.
+     */
+    recommendModel(inputTokens, requiresTools, requiresThinking) {
+        if (requiresThinking || inputTokens > 50_000) {
+            return "gemini-2.5-pro";
+        }
+        if (!requiresTools && inputTokens < 5_000) {
+            return "gemini-2.5-flash";
+        }
+        return "gemini-2.5-flash";
+    }
+    getSessionTotal() {
+        return this.sessionUsage.reduce((sum, u) => sum + u.totalTokens, 0);
+    }
+    getDailyTotal() {
+        const today = new Date().toISOString().slice(0, 10);
+        return this.dailyUsage
+            .filter((u) => u.timestamp.startsWith(today))
+            .reduce((sum, u) => sum + u.totalTokens, 0);
+    }
+    getSessionCost() {
+        return this.sessionUsage.reduce((sum, u) => sum + u.costUsd, 0);
+    }
+    getDailyCost() {
+        const today = new Date().toISOString().slice(0, 10);
+        return this.dailyUsage
+            .filter((u) => u.timestamp.startsWith(today))
+            .reduce((sum, u) => sum + u.costUsd, 0);
+    }
+    getStats() {
+        return {
+            sessionTokens: this.getSessionTotal(),
+            sessionCost: this.getSessionCost(),
+            dailyTokens: this.getDailyTotal(),
+            dailyCost: this.getDailyCost(),
+            requestCount: this.sessionUsage.length,
+            budget: this.budget,
+        };
+    }
+    resetSession() {
+        this.sessionUsage = [];
+    }
+}
+//# sourceMappingURL=estimator.js.map

package/dist/token/estimator.js.map

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

package/dist/utils/crypto.d.ts

@@ -0,0 +1,4 @@
+export declare function encrypt(plaintext: string, key: Buffer): string;
+export declare function decrypt(encoded: string, key: Buffer): string;
+export declare function deriveKey(secret: Buffer): Buffer;
+//# sourceMappingURL=crypto.d.ts.map

package/dist/utils/crypto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.d.ts","sourceRoot":"","sources":["../../src/utils/crypto.ts"],"names":[],"mappings":"AAIA,wBAAgB,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAS9D;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAW5D;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEhD"}

package/dist/utils/crypto.js

@@ -0,0 +1,28 @@
+import { randomBytes, createCipheriv, createDecipheriv, createHash } from "crypto";
+const ALGO = "aes-256-gcm";
+export function encrypt(plaintext, key) {
+    const iv = randomBytes(12);
+    const cipher = createCipheriv(ALGO, key, iv);
+    const encrypted = Buffer.concat([
+        cipher.update(plaintext, "utf8"),
+        cipher.final(),
+    ]);
+    const tag = cipher.getAuthTag();
+    return Buffer.concat([iv, tag, encrypted]).toString("base64");
+}
+export function decrypt(encoded, key) {
+    const buf = Buffer.from(encoded, "base64");
+    const iv = buf.subarray(0, 12);
+    const tag = buf.subarray(12, 28);
+    const encrypted = buf.subarray(28);
+    const decipher = createDecipheriv(ALGO, key, iv);
+    decipher.setAuthTag(tag);
+    return Buffer.concat([
+        decipher.update(encrypted),
+        decipher.final(),
+    ]).toString("utf8");
+}
+export function deriveKey(secret) {
+    return createHash("sha256").update(secret).digest();
+}
+//# sourceMappingURL=crypto.js.map

package/dist/utils/crypto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.js","sourceRoot":"","sources":["../../src/utils/crypto.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEnF,MAAM,IAAI,GAAG,aAAa,CAAC;AAE3B,MAAM,UAAU,OAAO,CAAC,SAAiB,EAAE,GAAW;IACpD,MAAM,EAAE,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC;IAC3B,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC;QAC9B,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC;QAChC,MAAM,CAAC,KAAK,EAAE;KACf,CAAC,CAAC;IACH,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;IAChC,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,OAAe,EAAE,GAAW;IAClD,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC3C,MAAM,EAAE,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC/B,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IACjC,MAAM,SAAS,GAAG,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;IACjD,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACzB,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC;QAC1B,QAAQ,CAAC,KAAK,EAAE;KACjB,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,MAAc;IACtC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC;AACtD,CAAC"}

package/dist/utils/file.d.ts

@@ -0,0 +1,14 @@
+export declare function ensureDir(dir: string): void;
+export declare function readJSON<T = unknown>(path: string): T | null;
+export declare function writeJSON(path: string, data: unknown): void;
+export declare function readJSON5<T = unknown>(path: string): T | null;
+/** Alias for workspace.ts compatibility */
+export declare const readYaml: typeof readYAML;
+/** Alias for workspace.ts compatibility */
+export declare const writeYaml: typeof writeYAML;
+export declare function readYAML<T = unknown>(path: string): T | null;
+export declare function writeYAML(path: string, data: unknown): void;
+export declare function readMD(path: string): string | null;
+export declare function appendJSONL(path: string, entry: unknown): void;
+export declare function readJSONL<T = unknown>(path: string): T[];
+//# sourceMappingURL=file.d.ts.map

package/dist/utils/file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../src/utils/file.ts"],"names":[],"mappings":"AAKA,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,QAEpC;AAED,wBAAgB,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAG5D;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,QAGpD;AAED,wBAAgB,SAAS,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAG7D;AAED,2CAA2C;AAC3C,eAAO,MAAM,QAAQ,iBAAW,CAAC;AACjC,2CAA2C;AAC3C,eAAO,MAAM,SAAS,kBAAY,CAAC;AAEnC,wBAAgB,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAG5D;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,QAGpD;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGlD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,QAIvD;AAED,wBAAgB,SAAS,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,EAAE,CAMxD"}

package/dist/utils/file.js

@@ -0,0 +1,54 @@
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";
+import { dirname } from "path";
+import YAML from "yaml";
+import JSON5 from "json5";
+export function ensureDir(dir) {
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+}
+export function readJSON(path) {
+    if (!existsSync(path))
+        return null;
+    return JSON.parse(readFileSync(path, "utf-8"));
+}
+export function writeJSON(path, data) {
+    ensureDir(dirname(path));
+    writeFileSync(path, JSON.stringify(data, null, 2), "utf-8");
+}
+export function readJSON5(path) {
+    if (!existsSync(path))
+        return null;
+    return JSON5.parse(readFileSync(path, "utf-8"));
+}
+/** Alias for workspace.ts compatibility */
+export const readYaml = readYAML;
+/** Alias for workspace.ts compatibility */
+export const writeYaml = writeYAML;
+export function readYAML(path) {
+    if (!existsSync(path))
+        return null;
+    return YAML.parse(readFileSync(path, "utf-8"));
+}
+export function writeYAML(path, data) {
+    ensureDir(dirname(path));
+    writeFileSync(path, YAML.stringify(data), "utf-8");
+}
+export function readMD(path) {
+    if (!existsSync(path))
+        return null;
+    return readFileSync(path, "utf-8");
+}
+export function appendJSONL(path, entry) {
+    ensureDir(dirname(path));
+    const line = JSON.stringify(entry) + "\n";
+    writeFileSync(path, line, { flag: "a", encoding: "utf-8" });
+}
+export function readJSONL(path) {
+    if (!existsSync(path))
+        return [];
+    return readFileSync(path, "utf-8")
+        .split("\n")
+        .filter(Boolean)
+        .map((l) => JSON.parse(l));
+}
+//# sourceMappingURL=file.js.map

package/dist/utils/file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.js","sourceRoot":"","sources":["../../src/utils/file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AACxE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,QAAQ,CAAc,IAAY;IAChD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,IAAa;IACnD,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACzB,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,SAAS,CAAc,IAAY;IACjD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,OAAO,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;AAClD,CAAC;AAED,2CAA2C;AAC3C,MAAM,CAAC,MAAM,QAAQ,GAAG,QAAQ,CAAC;AACjC,2CAA2C;AAC3C,MAAM,CAAC,MAAM,SAAS,GAAG,SAAS,CAAC;AAEnC,MAAM,UAAU,QAAQ,CAAc,IAAY;IAChD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,IAAa;IACnD,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACzB,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,IAAY;IACjC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,OAAO,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,KAAc;IACtD,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACzB,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;IAC1C,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,SAAS,CAAc,IAAY;IACjD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,OAAO,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC;SAC/B,KAAK,CAAC,IAAI,CAAC;SACX,MAAM,CAAC,OAAO,CAAC;SACf,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/B,CAAC"}

package/dist/utils/media.d.ts

@@ -0,0 +1,6 @@
+export type MediaType = "image" | "video" | "audio" | "document" | "unknown";
+export declare function detectMediaType(filename: string, mime?: string): MediaType;
+export declare function saveMedia(runtimeDir: string, direction: "incoming" | "outgoing", filename: string, data: Buffer): string;
+export declare function loadMedia(path: string): Buffer | null;
+export declare function downloadMedia(url: string, runtimeDir: string): Promise<string | null>;
+//# sourceMappingURL=media.d.ts.map

package/dist/utils/media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../../src/utils/media.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;AA0B7E,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAI1E;AAED,wBAAgB,SAAS,CACvB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,UAAU,GAAG,UAAU,EAClC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,MAAM,CASR;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGrD;AAED,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAY3F"}

package/dist/utils/media.js

@@ -0,0 +1,65 @@
+import { resolve } from "path";
+import { writeFileSync, readFileSync, existsSync } from "fs";
+import { ensureDir } from "./file.js";
+import { createLogger } from "../infra/logger.js";
+import { randomBytes } from "crypto";
+const log = createLogger("media");
+const MIME_MAP = {
+    "image/png": "image",
+    "image/jpeg": "image",
+    "image/gif": "image",
+    "image/webp": "image",
+    "image/heic": "image",
+    "image/svg+xml": "image",
+    "video/mp4": "video",
+    "video/webm": "video",
+    "audio/mpeg": "audio",
+    "audio/ogg": "audio",
+    "audio/wav": "audio",
+    "audio/mp4": "audio",
+    "application/pdf": "document",
+};
+const EXT_MAP = {
+    ".png": "image", ".jpg": "image", ".jpeg": "image", ".gif": "image",
+    ".webp": "image", ".heic": "image", ".svg": "image",
+    ".mp4": "video", ".webm": "video", ".mov": "video",
+    ".mp3": "audio", ".ogg": "audio", ".wav": "audio", ".m4a": "audio", ".opus": "audio",
+    ".pdf": "document", ".docx": "document",
+};
+export function detectMediaType(filename, mime) {
+    if (mime && MIME_MAP[mime])
+        return MIME_MAP[mime];
+    const ext = filename.toLowerCase().match(/\.[a-z0-9]+$/)?.[0] || "";
+    return EXT_MAP[ext] || "unknown";
+}
+export function saveMedia(runtimeDir, direction, filename, data) {
+    const dir = resolve(runtimeDir, "media", direction);
+    ensureDir(dir);
+    const id = randomBytes(8).toString("hex");
+    const safeName = `${id}-${filename.replace(/[^a-zA-Z0-9._-]/g, "_")}`;
+    const path = resolve(dir, safeName);
+    writeFileSync(path, data);
+    log.debug("Saved %s media: %s", direction, safeName);
+    return path;
+}
+export function loadMedia(path) {
+    if (!existsSync(path))
+        return null;
+    return readFileSync(path);
+}
+export async function downloadMedia(url, runtimeDir) {
+    try {
+        const res = await fetch(url);
+        if (!res.ok)
+            return null;
+        const buf = Buffer.from(await res.arrayBuffer());
+        const urlParts = new URL(url);
+        const filename = urlParts.pathname.split("/").pop() || "download";
+        return saveMedia(runtimeDir, "incoming", filename, buf);
+    }
+    catch (err) {
+        log.error({ err }, "Failed to download media from %s", url);
+        return null;
+    }
+}
+//# sourceMappingURL=media.js.map

package/dist/utils/media.js.map

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

package/dist/wallet/x402.d.ts

@@ -0,0 +1,22 @@
+import type { DeviceIdentity } from "../security/device-identity.js";
+export interface WalletInfo {
+    address: string;
+    chain: string;
+    createdAt: string;
+}
+export interface WalletState {
+    info: WalletInfo;
+    encryptedKey: string;
+}
+export declare function getWalletPath(runtimeDir: string): string;
+export declare function initWallet(runtimeDir: string, identity: DeviceIdentity, chain?: string): WalletInfo;
+export declare function getWalletAddress(runtimeDir: string): string | null;
+export declare function getBalance(runtimeDir: string, rpcUrl?: string): Promise<string>;
+export declare function logTransaction(runtimeDir: string, tx: {
+    type: string;
+    to: string;
+    amount: string;
+    hash?: string;
+    status: string;
+}): void;
+//# sourceMappingURL=x402.d.ts.map

package/dist/wallet/x402.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"x402.d.ts","sourceRoot":"","sources":["../../src/wallet/x402.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAKrE,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,UAAU,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAID,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wBAAgB,UAAU,CACxB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,cAAc,EACxB,KAAK,GAAE,MAAe,GACrB,UAAU,CA2BZ;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGlE;AAED,wBAAsB,UAAU,CAC9B,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,MAAmC,GAC1C,OAAO,CAAC,MAAM,CAAC,CAmBjB;AAED,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,QAMhF"}