@nookplot/mcp 0.4.109 → 0.4.111

package/dist/profileName.d.ts

@@ -1,65 +0,0 @@
-/**
- * Profile-name derivation for Hermes's `hermes profile create <name>`.
- *
- * Every forged agent on Nookplot maps to its own Hermes profile — a fully
- * isolated directory tree at `~/.hermes/profiles/<name>/` with its own
- * config.yaml, .env, sessions, and (optionally) Telegram bot token. The
- * profile name is the user-facing handle: they run `<name> chat` (via the
- * alias wrapper at `~/.local/bin/<name>`), and it shows up in
- * `hermes profile list`.
- *
- * Hermes's validation rule (from `hermes profile create --help`):
- *   "Profile name (lowercase, alphanumeric)"
- *
- * Empirically, it also accepts hyphens. The pattern we target is
- *   `/^[a-z][a-z0-9-]{0,30}[a-z0-9]$/`  — 2..32 chars, letter-prefix,
- *   alnum-or-hyphen middle, alnum suffix.
- *
- * Input sources, in preference order:
- *   1. `display_name` from `agents.display_name` (slugged)
- *   2. `agent-<last6-hex>` fallback derived from the agent address
- *
- * Collision handling is the caller's job — we just produce the candidate
- * from inputs. The bash installer does a `hermes profile show $NAME ||
- * hermes profile create $NAME` pattern, so a name that already exists
- * with a DIFFERENT agent is the user's problem (rare, and giving them a
- * clear error beats silently shadowing).
- *
- * @module profileName
- */
-/** Validate against Hermes's profile-name rule. Exported for tests. */
-export declare function isValidProfileName(name: string): boolean;
-/**
- * Slugify a free-form string (display name, title, etc.) into a safe
- * profile name. Rules:
- *   - lowercase
- *   - unicode → ASCII approximation (NFKD strips diacritics)
- *   - non-alnum runs become single hyphens
- *   - leading/trailing hyphens trimmed
- *   - leading digits replaced with "a-" so the name starts with a letter
- *   - length capped at MAX_PROFILE_NAME_LEN, trimmed at a hyphen if possible
- *
- * Returns empty string if the input has no usable alphanumeric chars
- * (e.g. pure emoji). Callers should treat that as "fall back to the
- * address-based default."
- */
-export declare function slugifyDisplayName(input: string): string;
-/**
- * Fallback name from an agent's on-chain address: `agent-<last6-hex>`.
- * Always valid (short, letter-prefix, alnum).
- */
-export declare function profileNameFromAddress(address: string): string;
-/**
- * Top-level derivation: try display_name first, fall back to address.
- *
- * Takes optional collision-check hook — if provided, we'll try `<name>-2`,
- * `<name>-3`, ... up to `-9` before giving up. That's enough headroom for
- * normal users; power users who hit it can rename via `hermes profile
- * rename` after the fact.
- */
-export declare function deriveProfileName(opts: {
-    displayName?: string | null;
-    agentAddress: string;
-    isTaken?: (candidate: string) => boolean;
-}): string;
-//# sourceMappingURL=profileName.d.ts.map

package/dist/profileName.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"profileName.d.ts","sourceRoot":"","sources":["../src/profileName.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAKH,uEAAuE;AACvE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CA2BxD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAI9D;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE;IACJ,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;CAC1C,GACA,MAAM,CAmBR"}

package/dist/profileName.js

