@hachej/boring-agent 0.1.63 → 0.1.65

package/dist/server/index.d.ts

@@ -1,9 +1,15 @@
-import { o as WorkspaceRuntimeContext, S as Sandbox, g as SandboxHandleStore, f as SandboxHandleRecord, W as Workspace, j as TelemetrySink, q as ToolReadinessRequirement, F as FileSearch, i as Stat, E as Entry, c as ExecResult, r as WorkspaceChangeEvent, b as ExecOptions, P as PluginRestartWarning, A as AgentTool, t as AgentHarnessFactory } from '../agentPluginEvents-Ddn5DQ5E.js';
-export { u as AgentHarnessFactoryInput } from '../agentPluginEvents-Ddn5DQ5E.js';
+import { j as WorkspaceRuntimeContext, S as Sandbox, f as SandboxHandleStore, e as SandboxHandleRecord, W as Workspace, F as FileSearch, g as Stat, E as Entry, b as ExecResult, k as WorkspaceChangeEvent, a as ExecOptions, P as PluginRestartWarning } from '../agentPluginEvents-ChUzG2Lh.js';
 import { Sandbox as Sandbox$1 } from '@vercel/sandbox';
+import { v as TelemetrySink, C as ToolReadinessRequirement, i as AgentEvent, b as Agent, c as AgentActor, A as AgentTool, D as AgentHarnessFactory } from '../harness-DN9KdrT7.js';
+export { u as AgentConfig, E as AgentHarnessFactoryInput } from '../harness-DN9KdrT7.js';
 import { FastifyInstance, FastifyRequest, FastifyPluginAsync } from 'fastify';
