@grackle-ai/ahp 0.131.0

package/dist/vendor/ahp/channels-session/actions.d.ts.map

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

package/dist/vendor/ahp/channels-session/actions.js

@@ -0,0 +1,8 @@
+/* eslint-disable -- vendored third-party code, see SOURCE.md */
+/**
+ * Session Channel Actions — Mutations of an `ahp-session:` channel's state.
+ *
+ * @module channels-session/actions
+ */
+export {};
+//# sourceMappingURL=actions.js.map

package/dist/vendor/ahp/channels-session/actions.js.map

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

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

@@ -0,0 +1,261 @@
+/**
+ * Session Channel Commands — `createSession`, `disposeSession`, `fetchTurns`,
+ * and `completions`. Most target a specific `ahp-session:` URI.
+ *
+ * @module channels-session/commands
+ */
+import type { URI } from '../common/state.js';
+import type { BaseParams } from '../common/commands.js';
+import type { ModelSelection } from '../channels-root/state.js';
+import type { Turn, SessionActiveClient, MessageAttachment, AgentSelection } from './state.js';
+/**
+ * Creates a new session with the specified agent provider.
+ *
+ * If the session URI already exists, the server MUST return an error with code
+ * `-32003` (`SessionAlreadyExists`).
+ *
+ * After creation, the client should subscribe to the session URI to receive state
+ * updates. The server also broadcasts a `root/sessionAdded` notification to all
+ * clients.
+ *
+ * @category Commands
+ * @method createSession
+ * @direction Client → Server
+ * @messageType Request
+ * @version 1
+ * @example
+ * ```jsonc
+ * // Client → Server
+ * { "jsonrpc": "2.0", "id": 2, "method": "createSession",
+ *   "params": { "channel": "ahp-session:/<uuid>", "provider": "copilot", "model": "gpt-4o" } }
+ *
+ * // Server → Client (success)
+ * { "jsonrpc": "2.0", "id": 2, "result": null }
+ *
+ * // Server → Client (failure — provider not found)
+ * { "jsonrpc": "2.0", "id": 2, "error": { "code": -32002, "message": "No agent for provider" } }
+ *
+ * // Server → Client (failure — session already exists)
+ * { "jsonrpc": "2.0", "id": 2, "error": { "code": -32003, "message": "Session already exists" } }
+ * ```
+ */
+/**
+ * Identifies a source session and turn to fork from.
+ *
+ * When provided in `createSession`, the server populates the new session with
+ * content from the source session up to and including the response of the
+ * specified turn.
+ */
+export interface SessionForkSource {
+    /** URI of the existing session to fork from */
+    session: URI;
+    /** Turn ID in the source session; content up to and including this turn's response is copied */
+    turnId: string;
+}
+export interface CreateSessionParams extends BaseParams {
+    /** Session URI (client-chosen, e.g. `ahp-session:/<uuid>`) */
+    channel: URI;
+    /** Agent provider ID */
+    provider?: string;
+    /** Model selection (ID and optional model-specific configuration) */
+    model?: ModelSelection;
+    /**
+     * Initial custom agent selection for the new session.
+     *
+     * Omit to start the session with no custom agent selected (provider default).
+     */
+    agent?: AgentSelection;
+    /** Working directory for the session */
+    workingDirectory?: URI;
+    /**
+     * Fork from an existing session. The new session is populated with content
+     * from the source session up to and including the specified turn's response.
+     */
+    fork?: SessionForkSource;
+    /**
+     * Agent-specific configuration values collected via `resolveSessionConfig`.
+     * Keys and values correspond to the schema returned by the server.
+     */
+    config?: Record<string, unknown>;
+    /**
+     * Eagerly claim the active client role for the new session.
+     *
+     * When provided, the server initializes the session with this client as the
+     * active client, equivalent to dispatching a `session/activeClientChanged`
+     * action immediately after creation. The `clientId` MUST match the
+     * `clientId` the creating client supplied in `initialize`.
+     */
+    activeClient?: SessionActiveClient;
+}
+/**
+ * Disposes a session and cleans up server-side resources.
+ *
+ * The server broadcasts a `root/sessionRemoved` notification to all clients.
+ *
+ * @category Commands
+ * @method disposeSession
+ * @direction Client → Server
+ * @messageType Request
+ * @version 1
+ */
+export interface DisposeSessionParams extends BaseParams {
+}
+/**
+ * Fetches historical turns for a session. Used for lazy loading of conversation
+ * history.
+ *
+ * @category Commands
+ * @method fetchTurns
+ * @direction Client → Server
+ * @messageType Request
+ * @version 1
+ * @example
+ * ```jsonc
+ * // Client → Server (fetch the 20 most recent turns)
+ * { "jsonrpc": "2.0", "id": 8, "method": "fetchTurns",
+ *   "params": { "channel": "ahp-session:/<uuid>", "limit": 20 } }
+ *
+ * // Server → Client
+ * { "jsonrpc": "2.0", "id": 8, "result": {
+ *   "turns": [ { "id": "t1", ... }, { "id": "t2", ... } ],
+ *   "hasMore": true
+ * }}
+ *
+ * // Client → Server (fetch 20 turns before t1)
+ * { "jsonrpc": "2.0", "id": 9, "method": "fetchTurns",
+ *   "params": { "channel": "ahp-session:/<uuid>", "before": "t1", "limit": 20 } }
+ * ```
+ */
+export interface FetchTurnsParams extends BaseParams {
+    /** Session URI */
+    channel: URI;
+    /** Turn ID to fetch before (exclusive). Omit to fetch from the most recent turn. */
+    before?: string;
+    /** Maximum number of turns to return. Server MAY impose its own upper bound. */
+    limit?: number;
+}
+/**
+ * Result of the `fetchTurns` command.
+ */
+export interface FetchTurnsResult {
+    /** The requested turns, ordered oldest-first */
+    turns: Turn[];
+    /** Whether more turns exist before the returned range */
+    hasMore: boolean;
+}
+/**
+ * The kind of completion items being requested.
+ *
+ * @category Commands
+ */
+export declare enum CompletionItemKind {
+    /**
+     * Completions for the text of a {@link UserMessage} the user is composing.
+     * Each returned item carries an attachment that gets associated with the
+     * message when accepted.
+     */
+    UserMessage = "userMessage"
+}
+/**
+ * Requests completion items for a partially-typed input (e.g. a user message
+ * the user is currently composing). Used to power `@`-mention pickers,
+ * file/symbol references, and similar inline-completion experiences.
+ *
+ * Servers SHOULD treat this command as best-effort and return promptly. The
+ * client SHOULD debounce calls to avoid flooding the server with requests on
+ * every keystroke.
+ *
+ * @category Commands
+ * @method completions
+ * @direction Client → Server
+ * @messageType Request
+ * @version 1
+ * @example
+ * ```jsonc
+ * // User has typed "look at @foo" and the cursor is just after "@foo".
+ * // Client → Server
+ * { "jsonrpc": "2.0", "id": 12, "method": "completions",
+ *   "params": { "kind": "userMessage", "channel": "ahp-session:/<uuid>",
+ *               "text": "look at @foo", "offset": 12 } }
+ *
+ * // Server → Client
+ * { "jsonrpc": "2.0", "id": 12, "result": {
+ *   "items": [
+ *     {
+ *       "insertText": "@foo.ts",
+ *       "rangeStart": 8,
+ *       "rangeEnd": 12,
+ *       "attachment": {
+ *         "type": "resource",
+ *         "label": "foo.ts",
+ *         "displayKind": "document",
+ *         "uri": "file:///workspace/foo.ts"
+ *       }
+ *     }
+ *   ]
+ * }}
+ * ```
+ */
+export interface CompletionsParams extends BaseParams {
+    /** What kind of completion is being requested. */
+    kind: CompletionItemKind;
+    /** The session URI the completion is being requested for. */
+    channel: URI;
+    /**
+     * The complete text of the input being completed (e.g. the full user
+     * message text typed so far).
+     */
+    text: string;
+    /**
+     * The character offset within `text` at which the completion is requested,
+     * measured in UTF-16 code units. MUST satisfy `0 <= offset <= text.length`.
+     */
+    offset: number;
+}
+/**
+ * A single completion item returned by the `completions` command.
+ *
+ * When the user accepts an item, the client SHOULD:
+ * 1. Replace the range `[rangeStart, rangeEnd)` in the input with `insertText`
+ *    (or insert `insertText` at the cursor when the range is omitted).
+ * 2. Associate the item's `attachment` with the resulting {@link UserMessage}.
+ *
+ * @category Commands
+ */
+export interface CompletionItem {
+    /**
+     * The text inserted into the input when this item is accepted.
+     */
+    insertText: string;
+    /**
+     * If defined, the start of the range in the input's `text` that is replaced
+     * by `insertText`. The range is the half-open interval
+     * `[rangeStart, rangeEnd)` of character offsets, measured in UTF-16 code
+     * units.
+     *
+     * When omitted, the client SHOULD insert `insertText` at the cursor.
+     *
+     * Note: this range refers to positions in the *current* input. The
+     * attachment's own `rangeStart`/`rangeEnd` (when present) refer to
+     * positions in the final {@link UserMessage.text} after the item is
+     * accepted.
+     */
+    rangeStart?: number;
+    /**
+     * The end of the range in the input's `text` that is replaced by
+     * `insertText`. See {@link rangeStart}.
+     */
+    rangeEnd?: number;
+    /**
+     * The attachment associated with this completion item.
+     */
+    attachment: MessageAttachment;
+}
+/**
+ * Result of the `completions` command.
+ */
+export interface CompletionsResult {
+    /** The completion items, in the order the server suggests displaying them. */
+    items: CompletionItem[];
+}
+//# sourceMappingURL=commands.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../../src/vendor/ahp/channels-session/commands.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EACV,IAAI,EACJ,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACf,MAAM,YAAY,CAAC;AAIpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,+CAA+C;IAC/C,OAAO,EAAE,GAAG,CAAC;IACb,gGAAgG;IAChG,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAoB,SAAQ,UAAU;IACrD,8DAA8D;IAC9D,OAAO,EAAE,GAAG,CAAC;IACb,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB;;;;OAIG;IACH,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,wCAAwC;IACxC,gBAAgB,CAAC,EAAE,GAAG,CAAC;IACvB;;;OAGG;IACH,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,mBAAmB,CAAC;CACpC;AAID;;;;;;;;;;GAUG;AACH,MAAM,WAAW,oBAAqB,SAAQ,UAAU;CAAG;AAI3D;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,WAAW,gBAAiB,SAAQ,UAAU;IAClD,kBAAkB;IAClB,OAAO,EAAE,GAAG,CAAC;IACb,oFAAoF;IACpF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gDAAgD;IAChD,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,yDAAyD;IACzD,OAAO,EAAE,OAAO,CAAC;CAClB;AAID;;;;GAIG;AACH,oBAAY,kBAAkB;IAC5B;;;;OAIG;IACH,WAAW,gBAAgB;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,WAAW,iBAAkB,SAAQ,UAAU;IACnD,kDAAkD;IAClD,IAAI,EAAE,kBAAkB,CAAC;IACzB,6DAA6D;IAC7D,OAAO,EAAE,GAAG,CAAC;IACb;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;;;;;;;;;;;OAYG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,UAAU,EAAE,iBAAiB,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,8EAA8E;IAC9E,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB"}

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

