@minzicat/pi-team 0.1.0

package/dist/usage/plans.js

@@ -0,0 +1,214 @@
+/**
+ * Plan catalog.
+ *
+ * Hardcoded subscription limits for the plans we care about. Numbers come
+ * from publicly documented sources:
+ *
+ *   - OpenAI Codex: https://developers.openai.com/codex/pricing/
+ *   - Anthropic Claude: https://support.anthropic.com/en/articles/11145838
+ *
+ * These are ranges — the real cap depends on task complexity, context size,
+ * and server load. We track both the min (conservative) and max (optimistic)
+ * bounds. For Anthropic, published caps are *hours of use per week* for
+ * subscription tiers; for Codex, they're *messages per 5h window* with
+ * separate weekly caps.
+ *
+ * When a model isn't listed, it falls back to the plan's default. When a
+ * plan isn't listed at all, we default to "api" mode (pay-per-token, show
+ * dollar cost, no window tracking).
+ */
+const FIVE_HOURS_MS = 5 * 60 * 60 * 1000;
+const ONE_WEEK_MS = 7 * 24 * 60 * 60 * 1000;
+/**
+ * OpenAI Codex via ChatGPT subscriptions.
+ *
+ * Local messages and cloud tasks share the 5h window. We track local-message
+ * caps here since pi agents run locally. Numbers are the "Local Messages / 5h"
+ * ranges published on the Codex pricing page.
+ */
+export const openaiPlus = {
+    id: "openai-plus",
+    provider: "openai-codex",
+    tier: "plus",
+    mode: "subscription",
+    description: "ChatGPT Plus ($20/mo) — includes Codex CLI access",
+    short: {
+        durationMs: FIVE_HOURS_MS,
+        unit: "messages",
+        capByModel: {
+            "gpt-5.4": { min: 33, max: 168 },
+            "gpt-5.4-mini": { min: 110, max: 560 },
+            "gpt-5.3-codex": { min: 45, max: 225 },
+            "gpt-5.3-codex-mini": { min: 150, max: 760 },
+            "gpt-5.1-codex-mini": { min: 150, max: 760 },
+            "gpt-5.2-codex": { min: 45, max: 225 },
+        },
+    },
+    // Plus has no separately-published weekly cap; the 5h window is the practical limit.
+};
+export const openaiPro = {
+    id: "openai-pro",
+    provider: "openai-codex",
+    tier: "pro",
+    mode: "subscription",
+    // 6x Plus matches the published Pro ratio. Leaving the description and
+    // the numbers consistent so users don't see a "6x values but 2x promo"
+    // mismatch. Source: openai.com/chatgpt/pricing and the Codex docs.
+    description: "ChatGPT Pro ($200/mo) — 6x Plus limits",
+    short: {
+        durationMs: FIVE_HOURS_MS,
+        unit: "messages",
+        capByModel: {
+            // 6x the Plus ranges
+            "gpt-5.4": { min: 198, max: 1008 },
+            "gpt-5.4-mini": { min: 660, max: 3360 },
+            "gpt-5.3-codex": { min: 270, max: 1350 },
+            "gpt-5.3-codex-mini": { min: 900, max: 4560 },
+            "gpt-5.1-codex-mini": { min: 900, max: 4560 },
+            "gpt-5.2-codex": { min: 270, max: 1350 },
+        },
+    },
+};
+export const openaiBusiness = {
+    id: "openai-business",
+    provider: "openai-codex",
+    tier: "business",
+    mode: "subscription",
+    description: "ChatGPT Business ($25/user/mo) — ~2x Plus with team features",
+    short: {
+        durationMs: FIVE_HOURS_MS,
+        unit: "messages",
+        capByModel: {
+            "gpt-5.4": { min: 66, max: 336 },
+            "gpt-5.4-mini": { min: 220, max: 1120 },
+            "gpt-5.3-codex": { min: 90, max: 450 },
+            "gpt-5.3-codex-mini": { min: 300, max: 1520 },
+            "gpt-5.1-codex-mini": { min: 300, max: 1520 },
+            "gpt-5.2-codex": { min: 90, max: 450 },
+        },
+    },
+};
+/**
+ * Anthropic Claude subscriptions.
+ *
+ * Anthropic publishes per-model *hours of use* per week, plus a shared 5-hour
+ * session window with model-specific message caps. The official docs use
+ * hours; we track both as rough message-count approximations derived from
+ * typical-task assumptions. These ARE the least precise of all plans — the
+ * real enforcement is opaque.
+ */
+export const anthropicPro = {
+    id: "anthropic-pro",
+    provider: "anthropic",
+    tier: "pro",
+    mode: "subscription",
+    description: "Claude Pro ($20/mo) — Sonnet + Haiku; limited Opus",
+    short: {
+        durationMs: FIVE_HOURS_MS,
+        unit: "messages",
+        capByModel: {
+            "claude-sonnet-4-5": { min: 45, max: 225 },
+            "claude-sonnet-4-6": { min: 45, max: 225 },
+            "claude-opus-4-6": { min: 5, max: 25 },
+            "claude-opus-4-5": { min: 5, max: 25 },
+            "claude-haiku-4-5": { min: 150, max: 700 },
+        },
+    },
+    long: {
+        durationMs: ONE_WEEK_MS,
+        unit: "hours",
+        capByModel: {
+            "claude-sonnet-4-5": { min: 40, max: 40 },
+            "claude-sonnet-4-6": { min: 40, max: 40 },
+            "claude-opus-4-6": { min: 5, max: 5 },
+            "claude-opus-4-5": { min: 5, max: 5 },
+            "claude-haiku-4-5": { min: 80, max: 80 },
+        },
+    },
+};
+export const anthropicMax5x = {
+    id: "anthropic-max-5x",
+    provider: "anthropic",
+    tier: "max-5x",
+    mode: "subscription",
+    description: "Claude Max 5x ($100/mo) — 5x the Pro limits",
+    short: {
+        durationMs: FIVE_HOURS_MS,
+        unit: "messages",
+        capByModel: {
+            "claude-sonnet-4-5": { min: 225, max: 1125 },
+            "claude-sonnet-4-6": { min: 225, max: 1125 },
+            "claude-opus-4-6": { min: 25, max: 125 },
+            "claude-opus-4-5": { min: 25, max: 125 },
+            "claude-haiku-4-5": { min: 750, max: 3500 },
+        },
+    },
+    long: {
+        durationMs: ONE_WEEK_MS,
+        unit: "hours",
+        capByModel: {
+            "claude-sonnet-4-5": { min: 200, max: 200 },
+            "claude-sonnet-4-6": { min: 200, max: 200 },
+            "claude-opus-4-6": { min: 25, max: 25 },
+            "claude-opus-4-5": { min: 25, max: 25 },
+            "claude-haiku-4-5": { min: 400, max: 400 },
+        },
+    },
+};
+export const anthropicMax20x = {
+    id: "anthropic-max-20x",
+    provider: "anthropic",
+    tier: "max-20x",
+    mode: "subscription",
+    description: "Claude Max 20x ($200/mo) — 20x the Pro limits",
+    short: {
+        durationMs: FIVE_HOURS_MS,
+        unit: "messages",
+        capByModel: {
+            "claude-sonnet-4-5": { min: 900, max: 4500 },
+            "claude-sonnet-4-6": { min: 900, max: 4500 },
+            "claude-opus-4-6": { min: 100, max: 500 },
+            "claude-opus-4-5": { min: 100, max: 500 },
+            "claude-haiku-4-5": { min: 3000, max: 14000 },
+        },
+    },
+    long: {
+        durationMs: ONE_WEEK_MS,
+        unit: "hours",
+        capByModel: {
+            "claude-sonnet-4-5": { min: 800, max: 800 },
+            "claude-sonnet-4-6": { min: 800, max: 800 },
+            "claude-opus-4-6": { min: 100, max: 100 },
+            "claude-opus-4-5": { min: 100, max: 100 },
+            "claude-haiku-4-5": { min: 1600, max: 1600 },
+        },
+    },
+};
+/**
+ * API (pay-per-token) — no window tracking, dollar cost is meaningful.
+ */
+export const apiPlan = {
+    id: "api",
+    provider: "*",
+    tier: "pay-per-token",
+    mode: "api",
+    description: "Pay-per-token via direct API key — dollar cost is real",
+};
+export const PLAN_CATALOG = {
+    "openai-plus": openaiPlus,
+    "openai-pro": openaiPro,
+    "openai-business": openaiBusiness,
+    "anthropic-pro": anthropicPro,
+    "anthropic-max-5x": anthropicMax5x,
+    "anthropic-max-20x": anthropicMax20x,
+    api: apiPlan,
+};
+export function getPlan(id) {
+    if (!id)
+        return apiPlan;
+    return PLAN_CATALOG[id] ?? apiPlan;
+}
+export function listPlans() {
+    return Object.keys(PLAN_CATALOG);
+}
+//# sourceMappingURL=plans.js.map

