@skaile/workspaces 0.8.5

package/dist/types/src/manifests/skill.d.ts.map

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

package/dist/types/src/mentions.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Mentions — types for @-mention support in session messages.
+ *
+ * A Mention records who was addressed in a message, whether a specific user
+ * or a well-known group. Group mentions carry a resolved array of user IDs
+ * so consumers can perform membership checks without the resolver.
+ */
+/**
+ * Well-known group mention targets as a `const` array.
+ *
+ * Use this for validation or exhaustive checks against `MentionGroup`.
+ *
+ * @docLink packages/types/messages#mention
+ */
+export declare const MENTION_GROUPS: readonly ["agent", "humans", "humans_here", "here", "all"];
+/**
+ * A well-known group that can be `@`-mentioned: `'agent' | 'humans' | 'humans_here' | 'here' | 'all'`.
+ *
+ * @docLink packages/types/messages#mention
+ */
+export type MentionGroup = (typeof MENTION_GROUPS)[number];
+/**
+ * A parsed `@`-mention in a session message. Records who was addressed — either a
+ * specific user or a well-known group — along with the source text position.
+ *
+ * Group mentions carry a resolved array of user IDs so consumers can perform
+ * membership checks without needing the resolver.
+ *
+ * @docLink packages/types/messages#mention
+ */
+export type Mention = {
+    type: "user";
+    userId: string;
+    name: string;
+    /** Position of the `@` character in the source text. */
+    offset: number;
+    /** Length of the full `@token` string including the `@`. */
+    length: number;
+} | {
+    type: "group";
+    group: MentionGroup;
+    /** User IDs resolved at parse time (e.g. all online users for `@here`). */
+    resolved: string[];
+    /** Position of the `@` character in the source text. */
+    offset: number;
+    /** Length of the full `@token` string including the `@`. */
+    length: number;
+};
+//# sourceMappingURL=mentions.d.ts.map

package/dist/types/src/mentions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mentions.d.ts","sourceRoot":"","sources":["../../../types/src/mentions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,4DAA6D,CAAC;AAEzF;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAM3D;;;;;;;;GAQG;AACH,MAAM,MAAM,OAAO,GACf;IACE,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAC;CAChB,GACD;IACE,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,YAAY,CAAC;IACpB,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC"}

