@hachej/boring-agent 0.1.83 → 0.1.84

package/dist/{chunk-TNN3LPXE.js → chunk-2XADUCX7.js}

@@ -5,13 +5,74 @@ import {
   ErrorCode
 } from "./chunk-PG2WOJ22.js";
 
+// src/core/piChatSessionService.ts
+var AgentEffectAdmissionError = class extends Error {
+  constructor(code, details) {
+    super(code);
+    this.code = code;
+    this.details = details;
+    this.name = "AgentEffectAdmissionError";
+  }
+  code;
+  details;
+  statusCode = 500;
+};
+var AGENT_EFFECT_METHODS = {
+  createSession: true,
+  deleteSession: true,
+  prompt: true,
+  followUp: true,
+  clearQueue: true,
+  interrupt: true,
+  stop: true
+};
+function withAgentEffectAdmission(service, admit) {
+  return {
+    ...service.listSessions ? { listSessions: (ctx, options) => service.listSessions(ctx, options) } : {},
+    async createSession(ctx, init) {
+      await admit(ctx);
+      return service.createSession(ctx, init);
+    },
+    async deleteSession(ctx, sessionId) {
+      await admit(ctx);
+      return service.deleteSession(ctx, sessionId);
+    },
+    readState: (ctx, sessionId) => service.readState(ctx, sessionId),
+    subscribe: (ctx, sessionId, cursor, subscriber) => service.subscribe(ctx, sessionId, cursor, subscriber),
+    async prompt(ctx, sessionId, payload) {
+      await admit(ctx);
+      return service.prompt(ctx, sessionId, payload);
+    },
+    async followUp(ctx, sessionId, payload) {
+      await admit(ctx);
+      return service.followUp(ctx, sessionId, payload);
+    },
+    async clearQueue(ctx, sessionId, payload) {
+      await admit(ctx);
+      return service.clearQueue(ctx, sessionId, payload);
+    },
+    async interrupt(ctx, sessionId, payload) {
+      await admit(ctx);
+      return service.interrupt(ctx, sessionId, payload);
+    },
+    async stop(ctx, sessionId, payload) {
+      await admit(ctx);
+      return service.stop(ctx, sessionId, payload);
+    },
+    ...service.dispose ? { dispose: () => service.dispose() } : {}
+  };
+}
+
 // src/core/createAgent.ts
 var DEFAULT_LIVE_BUFFER_SIZE = 1e3;
 function createAgent(config) {
   return createAgentRuntimeBridge(config).agent;
 }
 function createAgentRuntimeBridge(config) {
-  const runtimeLoader = createRuntimeLoader(config.runtimeFactory);
+  const runtimeLoader = createRuntimeLoader(async () => {
+    const runtime = await config.runtimeFactory();
+    return config.admitEffect ? { ...runtime, service: withAgentEffectAdmission(runtime.service, config.admitEffect) } : runtime;
+  });
   const live = new AgentLiveEventBuffer(DEFAULT_LIVE_BUFFER_SIZE);
   const sessionContexts = /* @__PURE__ */ new Map();
   const startedSessions = /* @__PURE__ */ new Map();
@@ -255,7 +316,8 @@ function createFacadeSessionStore(getRuntime, assertActive, live, sessionContext
     },
     async create(ctx, init) {
       assertActive();
-      const created = await (await store()).create(ctx, init);
+      const runtime = await getRuntime();
+      const created = await runtime.service.createSession(toPiRequestContext(ctx), init);
       assertActive();
       rememberSessionCtx(sessionContexts, created.id, ctx);
       return created;
@@ -532,6 +594,9 @@ function createLiveIterator(state, startIndex) {
 }
 
 export {
+  AgentEffectAdmissionError,
+  AGENT_EFFECT_METHODS,
+  withAgentEffectAdmission,
   createAgent,
   createAgentRuntimeBridge
 };

package/dist/{chunk-7V3E6KHX.js → chunk-5IRFVKV7.js}

@@ -13,8 +13,9 @@ import {
   validateTool
 } from "./chunk-WODTQBXR.js";
 import {
+  AgentEffectAdmissionError,
   createAgentRuntimeBridge
-} from "./chunk-TNN3LPXE.js";
+} from "./chunk-2XADUCX7.js";
 import {
   sessionStreamPath
 } from "./chunk-WSQ5QNIY.js";
@@ -8479,6 +8480,7 @@ function createAgentRuntimeBridge2(config, options = {}) {
   }
   return createAgentRuntimeBridge({
     runtimeFactory: () => createRuntime(config, options),
+    admitEffect: options.service?.admitEffect,
     readiness: config.readiness,
     readinessRequirements: config.readinessRequirements
   });
@@ -11874,7 +11876,7 @@ function piChatRoutes(app, opts, done) {
       if (!service.createSession) throw unsupportedServiceMethod("create Pi chat session");
       return reply.code(201).send(await service.createSession(getRequestContext(request), body));
     } catch (err) {
-      return sendRouteError(reply, err, "create pi chat session failed");
+      return sendRouteError(reply, err, "create pi chat session failed", true);
     }
   });
   app.delete("/api/v1/agent/pi-chat/sessions/:sessionId", async (request, reply) => {
@@ -11886,7 +11888,7 @@ function piChatRoutes(app, opts, done) {
       await service.deleteSession(getRequestContext(request), params.sessionId);
       return reply.code(204).send();
     } catch (err) {
-      return sendRouteError(reply, err, "delete pi chat session failed");
+      return sendRouteError(reply, err, "delete pi chat session failed", true);
     }
   });
   app.get("/api/v1/agent/pi-chat/:sessionId/state", async (request, reply) => {
@@ -11977,7 +11979,7 @@ function piChatRoutes(app, opts, done) {
       const receipt = await service.prompt(getRequestContext(request), params.sessionId, body);
       return reply.code(202).send(receipt);
     } catch (err) {
-      return sendRouteError(reply, err, "prompt rejected");
+      return sendRouteError(reply, err, "prompt rejected", true);
     }
   });
   app.post("/api/v1/agent/pi-chat/:sessionId/followup", async (request, reply) => {
@@ -11990,7 +11992,7 @@ function piChatRoutes(app, opts, done) {
       const receipt = await service.followUp(getRequestContext(request), params.sessionId, body);
       return reply.code(202).send(receipt);
     } catch (err) {
-      return sendRouteError(reply, err, "follow-up rejected");
+      return sendRouteError(reply, err, "follow-up rejected", true);
     }
   });
   app.post("/api/v1/agent/pi-chat/:sessionId/queue/clear", async (request, reply) => {
@@ -12003,7 +12005,7 @@ function piChatRoutes(app, opts, done) {
       const receipt = await service.clearQueue(getRequestContext(request), params.sessionId, body);
       return reply.code(202).send(receipt);
     } catch (err) {
-      return sendRouteError(reply, err, "queue clear rejected");
+      return sendRouteError(reply, err, "queue clear rejected", true);
     }
   });
   app.post("/api/v1/agent/pi-chat/:sessionId/interrupt", async (request, reply) => {
@@ -12016,7 +12018,7 @@ function piChatRoutes(app, opts, done) {
       const receipt = await service.interrupt(getRequestContext(request), params.sessionId, body);
       return reply.code(202).send(receipt);
     } catch (err) {
-      return sendRouteError(reply, err, "interrupt rejected");
+      return sendRouteError(reply, err, "interrupt rejected", true);
     }
   });
   app.post("/api/v1/agent/pi-chat/:sessionId/stop", async (request, reply) => {
@@ -12029,7 +12031,7 @@ function piChatRoutes(app, opts, done) {
       const receipt = await service.stop(getRequestContext(request), params.sessionId, body);
       return reply.code(202).send(receipt);
     } catch (err) {
-      return sendRouteError(reply, err, "stop rejected");
+      return sendRouteError(reply, err, "stop rejected", true);
     }
   });
   done();
