@tyvm/knowhow 0.0.161 → 0.0.163

package/ts_build/src/services/stateful/agent/KnowhowWebChannel.js

@@ -0,0 +1,294 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KnowhowWebChannel = void 0;
+const base_1 = require("../channels/base");
+const delta_1 = require("../channels/delta");
+const types_1 = require("../types");
+const KnowhowClient_1 = require("../../KnowhowClient");
+const httpStatus = (e) => e?.status ?? e?.response?.status;
+function statusToControl(status) {
+    if (status === "killed" || status === "cancelled")
+        return { desired: "cancelled" };
+    if (status === "paused")
+        return { desired: "paused" };
+    if (status === "running")
+        return { desired: "running" };
+    return undefined;
+}
+class KnowhowWebChannel extends base_1.DuplexChannel {
+    opts;
+    id = "web";
+    client;
+    remoteTaskId;
+    cursor = new delta_1.ThreadCursor();
+    legacyServer = false;
+    disabled = false;
+    errorLogged = false;
+    lastStatus;
+    lastSent;
+    lastWriteAt = 0;
+    lastDoc;
+    handled = new Set();
+    toMark = new Set();
+    timer;
+    chain = Promise.resolve();
+    stopped = false;
+    constructor(opts) {
+        super();
+        this.opts = opts;
+        this.client = opts.client ?? new KnowhowClient_1.KnowhowSimpleClient();
+        this.remoteTaskId = opts.remoteTaskId;
+        this.policy = opts.policy ?? { minIntervalMs: 1000 };
+    }
+    static create(opts) {
+        return new KnowhowWebChannel(opts);
+    }
+    static existing(remoteTaskId, opts = {}) {
+        return new KnowhowWebChannel({ ...opts, remoteTaskId });
+    }
+    get taskId() {
+        return this.remoteTaskId;
+    }
+    reportOnce(message, error) {
+        if (this.errorLogged)
+            return;
+        this.errorLogged = true;
+        this.ctx?.log.error(`${message} ${error?.message ?? error}`);
+    }
+    async onStart() {
+        this.stopped = false;
+        if (!this.remoteTaskId) {
+            try {
+                const doc = this.ctx.snapshot();
+                const res = await this.client.createChatTask({
+                    messageId: this.opts.messageId,
+                    prompt: doc.state.prompt,
+                });
+                this.remoteTaskId = res.data.id;
+                if (this.opts.messageId)
+                    this.ctx.setLink("remoteMessageId", this.opts.messageId);
+            }
+            catch (e) {
+                this.disabled = true;
+                this.reportOnce("Failed to create Knowhow chat task:", e);
+                return;
+            }
+        }
+        this.ctx.setLink("remoteTaskId", this.remoteTaskId);
+        this.timer = setInterval(() => void this.idlePoll(), this.opts.pollMs ?? 3000);
+        this.timer.unref?.();
+    }
+    async stop() {
+        this.stopped = true;
+        if (this.timer)
+            clearInterval(this.timer);
+        this.timer = undefined;
+        await this.chain.catch(() => { });
+    }
+    serial(fn) {
+        const p = this.chain.then(fn, fn);
+        this.chain = p.catch(() => { });
+        return p;
+    }
+    statusFields(doc) {
+        const terminal = (0, types_1.isTerminalStatus)(doc.lifecycle.status);
+        const result = doc.lifecycle.result;
+        return {
+            inProgress: !terminal,
+            totalUsdCost: doc.state.totalCostUsd,
+            ...(terminal && result !== undefined ? { result } : {}),
+        };
+    }
+    async publish(doc, _events) {
+        if (this.disabled || !this.remoteTaskId)
+            return;
+        this.lastDoc = doc;
+        await this.serial(() => this.write(doc));
+    }
+    async write(doc) {
+        try {
+            await this.writeThreads(doc);
+        }
+        catch (e) {
+            const code = httpStatus(e);
+            const reason = e?.body?.reason ?? e?.body?.errors?.reason;
+            if (code === 404 || code === 405) {
+                this.legacyServer = true;
+            }
+            else if (!(code === 409 && reason === "inline_storage")) {
+                throw e;
+            }
+            await this.writeFull(doc, this.statusFields(doc));
+        }
+    }
+    async writeThreads(doc) {
+        const id = this.remoteTaskId;
+        const threads = doc.state.threads;
+        const fields = this.statusFields(doc);
+        const fieldsKey = JSON.stringify(fields);
+        if (this.legacyServer)
+            return this.writeFull(doc, fields);
+        const steps = this.cursor.plan(threads);
+        if (!steps.length) {
+            if (fieldsKey === this.lastSent)
+                return;
+            const index = Math.max(0, threads.length - 1);
+            const length = this.cursor.view(index).length;
+            try {
+                await this.send(() => this.client.appendTaskThread(id, index, { ...fields, length, messages: [] }));
+            }
+            catch (e) {
+                if (httpStatus(e) !== 409)
+                    throw e;
+                const thread = threads[index] ?? [];
+                this.cursor.reset(index);
+                await this.send(() => this.client.replaceTaskThread(id, index, { ...fields, messages: thread }));
+                this.cursor.ackStep({ index, kind: "replace", items: thread }, thread);
+            }
+            this.lastSent = fieldsKey;
+            return;
+        }
+        for (let i = 0; i < steps.length; i++) {
+            const step = steps[i];
+            const thread = threads[step.index] ?? [];
+            const last = i === steps.length - 1;
+            const status = last ? fields : {};
+            try {
+                if (step.kind === "append") {
+                    await this.send(() => this.client.appendTaskThread(id, step.index, {
+                        ...status,
+                        length: thread.length,
+                        messages: step.items,
+                    }));
+                }
+                else {
+                    await this.send(() => this.client.replaceTaskThread(id, step.index, { ...status, messages: thread }));
+                }
+                this.cursor.ackStep(step, thread);
+            }
+            catch (e) {
+                const code = httpStatus(e);
+                if (code === 404 || code === 405) {
+                    this.legacyServer = true;
+                    return this.writeFull(doc, fields);
+                }
+                if (code === 409) {
+                    const reason = e?.body?.reason ?? e?.body?.errors?.reason;
+                    if (reason === "inline_storage")
+                        return this.writeFull(doc, fields);
+                    this.cursor.reset(step.index);
+                    await this.send(() => this.client.replaceTaskThread(id, step.index, { ...status, messages: thread }));
+                    this.cursor.ackStep({ index: step.index, kind: "replace", items: thread }, thread);
+                }
+                else {
+                    throw e;
+                }
+            }
+        }
+        this.lastSent = fieldsKey;
+    }
+    async writeFull(doc, fields) {
+        const id = this.remoteTaskId;
+        await this.client.updateChatTask(id, {
+            threads: doc.state.threads,
+            totalUsdCost: fields.totalUsdCost ?? 0,
+            inProgress: fields.inProgress ?? true,
+            ...(fields.result !== undefined ? { result: fields.result } : {}),
+        });
+        doc.state.threads.forEach((t, i) => this.cursor.ackStep({ index: i, kind: "replace", items: t }, t));
+        this.lastSent = JSON.stringify(fields);
+    }
+    async send(call) {
+        const res = await call();
+        this.lastWriteAt = Date.now();
+        await this.onResponse(res.data);
+    }
+    async onResponse(r) {
+        if (!r)
+            return;
+        this.observeStatus(r.status, r.desiredStatus);
+        if (r.pendingMessages?.length)
+            await this.deliverPending(r.pendingMessages);
+        await this.markPending();
+    }
+    observeStatus(status, desiredStatus) {
+        const token = desiredStatus ? desiredStatus : status;
+        if (token === undefined || token === this.lastStatus)
+            return;
+        const first = this.lastStatus === undefined;
+        this.lastStatus = token;
+        if (first)
+            return;
+        const patch = statusToControl(token);
+        if (patch)
+            this.ctx.applyControl(patch);
+    }
+    async deliverPending(pending) {
+        const fresh = pending.filter((m) => !this.handled.has(m.id));
+        if (!fresh.length)
+            return;
+        for (const m of fresh)
+            this.handled.add(m.id);
+        const items = fresh.map((m) => ({
+            id: m.id,
+            kind: "message",
+            payload: { text: m.message, role: m.role },
+            at: new Date(m.createdAt ?? Date.now()).toISOString(),
+        }));
+        const version = await this.ctx.deliver(items, fresh[fresh.length - 1].id);
+        try {
+            await this.ctx.persisted(version, "fs");
+        }
+        catch {
+        }
+        for (const m of fresh)
+            this.toMark.add(m.id);
+    }
+    async markPending() {
+        if (!this.toMark.size || !this.remoteTaskId)
+            return;
+        const ids = [...this.toMark];
+        try {
+            await this.client.markMessagesAsProcessed(this.remoteTaskId, ids);
+            ids.forEach((i) => this.toMark.delete(i));
+        }
+        catch (e) {
+            this.reportOnce("Failed to mark messages processed:", e);
+        }
+    }
+    async idlePoll() {
+        if (this.stopped || this.disabled || !this.remoteTaskId || !this.lastDoc)
+            return;
+        if (Date.now() - this.lastWriteAt < (this.opts.pollMs ?? 3000))
+            return;
+        if ((0, types_1.isTerminalStatus)(this.ctx.snapshot().lifecycle.status))
+            return;
+        await this.serial(async () => {
+            try {
+                const doc = this.ctx.snapshot();
+                if (this.legacyServer) {
+                    const id = this.remoteTaskId;
+                    const details = (await this.client.getTaskDetails(id)).data;
+                    this.observeStatus(details.status, details.desiredStatus);
+                    const pending = (await this.client.getPendingMessages(id)).data ?? [];
+                    await this.deliverPending(pending);
+                    await this.markPending();
+                }
+                else {
+                    const index = Math.max(0, doc.state.threads.length - 1);
+                    const length = this.cursor.view(index).length;
+                    await this.send(() => this.client.appendTaskThread(this.remoteTaskId, index, {
+                        ...this.statusFields(doc),
+                        length,
+                        messages: [],
+                    }));
+                }
+            }
+            catch (e) {
+                this.reportOnce("Error polling Knowhow task:", e);
+            }
+        });
+    }
+}
+exports.KnowhowWebChannel = KnowhowWebChannel;
+//# sourceMappingURL=KnowhowWebChannel.js.map