package/dist/types/src/messaging.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Messaging layer — Protocol v2's named grouping of conversational metadata
+ * fields that ride on the {@link MessageV2} envelope.
+ *
+ * The `Message` back-compat alias (defined in `index.ts`) keeps top-level
+ * `senderId`, `mentions`, and `reactions` fields for backward compatibility.
+ * The v2 envelope ({@link MessageV2}) carries those plus `recipientIds` and
+ * `reply` under a single `meta` field typed as {@link MessageMeta}.
+ *
+ * `MessageMeta` is generic over an extensions type parameter so host platforms
+ * can add typed metadata fields (e.g. `priority`, `archived`) without forking
+ * the framework. Framework-side code uses the default form
+ * (`MessageMeta<Record<string, never>>`); platforms declare their own
+ * extension type and use the typed alias at their boundaries.
+ *
+ * @see {@link MessageV2} envelope
+ * @see {@link ProtocolVersion}
+ *
+ * @category Messaging
+ * @since 2.0.0
+ */
+import type { Mention } from "./mentions.js";
+import type { Reaction } from "./reactions.js";
+/**
+ * Optional reply context attached to a message. The runner / platform
+ * formats this as a quoted preamble in the prompt sent to the agent — the
+ * agent SDK never sees this object directly.
+ *
+ * In v1 this was {@link PromptReplyTo} on `protocol.ts`; v2 renames it
+ * to `ReplyRef` and moves it to the messaging layer.
+ *
+ * @category Messaging
+ * @since 2.0.0
+ * @docLink packages/types/messages#reply-ref
+ */
+export type ReplyRef = {
+    /** Database id of the message being replied to. */
+    messageId: string;
+    /** Display name of the parent message's sender (incl. `"Assistant"` for agent). */
+    senderName: string;
+    /** First ~120 chars of the parent payload text. */
+    snippet: string;
+    /** Monotonic seq of the parent message in the same session. */
+    seq: number;
+};
+/**
+ * Conversational metadata for the v2 {@link MessageV2} envelope. All fields
+ * are optional; minimal clients can omit `meta` entirely.
+ *
+ * `MessageMeta` is **generic over an extensions type parameter** so host
+ * platforms can add typed fields without forking the framework. The default
+ * form (no type argument) is the framework-standard shape.
+ *
+ * @example Platform-side aliasing for typed extensions:
+ * ```ts
+ * type PlatformMetaExtensions = {
+ *   priority?: 'low' | 'normal' | 'high'
+ *   archived?: boolean
+ * };
+ * export type PlatformMessageMeta = MessageMeta<PlatformMetaExtensions>;
+ * ```
+ *
+ * # Round-trip preservation contract
+ *
+ * Implementations that store and replay `MessageMeta` MUST preserve unknown
+ * fields on round-trip. A v1-aware client reading a v2-emitted message must
+ * still emit the v2 extension fields back to other consumers when it
+ * forwards the message — even though it cannot interpret them.
+ *
+ * In practice, this is a one-line spread in any persistence layer
+ * (`{ ...row.meta, priority: 'high' }`); it does not need a framework-provided
+ * codec. Each platform implements its own meta-to-storage mapping according to
+ * its DB schema (separate JSONB column, per-field columns, merged into payload,
+ * etc.). The framework's responsibility ends at the type definitions and the
+ * contract.
+ *
+ * @typeParam TExtensions - platform-specific extension fields, defaults to no extensions.
+ *
+ * @category Messaging
+ * @since 2.0.0
+ * @docLink packages/types/messages#message-meta
+ */
+export type MessageMeta<TExtensions extends object = Record<string, never>> = TExtensions & {
+    /** User attribution for user-originated payloads; `undefined` denotes the agent. */
+    senderId?: string;
+    /**
+     * Recipients of the message:
+     * - missing or `[]` — broadcast to all session members (current behavior)
+     * - `[userId]` — private message to one recipient
+     * - `[userId, userId, ...]` — group message to a subset
+     * - `["agent"]` — agent-to-agent direct (whisper); not displayed to humans
+     *
+     * Enforcement (filtering, persistence) is up to the host platform.
+     */
+    recipientIds?: string[];
+    /** Optional reply-context for threading. */
+    reply?: ReplyRef;
+    /** `@`-mentions parsed from the message text, if any. */
+    mentions?: Mention[];
+    /** Emoji reactions on this message, if any. */
+    reactions?: Reaction[];
+};
+export type { Mention, MentionGroup } from "./mentions.js";
+export type { Reaction } from "./reactions.js";
+//# sourceMappingURL=messaging.d.ts.map

package/dist/types/src/messaging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messaging.d.ts","sourceRoot":"","sources":["../../../types/src/messaging.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAM/C;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,mFAAmF;IACnF,UAAU,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAMF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,MAAM,WAAW,CAAC,WAAW,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,WAAW,GAAG;IAC1F,oFAAoF;IACpF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;;;OAQG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;CACxB,CAAC;AAIF,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC3D,YAAY,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/types/src/protocol.d.ts

