@nanmicoder/dsh-agent-teams 0.1.12 → 0.1.14

package/lib/types/client/ActivityPanel.d.ts

@@ -16,6 +16,7 @@
  * always-available monitor.
  * @module dsh-agent-teams/client/activity
  */
+import type { ModelDirectoryResolver } from '@deepseek-ai/dsh-client-ui-model-selection/client';
 import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
 import type { SessionId } from '@deepseek-ai/dsh-session/types';
 import type { ObservableSnapshot, SessionListState } from '@deepseek-ai/dsh-client-runtime/client';
@@ -24,6 +25,7 @@ import type { ObservableSnapshot, SessionListState } from '@deepseek-ai/dsh-clie
  * session is the one currently open. */
 export type ActivityPanelProps = {
     readonly sessionsList: ObservableSnapshot<SessionListState>;
+    readonly modelDirectories: ModelDirectoryResolver;
     readonly openMember: (parentId: SessionId, childId: SessionId) => void;
 } & PropsLocale<'agentTeams'>;
-export declare function ActivityPanel({ sessionsList, openMember, t }: ActivityPanelProps): import("react").JSX.Element | null;
+export declare function ActivityPanel({ sessionsList, modelDirectories, openMember, t }: ActivityPanelProps): import("react").JSX.Element | null;

package/lib/types/client/StagingPlanEditor.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Editable pre-run roster and DAG review for staged AgentTeams plans.
+ *
+ * This leaf owns only transient form/disclosure state. Durable truth remains
+ * on the host and returns through the ordinary activity polling snapshot.
+ * @module dsh-agent-teams/client/staging-plan
+ */
+import type { ModelDirectory } from '@deepseek-ai/dsh-client-ui-model-selection/client';
+import type { ActivityTeam } from './activity-monitor.ts';
+import type { AgentTeamsTranslate } from './locales.ts';
+export declare function StagingPlanEditor({ team, modelDirectory, onContinuePlanning, onDiscarded, t }: {
+    readonly team: ActivityTeam;
+    readonly modelDirectory: ModelDirectory;
+    readonly onContinuePlanning: () => void;
+    readonly onDiscarded: () => void;
+    readonly t: AgentTeamsTranslate;
+}): import("react").JSX.Element;

package/lib/types/client/activity-model.d.ts

@@ -34,6 +34,59 @@ export declare const COMPACT_DAG_NODE_WIDTH = 92;
 export declare const COMPACT_DAG_NODE_HEIGHT = 30;
 export declare const COMPACT_DAG_COLUMN_GAP = 26;
 export declare const COMPACT_DAG_ROW_GAP = 8;
+/** Compact `provider/model` route, or just the model when the provider is absent. */
+export declare function memberRouteLabel(member: {
+    readonly provider?: string;
+    readonly model?: string;
+} | undefined): string;
+/**
+ * Compact route shown on a running task. Prefer the task's own snapshot
+ * field; fall back to the assignee member when older hosts omit it.
+ */
+export declare function taskModelLabel(task: {
+    readonly model?: string;
+    readonly assignee: string;
+}, members: readonly {
+    readonly name: string;
+    readonly provider?: string;
+    readonly model?: string;
+}[]): string;
+/** Short model id for tight DAG/chip surfaces (`openai/gpt-5.6-sol` → `gpt-5.6-sol`). */
+export declare function compactModelLabel(route: string): string;
+/** A live team the current captain still owns and has not halted. */
+export declare function liveCaptainTeam<T extends {
+    readonly captainSessionId: string;
+    readonly halted?: boolean;
+}>(teams: readonly T[], sessionId: string | undefined): T | undefined;
+/** Whether the captain chat should keep showing the in-progress banner. */
+export declare function teamIsActive(team: {
+    readonly phase?: string;
+    readonly halted?: boolean;
+    readonly members: readonly {
+        readonly status?: string;
+        readonly activity?: string;
+    }[];
+    readonly tasks: readonly {
+        readonly status: string;
+    }[];
+}): boolean;
+/** Compact banner copy: running members, otherwise the current planning state. */
+export declare function teamProgressSummary(team: {
+    readonly members: readonly {
+        readonly name: string;
+        readonly status?: string;
+        readonly activity?: string;
+        readonly currentTask?: string;
+    }[];
+    readonly tasks: readonly {
+        readonly id: string;
+        readonly subject: string;
+        readonly status: string;
+    }[];
+}, separator: string): {
+    readonly working: number;
+    readonly detail: string;
+};
 /** Use a fill-width grid when the task graph has no real dependency edges. */
 export declare function usesParallelTaskGrid<T extends RelationshipTask>(tasks: readonly T[]): boolean;
 /**
@@ -45,6 +98,20 @@ export declare function usesParallelTaskGrid<T extends RelationshipTask>(tasks:
  * while its local open state is being reset.
  */
 export declare function activityPanelExpandedForSession(open: boolean, owner: string | undefined, current: string | undefined): boolean;