@@ -12115,17 +12117,19 @@ function sendReplayRangeError(reply, error) {
     }
   });
 }
-function sendRouteError(reply, err, fallbackMessage) {
+function sendRouteError(reply, err, fallbackMessage, preserveAdmissionError = false) {
   const statusCode = statusCodeFromError(err);
   const parsedCode = ErrorCode.safeParse(err?.code);
-  const code = parsedCode.success ? parsedCode.data : ErrorCode.enum.INTERNAL_ERROR;
-  const message = err instanceof Error ? err.message : fallbackMessage;
+  const admissionError = preserveAdmissionError && err instanceof AgentEffectAdmissionError;
+  const rejectedAdmissionError = !preserveAdmissionError && err instanceof AgentEffectAdmissionError;
+  const code = admissionError ? err.code : parsedCode.success ? parsedCode.data : ErrorCode.enum.INTERNAL_ERROR;
+  const message = !rejectedAdmissionError && err instanceof Error ? err.message : fallbackMessage;
   return reply.code(statusCode).send({
     error: {
       code,
       message,
       retryable: err?.retryable === true ? true : void 0,
-      details: err?.details
+      details: rejectedAdmissionError ? void 0 : err?.details
     }
   });
 }
@@ -12364,7 +12368,7 @@ function meteredCommandBlocked(command) {
 }
 function stableErrorPayload(error, message) {
   const code = error?.code;
-  if (!isErrorCode(code)) return void 0;
+  if (!isErrorCode(code) && !(error instanceof AgentEffectAdmissionError)) return void 0;
   const details = error?.details;
   return {
     error: {
@@ -12412,6 +12416,7 @@ function commandsRoutes(app, opts, done) {
       if (meteringActive) {
         return reply.code(409).send(meteredCommandBlocked(name));
       }
+      await opts.admitEffect?.({ workspaceId: getRequestWorkspaceId(request), requestId: request.id });
       await harness.executeSlashCommand(sessionId, name, args, runContext);
       return reply.code(200).send({ ok: true });
     } catch (error) {
@@ -14039,6 +14044,7 @@ var registerAgentRoutes = async (app, opts) => {
       workdir: root
     }, {
       service: {
+        admitEffect: opts.admitEffect,
         workdir: runtimeBundle.workspace.root,
         workspace: runtimeBundle.workspace
       }
@@ -14427,6 +14433,7 @@ var registerAgentRoutes = async (app, opts) => {
       return reply.status(501).send({ ok: false, error: "Agent harness does not support reload" });
     }
     try {
+      await opts.admitEffect?.({ workspaceId, requestId: request.id });
       await binding.reprovision(request);
       binding.assertActive();
       const hookResult = await opts.beforeReload?.({
@@ -14464,6 +14471,9 @@ var registerAgentRoutes = async (app, opts) => {
       };
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);
+      if (error instanceof AgentEffectAdmissionError) {
+        return reply.status(error.statusCode).send({ ok: false, error: { code: error.code, message } });
+      }
       return reply.status(422).send({ ok: false, error: message });
     }
   });
@@ -14477,12 +14487,14 @@ var registerAgentRoutes = async (app, opts) => {
       harness: staticBinding.harness,
       defaultSessionId: sessionId,
       workdir: staticBinding.runtimeBundle.workspace.root,
-      metering: opts.metering
+      metering: opts.metering,
+      admitEffect: opts.admitEffect
     } : {
       defaultSessionId: sessionId,
       getHarness: async (request) => (await getBindingForRequest(request)).harness,
       getWorkdir: async (request) => (await getBindingForRequest(request)).runtimeBundle.workspace.root,
-      metering: opts.metering
+      metering: opts.metering,
+      admitEffect: opts.admitEffect
     }
   );
   await app.register(

package/dist/core/index.d.ts

@@ -1,56 +1,11 @@
-import { A as AgentHarness, a as AgentReadiness, b as Agent } from '../harness-C53mjCcq.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-C53mjCcq.js';
-import { S as SessionListOptions, a as SessionSummary, C as ChatModelSelection, P as PiChatSnapshot, b as PiChatEvent, c as PromptPayload, d as PromptReceipt, F as FollowUpPayload, e as FollowUpReceipt, Q as QueueClearPayload, f as QueueClearReceipt, I as InterruptPayload, g as CommandReceipt, h as StopPayload, i as StopReceipt, j as SessionStore } from '../piChatEvent-3pFPXYPx.js';
+import { A as AgentHarness, a as AgentReadiness, b as Agent } from '../harness-Dtu-WAXy.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-Dtu-WAXy.js';
+import { S as SessionStore } from '../piChatEvent-DLa8CgFa.js';
+import { A as AgentCoreSessionService, a as AgentEffectAdmission } from '../piChatSessionService-BuPaMB7k.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-BuPaMB7k.js';
 import '@mariozechner/pi-coding-agent';
 import 'zod';
 
-interface PiSessionRequestContext {
-    workspaceId?: string;
-    storageScope?: string;
-    authSubject?: string;
-    authEmail?: string;
-    authEmailVerified?: boolean;
-    requestId: string;
-}
-interface PiSessionCreateInit {
-    title?: string;
-    modelDefault?: ChatModelSelection;
-}
-type PiChatReplayRangeError = {
-    type: 'replay_gap';
-    latestSeq: number;
-    minReplaySeq: number;
-} | {
-    type: 'cursor_ahead';
-    latestSeq: number;
-    minReplaySeq: number;
-};
-interface PiChatEventStreamSubscription {
-    type: 'ok';
-    unsubscribe: () => void;
-    /** Optional test/service completion hook. Real live streams normally omit it. */
-    closed?: Promise<void>;
-}
-type PiChatEventStreamResult = PiChatEventStreamSubscription | PiChatReplayRangeError;
-type PiChatEventSubscriber = (event: PiChatEvent) => void;
-interface PiChatSessionService {
-    listSessions?(ctx: PiSessionRequestContext, options?: SessionListOptions): Promise<SessionSummary[]>;
-    createSession?(ctx: PiSessionRequestContext, init?: PiSessionCreateInit): Promise<SessionSummary>;
-    deleteSession?(ctx: PiSessionRequestContext, sessionId: string): Promise<void>;
-    readState(ctx: PiSessionRequestContext, sessionId: string): Promise<PiChatSnapshot>;
-    subscribe(ctx: PiSessionRequestContext, sessionId: string, cursor: number, subscriber: PiChatEventSubscriber): Promise<PiChatEventStreamResult>;
-    prompt(ctx: PiSessionRequestContext, sessionId: string, payload: PromptPayload): Promise<PromptReceipt>;
-    followUp(ctx: PiSessionRequestContext, sessionId: string, payload: FollowUpPayload): Promise<FollowUpReceipt>;
-    clearQueue(ctx: PiSessionRequestContext, sessionId: string, payload: QueueClearPayload): Promise<QueueClearReceipt>;
-    interrupt(ctx: PiSessionRequestContext, sessionId: string, payload: InterruptPayload): Promise<CommandReceipt>;
-    stop(ctx: PiSessionRequestContext, sessionId: string, payload: StopPayload): Promise<StopReceipt>;
-}
-interface AgentCoreSessionService extends PiChatSessionService {
-    createSession(ctx: PiSessionRequestContext, init?: PiSessionCreateInit): Promise<SessionSummary>;
-    deleteSession(ctx: PiSessionRequestContext, sessionId: string): Promise<void>;
-    dispose?(): Promise<void>;
-}
-
 interface AgentCoreRuntime {
     harness: AgentHarness;
     sessionStore: SessionStore;
@@ -59,6 +14,7 @@ interface AgentCoreRuntime {
 type AgentCoreRuntimeFactory = () => AgentCoreRuntime | Promise<AgentCoreRuntime>;
 interface AgentCoreConfig {
     runtimeFactory: AgentCoreRuntimeFactory;
+    admitEffect?: AgentEffectAdmission;
     readiness?: AgentReadiness;
     readinessRequirements?: string[];
 }
@@ -69,4 +25,4 @@ interface AgentCoreRuntimeView {
 }
 declare function createAgent(config: AgentCoreConfig): Agent;
 
-export { Agent, type AgentCoreConfig, type AgentCoreRuntime, type AgentCoreRuntimeFactory, type AgentCoreRuntimeView, type AgentCoreSessionService, AgentReadiness, type PiChatEventStreamResult, type PiChatEventStreamSubscription, type PiChatEventSubscriber, type PiChatReplayRangeError, type PiChatSessionService, type PiSessionCreateInit, type PiSessionRequestContext, createAgent };
+export { Agent, type AgentCoreConfig, type AgentCoreRuntime, type AgentCoreRuntimeFactory, type AgentCoreRuntimeView, AgentCoreSessionService, AgentEffectAdmission, AgentReadiness, createAgent };

package/dist/core/index.js

@@ -1,13 +1,19 @@
 import {
-  createAgent
-} from "../chunk-TNN3LPXE.js";
+  AGENT_EFFECT_METHODS,
+  AgentEffectAdmissionError,
+  createAgent,
+  withAgentEffectAdmission
+} from "../chunk-2XADUCX7.js";
 import {
   AGENT_NOT_IMPLEMENTED_UNTIL_T1,
   AgentNotImplementedError
 } from "../chunk-WSQ5QNIY.js";
 import "../chunk-PG2WOJ22.js";
 export {
+  AGENT_EFFECT_METHODS,
   AGENT_NOT_IMPLEMENTED_UNTIL_T1,
+  AgentEffectAdmissionError,
   AgentNotImplementedError,
-  createAgent
+  createAgent,
+  withAgentEffectAdmission
 };

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, k as BoringChatMessage, l as PiChatStatus, m as QueuedUserMessage, n as ChatError, b as PiChatEvent, c as PromptPayload, d as PromptReceipt, F as FollowUpPayload, e as FollowUpReceipt, Q as QueueClearPayload, f as QueueClearReceipt, I as InterruptPayload, g as CommandReceipt, h as StopPayload, i as StopReceipt, a as SessionSummary } from '../piChatEvent-3pFPXYPx.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-DLa8CgFa.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';

package/dist/{harness-C53mjCcq.d.ts → harness-Dtu-WAXy.d.ts}

@@ -1,4 +1,4 @@
-import { o as SessionCtx, b as PiChatEvent, j as SessionStore } from './piChatEvent-3pFPXYPx.js';
+import { l as SessionCtx, b as PiChatEvent, S as SessionStore } from './piChatEvent-DLa8CgFa.js';
 import { AgentSessionEvent, PromptOptions } from '@mariozechner/pi-coding-agent';
 
 interface TelemetrySink {

package/dist/{piChatEvent-3pFPXYPx.d.ts → piChatEvent-DLa8CgFa.d.ts}

@@ -364,4 +364,4 @@ interface PiChatHeartbeatFrame {
 }
 type PiChatStreamFrame = PiChatEvent | PiChatHeartbeatFrame;
 
-export { AgentConsumptionErrorCode as A, type BoringChatPart as B, type ChatModelSelection as C, type InterruptReceipt as D, ErrorCode as E, type FollowUpPayload as F, type PiChatHeartbeatFrame as G, type PiChatStreamFrame as H, type InterruptPayload as I, type SessionDetail as J, type ThinkingLevel as K, extractToolUiMetadata as L, isToolUiMetadata as M, type PiChatSnapshot as P, type QueueClearPayload as Q, type SessionListOptions as S, type ToolUiMetadata as T, type SessionSummary as a, type PiChatEvent as b, type PromptPayload as c, type PromptReceipt as d, type FollowUpReceipt as e, type QueueClearReceipt as f, type CommandReceipt as g, type StopPayload as h, type StopReceipt as i, type SessionStore as j, type BoringChatMessage as k, type PiChatStatus as l, type QueuedUserMessage as m, type ChatError as n, type SessionCtx as o, AgentDefinitionErrorCode as p, AgentDeploymentErrorCode as q, type ApiErrorPayload as r, ApiErrorPayloadSchema as s, type ApiErrorResponse as t, ApiErrorResponseSchema as u, type ChatAttachmentPayload as v, type ChatSubmitPayload as w, ERROR_CODES as x, type ErrorLogFields as y, ErrorLogFieldsSchema as z };
+export { AgentConsumptionErrorCode as A, type BoringChatPart as B, type ChatError as C, type InterruptReceipt as D, ErrorCode as E, type FollowUpPayload as F, type PiChatHeartbeatFrame as G, type PiChatStreamFrame as H, type InterruptPayload as I, type SessionDetail as J, type ThinkingLevel as K, extractToolUiMetadata as L, isToolUiMetadata as M, type PiChatStatus as P, type QueuedUserMessage as Q, type SessionStore as S, type ToolUiMetadata as T, type BoringChatMessage as a, type PiChatEvent as b, type PromptPayload as c, type PromptReceipt as d, type FollowUpReceipt as e, type QueueClearPayload as f, type QueueClearReceipt as g, type CommandReceipt as h, type StopPayload as i, type StopReceipt as j, type SessionSummary as k, type SessionCtx as l, type ChatModelSelection as m, type SessionListOptions as n, type PiChatSnapshot as o, AgentDefinitionErrorCode as p, AgentDeploymentErrorCode as q, type ApiErrorPayload as r, ApiErrorPayloadSchema as s, type ApiErrorResponse as t, ApiErrorResponseSchema as u, type ChatAttachmentPayload as v, type ChatSubmitPayload as w, ERROR_CODES as x, type ErrorLogFields as y, ErrorLogFieldsSchema as z };

package/dist/piChatSessionService-BuPaMB7k.d.ts

@@ -0,0 +1,67 @@
+import { n as SessionListOptions, k as SessionSummary, m as ChatModelSelection, o as PiChatSnapshot, 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 } from './piChatEvent-DLa8CgFa.js';
+
+interface PiSessionRequestContext {
+    workspaceId?: string;
+    storageScope?: string;
+    authSubject?: string;
+    authEmail?: string;
+    authEmailVerified?: boolean;
+    requestId: string;
+}
+interface PiSessionCreateInit {
+    title?: string;
+    modelDefault?: ChatModelSelection;
+}
+type PiChatReplayRangeError = {
+    type: 'replay_gap';
+    latestSeq: number;
+    minReplaySeq: number;
+} | {
+    type: 'cursor_ahead';
+    latestSeq: number;
+    minReplaySeq: number;
+};
+interface PiChatEventStreamSubscription {
+    type: 'ok';
+    unsubscribe: () => void;
+    /** Optional test/service completion hook. Real live streams normally omit it. */
+    closed?: Promise<void>;
+}
+type PiChatEventStreamResult = PiChatEventStreamSubscription | PiChatReplayRangeError;
+type PiChatEventSubscriber = (event: PiChatEvent) => void;
+interface PiChatSessionService {
+    listSessions?(ctx: PiSessionRequestContext, options?: SessionListOptions): Promise<SessionSummary[]>;
+    createSession?(ctx: PiSessionRequestContext, init?: PiSessionCreateInit): Promise<SessionSummary>;
+    deleteSession?(ctx: PiSessionRequestContext, sessionId: string): Promise<void>;
+    readState(ctx: PiSessionRequestContext, sessionId: string): Promise<PiChatSnapshot>;
+    subscribe(ctx: PiSessionRequestContext, sessionId: string, cursor: number, subscriber: PiChatEventSubscriber): Promise<PiChatEventStreamResult>;
+    prompt(ctx: PiSessionRequestContext, sessionId: string, payload: PromptPayload): Promise<PromptReceipt>;
+    followUp(ctx: PiSessionRequestContext, sessionId: string, payload: FollowUpPayload): Promise<FollowUpReceipt>;
+    clearQueue(ctx: PiSessionRequestContext, sessionId: string, payload: QueueClearPayload): Promise<QueueClearReceipt>;
+    interrupt(ctx: PiSessionRequestContext, sessionId: string, payload: InterruptPayload): Promise<CommandReceipt>;
+    stop(ctx: PiSessionRequestContext, sessionId: string, payload: StopPayload): Promise<StopReceipt>;
+}
+interface AgentCoreSessionService extends PiChatSessionService {
+    createSession(ctx: PiSessionRequestContext, init?: PiSessionCreateInit): Promise<SessionSummary>;
+    deleteSession(ctx: PiSessionRequestContext, sessionId: string): Promise<void>;
+    dispose?(): Promise<void>;
+}
+type AgentEffectAdmission = (ctx: Pick<PiSessionRequestContext, 'workspaceId' | 'requestId'>) => Promise<void>;
+declare class AgentEffectAdmissionError extends Error {
+    readonly code: string;
+    readonly details?: unknown | undefined;
+    readonly statusCode = 500;
+    constructor(code: string, details?: unknown | undefined);
+}
+declare const AGENT_EFFECT_METHODS: {
+    readonly createSession: true;
+    readonly deleteSession: true;
+    readonly prompt: true;
+    readonly followUp: true;
+    readonly clearQueue: true;
+    readonly interrupt: true;
+    readonly stop: true;
+};
+declare function withAgentEffectAdmission(service: AgentCoreSessionService, admit: AgentEffectAdmission): AgentCoreSessionService;
+
+export { type AgentCoreSessionService as A, type PiChatEventStreamResult as P, type AgentEffectAdmission as a, AGENT_EFFECT_METHODS as b, AgentEffectAdmissionError as c, type PiChatEventStreamSubscription as d, type PiChatEventSubscriber as e, type PiChatReplayRangeError as f, type PiChatSessionService as g, type PiSessionCreateInit as h, type PiSessionRequestContext as i, withAgentEffectAdmission as w };

package/dist/server/index.d.ts

@@ -1,15 +1,16 @@
 import { W as WorkspaceRuntimeContext, S as Sandbox, a as Workspace, E as ExecOptions, b as ExecResult, c as WorkspaceChangeEvent } from '../sandbox-DthfJaOB.js';
 import { R as RemoteWorkerWorkspaceOp, a as RemoteWorkerWorkspaceResult, b as RemoteWorkerExecRequest } from '../protocol-B_OQKfbI.js';
 export { B as BwrapResourceLimits, C as CreateBwrapSandboxOptions, c as REMOTE_WORKER_PROVIDER, d as REMOTE_WORKER_RUNTIME_CWD, e as RemoteWorkerErrorPayload, f as RemoteWorkerExecResponse, g as RemoteWorkerFsEventEnvelope, W as WORKER_INTERNAL_TOKEN_HEADER, h as WORKER_REQUEST_ID_HEADER, i as WORKER_WORKSPACE_ID_HEADER, j as createBwrapSandbox } from '../protocol-B_OQKfbI.js';
-import { S as SandboxHandleStore, a as SandboxHandleRecord, F as FileSearch, C as CompiledAgentBundle, b as Sha256Digest, A as AgentDeployment, P as PluginRestartWarning, W as WorkspaceAgentDispatcherContext, c as WorkspaceAgentDispatcher } from '../workspaceAgentDispatcher-p4tlVvbM.js';
+import { S as SandboxHandleStore, a as SandboxHandleRecord, F as FileSearch, C as CompiledAgentBundle, b as Sha256Digest, A as AgentDeployment, P as PluginRestartWarning, W as WorkspaceAgentDispatcherContext, c as WorkspaceAgentDispatcher } from '../workspaceAgentDispatcher-CBN2xxaH.js';
 import { Sandbox as Sandbox$1 } from '@vercel/sandbox';
-import { T as TelemetrySink, s as ToolReadinessRequirement, t as AgentConfig, b as Agent, d as AgentActor, j as AgentEvent, u as AgentTool, v as AgentHarnessFactory } from '../harness-C53mjCcq.js';
-export { w as AgentHarnessFactoryInput } from '../harness-C53mjCcq.js';
+import { T as TelemetrySink, s as ToolReadinessRequirement, t as AgentConfig, b as Agent, d as AgentActor, j as AgentEvent, u as AgentTool, v as AgentHarnessFactory } from '../harness-Dtu-WAXy.js';
+export { w as AgentHarnessFactoryInput } from '../harness-Dtu-WAXy.js';
 import { FastifyInstance, FastifyRequest, FastifyPluginAsync } from 'fastify';
-import { E as ErrorCode, o as SessionCtx, C as ChatModelSelection } from '../piChatEvent-3pFPXYPx.js';
+import { E as ErrorCode, l as SessionCtx, m as ChatModelSelection } from '../piChatEvent-DLa8CgFa.js';
 import { IncomingMessage, ServerResponse } from 'node:http';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { PackageSource, ExtensionFactory, SettingsManager } from '@mariozechner/pi-coding-agent';
+import { a as AgentEffectAdmission } from '../piChatSessionService-BuPaMB7k.js';
 import 'zod';
 
 interface CreateDirectSandboxOptions {
@@ -1282,6 +1283,8 @@ interface RegisterAgentRoutesOptions {
     sessionRoot?: string;
     /** Optional best-effort telemetry sink supplied by an embedding host. */
     telemetry?: TelemetrySink;
+    /** Optional host admission called immediately before each agent effect. */
+    admitEffect?: AgentEffectAdmission;
     /** Generic request-aware model filtering seam. Hosts may filter per user/workspace. */
     filterModels?: ModelsRoutesOptions['filterModels'];
     /** Generic per-request/per-run filesystem binding seam. Hosts may return user/session-filtered bindings. */

package/dist/server/index.js

@@ -54,9 +54,9 @@ import {
   resolveAgentDeployment,
   resolveMode,
   resolveSandboxHandle
-} from "../chunk-7V3E6KHX.js";
+} from "../chunk-5IRFVKV7.js";
 import "../chunk-WODTQBXR.js";
-import "../chunk-TNN3LPXE.js";
+import "../chunk-2XADUCX7.js";
 import "../chunk-WSQ5QNIY.js";
 import "../chunk-DC3S7SZG.js";
 import {

package/dist/server/worker/index.js

@@ -4,9 +4,9 @@ import {
   constantTimeTokenEqual,
   createBwrapSandbox,
   createNodeWorkspace
-} from "../../chunk-7V3E6KHX.js";
+} from "../../chunk-5IRFVKV7.js";
 import "../../chunk-WODTQBXR.js";
-import "../../chunk-TNN3LPXE.js";
+import "../../chunk-2XADUCX7.js";
 import "../../chunk-WSQ5QNIY.js";
 import "../../chunk-DC3S7SZG.js";
 import "../../chunk-5NAN3TAR.js";

package/dist/shared/index.d.ts

@@ -1,11 +1,11 @@
-import { u as AgentTool } from '../harness-C53mjCcq.js';
-export { c as AGENT_NOT_IMPLEMENTED_UNTIL_T1, b as Agent, d as AgentActor, e as AgentCoreHarness, f as AgentCoreHarnessFactory, g as AgentCorePromptInput, h as AgentCoreSessionAdapter, i as AgentCoreSessionSnapshot, j as AgentEvent, A as AgentHarness, k as AgentMessageContent, l as AgentMessagePart, m as AgentNotImplementedError, a as AgentReadiness, n as AgentReadinessStatus, o as AgentResolveInputResponse, x as AgentRuntimeAdapter, p as AgentSendInput, q as AgentStartReceipt, r as AgentStreamOptions, t as CoreAgentConfig, J as JSONSchema, M as MessageAttachment, R as RunContext, S as SendMessageInput, y as TelemetryEvent, T as TelemetrySink, z as ToolExecContext, B as ToolResult, C as noopTelemetry, D as safeCapture, E as sessionStreamPath } from '../harness-C53mjCcq.js';
-import { F as FileSearch, d as SchemaValidationError, e as AgentSchemaIssue, f as AgentSchemaValidationResult } from '../workspaceAgentDispatcher-p4tlVvbM.js';
-export { g as AgentDefinition, h as AgentDefinitionDigestAsset, i as AgentDefinitionReference, j as AgentDefinitionValidationError, A as AgentDeployment, k as AgentDeploymentValidationError, l as CommandNotifyPayload, C as CompiledAgentBundle, m as CompiledAgentDefinition, O as OpaqueRefSchema, a as SandboxHandleRecord, S as SandboxHandleStore, b as Sha256Digest, n as Sha256DigestSchema, o as WORKSPACE_AGENT_PLUGINS_RELOADED_EVENT, p as WORKSPACE_COMMAND_NOTIFY_EVENT, c as WorkspaceAgentDispatcher, W as WorkspaceAgentDispatcherContext, q as WorkspaceAgentDispatcherSendInput, r as createAgentAssetDigest, s as createAgentDefinitionDigest, t as createAgentDeploymentDigest, v as validateAgentDefinition, u as validateAgentDeployment } from '../workspaceAgentDispatcher-p4tlVvbM.js';
+import { u as AgentTool } from '../harness-Dtu-WAXy.js';
+export { c as AGENT_NOT_IMPLEMENTED_UNTIL_T1, b as Agent, d as AgentActor, e as AgentCoreHarness, f as AgentCoreHarnessFactory, g as AgentCorePromptInput, h as AgentCoreSessionAdapter, i as AgentCoreSessionSnapshot, j as AgentEvent, A as AgentHarness, k as AgentMessageContent, l as AgentMessagePart, m as AgentNotImplementedError, a as AgentReadiness, n as AgentReadinessStatus, o as AgentResolveInputResponse, x as AgentRuntimeAdapter, p as AgentSendInput, q as AgentStartReceipt, r as AgentStreamOptions, t as CoreAgentConfig, J as JSONSchema, M as MessageAttachment, R as RunContext, S as SendMessageInput, y as TelemetryEvent, T as TelemetrySink, z as ToolExecContext, B as ToolResult, C as noopTelemetry, D as safeCapture, E as sessionStreamPath } from '../harness-Dtu-WAXy.js';
+import { F as FileSearch, d as SchemaValidationError, e as AgentSchemaIssue, f as AgentSchemaValidationResult } from '../workspaceAgentDispatcher-CBN2xxaH.js';
+export { g as AgentDefinition, h as AgentDefinitionDigestAsset, i as AgentDefinitionReference, j as AgentDefinitionValidationError, A as AgentDeployment, k as AgentDeploymentValidationError, l as CommandNotifyPayload, C as CompiledAgentBundle, m as CompiledAgentDefinition, O as OpaqueRefSchema, a as SandboxHandleRecord, S as SandboxHandleStore, b as Sha256Digest, n as Sha256DigestSchema, o as WORKSPACE_AGENT_PLUGINS_RELOADED_EVENT, p as WORKSPACE_COMMAND_NOTIFY_EVENT, c as WorkspaceAgentDispatcher, W as WorkspaceAgentDispatcherContext, q as WorkspaceAgentDispatcherSendInput, r as createAgentAssetDigest, s as createAgentDefinitionDigest, t as createAgentDeploymentDigest, v as validateAgentDefinition, u as validateAgentDeployment } from '../workspaceAgentDispatcher-CBN2xxaH.js';
 import { a as Workspace, S as Sandbox } from '../sandbox-DthfJaOB.js';
 export { e as Entry, E as ExecOptions, b as ExecResult, I as IsolatedCodeInput, f as IsolatedCodeOutput, g as SandboxCapability, d as Stat, W as WorkspaceRuntimeContext } from '../sandbox-DthfJaOB.js';
-import { B as BoringChatPart, T as ToolUiMetadata, A as AgentConsumptionErrorCode } from '../piChatEvent-3pFPXYPx.js';
-export { p as AgentDefinitionErrorCode, q as AgentDeploymentErrorCode, r as ApiErrorPayload, s as ApiErrorPayloadSchema, t as ApiErrorResponse, u as ApiErrorResponseSchema, k as BoringChatMessage, v as ChatAttachmentPayload, n as ChatError, C as ChatModelSelection, w as ChatSubmitPayload, g as CommandReceipt, x as ERROR_CODES, E as ErrorCode, y as ErrorLogFields, z as ErrorLogFieldsSchema, F as FollowUpPayload, e as FollowUpReceipt, I as InterruptPayload, D as InterruptReceipt, b as PiChatEvent, G as PiChatHeartbeatFrame, P as PiChatSnapshot, l as PiChatStatus, H as PiChatStreamFrame, c as PromptPayload, d as PromptReceipt, Q as QueueClearPayload, f as QueueClearReceipt, m as QueuedUserMessage, o as SessionCtx, J as SessionDetail, j as SessionStore, a as SessionSummary, h as StopPayload, i as StopReceipt, K as ThinkingLevel, L as extractToolUiMetadata, M as isToolUiMetadata } from '../piChatEvent-3pFPXYPx.js';
+import { B as BoringChatPart, T as ToolUiMetadata, A as AgentConsumptionErrorCode } from '../piChatEvent-DLa8CgFa.js';
+export { p as AgentDefinitionErrorCode, q as AgentDeploymentErrorCode, r as ApiErrorPayload, s as ApiErrorPayloadSchema, t as ApiErrorResponse, u as ApiErrorResponseSchema, a as BoringChatMessage, v as ChatAttachmentPayload, C as ChatError, m as ChatModelSelection, w as ChatSubmitPayload, h as CommandReceipt, x as ERROR_CODES, E as ErrorCode, y as ErrorLogFields, z as ErrorLogFieldsSchema, F as FollowUpPayload, e as FollowUpReceipt, I as InterruptPayload, D as InterruptReceipt, b as PiChatEvent, G as PiChatHeartbeatFrame, o as PiChatSnapshot, P as PiChatStatus, H as PiChatStreamFrame, c as PromptPayload, d as PromptReceipt, f as QueueClearPayload, g as QueueClearReceipt, Q as QueuedUserMessage, l as SessionCtx, J as SessionDetail, S as SessionStore, k as SessionSummary, i as StopPayload, j as StopReceipt, K as ThinkingLevel, L as extractToolUiMetadata, M as isToolUiMetadata } from '../piChatEvent-DLa8CgFa.js';
 import { z } from 'zod';
 import '@mariozechner/pi-coding-agent';
 

package/dist/{workspaceAgentDispatcher-p4tlVvbM.d.ts → workspaceAgentDispatcher-CBN2xxaH.d.ts}

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { p as AgentDefinitionErrorCode, q as AgentDeploymentErrorCode, D as InterruptReceipt, i as StopReceipt } from './piChatEvent-3pFPXYPx.js';
-import { p as AgentSendInput, j as AgentEvent } from './harness-C53mjCcq.js';
+import { p as AgentDefinitionErrorCode, q as AgentDeploymentErrorCode, D as InterruptReceipt, j as StopReceipt } from './piChatEvent-DLa8CgFa.js';
+import { p as AgentSendInput, j as AgentEvent } from './harness-Dtu-WAXy.js';
 
 interface SandboxHandleRecord {
     workspaceId: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hachej/boring-agent",
-  "version": "0.1.83",
+  "version": "0.1.84",
   "type": "module",
   "license": "MIT",
   "description": "Pane-embeddable coding agent. Ships direct/local/vercel-sandbox execution modes behind one interface.",
@@ -84,7 +84,7 @@
     "use-stick-to-bottom": "^1.1.6",
     "yaml": "^2.9.0",
     "zod": "^3.25.76",
-    "@hachej/boring-ui-kit": "0.1.83"
+    "@hachej/boring-ui-kit": "0.1.84"
   },
   "devDependencies": {
     "@antithesishq/bombadil": "0.6.1",