@swarmify/agents-cli 1.12.0 → 1.13.1

package/dist/lib/ledger/r2.js

@@ -0,0 +1,335 @@
+/**
+ * R2 (S3-compatible) Ledger implementation.
+ *
+ * Layout mirrors LocalDiskLedger — objects are keyed as:
+ *   teams/<team_id>/registry.json
+ *   teams/<team_id>/team.md
+ *   teams/<team_id>/sessions/<task_id>-<teammate>.jsonl
+ *   teams/<team_id>/artifacts/<task_id>/<filename>
+ *   teams/<team_id>/bugs/<task_id>.md
+ *
+ * Credentials come from the AGENTS_R2_* env vars (or `agents.yaml.ledger`
+ * when we add that later). Two patterns are supported:
+ *
+ *   1. Cloudflare R2:  set endpoint to https://<account>.r2.cloudflarestorage.com
+ *                       and AGENTS_R2_ACCESS_KEY_ID / AGENTS_R2_SECRET_ACCESS_KEY.
+ *   2. Plain S3:       omit endpoint; region picks up from AGENTS_R2_REGION.
+ *
+ * The ledger degrades gracefully: `resolveLedger()` only returns an R2Ledger
+ * when credentials + bucket are present. Otherwise it falls back to
+ * LocalDiskLedger so non-cloud workflows never touch the network.
+ */
+import { S3Client, GetObjectCommand, PutObjectCommand, ListObjectsV2Command, } from '@aws-sdk/client-s3';
+function artifactFilename(kind) {
+    switch (kind) {
+        case 'diff': return 'diff.patch';
+        case 'test-output': return 'test-output.txt';
+        case 'notes': return 'notes.md';
+        default: return `${String(kind)}.txt`;
+    }
+}
+function kindFromFilename(filename) {
+    if (filename === 'diff.patch')
+        return 'diff';
+    if (filename === 'test-output.txt')
+        return 'test-output';
+    if (filename === 'notes.md')
+        return 'notes';
+    const dot = filename.lastIndexOf('.');
+    return dot > 0 ? filename.slice(0, dot) : filename;
+}
+/**
+ * Read R2 config from environment. Returns null when required fields are
+ * missing so `resolveLedger()` can fall back to local disk without crashing.
+ *
+ * Required: AGENTS_R2_BUCKET. Optional: endpoint, region, access key pair.
+ */
+export function r2ConfigFromEnv() {
+    const bucket = process.env.AGENTS_R2_BUCKET?.trim();
+    if (!bucket)
+        return null;
+    return {
+        bucket,
+        endpoint: process.env.AGENTS_R2_ENDPOINT?.trim() || undefined,
+        region: process.env.AGENTS_R2_REGION?.trim() || 'auto',
+        accessKeyId: process.env.AGENTS_R2_ACCESS_KEY_ID?.trim() || undefined,
+        secretAccessKey: process.env.AGENTS_R2_SECRET_ACCESS_KEY?.trim() || undefined,
+        prefix: process.env.AGENTS_R2_PREFIX?.trim() || '',
+    };
+}
+export class R2Ledger {
+    kind = 'r2';
+    client;
+    bucket;
+    prefix;
+    constructor(config) {
+        this.bucket = config.bucket;
+        this.prefix = (config.prefix ?? '').replace(/^\/+|\/+$/g, '');
+        const clientConfig = {
+            region: config.region ?? 'auto',
+            forcePathStyle: true, // R2 and most S3-compatible stores need this
+        };
+        if (config.endpoint)
+            clientConfig.endpoint = config.endpoint;
+        if (config.accessKeyId && config.secretAccessKey) {
+            clientConfig.credentials = {
+                accessKeyId: config.accessKeyId,
+                secretAccessKey: config.secretAccessKey,
+            };
+        }
+        this.client = new S3Client(clientConfig);
+    }
+    key(...parts) {
+        const joined = parts.filter(Boolean).join('/').replace(/\/+/g, '/');
+        return this.prefix ? `${this.prefix}/${joined}` : joined;
+    }
+    teamKey(team_id, ...rest) {
+        return this.key('teams', team_id, ...rest);
+    }
+    async putText(key, content) {
+        await this.client.send(new PutObjectCommand({
+            Bucket: this.bucket,
+            Key: key,
+            Body: content,
+            ContentType: 'text/plain; charset=utf-8',
+        }));
+    }
+    async getText(key) {
+        try {
+            const r = await this.client.send(new GetObjectCommand({ Bucket: this.bucket, Key: key }));
+            const content = await r.Body?.transformToString('utf-8') ?? '';
+            const lastModified = r.LastModified?.toISOString() ?? new Date().toISOString();
+            return { content, lastModified };
+        }
+        catch (err) {
+            if (err?.$metadata?.httpStatusCode === 404 || err?.name === 'NoSuchKey')
+                return null;
+            throw err;
+        }
+    }
+    async listKeys(prefix) {
+        const out = [];
+        let continuationToken;
+        do {
+            const r = await this.client.send(new ListObjectsV2Command({
+                Bucket: this.bucket,
+                Prefix: prefix,
+                ContinuationToken: continuationToken,
+            }));
+            for (const obj of r.Contents ?? []) {
+                if (obj.Key) {
+                    out.push({
+                        key: obj.Key,
+                        lastModified: obj.LastModified?.toISOString() ?? new Date().toISOString(),
+                    });
+                }
+            }
+            continuationToken = r.IsTruncated ? r.NextContinuationToken : undefined;
+        } while (continuationToken);
+        return out;
+    }
+    async appendText(key, chunk) {
+        // S3 has no native append; read-modify-write is the canonical workaround
+        // and fine for small artifacts like notes.md and session jsonl lines.
+        const existing = (await this.getText(key))?.content ?? '';
+        await this.putText(key, existing + chunk);
+    }
+    async putArtifact(team_id, task_id, kind, content, _teammate) {
+        if (kind === 'bug') {
+            await this.putText(this.teamKey(team_id, 'bugs', `${task_id}.md`), content);
+            return;
+        }
+        await this.putText(this.teamKey(team_id, 'artifacts', task_id, artifactFilename(kind)), content);
+    }
+    async appendSession(team_id, task_id, teammate, line) {
+        const safe = teammate.replace(/[/\\]/g, '_');
+        const key = this.teamKey(team_id, 'sessions', `${task_id}-${safe}.jsonl`);
+        await this.appendText(key, line.endsWith('\n') ? line : line + '\n');
+    }
+    async putRegistry(registry) {
+        await this.putText(this.teamKey(registry.team_id, 'registry.json'), JSON.stringify(registry, null, 2));
+    }
+    async getRegistry(team_id) {
+        const got = await this.getText(this.teamKey(team_id, 'registry.json'));
+        if (!got)
+            return null;
+        try {
+            return JSON.parse(got.content);
+        }
+        catch {
+            return null;
+        }
+    }
+    async appendNarrative(team_id, text) {
+        await this.appendText(this.teamKey(team_id, 'team.md'), text.endsWith('\n') ? text : text + '\n');
+    }
+    async getNarrative(team_id) {
+        const got = await this.getText(this.teamKey(team_id, 'team.md'));
+        return got?.content ?? null;
+    }
+    async note(team_id, task_id, teammate, text) {
+        const key = this.teamKey(team_id, 'artifacts', task_id, 'notes.md');
+        const ts = new Date().toISOString();
+        const entry = `\n### ${ts} — ${teammate}\n\n${text.endsWith('\n') ? text : text + '\n'}`;
+        await this.appendText(key, entry);
+    }
+    async read(team_id, task_id, kind) {
+        const artifacts = [];
+        if (kind && kind !== 'session' && kind !== 'bug') {
+            const key = this.teamKey(team_id, 'artifacts', task_id, artifactFilename(kind));
+            const got = await this.getText(key);
+            if (got) {
+                artifacts.push({
+                    team_id, task_id, kind, content: got.content,
+                    created_at: got.lastModified, updated_at: got.lastModified,
+                });
+            }
+        }
+        else if (kind === 'bug') {
+            const key = this.teamKey(team_id, 'bugs', `${task_id}.md`);
+            const got = await this.getText(key);
+            if (got) {
+                artifacts.push({
+                    team_id, task_id, kind: 'bug', content: got.content,
+                    created_at: got.lastModified, updated_at: got.lastModified,
+                });
+            }
+        }
+        else if (kind === 'session') {
+            const prefix = this.teamKey(team_id, 'sessions') + '/';
+            for (const { key, lastModified } of await this.listKeys(prefix)) {
+                const name = key.slice(prefix.length);
+                if (!name.startsWith(`${task_id}-`) || !name.endsWith('.jsonl'))
+                    continue;
+                const got = await this.getText(key);
+                const teammate = name.slice(task_id.length + 1, -'.jsonl'.length);
+                artifacts.push({
+                    team_id, task_id, teammate, kind: 'session',
+                    content: got?.content ?? '',
+                    created_at: lastModified, updated_at: lastModified,
+                });
+            }
+        }
+        else {
+            // No kind — gather everything for the task.
+            const artPrefix = this.teamKey(team_id, 'artifacts', task_id) + '/';
+            for (const { key, lastModified } of await this.listKeys(artPrefix)) {
+                const name = key.slice(artPrefix.length);
+                const got = await this.getText(key);
+                artifacts.push({
+                    team_id, task_id, kind: kindFromFilename(name),
+                    content: got?.content ?? '',
+                    created_at: lastModified, updated_at: lastModified,
+                });
+            }
+            const sessionPrefix = this.teamKey(team_id, 'sessions') + '/';
+            for (const { key, lastModified } of await this.listKeys(sessionPrefix)) {
+                const name = key.slice(sessionPrefix.length);
+                if (!name.startsWith(`${task_id}-`) || !name.endsWith('.jsonl'))
+                    continue;
+                const got = await this.getText(key);
+                const teammate = name.slice(task_id.length + 1, -'.jsonl'.length);
+                artifacts.push({
+                    team_id, task_id, teammate, kind: 'session',
+                    content: got?.content ?? '',
+                    created_at: lastModified, updated_at: lastModified,
+                });
+            }
+            const bugKey = this.teamKey(team_id, 'bugs', `${task_id}.md`);
+            const bug = await this.getText(bugKey);
+            if (bug) {
+                artifacts.push({
+                    team_id, task_id, kind: 'bug', content: bug.content,
+                    created_at: bug.lastModified, updated_at: bug.lastModified,
+                });
+            }
+        }
+        const reg = await this.getRegistry(team_id);
+        const entry = reg?.teammates.find((t) => t.agent_id === task_id);
+        return {
+            team_id, task_id,
+            teammate: entry?.name ?? null,
+            task_type: entry?.task_type ?? null,
+            status: entry?.status ?? null,
+            artifacts,
+            completed_at: entry?.completed_at ?? null,
+        };
+    }
+    async recent(team_id, n = 5) {
+        const reg = await this.getRegistry(team_id);
+        if (!reg)
+            return [];
+        const done = reg.teammates
+            .filter((t) => t.status === 'completed' || t.status === 'failed')
+            .sort((a, b) => {
+            const at = a.completed_at ?? a.started_at;
+            const bt = b.completed_at ?? b.started_at;
+            return new Date(bt).getTime() - new Date(at).getTime();
+        })
+            .slice(0, n);
+        const views = [];
+        for (const t of done)
+            views.push(await this.read(team_id, t.agent_id));
+        return views;
+    }
+    async search(team_id, query, limit = 50) {
+        const hits = [];
+        const needle = query.toLowerCase();
+        const teamPrefix = this.teamKey(team_id) + '/';
+        for (const { key } of await this.listKeys(teamPrefix)) {
+            if (hits.length >= limit)
+                break;
+            const got = await this.getText(key);
+            if (!got)
+                continue;
+            const lines = got.content.split('\n');
+            for (let i = 0; i < lines.length; i++) {
+                if (hits.length >= limit)
+                    break;
+                if (!lines[i].toLowerCase().includes(needle))
+                    continue;
+                // Infer metadata from the key shape.
+                const rel = key.slice(teamPrefix.length);
+                let kind = 'narrative';
+                let task_id = '_team';
+                let teammate = null;
+                if (rel.startsWith('sessions/') && rel.endsWith('.jsonl')) {
+                    kind = 'session';
+                    const name = rel.slice('sessions/'.length, -'.jsonl'.length);
+                    const dash = name.lastIndexOf('-');
+                    if (dash > 0) {
+                        task_id = name.slice(0, dash);
+                        teammate = name.slice(dash + 1);
+                    }
+                    else {
+                        task_id = name;
+                    }
+                }
+                else if (rel.startsWith('artifacts/')) {
+                    const parts = rel.split('/');
+                    task_id = parts[1] ?? '_';
+                    kind = kindFromFilename(parts[2] ?? '');
+                }
+                else if (rel.startsWith('bugs/') && rel.endsWith('.md')) {
+                    kind = 'bug';
+                    task_id = rel.slice('bugs/'.length, -'.md'.length);
+                }
+                else if (rel === 'team.md') {
+                    kind = 'narrative';
+                    task_id = '_team';
+                }
+                else if (rel === 'registry.json') {
+                    continue; // skip registry — not meaningful for text search
+                }
+                hits.push({
+                    team_id, task_id, teammate, kind,
+                    line_number: i + 1,
+                    line: lines[i].slice(0, 500),
+                    path: key,
+                });
+            }
+        }
+        return hits.slice(0, limit);
+    }
+}
+//# sourceMappingURL=r2.js.map

