@grackle-ai/ahp 0.131.0

package/dist/vendor/ahp/common/errors.d.ts

@@ -0,0 +1,184 @@
+/**
+ * Error Codes — Source of truth for all AHP error code definitions.
+ *
+ * @module common/errors
+ * @description AHP uses JSON-RPC 2.0 error codes. In addition to the standard
+ * JSON-RPC codes, AHP defines application-specific error codes in the `-32000`
+ * to `-32099` range.
+ */
+import type { ProtectedResourceMetadata } from './state.js';
+import type { ResourceRequestParams } from './commands.js';
+/**
+ * Standard JSON-RPC 2.0 error codes.
+ *
+ * @category Standard JSON-RPC Codes
+ */
+export declare const JsonRpcErrorCodes: {
+    /** Invalid JSON */
+    readonly ParseError: -32700;
+    /** Not a valid JSON-RPC request */
+    readonly InvalidRequest: -32600;
+    /** Unknown method name */
+    readonly MethodNotFound: -32601;
+    /** Invalid method parameters */
+    readonly InvalidParams: -32602;
+    /** Unspecified server error */
+    readonly InternalError: -32603;
+};
+/**
+ * AHP application-specific error codes.
+ *
+ * @category AHP Application Codes
+ * @version 1
+ */
+export declare const AhpErrorCodes: {
+    /** The referenced session URI does not exist */
+    readonly SessionNotFound: -32001;
+    /** The requested agent provider is not registered */
+    readonly ProviderNotFound: -32002;
+    /** A session with the given URI already exists */
+    readonly SessionAlreadyExists: -32003;
+    /** The operation requires no active turn, but one is in progress */
+    readonly TurnInProgress: -32004;
+    /**
+     * The server cannot speak any of the protocol versions offered by the
+     * client in `InitializeParams.protocolVersions`. The `data` field of the
+     * JSON-RPC error MAY be an `UnsupportedProtocolVersionErrorData` advertising
+     * the protocol versions the server is willing to speak.
+     */
+    readonly UnsupportedProtocolVersion: -32005;
+    /** The requested content URI does not exist */
+    readonly ContentNotFound: -32006;
+    /**
+     * A command failed because the client has not authenticated for a required
+     * protected resource. The `data` field of the JSON-RPC error MUST be an
+     * `AuthRequiredErrorData` describing the resources that require
+     * authentication.
+     *
+     * @see {@link /specification/authentication | Authentication}
+     */
+    readonly AuthRequired: -32007;
+    /** The requested file, folder, or URI does not exist */
+    readonly NotFound: -32008;
+    /**
+     * The client is not permitted to access the requested resource.
+     *
+     * Servers SHOULD return this when a client attempts to read or browse
+     * a path outside the allowed set (e.g. outside the session's working
+     * directory or workspace roots).
+     *
+     * The `data` field of the JSON-RPC error MAY be a
+     * `PermissionDeniedErrorData` advertising a `resourceRequest` that, if
+     * granted, would unlock the operation.
+     */
+    readonly PermissionDenied: -32009;
+    /**
+     * The target resource already exists and the operation does not allow
+     * overwriting (e.g. `resourceWrite` with `createOnly: true`).
+     */
+    readonly AlreadyExists: -32010;
+};
+/** Union type of all AHP application error codes. */
+export type AhpErrorCode = (typeof AhpErrorCodes)[keyof typeof AhpErrorCodes];
+/** Union type of all JSON-RPC error codes. */
+export type JsonRpcErrorCode = (typeof JsonRpcErrorCodes)[keyof typeof JsonRpcErrorCodes];
+/**
+ * Details carried in the `data` field of an `AuthRequired` (-32007) error.
+ *
+ * Wraps the protected resource list in `{ resources: [...] }` rather than
+ * returning a bare array, so additional fields can be added in future
+ * versions without breaking the wire shape.
+ *
+ * @category Error Details
+ * @version 1
+ */
+export interface AuthRequiredErrorData {
+    /** Protected resources that require authentication. */
+    resources: ProtectedResourceMetadata[];
+}
+/**
+ * Details carried in the `data` field of a `PermissionDenied` (-32009) error.
+ *
+ * The receiver MAY advertise a `resourceRequest` payload describing the
+ * access that, if granted, would unlock the operation. The caller MAY then
+ * issue `resourceRequest` with that payload to negotiate access.
+ *
+ * @category Error Details
+ * @version 1
+ */
+export interface PermissionDeniedErrorData {
+    /**
+     * The resource access that, if granted via `resourceRequest`, would unlock
+     * the operation. Omitted when no specific access grant would resolve the
+     * denial (for example, when the resource is fundamentally inaccessible).
+     */
+    request?: ResourceRequestParams;
+}
+/**
+ * Details carried in the `data` field of an `UnsupportedProtocolVersion`
+ * (-32005) error.
+ *
+ * @category Error Details
+ * @version 1
+ */
+export interface UnsupportedProtocolVersionErrorData {
+    /**
+     * Protocol versions the server is willing to speak.
+     *
+     * Each entry is either a [SemVer](https://semver.org) `MAJOR.MINOR.PATCH`
+     * string (e.g. `"0.1.0"`) or a [SemVer range](https://semver.org/#spec-item-11)
+     * constraint (e.g. `">=0.1.0 <0.3.0"` or `"^0.2.0"`).
+     */
+    supportedVersions: string[];
+}
+/**
+ * Maps each AHP error code that carries structured `data` to the type of
+ * that data.
+ *
+ * Error codes not present in this map either have no `data` payload or
+ * carry an unspecified payload that callers SHOULD treat as `unknown`.
+ *
+ * @category Error Details
+ * @version 1
+ */
+export interface AhpErrorDetailsMap {
+    [AhpErrorCodes.AuthRequired]: AuthRequiredErrorData;
+    [AhpErrorCodes.PermissionDenied]: PermissionDeniedErrorData;
+    [AhpErrorCodes.UnsupportedProtocolVersion]: UnsupportedProtocolVersionErrorData;
+}
+/** AHP error codes that carry a structured `data` payload. */
+export type AhpErrorCodeWithData = keyof AhpErrorDetailsMap;
+/**
+ * A typed JSON-RPC error object whose `data` is narrowed by `code`.
+ *
+ * Distributes over the `AhpErrorCode` union so narrowing on `code` reveals
+ * the precise `data` type. For codes listed in {@link AhpErrorDetailsMap}
+ * `data` is required; for all other codes `data` is an optional `unknown`.
+ *
+ * ```ts
+ * function handle(err: AhpError) {
+ *   if (err.code === AhpErrorCodes.PermissionDenied) {
+ *     err.data.request; // typed as ResourceRequestParams | undefined
+ *   }
+ * }
+ * ```
+ *
+ * @category Error Details
+ * @version 1
+ */
+export type AhpError<C extends AhpErrorCode = AhpErrorCode> = C extends AhpErrorCode ? C extends keyof AhpErrorDetailsMap ? {
+    /** The error code. */
+    readonly code: C;
+    /** Human-readable error message. */
+    readonly message: string;
+    /** Structured detail payload mandated by `AhpErrorDetailsMap`. */
+    readonly data: AhpErrorDetailsMap[C];
+} : {
+    /** The error code. */
+    readonly code: C;
+    /** Human-readable error message. */
+    readonly message: string;
+    /** Optional, unspecified detail payload. */
+    readonly data?: unknown;
+} : never;
+//# sourceMappingURL=errors.d.ts.map

