@creator-notes/cnotes 0.16.11

package/dist/lib/brand.js

@@ -0,0 +1,32 @@
+/**
+ * Brand single source of truth for the CLI.
+ *
+ * This is the CLI-side MIRROR of the app's `lib/brand.ts`. The CLI ships as a
+ * separate npm package and cannot import from the Next.js app, so the shared
+ * identity is duplicated here. A drift guard in the app
+ * (`__tests__/brand.test.ts`) asserts the shared fields below stay in sync with
+ * `lib/brand.ts` — update both together.
+ *
+ * On a rename, changing `configDir` orphans existing logins and changing
+ * `packageName` breaks `npx`/global-install updates — so when either moves, ship
+ * a migration. `configDir` carries a one-time rename of the old directory on
+ * load (see `auth-store.ts`); the old npm package should be deprecated to point
+ * at the new one.
+ */
+export const BRAND = {
+    /** Display name, used in CLI help/banner text. */
+    name: "Creator Notes",
+    /** Canonical production origin (the published default server). */
+    url: "https://creatornotes.app",
+    /** Bare domain. */
+    domain: "creatornotes.app",
+    /** The installed command. */
+    command: "cnotes",
+    /** Published package name. */
+    packageName: "@creator-notes/cnotes",
+    /** Config dir under $HOME (holds login tokens). Migrated from the old name on load. */
+    configDir: ".cnotes",
+    /** Source repo, owner/name form. */
+    repo: "creatornotes/pm-notes",
+};
+//# sourceMappingURL=brand.js.map

package/dist/lib/brand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand.js","sourceRoot":"","sources":["../../src/lib/brand.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,kDAAkD;IAClD,IAAI,EAAE,eAAe;IACrB,kEAAkE;IAClE,GAAG,EAAE,0BAA0B;IAC/B,mBAAmB;IACnB,MAAM,EAAE,kBAAkB;IAC1B,6BAA6B;IAC7B,OAAO,EAAE,QAAQ;IACjB,8BAA8B;IAC9B,WAAW,EAAE,uBAAuB;IACpC,uFAAuF;IACvF,SAAS,EAAE,SAAS;IACpB,oCAAoC;IACpC,IAAI,EAAE,uBAAuB;CACrB,CAAC"}

