@excitedjs/dreamux-types 0.11.0-beta.264 → 0.11.0-beta.271

package/README.md

@@ -13,7 +13,8 @@ shared structural types.
 - **Declarations only.** The package emits `.d.ts` files (`emitDeclarationOnly`)
   and publishes a `types`-only `exports` map — there is no runtime JS contract
   surface to import as a value.
-- **No runtime dependencies.** `package.json` declares only dev tooling.
+- **One runtime dependency, `tapable`, by type only.** The plugin hook contract
+  is tapable's hook types; beyond it `package.json` declares only dev tooling.
 - **No host-private types.** Provider create contexts here are neutral; Dreamux
   core adapts its private objects (dispatcher rows, stores, identity records)
   into these public shapes rather than exposing them.
@@ -34,6 +35,9 @@ shared structural types.
   collaboration operations, and dispatcher-scoped read-only core event DTOs.
   Channel delivery receipts are status-only and the core event surface carries
   no service Turn submitted/settled events;
+- plugin contracts: `DreamuxPlugin`, its `ContributeHost` / `ServerHost`, the
+  hooked `Dispatcher` / `Team` faces, `LaunchDraft`, and the
+  `DreamuxPluginApis` map a plugin augments to type its published `api`;
 - a minimal public logger type (`DreamuxLogger`).
 
 It does **not** export runtime implementations, default loggers, loader logic,
