actoviq-agent-sdk 0.4.5 → 0.4.7

package/dist/src/tui/pluginCatalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pluginCatalog.d.ts","sourceRoot":"","sources":["../../../src/tui/pluginCatalog.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,wBAAsB,sBAAsB,CAAC,OAAO,EAAE;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B,GAAG,OAAO,CAAC,yBAAyB,EAAE,CAAC,CA6BvC"}
+{"version":3,"file":"pluginCatalog.d.ts","sourceRoot":"","sources":["../../../src/tui/pluginCatalog.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,wBAAsB,sBAAsB,CAAC,OAAO,EAAE;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B,GAAG,OAAO,CAAC,yBAAyB,EAAE,CAAC,CA8BvC"}

package/dist/src/tui/pluginCatalog.js

@@ -1,9 +1,11 @@
 import { readdir, readFile, stat } from 'node:fs/promises';
 import path from 'node:path';
+import { resolveActoviqHome } from '../config/actoviqHome.js';
 import { isRecord } from '../runtime/helpers.js';
 export async function discoverActoviqPlugins(options) {
+    const dataRoot = resolveActoviqHome(options.homeDir);
     const candidates = [
-        path.join(options.homeDir, '.actoviq', 'plugins'),
+        path.join(dataRoot, 'plugins'),
         path.join(options.workDir, '.actoviq', 'plugins'),
         ...(options.configuredDirs ?? []),
     ];

package/dist/src/tui/pluginCatalog.js.map

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

package/dist/src/types.d.ts

@@ -54,6 +54,8 @@ export interface ActoviqPermissionDecision {
     source: 'mode' | 'rule' | 'classifier' | 'approver' | 'canUseTool';
     matchedRule?: string;
     timestamp: string;
+    /** When set, the conversation engine executes the tool with this input instead of the model-provided input. */
+    updatedInput?: unknown;
 }
 export type ActoviqClassifierOutcome = {
     behavior: 'allow' | 'deny' | 'ask';
@@ -80,6 +82,8 @@ export interface ActoviqToolApprovalContext extends ActoviqToolClassifierContext
 export type ActoviqToolApprovalOutcome = {
     behavior: 'allow' | 'deny';
     reason?: string;
+    /** Optional replacement tool input (e.g. AskUserQuestion answers). */
+    updatedInput?: unknown;
 };
 export type ActoviqToolApprover = (context: ActoviqToolApprovalContext) => Promise<ActoviqToolApprovalOutcome | void> | ActoviqToolApprovalOutcome | void;
 export interface ActoviqCanUseToolContext {
@@ -251,6 +255,7 @@ export interface ResolvedToolAdapter {
     isDestructive?: (input?: unknown) => boolean;
     requiresUserInteraction?: () => boolean;
     isConcurrencySafe?: () => boolean;
+    interruptBehavior?: 'cancel' | 'block';
     /** Per-tool result size cap in chars before artifacting to disk. */
     maxResultSizeChars?: number;
     checkPermissions?: (context: {
@@ -270,6 +275,15 @@ export interface ResolvedRuntimeConfig {
     modelTiers: ActoviqModelTierConfig;
     maxTokens: number;
     temperature?: number;
+    /** Whole-run wall-clock deadline, including model/tool iterations. */
+    runTimeoutMs: number;
+    /** Local and MCP tool deadline. */
+    toolTimeoutMs: number;
+    /** Individual hook deadline. */
+    hookTimeoutMs: number;
+    /** MCP connect/catalog/call deadline. */
+    mcpTimeoutMs: number;
+    /** Provider request timeout retained for compatibility. */
     timeoutMs: number;
     maxRetries: number;
     workDir: string;
@@ -339,6 +353,7 @@ export interface ActoviqStopHookContext {
     assistantMessage: Message;
     systemPrompt?: string;
     stopHookActive: boolean;
+    signal?: AbortSignal;
 }
 export interface ActoviqHookBlockingError {
     command?: string;
@@ -559,6 +574,10 @@ export interface CreateAgentSdkOptions {
     model?: string;
     maxTokens?: number;
     temperature?: number;
+    runTimeoutMs?: number;
+    toolTimeoutMs?: number;
+    hookTimeoutMs?: number;
+    mcpTimeoutMs?: number;
     timeoutMs?: number;
     maxRetries?: number;
     workDir?: string;
@@ -684,6 +703,12 @@ export interface AgentRunOptions {
      * next tool-result user message so the model sees them on its next request.
      */
     drainQueuedInputs?: () => string[];
+    /**
+     * Follow-up queue: drained only after the model reaches a natural stopping
+     * point. Follow-ups continue the same run without racing a second session
+     * turn against the active one.
+     */
+    drainFollowUpInputs?: () => string[];
     /** Override the runtime working directory for this run. */
     workDir?: string;
     /** When parent is in a worktree, inherit the worktree directory. Default: true. */
@@ -1056,6 +1081,18 @@ export type AgentEvent = {
     requestByteLength?: number;
     localMicrocompact?: AgentRequestSummary['localMicrocompact'];
     timestamp: string;
+} | {
+    type: 'request.prompt_cache';
+    runId: string;
+    iteration: number;
+    prefixSignature: string;
+    prefixChanged: boolean;
+    breakpoints: {
+        system: boolean;
+        tools: boolean;
+        message: boolean;
+    };
+    timestamp: string;
 } | {
     type: 'response.text.delta';
     runId: string;
@@ -1063,6 +1100,25 @@ export type AgentEvent = {
     delta: string;
     snapshot: string;
     timestamp: string;
+} | {
+    type: 'response.thinking.delta';
+    runId: string;
+    iteration: number;
+    index: number;
+    delta: string;
+    snapshot: string;
+    signature?: string;
+    timestamp: string;
+} | {
+    type: 'response.tool_input.delta';
+    runId: string;
+    iteration: number;
+    index: number;
+    toolUseId?: string;
+    toolName?: string;
+    delta: string;
+    snapshot: string;
+    timestamp: string;
 } | {
     type: 'response.content';
     runId: string;
@@ -1242,6 +1298,8 @@ export interface StoredRunSummary {
 export type SessionStatus = 'active' | 'idle' | 'closed';
 export interface StoredSession {
     version: 1;
+    /** Monotonic compare-and-swap revision. Legacy v1 snapshots without it load as revision 0. */
+    revision: number;
     id: string;
     title: string;
     titleSource: 'auto' | 'manual';
@@ -1256,7 +1314,7 @@ export interface StoredSession {
     status: SessionStatus;
     messages: MessageParam[];
     runs: StoredRunSummary[];
-    kind?: 'main' | 'worktree';
+    kind?: 'main' | 'worktree' | 'manager';
     worktreePath?: string;
     worktreeBranch?: string;
     parentSessionId?: string;
@@ -1267,6 +1325,10 @@ export interface SessionSummary {
     title: string;
     titleSource: 'auto' | 'manual';
     model: string;
+    /** Last runtime used for this session (bridge config runtime or `hadamard`). */
+    runtime: string;
+    /** Last named provider config used; null when the default Hadamard provider ran. */
+    configName: string | null;
     createdAt: string;
     updatedAt: string;
     lastRunAt?: string;
@@ -1274,8 +1336,19 @@ export interface SessionSummary {
     status: SessionStatus;
     tags: string[];
     preview: string;
+    /** First-user-prompt style label for conversation lists. */
+    brief?: string;
     messageCount: number;
     runCount: number;
+    /** True when the session file lives in the project archive/ directory. */
+    archived?: boolean;
+    /** Session kind — 'manager' sessions belong to the Project Manager panel, not the chat list. */
+    kind?: 'main' | 'worktree' | 'manager';
+    /** Project issue linked to this session, when the session was created from an issue dispatch. */
+    issueId?: string;
+    issueNumber?: number;
+    issueKey?: string;
+    agentProfile?: string;
 }
 export interface SessionManagerConfig {
     /** Maximum stored sessions. When exceeded, the oldest idle/closed sessions are evicted during `touch()`. */
@@ -1645,6 +1718,61 @@ export interface TaskSchedulerOptions {
     defaultMaxRetries?: number;
     defaultRetryDelayMs?: number;
 }
+export type ScheduledAutomationKind = 'workflow' | 'prompt' | 'manager';
+/** How an automation task is fired. */
+export type AutomationTriggerType = 'schedule' | 'webhook';
+/**
+ * A scheduled or webhook-triggered automation task. Schedule tasks fire on a
+ * cron expression; webhook tasks fire when their unique webhook URL receives a
+ * POST. Tasks are persisted per project workDir, or globally when `scope` is
+ * 'global' (created from any conversation via /automation).
+ */
+export interface ScheduledAutomationTask {
+    id: string;
+    name: string;
+    kind: ScheduledAutomationKind;
+    /** Trigger type. Absent → 'schedule' (backward compat). */
+    trigger?: AutomationTriggerType;
+    /** Cron expression for trigger==='schedule'. Empty for webhook tasks. */
+    cron: string;
+    enabled: boolean;
+    description?: string;
+    workflowName?: string;
+    input?: string;
+    prompt?: string;
+    /** Webhook: unique token in the webhook URL (trigger==='webhook'). */
+    webhookId?: string;
+    /** Webhook: shared secret verified via x-webhook-secret header. */
+    webhookSecret?: string;
+    /** Webhook: optional case-insensitive substring the request body must contain. */
+    webhookFilter?: string;
+    /** 'global' = created from conversation (any project); otherwise the project workDir path. */
+    scope?: string;
+    lastRunAt?: string;
+    lastResult?: ScheduledTaskRecord['lastResult'];
+    lastError?: string;
+    /** ISO time of the next scheduled run (schedule trigger only). */
+    nextRunAt: string;
+    invocationCount: number;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ScheduledAutomationTaskInput {
+    id?: string;
+    name?: string;
+    kind?: ScheduledAutomationKind;
+    trigger?: AutomationTriggerType;
+    cron?: string;
+    enabled?: boolean;
+    description?: string;
+    workflowName?: string;
+    input?: string;
+    prompt?: string;
+    webhookId?: string;
+    webhookSecret?: string;
+    webhookFilter?: string;
+    scope?: string;
+}
 export type ActoviqBridgePermissionMode = 'acceptEdits' | 'bypassPermissions' | 'default' | 'dontAsk' | 'plan';
 export type ActoviqBridgeToolsOption = 'default' | 'none' | string[];
 /**
@@ -2027,7 +2155,22 @@ export interface WorktreeInfo {
  * convergence (the `panel` capability). `panel` and `analysis` are retained as
  * backward-compatible aliases that route to the same engine.
  */
-export type ModelTeamMode = 'panel-analysis' | 'panel' | 'analysis' | 'reviewer' | 'executor-reviewer';
+export type ModelTeamMode = 'panel-analysis' | 'panel' | 'analysis' | 'reviewer' | 'executor-reviewer' | 'graph';
+/** A node in a workflow squad's execution tree. */
+export interface WorkflowNode {
+    id: string;
+    /** Agent = run a prompt; branch = if/else split (children[0]=true, children[1]=false); parallel = run all children concurrently. */
+    type: 'agent' | 'branch' | 'parallel';
+    label?: string;
+    /** Agent nodes: the prompt to run. */
+    prompt?: string;
+    /** Branch nodes: case-insensitive substring the upstream output must contain to take the `true` child. */
+    condition?: string;
+    runtime?: string;
+    model?: string;
+    /** Children: branch=[if,else], parallel=all, agent=[] (leaf). */
+    children: WorkflowNode[];
+}
 export interface TeamMember {
     model: string;
     provider?: 'anthropic' | 'openai';
@@ -2042,17 +2185,180 @@ export interface TeamMember {
     name?: string;
     /** The member's role/specialty (e.g. "security", "skeptic"). */
     role?: string;
+    /** User-facing task ownership for this member inside a team run. */
+    responsibility?: string;
+    /** Member ids/names/roles this member should review after they work. */
+    reviews?: string[];
+    /** Member ids/names/roles this member depends on before it should work. */
+    dependsOn?: string[];
+    /** Preferred local/runtime label for this member, if it should use a named runtime. */
+    runtime?: string;
+    /** Tool families this member is expected to use, shown in GUI planning surfaces. */
+    toolScope?: string[];
+    /**
+     * Workspace access for this member during a team run.
+     * `workspace` (default): project workspace only.
+     * `full`: unrestricted filesystem access (same as the main agent).
+     */
+    workspaceAccess?: 'workspace' | 'full';
+}
+export interface TeamReviewEdge {
+    /** Reviewer member id/name/role. */
+    from: string;
+    /** Reviewed member id/name/role. */
+    to: string;
+    kind?: 'review' | 'handoff' | 'support';
+    note?: string;
+}
+/** How an edge wakes its downstream node. v1 engine auto-schedules only `on_complete`. */
+export type TeamGraphTrigger = 'on_complete' | 'on_tool_call' | 'on_handoff' | 'on_review_request' | 'manual';
+/** What kind of communication the edge carries (labeling/UI semantics). */
+export type TeamGraphChannel = 'message' | 'handoff' | 'review' | 'broadcast';
+/** v3 port + agent nodes on the collaboration canvas. */
+export type TeamGraphNodeKind = 'task' | 'agent' | 'return';
+/** How a Return port delivers its result to the team caller. */
+export type TeamGraphReturnMode = 'void' | 'payload';
+/**
+ * A graph node is a team member plus graph-only fields. Nodes are read-only by
+ * default (same expert toolset as panel members); `allowedTools` opts specific
+ * core tools in per node — granting Write/Bash requires an explicit editor
+ * confirmation (product rule, enforced at the UI layer).
+ *
+ * v3: `kind: 'task'` (exactly one per graph) dispatches `run.prompt`; `kind:
+ * 'return'` (≥1) terminates the run. Absent `kind` → `agent` (v2 compat).
+ */
+export interface TeamGraphNode extends Omit<TeamMember, 'model'> {
+    /** Agent nodes require a model; task/return ports omit it. */
+    model?: string;
+    /** v3 node kind. Default `agent`. */
+    kind?: TeamGraphNodeKind;
+    /**
+     * Execution mode for agent nodes.
+     * - `react` (default): full ReAct loop with the node's allowed tools.
+     * - `single`: one LLM call, no tools — answer directly.
+     * - `team`: invoke another persisted team definition by `teamRef` as a
+     *   sub-agent; the sub-team's answer becomes this node's output.
+     */
+    type?: 'react' | 'single' | 'team';
+    /** When `type === 'team'`, name of the persisted team definition to invoke. */
+    teamRef?: string;
+    /** Return ports only — `void` (return 0) or structured `payload`. */
+    returnMode?: TeamGraphReturnMode;
+    /** Return ports in `payload` mode — template for the structured return value. */
+    payloadTemplate?: string;
+    /** v2 entry flag — migrated to Task→agent edges in v3. */
+    entry?: boolean;
+    /** Core-tool whitelist for this node. Absent → read-only expert tools. */
+    allowedTools?: string[];
+    /**
+     * Join semantics across this node's `on_complete` in-edges.
+     * `all` (default): wait-all — wake once after every in-edge resolves.
+     * `any`: OR-join — wake on the first in-edge that delivers a payload.
+     */
+    join?: 'all' | 'any';
+    /** GUI canvas position (pixels). Ignored by the graph engine. */
+    ui?: {
+        x?: number;
+        y?: number;
+    };
+    /** Per-node ReAct tool-iteration cap. Omit or ≤0 = unlimited. */
+    maxIterations?: number;
+    /** Per-node run timeout (ms). Omit → squad default. */
+    timeoutMs?: number;
+    /** Transient network-error reconnect attempts. Default 10. */
+    reconnectAttempts?: number;
+    /** Per-node graph loop-round cap. Omit or ≤0 = unlimited (squad `maxRounds` applies). */
+    maxRounds?: number;
+}
+export interface TeamGraphEdge {
+    /** Upstream node ref (id → name → role → model). */
+    from: string;
+    /** Downstream node ref. */
+    to: string;
+    channel?: TeamGraphChannel;
+    /** Default: `on_complete`. */
+    trigger?: TeamGraphTrigger;
+    /**
+     * Template for the payload delivered downstream. Supports `{{from.output}}`,
+     * `{{from.id}}`, and `{{run.prompt}}` placeholders. Absent → a labeled
+     * "input from <id>" section containing the upstream report.
+     */
+    payloadTemplate?: string;
+    /**
+     * Output gate: the edge fires only when the upstream output matches.
+     * `/pattern/` (optionally `/pattern/i`) is a regex test; anything else is a
+     * case-sensitive substring test. A gated-out edge releases its join slot
+     * without a payload; a node whose every in-edge gates out is skipped
+     * (conditional short-circuit) and releases its own downstream edges.
+     */
+    condition?: string;
+    note?: string;
+    /** v3: back-edge for convergence loops — requires `maxRounds` on the definition. */
+    loop?: boolean;
+    /**
+     * Edge direction for GUI + runtime. Default / omitted = `directed` (from → to).
+     * `undirected` (↔): bidirectional — runtime expands a reverse sibling for
+     * communication triggers; passive `on_complete` edges still store one record
+     * but also gain reverse scheduling except when `loop` is set.
+     */
+    direction?: 'directed' | 'undirected';
+    /**
+     * GUI canvas cubic-bezier control points (offsets from from/to ports).
+     * Ignored by the graph engine; persisted with the squad JSON on Save.
+     */
+    ui?: {
+        c1?: {
+            dx: number;
+            dy: number;
+        };
+        c2?: {
+            dx: number;
+            dy: number;
+        };
+        /**
+         * GUI-only snap-point index on the source/target node's edge (0-based).
+         * Agents have 3 snaps per side (0=left, 1=center, 2=right); task/return have
+         * 1 (index 0). Default/absent → center. Ignored by the graph engine.
+         */
+        fromPort?: number;
+        toPort?: number;
+    };
 }
 export interface TeamDefinition {
     name: string;
     description?: string;
     mode: ModelTeamMode;
+    /** Definition schema version. Missing → 1. Version 2 adds graph orchestration. */
+    version?: number;
+    /** How the team executes. Version 2 only; v1 definitions are implicitly `legacy-mode`. */
+    orchestration?: 'legacy-mode' | 'graph';
+    /**
+     * Squad kind — drives which editor the GUI shows. Absent → 'graph' (back-compat).
+     * - `graph`: collaboration graph (Task → agents → Return), the existing editor.
+     * - `workflow`: linear/tree work-flow node editor (Phase 3 — visual work tree).
+     * - `subagent`: a single configured agent (prompt + tools + workspace + runtime).
+     */
+    squadType?: 'graph' | 'workflow' | 'subagent';
+    /** Workflow squad only: the execution tree. */
+    workflowTree?: WorkflowNode;
     /** Panel members (panel-analysis / its `panel`+`analysis` aliases). */
     members: TeamMember[];
     /** Optional synthesizer that drives panel-analysis convergence. */
     primary?: TeamMember;
     /** The reviewer model (reviewer / its `executor-reviewer` alias). */
     reviewer?: TeamMember;
+    /**
+     * Explicit collaboration edges used by GUI/team planners (v1 only). The
+     * v1 → v2 migrator converts these into `edges` with `channel: 'review'` and
+     * drops the field — it is not carried forward on graph definitions.
+     */
+    reviewEdges?: TeamReviewEdge[];
+    /** Graph nodes (mode `graph`, version 2). */
+    nodes?: TeamGraphNode[];
+    /** Graph edges (mode `graph`, version 2). */
+    edges?: TeamGraphEdge[];
+    /** Entry node refs; alternative to per-node `entry: true` (union of both applies). */
+    entryNodeIds?: string[];
     /** Max panel members dispatched concurrently within this team (still bounded by the global AgentPool). Default: all members. */
     maxParallel?: number;
     /** Per-member, per-call timeout in ms. */
@@ -2124,6 +2430,17 @@ export type TeamEvent = {
     type: 'team.synthesis';
     round: number;
     decision: 'finalize' | 'continue';
+} | {
+    type: 'team.edge.triggered';
+    from: string;
+    to: string;
+    trigger: TeamGraphTrigger;
+    channel: TeamGraphChannel;
+} | {
+    type: 'team.returned';
+    nodeId: string;
+    returnMode: TeamGraphReturnMode;
+    returnValue?: string;
 } | {
     type: 'team.completed';
     mode: ModelTeamMode;
@@ -2138,6 +2455,18 @@ export interface TeamAskOptions {
     workDir?: string;
     /** Receives progress events as the team deliberates. */
     onEvent?: (event: TeamEvent) => void;
+    /** Permission policy inherited by every member runtime. Defaults to `default`, never bypass. */
+    permissionMode?: ActoviqPermissionMode;
+    permissions?: ActoviqPermissionRule[];
+    classifier?: ActoviqToolClassifier;
+    approver?: ActoviqToolApprover;
+    hooks?: ActoviqHooks;
+    /**
+     * Internal recursion guard for `type: 'team'` graph nodes: the chain of team
+     * refs currently being executed. The top-level call omits this; each team node
+     * appends its own ref before invoking the sub-team.
+     */
+    teamStack?: string[];
 }
 export interface TeamResult {
     answer: string;
@@ -2150,17 +2479,8 @@ export interface TeamResult {
     incompleteReason?: string;
 }
 /**
- * `reviewer` result. A single read-only ReAct agent inspects the project and
- * returns confirmed issues. The main agent (the "executor") invokes it as a
- * tool, supplies the context to review, and keeps final authority over the
- * findings. It only confirms issues it can verify — no speculation.
+ * One panel/graph agent's findings report.
  */
-export interface ReviewerResult extends TeamResult {
-    mode: 'reviewer';
-    report: string;
-    toolCalls: number;
-}
-/** One panel member's findings in `panel-analysis`/`analysis` mode. */
 export interface ExpertPanelReport {
     model: string;
     /** Stable member identity (disambiguates members that share a model). */
@@ -2174,19 +2494,31 @@ export interface ExpertPanelReport {
     round?: number;
 }
 /**
- * `panel-analysis` (and its `analysis` alias) result. Members are independent
- * read-only ReAct agents that investigate and report back. With no `primary`
- * it is single-pass advisory — the caller (the main agent) decides what to do
- * with the reports. With a `primary`, the primary synthesizes and decides
- * convergence across multiple rounds (harness: the model decides; `maxRounds`
- * is only a safety cap).
+ * `graph` mode result: all team runs return this shape (graph v3 runtime).
+ * Legacy `reviewer` / `panel-analysis` inputs are migrated before execution.
  */
-export interface AnalysisResult extends TeamResult {
-    mode: 'analysis' | 'panel-analysis';
+export interface GraphTeamResult extends TeamResult {
+    mode: 'graph';
     reports: ExpertPanelReport[];
-    rounds: number;
-}
-export type ModelTeamResult = ReviewerResult | AnalysisResult;
+    /** Node ids that never ran (unreachable, or only manual/communication in-edges). */
+    skippedNodes: string[];
+    /** v3: null = void / natural convergence (return 0). */
+    returnValue?: string | null;
+    returnMode?: TeamGraphReturnMode;
+    returnNodeId?: string;
+    /** Convergence loop rounds (v3 graphs with loop edges). */
+    graphRounds?: number;
+}
+/** @deprecated Runtime always returns {@link GraphTeamResult}. Kept for type compatibility. */
+export type ReviewerResult = GraphTeamResult & {
+    report?: string;
+    toolCalls?: number;
+};
+/** @deprecated Runtime always returns {@link GraphTeamResult}. Kept for type compatibility. */
+export type AnalysisResult = GraphTeamResult & {
+    rounds?: number;
+};
+export type ModelTeamResult = GraphTeamResult;
 /** A model target: a model id plus optional per-target provider config. */
 export interface RouterModelRef {
     model: string;