@@ -1,114 +0,0 @@
-/**
- * Profile-name derivation for Hermes's `hermes profile create <name>`.
- *
- * Every forged agent on Nookplot maps to its own Hermes profile — a fully
- * isolated directory tree at `~/.hermes/profiles/<name>/` with its own
- * config.yaml, .env, sessions, and (optionally) Telegram bot token. The
- * profile name is the user-facing handle: they run `<name> chat` (via the
- * alias wrapper at `~/.local/bin/<name>`), and it shows up in
- * `hermes profile list`.
- *
- * Hermes's validation rule (from `hermes profile create --help`):
- *   "Profile name (lowercase, alphanumeric)"
- *
- * Empirically, it also accepts hyphens. The pattern we target is
- *   `/^[a-z][a-z0-9-]{0,30}[a-z0-9]$/`  — 2..32 chars, letter-prefix,
- *   alnum-or-hyphen middle, alnum suffix.
- *
- * Input sources, in preference order:
- *   1. `display_name` from `agents.display_name` (slugged)
- *   2. `agent-<last6-hex>` fallback derived from the agent address
- *
- * Collision handling is the caller's job — we just produce the candidate
- * from inputs. The bash installer does a `hermes profile show $NAME ||
- * hermes profile create $NAME` pattern, so a name that already exists
- * with a DIFFERENT agent is the user's problem (rare, and giving them a
- * clear error beats silently shadowing).
- *
- * @module profileName
- */
-const MAX_PROFILE_NAME_LEN = 32;
-const MIN_PROFILE_NAME_LEN = 2;
-/** Validate against Hermes's profile-name rule. Exported for tests. */
-export function isValidProfileName(name) {
-    return /^[a-z][a-z0-9-]{0,30}[a-z0-9]$/.test(name);
-}
-/**
- * Slugify a free-form string (display name, title, etc.) into a safe
- * profile name. Rules:
- *   - lowercase
- *   - unicode → ASCII approximation (NFKD strips diacritics)
- *   - non-alnum runs become single hyphens
- *   - leading/trailing hyphens trimmed
- *   - leading digits replaced with "a-" so the name starts with a letter
- *   - length capped at MAX_PROFILE_NAME_LEN, trimmed at a hyphen if possible
- *
- * Returns empty string if the input has no usable alphanumeric chars
- * (e.g. pure emoji). Callers should treat that as "fall back to the
- * address-based default."
- */
-export function slugifyDisplayName(input) {
-    if (typeof input !== "string" || input.length === 0)
-        return "";
-    let s = input
-        .normalize("NFKD")
-        .replace(/[\u0300-\u036f]/g, "") // strip combining accents
-        .toLowerCase()
-        .replace(/[^a-z0-9]+/g, "-") // non-alnum runs → hyphen
-        .replace(/^-+|-+$/g, ""); // trim leading/trailing hyphens
-    if (s.length === 0)
-        return "";
-    // Hermes requires a letter prefix.
-    if (/^[0-9]/.test(s))
-        s = "a-" + s;
-    // Cap length. If we have to cut, prefer cutting at a hyphen so we don't
-    // leave a mid-word stump.
-    if (s.length > MAX_PROFILE_NAME_LEN) {
-        const cut = s.slice(0, MAX_PROFILE_NAME_LEN);
-        const lastHyphen = cut.lastIndexOf("-");
-        s = lastHyphen > MIN_PROFILE_NAME_LEN ? cut.slice(0, lastHyphen) : cut;
-    }
-    // Trim trailing hyphen that could remain after length cut.
-    s = s.replace(/-+$/, "");
-    // After all of that, still must pass the Hermes rule. If not, give up.
-    return isValidProfileName(s) ? s : "";
-}
-/**
- * Fallback name from an agent's on-chain address: `agent-<last6-hex>`.
- * Always valid (short, letter-prefix, alnum).
- */
-export function profileNameFromAddress(address) {
-    const clean = address.replace(/^0x/, "").toLowerCase();
-    const last6 = clean.slice(-6);
-    return `agent-${last6}`;
-}
-/**
- * Top-level derivation: try display_name first, fall back to address.
- *
- * Takes optional collision-check hook — if provided, we'll try `<name>-2`,
- * `<name>-3`, ... up to `-9` before giving up. That's enough headroom for
- * normal users; power users who hit it can rename via `hermes profile
- * rename` after the fact.
- */
-export function deriveProfileName(opts) {
-    const fromDisplay = opts.displayName ? slugifyDisplayName(opts.displayName) : "";
-    const primary = fromDisplay || profileNameFromAddress(opts.agentAddress);
-    if (!opts.isTaken)
-        return primary;
-    if (!opts.isTaken(primary))
-        return primary;
-    for (let i = 2; i <= 9; i++) {
-        const candidate = `${primary}-${i}`;
-        if (candidate.length > MAX_PROFILE_NAME_LEN) {
-            // Primary was too long to suffix; fall back to address-based.
-            const addrName = profileNameFromAddress(opts.agentAddress);
-            return opts.isTaken(addrName) ? `${addrName}-${i}` : addrName;
-        }
-        if (!opts.isTaken(candidate))
-            return candidate;
-    }
-    // Give up — return the primary. Hermes will error on duplicate create;
-    // user sees the error and can rename.
-    return primary;
-}
-//# sourceMappingURL=profileName.js.map

