harnery 0.0.1 → 0.2.1

package/dist/lib/cookies/client.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Shared cookie-store library.
+ *
+ * Design:
+ *   - CDP-native cookie format (matches Playwright/agent-browser output).
+ *   - Caller chooses the store path on construction; the harn defaults are
+ *     `~/.cache/harnery/cookies.json`. Consumers can point at any path.
+ *   - Pure synchronous I/O; the store is small (<1MB typical) so async
+ *     buys nothing and complicates the merge-on-write path.
+ */
+/** CDP-native cookie. `expires === -1` means session cookie / no expiry. */
+export interface Cookie {
+    name: string;
+    value: string;
+    domain: string;
+    path: string;
+    expires: number;
+    size?: number;
+    httpOnly: boolean;
+    secure: boolean;
+    session?: boolean;
+    sameSite?: string;
+}
+export interface OriginEntry {
+    origin: string;
+    localStorage: {
+        name: string;
+        value: string;
+    }[];
+}
+export interface CookieStore {
+    cookies: Cookie[];
+    origins: OriginEntry[];
+    exportedAt?: string;
+    exportedFrom?: string;
+}
+export interface CookieJarOptions {
+    /** Absolute path to the JSON store. Caller must provide. */
+    path: string;
+    /** `exportedFrom` tag stamped on every save. Defaults to `"bp-cookies"`. */
+    source?: string;
+}
+export interface InfoResult {
+    path: string;
+    exists: boolean;
+    bytes: number;
+    active: number;
+    expired: number;
+    total: number;
+    domains: string[];
+    origins: number;
+    exportedAt?: string;
+    exportedFrom?: string;
+}
+export declare class CookieJar {
+    readonly path: string;
+    private readonly source;
+    constructor(opts: CookieJarOptions);
+    exists(): boolean;
+    load(): CookieStore;
+    /**
+     * Persist a store, stamping `exportedAt` (now) and `exportedFrom`
+     * (constructor-provided source). Creates the parent directory if needed.
+     */
+    save(store: CookieStore): void;
+    /**
+     * Read + filter helper. Drops expired cookies. Optional domain filter
+     * uses the same `domainMatches` logic Playwright/CDP do (leading dot
+     * means subdomain match).
+     */
+    list(filter?: {
+        domain?: string;
+    }): Cookie[];
+    /**
+     * Set a single cookie, merging into the store on `(name, domain, path)`.
+     * Returns the saved store.
+     */
+    set(cookie: Cookie): CookieStore;
+    /**
+     * Clear cookies. Pass `{ all: true }` to wipe everything (including
+     * origins/localStorage), or `{ domain: "..." }` to drop matching cookies
+     * + origins. Returns counts before/after.
+     */
+    clear(opts: {
+        domain?: string;
+        all?: boolean;
+    }): {
+        before: number;
+        after: number;
+    };
+    /**
+     * Build a `Cookie:` header value for a URL. Only cookies that match
+     * domain + path + secure rules are included. Returns `""` when nothing
+     * matches.
+     */
+    header(url: string): string;
+    /**
+     * Import cookies from a JSON file. Accepts three shapes:
+     *   - `{ cookies: [...] }` (CDP/agent-browser native)
+     *   - `{ data: { cookies: [...] } }` (agent-browser wrapper envelope)
+     *   - `[...]` (raw array)
+     *
+     * `replace: true` overwrites the store; default merges on `(name, domain, path)`.
+     * Returns the count imported.
+     */
+    import(filePath: string, opts?: {
+        replace?: boolean;
+    }): {
+        count: number;
+    };
+    /** Write the entire store to a file (for sharing with another tool). */
+    export(filePath: string): {
+        count: number;
+    };
+    /** Stats for the `info` command. Stable shape so callers can JSON it. */
+    info(): InfoResult;
+}
+/**
+ * Merge cookies into a store. Newer entries with the same
+ * `(name, domain, path)` triple replace older ones. Pure; caller must save.
+ */
+export declare function mergeCookies(store: CookieStore, incoming: Cookie[]): CookieStore;
+/** RFC 6265 domain match. Leading dot in cookie domain means subdomain match. */
+export declare function domainMatches(cookieDomain: string, hostname: string): boolean;
+/** RFC 6265 path match. */
+export declare function pathMatches(cookiePath: string, urlPath: string): boolean;
+/** `expires <= 0` is a session cookie / no expiry; otherwise compare to now. */
+export declare function isExpired(cookie: Cookie): boolean;
+/** Cookies that should be sent with a request to `url`. */
+export declare function matchingCookies(store: CookieStore, url: string): Cookie[];
+//# sourceMappingURL=client.d.ts.map

