@grackle-ai/ahp 0.131.0

package/dist/vendor/ahp/channels-root/commands.d.ts

@@ -0,0 +1,172 @@
+/**
+ * Root Channel Commands — `listSessions`, `resolveSessionConfig`, and
+ * `sessionConfigCompletions`. These commands target `ahp-root://` even
+ * though they describe per-session metadata.
+ *
+ * @module channels-root/commands
+ */
+import type { URI } from '../common/state.js';
+import type { BaseParams } from '../common/commands.js';
+import type { SessionSummary, SessionConfigSchema } from '../channels-session/state.js';
+export type { ConfigPropertySchema, ConfigSchema } from '../common/state.js';
+export type { SessionConfigPropertySchema, SessionConfigSchema } from '../channels-session/state.js';
+/**
+ * Returns a list of session summaries. Used to populate session lists and sidebars.
+ *
+ * The session list is **not** part of the state tree because it can be arbitrarily
+ * large. Clients fetch it imperatively and maintain a local cache updated by
+ * `root/sessionAdded` and `root/sessionRemoved` notifications.
+ *
+ * @category Commands
+ * @method listSessions
+ * @direction Client → Server
+ * @messageType Request
+ * @version 1
+ */
+export interface ListSessionsParams extends BaseParams {
+    channel: 'ahp-root://';
+    /** Optional filter criteria */
+    filter?: object;
+}
+/** Result of the `listSessions` command. */
+export interface ListSessionsResult {
+    /** The list of session summaries. */
+    items: SessionSummary[];
+}
+/**
+ * Iteratively resolves the session configuration schema. The client sends the
+ * current partial session config and any user-filled metadata values. The server
+ * returns a property schema describing what additional metadata is needed,
+ * contextual to the current selections.
+ *
+ * The client calls this command whenever the user changes a significant input
+ * (e.g. picks a working directory, toggles a property). Each response returns
+ * the full current property set (not a delta). The returned `values` contain
+ * server-resolved defaults to pass to `createSession`.
+ *
+ * @category Commands
+ * @method resolveSessionConfig
+ * @direction Client → Server
+ * @messageType Request
+ * @version 1
+ * @example
+ * ```jsonc
+ * // Step 1: Client picks a working directory
+ * // Client → Server
+ * { "jsonrpc": "2.0", "id": 5, "method": "resolveSessionConfig",
+ *   "params": { "workingDirectory": "file:///home/user/my-project" } }
+ *
+ * // Server → Client (git repo detected, offers worktree option)
+ * { "jsonrpc": "2.0", "id": 5, "result": {
+ *   "schema": {
+ *     "type": "object",
+ *     "properties": {
+ *       "target": { "type": "string", "title": "Target", "enum": ["workspace", "worktree"] }
+ *     }
+ *   },
+ *   "values": {}
+ * }}
+ *
+ * // Step 2: User enables worktree
+ * // Client → Server
+ * { "jsonrpc": "2.0", "id": 6, "method": "resolveSessionConfig",
+ *   "params": { "workingDirectory": "file:///home/user/my-project",
+ *               "config": { "target": "worktree" } } }
+ *
+ * // Server → Client (now requires branch selection)
+ * { "jsonrpc": "2.0", "id": 6, "result": {
+ *   "schema": {
+ *     "type": "object",
+ *     "properties": {
+ *       "target": { "type": "string", "title": "Target", "enum": ["workspace", "worktree"] },
+ *       "baseBranch": { "type": "string", "title": "Base Branch",
+ *                       "enum": ["main", "develop"],
+ *                       "enumLabels": ["main", "develop"] }
+ *     },
+ *     "required": ["baseBranch"]
+ *   },
+ *   "values": { "target": "worktree" }
+ * }}
+ * ```
+ */
+export interface ResolveSessionConfigParams extends BaseParams {
+    channel: 'ahp-root://';
+    /** Agent provider ID */
+    provider?: string;
+    /** Working directory for the session */
+    workingDirectory?: URI;
+    /** Current user-filled configuration values */
+    config?: Record<string, unknown>;
+}
+/**
+ * Result of the `resolveSessionConfig` command.
+ */
+export interface ResolveSessionConfigResult {
+    /** JSON Schema describing available configuration properties given the current context */
+    schema: SessionConfigSchema;
+    /** Current configuration values (echoed back with server-resolved defaults applied) */
+    values: Record<string, unknown>;
+}
+/**
+ * A single value item returned by `sessionConfigCompletions`.
+ *
+ * @category Commands
+ */
+export interface SessionConfigValueItem {
+    /** The value to store in config */
+    value: string;
+    /** Human-readable display label */
+    label: string;
+    /** Optional secondary description */
+    description?: string;
+}
+/**
+ * Queries the server for allowed values of a dynamic session config property.
+ *
+ * Used when a property in the schema returned by `resolveSessionConfig` has
+ * `enumDynamic: true`. The client sends a search query and receives matching
+ * values with display metadata.
+ *
+ * @category Commands
+ * @method sessionConfigCompletions
+ * @direction Client → Server
+ * @messageType Request
+ * @version 1
+ * @example
+ * ```jsonc
+ * // Client → Server (user types "ma" in branch picker)
+ * { "jsonrpc": "2.0", "id": 7, "method": "sessionConfigCompletions",
+ *   "params": { "workingDirectory": "file:///home/user/my-project",
+ *               "config": { "target": "worktree" },
+ *               "property": "baseBranch", "query": "ma" } }
+ *
+ * // Server → Client
+ * { "jsonrpc": "2.0", "id": 7, "result": {
+ *   "items": [
+ *     { "value": "main", "label": "main", "icon": "git-branch" },
+ *     { "value": "main-v2", "label": "main-v2", "icon": "git-branch" }
+ *   ]
+ * }}
+ * ```
+ */
+export interface SessionConfigCompletionsParams extends BaseParams {
+    channel: 'ahp-root://';
+    /** Agent provider ID */
+    provider?: string;
+    /** Working directory for the session */
+    workingDirectory?: URI;
+    /** Current user-filled configuration values (provides context for the query) */
+    config?: Record<string, unknown>;
+    /** Property id from the schema to query values for */
+    property: string;
+    /** Search filter text (empty or omitted returns default/recent values) */
+    query?: string;
+}
+/**
+ * Result of the `sessionConfigCompletions` command.
+ */
+export interface SessionConfigCompletionsResult {
+    /** Matching value items */
+    items: SessionConfigValueItem[];
+}
+//# sourceMappingURL=commands.d.ts.map