@@ -0,0 +1,201 @@
+/**
+ * Agent Protocol — messages exchanged between agent client and server.
+ *
+ * AgentCommand: sent toward the agent (client → server)
+ * AgentEvent:   sent from the agent (server → client) — defined in events.ts
+ *
+ * Protocol v3 (since `@skaile/workspaces/types@4.0.0`, shipped 2026-05-10) removed
+ * the following commands from the {@link AgentCommand} union: `configure` /
+ * `ConfigureCommandV2`, `provision_secrets`, `request_access_token`,
+ * `add_resource`, `remove_resource`, `set_log_level`, `state_action`,
+ * `lifecycle`, `remount_mount`, `compact`, `reconfigure_agent`. Their
+ * semantics ride on:
+ *   - {@link SessionInitCommand} (one deterministic envelope at session
+ *     start that delivers identity, resolved config, pre-minted credentials,
+ *     secrets, capabilities, shared state, active flows, resume hints, and
+ *     logging config), and
+ *   - `host.*` / `runner.*` capability invocations (bidirectional
+ *     capability registry).
+ *
+ * Spec: `_devlog/specs/2026-05-10-deterministic-session-bootstrap.md`.
+ */
+import type { CapabilityApproveCommand, CapabilityDeregisterCommand, CapabilityRegisterCommand, CapabilityResultCommand } from "./capabilities.js";
+import type { ConnectorContent, ConnectorOperation, ListOptions, SearchOptions } from "./events.js";
+import type { ReplyRef } from "./messaging.js";
+/**
+ * Discriminated union of all commands sent from client to agent server.
+ *
+ * Narrow via `command.type` or a `switch` statement.
+ *
+ * @docLink packages/types/protocol-v3#agent-command
+ */
+export type AgentCommand = {
+    type: "prompt";
+    prompt: string;
+    replyTo?: ReplyRef;
+} | {
+    type: "reply";
+    answer: string;
+} | {
+    type: "cancel";
+} | {
+    type: "shutdown";
+} | ConnectorRequestCommand | DebugCommand | ConnectorMutateCommand | ConnectorQueryCommand | ConnectorConfigCommand | StateUpdateCommand | CustomMessageCommand | CapabilityRegisterCommand | CapabilityDeregisterCommand | CapabilityResultCommand | CapabilityApproveCommand;
+/**
+ * A resource declaration carried by `runner.add_mount` / `runner.add_connector`
+ * capability invocations. Mirrors the `skaile.yaml` mount/connector schema
+ * but flattened for transport.
+ *
+ * Used by:
+ *   - {@link ResolvedSkaileConfig.mounts} / `.connectors` (lifecycle.ts)
+ *   - `runner.add_mount.input.declaration` / `runner.add_connector.input.declaration`
+ *
+ * @docLink packages/types/protocol-v3#resource-declaration
+ */
+export type ResourceDeclaration = {
+    id: string;
+    driver: string;
+    source: string;
+    target?: string;
+    access: "read-only" | "read-write";
+    auth?: string;
+    /**
+     * Identifier of the `ProviderLink` this resource is bound to when
+     * `auth: 'backend'`. Read by the platform credential mediator to dispatch
+     * the mint (and re-read by the runner when an `exposeAccessToken` git
+     * mount needs to surface a managed-gitconfig credential helper). Optional
+     * because not every backend-auth driver is provider-linked, and not every
+     * resource uses backend auth.
+     */
+    providerLinkId?: string;
+    options?: Record<string, unknown>;
+};
+/**
+ * Migration strategy carried by `runner.add_mount.input.migration` when
+ * replacing the workspace mount of an empty project.
+ *
+ * @docLink packages/types/protocol-v3#resource-migration
+ */
+export type ResourceMigration = {
+    strategy: "replace-workspace";
+    targetFolder?: string | null;
+} | {
+    strategy: "none";
+};
+/**
+ * Generic connector mutation. Routes to ConnectorManager.executeOp(id, op, payload).
+ * Replaces the typed flow commands in Protocol 2.2 — see
+ * MIGRATION-flow-connector.md for the per-op mapping table.
+ *
+ * @docLink packages/types/protocol-v3#connector-mutate-command
+ * @since 2.2.0
+ */
+export type ConnectorMutateCommand = {
+    type: "connector_mutate";
+    /** Target connector id (matches `connectors[].id` in skaile.yaml). */
+    id: string;
+    /** Operation name as declared by the adapter's describeOperations(). */
+    op: string;
+    /** Operation arguments. Adapter-specific shape. Optional for nullary ops. */
+    payload?: Record<string, unknown>;
+};
+/**
+ * Generic connector read. Same dispatch as connector_mutate but the result
+ * is returned to the caller as a `connector_query_response` event correlated
+ * by `requestId`. Use for read-only queries that should not kick a turn.
+ *
+ * @since 2.2.0
+ */
+export type ConnectorQueryCommand = {
+    type: "connector_query";
+    requestId: string;
+    id: string;
+    op: string;
+    payload?: Record<string, unknown>;
+};
+/**
+ * Query the internal state of a running agent server for diagnostics.
+ *
+ * @docLink packages/types/protocol-v3#debug-command
+ */
+export type DebugCommand = {
+    type: "debug";
+    query: "tools" | "connectors" | "mcp" | "config" | "state" | "commands";
+    args?: Record<string, unknown>;
+};
+/**
+ * Browse or modify connectors from the frontend.
+ *
+ * The wire `type:` string is `"resource_request"` for protocol stability.
+ * The server responds with a `ConnectorResponseEvent` correlated by `requestId`.
+ *
+ * @docLink packages/types/protocol-v3#connector-request-command
+ */
+export type ConnectorRequestCommand = {
+    type: "resource_request";
+    /** UUID for request/response correlation. */
+    requestId: string;
+    /** Connector ID (e.g. "docs", "project-db"). */
+    connectorId: string;
+    /** Operation to perform. */
+    operation: ConnectorOperation;
+    /** Target path (directory, file, key, etc.). */
+    path?: string;
+    /** Operation-specific options (ListOptions, SearchOptions). */
+    options?: ListOptions | SearchOptions;
+    /** Content payload for write operations. */
+    content?: ConnectorContent;
+};
+/**
+ * Sent by the frontend to add, remove, or refresh connectors at runtime without a session restart.
+ *
+ * @docLink packages/types/protocol-v3#connector-config-command
+ */
+export interface ConnectorConfigCommand {
+    type: "connector_config";
+    action: "add" | "remove" | "refresh";
+    /** Required when action === "add". */
+    declaration?: {
+        id: string;
+        driver: string;
+        access?: "read-only" | "read-write";
+        options?: Record<string, unknown>;
+    };
+    /** Required when action === "remove". */
+    connectorId?: string;
+}
+/**
+ * Client/component writes shared state to the runtime.
+ *
+ * Store namespace must start with `"app"` or `"component:"` when sent from the client.
+ *
+ * @docLink packages/types/protocol-v3#state-update-command
+ */
+export type StateUpdateCommand = {
+    type: "state_update";
+    /** Store namespace — must start with "app" or "component:" from client. */
+    store: string;
+    /** Full state snapshot (replaces previous). */
+    state: Record<string, unknown>;
+};
+/**
+ * User-originated message with a custom type (from input extensions).
+ *
+ * Unlike a plain `prompt`, a custom message carries structured data
+ * (`customType` + `customData`) alongside the text content. The agent
+ * receives these on the `finished` event as `customType`/`customData`
+ * fields. On the frontend, the custom message is rendered by the
+ * matching dynamic component (or its fallback template).
+ *
+ * @docLink packages/types/protocol-v3#custom-message-command
+ */
+export type CustomMessageCommand = {
+    type: "custom_message";
+    /** Plain-text content (backward-compatible summary). */
+    content: string;
+    /** Custom message type identifier (e.g. "gif"). */
+    customType: string;
+    /** Structured data for the custom message type. */
+    customData: Record<string, unknown>;
+};
+//# sourceMappingURL=protocol.d.ts.map

