@sixb/core 0.1.3 → 0.1.4

package/dist/testing/lake-storage-contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lake-storage-contract.d.ts","sourceRoot":"","sources":["../../src/testing/lake-storage-contract.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAc,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAEpE,MAAM,MAAM,oCAAoC,GAAG,QAAQ,GAAG,oBAAoB,CAAA;AAElF,MAAM,WAAW,+BAA+B,CAAC,QAAQ,SAAS,WAAW,GAAG,WAAW;IACzF,+EAA+E;IAC/E,QAAQ,CAAC,aAAa,EAAE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC1D,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/D;;;OAGG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,oCAAoC,CAAA;IAC/D;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CACnC;AA2CD;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,SAAS,WAAW,EACtE,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,+BAA+B,CAAC,QAAQ,CAAC,GACjD,IAAI,CA2nBN"}
+{"version":3,"file":"lake-storage-contract.d.ts","sourceRoot":"","sources":["../../src/testing/lake-storage-contract.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAc,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAEpE,MAAM,MAAM,oCAAoC,GAAG,QAAQ,GAAG,oBAAoB,CAAA;AAElF,MAAM,WAAW,+BAA+B,CAAC,QAAQ,SAAS,WAAW,GAAG,WAAW;IACzF,+EAA+E;IAC/E,QAAQ,CAAC,aAAa,EAAE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC1D,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/D;;;OAGG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,oCAAoC,CAAA;IAC/D;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CACnC;AA2CD;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,SAAS,WAAW,EACtE,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,+BAA+B,CAAC,QAAQ,CAAC,GACjD,IAAI,CAmrBN"}

package/dist/testing/object-query-contract.d.ts

@@ -13,7 +13,7 @@ export declare const objectQueryContractOntology: OntologyRegistry;
  *
  * The contract defines the portable V1 query surface: capability declarations,
  * validation/normalization handoff, provider pushdown, bounded fallback,
- * traversal, set operations, pagination, search profile defaults, and stable
+ * canonical reference sets, traversal, set operations, pagination, search profile defaults, and stable
  * structured rejections for features outside a provider's capability map.
  */
 export declare function runObjectQueryProviderContractSuite<TStorage extends Storage>(label: string, options: ObjectQueryProviderContractSuiteOptions<TStorage>): void;

package/dist/testing/object-query-contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"object-query-contract.d.ts","sourceRoot":"","sources":["../../src/testing/object-query-contract.ts"],"names":[],"mappings":"AAaA,OAAO,EAA0B,gBAAgB,EAAoB,MAAM,aAAa,CAAA;AAExF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAC/C,OAAO,EAIL,KAAK,uBAAuB,EAC7B,MAAM,wBAAwB,CAAA;AAE/B,MAAM,WAAW,uCAAuC,CAAC,QAAQ,SAAS,OAAO;IAC/E,kFAAkF;IAClF,QAAQ,CAAC,aAAa,EAAE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC1D,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAChE;AA8GD,eAAO,MAAM,2BAA2B,kBAEtC,CAAA;AAEF;;;;;;;GAOG;AACH,wBAAgB,mCAAmC,CAAC,QAAQ,SAAS,OAAO,EAC1E,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,uCAAuC,CAAC,QAAQ,CAAC,GACzD,IAAI,CAw4BN;AAED,wBAAsB,2BAA2B,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2EjG"}
+{"version":3,"file":"object-query-contract.d.ts","sourceRoot":"","sources":["../../src/testing/object-query-contract.ts"],"names":[],"mappings":"AAcA,OAAO,EAA0B,gBAAgB,EAAoB,MAAM,aAAa,CAAA;AAExF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAC/C,OAAO,EAIL,KAAK,uBAAuB,EAC7B,MAAM,wBAAwB,CAAA;AAE/B,MAAM,WAAW,uCAAuC,CAAC,QAAQ,SAAS,OAAO;IAC/E,kFAAkF;IAClF,QAAQ,CAAC,aAAa,EAAE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC1D,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAChE;AA8GD,eAAO,MAAM,2BAA2B,kBAEtC,CAAA;AAEF;;;;;;;GAOG;AACH,wBAAgB,mCAAmC,CAAC,QAAQ,SAAS,OAAO,EAC1E,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,uCAAuC,CAAC,QAAQ,CAAC,GACzD,IAAI,CAslCN;AAED,wBAAsB,2BAA2B,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2EjG"}

