@cleocode/contracts 2026.3.76 → 2026.4.0

package/dist/agent-registry.d.ts

@@ -18,6 +18,8 @@ export interface TransportConfig {
     wsUrl?: string;
     /** HTTP polling endpoint path (for HTTP polling transport). */
     pollEndpoint?: string;
+    /** Fallback API base URL (used when primary apiBaseUrl is unreachable). */
+    apiBaseUrlFallback?: string;
 }
 /** A registered agent's credentials and profile. */
 export interface AgentCredential {
@@ -37,6 +39,8 @@ export interface AgentCredential {
     capabilities: string[];
     /** Agent skills (e.g. ['coding', 'review', 'testing']). */
     skills: string[];
+    /** Transport type for agent connections. */
+    transportType: 'http' | 'sse' | 'websocket';
     /** Transport-specific configuration. */
     transportConfig: TransportConfig;
     /** Whether this agent is currently active. */

package/dist/agent-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-registry.d.ts","sourceRoot":"","sources":["../src/agent-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,oEAAoE;AACpE,MAAM,WAAW,eAAe;IAC9B,qEAAqE;IACrE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAMD,oDAAoD;AACpD,MAAM,WAAW,eAAe;IAC9B,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,MAAM,EAAE,MAAM,CAAC;IACf,4FAA4F;IAC5F,UAAU,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gDAAgD;IAChD,WAAW,EAAE,QAAQ,GAAG,cAAc,GAAG,SAAS,CAAC;IACnD,qEAAqE;IACrE,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,2DAA2D;IAC3D,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,wCAAwC;IACxC,eAAe,EAAE,eAAe,CAAC;IACjC,8CAA8C;IAC9C,QAAQ,EAAE,OAAO,CAAC;IAClB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD,oDAAoD;AACpD,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,2DAA2D;AAC3D,MAAM,WAAW,gBAAgB;IAC/B,uCAAuC;IACvC,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC,eAAe,EAAE,WAAW,GAAG,WAAW,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAEjG,sEAAsE;IACtE,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IAEtD,sDAAsD;IACtD,IAAI,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAE3D,qDAAqD;IACrD,MAAM,CACJ,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,SAAS,GAAG,WAAW,CAAC,CAAC,GAC/D,OAAO,CAAC,eAAe,CAAC,CAAC;IAE5B,8CAA8C;IAC9C,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvC,mFAAmF;IACnF,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAE5E,gFAAgF;IAChF,SAAS,IAAI,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IAE7C,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1C"}
+{"version":3,"file":"agent-registry.d.ts","sourceRoot":"","sources":["../src/agent-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,oEAAoE;AACpE,MAAM,WAAW,eAAe;IAC9B,qEAAqE;IACrE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2EAA2E;IAC3E,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAMD,oDAAoD;AACpD,MAAM,WAAW,eAAe;IAC9B,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,MAAM,EAAE,MAAM,CAAC;IACf,4FAA4F;IAC5F,UAAU,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gDAAgD;IAChD,WAAW,EAAE,QAAQ,GAAG,cAAc,GAAG,SAAS,CAAC;IACnD,qEAAqE;IACrE,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,2DAA2D;IAC3D,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,4CAA4C;IAC5C,aAAa,EAAE,MAAM,GAAG,KAAK,GAAG,WAAW,CAAC;IAC5C,wCAAwC;IACxC,eAAe,EAAE,eAAe,CAAC;IACjC,8CAA8C;IAC9C,QAAQ,EAAE,OAAO,CAAC;IAClB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD,oDAAoD;AACpD,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,2DAA2D;AAC3D,MAAM,WAAW,gBAAgB;IAC/B,uCAAuC;IACvC,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC,eAAe,EAAE,WAAW,GAAG,WAAW,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAEjG,sEAAsE;IACtE,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IAEtD,sDAAsD;IACtD,IAAI,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAE3D,qDAAqD;IACrD,MAAM,CACJ,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,SAAS,GAAG,WAAW,CAAC,CAAC,GAC/D,OAAO,CAAC,eAAe,CAAC,CAAC;IAE5B,8CAA8C;IAC9C,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvC,mFAAmF;IACnF,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAE5E,gFAAgF;IAChF,SAAS,IAAI,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IAE7C,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1C"}

package/dist/code-symbol.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Code symbol types for tree-sitter AST analysis.
+ *
+ * Used by the Smart Explore code analysis pipeline to represent
+ * parsed source code structures.
+ *
+ * @task T149
+ */
+/** Kind of code symbol extracted from AST. */
+export type CodeSymbolKind = 'function' | 'method' | 'class' | 'interface' | 'type' | 'enum' | 'variable' | 'constant' | 'module' | 'import' | 'export' | 'struct' | 'trait' | 'impl';
+/** A structured code symbol extracted from a source file via tree-sitter. */
+export interface CodeSymbol {
+    /** Symbol name (e.g. "parseFile", "HttpTransport"). */
+    name: string;
+    /** Kind of symbol. */
+    kind: CodeSymbolKind;
+    /** Start line (1-based). */
+    startLine: number;
+    /** End line (1-based). */
+    endLine: number;
+    /** File path (relative to project root). */
+    filePath: string;
+    /** Language of the source file. */
+    language: string;
+    /** Parent symbol name (e.g. class name for methods). */
+    parent?: string;
+    /** Whether the symbol is exported. */
+    exported?: boolean;
+    /** Function/method parameters (if applicable). */
+    parameters?: string[];
+    /** Return type annotation (if available). */
+    returnType?: string;
+    /** JSDoc/docstring summary (first line only). */
+    docSummary?: string;
+}
+/** Result of parsing a single file. */
+export interface ParseResult {
+    /** Source file path. */
+    filePath: string;
+    /** Detected language. */
+    language: string;
+    /** Extracted symbols. */
+    symbols: CodeSymbol[];
+    /** Parse errors (non-fatal). */
+    errors: string[];
+}
+/** Result of batch-parsing multiple files. */
+export interface BatchParseResult {
+    /** Per-file results. */
+    results: ParseResult[];
+    /** Files that were skipped (unsupported language). */
+    skipped: string[];
+    /** Total symbols found across all files. */
+    totalSymbols: number;
+}
+//# sourceMappingURL=code-symbol.d.ts.map

package/dist/code-symbol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-symbol.d.ts","sourceRoot":"","sources":["../src/code-symbol.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,8CAA8C;AAC9C,MAAM,MAAM,cAAc,GACtB,UAAU,GACV,QAAQ,GACR,OAAO,GACP,WAAW,GACX,MAAM,GACN,MAAM,GACN,UAAU,GACV,UAAU,GACV,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,MAAM,CAAC;AAEX,6EAA6E;AAC7E,MAAM,WAAW,UAAU;IACzB,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,IAAI,EAAE,cAAc,CAAC;IACrB,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,uCAAuC;AACvC,MAAM,WAAW,WAAW;IAC1B,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,gCAAgC;IAChC,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,8CAA8C;AAC9C,MAAM,WAAW,gBAAgB;IAC/B,wBAAwB;IACxB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,sDAAsD;IACtD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,4CAA4C;IAC5C,YAAY,EAAE,MAAM,CAAC;CACtB"}

package/dist/code-symbol.js

@@ -0,0 +1,10 @@
+/**
+ * Code symbol types for tree-sitter AST analysis.
+ *
+ * Used by the Smart Explore code analysis pipeline to represent
+ * parsed source code structures.
+ *
+ * @task T149
+ */
+export {};
+//# sourceMappingURL=code-symbol.js.map

package/dist/code-symbol.js.map

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

package/dist/index.d.ts

@@ -10,6 +10,7 @@ export type { AgentCredential, AgentListFilter, AgentRegistryAPI, TransportConfi
 export type { ArchiveCycleTimesReport, ArchiveDailyTrend, ArchivedTask, ArchiveLabelEntry, ArchiveMetadata, ArchiveMonthlyTrend, ArchivePhaseEntry, ArchivePriorityEntry, ArchiveReportType, ArchiveStatsEnvelope, ArchiveSummaryReport, ArchiveTrendsReport, CycleTimeDistribution, CycleTimePercentiles, } from './archive.js';
 export type { BrainEntryRef, BrainEntrySummary, ContradictionDetail, SupersededEntry, } from './brain.js';
 export type { AdapterCapabilities } from './capabilities.js';
+export type { BatchParseResult, CodeSymbol, CodeSymbolKind, ParseResult, } from './code-symbol.js';
 export type { Conduit, ConduitConfig, ConduitMessage, ConduitSendOptions, ConduitSendResult, ConduitState, ConduitStateChange, ConduitUnsubscribe, } from './conduit.js';
 export type { BackupConfig, BrainConfig, BrainEmbeddingConfig, BrainMemoryBridgeConfig, BrainSummarizationConfig, CleoConfig, ConfigSource, DateFormat, EnforcementProfile, HierarchyConfig, LifecycleConfig, LifecycleEnforcementMode, LoggingConfig, LogLevel, OutputConfig, OutputFormat, ResolvedValue, SessionConfig, SessionSummaryInput, SharingConfig, SharingMode, SignalDockConfig, SignalDockMode, } from './config.js';
 export type { AdapterContextMonitorProvider } from './context-monitor.js';
@@ -26,6 +27,7 @@ export { isGatewayEnvelope, isLafsError, isLafsSuccess, } from './lafs.js';
 export type { BridgeDecision, BridgeLearning, BridgeObservation, BridgePattern, MemoryBridgeConfig, MemoryBridgeContent, SessionSummary, } from './memory.js';
 export * as ops from './operations/index.js';
 export type { BrainState } from './operations/orchestrate.js';
+export { type AgentHierarchy, type AgentHierarchyEntry, type EscalationChain, type OrchestrationHierarchyAPI, OrchestrationLevel, } from './orchestration-hierarchy.js';
 export type { AdapterPathProvider } from './provider-paths.js';
 export type { BottleneckTask, CompleteTaskUnblocked, ContextResult, DashboardResult, LabelCount, LeveragedTask, LogQueryResult, SequenceResult, StatsActivityMetrics, StatsAllTime, StatsCompletionMetrics, StatsCurrentState, StatsCycleTimes, StatsResult, TaskAnalysisResult, TaskDepsResult, TaskRef, TaskRefPriority, TaskSummary, } from './results.js';
 export type { Session, SessionScope, SessionStartResult, SessionStats, SessionTaskWork, } from './session.js';

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -15,6 +15,8 @@ export { AGENT_INSTANCE_STATUSES, AGENT_TYPES, BRAIN_OBSERVATION_TYPES, } from '
 export { isGatewayEnvelope, isLafsError, isLafsSuccess, } from './lafs.js';
 // === Operations Types (API wire format, namespaced to avoid collision with domain types) ===
 export * as ops from './operations/index.js';
+// === Orchestration Hierarchy ===
+export { OrchestrationLevel, } from './orchestration-hierarchy.js';
 // === Session Types ===
 export { SessionView } from './session.js';
 // === Status Registry (MUST be first — everything depends on this) ===

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAsFH,0BAA0B;AAC1B,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,aAAa,EACb,WAAW,EACX,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,qBAAqB;AACrB,OAAO,EACL,QAAQ,EACR,eAAe,EACf,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,aAAa,GACd,MAAM,iBAAiB,CAAC;AA+BzB,gCAAgC;AAChC,OAAO,EACL,uBAAuB,EACvB,WAAW,EACX,uBAAuB,GACxB,MAAM,aAAa,CAAC;AA2BrB,8BAA8B;AAC9B,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,aAAa,GACd,MAAM,WAAW,CAAC;AAUnB,8FAA8F;AAC9F,OAAO,KAAK,GAAG,MAAM,uBAAuB,CAAC;AAkC7C,wBAAwB;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAa3C,uEAAuE;AACvE,OAAO,EACL,YAAY,EAIZ,aAAa,EAEb,aAAa,EACb,2BAA2B,EAC3B,wBAAwB,EACxB,iBAAiB;AAEjB,gBAAgB;AAChB,qBAAqB,EAErB,gBAAgB,EAEhB,kBAAkB,EAClB,eAAe,EAEf,yBAAyB,EACzB,2BAA2B;AAC3B,YAAY;AACZ,aAAa,EAGb,0BAA0B,EAC1B,uBAAuB;AACvB,sBAAsB;AACtB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AA6E9B,yCAAyC;AACzC,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA6FH,0BAA0B;AAC1B,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,aAAa,EACb,WAAW,EACX,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,qBAAqB;AACrB,OAAO,EACL,QAAQ,EACR,eAAe,EACf,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,aAAa,GACd,MAAM,iBAAiB,CAAC;AA+BzB,gCAAgC;AAChC,OAAO,EACL,uBAAuB,EACvB,WAAW,EACX,uBAAuB,GACxB,MAAM,aAAa,CAAC;AA2BrB,8BAA8B;AAC9B,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,aAAa,GACd,MAAM,WAAW,CAAC;AAUnB,8FAA8F;AAC9F,OAAO,KAAK,GAAG,MAAM,uBAAuB,CAAC;AAG7C,kCAAkC;AAClC,OAAO,EAKL,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AAgCtC,wBAAwB;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAa3C,uEAAuE;AACvE,OAAO,EACL,YAAY,EAIZ,aAAa,EAEb,aAAa,EACb,2BAA2B,EAC3B,wBAAwB,EACxB,iBAAiB;AAEjB,gBAAgB;AAChB,qBAAqB,EAErB,gBAAgB,EAEhB,kBAAkB,EAClB,eAAe,EAEf,yBAAyB,EACzB,2BAA2B;AAC3B,YAAY;AACZ,aAAa,EAGb,0BAA0B,EAC1B,uBAAuB;AACvB,sBAAsB;AACtB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AA6E9B,yCAAyC;AACzC,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC"}

package/dist/orchestration-hierarchy.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Orchestration Hierarchy — 5-level agent hierarchy types.
+ *
+ * Codifies the agent authority chain from ORCH-PLAN.md:
+ *   Level 0: HITL (Human-In-The-Loop) — Owner, final authority
+ *   Level 1: Prime Orchestrator — Cross-project coordination
+ *   Level 2: Project Lead — Project-level architecture decisions
+ *   Level 3: Team Lead — Team-level task management, can spawn ephemeral agents
+ *   Level 4: Ephemeral — Task-scoped agents spawned by Team Leads
+ *
+ * @see docs/specs/CLEO-ORCH-PLAN.md
+ * @task T217
+ */
+/** The 5 orchestration levels in order of authority. */
+export declare enum OrchestrationLevel {
+    /** Level 0: Human owner. Final authority. Never contacted by agents directly. */
+    HITL = 0,
+    /** Level 1: Prime Orchestrator. Cross-project coordination. Breaks ties. */
+    Prime = 1,
+    /** Level 2: Project Lead. Architecture decisions within a project. */
+    ProjectLead = 2,
+    /** Level 3: Team Lead. Task management. Can spawn ephemeral agents. */
+    TeamLead = 3,
+    /** Level 4: Ephemeral agent. Task-scoped, short-lived. */
+    Ephemeral = 4
+}
+/** An agent's position in the orchestration hierarchy. */
+export interface AgentHierarchyEntry {
+    /** The agent's unique ID (e.g. 'cleo-rust-lead'). */
+    agentId: string;
+    /** Display name for human-readable output. */
+    displayName: string;
+    /** The agent's orchestration level. */
+    level: OrchestrationLevel;
+    /** The agent's direct superior (null for HITL). */
+    reportsTo: string | null;
+    /** Agents this agent directly manages (empty for Ephemeral). */
+    manages: string[];
+    /** Project scope (null for cross-project agents like Prime). */
+    projectId: string | null;
+    /** Team scope within a project (e.g. 'cleocode', 'signaldock'). */
+    teamId: string | null;
+    /** Whether this agent can spawn ephemeral sub-agents. */
+    canSpawn: boolean;
+}
+/** The full agent hierarchy tree. */
+export interface AgentHierarchy {
+    /** All agents in the hierarchy, keyed by agentId. */
+    agents: Record<string, AgentHierarchyEntry>;
+    /** The Prime Orchestrator agent ID. */
+    primeId: string;
+    /** Project IDs in this hierarchy. */
+    projectIds: string[];
+}
+/** An escalation path from an agent to its authority chain. */
+export interface EscalationChain {
+    /** The requesting agent. */
+    fromAgentId: string;
+    /** Ordered list of agents to escalate to (nearest first). */
+    chain: string[];
+    /** The final authority (PRIME or HITL). */
+    finalAuthority: string;
+}
+/** API for querying and managing the agent hierarchy. */
+export interface OrchestrationHierarchyAPI {
+    /** Get the full hierarchy. */
+    getHierarchy(): AgentHierarchy;
+    /** Get a single agent's hierarchy entry. */
+    getAgent(agentId: string): AgentHierarchyEntry | null;
+    /** Get all agents at a specific level. */
+    getAgentsAtLevel(level: OrchestrationLevel): AgentHierarchyEntry[];
+    /** Get the escalation chain for an agent. */
+    getEscalationChain(agentId: string): EscalationChain;
+    /** Get all agents managed by a specific agent (direct reports). */
+    getDirectReports(agentId: string): AgentHierarchyEntry[];
+    /** Check if agent A has authority over agent B. */
+    hasAuthority(agentIdA: string, agentIdB: string): boolean;
+    /** Get all agents scoped to a project. */
+    getProjectAgents(projectId: string): AgentHierarchyEntry[];
+}
+//# sourceMappingURL=orchestration-hierarchy.d.ts.map

package/dist/orchestration-hierarchy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestration-hierarchy.d.ts","sourceRoot":"","sources":["../src/orchestration-hierarchy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,wDAAwD;AACxD,oBAAY,kBAAkB;IAC5B,iFAAiF;IACjF,IAAI,IAAI;IACR,4EAA4E;IAC5E,KAAK,IAAI;IACT,sEAAsE;IACtE,WAAW,IAAI;IACf,uEAAuE;IACvE,QAAQ,IAAI;IACZ,0DAA0D;IAC1D,SAAS,IAAI;CACd;AAMD,0DAA0D;AAC1D,MAAM,WAAW,mBAAmB;IAClC,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,KAAK,EAAE,kBAAkB,CAAC;IAC1B,mDAAmD;IACnD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,gEAAgE;IAChE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,gEAAgE;IAChE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,mEAAmE;IACnE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,yDAAyD;IACzD,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,qCAAqC;AACrC,MAAM,WAAW,cAAc;IAC7B,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IAC5C,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAMD,+DAA+D;AAC/D,MAAM,WAAW,eAAe;IAC9B,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,2CAA2C;IAC3C,cAAc,EAAE,MAAM,CAAC;CACxB;AAMD,yDAAyD;AACzD,MAAM,WAAW,yBAAyB;IACxC,8BAA8B;IAC9B,YAAY,IAAI,cAAc,CAAC;IAE/B,4CAA4C;IAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CAAC;IAEtD,0CAA0C;IAC1C,gBAAgB,CAAC,KAAK,EAAE,kBAAkB,GAAG,mBAAmB,EAAE,CAAC;IAEnE,6CAA6C;IAC7C,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAAC;IAErD,mEAAmE;IACnE,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,EAAE,CAAC;IAEzD,mDAAmD;IACnD,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAE1D,0CAA0C;IAC1C,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB,EAAE,CAAC;CAC5D"}

package/dist/orchestration-hierarchy.js

@@ -0,0 +1,31 @@
+/**
+ * Orchestration Hierarchy — 5-level agent hierarchy types.
+ *
+ * Codifies the agent authority chain from ORCH-PLAN.md:
+ *   Level 0: HITL (Human-In-The-Loop) — Owner, final authority
+ *   Level 1: Prime Orchestrator — Cross-project coordination
+ *   Level 2: Project Lead — Project-level architecture decisions
+ *   Level 3: Team Lead — Team-level task management, can spawn ephemeral agents
+ *   Level 4: Ephemeral — Task-scoped agents spawned by Team Leads
+ *
+ * @see docs/specs/CLEO-ORCH-PLAN.md
+ * @task T217
+ */
+// ============================================================================
+// Hierarchy levels
+// ============================================================================
+/** The 5 orchestration levels in order of authority. */
+export var OrchestrationLevel;
+(function (OrchestrationLevel) {
+    /** Level 0: Human owner. Final authority. Never contacted by agents directly. */
+    OrchestrationLevel[OrchestrationLevel["HITL"] = 0] = "HITL";
+    /** Level 1: Prime Orchestrator. Cross-project coordination. Breaks ties. */
+    OrchestrationLevel[OrchestrationLevel["Prime"] = 1] = "Prime";
+    /** Level 2: Project Lead. Architecture decisions within a project. */
+    OrchestrationLevel[OrchestrationLevel["ProjectLead"] = 2] = "ProjectLead";
+    /** Level 3: Team Lead. Task management. Can spawn ephemeral agents. */
+    OrchestrationLevel[OrchestrationLevel["TeamLead"] = 3] = "TeamLead";
+    /** Level 4: Ephemeral agent. Task-scoped, short-lived. */
+    OrchestrationLevel[OrchestrationLevel["Ephemeral"] = 4] = "Ephemeral";
+})(OrchestrationLevel || (OrchestrationLevel = {}));
+//# sourceMappingURL=orchestration-hierarchy.js.map

package/dist/orchestration-hierarchy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestration-hierarchy.js","sourceRoot":"","sources":["../src/orchestration-hierarchy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E,wDAAwD;AACxD,MAAM,CAAN,IAAY,kBAWX;AAXD,WAAY,kBAAkB;IAC5B,iFAAiF;IACjF,2DAAQ,CAAA;IACR,4EAA4E;IAC5E,6DAAS,CAAA;IACT,sEAAsE;IACtE,yEAAe,CAAA;IACf,uEAAuE;IACvE,mEAAY,CAAA;IACZ,0DAA0D;IAC1D,qEAAa,CAAA;AACf,CAAC,EAXW,kBAAkB,KAAlB,kBAAkB,QAW7B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleocode/contracts",
-  "version": "2026.3.76",
+  "version": "2026.4.0",
   "description": "Domain types, interfaces, and contracts for the CLEO ecosystem",
   "type": "module",
   "main": "./dist/index.js",

package/src/agent-registry.ts

@@ -23,6 +23,8 @@ export interface TransportConfig {
   wsUrl?: string;
   /** HTTP polling endpoint path (for HTTP polling transport). */
   pollEndpoint?: string;
+  /** Fallback API base URL (used when primary apiBaseUrl is unreachable). */
+  apiBaseUrlFallback?: string;
 }
 
 // ============================================================================
@@ -47,6 +49,8 @@ export interface AgentCredential {
   capabilities: string[];
   /** Agent skills (e.g. ['coding', 'review', 'testing']). */
   skills: string[];
+  /** Transport type for agent connections. */
+  transportType: 'http' | 'sse' | 'websocket';
   /** Transport-specific configuration. */
   transportConfig: TransportConfig;
   /** Whether this agent is currently active. */

package/src/code-symbol.ts

@@ -0,0 +1,73 @@
+/**
+ * Code symbol types for tree-sitter AST analysis.
+ *
+ * Used by the Smart Explore code analysis pipeline to represent
+ * parsed source code structures.
+ *
+ * @task T149
+ */
+
+/** Kind of code symbol extracted from AST. */
+export type CodeSymbolKind =
+  | 'function'
+  | 'method'
+  | 'class'
+  | 'interface'
+  | 'type'
+  | 'enum'
+  | 'variable'
+  | 'constant'
+  | 'module'
+  | 'import'
+  | 'export'
+  | 'struct'
+  | 'trait'
+  | 'impl';
+
+/** A structured code symbol extracted from a source file via tree-sitter. */
+export interface CodeSymbol {
+  /** Symbol name (e.g. "parseFile", "HttpTransport"). */
+  name: string;
+  /** Kind of symbol. */
+  kind: CodeSymbolKind;
+  /** Start line (1-based). */
+  startLine: number;
+  /** End line (1-based). */
+  endLine: number;
+  /** File path (relative to project root). */
+  filePath: string;
+  /** Language of the source file. */
+  language: string;
+  /** Parent symbol name (e.g. class name for methods). */
+  parent?: string;
+  /** Whether the symbol is exported. */
+  exported?: boolean;
+  /** Function/method parameters (if applicable). */
+  parameters?: string[];
+  /** Return type annotation (if available). */
+  returnType?: string;
+  /** JSDoc/docstring summary (first line only). */
+  docSummary?: string;
+}
+
+/** Result of parsing a single file. */
+export interface ParseResult {
+  /** Source file path. */
+  filePath: string;
+  /** Detected language. */
+  language: string;
+  /** Extracted symbols. */
+  symbols: CodeSymbol[];
+  /** Parse errors (non-fatal). */
+  errors: string[];
+}
+
+/** Result of batch-parsing multiple files. */
+export interface BatchParseResult {
+  /** Per-file results. */
+  results: ParseResult[];
+  /** Files that were skipped (unsupported language). */
+  skipped: string[];
+  /** Total symbols found across all files. */
+  totalSymbols: number;
+}

package/src/index.ts

@@ -40,6 +40,13 @@ export type {
   SupersededEntry,
 } from './brain.js';
 export type { AdapterCapabilities } from './capabilities.js';
+// === Code Symbol Types (tree-sitter AST) ===
+export type {
+  BatchParseResult,
+  CodeSymbol,
+  CodeSymbolKind,
+  ParseResult,
+} from './code-symbol.js';
 // === Conduit Protocol (agent-to-agent communication) ===
 export type {
   Conduit,
@@ -190,6 +197,14 @@ export type {
 export * as ops from './operations/index.js';
 // Commonly used ops types re-exported at top level for convenience
 export type { BrainState } from './operations/orchestrate.js';
+// === Orchestration Hierarchy ===
+export {
+  type AgentHierarchy,
+  type AgentHierarchyEntry,
+  type EscalationChain,
+  type OrchestrationHierarchyAPI,
+  OrchestrationLevel,
+} from './orchestration-hierarchy.js';
 export type { AdapterPathProvider } from './provider-paths.js';
 // === Result Types (Dashboard, Stats, Log, Context, Sequence, Analysis, Deps) ===
 export type {

package/src/orchestration-hierarchy.ts

@@ -0,0 +1,107 @@
+/**
+ * Orchestration Hierarchy — 5-level agent hierarchy types.
+ *
+ * Codifies the agent authority chain from ORCH-PLAN.md:
+ *   Level 0: HITL (Human-In-The-Loop) — Owner, final authority
+ *   Level 1: Prime Orchestrator — Cross-project coordination
+ *   Level 2: Project Lead — Project-level architecture decisions
+ *   Level 3: Team Lead — Team-level task management, can spawn ephemeral agents
+ *   Level 4: Ephemeral — Task-scoped agents spawned by Team Leads
+ *
+ * @see docs/specs/CLEO-ORCH-PLAN.md
+ * @task T217
+ */
+
+// ============================================================================
+// Hierarchy levels
+// ============================================================================
+
+/** The 5 orchestration levels in order of authority. */
+export enum OrchestrationLevel {
+  /** Level 0: Human owner. Final authority. Never contacted by agents directly. */
+  HITL = 0,
+  /** Level 1: Prime Orchestrator. Cross-project coordination. Breaks ties. */
+  Prime = 1,
+  /** Level 2: Project Lead. Architecture decisions within a project. */
+  ProjectLead = 2,
+  /** Level 3: Team Lead. Task management. Can spawn ephemeral agents. */
+  TeamLead = 3,
+  /** Level 4: Ephemeral agent. Task-scoped, short-lived. */
+  Ephemeral = 4,
+}
+
+// ============================================================================
+// Agent hierarchy membership
+// ============================================================================
+
+/** An agent's position in the orchestration hierarchy. */
+export interface AgentHierarchyEntry {
+  /** The agent's unique ID (e.g. 'cleo-rust-lead'). */
+  agentId: string;
+  /** Display name for human-readable output. */
+  displayName: string;
+  /** The agent's orchestration level. */
+  level: OrchestrationLevel;
+  /** The agent's direct superior (null for HITL). */
+  reportsTo: string | null;
+  /** Agents this agent directly manages (empty for Ephemeral). */
+  manages: string[];
+  /** Project scope (null for cross-project agents like Prime). */
+  projectId: string | null;
+  /** Team scope within a project (e.g. 'cleocode', 'signaldock'). */
+  teamId: string | null;
+  /** Whether this agent can spawn ephemeral sub-agents. */
+  canSpawn: boolean;
+}
+
+/** The full agent hierarchy tree. */
+export interface AgentHierarchy {
+  /** All agents in the hierarchy, keyed by agentId. */
+  agents: Record<string, AgentHierarchyEntry>;
+  /** The Prime Orchestrator agent ID. */
+  primeId: string;
+  /** Project IDs in this hierarchy. */
+  projectIds: string[];
+}
+
+// ============================================================================
+// Escalation chain
+// ============================================================================
+
+/** An escalation path from an agent to its authority chain. */
+export interface EscalationChain {
+  /** The requesting agent. */
+  fromAgentId: string;
+  /** Ordered list of agents to escalate to (nearest first). */
+  chain: string[];
+  /** The final authority (PRIME or HITL). */
+  finalAuthority: string;
+}
+
+// ============================================================================
+// Hierarchy API
+// ============================================================================
+
+/** API for querying and managing the agent hierarchy. */
+export interface OrchestrationHierarchyAPI {
+  /** Get the full hierarchy. */
+  getHierarchy(): AgentHierarchy;
+
+  /** Get a single agent's hierarchy entry. */
+  getAgent(agentId: string): AgentHierarchyEntry | null;
+
+  /** Get all agents at a specific level. */
+  getAgentsAtLevel(level: OrchestrationLevel): AgentHierarchyEntry[];
+
+  /** Get the escalation chain for an agent. */
+  getEscalationChain(agentId: string): EscalationChain;
+
+  /** Get all agents managed by a specific agent (direct reports). */
+  getDirectReports(agentId: string): AgentHierarchyEntry[];
+
+  /** Check if agent A has authority over agent B. */
+  hasAuthority(agentIdA: string, agentIdB: string): boolean;
+
+  /** Get all agents scoped to a project. */
+  getProjectAgents(projectId: string): AgentHierarchyEntry[];
+}