package/dist/lib/build-schema.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Shared schema builder for `cnotes schema` and the `cn_schema` MCP tool.
+ *
+ * Returns the things an agent would otherwise have to read SKILL.md or guess
+ * at: valid note types (from the current workspace), common relationship
+ * slugs, resource field shapes, exit codes, and env vars. One source of truth
+ * so the CLI and MCP surfaces never drift.
+ */
+import { ApiClient } from "./api-client.js";
+export declare const STATIC_SCHEMA: {
+    readonly relationships: {
+        readonly note: "Relationship slugs are free-form strings. The values below are common conventions, not an enum — the server accepts any string.";
+        readonly common: readonly ["references", "supports", "blocks", "derives_from", "contradicts", "triggers", "related"];
+    };
+    readonly syntax: {
+        readonly noteMention: "[NOTE-12: Title](relationship:references)";
+        readonly batchPlaceholder: "[@key: Title](relationship:references) — '@key' is replaced with the new display ID after batch create";
+        readonly rules: readonly ["Always include `: Title` after the ID. The title-less form renders as 'Untitled' in the UI.", "Pick a relationship slug that fits; `references` is the safe default."];
+    };
+    readonly resources: {
+        readonly note: {
+            readonly fields: {
+                readonly id: "Convex ID (string)";
+                readonly displayId: "Human-readable ID (e.g. MEETING-12, PRD-3)";
+                readonly title: "string";
+                readonly type: "string (must match a supertag name from `types`)";
+                readonly tags: "string[]";
+                readonly isPinned: "boolean";
+                readonly isArchived: "boolean";
+                readonly updatedAt: "number (unix ms)";
+            };
+        };
+        readonly canvasNode: {
+            readonly kinds: readonly ["note", "text", "list", "canvas", "richtext", "link"];
+            readonly note: "Use `cnotes canvas place` with the declarative layout DSL whenever you can — it packs items without overlaps so you avoid x/y math.";
+        };
+        readonly canvasEdge: {
+            readonly fields: {
+                readonly sourceNodeId: "string";
+                readonly targetNodeId: "string";
+                readonly label: "string (optional, free-form)";
+                readonly lineStyle: "solid | dashed";
+                readonly arrow: "end | start | both | none";
+            };
+        };
+    };
+    readonly exitCodes: {
+        readonly "0": "ok";
+        readonly "1": "generic error";
+        readonly "2": "auth required (run `cnotes auth login`)";
+        readonly "3": "validation (bad input)";
+        readonly "4": "not found";
+        readonly "5": "conflict (state collision)";
+        readonly "6": "rate-limited";
+        readonly "7": "permission denied";
+    };
+    readonly env: {
+        readonly CN_SERVER: "Override server URL";
+        readonly CN_TOKEN: "Auth token (alternative to `cnotes auth login`)";
+        readonly CN_WORKSPACE: "Override workspace ID for this invocation";
+        readonly CN_JSON: "Set to 1 to force JSON output";
+        readonly CN_AGENT_RUN_ID: "Active agent-run bracket (set by `cnotes canvas agent-run begin/wrap`)";
+        readonly CN_AGENT_BEFORE_SNAPSHOT_ID: "Begin-snapshot ID carried with the agent-run";
+    };
+    readonly agentRun: {
+        readonly note: "Wrap multi-step canvas mutations in an agent-run so they show up as one revertable unit in the UI history.";
+        readonly wrap: "cnotes canvas agent-run wrap --canvas <id> --prompt \"<intent>\" -- <command>";
+    };
+};
+export interface SchemaType {
+    name: string;
+    prefix: string;
+    displayName: string;
+    color: string | null;
+    isBuiltIn: boolean;
+}
+export interface SchemaFetchError {
+    resource: "workspace" | "types";
+    error: string;
+}
+export interface BuiltSchema {
+    workspace: {
+        id: string;
+        name: string | null;
+        verified: boolean;
+    };
+    types: SchemaType[];
+    dynamicFetchErrors?: SchemaFetchError[];
+}
+/**
+ * Build the full schema document. The static metadata (exit codes, syntax,
+ * resource shapes) is always present; the dynamic bits (workspace + types)
+ * are fetched and any failures are reported in `dynamicFetchErrors` so callers
+ * never treat a partial schema as authoritative.
+ */
+export declare function buildSchema(api: ApiClient, workspaceId: string): Promise<BuiltSchema & typeof STATIC_SCHEMA>;
+//# sourceMappingURL=build-schema.d.ts.map

package/dist/lib/build-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-schema.d.ts","sourceRoot":"","sources":["../../src/lib/build-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsEhB,CAAC;AAgBX,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;IAClE,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,kBAAkB,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACzC;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,SAAS,EACd,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,WAAW,GAAG,OAAO,aAAa,CAAC,CAyD7C"}

package/dist/lib/build-schema.js

