@fungi.computer/truffle 0.4.0 → 0.6.0

package/dist/internal/sandbox-metafile.json

@@ -1934,8 +1934,8 @@
       ],
       "format": "esm"
     },
-    "../../packages/forage/dist/schemas.js": {
-      "bytes": 5755,
+    "../../packages/forage/dist/normalization.js": {
+      "bytes": 3520,
       "imports": [
         {
           "path": "../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/index.js",
@@ -1945,24 +1945,29 @@
       ],
       "format": "esm"
     },
-    "../../packages/forage/dist/errors.js": {
-      "bytes": 396,
-      "imports": [],
-      "format": "esm"
-    },
-    "../../packages/forage/dist/normalization.js": {
-      "bytes": 3477,
+    "../../packages/forage/dist/schemas.js": {
+      "bytes": 5698,
       "imports": [
         {
           "path": "../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/index.js",
           "kind": "import-statement",
           "original": "zod"
+        },
+        {
+          "path": "../../packages/forage/dist/normalization.js",
+          "kind": "import-statement",
+          "original": "./normalization.js"
         }
       ],
       "format": "esm"
     },
+    "../../packages/forage/dist/errors.js": {
+      "bytes": 396,
+      "imports": [],
+      "format": "esm"
+    },
     "../../packages/forage/dist/rendering.js": {
-      "bytes": 13533,
+      "bytes": 11613,
       "imports": [
         {
           "path": "../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/index.js",
@@ -1978,17 +1983,12 @@
           "path": "../../packages/forage/dist/normalization.js",
           "kind": "import-statement",
           "original": "./normalization.js"
-        },
-        {
-          "path": "../../packages/forage/dist/schemas.js",
-          "kind": "import-statement",
-          "original": "./schemas.js"
         }
       ],
       "format": "esm"
     },
     "../../packages/forage/dist/describe.js": {
-      "bytes": 2934,
+      "bytes": 3157,
       "imports": [
         {
           "path": "../../packages/forage/dist/schemas.js",
@@ -2014,7 +2014,7 @@
       "format": "esm"
     },
     "../../packages/forage/dist/search.js": {
-      "bytes": 9616,
+      "bytes": 9656,
       "imports": [
         {
           "path": "../../packages/forage/dist/schemas.js",
@@ -2066,8 +2066,13 @@
       "format": "esm"
     },
     "../../packages/forage/dist/catalog.js": {
-      "bytes": 4793,
+      "bytes": 6091,
       "imports": [
+        {
+          "path": "../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/index.js",
+          "kind": "import-statement",
+          "original": "zod"
+        },
         {
           "path": "../../packages/forage/dist/errors.js",
           "kind": "import-statement",
@@ -2107,7 +2112,7 @@
       "format": "esm"
     },
     "../../packages/forage/dist/app-api.js": {
-      "bytes": 5198,
+      "bytes": 6114,
       "imports": [
         {
           "path": "../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/index.js",
@@ -2129,7 +2134,7 @@
       "format": "esm"
     },
     "../../packages/forage/dist/index.js": {
-      "bytes": 981,
+      "bytes": 996,
       "imports": [
         {
           "path": "../../packages/forage/dist/schemas.js",
@@ -6533,8 +6538,11 @@
         "../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/index.js": {
           "bytesInOutput": 0
         },
+        "../../packages/forage/dist/normalization.js": {
+          "bytesInOutput": 2663
+        },
         "../../packages/forage/dist/schemas.js": {
-          "bytesInOutput": 5686
+          "bytesInOutput": 5531
         },
         "../../packages/forage/dist/index.js": {
           "bytesInOutput": 127
@@ -6542,26 +6550,23 @@
         "../../packages/forage/dist/errors.js": {
           "bytesInOutput": 299
         },
-        "../../packages/forage/dist/normalization.js": {
-          "bytesInOutput": 2924
-        },
         "../../packages/forage/dist/rendering.js": {
-          "bytesInOutput": 10894
+          "bytesInOutput": 9821
         },
         "../../packages/forage/dist/describe.js": {
-          "bytesInOutput": 2413
+          "bytesInOutput": 2570
         },
         "../../packages/forage/dist/search.js": {
-          "bytesInOutput": 8128
+          "bytesInOutput": 8262
         },
         "../../packages/forage/dist/list.js": {
           "bytesInOutput": 1793
         },
         "../../packages/forage/dist/catalog.js": {
-          "bytesInOutput": 3677
+          "bytesInOutput": 4697
         },
         "../../packages/forage/dist/app-api.js": {
-          "bytesInOutput": 1649
+          "bytesInOutput": 1723
         },
         "../../packages/forage/dist/definitions.js": {
           "bytesInOutput": 1100
@@ -6720,7 +6725,7 @@
           "bytesInOutput": 4648
         }
       },
-      "bytes": 993376
+      "bytes": 993272
     }
   }
 }

package/dist/local-board-agents.d.ts

@@ -0,0 +1,46 @@
+import type { SessionAttention, SessionSummaryRow } from "@fungi.computer/shiitake/client";
+/**
+ * One Agent as the Board reads it from its store, without starting its runtime:
+ * its conversations' stored state and the open attention of those that matter.
+ */
+export type BoardAgent = Readonly<{
+    /** Stable identity of the Agent. */
+    agentId: string;
+    /** Display name; the id when the Agent has none. */
+    name: string;
+    /** Set when the Agent's store cannot be read, and why. */
+    unreadable?: string;
+    /**
+     * Whether a live runtime holds the store. A conversation stored as running
+     * in a store nobody holds was left behind by a runtime that stopped.
+     */
+    owned: boolean;
+    /** Page one of its conversations, waiting ones first, then running, then settled. */
+    sessions: readonly SessionSummaryRow[];
+    /** Open attention of the conversations `attentionWanted` names. */
+    attention: ReadonlyMap<string, readonly SessionAttention[]>;
+}>;
+/** Waiting conversations whose attention is read per Agent. */
+export declare const maximumWaitingPerAgent = 4;
+/**
+ * Which conversations' attention to load: the newest one, whose state is the
+ * Agent's lane, and the ones waiting on a person.
+ */
+export declare function attentionWanted(sessions: readonly SessionSummaryRow[]): readonly string[];
+/**
+ * Whether a live runtime holds this store. A runtime holds an exclusive
+ * transaction on the store's `.owner.sqlite` sidecar for as long as its
+ * process lives, so a reader that is refused at once has found a live owner,
+ * and one that reads the sidecar has found none. Nothing is written.
+ */
+export declare function storeIsOwned(databasePath: string): boolean;
+/**
+ * One Agent as the Board sees it, read from its store alone: no runtime starts,
+ * so reading every Agent every few seconds costs file reads, not Agents.
+ * The run state is as the Agent's runtime last wrote it. A store that cannot
+ * be read is an unavailable Agent with the reason, never an idle one. An
+ * archived Agent is not on the board.
+ */
+export declare function readBoardAgent(agentId: string, databasePath: string): Promise<BoardAgent | undefined>;
+/** Every Agent store under a project folder, as the Board reads them. */
+export declare function readBoardAgents(root: string): Promise<readonly BoardAgent[]>;

package/dist/local-board-agents.js

@@ -0,0 +1,138 @@
+import { readStoredAttention, readStoredSessionStates, } from "@fungi.computer/shiitake/effect";
+import { existsSync } from "node:fs";
+import { basename, dirname } from "node:path";
+import * as Effect from "effect/Effect";
+import { z } from "zod";
+import { logEvent } from "./log-event.js";
+import { listPrivateLocalAgentStores, LocalStoreSchemaError, readPrivateLocalAgentProfile, unreadableStoreReason, } from "./private-local-session-discovery.js";
+import { createPrivateSqliteOwner, openPrivateReadOnlySqliteDatabase, } from "./private-sqlite-owner.js";
+/** Waiting conversations whose attention is read per Agent. */
+export const maximumWaitingPerAgent = 4;
+/**
+ * Which conversations' attention to load: the newest one, whose state is the
+ * Agent's lane, and the ones waiting on a person.
+ */
+export function attentionWanted(sessions) {
+    const first = sessions[0];
+    return [
+        ...new Set([
+            ...(first === undefined ? [] : [first.sessionId]),
+            ...sessions
+                .filter((row) => row.state === "needs_you")
+                .slice(0, maximumWaitingPerAgent)
+                .map((row) => row.sessionId),
+        ]),
+    ];
+}
+/** SQLite's "database is locked" result code, from node:sqlite or bun:sqlite. */
+const sqliteBusy = 5;
+/**
+ * Whether a live runtime holds this store. A runtime holds an exclusive
+ * transaction on the store's `.owner.sqlite` sidecar for as long as its
+ * process lives, so a reader that is refused at once has found a live owner,
+ * and one that reads the sidecar has found none. Nothing is written.
+ */
+export function storeIsOwned(databasePath) {
+    const sidecar = `${databasePath}.owner.sqlite`;
+    if (!existsSync(sidecar))
+        return false;
+    let database;
+    try {
+        database = openPrivateReadOnlySqliteDatabase(sidecar, 0);
+    }
+    catch (cause) {
+        if (busy(cause))
+            return true;
+        throw cause;
+    }
+    try {
+        database.prepare("SELECT count(*) FROM sqlite_master").all();
+        return false;
+    }
+    catch (cause) {
+        if (busy(cause))
+            return true;
+        throw cause;
+    }
+    finally {
+        database.close();
+    }
+}
+/** node:sqlite names the result code `errcode`, bun:sqlite `errno`. */
+const sqliteFailure = z.looseObject({
+    errcode: z.number().optional(),
+    errno: z.number().optional(),
+});
+function busy(cause) {
+    const failure = sqliteFailure.safeParse(cause);
+    return (failure.success &&
+        (failure.data.errcode ?? failure.data.errno) === sqliteBusy);
+}
+/**
+ * One Agent as the Board sees it, read from its store alone: no runtime starts,
+ * so reading every Agent every few seconds costs file reads, not Agents.
+ * The run state is as the Agent's runtime last wrote it. A store that cannot
+ * be read is an unavailable Agent with the reason, never an idle one. An
+ * archived Agent is not on the board.
+ */
+export async function readBoardAgent(agentId, databasePath) {
+    const none = new Map();
+    let name;
+    let owned;
+    try {
+        const profile = readPrivateLocalAgentProfile(databasePath);
+        if (profile.archived)
+            return undefined;
+        name = profile.name ?? agentId;
+        owned = storeIsOwned(databasePath);
+    }
+    catch (cause) {
+        if (cause instanceof LocalStoreSchemaError)
+            return {
+                agentId,
+                name: agentId,
+                sessions: [],
+                attention: none,
+                owned: false,
+                unreadable: unreadableStoreReason(agentId),
+            };
+        logEvent("board-agent-profile", cause);
+        return {
+            agentId,
+            name: agentId,
+            sessions: [],
+            attention: none,
+            owned: false,
+            unreadable: "its store could not be read",
+        };
+    }
+    const database = openPrivateReadOnlySqliteDatabase(databasePath);
+    try {
+        const owner = createPrivateSqliteOwner(database);
+        const sessions = (await Effect.runPromise(readStoredSessionStates(owner))).sessions;
+        const attention = new Map();
+        for (const sessionId of attentionWanted(sessions))
+            attention.set(sessionId, await Effect.runPromise(readStoredAttention(owner, sessionId)));
+        return { agentId, name, owned, sessions, attention };
+    }
+    catch (cause) {
+        logEvent("board-agent-store", cause);
+        return {
+            agentId,
+            name,
+            owned,
+            sessions: [],
+            attention: none,
+            unreadable: "its conversations could not be read",
+        };
+    }
+    finally {
+        database.close();
+    }
+}
+/** Every Agent store under a project folder, as the Board reads them. */
+export async function readBoardAgents(root) {
+    const stores = await listPrivateLocalAgentStores(root, "all");
+    const agents = await Promise.all(stores.map((path) => readBoardAgent(basename(dirname(path)), path)));
+    return agents.flatMap((agent) => (agent === undefined ? [] : [agent]));
+}

package/dist/local-board-shipping.d.ts

@@ -0,0 +1,129 @@
+import * as Result from "effect/Result";
+import * as Schema from "effect/Schema";
+/** What happened to a piece of work: it landed, shipped out, or is on its way. */
+export declare const ShipKind: Schema.Literals<readonly ["landed", "released", "queued", "gating", "dropped"]>;
+/** Display kind of one shipped item. */
+export type ShipKind = typeof ShipKind.Type;
+/** One thing a shipping source saw since local midnight. */
+export declare const ShipItem: Schema.Struct<{
+    /** Stable within its source. */
+    readonly id: Schema.String;
+    /** What happened to it. */
+    readonly kind: Schema.Literals<readonly ["landed", "released", "queued", "gating", "dropped"]>;
+    /** A one-line title, such as a commit subject or a released version. */
+    readonly title: Schema.String;
+    /** The branch, tag or package it belongs to. */
+    readonly ref: Schema.optionalKey<Schema.String>;
+    /** When it happened. */
+    readonly at: Schema.Int;
+    /** A short note the source adds. */
+    readonly detail: Schema.optionalKey<Schema.String>;
+}>;
+/** Decoded shipped item. */
+export type ShipItem = typeof ShipItem.Type;
+/** What one read of a shipping source found; a throw is a failed source instead. */
+export type ShippingRead = Readonly<{
+    /** `held` is paused on purpose, `stopped` is not running; neither is an error. */
+    state: "ok" | "held" | "stopped";
+    /** Why it is held or stopped, in a few words. */
+    detail?: string;
+    /** What the source saw since `sinceMs`, newest first. */
+    items: readonly ShipItem[];
+}>;
+/**
+ * Something that ships work: a branch, a package registry, a merge train. The
+ * Board reads it on its own cadence and never trusts it to say "none" when it
+ * could not look.
+ */
+export type ShippingSource = Readonly<{
+    /** Stable identity of the source. */
+    id: string;
+    /** What the person calls the source. */
+    label: string;
+    /** How often the source is read again. */
+    refreshMs: number;
+    /** Read what shipped at or after `sinceMs` (local midnight); throw when it cannot be read. */
+    read: (sinceMs: number, signal: AbortSignal) => Promise<ShippingRead>;
+}>;
+/** The sources the Board reads, resolved afresh each cycle so settings edits apply. */
+export type ShippingSources = (signal: AbortSignal) => Promise<readonly ShippingSource[]>;
+/** The most shipping sources one board reads. */
+export declare const maximumShippingSources = 6;
+/** One configured shipping source; an unknown kind or key is refused. */
+export declare const ShippingSourceConfig: Schema.Union<readonly [Schema.Struct<{
+    /** Reads a Git history. */
+    readonly kind: Schema.Literal<"git">;
+    /** The branch, tag or `HEAD` whose first-parent history is read. */
+    readonly ref: Schema.String;
+    /** Whether those commits landed work or released it. */
+    readonly shows: Schema.Literals<readonly ["landed", "released"]>;
+}>, Schema.Struct<{
+    /** Reads a package registry. */
+    readonly kind: Schema.Literal<"npm">;
+    /** Package names, as `npm view` takes them. */
+    readonly packages: Schema.$Array<Schema.String>;
+}>]>;
+/** Decoded configured shipping source. */
+export type ShippingSourceConfig = typeof ShippingSourceConfig.Type;
+/** The `board` key of a `.fungi/settings.json`; excess keys are refused. */
+export declare const BoardSettings: Schema.Struct<{
+    /** The sources the Board reads for what shipped today. */
+    readonly shipping: Schema.optionalKey<Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+        /** Reads a Git history. */
+        readonly kind: Schema.Literal<"git">;
+        /** The branch, tag or `HEAD` whose first-parent history is read. */
+        readonly ref: Schema.String;
+        /** Whether those commits landed work or released it. */
+        readonly shows: Schema.Literals<readonly ["landed", "released"]>;
+    }>, Schema.Struct<{
+        /** Reads a package registry. */
+        readonly kind: Schema.Literal<"npm">;
+        /** Package names, as `npm view` takes them. */
+        readonly packages: Schema.$Array<Schema.String>;
+    }>]>>>;
+}>;
+/** The sources a settings `board` value names, or each refusal with its settings path. */
+export declare function decodeBoardSettings(board: unknown): Result.Result<readonly ShippingSourceConfig[], readonly string[]>;
+/** Run a program with these arguments and return what it wrote to stdout. */
+export type ShippingExec = (file: string, args: readonly string[], options: Readonly<{
+    cwd: string;
+    signal: AbortSignal;
+}>) => Promise<string>;
+/**
+ * The tool's ordinary interface: its own argv, no shell, a bounded environment.
+ * A program that is missing or refuses is an error with a short reason.
+ */
+export declare const execShipping: ShippingExec;
+/**
+ * Commits first-parent on `ref` since local midnight, from `git log`. A merge
+ * shows the subject of the tip it merged, and any other commit its own, so a
+ * merge queue's "Merge branch ..." lines read as the work that landed.
+ */
+export declare function gitSource(config: Extract<ShippingSourceConfig, {
+    kind: "git";
+}>, options: Readonly<{
+    cwd: string;
+    exec: ShippingExec;
+    label?: string;
+}>): ShippingSource;
+/** Versions of each package published since local midnight, from `npm view <package> time --json`. */
+export declare function npmSource(config: Extract<ShippingSourceConfig, {
+    kind: "npm";
+}>, options: Readonly<{
+    cwd: string;
+    exec: ShippingExec;
+}>): ShippingSource;
+/**
+ * The Board's shipping sources for this folder: `board.shipping` in the
+ * folder's `.fungi/settings.json`, then the person's, read afresh each cycle so
+ * an edit applies. A refused file is one failed source line naming its
+ * path, never a silent default. With nothing configured, a Git work tree
+ * shows its current branch as landed work, and a folder that is not one shows
+ * no shipping at all.
+ */
+export declare function createLocalShippingSources(options: Readonly<{
+    cwd: string;
+    home: string;
+    exec?: ShippingExec;
+    now?: () => number;
+}>): ShippingSources;