pi-fabric 0.9.0 → 0.10.0

package/README.md

@@ -320,6 +320,34 @@ Two response modes are available:
 
 Delivery can remain in `mailbox` or enter the main session as `steer`, `followUp`, or `nextTurn`. The creator fixes delivery policy; an actor cannot escalate it in a response. Use `agents.ask()` for a blocking exchange, `agents.tell()` for fire-and-forget mail, `agents.messages()` for history, and `agents.remove()` for cleanup.
 
+### Global actor templates
+
+Persistent actors live in a project mesh, but a persona worth reusing across projects belongs in a project-independent **template library** stored in your agent dir (`~/.pi/agent/fabric/actors/`). Templates carry only an actor definition — name, instructions, subscriptions, and run settings — never any history (mailbox, session transcript, or run logs). They are not live; you stamp one into a project to make it run.
+
+```ts
+// Save a reusable persona to the global registry (not a live actor).
+return agents.create({
+  name: "security-reviewer",
+  instructions: "Review changes for security defects. Reply with a directive only for material drift.",
+  events: ["agent_settled"],
+  responseMode: "directive",
+  scope: "global",
+});
+
+// List templates, then stamp one into the current project as a fresh actor.
+const [template] = agents.actors({ scope: "global" });
+return agents.import({ name: template.name });                       // fresh: no inherited history
+return agents.import({ name: "security-reviewer", as: "security-reviewer-2" }); // rename on collision
+
+// Promote a tuned project actor back to the global library (no history).
+return agents.export({ id: actorId, overwrite: true });
+
+// Refine a template's default instruction (the persona / system-prompt body).
+return agents.setInstructions({ id: template.id, instructions: "Be brief.", scope: "global" });
+```
+
+`agents.setInstructions` also edits a live project actor (`scope: "project"`, the default); the new instruction takes effect on the actor's next queued message. History never crosses the project⇄global boundary — import and export move only the definition. Slash commands mirror the API: `/fabric global` lists templates, `/fabric import <name> [as <new>]` stamps one into the project, and `/fabric export <id> [--overwrite]` promotes a project actor. The dashboard lists global templates alongside live actors and lets you import, export, delete, and edit instructions without writing code.
+
 ### Durable mesh coordination
 
 The `mesh` API is a project-scoped, event-sourced coordination substrate:
@@ -397,9 +425,9 @@ Supervisor and advisor are deliberately skills rather than hard-coded host servi
 Fabric also owns a general-purpose, theme-aware activity surface for any agent setup:
 
 - A compact widget above the chat (like `pi-supervisor`) follows the current phase and shows active agents, actors, tools, custom items, shared tasks, token use, and elapsed time. It disappears after ordinary runs become quiet, while persistent actors remain visible as a compact ambient row.
-- `/fabric dashboard` opens a responsive interactive overlay. Wide terminals use a Claude-workflow-style phase pane beside agents and work items; narrow terminals stack the same panels. Agent detail includes task, model, current tool, usage, result, worktree, and attach metadata. Actor mailboxes, mesh state, and recent mesh events use the same view rather than role-specific screens. In an actor's detail view, press `m` to open the model picker and change that actor's model, or press `e` to open the thinking (reasoning effort) picker and change that actor's `thinking` level (or pick Inherit to fall back to the Fabric default); both changes persist to the actor registry and take effect on the actor's next run.
+- `/fabric dashboard` opens a responsive interactive overlay. Wide terminals use a Claude-workflow-style phase pane beside agents and work items; narrow terminals stack the same panels. Agent detail includes task, model, current tool, usage, result, worktree, and attach metadata. Actor mailboxes, mesh state, and recent mesh events use the same view rather than role-specific screens. In an actor's detail view, press `m` to open the model picker and change that actor's model, or press `e` to open the thinking (reasoning effort) picker and change that actor's `thinking` level (or pick Inherit to fall back to the Fabric default); both changes persist to the actor registry and take effect on the actor's next run. Global actor templates (project-independent personas) appear in the same view; in any actor's detail, press `i` to edit its default instruction (Enter submits, Shift+Enter inserts a line), `x` to export a project actor to the global library, `p` to import a global template as a fresh project actor, and `d` to delete a global template.
 - `/fabric settings` opens an inline settings view that mirrors Pi core's `/settings` (top and bottom borders, fuzzy search, section submenus) and writes changes to `fabric.json`. Trusted projects write to `<project>/.pi/fabric.json`; untrusted sessions write to the global `~/.pi/agent/fabric.json`. Full code mode, capture, executor, approvals, and UI changes apply immediately; mesh, subagent, and MCP changes persist and take effect on the next `/fabric reload`. List editors for `subagents.defaultTools` and `capture.keepVisible` toggle known tools on and off; `keepVisible` candidates include `fabric_exec` plus every captured extension tool.