+export { createAgent } from '../core/index.js';
+import { S as SessionCtx, f as ErrorCode } from '../piChatEvent-B6Lg9ft-.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 ChatModelSelection } from '../chatSubmitPayload-DHqQL2wD.js';
+import { b as ChatModelSelection } from '../chatSubmitPayload-DwOHyiqR.js';
+import 'zod';
 
 interface CreateDirectSandboxOptions {
     runtimeContext?: WorkspaceRuntimeContext;
@@ -490,6 +496,35 @@ interface RuntimeFilesystemBindingOperations {
         isDirectory: boolean;
         metadata?: unknown;
     }>;
+    write?(descriptor: {
+        filesystem: string;
+        path: string;
+        content: string;
+        expectedMtimeMs?: number;
+    }): Promise<{
+        mtimeMs?: number;
+        metadata?: unknown;
+    }>;
+    delete?(descriptor: {
+        filesystem: string;
+        path: string;
+    }): Promise<{
+        metadata?: unknown;
+    }>;
+    move?(descriptor: {
+        filesystem: string;
+        from: string;
+        to: string;
+    }): Promise<{
+        metadata?: unknown;
+    }>;
+    mkdir?(descriptor: {
+        filesystem: string;
+        path: string;
+        recursive?: boolean;
+    }): Promise<{
+        metadata?: unknown;
+    }>;
     rejectMutation(operation: string, descriptor: {
         filesystem: string;
         path: string;
@@ -497,7 +532,7 @@ interface RuntimeFilesystemBindingOperations {
 }
 interface RuntimeFilesystemBinding {
     readonly filesystem: string;
-    readonly access: 'readonly';
+    readonly access: 'readonly' | 'readwrite';
     readonly operations: RuntimeFilesystemBindingOperations;
 }
 interface RuntimeBundle {
@@ -754,6 +789,127 @@ interface ResolveModeOptions {
 }
 declare function resolveMode(mode?: RuntimeModeId, opts?: ResolveModeOptions): RuntimeModeAdapter;
 
+declare const MANAGED_AGENT_MCP_ORIGIN_SURFACE = "mcp-managed-agent";
+declare const MANAGED_AGENT_MCP_DELIVERY_RULE = "M1-pr1 DELIVERY v0: delegate_task returns final assistant text and artifact file references only; share-link delivery is gated on PR #424.";
+type ManagedAgentDelegationStatus = 'running' | 'completed' | 'error';
+type ManagedAgentDelegateStatus = ManagedAgentDelegationStatus;
+interface ManagedAgentArtifactRef {
+    path: string;
+    mediaType?: string;
+    title?: string;
+    content?: string;
+    truncated?: boolean;
+}
+interface ManagedAgentDelegateProgress {
+    at: string;
+    eventIndex: number;
+    kind: string;
+    message: string;
+}
+interface ManagedAgentDelegateResult {
+    delegationId: string;
+    status: 'completed';
+    finalAssistantText: string;
+    artifacts: ManagedAgentArtifactRef[];
+    deliveryRule: typeof MANAGED_AGENT_MCP_DELIVERY_RULE;
+}
+interface ManagedAgentDelegateStatusResult {
+    delegationId: string;
+    status: ManagedAgentDelegationStatus;
+    progress: ManagedAgentDelegateProgress[];
+    lastEventIndex?: number;
+    eventCount: number;
+    result?: ManagedAgentDelegateResult;
+    error?: ManagedAgentSafeError;
+}
+interface ManagedAgentSafeError {
+    code: ErrorCode;
+    message: string;
+}
+interface ManagedAgentDelegateRequestContext {
+    sessionId?: string;
+    authInfo?: unknown;
+}
+interface ManagedAgentDelegateInput {
+    brief: string;
+    request?: ManagedAgentDelegateRequestContext;
+    onDelegationCreated?: (status: ManagedAgentDelegateStatusResult) => void | Promise<void>;
+    onProgress?: (progress: ManagedAgentDelegateProgress) => void | Promise<void>;
+    signal?: AbortSignal;
+}
+interface ManagedAgentCollectArtifactsInput {
+    delegationId: string;
+    sessionId: string;
+    ctx: SessionCtx;
+    finalAssistantText: string;
+    events: readonly AgentEvent[];
+}
+interface ManagedAgentMcpDelegateOptions {
+    agent: Agent;
+    resolveSessionCtx(input: {
+        brief: string;
+        request: ManagedAgentDelegateRequestContext;
+    }): SessionCtx | Promise<SessionCtx>;
+    resolveActor?(input: {
+        brief: string;
+        ctx: SessionCtx;
+        request: ManagedAgentDelegateRequestContext;
+    }): AgentActor | Promise<AgentActor>;
+    collectArtifacts?(input: ManagedAgentCollectArtifactsInput): ManagedAgentArtifactRef[] | Promise<ManagedAgentArtifactRef[]>;
+    createDelegationId?: () => string;
+    now?: () => Date;
+    maxBriefChars?: number;
+    maxInlineArtifactContentChars?: number;
+    terminalRetentionMs?: number;
+    maxDelegations?: number;
+    redactionCanaries?: readonly string[];
+}
+declare class ManagedAgentMcpError extends Error {
+    readonly code: ErrorCode;
+    constructor(code: ErrorCode, message: string);
+}
+declare class ManagedAgentMcpDelegateController {
+    private readonly options;
+    private readonly delegations;
+    private readonly createDelegationId;
+    private readonly now;
+    private readonly maxBriefChars;
+    private readonly maxInlineArtifactContentChars;
+    private readonly terminalRetentionMs;
+    private readonly maxDelegations;
+    private readonly redactionCanaries;
+    constructor(options: ManagedAgentMcpDelegateOptions);
+    delegateTask(input: ManagedAgentDelegateInput): Promise<ManagedAgentDelegateResult>;
+    getStatusForRequest(delegationId: string, request: ManagedAgentDelegateRequestContext): Promise<ManagedAgentDelegateStatusResult>;
+    getStatus(delegationId: string, ctx: SessionCtx): ManagedAgentDelegateStatusResult;
+    private createRecord;
+    private markTerminal;
+    private pruneDelegations;
+    private parseBrief;
+    private resolveSessionCtx;
+    private assertNotAborted;
+    private stopDelegatedSession;
+    private resolveActor;
+    private observeEvent;
+    private pushProgress;
+    private collectArtifacts;
+    private toSafeError;
+    private assertPublicPayloadSafe;
+    private containsSecret;
+    private timestamp;
+}
+declare function createManagedAgentMcpDelegateController(options: ManagedAgentMcpDelegateOptions): ManagedAgentMcpDelegateController;
+
+interface ManagedAgentMcpServerOptions extends ManagedAgentMcpDelegateOptions {
+    name?: string;
+    version?: string;
+}
+interface ManagedAgentMcpHttpHandlerOptions extends ManagedAgentMcpServerOptions {
+    controller?: ManagedAgentMcpDelegateController;
+}
+declare function createManagedAgentMcpServer(options: ManagedAgentMcpServerOptions, controller?: ManagedAgentMcpDelegateController): McpServer;
+declare function createManagedAgentMcpHttpHandler(options: ManagedAgentMcpHttpHandlerOptions): (req: IncomingMessage, res: ServerResponse, parsedBody?: unknown) => Promise<void>;
+
 interface ReloadHookDiagnostic {
     source: string;
     message: string;
@@ -814,6 +970,8 @@ interface PiHarnessOptions {
      * arrays that the harness already captured.
      */
     getHotReloadableResources?: () => HotReloadablePiResources;
+    /** Reject an explicit unavailable/unknown model instead of silently falling back. */
+    strictModelResolution?: boolean;
 }
 interface HotReloadablePiResources {
     additionalSkillPaths?: string[];
@@ -847,6 +1005,8 @@ declare function createResourceSettingsManager(cwd: string, agentDir: string, pi
  * because process restarts and client retries can replay transitions.
  */
 interface AgentMeteringSink {
+    /** False means the sink is installed but policy is disabled/no-op. Omitted means active for fail-closed callers. */
+    isEnabled?: () => boolean;
     reserveRun(input: MeteringReserveInput): Promise<MeteringReservationResult>;
     /** Records the usage and returns the credit micros it was actually billed. The
      * coordinator counts a usage as billable from this charged amount (not raw provider
@@ -861,8 +1021,10 @@ interface MeteringUsageResult {
     billedMicros: number;
 }
 interface MeteringRunScope {
-    workspaceId: string;
+    workspaceId?: string;
     userId?: string;
+    userEmail?: string;
+    userEmailVerified?: boolean;
     sessionId: string;
     /** Stable id for one accepted prompt/follow-up run. */
     runId: string;
@@ -902,6 +1064,7 @@ interface MeteringUsageInput extends MeteringRunScope {
     };
     usage: MeteringUsage;
     stopReason?: string;
+    metadata?: Record<string, unknown>;
 }
 type MeteringRunStatus = 'ok' | 'error' | 'aborted';
 interface MeteringSettleInput extends MeteringRunScope {
@@ -953,6 +1116,17 @@ interface CreateAgentAppOptions {
     telemetry?: TelemetrySink;
     /** Optional billing sink for native Pi usage (see AgentMeteringSink). */
     metering?: AgentMeteringSink;
+    /** Generic filesystem binding seam for standalone embeddings. */
+    getFilesystemBindings?: (ctx: {
+        request?: FastifyRequest;
+        sessionId?: string;
+        workspaceId: string;
+        workspaceRoot: string;
+        userId?: string;
+        userEmail?: string;
+        userEmailVerified?: boolean;
+        requestId?: string;
+    }) => RuntimeFilesystemBinding[] | undefined | Promise<RuntimeFilesystemBinding[] | undefined>;
     /** Generic runtime env contributors. Agent stays workspace-neutral; hosts decide env names/values. */
     runtimeEnvContributions?: RuntimeEnvContribution[];
     /** Runtime-aware provisioning hook. Runs after Workspace/Sandbox creation and before tools/harness. */
@@ -1005,6 +1179,50 @@ declare function applyCspHeaders(response: HeaderLike, opts?: {
     dev?: boolean;
 }): void;
 
+interface AgentModelSelection {
+    provider: string;
+    id: string;
+}
+
+/**
+ * GET /api/v1/agent/models
+ *
+ * Returns the list of models pi-coding-agent has auth for (i.e. where
+ * the corresponding provider API key is present in the environment or
+ * `~/.pi/agent/auth.json`). Consumers — including the shadcn example
+ * ChatPanel — fetch this endpoint to populate the model-selector dropdown
+ * instead of hardcoding a short alias list.
+ *
+ * Shape:
+ *   {
+ *     models: [
+ *       { provider: "anthropic", id: "claude-sonnet-4-6", label: "Claude Sonnet 4.6", available: true },
+ *       ...
+ *     ]
+ *   }
+ *
+ * Safe to call unauthenticated — we only report {provider, id, label,
+ * available}, never any key material.
+ */
+
+interface ModelSummary {
+    provider: string;
+    id: string;
+    label: string;
+    available: boolean;
+}
+interface ModelFilterContext {
+    request: FastifyRequest;
+    workspaceId?: string;
+}
+type ModelFilterResult = {
+    models: readonly ModelSummary[];
+    defaultModel?: AgentModelSelection;
+};
+interface ModelsRoutesOptions {
+    filterModels?: (ctx: ModelFilterContext, models: readonly ModelSummary[], defaultModel: AgentModelSelection | undefined) => ModelFilterResult | Promise<ModelFilterResult>;
+}
+
 interface RegisterAgentRoutesOptions {
     workspaceRoot?: string;
     sessionId?: string;
@@ -1024,6 +1242,7 @@ interface RegisterAgentRoutesOptions {
         workspaceRoot: string;
         runtimeMode: RuntimeModeId;
         workspaceFsCapability?: Workspace['fsCapability'];
+        authSubject?: string;
     }) => AgentTool[] | Promise<AgentTool[]>;
     systemPromptAppend?: string;
     /** Optional dynamic system-prompt source forwarded to the harness. */
@@ -1046,6 +1265,19 @@ interface RegisterAgentRoutesOptions {
     sessionRoot?: string;
     /** Optional best-effort telemetry sink supplied by an embedding host. */
     telemetry?: TelemetrySink;
+    /** 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. */
+    getFilesystemBindings?: (ctx: {
+        request?: FastifyRequest;
+        workspaceId: string;
+        workspaceRoot: string;
+        sessionId?: string;
+        userId?: string;
+        userEmail?: string;
+        userEmailVerified?: boolean;
+        requestId?: string;
+    }) => RuntimeFilesystemBinding[] | undefined | Promise<RuntimeFilesystemBinding[] | undefined>;
     /**
      * Optional billing sink for native Pi usage. Reserve happens before
      * accepted prompt/follow-up execution (fail closed), usage is recorded from
@@ -1124,4 +1356,4 @@ interface Logger {
 }
 declare function createLogger(prefix: string): Logger;
 
-export { AgentHarnessFactory, type AgentMeteringSink, type BoringAgentRuntimePaths, type BuiltinRuntimeModeId, type BwrapResourceLimits, type CreateAgentAppOptions, type CreateBwrapSandboxOptions, type CreateVercelProvisioningAdapterOptions, type DeploymentSnapshotProvider, type DeploymentSnapshotRecipe, type DeploymentSnapshotResult, type DeploymentSnapshotStatus, FileHandleStore, type LogFields, type Logger, 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, REMOTE_WORKER_PROVIDER, REMOTE_WORKER_RUNTIME_CWD, type RegisterAgentRoutesOptions, RemoteWorkerClient, RemoteWorkerClientError, type RemoteWorkerClientOptions, type RemoteWorkerErrorPayload, type RemoteWorkerExecRequest, type RemoteWorkerExecResponse, type RemoteWorkerFsEventEnvelope, type RemoteWorkerModeAdapterOptions, type RemoteWorkerWorkspaceOp, type RemoteWorkerWorkspaceResult, type RuntimeBundle, type RuntimeEnvContribution, type RuntimeEnvContributionContext, 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, WORKER_INTERNAL_TOKEN_HEADER, WORKER_REQUEST_ID_HEADER, WORKER_WORKSPACE_ID_HEADER, type WorkspaceProvisioningAdapter, type WorkspaceProvisioningExecResult, type WorkspaceProvisioningResult, applyCspHeaders, autoDetectMode, bakeSnapshotIfNeeded, buildDeploymentSnapshotRecipe, buildPackageHash, buildSnapshotRecipeHash, compactPiPackages, constantTimeTokenEqual, createAgentApp, createBwrapSandbox, createDirectSandbox, createLogger, createNodeWorkspace, createRemoteWorkerModeAdapter, createRemoteWorkerSandbox, createRemoteWorkerWorkspace, createResourceSettingsManager, createVercelDeploymentSnapshotProvider, createVercelProvisioningAdapter, createVercelSandboxWorkspace, decodeBytesFromWorker, encodeBytesForWorker, fileRoutes, getBoringAgentPathEntries, getBoringAgentRuntimeEnv, getBoringAgentRuntimePaths, hasBwrap, mergePiPackageSources, normalizeMeteringUsage, piPackageSourceKey, prepareDeploymentSnapshot, prepareVercelDeploymentSnapshot, provisionRuntimeWorkspace, provisionWorkspaceRuntime, registerAgentRoutes, resolveMode, resolveSandboxHandle };
+export { AgentHarnessFactory, type AgentMeteringSink, type BoringAgentRuntimePaths, type BuiltinRuntimeModeId, type BwrapResourceLimits, type CreateAgentAppOptions, type CreateBwrapSandboxOptions, 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 ManagedAgentArtifactRef, type ManagedAgentCollectArtifactsInput, type ManagedAgentDelegateInput, type ManagedAgentDelegateProgress, type ManagedAgentDelegateRequestContext, type ManagedAgentDelegateResult, type ManagedAgentDelegateStatus, type ManagedAgentDelegateStatusResult, ManagedAgentMcpDelegateController, type ManagedAgentMcpDelegateOptions, ManagedAgentMcpError, type ManagedAgentMcpHttpHandlerOptions, type ManagedAgentMcpServerOptions, type ManagedAgentSafeError, 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, REMOTE_WORKER_PROVIDER, REMOTE_WORKER_RUNTIME_CWD, type RegisterAgentRoutesOptions, RemoteWorkerClient, RemoteWorkerClientError, type RemoteWorkerClientOptions, type RemoteWorkerErrorPayload, type RemoteWorkerExecRequest, type RemoteWorkerExecResponse, type RemoteWorkerFsEventEnvelope, type RemoteWorkerModeAdapterOptions, type RemoteWorkerWorkspaceOp, type RemoteWorkerWorkspaceResult, 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, WORKER_INTERNAL_TOKEN_HEADER, WORKER_REQUEST_ID_HEADER, WORKER_WORKSPACE_ID_HEADER, type WorkspaceProvisioningAdapter, type WorkspaceProvisioningExecResult, type WorkspaceProvisioningResult, applyCspHeaders, autoDetectMode, bakeSnapshotIfNeeded, buildDeploymentSnapshotRecipe, buildPackageHash, buildSnapshotRecipeHash, compactPiPackages, constantTimeTokenEqual, createAgentApp, createBwrapSandbox, createDirectSandbox, createLogger, createManagedAgentMcpDelegateController, createManagedAgentMcpHttpHandler, createManagedAgentMcpServer, createNodeWorkspace, createRemoteWorkerModeAdapter, createRemoteWorkerSandbox, createRemoteWorkerWorkspace, createResourceSettingsManager, createVercelDeploymentSnapshotProvider, createVercelProvisioningAdapter, createVercelSandboxWorkspace, decodeBytesFromWorker, encodeBytesForWorker, fileRoutes, getBoringAgentPathEntries, getBoringAgentRuntimeEnv, getBoringAgentRuntimePaths, hasBwrap, mergePiPackageSources, normalizeMeteringUsage, piPackageSourceKey, prepareDeploymentSnapshot, prepareVercelDeploymentSnapshot, provisionRuntimeWorkspace, provisionWorkspaceRuntime, registerAgentRoutes, resolveMode, resolveSandboxHandle };