@@ -0,0 +1,139 @@
+/**
+ * Shared schema builder for `cnotes schema` and the `cn_schema` MCP tool.
+ *
+ * Returns the things an agent would otherwise have to read SKILL.md or guess
+ * at: valid note types (from the current workspace), common relationship
+ * slugs, resource field shapes, exit codes, and env vars. One source of truth
+ * so the CLI and MCP surfaces never drift.
+ */
+export const STATIC_SCHEMA = {
+    relationships: {
+        note: "Relationship slugs are free-form strings. The values below are common conventions, not an enum — the server accepts any string.",
+        common: [
+            "references",
+            "supports",
+            "blocks",
+            "derives_from",
+            "contradicts",
+            "triggers",
+            "related",
+        ],
+    },
+    syntax: {
+        noteMention: "[NOTE-12: Title](relationship:references)",
+        batchPlaceholder: "[@key: Title](relationship:references) — '@key' is replaced with the new display ID after batch create",
+        rules: [
+            "Always include `: Title` after the ID. The title-less form renders as 'Untitled' in the UI.",
+            "Pick a relationship slug that fits; `references` is the safe default.",
+        ],
+    },
+    resources: {
+        note: {
+            fields: {
+                id: "Convex ID (string)",
+                displayId: "Human-readable ID (e.g. MEETING-12, PRD-3)",
+                title: "string",
+                type: "string (must match a supertag name from `types`)",
+                tags: "string[]",
+                isPinned: "boolean",
+                isArchived: "boolean",
+                updatedAt: "number (unix ms)",
+            },
+        },
+        canvasNode: {
+            kinds: ["note", "text", "list", "canvas", "richtext", "link"],
+            note: "Use `cnotes canvas place` with the declarative layout DSL whenever you can — it packs items without overlaps so you avoid x/y math.",
+        },
+        canvasEdge: {
+            fields: {
+                sourceNodeId: "string",
+                targetNodeId: "string",
+                label: "string (optional, free-form)",
+                lineStyle: "solid | dashed",
+                arrow: "end | start | both | none",
+            },
+        },
+    },
+    exitCodes: {
+        "0": "ok",
+        "1": "generic error",
+        "2": "auth required (run `cnotes auth login`)",
+        "3": "validation (bad input)",
+        "4": "not found",
+        "5": "conflict (state collision)",
+        "6": "rate-limited",
+        "7": "permission denied",
+    },
+    env: {
+        CN_SERVER: "Override server URL",
+        CN_TOKEN: "Auth token (alternative to `cnotes auth login`)",
+        CN_WORKSPACE: "Override workspace ID for this invocation",
+        CN_JSON: "Set to 1 to force JSON output",
+        CN_AGENT_RUN_ID: "Active agent-run bracket (set by `cnotes canvas agent-run begin/wrap`)",
+        CN_AGENT_BEFORE_SNAPSHOT_ID: "Begin-snapshot ID carried with the agent-run",
+    },
+    agentRun: {
+        note: "Wrap multi-step canvas mutations in an agent-run so they show up as one revertable unit in the UI history.",
+        wrap: "cnotes canvas agent-run wrap --canvas <id> --prompt \"<intent>\" -- <command>",
+    },
+};
+/**
+ * Build the full schema document. The static metadata (exit codes, syntax,
+ * resource shapes) is always present; the dynamic bits (workspace + types)
+ * are fetched and any failures are reported in `dynamicFetchErrors` so callers
+ * never treat a partial schema as authoritative.
+ */
+export async function buildSchema(api, workspaceId) {
+    const dynamicFetchErrors = [];
+    const [workspaceData, supertags] = await Promise.all([
+        api
+            .get(`/api/workspaces/${workspaceId}`)
+            .catch((err) => {
+            dynamicFetchErrors.push({
+                resource: "workspace",
+                error: err instanceof Error ? err.message : String(err),
+            });
+            return null;
+        }),
+        api
+            .get("/api/supertags", { workspaceId })
+            .catch((err) => {
+            dynamicFetchErrors.push({
+                resource: "types",
+                error: err instanceof Error ? err.message : String(err),
+            });
+            return [];
+        }),
+    ]);
+    const workspaceRecord = workspaceData
+        ? (workspaceData.workspace ??
+            workspaceData)
+        : null;
+    const types = (Array.isArray(supertags) ? supertags : []).map((s) => ({
+        name: s.name ?? "",
+        prefix: s.prefix ?? "",
+        displayName: s.displayName ?? s.name ?? "",
+        color: s.color ?? null,
+        isBuiltIn: !!s.isBuiltIn,
+    }));
+    const workspaceFailed = dynamicFetchErrors.some((e) => e.resource === "workspace");
+    return {
+        workspace: workspaceRecord
+            ? {
+                id: String(workspaceRecord._id ?? workspaceRecord.id ?? workspaceId),
+                name: workspaceRecord.name ?? null,
+                verified: true,
+            }
+            : {
+                id: workspaceId,
+                name: null,
+                // Surface that we couldn't confirm this ID with the server, so an
+                // agent doesn't trust it for downstream lookups.
+                verified: !workspaceFailed,
+            },
+        types,
+        ...(dynamicFetchErrors.length > 0 ? { dynamicFetchErrors } : {}),
+        ...STATIC_SCHEMA,
+    };
+}
+//# sourceMappingURL=build-schema.js.map

