@hachej/boring-agent 0.1.80 → 0.1.82

package/dist/shared/index.js

@@ -2,14 +2,16 @@ import {
   AgentDefinitionValidationError,
   AgentDeploymentValidationError,
   OpaqueRefSchema,
+  SchemaValidationError,
   Sha256DigestSchema,
   createAgentAssetDigest,
   createAgentDefinitionDigest,
   createAgentDeploymentDigest,
+  formatPath,
   validateAgentDefinition,
   validateAgentDeployment,
   validateTool
-} from "../chunk-CUF7ELFO.js";
+} from "../chunk-WODTQBXR.js";
 import {
   AGENT_NOT_IMPLEMENTED_UNTIL_T1,
   AgentNotImplementedError,
@@ -46,12 +48,13 @@ import {
   extractToolUiMetadata,
   isToolUiMetadata,
   sanitizeToolUiMetadata2 as sanitizeToolUiMetadata
-} from "../chunk-UJQXCOHR.js";
+} from "../chunk-DC3S7SZG.js";
 import {
   noopTelemetry,
   safeCapture
 } from "../chunk-AQBXNPMD.js";
 import {
+  AgentConsumptionErrorCode,
   AgentDefinitionErrorCode,
   AgentDeploymentErrorCode,
   ApiErrorPayloadSchema,
@@ -59,7 +62,7 @@ import {
   ERROR_CODES,
   ErrorCode,
   ErrorLogFieldsSchema
-} from "../chunk-CCNXYCD5.js";
+} from "../chunk-PG2WOJ22.js";
 
 // src/shared/config-schema.ts
 import { z } from "zod";
@@ -124,15 +127,154 @@ var PI_AGENT_RUNTIME_CAPABILITIES = {
   nativeFollowUp: true,
   aiSdkOwnsHistory: false
 };