package/dist/webhooks/internal.js

@@ -1,12 +1,12 @@
 // @bun
 import {
   createPrimitiveExecutionRecord
-} from "../chunk-4aw0jwk0.js";
+} from "../chunk-f6erf2vv.js";
 import {
   canRetryWebhookRun,
   isStorageSerializationFailure
-} from "../chunk-xmggaxg4.js";
-import"../chunk-fmx1sz2h.js";
+} from "../chunk-1wk20wn3.js";
+import"../chunk-72q2y8hn.js";
 import"../chunk-xc7hq65b.js";
 import"../chunk-cy0n5dms.js";
 import"../chunk-dysw7nsm.js";
@@ -14,13 +14,13 @@ import"../chunk-62c7t4jc.js";
 import {
   WebhookRunError
 } from "../chunk-ezake7g1.js";
-import"../chunk-pxtrxm3p.js";
+import"../chunk-a09jx26t.js";
 import"../chunk-htq0qh7z.js";
 import"../chunk-xkthy56g.js";
-import"../chunk-qer6am8w.js";
-import"../chunk-n5x5y80a.js";
+import"../chunk-xdf9yswn.js";
+import"../chunk-nzw7sm3b.js";
 import"../chunk-t9xghkva.js";
-import"../chunk-kqxgf6kv.js";
+import"../chunk-drjqm1aa.js";
 import"../chunk-5gd7tpv6.js";
 import {
   ExecutionStorageError
@@ -28,19 +28,18 @@ import {
 import"../chunk-9dzba0f2.js";
 import"../chunk-vybf6pkp.js";
 import"../chunk-ry24jbr1.js";
-import"../chunk-6wetht33.js";
 import"../chunk-3j7573mj.js";
 import"../chunk-4gz41why.js";
 import"../chunk-zcnhxkvd.js";
+import"../chunk-t0jjkep3.js";
+import"../chunk-tkdscva6.js";
+import"../chunk-rhrbz7d4.js";
+import"../chunk-xwnf87e1.js";
+import"../chunk-f83ka50g.js";
 import"../chunk-rnshztfq.js";
 import"../chunk-04b07a9q.js";
 import"../chunk-dktq02ne.js";
 import"../chunk-zqysyfjt.js";
-import"../chunk-t0jjkep3.js";
-import"../chunk-d2adj15j.js";
-import"../chunk-rhrbz7d4.js";
-import"../chunk-xwnf87e1.js";
-import"../chunk-4z3n1dzt.js";
 import"../chunk-0172wgm9.js";
 import"../chunk-t8t39h7v.js";
 import"../chunk-y64skrwp.js";
@@ -149,4 +148,4 @@ export {
   admitWebhookRun
 };
 
-//# debugId=A21F13420826A31E64756E2164756E21
+//# debugId=1789834E3012281164756E2164756E21

package/dist/webhooks/internal.js.map

@@ -4,7 +4,7 @@
   "sourcesContent": [
     "import { randomUUID } from \"node:crypto\"\nimport { createPrimitiveExecutionRecord } from \"../execution/durable\"\nimport type { ExecutionRecord, Storage, WebhookRunRecord } from \"../storage\"\nimport {\n  canRetryWebhookRun,\n  ExecutionStorageError,\n  isStorageSerializationFailure,\n  WebhookRunError,\n} from \"../storage\"\n\nconst MAX_ADMISSION_ATTEMPTS = 3\n\nexport interface AdmitWebhookRunInput {\n  readonly projectId: string\n  readonly storage: Storage\n  readonly runId: string\n  readonly connectorId: string\n  readonly webhookId: string\n  readonly method: string\n  readonly route: string\n  readonly requestBodyBytes: number\n  readonly requestBodySha256: string\n  readonly idempotencyKey?: string\n}\n\nexport type AdmitWebhookRunResult =\n  | {\n      readonly status: \"admitted\"\n      readonly run: WebhookRunRecord\n      readonly execution: ExecutionRecord\n      readonly retried: boolean\n    }\n  | {\n      readonly status: \"duplicate\" | \"in_progress\"\n      readonly run: WebhookRunRecord\n    }\n\n/** Persist or reclaim one verified Webhook delivery before its protected handler executes. */\nexport async function admitWebhookRun(input: AdmitWebhookRunInput): Promise<AdmitWebhookRunResult> {\n  assertAdmissionInput(input)\n  let attempt = 0\n\n  // Concurrent deliveries may both observe no run before one transaction commits. Retry only\n  // serialization and uniqueness races so the loser can reload the winning run; every other error\n  // fails immediately, and repeated contention remains bounded by MAX_ADMISSION_ATTEMPTS.\n  while (true) {\n    attempt += 1\n    try {\n      return await input.storage.transaction((tx) => admitWebhookRunTransaction(tx, input), {\n        isolation: \"serializable\",\n      })\n    } catch (error) {\n      if (attempt >= MAX_ADMISSION_ATTEMPTS || !isConcurrentAdmissionConflict(error)) {\n        throw error\n      }\n    }\n  }\n}\n\nasync function admitWebhookRunTransaction(\n  storage: Storage,\n  input: AdmitWebhookRunInput\n): Promise<AdmitWebhookRunResult> {\n  const runs = requireWebhookRunStorage(storage)\n  const existing = input.idempotencyKey\n    ? await runs.getByDelivery({\n        projectId: input.projectId,\n        connectorId: input.connectorId,\n        webhookId: input.webhookId,\n        idempotencyKey: input.idempotencyKey,\n      })\n    : null\n\n  if (existing) {\n    assertSameDelivery(existing, input)\n    if (existing.status === \"running\") return { status: \"in_progress\", run: existing }\n    if (!canRetryWebhookRun(existing)) return { status: \"duplicate\", run: existing }\n\n    const execution = await requireWebhookExecution(storage, existing)\n    const run = await runs.restart({\n      projectId: input.projectId,\n      id: existing.id,\n    })\n    return { status: \"admitted\", run, execution, retried: true }\n  }\n\n  const executionInput = createPrimitiveExecutionRecord({\n    id: `exec_${randomUUID()}`,\n    primitive: { kind: \"webhook\", id: input.route, runId: input.runId },\n    origin: {\n      type: \"automatic\",\n      projectId: input.projectId,\n      source: { type: \"webhook\", deliveryId: input.runId },\n      correlationId: input.runId,\n    },\n  })\n  const execution = await storage.executions.create(executionInput)\n  const run = await runs.start({\n    id: input.runId,\n    projectId: input.projectId,\n    executionId: execution.id,\n    connectorId: input.connectorId,\n    webhookId: input.webhookId,\n    method: input.method,\n    route: input.route,\n    requestBodyBytes: input.requestBodyBytes,\n    requestBodySha256: input.requestBodySha256,\n    idempotencyKey: input.idempotencyKey,\n  })\n  return { status: \"admitted\", run, execution, retried: false }\n}\n\nfunction assertSameDelivery(existing: WebhookRunRecord, input: AdmitWebhookRunInput): void {\n  if (\n    existing.connectorId !== input.connectorId ||\n    existing.webhookId !== input.webhookId ||\n    existing.method !== input.method ||\n    existing.route !== input.route ||\n    existing.requestBodyBytes !== input.requestBodyBytes ||\n    existing.requestBodySha256 !== input.requestBodySha256\n  ) {\n    throw new WebhookRunError(\n      `[Sixb] Webhook delivery '${input.idempotencyKey}' conflicts with run '${existing.id}'.`,\n      \"delivery_conflict\"\n    )\n  }\n}\n\nasync function requireWebhookExecution(\n  storage: Storage,\n  run: WebhookRunRecord\n): Promise<ExecutionRecord> {\n  const execution = await storage.executions.getById({\n    projectId: run.projectId,\n    id: run.executionId,\n  })\n  if (!execution) {\n    throw new WebhookRunError(\n      `[Sixb] Execution '${run.executionId}' for Webhook run '${run.id}' was not found.`,\n      \"invalid_execution\"\n    )\n  }\n  return execution\n}\n\nfunction requireWebhookRunStorage(storage: Storage): NonNullable<Storage[\"webhookRuns\"]> {\n  if (!storage.webhookRuns) {\n    throw new WebhookRunError(\"[Sixb] Webhook run storage is not configured.\")\n  }\n  return storage.webhookRuns\n}\n\nfunction assertAdmissionInput(input: AdmitWebhookRunInput): void {\n  if (input.idempotencyKey !== undefined && !input.idempotencyKey.trim()) {\n    throw new WebhookRunError(\"[Sixb] Webhook idempotency key must not be empty.\")\n  }\n  if (!Number.isSafeInteger(input.requestBodyBytes) || input.requestBodyBytes < 0) {\n    throw new WebhookRunError(\"[Sixb] Webhook request body bytes must be a non-negative integer.\")\n  }\n  if (!/^[a-f0-9]{64}$/.test(input.requestBodySha256)) {\n    throw new WebhookRunError(\"[Sixb] Webhook request body SHA-256 must be lowercase hexadecimal.\")\n  }\n}\n\nfunction isConcurrentAdmissionConflict(error: unknown): boolean {\n  return (\n    isStorageSerializationFailure(error) ||\n    (error instanceof ExecutionStorageError && error.code === \"duplicate_execution\") ||\n    (error instanceof WebhookRunError &&\n      (error.code === \"duplicate_run\" || error.code === \"invalid_transition\"))\n  )\n}\n"
   ],
-  "mappings": "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",
-  "debugId": "A21F13420826A31E64756E2164756E21",
+  "mappings": "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",
+  "debugId": "1789834E3012281164756E2164756E21",
   "names": []
 }

package/dist/workflows/index.js

@@ -7,7 +7,7 @@ import {
   defineWorkflowStep,
   interventionField,
   unwrapWorkflowNodeFailure
-} from "../chunk-c8bw2b6c.js";
+} from "../chunk-hbeh8j9w.js";
 import"../chunk-5sz8ta9r.js";
 import"../chunk-979ww6b3.js";
 import"../chunk-74drx9gd.js";