package/dist/profileName.js.map

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

package/dist/syncSessions.d.ts

@@ -1,84 +0,0 @@
-/**
- * Phase 2b — session post-processor.
- *
- * `nookplot-mcp sync-sessions` walks `~/.hermes/sessions/session_*.json`,
- * finds sessions we haven't processed yet, extracts findings + reasoning
- * traces heuristically, and POSTs each to the Phase 2c capture queue at
- * `/v1/me/captures`. Each POST goes through the same sybil gate +
- * ContentScanner + rate-limit that the realtime MCP tools already use —
- * this file is a thin driver, not a new write surface.
- *
- * Safety net positioning:
- *   - The MCP tools in Phase 2a run DURING the session; this subcommand
- *     runs AFTER. Together they ensure that even if the agent forgot to
- *     call `nookplot_capture_finding` during work, the synthesis it
- *     produced doesn't get lost.
- *   - Everything goes through the 24h review queue, so the user can
- *     still reject anything the heuristic misidentified as a finding.
- *   - Dedup is two-layered: `processed_sessions.json` skips whole
- *     sessions on the next run, and the gateway's UNIQUE (agent_address,
- *     kind, content_hash) index blocks exact-duplicate bodies across
- *     different sessions too.
- *
- * @module syncSessions
- */
-import type { NookplotCredentials } from "./auth.js";
-export interface SyncSessionsOptions {
-    /** Gateway URL. Defaults to $NOOKPLOT_GATEWAY_URL or the public gateway. */
-    gatewayUrl?: string;
-    /** Credentials (loaded from ~/.nookplot/credentials.json normally). */
-    credentials: NookplotCredentials;
-    /** If set, overrides the NOOKPLOT_AGENT_ADDRESS env var. */
-    scopedAgentAddress?: string;
-    /** Dry run — extract + report, but don't POST to the gateway. */
-    dryRun?: boolean;
-    /** Max sessions to process in this invocation. Default 10. */
-    limit?: number;
-    /** Only consider sessions modified after this time. */
-    since?: Date;
-    /** Re-process sessions marked as done. Item-level dedup still applies. */
-    force?: boolean;
-    /** Directory override for tests. Defaults to ~/.hermes/sessions. */
-    sessionsDir?: string;
-    /** State file path override for tests. */
-    statePath?: string;
-    /** Max ms per POST. */
-    timeoutMs?: number;
-    _fetch?: typeof fetch;
-    _now?: () => Date;
-}
-export interface SessionResult {
-    sessionId: string;
-    filePath: string;
-    /** 'processed' on success, 'skipped' if already done, 'failed' on fatal parse error. */
-    status: "processed" | "skipped" | "failed";
-    /** Items extracted (whether or not they posted successfully). */
-    extracted: number;
-    /** Items that successfully posted (or counted as duplicates). */
-    captured: number;
-    /** Per-item errors, if any. */
-    errors: string[];
-    /** Reason for skip, if status is 'skipped'. */
-    skipReason?: string;
-}
-export interface SyncSessionsResult {
-    /** Total sessions inspected on this run. */
-    inspected: number;
-    /** Sessions processed (extraction + POSTs attempted). */
-    processed: number;
-    /** Sessions skipped (already done or filtered by --since). */
-    skipped: number;
-    /** Sessions that failed to parse. */
-    failed: number;
-    /** Items captured into the review queue. */
-    capturesCreated: number;
-    /** Detailed per-session breakdown (for dry-run reporting). */
-    perSession: SessionResult[];
-}
-/**
- * Main entry point. Walks sessions, extracts, posts. Returns a summary
- * caller can print. Tests drive this directly with mocked `_fetch` +
- * `sessionsDir` + `statePath`.
- */
-export declare function syncSessions(opts: SyncSessionsOptions): Promise<SyncSessionsResult>;
-//# sourceMappingURL=syncSessions.d.ts.map

