@hachej/boring-agent 0.1.90 → 0.1.92

package/dist/core/index.d.ts

@@ -1,8 +1,8 @@
-import { A as AgentHarness, a as AgentReadiness, b as Agent } from '../harness-Rbkdpvse.js';
-export { c as AGENT_NOT_IMPLEMENTED_UNTIL_T1, d as AgentActor, e as AgentCoreHarness, f as AgentCoreHarnessFactory, g as AgentCorePromptInput, h as AgentCoreSessionAdapter, i as AgentCoreSessionSnapshot, j as AgentEvent, k as AgentMessageContent, l as AgentMessagePart, m as AgentNotImplementedError, n as AgentReadinessStatus, o as AgentResolveInputResponse, p as AgentSendInput, q as AgentStartReceipt, r as AgentStreamOptions } from '../harness-Rbkdpvse.js';
-import { S as SessionStore } from '../piChatEvent-CHgln6yx.js';
-import { A as AgentCoreSessionService, a as AgentEffectAdmission } from '../piChatSessionService-DDKPOj4x.js';
-export { b as AGENT_EFFECT_METHODS, c as AgentEffectAdmissionError, P as PiChatEventStreamResult, d as PiChatEventStreamSubscription, e as PiChatEventSubscriber, f as PiChatReplayRangeError, g as PiChatSessionService, h as PiSessionCreateInit, i as PiSessionRequestContext, w as withAgentEffectAdmission } from '../piChatSessionService-DDKPOj4x.js';
+import { A as AgentHarness, a as AgentReadiness, b as Agent } from '../harness-Cc48o6uS.js';
+export { c as AGENT_NOT_IMPLEMENTED_UNTIL_T1, d as AgentActor, e as AgentCoreHarness, f as AgentCoreHarnessFactory, g as AgentCorePromptInput, h as AgentCoreSessionAdapter, i as AgentCoreSessionSnapshot, j as AgentEvent, k as AgentMessageContent, l as AgentMessagePart, m as AgentNotImplementedError, n as AgentReadinessStatus, o as AgentResolveInputResponse, p as AgentSendInput, q as AgentStartReceipt, r as AgentStreamOptions } from '../harness-Cc48o6uS.js';
+import { S as SessionStore } from '../piChatEvent-BsMp3MSo.js';
+import { A as AgentCoreSessionService, a as AgentEffectAdmission } from '../piChatSessionService-BrPqKrpY.js';
+export { b as AGENT_EFFECT_METHODS, c as AgentEffectAdmissionError, P as PiChatEventStreamResult, d as PiChatEventStreamSubscription, e as PiChatEventSubscriber, f as PiChatReplayRangeError, g as PiChatSessionService, h as PiSessionCreateInit, i as PiSessionRequestContext, w as withAgentEffectAdmission } from '../piChatSessionService-BrPqKrpY.js';
 import '@mariozechner/pi-coding-agent';
 import 'zod';
 

package/dist/core/index.js

@@ -3,12 +3,12 @@ import {
   AgentEffectAdmissionError,
   createAgent,
   withAgentEffectAdmission
-} from "../chunk-BEFJNMKQ.js";
+} from "../chunk-CJ2BW2W2.js";
 import {
   AGENT_NOT_IMPLEMENTED_UNTIL_T1,
   AgentNotImplementedError
 } from "../chunk-WSQ5QNIY.js";
-import "../chunk-4PKGVPJA.js";
+import "../chunk-2GBHYJVC.js";
 export {
   AGENT_EFFECT_METHODS,
   AGENT_NOT_IMPLEMENTED_UNTIL_T1,

package/dist/{createHarness-UCCGMVQJ.js → createHarness-PMYRKDE4.js}

@@ -4,9 +4,9 @@ import {
   deriveSourcePlugin,
   mergePiPackageSources,
   withPiHarnessDefaults
-} from "./chunk-F7ZS27HE.js";
+} from "./chunk-IWBC6SF7.js";
 import "./chunk-AQBXNPMD.js";