package/dist/usage/plans.js.map

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

package/dist/usage/reporter.js

@@ -0,0 +1,69 @@
+/**
+ * Format a UsageSnapshot as a compact single-line status string, suitable
+ * for display in the observer after each turn.
+ *
+ * Examples:
+ *   claude │ sonnet-4-5      │ 5h: 12/45–225 msg (26%) · wk: 0.4/40h
+ *   codex  │ gpt-5.4 high    │ 5h: 5/33–168 msg (15%)
+ *   api    │ haiku-4-5       │ 1.2K in / 340 out  $0.0042
+ */
+const DIM = "\x1b[2m";
+const BOLD = "\x1b[1m";
+const RESET = "\x1b[0m";
+const GREEN = "\x1b[38;5;42m";
+export function formatSnapshot(snap, opts = {}) {
+    const color = opts.color ?? true;
+    const c = (code, text) => (color ? `${code}${text}${RESET}` : text);
+    const agentLabel = c(BOLD, snap.agentName.padEnd(8));
+    const modelLabel = shortenModel(snap.model).padEnd(18);
+    if (snap.planMode === "api") {
+        // Pay-per-token display: tokens + dollar cost
+        const { input, output } = snap.sessionTokens;
+        const tokens = `${formatNum(input)} in / ${formatNum(output)} out`;
+        const cost = `$${snap.sessionDollarCost.toFixed(4)}`;
+        return `${agentLabel} │ ${modelLabel} │ ${tokens}  ${c(DIM, cost)}`;
+    }
+    // Subscription display: windows
+    const parts = [];
+    if (snap.windows.short) {
+        parts.push(formatWindow("5h", snap.windows.short, color, opts.optimistic ?? false));
+    }
+    if (snap.windows.long) {
+        parts.push(formatWindow("wk", snap.windows.long, color, opts.optimistic ?? false));
+    }
+    const planLabel = c(DIM, snap.planId);
+    return `${agentLabel} │ ${modelLabel} │ ${parts.join(" · ")}  ${planLabel}`;
+}
+function formatWindow(label, w, color, optimistic) {
+    const cap = optimistic && w.capMax ? w.capMax : w.cap;
+    const used = w.unit === "hours" ? w.used : Math.round(w.used);
+    const capStr = w.capMax && w.cap !== w.capMax ? `${w.cap}–${w.capMax}` : String(cap);
+    const unit = w.unit === "messages" ? "msg" : w.unit === "tokens" ? "tok" : "h";
+    const percent = cap > 0 ? Math.min(100, (w.used / cap) * 100) : 0;
+    const pctStr = `${percent.toFixed(0)}%`;
+    const usedStr = w.unit === "hours" ? used.toFixed(1) : String(used);
+    const body = `${label}: ${usedStr}/${capStr} ${unit} (${pctStr})`;
+    if (!color)
+        return body;
+    if (percent >= 90)
+        return `\x1b[38;5;196m${body}${RESET}`;
+    if (percent >= 75)
+        return `\x1b[38;5;220m${body}${RESET}`;
+    if (percent >= 50)
+        return `${GREEN}${body}${RESET}`;
+    return `${DIM}${body}${RESET}`;
+}
+function shortenModel(model) {
+    // Drop common prefixes for display
+    return model
+        .replace(/^claude-/, "")
+        .replace(/-20\d{6}$/, "");
+}
+function formatNum(n) {
+    if (n >= 1_000_000)
+        return `${(n / 1_000_000).toFixed(1)}M`;
+    if (n >= 1_000)
+        return `${(n / 1_000).toFixed(1)}K`;
+    return String(n);
+}
+//# sourceMappingURL=reporter.js.map

