agents-united 0.12.0 → 0.13.0

package/dist/cli.d.ts

@@ -1,4 +1,5 @@
 type AgentHost = 'agents' | 'gemini' | 'claude' | 'cursor' | 'cline' | 'opencode' | 'codex';
+type BundleTier = 'domain' | 'organization';
 type ProjectionKind = 'role' | 'skill' | 'rule' | 'team-manifest' | 'workflow' | 'bridge' | 'plugin-manifest';
 interface ProjectionInfo {
     host: string;
@@ -23,5 +24,29 @@ interface InstallationSummaryOptions {
 }
 declare function formatInstallationSummary(options: InstallationSummaryOptions): string;
 declare function renderProjections(projections: ProjectionInfo[]): string;
+/** Why the Agent-Teams scaffold is on or off for a Claude session. */
+type ClaudeTeamsReason = 'explicit' | 'tier-default' | 'opt-out' | 'domain-tier' | 'unresolved-tier';
+interface ClaudeTeamsPosture {
+    /** Whether the ephemeral agent-teams scaffold will be injected into the spawned session. */
+    active: boolean;
+    reason: ClaudeTeamsReason;
+    /** The resolved bundle tier that drove the decision, when the bundle could be resolved. */
+    tier?: BundleTier;
+}
+/**
+ * Tier-aware Agent-Teams posture for `agents start --host claude` (Plan 016 decision 14 + the Tier-1/Tier-2
+ * split recorded in CONTEXT.md).
+ *
+ * - Tier 1 (`tier: 'domain'`) is a single-discipline hub-and-spoke team, so it keeps the ordinary
+ *   parallel-subagent model: teams stay opt-in via `--teams`.
+ * - Tier 2 (`tier: 'organization'`) is cross-functional by construction, so it runs with Agent Teams logic
+ *   by default. `--no-teams` (cac parses it into `options.teams === false`) is the explicit opt-out and
+ *   always wins over the tier default.
+ *
+ * Pure and exported so the `--dry-run` plan and the tests can assert the decision without spawning `claude`.
+ */
+declare function resolveClaudeTeamsPosture(teamsOption: boolean | undefined, tier: BundleTier | undefined): ClaudeTeamsPosture;
+/** One-line, honest explanation of why teams is on or off — shared by the live notice and `--dry-run`. */
+declare function describeClaudeTeamsPosture(posture: ClaudeTeamsPosture): string;
 
-export { type InstallationSummaryOptions, detectWorkspaceHosts, formatInstallationSummary, formatWrappedList, getTerminalContentWidth, renderProjections, wrapText };
+export { type ClaudeTeamsPosture, type ClaudeTeamsReason, type InstallationSummaryOptions, describeClaudeTeamsPosture, detectWorkspaceHosts, formatInstallationSummary, formatWrappedList, getTerminalContentWidth, renderProjections, resolveClaudeTeamsPosture, wrapText };