@@ -40,62 +40,61 @@ import {
   validateWorkflowStepInput,
   validateWorkflowStepOutput,
   validateWorkflowsAtStartup
-} from "../chunk-177ed2mp.js";
-import"../chunk-km4rkj4t.js";
-import"../chunk-261ag4t4.js";
-import"../chunk-3rsf30p4.js";
-import"../chunk-gqdd7508.js";
+} from "../chunk-c43qr6s0.js";
+import"../chunk-g13869yf.js";
+import"../chunk-cbkm2vam.js";
+import"../chunk-pn8n8sba.js";
+import"../chunk-4rh2m6zg.js";
 import"../chunk-xhy826cz.js";
-import"../chunk-f1cyvnrk.js";
-import"../chunk-88ppkr54.js";
-import"../chunk-63te770v.js";
+import"../chunk-7gw7mepb.js";
+import"../chunk-rte5sm3z.js";
+import"../chunk-qewtks41.js";
 import"../chunk-8b55ygje.js";
 import"../chunk-51fjndv0.js";
 import"../chunk-8m5ejdpn.js";
 import"../chunk-nf4r78r4.js";
-import"../chunk-ttba8x6z.js";
-import"../chunk-d6y2wsfg.js";
-import"../chunk-ettb0cy4.js";
+import"../chunk-tycbzedm.js";
+import"../chunk-tek1qwgm.js";
+import"../chunk-afjpa2hs.js";
 import"../chunk-96swp2wd.js";
