@beeos-ai/device-agent 0.4.0

package/dist/agent-runtime/skills/fs-store.js

@@ -0,0 +1,483 @@
+/**
+ * agent-runtime/skills/fs-store — FileSystem-backed
+ * {@link SkillCacheStore}.
+ *
+ * Layout:
+ * ```
+ * <root>/
+ * ├── _meta/
+ * │   └── version                         # plain text "1"
+ * ├── com.tencent.mm/
+ * │   ├── 8dc7bafa-...-e58122.json        # main record (atomic tmp+rename)
+ * │   └── 8dc7bafa-...-e58122.deltas.jsonl # append-only counter log
+ * └── com.xunmeng.pinduoduo/
+ *     └── ...
+ * ```
+ *
+ * The default root is `~/.beeos/device-agent/skills/`. Cloud
+ * deployments mount a `ReadWriteMany` PVC at `$HOME/.beeos` so multiple
+ * pods see one shared cache; on a developer laptop / EdgeAgent host the
+ * directory is just a local folder, naturally shared by every
+ * `device-agent` process running on that machine.
+ *
+ * Counter atomicity relies on POSIX O_APPEND semantics: each
+ * `recordSuccess` / `recordFailure` writes a single ≤30-byte line via
+ * `fs.appendFileSync`, which the kernel guarantees to be atomic across
+ * processes (line ≤ PIPE_BUF). When `deltas.jsonl` exceeds
+ * `compactThresholdBytes` (default 4 KB) the next writer folds the
+ * accumulated deltas into the main JSON via tmp+rename and truncates
+ * the deltas file. Read paths always fold the live deltas plus any
+ * orphaned `*.compacting` files left by a crashed writer.
+ *
+ * The schema is intentionally diff-friendly (one self-contained JSON
+ * per skill, base64-encoded embedding) so users can inspect / git-track
+ * / rsync the cache directly.
+ */
+import * as fs from "node:fs";
+import path from "node:path";
+import { homedir } from "node:os";
+import { randomUUID } from "node:crypto";
+import { cosine } from "./embedding.js";
+const STORE_VERSION = "1";
+const META_DIR = "_meta";
+const META_VERSION_FILE = "version";
+/**
+ * Trigger compaction once the per-skill deltas file crosses this size.
+ * Comfortably under PIPE_BUF (4096 on Linux/macOS) so per-line appends
+ * stay atomic across processes.
+ */
+const DEFAULT_COMPACT_THRESHOLD_BYTES = 4096;
+/**
+ * Default cache root: `~/.beeos/device-agent/skills/` unless
+ * `SKILL_CACHE_PATH` overrides it. Returns a directory path (the
+ * legacy SQLite store returned a `.sqlite` *file*; the new layout is
+ * directory-based).
+ */
+export function defaultSkillCachePath() {
+    const env = process.env.SKILL_CACHE_PATH;
+    if (env && env.length > 0)
+        return env;
+    return path.join(homedir(), ".beeos", "device-agent", "skills");
+}
+/* -------------------------------------------------------------------------- */
+/* store                                                                      */
+/* -------------------------------------------------------------------------- */
+export class FileSystemSkillCacheStore {
+    root;
+    compactThreshold;
+    constructor(opts = {}) {
+        this.root = opts.root ?? defaultSkillCachePath();
+        this.compactThreshold = opts.compactThresholdBytes ?? DEFAULT_COMPACT_THRESHOLD_BYTES;
+        if (!opts.noMkdir) {
+            fs.mkdirSync(this.root, { recursive: true });
+            fs.mkdirSync(path.join(this.root, META_DIR), { recursive: true });
+        }
+        this.writeVersionIfMissing();
+    }
+    insert(input) {
+        const now = Date.now();
+        const id = randomUUID();
+        const appDir = this.appDir(input.appPackage);
+        fs.mkdirSync(appDir, { recursive: true });
+        const persisted = {
+            id,
+            appPackage: input.appPackage,
+            taskSummary: input.taskSummary,
+            taskEmbeddingB64: input.taskEmbedding ? embeddingToB64(input.taskEmbedding) : undefined,
+            actionSequence: cloneActions(input.actionSequence),
+            successCount: 1,
+            failCount: 0,
+            lastUsedAt: now,
+            createdAt: now,
+        };
+        atomicWriteJson(this.skillJsonPath(appDir, id), persisted);
+        return persistedToSkill(persisted);
+    }
+    get(id) {
+        const located = this.locate(id);
+        if (!located)
+            return undefined;
+        return this.readSkill(located.appDir, id);
+    }
+    listByApp(appPackage, limit = 50) {
+        const dir = this.appDir(appPackage);
+        if (!fs.existsSync(dir))
+            return [];
+        const out = [];
+        for (const id of this.skillIdsIn(dir)) {
+            const skill = this.readSkill(dir, id);
+            if (skill)
+                out.push(skill);
+        }
+        out.sort((a, b) => b.lastUsedAt - a.lastUsedAt);
+        return out.slice(0, Math.max(0, limit));
+    }
+    listAll(limit = 200) {
+        if (!fs.existsSync(this.root))
+            return [];
+        const out = [];
+        for (const dir of this.appDirs()) {
+            for (const id of this.skillIdsIn(dir)) {
+                const skill = this.readSkill(dir, id);
+                if (skill)
+                    out.push(skill);
+            }
+        }
+        out.sort((a, b) => b.lastUsedAt - a.lastUsedAt);
+        return out.slice(0, Math.max(0, limit));
+    }
+    search(appPackage, query, k) {
+        const dir = this.appDir(appPackage);
+        if (!fs.existsSync(dir))
+            return [];
+        const matches = [];
+        for (const id of this.skillIdsIn(dir)) {
+            const skill = this.readSkill(dir, id);
+            if (!skill || !skill.taskEmbedding)
+                continue;
+            if (skill.taskEmbedding.length !== query.length)
+                continue;
+            const score = cosine(query, skill.taskEmbedding);
+            matches.push({ skill, score });
+        }
+        matches.sort((a, b) => b.score - a.score);
+        return matches.slice(0, Math.max(0, k));
+    }
+    recordSuccess(id, now = Date.now()) {
+        this.appendDelta(id, { ts: now, r: "ok" });
+    }
+    recordFailure(id, now = Date.now()) {
+        this.appendDelta(id, { ts: now, r: "fail" });
+    }
+    delete(id) {
+        const located = this.locate(id);
+        if (!located)
+            return false;
+        const jsonPath = this.skillJsonPath(located.appDir, id);
+        let removed = false;
+        try {
+            fs.unlinkSync(jsonPath);
+            removed = true;
+        }
+        catch {
+            // ignore — already gone
+        }
+        safeUnlink(this.skillDeltasPath(located.appDir, id));
+        for (const orphan of this.findCompacting(located.appDir, id)) {
+            safeUnlink(orphan);
+        }
+        return removed;
+    }
+    clear() {
+        if (!fs.existsSync(this.root))
+            return;
+        for (const appDir of this.appDirs()) {
+            try {
+                fs.rmSync(appDir, { recursive: true, force: true });
+            }
+            catch {
+                // best effort
+            }
+        }
+    }
+    close() {
+        // No-op: the store has no long-lived handles. Kept on the
+        // interface for parity with InMemorySkillCacheStore (the SQLite
+        // store used to actually close a DB handle here).
+    }
+    /* ----------------------------------------------------------------- */
+    /* internals                                                          */
+    /* ----------------------------------------------------------------- */
+    writeVersionIfMissing() {
+        const p = path.join(this.root, META_DIR, META_VERSION_FILE);
+        try {
+            if (!fs.existsSync(p))
+                fs.writeFileSync(p, STORE_VERSION);
+        }
+        catch {
+            // best effort — _meta is informational only
+        }
+    }
+    appDir(appPackage) {
+        return path.join(this.root, sanitizeAppPackage(appPackage));
+    }
+    skillJsonPath(appDir, id) {
+        return path.join(appDir, `${id}.json`);
+    }
+    skillDeltasPath(appDir, id) {
+        return path.join(appDir, `${id}.deltas.jsonl`);
+    }
+    appDirs() {
+        if (!fs.existsSync(this.root))
+            return [];
+        const out = [];
+        for (const name of fs.readdirSync(this.root)) {
+            if (name === META_DIR)
+                continue;
+            const full = path.join(this.root, name);
+            let stat;
+            try {
+                stat = fs.statSync(full);
+            }
+            catch {
+                continue;
+            }
+            if (stat.isDirectory())
+                out.push(full);
+        }
+        return out;
+    }
+    skillIdsIn(appDir) {
+        const out = [];
+        for (const name of fs.readdirSync(appDir)) {
+            // Take just the canonical `<id>.json`. tmp files (`<id>.json.<...>.tmp`)
+            // and deltas files (`<id>.deltas.jsonl`, `*.compacting`) are excluded
+            // by the suffix check.
+            if (!name.endsWith(".json"))
+                continue;
+            if (name.includes(".deltas."))
+                continue;
+            out.push(name.slice(0, -".json".length));
+        }
+        return out;
+    }
+    locate(id) {
+        for (const dir of this.appDirs()) {
+            if (fs.existsSync(this.skillJsonPath(dir, id))) {
+                return { appDir: dir };
+            }
+        }
+        return undefined;
+    }
+    readSkill(appDir, id) {
+        let raw;
+        try {
+            raw = fs.readFileSync(this.skillJsonPath(appDir, id), "utf8");
+        }
+        catch {
+            return undefined;
+        }
+        let persisted;
+        try {
+            persisted = JSON.parse(raw);
+        }
+        catch {
+            return undefined;
+        }
+        const fold = this.foldDeltaFiles(appDir, id);
+        return persistedToSkill({
+            ...persisted,
+            successCount: persisted.successCount + fold.success,
+            failCount: persisted.failCount + fold.fail,
+            lastUsedAt: fold.lastUsedAt !== undefined
+                ? Math.max(persisted.lastUsedAt, fold.lastUsedAt)
+                : persisted.lastUsedAt,
+        });
+    }
+    foldDeltaFiles(appDir, id) {
+        let success = 0;
+        let fail = 0;
+        let lastUsedAt;
+        const sources = [this.skillDeltasPath(appDir, id), ...this.findCompacting(appDir, id)];
+        for (const src of sources) {
+            let raw;
+            try {
+                raw = fs.readFileSync(src, "utf8");
+            }
+            catch {
+                continue;
+            }
+            for (const line of raw.split("\n")) {
+                if (!line)
+                    continue;
+                try {
+                    const obj = JSON.parse(line);
+                    if (obj.r === "ok")
+                        success += 1;
+                    else if (obj.r === "fail")
+                        fail += 1;
+                    if (typeof obj.ts === "number") {
+                        if (lastUsedAt === undefined || obj.ts > lastUsedAt)
+                            lastUsedAt = obj.ts;
+                    }
+                }
+                catch {
+                    // skip malformed line
+                }
+            }
+        }
+        return { success, fail, lastUsedAt };
+    }
+    findCompacting(appDir, id) {
+        let names;
+        try {
+            names = fs.readdirSync(appDir);
+        }
+        catch {
+            return [];
+        }
+        const prefix = `${id}.deltas.`;
+        const out = [];
+        for (const name of names) {
+            if (name.startsWith(prefix) && name.endsWith(".compacting")) {
+                out.push(path.join(appDir, name));
+            }
+        }
+        return out;
+    }
+    appendDelta(id, line) {
+        const located = this.locate(id);
+        if (!located)
+            return;
+        const deltasPath = this.skillDeltasPath(located.appDir, id);
+        const payload = `${JSON.stringify(line)}\n`;
+        try {
+            // POSIX O_APPEND atomic for ≤PIPE_BUF writes — multiple
+            // processes can hammer this concurrently without losing lines.
+            fs.appendFileSync(deltasPath, payload);
+        }
+        catch {
+            return;
+        }
+        this.maybeCompact(located.appDir, id);
+    }
+    maybeCompact(appDir, id) {
+        const deltasPath = this.skillDeltasPath(appDir, id);
+        let stat;
+        try {
+            stat = fs.statSync(deltasPath);
+        }
+        catch {
+            return;
+        }
+        if (stat.size < this.compactThreshold)
+            return;
+        // Claim the current deltas via atomic rename. New appends from
+        // concurrent writers go into a freshly-created `deltas.jsonl`;
+        // any orphaned `*.compacting` files are picked up by readers.
+        const claim = path.join(appDir, `${id}.deltas.${process.pid}.${Date.now()}.${Math.floor(Math.random() * 1e6)}.compacting`);
+        try {
+            fs.renameSync(deltasPath, claim);
+        }
+        catch {
+            // Another writer beat us to it.
+            return;
+        }
+        const claimed = readDeltasFile(claim);
+        const jsonPath = this.skillJsonPath(appDir, id);
+        let raw;
+        try {
+            raw = fs.readFileSync(jsonPath, "utf8");
+        }
+        catch {
+            // JSON gone — nothing to fold into; drop the orphan.
+            safeUnlink(claim);
+            return;
+        }
+        let persisted;
+        try {
+            persisted = JSON.parse(raw);
+        }
+        catch {
+            safeUnlink(claim);
+            return;
+        }
+        persisted.successCount += claimed.success;
+        persisted.failCount += claimed.fail;
+        if (claimed.lastUsedAt !== undefined) {
+            persisted.lastUsedAt = Math.max(persisted.lastUsedAt, claimed.lastUsedAt);
+        }
+        atomicWriteJson(jsonPath, persisted);
+        safeUnlink(claim);
+    }
+}
+/* -------------------------------------------------------------------------- */
+/* helpers                                                                    */
+/* -------------------------------------------------------------------------- */
+function readDeltasFile(p) {
+    let success = 0;
+    let fail = 0;
+    let lastUsedAt;
+    let raw;
+    try {
+        raw = fs.readFileSync(p, "utf8");
+    }
+    catch {
+        return { success, fail, lastUsedAt };
+    }
+    for (const line of raw.split("\n")) {
+        if (!line)
+            continue;
+        try {
+            const obj = JSON.parse(line);
+            if (obj.r === "ok")
+                success += 1;
+            else if (obj.r === "fail")
+                fail += 1;
+            if (typeof obj.ts === "number") {
+                if (lastUsedAt === undefined || obj.ts > lastUsedAt)
+                    lastUsedAt = obj.ts;
+            }
+        }
+        catch {
+            // skip malformed line
+        }
+    }
+    return { success, fail, lastUsedAt };
+}
+function persistedToSkill(p) {
+    return {
+        id: p.id,
+        appPackage: p.appPackage,
+        taskSummary: p.taskSummary,
+        taskEmbedding: p.taskEmbeddingB64 ? b64ToEmbedding(p.taskEmbeddingB64) : undefined,
+        actionSequence: p.actionSequence,
+        successCount: p.successCount,
+        failCount: p.failCount,
+        lastUsedAt: p.lastUsedAt,
+        createdAt: p.createdAt,
+    };
+}
+function embeddingToB64(v) {
+    return Buffer.from(v.buffer, v.byteOffset, v.byteLength).toString("base64");
+}
+function b64ToEmbedding(s) {
+    const buf = Buffer.from(s, "base64");
+    const out = new Float32Array(buf.byteLength / 4);
+    for (let i = 0; i < out.length; i++)
+        out[i] = buf.readFloatLE(i * 4);
+    return out;
+}
+function atomicWriteJson(target, payload) {
+    // Random suffix avoids the dual-writer collision: two compactors
+    // can produce different tmp files that won't clobber each other
+    // before rename. POSIX `rename` is atomic so readers always see
+    // either the old or new file, never partial bytes.
+    const tmp = `${target}.${process.pid}.${Date.now()}.${Math.floor(Math.random() * 1e6)}.tmp`;
+    fs.writeFileSync(tmp, JSON.stringify(payload, null, 2));
+    fs.renameSync(tmp, target);
+}
+function safeUnlink(p) {
+    try {
+        fs.unlinkSync(p);
+    }
+    catch {
+        // best effort
+    }
+}
+function cloneActions(seq) {
+    return seq.map((a) => ({ ...a }));
+}
+function sanitizeAppPackage(pkg) {
+    if (!pkg) {
+        throw new Error('FileSystemSkillCacheStore: appPackage must be non-empty');
+    }
+    if (pkg === "." || pkg === ".." || pkg.includes("/") || pkg.includes("\\")) {
+        throw new Error(`FileSystemSkillCacheStore: invalid appPackage "${pkg}"`);
+    }
+    if (pkg === META_DIR) {
+        throw new Error(`FileSystemSkillCacheStore: appPackage "${META_DIR}" is reserved`);
+    }
+    return pkg;
+}
+//# sourceMappingURL=fs-store.js.map

