qlogicagent 0.5.3 → 1.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qlogicagent",
-  "version": "0.5.3",
+  "version": "1.0.0",
   "description": "XiaozhiClaw Agent CLI — subprocess architecture (JSON-RPC over stdio)",
   "type": "module",
   "main": "dist/index.js",
@@ -32,7 +32,7 @@
     "dev": "tsx watch src/index.ts",
     "build": "node scripts/build.mjs",
     "build:tsc": "tsc --noCheck",
-    "start": "node dist/cli/main.js",
+    "start": "node dist/cli.js",
     "test": "vitest run",
     "test:watch": "vitest",
     "lint": "oxlint .",

package/dist/types/contracts/skill-candidate.d.ts

@@ -1,63 +0,0 @@
-export declare const SKILL_CANDIDATE_STATUS_VALUES: readonly ["draft", "in_review", "approved", "rejected", "canary", "published", "stale", "superseded", "rolled_back"];
-export declare const SKILL_CANDIDATE_ACTION_VALUES: readonly ["submit-review", "approve", "reject", "start-canary", "record-effectiveness", "promote", "publish", "mark-stale", "mark-superseded", "rollback"];
-export declare const SKILL_CANDIDATE_EFFECTIVENESS_PHASE_VALUES: readonly ["canary", "published"];
-export type SkillCandidateStatus = (typeof SKILL_CANDIDATE_STATUS_VALUES)[number];
-export type SkillCandidateAction = (typeof SKILL_CANDIDATE_ACTION_VALUES)[number];
-export type SkillCandidateEffectivenessPhase = (typeof SKILL_CANDIDATE_EFFECTIVENESS_PHASE_VALUES)[number];
-export type SkillCandidateArtifactContract = {
-    uri: string;
-    sha256?: string;
-    workspaceDir?: string;
-    relativePath?: string;
-    sourceWorkspaceDir?: string;
-    stagedAt?: string;
-};
-export type SkillCandidateSourceExecutionContract = {
-    executionId?: string;
-    rootExecutionId?: string;
-    parentExecutionId?: string;
-    sidechainId?: string;
-    attemptId?: string;
-    outcomeId?: string;
-    sessionId?: string;
-    turnId?: string;
-};
-export type SkillCandidateReviewContract = {
-    action: SkillCandidateAction;
-    actor?: string | null;
-    notes?: string | null;
-    payload?: Record<string, unknown>;
-    createdAt?: string;
-};
-export type SkillCandidateEffectivenessContract = {
-    phase: SkillCandidateEffectivenessPhase;
-    sampleCount: number;
-    successCount: number;
-    failureCount: number;
-    regressionCount: number;
-    successRate: number;
-    regressionRate: number;
-    avgLatencyMs?: number;
-    avgCostUsd?: number;
-    score?: number;
-    staleReason?: string | null;
-    notes?: string | null;
-    summary?: Record<string, unknown>;
-    lastObservedAt?: string;
-    updatedAt?: string;
-    /** ISO-8601 timestamp of last skill invocation/view/patch activity. */
-    lastActivityAt?: string;
-    /** Cumulative activity count (use + view + patch). */
-    activityCount?: number;
-};
-export declare function coerceSkillCandidateJsonObject(value: unknown): Record<string, unknown>;
-export declare function isSkillCandidateStatus(value: unknown): value is SkillCandidateStatus;
-export declare function isSkillCandidateAction(value: unknown): value is SkillCandidateAction;
-export declare function isSkillCandidateEffectivenessPhase(value: unknown): value is SkillCandidateEffectivenessPhase;
-export declare function normalizeSkillCandidateStatus(value: unknown, fallback?: SkillCandidateStatus): SkillCandidateStatus;
-export declare function normalizeSkillCandidateAction(value: unknown): SkillCandidateAction | null;
-export declare function normalizeSkillCandidateEffectivenessPhase(value: unknown): SkillCandidateEffectivenessPhase | null;
-export declare function normalizeSkillCandidateArtifact(value: unknown): SkillCandidateArtifactContract | null;
-export declare function normalizeSkillCandidateSourceExecution(value: unknown): SkillCandidateSourceExecutionContract | null;
-export declare function normalizeSkillCandidateReview(value: unknown): SkillCandidateReviewContract | null;
-export declare function normalizeSkillCandidateEffectiveness(value: unknown): SkillCandidateEffectivenessContract | null;