package/dist/vendor/ahp/channels-root/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../../src/vendor/ahp/channels-root/commands.ts"],"names":[],"mappings":"AACA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAIxF,YAAY,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC7E,YAAY,EAAE,2BAA2B,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAIrG;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,kBAAmB,SAAQ,UAAU;IACpD,OAAO,EAAE,aAAa,CAAC;IACvB,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,4CAA4C;AAC5C,MAAM,WAAW,kBAAkB;IACjC,qCAAqC;IACrC,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AACH,MAAM,WAAW,0BAA2B,SAAQ,UAAU;IAC5D,OAAO,EAAE,aAAa,CAAC;IACvB,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,gBAAgB,CAAC,EAAE,GAAG,CAAC;IACvB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,0FAA0F;IAC1F,MAAM,EAAE,mBAAmB,CAAC;IAC5B,uFAAuF;IACvF,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAID;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,WAAW,8BAA+B,SAAQ,UAAU;IAChE,OAAO,EAAE,aAAa,CAAC;IACvB,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,gBAAgB,CAAC,EAAE,GAAG,CAAC;IACvB,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAC;IACjB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C,2BAA2B;IAC3B,KAAK,EAAE,sBAAsB,EAAE,CAAC;CACjC"}

package/dist/vendor/ahp/channels-root/commands.js

@@ -0,0 +1,10 @@
+/* eslint-disable -- vendored third-party code, see SOURCE.md */
+/**
+ * Root Channel Commands — `listSessions`, `resolveSessionConfig`, and
+ * `sessionConfigCompletions`. These commands target `ahp-root://` even
+ * though they describe per-session metadata.
+ *
+ * @module channels-root/commands
+ */
+export {};
+//# sourceMappingURL=commands.js.map