package/dist/syncSessions.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"syncSessions.d.ts","sourceRoot":"","sources":["../src/syncSessions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAKH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAiBrD,MAAM,WAAW,mBAAmB;IAClC,4EAA4E;IAC5E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,WAAW,EAAE,mBAAmB,CAAC;IACjC,4DAA4D;IAC5D,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iEAAiE;IACjE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,KAAK,CAAC,EAAE,IAAI,CAAC;IACb,0EAA0E;IAC1E,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uBAAuB;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,MAAM,CAAC,EAAE,OAAO,KAAK,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,IAAI,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,wFAAwF;IACxF,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC3C,iEAAiE;IACjE,SAAS,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,QAAQ,EAAE,MAAM,CAAC;IACjB,+BAA+B;IAC/B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,eAAe,EAAE,MAAM,CAAC;IACxB,8DAA8D;IAC9D,UAAU,EAAE,aAAa,EAAE,CAAC;CAC7B;AAqGD;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,kBAAkB,CAAC,CAiK7B"}

package/dist/syncSessions.js

@@ -1,260 +0,0 @@
-/**
- * Phase 2b — session post-processor.
- *
- * `nookplot-mcp sync-sessions` walks `~/.hermes/sessions/session_*.json`,
- * finds sessions we haven't processed yet, extracts findings + reasoning
- * traces heuristically, and POSTs each to the Phase 2c capture queue at
- * `/v1/me/captures`. Each POST goes through the same sybil gate +
- * ContentScanner + rate-limit that the realtime MCP tools already use —
- * this file is a thin driver, not a new write surface.
- *
- * Safety net positioning:
- *   - The MCP tools in Phase 2a run DURING the session; this subcommand
- *     runs AFTER. Together they ensure that even if the agent forgot to
- *     call `nookplot_capture_finding` during work, the synthesis it
- *     produced doesn't get lost.
- *   - Everything goes through the 24h review queue, so the user can
- *     still reject anything the heuristic misidentified as a finding.
- *   - Dedup is two-layered: `processed_sessions.json` skips whole
- *     sessions on the next run, and the gateway's UNIQUE (agent_address,
- *     kind, content_hash) index blocks exact-duplicate bodies across
- *     different sessions too.
- *
- * @module syncSessions
- */
-import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
-import { homedir } from "node:os";
-import { join } from "node:path";
-import { extractFromSession } from "./syncSessionsExtractor.js";
-import { defaultStatePath, isSessionProcessed, isItemAlreadyCaptured, loadState, markSessionProcessed, saveState, } from "./syncSessionsState.js";
-// ---------------------------------------------------------------------------
-//  File discovery
-// ---------------------------------------------------------------------------
-/**
- * Default sessions directory. Tests override via `opts.sessionsDir`; in
- * production this is where Hermes v0.8.0 writes session JSONs.
- */
-function defaultSessionsDir() {
-    return join(homedir(), ".hermes", "sessions");
-}
-/**
- * Session files are named `session_<YYYYMMDD>_<HHMMSS>_<hex>.json`.
- * We ignore `request_dump_*.json` (Hermes's per-request snapshots) since
- * those are noisy duplicates of the session data with much more tool
- * metadata — we only want the clean session stream.
- */
-function isSessionFile(filename) {
-    return /^session_\d{8}_\d{6}_[a-f0-9]+\.json$/.test(filename);
-}
-/**
- * Extract a stable session id from a Hermes session file. We prefer the
- * in-file `session_id` (which Hermes guarantees unique per chat) but
- * fall back to the filename-derived id if the file is malformed.
- */
-function sessionIdOf(session, filename) {
-    if (typeof session.session_id === "string" && session.session_id.length > 0) {
-        return session.session_id;
-    }
-    // filename is `session_<id>.json`, strip the prefix + suffix.
-    return filename.replace(/^session_/, "").replace(/\.json$/, "");
-}
-// ---------------------------------------------------------------------------
-//  Gateway POST
-// ---------------------------------------------------------------------------
-/**
- * Send one extracted item to the gateway's capture queue. Returns the
- * queue row id on success, an error string on failure.
- *
- * We deliberately tolerate the gateway responding with a "duplicate"
- * path — `POST /v1/me/captures` is idempotent per the Phase 2c design
- * (same content-hash returns the existing row), so a re-run of
- * `sync-sessions` that hits an already-captured item is NOT an error.
- */
-async function postCapture(opts, gatewayUrl, item, sessionId, agentAddress) {
-    const fetchFn = opts._fetch ?? fetch;
-    const timeoutMs = opts.timeoutMs ?? 15_000;
-    const controller = new AbortController();
-    const timer = setTimeout(() => controller.abort(), timeoutMs);
-    try {
-        const res = await fetchFn(`${gatewayUrl.replace(/\/$/, "")}/v1/me/captures`, {
-            method: "POST",
-            headers: {
-                "Content-Type": "application/json",
-                Authorization: `Bearer ${opts.credentials.apiKey}`,
-            },
-            body: JSON.stringify({
-                kind: item.kind,
-                payload: item.payload,
-                agentAddress,
-                sourceSessionId: sessionId,
-            }),
-            signal: controller.signal,
-        });
-        if (!res.ok) {
-            const body = await res.text().catch(() => "");
-            return {
-                error: `HTTP ${res.status}: ${body.slice(0, 200)}`,
-            };
-        }
-        const parsed = (await res.json());
-        if (typeof parsed.id !== "string") {
-            return { error: "Gateway response missing `id` field" };
-        }
-        return { captureId: parsed.id };
-    }
-    catch (err) {
-        return { error: err instanceof Error ? err.message : String(err) };
-    }
-    finally {
-        clearTimeout(timer);
-    }
-}
-// ---------------------------------------------------------------------------
-//  Orchestration
-// ---------------------------------------------------------------------------
-/**
- * Main entry point. Walks sessions, extracts, posts. Returns a summary
- * caller can print. Tests drive this directly with mocked `_fetch` +
- * `sessionsDir` + `statePath`.
- */
-export async function syncSessions(opts) {
-    const gatewayUrl = opts.gatewayUrl ??
-        process.env.NOOKPLOT_GATEWAY_URL ??
-        "https://gateway.nookplot.com";
-    const sessionsDir = opts.sessionsDir ?? defaultSessionsDir();
-    const statePath = opts.statePath ?? defaultStatePath();
-    const limit = opts.limit ?? 10;
-    const scopedAgentAddress = opts.scopedAgentAddress ?? process.env.NOOKPLOT_AGENT_ADDRESS ?? undefined;
-    const result = {
-        inspected: 0,
-        processed: 0,
-        skipped: 0,
-        failed: 0,
-        capturesCreated: 0,
-        perSession: [],
-    };
-    if (!existsSync(sessionsDir)) {
-        // Fresh install — no sessions yet. Not an error, just nothing to do.
-        return result;
-    }
-    let state = loadState(statePath);
-    // Sort files oldest → newest so resumed runs process in chronological
-    // order, matching the natural "replay of the user's work" semantics.
-    const files = readdirSync(sessionsDir)
-        .filter(isSessionFile)
-        .map((name) => {
-        const full = join(sessionsDir, name);
-        const stat = statSync(full);
-        return { name, full, mtimeMs: stat.mtimeMs };
-    })
-        .sort((a, b) => a.mtimeMs - b.mtimeMs);
-    for (const file of files) {
-        if (result.processed >= limit)
-            break;
-        result.inspected += 1;
-        // --since filter: skip anything older than the cutoff.
-        if (opts.since && file.mtimeMs < opts.since.getTime()) {
-            result.skipped += 1;
-            result.perSession.push({
-                sessionId: file.name,
-                filePath: file.full,
-                status: "skipped",
-                extracted: 0,
-                captured: 0,
-                errors: [],
-                skipReason: "older than --since cutoff",
-            });
-            continue;
-        }
-        // Parse the session.
-        let session;
-        try {
-            const raw = readFileSync(file.full, "utf8");
-            session = JSON.parse(raw);
-        }
-        catch (err) {
-            result.failed += 1;
-            result.perSession.push({
-                sessionId: file.name,
-                filePath: file.full,
-                status: "failed",
-                extracted: 0,
-                captured: 0,
-                errors: [
-                    `parse: ${err instanceof Error ? err.message : String(err)}`,
-                ],
-            });
-            continue;
-        }
-        const sid = sessionIdOf(session, file.name);
-        // Already-processed fast path. --force bypasses this but still dedups
-        // on the item level below, so we never double-POST known items.
-        if (!opts.force && isSessionProcessed(state, sid)) {
-            result.skipped += 1;
-            result.perSession.push({
-                sessionId: sid,
-                filePath: file.full,
-                status: "skipped",
-                extracted: 0,
-                captured: 0,
-                errors: [],
-                skipReason: "already processed (use --force to reprocess)",
-            });
-            continue;
-        }
-        const extracted = extractFromSession(session);
-        const itemResults = [];
-        const errors = [];
-        let captured = 0;
-        for (const item of extracted) {
-            // Item-level dedup for --force re-runs: if we know the gateway
-            // already has this hash from a prior pass, skip the POST entirely.
-            if (opts.force && isItemAlreadyCaptured(state, sid, item.hash)) {
-                captured += 1; // count it as already-captured for the summary
-                continue;
-            }
-            if (opts.dryRun) {
-                itemResults.push({ hash: item.hash, kind: item.kind });
-                captured += 1;
-                continue;
-            }
-            const postResult = await postCapture(opts, gatewayUrl, item, sid, scopedAgentAddress);
-            if ("captureId" in postResult) {
-                itemResults.push({
-                    hash: item.hash,
-                    kind: item.kind,
-                    captureId: postResult.captureId,
-                });
-                captured += 1;
-            }
-            else {
-                itemResults.push({
-                    hash: item.hash,
-                    kind: item.kind,
-                    error: postResult.error,
-                });
-                errors.push(`${item.kind}: ${postResult.error}`);
-            }
-        }
-        // Record this session (successes + failures) so we don't re-process.
-        // Failures are still recorded: on the next run we skip the whole
-        // session unless --force is used. If the user wants to retry just
-        // the failed items they run with --force.
-        if (!opts.dryRun) {
-            state = markSessionProcessed(state, sid, itemResults);
-            saveState(state, statePath);
-        }
-        result.processed += 1;
-        result.capturesCreated += captured;
-        result.perSession.push({
-            sessionId: sid,
-            filePath: file.full,
-            status: "processed",
-            extracted: extracted.length,
-            captured,
-            errors,
-        });
-    }
-    return result;
-}
-//# sourceMappingURL=syncSessions.js.map

package/dist/syncSessions.js.map

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