package/dist/types/orchestration/curator-scheduler.d.ts

@@ -1,119 +0,0 @@
-/**
- * Curator scheduler — pure strategy for autonomous skill library
- * maintenance. Decides WHEN to run the curator review cycle and
- * computes automatic lifecycle transitions (active → stale → archived).
- *
- * No I/O — all functions are pure; the caller supplies timestamps and
- * skill records, and receives transition instructions back.
- */
-/** Policy knobs for the curator scheduler. */
-export interface CuratorSchedulePolicy {
-    /** Minimum idle seconds before curator may trigger (default: 7200 = 2 h). */
-    minIdleSeconds: number;
-    /** Minimum interval between curator runs in seconds (default: 604800 = 7 days). */
-    intervalSeconds: number;
-    /** Days without activity before marking a skill stale (default: 30). */
-    staleAfterDays: number;
-    /** Days without activity before archiving a stale skill (default: 90). */
-    archiveAfterDays: number;
-    /** Maximum skills to process in one LLM review pass (default: 50). */
-    maxReviewBatchSize: number;
-}
-export declare const DEFAULT_CURATOR_SCHEDULE_POLICY: CuratorSchedulePolicy;
-/** Persistent curator state (stored by the host runtime). */
-export interface CuratorState {
-    /** ISO-8601 timestamp of last curator run. */
-    lastRunAt: string | null;
-    /** Duration of last run in seconds. */
-    lastRunDurationSeconds: number;
-    /** Human-readable summary of last run. */
-    lastRunSummary: string;
-    /** Whether curator is paused by the user. */
-    paused: boolean;
-    /** Cumulative run count. */
-    runCount: number;
-}
-export declare const INITIAL_CURATOR_STATE: CuratorState;
-/** Lifecycle state of an agent-created skill. */
-export type CuratorSkillLifecycleState = "active" | "stale" | "archived";
-/** Minimal skill activity record consumed by the scheduler. */
-export interface CuratorSkillRecord {
-    /** Skill name / identifier. */
-    name: string;
-    /** Whether this skill was agent-created (only these are curated). */
-    agentCreated: boolean;
-    /** Current lifecycle state. */
-    state: CuratorSkillLifecycleState;
-    /** Whether the user pinned this skill (immune to auto-transitions). */
-    pinned: boolean;
-    /** ISO-8601 timestamp of last activity. */
-    lastActivityAt: string | null;
-    /** Cumulative use count. */
-    useCount: number;
-    /** ISO-8601 timestamp of creation. */
-    createdAt: string;
-}
-/** Input for the gate check. */
-export interface CuratorGateInput {
-    /** Current ISO-8601 timestamp. */
-    now: string;
-    /** Seconds the session has been idle. */
-    idleSeconds: number;
-    /** Current curator state. */
-    state: CuratorState;
-    /** Whether the feature is enabled at all. */
-    enabled: boolean;
-    /** Policy overrides. */
-    policy?: Partial<CuratorSchedulePolicy>;
-}
-/** Result of the gate check: should the curator run? */
-export interface CuratorGateResult {
-    shouldRun: boolean;
-    reason: string;
-}
-/**
- * Determine whether the curator should run now.
- *
- * All gates must pass:
- * 1. Feature enabled
- * 2. Not paused
- * 3. Session idle ≥ minIdleSeconds
- * 4. Time since last run ≥ intervalSeconds
- */
-export declare function shouldRunCurator(input: CuratorGateInput): CuratorGateResult;
-/** A single lifecycle transition computed by the scheduler. */
-export interface CuratorLifecycleTransition {
-    skillName: string;
-    from: CuratorSkillLifecycleState;
-    to: CuratorSkillLifecycleState;
-    reason: string;
-}
-/** Summary of all auto-transitions in one pass. */
-export interface CuratorAutoTransitionResult {
-    checked: number;
-    transitions: CuratorLifecycleTransition[];
-    markedStale: number;
-    archived: number;
-    reactivated: number;
-}
-/**
- * Compute automatic lifecycle transitions for agent-created skills.
- *
- * Pure function — no I/O, no mutations. The caller applies the
- * returned transitions to its skill storage.
- *
- * Rules:
- * - Pinned skills are never transitioned.
- * - Non-agent-created skills are skipped.
- * - active → stale: no activity for staleAfterDays.
- * - stale → archived: no activity for archiveAfterDays.
- * - stale/archived → active: if useCount increased (reactivation).
- */
-export declare function computeLifecycleTransitions(skills: readonly CuratorSkillRecord[], now: string, policy?: Partial<CuratorSchedulePolicy>): CuratorAutoTransitionResult;
-/**
- * Select skills that should be reviewed by the LLM curator.
- *
- * Only non-pinned, agent-created skills in active or stale state
- * are eligible for review. Returns at most maxReviewBatchSize names.
- */
-export declare function selectReviewCandidates(skills: readonly CuratorSkillRecord[], policy?: Partial<CuratorSchedulePolicy>): string[];

