@hachej/boring-agent 0.1.83 → 0.1.85

package/dist/piChatSessionService-iBtx32ya.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-CUTKRaZD.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, c as ShareEntryStore, P as PluginRestartWarning, W as WorkspaceAgentDispatcherContext, d as WorkspaceAgentDispatcher } from '../workspaceAgentDispatcher-Dv0DocrE.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-RhGbdGWY.js';
+export { w as AgentHarnessFactoryInput } from '../harness-RhGbdGWY.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-CUTKRaZD.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-iBtx32ya.js';
 import 'zod';
 
 interface CreateDirectSandboxOptions {
@@ -897,6 +898,19 @@ interface ManagedAgentMcpPresentationOptions {
     name?: string;
     version?: string;
     maxBriefChars?: number;
+    /**
+     * Optional Lane W (AR1-002/AR1-004) share-entry store. When supplied
+     * together with `resolveShareSessionCtx`/`resolveShareWorkspace`, the
+     * server exposes `listResources`/`readResource` scoped to the
+     * authenticated workspace's share entries, on this SAME MCP server
+     * process (no second MCP runtime owner). Hosts that omit any of the
+     * three leave Lane W unmounted — no widening.
+     */
+    shareEntryStore?: ShareEntryStore;
+    /** Resolves the authenticated SessionCtx for a share resource request. */
+    resolveShareSessionCtx?: (request: ManagedAgentDelegateRequestContext) => SessionCtx | Promise<SessionCtx>;
+    /** Resolves the authorized Workspace to read share targets from, for a given SessionCtx. */
+    resolveShareWorkspace?: (ctx: SessionCtx) => Workspace | Promise<Workspace>;
 }
 interface ManagedAgentMcpServerOptions extends ManagedAgentMcpDelegateOptions, ManagedAgentMcpPresentationOptions {
 }
@@ -908,6 +922,24 @@ type ManagedAgentMcpHttpHandlerOptions = (ManagedAgentMcpPresentationOptions & {
 declare function createManagedAgentMcpServer(options: ManagedAgentMcpServerOptions): McpServer;
 declare function createManagedAgentMcpHttpHandler(options: ManagedAgentMcpHttpHandlerOptions): (req: IncomingMessage, res: ServerResponse, parsedBody?: unknown) => Promise<void>;
 
+interface ShareEntryMcpResourceOptions {
+    /** Lane W (AR1-002) opaque share-entry store — the single source of truth for entries. */
+    store: ShareEntryStore;
+    /** Resolves the authenticated SessionCtx for a resource request (list or read). */
+    resolveSessionCtx(request: ManagedAgentDelegateRequestContext): SessionCtx | Promise<SessionCtx>;
+    /** Resolves the authorized Workspace to read share targets from, for a given SessionCtx. */
+    resolveWorkspace(ctx: SessionCtx): Workspace | Promise<Workspace>;
+}
+/** Builds the opaque share resource URI for a given share-entry id. */
+declare function shareResourceUri(id: string): string;
+/**
+ * Registers `listResources`/`readResource` for Lane W share entries on an
+ * already-constructed managed-agent `McpServer`. A no-op call site (host
+ * omits `shareEntryStore`) leaves Lane W unmounted — see
+ * `managedAgentMcpServer.ts`'s optional wiring.
+ */
+declare function registerShareEntryResources(server: McpServer, options: ShareEntryMcpResourceOptions): void;
+
 interface ReloadHookDiagnostic {
     source: string;
     message: string;
@@ -1282,6 +1314,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. */
@@ -1317,6 +1351,14 @@ interface RegisterAgentRoutesOptions {
     }) => string | undefined | Promise<string | undefined>;
     registerHealthRoute?: boolean;
     sandboxHandleStore?: SandboxHandleStore;
+    /**
+     * Optional Lane W share-entry store (AR1-002/AR1-003, same-workspace
+     * shareable links, `docs/issues/391/runtime-refactor/work/
+     * AR1-shareable-artifacts/AR1-001-SPEC.md` §3). When supplied, mounts the
+     * membership-gated `GET /a/:id` deep-link route. Omit to leave Lane W
+     * entirely unmounted (no widening for hosts that don't use it yet).
+     */
+    shareEntryStore?: ShareEntryStore;
     getWorkspaceId?: (request: FastifyRequest) => string | Promise<string>;
     getWorkspaceRoot?: (workspaceId: string, request: FastifyRequest) => string | Promise<string>;
     getTrustedWorkspaceRoot?: (ctx: WorkspaceAgentDispatcherContext) => string | Promise<string>;
@@ -1383,4 +1425,4 @@ interface Logger {
 }
 declare function createLogger(prefix: string): Logger;
 
-export { AgentConfig, AgentDirectoryCompilerError, type AgentDirectoryCompilerErrorCode, type AgentDirectoryCompilerPublicErrorCode, AgentHarnessFactory, type AgentMeteringSink, type BoringAgentRuntimePaths, type BuiltinRuntimeModeId, type CreateAgentAppOptions, type CreateVercelProvisioningAdapterOptions, type DeploymentSnapshotProvider, type DeploymentSnapshotRecipe, type DeploymentSnapshotResult, type DeploymentSnapshotStatus, FileHandleStore, type LogFields, type Logger, MANAGED_AGENT_MCP_DELIVERY_RULE, MANAGED_AGENT_MCP_ORIGIN_SURFACE, type ManagedAgentArtifact, type ManagedAgentArtifactCandidate, type ManagedAgentArtifactRef, type ManagedAgentBoundRunnerWorkspace, type ManagedAgentCollectArtifactsInput, type ManagedAgentDelegateInput, type ManagedAgentDelegateProgress, type ManagedAgentDelegateRequestContext, type ManagedAgentDelegateResult, type ManagedAgentDelegateRunInput, type ManagedAgentDelegateRunner, type ManagedAgentDelegateStatus, type ManagedAgentDelegateStatusResult, ManagedAgentMcpDelegateController, type ManagedAgentMcpDelegateOptions, ManagedAgentMcpError, type ManagedAgentMcpHttpHandlerOptions, type ManagedAgentMcpServerOptions, type ManagedAgentSafeError, type ManagedAgentWorkspaceResolutionInput, type MeteringErrorLogger, type MeteringReleaseInput, type MeteringReleaseReason, type MeteringReservationResult, type MeteringReserveInput, type MeteringRunKind, type MeteringRunScope, type MeteringRunStatus, type MeteringSettleInput, type MeteringUsage, type MeteringUsageInput, type ModeContext, PI_PACKAGE_RESOURCE_FILTERS, type PiExtensionFactory, type PiHarnessOptions, type PiPackageSource, type PluginSkillSource, type ProvisionRuntimeWorkspaceOptions, type ProvisionWorkspaceRuntimeOptions, type ProvisioningArtifactRequest, type RegisterAgentRoutesOptions, RemoteWorkerClient, RemoteWorkerClientError, type RemoteWorkerClientOptions, RemoteWorkerExecRequest, type RemoteWorkerModeAdapterOptions, RemoteWorkerWorkspaceOp, RemoteWorkerWorkspaceResult, type ResolvedAgent, type ResolvedAgentDigestInput, type RuntimeBundle, type RuntimeEnvContribution, type RuntimeEnvContributionContext, type RuntimeFilesystemBinding, type RuntimeFilesystemBindingOperations, type RuntimeModeAdapter, type RuntimeModeId, type RuntimeNodePackageSpec$1 as RuntimeNodePackageSpec, type RuntimeProvisioningContribution$1 as RuntimeProvisioningContribution, type RuntimePythonSpec$1 as RuntimePythonSpec, type RuntimeTemplateContribution$1 as RuntimeTemplateContribution, type RuntimeWorkspaceProvisioningResult, type SnapshotBakeOptions, type SnapshotBakeResult, UV_SETUP_COMMANDS, VERCEL_PROVISIONING_CACHE_ROOT, VERCEL_SANDBOX_WORKSPACE_ROOT, UV_SETUP_COMMANDS as VERCEL_UV_SETUP_COMMANDS, type VercelBakeClient, type VercelBakeSandbox, type VercelDeploymentSnapshotOptions, type WorkspaceAgentDispatcherBinding, type WorkspaceAgentDispatcherResolveOptions, type WorkspaceAgentDispatcherResolver, type WorkspaceProvisioningAdapter, type WorkspaceProvisioningExecResult, type WorkspaceProvisioningResult, applyCspHeaders, autoDetectMode, bakeSnapshotIfNeeded, buildDeploymentSnapshotRecipe, buildPackageHash, buildSnapshotRecipeHash, compactPiPackages, compileAgentDirectory, constantTimeTokenEqual, createAgent, createAgentApp, createDirectSandbox, createLogger, createManagedAgentMcpDelegateController, createManagedAgentMcpHttpHandler, createManagedAgentMcpServer, createNodeWorkspace, createRemoteWorkerModeAdapter, createRemoteWorkerSandbox, createRemoteWorkerWorkspace, createResolvedAgentDigest, createResourceSettingsManager, createVercelDeploymentSnapshotProvider, createVercelProvisioningAdapter, createVercelSandboxWorkspace, decodeBytesFromWorker, encodeBytesForWorker, fileRoutes, getBoringAgentPathEntries, getBoringAgentRuntimeEnv, getBoringAgentRuntimePaths, hasBwrap, mergePiPackageSources, normalizeMeteringUsage, piPackageSourceKey, prepareDeploymentSnapshot, prepareVercelDeploymentSnapshot, provisionRuntimeWorkspace, provisionWorkspaceRuntime, registerAgentRoutes, resolveAgentDeployment, resolveMode, resolveSandboxHandle };
+export { AgentConfig, AgentDirectoryCompilerError, type AgentDirectoryCompilerErrorCode, type AgentDirectoryCompilerPublicErrorCode, AgentHarnessFactory, type AgentMeteringSink, type BoringAgentRuntimePaths, type BuiltinRuntimeModeId, type CreateAgentAppOptions, type CreateVercelProvisioningAdapterOptions, type DeploymentSnapshotProvider, type DeploymentSnapshotRecipe, type DeploymentSnapshotResult, type DeploymentSnapshotStatus, FileHandleStore, type LogFields, type Logger, MANAGED_AGENT_MCP_DELIVERY_RULE, MANAGED_AGENT_MCP_ORIGIN_SURFACE, type ManagedAgentArtifact, type ManagedAgentArtifactCandidate, type ManagedAgentArtifactRef, type ManagedAgentBoundRunnerWorkspace, type ManagedAgentCollectArtifactsInput, type ManagedAgentDelegateInput, type ManagedAgentDelegateProgress, type ManagedAgentDelegateRequestContext, type ManagedAgentDelegateResult, type ManagedAgentDelegateRunInput, type ManagedAgentDelegateRunner, type ManagedAgentDelegateStatus, type ManagedAgentDelegateStatusResult, ManagedAgentMcpDelegateController, type ManagedAgentMcpDelegateOptions, ManagedAgentMcpError, type ManagedAgentMcpHttpHandlerOptions, type ManagedAgentMcpServerOptions, type ManagedAgentSafeError, type ManagedAgentWorkspaceResolutionInput, type MeteringErrorLogger, type MeteringReleaseInput, type MeteringReleaseReason, type MeteringReservationResult, type MeteringReserveInput, type MeteringRunKind, type MeteringRunScope, type MeteringRunStatus, type MeteringSettleInput, type MeteringUsage, type MeteringUsageInput, type ModeContext, PI_PACKAGE_RESOURCE_FILTERS, type PiExtensionFactory, type PiHarnessOptions, type PiPackageSource, type PluginSkillSource, type ProvisionRuntimeWorkspaceOptions, type ProvisionWorkspaceRuntimeOptions, type ProvisioningArtifactRequest, type RegisterAgentRoutesOptions, RemoteWorkerClient, RemoteWorkerClientError, type RemoteWorkerClientOptions, RemoteWorkerExecRequest, type RemoteWorkerModeAdapterOptions, RemoteWorkerWorkspaceOp, RemoteWorkerWorkspaceResult, type ResolvedAgent, type ResolvedAgentDigestInput, type RuntimeBundle, type RuntimeEnvContribution, type RuntimeEnvContributionContext, type RuntimeFilesystemBinding, type RuntimeFilesystemBindingOperations, type RuntimeModeAdapter, type RuntimeModeId, type RuntimeNodePackageSpec$1 as RuntimeNodePackageSpec, type RuntimeProvisioningContribution$1 as RuntimeProvisioningContribution, type RuntimePythonSpec$1 as RuntimePythonSpec, type RuntimeTemplateContribution$1 as RuntimeTemplateContribution, type RuntimeWorkspaceProvisioningResult, type ShareEntryMcpResourceOptions, type SnapshotBakeOptions, type SnapshotBakeResult, UV_SETUP_COMMANDS, VERCEL_PROVISIONING_CACHE_ROOT, VERCEL_SANDBOX_WORKSPACE_ROOT, UV_SETUP_COMMANDS as VERCEL_UV_SETUP_COMMANDS, type VercelBakeClient, type VercelBakeSandbox, type VercelDeploymentSnapshotOptions, type WorkspaceAgentDispatcherBinding, type WorkspaceAgentDispatcherResolveOptions, type WorkspaceAgentDispatcherResolver, type WorkspaceProvisioningAdapter, type WorkspaceProvisioningExecResult, type WorkspaceProvisioningResult, applyCspHeaders, autoDetectMode, bakeSnapshotIfNeeded, buildDeploymentSnapshotRecipe, buildPackageHash, buildSnapshotRecipeHash, compactPiPackages, compileAgentDirectory, constantTimeTokenEqual, createAgent, createAgentApp, createDirectSandbox, createLogger, createManagedAgentMcpDelegateController, createManagedAgentMcpHttpHandler, createManagedAgentMcpServer, createNodeWorkspace, createRemoteWorkerModeAdapter, createRemoteWorkerSandbox, createRemoteWorkerWorkspace, createResolvedAgentDigest, createResourceSettingsManager, createVercelDeploymentSnapshotProvider, createVercelProvisioningAdapter, createVercelSandboxWorkspace, decodeBytesFromWorker, encodeBytesForWorker, fileRoutes, getBoringAgentPathEntries, getBoringAgentRuntimeEnv, getBoringAgentRuntimePaths, hasBwrap, mergePiPackageSources, normalizeMeteringUsage, piPackageSourceKey, prepareDeploymentSnapshot, prepareVercelDeploymentSnapshot, provisionRuntimeWorkspace, provisionWorkspaceRuntime, registerAgentRoutes, registerShareEntryResources, resolveAgentDeployment, resolveMode, resolveSandboxHandle, shareResourceUri };

package/dist/server/index.js

@@ -51,14 +51,16 @@ import {
   provisionRuntimeWorkspace,
   provisionWorkspaceRuntime,
   registerAgentRoutes,
+  registerShareEntryResources,
   resolveAgentDeployment,
   resolveMode,
-  resolveSandboxHandle
-} from "../chunk-7V3E6KHX.js";
-import "../chunk-WODTQBXR.js";
-import "../chunk-TNN3LPXE.js";
+  resolveSandboxHandle,
+  shareResourceUri
+} from "../chunk-HY7EERLW.js";
+import "../chunk-YONTHCD7.js";
+import "../chunk-LYBTHR7J.js";
 import "../chunk-WSQ5QNIY.js";
-import "../chunk-DC3S7SZG.js";
+import "../chunk-6O5ADR57.js";
 import {
   PI_PACKAGE_RESOURCE_FILTERS,
   compactPiPackages,
@@ -66,9 +68,9 @@ import {
   createResourceSettingsManager,
   mergePiPackageSources,
   piPackageSourceKey
-} from "../chunk-5NAN3TAR.js";
+} from "../chunk-ZUDWQAAB.js";
 import "../chunk-AQBXNPMD.js";
-import "../chunk-PG2WOJ22.js";
+import "../chunk-HDIRWHJB.js";
 export {
   AgentDirectoryCompilerError,
   FileHandleStore,
@@ -129,7 +131,9 @@ export {
   provisionRuntimeWorkspace,
   provisionWorkspaceRuntime,
   registerAgentRoutes,
+  registerShareEntryResources,
   resolveAgentDeployment,
   resolveMode,
-  resolveSandboxHandle
+  resolveSandboxHandle,
+  shareResourceUri
 };

package/dist/server/worker/index.js

@@ -4,14 +4,14 @@ import {
   constantTimeTokenEqual,
   createBwrapSandbox,
   createNodeWorkspace
-} from "../../chunk-7V3E6KHX.js";
-import "../../chunk-WODTQBXR.js";
-import "../../chunk-TNN3LPXE.js";
+} from "../../chunk-HY7EERLW.js";
+import "../../chunk-YONTHCD7.js";
+import "../../chunk-LYBTHR7J.js";
 import "../../chunk-WSQ5QNIY.js";
-import "../../chunk-DC3S7SZG.js";
-import "../../chunk-5NAN3TAR.js";
+import "../../chunk-6O5ADR57.js";
+import "../../chunk-ZUDWQAAB.js";
 import "../../chunk-AQBXNPMD.js";
-import "../../chunk-PG2WOJ22.js";
+import "../../chunk-HDIRWHJB.js";
 
 // src/server/worker/index.ts
 import Fastify from "fastify";