-import"../chunk-4aw0jwk0.js";
-import"../chunk-xmggaxg4.js";
-import"../chunk-fmx1sz2h.js";
+import"../chunk-f6erf2vv.js";
+import"../chunk-1wk20wn3.js";
+import"../chunk-72q2y8hn.js";
 import"../chunk-xc7hq65b.js";
 import"../chunk-cy0n5dms.js";
 import"../chunk-dysw7nsm.js";
 import"../chunk-62c7t4jc.js";
 import"../chunk-ezake7g1.js";
-import"../chunk-pxtrxm3p.js";
+import"../chunk-a09jx26t.js";
 import"../chunk-htq0qh7z.js";
 import"../chunk-xkthy56g.js";
-import"../chunk-qer6am8w.js";
-import"../chunk-n5x5y80a.js";
+import"../chunk-xdf9yswn.js";
+import"../chunk-nzw7sm3b.js";
 import"../chunk-t9xghkva.js";
-import"../chunk-kqxgf6kv.js";
+import"../chunk-drjqm1aa.js";
 import"../chunk-5gd7tpv6.js";
 import"../chunk-h9kxd41f.js";
 import"../chunk-9dzba0f2.js";
 import"../chunk-vybf6pkp.js";
 import"../chunk-ry24jbr1.js";