package/dist/vendor/ahp/common/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../src/vendor/ahp/common/errors.ts"],"names":[],"mappings":"AACA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAI3D;;;;GAIG;AACH,eAAO,MAAM,iBAAiB;IAC5B,mBAAmB;;IAEnB,mCAAmC;;IAEnC,0BAA0B;;IAE1B,gCAAgC;;IAEhC,+BAA+B;;CAEvB,CAAC;AAIX;;;;;GAKG;AACH,eAAO,MAAM,aAAa;IACxB,gDAAgD;;IAEhD,qDAAqD;;IAErD,kDAAkD;;IAElD,oEAAoE;;IAEpE;;;;;OAKG;;IAEH,+CAA+C;;IAE/C;;;;;;;OAOG;;IAEH,wDAAwD;;IAExD;;;;;;;;;;OAUG;;IAEH;;;OAGG;;CAEK,CAAC;AAEX,qDAAqD;AACrD,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC;AAE9E,8CAA8C;AAC9C,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,OAAO,iBAAiB,CAAC,CAAC;AAI1F;;;;;;;;;GASG;AACH,MAAM,WAAW,qBAAqB;IACpC,uDAAuD;IACvD,SAAS,EAAE,yBAAyB,EAAE,CAAC;CACxC;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;;OAIG;IACH,OAAO,CAAC,EAAE,qBAAqB,CAAC;CACjC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mCAAmC;IAClD;;;;;;OAMG;IACH,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,kBAAkB;IACjC,CAAC,aAAa,CAAC,YAAY,CAAC,EAAE,qBAAqB,CAAC;IACpD,CAAC,aAAa,CAAC,gBAAgB,CAAC,EAAE,yBAAyB,CAAC;IAC5D,CAAC,aAAa,CAAC,0BAA0B,CAAC,EAAE,mCAAmC,CAAC;CACjF;AAED,8DAA8D;AAC9D,MAAM,MAAM,oBAAoB,GAAG,MAAM,kBAAkB,CAAC;AAE5D;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY,IACxD,CAAC,SAAS,YAAY,GAClB,CAAC,SAAS,MAAM,kBAAkB,GAChC;IACA,sBAAsB;IACtB,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACjB,oCAAoC;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,kEAAkE;IAClE,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC;CACtC,GACC;IACA,sBAAsB;IACtB,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACjB,oCAAoC;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;CACzB,GACD,KAAK,CAAC"}

