@drisp/protocol 0.8.0 → 0.8.2

package/dist/v2.d.ts

@@ -4,6 +4,27 @@ import { f as InstalledWorkflowSchema } from './domain-B-kg2pa_.js';
 /** Presentation of canonical fragment records; archive/cursor accounting always uses the original records. */
 declare function readableHistory(records: HistoryRecord[]): HistoryRecord[];
 
+/**
+ * What a Build's children cost against its token budget (root ADR-0011). Tokens exclude cache reads. The forecasts
+ * are defaults, not measured; the caps are the per-Run ceilings the size classes declare.
+ */
+type SizeClass = 'S' | 'M' | 'L';
+/** Per-Run token cap of each size class. The largest class also bounds anything above it. */
+declare const SIZE_CLASS_CAPS: Readonly<Record<SizeClass, number>>;
+/** What a Run of each class is expected to use: default, not measured. */
+declare const SIZE_CLASS_FORECASTS: Readonly<Record<SizeClass, number>>;
+/** The smallest class whose cap is at least the declared one; above the largest cap is `L`. A cap that is no number reads as `S`. */
+declare function classOfCap(declaredCap: number): SizeClass;
+/**
+ * What one attempt holds against the budget: a closed attempt (finished, failed, cancelled) its forecast, never more
+ * than its own declared cap (so the rule stays looser than the cap sum it replaces); a running or queued one still its
+ * declared cap. A closed attempt whose cap is no positive number counts its forecast.
+ */
+declare function attemptCost(attempt: {
+    tokenCap: number;
+    closed: boolean;
+}): number;
+
 declare const protocolVersion: {
     readonly major: 2;
     readonly minor: 2;
@@ -1404,4 +1425,4 @@ type ConnectPendingResponse = z.infer<typeof connectPendingResponseSchema>;
 type TeamDefault = z.infer<typeof teamDefaultSchema>;
 type RunsGoTo = z.infer<typeof runsGoToSchema>;
 
-export { type Audience, type BuildCloseReason, type Checkpoint, type Command, type ConnectAlreadyConnected, type ConnectPendingResponse, type ConnectRedeemRequest, type ConnectRedeemResponse, type ConnectStartRequest, type ConnectStartResponse, type ControlRecord, type Delegation, type ExecutionFact, type Grant, type Harness, type HarnessReadiness, type HistoryRecord, type InstalledWorkflow, type RepositoryBinding, type RepositorySource, type RunCloseReason, type RunParent, type RunView, type RunnerAdoptRequest, type RunnerDisconnectPreview, type RunnerDisconnectResponse, type RunnerFrame, type RunnerList, type RunnerListEntry, type RunnerReadiness, type RunsGoTo, type Scope, type TeamDefault, type WorkflowIdentity, type WorkflowInstallReference, type WorkflowReference, abandonedConversationContinuationCapability, audienceSchema, buildCloseReasonSchema, canonicalJson, checkpointPathSchema, checkpointSchema, clientFrameSchema, commandSchema, connectAlreadyConnectedSchema, connectApproveRequestSchema, connectCodeAlphabet, connectCodeRequestSchema, connectCodeResponseSchema, connectCodeSchema, connectDenyRequestSchema, connectPendingResponseSchema, connectPollRequestSchema, connectRedeemRequestSchema, connectRedeemResponseSchema, connectStartRequestSchema, connectStartResponseSchema, controlRecordSchema, conversationContinuationCapability, delegationSchema, delegationTokenPrefix, grantSchema, harnessReadinessSchema, harnessSchema, historyRecordSchema, hubEpochRequestSchema, installReference, installedWorkflowsSchema, interruptionSchema, permissionAnswerSchema, protocolVersion, readableHistory, readinessFixCommand, repositoryAccessCapability, repositoryBindingSchema, repositoryRefSchema, repositorySourceSchema, repositoryWorkingDirectorySchema, runArtifactMaxBytes, runArtifactNameSchema, runCloseReasonSchema, runDelegationCapability, runKeySchema, runParentIntentSchema, runParentSchema, runSpecSchema, runViewSchema, runnerAdoptRequestSchema, runnerDisconnectPreviewSchema, runnerDisconnectRequestSchema, runnerDisconnectResponseSchema, runnerFrameSchema, runnerListEntrySchema, runnerListSchema, runnerReadinessSchema, runnerUpdateCommand, runnerUpdateRequestSchema, runsGoToSchema, sameWorkflow, scopeSchema, secretEnvironmentSchema, sequence, teamDefaultRequestSchema, teamDefaultSchema, workflowIdentitySchema, workflowInstallCapability, workflowName, workflowReferenceSchema, workflowSourceSchema };
+export { type Audience, type BuildCloseReason, type Checkpoint, type Command, type ConnectAlreadyConnected, type ConnectPendingResponse, type ConnectRedeemRequest, type ConnectRedeemResponse, type ConnectStartRequest, type ConnectStartResponse, type ControlRecord, type Delegation, type ExecutionFact, type Grant, type Harness, type HarnessReadiness, type HistoryRecord, type InstalledWorkflow, type RepositoryBinding, type RepositorySource, type RunCloseReason, type RunParent, type RunView, type RunnerAdoptRequest, type RunnerDisconnectPreview, type RunnerDisconnectResponse, type RunnerFrame, type RunnerList, type RunnerListEntry, type RunnerReadiness, type RunsGoTo, SIZE_CLASS_CAPS, SIZE_CLASS_FORECASTS, type Scope, type SizeClass, type TeamDefault, type WorkflowIdentity, type WorkflowInstallReference, type WorkflowReference, abandonedConversationContinuationCapability, attemptCost, audienceSchema, buildCloseReasonSchema, canonicalJson, checkpointPathSchema, checkpointSchema, classOfCap, clientFrameSchema, commandSchema, connectAlreadyConnectedSchema, connectApproveRequestSchema, connectCodeAlphabet, connectCodeRequestSchema, connectCodeResponseSchema, connectCodeSchema, connectDenyRequestSchema, connectPendingResponseSchema, connectPollRequestSchema, connectRedeemRequestSchema, connectRedeemResponseSchema, connectStartRequestSchema, connectStartResponseSchema, controlRecordSchema, conversationContinuationCapability, delegationSchema, delegationTokenPrefix, grantSchema, harnessReadinessSchema, harnessSchema, historyRecordSchema, hubEpochRequestSchema, installReference, installedWorkflowsSchema, interruptionSchema, permissionAnswerSchema, protocolVersion, readableHistory, readinessFixCommand, repositoryAccessCapability, repositoryBindingSchema, repositoryRefSchema, repositorySourceSchema, repositoryWorkingDirectorySchema, runArtifactMaxBytes, runArtifactNameSchema, runCloseReasonSchema, runDelegationCapability, runKeySchema, runParentIntentSchema, runParentSchema, runSpecSchema, runViewSchema, runnerAdoptRequestSchema, runnerDisconnectPreviewSchema, runnerDisconnectRequestSchema, runnerDisconnectResponseSchema, runnerFrameSchema, runnerListEntrySchema, runnerListSchema, runnerReadinessSchema, runnerUpdateCommand, runnerUpdateRequestSchema, runsGoToSchema, sameWorkflow, scopeSchema, secretEnvironmentSchema, sequence, teamDefaultRequestSchema, teamDefaultSchema, workflowIdentitySchema, workflowInstallCapability, workflowName, workflowReferenceSchema, workflowSourceSchema };

package/dist/v2.js

@@ -47,6 +47,28 @@ function readableHistory(records) {
   return result;
 }
 
+// src/budget.ts
+var SIZE_CLASS_CAPS = {
+  S: 3e6,
+  M: 6e6,
+  L: 12e6
+};
+var SIZE_CLASS_FORECASTS = {
+  S: 15e4,
+  M: 4e5,
+  L: 12e5
+};
+function classOfCap(declaredCap) {
+  if (Number.isNaN(declaredCap) || declaredCap <= SIZE_CLASS_CAPS.S) return "S";
+  if (declaredCap <= SIZE_CLASS_CAPS.M) return "M";
+  return "L";
+}
+function attemptCost(attempt) {
+  if (!attempt.closed) return attempt.tokenCap;
+  const forecast = SIZE_CLASS_FORECASTS[classOfCap(attempt.tokenCap)];
+  return attempt.tokenCap > 0 ? Math.min(attempt.tokenCap, forecast) : forecast;
+}
+
 // src/v2.ts
 var protocolVersion = { major: 2, minor: 2 };
 var conversationContinuationCapability = "conversation_continuation";
@@ -599,12 +621,16 @@ var connectApproveRequestSchema = z.strictObject({
 });
 var connectDenyRequestSchema = z.strictObject({ code: z.string().min(8).max(16) });
 export {
+  SIZE_CLASS_CAPS,
+  SIZE_CLASS_FORECASTS,
   abandonedConversationContinuationCapability,
+  attemptCost,
   audienceSchema,
   buildCloseReasonSchema,
   canonicalJson,
   checkpointPathSchema,
   checkpointSchema,
+  classOfCap,
   clientFrameSchema,
   commandSchema,
   connectAlreadyConnectedSchema,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@drisp/protocol",
-  "version": "0.8.0",
+  "version": "0.8.2",
   "description": "Wire contract between a drisp runner and the hub: zod schemas, inferred types, and JSON Schema for the instance-socket frames, Run, Turn, Interruption, and the event stream",
   "repository": {
     "type": "git",