-import"../chunk-6wetht33.js";
 import"../chunk-3j7573mj.js";
 import"../chunk-4gz41why.js";
 import"../chunk-zcnhxkvd.js";
 import"../chunk-1evzqhks.js";
 import"../chunk-dsrkgtnh.js";
 import"../chunk-bhxaq2nn.js";
-import"../chunk-rnshztfq.js";
-import"../chunk-04b07a9q.js";
-import"../chunk-dktq02ne.js";
-import"../chunk-zqysyfjt.js";
 import"../chunk-yt8wphsx.js";
 import"../chunk-rdeagz6b.js";
-import"../chunk-zpw39qhj.js";
+import"../chunk-dm72y8wt.js";
 import"../chunk-t0jjkep3.js";
-import"../chunk-d2adj15j.js";
+import"../chunk-tkdscva6.js";
 import"../chunk-rhrbz7d4.js";
 import"../chunk-xwnf87e1.js";
-import"../chunk-4z3n1dzt.js";
+import"../chunk-f83ka50g.js";
+import"../chunk-rnshztfq.js";
+import"../chunk-04b07a9q.js";
+import"../chunk-dktq02ne.js";
+import"../chunk-zqysyfjt.js";
 import"../chunk-0172wgm9.js";
 import"../chunk-t8t39h7v.js";
 import"../chunk-y64skrwp.js";
@@ -136,4 +135,4 @@ export {
   WorkflowDefinitionError
 };
 
-//# debugId=28B83A3228FF218964756E2164756E21
+//# debugId=49C4A15FE91A2DE064756E2164756E21

package/dist/workflows/index.js.map

@@ -4,6 +4,6 @@
   "sourcesContent": [
   ],
   "mappings": "",