package/dist/types/orchestration/memory-provider.d.ts

@@ -1,14 +0,0 @@
-import { MEMORY_OBSERVATION_HOOK_VALUES, type MemoryObservationHook, MEMORY_OBSERVATION_SOURCE_VALUES, type MemoryObservationSource, MEMORY_WRITE_ACCESS_VALUES, type MemoryWriteAccess } from "qlogicagent-runtime-contracts";
-export { MEMORY_OBSERVATION_HOOK_VALUES, type MemoryObservationHook, MEMORY_OBSERVATION_SOURCE_VALUES, type MemoryObservationSource, MEMORY_WRITE_ACCESS_VALUES, type MemoryWriteAccess, };
-export interface MemoryProviderLifecycleInvocation {
-    hook: MemoryObservationHook;
-    source: MemoryObservationSource;
-    sessionId: string;
-    turnId?: string;
-    executionId?: string;
-    rootExecutionId?: string;
-    parentExecutionId?: string;
-    sidechainId?: string;
-    attemptId?: string;
-    writeAccess: MemoryWriteAccess;
-}

package/dist/types/orchestration/skill-candidate.d.ts

@@ -1,52 +0,0 @@
-import { type SkillCandidateAction, type SkillCandidateArtifactContract, type SkillCandidateEffectivenessContract, type SkillCandidateReviewContract, type SkillCandidateSourceExecutionContract } from "../contracts/skill-candidate.js";
-export type SkillImprovementPolicyContract = {
-    reviewRequired: boolean;
-    canaryRequired: boolean;
-    autoPromote: boolean;
-    minCanarySampleCount: number;
-    minSuccessRate: number;
-    maxRegressionRate: number;
-    maxCostIncreaseRate: number;
-    staleAfterHours: number;
-};
-export type SkillCandidateImprovementEvidenceBundleContract = {
-    artifact?: SkillCandidateArtifactContract | null;
-    sourceExecution?: SkillCandidateSourceExecutionContract | null;
-    sourceSessionKey?: string | null;
-    diffSummary?: string | null;
-    baselineCandidateId?: string | null;
-    rolloutNotes?: string | null;
-    validationRefs?: string[];
-    evidence?: Record<string, unknown>;
-};
-export declare function createDefaultSkillImprovementPolicy(overrides?: Partial<SkillImprovementPolicyContract>): SkillImprovementPolicyContract;
-export declare function normalizeSkillImprovementPolicy(value: unknown, fallback?: SkillImprovementPolicyContract): SkillImprovementPolicyContract;
-export declare function buildSkillCandidateEvidencePayload(params: {
-    evidence?: Record<string, unknown> | null;
-    artifact?: SkillCandidateArtifactContract | null;
-    sourceExecution?: SkillCandidateSourceExecutionContract | null;
-    sourceSessionKey?: string | null;
-}): Record<string, unknown>;
-export declare function buildSkillCandidateImprovementEvidenceBundle(params: SkillCandidateImprovementEvidenceBundleContract): Record<string, unknown>;
-export declare function buildSkillCandidateLatestReview(params: {
-    action: SkillCandidateAction;
-    actor?: string | null;
-    notes?: string | null;
-    payload?: Record<string, unknown> | null;
-    createdAt?: string;
-}): SkillCandidateReviewContract;
-export declare function buildSkillCandidateEffectivenessSummary(params: {
-    phase: "canary" | "published";
-    sampleCount?: number;
-    successCount?: number;
-    failureCount?: number;
-    regressionCount?: number;
-    avgLatencyMs?: number;
-    avgCostUsd?: number;
-    score?: number;
-    staleReason?: string | null;
-    notes?: string | null;
-    summary?: Record<string, unknown> | null;
-    lastObservedAt?: string;
-    updatedAt?: string;
-}): SkillCandidateEffectivenessContract;