-- `↑`/`↓` or `j`/`k` select, `←`/`→` or Tab switch panes, Enter drills into details, `f` cycles status filters, `[`/`]` switches retained runs, `m` changes an actor's model and `e` its thinking level from the detail view, and Esc backs out or closes.
+- `↑`/`↓` or `j`/`k` select, `←`/`→` or Tab switch panes, Enter drills into details, `f` cycles status filters, `[`/`]` switches retained runs, `m` changes an actor's model, `e` its thinking level, `i` its default instruction, `x` exports to global, `p` imports from global, and `d` deletes a global template from the detail view, and Esc backs out or closes.
 
 The surface is data-driven. Fabric automatically instruments nested provider calls, subagents, persistent actors, and task-shaped mesh entries. A workflow can add domain-specific labels and arbitrary progress without adding extension UI code:
 

package/dist/actors/global-registry.d.ts

@@ -0,0 +1,47 @@
+import type { FabricActorRequest, GlobalActorDefinition } from "./types.js";
+/**
+ * A project-independent library of actor templates. Templates carry only an
+ * actor definition (name, instructions, subscriptions, and run settings) plus
+ * identity/timestamps — never any history. They are not live actors: importing
+ * a template into a project creates a fresh live actor with no inherited
+ * session, mailbox, or run logs.
+ *
+ * The registry lives in the user's agent dir (machine-global), independent of
+ * any project or mesh, so the same templates are available across every
+ * project. Operations are pure file I/O and do not require the mesh to be
+ * enabled; only importing (which creates a live actor via ActorManager) does.
+ * The registry is read into memory once at construction; run `/fabric reload`
+ * to pick up templates added by other Pi sessions. Writes are atomic (write
+ * to a temp file then rename) so concurrent sessions cannot corrupt the
+ * store, though truly simultaneous edits are last-write-wins.
+ */
+export declare class GlobalActorRegistry {
+    #private;
+    constructor(agentDir: string, maxInstructionsBytes: number);
+    list(): GlobalActorDefinition[];
+    resolve(idOrName: string): GlobalActorDefinition | undefined;
+    /**
+     * Save a definition to the global registry. If a template with the same name
+     * already exists, throws unless `overwrite` is true (in which case the
+     * existing template is updated in place, keeping its id). Returns the stored
+     * definition.
+     */
+    create(def: FabricActorRequest, overwrite?: boolean): GlobalActorDefinition;
+    /**
+     * Apply a partial patch to a stored template (e.g. new instructions). Only
+     * the supplied fields are replaced; the rest are preserved. Re-validates any
+     * changed field.
+     */
+    update(idOrName: string, patch: Partial<FabricActorRequest>): GlobalActorDefinition;
+    remove(idOrName: string): {
+        removed: boolean;
+    };
+    /**
+     * Strip identity/timestamps from a stored template to produce the request
+     * shape ActorManager.create expects. Optionally rename the imported actor so
+     * a template can be stamped into a project under a different name (e.g. to
+     * avoid a collision with a live actor).
+     */
+    toRequest(def: GlobalActorDefinition, as?: string): FabricActorRequest;
+}
+//# sourceMappingURL=global-registry.d.ts.map

