@vascend/talos 0.1.0

package/dist/horizon/main-team.d.ts

@@ -0,0 +1,163 @@
+import type { AgentEvent } from "../core/types.js";
+import type { HorizonContextStatus, HorizonEngineOptions, HorizonModelCatalog, HorizonRuntime, HorizonTurnInput, HorizonTurnResult } from "./types.js";
+export type HorizonMainRef = "r1" | "r2";
+export type HorizonTeamRef = HorizonMainRef | "guide";
+export interface HorizonMainTeamConfig {
+    readonly agents?: 1 | 2;
+    readonly guide?: boolean;
+    readonly reviewRounds?: number;
+    /** Nomi UI dei main agent; r1/r2 restano gli identificatori tecnici. */
+    readonly names?: Readonly<Partial<Record<HorizonMainRef, string>>>;
+    /** Sessione privata di r2 da riprendere nella stessa conversazione host. */
+    readonly peerSessionId?: string;
+    /** Modello qualificato provider/modello usato esclusivamente da r2. */
+    readonly peerModel?: string;
+}
+export interface HorizonMainExchange {
+    readonly seq: number;
+    readonly from: HorizonMainRef;
+    readonly to: HorizonMainRef | "all";
+    readonly text: string;
+    readonly at: number;
+}
+export type HorizonMainTeamEvent = {
+    readonly type: "team_start";
+    readonly teamId: string;
+    readonly agents: readonly HorizonMainRef[];
+    readonly names: Readonly<Record<HorizonMainRef, string>>;
+    readonly guide: boolean;
+} | {
+    readonly type: "agent_start";
+    readonly agent: HorizonTeamRef;
+    readonly name: string;
+    readonly round: number;
+    readonly purpose?: HorizonAgentPurpose;
+} | {
+    readonly type: "agent_event";
+    readonly agent: HorizonTeamRef;
+    readonly round: number;
+    readonly purpose?: HorizonAgentPurpose;
+    readonly event: AgentEvent;
+} | {
+    readonly type: "plan";
+    readonly round: number;
+    readonly plan: HorizonGuidePlan;
+} | {
+    readonly type: "exchange";
+    readonly teamId: string;
+    readonly exchange: HorizonMainExchange;
+} | {
+    readonly type: "review";
+    readonly round: number;
+    readonly verdict: HorizonGuideVerdict;
+} | {
+    readonly type: "decision";
+    readonly phase: "requested" | "resolved";
+    readonly request: HorizonGuideDecisionRequest;
+    readonly decision?: HorizonGuideDecision;
+} | {
+    readonly type: "agent_end";
+    readonly agent: HorizonTeamRef;
+    readonly name: string;
+    readonly round: number;
+    readonly status: HorizonTurnResult["status"];
+    readonly output: string;
+} | {
+    readonly type: "team_end";
+    readonly teamId: string;
+    readonly status: HorizonTurnResult["status"];
+};
+export interface HorizonGuideVerdict {
+    readonly approved: boolean;
+    readonly summary: string;
+    readonly actions: Readonly<Partial<Record<HorizonMainRef, string>>>;
+}
+export type HorizonAgentPurpose = "plan" | "work" | "consolidate" | "review" | "decision";
+export interface HorizonGuideDecisionRequest {
+    readonly id: string;
+    readonly agent: HorizonMainRef;
+    readonly agentName: string;
+    readonly action: string;
+    readonly proposal: string;
+    readonly source: "automatic-gate" | "agent-request";
+    readonly at: number;
+}
+export interface HorizonGuideDecision {
+    readonly requestId: string;
+    readonly approved: boolean;
+    readonly risk: "low" | "medium" | "high" | "critical";
+    readonly reason: string;
+    readonly guidance: string;
+}
+export interface HorizonGuideDecisionRecord {
+    readonly request: HorizonGuideDecisionRequest;
+    readonly decision: HorizonGuideDecision;
+}
+export interface HorizonGuideTask {
+    readonly id: string;
+    readonly title: string;
+    readonly details: string;
+    readonly cooperateWith?: HorizonMainRef;
+}
+export interface HorizonGuideCooperation {
+    readonly id: string;
+    readonly title: string;
+    readonly lead: HorizonMainRef;
+    readonly support: HorizonMainRef;
+    readonly protocol: string;
+}
+export interface HorizonGuidePlan {
+    readonly summary: string;
+    readonly assignments: Readonly<Record<HorizonMainRef, readonly HorizonGuideTask[]>>;
+    readonly cooperation: readonly HorizonGuideCooperation[];
+}
+export interface HorizonMainTeamResult {
+    readonly id: string;
+    readonly teamId: string;
+    readonly status: HorizonTurnResult["status"];
+    readonly text: string;
+    readonly sessions: Readonly<Record<HorizonMainRef, string | null>>;
+    readonly names: Readonly<Record<HorizonMainRef, string>>;
+    readonly outputs: Readonly<Partial<Record<HorizonMainRef, string>>>;
+    readonly exchanges: readonly HorizonMainExchange[];
+    readonly decisions: readonly HorizonGuideDecisionRecord[];
+    readonly plan?: HorizonGuidePlan;
+    readonly review?: HorizonGuideVerdict;
+    readonly error?: string;
+}
+export interface HorizonMainTeamTurn {
+    readonly id: string;
+    readonly teamId: string;
+    readonly events: AsyncIterable<HorizonMainTeamEvent>;
+    readonly done: Promise<HorizonMainTeamResult>;
+    abort(): boolean;
+    send(input: HorizonTurnInput, id?: string): string | null;
+    prioritize(id: string): boolean;
+}
+export declare class HorizonMainTeam {
+    private readonly options;
+    private readonly runtime?;
+    private readonly engines;
+    private readonly activeTurns;
+    private readonly config;
+    private sequence;
+    private decisionSequence;
+    private guideDecisionTail;
+    private supervision;
+    private closed;
+    private constructor();
+    static create(options: HorizonEngineOptions, config?: HorizonMainTeamConfig, runtime?: HorizonRuntime | undefined): Promise<HorizonMainTeam>;
+    startTurn(input: HorizonTurnInput): HorizonMainTeamTurn;
+    modelCatalog(): HorizonModelCatalog;
+    contextStatus(): HorizonContextStatus;
+    close(): Promise<void>;
+    private initialize;
+    private createEngine;
+    private bindTeamTools;
+    private mainRefs;
+    private runAgent;
+    private review;
+    private plan;
+    private arbitrate;
+}
+export declare function needsGuideArbitration(action: string, detail: string): boolean;