@project-ava-supernova/core 0.2.71

package/dist/personas/conductor.d.ts

@@ -0,0 +1,184 @@
+import type { Provider } from '../providers/types.js';
+import type { ModelDefinition, Message } from '../core/types.js';
+import type { ToolRegistry } from '../tools/tool-registry.js';
+import type { PersonaDefinition, PersonaState, ContextPool, ConductorConfig, ConductorEventHandler } from './types.js';
+/**
+ * How much of the persona pipeline to run.
+ *
+ * - `light` (default) — minimum viable team for the mode. Saves ~3-5K tokens
+ *   per persona skipped. Fine for typical requests.
+ * - `full` — the complete pipeline defined in MODE_PERSONAS. User opts in
+ *   when the task actually needs all of it ("comprehensive review", "full
+ *   audit", etc.). Security + Work especially have a long tail of personas
+ *   that only matter for the heaviest tasks.
+ *
+ * Modes without a light variant (plan) ignore this option — their full team
+ * is already their intended minimum.
+ */
+export type ConductorDepth = 'light' | 'full';
+/**
+ * Regex-based fallback for picking persona depth. The primary path for
+ * Teach mode runs through `classifyTeachDepth` (Flash) in the
+ * auto-coordinator — that handles natural phrasings the regex can't
+ * cover ("I'd like to learn X", "help me understand Y from scratch",
+ * etc.). This function stays as the safety net when Flash is
+ * unavailable, when callers invoke `orchestrate()` directly, or for
+ * non-Teach modes where the regex is sufficient.
+ *
+ * The signal has to be explicit — brevity / ambiguity defaults to
+ * 'light' so tokens stay low unless someone genuinely wants the deep
+ * pipeline.
+ *
+ * For Teach mode (regex fallback only): full team runs when the user is
+ * creating a new curriculum ("teach me X", "I want to learn Y", "create
+ * a curriculum"). Other Teach turns ("continue", "another example",
+ * "I'm stuck") are delivery within an existing curriculum and use the
+ * light team (TUTOR alone).
+ */
+export declare function detectConductorDepth(userMessage: string, mode?: string): ConductorDepth;
+export declare class Conductor {
+    private readonly provider;
+    private readonly model;
+    /**
+     * Cheap fast model for light-tier personas (critics, summarisers,
+     * readers). Falls back to the heavy provider/model when absent so no
+     * persona ever goes un-modelled.
+     */
+    private readonly lightProvider;
+    private readonly lightModel;
+    private readonly toolRegistry;
+    private readonly toolContext;
+    private readonly config;
+    /**
+     * Optional vision provider/model so text-only coordinators (Supernova/
+     * DeepSeek, Aurora/Mistral) can still "see" attached images: each persona's
+     * messages get images described by this model and injected as text. Shared
+     * one cache across all personas so an image is described once per turn.
+     */
+    private readonly visionProvider;
+    private readonly visionModel;
+    private readonly visionDescriptionCache;
+    constructor(opts: {
+        provider: Provider;
+        model: ModelDefinition;
+        /**
+         * Optional cheap fast provider/model for personas tagged
+         * `modelTier: 'light'`. Pass the same pair resolved by the Auto
+         * Coordinator's intent gate (Qwen 3.5 Flash on platform, Haiku /
+         * DeepSeek on BYOK). When omitted the Conductor runs every persona
+         * on the heavy model — previous behaviour.
+         */
+        lightProvider?: Provider;
+        lightModel?: ModelDefinition;
+        /**
+         * Optional vision provider/model (e.g. Qwen 3.5 Omni) used to describe
+         * attached images for text-only coordinators. When omitted, image-bearing
+         * messages fall back to a "switch to a vision model" note.
+         */
+        visionProvider?: Provider;
+        visionModel?: ModelDefinition;
+        toolRegistry: ToolRegistry;
+        cwd: string;
+        sharedState?: Record<string, unknown>;
+        config?: ConductorConfig;
+    });
+    /**
+     * Resolve which provider + model runs a given persona. Light-tier
+     * personas use the cheap fast pair if one was configured; everything
+     * else uses the coordinator model. Falls back to the heavy pair when
+     * the light one isn't available (no BYOK Flash / Haiku configured).
+     */
+    private resolvePersonaModel;
+    /**
+     * Update the working directory used by all tool executions.
+     * Called when the user opens a different project folder mid-session.
+     */
+    setCwd(cwd: string): void;
+    /**
+     * Determine if a task needs the full persona team or if the coordinator
+     * can handle it directly with its own tools.
+     *
+     * The hard rules are:
+     *   - Chat → never orchestrates. Casual conversation, no team.
+     *   - Teach → always orchestrates. Curriculum building genuinely needs
+     *     the Curriculum Architect → Content Writer → Fact Checker →
+     *     Quiz Master → Tutor chain. Teach is a low-volume, high-value
+     *     call; the cost is justified per invocation.
+     *
+     * Every other mode (work, plan, security, brainstorm) is gated on an
+     * explicit-signal regex — the user has to ask for the team. Most prompts
+     * in those modes are things the coordinator (Qwen 3.7 Plus) can handle
+     * directly with file reads + writes + tool calls, without spawning 3–9
+     * specialists on an expensive model. That was the old token sink: a
+     * casual "plan adding a settings button" in Plan mode was triggering
+     * Researcher + Architect + Challenger each on the expensive coordinator
+     * model, ~15K–20K tokens before any real work happened.
+     *
+     * If the user genuinely wants the team, they say so — "full plan",
+     * "deep audit", "comprehensive review", etc. — and the regex lights up.
+     */
+    needsOrchestration(userMessage: string, mode: string): boolean;
+    /**
+     * Get the persona team for a given mode. Defaults to the light variant
+     * when one is defined for the mode — callers opt into the full team by
+     * passing `'full'` (detected from user keywords upstream). Modes without
+     * a light variant (plan, teach) return their full team unchanged since
+     * they're already at their intended minimum.
+     */
+    getTeam(mode: string, depth?: ConductorDepth): PersonaDefinition[];
+    /**
+     * Run the persona team on a task. Returns enriched context for the main agent.
+     *
+     * The Conductor does NOT replace the Agent. It runs *before* the Agent's
+     * main response to gather context, design the approach, and verify it.
+     * The final Agent response uses the Conductor's output as additional context.
+     */
+    orchestrate(userMessage: string, mode: string, conversationHistory: Message[], onEvent: ConductorEventHandler, signal?: AbortSignal, options?: {
+        depth?: ConductorDepth;
+        /**
+         * Optional callback the conductor polls between personas (sequential)
+         * or waves (parallel). Returning true causes orchestration to break
+         * early so a user interjection that arrived during the blocking
+         * persona loop doesn't have to wait for the full team to finish.
+         * The caller is responsible for draining the interjection queue once
+         * orchestrate returns — typically by letting the main Agent.run loop
+         * pick it up on the next iteration.
+         */
+        hasPendingInjection?: () => boolean;
+    }): Promise<{
+        contextPool: ContextPool;
+        personaStates: PersonaState[];
+        synthesisPrompt: string;
+    }>;
+    /**
+     * Run a single persona. Sends a focused prompt to the model with the persona's
+     * system instructions, current context pool, and scoped tool access.
+     *
+     * `rewriteContext` is set when this run is a retry after a downstream
+     * veto (e.g. Fact Checker HALTed Content Writer's lesson). The persona
+     * receives the original task plus a focused instruction to address the
+     * specific issue the gatekeeper raised, then re-do its work — typically
+     * by re-reading state from disk via its tools and producing a corrected
+     * output. Bounded to one retry per veto by `orchestrate()`.
+     */
+    private runPersona;
+    private buildPersonaPrompt;
+    private poolToString;
+    /**
+     * Compress a persona's output before it goes into the shared pool.
+     * Every subsequent persona in the chain reads the pool, so raw 500-800
+     * token outputs compound quickly (Scout 100 → Architect reads 100 →
+     * Verifier reads 200 → Sequencer reads 300 …). Capping the stored
+     * contribution at ~1200 chars (~300 tokens) keeps the pool small
+     * without losing the essential findings — personas already lead with
+     * their headline output and bury elaboration after, so a head-biased
+     * cap preserves the useful bit.
+     *
+     * Prefers cutting at paragraph / sentence boundaries over mid-word.
+     */
+    private compressOutput;
+    private updatePool;
+    private buildSynthesis;
+    private createEmptyPool;
+}
+//# sourceMappingURL=conductor.d.ts.map

package/dist/personas/conductor.d.ts.map

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