package/dist/types/src/protocol.d.ts.map

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

package/dist/types/src/reactions.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Reactions -- emoji reactions on session messages.
+ *
+ * Any session participant (user or agent) can react to any message.
+ * Reactions are persisted in a dedicated DB model and broadcast as
+ * transient events for real-time updates.
+ */
+/**
+ * A single emoji reaction on a message, set by any session participant (user or agent).
+ *
+ * Reactions are persisted in a dedicated DB model and broadcast as transient events
+ * for real-time updates.
+ *
+ * @docLink packages/types/messages#reaction
+ */
+export type Reaction = {
+    /** Unicode emoji character (e.g. "thumbs up", not ":thumbsup:"). */
+    emoji: string;
+    /** ID of the user (or "agent" for agent reactions). */
+    userId: string;
+    /** Display name at reaction time (avoids extra lookups for tooltip rendering). */
+    userName: string;
+    /** Unix epoch milliseconds. */
+    timestamp: number;
+};
+/**
+ * Quick-access emojis shown in the reaction bar picker.
+ *
+ * An `as const` array of eight Unicode emoji characters in display order.
+ *
+ * @docLink packages/types/messages#reaction
+ */
+export declare const QUICK_REACTIONS: readonly ["👍", "👀", "✅", "❤️", "🤔", "🫡", "👏", "🎉"];
+//# sourceMappingURL=reactions.d.ts.map