-  "debugId": "28B83A3228FF218964756E2164756E21",
+  "debugId": "49C4A15FE91A2DE064756E2164756E21",
   "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sixb/core",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "The ontology-first runtime for Sixb — objects, links, telemetry, actions, and provider contracts",
   "keywords": [
     "sixb",

package/src/agents/builders.ts

@@ -16,10 +16,10 @@ import {
   assertValidAgentToolDescription,
   assertValidAgentToolInput,
   assertValidAgentToolName,
-  assertValidLoopConfig,
   assertValidProviderOptions,
   assertValidReasoningLevel,
   groupIdsFromDefinitions,
+  resolveAgentLoopConfig,
 } from "./validation"
 
 /**
@@ -76,7 +76,7 @@ export function defineAgent<const TId extends string>(
   }
   assertValidReasoningLevel(config.reasoning)
   assertValidProviderOptions(config.providerOptions)
-  assertValidLoopConfig(config.loop)
+  const loop = resolveAgentLoopConfig(config.loop)
   const groupIds = groupIdsFromDefinitions(id, config.groups)
   const tools = toolsFromDefinitions(id, config.tools)
 
@@ -91,6 +91,6 @@ export function defineAgent<const TId extends string>(
     groupIds,
     tools,
     ...(config.description !== undefined ? { description: config.description } : {}),
-    ...(config.loop !== undefined ? { loop: config.loop } : {}),
+    ...(loop !== undefined ? { loop } : {}),
   })
 }

package/src/agents/context-compaction.ts

@@ -0,0 +1,261 @@
+import { stableJsonStringify } from "../json"
+import type { AgentMessageRecord } from "../storage/agents/types"
+import type { AgentMessage, AgentMessagePart } from "./message"
+
+export const AGENT_CONTEXT_ESTIMATOR_VERSION = 1 as const
+
+const CHARS_PER_TOKEN = 4
+const REQUEST_OVERHEAD_TOKENS = 8
+const MESSAGE_OVERHEAD_TOKENS = 8
+const TOOL_OVERHEAD_TOKENS = 16
+const STEP_OVERHEAD_TOKENS = 2
+const IMAGE_ALLOWANCE_TOKENS = 1_200
+const FILE_TEXT_INLINE_MAX_BYTES = 50 * 1024
+const FILE_TEXT_INLINE_TOTAL_MAX_BYTES = 200 * 1024
+const TOOL_RESULT_SUMMARY_MAX_CHARS = 2_000
+
+export interface AgentContextEstimateTool {
+  readonly name: string
+  readonly description: string
+  /** Deterministic JSON-schema serialization sent for this tool. */
+  readonly inputSchema: string
+}
+
+export interface EstimateAgentContextRequestTokensInput {
+  readonly systemPrompt: string
+  readonly tools: readonly AgentContextEstimateTool[]
+  readonly messages: readonly AgentMessage[]
+}
+
+export interface AgentContextTokenEstimate {
+  readonly tokens: number
+  readonly estimatorVersion: typeof AGENT_CONTEXT_ESTIMATOR_VERSION
+}
+
+export interface AgentContextCompactionBoundary {
+  readonly messagesToSummarize: readonly AgentMessageRecord[]
+  readonly retainedMessages: readonly AgentMessageRecord[]
+  readonly summarizedThroughSeq: number
+}
+
+/** Compaction begins only once the estimated request crosses the reserved input budget. */
+export function shouldCompactAgentContext(input: {
+  readonly estimatedInputTokens: number
+  readonly inputBudgetTokens: number
+}): boolean {
+  return input.estimatedInputTokens > input.inputBudgetTokens
+}
+
+/** Estimate the provider request shape with one stable, conservative character heuristic. */
+export function estimateAgentContextRequestTokens(
+  input: EstimateAgentContextRequestTokensInput
+): AgentContextTokenEstimate {
+  const toolTokens = input.tools.reduce(
+    (total, tool) =>
+      total +
+      TOOL_OVERHEAD_TOKENS +
+      textTokens(tool.name) +
+      textTokens(tool.description) +
+      textTokens(tool.inputSchema),
+    0
+  )
+  return {
+    tokens:
+      REQUEST_OVERHEAD_TOKENS +
+      textTokens(input.systemPrompt) +
+      toolTokens +
+      estimateAgentContextMessagesTokens(input.messages).tokens,
+    estimatorVersion: AGENT_CONTEXT_ESTIMATOR_VERSION,
+  }
+}
+
+/** Estimate message-only growth after a provider-usage anchor. */
+export function estimateAgentContextMessagesTokens(
+  messages: readonly AgentMessage[]
+): AgentContextTokenEstimate {
+  const attachments = { textBytesRemaining: FILE_TEXT_INLINE_TOTAL_MAX_BYTES }
+  let tokens = 0
+  for (const message of messages) {
+    tokens += estimateMessageTokens(message, attachments)
+  }
+  return { tokens, estimatorVersion: AGENT_CONTEXT_ESTIMATOR_VERSION }
+}
+
+/** Select the safe user boundary whose retained tail is closest to the configured recent budget. */
+export function selectAgentContextCompactionBoundary(input: {
+  readonly messages: readonly AgentMessageRecord[]
+  readonly keepRecentTokens: number
+}): AgentContextCompactionBoundary | null {
+  if (input.messages.length < 2) return null
+
+  let retainedTokens = 0
+  let boundaryIndex: number | null = null
+  let closestDistance = Number.POSITIVE_INFINITY
+  for (let index = input.messages.length - 1; index > 0; index -= 1) {
+    retainedTokens += estimateAgentContextMessagesTokens([input.messages[index]!]).tokens
+    if (input.messages[index]?.role !== "user") continue
+
+    const distance = Math.abs(input.keepRecentTokens - retainedTokens)
+    if (distance <= closestDistance) {
+      boundaryIndex = index
+      closestDistance = distance
+    }
+    if (retainedTokens >= input.keepRecentTokens) break
+  }
+
+  if (boundaryIndex === null) return null
+
+  const summarizedThroughSeq = input.messages[boundaryIndex - 1]?.seq
+  if (summarizedThroughSeq === undefined) return null
+  return {
+    messagesToSummarize: input.messages.slice(0, boundaryIndex),
+    retainedMessages: input.messages.slice(boundaryIndex),
+    summarizedThroughSeq,
+  }
+}
+
+/** Serialize durable conversation content as escaped quoted data for the summary model. */
+export function serializeAgentMessagesForSummary(messages: readonly AgentMessageRecord[]): string {
+  const lines = ["<sixb_conversation_history>"]
+  for (const message of messages) {
+    lines.push(
+      `  <message id="${escapeXml(message.id)}" seq="${message.seq}" role="${message.role}">`
+    )
+    message.parts.forEach((part, partIndex) => {
+      lines.push(...serializeSummaryPart(message, part, partIndex))
+    })
+    lines.push("  </message>")
+  }
+  lines.push("</sixb_conversation_history>")
+  return lines.join("\n")
+}
+
+function estimateMessageTokens(
+  message: AgentMessage,
+  attachments: { textBytesRemaining: number }
+): number {
+  let tokens = MESSAGE_OVERHEAD_TOKENS
+  for (const part of message.parts) {
+    switch (part.type) {
+      case "text":
+      case "reasoning":
+        tokens += textTokens(part.text)
+        break
+      case "step-start":
+        tokens += STEP_OVERHEAD_TOKENS
+        break
+      case "context":
+        tokens += textTokens(stableJsonStringify(part.context))
+        break
+      case "tool-call":
+        tokens +=
+          TOOL_OVERHEAD_TOKENS +
+          textTokens(part.toolName) +
+          textTokens(stableJsonStringify(part.input)) +
+          (part.state === "output-available"
+            ? textTokens(stableJsonStringify(part.output))
+            : textTokens(part.errorText))
+        break
+      case "file": {
+        const file = part.fileRef
+        tokens += textTokens(
+          [file.blobId, file.digest, file.fileName, file.mediaType, file.logicalPath]
+            .filter((value): value is string => value !== undefined)
+            .join(" ")
+        )
+        if (message.role !== "assistant") {
+          if (looksLikeImage(file.mediaType, file.fileName)) {
+            tokens += IMAGE_ALLOWANCE_TOKENS
+          } else {
+            const inlineBytes = Math.min(
+              file.sizeBytes,
+              FILE_TEXT_INLINE_MAX_BYTES,
+              attachments.textBytesRemaining
+            )
+            attachments.textBytesRemaining -= inlineBytes
+            tokens += Math.ceil(inlineBytes / CHARS_PER_TOKEN)
+          }
+        }
+        break
+      }
+    }
+  }
+  return tokens
+}
+
+function serializeSummaryPart(
+  message: AgentMessageRecord,
+  part: AgentMessagePart,
+  partIndex: number
+): string[] {
+  const indent = "    "
+  switch (part.type) {
+    case "text":
+      return [`${indent}<text>${escapeXml(part.text)}</text>`]
+    case "reasoning":
+    case "step-start":
+      return []
+    case "context":
+      return part.context.kind === "object"
+        ? [
+            `${indent}<object_context origin="${part.origin}" object_type_id="${escapeXml(part.context.ref.objectTypeId)}" primary_id="${escapeXml(part.context.ref.primaryId)}" />`,
+          ]
+        : [
+            `${indent}<app_context origin="${part.origin}" id="${escapeXml(part.context.id)}" label="${escapeXml(part.context.label)}">`,
+            `${indent}  <description>${escapeXml(part.context.description)}</description>`,
+            `${indent}  <value format="json">${escapeXml(stableJsonStringify(part.context.value))}</value>`,
+            `${indent}</app_context>`,
+          ]
+    case "file": {
+      const file = part.fileRef
+      const attributes = [
+        `message_id="${escapeXml(message.id)}"`,
+        `part_index="${partIndex}"`,
+        `blob_id="${escapeXml(file.blobId)}"`,
+        `digest="${escapeXml(file.digest)}"`,
+        `size_bytes="${file.sizeBytes}"`,
+        ...(file.fileName === undefined ? [] : [`file_name="${escapeXml(file.fileName)}"`]),
+        ...(file.mediaType === undefined ? [] : [`media_type="${escapeXml(file.mediaType)}"`]),
+        ...(file.logicalPath === undefined
+          ? []
+          : [`logical_path="${escapeXml(file.logicalPath)}"`]),
+      ]
+      return [`${indent}<file ${attributes.join(" ")} />`]
+    }
+    case "tool-call": {
+      const output =
+        part.state === "output-available"
+          ? truncateToolResult(stableJsonStringify(part.output))
+          : truncateToolResult(part.errorText)
+      return [
+        `${indent}<tool_call id="${escapeXml(part.toolCallId)}" name="${escapeXml(part.toolName)}" state="${part.state}">`,
+        `${indent}  <input format="json">${escapeXml(stableJsonStringify(part.input))}</input>`,
+        `${indent}  <result>${escapeXml(output)}</result>`,
+        `${indent}</tool_call>`,
+      ]
+    }
+  }
+}
+
+function truncateToolResult(value: string): string {
+  if (value.length <= TOOL_RESULT_SUMMARY_MAX_CHARS) return value
+  return `${value.slice(0, TOOL_RESULT_SUMMARY_MAX_CHARS)}\n[truncated ${value.length - TOOL_RESULT_SUMMARY_MAX_CHARS} characters]`
+}
+
+function looksLikeImage(mediaType: string | undefined, fileName: string | undefined): boolean {
+  if (mediaType?.toLowerCase().startsWith("image/")) return true
+  return /\.(?:avif|gif|jpe?g|png|webp)$/i.test(fileName ?? "")
+}
+
+function textTokens(value: string): number {
+  return Math.ceil(new TextEncoder().encode(value).byteLength / CHARS_PER_TOKEN)
+}
+
+function escapeXml(value: string): string {
+  return value
+    .replaceAll("&", "&amp;")
+    .replaceAll("<", "&lt;")
+    .replaceAll(">", "&gt;")
+    .replaceAll('"', "&quot;")
+    .replaceAll("'", "&apos;")
+}