package/dist/vendor/ahp/common/errors.js

@@ -0,0 +1,82 @@
+/* eslint-disable -- vendored third-party code, see SOURCE.md */
+/**
+ * Error Codes — Source of truth for all AHP error code definitions.
+ *
+ * @module common/errors
+ * @description AHP uses JSON-RPC 2.0 error codes. In addition to the standard
+ * JSON-RPC codes, AHP defines application-specific error codes in the `-32000`
+ * to `-32099` range.
+ */
+// ─── Standard JSON-RPC Codes ─────────────────────────────────────────────────
+/**
+ * Standard JSON-RPC 2.0 error codes.
+ *
+ * @category Standard JSON-RPC Codes
+ */
+export const JsonRpcErrorCodes = {
+    /** Invalid JSON */
+    ParseError: -32700,
+    /** Not a valid JSON-RPC request */
+    InvalidRequest: -32600,
+    /** Unknown method name */
+    MethodNotFound: -32601,
+    /** Invalid method parameters */
+    InvalidParams: -32602,
+    /** Unspecified server error */
+    InternalError: -32603,
+};
+// ─── AHP Application Codes ──────────────────────────────────────────────────
+/**
+ * AHP application-specific error codes.
+ *
+ * @category AHP Application Codes
+ * @version 1
+ */
+export const AhpErrorCodes = {
+    /** The referenced session URI does not exist */
+    SessionNotFound: -32001,
+    /** The requested agent provider is not registered */
+    ProviderNotFound: -32002,
+    /** A session with the given URI already exists */
+    SessionAlreadyExists: -32003,
+    /** The operation requires no active turn, but one is in progress */
+    TurnInProgress: -32004,
+    /**
+     * The server cannot speak any of the protocol versions offered by the
+     * client in `InitializeParams.protocolVersions`. The `data` field of the
+     * JSON-RPC error MAY be an `UnsupportedProtocolVersionErrorData` advertising
+     * the protocol versions the server is willing to speak.
+     */
+    UnsupportedProtocolVersion: -32005,
+    /** The requested content URI does not exist */
+    ContentNotFound: -32006,
+    /**
+     * A command failed because the client has not authenticated for a required
+     * protected resource. The `data` field of the JSON-RPC error MUST be an
+     * `AuthRequiredErrorData` describing the resources that require
+     * authentication.
+     *
+     * @see {@link /specification/authentication | Authentication}
+     */
+    AuthRequired: -32007,
+    /** The requested file, folder, or URI does not exist */
+    NotFound: -32008,
+    /**
+     * The client is not permitted to access the requested resource.
+     *
+     * Servers SHOULD return this when a client attempts to read or browse
+     * a path outside the allowed set (e.g. outside the session's working
+     * directory or workspace roots).
+     *
+     * The `data` field of the JSON-RPC error MAY be a
+     * `PermissionDeniedErrorData` advertising a `resourceRequest` that, if
+     * granted, would unlock the operation.
+     */
+    PermissionDenied: -32009,
+    /**
+     * The target resource already exists and the operation does not allow
+     * overwriting (e.g. `resourceWrite` with `createOnly: true`).
+     */
+    AlreadyExists: -32010,
+};
+//# sourceMappingURL=errors.js.map