@@ -83,6 +87,14 @@ A provider implements the full contract against this package only — see
 > (issue #209 slice 3). The public target published here is already stable for
 > external and built-in runtime/channel packages to author against.
 
+## Plugin loading contract
+
+A plugin factory returns its `DreamuxPlugin` synchronously; `config.read`
+synchronously validates the plugin's config. Returning a thenable fails loading
+with the ref or plugin name and phase. Loaded plugin names must be unique
+ignoring ASCII case, so `Foo` and `foo` cannot coexist. A single mixed-case
+name keeps its original API key and `state/plugins/<name>` spelling.
+
 ## Build / test
 
 Built and tested through the monorepo (rush) path — the only supported install

package/dist/activity.d.ts

@@ -0,0 +1,192 @@
+/**
+ * The Activity domain (declaration-only): what a runtime reports about what an
+ * agent did, in two distinct contracts.
+ *
+ * `RuntimeActivity` (with its `NativeActivity`/`RuntimeToolAction` support
+ * types) is the live, per-provider-detailed stream a runtime pushes through
+ * {@link AgentRuntimeActivitySink} while a turn is running. `AgentActivityRecord`
+ * (with `AgentActivityQuery`/`AgentActivityPage`/`AgentActivityReadContext`/
+ * `AgentActivityError`) is the neutral, minimal contract
+ * {@link AgentRuntimeProvider.readRecentActivity} replays from a cold
+ * session/rollout file. The two are deliberately not unified: a provider folds
+ * many submissions into one native turn, so live activity carries per-call
+ * detail (arguments, results, native ids) a cold replay never reconstructs,
+ * while a cold read exposes only the minimal shape every provider can honestly
+ * replay after the live runtime is gone. This module holds both because they
+ * are the same domain — what an agent did — read through the runtime's two
+ * different lifecycles, separate from `agent-runtime.ts`'s concern of
+ * launching and running a native session at all.
+ */
+import type { JsonValue } from './json.js';
+import type { DreamuxLogger } from './logger.js';
+/**
+ * What a tool invocation does, classified by the runtime that owns the tool
+ * vocabulary. `null` means the runtime has no such classification for this call.
+ */
+export type RuntimeToolAction = 'read' | 'list_files' | 'search' | 'edit' | 'run';
+/** A live fact identified by the native object it reports. */
+interface NativeActivity<K extends string> {
+    readonly kind: K;
+    readonly occurredAt: number;
+    /**
+     * The provider's own id, taken whole without a prefix, suffix, or counter.
+     * It identifies the native object, not a unique activity: a tool's start
+     * and result share its call id; usage and interruption share a turn id.
+     * A consumer derives row identity from kind (and tool status) plus this id.
+     */
+    readonly id: string;
+}
+/**
+ * One thing an agent's runtime did, in the runtime's own vocabulary.
+ *
+ * Keyed on the agent and nothing else. A provider folds any number of Dreamux
+ * submissions into one native turn, so an activity cannot honestly name the
+ * submission that caused it — and inventing one would make a display pick an
+ * arbitrary member. What a live surface needs is this agent's stream in order,
+ * which is what this is.
+ *
+ * A Channel receives this same type with every text and JSON payload member
+ * already redacted by Core. Core bounds nothing: each surface applies its
+ * own display limits where it sends.
+ */
+export type RuntimeActivity = (NativeActivity<'assistant.message'> & {
+    readonly text: string;
+})
+/**
+ * The runtime compacted its context. Carries no summary or compaction
+ * metadata. Live-only: the cold activity reader never produces this.
+ */
+ | NativeActivity<'context.compacted'>
+/**
+ * A display marker, not a terminal: a native turn stopped at an interrupt
+ * request. Reported from the native interrupted terminal, before its
+ * `token.usage` (when available) and paired `turn.ended` with status
+ * `interrupted`. Teardown reports `turn.ended` `interrupted` without this
+ * marker. Live-only: the cold activity reader never produces this.
+ */
+ | NativeActivity<'turn.interrupted'> | (NativeActivity<'tool.call'> & {
+    readonly toolName: string;
+    readonly action: RuntimeToolAction | null;
+    /**
+     * The call as the runtime's own UI labels it, in one line: a command's
+     * stated purpose, the path a file tool touches, the pattern a search
+     * runs, the task a sub-agent was given. `null` when the runtime has no
+     * label of its own for the tool, so a display falls back to the name.
+     */
+    readonly summary: string | null;
+    /**
+     * The call as a person would write it: the shell command line, the
+     * task text handed to a sub-agent, the script a runner executes.
+     * `arguments` is the tool's full structured input; this is the one
+     * member of it that has a notation of its own, so a display can show
+     * it in that notation instead of as JSON. `null` when there is none.
+     */
+    readonly invocation: string | null;
+    /**
+     * What the call is about, one entry per item, as the runtime reported
+     * it in structured members of the call: the path a file tool reads or
+     * writes, the paths of a patch, the files a parsed shell command read.
+     * Not limited to files: a runtime lists whatever discrete things its
+     * protocol names for the call. Empty when it names none; never
+     * recovered from a label or an output by parsing.
+     */
+    readonly items: readonly string[];
+    readonly status: 'started' | 'completed' | 'failed';
+    readonly arguments: JsonValue | null;
+    readonly result: JsonValue | null;
+    readonly error: string | null;
+})
+/**
+ * The native runtime's cumulative token counters for its live session,
+ * at the turn they were observed for. Runners that fold several native
+ * turns into one provider turn emit once on the native terminal with the
+ * latest snapshot, so one activity stands for one turn.
+ *
+ * Values are session-total as the runtime owns them, never turn deltas:
+ * a consumer derives a turn's consumption by differencing against the
+ * previous snapshot for this agent. The runtime keeps no history and
+ * performs no subtraction. Live-only: the cold activity reader never
+ * replays this, and a dropped snapshot simply widens the next delta.
+ */
+ | (NativeActivity<'token.usage'> & {
+    readonly inputTokens: number;
+    readonly outputTokens: number;
+    /** The last response's context footprint, and the native window when the runtime reports one; `null` when the runtime gives no context signal. */
+    readonly context: {
+        readonly usedTokens: number;
+        readonly windowTokens: number | null;
+    } | null;
+}) | {
+    /**
+     * The runtime stopped producing for the turn it was running, whatever
+     * that turn contained. `completed` is the runtime's own successful
+     * terminal; `failed` is a proven terminal error; `interrupted` is a
+     * native turn that ended without either, such as a stop or a protocol
+     * loss. `reason` carries the runtime's own explanation when it holds
+     * one, so a display can say why rather than only that.
+     * A native interrupt also reports `turn.interrupted` before this end.
+     *
+     * Core also reports this for an input no runtime accepted, because that
+     * input opened a display that nothing else closes.
+     *
+     * A provider reports this from the native terminal it observed, and
+     * again, without asking whether a turn was open, when it tears down a
+     * live native session. It keeps no display state to answer that
+     * question, so a consumer may receive an end with nothing open and
+     * ignores it: a native end closes an open display and never opens one.
+     */
+    readonly kind: 'turn.ended';
+    readonly occurredAt: number;
+    readonly status: 'completed' | 'failed' | 'interrupted';
+    readonly reason: string | null;
+};
+/**
+ * A bounded request for the recent tail of one session's activity. Cursors are
+ * opaque and provider-owned; pagination walks a stable recent tail without
+ * skipping or duplicating records as native history grows.
+ */
+export interface AgentActivityQuery {
+    readonly sessionId: string;
+    readonly cursor?: string;
+    readonly limit?: number;
+    /** Tools are included by default and can only be hidden as a group. */
+    readonly includeTools?: boolean;
+}
+export interface AgentActivityReadContext<TConfig> {
+    readonly config: TConfig;
+    readonly cwd: string;
+    readonly logger: DreamuxLogger;
+}
+/**
+ * One neutral activity fact. Tool arguments, tool results, provider-native
+ * lines, Core status, admission, and settlement never appear here.
+ */
+export type AgentActivityRecord = {
+    readonly kind: 'assistant_message';
+    readonly text: string;
+    readonly occurredAt?: string;
+} | {
+    readonly kind: 'tool';
+    readonly name: string;
+    readonly status: 'started' | 'completed' | 'failed';
+    readonly occurredAt?: string;
+};
+/** One chronological page of recent Activity Records. */
+export interface AgentActivityPage {
+    readonly records: readonly AgentActivityRecord[];
+    readonly nextCursor?: string;
+    /** Set by the provider when its own native read bounds truncated the page. */
+    readonly truncated: boolean;
+}
+/**
+ * Structural shape of the `Error` a provider rejects an Activity read with.
+ * Reasons describe neutral states only: never a filesystem path, native history
+ * layout, or scan mode. Callers branch on `error.name` rather than
+ * `instanceof`, keeping this package declaration-only.
+ */
+export interface AgentActivityError extends Error {
+    name: 'AgentActivityError';
+    reason: 'session_unavailable' | 'cursor_invalid' | 'activity_corrupt' | 'provider_failure';
+}
+export {};
+//# sourceMappingURL=activity.d.ts.map

package/dist/activity.d.ts.map

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

package/dist/agent-runtime.d.ts

@@ -15,7 +15,14 @@
  * mandatory provider behavior rather than negotiated capability bits. Live
  * activity emission stays optional because its absence changes only
  * presentation.
+ *
+ * The live and cold Activity record shapes themselves (`RuntimeActivity` and
+ * `AgentActivityRecord`, with their supporting types) live in `activity.js`:
+ * that module is the Activity domain read through both of a runtime's
+ * lifecycles, while this module stays about launching and running the session
+ * that produces them.
  */
+import type { AgentActivityPage, AgentActivityQuery, AgentActivityReadContext, RuntimeActivity } from './activity.js';
 import type { DreamuxLogger } from './logger.js';
 import type { JsonSchema, JsonValue } from './json.js';
 import type { DreamuxEnvironment, ProviderBinCheck, ProviderDiagnosticRunner, ProviderDiagnosticScope, ProviderDiagnosticResult, ProviderFactory, ProviderOnboard } from './provider.js';
@@ -139,11 +146,6 @@ export interface AgentRuntimeStateSink {
 export interface AgentRuntimeStateLeaseRevokedError extends Error {
     name: 'AgentRuntimeStateLeaseRevokedError';
 }
-/**
- * What a tool invocation does, classified by the runtime that owns the tool
- * vocabulary. `null` means the runtime has no such classification for this call.
- */
-export type RuntimeToolAction = 'read' | 'list_files' | 'search' | 'edit' | 'run';
 /** One accepted provider submission. Its identity never implies folding. */
 export interface RuntimeSubmission {
     readonly settled: Promise<RuntimeSubmissionSettlement>;
@@ -165,122 +167,6 @@ export type RuntimeSubmissionSettlement = {
 } | {
     readonly kind: 'stopped';
 };
-/** A live fact identified by the native object it reports. */
-interface NativeActivity<K extends string> {
-    readonly kind: K;
-    readonly occurredAt: number;
-    /**
-     * The provider's own id, taken whole without a prefix, suffix, or counter.
-     * It identifies the native object, not a unique activity: a tool's start
-     * and result share its call id; usage and interruption share a turn id.
-     * A consumer derives row identity from kind (and tool status) plus this id.
-     */
-    readonly id: string;
-}
-/**
- * One thing an agent's runtime did, in the runtime's own vocabulary.
- *
- * Keyed on the agent and nothing else. A provider folds any number of Dreamux
- * submissions into one native turn, so an activity cannot honestly name the
- * submission that caused it — and inventing one would make a display pick an
- * arbitrary member. What a live surface needs is this agent's stream in order,
- * which is what this is.
- *
- * A Channel receives this same type with every text and JSON payload member
- * already redacted by Core. Core bounds nothing: each surface applies its
- * own display limits where it sends.
- */
-export type RuntimeActivity = NativeActivity<'assistant.message'> & {
-    readonly text: string;
-}
-/**
- * The runtime compacted its context. Carries no summary or compaction
- * metadata. Live-only: the cold activity reader never produces this.
- */
- | NativeActivity<'context.compacted'>
-/**
- * A display marker, not a terminal: a native turn stopped at an interrupt
- * request. Reported from the native interrupted terminal, before its
- * `token.usage` (when available) and paired `turn.ended` with status
- * `interrupted`. Teardown reports `turn.ended` `interrupted` without this
- * marker. Live-only: the cold activity reader never produces this.
- */
- | NativeActivity<'turn.interrupted'> | NativeActivity<'tool.call'> & {
-    readonly toolName: string;
-    readonly action: RuntimeToolAction | null;
-    /**
-     * The call as the runtime's own UI labels it, in one line: a command's
-     * stated purpose, the path a file tool touches, the pattern a search
-     * runs, the task a sub-agent was given. `null` when the runtime has no
-     * label of its own for the tool, so a display falls back to the name.
-     */
-    readonly summary: string | null;
-    /**
-     * The call as a person would write it: the shell command line, the
-     * task text handed to a sub-agent, the script a runner executes.
-     * `arguments` is the tool's full structured input; this is the one
-     * member of it that has a notation of its own, so a display can show
-     * it in that notation instead of as JSON. `null` when there is none.
-     */
-    readonly invocation: string | null;
-    /**
-     * What the call is about, one entry per item, as the runtime reported
-     * it in structured members of the call: the path a file tool reads or
-     * writes, the paths of a patch, the files a parsed shell command read.
-     * Not limited to files: a runtime lists whatever discrete things its
-     * protocol names for the call. Empty when it names none; never
-     * recovered from a label or an output by parsing.
-     */
-    readonly items: readonly string[];
-    readonly status: 'started' | 'completed' | 'failed';
-    readonly arguments: JsonValue | null;
-    readonly result: JsonValue | null;
-    readonly error: string | null;
-}
-/**
- * The native runtime's cumulative token counters for its live session,
- * at the turn they were observed for. Runners that fold several native
- * turns into one provider turn emit once on the native terminal with the
- * latest snapshot, so one activity stands for one turn.
- *
- * Values are session-total as the runtime owns them, never turn deltas:
- * a consumer derives a turn's consumption by differencing against the
- * previous snapshot for this agent. The runtime keeps no history and
- * performs no subtraction. Live-only: the cold activity reader never
- * replays this, and a dropped snapshot simply widens the next delta.
- */
- | NativeActivity<'token.usage'> & {
-    readonly inputTokens: number;
-    readonly outputTokens: number;
-    /** The last response's context footprint, and the native window when the runtime reports one; `null` when the runtime gives no context signal. */
-    readonly context: {
-        readonly usedTokens: number;
-        readonly windowTokens: number | null;
-    } | null;
-} | {
-    /**
-     * The runtime stopped producing for the turn it was running, whatever
-     * that turn contained. `completed` is the runtime's own successful
-     * terminal; `failed` is a proven terminal error; `interrupted` is a
-     * native turn that ended without either, such as a stop or a protocol
-     * loss. `reason` carries the runtime's own explanation when it holds
-     * one, so a display can say why rather than only that.
-     * A native interrupt also reports `turn.interrupted` before this end.
-     *
-     * Core also reports this for an input no runtime accepted, because that
-     * input opened a display that nothing else closes.
-     *
-     * A provider reports this from the native terminal it observed, and
-     * again, without asking whether a turn was open, when it tears down a
-     * live native session. It keeps no display state to answer that
-     * question, so a consumer may receive an end with nothing open and
-     * ignores it: a native end closes an open display and never opens one.
-     */
-    readonly kind: 'turn.ended';
-    readonly occurredAt: number;
-    readonly status: 'completed' | 'failed' | 'interrupted';
-    readonly reason: string | null;
-};
 /**
  * Optional, synchronous, non-backpressuring sink for live native activity. It
  * is transient input to the Core conversation projection, not a progress view:
@@ -392,21 +278,12 @@ export interface AgentRuntimeCreateContext<TConfig> {
      * valid JSON conforming to the schema; the caller parses it.
      */
     readonly outputSchema?: JsonSchema;
-    /**
-     * Neutral process-env injection seam. Core merges these entries into the
-     * runtime's spawn environment AFTER `process.env` and BEFORE the provider's
-     * own `config.extra_env`, i.e. spawn env =
-     * `{ ...process.env, ...injectEnv, ...config.extra_env }`. Core owns what (if
-     * anything) it injects; `config.extra_env` is the provider's own config and is
-     * NOT routed through here.
-     */
-    readonly injectEnv?: Readonly<Record<string, string>>;
     readonly paths: AgentRuntimePathContext;
     /** Leased, push-only state sink for this runtime generation. */
     readonly state: AgentRuntimeStateSink;
     /** Leased, push-only sink for this runtime generation's live activity. */
-    readonly activity?: AgentRuntimeActivitySink;
-    readonly logger?: AgentRuntimeLogger;
+    readonly activity: AgentRuntimeActivitySink;
+    readonly logger: AgentRuntimeLogger;
 }
 /** What `start` restored. Core consumes it before admitting the first submission. */
 export interface AgentRuntimeStartOutcome {
@@ -441,55 +318,6 @@ export interface AgentRuntime {
      */
     stop(): Promise<void>;
 }
-/**
- * A bounded request for the recent tail of one session's activity. Cursors are
- * opaque and provider-owned; pagination walks a stable recent tail without
- * skipping or duplicating records as native history grows.
- */
-export interface AgentActivityQuery {
-    readonly sessionId: string;
-    readonly cursor?: string;
-    readonly limit?: number;
-    /** Tools are included by default and can only be hidden as a group. */
-    readonly includeTools?: boolean;
-}
-export interface AgentActivityReadContext<TConfig> {
-    readonly config: TConfig;
-    readonly cwd: string;
-    readonly injectEnv?: Readonly<Record<string, string>>;
-    readonly logger?: AgentRuntimeLogger;
-}
-/**
- * One neutral activity fact. Tool arguments, tool results, provider-native
- * lines, Core status, admission, and settlement never appear here.
- */
-export type AgentActivityRecord = {
-    readonly kind: 'assistant_message';
-    readonly text: string;
-    readonly occurredAt?: string;
-} | {
-    readonly kind: 'tool';
-    readonly name: string;
-    readonly status: 'started' | 'completed' | 'failed';
-    readonly occurredAt?: string;
-};
-/** One chronological page of recent Activity Records. */
-export interface AgentActivityPage {
-    readonly records: readonly AgentActivityRecord[];
-    readonly nextCursor?: string;
-    /** Set by the provider when its own native read bounds truncated the page. */
-    readonly truncated: boolean;
-}
-/**
- * Structural shape of the `Error` a provider rejects an Activity read with.
- * Reasons describe neutral states only: never a filesystem path, native history
- * layout, or scan mode. Callers branch on `error.name` rather than
- * `instanceof`, keeping this package declaration-only.
- */
-export interface AgentActivityError extends Error {
-    name: 'AgentActivityError';
-    reason: 'session_unavailable' | 'cursor_invalid' | 'activity_corrupt' | 'provider_failure';
-}
 export interface AgentRuntimeProviderConfigReadContext {
     providerRef: string;
     /**
@@ -502,7 +330,11 @@ export interface AgentRuntimeProviderConfigReadContext {
 }
 /**
  * Optional provider-owned config parsing. A parse/validation failure must throw
- * (the host fails loud), never return a partially-valid config.
+ * (the host fails loud), never return a partially-valid config. Throw the
+ * `RuleViolation` from `@excitedjs/dreamux-utils` for a value this reader
+ * checked and refused, so a host request that carried that value (an online
+ * config replace) reports it as the caller's mistake; any other throw is
+ * reported as an internal failure.
  */
 export interface AgentRuntimeConfigCapability<TConfig> {
     read(rawConfig: Record<string, unknown>, context: AgentRuntimeProviderConfigReadContext): TConfig | Promise<TConfig>;
@@ -532,10 +364,10 @@ export interface AgentRuntimeDiagnosticContext<TConfig = unknown> {
      * The same neutral path context the create context carries, supplied by
      * doctor so a provider diagnostic can pre-check placement-sensitive paths
      * (e.g. validate that a runtime socket would fit the platform budget via
-     * {@link AgentRuntimePathContext.runtimeSocketDirs}). Optional: a provider
-     * with no path-dependent checks ignores it.
+     * {@link AgentRuntimePathContext.runtimeSocketDirs}). Always supplied by the
+     * host; a provider with no path-dependent checks simply never reads it.
      */
-    paths?: AgentRuntimePathContext;
+    paths: AgentRuntimePathContext;
 }
 /**
  * Optional provider-owned diagnostics: the provider DECLARES the bin checks
@@ -550,7 +382,10 @@ export interface AgentRuntimeDiagnosticCapability<TConfig> {
 /**
  * The Agent Runtime provider facade: selection, neutral recent Activity reads,
  * and runtime creation, plus operational capabilities composed as optional
- * objects rather than fake methods.
+ * members. A capability with more than one operation is an optional object
+ * (`config`, `onboard`, `diagnostic`) rather than a set of fake always-present
+ * methods; a capability that is a single pure function (`operatorStateRoot`)
+ * is declared directly as an optional method, with no object wrapper to add.
  *
  * Registration identity is absent by construction — Core owns the descriptor in
  * its {@link RegisteredProvider} wrapper, so this interface has no `ref` or
@@ -566,14 +401,23 @@ export interface AgentRuntimeProvider<TConfig> {
      * against an actively growing session — producing useful records before any
      * completion marker — and against the same session after the live runtime has
      * closed. The provider enforces its own native read bounds and sets
-     * {@link AgentActivityPage.truncated}; Core independently validates record
-     * count, text size, page size, cursor size, and public errors.
+     * {@link AgentActivityPage.truncated}; Core checks page and record shape,
+     * record count, and recognized public errors. Text, page, and cursor size
+     * bounds belong to the provider.
      */
     readRecentActivity(query: AgentActivityQuery, context: AgentActivityReadContext<TConfig>): Promise<AgentActivityPage>;
     createRuntime(context: AgentRuntimeCreateContext<TConfig>): Promise<AgentRuntime>;
     readonly config?: AgentRuntimeConfigCapability<TConfig>;
     readonly onboard?: AgentRuntimeOnboardCapability;
     readonly diagnostic?: AgentRuntimeDiagnosticCapability<TConfig>;
+    /**
+     * The provider's own global state directory (e.g. `~/.codex`), with no
+     * per-agent `extra_env` override applied. Host-wide operations that are not
+     * scoped to any one agent (uninstall's directory-safety guard) call this
+     * with the operator's ambient env to learn which directories this provider
+     * owns, instead of the host hard-coding provider-specific path literals.
+     */
+    operatorStateRoot?(env: DreamuxEnvironment): string;
 }
 /**
  * The default (or `npm:pkg#export`-selected) factory export an Agent Runtime

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

@@ -1 +1 @@
-{"version":3,"file":"agent-runtime.d.ts","sourceRoot":"","sources":["../src/agent-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,KAAK,EACV,kBAAkB,EAClB,gBAAgB,EAChB,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,EACxB,eAAe,EACf,eAAe,EAChB,MAAM,eAAe,CAAC;AAEvB,mEAAmE;AACnE,MAAM,MAAM,kBAAkB,GAAG,aAAa,CAAC;AAE/C;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACjD;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,cAAc,GAAG,MAAM,CAAC;CACjC;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;CAC7D;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,QAAQ,IAAI,MAAM,CAAC;IACnB;;;;;OAKG;IACH,OAAO,IAAI,MAAM,CAAC;IAClB;;;;;;;OAOG;IACH,iBAAiB,IAAI,SAAS,MAAM,EAAE,CAAC;CACxC;AAED;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAC1B,UAAU,GACV,UAAU,GACV,OAAO,GACP,UAAU,GACV,UAAU,GACV,SAAS,CAAC;AAEd,4EAA4E;AAC5E,MAAM,MAAM,uBAAuB,GAC/B;IACE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACxD;IAAE,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/D;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzD;AAED;;;;GAIG;AACH,MAAM,WAAW,kCAAmC,SAAQ,KAAK;IAC/D,IAAI,EAAE,oCAAoC,CAAC;CAC5C;AAED;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GACzB,MAAM,GACN,YAAY,GACZ,QAAQ,GACR,MAAM,GACN,KAAK,CAAC;AAEV,4EAA4E;AAC5E,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,2BAA2B,CAAC,CAAC;CACxD;AAED,yCAAyC;AACzC,MAAM,MAAM,iBAAiB,GACzB;IACE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC,GACD;IACE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;CACvB,CAAC;AAEN,MAAM,MAAM,2BAA2B,GACnC;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAA;CAAE,GACvE;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;CAAE,GAClD;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AAEjC,8DAA8D;AAC9D,UAAU,cAAc,CAAC,CAAC,SAAS,MAAM;IACvC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACjB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,eAAe,GACvB,cAAc,CAAC,mBAAmB,CAAC,GAAG;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AACH;;;GAGG;GACD,cAAc,CAAC,mBAAmB,CAAC;AACrC;;;;;;GAMG;GACD,cAAc,CAAC,kBAAkB,CAAC,GAClC,cAAc,CAAC,WAAW,CAAC,GAAG;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC1C;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC;;;;;;;OAOG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IACpD,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AACH;;;;;;;;;;;GAWG;GACD,cAAc,CAAC,aAAa,CAAC,GAAG;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,kJAAkJ;IAClJ,QAAQ,CAAC,OAAO,EAAE;QAChB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;KACtC,GAAG,IAAI,CAAC;CACV,GACD;IACE;;;;;;;;;;;;;;;;;OAiBG;IACH,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,aAAa,CAAC;IACxD,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC,CAAC;AAEN;;;;;;;;;;GAUG;AACH,MAAM,WAAW,wBAAwB;IACvC,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAC;CACnC;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,gBAAgB,GACxB;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,UAAU,EAAE,iBAAiB,CAAA;CAAE,GACtD;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,GAClC;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC;AAE1C;;;;;;;GAOG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED;;;GAGG;AACH,MAAM,WAAW,yBAAyB,CAAC,OAAO;IAChD,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,mFAAmF;IACnF,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,QAAQ,CAAC,YAAY,CAAC,EAAE,wBAAwB,CAAC;IACjD;;;;OAIG;IACH,QAAQ,CAAC,UAAU,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACtD;;;OAGG;IACH,QAAQ,CAAC,YAAY,EAAE,SAAS,uBAAuB,EAAE,CAAC;IAC1D;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C;;;;;;OAMG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,UAAU,CAAC;IACnC;;;;;;;OAOG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACtD,QAAQ,CAAC,KAAK,EAAE,uBAAuB,CAAC;IACxC,gEAAgE;IAChE,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAC;IACtC,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ,CAAC,EAAE,wBAAwB,CAAC;IAC7C,QAAQ,CAAC,MAAM,CAAC,EAAE,kBAAkB,CAAC;CACtC;AAED,qFAAqF;AACrF,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,UAAU,EAAE,OAAO,GAAG,SAAS,CAAC;CAC1C;AAED,8EAA8E;AAC9E,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAAC;CACzC;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;OAKG;IACH,KAAK,IAAI,OAAO,CAAC,wBAAwB,CAAC,CAAC;IAC3C,MAAM,CAAC,KAAK,EAAE,2BAA2B,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACtE,kFAAkF;IAClF,SAAS,IAAI,OAAO,CAAC,4BAA4B,CAAC,CAAC;IACnD;;;;;;;OAOG;IACH,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,uEAAuE;IACvE,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,wBAAwB,CAAC,OAAO;IAC/C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACtD,QAAQ,CAAC,MAAM,CAAC,EAAE,kBAAkB,CAAC;CACtC;AAED;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAC3B;IACE,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IACpD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEN,yDAAyD;AACzD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACjD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,8EAA8E;IAC9E,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAmB,SAAQ,KAAK;IAC/C,IAAI,EAAE,oBAAoB,CAAC;IAC3B,MAAM,EACF,qBAAqB,GACrB,gBAAgB,GAChB,kBAAkB,GAClB,kBAAkB,CAAC;CACxB;AAED,MAAM,WAAW,qCAAqC;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,4BAA4B,CAAC,OAAO;IACnD,IAAI,CACF,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,OAAO,EAAE,qCAAqC,GAC7C,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC/B;AAED;;;GAGG;AACH,MAAM,MAAM,6BAA6B,GAAG,eAAe,CACzD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CACxB,CAAC;AAEF,kEAAkE;AAClE,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,CAAC;AAEpD,uEAAuE;AACvE,MAAM,MAAM,4BAA4B,GAAG,wBAAwB,CAAC;AAEpE,uEAAuE;AACvE,MAAM,MAAM,4BAA4B,GAAG,wBAAwB,CAAC;AAEpE;;;;GAIG;AACH,MAAM,WAAW,6BAA6B,CAAC,OAAO,GAAG,OAAO;IAC9D,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE,kBAAkB,CAAC;IACxB,KAAK,EAAE,uBAAuB,CAAC;IAC/B;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,uBAAuB,CAAC;CACjC;AAED;;;;;GAKG;AACH,MAAM,WAAW,gCAAgC,CAAC,OAAO;IACvD,SAAS,CACP,OAAO,EAAE,6BAA6B,CAAC,OAAO,CAAC,GAC9C,oBAAoB,EAAE,CAAC;IAC1B,aAAa,CACX,OAAO,EAAE,6BAA6B,CAAC,OAAO,CAAC,EAC/C,MAAM,EAAE,4BAA4B,GACnC,OAAO,CAAC,4BAA4B,CAAC,CAAC;CAC1C;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,oBAAoB,CAAC,OAAO;IAC3C,eAAe,IAAI,gCAAgC,CAAC;IACpD;;;;;;;OAOG;IACH,kBAAkB,CAChB,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE,wBAAwB,CAAC,OAAO,CAAC,GACzC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC9B,aAAa,CACX,OAAO,EAAE,yBAAyB,CAAC,OAAO,CAAC,GAC1C,OAAO,CAAC,YAAY,CAAC,CAAC;IAEzB,QAAQ,CAAC,MAAM,CAAC,EAAE,4BAA4B,CAAC,OAAO,CAAC,CAAC;IACxD,QAAQ,CAAC,OAAO,CAAC,EAAE,6BAA6B,CAAC;IACjD,QAAQ,CAAC,UAAU,CAAC,EAAE,gCAAgC,CAAC,OAAO,CAAC,CAAC;CACjE;AAED;;;GAGG;AACH,MAAM,MAAM,2BAA2B,CAAC,OAAO,IAAI,eAAe,CAChE,oBAAoB,CAAC,OAAO,CAAC,CAC9B,CAAC;AAEF,8EAA8E;AAC9E,YAAY,EAAE,aAAa,EAAE,CAAC"}
+{"version":3,"file":"agent-runtime.d.ts","sourceRoot":"","sources":["../src/agent-runtime.ts"],"names":[],"mappings":"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"}

package/dist/channel.d.ts

@@ -216,7 +216,7 @@ export type ChannelMcpToolOutcome = {
  */
 export interface ChannelInstance {
     readonly session: ChannelSession;
-    readonly mcp?: ChannelSessionMcpCapability;
+    readonly mcp?: ChannelSessionMcpCapability | undefined;
 }
 export interface ChannelConfigContext {
     dispatcher_id: string;
@@ -228,14 +228,18 @@ export interface ChannelSessionCreateContext<TConfig> {
     channel_id: string;
     provider: string;
     config: TConfig;
-    logger?: DreamuxLogger;
+    logger: DreamuxLogger;
     /** The per-dispatcher root the Channel owns its durable state under. */
-    state_root?: string;
-    cache_root?: string;
+    state_root: string;
+    cache_root: string;
 }
 /**
  * Optional Channel-owned config parsing. A parse/validation failure must throw
- * (the host fails loud), never return a partially-valid config.
+ * (the host fails loud), never return a partially-valid config. Throw the
+ * `RuleViolation` from `@excitedjs/dreamux-utils` for a value this reader
+ * checked and refused, so a host request that carried that value (an online
+ * config replace) reports it as the caller's mistake; any other throw is
+ * reported as an internal failure.
  */
 export interface ChannelConfigCapability<TConfig> {
     read(raw: unknown, context: ChannelConfigContext): TConfig | Promise<TConfig>;

package/dist/channel.d.ts.map

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

package/dist/index.d.ts

@@ -5,18 +5,24 @@
  * Runtime and Channel providers import Dreamux contracts from this package and
  * must not import `@excitedjs/dreamux`.
  *
- * This package emits declarations only: there is no runtime JS contract surface
- * and no runtime dependencies. See
+ * This package emits declarations only: there is no runtime JS contract
+ * surface. Its one dependency is `tapable`, referenced only by type, because
+ * the plugin hook contract is tapable's hook types. See
  * `.agents/tasks/architecture/npm-package-split/requirement.md (npm-package-split-and-channel-targets)`.
  *
- * Scope: neutral contracts and catalog types only. No provider-specific paths,
- * selectors, or runtime-native record formats cross this boundary, and no
- * module here encodes a provider id or an exposure policy.
+ * Scope: neutral provider and plugin contracts and catalog types only. No
+ * provider-specific paths, selectors, or runtime-native record formats cross
+ * this boundary, and no module here encodes a provider id or an exposure
+ * policy.
  *
  * Module layout follows domain ownership: `agent-runtime.ts` is the Provider /
- * native execution seam, `channel.ts` is the bridge lifecycle plus the two
- * generic Core ports, `command.ts` is the generic Command port, and `team.ts` /
- * `teammate.ts` hold the Core domain facts each of those entities owns.
+ * native execution seam, `activity.ts` is the Activity domain (live and cold
+ * record shapes) that seam produces, `channel.ts` is the bridge lifecycle plus
+ * the two generic Core ports, `plugin.ts` is the plugin seam (plugin object,
+ * hosts, hooked Dispatcher/Team faces, launch draft), and `team.ts` /
+ * `teammate.ts` hold the Core domain facts each of those entities owns
+ * (`team.ts` also owns the published Channel Command failure shape, since a
+ * Team Command payload is its only consumer).
  *
  * Root-export policy (issue #209): the root aggregates every public contract
  * type so an external provider author can name any of them directly. A type
@@ -27,13 +33,14 @@
  * legitimately depend on). The `exports` map publishes only this root, so this
  * list IS the public API.
  */
-export type { DreamuxLogger } from './logger.js';
-export type { JsonSchema, JsonValue } from './json.js';
-export type { JsonInvokeResult, JsonInvoker } from './invoke.js';
-export type { AgentRuntimeProviderDescriptor, BuiltinProviderRef, ChannelProviderDescriptor, DreamuxEnvironment, ProviderBinCheck, NpmProviderRef, ProviderDiagnosticRunner, ProviderDiagnosticScope, ProviderDescriptor, ProviderDiagnosticResult, ProviderFactory, ProviderFactoryContext, ProviderKind, ProviderOnboard, ProviderOnboardConfirmPrompt, ProviderOnboardContext, ProviderOnboardPromptHost, ProviderOnboardSecretPrompt, ProviderOnboardTextPrompt, ProviderRef, ProviderRefSource, RegisteredProvider, } from './provider.js';
-export type { AgentActivityError, AgentActivityPage, AgentActivityQuery, AgentActivityReadContext, AgentActivityRecord, AgentRuntime, AgentRuntimeActivitySink, AgentRuntimeBinCheck, AgentRuntimeConfigCapability, AgentRuntimeCreateContext, AgentRuntimeDiagnosticCapability, AgentRuntimeDiagnosticContext, AgentRuntimeDiagnosticRunner, AgentRuntimeDiagnosticResult, AgentRuntimeIdentity, AgentRuntimeInterruptOutcome, AgentRuntimeLogger, AgentRuntimeMcpServer, AgentRuntimeOnboardCapability, AgentRuntimePathContext, AgentRuntimeProvider, AgentRuntimeProviderCapabilities, AgentRuntimeProviderConfigReadContext, AgentRuntimeProviderFactory, AgentRuntimeSkillSource, AgentRuntimeStartOutcome, AgentRuntimeStateLeaseRevokedError, AgentRuntimeStateSink, AgentRuntimeStateUpdate, AgentRuntimeStatus, AgentRuntimeSubmissionInput, AgentRuntimeSystemPrompt, RuntimeActivity, RuntimeAdmission, RuntimeCompletion, RuntimeSubmission, RuntimeSubmissionSettlement, RuntimeToolAction, } from './agent-runtime.js';
-export type { ChannelCommandError, ChannelCommandRetryableErrorCode, CoreCommandContext, CoreCommandDefinition, CoreCommandRegistry, CoreCommandSource, } from './command.js';
-export type { SubmitCommand, TeamCreateCommand, TeamCreateRepoRequest, TeamStatus, TeamSummary, TeamStateEvent, TeamStateTeammateSummary, TeamSubmitCommand, TeamSubmitResult, } from './team.js';
-export type { TeamContainedRole, TeammateActivityEvent, TeammateActorScope, TeammateInputEvent, TeammateInputNotice, TeammateRole, TeammateStateEvent, TeammateStatus, } from './teammate.js';
-export type { ChannelBinCheck, ChannelConfigCapability, ChannelConfigContext, ChannelCorePort, ChannelCoreEvent, ChannelDiagnosticCapability, ChannelDiagnosticContext, ChannelDiagnosticRunner, ChannelDiagnosticResult, ChannelEventSource, ChannelEventSubscription, ChannelIdentityCapability, ChannelInstance, ChannelMcpCall, ChannelMcpCallContext, ChannelMcpCaller, ChannelMcpCapability, ChannelMcpToolAnnotations, ChannelMcpToolDescriptor, ChannelMcpToolIcon, ChannelMcpToolOutcome, ChannelMcpToolRegistration, ChannelOnboardCapability, ChannelProvider, ChannelProviderFactory, ChannelSession, ChannelSessionCreateContext, ChannelSessionMcpCapability, } from './channel.js';
+export type * from './logger.js';
+export type * from './json.js';
+export type * from './invoke.js';
+export type * from './provider.js';
+export type * from './agent-runtime.js';
+export type * from './activity.js';
+export type * from './team.js';
+export type * from './teammate.js';
+export type * from './channel.js';
+export type * from './plugin.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACvD,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACjE,YAAY,EACV,8BAA8B,EAC9B,kBAAkB,EAClB,yBAAyB,EACzB,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,wBAAwB,EACxB,uBAAuB,EACvB,kBAAkB,EAClB,wBAAwB,EACxB,eAAe,EACf,sBAAsB,EACtB,YAAY,EACZ,eAAe,EACf,4BAA4B,EAC5B,sBAAsB,EACtB,yBAAyB,EACzB,2BAA2B,EAC3B,yBAAyB,EACzB,WAAW,EACX,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,wBAAwB,EACxB,mBAAmB,EACnB,YAAY,EACZ,wBAAwB,EACxB,oBAAoB,EACpB,4BAA4B,EAC5B,yBAAyB,EACzB,gCAAgC,EAChC,6BAA6B,EAC7B,4BAA4B,EAC5B,4BAA4B,EAC5B,oBAAoB,EACpB,4BAA4B,EAC5B,kBAAkB,EAClB,qBAAqB,EACrB,6BAA6B,EAC7B,uBAAuB,EACvB,oBAAoB,EACpB,gCAAgC,EAChC,qCAAqC,EACrC,2BAA2B,EAC3B,uBAAuB,EACvB,wBAAwB,EACxB,kCAAkC,EAClC,qBAAqB,EACrB,uBAAuB,EACvB,kBAAkB,EAClB,2BAA2B,EAC3B,wBAAwB,EACxB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,2BAA2B,EAC3B,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,mBAAmB,EACnB,gCAAgC,EAChC,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,qBAAqB,EACrB,UAAU,EACV,WAAW,EACX,cAAc,EACd,wBAAwB,EACxB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,EAClB,cAAc,GACf,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,eAAe,EACf,uBAAuB,EACvB,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,2BAA2B,EAC3B,wBAAwB,EACxB,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,EAClB,wBAAwB,EACxB,yBAAyB,EACzB,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,EACpB,yBAAyB,EACzB,wBAAwB,EACxB,kBAAkB,EAClB,qBAAqB,EACrB,0BAA0B,EAC1B,wBAAwB,EACxB,eAAe,EACf,sBAAsB,EACtB,cAAc,EACd,2BAA2B,EAC3B,2BAA2B,GAC5B,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,mBAAmB,aAAa,CAAC;AACjC,mBAAmB,WAAW,CAAC;AAC/B,mBAAmB,aAAa,CAAC;AACjC,mBAAmB,eAAe,CAAC;AACnC,mBAAmB,oBAAoB,CAAC;AACxC,mBAAmB,eAAe,CAAC;AACnC,mBAAmB,WAAW,CAAC;AAC/B,mBAAmB,eAAe,CAAC;AACnC,mBAAmB,cAAc,CAAC;AAClC,mBAAmB,aAAa,CAAC"}

package/dist/invoke.d.ts

@@ -15,25 +15,4 @@ import type { JsonValue } from './json.js';
 export interface JsonInvoker {
     invoke(method: string, params: JsonValue): Promise<JsonValue>;
 }
-/**
- * A settled outcome an implementation chose to state, rather than throw.
- *
- * The distinction is the whole failure boundary. `ok: false` is a decision: the
- * implementation understood the request, refused it, and wrote a message it
- * accepts being read by whoever asked. Everything it did *not* decide — a bug,
- * a broken invariant, an unexpected exception — is never this. It stays an
- * exception, so the boundary that owns diagnostics logs it in full and answers
- * with its own sanitized wording.
- *
- * Because a refusal is data, it crosses a process or package edge as JSON. No
- * error class, error code, or thrown domain value has to be shared for one side
- * to tell the other exactly what was wrong.
- */
-export type JsonInvokeResult<TValue = JsonValue> = {
-    readonly ok: true;
-    readonly value: TValue;
-} | {
-    readonly ok: false;
-    readonly message: string;
-};
 //# sourceMappingURL=invoke.d.ts.map

package/dist/invoke.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"invoke.d.ts","sourceRoot":"","sources":["../src/invoke.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;CAC/D;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,gBAAgB,CAAC,MAAM,GAAG,SAAS,IAC3C;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC7C;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC"}
+{"version":3,"file":"invoke.d.ts","sourceRoot":"","sources":["../src/invoke.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;CAC/D"}

package/dist/logger.d.ts

@@ -4,10 +4,8 @@
  * Deliberately pino-compatible (fields-first: `info(fields, message)`), so the
  * host's real pino logger satisfies this shape *structurally* — Dreamux core
  * injects its pino logger as-is, with no wrapper and no conversion at any
- * boundary. A provider authored against `@excitedjs/dreamux-types` depends only
- * on this shape; when core injects no logger, the provider package owns its own
- * minimal console fallback (also this shape). That fallback is implementation
- * code and does not belong in this declaration-only package.
+ * boundary. Core always supplies a logger, so every provider context field
+ * that carries one is required, not optional.
  *
  * The dual call signature mirrors pino's two primary overloads: pass fields then
  * an optional message, or pass a bare message. A misplaced message-first call
@@ -26,10 +24,10 @@ export interface DreamuxLogger {
     debug: DreamuxLogFn;
     trace: DreamuxLogFn;
     /**
-     * Context-binding sub-logger. Optional so a minimal provider fallback need not
-     * implement it; pino's `child(bindings)` satisfies it directly.
+     * Context-binding sub-logger. Every constructed `DreamuxLogger` already
+     * provides it — pino's `child(bindings)` satisfies it directly.
      */
-    child?(bindings: Record<string, unknown>): DreamuxLogger;
+    child(bindings: Record<string, unknown>): DreamuxLogger;
 }
 export {};
 //# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,UAAU,YAAY;IACpB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1D,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,YAAY,CAAC;IACpB,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,YAAY,CAAC;IACpB;;;OAGG;IACH,KAAK,CAAC,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,aAAa,CAAC;CAC1D"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,UAAU,YAAY;IACpB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1D,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,YAAY,CAAC;IACpB,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,YAAY,CAAC;IACpB;;;OAGG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,aAAa,CAAC;CACzD"}

package/dist/plugin.d.ts

@@ -0,0 +1,192 @@
+import type { AsyncSeriesHook, AsyncSeriesWaterfallHook, SyncHook, TypedHookMap } from 'tapable';
+import type { AgentRuntimeProvider, AgentRuntimeSkillSource } from './agent-runtime.js';
+import type { ChannelProvider } from './channel.js';
+import type { DreamuxLogger } from './logger.js';
+import type { TeamCreateParams } from './team.js';
+/**
+ * A Dreamux plugin: the object a plugin package's zero-argument factory
+ * (its `default` export, or the `npm:<pkg>#<export>` export) returns
+ * synchronously. Factories and `config.read` must not return thenables.
+ *
+ * `contribute` and `server` only register and tap. They must not do IO, start
+ * timers, or hold resources: `dreamux doctor` runs both while a daemon may be
+ * live, and no Dispatcher or channel exists yet to own a resource. Resources
+ * belong to object lifecycles (a channel's initialize/start/close, or a hook
+ * callback). Both must be synchronous — declared `void`, and enforced at load
+ * time by rejecting a returned thenable — since nothing awaits them: an
+ * `async` implementation would silently lose any tap it registers after its
+ * first `await`.
+ */
+export interface DreamuxPlugin {
+    /** Unique ignoring ASCII case across loaded plugins; spelling is preserved. */
+    readonly name: string;
+    /**
+     * Published to other plugins after every plugin's `server` ran, through
+     * `ServerHost.hooks.plugin.for(name)`. Declare its type by augmenting
+     * {@link DreamuxPluginApis}.
+     */
+    readonly api?: unknown;
+    /** Synchronously validate this plugin's `plugins[]` config block; a throw fails loading. */
+    readonly config?: {
+        read(raw: unknown): unknown;
+    };
+    contribute?(host: ContributeHost): void;
+    server?(host: ServerHost): void;
+}
+export interface ContributeHost {
+    readonly logger: DreamuxLogger;
+    /** Registers a channel provider addressed in config as `builtin:<name>`. */
+    readonly channelProviders: {
+        contribute<TConfig>(name: string, provider: ChannelProvider<TConfig>): void;
+    };
+    /** Registers an Agent Runtime provider addressed in config as `builtin:<name>`. */
+    readonly agentRuntimeProviders: {
+        contribute<TConfig>(name: string, provider: AgentRuntimeProvider<TConfig>): void;
+    };
+}
+/**
+ * Plugin name -> the type of that plugin's `api`. A plugin package that
+ * publishes an api augments this interface:
+ *
+ * ```ts
+ * declare module '@excitedjs/dreamux-types' {
+ *   interface DreamuxPluginApis { example: ExampleApi }
+ * }
+ * ```
+ */
+export interface DreamuxPluginApis {
+}
+export interface ServerHost {
+    /** The value this plugin's `config.read` returned; `undefined` without one. */
+    readonly config: unknown;
+    /** Bound with `plugin: <name>`. */
+    readonly logger: DreamuxLogger;
+    /**
+     * This plugin's own durable state directory, scoped by the plugin's name
+     * and no other identity. Core neither creates it nor reads inside it — the
+     * plugin owns its own `mkdir`/read/write, the same way every other Dreamux
+     * store creates its directory lazily on first write.
+     */
+    readonly stateDir: string;
+    /**
+     * Core runs these hooks, and every hook below them, with tapable's own
+     * `call` / `promise`, so interceptors added with `hook.intercept` run. Core
+     * installs a `register` interceptor first, which wraps each tap: a failing
+     * tap is logged with its owning plugin and the other taps still run. Core
+     * also wraps `hook.intercept` itself, so every method of a plugin's own
+     * interceptor (`call`/`tap`/`loop`/`result`/`done`/`error`/`register`) is
+     * guarded the same way — including `done`/`error`, which tapable invokes
+     * from a continuation no caller-side try/catch can see, so an unguarded
+     * throw there would otherwise hang the hook's own `promise()` forever
+     * instead of failing it. A guarded interceptor's throw is attributed to the
+     * plugin that added it and follows the same rule as the hook it is on:
+     * logged and skipped at runtime, a failed load naming that plugin at load
+     * time (`hooks.plugin.for(name)`). Interceptor methods must be synchronous:
+     * tapable ignores their return value (except `register`'s), so an `async`
+     * method's rejection is logged at runtime and fails loading at load time,
+     * and an `async` `register` leaves the tap unchanged even when its promise
+     * resolves to a modified tap.
+     *
+     * Tap names are free-form. The owning plugin of a tap is the plugin whose
+     * `server` registered it, or the plugin whose tap callback was running when
+     * it registered (including after an `await` inside that callback). Failure
+     * logs and doctor name taps by that owner.
+     */
+    readonly hooks: Readonly<{
+        /**
+         * Called once per Dispatcher object, right after core constructs it. A tap
+         * that throws is only stopped: taps it already added to the Dispatcher's
+         * hooks stay.
+         */
+        dispatcher: SyncHook<[Dispatcher]>;
+        /**
+         * `for(name)` is called once with that plugin's `api`, after every
+         * plugin's `server` ran. Never called for a plugin that is not loaded.
+         */
+        plugin: TypedHookMap<{
+            [K in keyof DreamuxPluginApis]: SyncHook<[DreamuxPluginApis[K]]>;
+        }>;
+    }>;
+}
+/** The public face of a Dispatcher, as plugin hooks receive it. */
+export interface Dispatcher {
+    readonly id: string;
+    /** The configured Dispatcher cwd, absolute. */
+    readonly cwd: string;
+    /**
+     * A failing tap does not stop the others. Each `launch` or `teammateLaunch`
+     * tap receives its own empty draft, merged into the launch only when the
+     * tap succeeds. A `team` tap that throws is only stopped: taps it already
+     * added to the Team's hooks stay.
+     */
+    readonly hooks: Readonly<{
+        /** Runs each time this Dispatcher's Agent is constructed (each Dispatcher start). */
+        launch: AsyncSeriesHook<[LaunchDraft]>;
+        /**
+         * Runs each time any ordinary TeamMate's Agent is constructed —
+         * Dispatcher-spawned, a Team member, or a Workflow agent — never for the
+         * Dispatcher's own Agent or a Team's leader (see `launch` / `leaderLaunch`).
+         * `teamId` is `null` for a dispatcher-owned TeamMate, the owning Team's id
+         * otherwise.
+         */
+        teammateLaunch: AsyncSeriesHook<[
+            LaunchDraft,
+            Readonly<{
+                teamId: string | null;
+            }>
+        ]>;
+        /**
+         * Runs once per `team.create` request that is not a replay of an already
+         * accepted one, before the Team is constructed. Each tap receives the
+         * previous tap's returned value (the caller's own params for the first
+         * tap) and returns the value the next tap sees; the final value is what
+         * the Team is built from. `request_id` is not part of this value — replay
+         * identity is decided before this hook ever runs.
+         */
+        createTeam: AsyncSeriesWaterfallHook<[TeamCreateParams]>;
+        /**
+         * Runs right after a Team object is constructed: on creation (before the
+         * Team record is written, so the object may be discarded when the name is
+         * taken) and on rebuild. Taps here should only tap the Team's own hooks.
+         */
+        team: SyncHook<[Team, {
+            readonly origin: 'create' | 'rebuild';
+        }]>;
+    }>;
+}
+/** The public face of a Team, as plugin hooks receive it. */
+export interface Team {
+    readonly id: string;
+    readonly name: string;
+    /** The Team's runtime cwd. */
+    readonly workspace: string;
+    /**
+     * A failing tap does not stop the others. Each `leaderLaunch` tap
+     * receives its own empty draft, merged into the launch only when the tap
+     * succeeds.
+     */
+    readonly hooks: Readonly<{
+        /**
+         * Runs each time this Team's TeamLeader Agent is constructed, including
+         * when a failed creation adopts the already-persisted leader to close it.
+         */
+        leaderLaunch: AsyncSeriesHook<[LaunchDraft]>;
+    }>;
+}
+/**
+ * What a launch hook may add. It starts empty: built-in prompts and skill
+ * roots are not in it and cannot be changed. Core appends `instructions` after
+ * the built-in prompt and `skillSources` after the built-in roots, fenced
+ * against them.
+ *
+ * This is also the only shape a launch hook itself ever carries: a tap gets
+ * its own private one, merged in only after it resolves and passes the skill
+ * fence, and a plugin's own `hook.intercept` callback on the hook sees a
+ * disconnected one — the accumulator that applies the fence is never handed
+ * to a hook, so an interceptor cannot add a skill root that skips it.
+ */
+export interface LaunchDraft {
+    readonly instructions: string[];
+    readonly skillSources: AgentRuntimeSkillSource[];
+}
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

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

package/dist/team.d.ts

@@ -4,17 +4,44 @@
  * The Team owns its canonical Commands and its aggregate state event. Both
  * Command payloads below are the two whose contracts change materially for
  * Channel use; every other canonical Team Command keeps its current domain
- * behavior and is defined by its own domain-owned Command module in Core.
+ * behavior and is defined by its own domain-owned Command module in Core. The
+ * published Channel Command failure shape lives here too, rather than with a
+ * generic Command port module, because {@link TeamSubmitResult} is its only
+ * consumer.
  */
 import type { AgentRuntimeSkillSource, AgentRuntimeStatus } from './agent-runtime.js';
-import type { ChannelCommandError } from './command.js';
 import type { TeamContainedRole, TeammateStatus } from './teammate.js';
+/**
+ * A typed Command failure returned across the generic Channel Command port.
+ * `code` stays an open string because each domain owns its own failure
+ * vocabulary; the two codes that carry a cross-domain rule are named by
+ * {@link ChannelCommandRetryableErrorCode}.
+ */
+export interface ChannelCommandError {
+    readonly code: string;
+    readonly message: string;
+    /**
+     * The next step the failure stated for itself, when it stated one.
+     *
+     * Present exactly when the failure's own author wrote both halves of it — the
+     * reason and what to do about it — so a caller rendering this for an agent can
+     * repeat it as it stands. Absent means no next step was ever authored: a
+     * renderer carries the `code` and the `message` alone, and says nothing more.
+     */
+    readonly action?: string;
+}
+/**
+ * The only pre-admission failures that permit a Channel to remove a stale
+ * binding and retry once to the Dispatcher Agent. Every other failure — and any
+ * `ambiguous` outcome — is never retried.
+ */
+export type ChannelCommandRetryableErrorCode = 'TEAM_NOT_FOUND' | 'TEAM_CLOSED';
 /**
  * A Team's repository policy. It is the complete existing Team-creation
  * capability, not a Channel-shaped subset: `reuse-cwd` reuses a caller-selected
  * or default working directory, and `managed` creates a git worktree with the
- * existing optional path, base ref, branch, slug, and cleanup controls. An
- * omitted request keeps the dispatcher's default shared work directory.
+ * existing optional path, base ref, branch, and cleanup controls. An omitted
+ * request keeps the dispatcher's default shared work directory.
  *
  * A Channel that owns only a narrow policy — Feishu supplies `path`/`base_ref`
  * — maps it into the `managed` branch before invoking the Command, so no
@@ -30,7 +57,6 @@ export type TeamCreateRepoRequest = {
     readonly path?: string;
     readonly base_ref?: string;
     readonly branch?: string;
-    readonly slug?: string;
     readonly cleanup?: 'keep' | 'delete-on-close';
 };
 /**
@@ -58,7 +84,23 @@ export interface TeamCreateCommand {
     };
     readonly repo?: TeamCreateRepoRequest;
 }
+/**
+ * A `team.create` request's own params, without `request_id`.
+ *
+ * This is what `dispatcher.hooks.createTeam` hands a tap and expects back:
+ * `request_id` decides replay identity before the hook ever runs, so it is
+ * neither read nor returnable here. Every field is `readonly` (inherited from
+ * {@link TeamCreateCommand}); a tap that wants to change one returns a new
+ * spread object (`{ ...params, intent: '...' }`), never a mutation in place.
+ */
+export type TeamCreateParams = Omit<TeamCreateCommand, 'request_id'>;
 export type TeamStatus = 'starting' | 'running' | 'closed';
+/**
+ * A managed worktree's cleanup outcome, as {@link TeamSummary} reports it. Named
+ * so a caller can hold or narrow the value by type rather than repeating the
+ * nine-member literal union at every read site.
+ */
+export type TeamWorktreeCleanupState = 'not-managed' | 'managed-active' | 'cleanup-pending' | 'kept' | 'deleted' | 'retained-dirty' | 'retained-unmerged' | 'retained-unique-commits' | 'retained-error';
 /** The current Team facts shared by create and status; `team.list` is a compact row. */
 export interface TeamSummary {
     readonly team_name: string;
@@ -84,7 +126,7 @@ export interface TeamSummary {
     readonly source_repo: string | null;
     readonly worktree_mode: 'reuse-cwd' | 'managed';
     readonly worktree_cleanup_mode: 'keep' | 'delete-on-close';
-    readonly worktree_cleanup: 'not-managed' | 'managed-active' | 'cleanup-pending' | 'kept' | 'deleted' | 'retained-dirty' | 'retained-unmerged' | 'retained-unique-commits' | 'retained-error';
+    readonly worktree_cleanup: TeamWorktreeCleanupState;
 }
 /**
  * One turn submitted from a Channel-facing surface: the flat payload shared by

package/dist/team.d.ts.map

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

package/dist/teammate.d.ts

@@ -10,7 +10,7 @@
  * Dispatcher-scoped TeamMate publishes its first `teammate.state`; later
  * transitions publish the same kind. There is no separate creation event.
  */
-import type { RuntimeActivity } from './agent-runtime.js';
+import type { RuntimeActivity } from './activity.js';
 /**
  * The role a TeamMate presents at this boundary.
  *

package/dist/teammate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"teammate.d.ts","sourceRoot":"","sources":["../src/teammate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,UAAU,GAAG,aAAa,CAAC;AAErE,wEAAwE;AACxE,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;AAEpE,MAAM,MAAM,cAAc,GACtB,UAAU,GACV,SAAS,GACT,UAAU,GACV,SAAS,GACT,QAAQ,CAAC;AAEb,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;CACjC;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,8DAA8D;IAC9D,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,mBAAmB,GAC3B;IAAE,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACnE;IAAE,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAA;CAAE,CAAC;AAE7C;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,GAAG,kBAAkB,GAAG;IACpD,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,sEAAsE;IACtE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAAC;CAC7C,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,qBAAqB,GAAG,kBAAkB,GAAG;IACvD,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;CACpC,CAAC"}
+{"version":3,"file":"teammate.d.ts","sourceRoot":"","sources":["../src/teammate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,UAAU,GAAG,aAAa,CAAC;AAErE,wEAAwE;AACxE,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;AAEpE,MAAM,MAAM,cAAc,GACxB,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE7D,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;CACjC;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,8DAA8D;IAC9D,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,mBAAmB,GAC3B;IAAE,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACnE;IAAE,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAA;CAAE,CAAC;AAE7C;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,GAAG,kBAAkB,GAAG;IACpD,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,sEAAsE;IACtE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAAC;CAC7C,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,qBAAqB,GAAG,kBAAkB,GAAG;IACvD,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;CACpC,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@excitedjs/dreamux-types",
-  "version": "0.11.0-beta.264",
-  "description": "Declaration-only provider-authoring contracts for Dreamux: Agent Runtime and Channel provider types external providers compile against without depending on @excitedjs/dreamux (issue excitedjs/dreamux#209).",
+  "version": "0.11.0-beta.271",
+  "description": "Declaration-only provider- and plugin-authoring contracts for Dreamux: Agent Runtime and Channel provider types and the plugin hook contract, which external providers and plugins compile against without depending on @excitedjs/dreamux (issue excitedjs/dreamux#209).",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -23,9 +23,13 @@
     "README.md",
     "LICENSE"
   ],
+  "dependencies": {
+    "tapable": "~2.3.3"
+  },
   "devDependencies": {
     "@types/node": "^22.10.0",
     "eslint": "^9.39.0",
+    "prettier": "^3.9.9",
     "typescript": "^5.7.0",
     "vitest": "^2.1.0",
     "@excitedjs/eslint-config": "0.0.0"
@@ -34,7 +38,7 @@
     "build": "tsc -p tsconfig.json",
     "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.tests.json",
     "typecheck:tests": "tsc -p tsconfig.tests.json",
-    "lint": "eslint .",
+    "lint": "eslint . && prettier --check . '!**/*.md' '!**/dist/**' '!**/CHANGELOG.json' '!**/.rush/**'",
     "test": "vitest run",
     "test:watch": "vitest",
     "clean": "rm -rf dist"

package/dist/command.d.ts

@@ -1,78 +0,0 @@
-/**
- * The generic Core Command port (declaration-only).
- *
- * There is one authoritative Command registry, not an admin method table plus a
- * separate Channel catalog. Both adapters — the `admin.sock` NDJSON server and
- * the in-process Channel invoker — resolve the same definition, run the same
- * validation, attach their factual caller context, execute the same domain
- * handler, and return the same typed result or error.
- *
- * These types carry no exposure/audience property, allowlist, describe-by-caller
- * hook, or capability negotiation: every registered Command is callable through
- * every adapter, subject only to its ordinary input and domain invariants.
- * Canonical Command payloads themselves live with the domain that owns them
- * (see `team.ts`).
- */
-import type { JsonSchema, JsonValue } from './json.js';
-/**
- * Which adapter admitted this Command invocation.
- *
- * There are exactly two, because an Agent no longer reaches Commands at all: an
- * Agent-facing MCP tool is served by its own delegate behind a runtime-generation
- * lease, so no adapter has to describe itself as “the MCP proxy”.
- */
-export type CoreCommandSource = 'admin_socket' | 'channel';
-/**
- * Factual invocation context. Some domain operations, logging, and deduplication
- * consume these fields. They never filter the registry.
- *
- * There is no caller identity here. Caller scope belongs to whoever bound it —
- * for MCP that is the delegate the lease resolves to — and a Command that read
- * one would be re-deriving a fact a lower layer already owns.
- */
-export interface CoreCommandContext {
-    readonly source: CoreCommandSource;
-    readonly dispatcher_id?: string;
-    readonly channel_id?: string;
-}
-/**
- * One domain-owned Command. Parsing, schemas, and execution belong to the
- * domain that owns the action, not to a transport adapter.
- */
-export interface CoreCommandDefinition<Name extends string, Input, Output> {
-    readonly name: Name;
-    readonly version: 1;
-    readonly input: JsonSchema;
-    readonly output: JsonSchema;
-    parse(payload: JsonValue): Input;
-    execute(context: CoreCommandContext, input: Input): Promise<Output>;
-}
-export interface CoreCommandRegistry {
-    invoke(context: CoreCommandContext, name: string, payload: JsonValue): Promise<JsonValue>;
-}
-/**
- * A typed Command failure returned across the generic port. `code` stays an
- * open string because each domain owns its own failure vocabulary; the two
- * codes that carry a cross-domain rule are named by
- * {@link ChannelCommandRetryableErrorCode}.
- */
-export interface ChannelCommandError {
-    readonly code: string;
-    readonly message: string;
-    /**
-     * The next step the failure stated for itself, when it stated one.
-     *
-     * Present exactly when the failure's own author wrote both halves of it — the
-     * reason and what to do about it — so a caller rendering this for an agent can
-     * repeat it as it stands. Absent means no next step was ever authored: a
-     * renderer carries the `code` and the `message` alone, and says nothing more.
-     */
-    readonly action?: string;
-}
-/**
- * The only pre-admission failures that permit a Channel to remove a stale
- * binding and retry once to the Dispatcher Agent. Every other failure — and any
- * `ambiguous` outcome — is never retried.
- */
-export type ChannelCommandRetryableErrorCode = 'TEAM_NOT_FOUND' | 'TEAM_CLOSED';
-//# sourceMappingURL=command.d.ts.map

package/dist/command.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../src/command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEvD;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG,cAAc,GAAG,SAAS,CAAC;AAE3D;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB,CAAC,IAAI,SAAS,MAAM,EAAE,KAAK,EAAE,MAAM;IACvE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,KAAK,CAAC,OAAO,EAAE,SAAS,GAAG,KAAK,CAAC;IACjC,OAAO,CAAC,OAAO,EAAE,kBAAkB,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACrE;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,CACJ,OAAO,EAAE,kBAAkB,EAC3B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,SAAS,GACjB,OAAO,CAAC,SAAS,CAAC,CAAC;CACvB;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;;;;;;;OAOG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,MAAM,gCAAgC,GAAG,gBAAgB,GAAG,aAAa,CAAC"}