package/dist/vendor/ahp/channels-root/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../../../src/vendor/ahp/channels-root/commands.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE;;;;;;GAMG"}

package/dist/vendor/ahp/channels-root/notifications.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Root Channel Notifications — Session catalogue events delivered on the
+ * `ahp-root://` channel.
+ *
+ * @module channels-root/notifications
+ */
+import type { URI } from '../common/state.js';
+import type { SessionSummary } from '../channels-session/state.js';
+/**
+ * Broadcast to all clients subscribed to the root channel when a new session
+ * is created.
+ *
+ * @category Protocol Notifications
+ * @method root/sessionAdded
+ * @direction Server → Client
+ * @messageType Notification
+ * @version 1
+ * @example
+ * ```json
+ * {
+ *   "jsonrpc": "2.0",
+ *   "method": "root/sessionAdded",
+ *   "params": {
+ *     "channel": "ahp-root://",
+ *     "summary": {
+ *       "resource": "ahp-session:/<uuid>",
+ *       "provider": "copilot",
+ *       "title": "New Session",
+ *       "status": 1,
+ *       "createdAt": 1710000000000,
+ *       "modifiedAt": 1710000000000
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export interface SessionAddedParams {
+    /** Channel URI this notification belongs to (the root channel) */
+    channel: URI;
+    /** Summary of the new session */
+    summary: SessionSummary;
+}
+/**
+ * Broadcast to all clients subscribed to the root channel when a session is
+ * disposed.
+ *
+ * @category Protocol Notifications
+ * @method root/sessionRemoved
+ * @direction Server → Client
+ * @messageType Notification
+ * @version 1
+ * @example
+ * ```json
+ * {
+ *   "jsonrpc": "2.0",
+ *   "method": "root/sessionRemoved",
+ *   "params": {
+ *     "channel": "ahp-root://",
+ *     "session": "ahp-session:/<uuid>"
+ *   }
+ * }
+ * ```
+ */
+export interface SessionRemovedParams {
+    /** Channel URI this notification belongs to (the root channel) */
+    channel: URI;
+    /** URI of the removed session */
+    session: URI;
+}
+/**
+ * Broadcast to all clients subscribed to the root channel when an existing
+ * session's summary changes (title, status, `modifiedAt`, model, working
+ * directory, read/done state, or diff statistics).
+ *
+ * This notification lets clients that maintain a cached session list — for
+ * example, the result of a previous `listSessions()` call — stay in sync with
+ * in-flight sessions without having to subscribe to every session URI
+ * individually. It is complementary to, not a replacement for,
+ * `root/sessionAdded` and `root/sessionRemoved`: those signal lifecycle
+ * (creation/disposal), while this signals summary-level mutations on an
+ * already-known session.
+ *
+ * Semantics:
+ *
+ * - Only fields present in `changes` have new values; omitted fields are
+ *   unchanged on the client's cached summary.
+ * - Identity fields (`resource`, `provider`, `createdAt`) never change and
+ *   are not carried.
+ * - Like all protocol notifications, this is ephemeral: it is **not**
+ *   replayed on reconnect. On reconnect, clients should re-fetch the full
+ *   catalog via `listSessions()` as usual.
+ * - The server SHOULD emit this notification whenever any mutable field on
+ *   {@link SessionSummary | `SessionSummary`} changes for a session the
+ *   server has surfaced via `listSessions()` or `root/sessionAdded`.
+ *   Servers MAY coalesce or debounce updates for noisy fields (for example,
+ *   `modifiedAt` bumps while a turn is streaming, or rapidly changing
+ *   `changesets`) at their discretion.
+ * - Clients that have no cached entry for `session` MAY ignore the
+ *   notification; it is not a substitute for `root/sessionAdded`.
+ *
+ * @category Protocol Notifications
+ * @method root/sessionSummaryChanged
+ * @direction Server → Client
+ * @messageType Notification
+ * @version 1
+ * @example
+ * ```json
+ * {
+ *   "jsonrpc": "2.0",
+ *   "method": "root/sessionSummaryChanged",
+ *   "params": {
+ *     "channel": "ahp-root://",
+ *     "session": "ahp-session:/<uuid>",
+ *     "changes": {
+ *       "title": "Refactor auth middleware",
+ *       "status": 8,
+ *       "modifiedAt": 1710000123456
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export interface SessionSummaryChangedParams {
+    /** Channel URI this notification belongs to (the root channel) */
+    channel: URI;
+    /** URI of the session whose summary changed */
+    session: URI;
+    /**
+     * Mutable summary fields that changed; omitted fields are unchanged.
+     *
+     * Identity fields (`resource`, `provider`, `createdAt`) never change and
+     * MUST be omitted by senders; receivers SHOULD ignore them if present.
+     */
+    changes: Partial<SessionSummary>;
+}
+//# sourceMappingURL=notifications.d.ts.map