package/dist/lib/ledger/r2.js.map

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

package/dist/lib/ledger/sync.d.ts

@@ -0,0 +1,33 @@
+import type { LedgerStore } from './types.js';
+export interface TeammateSnapshot {
+    agent_id: string;
+    team_id: string;
+    teammate_name: string | null;
+    agent_type: string;
+    task_type: string | null;
+    status: string;
+    started_at: string;
+    completed_at: string | null;
+    after: string[];
+    cloud_provider: string | null;
+    cloud_session_id: string | null;
+    cloud_repo: string | null;
+    cloud_branch: string | null;
+    /** Absolute path to the teammate's on-disk agent dir (stdout.log + meta.json). */
+    agent_dir: string;
+    /** Working dir the agent ran in — used to collect a git diff. */
+    cwd: string | null;
+}
+/**
+ * Push a teammate's outputs to the ledger: session transcript, git diff (if
+ * any), and a registry update. Test output is written separately via
+ * `putArtifact(..., 'test-output', ...)` by the caller that runs the tests.
+ */
+export declare function syncTeammate(snap: TeammateSnapshot, ledger?: LedgerStore): Promise<void>;
+/**
+ * Called from a pod's preStop hook right before SIGTERM. Same as syncTeammate
+ * but tolerates a still-running status. The remote orchestrator will re-sync
+ * once the workload finishes in its replacement.
+ */
+export declare function syncOnEviction(snap: TeammateSnapshot, ledger?: LedgerStore): Promise<void>;
+//# sourceMappingURL=sync.d.ts.map