package/dist/types/src/reactions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactions.d.ts","sourceRoot":"","sources":["../../../types/src/reactions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;GAOG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,kFAAkF;IAClF,QAAQ,EAAE,MAAM,CAAC;IACjB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,0DASlB,CAAC"}

package/dist/types/src/runtime.d.ts

@@ -0,0 +1,219 @@
+/**
+ * Agent Runtime — the shared interface for agent execution.
+ *
+ * Both local runtimes (BridgeRuntime) and remote clients (AgentClient)
+ * implement IAgentRuntime, allowing consumers to drive agents through
+ * the same API regardless of where the agent runs.
+ */
+import type { AgentEvent } from "./events.js";
+/**
+ * Initial configuration passed to `IAgentRuntime.start()`.
+ *
+ * Sets the working directory, model, system prompt, API keys, environment variables,
+ * and initial subagent definitions for the agent session.
+ *
+ * @docLink packages/types/runtime#agent-runtime-config
+ */
+export type AgentRuntimeConfig = {
+    cwd: string;
+    provider?: string;
+    model?: string;
+    maxTurns?: number;
+    systemPrompt?: string;
+    apiKeys?: Record<string, string>;
+    env?: Record<string, string>;
+    agentDir?: string;
+    sessionId?: string;
+    resumeSessionId?: string;
+    subagents?: Record<string, SubagentDefinition>;
+};
+/**
+ * Definition for a named subagent that the primary agent can dispatch.
+ *
+ * Use full model IDs for explicit version pinning — short aliases accepted by the
+ * SDK can drift between SDK versions.
+ *
+ * @docLink packages/types/runtime#subagent-definition
+ */
+export type SubagentDefinition = {
+    description: string;
+    prompt: string;
+    tools?: string[];
+    disallowedTools?: string[];
+    /**
+     * Model identifier. Use full IDs (e.g. `"claude-sonnet-4-6"`,
+     * `"claude-opus-4-6"`) for explicit version pinning. Short aliases
+     * (`"sonnet"`, `"opus"`, `"haiku"`, `"inherit"`) are accepted by the SDK
+     * but their resolution can drift between SDK versions.
+     */
+    model?: string;
+};
+/**
+ * Properties that can change while the agent is running, passed to `IAgentRuntime.configure()`.
+ *
+ * Used at session boot via `ConfigureCommandV2.config` and for runtime reconfiguration
+ * without a full session restart. Includes the resume cascade fields for tier-1 native
+ * SDK resume (v3.2.0+).
+ *
+ * @docLink packages/types/runtime#agent-reconfigure-options
+ */
+export type AgentReconfigureOptions = {
+    /** Add/remove/update connected data sources. */
+    connectors?: ConnectorReference[];
+    /** Add/remove/update available skills and agent definitions. */
+    aiResources?: AiResourceReference[];
+    /** Add/remove subagent definitions. */
+    subagents?: Record<string, SubagentDefinition>;
+    /** Initialize or replace shared state stores. */
+    sharedState?: SharedStateConfig[];
+    /**
+     * Driver-level native session resume hint (Phase 3 of the resume cascade).
+     *
+     * When set, drivers that support native session resume (claude-sdk today)
+     * recreate the driver with this session id so the SDK reloads its JSONL
+     * conversation history losslessly. Drivers that do not support native
+     * resume ignore the hint.
+     *
+     * Treated as a soft hint: if the driver cannot honor it (signature
+     * mismatch, JSONL lost, model changed), the runner emits
+     * {@link ResumeFailedEvent} and continues without resume. The platform
+     * downgrades to tier 2 / 3 on the next wake.
+     *
+     * Spec: `_devlog/specs/2026-05-05-session-resume-restart-design.md`
+     * § "Tier 1: native resume plumbing".
+     *
+     * @category Resume
+     * @since 3.2.0
+     */
+    resumeSessionId?: string;
+    /**
+     * Capability signature the platform expects to find on the runner at
+     * configure time, used to validate that the toolset has not drifted since
+     * {@link resumeSessionId} was captured. Computed via
+     * `computeCapabilitySignature` from `@skaile/workspaces/runner`. When the
+     * signature does not match the runner's current registry, the runner
+     * drops {@link resumeSessionId} and emits {@link ResumeFailedEvent} with
+     * `reason: 'signature_mismatch'`.
+     *
+     * Optional. When omitted, the runner honors {@link resumeSessionId}
+     * without signature validation (still subject to driver-level checks
+     * such as model match and JSONL presence).
+     *
+     * @category Resume
+     * @since 3.2.0
+     */
+    expectedCapabilitySignature?: string;
+    /**
+     * Platform `AIProviderConfig.id` for the AI credential provisioned into
+     * this session. The runner stashes this in session state and passes it
+     * as `configId` in `request_access_token { kind: 'ai-credentials' }`
+     * when the bridge driver throws an `AuthError` against the AI provider.
+     *
+     * Set by the platform agent-gateway for mediated sessions; standalone
+     * runners (CLI / forge / Claude plugin) leave it undefined. The runner's
+     * 401-mediation handler short-circuits to surface-the-error when this
+     * field is undefined.
+     *
+     * Spec: `_devlog/specs/2026-05-07-unified-credential-mediation.md`
+     * § "Wire `aiProviderConfigId` end-to-end".
+     *
+     * @category Credentials
+     * @since 3.3.0
+     */
+    aiProviderConfigId?: string;
+};
+/**
+ * Lightweight reference to a connector for use in `AgentReconfigureOptions.connectors`.
+ *
+ * @docLink packages/types/runtime#connector-reference
+ */
+export type ConnectorReference = {
+    id: string;
+    adapter: string;
+    access?: "read-only" | "read-write";
+    auth?: string;
+    autoMount?: boolean;
+    mountPath?: string;
+    params?: Record<string, unknown>;
+};
+/**
+ * Lightweight reference to an AI resource (skill, flow, prompt, etc.) for use in
+ * `AgentReconfigureOptions.aiResources`. Supports both path-based and catalog-based
+ * deployment via the `action` field.
+ *
+ * @docLink packages/types/runtime#ai-resource-reference
+ */
+export type AiResourceReference = {
+    name: string;
+    path: string;
+    branch?: string;
+    dependencies?: string[];
+    auto_deploy?: boolean;
+    /** Catalog-based deployment: "add" to deploy, "remove" to undeploy. */
+    action?: "add" | "remove";
+    /** Catalog entry metadata (for catalog-based deployment). */
+    entry?: Record<string, unknown>;
+    /** Root directory of ai-assets (for catalog-based deployment). */
+    assetsRoot?: string;
+    /** Skill context to inject (for catalog-based deployment). */
+    context?: string;
+};
+/**
+ * Configuration for a shared state store at the protocol level.
+ *
+ * Used in `AgentReconfigureOptions.sharedState` to initialize XState machines, Yjs
+ * documents, or custom adapters shared between components during a session.
+ *
+ * @docLink packages/types/runtime#shared-state-config
+ */
+export type SharedStateConfig = {
+    /** Store identifier, e.g. "flow", "session" */
+    id: string;
+    /** State backend adapter: "xstate", "yjs", or any registered connector adapter */
+    adapter: string;
+    /** Machine definition (XState), schema (Yjs), or adapter-specific config */
+    definition?: unknown;
+    /** Starting state */
+    initialState?: Record<string, unknown>;
+};
+/**
+ * Shared interface for anything that can drive an agent execution.
+ *
+ * Both `BridgeRuntime` (local execution via drivers) and `AgentClient` (remote
+ * execution via transport) implement this interface, allowing consumers to drive
+ * agents through the same API regardless of where the agent runs.
+ *
+ * @docLink packages/types/runtime#i-agent-runtime
+ */
+export interface IAgentRuntime {
+    /** Optional initial setup. BridgeRuntime creates a driver; AgentClient may connect. */
+    start?(config: AgentRuntimeConfig): Promise<void>;
+    /** Reconfigure at runtime — connectors, ai-assets, subagents, shared state. */
+    configure(config: AgentReconfigureOptions): Promise<void>;
+    /** Tear down the runtime and release resources. */
+    dispose(): Promise<void>;
+    /** Send a user message to the agent. */
+    prompt(message: string): Promise<void>;
+    /** Answer an agent question. */
+    reply(answer: string): Promise<void>;
+    /** Cancel the current operation. */
+    abort(): Promise<void>;
+    /** Subscribe to agent events. */
+    onEvent(handler: (event: AgentEvent) => void): void;
+    /** Unsubscribe from agent events. */
+    offEvent(handler: (event: AgentEvent) => void): void;
+    /** Whether the agent is currently running/connected. */
+    readonly isRunning: boolean;
+}
+/**
+ * Metadata about an agent driver backend, returned by bridge driver introspection.
+ *
+ * @docLink packages/types/runtime#driver-info
+ */
+export type DriverInfo = {
+    id: string;
+    name: string;
+    modelAgnostic: boolean;
+    supportsInBandAbort: boolean;
+};
+//# sourceMappingURL=runtime.d.ts.map