package/ts_build/src/services/stateful/agent/KnowhowWebChannel.js.map

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

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

@@ -0,0 +1,14 @@
+import type { KnowhowSimpleClient } from "../../KnowhowClient";
+import type { AgentChannel } from "./AgentSession";
+export declare function isUuid(value: string | undefined): value is string;
+export interface AgentChannelsOptions {
+    taskId: string;
+    messageId?: string;
+    remoteTaskId?: string;
+    syncFs?: boolean;
+    syncRemote?: boolean;
+    client?: KnowhowSimpleClient;
+    baseDir?: string;
+    pollMs?: number;
+}
+export declare function agentChannels(o: AgentChannelsOptions): AgentChannel[];

package/ts_build/src/services/stateful/agent/agentChannels.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isUuid = isUuid;
+exports.agentChannels = agentChannels;
+const AgentFsChannel_1 = require("./AgentFsChannel");
+const KnowhowWebChannel_1 = require("./KnowhowWebChannel");
+function isUuid(value) {
+    return (!!value &&
+        /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(value));
+}
+function agentChannels(o) {
+    const channels = [
+        new AgentFsChannel_1.AgentFsChannel({ taskId: o.taskId, baseDir: o.baseDir, pollMs: o.pollMs }),
+    ];
+    if (o.messageId && !o.syncFs) {
+        channels.push(KnowhowWebChannel_1.KnowhowWebChannel.create({ messageId: o.messageId, client: o.client }));
+    }
+    else if (o.syncRemote && !o.messageId && isUuid(o.remoteTaskId)) {
+        channels.push(KnowhowWebChannel_1.KnowhowWebChannel.existing(o.remoteTaskId, { client: o.client }));
+    }
+    return channels;
+}
+//# sourceMappingURL=agentChannels.js.map