package/dist/types/orchestration/skill-consolidation.d.ts

@@ -1,123 +0,0 @@
-/**
- * Skill consolidation strategy — pure decision logic for
- * the Autonomous Curator's LLM-driven skill merging phase.
- *
- * This module:
- * 1. Detects prefix clusters among skill names.
- * 2. Builds the consolidation prompt for the LLM review agent.
- * 3. Parses structured LLM output into actionable merge/prune plans.
- * 4. Reconciles LLM intent against ground truth (existing skills).
- *
- * No I/O — the caller invokes the LLM and applies the results.
- */
-/** A skill summary fed to the LLM reviewer. */
-export interface ConsolidationSkillSummary {
-    name: string;
-    description: string;
-    /** Comma-separated tool names the skill uses. */
-    tools: string;
-    useCount: number;
-    lastActivityAt: string | null;
-    state: "active" | "stale";
-}
-/** A single consolidation action proposed by the LLM. */
-export interface ConsolidationAction {
-    /** Source skill to be absorbed. */
-    sourceSkill: string;
-    /** Target umbrella skill (existing or to-be-created). */
-    targetUmbrella: string;
-    /** Whether the target umbrella already exists. */
-    targetExists: boolean;
-    /** LLM's reason for the merge. */
-    reason: string;
-}
-/** A single pruning action proposed by the LLM. */
-export interface PruningAction {
-    /** Skill to be archived (not deleted). */
-    skillName: string;
-    /** Reason for pruning. */
-    reason: string;
-}
-/** Full consolidation plan produced by parsing LLM output. */
-export interface ConsolidationPlan {
-    consolidations: ConsolidationAction[];
-    prunings: PruningAction[];
-    /** Skills mentioned by LLM but not found in ground truth. */
-    hallucinations: string[];
-}
-/** Result of reconciling the LLM plan against ground truth. */
-export interface ReconciledConsolidationPlan {
-    /** Validated consolidation actions (targets exist or are marked for creation). */
-    validConsolidations: ConsolidationAction[];
-    /** Validated pruning actions (skills exist). */
-    validPrunings: PruningAction[];
-    /** Rejected actions due to ground-truth mismatch. */
-    rejected: Array<{
-        action: string;
-        reason: string;
-    }>;
-}
-/** A detected cluster of skills sharing a naming prefix. */
-export interface SkillPrefixCluster {
-    prefix: string;
-    skills: string[];
-}
-/**
- * Detect prefix clusters among skill names.
- *
- * A cluster is ≥2 skills sharing a common hyphenated prefix of ≥2 chars.
- * E.g. `["pr-review", "pr-merge", "pr-label"]` → cluster `"pr"`.
- */
-export declare function detectPrefixClusters(skillNames: readonly string[], minClusterSize?: number): SkillPrefixCluster[];
-/**
- * Build the consolidation review prompt for the LLM curator agent.
- *
- * The prompt instructs the model to:
- * 1. Identify prefix clusters and overlapping skills.
- * 2. Propose umbrella consolidations.
- * 3. Mark redundant/trivial skills for pruning (archive, not delete).
- * 4. Output a structured YAML block.
- */
-export declare function buildConsolidationPrompt(candidates: readonly ConsolidationSkillSummary[], existingUmbrellas: readonly string[], clusters: readonly SkillPrefixCluster[]): string;
-/**
- * Parse the LLM's structured YAML response into a ConsolidationPlan.
- *
- * Tolerant: handles minor formatting variations, ignores unknown fields.
- */
-export declare function parseConsolidationOutput(llmOutput: string, knownSkills: ReadonlySet<string>): ConsolidationPlan;
-/**
- * Reconcile the LLM's consolidation plan against ground truth.
- *
- * Validates that:
- * - Source skills exist and aren't already consolidated in this plan.
- * - Target umbrellas either exist or are new (will be created).
- * - Pruning targets aren't also being consolidated.
- */
-export declare function reconcileConsolidationPlan(plan: ConsolidationPlan, knownSkills: ReadonlySet<string>): ReconciledConsolidationPlan;
-/** Summary of a curator review run. */
-export interface CuratorRunReport {
-    /** ISO-8601 timestamp of the run. */
-    runAt: string;
-    /** Duration in seconds. */
-    durationSeconds: number;
-    /** Number of skills checked for lifecycle transitions. */
-    autoTransitionsChecked: number;
-    /** Number of skills marked stale. */
-    autoMarkedStale: number;
-    /** Number of skills archived. */
-    autoArchived: number;
-    /** Number of skills reactivated. */
-    autoReactivated: number;
-    /** Number of LLM-proposed consolidations accepted. */
-    consolidationsAccepted: number;
-    /** Number of LLM-proposed prunings accepted. */
-    pruningsAccepted: number;
-    /** Number of LLM-proposed actions rejected. */
-    actionsRejected: number;
-    /** Number of hallucinated skill names. */
-    hallucinations: number;
-}
-/**
- * Build a human-readable summary from a curator run report.
- */
-export declare function buildCuratorRunSummary(report: CuratorRunReport): string;