package/src/agents/ids.ts

@@ -18,6 +18,11 @@ export function createAgentMessageId(): string {
   return `agt_msg_${randomUUID()}`
 }
 
+/** One deterministic context-checkpoint identity per conversational run. */
+export function agentContextCheckpointId(runId: string): string {
+  return `agt_ctx_${runId}`
+}
+
 /** A queue delivery's fencing token for writes to an `agent_runs` record. */
 export function createAgentRunExecutionToken(): string {
   return `agt_exec_${randomUUID()}`

package/src/agents/index.ts

@@ -53,6 +53,20 @@ export {
   MAX_AGENT_CONTEXT_ENTRIES,
   normalizeAgentContextEntries,
 } from "./context"
+export type {
+  AgentContextCompactionBoundary,
+  AgentContextEstimateTool,
+  AgentContextTokenEstimate,
+  EstimateAgentContextRequestTokensInput,
+} from "./context-compaction"
+export {
+  AGENT_CONTEXT_ESTIMATOR_VERSION,
+  estimateAgentContextMessagesTokens,
+  estimateAgentContextRequestTokens,
+  selectAgentContextCompactionBoundary,
+  serializeAgentMessagesForSummary,
+  shouldCompactAgentContext,
+} from "./context-compaction"
 export { serializeAgentContextForModel } from "./context-model"
 export { resolveAgentContextParts } from "./context-resolution"
 export type {
@@ -75,6 +89,7 @@ export {
   AgentToolResultValidationError,
 } from "./errors"
 export {
+  agentContextCheckpointId,
   createAgentMessageId,
   createAgentRunExecutionToken,
   createAgentRunId,
@@ -93,15 +108,6 @@ export {
   type AgentToolCallPart,
   type AgentToolCallState,
 } from "./message"
-export {
-  type BuildAgentSystemPromptInput,
-  type BuildWorkflowOutputFinalizerPromptInput,
-  buildAgentSystemPrompt,
-  buildWorkflowOutputFinalizerPrompt,
-  DEFAULT_AGENT_SYSTEM_CONTEXT,
-  DEFAULT_AGENT_WORKFLOW_SYSTEM_CONTEXT,
-  DEFAULT_WORKFLOW_OUTPUT_FINALIZER_SYSTEM_CONTEXT,
-} from "./prompt"
 export {
   type RequestAgentRunInput,
   type RequestAgentRunResult,
@@ -109,6 +115,7 @@ export {
   retryAgentRun,
 } from "./request"
 export type {
+  AgentCompactionFailureCode,
   AgentRunControlStreamId,
   AgentRunFailure,
   AgentRunFinishedEvent,
@@ -116,6 +123,7 @@ export type {
   AgentRunStreamId,
 } from "./streams"
 export {
+  AGENT_COMPACTION_FAILURE_CODES,
   AGENT_RUN_CANCEL_RECORD,
   AGENT_RUN_STREAM_SCHEMA_VERSION,
   agentRunControlStreamDefinition,
@@ -137,6 +145,7 @@ export type {
 export { projectAgentThreadModelContext } from "./thread-context-projection"
 export { isAgentToolResult } from "./tool-result"
 export type {
+  AgentContextConfig,
   AgentDefinition,
   AgentLoopConfig,
   AgentReasoningLevel,