package/dist/lib/build-schema.js.map

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

package/dist/lib/canvas-read.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Shared helper for `cnotes canvas read` and the `cn_canvas_read` MCP tool.
+ *
+ * Fetches a canvas + its referenced notes (one bulk call, never N+1) and
+ * returns a list of "renderable" elements ordered top-to-bottom,
+ * left-to-right with a small Y tolerance so visually-aligned rows stay
+ * together. Heuristic, not a layout-aware sort — fine for a "thinking
+ * aid" but not authoritative.
+ */
+import type { ApiClient } from "./api-client.js";
+export type CanvasPos = {
+    positionX?: number;
+    positionY?: number;
+};
+export type CanvasElement = {
+    kind: "note";
+    pos: CanvasPos;
+    displayId: string;
+    title: string;
+    type: string;
+    markdown: string;
+} | {
+    kind: "text";
+    pos: CanvasPos;
+    text: string;
+    headingSize?: string;
+} | {
+    kind: "richtext";
+    pos: CanvasPos;
+    markdown: string;
+} | {
+    kind: "list";
+    pos: CanvasPos;
+    title: string;
+    items: Array<{
+        displayId?: string;
+        title?: string;
+        type?: string;
+    }>;
+};
+export interface CanvasReadResult {
+    canvas: Record<string, unknown> | {
+        id: string;
+    };
+    elements: CanvasElement[];
+}
+export declare function readCanvasMarkdown(api: ApiClient, workspaceId: string | undefined, canvasId: string): Promise<CanvasReadResult>;
+/**
+ * Render a CanvasReadResult as a single concatenated markdown document.
+ * Used by the CLI's text output mode; the MCP tool returns the structured
+ * form directly so the model can do its own rendering if needed.
+ */
+export declare function renderCanvasMarkdown(result: CanvasReadResult): string;
+//# sourceMappingURL=canvas-read.d.ts.map

package/dist/lib/canvas-read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvas-read.d.ts","sourceRoot":"","sources":["../../src/lib/canvas-read.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM,MAAM,SAAS,GAAG;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnE,MAAM,MAAM,aAAa,GACrB;IACE,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,SAAS,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB,GACD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GACpE;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,GAAG,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACtD;IACE,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,SAAS,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,KAAK,CAAC;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrE,CAAC;AAEN,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACjD,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAID,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,SAAS,EACd,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,gBAAgB,CAAC,CA0G3B;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CA6BrE"}

package/dist/lib/canvas-read.js

