teamshare-bridge 0.26.25 → 0.27.0

package/dist/lib/git/pr-token.js.map

@@ -1 +1 @@
-{"version":3,"file":"pr-token.js","sourceRoot":"","sources":["../../../src/lib/git/pr-token.ts"],"names":[],"mappings":";;AA4CA,kCAcC;AAOD,0CA+BC;AAOD,wCAaC;AApHD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,2DAAkD;AAClD,8CAAqD;AACrD,yCAAyC;AAEzC;;;;;;;GAOG;AACH,MAAM,oBAAoB,GACxB,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,+BAA+B,CAAC;AASnE,gFAAgF;AAChF,SAAgB,WAAW;IACzB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAA,iCAAY,EAAC,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE;YAChD,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;YACnC,WAAW,EAAE,IAAI;YACjB,GAAG,EAAE,IAAA,uBAAe,GAAE;YACtB,OAAO,EAAE,MAAM;SAChB,CAAC,CAAC;QACH,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QACzB,OAAO,KAAK,IAAI,IAAI,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;GAIG;AACI,KAAK,UAAU,eAAe,CAAC,IAKrC;IACC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;IAC1D,IAAI,CAAC,SAAS,IAAI,CAAC,SAAS,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACrD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CACrB,GAAG,CAAC,UAAU,IAAI,oBAAoB,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,4BAA4B,EACvF;YACE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,WAAW,EAAE,MAAM;aACpB;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;YACvD,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC;SACpC,CACF,CAAC;QACF,MAAM,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAGvC,CAAC;QACT,MAAM,KAAK,GAAG,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC;QAC/B,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,GAAG,EAAE,OAAO,KAAK,IAAI,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QAC5D,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;GAIG;AACI,KAAK,UAAU,cAAc,CAAC,IAKpC;IACC,MAAM,KAAK,GAAG,IAAA,sBAAW,EAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC1C,IAAI,KAAK;QAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IACtD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;IAChE,IAAI,GAAG;QAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAC9C,MAAM,GAAG,GAAG,WAAW,EAAE,CAAC;IAC1B,IAAI,GAAG;QAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IACjD,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC"}
+{"version":3,"file":"pr-token.js","sourceRoot":"","sources":["../../../src/lib/git/pr-token.ts"],"names":[],"mappings":"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"}

package/dist/lib/run-report.d.ts

@@ -1,37 +1,64 @@
 import { TeamshareApi } from './api';
 import type { StashResult } from './git/git-runner';
+export type RunReportKind = 'run' | 'build' | 'orchestrator' | 'plan' | 'tool' | 'workflow';
 export interface RunReportInput {
     api: TeamshareApi;
     projectId: string;
-    taskId: string;
+    /** Task-bound reports (every kind except a detached tool run). */
+    taskId?: string;
+    toolRunId?: string;
+    workflowRunId?: string;
     agentId: string;
     taskTitle: string;
-    /** 'orchestrator' = required per policy; 'build' = advisory. */
-    kind: 'orchestrator' | 'build';
+    kind: RunReportKind;
+    /** Per-run identity (`<taskId>-<session8>`, tool `runId`, …). */
+    runKey: string;
     status: string;
+    /** Fallback narrative when the agent wrote no report file. */
     summary: string;
-    /** Extra fact lines (branch, worktree, exit codes, attempts, git outcome). */
+    /** Per-run agent file (`~/.teamshare/reports/<runKey>.md`). */
+    reportPath: string;
+    /** Fact lines about the work (branch, worktree, attempts, git outcome). */
     details?: string[];
+    /** Verification lines (checklist/subtask counts, finalize outcome). */
+    verification?: string[];
+    notes?: string[];
     gitLine?: string;
-    /** Stash results from git-runner — displayed in ## Git Stash section. */
+    branch?: string;
+    sha?: string;
+    prUrl?: string;
+    changedPaths?: string[];
+    workingDir?: string;
+    startedAt?: string;
+    finishedAt?: string;
+    /** Stash results from git-runner — surfaced in verification. */
     stashResults?: StashResult[];
     log?: (text: string, level?: 'stdout' | 'stderr') => void;
 }
