feat(ai): migrate support responses to Luna and OpenAI Agents SDK

.env.example

@@ -19,15 +19,19 @@ NEXT_PUBLIC_AUTH_PROVIDER="credentials"
 # OIDC_CLIENT_SECRET=""
 
 # ─── AI Pipeline ─────────────────────────────────────────────────────────────
-ANTHROPIC_API_KEY=""
-OPENAI_API_KEY=""             # Pathfinder embeddings (text-embedding-3-small)
+ANTHROPIC_API_KEY=""          # Optional: explicit anthropic rollback / direct legacy generator
+OPENAI_API_KEY=""             # Required default: investigation, verification, classification, sentiment
 PATHFINDER_URL="http://localhost:3100"
 PATHFINDER_MCP_URL=           # Pathfinder knowledge base URL
 FALLBACK_DOCS_URL=            # Fallback documentation URL
-AI_RESPONSE_MODEL=            # Override AI response model (default: claude-sonnet-4-20250514)
-AI_CONFIDENCE_MODEL=          # Override confidence scoring model
-AI_CLASSIFIER_MODEL=          # Override ticket classifier model
-AI_SENTIMENT_MODEL=           # Override sentiment analysis model
+AI_RESPONSE_PROVIDER=openai  # openai (default) or anthropic (rollback)
+AI_RESPONSE_MODEL=            # Defaults to gpt-5.6-luna; claude-sonnet-4-6 for anthropic
+AI_LEGACY_RESPONSE_MODEL=     # Direct legacy generator default: claude-sonnet-4-6
+AI_DRAFT_LINT_MODE=report     # report (default) or enforce after false-positive review
+OPENAI_AGENTS_DISABLE_TRACING=0 # Set 1 to disable; sensitive trace payloads are always off
+AI_CONFIDENCE_MODEL=          # Default gpt-5.6-luna (Claude Haiku for anthropic)
+AI_CLASSIFIER_MODEL=          # Default gpt-5.6-luna (Claude Haiku for anthropic)
+AI_SENTIMENT_MODEL=           # Default gpt-5.6-luna (Claude Haiku for anthropic)
 
 # ─── Shadow Mode ─────────────────────────────────────────────────────────────
 # Set to 'true' to run the full AI pipeline but LOG responses instead of posting

README.md

@@ -14,7 +14,7 @@ AI-powered support operations platform by CopilotKit. Outpost unifies customer s
 ├──────────┬──────────┬─────────────┼────────────┬────────────────┤
 │  pkg/ai  │ pkg/queue│  pkg/shared │   pkg/db   │                │
 │ Pathfinder│ Postgres │  Types &    │   Prisma   │                │
-│ + Claude │ Job Queue│  Constants  │   Schema   │                │
+│ + OpenAI │ Job Queue│  Constants  │   Schema   │                │
 ├──────────┴──────────┴─────────────┴────────────┘                │
 │                      PostgreSQL 16 + pgvector                    │
 └─────────────────────────────────────────────────────────────────┘
@@ -24,7 +24,7 @@ AI-powered support operations platform by CopilotKit. Outpost unifies customer s
 
 ### Prerequisites
 
-- Node.js >= 20
+- Node.js >= 24
 - pnpm >= 9
 - Docker (for local PostgreSQL)
 