package/dist/agent-runtime/skills/fs-store.js.map

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

package/dist/agent-runtime/skills/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * agent-runtime/skills — barrel export for the Phase 3 skill memory.
+ */
+export { bufferToEmbedding, cosine, DEFAULT_EMBEDDING_DIM, embeddingToBuffer, HashEmbeddingProvider, type EmbeddingProvider, } from "./embedding.js";
+export { normaliseActionSequence, similarityRatio, type NormaliseOptions, } from "./normalise.js";
+export { InMemorySkillCacheStore } from "./memory-store.js";
+export { defaultSkillCachePath, FileSystemSkillCacheStore, type FileSystemSkillCacheStoreOptions, } from "./fs-store.js";
+export { type NewSkillInput, type Skill, type SkillActionSequence, type SkillCacheStore, type SkillMatch, type SkillSummary, } from "./types.js";
+export { evolveSkill, matchSkill, summariseSkill, type SkillEvolverOptions, type SkillMatchOutcome, type SkillMatcherOptions, } from "./matcher-evolver.js";
+export { replaySkill, type SkillReplayOptions, type SkillReplayResult, } from "./replay.js";

package/dist/agent-runtime/skills/index.js

@@ -0,0 +1,10 @@
+/**
+ * agent-runtime/skills — barrel export for the Phase 3 skill memory.
+ */
+export { bufferToEmbedding, cosine, DEFAULT_EMBEDDING_DIM, embeddingToBuffer, HashEmbeddingProvider, } from "./embedding.js";
+export { normaliseActionSequence, similarityRatio, } from "./normalise.js";
+export { InMemorySkillCacheStore } from "./memory-store.js";
+export { defaultSkillCachePath, FileSystemSkillCacheStore, } from "./fs-store.js";
+export { evolveSkill, matchSkill, summariseSkill, } from "./matcher-evolver.js";
+export { replaySkill, } from "./replay.js";
+//# sourceMappingURL=index.js.map