package/dist/lib/cookies/client.d.ts.map

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

package/dist/lib/cookies/client.js

@@ -0,0 +1,239 @@
+import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+export class CookieJar {
+    path;
+    source;
+    constructor(opts) {
+        this.path = opts.path;
+        this.source = opts.source ?? "bp-cookies";
+    }
+    exists() {
+        return existsSync(this.path);
+    }
+    load() {
+        if (!existsSync(this.path)) {
+            return { cookies: [], origins: [] };
+        }
+        const raw = readFileSync(this.path, "utf-8");
+        const parsed = JSON.parse(raw);
+        return {
+            cookies: parsed.cookies ?? [],
+            origins: parsed.origins ?? [],
+            exportedAt: parsed.exportedAt,
+            exportedFrom: parsed.exportedFrom,
+        };
+    }
+    /**
+     * Persist a store, stamping `exportedAt` (now) and `exportedFrom`
+     * (constructor-provided source). Creates the parent directory if needed.
+     */
+    save(store) {
+        const stamped = {
+            ...store,
+            exportedAt: new Date().toISOString(),
+            exportedFrom: this.source,
+        };
+        mkdirSync(dirname(this.path), { recursive: true });
+        writeFileSync(this.path, `${JSON.stringify(stamped, null, 2)}\n`);
+    }
+    /**
+     * Read + filter helper. Drops expired cookies. Optional domain filter
+     * uses the same `domainMatches` logic Playwright/CDP do (leading dot
+     * means subdomain match).
+     */
+    list(filter = {}) {
+        const store = this.load();
+        let cookies = store.cookies.filter((c) => !isExpired(c));
+        if (filter.domain) {
+            cookies = cookies.filter((c) => domainMatches(c.domain, filter.domain));
+        }
+        return cookies;
+    }
+    /**
+     * Set a single cookie, merging into the store on `(name, domain, path)`.
+     * Returns the saved store.
+     */
+    set(cookie) {
+        const store = this.load();
+        const merged = mergeCookies(store, [cookie]);
+        this.save(merged);
+        return merged;
+    }
+    /**
+     * Clear cookies. Pass `{ all: true }` to wipe everything (including
+     * origins/localStorage), or `{ domain: "..." }` to drop matching cookies
+     * + origins. Returns counts before/after.
+     */
+    clear(opts) {
+        if (!opts.domain && !opts.all) {
+            throw new Error("Specify { domain } or { all: true }");
+        }
+        const store = this.load();
+        const before = store.cookies.length;
+        if (opts.all) {
+            store.cookies = [];
+            store.origins = [];
+        }
+        else if (opts.domain) {
+            const dom = opts.domain;
+            store.cookies = store.cookies.filter((c) => !domainMatches(c.domain, dom));
+            store.origins = store.origins.filter((o) => {
+                try {
+                    return !domainMatches(dom, new URL(o.origin).hostname);
+                }
+                catch {
+                    return true;
+                }
+            });
+        }
+        this.save(store);
+        return { before, after: store.cookies.length };
+    }
+    /**
+     * Build a `Cookie:` header value for a URL. Only cookies that match
+     * domain + path + secure rules are included. Returns `""` when nothing
+     * matches.
+     */
+    header(url) {
+        const store = this.load();
+        const cookies = matchingCookies(store, url);
+        return cookies.map((c) => `${c.name}=${c.value}`).join("; ");
+    }
+    /**
+     * Import cookies from a JSON file. Accepts three shapes:
+     *   - `{ cookies: [...] }` (CDP/agent-browser native)
+     *   - `{ data: { cookies: [...] } }` (agent-browser wrapper envelope)
+     *   - `[...]` (raw array)
+     *
+     * `replace: true` overwrites the store; default merges on `(name, domain, path)`.
+     * Returns the count imported.
+     */
+    import(filePath, opts = {}) {
+        if (!existsSync(filePath)) {
+            throw new Error(`File not found: ${filePath}`);
+        }
+        const raw = readFileSync(filePath, "utf-8");
+        const incoming = JSON.parse(raw);
+        const cookies = incoming.cookies ?? incoming.data?.cookies ?? incoming;
+        if (!Array.isArray(cookies)) {
+            throw new Error(`Expected a cookies array in ${filePath}`);
+        }
+        if (opts.replace) {
+            const store = { cookies, origins: incoming.origins ?? [] };
+            this.save(store);
+        }
+        else {
+            const store = this.load();
+            const merged = mergeCookies(store, cookies);
+            if (incoming.origins) {
+                const seen = new Set(store.origins.map((o) => o.origin));
+                for (const o of incoming.origins) {
+                    if (!seen.has(o.origin))
+                        merged.origins.push(o);
+                }
+            }
+            this.save(merged);
+        }
+        return { count: cookies.length };
+    }
+    /** Write the entire store to a file (for sharing with another tool). */
+    export(filePath) {
+        const store = this.load();
+        const stamped = {
+            ...store,
+            exportedAt: new Date().toISOString(),
+            exportedFrom: `${this.source}-export`,
+        };
+        mkdirSync(dirname(filePath), { recursive: true });
+        writeFileSync(filePath, `${JSON.stringify(stamped, null, 2)}\n`);
+        return { count: stamped.cookies.length };
+    }
+    /** Stats for the `info` command. Stable shape so callers can JSON it. */
+    info() {
+        if (!existsSync(this.path)) {
+            return {
+                path: this.path,
+                exists: false,
+                bytes: 0,
+                active: 0,
+                expired: 0,
+                total: 0,
+                domains: [],
+                origins: 0,
+            };
+        }
+        const store = this.load();
+        const expired = store.cookies.filter(isExpired).length;
+        const active = store.cookies.length - expired;
+        const domainSet = new Set(store.cookies.map((c) => (c.domain.startsWith(".") ? c.domain.slice(1) : c.domain)));
+        return {
+            path: this.path,
+            exists: true,
+            bytes: statSync(this.path).size,
+            active,
+            expired,
+            total: store.cookies.length,
+            domains: [...domainSet].sort(),
+            origins: store.origins.length,
+            exportedAt: store.exportedAt,
+            exportedFrom: store.exportedFrom,
+        };
+    }
+}
+// ---------------------------------------------------------------------------
+// Standalone helpers (also exported so callers without a CookieJar can use them)
+// ---------------------------------------------------------------------------
+/**
+ * Merge cookies into a store. Newer entries with the same
+ * `(name, domain, path)` triple replace older ones. Pure; caller must save.
+ */
+export function mergeCookies(store, incoming) {
+    const key = (c) => `${c.name}|${c.domain}|${c.path}`;
+    const map = new Map();
+    for (const c of store.cookies)
+        map.set(key(c), c);
+    for (const c of incoming)
+        map.set(key(c), c);
+    return { ...store, cookies: Array.from(map.values()) };
+}
+/** RFC 6265 domain match. Leading dot in cookie domain means subdomain match. */
+export function domainMatches(cookieDomain, hostname) {
+    const cd = cookieDomain.startsWith(".") ? cookieDomain.slice(1) : cookieDomain;
+    if (hostname === cd)
+        return true;
+    if (hostname.endsWith(`.${cd}`))
+        return true;
+    return false;
+}
+/** RFC 6265 path match. */
+export function pathMatches(cookiePath, urlPath) {
+    if (urlPath === cookiePath)
+        return true;
+    if (urlPath.startsWith(cookiePath) && cookiePath.endsWith("/"))
+        return true;
+    if (urlPath.startsWith(`${cookiePath}/`))
+        return true;
+    return false;
+}
+/** `expires <= 0` is a session cookie / no expiry; otherwise compare to now. */
+export function isExpired(cookie) {
+    if (cookie.expires <= 0)
+        return false;
+    return cookie.expires < Date.now() / 1000;
+}
+/** Cookies that should be sent with a request to `url`. */
+export function matchingCookies(store, url) {
+    const parsed = new URL(url);
+    const isSecure = parsed.protocol === "https:";
+    return store.cookies.filter((c) => {
+        if (isExpired(c))
+            return false;
+        if (!domainMatches(c.domain, parsed.hostname))
+            return false;
+        if (!pathMatches(c.path, parsed.pathname))
+            return false;
+        if (c.secure && !isSecure)
+            return false;
+        return true;
+    });
+}