-import "./chunk-4PKGVPJA.js";
+import "./chunk-2GBHYJVC.js";
 export {
   createPiCodingAgentHarness,
   createResourceSettingsManager,

package/dist/errors-C38f6pol.d.ts

@@ -0,0 +1,200 @@
+import { b as PiChatEvent, o as ChatModelSelection, K as ThinkingLevel, v as ChatAttachmentPayload, Q as QueuedUserMessage, n as PiChatSnapshot } from './piChatEvent-BsMp3MSo.js';
+
+/** Placement-independent event envelope. `seq` is the only replay cursor. */
+interface AgentSessionEvent {
+    readonly ref: AgentSessionRef;
+    readonly seq: number;
+    readonly event: JsonSafe<PiChatEvent>;
+}
+
+type WorkspaceScopeId = string;
+type AuthSubjectId = string;
+type JsonPrimitive = string | number | boolean | null;
+type JsonValue = JsonPrimitive | readonly JsonValue[] | {
+    readonly [key: string]: JsonValue;
+};
+/** Maps unknown event leaves onto the JSON transport boundary. */
+type JsonSafe<T> = unknown extends T ? JsonValue : T extends JsonPrimitive ? T : T extends (...args: readonly never[]) => unknown ? never : T extends readonly (infer U)[] ? readonly JsonSafe<U>[] : T extends object ? {
+    readonly [K in keyof T]: JsonSafe<T[K]>;
+} : never;
+/** Verified identity facts returned only by the app-owned verifier. */
+interface VerifiedAgentScopeClaim {
+    readonly workspaceScopeId: WorkspaceScopeId;
+    readonly authSubjectId: AuthSubjectId;
+}
+declare const authorizedAgentScope: unique symbol;
+/**
+ * Issuer-owned runtime capability. It is deliberately not a transport DTO and
+ * must be checked by issuer identity and current membership on every use.
+ */
+interface AuthorizedAgentScope {
+    readonly workspaceScopeId: WorkspaceScopeId;
+    readonly authSubjectId: AuthSubjectId;
+    readonly [authorizedAgentScope]: true;
+}
+interface AgentScopeVerifier {
+    verify(scope: AuthorizedAgentScope): Promise<VerifiedAgentScopeClaim>;
+}
+interface AgentSessionRef {
+    readonly agentTypeId: string;
+    readonly sessionId: string;
+}
+interface AgentSummary {
+    readonly agentTypeId: string;
+    readonly label: string;
+    readonly description?: string;
+    readonly definition?: {
+        readonly version: string;
+        readonly digest: string;
+    };
+}
+interface ListAgentsInput {
+    readonly scope: AuthorizedAgentScope;
+}
+interface AuthorizedAgentSessionQuery {
+    readonly scope: AuthorizedAgentScope;
+    readonly agentTypeId?: string;
+    readonly cursor?: string;
+    readonly limit?: number;
+}
+type AgentSessionActivity = 'idle' | 'running' | 'aborting' | 'error';
+interface AgentSessionSummary {
+    readonly ref: AgentSessionRef;
+    readonly title: string;
+    readonly status: AgentSessionActivity;
+    readonly createdAt: number;
+    readonly updatedAt: number;
+}
+interface AgentSessionPage {
+    readonly sessions: readonly AgentSessionSummary[];
+    readonly nextCursor?: string;
+}
+interface CreateAgentSessionInput {
+    readonly scope: AuthorizedAgentScope;
+    readonly agentTypeId: string;
+    readonly requestId: string;
+    readonly title?: string;
+}
+interface ConnectAgentSessionInput {
+    readonly scope: AuthorizedAgentScope;
+    readonly ref: AgentSessionRef;
+    readonly cursor?: number;
+}
+interface ReadAgentSessionStateInput {
+    readonly scope: AuthorizedAgentScope;
+    readonly ref: AgentSessionRef;
+}
+interface RenameAgentSessionInput {
+    readonly scope: AuthorizedAgentScope;
+    readonly ref: AgentSessionRef;
+    readonly requestId: string;
+    readonly title: string;
+}
+interface DeleteAgentSessionInput {
+    readonly scope: AuthorizedAgentScope;
+    readonly ref: AgentSessionRef;
+    readonly requestId: string;
+}
+interface AgentPromptCommand {
+    readonly kind: 'prompt';
+    readonly requestId: string;
+    readonly clientNonce: string;
+    readonly content: string;
+    readonly displayContent?: string;
+    readonly model?: ChatModelSelection;
+    readonly thinkingLevel?: ThinkingLevel;
+    readonly attachments?: readonly ChatAttachmentPayload[];
+}
+interface AgentFollowUpCommand {
+    readonly kind: 'followup';
+    readonly requestId: string;
+    readonly clientNonce: string;
+    readonly content: string;
+    readonly displayContent?: string;
+    readonly clientSeq: number;
+}
+type IdempotentAgentSend = AgentPromptCommand | AgentFollowUpCommand;
+interface IdempotentAgentControl {
+    readonly requestId: string;
+}
+interface IdempotentQueueClear extends IdempotentAgentControl {
+    readonly clientNonce?: string;
+    readonly clientSeq?: number;
+}
+interface CommandReceipt {
+    readonly accepted: true;
+    readonly cursor: number;
+}
+interface AgentSendReceipt extends CommandReceipt {
+    readonly disposition: 'prompt' | 'followup';
+    readonly clientNonce: string;
+    readonly duplicate?: boolean;
+    readonly clientSeq?: number;
+}
+interface QueueClearReceipt extends CommandReceipt {
+    readonly cleared: number;
+}
+interface StopReceipt extends CommandReceipt {
+    readonly stopped: boolean;
+    readonly clearedQueue: readonly QueuedUserMessage[];
+}
+interface AgentSessionStateSnapshot {
+    readonly ref: AgentSessionRef;
+    readonly seq: number;
+    readonly summary: AgentSessionSummary;
+    readonly state: JsonSafe<PiChatSnapshot>;
+}
+interface AgentSessionConnection {
+    readonly ref: AgentSessionRef;
+    readonly events: AsyncIterable<AgentSessionEvent>;
+    send(input: IdempotentAgentSend): Promise<AgentSendReceipt>;
+    interrupt(input: IdempotentAgentControl): Promise<CommandReceipt>;
+    stop(input: IdempotentAgentControl): Promise<StopReceipt>;
+    clearQueue(input: IdempotentQueueClear): Promise<QueueClearReceipt>;
+    close(): Promise<void>;
+}
+interface AgentGateway {
+    listAgents(input: ListAgentsInput): Promise<readonly AgentSummary[]>;
+    listSessions(input: AuthorizedAgentSessionQuery): Promise<AgentSessionPage>;
+    createSession(input: CreateAgentSessionInput): Promise<AgentSessionRef>;
+    connectSession(input: ConnectAgentSessionInput): Promise<AgentSessionConnection>;
+    readSessionState(input: ReadAgentSessionStateInput): Promise<AgentSessionStateSnapshot>;
+    renameSession(input: RenameAgentSessionInput): Promise<AgentSessionSummary>;
+    deleteSession(input: DeleteAgentSessionInput): Promise<void>;
+    close(): Promise<void>;
+}
+
+interface FileSearch {
+    search(glob: string, limit?: number): Promise<string[]>;
+}
+
+declare const AgentGatewayErrorCode: {
+    readonly AGENT_TYPE_UNKNOWN: "AGENT_TYPE_UNKNOWN";
+    readonly AGENT_SESSION_NOT_FOUND: "AGENT_SESSION_NOT_FOUND";
+    readonly AGENT_SCOPE_DENIED: "AGENT_SCOPE_DENIED";
+    readonly AGENT_SESSION_REPLAY_GAP: "AGENT_SESSION_REPLAY_GAP";
+    readonly AGENT_SESSION_CURSOR_AHEAD: "AGENT_SESSION_CURSOR_AHEAD";
+    readonly AGENT_SESSION_CURSOR_EXPIRED: "AGENT_SESSION_CURSOR_EXPIRED";
+    readonly AGENT_SESSION_CURSOR_INVALID: "AGENT_SESSION_CURSOR_INVALID";
+    readonly AGENT_REQUEST_CONFLICT: "AGENT_REQUEST_CONFLICT";
+    readonly AGENT_REQUEST_OUTCOME_UNKNOWN: "AGENT_REQUEST_OUTCOME_UNKNOWN";
+    readonly AGENT_COMMAND_INVALID_STATE: "AGENT_COMMAND_INVALID_STATE";
+    readonly AGENT_SESSION_RUNTIME_SCOPE_MISMATCH: "AGENT_SESSION_RUNTIME_SCOPE_MISMATCH";
+    readonly AGENT_SHARED_ENVIRONMENT_UNAVAILABLE: "AGENT_SHARED_ENVIRONMENT_UNAVAILABLE";
+    readonly AGENT_GATEWAY_CLOSED: "AGENT_GATEWAY_CLOSED";
+};
+type AgentGatewayErrorCode = (typeof AgentGatewayErrorCode)[keyof typeof AgentGatewayErrorCode];
+declare const AGENT_GATEWAY_ERROR_CODES: readonly ["AGENT_TYPE_UNKNOWN", "AGENT_SESSION_NOT_FOUND", "AGENT_SCOPE_DENIED", "AGENT_SESSION_REPLAY_GAP", "AGENT_SESSION_CURSOR_AHEAD", "AGENT_SESSION_CURSOR_EXPIRED", "AGENT_SESSION_CURSOR_INVALID", "AGENT_REQUEST_CONFLICT", "AGENT_REQUEST_OUTCOME_UNKNOWN", "AGENT_COMMAND_INVALID_STATE", "AGENT_SESSION_RUNTIME_SCOPE_MISMATCH", "AGENT_SHARED_ENVIRONMENT_UNAVAILABLE", "AGENT_GATEWAY_CLOSED"];
+interface AgentGatewayErrorDTO {
+    readonly code: AgentGatewayErrorCode;
+    readonly message: string;
+    readonly details?: JsonValue;
+}
+declare class AgentGatewayError extends Error {
+    readonly code: AgentGatewayErrorCode;
+    readonly details?: JsonValue;
+    constructor(code: AgentGatewayErrorCode, message: string, details?: JsonValue);
+    toJSON(): AgentGatewayErrorDTO;
+}
+
+export { type AgentGateway as A, type ConnectAgentSessionInput as C, type DeleteAgentSessionInput as D, type FileSearch as F, type IdempotentAgentControl as I, type JsonValue as J, type ListAgentsInput as L, type ReadAgentSessionStateInput as R, type VerifiedAgentScopeClaim as V, type WorkspaceScopeId as W, type AuthorizedAgentScope as a, type AgentSessionRef as b, type AgentSessionActivity as c, type AgentSessionSummary as d, type AgentSessionStateSnapshot as e, type AgentSessionConnection as f, type AgentGatewayErrorDTO as g, type AgentScopeVerifier as h, AGENT_GATEWAY_ERROR_CODES as i, type AgentFollowUpCommand as j, AgentGatewayError as k, AgentGatewayErrorCode as l, type AgentPromptCommand as m, type AgentSendReceipt as n, type AgentSessionEvent as o, type AgentSessionPage as p, type AgentSummary as q, type AuthSubjectId as r, type AuthorizedAgentSessionQuery as s, type CreateAgentSessionInput as t, type IdempotentAgentSend as u, type IdempotentQueueClear as v, type JsonPrimitive as w, type JsonSafe as x, type RenameAgentSessionInput as y };

package/dist/front/index.d.ts

@@ -1,7 +1,7 @@
 import * as react from 'react';
 import { ComponentProps, HTMLAttributes, FormEvent, ReactNode, ComponentType } from 'react';
 import { FileUIPart, ChatStatus, UIMessage } from 'ai';
-import { T as ToolUiMetadata, B as BoringChatPart, a as BoringChatMessage, P as PiChatStatus, Q as QueuedUserMessage, C as ChatError, b as PiChatEvent, c as PromptPayload, d as PromptReceipt, F as FollowUpPayload, e as FollowUpReceipt, f as QueueClearPayload, g as QueueClearReceipt, I as InterruptPayload, h as CommandReceipt, i as StopPayload, j as StopReceipt, k as SessionSummary } from '../piChatEvent-CHgln6yx.js';
+import { T as ToolUiMetadata, B as BoringChatPart, a as BoringChatMessage, P as PiChatStatus, Q as QueuedUserMessage, C as ChatError, b as PiChatEvent, c as PromptPayload, d as PromptReceipt, F as FollowUpPayload, e as FollowUpReceipt, f as QueueClearPayload, g as QueueClearReceipt, I as InterruptPayload, h as CommandReceipt, i as StopPayload, j as StopReceipt, k as SessionSummary } from '../piChatEvent-BsMp3MSo.js';
 import { InputGroupAddon, InputGroupButton, InputGroupTextarea, Button, Collapsible, CollapsibleContent, CollapsibleTrigger } from '@hachej/boring-ui-kit';
 import { Streamdown } from 'streamdown';
 import { StickToBottom } from 'use-stick-to-bottom';
@@ -336,6 +336,8 @@ interface RemotePiSessionHeaders {
 }
 interface RemotePiSessionOptions {
     sessionId: string;
+    /** Selects the additive addressed AgentGateway transport. Omit for legacy wire. */
+    agentTypeId?: string;
     workspaceId?: string;
     storageScope?: string;
     apiBaseUrl?: string;
@@ -432,11 +434,14 @@ declare class RemotePiSession {
     private ensureReconnectScheduled;
     private scheduleReconnect;
     private postCommand;
+    private addressedCommandReceipt;
     private rollbackOptimisticMessage;
     private fetchJson;
     private requestHeaders;
     private stateUrl;
+    private eventsUrl;
     private sessionUrl;
+    private addressedCommandPayload;
     private dispatchProtocolError;
     private recordEventType;
     private recordLargeStateWarning;
@@ -465,10 +470,14 @@ interface PiSessionCreateInit {
 }
 interface PiSessionRefreshOptions {
     background?: boolean;
+    /** Reject when the authoritative refresh fails instead of only updating hook state. */
+    throwOnError?: boolean;
 }
 interface UsePiSessionsOptions {
     apiBaseUrl?: string;
     sessionsApiPath?: string;
+    /** Selects the additive addressed AgentGateway transport. Omit for legacy wire. */
+    agentTypeId?: string;
     workspaceId?: string;
     storageScope?: string;
     requestHeaders?: Record<string, string | undefined>;
@@ -478,7 +487,7 @@ interface UsePiSessionsOptions {
     fetch?: typeof globalThis.fetch;
     storage?: ActiveSessionStorageLike;
     createRemoteSession?: (options: RemotePiSessionOptions) => RemotePiSession;
-    remoteSessionOptions?: Omit<Partial<RemotePiSessionOptions>, 'sessionId' | 'workspaceId' | 'storageScope' | 'apiBaseUrl' | 'headers' | 'fetch'>;
+    remoteSessionOptions?: Omit<Partial<RemotePiSessionOptions>, 'sessionId' | 'agentTypeId' | 'workspaceId' | 'storageScope' | 'apiBaseUrl' | 'headers' | 'fetch'>;
     connectActiveSession?: boolean;
     retry?: {
         maxRetries?: number;
@@ -600,6 +609,8 @@ interface AgentPluginReloadResult {
 interface PiChatPanelProps<TComposerBlocker extends ComposerBlocker = ComposerBlocker> {
     /** Optional externally selected Pi session id. When provided, session navigation is owned by the host. */
     sessionId?: string;
+    /** Selects the additive addressed AgentGateway transport. Omit for legacy wire. */
+    agentTypeId?: string;
     /** Alias kept for consumers that still pass the pre-cutover prop name. */
     extraCommands?: SlashCommand[];
     apiBaseUrl?: string;
@@ -667,7 +678,7 @@ interface PiChatPanelProps<TComposerBlocker extends ComposerBlocker = ComposerBl
      * knowing what the code means or what the action does. */
     renderNoticeAction?: (notice: PiChatRuntimeNotice) => ReactNode;
 }
-declare function PiChatPanel<TComposerBlocker extends ComposerBlocker = ComposerBlocker>({ sessionId, extraCommands, apiBaseUrl, workspaceId, storageScope, requestHeaders, storage, fetch, className, chrome, debug, showSessions, hotReloadEnabled, suggestions, emptyState, emptyPlacement, composerPlaceholder, initialDraft, autoSubmitInitialDraft, onDraftRestored, onAutoSubmitInitialDraftAccepted, onAutoSubmitInitialDraftSettled, model, defaultModel, availableModels, hideDefaultModelOption, hideComposerSettings, suppressPreSubmitCancelledWarning, thinkingLevel, thinkingControl, serverResourcesEnabled, mentionedFiles, commands, excludeBuiltinCommands, toolRenderers, createRemoteSession, remoteSessionOptions, hydrateMessages, allowPromptDuringInitialHydration, workspaceWarmupStatus, onSessionReset, onBeforeSubmit, onReloadAgentPlugins, onCommandResult, onComposerWarning, onMentionedFilesConsumed, onPromptSubmitStarted, onData, onOpenArtifact, composerBlockers, onComposerStop, onComposerBlockerAction, onTurnComplete, renderNoticeAction, }: PiChatPanelProps<TComposerBlocker>): react.JSX.Element;
+declare function PiChatPanel<TComposerBlocker extends ComposerBlocker = ComposerBlocker>({ sessionId, agentTypeId, extraCommands, apiBaseUrl, workspaceId, storageScope, requestHeaders, storage, fetch, className, chrome, debug, showSessions, hotReloadEnabled, suggestions, emptyState, emptyPlacement, composerPlaceholder, initialDraft, autoSubmitInitialDraft, onDraftRestored, onAutoSubmitInitialDraftAccepted, onAutoSubmitInitialDraftSettled, model, defaultModel, availableModels, hideDefaultModelOption, hideComposerSettings, suppressPreSubmitCancelledWarning, thinkingLevel, thinkingControl, serverResourcesEnabled, mentionedFiles, commands, excludeBuiltinCommands, toolRenderers, createRemoteSession, remoteSessionOptions, hydrateMessages, allowPromptDuringInitialHydration, workspaceWarmupStatus, onSessionReset, onBeforeSubmit, onReloadAgentPlugins, onCommandResult, onComposerWarning, onMentionedFilesConsumed, onPromptSubmitStarted, onData, onOpenArtifact, composerBlockers, onComposerStop, onComposerBlockerAction, onTurnComplete, renderNoticeAction, }: PiChatPanelProps<TComposerBlocker>): react.JSX.Element;
 
 interface DebugDrawerProps {
     apiBaseUrl?: string;
@@ -699,6 +710,7 @@ declare const ModelSelectTrigger: react.ForwardRefExoticComponent<Omit<Omit<reac
     disabled?: boolean;
     trigger?: SelectorTrigger;
     open?: boolean;
+    emptyLabel?: string;
 } & react.RefAttributes<HTMLButtonElement>>;
 declare function ModelPickerMenu({ value, onChange, options, disabled, hideDefaultOption, onClose, className, }: {
     value: ModelSelection | null;
@@ -716,7 +728,7 @@ declare function ModelPickerMenu({ value, onChange, options, disabled, hideDefau
  * option's stored value, encoded as "{provider}:{id}" to keep
  * ids stable across providers.
  */
-declare function ModelSelect({ value, onChange, options, disabled, trigger, openSignal, className, }: {
+declare function ModelSelect({ value, onChange, options, disabled, trigger, openSignal, className, emptyLabel, ariaInvalid, ariaDescribedBy, hideDefaultOption, }: {
     value: ModelSelection | null;
     onChange: (next: ModelSelection | null) => void;
     options: AvailableModel[];
@@ -724,6 +736,10 @@ declare function ModelSelect({ value, onChange, options, disabled, trigger, open
     trigger?: SelectorTrigger;
     openSignal?: unknown;
     className?: string;
+    emptyLabel?: string;
+    ariaInvalid?: boolean;
+    ariaDescribedBy?: string;
+    hideDefaultOption?: boolean;
 }): react.JSX.Element;
 declare function ThinkingSelect({ value, onChange, disabled, trigger, openSignal, className, }: {
     value: ThinkingLevel;