package/dist/types/orchestration/skill-similarity.d.ts

@@ -1,98 +0,0 @@
-/**
- * Skill similarity — pure strategy for detecting near-duplicate skills
- * before creation and during curator consolidation reviews.
- *
- * Computes multi-signal similarity between skills:
- * 1. Tool-set Jaccard overlap (primary signal for auto-generated skills)
- * 2. Title/description cosine bigram similarity (complementary signal)
- * 3. Step-count proximity (minor signal for workflow complexity)
- *
- * No I/O — all functions are pure.
- */
-/** Minimal skill profile for similarity comparison. */
-export interface SkillSimilarityProfile {
-    skillKey: string;
-    title: string;
-    tools: readonly string[];
-    stepCount?: number;
-}
-/** Result of a pairwise similarity comparison. */
-export interface SimilarityScore {
-    /** Overall similarity [0, 1]. */
-    overall: number;
-    /** Tool-set Jaccard index [0, 1]. */
-    toolJaccard: number;
-    /** Title bigram similarity [0, 1]. */
-    titleSimilarity: number;
-    /** Step-count proximity [0, 1]. */
-    stepProximity: number;
-}
-/** A candidate detected as similar during pre-creation check. */
-export interface SimilarSkillMatch {
-    existingSkillKey: string;
-    score: SimilarityScore;
-}
-/** Policy for similarity thresholds. */
-export interface SkillSimilarityPolicy {
-    /**
-     * Overall similarity threshold to block creation and emit "improve"
-     * instead. Default: 0.75.
-     */
-    blockCreationThreshold: number;
-    /**
-     * Overall similarity threshold to flag for curator review.
-     * Default: 0.55.
-     */
-    curatorReviewThreshold: number;
-    /** Weight of toolJaccard in overall score. Default: 0.60. */
-    toolWeight: number;
-    /** Weight of titleSimilarity in overall score. Default: 0.30. */
-    titleWeight: number;
-    /** Weight of stepProximity in overall score. Default: 0.10. */
-    stepWeight: number;
-}
-export declare const DEFAULT_SKILL_SIMILARITY_POLICY: SkillSimilarityPolicy;
-/**
- * Compute Jaccard index between two tool sets.
- * Returns 0 if both sets are empty.
- */
-export declare function toolSetJaccard(toolsA: readonly string[], toolsB: readonly string[]): number;
-/**
- * Compute character-bigram similarity between two strings.
- * Uses Dice coefficient of bigram sets.
- */
-export declare function bigramSimilarity(a: string, b: string): number;
-/**
- * Compute step-count proximity [0, 1].
- * Returns 1 when counts are identical, decreases with difference.
- */
-export declare function stepCountProximity(stepsA: number | undefined, stepsB: number | undefined): number;
-/**
- * Compute overall similarity between two skill profiles.
- */
-export declare function computeSimilarity(a: SkillSimilarityProfile, b: SkillSimilarityProfile, policy?: Partial<SkillSimilarityPolicy>): SimilarityScore;
-/**
- * Check a new skill candidate against existing skills for similarity.
- *
- * Returns all existing skills above curatorReviewThreshold, sorted
- * by descending similarity. The caller should:
- * - Block creation if any match ≥ blockCreationThreshold (emit improve instead)
- * - Tag for curator review if match ≥ curatorReviewThreshold
- */
-export declare function findSimilarSkills(newSkill: SkillSimilarityProfile, existingSkills: readonly SkillSimilarityProfile[], policy?: Partial<SkillSimilarityPolicy>): SimilarSkillMatch[];
-/**
- * Determine creation decision based on similarity matches.
- */
-export type SimilarityDecision = {
-    action: "create";
-    reason: string;
-} | {
-    action: "improve";
-    targetSkillKey: string;
-    reason: string;
-} | {
-    action: "flag-for-review";
-    targetSkillKey: string;
-    reason: string;
-};
-export declare function decideSimilarityAction(matches: readonly SimilarSkillMatch[], policy?: Partial<SkillSimilarityPolicy>): SimilarityDecision;