+
+// src/shared/agent-consumption.ts
+import { z as z2 } from "zod";
+var nonEmptyString = z2.string().min(1);
+var TASK_STATES = [
+  "submitted",
+  "working",
+  "input-required",
+  "completed",
+  "failed",
+  "canceled",
+  "rejected"
+];
+var TaskStateSchema = z2.enum(TASK_STATES);
+var TASK_TRANSITIONS = {
+  submitted: ["working", "rejected", "canceled"],
+  working: ["input-required", "completed", "failed", "canceled", "rejected"],
+  "input-required": ["working", "canceled"],
+  completed: [],
+  failed: [],
+  canceled: [],
+  rejected: []
+};
+function isValidTaskTransition(from, to) {
+  return TASK_TRANSITIONS[from].includes(to);
+}
+function assertValidTransition(from, to) {
+  if (!isValidTaskTransition(from, to)) {
+    throw new AgentConsumptionValidationError({
+      code: AgentConsumptionErrorCode.enum.AGENT_CONSUMPTION_INVALID_TRANSITION,
+      field: "state",
+      message: `invalid task state transition: '${from}' -> '${to}'`
+    });
+  }
+}
+var PrincipalRefSchema = z2.object({
+  userId: nonEmptyString,
+  workspaceId: nonEmptyString
+}).strict();
+var AgentRefSchema = z2.object({
+  agentId: nonEmptyString,
+  deploymentId: nonEmptyString.optional()
+}).strict();
+function agentRefEquals(a, b) {
+  return a.agentId === b.agentId && (a.deploymentId ?? null) === (b.deploymentId ?? null);
+}
+var ArtifactRefSchema = z2.object({
+  artifactId: nonEmptyString,
+  name: z2.string().optional(),
+  mimeType: nonEmptyString,
+  uri: nonEmptyString
+}).strict();
+var PartSchema = z2.discriminatedUnion("type", [
+  z2.object({ type: z2.literal("text"), text: z2.string() }).strict(),
+  z2.object({ type: z2.literal("file"), file: ArtifactRefSchema }).strict(),
+  z2.object({ type: z2.literal("data"), mimeType: nonEmptyString, data: z2.unknown() }).strict()
+]);
+var AgentMessageSchema = z2.object({
+  role: z2.enum(["consumer", "agent"]),
+  parts: z2.array(PartSchema),
+  ts: nonEmptyString
+}).strict();
+var AgentTaskSchema = z2.object({
+  id: nonEmptyString,
+  contextId: nonEmptyString,
+  state: TaskStateSchema,
+  messages: z2.array(AgentMessageSchema),
+  artifacts: z2.array(ArtifactRefSchema),
+  principal: PrincipalRefSchema,
+  actor: AgentRefSchema.optional(),
+  schemaVersion: z2.literal("1"),
+  createdAt: nonEmptyString,
+  updatedAt: nonEmptyString
+}).strict();
+function schemaMismatchIssues(issues) {
+  return issues.map((issue) => {
+    const field = formatPath(issue.path);
+    return {
+      code: AgentConsumptionErrorCode.enum.AGENT_CONSUMPTION_SCHEMA_MISMATCH,
+      field,
+      message: field === "<root>" ? issue.message : `${field} ${issue.message}`
+    };
+  });
+}
+function validateAgentTask(raw) {
+  const result = AgentTaskSchema.safeParse(raw);
+  if (!result.success) {
+    return { valid: false, issues: schemaMismatchIssues(result.error.issues) };
+  }
+  return { valid: true, value: result.data };
+}
+var AgentConsumptionValidationError = class extends SchemaValidationError {
+  constructor(issue) {
+    super(issue);
+    this.name = "AgentConsumptionValidationError";
+  }
+};
+var ConsumptionGuardsSchema = z2.object({
+  maxDepth: z2.number().int().positive(),
+  inputRequiredTimeoutMs: z2.number().int().positive()
+}).strict();
+function validateConsumptionGuards(raw) {
+  const result = ConsumptionGuardsSchema.safeParse(raw);
+  if (!result.success) {
+    return { valid: false, issues: schemaMismatchIssues(result.error.issues) };
+  }
+  return { valid: true, value: result.data };
+}
+function detectConsumptionCycle(chain, next) {
+  return chain.some((ref) => agentRefEquals(ref, next));
+}
+function assertNoConsumptionCycle(chain, next) {
+  if (detectConsumptionCycle(chain, next)) {
+    const label = next.deploymentId ? `${next.agentId}@${next.deploymentId}` : next.agentId;
+    throw new AgentConsumptionValidationError({
+      code: AgentConsumptionErrorCode.enum.AGENT_CONSUMPTION_CYCLE_DETECTED,
+      field: "actor",
+      message: `consumption cycle detected: agent '${label}' already present in the delegation chain`
+    });
+  }
+}
+function isWithinConsumptionDepth(chain, guards) {
+  return chain.length < guards.maxDepth;
+}
+function assertWithinConsumptionDepth(chain, guards) {
+  if (!isWithinConsumptionDepth(chain, guards)) {
+    throw new AgentConsumptionValidationError({
+      code: AgentConsumptionErrorCode.enum.AGENT_CONSUMPTION_DEPTH_EXCEEDED,
+      field: "depth",
+      message: `consumption depth exceeded: chain length ${chain.length} >= max depth ${guards.maxDepth}`
+    });
+  }
+}
 export {
   AGENT_NOT_IMPLEMENTED_UNTIL_T1,
+  AgentConsumptionErrorCode,
+  AgentConsumptionValidationError,
   AgentDefinitionErrorCode,
   AgentDefinitionValidationError,
   AgentDeploymentErrorCode,
   AgentDeploymentValidationError,
+  AgentMessageSchema,
   AgentNotImplementedError,
+  AgentRefSchema,
+  AgentTaskSchema,
   ApiErrorPayloadSchema,
   ApiErrorResponseSchema,
+  ArtifactRefSchema,
   BoringChatMessageSchema,
   BoringChatPartSchema,
   ChatAttachmentPayloadSchema,
@@ -140,6 +282,7 @@ export {
   ChatModelSelectionSchema,
   CommandReceiptSchema,
   ConfigSchema,
+  ConsumptionGuardsSchema,
   DEFAULT_AGENT_RUNTIME_CAPABILITIES,
   ERROR_CODES,
   EnvSchema,
@@ -150,11 +293,13 @@ export {
   InterruptPayloadSchema,
   OpaqueRefSchema,
   PI_AGENT_RUNTIME_CAPABILITIES,
+  PartSchema,
   PiChatEventSchema,
   PiChatHeartbeatFrameSchema,
   PiChatSnapshotSchema,
   PiChatStatusSchema,
   PiChatStreamFrameSchema,
+  PrincipalRefSchema,
   PromptPayloadSchema,
   PromptReceiptSchema,
   QueueClearPayloadSchema,
@@ -164,21 +309,32 @@ export {
   Sha256DigestSchema,
   StopPayloadSchema,
   StopReceiptSchema,
+  TASK_STATES,
+  TaskStateSchema,
   ThinkingLevelSchema,
   ToolUiMetadataSchema,
   WORKSPACE_AGENT_PLUGINS_RELOADED_EVENT,
   WORKSPACE_COMMAND_NOTIFY_EVENT,
+  agentRefEquals,
+  assertNoConsumptionCycle,
+  assertValidTransition,
+  assertWithinConsumptionDepth,
   createAgentAssetDigest,
   createAgentDefinitionDigest,
   createAgentDeploymentDigest,
+  detectConsumptionCycle,
   extractToolUiMetadata,
   isToolUiMetadata,
+  isValidTaskTransition,
+  isWithinConsumptionDepth,
   noopTelemetry,
   safeCapture,
   sanitizeToolUiMetadata,
   sessionStreamPath,
   validateAgentDefinition,
   validateAgentDeployment,
+  validateAgentTask,
   validateConfig,
+  validateConsumptionGuards,
   validateTool
 };

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

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { A as AgentDefinitionErrorCode, p as AgentDeploymentErrorCode, z as InterruptReceipt, i as StopReceipt } from './piChatEvent-CpoTZau1.js';
-import { p as AgentSendInput, j as AgentEvent } from './harness-BZW5Jiy3.js';
+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';
 
 interface SandboxHandleRecord {
     workspaceId: string;
@@ -21,6 +21,26 @@ interface FileSearch {
 }
 
 type Sha256Digest = `sha256:${string}`;
+
+interface AgentSchemaIssue<Code extends string> {
+    code: Code;
+    field: string;
+    message: string;
+}
+type AgentSchemaValidationResult<T, Code extends string> = {
+    valid: true;
+    value: T;
+} | {
+    valid: false;
+    issues: AgentSchemaIssue<Code>[];
+};
+declare abstract class SchemaValidationError<Code extends string> extends Error {
+    readonly code: "CONFIG_INVALID";
+    readonly field: string;
+    readonly validationCode: Code;
+    constructor(issue: AgentSchemaIssue<Code>);
+}
+
 interface AgentDefinition {
     schemaVersion: 1;
     definitionId: string;
@@ -56,33 +76,15 @@ interface CompiledAgentBundle {
     readonly definitionDigest: Sha256Digest;
     readonly assets: readonly Readonly<AgentDefinitionDigestAsset>[];
 }
-interface AgentSchemaIssue<Code extends string> {
-    code: Code;
-    field: string;
-    message: string;
-}
-type AgentSchemaValidationResult<T, Code extends string> = {
-    valid: true;
-    value: T;
-} | {
-    valid: false;
-    issues: AgentSchemaIssue<Code>[];
-};
 declare const OpaqueRefSchema: z.ZodEffects<z.ZodString, string, string>;
 declare const Sha256DigestSchema: z.ZodEffects<z.ZodString, `sha256:${string}`, string>;
 declare function validateAgentDefinition(raw: unknown): AgentSchemaValidationResult<AgentDefinition, AgentDefinitionErrorCode>;
 declare function validateAgentDeployment(raw: unknown): AgentSchemaValidationResult<AgentDeployment, AgentDeploymentErrorCode>;
 declare function createAgentAssetDigest(content: string): Promise<Sha256Digest>;
-declare class AgentDefinitionValidationError extends Error {
-    readonly code: "CONFIG_INVALID";
-    readonly field: string;
-    readonly validationCode: AgentDefinitionErrorCode;
+declare class AgentDefinitionValidationError extends SchemaValidationError<AgentDefinitionErrorCode> {
     constructor(issue: AgentSchemaIssue<AgentDefinitionErrorCode>);
 }
-declare class AgentDeploymentValidationError extends Error {
-    readonly code: "CONFIG_INVALID";
-    readonly field: string;
-    readonly validationCode: AgentDeploymentErrorCode;
+declare class AgentDeploymentValidationError extends SchemaValidationError<AgentDeploymentErrorCode> {
     constructor(issue: AgentSchemaIssue<AgentDeploymentErrorCode>);
 }
 declare function createAgentDefinitionDigest(input: {
@@ -146,4 +148,4 @@ interface WorkspaceAgentDispatcher {
     stop(sessionId: string): Promise<StopReceipt>;
 }
 
-export { type AgentDeployment as A, type CompiledAgentBundle as C, type FileSearch as F, OpaqueRefSchema as O, type PluginRestartWarning as P, type SandboxHandleStore as S, type WorkspaceAgentDispatcherContext as W, type SandboxHandleRecord as a, type Sha256Digest as b, type WorkspaceAgentDispatcher as c, type AgentDefinition as d, type AgentDefinitionDigestAsset as e, type AgentDefinitionReference as f, AgentDefinitionValidationError as g, AgentDeploymentValidationError as h, type AgentSchemaIssue as i, type AgentSchemaValidationResult as j, type CommandNotifyPayload as k, type CompiledAgentDefinition as l, Sha256DigestSchema as m, WORKSPACE_AGENT_PLUGINS_RELOADED_EVENT as n, WORKSPACE_COMMAND_NOTIFY_EVENT as o, type WorkspaceAgentDispatcherSendInput as p, createAgentAssetDigest as q, createAgentDefinitionDigest as r, createAgentDeploymentDigest as s, validateAgentDeployment as t, validateAgentDefinition as v };
+export { type AgentDeployment as A, type CompiledAgentBundle as C, type FileSearch as F, OpaqueRefSchema as O, type PluginRestartWarning as P, type SandboxHandleStore as S, type WorkspaceAgentDispatcherContext as W, type SandboxHandleRecord as a, type Sha256Digest as b, type WorkspaceAgentDispatcher as c, SchemaValidationError as d, type AgentSchemaIssue as e, type AgentSchemaValidationResult as f, type AgentDefinition as g, type AgentDefinitionDigestAsset as h, type AgentDefinitionReference as i, AgentDefinitionValidationError as j, AgentDeploymentValidationError as k, type CommandNotifyPayload as l, type CompiledAgentDefinition as m, Sha256DigestSchema as n, WORKSPACE_AGENT_PLUGINS_RELOADED_EVENT as o, WORKSPACE_COMMAND_NOTIFY_EVENT as p, type WorkspaceAgentDispatcherSendInput as q, createAgentAssetDigest as r, createAgentDefinitionDigest as s, createAgentDeploymentDigest as t, validateAgentDeployment as u, validateAgentDefinition as v };

package/docs/ERROR_CODES.md

@@ -35,6 +35,7 @@ All API failures must use the response envelope:
 | `PATH_NOT_WRITABLE` | Path parent missing or write denied | 403 | user-fix | warn | stable (public API) |
 | `WORKSPACE_UNINITIALIZED` | Workspace adapter/store not initialized yet | 503 | retry | warn | stable (public API) |
 | `WORKSPACE_NOT_READY` | Workspace substrate (`workspace-fs`, `sandbox-exec`, or `ui-bridge`) is still preparing | 503 | retry | warn | stable (public API) |
+| `D1_HOST_SCOPE_VIOLATION` | Presented workspace selector conflicts with the trusted dedicated-host request scope | 421 | user-fix | warn | stable (public API) |
 | `AGENT_RUNTIME_NOT_READY` | Selected workspace runtime dependencies (`runtime-dependencies` or `runtime:<name>`, e.g. `runtime:python`/`runtime:node`) are still preparing | 503 | retry | warn | stable (public API) |
 | `AGENT_BINDING_DISPOSED` | A caller retained an agent binding after its host retired it | 410 | resolve a fresh binding | warn | stable (trusted API) |
 | `AGENT_CONTROL_RECEIPT_INVALID` | The existing agent runtime returned a malformed interrupt/stop receipt through the trusted dispatcher | 500 | report-bug | error | stable (trusted API) |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hachej/boring-agent",
-  "version": "0.1.80",
+  "version": "0.1.82",
   "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.80"
+    "@hachej/boring-ui-kit": "0.1.82"
   },
   "devDependencies": {
     "@antithesishq/bombadil": "0.6.1",