package/dist/vendor/ahp/channels-root/notifications.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.d.ts","sourceRoot":"","sources":["../../../../src/vendor/ahp/channels-root/notifications.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAInE;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,WAAW,kBAAkB;IACjC,kEAAkE;IAClE,OAAO,EAAE,GAAG,CAAC;IACb,iCAAiC;IACjC,OAAO,EAAE,cAAc,CAAC;CACzB;AAID;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,oBAAoB;IACnC,kEAAkE;IAClE,OAAO,EAAE,GAAG,CAAC;IACb,iCAAiC;IACjC,OAAO,EAAE,GAAG,CAAC;CACd;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AACH,MAAM,WAAW,2BAA2B;IAC1C,kEAAkE;IAClE,OAAO,EAAE,GAAG,CAAC;IACb,+CAA+C;IAC/C,OAAO,EAAE,GAAG,CAAC;IACb;;;;;OAKG;IACH,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;CAClC"}

package/dist/vendor/ahp/channels-root/notifications.js

@@ -0,0 +1,9 @@
+/* eslint-disable -- vendored third-party code, see SOURCE.md */
+/**
+ * Root Channel Notifications — Session catalogue events delivered on the
+ * `ahp-root://` channel.
+ *
+ * @module channels-root/notifications
+ */
+export {};
+//# sourceMappingURL=notifications.js.map

package/dist/vendor/ahp/channels-root/notifications.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.js","sourceRoot":"","sources":["../../../../src/vendor/ahp/channels-root/notifications.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE;;;;;GAKG"}

package/dist/vendor/ahp/channels-root/reducer.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Root Channel Reducer — Pure reducer for `RootState`.
+ *
+ * @module channels-root/reducer
+ */
+import type { RootState } from './state.js';
+import type { RootAction } from '../action-origin.generated.js';
+/**
+ * Pure reducer for root state. Handles all {@link RootAction} variants.
+ */
+export declare function rootReducer(state: RootState, action: RootAction, log?: (msg: string) => void): RootState;
+//# sourceMappingURL=reducer.d.ts.map

package/dist/vendor/ahp/channels-root/reducer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reducer.d.ts","sourceRoot":"","sources":["../../../../src/vendor/ahp/channels-root/reducer.ts"],"names":[],"mappings":"AACA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAGhE;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,SAAS,CA2BxG"}

package/dist/vendor/ahp/channels-root/reducer.js

@@ -0,0 +1,36 @@
+/* eslint-disable -- vendored third-party code, see SOURCE.md */
+/**
+ * Root Channel Reducer — Pure reducer for `RootState`.
+ *
+ * @module channels-root/reducer
+ */
+import { ActionType } from '../common/actions.js';
+import { softAssertNever } from '../common/reducer-helpers.js';
+/**
+ * Pure reducer for root state. Handles all {@link RootAction} variants.
+ */
+export function rootReducer(state, action, log) {
+    switch (action.type) {
+        case ActionType.RootAgentsChanged:
+            return { ...state, agents: action.agents };
+        case ActionType.RootActiveSessionsChanged:
+            return { ...state, activeSessions: action.activeSessions };
+        case ActionType.RootTerminalsChanged:
+            return { ...state, terminals: action.terminals };
+        case ActionType.RootConfigChanged:
+            if (!state.config) {
+                return state;
+            }
+            return {
+                ...state,
+                config: {
+                    ...state.config,
+                    values: action.replace ? { ...action.config } : { ...state.config.values, ...action.config },
+                },
+            };
+        default:
+            softAssertNever(action, log);
+            return state;
+    }
+}
+//# sourceMappingURL=reducer.js.map