package/ts_build/src/services/stateful/agent/agentChannels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentChannels.js","sourceRoot":"","sources":["../../../../../src/services/stateful/agent/agentChannels.ts"],"names":[],"mappings":";;AAMA,wBAKC;AAuBD,sCAUC;AA1CD,qDAAkD;AAClD,2DAAwD;AAGxD,SAAgB,MAAM,CAAC,KAAyB;IAC9C,OAAO,CACL,CAAC,CAAC,KAAK;QACP,4EAA4E,CAAC,IAAI,CAAC,KAAK,CAAC,CACzF,CAAC;AACJ,CAAC;AAuBD,SAAgB,aAAa,CAAC,CAAuB;IACnD,MAAM,QAAQ,GAAmB;QAC/B,IAAI,+BAAc,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;KAC/E,CAAC;IACF,IAAI,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAC7B,QAAQ,CAAC,IAAI,CAAC,qCAAiB,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACxF,CAAC;SAAM,IAAI,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC,SAAS,IAAI,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC;QAClE,QAAQ,CAAC,IAAI,CAAC,qCAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAClF,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

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

@@ -0,0 +1,59 @@
+import { EventService } from "../../EventService";
+import { KnowhowSimpleClient } from "../../KnowhowClient";
+import type { SyncedAgentWatcher, AttachableAgent } from "../../SyncedAgentWatcher";
+import type { DocSource } from "../channels/Channel";
+import { ProcessMirror } from "../ProcessMirror";
+import type { ProcessDocument, Unsubscribe } from "../types";
+import type { AgentControl, AgentEvent, AgentState } from "./types";
+type Doc = ProcessDocument<AgentState, AgentControl>;
+export type AgentMirror = ProcessMirror<AgentState, AgentControl, AgentEvent>;
+export declare class KnowhowWebSource implements DocSource<AgentState, AgentControl, AgentEvent> {
+    private taskId;
+    private client;
+    private pollMs;
+    private version;
+    constructor(taskId: string, client?: KnowhowSimpleClient, pollMs?: number);
+    private toDoc;
+    readDocument(): Promise<Doc | undefined>;
+    watchDocument(cb: (doc: Doc, events: AgentEvent[]) => void): Unsubscribe;
+    writeControl(patch: Partial<AgentControl>): Promise<void>;
+    appendInput(item: {
+        text?: string;
+        payload?: unknown;
+    }): Promise<void>;
+}
+export declare class MirrorAgentWatcher implements SyncedAgentWatcher {
+    private makeSource?;
+    taskId: string;
+    agentName: string;
+    agentEvents: EventService;
+    eventTypes: {
+        done: string;
+        toolCall: string;
+        toolUsed: string;
+        agentSay: string;
+        threadUpdate: string;
+    };
+    protected mirror?: AgentMirror;
+    private stopProjection?;
+    constructor(makeSource?: (taskId: string) => DocSource<AgentState, AgentControl, AgentEvent>);
+    attach(mirror: AgentMirror): void;
+    startWatching(taskId: string): Promise<void>;
+    protected onStarted(): void;
+    stopWatching(): void;
+    sendMessage(message: string): Promise<void>;
+    getThreads(): Promise<any[][]>;
+    pause(): Promise<void>;
+    unpause(): Promise<void>;
+    kill(): Promise<void>;
+    interrupt(message?: string): Promise<void>;
+}
+export declare class FsSyncedAgentWatcher extends MirrorAgentWatcher {
+    constructor();
+}
+export declare class WebSyncedAgentWatcher extends MirrorAgentWatcher {
+    constructor(client?: KnowhowSimpleClient);
+    protected onStarted(): void;
+}
+export declare function asAttachable(mirror: AgentMirror): AttachableAgent;
+export {};