@@ -56,16 +56,18 @@ pnpm db:seed
 pnpm dev
 ```
 
+Set `OPENAI_API_KEY` for the default Luna support investigator, independent verifier, classifier, and sentiment analyzer. `ANTHROPIC_API_KEY` is only needed for the explicit Anthropic rollback or direct legacy generator. See [support-agent configuration](docs/support-agent.md).
+
 ### Key Commands
 
-| Command | Description |
-|---------|-------------|
-| `pnpm dev` | Start all apps in development mode |
-| `pnpm build` | Build all apps and packages |
-| `pnpm lint` | Lint all packages |
-| `pnpm typecheck` | Type-check all packages |
-| `pnpm test` | Run all tests |
-| `pnpm format` | Format code with Prettier |
+| Command          | Description                        |
+| ---------------- | ---------------------------------- |
+| `pnpm dev`       | Start all apps in development mode |
+| `pnpm build`     | Build all apps and packages        |
+| `pnpm lint`      | Lint all packages                  |
+| `pnpm typecheck` | Type-check all packages            |
+| `pnpm test`      | Run all tests                      |
+| `pnpm format`    | Format code with Prettier          |
 
 ## Project Structure
 
@@ -77,7 +79,7 @@ outpost/
 │   ├── github-app/       # GitHub App for issue/discussion tracking
 │   └── docs/             # Public documentation site
 ├── packages/
-│   ├── ai/               # AI pipeline (Pathfinder + Claude)
+│   ├── ai/               # AI pipeline (Pathfinder + OpenAI)
 │   ├── db/               # Prisma schema and database client
 │   ├── queue/            # Postgres-based job queue
 │   └── shared/           # Shared types, constants, utilities

apps/discord-bot/Dockerfile

@@ -1,5 +1,5 @@
 # ── Stage 1: prune the monorepo to only what @copilotkit/outpost-discord-bot needs ──────
-FROM node:20-alpine AS pruner
+FROM node:24-alpine AS pruner
 RUN apk add --no-cache libc6-compat
 WORKDIR /app
 
@@ -10,7 +10,7 @@ COPY . .
 RUN turbo prune @copilotkit/outpost-discord-bot --docker
 
 # ── Stage 2: install dependencies and build ──────────────────────────────────
-FROM node:20-alpine AS installer
+FROM node:24-alpine AS installer
 RUN apk add --no-cache libc6-compat openssl
 WORKDIR /app
 
@@ -24,7 +24,7 @@ COPY --from=pruner /app/tsconfig.json ./tsconfig.json
 RUN pnpm turbo run build --filter=@copilotkit/outpost-discord-bot
 
 # ── Stage 3: production image ────────────────────────────────────────────────
-FROM node:20-alpine AS runner
+FROM node:24-alpine AS runner
 RUN apk add --no-cache libc6-compat openssl
 
 RUN addgroup --system --gid 1001 outpost && \

apps/docs/architecture/index.html

@@ -58,7 +58,7 @@ <h2>System Diagram</h2>
 ├─────────┬────────┴──┬───────────┬───┴──────────────────┴────────────────────┤
 │ <span class="str">pkg/ai</span>  │<span class="str">pkg/queue</span>  │<span class="str">pkg/shared</span> │              <span class="str">pkg/db</span>                        │
 │Pathfinder│ Postgres  │ Types &amp;   │              Prisma                       │
-│+ Claude │ Job Queue │ Constants │              Schema                       │
+│+ OpenAI │ Job Queue │ Constants │              Schema                       │
 ├─────────┴───────────┴───────────┴───────────────────────────────────────────┤
 │                          PostgreSQL 16                                        │
 └──────────────────────────────────────────────────────────────────────────────┘</code></pre>
@@ -108,8 +108,8 @@ <h2>Shared Packages</h2>
         <h3>packages/ai — AI Pipeline</h3>
         <p>
           The intelligence layer. Uses <a href="https://pathfinder.copilotkit.dev" target="_blank">Pathfinder</a>
-          for semantic search across the knowledge base and Claude for ticket classification,
-          priority assignment, response drafting, and routing decisions. All AI operations go
+          for semantic search across the knowledge base and OpenAI Agents SDK with Luna for ticket classification,
+          priority assignment, response drafting, independent verification, sentiment analysis, and routing decisions. All AI operations go
           through this package.
         </p>
 
@@ -198,7 +198,7 @@ <h2>Technology Stack</h2>
             <tr><td>Language</td><td>TypeScript</td></tr>
             <tr><td>Database</td><td>PostgreSQL 16</td></tr>
             <tr><td>ORM</td><td>Prisma</td></tr>
-            <tr><td>AI</td><td>Claude (Anthropic) + Pathfinder</td></tr>
+            <tr><td>AI</td><td>OpenAI Agents SDK (Luna) + Pathfinder</td></tr>
             <tr><td>Discord</td><td>discord.js</td></tr>
             <tr><td>Slack</td><td>@slack/bolt</td></tr>
             <tr><td>Teams</td><td>Bot Framework SDK (botbuilder)</td></tr>

apps/docs/configuration/index.html

@@ -51,12 +51,27 @@ <h2>AI Configuration</h2>
         <table class="env-table">
           <thead><tr><th>Variable</th><th>Description</th><th>Default</th></tr></thead>
           <tbody>
-            <tr><td>ANTHROPIC_API_KEY</td><td>Anthropic API key for Claude</td><td>&mdash;</td></tr>
-            <tr><td>AI_MODEL</td><td>Claude model to use for triage and responses</td><td>claude-sonnet-4-6</td></tr>
+            <tr><td>OPENAI_API_KEY</td><td>Required for the default Luna investigator, independent verifier, classifier, and sentiment analyzer</td><td>&mdash;</td></tr>
+            <tr><td>ANTHROPIC_API_KEY</td><td>Optional; required only for the Anthropic rollback or direct legacy generator</td><td>&mdash;</td></tr>
+            <tr><td>AI_RESPONSE_PROVIDER</td><td>Provider for response generation and auxiliary checks: <code>openai</code> or <code>anthropic</code></td><td>openai</td></tr>
+            <tr><td>AI_RESPONSE_MODEL</td><td>Investigator model; defaults to <code>claude-sonnet-4-6</code> for Anthropic</td><td>gpt-5.6-luna</td></tr>
+            <tr><td>AI_CONFIDENCE_MODEL</td><td>Independent confidence verifier; defaults to <code>claude-haiku-4-5-20251001</code> for Anthropic</td><td>gpt-5.6-luna</td></tr>
+            <tr><td>AI_CLASSIFIER_MODEL</td><td>Ticket classifier; defaults to <code>claude-haiku-4-5-20251001</code> for Anthropic</td><td>gpt-5.6-luna</td></tr>
+            <tr><td>AI_SENTIMENT_MODEL</td><td>Sentiment analyzer; defaults to <code>claude-haiku-4-5-20251001</code> for Anthropic</td><td>gpt-5.6-luna</td></tr>
+            <tr><td>AI_LEGACY_RESPONSE_MODEL</td><td>Direct legacy-generator model when the pipeline provider is OpenAI</td><td>claude-sonnet-4-6</td></tr>
+            <tr><td>AI_DRAFT_LINT_MODE</td><td><code>report</code> records violations; <code>enforce</code> routes blocking violations to review</td><td>report</td></tr>
+            <tr><td>OPENAI_AGENTS_DISABLE_TRACING</td><td>Set to <code>1</code> to disable SDK tracing; sensitive trace payloads are always excluded</td><td>0</td></tr>
             <tr><td>PATHFINDER_MCP_URL</td><td>Pathfinder MCP server URL for knowledge base search</td><td>https://mcp.copilotkit.ai</td></tr>
           </tbody>
         </table>
 
+        <p>
+          Configure <code>OPENAI_API_KEY</code> on the worker and web service. To roll back, set
+          <code>AI_RESPONSE_PROVIDER=anthropic</code>, provide <code>ANTHROPIC_API_KEY</code>,
+          and clear any OpenAI model overrides above. Model overrides must match the selected
+          provider; failures never switch providers automatically.
+        </p>
+
         <h2>Discord Bot</h2>
         <table class="env-table">
           <thead><tr><th>Variable</th><th>Description</th><th>Default</th></tr></thead>

apps/docs/contributing/index.html

@@ -86,7 +86,7 @@ <h2>Project Structure</h2>
 │   ├── github-app/       <span class="cm"># GitHub App webhook receiver</span>
 │   └── docs/             <span class="cm"># Documentation site (this site)</span>
 ├── packages/
-│   ├── ai/               <span class="cm"># AI pipeline (Pathfinder + Claude)</span>
+│   ├── ai/               <span class="cm"># AI pipeline (Pathfinder + OpenAI)</span>
 │   ├── db/               <span class="cm"># Prisma schema and client</span>
 │   ├── queue/            <span class="cm"># Postgres-backed job queue</span>
 │   └── shared/           <span class="cm"># Shared types and utilities</span>

apps/docs/deployment/index.html

@@ -39,7 +39,7 @@ <h1>Deployment Guide</h1>
         <h2>Requirements</h2>
         <ul>
           <li><strong>PostgreSQL 16</strong> with pgvector extension (required by Pathfinder for embeddings)</li>
-          <li><strong>Node.js 20+</strong> runtime for all five services</li>
+          <li><strong>Node.js 24+</strong> runtime for all five services</li>
           <li><strong>Persistent process manager</strong> for the Discord and Slack bots (they maintain WebSocket connections)</li>
           <li><strong>Public HTTPS endpoint</strong> for the GitHub App and Teams bot webhook receivers</li>
         </ul>
@@ -151,7 +151,7 @@ <h3>Railway (Recommended)</h3>
             </ul>
           </li>
           <li>Share <code>DATABASE_URL</code> across all services via Railway's variable references (<code>${{Postgres.DATABASE_URL}}</code>)</li>
-          <li>Fill in secret environment variables (<code>DISCORD_TOKEN</code>, <code>ANTHROPIC_API_KEY</code>, etc.)</li>
+          <li>Fill in secret environment variables (<code>DISCORD_TOKEN</code>, <code>OPENAI_API_KEY</code>, etc.)</li>
           <li>Configure custom domains for the web dashboard and GitHub App webhook endpoint</li>
         </ol>
 
@@ -200,7 +200,8 @@ <h2>Environment Checklist</h2>
         <p>Before deploying, verify these are all set:</p>
         <ul>
           <li>&#9745; <code>DATABASE_URL</code> pointing to production PostgreSQL</li>
-          <li>&#9745; <code>ANTHROPIC_API_KEY</code> for AI features</li>
+          <li>&#9745; <code>OPENAI_API_KEY</code> on the worker and web service for all default AI features</li>
+          <li><code>ANTHROPIC_API_KEY</code> only if selecting <code>AI_RESPONSE_PROVIDER=anthropic</code> for rollback or using the legacy generator directly</li>
           <li>&#9745; <code>DISCORD_BOT_TOKEN</code> and related Discord vars</li>
           <li>&#9745; <code>GITHUB_APP_ID</code>, <code>GITHUB_PRIVATE_KEY</code>, and webhook secret</li>
           <li>&#9745; <code>SLACK_BOT_TOKEN</code>, <code>SLACK_APP_TOKEN</code>, <code>SLACK_SIGNING_SECRET</code></li>

apps/docs/getting-started/index.html

@@ -50,13 +50,13 @@
       <main class="docs-content">
         <h1>Quick Start</h1>
         <p class="lead">
-          Get Outpost running locally in under 5 minutes. You need Node.js 20+, pnpm 9+, and Docker
+          Get Outpost running locally in under 5 minutes. You need Node.js 24+, pnpm 9+, and Docker
           for the local PostgreSQL instance.
         </p>
 
         <h2>Prerequisites</h2>
         <ul>
-          <li><strong>Node.js</strong> &ge; 20.0.0</li>
+          <li><strong>Node.js</strong> &ge; 24.0.0</li>
           <li><strong>pnpm</strong> &ge; 9.15.0</li>
           <li><strong>Docker</strong> &amp; Docker Compose (for local PostgreSQL)</li>
           <li><strong>Git</strong></li>

apps/docs/index.html

@@ -371,7 +371,7 @@ <h1>Intelligent <span class="accent">support</span><br class="hero-break"> <span
   channels: <span class="file">[support-forum]</span>
 
 <span class="highlight">ai:</span>
-  model: <span class="file">claude-sonnet-4-6</span>
+  model: <span class="file">gpt-5.6-luna</span>
   pathfinder: <span class="file">mcp.copilotkit.ai</span>
   autoRespond: <span class="file">true</span>
 
@@ -401,7 +401,7 @@ <h2 class="fade-in">Everything you need for support operations</h2>
         <div class="feature-card fade-in">
             <div class="icon">&#129302;</div>
             <h3>AI-Powered Triage</h3>
-            <p>Automatically classify, prioritize, and route incoming tickets using Claude and Pathfinder for intelligent knowledge base search.</p>
+            <p>Automatically classify, prioritize, and route incoming tickets using Luna and Pathfinder for intelligent knowledge base search.</p>
         </div>
         <div class="feature-card fade-in" style="transition-delay: 0.08s">
             <div class="icon">&#127919;</div>
@@ -526,10 +526,10 @@ <h2 class="fade-in">Five processes, one database</h2>
             </g>
 
             <!-- Layer 3: pkg/ai -->
-            <g class="arch-node" data-tooltip="AI package powered by Pathfinder semantic search and Claude for intelligent ticket triage, knowledge base lookup, and suggested responses.">
+            <g class="arch-node" data-tooltip="AI package powered by Pathfinder semantic search and Luna for intelligent ticket triage, knowledge base lookup, and suggested responses.">
                 <rect x="50" y="350" width="210" height="108" rx="12" fill="url(#nodeGrad)" stroke="#f97316" stroke-opacity="0.3" stroke-width="1" />
                 <text x="155" y="383" text-anchor="middle" fill="#f97316" font-family="JetBrains Mono, monospace" font-size="11" font-weight="600" letter-spacing="0.5">&#129302;  pkg/ai</text>
-                <text x="155" y="418" text-anchor="middle" fill="#64748b" font-family="Instrument Sans, sans-serif" font-size="10.5">Pathfinder + Claude</text>
+                <text x="155" y="418" text-anchor="middle" fill="#64748b" font-family="Instrument Sans, sans-serif" font-size="10.5">Pathfinder + Luna</text>
                 <text x="155" y="435" text-anchor="middle" fill="#64748b" font-family="Instrument Sans, sans-serif" font-size="10.5">Semantic search</text>
             </g>
 

apps/github-app/Dockerfile

@@ -1,5 +1,5 @@
 # ── Stage 1: prune the monorepo to only what @copilotkit/outpost-github-app needs ───────
-FROM node:20-alpine AS pruner
+FROM node:24-alpine AS pruner
 RUN apk add --no-cache libc6-compat
 WORKDIR /app
 
@@ -10,7 +10,7 @@ COPY . .
 RUN turbo prune @copilotkit/outpost-github-app --docker
 
 # ── Stage 2: install dependencies and build ──────────────────────────────────
-FROM node:20-alpine AS installer
+FROM node:24-alpine AS installer
 RUN apk add --no-cache libc6-compat openssl
 WORKDIR /app
 
@@ -24,7 +24,7 @@ COPY --from=pruner /app/tsconfig.json ./tsconfig.json
 RUN pnpm turbo run build --filter=@copilotkit/outpost-github-app
 
 # ── Stage 3: production image ────────────────────────────────────────────────
-FROM node:20-alpine AS runner
+FROM node:24-alpine AS runner
 RUN apk add --no-cache libc6-compat openssl
 
 RUN addgroup --system --gid 1001 outpost && \

apps/linear-sync/Dockerfile

@@ -1,5 +1,5 @@
 # ── Stage 1: prune the monorepo to only what @copilotkit/outpost-linear-sync needs ────────
-FROM node:20-alpine AS pruner
+FROM node:24-alpine AS pruner
 RUN apk add --no-cache libc6-compat
 WORKDIR /app
 
@@ -10,7 +10,7 @@ COPY . .
 RUN turbo prune @copilotkit/outpost-linear-sync --docker
 
 # ── Stage 2: install dependencies and build ──────────────────────────────────
-FROM node:20-alpine AS installer
+FROM node:24-alpine AS installer
 RUN apk add --no-cache libc6-compat openssl
 WORKDIR /app
 
@@ -24,7 +24,7 @@ COPY --from=pruner /app/tsconfig.json ./tsconfig.json
 RUN pnpm turbo run build --filter=@copilotkit/outpost-linear-sync
 
 # ── Stage 3: production image ────────────────────────────────────────────────
-FROM node:20-alpine AS runner
+FROM node:24-alpine AS runner
 RUN apk add --no-cache libc6-compat openssl
 
 RUN addgroup --system --gid 1001 outpost && \