package/dist/usage/reporter.js.map

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

package/dist/usage/tracker.js

@@ -0,0 +1,200 @@
+/**
+ * UsageTracker: reads per-agent pi session JSONL files, extracts turn usage,
+ * and computes rolling-window aggregates against each agent's declared plan.
+ *
+ * Strategy:
+ *   - Each agent's pi writes to agent-<name>.session.jsonl
+ *   - Every "message" entry with role="assistant" has a `usage` object
+ *     containing token counts, cost, provider, model, and timestamp
+ *   - After each turn, the orchestrator calls tracker.syncAgent(name) which
+ *     re-reads the agent's session file, extracts new turns, and recomputes
+ *     the snapshot
+ *
+ * We deliberately do NOT tail the file in real-time (fs.watch). Pi's RPC
+ * mode already tells us exactly when turns end via agent_end, which is the
+ * only time we need a fresh snapshot. Polling at turn boundaries is simpler
+ * and avoids racing with pi's writer.
+ */
+import { readFileSync, existsSync } from "node:fs";
+import { getPlan } from "./plans.js";
+export class UsageTracker {
+    turnsByAgent = new Map();
+    plansByAgent = new Map();
+    register(agent) {
+        this.turnsByAgent.set(agent.name, []);
+        this.plansByAgent.set(agent.name, getPlan(agent.planId));
+    }
+    /**
+     * Re-parse the agent's session jsonl and refresh its turn list.
+     * Idempotent; safe to call after every turn.
+     */
+    syncAgent(agentName, sessionPath) {
+        if (!existsSync(sessionPath))
+            return;
+        const turns = [];
+        const raw = readFileSync(sessionPath, "utf8");
+        for (const line of raw.split("\n")) {
+            if (!line.trim())
+                continue;
+            let entry;
+            try {
+                entry = JSON.parse(line);
+            }
+            catch {
+                continue;
+            }
+            if (entry.type !== "message")
+                continue;
+            const m = entry.message;
+            if (!m || m.role !== "assistant")
+                continue;
+            const usage = m.usage;
+            if (!usage)
+                continue;
+            const timestamp = parseTimestamp(entry.timestamp) ?? Date.now();
+            turns.push({
+                agentName,
+                timestamp,
+                provider: String(m.provider ?? ""),
+                model: String(m.model ?? ""),
+                tokens: {
+                    input: Number(usage.input ?? 0),
+                    output: Number(usage.output ?? 0),
+                    cacheRead: Number(usage.cacheRead ?? 0),
+                    cacheWrite: Number(usage.cacheWrite ?? 0),
+                    total: Number(usage.totalTokens ?? 0),
+                },
+                dollarCost: Number(usage.cost?.total ?? 0),
+            });
+        }
+        this.turnsByAgent.set(agentName, turns);
+    }
+    snapshot(agentName) {
+        const turns = this.turnsByAgent.get(agentName);
+        const plan = this.plansByAgent.get(agentName);
+        if (!turns || !plan)
+            return null;
+        // `total` is computed as the sum of the four individual counters (one
+        // source of truth). Pi's own `usage.totalTokens` can include cached
+        // tokens in a different way across providers, so summing here keeps
+        // session totals consistent with the field breakdown exposed via
+        // /state and /usage.
+        const sessionTokens = {
+            input: 0,
+            output: 0,
+            cacheRead: 0,
+            cacheWrite: 0,
+            total: 0,
+        };
+        let sessionDollarCost = 0;
+        let latestProvider = plan.provider;
+        let latestModel = "";
+        for (const t of turns) {
+            sessionTokens.input += t.tokens.input;
+            sessionTokens.output += t.tokens.output;
+            sessionTokens.cacheRead += t.tokens.cacheRead;
+            sessionTokens.cacheWrite += t.tokens.cacheWrite;
+            sessionDollarCost += t.dollarCost;
+            latestProvider = t.provider || latestProvider;
+            latestModel = t.model || latestModel;
+        }
+        sessionTokens.total =
+            sessionTokens.input + sessionTokens.output + sessionTokens.cacheRead + sessionTokens.cacheWrite;
+        const now = Date.now();
+        const shortSnap = plan.short ? computeWindow(turns, plan.short, now) : undefined;
+        const longSnap = plan.long ? computeWindow(turns, plan.long, now) : undefined;
+        const messagesShort = plan.short
+            ? turns.filter((t) => t.timestamp >= now - plan.short.durationMs).length
+            : turns.length;
+        const messagesLong = plan.long
+            ? turns.filter((t) => t.timestamp >= now - plan.long.durationMs).length
+            : turns.length;
+        return {
+            agentName,
+            provider: latestProvider,
+            model: latestModel,
+            planId: plan.id,
+            planMode: plan.mode,
+            sessionTokens,
+            sessionDollarCost,
+            windows: { short: shortSnap, long: longSnap },
+            messagesShort,
+            messagesLong,
+        };
+    }
+    snapshotAll() {
+        return Array.from(this.turnsByAgent.keys())
+            .map((name) => this.snapshot(name))
+            .filter((s) => s !== null);
+    }
+}
+function computeWindow(turns, window, now) {
+    const windowStart = now - window.durationMs;
+    const inWindow = turns.filter((t) => t.timestamp >= windowStart);
+    // Cap is model-specific. Use the most-used model in the window to pick the cap.
+    const modelCounts = new Map();
+    for (const t of inWindow) {
+        modelCounts.set(t.model, (modelCounts.get(t.model) ?? 0) + 1);
+    }
+    const dominantModel = maxBy(Array.from(modelCounts.entries()), ([, c]) => c)?.[0] ?? "";
+    const modelCap = window.capByModel[dominantModel];
+    let used;
+    if (window.unit === "messages") {
+        used = inWindow.length;
+    }
+    else if (window.unit === "tokens") {
+        used = inWindow.reduce((sum, t) => sum + t.tokens.total, 0);
+    }
+    else {
+        // hours — approximate by assuming each assistant turn represents some
+        // fraction of an hour. Without true session-duration data, we use
+        // total output tokens as a proxy, calibrated at 2000 output tokens
+        // ≈ 1 minute of "active use" (rough but honest).
+        const outputTokens = inWindow.reduce((sum, t) => sum + t.tokens.output, 0);
+        used = outputTokens / 2000 / 60; // hours
+    }
+    // Earliest turn in window tells us when the oldest will roll out.
+    // inWindow is filtered in iteration order — not guaranteed to be
+    // chronologically sorted if the underlying session JSONL was ever
+    // re-ordered or merged. Scan explicitly.
+    let oldest = now;
+    if (inWindow.length > 0) {
+        oldest = inWindow[0].timestamp;
+        for (let i = 1; i < inWindow.length; i++) {
+            if (inWindow[i].timestamp < oldest)
+                oldest = inWindow[i].timestamp;
+        }
+    }
+    const nextResetAt = oldest + window.durationMs;
+    return {
+        durationMs: window.durationMs,
+        used,
+        cap: modelCap?.min ?? 0,
+        capMax: modelCap?.max,
+        unit: window.unit,
+        windowStart,
+        nextResetAt,
+    };
+}
+function parseTimestamp(raw) {
+    if (typeof raw === "number")
+        return raw;
+    if (typeof raw === "string") {
+        const t = Date.parse(raw);
+        return Number.isNaN(t) ? null : t;
+    }
+    return null;
+}
+function maxBy(items, key) {
+    let best;
+    let bestKey = -Infinity;
+    for (const item of items) {
+        const k = key(item);
+        if (k > bestKey) {
+            bestKey = k;
+            best = item;
+        }
+    }
+    return best;
+}
+//# sourceMappingURL=tracker.js.map