package/dist/lib/cookies/index.d.ts

@@ -0,0 +1,2 @@
+export { type Cookie, CookieJar, type CookieJarOptions, type CookieStore, domainMatches, type InfoResult, isExpired, matchingCookies, mergeCookies, type OriginEntry, pathMatches, } from "./client.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/cookies/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/cookies/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,MAAM,EACX,SAAS,EACT,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,aAAa,EACb,KAAK,UAAU,EACf,SAAS,EACT,eAAe,EACf,YAAY,EACZ,KAAK,WAAW,EAChB,WAAW,GACZ,MAAM,aAAa,CAAC"}

package/dist/lib/cookies/index.js

@@ -0,0 +1 @@
+export { CookieJar, domainMatches, isExpired, matchingCookies, mergeCookies, pathMatches, } from "./client.js";

package/dist/lib/council/index.d.ts

@@ -0,0 +1,266 @@
+/**
+ * Council manifest helpers: file-based multi-agent coordination primitives.
+ *
+ * Lives under .harnery/councils/ alongside heartbeats + scratchpads. Council
+ * lifecycle commands serialize manifest mutations through a shared flock;
+ * round contribution files are per-member and don't need shared locking.
+ */
+export declare const COUNCIL_SCHEMA_VERSION: 2;
+export type CouncilStatus = "active" | "closed" | "archived";
+export type CouncilRoundStatus = "open" | "collected";
+export type CouncilRoundVisibility = "next_round" | "live";
+export interface CouncilManifest {
+    schema_version: typeof COUNCIL_SCHEMA_VERSION;
+    council_id: string;
+    created_at: string;
+    /** Display name of the convener (denormalized, for human scan).
+     * Canonical FK is `created_by_id`. */
+    created_by: string;
+    /** Durable persona UUID of the convener (registry key). Authoritative. */
+    created_by_id: string;
+    /**
+     * Optional ongoing process-tender. Distinct from `created_by`, which is the
+     * one-time act of creation; the steward is whoever drafts + maintains the
+     * per-round prompts that route operator → contributor each round. Defaults
+     * to `created_by` when omitted (set at create-time via --steward, or
+     * retrofitted via direct manifest edit). Read by `agents council prompt`
+     * to enforce write authority.
+     *
+     * Display name (denormalized). Canonical FK is `steward_id`.
+     */
+    steward?: string;
+    /** Durable persona UUID of the steward. */
+    steward_id?: string;
+    objective: string;
+    target_doc: string | null;
+    /** Member display names (denormalized, parallel to `member_ids`). */
+    members: string[];
+    /** Canonical FK array of durable persona UUIDs of every member, parallel
+     * to `members[]` (same length, same order). Used by contributors-in-round
+     * lookups and contribution filenames (`round-N/<member_id>.md`). */
+    member_ids: string[];
+    current_round: number;
+    round_status: CouncilRoundStatus;
+    status: CouncilStatus;
+    auto_advance: boolean;
+    round_visibility: CouncilRoundVisibility;
+    closed_at?: string;
+    archived_at?: string;
+}
+/**
+ * Resolve the effective steward: explicit `steward` field if set, otherwise
+ * fall back to `created_by`. Always returns a normalized `agent-Foo` name.
+ */
+export declare function effectiveSteward(manifest: CouncilManifest): string;
+/** Resolve `.harnery/councils/` (creates the dir lazily on first write). */
+export declare function councilsDir(): string | null;
+/** Resolve `.harnery/councils/archive/`. */
+export declare function councilsArchiveDir(): string | null;
+/** Manifest file path: `.harnery/councils/<id>.json`. */
+export declare function manifestPath(councilId: string): string | null;
+/** Council body dir: `.harnery/councils/<id>/` (holds invite.md + round-N/...). */
+export declare function councilBodyDir(councilId: string): string | null;
+/** Normalize an `agent-Foo`/`Foo` reference to canonical `agent-Foo` form. */
+export declare function normalizeAgentName(raw: string): string;
+/** Strip the `agent-` prefix for output to lookups that expect bare name. */
+export declare function bareAgentName(raw: string): string;
+/**
+ * Derive a kebab-case slug from objective text. Keeps the first 5 words after
+ * lowercasing and stripping non-alphanumeric chars.
+ */
+export declare function deriveSlug(objective: string): string;
+/**
+ * Build a council_id from objective + today's UTC date.
+ *
+ * Format: `<slug>-<YYYY-MM-DD>-<4hex>`. The 4-hex suffix is sourced from a
+ * crypto-strong random byte (not from a hash of the objective) to avoid
+ * collisions when two councils share the same slug + date.
+ */
+export declare function buildCouncilId(objective: string, now?: Date): string;
+/** Hash an objective deterministically, used by tests for stable IDs. */
+export declare function deterministicCouncilId(objective: string, now?: Date): string;
+/** Atomically write a manifest (write tmp → rename). */
+export declare function writeManifest(manifest: CouncilManifest): void;
+/** Read a manifest by id. Returns null when the file is missing. */
+export declare function readManifest(councilId: string): CouncilManifest | null;
+/** Read an archived manifest by id from `.harnery/councils/archive/<id>.json`.
+ * Symmetric to readManifest() but scoped to the archive dir, used by
+ * `agents council unarchive` to load an archived council that is
+ * (by definition) not in the active councils dir. */
+export declare function readArchivedManifest(councilId: string): CouncilManifest | null;
+/**
+ * Reassign the steward on an active or closed council. Atomic via
+ * writeManifest's tmp+rename. Refuses to mutate archived councils
+ * (those are read-only by convention). Pass `null` to clear the field
+ * and revert to the default (the convener, via effectiveSteward).
+ */
+export declare function setCouncilSteward(councilId: string, steward: string | null): CouncilManifest;
+export interface KnownAgent {
+    /** `agent-<Name>` canonical handle. */
+    name: string;
+    /** `active` = currently has a heartbeat in `.harnery/active/`. `stale` =
+     * recently ended (scratchpad archived within the lookback window). */
+    state: "active" | "stale";
+    /** ISO timestamp of the most-recent signal. */
+    last_seen: string;
+}
+/**
+ * Active heartbeats + recently-archived scratchpads, deduped by name.
+ * Used by `agents council set-steward` to refuse arbitrary names;
+ * pass `--allow-unknown` to bypass when bootstrapping a new agent.
+ */
+export declare function listKnownAgents(): KnownAgent[];
+/** List all council manifests in the active dir (skips archive/). */
+export declare function listManifests(): CouncilManifest[];
+/**
+ * Move a council's manifest + body dir into the archive subdir. Idempotent:
+ * archiving an already-archived council is a no-op (the source paths won't
+ * exist). Used by `council archive` and by `council close --archive`.
+ */
+export declare function moveToArchive(councilId: string): void;
+/**
+ * Reverse of moveToArchive: move a council's manifest + body dir back from
+ * archive/ to the active councils dir. Idempotent: a missing archive path is
+ * a no-op; an existing active path is left untouched and the archived copy
+ * is dropped (mirrors moveToArchive's clobber-avoidance rule). Used by
+ * `agents council unarchive` for testing the archive flow and as an undo
+ * escape hatch.
+ */
+export declare function moveFromArchive(councilId: string): void;
+/**
+ * Permanently remove an archived council: manifest + body dir under
+ * .harnery/councils/archive/<id>. Refuses to touch a council that's still
+ * in the active dir (caller must archive first; the trash-can pattern).
+ * Idempotent: missing paths are a no-op. Returns true when something was
+ * actually deleted, false when both targets were already absent.
+ *
+ * NB: does NOT touch the council's target_doc (separate authored artifact),
+ * close_handoff_path (separate authored artifact), or the canonical event
+ * stream (immutable activity log). The delete is scoped to the manifest +
+ * per-round member contributions.
+ */
+export declare function deleteArchivedCouncil(councilId: string): boolean;
+/** Resolve a member name (or partial id) to a council manifest from the active dir. */
+export declare function findManifestByPartialId(partial: string): CouncilManifest | null;
+/** Build the invite.md body that ships alongside the manifest. */
+export declare function buildInviteMarkdown(manifest: CouncilManifest): string;
+/**
+ * Path to the contribution file for a member in a specific round.
+ * Filename uses the agent's durable persona uuid (`<agent_id>.md`) so
+ * a future rename doesn't break the link between manifest and on-disk
+ * contribution. Resolves the name through the identity registry; mints a
+ * new identity when the member name isn't registered yet (rare post-
+ * migration; only happens for a brand-new persona that's never run).
+ */
+export declare function contributionPath(councilId: string, round: number, memberName: string): string | null;
+/** Path to a round's directory: `.harnery/councils/<id>/round-<N>/`. */
+export declare function roundDir(councilId: string, round: number): string | null;
+/**
+ * Read the set of agent-Names that have contributed to a given round.
+ * Returns display names ("agent-Maya"), not raw uuids; filenames on disk
+ * are now `<agent_id>.md`, so we resolve each one through the registry
+ * before returning. An identity that's been pruned (or never registered)
+ * surfaces as `agent-<8-char-prefix>` so the value remains scannable.
+ *
+ * For UUID-keyed callers, use `contributorIdsInRound`.
+ * Empty array when the round directory doesn't exist yet.
+ */
+export declare function contributorsInRound(councilId: string, round: number): string[];
+/** Like contributorsInRound but returns the raw agent_id uuids: the
+ * filenames on disk without the .md extension. */
+export declare function contributorIdsInRound(councilId: string, round: number): string[];
+/**
+ * Return the IDs of active councils where this agent is a member AND has not
+ * yet contributed to the current open round. Used by `agents status` to
+ * surface a `council N pending` line in the status box, and by SessionStart
+ * adapters to inject system reminders about pending invites.
+ */
+export declare function pendingCouncilsForMember(memberName: string): string[];
+/** Write a contribution file (atomic). Creates the round directory lazily. */
+export declare function writeContribution(councilId: string, round: number, memberName: string, body: string): string;
+/**
+ * Path to the round-N prompts directory: `.harnery/councils/<id>/round-N/prompts/`.
+ * Sibling to the contribution files. Holds one `<member>.md` per non-self
+ * council member, drafted by the steward, read by the operator (copy-paste
+ * into each agent harness) and the web UI (per-member panel).
+ */
+export declare function promptsDir(councilId: string, round: number): string | null;
+/** Path to a single member's prompt file in a given round. Like
+ * contributionPath, filename uses the agent's durable persona uuid. */
+export declare function promptPath(councilId: string, round: number, memberName: string): string | null;
+/**
+ * Build the routing header prepended to every steward-drafted prompt. The
+ * contributor skill scans inbound messages for this comment block; if the
+ * `member:` line does not match the receiving agent's whoami, the agent
+ * refuses to contribute (catches operator misrouting). HTML-comment so it
+ * renders invisibly in markdown previews.
+ */
+export declare function buildRouteHeader(councilId: string, round: number, memberName: string): string;
+/** Strip a leading route header from a prompt body, if present. */
+export declare function stripRouteHeader(body: string): string;
+/**
+ * Build the submit footer appended to every steward-drafted prompt. This is the
+ * load-bearing instruction that a contribution composed in chat is NOT recorded;
+ * the agent must run the command below. It rides on the prompt (the one
+ * artifact the operator always pastes) so it reaches every harness regardless of
+ * whether the convene-time invitation was delivered or a `/council` skill is
+ * available. Without it, agents (esp. non-Claude harnesses with no skill) write
+ * their take as a reply and end the turn, leaving the council showing them as
+ * still-pending. Visible markdown (not an HTML comment) so the agent reads it.
+ */
+export declare function buildSubmitFooter(councilId: string): string;
+/** Strip an appended submit footer from a prompt body, if present. */
+export declare function stripSubmitFooter(body: string): string;
+/** Parse a route header from a string (the inbound user message). Returns
+ * null when the comment is absent or malformed. Used by the /council
+ * contribute skill to detect operator misrouting before contributing. */
+export declare function parseRouteHeader(text: string): {
+    council_id: string;
+    council_round: number;
+    member: string;
+} | null;
+/** Write a prompt file (atomic). Creates the prompts dir lazily. The body
+ * is automatically prepended with a route header (see `buildRouteHeader`) so
+ * the contributor skill can verify the operator routed the prompt to the
+ * right agent. */
+export declare function writePrompt(councilId: string, round: number, memberName: string, body: string): string;
+/**
+ * Read a member's prompt for a given round. Returns null when the file
+ * doesn't exist (steward hasn't drafted one yet). Includes a `completed`
+ * boolean so the UI can mark the prompt deactivated once the contribution
+ * has landed.
+ */
+export declare function readPrompt(councilId: string, round: number, memberName: string): {
+    body: string;
+    completed: boolean;
+} | null;
+/**
+ * Visual/behavioral state of a per-member routing prompt within a round:
+ *
+ * - `contributed`: the member already submitted; the prompt is preserved for
+ *   audit but no longer actionable. UIs render it dimmed + struck-through.
+ * - `active`: the first not-yet-contributed prompt in `manifest.members`
+ *   order. This is the one the operator should route next. UIs highlight it.
+ * - `queued`: drafted but waiting for an earlier member to contribute first.
+ *   UIs render it dimmed with the Copy button disabled so the operator can't
+ *   route it out of order.
+ */
+export type CouncilPromptState = "contributed" | "active" | "queued";
+/**
+ * Read every member's prompt for a round, in `manifest.members` order
+ * (which is the agreed round-robin sequence; alphabetical is wrong because
+ * stewards typically build councils with a deliberate first-to-last order).
+ *
+ * Each entry carries `order` (1-indexed position within manifest.members,
+ * skipping members whose prompts don't exist) + `state` (contributed /
+ * active / queued) so the UI can render the three-state pattern without
+ * duplicating the active-determination logic.
+ */
+export declare function readRoundPrompts(manifest: CouncilManifest, round: number): Array<{
+    member: string;
+    body: string;
+    completed: boolean;
+    order: number;
+    state: CouncilPromptState;
+}>;
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/council/index.d.ts.map

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