@hachej/boring-agent 0.1.104 → 0.1.107

package/dist/{chunk-6DRHERVK.js → chunk-MVKXLMH3.js}

@@ -1,6 +1,6 @@
 import {
   ErrorCode
-} from "./chunk-K25PK5EC.js";
+} from "./chunk-3JFPS2O6.js";
 
 // src/shared/tool-ui.ts
 function isRecord(value) {
@@ -38,6 +38,9 @@ var AgentGatewayErrorCode = {
   AGENT_TYPE_UNKNOWN: "AGENT_TYPE_UNKNOWN",
   AGENT_SESSION_NOT_FOUND: "AGENT_SESSION_NOT_FOUND",
   AGENT_SCOPE_DENIED: "AGENT_SCOPE_DENIED",
+  AGENT_ENTITLEMENT_REQUIRED: "AGENT_ENTITLEMENT_REQUIRED",
+  AGENT_ACCESS_FORBIDDEN: "AGENT_ACCESS_FORBIDDEN",
+  AGENT_ACCESS_POLICY_UNAVAILABLE: "AGENT_ACCESS_POLICY_UNAVAILABLE",
   AGENT_SESSION_REPLAY_GAP: "AGENT_SESSION_REPLAY_GAP",
   AGENT_SESSION_CURSOR_AHEAD: "AGENT_SESSION_CURSOR_AHEAD",
   AGENT_SESSION_CURSOR_EXPIRED: "AGENT_SESSION_CURSOR_EXPIRED",
@@ -54,6 +57,9 @@ var AGENT_GATEWAY_ERROR_CODES = [
   AgentGatewayErrorCode.AGENT_TYPE_UNKNOWN,
   AgentGatewayErrorCode.AGENT_SESSION_NOT_FOUND,
   AgentGatewayErrorCode.AGENT_SCOPE_DENIED,
+  AgentGatewayErrorCode.AGENT_ENTITLEMENT_REQUIRED,
+  AgentGatewayErrorCode.AGENT_ACCESS_FORBIDDEN,
+  AgentGatewayErrorCode.AGENT_ACCESS_POLICY_UNAVAILABLE,
   AgentGatewayErrorCode.AGENT_SESSION_REPLAY_GAP,
   AgentGatewayErrorCode.AGENT_SESSION_CURSOR_AHEAD,
   AgentGatewayErrorCode.AGENT_SESSION_CURSOR_EXPIRED,
@@ -292,7 +298,9 @@ var QueueClearPayloadSchema = z.preprocess(
     clientSeq: z.number().int().nonnegative().optional()
   }).strict()
 );
-var InterruptPayloadSchema = z.object({}).strict();
+var InterruptPayloadSchema = z.object({
+  queueAction: z.enum(["hold", "resume"]).optional()
+}).strict();
 var StopPayloadSchema = z.object({}).strict();
 var CommandReceiptSchema = z.object({
   accepted: z.literal(true),
@@ -316,6 +324,38 @@ var StopReceiptSchema = CommandReceiptSchema.extend({
   clearedQueue: z.array(QueuedUserMessageSchema)
 });
 
+// src/shared/chat/modelContextError.ts
+var MODEL_CONTEXT_RECOVERY_MESSAGE = "This conversation exceeded the model context window. Compact the conversation and retry, or start a new chat with less context.";
+var CONTEXT_WINDOW_ERROR_PATTERN = /context[_ ]length[_ ]exceeded|exceeds the context window|input exceeds the context window/i;
+function errorMessage(value) {
+  if (value instanceof Error) return value.message;
+  if (typeof value === "string") return value;
+  if (typeof value !== "object" || value === null) return void 0;
+  const record = value;
+  if (typeof record.code === "string" && CONTEXT_WINDOW_ERROR_PATTERN.test(record.code)) return record.code;
+  if (typeof record.message === "string") return record.message;
+  return errorMessage(record.error);
+}
+function isModelContextWindowError(value) {
+  const message = errorMessage(value);
+  return message !== void 0 && CONTEXT_WINDOW_ERROR_PATTERN.test(message);
+}
+function chatErrorFromUnknown(value, fallbackMessage) {
+  if (isModelContextWindowError(value)) {
+    return {
+      code: ErrorCode.enum.MODEL_CONTEXT_WINDOW_EXCEEDED,
+      message: MODEL_CONTEXT_RECOVERY_MESSAGE,
+      retryable: true
+    };
+  }
+  const message = errorMessage(value);
+  return {
+    code: ErrorCode.enum.INTERNAL_ERROR,
+    message: message || fallbackMessage,
+    retryable: false
+  };
+}
+
 export {
   isToolUiMetadata,
   sanitizeToolUiMetadata,
@@ -325,6 +365,8 @@ export {
   AgentGatewayErrorCode,
   AGENT_GATEWAY_ERROR_CODES,
   AgentGatewayError,
+  isModelContextWindowError,
+  chatErrorFromUnknown,
   ToolUiMetadataSchema,
   sanitizeToolUiMetadata2,
   ChatErrorSchema,

package/dist/chunk-YTUZFKB3.js

@@ -0,0 +1,78 @@
+// src/shared/events.ts
+var AGENT_NOT_IMPLEMENTED_UNTIL_T1 = "ERR_NOT_IMPLEMENTED_UNTIL_T1";
+var SESSION_STREAM_PREFIX = "sessions/";
+var V1_QUARANTINE_STREAM_PREFIX = "quarantine/v1/";
+function sessionStreamPath(identity) {
+  assertIdentitySegment("workspaceScopeId", identity?.workspaceScopeId);
+  assertIdentitySegment("sessionId", identity?.sessionId);
+  return `${SESSION_STREAM_PREFIX}${encodeIdentitySegment(identity.workspaceScopeId)}/${encodeIdentitySegment(identity.sessionId)}`;
+}
+function parseSessionStreamPath(path) {
+  if (typeof path !== "string" || !path.startsWith(SESSION_STREAM_PREFIX)) return null;
+  const segments = path.slice(SESSION_STREAM_PREFIX.length).split("/");
+  if (segments.length !== 2) return null;
+  const workspaceScopeId = decodeIdentitySegment(segments[0] ?? "");
+  const sessionId = decodeIdentitySegment(segments[1] ?? "");
+  if (workspaceScopeId === null || sessionId === null) return null;
+  return { workspaceScopeId, sessionId };
+}
+function quarantineV1EventStreamPath(oldPath) {
+  return `${V1_QUARANTINE_STREAM_PREFIX}${encodeIdentitySegment(oldPath)}`;
+}
+function quarantineV1EventStreamRowidPath(rowid) {
+  if (!Number.isSafeInteger(rowid) || rowid <= 0) {
+    throw new TypeError("Legacy event stream rowid must be a positive safe integer.");
+  }
+  return `${V1_QUARANTINE_STREAM_PREFIX}rowid-${rowid}`;
+}
+function assertIdentitySegment(name, value) {
+  if (typeof value !== "string" || value.length === 0) {
+    throw new TypeError(`Session stream ${name} must be a non-empty string.`);
+  }
+  if (!isWellFormedUnicode(value)) {
+    throw new TypeError(`Session stream ${name} must contain well-formed Unicode.`);
+  }
+}
+function isWellFormedUnicode(value) {
+  for (let index = 0; index < value.length; index += 1) {
+    const code = value.charCodeAt(index);
+    if (code >= 55296 && code <= 56319) {
+      const next = value.charCodeAt(index + 1);
+      if (!(next >= 56320 && next <= 57343)) return false;
+      index += 1;
+    } else if (code >= 56320 && code <= 57343) {
+      return false;
+    }
+  }
+  return true;
+}
+function encodeIdentitySegment(value) {
+  return encodeURIComponent(value).replace(/[!'()*~]/g, (character) => `%${character.charCodeAt(0).toString(16).toUpperCase()}`);
+}
+function decodeIdentitySegment(value) {
+  if (value.length === 0) return null;
+  try {
+    const decoded = decodeURIComponent(value);
+    if (decoded.length === 0 || encodeIdentitySegment(decoded) !== value) return null;
+    return decoded;
+  } catch {
+    return null;
+  }
+}
+var AgentNotImplementedError = class extends Error {
+  code = AGENT_NOT_IMPLEMENTED_UNTIL_T1;
+  constructor(message = "This agent capability is not implemented until T1.") {
+    super(message);
+    this.name = "AgentNotImplementedError";
+  }
+};
+
+export {
+  AGENT_NOT_IMPLEMENTED_UNTIL_T1,
+  SESSION_STREAM_PREFIX,
+  sessionStreamPath,
+  parseSessionStreamPath,
+  quarantineV1EventStreamPath,
+  quarantineV1EventStreamRowidPath,
+  AgentNotImplementedError
+};

package/dist/core/index.d.ts

@@ -1,8 +1,8 @@
-import { A as AgentHarness, a as AgentReadiness, b as Agent } from '../harness-Dcd08yKr.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-Dcd08yKr.js';
-import { S as SessionStore } from '../piChatEvent-iNSXiFQq.js';
-import { A as AgentCoreSessionService, a as AgentEffectAdmission } from '../piChatSessionService-DQSQ_kWZ.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-DQSQ_kWZ.js';
+import { A as AgentHarness, a as AgentReadiness, b as Agent } from '../harness-Ct0e4RWc.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-Ct0e4RWc.js';
+import { S as SessionStore } from '../piChatEvent-BUWIzw5l.js';
+import { A as AgentCoreSessionService, a as AgentEffectAdmission } from '../piChatSessionService-nvroRAVk.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-nvroRAVk.js';
 import '@mariozechner/pi-coding-agent';
 import 'zod';
 

package/dist/core/index.js

@@ -1,10 +1,10 @@
 import {
   AGENT_NOT_IMPLEMENTED_UNTIL_T1,
   AgentNotImplementedError
-} from "../chunk-WSQ5QNIY.js";
+} from "../chunk-YTUZFKB3.js";
 import {
   ErrorCode
-} from "../chunk-K25PK5EC.js";
+} from "../chunk-3JFPS2O6.js";
 
 // src/core/piChatSessionService.ts
 var AgentEffectAdmissionError = class extends Error {

package/dist/{createHarness-POZ4AXCZ.js → createHarness-AHWSC36D.js}

@@ -5,9 +5,9 @@ import {
   mergePiPackageSources,
   projectSkillResourceLocations,
   withPiHarnessDefaults
-} from "./chunk-I7KFNGB4.js";
-import "./chunk-4IQ4HHBG.js";
-import "./chunk-K25PK5EC.js";
+} from "./chunk-GS4ADE34.js";
+import "./chunk-7XAOVFSN.js";
+import "./chunk-3JFPS2O6.js";
 export {
   createPiCodingAgentHarness,
   createResourceSettingsManager,

package/dist/{errors-DH7C01Pm.d.ts → errors-CEU4iujR.d.ts}

@@ -1,4 +1,4 @@
-import { c as PiChatEvent, C as ChatModelSelection, T as ThinkingLevel, l as ChatAttachmentPayload, m as QueuedUserMessage, P as PiChatSnapshot } from './piChatEvent-iNSXiFQq.js';
+import { d as PiChatEvent, l as SessionArchiveFilter, C as ChatModelSelection, T as ThinkingLevel, m as ChatAttachmentPayload, n as QueuedUserMessage, c as PiChatSnapshot } from './piChatEvent-BUWIzw5l.js';
 
 /** Placement-independent event envelope. `seq` is the only replay cursor. */
 interface AgentSessionEvent {
@@ -35,6 +35,33 @@ interface AuthorizedAgentScope {
 interface AgentScopeVerifier {
     verify(scope: AuthorizedAgentScope): Promise<VerifiedAgentScopeClaim>;
 }
+/**
+ * Product-owned access decision for one deployed Agent in one verified scope.
+ * The Host consumes this decision before session lookup, runtime binding, or
+ * effects. A host without a resolver preserves the legacy all-deployed policy.
+ */
+type AgentAccessDecision = {
+    readonly state: 'allowed';
+    readonly seatId?: string;
+} | {
+    readonly state: 'not-available';
+    readonly reason: 'not-deployed' | 'not-seated';
+} | {
+    readonly state: 'entitlement-denied';
+    readonly seatId: string;
+    readonly denial: 'subscription-required' | 'forbidden';
+} | {
+    readonly state: 'policy-unavailable';
+    readonly retryAfterSeconds?: number;
+};
+type AgentAccessOperation = 'catalog' | 'session.list' | 'session.read' | 'session.create' | 'session.mutate' | 'runtime.bind' | 'runtime.effect' | 'stream.event';
+interface ResolveAgentAccessInput {
+    readonly authorizedScope: AuthorizedAgentScope;
+    readonly verifiedClaim: VerifiedAgentScopeClaim;
+    readonly agentTypeId: string;
+    readonly operation: AgentAccessOperation;
+}
+type ResolveAgentAccess = (input: ResolveAgentAccessInput) => Promise<AgentAccessDecision>;
 interface AgentSessionRef {
     readonly agentTypeId: string;
     readonly sessionId: string;
@@ -58,6 +85,8 @@ interface AuthorizedAgentSessionQuery {
     readonly agentTypeId?: string;
     readonly cursor?: string;
     readonly limit?: number;
+    /** Defaults to `all`; archiving is a visibility flag, not a listing default. */
+    readonly archived?: SessionArchiveFilter;
 }
 type AgentSessionActivity = 'idle' | 'running' | 'aborting' | 'error';
 interface AgentSessionSummary {
@@ -71,6 +100,8 @@ interface AgentSessionSummary {
     readonly nativeSessionId?: string;
     /** Native transcript metadata used to gate rename until a reply exists. */
     readonly hasAssistantReply?: boolean;
+    /** Visibility only: present (true) exactly while the session is archived. */
+    readonly archived?: boolean;
 }
 interface AgentSessionPage {
     readonly sessions: readonly AgentSessionSummary[];
@@ -99,6 +130,17 @@ interface RenameAgentSessionInput {
     readonly requestId: string;
     readonly title: string;
 }
+/**
+ * Archive is NOT delete: it hides the session from a default listing and
+ * nothing else. The transcript stays exactly where it was, and `archived:
+ * false` puts the row back.
+ */
+interface SetAgentSessionArchivedInput {
+    readonly scope: AuthorizedAgentScope;
+    readonly ref: AgentSessionRef;
+    readonly requestId: string;
+    readonly archived: boolean;
+}
 interface DeleteAgentSessionInput {
     readonly scope: AuthorizedAgentScope;
     readonly ref: AgentSessionRef;
@@ -128,6 +170,10 @@ type IdempotentAgentSend = AgentPromptCommand | AgentFollowUpCommand;
 interface IdempotentAgentControl {
     readonly requestId: string;
 }
+interface IdempotentInterruptControl extends IdempotentAgentControl {
+    /** Abort-and-queue policy specific to interrupt commands. */
+    readonly queueAction?: 'hold' | 'resume';
+}
 interface IdempotentQueueClear extends IdempotentAgentControl {
     readonly clientNonce?: string;
     readonly clientSeq?: number;
@@ -159,18 +205,24 @@ interface AgentSessionConnection {
     readonly ref: AgentSessionRef;
     readonly events: AsyncIterable<AgentSessionEvent>;
     send(input: IdempotentAgentSend): Promise<AgentSendReceipt>;
-    interrupt(input: IdempotentAgentControl): Promise<CommandReceipt>;
+    interrupt(input: IdempotentInterruptControl): Promise<CommandReceipt>;
     stop(input: IdempotentAgentControl): Promise<StopReceipt>;
     clearQueue(input: IdempotentQueueClear): Promise<QueueClearReceipt>;
     close(): Promise<void>;
 }
 interface AgentGateway {
+    authorizeAgentAccess?(input: {
+        readonly scope: AuthorizedAgentScope;
+        readonly agentTypeId: string;
+        readonly operation: AgentAccessOperation;
+    }): Promise<void>;
     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>;
+    setSessionArchived(input: SetAgentSessionArchivedInput): Promise<AgentSessionSummary>;
     deleteSession(input: DeleteAgentSessionInput): Promise<void>;
     close(): Promise<void>;
 }
@@ -179,6 +231,9 @@ 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_ENTITLEMENT_REQUIRED: "AGENT_ENTITLEMENT_REQUIRED";
+    readonly AGENT_ACCESS_FORBIDDEN: "AGENT_ACCESS_FORBIDDEN";
+    readonly AGENT_ACCESS_POLICY_UNAVAILABLE: "AGENT_ACCESS_POLICY_UNAVAILABLE";
     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";
@@ -192,7 +247,7 @@ declare const AgentGatewayErrorCode: {
     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_IN_PROGRESS", "AGENT_REQUEST_OUTCOME_UNKNOWN", "AGENT_RUNTIME_RESTART_REQUIRED", "AGENT_COMMAND_INVALID_STATE", "AGENT_SHARED_ENVIRONMENT_UNAVAILABLE", "AGENT_GATEWAY_CLOSED"];
+declare const AGENT_GATEWAY_ERROR_CODES: readonly ["AGENT_TYPE_UNKNOWN", "AGENT_SESSION_NOT_FOUND", "AGENT_SCOPE_DENIED", "AGENT_ENTITLEMENT_REQUIRED", "AGENT_ACCESS_FORBIDDEN", "AGENT_ACCESS_POLICY_UNAVAILABLE", "AGENT_SESSION_REPLAY_GAP", "AGENT_SESSION_CURSOR_AHEAD", "AGENT_SESSION_CURSOR_EXPIRED", "AGENT_SESSION_CURSOR_INVALID", "AGENT_REQUEST_CONFLICT", "AGENT_REQUEST_IN_PROGRESS", "AGENT_REQUEST_OUTCOME_UNKNOWN", "AGENT_RUNTIME_RESTART_REQUIRED", "AGENT_COMMAND_INVALID_STATE", "AGENT_SHARED_ENVIRONMENT_UNAVAILABLE", "AGENT_GATEWAY_CLOSED"];
 interface AgentGatewayErrorDTO {
     readonly code: AgentGatewayErrorCode;
     readonly message: string;
@@ -205,4 +260,4 @@ declare class AgentGatewayError extends Error {
     toJSON(): AgentGatewayErrorDTO;
 }
 
-export { type AgentGateway as A, type ConnectAgentSessionInput as C, type DeleteAgentSessionInput as D, type IdempotentAgentControl as I, type JsonPrimitive 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 AgentSendReceipt as d, AGENT_GATEWAY_ERROR_CODES as e, type AgentFollowUpCommand as f, AgentGatewayError as g, AgentGatewayErrorCode as h, type AgentGatewayErrorDTO as i, type AgentPromptCommand as j, type AgentScopeVerifier as k, type AgentSessionConnection as l, type AgentSessionEvent as m, type AgentSessionPage as n, type AgentSessionStateSnapshot as o, type AgentSessionSummary 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 JsonSafe as w, type JsonValue as x, type RenameAgentSessionInput as y };
+export { type AgentGateway as A, type JsonValue as B, type ConnectAgentSessionInput as C, type DeleteAgentSessionInput as D, type RenameAgentSessionInput as E, type ResolveAgentAccess as F, type ResolveAgentAccessInput as G, type IdempotentAgentControl as I, type JsonPrimitive 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 AgentSendReceipt as d, AGENT_GATEWAY_ERROR_CODES as e, type AgentAccessDecision as f, type AgentAccessOperation as g, type AgentFollowUpCommand as h, AgentGatewayError as i, AgentGatewayErrorCode as j, type AgentGatewayErrorDTO as k, type AgentPromptCommand as l, type AgentScopeVerifier as m, type AgentSessionConnection as n, type AgentSessionEvent as o, type AgentSessionPage as p, type AgentSessionStateSnapshot as q, type AgentSessionSummary as r, type AgentSummary as s, type AuthSubjectId as t, type AuthorizedAgentSessionQuery as u, type CreateAgentSessionInput as v, type IdempotentAgentSend as w, type IdempotentInterruptControl as x, type IdempotentQueueClear as y, type JsonSafe as z };

package/dist/{file-search-qcD5zItr.d.ts → file-search-BGUHnW9o.d.ts}

@@ -1,7 +1,7 @@
-import { k as InterruptReceipt, j as StopReceipt } from './piChatEvent-iNSXiFQq.js';
-import { p as AgentSendInput, j as AgentEvent } from './harness-Dcd08yKr.js';
+import { k as InterruptReceipt, j as StopReceipt } from './piChatEvent-BUWIzw5l.js';
+import { p as AgentSendInput, j as AgentEvent } from './harness-Ct0e4RWc.js';
 import { b as Workspace } from './sandbox-BMhut3kh.js';
-import { b as AgentSessionRef, d as AgentSendReceipt, A as AgentGateway, a as AuthorizedAgentScope } from './errors-DH7C01Pm.js';
+import { b as AgentSessionRef, d as AgentSendReceipt, A as AgentGateway, a as AuthorizedAgentScope } from './errors-CEU4iujR.js';
 
 interface WorkspaceAgentDispatcherContext {
     workspaceId: string;

package/dist/front/index.d.ts

@@ -1,8 +1,8 @@
-import { p as ToolUiMetadata, B as BoringChatPart, v as BoringChatMessage, H as PiChatStatus, P as PiChatSnapshot, m as QueuedUserMessage, w as ChatError, c as PiChatEvent, d as PromptPayload, e as PromptReceipt, F as FollowUpPayload, f as FollowUpReceipt, Q as QueueClearPayload, g as QueueClearReceipt, I as InterruptPayload, h as CommandReceipt, i as StopPayload, j as StopReceipt, b as SessionSummary, y as ErrorCode } from '../piChatEvent-iNSXiFQq.js';
+import { q as ToolUiMetadata, B as BoringChatPart, w as BoringChatMessage, J as PiChatStatus, c as PiChatSnapshot, n as QueuedUserMessage, x as ChatError, d as PiChatEvent, P as PromptPayload, e as PromptReceipt, F as FollowUpPayload, f as FollowUpReceipt, Q as QueueClearPayload, g as QueueClearReceipt, I as InterruptPayload, h as CommandReceipt, i as StopPayload, j as StopReceipt, b as SessionSummary, z as ErrorCode } from '../piChatEvent-BUWIzw5l.js';
 import * as react from 'react';
 import { ComponentProps, HTMLAttributes, FormEvent, ReactNode, ComponentType } from 'react';
 import { FileUIPart, ChatStatus, UIMessage } from 'ai';
-import { q as AgentSummary, h as AgentGatewayErrorCode, x as JsonValue } from '../errors-DH7C01Pm.js';
+import { s as AgentSummary, j as AgentGatewayErrorCode, B as JsonValue } from '../errors-CEU4iujR.js';
 export { Artifact, ArtifactAction, ArtifactActions, ArtifactDescription, ArtifactHeader, ArtifactOpenProvider, ArtifactTitle, OpenArtifactHandler, useOpenArtifact } from './artifacts.js';
 import { InputGroupAddon, InputGroupButton, InputGroupTextarea, Button, Collapsible, CollapsibleContent, CollapsibleTrigger } from '@hachej/boring-ui-kit';
 import { Streamdown } from 'streamdown';
@@ -14,6 +14,7 @@ import 'lucide-react';
 interface UploadFileOptions {
     apiBaseUrl?: string;
     workspaceRequestId?: string | null;
+    requestHeaders?: Record<string, string | undefined>;
     directory?: string;
     sourcePath?: string;
     responseUrl?: 'markdown' | 'raw';
@@ -157,6 +158,13 @@ declare function parseSlashCommand(text: string): ParsedCommand | null;
 type SlashCommandHandlerResult = string | void | {
     message?: string;
     preserveDraft?: boolean;
+    /**
+     * Result text the agent must see. When set, the command's outcome is also
+     * submitted as an expanded-text turn, so it lands in the model's context the
+     * same way a skill command's expansion does — a browser-only notice is
+     * invisible to the agent. Keep it a short structured summary, not a dump.
+     */
+    modelMessage?: string;
 };
 type SlashCommandHandler = (args: string, ctx: SlashCommandContext) => SlashCommandHandlerResult | Promise<SlashCommandHandlerResult>;
 type SlashCommandClickBehavior = 'execute' | 'insert' | 'disabled';
@@ -444,6 +452,7 @@ declare class RemotePiSession {
     prompt(payload: PromptPayload): Promise<PromptReceipt>;
     followUp(payload: FollowUpPayload): Promise<FollowUpReceipt>;
     clearQueue(payload?: QueueClearPayload): Promise<QueueClearReceipt>;
+    private postQueueClear;
     interrupt(payload?: InterruptPayload): Promise<CommandReceipt>;
     stop(payload?: StopPayload): Promise<StopReceipt>;
     suspendStream(): void;
@@ -548,10 +557,18 @@ interface UsePiSessionsResult {
     loading: boolean;
     loadingMore: boolean;
     hasMore: boolean;
+    /** Archived inventory is paged independently from the active list. */
+    archivedLoaded: boolean;
+    archivedLoading: boolean;
+    hasMoreArchived: boolean;
     error: Error | undefined;
     refresh: (options?: PiSessionRefreshOptions) => Promise<void>;
     create: (init?: PiSessionCreateInit) => Promise<SessionSummary>;
     rename: (id: string, title: string) => Promise<SessionSummary>;
+    /** Explicit archive capability; never aliases delete. */
+    setArchived: (id: string, archived: boolean) => Promise<SessionSummary>;
+    /** Loads the first or next archived-only page. */
+    loadArchived: () => Promise<void>;
     switch: (id: string) => void;
     delete: (id: string) => Promise<void>;
     loadMore: () => Promise<void>;
@@ -620,6 +637,18 @@ declare function matchPiSessionSearch(session: PiSessionSearchItem, parsed: Pars
 };
 declare function searchPiSessions<T extends PiSessionSearchItem>(sessions: readonly T[], query: string, options?: PiSessionSearchOptions): T[];
 
+interface PiComposerHandledSubmit {
+    handled: true;
+    message?: string;
+}
+interface PiComposerReplacementSubmit {
+    replacement: {
+        text: string;
+        displayText?: string;
+    };
+}
+type PiComposerBeforeSubmitResult = boolean | void | PiComposerHandledSubmit | PiComposerReplacementSubmit;
+
 interface ComposerBlockerAction {
     id: string;
     label: string;
@@ -640,6 +669,7 @@ interface ChatSubmitContext {
     sessionId: string;
     source: ChatSubmitSource;
 }
+type ChatBeforeSubmitResult = PiComposerBeforeSubmitResult;
 interface ChatPanelEmptyState {
     eyebrow?: string;
     title?: string;
@@ -698,7 +728,11 @@ interface PiChatPanelProps<TComposerBlocker extends ComposerBlocker = ComposerBl
     allowPromptDuringInitialHydration?: boolean;
     workspaceWarmupStatus?: ChatPanelWorkspaceWarmupStatus;
     onSessionReset?: () => void | Promise<void>;
-    onBeforeSubmit?: (draft: string, context: ChatSubmitContext) => false | void | boolean | Promise<false | void | boolean>;
+    /** Persist oversized text prompts through the workspace upload route and send a compact path reference. Enabled by default. */
+    spillLargePrompts?: boolean;
+    /** Character threshold for generic prompt spilling. Defaults to 12,000. */
+    largePromptThresholdChars?: number;
+    onBeforeSubmit?: (draft: string, context: ChatSubmitContext) => ChatBeforeSubmitResult | Promise<ChatBeforeSubmitResult>;
     onReloadAgentPlugins?: () => Promise<AgentPluginReloadResult | string>;
     onCommandResult?: (message: string) => void;
     onComposerWarning?: (message: string) => void;
@@ -723,13 +757,15 @@ 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, 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;
+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, spillLargePrompts, largePromptThresholdChars, onBeforeSubmit, onReloadAgentPlugins, onCommandResult, onComposerWarning, onMentionedFilesConsumed, onPromptSubmitStarted, onData, onOpenArtifact, composerBlockers, onComposerStop, onComposerBlockerAction, onTurnComplete, renderNoticeAction, }: PiChatPanelProps<TComposerBlocker>): react.JSX.Element;
 
 type AddressedAgentOption = Pick<AgentSummary, 'agentTypeId' | 'label' | 'description' | 'pluginIds'>;
 interface UseAddressedAgentSelectionOptions {
     apiBaseUrl?: string;
     requestHeaders?: Record<string, string | undefined>;
     storageScope?: string;
+    /** Initial regular Agent selection; never changes fleet membership or order. */
+    preferredAgentTypeId?: string;
     fetch?: typeof globalThis.fetch;
     enabled?: boolean;
 }
@@ -740,7 +776,7 @@ interface UseAddressedAgentSelectionResult {
     error: Error | undefined;
     selectAgentTypeId: (agentTypeId: string) => void;
 }
-declare function useAddressedAgentSelection({ apiBaseUrl, requestHeaders, storageScope, fetch, enabled, }?: UseAddressedAgentSelectionOptions): UseAddressedAgentSelectionResult;
+declare function useAddressedAgentSelection({ apiBaseUrl, requestHeaders, storageScope, preferredAgentTypeId, fetch, enabled, }?: UseAddressedAgentSelectionOptions): UseAddressedAgentSelectionResult;
 
 type GatewayResponseErrorCode = AgentGatewayErrorCode | ErrorCode;
 declare class GatewayResponseError extends Error {
@@ -896,7 +932,7 @@ type BoringMessageResponseProps = MessageResponseProps & {
     /** Source path inferred from the preceding write/edit tool call, when known. */
     codeFilename?: string;
 };
-declare const MessageResponse: react.MemoExoticComponent<({ className, shikiTheme, components, codeFilename, ...props }: BoringMessageResponseProps) => react.JSX.Element>;
+declare const MessageResponse: react.MemoExoticComponent<({ className, shikiTheme, components, codeFilename, rehypePlugins, allowedTags, ...props }: BoringMessageResponseProps) => react.JSX.Element>;
 
 type ConversationProps = ComponentProps<typeof StickToBottom> & {
     onScrollToBottomReady?: (scrollToBottom: () => void) => void;
@@ -958,4 +994,4 @@ declare const ToolContent: ({ className, ...props }: ToolContentProps) => react.
 
 declare function cn(...inputs: ClassValue[]): string;
 
-export { type AddressedAgentOption, type AgentCommandContribution, type AgentCommandOptions, type AgentPluginReloadResult, type AvailableModel, BoringChatMessage, ChatEmptyState, type ChatEmptyStateProps, type ChatMessageContribution, type ChatMessageContributionProps, ChatMessageContributionProvider, PiChatPanel as ChatPanel, type PiChatPanelProps as ChatPanelProps, type ChatSuggestion, CodeBlock, type CommandRegistry, type ComposerActionContributionProps, type ComposerBlocker, type ComposerBlockerAction, type ComposerContribution, ComposerContributionProvider, type ComposerDraftUpdate, Conversation, ConversationContent, ConversationScrollButton, DebugDrawer, GatewayResponseError, type GatewayResponseErrorCode, type GroupedToolEntry, Message, MessageAction, MessageActions, MessageContent, MessageResponse, ModelPickerMenu, ModelSelect, ModelSelectTrigger, type ModelSelection, type ParsedCommand, PiChatPanel, type PiChatPanelProps, SessionBrowser as PiSessionBrowser, type PiSessionCreateInit, SessionList as PiSessionList, type PiSessionSearchItem, type PiSessionSearchOptions, type PiSessionSearchSortMode, PromptInput, PromptInputFooter, PromptInputSubmit, PromptInputTextarea, Reasoning, ReasoningContent, ReasoningTrigger, type SessionListProps, type SlashCommand, type SlashCommandContext, type ThinkingLevel, ThinkingSelect, Tool, ToolCallGroup, ToolContent, ToolHeader, type ToolPart$1 as ToolPart, type ToolRenderer, type ToolRendererOverrides, type UploadFileOptions, type UploadFileResult, type UseAddressedAgentSelectionOptions, type UseAddressedAgentSelectionResult, type UsePiSessionsOptions, type UsePiSessionsResult, activeSessionStorageKey, builtinCommands, cn, createCommandRegistry, defaultChatSuggestions, defaultToolRenderers, errorResponseCode, gatewayResponseError, gatewayResponseErrorFromBody, getAgentCommands, matchPiSessionSearch, mergeShadcnToolRenderers, mergeToolRenderers, parsePiSessionSearchQuery, parseSlashCommand, readActiveSessionId, resolveToolRenderer, searchPiSessions, uploadFile, useAddressedAgentSelection, usePiSessions, writeActiveSessionId };
+export { type AddressedAgentOption, type AgentCommandContribution, type AgentCommandOptions, type AgentPluginReloadResult, type AvailableModel, BoringChatMessage, type ChatBeforeSubmitResult, ChatEmptyState, type ChatEmptyStateProps, type ChatMessageContribution, type ChatMessageContributionProps, ChatMessageContributionProvider, PiChatPanel as ChatPanel, type PiChatPanelProps as ChatPanelProps, type ChatSubmitContext, type ChatSuggestion, CodeBlock, type CommandRegistry, type ComposerActionContributionProps, type ComposerBlocker, type ComposerBlockerAction, type ComposerContribution, ComposerContributionProvider, type ComposerDraftUpdate, Conversation, ConversationContent, ConversationScrollButton, DebugDrawer, GatewayResponseError, type GatewayResponseErrorCode, type GroupedToolEntry, Message, MessageAction, MessageActions, MessageContent, MessageResponse, ModelPickerMenu, ModelSelect, ModelSelectTrigger, type ModelSelection, type ParsedCommand, PiChatPanel, type PiChatPanelProps, SessionBrowser as PiSessionBrowser, type PiSessionCreateInit, SessionList as PiSessionList, type PiSessionSearchItem, type PiSessionSearchOptions, type PiSessionSearchSortMode, PromptInput, PromptInputFooter, PromptInputSubmit, PromptInputTextarea, Reasoning, ReasoningContent, ReasoningTrigger, type SessionListProps, type SlashCommand, type SlashCommandContext, type ThinkingLevel, ThinkingSelect, Tool, ToolCallGroup, ToolContent, ToolHeader, type ToolPart$1 as ToolPart, type ToolRenderer, type ToolRendererOverrides, type UploadFileOptions, type UploadFileResult, type UseAddressedAgentSelectionOptions, type UseAddressedAgentSelectionResult, type UsePiSessionsOptions, type UsePiSessionsResult, activeSessionStorageKey, builtinCommands, cn, createCommandRegistry, defaultChatSuggestions, defaultToolRenderers, errorResponseCode, gatewayResponseError, gatewayResponseErrorFromBody, getAgentCommands, matchPiSessionSearch, mergeShadcnToolRenderers, mergeToolRenderers, parsePiSessionSearchQuery, parseSlashCommand, readActiveSessionId, resolveToolRenderer, searchPiSessions, uploadFile, useAddressedAgentSelection, usePiSessions, writeActiveSessionId };