package/dist/agent-runtime/skills/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agent-runtime/skills/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,iBAAiB,EACjB,MAAM,EACN,qBAAqB,EACrB,iBAAiB,EACjB,qBAAqB,GAEtB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,uBAAuB,EACvB,eAAe,GAEhB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,OAAO,EACL,qBAAqB,EACrB,yBAAyB,GAE1B,MAAM,eAAe,CAAC;AAWvB,OAAO,EACL,WAAW,EACX,UAAU,EACV,cAAc,GAIf,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,WAAW,GAGZ,MAAM,aAAa,CAAC"}

package/dist/agent-runtime/skills/matcher-evolver.d.ts

@@ -0,0 +1,88 @@
+/**
+ * agent-runtime/skills/matcher-evolver — Phase 3.2 / 3.3.
+ *
+ * Provides:
+ *  - {@link matchSkill}: cosine + success-rate gated lookup that the
+ *    `AgentRunner` consults at task entry. Returns either a confident
+ *    hit ({@link SkillMatchOutcome} with `replay: true`) or a miss
+ *    that still surfaces the top candidate so callers can log telemetry.
+ *  - {@link evolveSkill}: post-task hook that updates counters or
+ *    persists a new skill row from a successful run.
+ *
+ * Both functions are pure data-transformations over a
+ * {@link SkillCacheStore} — no IO outside the store and no awareness
+ * of the executor. That keeps Phase 3.4 (CLI) and Phase 3.5 (bench)
+ * decoupled.
+ */
+import type { Action } from "@beeos-ai/device-common";
+import { type EmbeddingProvider } from "./embedding.js";
+import type { Skill, SkillCacheStore, SkillMatch } from "./types.js";
+export interface SkillMatcherOptions {
+    /** Cosine ≥ this score qualifies a hit. Plan default: 0.85. */
+    cosineThreshold?: number;
+    /**
+     * Minimum success rate (success / (success + fail)) for replay.
+     * Plan default: 0.7.
+     */
+    successRateThreshold?: number;
+    /**
+     * Minimum total invocations before we trust the success rate. New
+     * skills with a single success will still pass cosine alone — this
+     * prevents one accidental hit from disqualifying a future replay.
+     */
+    minInvocations?: number;
+    /** Top-K to consider. Plan default: 3 (we only return the best). */
+    topK?: number;
+}
+export interface SkillMatchOutcome {
+    /** Should the executor enter SkillReplay mode? */
+    replay: boolean;
+    /** Best match (defined whether we replay or not). */
+    best?: SkillMatch;
+    /** All inspected candidates, best score first. */
+    candidates: readonly SkillMatch[];
+    /** When `replay === false`, why we declined. */
+    declineReason?: "no_candidates" | "score_too_low" | "success_rate_too_low";
+}
+export declare function matchSkill(args: {
+    store: SkillCacheStore;
+    appPackage: string;
+    taskSummary: string;
+    embedding?: EmbeddingProvider;
+    options?: SkillMatcherOptions;
+}): Promise<SkillMatchOutcome>;
+export interface SkillEvolverOptions {
+    /**
+     * Minimum number of normalised steps required before a new plan-run
+     * is persisted. Avoids polluting the cache with trivial single-tap
+     * runs the planner could re-derive cheaply.
+     */
+    minStepsToCache?: number;
+    /**
+     * Similarity ratio (over normalised actions) at which we "merge" a
+     * fresh successful run into an existing skill instead of creating
+     * a new one. Default 0.8.
+     */
+    mergeRatio?: number;
+}
+export interface EvolveArgs {
+    store: SkillCacheStore;
+    appPackage: string;
+    taskSummary: string;
+    rawSequence: readonly Action[];
+    /** Whether the live run completed successfully. */
+    success: boolean;
+    /**
+     * Set when the run started by replaying a cached skill — counters
+     * land on this row instead of creating a new entry.
+     */
+    replayedSkillId?: string;
+    embedding?: EmbeddingProvider;
+    options?: SkillEvolverOptions;
+}
+export declare function evolveSkill(args: EvolveArgs): Promise<{
+    action: "skipped" | "incremented_success" | "incremented_failure" | "merged" | "inserted";
+    skillId?: string;
+}>;
+/** Helper used by tests + CLI to summarise a skill row. */
+export declare function summariseSkill(skill: Skill): string;