+/** Inputs for deciding whether genuinely new live work may expand the panel. */
+export interface ActivityPanelAutoExpandInput {
+    readonly alreadyAutoOpened: boolean;
+    readonly pageSettled: boolean;
+    readonly restoreComplete: boolean;
+    readonly previousLiveTeamIds: ReadonlySet<string>;
+    readonly currentLiveTeamIds: readonly string[];
+}
+/**
+ * Auto-expand only for live teams that appear after the current session's
+ * initial restore pass. Replayed cards, archived teams, and live teams restored
+ * while reopening a conversation must remain behind the collapsed badge.
+ */
+export declare function activityPanelShouldAutoExpand({ alreadyAutoOpened, pageSettled, restoreComplete, previousLiveTeamIds, currentLiveTeamIds, }: ActivityPanelAutoExpandInput): boolean;
 /**
  * Resolve the task whose dependency chain should be highlighted.
  *

package/lib/types/client/activity-monitor.d.ts

@@ -4,6 +4,10 @@ export interface ActivityMember {
     readonly id: string;
     readonly name: string;
     readonly role: string;
+    readonly provider?: string;
+    readonly model?: string;
+    readonly reasoningEffort?: string;
+    readonly executionPrompt?: string;
     readonly status?: 'idle' | 'working' | 'removed';
     readonly activity: 'working' | 'idle' | 'unknown';
     readonly progress: number;
@@ -16,11 +20,16 @@ export interface ActivityMember {
 export interface ActivityTask {
     readonly id: string;
     readonly subject: string;
+    readonly description?: string;
     readonly status: string;
-    readonly state: 'blocked' | 'open' | 'running' | 'completed';
+    readonly state: 'blocked' | 'open' | 'running' | 'completed' | 'failed' | 'cancelled';
     readonly assignee: string;
+    readonly model?: string;
     readonly dependencies: readonly string[];
     readonly depth: number;
+    readonly kind?: string;
+    readonly round?: number;
+    readonly verdict?: string;
 }
 /** One captain-inbox preview row. */
 export interface ActivityMessage {
@@ -34,6 +43,9 @@ export interface ActivityTeam {
     readonly name: string;
     readonly description?: string;
     readonly captainSessionId: string;
+    readonly phase: 'staged' | 'running';
+    readonly planReviewState?: 'awaiting_review' | 'awaiting_feedback';
+    readonly halted?: boolean;
     readonly members: readonly ActivityMember[];
     readonly tasks: readonly ActivityTask[];
     readonly messageCount: number;
@@ -71,8 +83,16 @@ export declare function getActivitySnapshotsSnapshot(): ActivitySnapshots;
 export declare function updateActivitySnapshots(update: Partial<ActivitySnapshots>): void;
 /** Poll cadence for the live host snapshot route. */
 export declare const ACTIVITY_POLL_MS = 1000;
+/**
+ * Low-frequency probe cadence while a cardless discovery session still owns
+ * no team. The probe keeps the panel able to pick up a team created later in
+ * that session (e.g. a run_code-wrapped agent_teams_create) without turning
+ * every ordinary session into a one-second filesystem scan.
+ */
+export declare const ACTIVITY_PROBE_MS = 5000;
 /** Host route serving live and archived team snapshots. */
 export declare const ACTIVITY_STATE_URL = "/plugins/dsh-agent-teams/state";
+export declare const ACTIVITY_HALT_URL = "/plugins/dsh-agent-teams/halt";
 interface ActivityFetchResponse {
     readonly ok: boolean;
     json(): Promise<unknown>;
@@ -105,12 +125,17 @@ export interface ActivityPollingController {
  * Start the single polling loop for the current session's requested targets.
  *
  * With neither targets nor a discovery session this is deliberately inert.
- * A discovery session performs one live+archive pass after selection/restart;
- * it keeps polling only while that captain still owns a live team. This
- * restores legacy/cardless history without turning every ordinary session
- * into a permanent one-second filesystem scan. Explicit card targets retain
- * the normal cadence, and archive state is refreshed when a target or a
- * previously discovered live team disappears.
+ * Explicit card targets poll at the live cadence from the start. A discovery
+ * session performs an immediate live+archive restore pass, then — while it
+ * still owns no team — probes on a low-frequency cadence, so a team created
+ * later in that session (e.g. a run_code-wrapped agent_teams_create) is
+ * discovered without a manual reload, without turning every ordinary session
+ * into a one-second filesystem scan. The moment a team for the discovery
+ * session appears, the controller upgrades to the live one-second cadence for
+ * the rest of its lifetime. The caller — the session view, which stops the
+ * controller when the session is no longer current — bounds the lifetime, and
+ * archive state is refreshed when a target or a previously discovered live
+ * team disappears.
  */
 export declare function startActivityPolling(monitorTargets: readonly ActivityMonitorTarget[], runtime?: ActivityPollingRuntime): ActivityPollingController;
 export {};

package/lib/types/client/locales.d.ts

@@ -13,6 +13,16 @@ export declare const zh: {
     'activity.dockRight': string;
     'activity.collapse': string;
     'activity.empty': string;
+    'team.stop': string;
+    'team.stopped': string;
+    'team.stopTitle': string;
+    'team.stopDescription': string;
+    'team.stopCancel': string;
+    'team.stopConfirm': string;
+    'team.stopping': string;
+    'team.stopFailed': string;
+    'team.stopRequestFailed': string;
+    'team.discarded': string;
     'format.listSeparator': string;
     'task.status.pending': string;
     'task.status.claimed': string;
@@ -20,6 +30,7 @@ export declare const zh: {
     'task.status.completed': string;
     'task.status.failed': string;
     'task.status.cancelled': string;
+    'task.status.notRun': string;
     'member.state.working': string;
     'member.state.failed': string;
     'member.state.waiting': string;
@@ -28,7 +39,11 @@ export declare const zh: {
     'member.state.removed': string;
     'member.state.pending': string;
     'member.state.unassigned': string;
+    'member.state.staged': string;
+    'member.state.notCreated': string;
+    'member.state.stopped': string;
     'member.status.executing': string;
+    'member.status.executingModel': string;
     'member.status.working': string;
     'member.status.waitingOn': string;
     'member.status.waitingPrerequisite': string;
@@ -36,14 +51,22 @@ export declare const zh: {
     'member.status.delivered': string;
     'member.status.idle': string;
     'member.status.unknown': string;
+    'member.status.staged': string;
+    'member.status.settled': string;
+    'member.status.discarded': string;
+    'member.status.stopped': string;
     'task.assignee.unclaimed': string;
     'task.summary.waitingBreakdown': string;
+    'task.summary.staged': string;
+    'task.summary.discarded': string;
     'task.summary.allDelivered': string;
+    'task.summary.ended': string;
     'task.summary.blockedAndRunning': string;
     'task.summary.more': string;
     'task.summary.running': string;
     'task.summary.ready': string;
     'task.summary.blocked': string;
+    'task.summary.failedSettled': string;
     'task.summary.waitingSchedule': string;
     'progress.aria': string;
     'progress.title': string;
@@ -57,13 +80,89 @@ export declare const zh: {
     'dependency.hint.chain': string;
     'dependency.hint.pinned': string;
     'task.runningAria': string;
+    'task.model': string;
+    'member.model': string;
     'task.detail.completed': string;
     'task.detail.noPrerequisite': string;
     'task.detail.ready': string;
     'task.detail.waitingOn': string;
+    'task.detail.notRun': string;
     'task.detail.noDownstream': string;
     'task.detail.unlocks': string;
     'team.ended': string;
+    'plan.badge': string;
+    'plan.title': string;
+    'plan.description': string;
+    'plan.member.role': string;
+    'plan.member.provider': string;
+    'plan.member.model': string;
+    'plan.member.reasoning': string;
+    'plan.member.reasoningHint': string;
+    'plan.model.choose': string;
+    'plan.model.currentUnavailable': string;
+    'plan.model.route': string;
+    'plan.model.defaultReasoning': string;
+    'plan.model.providerDefault': string;
+    'plan.model.modelDefault': string;
+    'plan.model.triggerAria': string;
+    'plan.model.back': string;
+    'plan.model.loading': string;
+    'plan.model.empty': string;
+    'plan.model.partialFailure': string;
+    'plan.model.retry': string;
+    'plan.member.prompt': string;
+    'plan.member.roleFallback': string;
+    'plan.task.subject': string;
+    'plan.task.description': string;
+    'plan.task.assignee': string;
+    'plan.task.dependencies': string;
+    'plan.task.dependenciesHint': string;
+    'plan.task.unassigned': string;
+    'plan.unsaved': string;
+    'plan.save': string;
+    'plan.saving': string;
+    'plan.remove': string;
+    'plan.removed': string;
+    'plan.removeConfirm': string;
+    'plan.removeWarning': string;
+    'plan.cancel': string;
+    'plan.addTask': string;
+    'plan.adding': string;
+    'plan.taskAdded': string;
+    'plan.newTask': string;
+    'plan.newTaskLabel': string;
+    'plan.readySummary': string;
+    'plan.flow.aria': string;
+    'plan.flow.review': string;
+    'plan.flow.spawn': string;
+    'plan.flow.run': string;
+    'plan.members.title': string;
+    'plan.members.count': string;
+    'plan.members.empty': string;
+    'plan.tasks.title': string;
+    'plan.tasks.count': string;
+    'plan.tasks.empty': string;
+    'plan.dependencies.none': string;
+    'plan.dependencies.count': string;
+    'plan.approve': string;
+    'plan.approving': string;
+    'plan.approveTitle': string;
+    'plan.approveHint': string;
+    'plan.approveConfirmTitle': string;
+    'plan.approveWarning': string;
+    'plan.approveConfirm': string;
+    'plan.continue': string;
+    'plan.returnToChat': string;
+    'plan.feedbackTitle': string;
+    'plan.feedbackHint': string;
+    'plan.discard': string;
+    'plan.discardConfirmTitle': string;
+    'plan.discardWarning': string;
+    'plan.discardConfirm': string;
+    'plan.discarding': string;
+    'plan.pendingEdits': string;
+    'plan.saved': string;
+    'plan.failed': string;
     'team.stats.members': string;
     'team.stats.completed': string;
     'team.stats.messages': string;
@@ -71,16 +170,28 @@ export declare const zh: {
     'captain.name': string;
     'captain.role': string;
     'captain.summary': string;
+    'captain.summary.staged': string;
+    'captain.summary.awaitingFeedback': string;
+    'captain.summary.discarded': string;
+    'captain.summary.withTakeover': string;
     'captain.state.working': string;
+    'captain.state.takeover': string;
     'captain.state.collected': string;
     'captain.state.waiting': string;
+    'captain.state.staged': string;
+    'captain.state.awaitingFeedback': string;
+    'captain.state.discarded': string;
+    'captain.state.settled': string;
     'members.toggle': string;
     'members.collapse': string;
     'members.expand': string;
     'members.empty': string;
     'assignment.label': string;
+    'assignment.staged': string;
+    'assignment.discarded': string;
     'assignment.empty': string;
     'archive.label': string;
+    'archive.discardedLabel': string;
 };
 /** AgentTeams namespace key union. */
 export type AgentTeamsLocaleKey = keyof typeof zh;
@@ -96,6 +207,16 @@ export declare const en: {
     'activity.dockRight': string;
     'activity.collapse': string;
     'activity.empty': string;
+    'team.stop': string;
+    'team.stopped': string;
+    'team.stopTitle': string;
+    'team.stopDescription': string;
+    'team.stopCancel': string;
+    'team.stopConfirm': string;
+    'team.stopping': string;
+    'team.stopFailed': string;
+    'team.stopRequestFailed': string;
+    'team.discarded': string;
     'format.listSeparator': string;
     'task.status.pending': string;
     'task.status.claimed': string;
@@ -103,6 +224,7 @@ export declare const en: {
     'task.status.completed': string;
     'task.status.failed': string;
     'task.status.cancelled': string;
+    'task.status.notRun': string;
     'member.state.working': string;
     'member.state.failed': string;
     'member.state.waiting': string;
@@ -111,7 +233,11 @@ export declare const en: {
     'member.state.removed': string;
     'member.state.pending': string;
     'member.state.unassigned': string;
+    'member.state.staged': string;
+    'member.state.notCreated': string;
+    'member.state.stopped': string;
     'member.status.executing': string;
+    'member.status.executingModel': string;
     'member.status.working': string;
     'member.status.waitingOn': string;
     'member.status.waitingPrerequisite': string;
@@ -119,14 +245,22 @@ export declare const en: {
     'member.status.delivered': string;
     'member.status.idle': string;
     'member.status.unknown': string;
+    'member.status.staged': string;
+    'member.status.settled': string;
+    'member.status.discarded': string;
+    'member.status.stopped': string;
     'task.assignee.unclaimed': string;
     'task.summary.waitingBreakdown': string;
+    'task.summary.staged': string;
+    'task.summary.discarded': string;
     'task.summary.allDelivered': string;
+    'task.summary.ended': string;
     'task.summary.blockedAndRunning': string;
     'task.summary.more': string;
     'task.summary.running': string;
     'task.summary.ready': string;
     'task.summary.blocked': string;
+    'task.summary.failedSettled': string;
     'task.summary.waitingSchedule': string;
     'progress.aria': string;
     'progress.title': string;
@@ -140,13 +274,89 @@ export declare const en: {
     'dependency.hint.chain': string;
     'dependency.hint.pinned': string;
     'task.runningAria': string;
+    'task.model': string;
+    'member.model': string;
     'task.detail.completed': string;
     'task.detail.noPrerequisite': string;
     'task.detail.ready': string;
     'task.detail.waitingOn': string;
+    'task.detail.notRun': string;
     'task.detail.noDownstream': string;
     'task.detail.unlocks': string;
     'team.ended': string;
+    'plan.badge': string;
+    'plan.title': string;
+    'plan.description': string;
+    'plan.member.role': string;
+    'plan.member.provider': string;
+    'plan.member.model': string;
+    'plan.member.reasoning': string;
+    'plan.member.reasoningHint': string;
+    'plan.model.choose': string;
+    'plan.model.currentUnavailable': string;
+    'plan.model.route': string;
+    'plan.model.defaultReasoning': string;
+    'plan.model.providerDefault': string;
+    'plan.model.modelDefault': string;
+    'plan.model.triggerAria': string;
+    'plan.model.back': string;
+    'plan.model.loading': string;
+    'plan.model.empty': string;
+    'plan.model.partialFailure': string;
+    'plan.model.retry': string;
+    'plan.member.prompt': string;
+    'plan.member.roleFallback': string;
+    'plan.task.subject': string;
+    'plan.task.description': string;
+    'plan.task.assignee': string;
+    'plan.task.dependencies': string;
+    'plan.task.dependenciesHint': string;
+    'plan.task.unassigned': string;
+    'plan.unsaved': string;
+    'plan.save': string;
+    'plan.saving': string;
+    'plan.remove': string;
+    'plan.removed': string;
+    'plan.removeConfirm': string;
+    'plan.removeWarning': string;
+    'plan.cancel': string;
+    'plan.addTask': string;
+    'plan.adding': string;
+    'plan.taskAdded': string;
+    'plan.newTask': string;
+    'plan.newTaskLabel': string;
+    'plan.readySummary': string;
+    'plan.flow.aria': string;
+    'plan.flow.review': string;
+    'plan.flow.spawn': string;
+    'plan.flow.run': string;
+    'plan.members.title': string;
+    'plan.members.count': string;
+    'plan.members.empty': string;
+    'plan.tasks.title': string;
+    'plan.tasks.count': string;
+    'plan.tasks.empty': string;
+    'plan.dependencies.none': string;
+    'plan.dependencies.count': string;
+    'plan.approve': string;
+    'plan.approving': string;
+    'plan.approveTitle': string;
+    'plan.approveHint': string;
+    'plan.approveConfirmTitle': string;
+    'plan.approveWarning': string;
+    'plan.approveConfirm': string;
+    'plan.continue': string;
+    'plan.returnToChat': string;
+    'plan.feedbackTitle': string;
+    'plan.feedbackHint': string;
+    'plan.discard': string;
+    'plan.discardConfirmTitle': string;
+    'plan.discardWarning': string;
+    'plan.discardConfirm': string;
+    'plan.discarding': string;
+    'plan.pendingEdits': string;
+    'plan.saved': string;
+    'plan.failed': string;
     'team.stats.members': string;
     'team.stats.completed': string;
     'team.stats.messages': string;
@@ -154,16 +364,28 @@ export declare const en: {
     'captain.name': string;
     'captain.role': string;
     'captain.summary': string;
+    'captain.summary.staged': string;
+    'captain.summary.awaitingFeedback': string;
+    'captain.summary.discarded': string;
+    'captain.summary.withTakeover': string;
     'captain.state.working': string;
+    'captain.state.takeover': string;
     'captain.state.collected': string;
     'captain.state.waiting': string;
+    'captain.state.staged': string;
+    'captain.state.awaitingFeedback': string;
+    'captain.state.discarded': string;
+    'captain.state.settled': string;
     'members.toggle': string;
     'members.collapse': string;
     'members.expand': string;
     'members.empty': string;
     'assignment.label': string;
+    'assignment.staged': string;
+    'assignment.discarded': string;
     'assignment.empty': string;
     'archive.label': string;
+    'archive.discardedLabel': string;
 };
 /** Translation function consumed by pure view helpers. */
 export type AgentTeamsTranslate = (key: AgentTeamsLocaleKey, params?: Record<string, unknown>) => string;

package/lib/types/command.d.ts

@@ -1,70 +1,25 @@
-/**
- * The `/agent-teams` slash command and its plain-text gesture boundary.
- *
- * Two deterministic activation paths, mirroring the Harness skill pipeline
- * (`dsh-tool-skill` + the `ui-skill` client source):
- *
- * 1. **Host command** — `ctx.commands.register` publishes the closed-namespace
- *    `/agent-teams` command. The web GUI's slash menu (the Harness
- *    `ui-commands` client) lists it from the host catalog with the input
- *    hint; the argued line is claimed client-side and executed through
- *    `command.execute`. The handler replays that exact line as an ordinary
- *    user follow-up (`agent.followup`) so it remains visible in the chat; the
- *    gesture boundary then adds the deterministic activation message.
- * 2. **Gesture boundary** — a `agent/pre-step` listener recognizes a leading
- *    `/agent-teams` token in genuine user messages and injects the same
- *    activation message. This covers surfaces with no command adjudication
- *    (headless CLI, API, pasted text in plain composers) and also handles the
- *    exact user line replayed by the host command. Mid-sentence mentions stay
- *    ordinary prose; only `source.kind === 'user'` messages are scanned, so
- *    injected or external text cannot forge the gesture.
- *
- * @module dsh-agent-teams/command
- */
 import type { Context } from '@deepseek-ai/cordis';
 import { type UserMessage } from '@deepseek-ai/dsh-llm';
-/** The slash command name (without the leading slash). */
+import { type TeamProfileConfig, type AgentTeamsInvocation } from './profiles.ts';
 export declare const AGENT_TEAMS_COMMAND = "agent-teams";
 declare module '@deepseek-ai/dsh-llm' {
     interface MessageSourceMap {
-        /**
-         * A deterministic `/agent-teams` activation injected after the visible
-         * user-authored slash line.
-         */
         'agent-teams-command': {
             readonly kind: 'agent-teams-command';
-            /** The user-supplied goal text (absent when the gesture was bare). */
             readonly goal?: string;
+            readonly profile?: string;
         };
     }
 }
 /**
- * The deterministic activation text. The system-prompt usage section owns
- * the full protocol; this message only switches it on for one concrete goal.
- * @param goal - the user-supplied goal, or `''` for a bare invocation.
- */
-export declare function buildActivationDirective(goal: string): string;
-/**
- * The goal of the latest start-anchored `/agent-teams` gesture in genuine
- * user messages, or `undefined` when no message carries one. `''` means a
- * bare `/agent-teams` token with no goal.
- * @param messages - the step's claimed batch (user messages only scanned).
+ * Convert a configured profile key into a stable, closed-namespace command
+ * suffix. Only lowercase ASCII letters, digits and dashes are representable;
+ * this deliberately prevents accidental command aliases for ambiguous profile
+ * names such as `foo bar`, `foo_bar`, or non-ASCII keys.
  */
+export declare function profileCommandName(profileName: string): string | undefined;
+export declare function invokedAgentTeamsInvocation(messages: readonly UserMessage[], getProfiles?: () => Record<string, TeamProfileConfig>): AgentTeamsInvocation | undefined;
 export declare function invokedAgentTeamsGoal(messages: readonly UserMessage[]): string | undefined;
-/**
- * Register the closed-namespace `/agent-teams` host command. The handler
- * preserves the exact submitted slash line as an ordinary user follow-up;
- * the pre-step gesture boundary injects the activation directive and wakes
- * the captain deterministically. The registration rides the calling
- * context's fiber, so a disposed scope (HMR, plugin removal) unregisters the
- * command.
- * @param ctx - host context providing the `commands` registry.
- */
-export declare function registerAgentTeamsCommand(ctx: Context): void;
-/**
- * Install the `agent/pre-step` gesture boundary: a claimed user message
- * starting with `/agent-teams` gains the deterministic activation message
- * appended after every other injection, closest to the model's answer.
- * @param ctx - host context providing the `agent/pre-step` waterfall.
- */
-export declare function installAgentTeamsGestureBoundary(ctx: Context): void;
+export declare function buildActivationDirective(goal: string, profile?: string, taskPlanning?: 'captain' | 'seed'): string;
+export declare function registerAgentTeamsCommand(ctx: Context, getProfiles?: () => Record<string, TeamProfileConfig>): void;
+export declare function installAgentTeamsGestureBoundary(ctx: Context, getProfiles?: () => Record<string, TeamProfileConfig>): void;