@cohortapp/agent-sdk 2.3.0

package/scripts/pdf-generation/build-document.mjs

@@ -0,0 +1,247 @@
+#!/usr/bin/env node
+
+/**
+ * PDF Document Generator for Northwind CEO Brain
+ *
+ * Converts Markdown documents to branded PDFs using Pandoc + XeLaTeX.
+ * Ported from ~/innovation-lab book generation pipeline.
+ *
+ * Usage:
+ *   node scripts/pdf-generation/build-document.mjs --input <markdown-file> [--template <template-name>] [--output <pdf-path>]
+ *
+ * Templates:
+ *   corporate-letter  — Standard A4 corporate correspondence (default)
+ *   board-pack        — Board materials with cover page and TOC
+ *   investor-letter   — Investor communications on branded letterhead
+ *   memo              — Internal memos and briefs
+ */
+
+import { execaCommand } from "execa";
+import { existsSync, readFileSync } from "fs";
+import fs from "fs/promises";
+import path from "path";
+import { fileURLToPath } from "url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const ROOT = process.env.AGENT_DIR || path.resolve(__dirname, "../..");
+
+// Load agent identity once so --author defaults to the running agent.
+let _agent = null;
+function loadAgent() {
+  if (_agent) return _agent;
+  try {
+    _agent = JSON.parse(readFileSync(path.join(ROOT, "config/agent.json"), "utf-8"));
+  } catch {
+    _agent = { fullName: "Agent", title: "" };
+  }
+  return _agent;
+}
+function defaultAuthor() {
+  const a = loadAgent();
+  return a.title ? `${a.fullName}, ${a.title}` : a.fullName;
+}
+
+const TEMPLATES_DIR = path.join(__dirname, "templates");
+// xelatex location: env override, otherwise let PATH resolve.
+// (Hardcoded per-user TinyTeX paths broke portability — agents now rely on
+// `which xelatex` resolution at exec time, with XELATEX_PATH as escape hatch.)
+const XELATEX_PATH = process.env.XELATEX_PATH || "xelatex";
+
+// Template configurations
+const TEMPLATES = {
+  "corporate-letter": {
+    file: "corporate-letter.latex",
+    description: "Standard A4 corporate correspondence",
+  },
+  "board-pack": {
+    file: "board-pack.latex",
+    description: "Board materials with cover page and TOC",
+  },
+  "investor-letter": {
+    file: "corporate-letter.latex", // Uses corporate-letter with different metadata
+    description: "Investor communications on branded letterhead",
+  },
+  memo: {
+    file: "memo.latex",
+    description: "Internal memos and briefs",
+  },
+};
+
+function parseArgs() {
+  const args = process.argv.slice(2);
+  const config = {
+    input: null,
+    template: "memo",
+    output: null,
+    title: null,
+    author: defaultAuthor(),
+    date: new Date().toISOString().split("T")[0],
+  };
+
+  for (let i = 0; i < args.length; i++) {
+    switch (args[i]) {
+      case "--input":
+      case "-i":
+        config.input = args[++i];
+        break;
+      case "--template":
+      case "-t":
+        config.template = args[++i];
+        break;
+      case "--output":
+      case "-o":
+        config.output = args[++i];
+        break;
+      case "--title":
+        config.title = args[++i];
+        break;
+      case "--author":
+        config.author = args[++i];
+        break;
+      case "--date":
+        config.date = args[++i];
+        break;
+      case "--help":
+      case "-h":
+        printHelp();
+        process.exit(0);
+    }
+  }
+
+  return config;
+}
+
+function printHelp() {
+  console.log(`
+Northwind PDF Document Generator
+
+Usage:
+  node build-document.mjs --input <file.md> [options]
+
+Options:
+  --input, -i      Input Markdown file (required)
+  --template, -t   Template name (default: memo)
+  --output, -o     Output PDF path (default: same dir as input)
+  --title          Document title (overrides markdown title)
+  --author         Author name (default: from config/agent.json)
+  --date           Document date (default: today)
+  --help, -h       Show this help
+
+Templates:
+  ${Object.entries(TEMPLATES)
+    .map(([name, t]) => `${name.padEnd(20)} ${t.description}`)
+    .join("\n  ")}
+  `);
+}
+
+async function extractTitle(markdownPath) {
+  const content = await fs.readFile(markdownPath, "utf-8");
+  const match = content.match(/^#\s+(.+)$/m);
+  return match
+    ? match[1].replace(/\{.*\}/, "").trim()
+    : path.basename(markdownPath, ".md");
+}
+
+async function buildDocument(config) {
+  const startTime = Date.now();
+
+  // Validate input
+  if (!config.input) {
+    console.error("Error: --input is required. Use --help for usage.");
+    process.exit(1);
+  }
+
+  const inputPath = path.resolve(config.input);
+  if (!existsSync(inputPath)) {
+    console.error(`Error: Input file not found: ${inputPath}`);
+    process.exit(1);
+  }
+
+  // Resolve template
+  const templateConfig = TEMPLATES[config.template];
+  if (!templateConfig) {
+    console.error(
+      `Error: Unknown template '${config.template}'. Available: ${Object.keys(TEMPLATES).join(", ")}`,
+    );
+    process.exit(1);
+  }
+
+  const templatePath = path.join(TEMPLATES_DIR, templateConfig.file);
+  if (!existsSync(templatePath)) {
+    console.error(`Error: Template file not found: ${templatePath}`);
+    process.exit(1);
+  }
+
+  // Resolve output path
+  const outputPath = config.output
+    ? path.resolve(config.output)
+    : inputPath.replace(/\.md$/, ".pdf");
+
+  // Extract title if not provided
+  const title = config.title || (await extractTitle(inputPath));
+
+  console.log(`\n  Northwind PDF Generator`);
+  console.log(`  ─────────────────────────`);
+  console.log(`  Input:    ${inputPath}`);
+  console.log(`  Template: ${config.template} (${templateConfig.description})`);
+  console.log(`  Output:   ${outputPath}`);
+  console.log(`  Title:    ${title}`);
+  console.log(`  Author:   ${config.author}`);
+  console.log(`  Date:     ${config.date}`);
+  console.log();
+
+  // Ensure output directory exists
+  await fs.mkdir(path.dirname(outputPath), { recursive: true });
+
+  // Build Pandoc command
+  const pandocArgs = [
+    "pandoc",
+    inputPath,
+    `--pdf-engine=${XELATEX_PATH}`,
+    `--template=${templatePath}`,
+    "-V",
+    `fontsize=11pt`,
+    "-V",
+    `linestretch=1.25`,
+    "--columns=72",
+    `--resource-path=${ROOT}:${path.dirname(inputPath)}`,
+    "--metadata",
+    `title=${title}`,
+    "--metadata",
+    `author=${config.author}`,
+    "--metadata",
+    `date=${config.date}`,
+    "-o",
+    outputPath,
+  ];
+
+  // Add TOC for board packs
+  if (config.template === "board-pack") {
+    pandocArgs.push("--toc", "--toc-depth=2");
+  }
+
+  console.log(`  Building PDF...`);
+
+  try {
+    const [cmd, ...args] = pandocArgs;
+    const { execa } = await import("execa");
+    await execa(cmd, args, {
+      cwd: ROOT,
+      stdio: "pipe",
+    });
+
+    const stats = await fs.stat(outputPath);
+    const elapsed = ((Date.now() - startTime) / 1000).toFixed(1);
+
+    console.log(`  Done! ${Math.round(stats.size / 1024)} KB in ${elapsed}s`);
+    console.log(`  Output: ${outputPath}\n`);
+  } catch (error) {
+    console.error(`\n  PDF generation failed:`);
+    console.error(`  ${error.stderr || error.message}`);
+    process.exit(1);
+  }
+}
+
+const config = parseArgs();
+buildDocument(config);

package/scripts/pdf-generation/templates/board-pack.latex

@@ -0,0 +1,136 @@
+% Northwind Board Pack Template
+% For Pandoc + XeLaTeX — A4 board materials with cover page and TOC
+% Ported from ~/ai-born LaTeX pipeline
+
+\documentclass[11pt,a4paper]{report}
+
+% ─── Geometry ───
+\usepackage[
+  a4paper,
+  top=25mm,
+  bottom=20mm,
+  left=20mm,
+  right=20mm,
+  headheight=20mm,
+  headsep=10mm,
+  footskip=15mm
+]{geometry}
+
+% ─── Fonts (XeLaTeX) ───
+\usepackage{fontspec}
+\setmainfont{Georgia}
+\setsansfont{Helvetica Neue}
+\setmonofont[Scale=0.85]{Menlo}
+
+% ─── Typography ───
+\usepackage{microtype}
+\usepackage{parskip}
+\setlength{\parindent}{0pt}
+\setlength{\parskip}{0.75em plus 0.25em minus 0.25em}
+\linespread{1.25}
+\widowpenalty=10000
+\clubpenalty=10000
+
+% ─── Colours ───
+\usepackage{xcolor}
+\definecolor{northwind-dark}{HTML}{151919}
+\definecolor{northwind-navy}{HTML}{090F16}
+\definecolor{northwind-canvas-light}{HTML}{f5f4f2}
+\definecolor{northwind-text-secondary}{HTML}{78716C}
+\definecolor{northwind-accent-steel}{HTML}{44546d}
+\definecolor{northwind-code-bg}{HTML}{f8f8f8}
+
+% ─── Graphics ───
+\usepackage{graphicx}
+
+% ─── Headers & Footers ───
+\usepackage{fancyhdr}
+\pagestyle{fancy}
+\fancyhf{}
+\renewcommand{\headrulewidth}{0pt}
+\renewcommand{\footrulewidth}{0.4pt}
+\fancyhead[L]{\includegraphics[height=10mm]{public/assets/icon-dark.svg}}
+\fancyhead[R]{\footnotesize\sffamily\color{northwind-text-secondary} Board of Directors — Confidential}
+\fancyfoot[L]{\footnotesize\color{northwind-text-secondary} Northwind Holdings Ltd (DIFC)}
+\fancyfoot[R]{\footnotesize\color{northwind-text-secondary} \thepage}
+
+% ─── Section styling ───
+\usepackage{titlesec}
+\titleformat{\chapter}[display]
+  {\sffamily\bfseries\Huge\color{northwind-dark}}
+  {\thechapter}{0.5em}{}
+\titleformat{\section}
+  {\sffamily\bfseries\Large\color{northwind-dark}}
+  {\thesection}{0.5em}{}
+\titleformat{\subsection}
+  {\sffamily\bfseries\large\color{northwind-dark}}
+  {\thesubsection}{0.5em}{}
+
+% ─── Links ───
+\usepackage[
+  colorlinks=true,
+  linkcolor=northwind-accent-steel,
+  urlcolor=northwind-accent-steel,
+  citecolor=northwind-accent-steel
+]{hyperref}
+
+% ─── Tables ───
+\usepackage{longtable}
+\usepackage{booktabs}
+\usepackage{array}
+
+% ─── Code blocks ───
+\usepackage{listings}
+\lstset{
+  backgroundcolor=\color{northwind-code-bg},
+  basicstyle=\small\ttfamily,
+  breaklines=true,
+  frame=single,
+  rulecolor=\color{northwind-canvas-light}
+}
+
+% ─── Pandoc compatibility ───
+\providecommand{\tightlist}{\setlength{\itemsep}{0pt}\setlength{\parskip}{0pt}}
+$if(highlighting-macros)$
+$highlighting-macros$
+$endif$
+
+% ─── Document ───
+\begin{document}
+
+% ─── Cover page ───
+\begin{titlepage}
+\begin{center}
+\vspace*{4cm}
+\includegraphics[width=0.5\textwidth]{public/assets/logo-dark.svg}
+
+\vspace{2cm}
+{\Huge\sffamily\bfseries\color{northwind-dark} $if(title)$$title$$else$Board of Directors Pack$endif$}
+
+\vspace{1cm}
+$if(subtitle)$
+{\Large\sffamily\color{northwind-text-secondary} $subtitle$}
+\vspace{0.5cm}
+$endif$
+
+{\large\color{northwind-text-secondary} Northwind Holdings Ltd (DIFC)}
+
+{\large\color{northwind-text-secondary} Arrowsphere Holdings Ltd Group}
+
+\vspace{2cm}
+{\normalsize\color{northwind-text-secondary}
+\textbf{Classification:} Board Confidential \\
+\textbf{Distribution:} Board members and invited attendees only \\
+$if(author)$\textbf{Prepared by:} $author$ \\$endif$
+$if(date)$\textbf{Date:} $date$ \\$endif$
+}
+\end{center}
+\end{titlepage}
+
+% ─── Table of Contents ───
+\tableofcontents
+\newpage
+
+$body$
+
+\end{document}

package/scripts/pdf-generation/templates/corporate-letter.latex

@@ -0,0 +1,126 @@
+% Northwind Corporate Letter Template
+% For Pandoc + XeLaTeX — standard A4 corporate correspondence
+% Ported from ~/ai-born LaTeX pipeline, adapted for corporate documents
+
+\documentclass[11pt,a4paper]{article}
+
+% ─── Geometry ───
+\usepackage[
+  a4paper,
+  top=30mm,
+  bottom=25mm,
+  left=25mm,
+  right=25mm,
+  headheight=20mm,
+  headsep=10mm,
+  footskip=15mm
+]{geometry}
+
+% ─── Fonts (XeLaTeX) ───
+\usepackage{fontspec}
+\setmainfont{Georgia}
+\setsansfont{Helvetica Neue}
+\setmonofont[Scale=0.85]{Menlo}
+
+% ─── Typography ───
+\usepackage{microtype}
+\usepackage{parskip}
+\setlength{\parindent}{0pt}
+\setlength{\parskip}{0.75em plus 0.25em minus 0.25em}
+\linespread{1.25}
+\widowpenalty=10000
+\clubpenalty=10000
+
+% ─── Colours ───
+\usepackage{xcolor}
+\definecolor{northwind-dark}{HTML}{151919}
+\definecolor{northwind-navy}{HTML}{090F16}
+\definecolor{northwind-canvas-light}{HTML}{f5f4f2}
+\definecolor{northwind-text-secondary}{HTML}{78716C}
+\definecolor{northwind-accent-steel}{HTML}{44546d}
+\definecolor{northwind-code-bg}{HTML}{f8f8f8}
+
+% ─── Graphics ───
+\usepackage{graphicx}
+\usepackage{svg}
+
+% ─── Headers & Footers ───
+\usepackage{fancyhdr}
+\pagestyle{fancy}
+\fancyhf{}
+\renewcommand{\headrulewidth}{0pt}
+\renewcommand{\footrulewidth}{0.4pt}
+\fancyhead[L]{\includegraphics[height=12mm]{public/assets/icon-dark.svg}}
+\fancyfoot[L]{\footnotesize\color{northwind-text-secondary} Northwind — Confidential}
+\fancyfoot[R]{\footnotesize\color{northwind-text-secondary} \thepage}
+
+% ─── Title page uses full logo ───
+\fancypagestyle{firstpage}{%
+  \fancyhf{}
+  \renewcommand{\headrulewidth}{0pt}
+  \renewcommand{\footrulewidth}{0.4pt}
+  \fancyhead[L]{\includegraphics[height=18mm]{public/assets/logo-dark.svg}}
+  \fancyfoot[L]{\footnotesize\color{northwind-text-secondary} Northwind — Confidential}
+  \fancyfoot[R]{\footnotesize\color{northwind-text-secondary} \thepage}
+}
+
+% ─── Links ───
+\usepackage[
+  colorlinks=true,
+  linkcolor=northwind-accent-steel,
+  urlcolor=northwind-accent-steel,
+  citecolor=northwind-accent-steel
+]{hyperref}
+
+% ─── Tables ───
+\usepackage{longtable}
+\usepackage{booktabs}
+\usepackage{array}
+
+% ─── Code blocks ───
+\usepackage{listings}
+\lstset{
+  backgroundcolor=\color{northwind-code-bg},
+  basicstyle=\small\ttfamily,
+  breaklines=true,
+  frame=single,
+  rulecolor=\color{northwind-canvas-light},
+  xleftmargin=1em,
+  xrightmargin=1em
+}
+
+% ─── Pandoc compatibility ───
+\providecommand{\tightlist}{\setlength{\itemsep}{0pt}\setlength{\parskip}{0pt}}
+$if(highlighting-macros)$
+$highlighting-macros$
+$endif$
+
+% ─── Document ───
+\begin{document}
+\thispagestyle{firstpage}
+
+$if(title)$
+{\Large\sffamily\bfseries\color{northwind-dark} $title$}
+\vspace{0.5em}
+$endif$
+
+$if(subtitle)$
+{\large\sffamily\color{northwind-text-secondary} $subtitle$}
+\vspace{0.5em}
+$endif$
+
+$if(author)$
+{\normalsize\color{northwind-text-secondary} $author$}
+$endif$
+
+$if(date)$
+{\normalsize\color{northwind-text-secondary} $date$}
+$endif$
+
+\vspace{1em}
+\rule{\textwidth}{0.4pt}
+\vspace{1em}
+
+$body$
+
+\end{document}

package/scripts/pdf-generation/templates/memo.latex

@@ -0,0 +1,114 @@
+% Northwind Internal Memo Template
+% For Pandoc + XeLaTeX — compact A4 memos, briefs, and decision documents
+
+\documentclass[11pt,a4paper]{article}
+
+% ─── Geometry ───
+\usepackage[
+  a4paper,
+  top=25mm,
+  bottom=20mm,
+  left=20mm,
+  right=20mm,
+  headheight=18mm,
+  headsep=8mm,
+  footskip=12mm
+]{geometry}
+
+% ─── Fonts (XeLaTeX) ───
+\usepackage{fontspec}
+\setmainfont{Georgia}
+\setsansfont{Helvetica Neue}
+\setmonofont[Scale=0.85]{Menlo}
+
+% ─── Typography ───
+\usepackage{microtype}
+\usepackage{parskip}
+\setlength{\parindent}{0pt}
+\setlength{\parskip}{0.6em plus 0.2em minus 0.2em}
+\linespread{1.2}
+\widowpenalty=10000
+\clubpenalty=10000
+
+% ─── Colours ───
+\usepackage{xcolor}
+\definecolor{northwind-dark}{HTML}{151919}
+\definecolor{northwind-text-secondary}{HTML}{78716C}
+\definecolor{northwind-accent-steel}{HTML}{44546d}
+\definecolor{northwind-canvas-light}{HTML}{f5f4f2}
+\definecolor{northwind-code-bg}{HTML}{f8f8f8}
+
+% ─── Graphics ───
+\usepackage{graphicx}
+
+% ─── Headers & Footers ───
+\usepackage{fancyhdr}
+\pagestyle{fancy}
+\fancyhf{}
+\renewcommand{\headrulewidth}{0pt}
+\renewcommand{\footrulewidth}{0.3pt}
+\fancyhead[L]{\includegraphics[height=10mm]{public/assets/icon-dark.png}}
+\fancyhead[R]{\footnotesize\sffamily\color{northwind-text-secondary} Internal — $if(title)$$title$$endif$}
+\fancyfoot[L]{\footnotesize\color{northwind-text-secondary} $if(author)$Prepared by $author$$endif$}
+\fancyfoot[R]{\footnotesize\color{northwind-text-secondary} \thepage}
+
+% ─── Links ───
+\usepackage[
+  colorlinks=true,
+  linkcolor=northwind-accent-steel,
+  urlcolor=northwind-accent-steel
+]{hyperref}
+
+% ─── Tables ───
+\usepackage{longtable}
+\usepackage{booktabs}
+\usepackage{array}
+% Pandoc 3.x compatibility: defines counter 'none' used by \def\LTcaptype{none}
+\newcounter{none}
+
+% ─── Code blocks ───
+\usepackage{listings}
+\lstset{
+  backgroundcolor=\color{northwind-code-bg},
+  basicstyle=\small\ttfamily,
+  breaklines=true,
+  frame=single,
+  rulecolor=\color{northwind-canvas-light}
+}
+
+% ─── Pandoc compatibility ───
+\providecommand{\tightlist}{\setlength{\itemsep}{0pt}\setlength{\parskip}{0pt}}
+% Pandoc 3.9+ \pandocbounded command for bounded image sizing
+\newcommand{\pandocbounded}[1]{#1}
+% Pandoc 3.x proportional column widths
+\usepackage{calc}
+\newlength{\cslhangindent}
+\setlength{\cslhangindent}{1.5em}
+\newlength{\csllabelwidth}
+\setlength{\csllabelwidth}{3em}
+\newlength{\cslentryspacing}
+\setlength{\cslentryspacing}{0em}
+% calc package provides \real for Pandoc 3.x proportional column widths
+$if(highlighting-macros)$
+$highlighting-macros$
+$endif$
+
+% ─── Document ───
+\begin{document}
+
+$if(title)$
+{\Large\sffamily\bfseries\color{northwind-dark} $title$}
+$endif$
+
+$if(date)$
+\vspace{0.3em}
+{\small\color{northwind-text-secondary} $date$}
+$endif$
+
+\vspace{0.8em}
+\rule{\textwidth}{0.3pt}
+\vspace{0.8em}
+
+$body$
+
+\end{document}

package/scripts/poll-slack-events.sh

@@ -0,0 +1,35 @@
+#!/bin/bash
+# poll-slack-events.sh — Fetch buffered events from Railway relay server
+# Writes events to state/inbox/slack/ for the monitoring loop to process
+# Run via cron every 5-10 seconds for near-instant response
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+AGENT_REPO_DIR="${AGENT_DIR:-$(cd "$SCRIPT_DIR/.." && pwd)}"
+EVENTS_URL="${SLACK_EVENTS_RELAY_URL:-https://slack-events-server-production.up.railway.app/events}"
+INBOX_DIR="$AGENT_REPO_DIR/state/inbox/slack"
+mkdir -p "$INBOX_DIR"
+
+RESPONSE=$(curl -s --max-time 5 "$EVENTS_URL" 2>/dev/null)
+COUNT=$(echo "$RESPONSE" | python3 -c "import sys,json; print(json.load(sys.stdin).get('count',0))" 2>/dev/null)
+
+if [ "$COUNT" = "0" ] || [ -z "$COUNT" ]; then
+  exit 0
+fi
+
+# Write each event to a separate file in the inbox
+echo "$RESPONSE" | python3 -c "
+import sys, json, os
+
+data = json.load(sys.stdin)
+inbox = '$INBOX_DIR'
+
+for event in data.get('events', []):
+    ts = event.get('received_at', '').replace(':', '-').replace('.', '-')
+    etype = event.get('event_type', 'unknown')
+    filename = f'{ts}-{etype}.json'
+    filepath = os.path.join(inbox, filename)
+    with open(filepath, 'w') as f:
+        json.dump(event, f, indent=2)
+    print(f'[INBOX] {etype} → {filename}')
+"

package/scripts/poller/calendar-poller.mjs

@@ -0,0 +1,12 @@
+// Calendar Poller — stub for direct Calendar API access
+// For initial deployment, the inbox-processor uses the Calendar MCP server
+import { readCursor, writeCursor } from "./utils.mjs";
+
+export async function pollCalendar() {
+  if (!process.env.GOOGLE_CREDENTIALS) {
+    writeCursor("calendar", new Date().toISOString());
+    return { items: [], errors: [] };
+  }
+  writeCursor("calendar", new Date().toISOString());
+  return { items: [], errors: [] };
+}