package/ts_build/src/services/stateful/agent/agentMirror.js

@@ -0,0 +1,203 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebSyncedAgentWatcher = exports.FsSyncedAgentWatcher = exports.MirrorAgentWatcher = exports.KnowhowWebSource = void 0;
+exports.asAttachable = asAttachable;
+const EventService_1 = require("../../EventService");
+const KnowhowClient_1 = require("../../KnowhowClient");
+const SyncedAgentWatcher_1 = require("../../SyncedAgentWatcher");
+const ProcessMirror_1 = require("../ProcessMirror");
+const AgentFsChannel_1 = require("./AgentFsChannel");
+const agentProjection_1 = require("./agentProjection");
+class KnowhowWebSource {
+    taskId;
+    client;
+    pollMs;
+    version = 0;
+    constructor(taskId, client = new KnowhowClient_1.KnowhowSimpleClient(), pollMs = 3000) {
+        this.taskId = taskId;
+        this.client = client;
+        this.pollMs = pollMs;
+    }
+    toDoc(d) {
+        const raw = d.status;
+        const status = raw === "completed" || (!raw && d.inProgress === false)
+            ? "completed"
+            : raw === "killed"
+                ? "cancelled"
+                : raw === "paused"
+                    ? "paused"
+                    : "running";
+        const now = d.updatedAt ?? new Date().toISOString();
+        return {
+            meta: {
+                id: this.taskId,
+                kind: "agent",
+                name: "remote-agent",
+                createdAt: d.createdAt ?? now,
+                schemaVersion: 1,
+                links: { remoteTaskId: this.taskId },
+            },
+            state: {
+                agentName: "remote-agent",
+                model: "",
+                provider: "",
+                enabledTools: [],
+                threads: d.threads ?? [],
+                totalCostUsd: d.totalUsdCost ?? 0,
+                tokenUsage: {
+                    totalInputTokens: 0,
+                    totalOutputTokens: 0,
+                    totalCacheReadTokens: 0,
+                    totalCacheWriteTokens: 0,
+                },
+                prompt: "",
+                pendingUserMessages: [],
+                inputCursors: {},
+                result: d.result,
+            },
+            control: raw === "paused" ? { desired: "paused" } : raw === "killed" ? { desired: "cancelled" } : {},
+            lifecycle: { status, updatedAt: now, resumable: "none", result: d.result },
+            version: this.version,
+            controlVersion: 0,
+            observedControlVersion: 0,
+        };
+    }
+    async readDocument() {
+        const res = await this.client.getTaskDetails(this.taskId);
+        this.version = Math.max(this.version, 1);
+        return this.toDoc(res?.data ?? {});
+    }
+    watchDocument(cb) {
+        let last;
+        let stopped = false;
+        let busy = false;
+        const poll = async () => {
+            if (stopped || busy)
+                return;
+            busy = true;
+            try {
+                const res = await this.client.getTaskDetails(this.taskId);
+                const doc = this.toDoc(res?.data ?? {});
+                const sig = JSON.stringify([doc.state, doc.lifecycle.status]);
+                const first = last === undefined;
+                if (sig !== last) {
+                    last = sig;
+                    if (!first) {
+                        this.version++;
+                        cb({ ...doc, version: this.version }, []);
+                    }
+                }
+            }
+            catch {
+            }
+            finally {
+                busy = false;
+            }
+        };
+        void poll();
+        const timer = setInterval(poll, this.pollMs);
+        timer.unref?.();
+        return () => {
+            stopped = true;
+            clearInterval(timer);
+        };
+    }
+    async writeControl(patch) {
+        if (patch.desired === "paused")
+            await this.client.pauseAgent(this.taskId);
+        else if (patch.desired === "running")
+            await this.client.resumeAgent(this.taskId);
+        else if (patch.desired === "cancelled")
+            await this.client.killAgent(this.taskId);
+        if (patch.interrupt) {
+            await this.client.sendMessageToAgent(this.taskId, `/poke ${patch.interrupt.message || ""}`.trim());
+        }
+        if (patch.compact)
+            await this.client.sendMessageToAgent(this.taskId, "/compact");
+    }
+    async appendInput(item) {
+        const p = item.payload;
+        const text = item.text ?? (typeof p === "string" ? p : p?.text) ?? "";
+        await this.client.sendMessageToAgent(this.taskId, text);
+    }
+}
+exports.KnowhowWebSource = KnowhowWebSource;
+class MirrorAgentWatcher {
+    makeSource;
+    taskId = "";
+    agentName = "unknown";
+    agentEvents = new EventService_1.EventService();
+    eventTypes = { ...agentProjection_1.PROJECTION_EVENT_TYPES };
+    mirror;
+    stopProjection;
+    constructor(makeSource) {
+        this.makeSource = makeSource;
+    }
+    attach(mirror) {
+        this.mirror = mirror;
+        this.taskId = mirror.meta.id;
+        this.agentName = mirror.getState().agentName || this.taskId;
+        this.stopProjection = (0, agentProjection_1.agentProjection)(mirror, this.agentEvents, {
+            types: this.eventTypes,
+            onDone: () => this.stopWatching(),
+        });
+    }
+    async startWatching(taskId) {
+        this.taskId = taskId;
+        const source = this.makeSource(taskId);
+        this.attach(await ProcessMirror_1.ProcessMirror.open(source));
+        this.onStarted();
+    }
+    onStarted() {
+        console.log(`👁️  Watching agent: ${this.taskId} (${this.agentName})`);
+        console.log(`   Type /logs 20 to see recent messages, or type to send a message`);
+    }
+    stopWatching() {
+        this.stopProjection?.();
+        this.stopProjection = undefined;
+        this.mirror?.close();
+        console.log(`🔌 Stopped watching agent: ${this.taskId}`);
+    }
+    async sendMessage(message) {
+        await this.mirror.send("message", { text: message });
+    }
+    async getThreads() {
+        return this.mirror?.getState().threads ?? [];
+    }
+    async pause() {
+        await this.mirror.pause();
+    }
+    async unpause() {
+        await this.mirror.resume();
+    }
+    async kill() {
+        await this.mirror.cancel();
+    }
+    async interrupt(message) {
+        await this.mirror.interrupt(message);
+    }
+}
+exports.MirrorAgentWatcher = MirrorAgentWatcher;
+class FsSyncedAgentWatcher extends MirrorAgentWatcher {
+    constructor() {
+        super((taskId) => new AgentFsChannel_1.AgentFsChannel({ taskId }));
+    }
+}
+exports.FsSyncedAgentWatcher = FsSyncedAgentWatcher;
+class WebSyncedAgentWatcher extends MirrorAgentWatcher {
+    constructor(client) {
+        super((taskId) => new KnowhowWebSource(taskId, client));
+    }
+    onStarted() {
+        this.agentName = "remote-agent";
+        console.log(`🌐 Watching web-synced agent: ${this.taskId} (${this.agentName})`);
+        console.log(`   Type /logs 20 to see recent messages, or type to send a message`);
+    }
+}
+exports.WebSyncedAgentWatcher = WebSyncedAgentWatcher;
+function asAttachable(mirror) {
+    const watcher = new MirrorAgentWatcher();
+    watcher.attach(mirror);
+    return new SyncedAgentWatcher_1.WatcherBackedAgent(watcher);
+}
+//# sourceMappingURL=agentMirror.js.map

package/ts_build/src/services/stateful/agent/agentMirror.js.map

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

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

@@ -0,0 +1,27 @@
+import { EventService } from "../../EventService";
+import type { ProcessHandle } from "../types";
+import type { AgentControl, AgentEvent, AgentState } from "./types";
+export declare const PROJECTION_EVENT_TYPES: {
+    done: string;
+    toolCall: string;
+    toolUsed: string;
+    agentSay: string;
+    threadUpdate: string;
+};
+export declare class ThreadDiffer {
+    private index;
+    private length;
+    private lastJson;
+    constructor(threads?: any[][]);
+    seed(threads: any[][]): void;
+    next(threads: any[][]): any[];
+    get state(): {
+        index: number;
+        length: number;
+        lastJson: string;
+    };
+}
+export declare function agentProjection(handle: ProcessHandle<AgentState, AgentControl, AgentEvent>, events: EventService, opts?: {
+    types?: typeof PROJECTION_EVENT_TYPES;
+    onDone?: (result: unknown) => void;
+}): () => void;