-/** Per-task report path: ~/.teamshare/reports/<taskId>.md */
-export declare function getReportPath(taskId: string): string;
+/**
+ * Per-run report path: `~/.teamshare/reports/<runKey>.md`. Per RUN, not per
+ * task — a stale file from a previous run must never read as this run's
+ * narrative.
+ */
+export declare function getReportPath(runKey: string): string;
+/** One block every run prompt carries, so all harnesses file the same way. */
+export declare function runReportBlock(reportPath: string): string;
 /** Success, or the final sanitized error so callers can surface WHY the
- *  report never landed in Documents (previously console-only). */
+ *  report never landed (previously console-only). */
 export type RunReportResult = {
     ok: true;
     id: string;
     name: string;
+    documentUrl: string;
 } | {
     ok: false;
     error: string;
 };
 /**
- * Reads the agent-written report.md (or falls back to a template) and
- * saves it as a note document. Never throws - orchestrator callers treat
- * `{ ok: false }` as mandatory-failure and post the reason to the task.
+ * Reads this run's narrative file and saves the composed report via
+ * `POST /run-reports` (falls back to a direct note on older backends).
+ * Never throws; `{ ok: false }` is advisory — completed work stays complete.
  */
 export declare function saveRunReport(input: RunReportInput): Promise<RunReportResult>;
+/** Best-effort cleanup of this run's narrative file (never throws). */
+export declare function clearReportFile(reportPath: string): void;

package/dist/lib/run-report.js

@@ -1,57 +1,58 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getReportPath = getReportPath;
+exports.runReportBlock = runReportBlock;
 exports.saveRunReport = saveRunReport;
+exports.clearReportFile = clearReportFile;
 /**
- * Run reports (documents-driven development, IMP-600): after every
- * ORCHESTRATOR run the agent writes a report to `~/.teamshare/reports/<taskId>.md`
- * and this module uploads it to the project's Documents tab as a note via
- * POST /documents/note - virtual folder `agents/<agent>/tasks/<taskId>`,
- * one note per run. Build-mode sessions use the same helper best-effort
- * (advised, never fatal).
+ * Per-run reports (2026-10): EVERY completed run lands ONE detailed report.
  *
- * The agent writes the report during its session (no separate LLM call).
- * If no report file is found, a deterministic fallback template is used.
+ * Coverage: task (`run`), build queue (`build`), orchestrator worker
+ * (`orchestrator`), plan passes (`plan`), tool/research runs incl. QA
+ * (`tool`) and workflow runs (`workflow`). Chat / doc-reply / board-reply
+ * sessions are conversations, not runs, and file no report.
  *
- * Reports are written to a per-task path (`~/.teamshare/reports/<taskId>.md`)
- * to avoid collisions when multiple agents work in the same project folder.
+ * One report per run: the caller passes a per-run `runKey`
+ * (`<taskId>-<session8>` or the run id) and a per-run `reportPath`. The
+ * backend names the document with a hash of `runKey`, so a retry writes a
+ * NEW document instead of overwriting the previous run's report. Only
+ * COMPLETED runs call this — paused, failed and stopped runs file nothing.
  *
- * Guarantees: this function NEVER throws - callers decide whether a null
- * return is mandatory-failure (orchestrator) or ignorable (build).
+ * The agent writes its narrative during the session (no separate LLM call);
+ * when the file is missing the caller's summary is the narrative. The
+ * backend composes the full report (Summary, What changed, Where to find
+ * it, Verification, Notes & risks, Run facts) and attaches it to the task.
+ *
+ * Guarantees: this function NEVER throws — a report must never fail a run.
  */
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const node_os_1 = require("node:os");
 const config_1 = require("./config");
 const git_runner_1 = require("./git/git-runner");