@@ -0,0 +1,23 @@
+/* eslint-disable -- vendored third-party code, see SOURCE.md */
+/**
+ * Session Channel Commands — `createSession`, `disposeSession`, `fetchTurns`,
+ * and `completions`. Most target a specific `ahp-session:` URI.
+ *
+ * @module channels-session/commands
+ */
+// ─── completions ─────────────────────────────────────────────────────────────
+/**
+ * The kind of completion items being requested.
+ *
+ * @category Commands
+ */
+export var CompletionItemKind;
+(function (CompletionItemKind) {
+    /**
+     * Completions for the text of a {@link UserMessage} the user is composing.
+     * Each returned item carries an attachment that gets associated with the
+     * message when accepted.
+     */
+    CompletionItemKind["UserMessage"] = "userMessage";
+})(CompletionItemKind || (CompletionItemKind = {}));
+//# sourceMappingURL=commands.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../../../src/vendor/ahp/channels-session/commands.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE;;;;;GAKG;AA6JH,gFAAgF;AAEhF;;;;GAIG;AACH,MAAM,CAAN,IAAY,kBAOX;AAPD,WAAY,kBAAkB;IAC5B;;;;OAIG;IACH,iDAA2B,CAAA;AAC7B,CAAC,EAPW,kBAAkB,KAAlB,kBAAkB,QAO7B"}

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

@@ -0,0 +1,14 @@
+/**
+ * Session Channel Reducer — Pure reducer for `SessionState`, including all
+ * session-internal helpers (turn lifecycle, tool call transitions, pending
+ * messages, input requests).
+ *
+ * @module channels-session/reducer
+ */
+import type { SessionState } from './state.js';
+import type { SessionAction } from '../action-origin.generated.js';
+/**
+ * Pure reducer for session state. Handles all {@link SessionAction} variants.
+ */
+export declare function sessionReducer(state: SessionState, action: SessionAction, log?: (msg: string) => void): SessionState;
+//# sourceMappingURL=reducer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reducer.d.ts","sourceRoot":"","sources":["../../../../src/vendor/ahp/channels-session/reducer.ts"],"names":[],"mappings":"AACA;;;;;;GAMG;AAGH,OAAO,KAAK,EAGV,YAAY,EAOb,MAAM,YAAY,CAAC;AAWpB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAqOnE;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,YAAY,CAgiBpH"}