package/dist/lib/ledger/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../../src/lib/ledger/sync.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,WAAW,EAAkB,MAAM,YAAY,CAAC;AAE9D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,kFAAkF;IAClF,SAAS,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,gBAAgB,EACtB,MAAM,GAAE,WAA6B,GACpC,OAAO,CAAC,IAAI,CAAC,CAsDf;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,gBAAgB,EACtB,MAAM,GAAE,WAA6B,GACpC,OAAO,CAAC,IAAI,CAAC,CAcf"}

package/dist/lib/ledger/sync.js

@@ -0,0 +1,106 @@
+/**
+ * Sync hooks between teammate process state (on disk at ~/.agents/teams/) and
+ * the team Ledger (LocalDiskLedger by default, R2Ledger in cloud pods).
+ *
+ * Callers:
+ * - `teams add/start` on teammate completion → syncTeammate()
+ * - `agents factory evict` (runs in a pod's preStop hook) → syncOnEviction()
+ *
+ * The sync is deliberately idempotent: safe to run multiple times, safe to
+ * run mid-flight (captures whatever's there now). The ledger layout mirrors
+ * the on-disk layout so the same data is queryable via MCP tools from any
+ * other teammate.
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { execSync } from 'child_process';
+import { resolveLedger } from './index.js';
+/**
+ * Push a teammate's outputs to the ledger: session transcript, git diff (if
+ * any), and a registry update. Test output is written separately via
+ * `putArtifact(..., 'test-output', ...)` by the caller that runs the tests.
+ */
+export async function syncTeammate(snap, ledger = resolveLedger()) {
+    const teammate = snap.teammate_name ?? snap.agent_id.slice(0, 8);
+    // 1. Session transcript (replace whole file each sync — simple and correct).
+    const stdoutPath = path.join(snap.agent_dir, 'stdout.log');
+    const raw = await readSafe(stdoutPath);
+    if (raw !== null && raw.length > 0) {
+        // Use putArtifact with a custom kind so R2 doesn't need append semantics.
+        // For a local ledger this still round-trips cleanly — read() picks it up
+        // under artifacts/<task_id>/session.txt.
+        await ledger.putArtifact(snap.team_id, snap.agent_id, 'session-log', raw, teammate);
+    }
+    // 2. Git diff in the teammate's cwd, if it's a git repo. Best-effort — a
+    // missing git binary or a non-repo cwd should not fail the whole sync.
+    if (snap.cwd) {
+        const diff = safeGitDiff(snap.cwd);
+        if (diff) {
+            await ledger.putArtifact(snap.team_id, snap.agent_id, 'diff', diff, teammate);
+        }
+    }
+    // 3. Registry upsert — merge this teammate into whatever's already there.
+    const existing = await ledger.getRegistry(snap.team_id);
+    const entry = {
+        agent_id: snap.agent_id,
+        name: snap.teammate_name,
+        agent_type: snap.agent_type,
+        task_type: snap.task_type,
+        dispatch: snap.cloud_provider
+            ? { cloud: snap.cloud_provider, repo: snap.cloud_repo ?? undefined, branch: snap.cloud_branch ?? undefined }
+            : 'local',
+        after: snap.after,
+        status: snap.status,
+        started_at: snap.started_at,
+        completed_at: snap.completed_at,
+    };
+    const next = existing
+        ? {
+            team_id: snap.team_id,
+            updated_at: new Date().toISOString(),
+            teammates: [
+                ...existing.teammates.filter((t) => t.agent_id !== snap.agent_id),
+                entry,
+            ],
+        }
+        : {
+            team_id: snap.team_id,
+            updated_at: new Date().toISOString(),
+            teammates: [entry],
+        };
+    await ledger.putRegistry(next);
+}
+/**
+ * Called from a pod's preStop hook right before SIGTERM. Same as syncTeammate
+ * but tolerates a still-running status. The remote orchestrator will re-sync
+ * once the workload finishes in its replacement.
+ */
+export async function syncOnEviction(snap, ledger = resolveLedger()) {
+    await syncTeammate({ ...snap, status: snap.status === 'running' ? 'evicted' : snap.status }, ledger);
+    const note = `Pod evicted at ${new Date().toISOString()} — status=${snap.status}, ` +
+        `cloud=${snap.cloud_provider ?? 'local'} session=${snap.cloud_session_id ?? '-'}`;
+    await ledger.note(snap.team_id, snap.agent_id, snap.teammate_name ?? snap.agent_id.slice(0, 8), note);
+}
+async function readSafe(p) {
+    try {
+        return await fs.readFile(p, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+}
+function safeGitDiff(cwd) {
+    try {
+        const diff = execSync('git diff --no-color HEAD', {
+            cwd,
+            encoding: 'utf-8',
+            maxBuffer: 16 * 1024 * 1024,
+            stdio: ['ignore', 'pipe', 'ignore'],
+        });
+        return diff.length > 0 ? diff : null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=sync.js.map

package/dist/lib/ledger/sync.js.map

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

package/dist/lib/ledger/types.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Team Ledger — shared substrate for cross-agent memory.
+ *
+ * The Ledger is a team-scoped, blob-per-task store that survives pod eviction
+ * and lets teammates read each other's outputs by task_id. It is NOT a semantic
+ * knowledge graph — just files grouped by team_id + task_id, with simple
+ * read/recent/search/note operations.
+ *
+ * Layout:
+ *   <root>/teams/<team_id>/
+ *     registry.json                       teammate list + DAG snapshot
+ *     team.md                             planner's running narrative
+ *     sessions/<task_id>-<teammate>.jsonl full agent event stream
+ *     artifacts/<task_id>/
+ *       diff.patch                        git diff of the task
+ *       test-output.txt                   test runner output (if any)
+ *       notes.md                          teammate's own notes (append-only)
+ *     bugs/<task_id>.md                   reviewer-filed bugs
+ */
+/** Canonical artifact kinds we know how to serialize. Free-form `kind` still works. */
+export type ArtifactKind = 'diff' | 'test-output' | 'notes' | 'session' | 'bug' | 'registry' | 'narrative' | string;
+/** A single artifact stored in the ledger. */
+export interface LedgerArtifact {
+    team_id: string;
+    task_id: string;
+    teammate?: string;
+    kind: ArtifactKind;
+    content: string;
+    created_at: string;
+    updated_at: string;
+}
+/** A single task's rolled-up view: all artifacts under one task_id. */
+export interface LedgerTaskView {
+    team_id: string;
+    task_id: string;
+    teammate: string | null;
+    task_type: string | null;
+    status: string | null;
+    artifacts: LedgerArtifact[];
+    completed_at: string | null;
+}
+/** Search hit — includes artifact + line number for context. */
+export interface LedgerSearchHit {
+    team_id: string;
+    task_id: string;
+    teammate: string | null;
+    kind: ArtifactKind;
+    line_number: number;
+    line: string;
+    path: string;
+}
+/** Registry snapshot — mirrors the teammate DAG state for a team. */
+export interface LedgerRegistry {
+    team_id: string;
+    updated_at: string;
+    teammates: Array<{
+        agent_id: string;
+        name: string | null;
+        agent_type: string;
+        task_type: string | null;
+        dispatch: 'local' | {
+            cloud: string;
+            repo?: string;
+            branch?: string;
+        };
+        after: string[];
+        status: string;
+        started_at: string;
+        completed_at: string | null;
+    }>;
+}
+/**
+ * Contract every ledger backend implements.
+ *
+ * Local-disk is the default; R2 is the durable remote. Both implement the
+ * same interface so cloud-evicted pods and local pods share a substrate.
+ */
+export interface LedgerStore {
+    /** Backend identifier, for debug output. */
+    readonly kind: 'local' | 'r2';
+    /** Read a single artifact kind for a task, or all kinds if `kind` omitted. */
+    read(team_id: string, task_id: string, kind?: ArtifactKind): Promise<LedgerTaskView>;
+    /** Last N completed tasks across the team, newest first. */
+    recent(team_id: string, n?: number): Promise<LedgerTaskView[]>;
+    /** Case-insensitive substring search across sessions + notes + bugs + team.md. */
+    search(team_id: string, query: string, limit?: number): Promise<LedgerSearchHit[]>;
+    /** Append text to <task_id>'s notes.md (creates if missing). */
+    note(team_id: string, task_id: string, teammate: string, text: string): Promise<void>;
+    /** Write an artifact. Overwrites if (task_id, kind) already exists. */
+    putArtifact(team_id: string, task_id: string, kind: ArtifactKind, content: string, teammate?: string): Promise<void>;
+    /** Append one line (JSON or text) to sessions/<task_id>-<teammate>.jsonl. */
+    appendSession(team_id: string, task_id: string, teammate: string, line: string): Promise<void>;
+    /** Snapshot or update the team registry. */
+    putRegistry(registry: LedgerRegistry): Promise<void>;
+    getRegistry(team_id: string): Promise<LedgerRegistry | null>;
+    /** Append a sentence to team.md (the planner's running narrative). */
+    appendNarrative(team_id: string, text: string): Promise<void>;
+    getNarrative(team_id: string): Promise<string | null>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/ledger/types.d.ts.map

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

package/dist/lib/ledger/types.js

@@ -0,0 +1,21 @@
+/**
+ * Team Ledger — shared substrate for cross-agent memory.
+ *
+ * The Ledger is a team-scoped, blob-per-task store that survives pod eviction
+ * and lets teammates read each other's outputs by task_id. It is NOT a semantic
+ * knowledge graph — just files grouped by team_id + task_id, with simple
+ * read/recent/search/note operations.
+ *
+ * Layout:
+ *   <root>/teams/<team_id>/
+ *     registry.json                       teammate list + DAG snapshot
+ *     team.md                             planner's running narrative
+ *     sessions/<task_id>-<teammate>.jsonl full agent event stream
+ *     artifacts/<task_id>/
+ *       diff.patch                        git diff of the task
+ *       test-output.txt                   test runner output (if any)
+ *       notes.md                          teammate's own notes (append-only)
+ *     bugs/<task_id>.md                   reviewer-filed bugs
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/lib/ledger/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/lib/ledger/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG"}

package/dist/lib/manifest.d.ts

@@ -1,8 +1,14 @@
 import type { Manifest } from './types.js';
+/** Canonical filename for the manifest in any agents repo or project root. */
 export declare const MANIFEST_FILENAME = "agents.yaml";
+/** Parse a YAML string into a typed Manifest object. */
 export declare function parseManifest(content: string): Manifest;
+/** Serialize a Manifest object to a YAML string with 2-space indentation. */
 export declare function serializeManifest(manifest: Manifest): string;
+/** Read and parse agents.yaml from a directory. Returns null if the file does not exist. */
 export declare function readManifest(repoPath: string): Manifest | null;
+/** Write a Manifest object to agents.yaml in the given directory. */
 export declare function writeManifest(repoPath: string, manifest: Manifest): void;
+/** Create a Manifest with sensible defaults for a fresh agents repo. */
 export declare function createDefaultManifest(): Manifest;
 //# sourceMappingURL=manifest.d.ts.map