-/** Folder per CDD convention: agents/<slug>/tasks/<taskId>. */
-function reportFolder(agentId, taskId) {
-    return `agents/${agentId.slice(0, 8).toLowerCase()}/tasks/${taskId}`;
-}
-function reportName(taskTitle) {
-    const date = new Date().toISOString().slice(0, 10);
-    const clean = taskTitle
-        .replace(/[\\/:*?"<>|]+/g, '-')
-        .replace(/\s+/g, ' ')
-        .trim()
-        .slice(0, 80);
-    return `${date} ${clean} — run report.md`;
-}
-function ensureMdExtension(name) {
-    return /\.(md|markdown|txt)$/i.test(name) ? name : `${name}.md`;
-}
-/** Per-task report path: ~/.teamshare/reports/<taskId>.md */
-function getReportPath(taskId) {
+/**
+ * Per-run report path: `~/.teamshare/reports/<runKey>.md`. Per RUN, not per
+ * task — a stale file from a previous run must never read as this run's
+ * narrative.
+ */
+function getReportPath(runKey) {
     const dir = (0, node_path_1.join)((0, node_os_1.homedir)(), '.teamshare', 'reports');
     (0, node_fs_1.mkdirSync)(dir, { recursive: true });
-    return (0, node_path_1.join)(dir, `${taskId}.md`);
+    const safe = runKey.replace(/[^a-zA-Z0-9-_]/g, '-').slice(0, 120);
+    return (0, node_path_1.join)(dir, `${safe || 'run'}.md`);
 }
-/** Read agent-written report from the per-task path, or return null. */
-function readAgentReport(taskId) {
-    const reportPath = getReportPath(taskId);
-    if (!(0, node_fs_1.existsSync)(reportPath))
-        return null;
+/** One block every run prompt carries, so all harnesses file the same way. */
+function runReportBlock(reportPath) {
+    return (`When done, write a run report narrative to \`${reportPath}\` with sections: ` +
+        `Summary, What Changed, Verification, Notes & Risks. Use markdown headings and short bullets. ` +
+        `Say WHERE the work went: files/areas touched, branch, and the documents/boards you created or updated. ` +
+        `The runner uploads it as the run report — do not create the report document yourself.`);
+}
+/** Read the agent-written narrative for THIS run, or return null. */
+function readAgentReport(reportPath) {
     try {
+        if (!(0, node_fs_1.existsSync)(reportPath))
+            return null;
         const content = (0, node_fs_1.readFileSync)(reportPath, 'utf8').trim();
         return content.length > 0 ? content : null;
     }
@@ -59,67 +60,115 @@ function readAgentReport(taskId) {
         return null;
     }
 }
-/** Deterministic fallback when no agent-written report exists. */
-function fallbackReport(input) {
-    return [
-        `# ${input.taskTitle} — run report`,
-        '',
-        '## Summary',
-        input.summary || '(no session summary captured)',
-        '',
-        '## What Changed',
-        '_Session-level detail lives in the task comments and the live console._',
-        '',
-        '## Verification',
-        `- Final status: ${input.status}`,
-        ...(input.details ?? []).map((d) => `- ${d}`),
-        '',
-        '## Git',
-        input.gitLine || '_No git operations recorded by the runner._',
-        '',
-        ...(input.stashResults?.length
-            ? [(0, git_runner_1.formatStashSummary)(input.stashResults), '']
-            : []),
-        '## Notes & Risks',
-        `_Auto-generated fallback report (${input.kind}); agent-written report not found._`,
-        '',
-    ].join('\n');
+function isNotFoundError(err) {
+    // ApiError carries the HTTP status; older fetch-style errors only have
+    // text ("Request failed 404 …", Nest's "Cannot POST /run-reports").
+    const status = err?.status;
+    if (status === 404)
+        return true;
+    return / 404\b|Not Found|Cannot POST \/run-reports/i.test((0, config_1.msg)(err));
 }
 /**
- * Reads the agent-written report.md (or falls back to a template) and
- * saves it as a note document. Never throws - orchestrator callers treat
- * `{ ok: false }` as mandatory-failure and post the reason to the task.
+ * Reads this run's narrative file and saves the composed report via
+ * `POST /run-reports` (falls back to a direct note on older backends).
+ * Never throws; `{ ok: false }` is advisory — completed work stays complete.
  */
 async function saveRunReport(input) {
     const log = input.log ?? (() => { });
-    // Prefer the agent-written report from the per-task path.
-    let content = readAgentReport(input.taskId);
-    if (content) {
-        log('[report] using agent-written report from ~/.teamshare/reports/');
+    const startedAt = input.startedAt ?? new Date().toISOString();
+    const narrative = readAgentReport(input.reportPath);
+    if (narrative) {
+        log('[report] using agent-written narrative for this run');
     }
     else {
-        log('[report] no report found at ~/.teamshare/reports/, using fallback template');
-        content = fallbackReport(input);
+        log('[report] no narrative file for this run, using session summary');
     }
-    // Orchestrator runs MUST land a document - retry the save once.
-    const attempts = input.kind === 'orchestrator' ? 2 : 1;
-    let lastError = 'unknown error';
-    for (let attempt = 1; attempt <= attempts; attempt += 1) {
-        try {
-            const doc = await input.api.createNoteDocument({
-                projectId: input.projectId,
-                name: ensureMdExtension(reportName(input.taskTitle)),
-                content,
-                folderPath: reportFolder(input.agentId, input.taskId),
-            });
-            log(`[report] saved "${doc.name}" under agents/${input.agentId.slice(0, 8).toLowerCase()}/tasks/${input.taskId}`);
-            return { ok: true, id: doc.id, name: doc.name };
-        }
-        catch (err) {
-            lastError = (0, config_1.msg)(err);
-            log(`[report] save failed (attempt ${attempt}/${attempts}): ${lastError}`, 'stderr');
+    const workedOn = [...(input.details ?? [])];
+    if (input.workingDir)
+        workedOn.push(`Working folder: ${input.workingDir}`);
+    const verification = [...(input.verification ?? [])];
+    if (input.stashResults?.length) {
+        verification.push((0, git_runner_1.formatStashSummary)(input.stashResults));
+    }
+    const payload = {
+        taskId: input.taskId,
+        toolRunId: input.toolRunId,
+        workflowRunId: input.workflowRunId,
+        projectId: input.projectId,
+        mode: input.kind,
+        runKey: input.runKey,
+        status: input.status,
+        title: input.taskTitle,
+        summary: input.summary,
+        narrative: narrative ?? undefined,
+        workedOn: workedOn.length ? workedOn : undefined,
+        changedPaths: input.changedPaths?.length
+            ? input.changedPaths.slice(0, 100)
+            : undefined,
+        verification: verification.length ? verification : undefined,
+        notes: input.notes?.length ? input.notes : undefined,
+        git: {
+            branch: input.branch,
+            sha: input.sha,
+            prUrl: input.prUrl,
+            gitLine: input.gitLine,
+        },
+        startedAt,
+        finishedAt: input.finishedAt ?? new Date().toISOString(),
+    };
+    try {
+        const doc = await input.api.createRunReport(payload);
+        log(`[report] saved "${doc.name}" (${doc.documentUrl})`);
+        return {
+            ok: true,
+            id: doc.id,
+            name: doc.name,
+            documentUrl: doc.documentUrl,
+        };
+    }
+    catch (err) {
+        if (!isNotFoundError(err)) {
+            const error = (0, config_1.msg)(err).slice(0, 300);
+            log(`[report] save failed: ${error}`, 'stderr');
+            return { ok: false, error };
         }
     }
-    return { ok: false, error: lastError.slice(0, 300) };
+    // Older backend without POST /run-reports: write the note directly into the
+    // same per-task folder so the report still lands where humans look.
+    try {
+        const folderPath = input.taskId
+            ? `agents/${input.agentId.slice(0, 8).toLowerCase()}/tasks/${input.taskId}`
+            : `agents/${input.agentId.slice(0, 8).toLowerCase()}`;
+        const date = new Date().toISOString().slice(0, 10);
+        const clean = input.taskTitle
+            .replace(/[\\/:*?"<>|]+/g, '-')
+            .replace(/\s+/g, ' ')
+            .trim()
+            .slice(0, 70);
+        const doc = await input.api.createNoteDocument({
+            projectId: input.projectId,
+            name: `${date} ${clean} — ${input.kind} run report.md`,
+            content: [narrative ?? input.summary, '', ...(verification ?? [])].join('\n'),
+            folderPath,
+        });
+        log(`[report] saved "${doc.name}" via legacy note path`);
+        return { ok: true, id: doc.id, name: doc.name, documentUrl: '' };
+    }
+    catch (err) {
+        const error = (0, config_1.msg)(err).slice(0, 300);
+        log(`[report] save failed: ${error}`, 'stderr');
+        return { ok: false, error };
+    }
+}
+/** Best-effort cleanup of this run's narrative file (never throws). */
+function clearReportFile(reportPath) {
+    try {
+        const { unlinkSync } = require('node:fs');
+        if ((0, node_fs_1.existsSync)(reportPath))
+            unlinkSync(reportPath);
+    }
+    catch {
+        /* best-effort */
+    }
 }
 //# sourceMappingURL=run-report.js.map

package/dist/lib/run-report.js.map

@@ -1 +1 @@
-{"version":3,"file":"run-report.js","sourceRoot":"","sources":["../../src/lib/run-report.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"run-report.js","sourceRoot":"","sources":["../../src/lib/run-report.ts"],"names":[],"mappings":";;AAyEA,sCAKC;AAGD,wCAOC;AAgCD,sCA2FC;AAGD,0CAOC;AA7ND;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qCAA8D;AAC9D,yCAAiC;AACjC,qCAAkC;AAElC,qCAA+B;AAG/B,iDAAsD;AAwCtD;;;;GAIG;AACH,SAAgB,aAAa,CAAC,MAAc;IAC1C,MAAM,GAAG,GAAG,IAAA,gBAAI,EAAC,IAAA,iBAAO,GAAE,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC;IACrD,IAAA,mBAAS,EAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAClE,OAAO,IAAA,gBAAI,EAAC,GAAG,EAAE,GAAG,IAAI,IAAI,KAAK,KAAK,CAAC,CAAC;AAC1C,CAAC;AAED,8EAA8E;AAC9E,SAAgB,cAAc,CAAC,UAAkB;IAC/C,OAAO,CACL,gDAAgD,UAAU,oBAAoB;QAC9E,+FAA+F;QAC/F,yGAAyG;QACzG,uFAAuF,CACxF,CAAC;AACJ,CAAC;AAED,qEAAqE;AACrE,SAAS,eAAe,CAAC,UAAkB;IACzC,IAAI,CAAC;QACH,IAAI,CAAC,IAAA,oBAAU,EAAC,UAAU,CAAC;YAAE,OAAO,IAAI,CAAC;QACzC,MAAM,OAAO,GAAG,IAAA,sBAAY,EAAC,UAAU,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QACxD,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAQD,SAAS,eAAe,CAAC,GAAY;IACnC,uEAAuE;IACvE,oEAAoE;IACpE,MAAM,MAAM,GAAI,GAAmC,EAAE,MAAM,CAAC;IAC5D,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IAChC,OAAO,6CAA6C,CAAC,IAAI,CAAC,IAAA,YAAG,EAAC,GAAG,CAAC,CAAC,CAAC;AACtE,CAAC;AAED;;;;GAIG;AACI,KAAK,UAAU,aAAa,CACjC,KAAqB;IAErB,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACpC,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAE9D,MAAM,SAAS,GAAG,eAAe,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACpD,IAAI,SAAS,EAAE,CAAC;QACd,GAAG,CAAC,qDAAqD,CAAC,CAAC;IAC7D,CAAC;SAAM,CAAC;QACN,GAAG,CAAC,gEAAgE,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;IAC5C,IAAI,KAAK,CAAC,UAAU;QAAE,QAAQ,CAAC,IAAI,CAAC,mBAAmB,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;IAC3E,MAAM,YAAY,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,CAAC;IACrD,IAAI,KAAK,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC;QAC/B,YAAY,CAAC,IAAI,CAAC,IAAA,+BAAkB,EAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,OAAO,GAAG;QACd,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,KAAK,EAAE,KAAK,CAAC,SAAS;QACtB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,SAAS,EAAE,SAAS,IAAI,SAAS;QACjC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;QAChD,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE,MAAM;YACtC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;YAClC,CAAC,CAAC,SAAS;QACb,YAAY,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS;QAC5D,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;QACpD,GAAG,EAAE;YACH,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB;QACD,SAAS;QACT,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACzD,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QACrD,GAAG,CAAC,mBAAmB,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,WAAW,GAAG,CAAC,CAAC;QACzD,OAAO;YACL,EAAE,EAAE,IAAI;YACR,EAAE,EAAE,GAAG,CAAC,EAAE;YACV,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,WAAW,EAAE,GAAG,CAAC,WAAW;SAC7B,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,KAAK,GAAG,IAAA,YAAG,EAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YACrC,GAAG,CAAC,yBAAyB,KAAK,EAAE,EAAE,QAAQ,CAAC,CAAC;YAChD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,4EAA4E;IAC5E,oEAAoE;IACpE,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM;YAC7B,CAAC,CAAC,UAAU,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,UAAU,KAAK,CAAC,MAAM,EAAE;YAC3E,CAAC,CAAC,UAAU,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;QACxD,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACnD,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS;aAC1B,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC;aAC9B,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;aACpB,IAAI,EAAE;aACN,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAChB,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,kBAAkB,CAAC;YAC7C,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,IAAI,EAAE,GAAG,IAAI,IAAI,KAAK,MAAM,KAAK,CAAC,IAAI,gBAAgB;YACtD,OAAO,EAAE,CAAC,SAAS,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CACrE,IAAI,CACL;YACD,UAAU;SACX,CAAC,CAAC;QACH,GAAG,CAAC,mBAAmB,GAAG,CAAC,IAAI,wBAAwB,CAAC,CAAC;QACzD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;IACnE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,KAAK,GAAG,IAAA,YAAG,EAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACrC,GAAG,CAAC,yBAAyB,KAAK,EAAE,EAAE,QAAQ,CAAC,CAAC;QAChD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IAC9B,CAAC;AACH,CAAC;AAED,uEAAuE;AACvE,SAAgB,eAAe,CAAC,UAAkB;IAChD,IAAI,CAAC;QACH,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;QAC1C,IAAI,IAAA,oBAAU,EAAC,UAAU,CAAC;YAAE,UAAU,CAAC,UAAU,CAAC,CAAC;IACrD,CAAC;IAAC,MAAM,CAAC;QACP,iBAAiB;IACnB,CAAC;AACH,CAAC"}

package/dist/lib/tools/pptx-deck.d.ts

@@ -1,5 +1,95 @@
 import type { ToolModule, ToolResult } from './runner';
+export declare const KNOWN_LAYOUTS: readonly ["title", "agenda", "section", "bullets", "statement", "two-column", "cards", "stats", "timeline", "quote", "table", "closing", "sources"];
+export type DeckLayout = (typeof KNOWN_LAYOUTS)[number];
+export type Density = 'airy' | 'normal' | 'compact';
+export interface DeckSlide {
+    layout: string;
+    title?: string;
+    subtitle?: string;
+    bullets?: unknown;
+    columns?: unknown;
+    cards?: unknown;
+    stats?: unknown;
+    rows?: unknown;
+    quote?: unknown;
+    notes?: unknown;
+}
+export interface DeckSpec {
+    title?: string;
+    slides: DeckSlide[];
+}
+export interface DeckTokens {
+    accent: string;
+    background: string;
+    surface: string;
+    textColor: string;
+    bodyFont: string;
+    headingFont: string;
+    coverStyle: string;
+    titleStyle: string;
+    footerStyle: string;
+    cornerStyle: string;
+    density: Density;
+}
+export interface TemplateEntry {
+    id: string;
+    label?: string;
+    summary?: string;
+    preview?: Partial<Record<keyof DeckTokens, string>>;
+}
+/** Built-in corporate-equivalent defaults (used only when the mirror file is unreadable). */
+export declare const FALLBACK_TOKENS: DeckTokens;
+/** Per-density content budgets. Exported for tests. */
+export declare const DENSITY_CAPS: Record<Density, {
+    maxBullets: number;
+    maxWords: number;
+}>;
+/**
+ * Load the template mirror at runtime (never statically imported: tsc does
+ * not emit JSON assets into dist, so a static import would break at runtime).
+ * Returns null when the file cannot be found or parsed.
+ */
+export declare function loadTemplateMirror(): {
+    templates: TemplateEntry[];
+} | null;
+/** Resolve template tokens: mirror lookup + accentColor/density overrides. */
+export declare function resolveDeckTokens(params: Record<string, unknown>): {
+    tokens: DeckTokens;
+    templateId: string;
+    warnings: string[];
+};
+/** Parse deckJson (text or object). Throws on invalid/empty specs. */
+export declare function parseDeckSpec(raw: unknown): DeckSpec;
+export interface PlannedSlide {
+    index: number;
+    /** Effective layout after degrading unknowns to bullets. */
+    layout: DeckLayout;
+    /** Original layout string when it was degraded. */
+    degradedFrom?: string;
+    titleSize: number;
+    bodySize: number;
+    columns: number;
+    bullets: string[];
+}
+/**
+ * Pure layout planner: per-slide sizes/spacing/columns from density + aspect.
+ * No pptxgenjs calls — safe to unit-test.
+ */
+export declare function planDeck(spec: DeckSpec, opts: {
+    density: Density;
+    aspect: '16:9' | '4:3';
+}): PlannedSlide[];
 export declare class PptxDeckTool implements ToolModule {
     key: string;
     run(params: Record<string, unknown>): Promise<ToolResult>;
+    private inferTitle;
+    private firstBullets;
+    private coerceColumns;
+    private coerceCards;
+    private coerceStats;
+    private coerceTimeline;
+    private coerceQuote;
+    private coerceTableRows;
+    private buildSpeakerNotes;
+    private runLegacy;
 }