package/dist/types/orchestration/team-orchestration.d.ts

@@ -1,195 +0,0 @@
-/**
- * Team Orchestration Strategy — multi-agent coordination layer.
- *
- * Extends the existing sidechain foundation with team/swarm semantics:
- * - Parallel agent spawning (multiple sidechains at once)
- * - Role-based agent assignment (planner / executor / reviewer)
- * - Shared knowledge pool via merge policies
- * - Budget-aware concurrency limits
- * - Lifecycle state machine for team coordination
- *
- * Architecture:
- *   Gateway ─── Hub ─── orchestration (this module, pure strategy)
- *                │
- *   ┌───────────┼───────────┐
- *   │   TeamCoordinator     │  ← Hub runtime (multi-sidechain-coordinator.ts)
- *   │   │                   │
- *   │   ├── Agent #1 (planner)
- *   │   ├── Agent #2 (executor)
- *   │   └── Agent #3 (reviewer)
- *   └───────────────────────┘
- *
- * This module provides:
- * 1. Type definitions (TeamPlan, AgentRole, TeamLifecycle)
- * 2. Pure strategy functions (plan resolution, role assignment, budget allocation)
- * 3. Merge/aggregation policies (how agent results combine)
- *
- * Hub consumes these types and strategy functions in its coordinator runtime.
- * Gateway consumes TeamPlan to spawn/manage multiple sidechain executions.
- */
-import type { SidechainType, SidechainMergePolicy, SidechainBudgetTier, SidechainToolAccessMode } from "./index.js";
-/** Roles an agent can take within a team execution. */
-export type AgentRole = "planner" | "executor" | "reviewer" | "researcher" | "custom";
-/** Execution mode for a team. */
-export type TeamExecutionMode = "parallel" | "sequential" | "pipeline" | "adaptive";
-/** How team results are aggregated into the parent execution. */
-export type TeamAggregationPolicy = "first-success" | "majority-vote" | "merge-all" | "reviewer-gate" | "planner-sync";
-/** Current lifecycle state of a team execution. */
-export type TeamLifecycleState = "planning" | "spawning" | "executing" | "aggregating" | "reviewing" | "completed" | "failed" | "cancelled";
-/** Specification for a single agent within a team. */
-export interface TeamAgentSpec {
-    /** Unique ID within the team (e.g., "agent-1", "researcher-a"). */
-    agentId: string;
-    /** Role this agent plays. */
-    role: AgentRole;
-    /** Human-readable label for tracing. */
-    label: string;
-    /** The sidechain type this agent maps to. */
-    sidechainType: SidechainType;
-    /** Task description / system prompt override for this agent. */
-    taskDescription: string;
-    /** Tool access mode for this agent's sidechain. */
-    toolAccessMode: SidechainToolAccessMode;
-    /** Budget tier for this agent. */
-    budgetTier: SidechainBudgetTier;
-    /** Which agents this one depends on (for sequential/pipeline modes). */
-    dependsOn: string[];
-    /** Maximum tokens this agent can consume. */
-    maxTokenBudget: number;
-    /** Maximum tool calls this agent can make. */
-    maxToolCalls: number;
-    /** Timeout in milliseconds (0 = inherit from team). */
-    timeoutMs: number;
-}
-/** A complete team execution plan. */
-export interface TeamPlan {
-    /** Unique team execution ID. */
-    teamId: string;
-    /** Execution mode for this team. */
-    mode: TeamExecutionMode;
-    /** How results from all agents are aggregated. */
-    aggregationPolicy: TeamAggregationPolicy;
-    /** All agent specs in this team. */
-    agents: TeamAgentSpec[];
-    /** Maximum concurrent agent executions (0 = unlimited). */
-    maxConcurrency: number;
-    /** Team-level timeout in ms (0 = no timeout). */
-    timeoutMs: number;
-    /** Total token budget across all agents. */
-    totalTokenBudget: number;
-    /** Whether early termination is allowed when one agent fails. */
-    failFast: boolean;
-    /** Shared context provided to all agents. */
-    sharedContext: string;
-    /** Merge policy for the final team output back to parent. */
-    mergePolicy: SidechainMergePolicy;
-}
-/** Result from a single agent within a team. */
-export interface TeamAgentResult {
-    agentId: string;
-    role: AgentRole;
-    status: "completed" | "failed" | "cancelled" | "timeout";
-    output: string;
-    tokenUsage: {
-        prompt: number;
-        completion: number;
-    };
-    toolCallCount: number;
-    durationMs: number;
-    error?: string;
-}
-/** Aggregated result from team execution. */
-export interface TeamResult {
-    teamId: string;
-    state: TeamLifecycleState;
-    agentResults: TeamAgentResult[];
-    aggregatedOutput: string;
-    totalTokenUsage: {
-        prompt: number;
-        completion: number;
-    };
-    totalDurationMs: number;
-}
-/** Maximum agents allowed in a team (safety bound). */
-export declare const TEAM_MAX_AGENTS = 8;
-/** Maximum recursion depth (teams spawning teams). */
-export declare const TEAM_MAX_DEPTH = 2;
-/**
- * Resolve a team plan from a high-level task decomposition.
- *
- * This is the main entry point: given a set of subtasks and constraints,
- * produce a concrete TeamPlan that the coordinator can execute.
- */
-export declare function resolveTeamPlan(params: {
-    teamId: string;
-    subtasks: Array<{
-        id: string;
-        role: AgentRole;
-        label: string;
-        task: string;
-        dependsOn?: string[];
-    }>;
-    mode?: TeamExecutionMode;
-    aggregationPolicy?: TeamAggregationPolicy;
-    totalTokenBudget?: number;
-    timeoutMs?: number;
-    failFast?: boolean;
-    sharedContext?: string;
-    mergePolicy?: SidechainMergePolicy;
-}): TeamPlan;
-/**
- * Map agent role to sidechain type for existing Hub plumbing compatibility.
- */
-export declare function mapRoleToSidechainType(role: AgentRole): SidechainType;
-/**
- * Resolve tool access mode for a given role.
- */
-export declare function resolveAgentToolAccess(role: AgentRole): SidechainToolAccessMode;
-/**
- * Allocate token budgets proportionally by role weight.
- */
-export declare function allocateTokenBudgets(agents: TeamAgentSpec[], totalBudget: number): TeamAgentSpec[];
-/**
- * Infer execution mode from agent dependency graph.
- */
-export declare function inferExecutionMode(agents: TeamAgentSpec[]): TeamExecutionMode;
-/**
- * Infer aggregation policy from mode and agent composition.
- */
-export declare function inferAggregationPolicy(mode: TeamExecutionMode, agents: TeamAgentSpec[]): TeamAggregationPolicy;
-/**
- * Determine the execution order for agents given their dependency graph.
- * Returns groups of agent IDs that can execute concurrently.
- *
- * Example: [[planner], [executor-a, executor-b], [reviewer]]
- */
-export declare function resolveExecutionOrder(agents: TeamAgentSpec[]): string[][];
-/**
- * Aggregate team results into a single output string.
- */
-export declare function aggregateTeamResults(results: TeamAgentResult[], policy: TeamAggregationPolicy): string;
-/**
- * Validate a team plan before execution.
- * Returns a list of issues (empty = valid).
- */
-export declare function validateTeamPlan(plan: TeamPlan): string[];
-/**
- * Determine if a team execution should be cancelled early based on current state.
- */
-export declare function shouldCancelTeam(params: {
-    plan: TeamPlan;
-    results: TeamAgentResult[];
-    elapsedMs: number;
-}): {
-    cancel: boolean;
-    reason: string;
-};
-/**
- * Build the task prompt for a specific agent, incorporating shared context
- * and outputs from dependency agents.
- */
-export declare function buildAgentTaskPrompt(params: {
-    agent: TeamAgentSpec;
-    plan: TeamPlan;
-    dependencyResults: TeamAgentResult[];
-}): string;