@excitedjs/dreamux-types 0.2.0-alpha.g0ddd418597ca

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 excitedjs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,61 @@
+# @excitedjs/dreamux-types
+
+Declaration-only provider-authoring contracts for **Dreamux**.
+
+External Agent Runtime and Channel providers compile against this package for
+Dreamux contracts and **must not** import `@excitedjs/dreamux`. The host package
+owns Dispatcher/Team/TeamMate orchestration, provider loading, the Channel MCP
+shim, binding state, routing, and authorization; this package owns only the
+shared structural types.
+
+## Guarantees
+
+- **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.
+- **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.
+
+## What it exports
+
+- provider descriptor / ref shapes;
+- the complete Agent Runtime provider contract: `AgentRuntimeProvider`,
+  `AgentRuntime`, the neutral `AgentRuntimeCreateContext`, capabilities, role,
+  skill sources, completion delivery, resume/last/context, MCP server
+  descriptor, neutral state callbacks, and diagnostic helper shapes;
+- Channel provider/session contracts, target shapes, inbound envelope shapes,
+  tool descriptor/call shapes, and config/session contexts;
+- a minimal public logger type (`DreamuxLogger`).
+
+It does **not** export runtime implementations, default loggers, loader logic,
+provider registry implementations, path helpers, config parsers, or Dreamux host
+state models.
+
+A provider implements the full contract against this package only — see
+`tests/fixtures/external-provider.ts` for a complete `AgentRuntimeProvider`
+(`readConfig` + `getCapabilities` + `createRuntime`) and a `ChannelProvider`
+authored with `@excitedjs/dreamux-types` imports alone.
+
+> **Core convergence is in progress.** Dreamux core's own launcher still threads
+> a host-coupled create context internally; converging it onto the neutral
+> public `AgentRuntimeCreateContext` (and deleting the host-coupled variant in
+> `packages/dreamux/src/agent-runtime/types.ts`) is the runtime-split slice's job
+> (issue #209 slice 3). The public target published here is already stable for
+> external and built-in runtime/channel packages to author against.
+
+## Build / test
+
+Built and tested through the monorepo (rush) path — the only supported install
+path (see [the install-model decision](../../.agents/decisions/install-model.md)).
+From the repo root:
+
+```sh
+node common/scripts/install-run-rush.js update
+node common/scripts/install-run-rush.js build
+node common/scripts/install-run-rush.js test
+```
+
+The design record is
+[`.agents/decisions/npm-package-split-and-channel-targets.md`](../../.agents/decisions/npm-package-split-and-channel-targets.md).

package/dist/agent-runtime.d.ts

@@ -0,0 +1,388 @@
+/**
+ * Agent Runtime provider-authoring contracts (declaration-only).
+ *
+ * The complete, neutral Agent Runtime provider contract an external runtime
+ * package (or a future built-in runtime package such as
+ * `@excitedjs/agent-runtime-codex`) implements while importing only
+ * `@excitedjs/dreamux-types`. The public create context, runtime handle, state
+ * callbacks, and status are deliberately neutral: they never expose Dreamux
+ * host-private types (`DispatcherRow`, `DispatcherStore`, `DispatcherStatus`,
+ * `DispatcherConfig`, config/state stores, or host path-helper implementations).
+ * Dreamux core adapts its private objects into these public shapes.
+ *
+ * Note on sequencing: Dreamux core's own launcher still threads a host-coupled
+ * create context internally; converging that launcher onto this neutral context
+ * is the runtime-split slice's job (issue #209 slice 3). This package already
+ * publishes the stable public target so external and built-in runtime packages
+ * can be authored against it today.
+ */
+import type { DreamuxLogger } from './logger.js';
+import type { AgentRuntimeProviderDescriptor, DreamuxEnvironment, ProviderFactory } from './provider.js';
+import type { InboundDeliveryHooks, InboundDeliveryResult, InboundTurnInput, NoticeInjectionResult, TurnSettledSignal } from './turn.js';
+export interface AgentRuntimeMcpServer {
+    name: string;
+    command: string;
+    args: string[];
+}
+/** The role Dreamux core assigns to a runtime instance. */
+export type AgentRuntimeRole = 'dispatcher' | 'team_leader' | 'teammate' | 'team_member';
+/**
+ * A bundled skill source core hands to a runtime. Core selects sources by role;
+ * the runtime package owns the mechanics of applying them to its engine.
+ */
+export interface AgentRuntimeSkillSource {
+    name: string;
+    path: string;
+    /**
+     * How the runtime should mount `path` into its engine. An open string, not a
+     * closed union: a new runtime may define its own layout without a types bump.
+     * Standard layouts core emits today are `skill-dir` (a single skill directory,
+     * e.g. a Codex `skills/extraRoots` entry) and `claude-skills-parent` (the
+     * parent of a `.claude/skills` tree, e.g. a Claude `--add-dir` root). A runtime
+     * that does not recognize a layout should ignore that source, not fail.
+     */
+    layout: string;
+    source: 'dreamux-core' | string;
+}
+/**
+ * An open, source-agnostic completion delivery shape. Each runtime self-declares
+ * its own `kind` string inside its own capabilities; the shared contract never
+ * enumerates them.
+ */
+export interface CompletionDeliveryShape {
+    kind: string;
+    description: string;
+}
+export interface AgentRuntimeResumeCheckpoint {
+    /** Runtime-owned checkpoint kind; each runtime self-declares its own. */
+    kind: string;
+    id: string;
+}
+export type AgentRuntimeResumeCapability = {
+    supported: true;
+    checkpoint: AgentRuntimeResumeCheckpoint['kind'];
+} | {
+    supported: false;
+};
+export interface AgentRuntimeCapabilities {
+    /** Whether this runtime can resume a prior checkpoint, and which checkpoint id it expects. */
+    resume: AgentRuntimeResumeCapability;
+    /**
+     * Whether a follow-up turn delivered while a turn is active folds into that
+     * turn rather than queueing behind it. Purely behavioral: there is no separate
+     * "steer" method — core still delivers through `channelInput`/`systemInput`,
+     * and this flag only tells core whether mid-turn delivery is absorbed.
+     */
+    steer: {
+        supported: boolean;
+    };
+    /** How runtime events are surfaced to Dreamux. */
+    events: {
+        kind: 'push' | 'synthesized';
+    };
+    /** Whether {@link AgentRuntime.getLast} can report the last result. */
+    last: {
+        supported: boolean;
+    };
+    /** Whether {@link AgentRuntime.getContext} can report context-window usage. */
+    context: {
+        supported: boolean;
+    };
+    /**
+     * How the launcher-supplied role/system prompt content is applied: `replace`
+     * swaps the engine's base instructions, `append` adds to them.
+     */
+    systemPrompt: {
+        mode: 'replace' | 'append';
+    };
+    /** Upward delivery shapes this runtime supports for teammate completion. */
+    teammateCompletion: readonly CompletionDeliveryShape[];
+}
+/**
+ * A source-agnostic completion delivered upward to a runtime. `teammate` is one
+ * source; `id` identifies the completing entity within that source.
+ */
+export interface CompletionEnvelope {
+    source: string;
+    id: string;
+    status: 'completed' | 'failed' | 'stopped';
+    result: string;
+}
+export type TeamMateCompletionDeliveryResult = {
+    status: 'accepted';
+} | {
+    status: 'unsupported';
+    reason: string;
+} | {
+    status: 'failed';
+    error: Error;
+};
+export interface AgentRuntimeSystemInput {
+    kind: 'system';
+    text: string;
+    reason: 'restart-notice' | 'teammate-completion' | 'runtime-control';
+}
+export interface AgentRuntimeResumeInput {
+    checkpoint?: AgentRuntimeResumeCheckpoint | null;
+}
+export interface AgentRuntimeLastResult {
+    text: string | null;
+}
+export interface AgentRuntimeContextSnapshot {
+    usedTokens: number | null;
+    windowTokens: number | null;
+}
+export interface AgentRuntimePathContext {
+    /**
+     * The per-dispatcher root the runtime drops its own state files into.
+     * Neutral: the runtime derives its own subpaths from here. Volatile
+     * rendezvous sockets do NOT live here.
+     */
+    dispatcherDir(id: string): string;
+    /**
+     * The central logs root. The runtime composes its OWN log subpaths under this
+     * directory (e.g. `<logsDir>/<engine>/<id>.log`), so core never has to name a
+     * per-runtime log file. Neutral: a runtime that logs differently lays out its
+     * own tree here.
+     */
+    logsDir(): string;
+    /** The owning dispatcher's completion-spill directory in the cache tree. */
+    completionSpillDir(id: string): string;
+    /**
+     * Candidate directories for volatile rendezvous sockets, in host preference
+     * order. A runtime that needs a Unix-domain socket allocates a fresh random
+     * short name inside the first candidate whose full path fits the platform
+     * socket-path budget (see `@excitedjs/dreamux-utils` `unixSocketPathFitsBudget`).
+     * Neutral: a runtime that needs no socket (e.g. a stdio engine) ignores it.
+     * Sockets are never persisted and never live under {@link dispatcherDir}.
+     */
+    runtimeSocketDirs(): readonly string[];
+}
+export interface AgentRuntimeProviderConfigReadContext {
+    providerRef: string;
+    /**
+     * The `agents[].id` whose config block is being parsed — a config-internal
+     * alias, not a dispatcher identity.
+     */
+    agentId: string;
+    file: string;
+    prefix: string;
+}
+/**
+ * A neutral runtime-binary launch descriptor a provider declares for doctor.
+ * Pure data — the provider never runs it itself.
+ */
+export interface AgentRuntimeBinCheck {
+    name: string;
+    bin: string;
+    args: string[];
+}
+/**
+ * The neutral result of a provider's own (non-bin) diagnostic pass. `detail` is
+ * a one-line summary; `errors` are per-problem lines.
+ */
+export interface AgentRuntimeDoctorResult {
+    ok: boolean;
+    detail: string;
+    errors: string[];
+}
+/**
+ * The minimal command runner a provider's diagnostic needs. A structural subset
+ * of the CLI's command runner so the provider never imports host CLI modules.
+ */
+export interface AgentRuntimeDiagnosticRunner {
+    check(command: string, args: string[], options?: {
+        env?: DreamuxEnvironment;
+    }): Promise<boolean>;
+    capture(command: string, args: string[], options?: {
+        env?: DreamuxEnvironment;
+    }): Promise<string>;
+}
+/**
+ * Neutral runtime status. Mirrors the host's dispatcher lifecycle states without
+ * importing the host enum, so a provider can report status without depending on
+ * `@excitedjs/dreamux`.
+ */
+export type AgentRuntimeStatus = 'declared' | 'starting' | 'ready' | 'degraded' | 'stopping' | 'stopped';
+/**
+ * Neutral state sink the runtime writes status/thread transitions to. Dreamux
+ * core adapts its own dispatcher store to this shape; the runtime never sees the
+ * host store type.
+ */
+export interface AgentRuntimeStateCallbacks {
+    setStatus(id: string, status: AgentRuntimeStatus, extras?: {
+        last_error?: string | null;
+        last_started_at?: number;
+        last_ready_at?: number;
+    }): Promise<void>;
+    setThreadId(id: string, threadId: string): Promise<void>;
+    recordLostThread?(id: string, lostThreadId: string, newThreadId: string, error: string): Promise<void>;
+}
+export type AgentRuntimeTurnResult = InboundDeliveryResult | NoticeInjectionResult;
+/**
+ * The neutral, launcher-supplied identity of the runtime instance. Replaces the
+ * host's `DispatcherRow` in the public create context: a provider reads only the
+ * fields it needs (its own id, an optional resumable checkpoint id) and never
+ * the host row.
+ */
+export interface AgentRuntimeIdentity {
+    /** The runtime instance id (the dispatcher/teammate id the launcher assigns). */
+    runtime_id: string;
+    /**
+     * A prior resumable checkpoint id the launcher recovered, or null for a fresh
+     * start. The runtime interprets it per its own `resume` capability.
+     */
+    checkpoint_id?: string | null;
+}
+/**
+ * The neutral create context a provider's `createRuntime` receives. Carries the
+ * runtime identity, role, parsed provider config, cwd, optional system-prompt
+ * content, MCP servers, bundled skill sources, and neutral logger/path/state
+ * sinks. It never exposes host dispatcher rows, stores, or config models.
+ */
+export interface AgentRuntimeCreateContext<TConfig = unknown> {
+    identity: AgentRuntimeIdentity;
+    role: AgentRuntimeRole;
+    /** Provider-parsed config (the output of the provider's own `readConfig`). */
+    config: TConfig;
+    /**
+     * The directory the runtime runs in. Always supplied by the launcher; never
+     * derived inside the runtime.
+     */
+    cwd: string;
+    /**
+     * Launcher-supplied role/system-prompt content, applied per the runtime's
+     * `systemPrompt.mode` capability. Optional: teammate launches may omit it.
+     */
+    systemPromptContent?: string;
+    /**
+     * MCP servers the launcher injects for this runtime instance. Already fully
+     * resolved by core: an empty array means "no MCP servers", and the provider
+     * must launch exactly these — it must not infer, append, or mutate the list.
+     */
+    mcpServers: readonly AgentRuntimeMcpServer[];
+    /**
+     * Bundled skill sources core selected for this role. Empty for roles that
+     * receive no bundled Dreamux skills (ordinary teammate/team-member).
+     */
+    skillSources?: readonly AgentRuntimeSkillSource[];
+    logger?: DreamuxLogger;
+    paths?: AgentRuntimePathContext;
+    state?: AgentRuntimeStateCallbacks;
+    /**
+     * 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. Empty/omitted means "inject nothing" — the common
+     * case today.
+     */
+    injectEnv?: Record<string, string>;
+    /**
+     * Fired each time a delivered turn reaches a terminal state. Capability-
+     * neutral; the launcher opts in.
+     */
+    onTurnSettled?: (settled: TurnSettledSignal) => void;
+}
+/**
+ * The live runtime handle a provider's `createRuntime` returns. Neutral: its
+ * status type is {@link AgentRuntimeStatus}, not a host enum.
+ */
+export interface AgentRuntime {
+    readonly providerRef: string;
+    start(): Promise<void>;
+    resume(input?: AgentRuntimeResumeInput): Promise<void>;
+    stop(): Promise<void>;
+    /** Deliver a channel-inbound turn. */
+    channelInput(input: InboundTurnInput, hooks?: InboundDeliveryHooks): Promise<AgentRuntimeTurnResult>;
+    /** Inject a system-originated notice (e.g. a restart notice). */
+    systemInput(notice: AgentRuntimeSystemInput): Promise<AgentRuntimeTurnResult>;
+    getStatus(): AgentRuntimeStatus;
+    getThreadId(): string | null;
+    wasThreadResumed(): boolean;
+    /**
+     * The last assistant/user-visible result, or `null` when unavailable.
+     * A runtime whose `capabilities.last.supported` is false returns `null`
+     * rather than throwing or blocking — core treats `null` as "not reported".
+     */
+    getLast(): Promise<AgentRuntimeLastResult | null>;
+    /**
+     * Context-window usage, or `null` when unavailable. A runtime whose
+     * `capabilities.context.supported` is false returns `null` rather than
+     * throwing or blocking.
+     */
+    getContext(): Promise<AgentRuntimeContextSnapshot | null>;
+    getCapabilities(): AgentRuntimeCapabilities;
+    /**
+     * Deliver a teammate-completion envelope upward. Optional, and feature-detected
+     * by presence: a runtime that declares no `capabilities.teammateCompletion`
+     * shapes should omit this method entirely rather than ship a throwing/no-op
+     * stub, since callers test for the method, not the capability array.
+     */
+    completionInput?(completion: CompletionEnvelope): Promise<TeamMateCompletionDeliveryResult>;
+}
+/**
+ * Per-runtime diagnostic context. Neutral: it carries the runtime instance id,
+ * the provider-parsed config, the resolved env, and the doctor pass `scope`,
+ * rather than a host `DispatcherConfig`.
+ */
+export interface AgentRuntimeDiagnosticContext<TConfig = unknown> {
+    runtime_id: string;
+    config: TConfig;
+    env: DreamuxEnvironment;
+    scope: 'foreground' | 'managedService';
+    /**
+     * 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.
+     */
+    paths?: AgentRuntimePathContext;
+}
+/**
+ * A provider's self-reported diagnostics: it DECLARES the bin checks doctor
+ * should dedup + execute, and RUNS its own non-bin internal checks. Doctor
+ * iterates providers and calls these instead of branching on a builtin ref.
+ *
+ * Optional on {@link AgentRuntimeProvider}: a provider with no diagnostic surface
+ * omits it. The host supplies the {@link AgentRuntimeDiagnosticRunner} to
+ * `runDiagnostic`; the provider only implements the checks, never the runner.
+ */
+export interface AgentRuntimeDiagnostic<TConfig = unknown> {
+    binChecks(context: AgentRuntimeDiagnosticContext<TConfig>): AgentRuntimeBinCheck[];
+    runDiagnostic(context: AgentRuntimeDiagnosticContext<TConfig>, runner: AgentRuntimeDiagnosticRunner): Promise<AgentRuntimeDoctorResult>;
+}
+/**
+ * The Agent Runtime provider contract. An external or built-in runtime package
+ * implements this against `@excitedjs/dreamux-types` only.
+ */
+export interface AgentRuntimeProvider<TConfig = unknown> {
+    readonly ref: string;
+    readonly descriptor: AgentRuntimeProviderDescriptor;
+    getCapabilities(): AgentRuntimeCapabilities;
+    /**
+     * Parse + validate this provider's own config block. May return synchronously
+     * or as a promise; Dreamux core awaits the result, mirroring
+     * `ChannelProvider.readConfig`. A parse/validation failure must throw (the host
+     * fails loud), never return a partially-valid config.
+     */
+    readConfig?(rawConfig: Record<string, unknown>, context: AgentRuntimeProviderConfigReadContext): TConfig | Promise<TConfig>;
+    /**
+     * Self-reported doctor diagnostics. Optional: a provider with no diagnostic
+     * surface may omit it.
+     */
+    diagnostic?: AgentRuntimeDiagnostic<TConfig>;
+    createRuntime(context: AgentRuntimeCreateContext<TConfig>): AgentRuntime;
+}
+/**
+ * The default (or `npm:pkg#export`-selected) factory export an Agent Runtime
+ * package ships. Its {@link ProviderFactoryContext} carries the already-narrowed
+ * {@link AgentRuntimeProviderDescriptor}, so the package assigns
+ * `provider.descriptor` from the seed without a cast.
+ */
+export type AgentRuntimeProviderFactory<TConfig = unknown> = ProviderFactory<AgentRuntimeProvider<TConfig>, AgentRuntimeProviderDescriptor>;
+/** Re-export so provider packages can take a logger in their own contexts. */
+export type { DreamuxLogger };
+//# sourceMappingURL=agent-runtime.d.ts.map

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

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

package/dist/channel.d.ts

@@ -0,0 +1,190 @@
+/**
+ * Channel provider-authoring contracts (declaration-only).
+ *
+ * The neutral Channel provider seam external channel packages author against.
+ * Dreamux core owns binding state, routing, and authorization (binding a channel
+ * to a Team is a core Team-MCP capability, not a generic Channel MCP); a channel
+ * provider owns platform I/O, provider-specific tools, inbound normalization,
+ * target resolution, and message ownership facts.
+ *
+ * These contracts are forward-looking for the channel-provider slices. They live
+ * here because external channel packages must compile against
+ * `@excitedjs/dreamux-types` only and must not import `@excitedjs/dreamux`.
+ */
+import type { AgentRuntimeMcpServer } from './agent-runtime.js';
+import type { DreamuxLogger } from './logger.js';
+import type { ChannelProviderDescriptor, ProviderFactory } from './provider.js';
+import type { InboundDeliveryHooks, InboundDeliveryResult, InboundTurnInput } from './turn.js';
+export interface ChannelTarget {
+    target_type: string;
+    target_key: string;
+    bindable: boolean;
+    display?: string;
+    canonical_url?: string;
+    meta?: Record<string, unknown>;
+}
+export interface ChannelToolDescriptor {
+    name: string;
+    description?: string;
+    /**
+     * Intentionally unrestricted: Dreamux types must not constrain the tool
+     * schemas a provider package exposes.
+     */
+    inputSchema?: unknown;
+}
+export interface ChannelSender {
+    id?: string;
+    display?: string;
+    meta?: Record<string, unknown>;
+}
+export interface ChannelInboundEnvelope {
+    provider: string;
+    channel_id: string;
+    target: ChannelTarget;
+    event_id?: string;
+    message_id?: string;
+    sender?: ChannelSender;
+    metadata?: Record<string, unknown>;
+}
+export interface ChannelConfigContext {
+    dispatcher_id: string;
+    channel_id: string;
+    provider: string;
+}
+export interface ChannelSessionCreateContext<TConfig = unknown> {
+    dispatcher_id: string;
+    channel_id: string;
+    provider: string;
+    config: TConfig;
+    logger?: DreamuxLogger;
+    state_root?: string;
+    cache_root?: string;
+}
+export interface ChannelReplyInput {
+    target: ChannelTarget;
+    text: string;
+    meta?: Record<string, unknown>;
+}
+export interface ChannelReactInput {
+    target: ChannelTarget;
+    message_id: string;
+    reaction: string;
+}
+export interface ChannelToolListContext {
+    dispatcher_id: string;
+    channel_id: string;
+}
+export interface ChannelToolCall {
+    name: string;
+    arguments: Record<string, unknown>;
+}
+export interface ChannelToolContext {
+    dispatcher_id: string;
+    channel_id: string;
+    logger?: DreamuxLogger;
+}
+export interface ChannelMessageTargetCheck {
+    target: ChannelTarget;
+    message_id: string;
+    meta?: Record<string, unknown>;
+}
+export interface ChannelRoutes {
+    /**
+     * Deliver a normalized inbound to Dreamux core. The channel session supplies
+     * the neutral turn {@link InboundTurnInput} (text/body/attrs/attachments it
+     * normalized) plus the routing/identity {@link ChannelInboundEnvelope}; core
+     * dedupes (on `input.sourceId`), submits the turn, and returns the neutral
+     * {@link InboundDeliveryResult} — the channel session keys its own
+     * reaction/ack ledger off the `submitted` turn id. `hooks.onAccepted` (if
+     * given) fires after dedupe accepts and before submit, so the channel can mark
+     * the message received. A channel inbound never yields `'skipped'` (that is a
+     * notice-only state), so the union is exactly the inbound-delivery one.
+     */
+    deliver(input: InboundTurnInput, envelope: ChannelInboundEnvelope, hooks?: InboundDeliveryHooks): Promise<InboundDeliveryResult>;
+}
+/**
+ * The context core passes to {@link ChannelSession.mcpServerDescriptor}. Carries
+ * the host bin command + admin-socket path the channel's stdio MCP shim forwards
+ * to, plus the caller identity so the descriptor can scope its tool calls. The
+ * provider builds its own stdio descriptor from these neutral pieces; core never
+ * names the channel's tool transport.
+ */
+export interface ChannelMcpDescriptorContext {
+    /** The Dreamux bin command the channel's MCP shim is spawned as. */
+    command: string;
+    /** The admin Unix-socket path the shim forwards tool calls to. */
+    adminSocketPath: string;
+    dispatcher_id: string;
+    /** Which agent role hosts the MCP server (scopes the shim's admin calls). */
+    callerKind?: 'dispatcher' | 'team_leader';
+    team_id?: string;
+    leader_name?: string;
+}
+/**
+ * The context core passes to {@link ChannelProvider.handleSessionlessTool}. A
+ * sessionless tool runs without a live {@link ChannelSession} (e.g. listing the
+ * bots in a chat before any binding exists), so it gets only neutral host
+ * locators, never a session handle.
+ */
+export interface ChannelSessionlessToolContext {
+    dispatcher_id: string;
+    /** The per-dispatcher state root the provider may read credentials/state from. */
+    state_root?: string;
+    logger?: DreamuxLogger;
+}
+export interface ChannelSession {
+    readonly provider: string;
+    readonly channel_id: string;
+    start(routes: ChannelRoutes): Promise<void>;
+    close(): Promise<void>;
+    resolveTarget(meta: unknown): Promise<ChannelTarget>;
+    /** Send a reply. Omit entirely if the platform has no outbound reply path. */
+    reply?(input: ChannelReplyInput): Promise<unknown>;
+    /** Add a reaction. Omit entirely if the platform has no reaction surface. */
+    react?(input: ChannelReactInput): Promise<unknown>;
+    /** Provider-specific MCP tools. Omit if the provider exposes none. */
+    tools?(context: ChannelToolListContext): readonly ChannelToolDescriptor[];
+    /**
+     * Handle a provider-specific tool call. Omit when `tools` is omitted; the two
+     * go together. These optional members are absent, not no-op stubs, when the
+     * platform does not support them — core feature-detects by presence.
+     */
+    handleTool?(call: ChannelToolCall, context: ChannelToolContext): Promise<unknown>;
+    /** Decide message ownership for routing. Omit if the platform cannot. */
+    messageBelongsToTarget?(input: ChannelMessageTargetCheck): boolean | Promise<boolean>;
+    /**
+     * Build the stdio MCP server descriptor that backs this channel's
+     * provider-specific tools for a runtime. Returns `null` when the channel
+     * exposes no MCP surface for the given caller. Omit entirely if the channel
+     * never exposes one. The descriptor is an {@link AgentRuntimeMcpServer} so a
+     * runtime can launch it through the same neutral MCP-server seam as any other.
+     */
+    mcpServerDescriptor?(context: ChannelMcpDescriptorContext): AgentRuntimeMcpServer | null;
+}
+export interface ChannelProvider<TConfig = unknown> {
+    readonly ref: string;
+    readonly descriptor: ChannelProviderDescriptor;
+    readConfig?(raw: unknown, context: ChannelConfigContext): TConfig | Promise<TConfig>;
+    createSession(context: ChannelSessionCreateContext<TConfig>): ChannelSession;
+    /**
+     * Self-report a neutral, opaque channel identity for this config (e.g. the
+     * bot app id). Core stores and displays the string but never interprets it,
+     * so it never has to name a provider config field. Omit if the channel has no
+     * stable identity to report.
+     */
+    getIdentity?(config: TConfig): string;
+    /**
+     * Handle a tool call that has no live {@link ChannelSession} (e.g. a discovery
+     * tool used before any binding exists). Omit when the channel exposes no
+     * sessionless tools. Feature-detected by presence.
+     */
+    handleSessionlessTool?(name: string, args: Record<string, unknown>, context: ChannelSessionlessToolContext): Promise<unknown>;
+}
+/**
+ * The default (or `npm:pkg#export`-selected) factory export a Channel package
+ * ships. Its {@link ProviderFactoryContext} carries the already-narrowed
+ * {@link ChannelProviderDescriptor}, so the package assigns `provider.descriptor`
+ * from the seed without a cast.
+ */
+export type ChannelProviderFactory<TConfig = unknown> = ProviderFactory<ChannelProvider<TConfig>, ChannelProviderDescriptor>;
+//# sourceMappingURL=channel.d.ts.map

package/dist/channel.d.ts.map

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

package/dist/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @excitedjs/dreamux-types
+ *
+ * Declaration-only provider-authoring contracts for Dreamux. External Agent
+ * 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
+ * `.agents/decisions/npm-package-split-and-channel-targets.md`.
+ *
+ * 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
+ * being reached only *contextually* today — through a property of one of these
+ * interfaces or an implemented method's parameter — is not a reason to hide it:
+ * the package is type-only, so re-exporting a public type costs nothing at
+ * runtime and keeps the surface honest (a provider author can name a shape they
+ * legitimately depend on). The `exports` map publishes only this root, so this
+ * list IS the public API. `tests/root-exports.test.ts` locks the surface to the
+ * full set of public types in the source modules so future slices grow it
+ * deliberately, not by accident.
+ */
+export type { DreamuxLogger } from './logger.js';
+export type { AgentRuntimeProviderDescriptor, BuiltinProviderRef, ChannelProviderDescriptor, DreamuxEnvironment, NpmProviderRef, ProviderDescriptor, ProviderFactory, ProviderFactoryContext, ProviderKind, ProviderRef, ProviderRefSource, } from './provider.js';
+export type { InboundAttachment, InboundDeliveryHooks, InboundDeliveryResult, InboundTurnInput, NoticeInjectionResult, TurnSettledSignal, } from './turn.js';
+export type { AgentRuntime, AgentRuntimeBinCheck, AgentRuntimeCapabilities, AgentRuntimeContextSnapshot, AgentRuntimeCreateContext, AgentRuntimeDiagnostic, AgentRuntimeDiagnosticContext, AgentRuntimeDiagnosticRunner, AgentRuntimeDoctorResult, AgentRuntimeIdentity, AgentRuntimeLastResult, AgentRuntimeMcpServer, AgentRuntimePathContext, AgentRuntimeProvider, AgentRuntimeProviderConfigReadContext, AgentRuntimeProviderFactory, AgentRuntimeResumeCapability, AgentRuntimeResumeCheckpoint, AgentRuntimeResumeInput, AgentRuntimeRole, AgentRuntimeSkillSource, AgentRuntimeStateCallbacks, AgentRuntimeStatus, AgentRuntimeSystemInput, AgentRuntimeTurnResult, CompletionDeliveryShape, CompletionEnvelope, TeamMateCompletionDeliveryResult, } from './agent-runtime.js';
+export type { ChannelConfigContext, ChannelInboundEnvelope, ChannelMcpDescriptorContext, ChannelMessageTargetCheck, ChannelProvider, ChannelProviderFactory, ChannelReactInput, ChannelReplyInput, ChannelRoutes, ChannelSender, ChannelSession, ChannelSessionCreateContext, ChannelSessionlessToolContext, ChannelTarget, ChannelToolCall, ChannelToolContext, ChannelToolDescriptor, ChannelToolListContext, } from './channel.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,YAAY,EACV,8BAA8B,EAC9B,kBAAkB,EAClB,yBAAyB,EACzB,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,sBAAsB,EACtB,YAAY,EACZ,WAAW,EACX,iBAAiB,GAClB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACrB,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,YAAY,EACZ,oBAAoB,EACpB,wBAAwB,EACxB,2BAA2B,EAC3B,yBAAyB,EACzB,sBAAsB,EACtB,6BAA6B,EAC7B,4BAA4B,EAC5B,wBAAwB,EACxB,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,EACvB,oBAAoB,EACpB,qCAAqC,EACrC,2BAA2B,EAC3B,4BAA4B,EAC5B,4BAA4B,EAC5B,uBAAuB,EACvB,gBAAgB,EAChB,uBAAuB,EACvB,0BAA0B,EAC1B,kBAAkB,EAClB,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACvB,kBAAkB,EAClB,gCAAgC,GACjC,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,oBAAoB,EACpB,sBAAsB,EACtB,2BAA2B,EAC3B,yBAAyB,EACzB,eAAe,EACf,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,cAAc,EACd,2BAA2B,EAC3B,6BAA6B,EAC7B,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,cAAc,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Minimal public logger contract for provider packages.
+ *
+ * Intentionally smaller than pino: a provider authored against
+ * `@excitedjs/dreamux-types` depends only on this shape. Dreamux core adapts
+ * its own logger to this contract; provider packages own their minimal console
+ * fallback when core passes no logger. That fallback is implementation code and
+ * does not belong in this declaration-only package.
+ */
+export interface DreamuxLogger {
+    error(message: string, fields?: Record<string, unknown>): void;
+    warn(message: string, fields?: Record<string, unknown>): void;
+    info(message: string, fields?: Record<string, unknown>): void;
+    debug(message: string, fields?: Record<string, unknown>): void;
+    trace(message: string, fields?: Record<string, unknown>): void;
+    child?(fields: Record<string, unknown>): DreamuxLogger;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC/D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC9D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC9D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC/D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC/D,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,aAAa,CAAC;CACxD"}

package/dist/provider.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Provider reference and descriptor shapes.
+ *
+ * Declaration-only structural contracts shared between Dreamux core and external
+ * provider packages. Parsing, validation, and the in-process registry are
+ * runtime concerns owned by `@excitedjs/dreamux`; this package exposes only the
+ * shapes so providers can be authored without depending on the host.
+ */
+/** Where a provider's implementation comes from. */
+export type ProviderRefSource = 'builtin' | 'npm';
+/** A bundled, first-party provider selected by id, e.g. `builtin:codex`. */
+export interface BuiltinProviderRef {
+    source: 'builtin';
+    /** Bundled provider id, e.g. `codex` or `claude-code`. */
+    id: string;
+    /** The original, canonical string form. */
+    raw: string;
+}
+/**
+ * An external provider selected by npm package, optionally narrowed to a named
+ * export.
+ */
+export interface NpmProviderRef {
+    source: 'npm';
+    /** npm package name, e.g. `@example/dreamux-provider` or `some-provider`. */
+    package: string;
+    /** Named export within the package, or null for the package default. */
+    export: string | null;
+    /** The original, canonical string form. */
+    raw: string;
+}
+export type ProviderRef = BuiltinProviderRef | NpmProviderRef;
+/** Kinds of provider the registry can hold. */
+export type ProviderKind = 'channel' | 'agentRuntime';
+/** A registered provider descriptor. Capabilities live on provider instances. */
+export interface ProviderDescriptor {
+    /** Stable registry id; builtin providers use their builtin id. */
+    id: string;
+    kind: ProviderKind;
+    ref: ProviderRef;
+}
+/** A descriptor narrowed to the Agent Runtime kind. */
+export type AgentRuntimeProviderDescriptor = ProviderDescriptor & {
+    kind: 'agentRuntime';
+};
+/** A descriptor narrowed to the Channel kind. */
+export type ChannelProviderDescriptor = ProviderDescriptor & {
+    kind: 'channel';
+};
+/**
+ * A Dreamux-owned environment map: variable name → value (or `undefined` when
+ * unset). Declaration-only and host-neutral so provider packages never reference
+ * a Node process-env typings global in their public surface — this is the
+ * sanctioned neutral env shape (issue #209 public-types audit, P0).
+ */
+export type DreamuxEnvironment = Record<string, string | undefined>;
+/**
+ * The context Dreamux core hands a provider package's factory export. Mirrors the
+ * core loader's call exactly — the canonical `ref` and the seed `descriptor` the
+ * provider must echo back on its own `descriptor`. `TDescriptor` lets kind-
+ * specific factory aliases carry the already-narrowed descriptor kind.
+ */
+export interface ProviderFactoryContext<TDescriptor extends ProviderDescriptor = ProviderDescriptor> {
+    /** Canonical provider ref, e.g. `npm:some-pkg#provider` or `builtin:codex`. */
+    ref: string;
+    /** Seed descriptor the provider must echo back on its own `descriptor`. */
+    descriptor: TDescriptor;
+}
+/**
+ * A provider package's factory export (default export, or the named export a
+ * `npm:pkg#export` ref selects). Dreamux core invokes it with a
+ * {@link ProviderFactoryContext} and registers the returned provider.
+ */
+export type ProviderFactory<TProvider, TDescriptor extends ProviderDescriptor = ProviderDescriptor> = (context: ProviderFactoryContext<TDescriptor>) => TProvider | Promise<TProvider>;
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,oDAAoD;AACpD,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,KAAK,CAAC;AAElD,4EAA4E;AAC5E,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,SAAS,CAAC;IAClB,0DAA0D;IAC1D,EAAE,EAAE,MAAM,CAAC;IACX,2CAA2C;IAC3C,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,KAAK,CAAC;IACd,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,2CAA2C;IAC3C,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,MAAM,WAAW,GAAG,kBAAkB,GAAG,cAAc,CAAC;AAE9D,+CAA+C;AAC/C,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,cAAc,CAAC;AAEtD,iFAAiF;AACjF,MAAM,WAAW,kBAAkB;IACjC,kEAAkE;IAClE,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,YAAY,CAAC;IACnB,GAAG,EAAE,WAAW,CAAC;CAClB;AAED,uDAAuD;AACvD,MAAM,MAAM,8BAA8B,GAAG,kBAAkB,GAAG;IAChE,IAAI,EAAE,cAAc,CAAC;CACtB,CAAC;AAEF,iDAAiD;AACjD,MAAM,MAAM,yBAAyB,GAAG,kBAAkB,GAAG;IAC3D,IAAI,EAAE,SAAS,CAAC;CACjB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAEpE;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB,CACrC,WAAW,SAAS,kBAAkB,GAAG,kBAAkB;IAE3D,+EAA+E;IAC/E,GAAG,EAAE,MAAM,CAAC;IACZ,2EAA2E;IAC3E,UAAU,EAAE,WAAW,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,MAAM,eAAe,CACzB,SAAS,EACT,WAAW,SAAS,kBAAkB,GAAG,kBAAkB,IACzD,CACF,OAAO,EAAE,sBAAsB,CAAC,WAAW,CAAC,KACzC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC"}

package/dist/turn.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Neutral inbound-turn contract declarations.
+ *
+ * Declaration-only subset of the core turn contract: the data shapes a provider
+ * package needs to author against. The runtime helpers (`renderChannelInput`,
+ * the dedupe-window constant) stay in `@excitedjs/dreamux` because they are
+ * executable code, not declarations.
+ */
+/**
+ * A channel-supplied attachment, in a neutral shape (no channel-typed field
+ * names). Passed through to the runtime so a runtime can render attachments its
+ * own way.
+ */
+export interface InboundAttachment {
+    /** Opaque media kind the channel assigns, e.g. `image` | `file`. */
+    kind: string;
+    /** Display name when the channel knows one. */
+    name?: string;
+    /** Local filesystem path when the channel downloaded the resource; absent otherwise. */
+    localPath?: string;
+}
+export interface InboundTurnInput {
+    /** The turn text to deliver to the agent (used when no channel body is set). */
+    text: string;
+    /**
+     * Stable dedupe / correlation id for this inbound. An empty string disables
+     * dedupe.
+     */
+    sourceId: string;
+    /**
+     * Opaque channel-source label (e.g. `feishu`), rendered as the
+     * `<channel source="…">` attribute. Data, not a typed concept.
+     */
+    source?: string;
+    /**
+     * Opaque display attributes rendered verbatim into the runtime's channel
+     * block. The runtime MUST NOT interpret or route on them.
+     */
+    attrs?: Array<[string, string]>;
+    /** Pre-rendered, already-escaped message body the runtime wraps into its channel block. */
+    body?: string;
+    /** Structured attachments for future per-runtime rendering. */
+    attachments?: readonly InboundAttachment[];
+}
+export type InboundDeliveryResult = {
+    status: 'duplicate';
+} | {
+    status: 'stopped';
+} | {
+    status: 'submitted';
+    turnId: string;
+} | {
+    status: 'failed';
+    error: Error;
+};
+/**
+ * Result of a best-effort restart-notice injection. `skipped` means a real
+ * inbound had already been handed to the runtime.
+ */
+export type NoticeInjectionResult = {
+    status: 'stopped';
+} | {
+    status: 'skipped';
+} | {
+    status: 'submitted';
+    turnId: string;
+} | {
+    status: 'failed';
+    error: Error;
+};
+export interface InboundDeliveryHooks {
+    /**
+     * Called after process-local dedupe accepts the message and before the turn
+     * is submitted.
+     */
+    onAccepted?: (input: InboundTurnInput) => void | Promise<void>;
+}
+/**
+ * A neutral "turn settled" signal: a delivered turn reached a terminal state.
+ * Capability-neutral — carries no channel or runtime specifics.
+ */
+export interface TurnSettledSignal {
+    turnId: string | null;
+    status: 'completed' | 'failed' | 'stopped';
+    error?: Error;
+}
+//# sourceMappingURL=turn.d.ts.map

package/dist/turn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn.d.ts","sourceRoot":"","sources":["../src/turn.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wFAAwF;IACxF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAChC,2FAA2F;IAC3F,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,WAAW,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAC5C;AAED,MAAM,MAAM,qBAAqB,GAC7B;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,GACvB;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC;AAEvC;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAC7B;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC;AAEvC,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChE;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC3C,KAAK,CAAC,EAAE,KAAK,CAAC;CACf"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@excitedjs/dreamux-types",
+  "version": "0.2.0-alpha.g0ddd418597ca",
+  "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).",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/excitedjs/dreamux.git",
+    "directory": "packages/dreamux-types"
+  },
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "engines": {
+    "node": ">=22.7"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "eslint": "^9.39.0",
+    "typescript": "^5.7.0",
+    "vitest": "^2.1.0",
+    "@excitedjs/eslint-config": "0.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "typecheck:tests": "tsc -p tsconfig.tests.json",
+    "lint": "eslint .",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist"
+  }
+}