package/dist/vendor/ahp/common/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../src/vendor/ahp/common/errors.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE;;;;;;;GAOG;AAKH,gFAAgF;AAEhF;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,mBAAmB;IACnB,UAAU,EAAE,CAAC,KAAK;IAClB,mCAAmC;IACnC,cAAc,EAAE,CAAC,KAAK;IACtB,0BAA0B;IAC1B,cAAc,EAAE,CAAC,KAAK;IACtB,gCAAgC;IAChC,aAAa,EAAE,CAAC,KAAK;IACrB,+BAA+B;IAC/B,aAAa,EAAE,CAAC,KAAK;CACb,CAAC;AAEX,+EAA+E;AAE/E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,gDAAgD;IAChD,eAAe,EAAE,CAAC,KAAK;IACvB,qDAAqD;IACrD,gBAAgB,EAAE,CAAC,KAAK;IACxB,kDAAkD;IAClD,oBAAoB,EAAE,CAAC,KAAK;IAC5B,oEAAoE;IACpE,cAAc,EAAE,CAAC,KAAK;IACtB;;;;;OAKG;IACH,0BAA0B,EAAE,CAAC,KAAK;IAClC,+CAA+C;IAC/C,eAAe,EAAE,CAAC,KAAK;IACvB;;;;;;;OAOG;IACH,YAAY,EAAE,CAAC,KAAK;IACpB,wDAAwD;IACxD,QAAQ,EAAE,CAAC,KAAK;IAChB;;;;;;;;;;OAUG;IACH,gBAAgB,EAAE,CAAC,KAAK;IACxB;;;OAGG;IACH,aAAa,EAAE,CAAC,KAAK;CACb,CAAC"}

package/dist/vendor/ahp/common/messages.d.ts