@@ -0,0 +1,145 @@
+/**
+ * Shared helper for `cnotes canvas read` and the `cn_canvas_read` MCP tool.
+ *
+ * Fetches a canvas + its referenced notes (one bulk call, never N+1) and
+ * returns a list of "renderable" elements ordered top-to-bottom,
+ * left-to-right with a small Y tolerance so visually-aligned rows stay
+ * together. Heuristic, not a layout-aware sort — fine for a "thinking
+ * aid" but not authoritative.
+ */
+const ROW_TOLERANCE = 80;
+export async function readCanvasMarkdown(api, workspaceId, canvasId) {
+    const data = await api.get(`/api/canvas/${encodeURIComponent(canvasId)}`, { workspaceId, format: "markdown" });
+    const nodes = data.nodes || [];
+    const textNodes = data.textNodes || [];
+    const richtextNodes = data.richtextNodes || [];
+    const listNodes = data.listNodes || [];
+    const wantedDisplayIds = new Set();
+    for (const n of nodes) {
+        const note = n.note;
+        const id = note?.displayId;
+        if (typeof id === "string")
+            wantedDisplayIds.add(id);
+    }
+    const idsArr = Array.from(wantedDisplayIds);
+    const bulk = idsArr.length === 0
+        ? []
+        : await api.get("/api/notes", {
+            workspaceId,
+            exact_ids: idsArr.join(","),
+            format: "markdown",
+        });
+    const markdownByDisplayId = new Map();
+    for (const n of bulk) {
+        const id = n.displayId;
+        const md = n.latestVersion?.content ?? n.content;
+        if (typeof id === "string" && typeof md === "string") {
+            markdownByDisplayId.set(id, md);
+        }
+    }
+    const elements = [];
+    for (const n of nodes) {
+        const note = n.note;
+        const displayId = note?.displayId;
+        if (!displayId)
+            continue;
+        elements.push({
+            kind: "note",
+            pos: {
+                positionX: n.positionX,
+                positionY: n.positionY,
+            },
+            displayId,
+            title: note?.title || "(untitled)",
+            type: note?.type || "Note",
+            markdown: markdownByDisplayId.get(displayId) ?? "",
+        });
+    }
+    for (const t of textNodes) {
+        elements.push({
+            kind: "text",
+            pos: {
+                positionX: t.positionX,
+                positionY: t.positionY,
+            },
+            text: String(t.text || ""),
+            headingSize: t.headingSize,
+        });
+    }
+    for (const r of richtextNodes) {
+        elements.push({
+            kind: "richtext",
+            pos: {
+                positionX: r.positionX,
+                positionY: r.positionY,
+            },
+            markdown: typeof r.content === "string" ? r.content : "",
+        });
+    }
+    for (const l of listNodes) {
+        const items = l.items || [];
+        elements.push({
+            kind: "list",
+            pos: {
+                positionX: l.positionX,
+                positionY: l.positionY,
+            },
+            title: String(l.title || "List"),
+            items: items.map((it) => {
+                const note = it.note;
+                return {
+                    displayId: note?.displayId,
+                    title: note?.title,
+                    type: note?.type,
+                };
+            }),
+        });
+    }
+    elements.sort((a, b) => {
+        const ay = a.pos.positionY ?? 0;
+        const by = b.pos.positionY ?? 0;
+        if (Math.abs(ay - by) > ROW_TOLERANCE)
+            return ay - by;
+        return (a.pos.positionX ?? 0) - (b.pos.positionX ?? 0);
+    });
+    return {
+        canvas: data.canvas ?? { id: canvasId },
+        elements,
+    };
+}
+/**
+ * Render a CanvasReadResult as a single concatenated markdown document.
+ * Used by the CLI's text output mode; the MCP tool returns the structured
+ * form directly so the model can do its own rendering if needed.
+ */
+export function renderCanvasMarkdown(result) {
+    const canvas = result.canvas;
+    const canvasName = canvas?.title || canvas?.name || "(unnamed)";
+    const lines = [`# Canvas: ${canvasName}`, ""];
+    for (const r of result.elements) {
+        if (r.kind === "note") {
+            lines.push(`## ${r.displayId}: ${r.title}`, `*${r.type}*`, "");
+            if (r.markdown)
+                lines.push(r.markdown.trim(), "");
+        }
+        else if (r.kind === "text") {
+            const prefix = r.headingSize === "h1" ? "# " : r.headingSize === "h2" ? "## " : "### ";
+            lines.push(`${prefix}${r.text}`, "");
+        }
+        else if (r.kind === "richtext") {
+            if (r.markdown)
+                lines.push(r.markdown.trim(), "");
+        }
+        else if (r.kind === "list") {
+            lines.push(`## List: ${r.title}`, "");
+            for (const it of r.items) {
+                if (it.displayId) {
+                    lines.push(`- [${it.displayId}: ${it.title ?? ""}](relationship:references)`);
+                }
+            }
+            lines.push("");
+        }
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=canvas-read.js.map

package/dist/lib/canvas-read.js.map

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

package/dist/lib/claude-session.d.ts

@@ -0,0 +1,73 @@
+export interface AgentSession {
+    /** Namespaces `id`. Today only "claude-code" (resumable via
+     *  `claude --resume <id>`); other agent runtimes can opt in later. */
+    kind: string;
+    /** The conversation/session id to resume. */
+    id: string;
+}
+/**
+ * Where `cnotes claude-hook` (a Claude Code SessionStart hook) persists the
+ * current session id. A single "latest" file — simple and correct for the
+ * common one-session-per-machine case. Concurrent Claude Code sessions on the
+ * same machine would clobber it; set CNOTES_AGENT_SESSION_ID to disambiguate.
+ */
+export declare const CLAUDE_SESSION_FILE: string;
+/**
+ * How long a hook-captured session stays trustworthy as "the agent driving
+ * this cnotes run". The SessionStart hook stamps `updatedAt` when the session is
+ * (re)opened, but there's no heartbeat — so this is age-since-opened, not
+ * since-last-activity. A generous window keeps long-running sessions valid
+ * while stopping a file left behind by a session that ended days ago from
+ * stamping a later, unrelated run.
+ */
+export declare const SESSION_FILE_MAX_AGE_MS: number;
+interface StoredSession {
+    id: string;
+    kind?: string;
+    cwd?: string;
+    updatedAt?: number;
+}
+/**
+ * Decide whether a stored hook session is still a trustworthy stand-in for
+ * "the agent driving THIS cnotes run". Pure (takes `now` + `cwd` rather than
+ * reading them) so the rules stay easy to reason about:
+ *
+ *   - Must carry an `id` — the only thing we can actually resume.
+ *   - Not older than {@link SESSION_FILE_MAX_AGE_MS} — a stale file left after
+ *     a session ended must not stamp a later run as if that chat drove it.
+ *   - If the file recorded the session's `cwd`, the current directory must sit
+ *     inside that subtree — a cnotes run in a *different* project isn't this
+ *     session's work. (No recorded cwd → can't scope, so we don't reject on
+ *     that basis.)
+ *
+ * Erring toward rejection is the safe bias here: a false negative just drops
+ * the (optional) resume affordance, whereas a false positive mislabels the
+ * run's provenance and offers a resume to the wrong chat.
+ */
+export declare function isStoredSessionUsable(stored: StoredSession, ctx: {
+    now: number;
+    cwd: string;
+}): boolean;
+/**
+ * Resolve the agent conversation/session driving the current cnotes run, so
+ * `cnotes operations begin` can stamp it on the operation row (making the run
+ * traceable + resumable from the timeline). Resolution order, most explicit
+ * first:
+ *
+ *   1. CN_AGENT_SESSION_ID (+ optional CN_AGENT_SESSION_KIND) — explicit
+ *      override, wins everything. Lets any agent runtime opt in by hand.
+ *   2. The SessionStart-hook file written by `cnotes claude-hook`, when it's still
+ *      fresh + scoped to this directory (see {@link isStoredSessionUsable}).
+ *      This is the Claude Code TOP-LEVEL session id, captured once when the
+ *      session starts — the most correct value to resume (a subagent's own
+ *      bash would otherwise report the subagent's id via the env var below).
+ *   3. CLAUDE_CODE_SESSION_ID — Claude Code's per-process env var. Zero-config
+ *      but undocumented; best-effort fallback when no hook is installed. It's
+ *      the live process's own env, so no staleness check applies.
+ *
+ * Returns null when nothing is known (e.g. cnotes run outside any agent), in which
+ * case the run simply isn't session-stamped — no error.
+ */
+export declare function resolveAgentSession(): AgentSession | null;
+export {};
+//# sourceMappingURL=claude-session.d.ts.map

package/dist/lib/claude-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-session.d.ts","sourceRoot":"","sources":["../../src/lib/claude-session.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,YAAY;IAC3B;0EACsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,QAI/B,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,QAAsB,CAAC;AAE3D,UAAU,aAAa;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,aAAa,EACrB,GAAG,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAChC,OAAO,CAUT;AAQD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,mBAAmB,IAAI,YAAY,GAAG,IAAI,CAgBzD"}