package/dist/usage/tracker.js.map

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

package/dist/usage/types.js

@@ -0,0 +1,18 @@
+/**
+ * Usage tracking types.
+ *
+ * Two things we care about:
+ *
+ * 1. TurnUsage — what a single agent turn cost, sourced from pi's session
+ *    JSONL (input/output/cache tokens + dollar cost + timestamp + model).
+ *
+ * 2. WindowUsage — aggregation of turns into rolling time windows, compared
+ *    against the agent's declared subscription plan. This is the thing users
+ *    actually care about on subscriptions: "how much of my 5-hour budget am
+ *    I burning through right now?"
+ *
+ * Dollar cost is always computed (from pi's pricing) but is MEANINGLESS for
+ * subscription users. The plan-aware view is the primary display.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/usage/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/usage/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG"}

package/docker/entrypoint.sh

@@ -0,0 +1,94 @@
+#!/usr/bin/env bash
+# pi-team container entrypoint.
+#
+# Reads configuration from env vars and launches a tmux session running the
+# orchestrator, plus ttyd for web observation. ttyd runs in the foreground so
+# the container stays alive as long as the debate does.
+#
+# Required env:
+#   PITEAM_NAME         session name (e.g. "emotions")
+#   PITEAM_AGENTS       comma-separated agent specs: "name:provider/model[:thinking],..."
+#   PITEAM_TOPIC        inline topic string, OR
+#   PITEAM_TOPIC_FILE   path to a topic file
+#
+# Optional env:
+#   PITEAM_MAX_TURNS    default 20
+#   PITEAM_HTTP_PORT    default 7682
+#   PITEAM_TTYD_PORT    default 7681
+#   PITEAM_SESSIONS_DIR default /data/sessions
+#   PITEAM_HTTP_TOKEN   if set, require Bearer token for HTTP inject
+#   PITEAM_TTYD_CREDS   user:password for ttyd basic auth (recommended for hosted)
+#   PITEAM_TTYD_ARGS    extra args passed to ttyd
+
+set -euo pipefail
+
+: "${PITEAM_NAME:?PITEAM_NAME is required}"
+: "${PITEAM_AGENTS:?PITEAM_AGENTS is required}"
+
+MAX_TURNS="${PITEAM_MAX_TURNS:-20}"
+HTTP_PORT="${PITEAM_HTTP_PORT:-7682}"
+TTYD_PORT="${PITEAM_TTYD_PORT:-7681}"
+SESSIONS_DIR="${PITEAM_SESSIONS_DIR:-/data/sessions}"
+
+mkdir -p "$SESSIONS_DIR"
+
+# Resolve topic: prefer file, fallback to inline
+TOPIC_ARGS=()
+if [[ -n "${PITEAM_TOPIC_FILE:-}" ]]; then
+  TOPIC_ARGS=(--topic-file "$PITEAM_TOPIC_FILE")
+elif [[ -n "${PITEAM_TOPIC:-}" ]]; then
+  TOPIC_ARGS=(--topic "$PITEAM_TOPIC")
+else
+  echo "error: set PITEAM_TOPIC or PITEAM_TOPIC_FILE" >&2
+  exit 2
+fi
+
+# Split comma-separated agent specs into repeated --agent args
+AGENT_ARGS=()
+IFS=',' read -ra SPECS <<< "$PITEAM_AGENTS"
+for spec in "${SPECS[@]}"; do
+  # Trim whitespace
+  spec="${spec#"${spec%%[![:space:]]*}"}"
+  spec="${spec%"${spec##*[![:space:]]}"}"
+  [[ -z "$spec" ]] && continue
+  AGENT_ARGS+=(--agent "$spec")
+done
+
+# Start the tmux session in the background
+pi-team start \
+  --name "$PITEAM_NAME" \
+  "${AGENT_ARGS[@]}" \
+  "${TOPIC_ARGS[@]}" \
+  --max-turns "$MAX_TURNS" \
+  --sessions-dir "$SESSIONS_DIR" \
+  --http-port "$HTTP_PORT"
+
+# Wait for tmux session to be created (pi-team exits after detaching)
+for i in 1 2 3 4 5; do
+  if tmux has-session -t "piteam-${PITEAM_NAME}" 2>/dev/null; then
+    break
+  fi
+  sleep 1
+done
+
+echo ""
+echo "==============================================="
+echo "  pi-team session \"${PITEAM_NAME}\" is running"
+echo "  web observer:  http://0.0.0.0:${TTYD_PORT}/"
+echo "  http inject:   POST http://0.0.0.0:${HTTP_PORT}/inject"
+echo "  status:        GET  http://0.0.0.0:${HTTP_PORT}/state"
+echo "==============================================="
+echo ""
+
+# Launch ttyd in the foreground pointing at the tmux session
+TTYD_CMD=(ttyd -p "$TTYD_PORT" -W)
+if [[ -n "${PITEAM_TTYD_CREDS:-}" ]]; then
+  TTYD_CMD+=(-c "$PITEAM_TTYD_CREDS")
+fi
+if [[ -n "${PITEAM_TTYD_ARGS:-}" ]]; then
+  # shellcheck disable=SC2206
+  TTYD_CMD+=($PITEAM_TTYD_ARGS)
+fi
+TTYD_CMD+=(tmux attach -t "piteam-${PITEAM_NAME}")
+
+exec "${TTYD_CMD[@]}"

package/docker-compose.yml

@@ -0,0 +1,28 @@
+services:
+  pi-team:
+    build: .
+    image: pi-team:local
+    container_name: pi-team
+    environment:
+      # Agent configuration
+      PITEAM_NAME: ${PITEAM_NAME:-debate}
+      PITEAM_AGENTS: ${PITEAM_AGENTS:-claude:anthropic/claude-sonnet-4-5,codex:openai-codex/gpt-5.4:xhigh}
+      PITEAM_TOPIC_FILE: /topics/topic.md
+      PITEAM_MAX_TURNS: ${PITEAM_MAX_TURNS:-20}
+      # Optional auth for hosted deployments
+      PITEAM_TTYD_CREDS: ${PITEAM_TTYD_CREDS:-}
+      PITEAM_HTTP_TOKEN: ${PITEAM_HTTP_TOKEN:-}
+      # LLM API keys (pass through from .env)
+      ANTHROPIC_API_KEY: ${ANTHROPIC_API_KEY:-}
+      OPENAI_API_KEY: ${OPENAI_API_KEY:-}
+      GOOGLE_API_KEY: ${GOOGLE_API_KEY:-}
+    ports:
+      - "${PITEAM_TTYD_PORT:-7681}:7681"  # web tmux observer
+      - "${PITEAM_HTTP_PORT:-7682}:7682"  # HTTP inject endpoint
+    volumes:
+      - ./topics:/topics:ro               # mount your topic files here
+      - piteam-sessions:/data             # persist session transcripts
+    restart: unless-stopped
+
+volumes:
+  piteam-sessions: