@tyvm/knowhow 0.0.161 → 0.0.163

package/ts_build/src/services/stateful/StatefulProcess.js

@@ -0,0 +1,513 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StatefulProcess = void 0;
+const crypto_1 = require("crypto");
+const os = __importStar(require("os"));
+const logger_1 = require("../../logger");
+const changesIterable_1 = require("./changesIterable");
+const Channel_1 = require("./channels/Channel");
+const types_1 = require("./types");
+const INBOX_LIMIT = 1000;
+const clone = (v) => v === undefined ? v : structuredClone(v);
+const same = (a, b) => JSON.stringify(a) === JSON.stringify(b);
+class StatefulProcess {
+    _meta;
+    _state;
+    _control;
+    _lifecycle;
+    _version = 0;
+    _controlVersion = 0;
+    _observedControlVersion = 0;
+    _channels = [];
+    pumps = new Map();
+    stateListeners = new Set();
+    controlListeners = new Set();
+    controlWaiters = [];
+    controlChain = Promise.resolve();
+    inputChain = Promise.resolve();
+    inbox = [];
+    inputWaiters = [];
+    localSeq = 0;
+    log;
+    constructor(init) {
+        const now = new Date().toISOString();
+        this.log = init.log ?? logger_1.Logger.of("StatefulProcess");
+        if (init.document) {
+            const d = init.document;
+            this._meta = clone(d.meta);
+            this._state = clone(d.state);
+            this._control = clone(d.control);
+            this._lifecycle = clone(d.lifecycle);
+            this._version = d.version;
+            this._controlVersion = d.controlVersion;
+            this._observedControlVersion = d.observedControlVersion;
+        }
+        else {
+            this._meta = {
+                id: init.id ?? (0, crypto_1.randomUUID)(),
+                kind: init.kind,
+                name: init.name,
+                parentId: init.parentId,
+                createdAt: now,
+                schemaVersion: init.schemaVersion ?? 1,
+                links: init.links,
+            };
+            this._state = init.state ?? {};
+            this._control = init.control ?? {};
+            this._lifecycle = {
+                status: "created",
+                updatedAt: now,
+                resumable: "none",
+                ...init.lifecycle,
+            };
+        }
+    }
+    get meta() {
+        return this._meta;
+    }
+    getState() {
+        return this._state;
+    }
+    getControl() {
+        return this._control;
+    }
+    getLifecycle() {
+        return this._lifecycle;
+    }
+    snapshot() {
+        return {
+            meta: this._meta,
+            state: this._state,
+            control: this._control,
+            lifecycle: this._lifecycle,
+            version: this._version,
+            controlVersion: this._controlVersion,
+            observedControlVersion: this._observedControlVersion,
+        };
+    }
+    update(mutate, opts = {}) {
+        const prev = this._state;
+        const draft = clone(prev);
+        const result = mutate(draft);
+        const next = (result === undefined ? draft : result);
+        this._state = next;
+        this._version++;
+        this.afterCommit(prev, next, opts.events ?? [], opts.reason);
+    }
+    replaceState(next, opts = {}) {
+        const prev = this._state;
+        this._state = next;
+        this._version++;
+        this.afterCommit(prev, next, opts.events ?? [], opts.reason);
+    }
+    emit(...events) {
+        this.afterCommit(this._state, this._state, events, undefined, false);
+    }
+    setStatus(status, extra = {}) {
+        const now = new Date().toISOString();
+        const prevStatus = this._lifecycle.status;
+        const next = {
+            ...this._lifecycle,
+            ...extra,
+            status,
+            updatedAt: now,
+        };
+        if (status === "running" && !next.startedAt)
+            next.startedAt = now;
+        if ((0, types_1.isTerminalStatus)(status) && !next.endedAt)
+            next.endedAt = now;
+        this._lifecycle = next;
+        this._version++;
+        this.afterCommit(this._state, this._state, [], `status:${status}`);
+        if (prevStatus !== status)
+            this.wakeControlWaiters();
+    }
+    consume(items, cursor, apply) {
+        this.update((draft) => {
+            apply(draft, items);
+            const d = draft;
+            if (d && typeof d === "object") {
+                d.inputCursors = { ...(d.inputCursors ?? {}), [cursor.source]: cursor.value };
+            }
+        }, { reason: `consume:${cursor.source}` });
+    }
+    afterCommit(prev, next, events, reason, bumped = true) {
+        const doc = this.snapshot();
+        for (const pump of this.pumps.values())
+            pump.enqueue(doc, events);
+        const change = {
+            version: this._version,
+            prev,
+            next,
+            events,
+            reason,
+        };
+        void bumped;
+        for (const cb of [...this.stateListeners]) {
+            try {
+                cb(change);
+            }
+            catch (e) {
+                this.log.error(`onStateUpdated listener failed: ${e?.message ?? e}`);
+            }
+        }
+    }
+    applyControl(patch, source = "local") {
+        const prev = this._control;
+        const next = typeof patch === "function"
+            ? patch(clone(prev))
+            : { ...prev, ...patch };
+        if (same(prev, next))
+            return;
+        this._control = next;
+        const controlVersion = ++this._controlVersion;
+        const change = { controlVersion, prev, next, source };
+        const doc = this.snapshot();
+        for (const pump of this.pumps.values())
+            pump.enqueue(doc, []);
+        for (const cb of [...this.controlListeners]) {
+            try {
+                cb(change);
+            }
+            catch (e) {
+                this.log.error(`onControlUpdated listener failed: ${e?.message ?? e}`);
+            }
+        }
+        this.controlChain = this.controlChain.then(() => this.reconcile(change));
+    }
+    async reconcile(change) {
+        const { prev, next } = change;
+        const run = async (name, fn) => {
+            if (!fn)
+                return;
+            try {
+                await fn.call(this);
+            }
+            catch (e) {
+                this.log.error(`${name} hook failed: ${e?.message ?? e}`);
+            }
+        };
+        await run("onControl", () => this.onControl?.(change));
+        if (next.desired !== prev.desired) {
+            if (next.desired === "paused")
+                await run("onPause", () => this.onPause?.());
+            else if (next.desired === "cancelled")
+                await run("onCancel", () => this.onCancel?.());
+            else if (next.desired === "running" &&
+                (prev.desired === "paused" || this._lifecycle.status === "paused")) {
+                await run("onResume", () => this.onResume?.());
+                if (this._lifecycle.status === "paused" && this._control.desired !== "paused") {
+                    this.setStatus("running");
+                }
+            }
+        }
+        if (next.interrupt?.id && next.interrupt.id !== prev.interrupt?.id) {
+            const message = next.interrupt.message;
+            await run("onInterrupt", () => this.onInterrupt?.(message));
+        }
+        this._observedControlVersion = Math.max(this._observedControlVersion, change.controlVersion);
+        const doc = this.snapshot();
+        for (const pump of this.pumps.values())
+            pump.enqueue(doc, []);
+        this.wakeControlWaiters();
+        this.rejectInputWaitersIfCancelled();
+    }
+    send(kind, payload, opts = {}) {
+        const item = {
+            id: opts.id ?? (0, crypto_1.randomUUID)(),
+            kind,
+            payload,
+            at: new Date().toISOString(),
+            from: opts.from,
+            source: "local",
+        };
+        this.localSeq++;
+        this.enqueueDelivery("local", [item], this.localSeq);
+        return item;
+    }
+    pause() {
+        this.applyControl({ desired: "paused" });
+    }
+    resume() {
+        this.applyControl({ desired: "running" });
+    }
+    cancel() {
+        this.applyControl({ desired: "cancelled" });
+    }
+    interrupt(message) {
+        this.applyControl({ interrupt: { id: (0, crypto_1.randomUUID)(), message } });
+    }
+    enqueueDelivery(source, items, cursor) {
+        const full = items.map((i) => ({
+            ...i,
+            id: i.id ?? (0, crypto_1.randomUUID)(),
+            at: i.at ?? new Date().toISOString(),
+            source,
+        }));
+        const p = this.inputChain.then(async () => {
+            try {
+                await this.deliverInput(full, { source, value: cursor });
+            }
+            catch (e) {
+                this.log.error(`onInput failed (${source}): ${e?.message ?? e}`);
+            }
+            return this._version;
+        });
+        this.inputChain = p.then(() => { });
+        return p;
+    }
+    async deliverInput(items, cursor) {
+        if (!items.length && cursor.value === undefined)
+            return;
+        this.inbox.push(...items);
+        if (this.inbox.length > INBOX_LIMIT) {
+            this.inbox.splice(0, this.inbox.length - INBOX_LIMIT);
+        }
+        if (this.onInput && items.length) {
+            await this.onInput(items, cursor);
+        }
+        else {
+            this.consume(items, cursor, () => { });
+        }
+        this.serveInputWaiters();
+    }
+    serveInputWaiters() {
+        for (const w of [...this.inputWaiters]) {
+            const idx = this.inbox.findIndex((i) => !w.filter?.kind || i.kind === w.filter.kind);
+            if (idx < 0)
+                continue;
+            const [item] = this.inbox.splice(idx, 1);
+            this.inputWaiters.splice(this.inputWaiters.indexOf(w), 1);
+            if (w.timer)
+                clearTimeout(w.timer);
+            w.resolve(item);
+        }
+    }
+    rejectInputWaitersIfCancelled() {
+        if (this._control.desired !== "cancelled")
+            return;
+        for (const w of this.inputWaiters.splice(0)) {
+            if (w.timer)
+                clearTimeout(w.timer);
+            w.reject(new types_1.ProcessCancelledError());
+        }
+    }
+    async waitForInput(filter = {}) {
+        if (this._control.desired === "cancelled")
+            throw new types_1.ProcessCancelledError();
+        const wasRunning = this._lifecycle.status === "running";
+        const idx = this.inbox.findIndex((i) => !filter.kind || i.kind === filter.kind);
+        if (idx >= 0)
+            return this.inbox.splice(idx, 1)[0];
+        if (wasRunning)
+            this.setStatus("waiting");
+        try {
+            return await new Promise((resolve, reject) => {
+                const w = { filter, resolve, reject };
+                if (filter.timeoutMs !== undefined) {
+                    w.timer = setTimeout(() => {
+                        this.inputWaiters = this.inputWaiters.filter((x) => x !== w);
+                        reject(new Error(`waitForInput timed out after ${filter.timeoutMs}ms`));
+                    }, filter.timeoutMs);
+                    w.timer.unref?.();
+                }
+                this.inputWaiters.push(w);
+            });
+        }
+        finally {
+            if (wasRunning && this._lifecycle.status === "waiting")
+                this.setStatus("running");
+        }
+    }
+    onStateUpdated(cb) {
+        this.stateListeners.add(cb);
+        return () => {
+            this.stateListeners.delete(cb);
+        };
+    }
+    onControlUpdated(cb) {
+        this.controlListeners.add(cb);
+        return () => {
+            this.controlListeners.delete(cb);
+        };
+    }
+    changes(signal) {
+        return (0, changesIterable_1.changesIterable)((cb) => this.onStateUpdated(cb), () => (0, types_1.isTerminalStatus)(this._lifecycle.status), signal);
+    }
+    wakeControlWaiters() {
+        const ws = this.controlWaiters.splice(0);
+        for (const w of ws)
+            w();
+    }
+    nextControlChange() {
+        return new Promise((r) => this.controlWaiters.push(r));
+    }
+    async checkpoint() {
+        for (;;) {
+            const desired = this._control.desired;
+            if (desired === "cancelled" || this._lifecycle.status === "cancelled") {
+                throw new types_1.ProcessCancelledError();
+            }
+            if (desired === "paused") {
+                if (this._lifecycle.status !== "paused" && !(0, types_1.isTerminalStatus)(this._lifecycle.status)) {
+                    this.setStatus("paused");
+                }
+                await this.nextControlChange();
+                continue;
+            }
+            if (this._lifecycle.status === "paused")
+                this.setStatus("running");
+            return;
+        }
+    }
+    makeContext(channel) {
+        return {
+            meta: this._meta,
+            snapshot: () => this.snapshot(),
+            applyControl: (patch) => this.applyControl(patch, channel.id),
+            deliver: (items, cursor) => this.enqueueDelivery(channel.id, items, cursor),
+            cursor: () => this._state?.inputCursors?.[channel.id],
+            persisted: (version, channelId) => this.persisted(version, channelId ?? (channel.direction !== "in" ? channel.id : undefined)),
+            setLink: (key, value) => {
+                this._meta = { ...this._meta, links: { ...this._meta.links, [key]: value } };
+                const doc = this.snapshot();
+                for (const pump of this.pumps.values())
+                    pump.enqueue(doc, []);
+            },
+            log: this.log,
+        };
+    }
+    async attach(channel) {
+        if (this._channels.some((c) => c.id === channel.id)) {
+            throw new Error(`channel ${channel.id} is already attached`);
+        }
+        this._channels.push(channel);
+        let pump;
+        if (channel.direction !== "in" && channel.publish) {
+            pump = new Channel_1.ChannelPump(channel, this.log);
+            this.pumps.set(channel.id, pump);
+        }
+        try {
+            await channel.start(this.makeContext(channel));
+        }
+        catch (e) {
+            this.removeChannel(channel);
+            throw e;
+        }
+        pump?.enqueue(this.snapshot(), []);
+        return () => {
+            void this.detach(channel.id);
+        };
+    }
+    removeChannel(channel) {
+        this._channels = this._channels.filter((c) => c !== channel);
+        this.pumps.delete(channel.id);
+    }
+    async detach(channelId) {
+        const channel = this._channels.find((c) => c.id === channelId);
+        if (!channel)
+            return;
+        const pump = this.pumps.get(channelId);
+        this.removeChannel(channel);
+        try {
+            await pump?.stop();
+            await channel.stop();
+        }
+        catch (e) {
+            this.log.error(`channel ${channelId} stop failed: ${e?.message ?? e}`);
+        }
+    }
+    channels() {
+        return this._channels;
+    }
+    async flush() {
+        let chain;
+        do {
+            chain = this.controlChain;
+            const inputs = this.inputChain;
+            await chain;
+            await inputs;
+        } while (chain !== this.controlChain);
+        await Promise.all([...this.pumps.values()].map((p) => p.flush()));
+    }
+    persisted(version, channelId) {
+        if (channelId) {
+            const pump = this.pumps.get(channelId);
+            if (!pump) {
+                return Promise.reject(new Error(`no output channel '${channelId}' attached`));
+            }
+            return pump.waitPersisted(version);
+        }
+        const durable = [...this.pumps.values()].filter((p) => p.durable);
+        return Promise.all(durable.map((p) => p.waitPersisted(version))).then(() => { });
+    }
+    async close() {
+        if (this._lifecycle.executor) {
+            this._lifecycle = { ...this._lifecycle, executor: undefined, updatedAt: new Date().toISOString() };
+            this._version++;
+            this.afterCommit(this._state, this._state, [], "close");
+        }
+        await this.flush();
+        for (const c of [...this._channels])
+            await this.detach(c.id);
+    }
+    async run(body) {
+        try {
+            this.setStatus("running", {
+                executor: { host: os.hostname(), pid: process.pid, heartbeatAt: new Date().toISOString() },
+            });
+            await this.checkpoint();
+            const result = await body(this);
+            this.setStatus("completed", { result });
+            await this.flush();
+            return result;
+        }
+        catch (e) {
+            if (e instanceof types_1.ProcessCancelledError) {
+                this.setStatus("cancelled");
+            }
+            else {
+                this.setStatus("failed", {
+                    error: { message: e?.message ?? String(e), stack: e?.stack },
+                });
+            }
+            await this.flush();
+            throw e;
+        }
+    }
+}
+exports.StatefulProcess = StatefulProcess;
+//# sourceMappingURL=StatefulProcess.js.map

package/ts_build/src/services/stateful/StatefulProcess.js.map

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

package/ts_build/src/services/stateful/agent/AgentFsChannel.d.ts

@@ -0,0 +1,68 @@
+import { DuplexChannel } from "../channels/base";
+import type { DocSource, OutputPolicy } from "../channels/Channel";
+import type { FileInputChannelOptions } from "../channels/inputStream";
+import type { ProcessDocument, ProcessStatus, Unsubscribe } from "../types";
+import type { AgentControl, AgentEvent, AgentState } from "./types";
+export declare const AGENTS_DIR = ".knowhow/processes/agents";
+export declare function legacyStatusFile(status: ProcessStatus): string;
+export declare function controlFromStatusFile(text: string): Partial<AgentControl> | undefined;
+export declare function persistRemoteIdentity(taskId: string, remoteTaskId: string, remoteMessageId?: string, baseDir?: string): Promise<void>;
+export interface AgentFsChannelOptions {
+    taskId: string;
+    baseDir?: string;
+    policy?: OutputPolicy;
+    pollMs?: number;
+    input?: Partial<FileInputChannelOptions>;
+}
+export declare class AgentFsChannel extends DuplexChannel<AgentState, AgentControl, AgentEvent> implements DocSource<AgentState, AgentControl, AgentEvent> {
+    readonly id = "fs";
+    readonly dir: string;
+    private input;
+    private pollMs;
+    private timer?;
+    private watcher?;
+    private lastSeen?;
+    private lastSeenMtime?;
+    private checking;
+    constructor(opts: AgentFsChannelOptions);
+    private get statusPath();
+    private get metadataPath();
+    private get inputPath();
+    protected onStart(): Promise<void>;
+    stop(): Promise<void>;
+    flush(): Promise<void>;
+    private writeNow;
+    private readAndApply;
+    private chain;
+    checkStatus(): Promise<boolean>;
+    private writeStatus;
+    private syncOwnerStatus;
+    publish(doc: ProcessDocument<AgentState, AgentControl>, events: AgentEvent[]): Promise<void>;
+    private writeMetadata;
+    private appendUsageEntry;
+    private mirrorVersion;
+    private readLegacy;
+    readDocument(): Promise<{
+        version: number;
+        meta: import("../types").ProcessMeta;
+        state: AgentState;
+        control: AgentControl;
+        lifecycle: import("../types").Lifecycle;
+        controlVersion: number;
+        observedControlVersion: number;
+    }>;
+    watchDocument(cb: (doc: ProcessDocument<AgentState, AgentControl>, events: AgentEvent[]) => void): Unsubscribe;
+    writeControl(patch: Partial<AgentControl>): Promise<void>;
+    appendInput(item: {
+        id?: string;
+        kind?: string;
+        text?: string;
+        payload?: unknown;
+        from?: string;
+    }): Promise<void>;
+}
+export declare function docFromLegacy(taskId: string, meta: any, statusText: string | undefined, version?: number): ProcessDocument<AgentState, AgentControl>;
+export declare function loadAgentRestoreState(taskId: string, baseDir?: string): Promise<{
+    inputCursors?: Record<string, unknown>;
+    pendingUserMessages?: any[];
+} | undefined>;