package/dist/vendor/ahp/channels-root/reducer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reducer.js","sourceRoot":"","sources":["../../../../src/vendor/ahp/channels-root/reducer.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAGlD,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE/D;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAgB,EAAE,MAAkB,EAAE,GAA2B;IAC3F,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,UAAU,CAAC,iBAAiB;YAC/B,OAAO,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;QAE7C,KAAK,UAAU,CAAC,yBAAyB;YACvC,OAAO,EAAE,GAAG,KAAK,EAAE,cAAc,EAAE,MAAM,CAAC,cAAc,EAAE,CAAC;QAE7D,KAAK,UAAU,CAAC,oBAAoB;YAClC,OAAO,EAAE,GAAG,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;QAEnD,KAAK,UAAU,CAAC,iBAAiB;YAC/B,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;gBAClB,OAAO,KAAK,CAAC;YACf,CAAC;YACD,OAAO;gBACL,GAAG,KAAK;gBACR,MAAM,EAAE;oBACN,GAAG,KAAK,CAAC,MAAM;oBACf,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE;iBAC7F;aACF,CAAC;QAEJ;YACE,eAAe,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;YAC7B,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC"}

package/dist/vendor/ahp/channels-root/state.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Root State Types — Global state exposed on the `ahp-root://` channel.
+ *
+ * @module channels-root/state
+ */
+import type { ConfigSchema, ProtectedResourceMetadata } from '../common/state.js';
+import type { TerminalInfo } from '../channels-terminal/state.js';
+import type { CustomizationRef } from '../channels-session/state.js';
+/**
+ * Policy configuration state for a model.
+ *
+ * @category Root State
+ */
+export declare enum PolicyState {
+    Enabled = "enabled",
+    Disabled = "disabled",
+    Unconfigured = "unconfigured"
+}
+/**
+ * Global state shared with every client subscribed to `ahp-root://`.
+ *
+ * @category Root State
+ */
+export interface RootState {
+    /** Available agent backends and their models */
+    agents: AgentInfo[];
+    /** Number of active (non-disposed) sessions on the server */
+    activeSessions?: number;
+    /** Known terminals on the server. Subscribe to individual terminal URIs for full state. */
+    terminals?: TerminalInfo[];
+    /** Agent host configuration schema and current values */
+    config?: RootConfigState;
+}
+/**
+ * @category Root State
+ */
+export interface AgentInfo {
+    /** Agent provider ID (e.g. `'copilot'`) */
+    provider: string;
+    /** Human-readable name */
+    displayName: string;
+    /** Description string */
+    description: string;
+    /** Available models for this agent */
+    models: SessionModelInfo[];
+    /**
+     * Protected resources this agent requires authentication for.
+     *
+     * Each entry describes an OAuth 2.0 protected resource using
+     * [RFC 9728](https://datatracker.ietf.org/doc/html/rfc9728) semantics.
+     * Clients should obtain tokens from the declared `authorization_servers`
+     * and push them via the `authenticate` command before creating sessions
+     * with this agent.
+     *
+     * @see {@link /specification/authentication | Authentication}
+     */
+    protectedResources?: ProtectedResourceMetadata[];
+    /**
+     * Customizations (Open Plugins) associated with this agent.
+     *
+     * Each entry is a reference to an [Open Plugins](https://open-plugins.com/)
+     * plugin that the agent host can activate for sessions using this agent.
+     */
+    customizations?: CustomizationRef[];
+}
+/**
+ * @category Root State
+ */
+export interface SessionModelInfo {
+    /** Model identifier */
+    id: string;
+    /** Provider this model belongs to */
+    provider: string;
+    /** Human-readable model name */
+    name: string;
+    /** Maximum context window size */
+    maxContextWindow?: number;
+    /** Whether the model supports vision */
+    supportsVision?: boolean;
+    /** Policy configuration state */
+    policyState?: PolicyState;
+    /**
+     * Configuration schema describing model-specific options (e.g. thinking
+     * level). Clients present this as a form and pass the resolved values in
+     * {@link ModelSelection.config} when creating or changing sessions.
+     */
+    configSchema?: ConfigSchema;
+    /**
+     * Additional provider-specific metadata for this model.
+     *
+     * Clients MAY look for well-known keys here to provide enhanced UI.
+     * For example, a `pricing` key may carry model pricing metadata.
+     */
+    _meta?: Record<string, unknown>;
+}
+/**
+ * A model selection: the chosen model ID together with any model-specific
+ * configuration values whose keys correspond to the model's
+ * {@link SessionModelInfo.configSchema}.
+ *
+ * @category Root State
+ */
+export interface ModelSelection {
+    /** Model identifier */
+    id: string;
+    /** Model-specific configuration values */
+    config?: Record<string, string>;
+}
+/**
+ * Live agent-host configuration metadata.
+ *
+ * The schema describes the available configuration properties and the values
+ * contain the current value for each resolved property.
+ *
+ * @category Root State
+ */
+export interface RootConfigState {
+    /** JSON Schema describing available configuration properties */
+    schema: ConfigSchema;
+    /** Current configuration values */
+    values: Record<string, unknown>;
+}
+//# sourceMappingURL=state.d.ts.map