@@ -0,0 +1,330 @@
+/**
+ * Message Types — Fully typed JSON-RPC message definitions for the AHP wire protocol.
+ *
+ * @module common/messages
+ * @description Typed JSON-RPC request, response, and notification types for all
+ * AHP methods. Narrowing on the `method` field gives fully typed `params` and
+ * result types.
+ */
+import type { InitializeParams, InitializeResult, PingParams, ReconnectParams, ReconnectResult, SubscribeParams, SubscribeResult, ResourceReadParams, ResourceReadResult, ResourceWriteParams, ResourceWriteResult, ResourceListParams, ResourceListResult, ResourceCopyParams, ResourceCopyResult, ResourceDeleteParams, ResourceDeleteResult, ResourceMoveParams, ResourceMoveResult, ResourceRequestParams, ResourceRequestResult, UnsubscribeParams, DispatchActionParams, AuthenticateParams, AuthenticateResult } from './commands.js';
+import type { ListSessionsParams, ListSessionsResult, ResolveSessionConfigParams, ResolveSessionConfigResult, SessionConfigCompletionsParams, SessionConfigCompletionsResult } from '../channels-root/commands.js';
+import type { CreateSessionParams, DisposeSessionParams, FetchTurnsParams, FetchTurnsResult, CompletionsParams, CompletionsResult } from '../channels-session/commands.js';
+import type { CreateTerminalParams, DisposeTerminalParams } from '../channels-terminal/commands.js';
+import type { InvokeChangesetOperationParams, InvokeChangesetOperationResult } from '../channels-changeset/commands.js';
+import type { ActionEnvelope } from './actions.js';
+import type { SessionAddedParams, SessionRemovedParams, SessionSummaryChangedParams } from '../channels-root/notifications.js';
+import type { AuthRequiredParams } from './notifications.js';
+import type { OtlpExportLogsParams, OtlpExportTracesParams, OtlpExportMetricsParams } from '../channels-otlp/notifications.js';
+import type { AhpError } from './errors.js';
+/** A JSON-RPC request: has both `method` and `id`. */
+export interface JsonRpcRequest {
+    readonly jsonrpc: '2.0';
+    readonly id: number;
+    readonly method: string;
+    readonly params?: unknown;
+}
+/** A JSON-RPC success response. */
+export interface JsonRpcSuccessResponse {
+    readonly jsonrpc: '2.0';
+    readonly id: number;
+    readonly result: unknown;
+}
+/** A JSON-RPC error response. */
+export interface JsonRpcErrorResponse {
+    readonly jsonrpc: '2.0';
+    readonly id: number;
+    readonly error: {
+        readonly code: number;
+        readonly message: string;
+        readonly data?: unknown;
+    };
+}
+/**
+ * A typed JSON-RPC error response whose error object is a fully typed
+ * {@link AhpError}. Useful when the caller knows the response is an AHP
+ * application error and wants `data` narrowed by `code`.
+ */
+export interface AhpErrorResponse {
+    readonly jsonrpc: '2.0';
+    readonly id: number;
+    readonly error: AhpError;
+}
+/** A JSON-RPC response (success or error). */
+export type JsonRpcResponse = JsonRpcSuccessResponse | JsonRpcErrorResponse;
+/** A JSON-RPC notification: has `method` but no `id`. */
+export interface JsonRpcNotification {
+    readonly jsonrpc: '2.0';
+    readonly method: string;
+    readonly params?: unknown;
+}
+/**
+ * Registry mapping each command method name to its params and result types.
+ *
+ * `CommandMap` covers methods that the client sends to the server. Methods
+ * that may also be initiated by the server are duplicated in
+ * {@link ServerCommandMap}; the entries in the two maps are kept identical.
+ *
+ * @category Commands
+ */
+export interface CommandMap {
+    'initialize': {
+        params: InitializeParams;
+        result: InitializeResult;
+    };
+    'ping': {
+        params: PingParams;
+        result: null;
+    };
+    'reconnect': {
+        params: ReconnectParams;
+        result: ReconnectResult;
+    };
+    'subscribe': {
+        params: SubscribeParams;
+        result: SubscribeResult;
+    };
+    'createSession': {
+        params: CreateSessionParams;
+        result: null;
+    };
+    'disposeSession': {
+        params: DisposeSessionParams;
+        result: null;
+    };
+    'createTerminal': {
+        params: CreateTerminalParams;
+        result: null;
+    };
+    'disposeTerminal': {
+        params: DisposeTerminalParams;
+        result: null;
+    };
+    'listSessions': {
+        params: ListSessionsParams;
+        result: ListSessionsResult;
+    };
+    'resourceRead': {
+        params: ResourceReadParams;
+        result: ResourceReadResult;
+    };
+    'resourceWrite': {
+        params: ResourceWriteParams;
+        result: ResourceWriteResult;
+    };
+    'resourceList': {
+        params: ResourceListParams;
+        result: ResourceListResult;
+    };
+    'resourceCopy': {
+        params: ResourceCopyParams;
+        result: ResourceCopyResult;
+    };
+    'resourceDelete': {
+        params: ResourceDeleteParams;
+        result: ResourceDeleteResult;
+    };
+    'resourceMove': {
+        params: ResourceMoveParams;
+        result: ResourceMoveResult;
+    };
+    'resourceRequest': {
+        params: ResourceRequestParams;
+        result: ResourceRequestResult;
+    };
+    'fetchTurns': {
+        params: FetchTurnsParams;
+        result: FetchTurnsResult;
+    };
+    'authenticate': {
+        params: AuthenticateParams;
+        result: AuthenticateResult;
+    };
+    'resolveSessionConfig': {
+        params: ResolveSessionConfigParams;
+        result: ResolveSessionConfigResult;
+    };
+    'sessionConfigCompletions': {
+        params: SessionConfigCompletionsParams;
+        result: SessionConfigCompletionsResult;
+    };
+    'completions': {
+        params: CompletionsParams;
+        result: CompletionsResult;
+    };
+    'invokeChangesetOperation': {
+        params: InvokeChangesetOperationParams;
+        result: InvokeChangesetOperationResult;
+    };
+}
+/**
+ * Registry mapping each server → client request method to its params and
+ * result types.
+ *
+ * Bidirectional commands (currently only `resourceRequest`) appear in both
+ * {@link CommandMap} and `ServerCommandMap` with identical params/result
+ * shapes. The receiver decides whether to allow, deny, or prompt for the
+ * requested operation regardless of which peer initiated it.
+ *
+ * @category Commands
+ */
+export interface ServerCommandMap {
+    'resourceRequest': {
+        params: ResourceRequestParams;
+        result: ResourceRequestResult;
+    };
+}
+/**
+ * Registry mapping each client → server notification method to its params type.
+ *
+ * Every notification's params MUST carry a top-level `channel: URI` so that
+ * the server can route the message to the correct subscription. See
+ * {@link UnsubscribeParams} for the canonical "base" shape.
+ *
+ * @category Notifications
+ */
+export interface ClientNotificationMap {
+    'unsubscribe': {
+        params: UnsubscribeParams;
+    };
+    'dispatchAction': {
+        params: DispatchActionParams;
+    };
+}
+/**
+ * Registry mapping each server → client notification method to its params type.
+ *
+ * Every notification's params MUST carry a top-level `channel: URI` so that
+ * the client can dispatch the message to the right subscription.
+ *
+ * @category Notifications
+ */
+export interface ServerNotificationMap {
+    'action': {
+        params: ActionEnvelope;
+    };
+    'root/sessionAdded': {
+        params: SessionAddedParams;
+    };
+    'root/sessionRemoved': {
+        params: SessionRemovedParams;
+    };
+    'root/sessionSummaryChanged': {
+        params: SessionSummaryChangedParams;
+    };
+    'auth/required': {
+        params: AuthRequiredParams;
+    };
+    'otlp/exportLogs': {
+        params: OtlpExportLogsParams;
+    };
+    'otlp/exportTraces': {
+        params: OtlpExportTracesParams;
+    };
+    'otlp/exportMetrics': {
+        params: OtlpExportMetricsParams;
+    };
+}
+/**
+ * A fully typed JSON-RPC request for a specific AHP command.
+ *
+ * When used as a union (default generic), narrowing on `method` gives typed `params`:
+ *
+ * ```ts
+ * function handle(req: AhpRequest) {
+ *   if (req.method === 'fetchTurns') {
+ *     req.params.session; // typed as URI
+ *   }
+ * }
+ * ```
+ *
+ * Defaults to client → server requests ({@link CommandMap}). Use
+ * {@link AhpServerRequest} for server → client requests.
+ */
+export type AhpRequest<M extends keyof CommandMap = keyof CommandMap> = M extends unknown ? {
+    readonly jsonrpc: '2.0';
+    readonly id: number;
+    readonly method: M;
+    readonly params: CommandMap[M]['params'];
+} : never;
+/**
+ * A fully typed JSON-RPC request initiated by the server. Identical in shape
+ * to {@link AhpRequest} but parameterised over {@link ServerCommandMap}.
+ */
+export type AhpServerRequest<M extends keyof ServerCommandMap = keyof ServerCommandMap> = M extends unknown ? {
+    readonly jsonrpc: '2.0';
+    readonly id: number;
+    readonly method: M;
+    readonly params: ServerCommandMap[M]['params'];
+} : never;
+/**
+ * A fully typed JSON-RPC success response for a specific AHP command.
+ *
+ * Since JSON-RPC responses do not carry `method`, use this with an explicit
+ * generic parameter when you know the method from the associated request:
+ *
+ * ```ts
+ * const result: AhpSuccessResponse<'fetchTurns'> = ...;
+ * result.result.turns; // typed as Turn[]
+ * ```
+ */
+export type AhpSuccessResponse<M extends keyof CommandMap = keyof CommandMap> = M extends unknown ? {
+    readonly jsonrpc: '2.0';
+    readonly id: number;
+    readonly result: CommandMap[M]['result'];
+} : never;
+/** Typed JSON-RPC response (success with known result type, or error). */
+export type AhpResponse<M extends keyof CommandMap = keyof CommandMap> = AhpSuccessResponse<M> | JsonRpcErrorResponse;
+/**
+ * A fully typed JSON-RPC success response for a server → client request
+ * ({@link ServerCommandMap}).
+ */
+export type AhpServerSuccessResponse<M extends keyof ServerCommandMap = keyof ServerCommandMap> = M extends unknown ? {
+    readonly jsonrpc: '2.0';
+    readonly id: number;
+    readonly result: ServerCommandMap[M]['result'];
+} : never;
+/** Typed JSON-RPC response to a server → client request. */
+export type AhpServerResponse<M extends keyof ServerCommandMap = keyof ServerCommandMap> = AhpServerSuccessResponse<M> | JsonRpcErrorResponse;
+/** A client → server notification. */
+export type AhpClientNotification<M extends keyof ClientNotificationMap = keyof ClientNotificationMap> = M extends unknown ? {
+    readonly jsonrpc: '2.0';
+    readonly method: M;
+    readonly params: ClientNotificationMap[M]['params'];
+} : never;
+/** A server → client notification. */
+export type AhpServerNotification<M extends keyof ServerNotificationMap = keyof ServerNotificationMap> = M extends unknown ? {
+    readonly jsonrpc: '2.0';
+    readonly method: M;
+    readonly params: ServerNotificationMap[M]['params'];
+} : never;
+/**
+ * A fully typed JSON-RPC notification — either direction.
+ *
+ * The client → server `dispatchAction` method and the server → client
+ * `action` method are distinct entries in the registries; their params have
+ * unrelated shapes ({@link DispatchActionParams} vs {@link ActionEnvelope}).
+ */
+export type AhpNotification = AhpClientNotification | AhpServerNotification;
+/**
+ * Discriminated union of all AHP protocol messages.
+ *
+ * Narrow using standard JSON-RPC structure:
+ * - Has `method` + `id` → request ({@link AhpRequest} or {@link AhpServerRequest})
+ * - Has `method`, no `id` → notification ({@link AhpNotification})
+ * - Has `result` or `error` + `id` → response ({@link AhpResponse})
+ *
+ * Then narrow on `method` for fully typed params:
+ *
+ * ```ts
+ * function dispatch(msg: ProtocolMessage) {
+ *   if ('method' in msg && 'id' in msg) {
+ *     // msg is AhpRequest | AhpServerRequest
+ *     if (msg.method === 'fetchTurns') {
+ *       msg.params.session; // URI
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export type ProtocolMessage = AhpRequest | AhpServerRequest | AhpSuccessResponse | AhpServerSuccessResponse | JsonRpcErrorResponse | AhpNotification;
+//# sourceMappingURL=messages.d.ts.map

package/dist/vendor/ahp/common/messages.d.ts.map

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

package/dist/vendor/ahp/common/messages.js

@@ -0,0 +1,11 @@
+/* eslint-disable -- vendored third-party code, see SOURCE.md */
+/**
+ * Message Types — Fully typed JSON-RPC message definitions for the AHP wire protocol.
+ *
+ * @module common/messages
+ * @description Typed JSON-RPC request, response, and notification types for all
+ * AHP methods. Narrowing on the `method` field gives fully typed `params` and
+ * result types.
+ */
+export {};
+//# sourceMappingURL=messages.js.map

package/dist/vendor/ahp/common/messages.js.map

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