package/dist/types/src/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../types/src/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAM9C;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;CAChD,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAMF;;;;;;;;GAQG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC,gDAAgD;IAChD,UAAU,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAClC,gEAAgE;IAChE,WAAW,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACpC,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC/C,iDAAiD;IACjD,WAAW,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAClC;;;;;;;;;;;;;;;;;;OAkBG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;;;;;;;;;;;OAeG;IACH,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC;;;;;;;;;;;;;;;;OAgBG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,WAAW,GAAG,YAAY,CAAC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,uEAAuE;IACvE,MAAM,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;IAC1B,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,+CAA+C;IAC/C,EAAE,EAAE,MAAM,CAAC;IACX,kFAAkF;IAClF,OAAO,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,qBAAqB;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC,CAAC;AAMF;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAa;IAC5B,uFAAuF;IACvF,KAAK,CAAC,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElD,+EAA+E;IAC/E,SAAS,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1D,mDAAmD;IACnD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzB,wCAAwC;IACxC,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvC,gCAAgC;IAChC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErC,oCAAoC;IACpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB,iCAAiC;IACjC,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI,CAAC;IAEpD,qCAAqC;IACrC,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI,CAAC;IAErD,wDAAwD;IACxD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAMD;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,OAAO,CAAC;IACvB,mBAAmB,EAAE,OAAO,CAAC;CAC9B,CAAC"}