package/dist/vendor/ahp/channels-root/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../../src/vendor/ahp/channels-root/state.ts"],"names":[],"mappings":"AACA;;;;GAIG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,yBAAyB,EAC1B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAIrE;;;;GAIG;AACH,oBAAY,WAAW;IACrB,OAAO,YAAY;IACnB,QAAQ,aAAa;IACrB,YAAY,iBAAiB;CAC9B;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,gDAAgD;IAChD,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,6DAA6D;IAC7D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2FAA2F;IAC3F,SAAS,CAAC,EAAE,YAAY,EAAE,CAAC;IAC3B,yDAAyD;IACzD,MAAM,CAAC,EAAE,eAAe,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B;;;;;;;;;;OAUG;IACH,kBAAkB,CAAC,EAAE,yBAAyB,EAAE,CAAC;IACjD;;;;;OAKG;IACH,cAAc,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uBAAuB;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,wCAAwC;IACxC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,iCAAiC;IACjC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B;;;;OAIG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,uBAAuB;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAID;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,gEAAgE;IAChE,MAAM,EAAE,YAAY,CAAC;IACrB,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC"}

package/dist/vendor/ahp/channels-root/state.js

@@ -0,0 +1,19 @@
+/* eslint-disable -- vendored third-party code, see SOURCE.md */
+/**
+ * Root State Types — Global state exposed on the `ahp-root://` channel.
+ *
+ * @module channels-root/state
+ */
+// ─── Root State ──────────────────────────────────────────────────────────────
+/**
+ * Policy configuration state for a model.
+ *
+ * @category Root State
+ */
+export var PolicyState;
+(function (PolicyState) {
+    PolicyState["Enabled"] = "enabled";
+    PolicyState["Disabled"] = "disabled";
+    PolicyState["Unconfigured"] = "unconfigured";
+})(PolicyState || (PolicyState = {}));
+//# sourceMappingURL=state.js.map

package/dist/vendor/ahp/channels-root/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../../../src/vendor/ahp/channels-root/state.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE;;;;GAIG;AASH,gFAAgF;AAEhF;;;;GAIG;AACH,MAAM,CAAN,IAAY,WAIX;AAJD,WAAY,WAAW;IACrB,kCAAmB,CAAA;IACnB,oCAAqB,CAAA;IACrB,4CAA6B,CAAA;AAC/B,CAAC,EAJW,WAAW,KAAX,WAAW,QAItB"}