package/dist/actors/global-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-registry.d.ts","sourceRoot":"","sources":["../../src/actors/global-registry.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAGV,kBAAkB,EAElB,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAkDpB;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,mBAAmB;;gBAKlB,QAAQ,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM;IAM1D,IAAI,IAAI,qBAAqB,EAAE;IAI/B,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS;IAK5D;;;;;OAKG;IACH,MAAM,CAAC,GAAG,EAAE,kBAAkB,EAAE,SAAS,UAAQ,GAAG,qBAAqB;IA6BzE;;;;OAIG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,qBAAqB;IAsCnF,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE;IAQ9C;;;;;OAKG;IACH,SAAS,CAAC,GAAG,EAAE,qBAAqB,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,kBAAkB;CAkJvE"}

package/dist/actors/global-registry.js

@@ -0,0 +1,308 @@
+import { randomUUID } from "node:crypto";
+import fs from "node:fs";
+import path from "node:path";
+import { isFabricThinking } from "../thinking.js";
+const ACTOR_NAME_PATTERN = /^[a-zA-Z0-9][a-zA-Z0-9 _.-]{0,59}$/;
+const TOPIC_PATTERN = /^[a-zA-Z0-9][a-zA-Z0-9._:/-]{0,127}$/;
+const HOST_EVENTS = new Set([
+    "input",
+    "turn_end",
+    "agent_settled",
+    "tool_error",
+    "session_compact",
+]);
+const DELIVERIES = new Set(["mailbox", "steer", "followUp", "nextTurn"]);
+const RESPONSE_MODES = new Set(["text", "directive"]);
+const TRANSPORTS = new Set(["auto", "process", "tmux", "screen", "localterm"]);
+const atomicWrite = (filePath, value) => {
+    fs.mkdirSync(path.dirname(filePath), { recursive: true, mode: 0o700 });
+    const temporaryPath = `${filePath}.${process.pid}.${randomUUID()}.tmp`;
+    fs.writeFileSync(temporaryPath, JSON.stringify(value, null, 2), {
+        encoding: "utf8",
+        mode: 0o600,
+    });
+    fs.renameSync(temporaryPath, filePath);
+};
+const clone = (value) => structuredClone(value);
+/**
+ * Resolve a partial id (unique prefix) or an exact name to a definition.
+ * Returns undefined when nothing matches, and throws on an ambiguous prefix.
+ */
+const resolveDefinition = (actors, idOrName) => {
+    const exact = actors.get(idOrName);
+    if (exact)
+        return exact;
+    const matches = [...actors.values()].filter((actor) => actor.id.startsWith(idOrName) || actor.name === idOrName);
+    if (matches.length === 1 && matches[0])
+        return matches[0];
+    if (matches.length > 1)
+        throw new Error(`Ambiguous global actor: ${idOrName}`);
+    return undefined;
+};
+/**
+ * A project-independent library of actor templates. Templates carry only an
+ * actor definition (name, instructions, subscriptions, and run settings) plus
+ * identity/timestamps — never any history. They are not live actors: importing
+ * a template into a project creates a fresh live actor with no inherited
+ * session, mailbox, or run logs.
+ *
+ * The registry lives in the user's agent dir (machine-global), independent of
+ * any project or mesh, so the same templates are available across every
+ * project. Operations are pure file I/O and do not require the mesh to be
+ * enabled; only importing (which creates a live actor via ActorManager) does.
+ * The registry is read into memory once at construction; run `/fabric reload`
+ * to pick up templates added by other Pi sessions. Writes are atomic (write
+ * to a temp file then rename) so concurrent sessions cannot corrupt the
+ * store, though truly simultaneous edits are last-write-wins.
+ */
+export class GlobalActorRegistry {
+    #actors = new Map();
+    #path;
+    #maxBytes;
+    constructor(agentDir, maxInstructionsBytes) {
+        this.#path = path.join(agentDir, "fabric", "actors", "global-actors.json");
+        this.#maxBytes = maxInstructionsBytes;
+        this.#load();
+    }
+    list() {
+        return [...this.#actors.values()].map(clone);
+    }
+    resolve(idOrName) {
+        const found = resolveDefinition(this.#actors, idOrName);
+        return found ? clone(found) : undefined;
+    }
+    /**
+     * Save a definition to the global registry. If a template with the same name
+     * already exists, throws unless `overwrite` is true (in which case the
+     * existing template is updated in place, keeping its id). Returns the stored
+     * definition.
+     */
+    create(def, overwrite = false) {
+        const validated = this.#validate(def);
+        const existing = [...this.#actors.values()].find((actor) => actor.name === validated.name);
+        if (existing) {
+            if (!overwrite) {
+                throw new Error(`A global actor named ${validated.name} already exists (${existing.id})`);
+            }
+            const updated = {
+                ...existing,
+                ...validated,
+                id: existing.id,
+                createdAt: existing.createdAt,
+                updatedAt: Date.now(),
+            };
+            this.#actors.set(existing.id, updated);
+            this.#save();
+            return clone(updated);
+        }
+        const created = {
+            ...validated,
+            id: randomUUID().replaceAll("-", ""),
+            createdAt: Date.now(),
+            updatedAt: Date.now(),
+        };
+        this.#actors.set(created.id, created);
+        this.#save();
+        return clone(created);
+    }
+    /**
+     * Apply a partial patch to a stored template (e.g. new instructions). Only
+     * the supplied fields are replaced; the rest are preserved. Re-validates any
+     * changed field.
+     */
+    update(idOrName, patch) {
+        const existing = resolveDefinition(this.#actors, idOrName);
+        if (!existing)
+            throw new Error(`Unknown global actor: ${idOrName}`);
+        const merged = {
+            name: patch.name ?? existing.name,
+            instructions: patch.instructions ?? existing.instructions,
+            events: patch.events ?? existing.events,
+            topics: patch.topics ?? existing.topics,
+            delivery: patch.delivery ?? existing.delivery,
+            responseMode: patch.responseMode ?? existing.responseMode,
+            triggerTurn: patch.triggerTurn ?? existing.triggerTurn,
+            coalesce: patch.coalesce ?? existing.coalesce,
+            ...(patch.model !== undefined ? { model: patch.model } : existing.model ? { model: existing.model } : {}),
+            ...(patch.thinking !== undefined ? { thinking: patch.thinking } : existing.thinking ? { thinking: existing.thinking } : {}),
+            ...(patch.tools !== undefined ? { tools: patch.tools } : existing.tools ? { tools: existing.tools } : {}),
+            ...(patch.transport !== undefined ? { transport: patch.transport } : existing.transport ? { transport: existing.transport } : {}),
+            ...(patch.timeoutMs !== undefined ? { timeoutMs: patch.timeoutMs } : existing.timeoutMs ? { timeoutMs: existing.timeoutMs } : {}),
+        };
+        const validated = this.#validate(merged);
+        if (validated.name !== existing.name) {
+            const clash = [...this.#actors.values()].find((actor) => actor.id !== existing.id && actor.name === validated.name);
+            if (clash) {
+                throw new Error(`A global actor named ${validated.name} already exists (${clash.id})`);
+            }
+        }
+        const updated = {
+            ...validated,
+            id: existing.id,
+            createdAt: existing.createdAt,
+            updatedAt: Date.now(),
+        };
+        this.#actors.set(existing.id, updated);
+        this.#save();
+        return clone(updated);
+    }
+    remove(idOrName) {
+        const existing = resolveDefinition(this.#actors, idOrName);
+        if (!existing)
+            return { removed: false };
+        this.#actors.delete(existing.id);
+        this.#save();
+        return { removed: true };
+    }
+    /**
+     * Strip identity/timestamps from a stored template to produce the request
+     * shape ActorManager.create expects. Optionally rename the imported actor so
+     * a template can be stamped into a project under a different name (e.g. to
+     * avoid a collision with a live actor).
+     */
+    toRequest(def, as) {
+        const name = as?.trim() || def.name;
+        const request = {
+            name,
+            instructions: def.instructions,
+            events: [...def.events],
+            topics: [...def.topics],
+            delivery: def.delivery,
+            responseMode: def.responseMode,
+            triggerTurn: def.triggerTurn,
+            coalesce: def.coalesce,
+            ...(def.model ? { model: def.model } : {}),
+            ...(def.thinking ? { thinking: def.thinking } : {}),
+            ...(def.tools ? { tools: [...def.tools] } : {}),
+            ...(def.transport ? { transport: def.transport } : {}),
+            ...(def.timeoutMs ? { timeoutMs: def.timeoutMs } : {}),
+        };
+        return request;
+    }
+    #validate(def) {
+        const name = def.name.trim();
+        if (!ACTOR_NAME_PATTERN.test(name))
+            throw new Error(`Invalid global actor name: ${def.name}`);
+        const instructions = def.instructions;
+        if (!instructions.trim())
+            throw new Error("Global actor instructions must not be empty");
+        if (Buffer.byteLength(instructions, "utf8") > this.#maxBytes) {
+            throw new Error(`Global actor instructions exceed ${this.#maxBytes} bytes`);
+        }
+        const events = [...new Set(def.events ?? [])];
+        for (const event of events) {
+            if (!HOST_EVENTS.has(event))
+                throw new Error(`Unsupported global actor event: ${event}`);
+        }
+        const topics = [...new Set(def.topics ?? [])];
+        for (const topic of topics) {
+            if (!TOPIC_PATTERN.test(topic))
+                throw new Error(`Invalid global actor topic: ${topic}`);
+        }
+        const delivery = def.delivery ?? "mailbox";
+        if (!DELIVERIES.has(delivery))
+            throw new Error(`Invalid global actor delivery: ${def.delivery}`);
+        const responseMode = def.responseMode ?? "text";
+        if (!RESPONSE_MODES.has(responseMode)) {
+            throw new Error(`Invalid global actor response mode: ${def.responseMode}`);
+        }
+        const triggerTurn = def.triggerTurn ?? false;
+        const coalesce = def.coalesce ?? true;
+        const model = typeof def.model === "string" && def.model.trim() ? def.model.trim() : undefined;
+        const thinking = def.thinking !== undefined && isFabricThinking(def.thinking) ? def.thinking : undefined;
+        const tools = Array.isArray(def.tools)
+            ? [...new Set(def.tools.filter((tool) => typeof tool === "string"))]
+            : undefined;
+        const transport = def.transport !== undefined && TRANSPORTS.has(def.transport) ? def.transport : undefined;
+        const timeoutMs = typeof def.timeoutMs === "number" ? def.timeoutMs : undefined;
+        return {
+            name,
+            instructions,
+            events,
+            topics,
+            delivery,
+            responseMode,
+            triggerTurn,
+            coalesce,
+            ...(model ? { model } : {}),
+            ...(thinking ? { thinking } : {}),
+            ...(tools ? { tools } : {}),
+            ...(transport ? { transport } : {}),
+            ...(timeoutMs ? { timeoutMs } : {}),
+        };
+    }
+    #load() {
+        let parsed;
+        try {
+            parsed = JSON.parse(fs.readFileSync(this.#path, "utf8"));
+        }
+        catch (error) {
+            if (error instanceof Error && "code" in error && error.code === "ENOENT")
+                return;
+            return;
+        }
+        if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed))
+            return;
+        const records = parsed.actors;
+        if (!Array.isArray(records))
+            return;
+        for (const value of records) {
+            if (typeof value !== "object" || value === null || Array.isArray(value))
+                continue;
+            const record = value;
+            if (typeof record.id !== "string" ||
+                !/^[a-f0-9]{32}$/.test(record.id) ||
+                typeof record.name !== "string" ||
+                !ACTOR_NAME_PATTERN.test(record.name) ||
+                typeof record.instructions !== "string" ||
+                Buffer.byteLength(record.instructions, "utf8") > this.#maxBytes ||
+                typeof record.createdAt !== "number") {
+                continue;
+            }
+            const events = Array.isArray(record.events)
+                ? record.events.filter((event) => HOST_EVENTS.has(event))
+                : [];
+            const topics = Array.isArray(record.topics)
+                ? record.topics.filter((topic) => typeof topic === "string" && TOPIC_PATTERN.test(topic))
+                : [];
+            const delivery = record.delivery === "steer" || record.delivery === "followUp" || record.delivery === "nextTurn"
+                ? record.delivery
+                : "mailbox";
+            const responseMode = record.responseMode === "directive" ? "directive" : "text";
+            const triggerTurn = record.triggerTurn === true;
+            const coalesce = record.coalesce !== false;
+            const thinking = isFabricThinking(record.thinking)
+                ? record.thinking
+                : undefined;
+            const tools = Array.isArray(record.tools)
+                ? record.tools.filter((tool) => typeof tool === "string")
+                : undefined;
+            const transport = record.transport !== undefined && TRANSPORTS.has(record.transport) ? record.transport : undefined;
+            const timeoutMs = typeof record.timeoutMs === "number" ? record.timeoutMs : undefined;
+            const def = {
+                id: record.id,
+                name: record.name,
+                instructions: record.instructions,
+                events,
+                topics,
+                delivery,
+                responseMode,
+                triggerTurn,
+                coalesce,
+                createdAt: record.createdAt,
+                updatedAt: typeof record.updatedAt === "number" ? record.updatedAt : record.createdAt,
+                ...(typeof record.model === "string" && record.model ? { model: record.model } : {}),
+                ...(thinking ? { thinking } : {}),
+                ...(tools ? { tools } : {}),
+                ...(transport ? { transport } : {}),
+                ...(timeoutMs ? { timeoutMs } : {}),
+            };
+            this.#actors.set(def.id, def);
+        }
+    }
+    #save() {
+        const file = { format: 1, actors: [...this.#actors.values()] };
+        atomicWrite(this.#path, file);
+    }
+}
+//# sourceMappingURL=global-registry.js.map

package/dist/actors/global-registry.js.map

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

package/dist/actors/manager.d.ts

@@ -46,12 +46,34 @@ export declare class ActorManager {
      * from the dashboard without stopping the actor.
      */
     clearMessages(id: string): Promise<FabricActorInfo>;
+    /**
+     * Replace an existing actor's default instruction (its persona / system-prompt
+     * body). Takes effect on the actor's next queued message: #runRequest builds
+     * the system prompt from actor.instructions at run start, so an in-flight run
+     * keeps the instructions it was launched with. Lets a steering user refine an
+     * actor's role from the dashboard without recreating it.
+     */
+    setInstructions(id: string, instructions: string): Promise<FabricActorInfo>;
     tell(id: string, message: string, data?: unknown): {
         queued: true;
         messageId: string;
     };
     ask(id: string, message: string, data?: unknown, signal?: AbortSignal): Promise<FabricActorMessage>;
     messages(id: string, limit?: number): FabricActorMessage[];
+    /**
+     * Read an actor's default instruction (its persona / system-prompt body).
+     * Used by the dashboard to prefill the instructions editor; deliberately not
+     * part of the mesh-presence FabricActorInfo to keep the persona text off the
+     * shared mesh state.
+     */
+    instructions(id: string): string;
+    /**
+     * Read an actor's portable definition — the fields that cross the
+     * global⇄project boundary (name, instructions, subscriptions, run settings).
+     * Excludes all history (messages, session transcript, run logs) so export
+     * can save a project actor to the global registry with a clean slate.
+     */
+    definition(id: string): FabricActorRequest;
     readLog(id: string, opts?: {
         type?: "session" | "run" | "all";
         lines?: number;
@@ -59,6 +81,14 @@ export declare class ActorManager {
     }): FabricActorLog;
     dispatchHostEvent(event: FabricActorHostEvent, payload: unknown): number;
     stop(id: string): Promise<FabricActorInfo>;
+    /**
+     * Whether the stop-the-world gate is currently armed. haltAll() arms it
+     * (ESC stop-the-world) and the "input" host event lifts it when the user
+     * resumes with a new message. Read-only view of the private gate so the
+     * ESC handler can treat a repeated lone Esc while already halted as a
+     * no-op rather than re-arming and re-notifying.
+     */
+    get halted(): boolean;
     /**
      * Interrupt every non-stopped actor: abort its in-flight run (if any) and
      * reject every queued message so subsequent execution is cancelled. Unlike

package/dist/actors/manager.d.ts.map

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

package/dist/actors/manager.js

@@ -272,6 +272,26 @@ export class ActorManager {
         await this.#publishPresence(actor);
         return this.#publicInfo(actor);
     }
+    /**
+     * Replace an existing actor's default instruction (its persona / system-prompt
+     * body). Takes effect on the actor's next queued message: #runRequest builds
+     * the system prompt from actor.instructions at run start, so an in-flight run
+     * keeps the instructions it was launched with. Lets a steering user refine an
+     * actor's role from the dashboard without recreating it.
+     */
+    async setInstructions(id, instructions) {
+        const actor = this.#requireActor(id);
+        if (!instructions.trim())
+            throw new Error("Actor instructions must not be empty");
+        if (Buffer.byteLength(instructions, "utf8") > this.meshConfig.maxEventBytes) {
+            throw new Error(`Actor instructions exceed ${this.meshConfig.maxEventBytes} bytes`);
+        }
+        actor.instructions = instructions;
+        actor.updatedAt = Date.now();
+        this.#saveActors();
+        await this.#publishPresence(actor);
+        return this.#publicInfo(actor);
+    }
     tell(id, message, data) {
         this.#validateDirectMessage(message, data);
         const actor = this.#requireActiveActor(id);
@@ -334,6 +354,39 @@ export class ActorManager {
         const bounded = Math.max(1, Math.min(Math.floor(limit), MESSAGE_HISTORY_LIMIT));
         return actor.messages.slice(-bounded).map((message) => structuredClone(message));
     }
+    /**
+     * Read an actor's default instruction (its persona / system-prompt body).
+     * Used by the dashboard to prefill the instructions editor; deliberately not
+     * part of the mesh-presence FabricActorInfo to keep the persona text off the
+     * shared mesh state.
+     */
+    instructions(id) {
+        return this.#requireActor(id).instructions;
+    }
+    /**
+     * Read an actor's portable definition — the fields that cross the
+     * global⇄project boundary (name, instructions, subscriptions, run settings).
+     * Excludes all history (messages, session transcript, run logs) so export
+     * can save a project actor to the global registry with a clean slate.
+     */
+    definition(id) {
+        const actor = this.#requireActor(id);
+        return {
+            name: actor.name,
+            instructions: actor.instructions,
+            events: [...actor.events],
+            topics: [...actor.topics],
+            delivery: actor.delivery,
+            responseMode: actor.responseMode,
+            triggerTurn: actor.triggerTurn,
+            coalesce: actor.coalesce,
+            ...(actor.model ? { model: actor.model } : {}),
+            ...(actor.thinking ? { thinking: actor.thinking } : {}),
+            ...(actor.tools ? { tools: [...actor.tools] } : {}),
+            ...(actor.transport ? { transport: actor.transport } : {}),
+            ...(actor.timeoutMs ? { timeoutMs: actor.timeoutMs } : {}),
+        };
+    }
     readLog(id, opts = {}) {
         const actor = this.#requireActor(id);
         const type = opts.type ?? "session";
@@ -410,6 +463,16 @@ export class ActorManager {
             .catch(() => undefined);
         return this.#publicInfo(actor);
     }
+    /**
+     * Whether the stop-the-world gate is currently armed. haltAll() arms it
+     * (ESC stop-the-world) and the "input" host event lifts it when the user
+     * resumes with a new message. Read-only view of the private gate so the
+     * ESC handler can treat a repeated lone Esc while already halted as a
+     * no-op rather than re-arming and re-notifying.
+     */
+    get halted() {
+        return this.#halted;
+    }
     /**
      * Interrupt every non-stopped actor: abort its in-flight run (if any) and
      * reject every queued message so subsequent execution is cancelled. Unlike