@sixb/core 0.1.5 → 0.1.7

package/dist/chunk-xdf9yswn.js.map

@@ -1,11 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../src/storage/agents/errors.ts", "../src/storage/agents/provider.ts"],
-  "sourcesContent": [
-    "export type AgentStorageErrorCode =\n  | \"thread_not_found\"\n  | \"active_run_exists\"\n  | \"run_not_found\"\n  | \"invalid_input\"\n  | \"invalid_state\"\n  | \"execution_lost\"\n  | \"duplicate_id\"\n\n/**\n * Error for agent-storage invariants and invalid state transitions (single-flight, execution\n * ownership, run lifecycle, message append). Callers branch on `code` rather than message text.\n */\nexport class AgentStorageError extends Error {\n  readonly name = \"AgentStorageError\"\n\n  constructor(\n    readonly code: AgentStorageErrorCode,\n    message: string\n  ) {\n    super(message)\n  }\n}\n",
-    "import { agentServiceAccountId } from \"../../agents/authority\"\nimport type { ExecutionStorage } from \"../executions\"\nimport { findAgentRunExecution } from \"../executions/run-link\"\nimport { AgentStorageError } from \"./errors\"\nimport type {\n  AgentContextCheckpointRecord,\n  AgentMessageRecord,\n  AgentRunRecord,\n  AgentThreadRecord,\n  CreateAgentContextCheckpointInput,\n} from \"./types\"\n\n/** Validate the semantic link between a conversational Agent run and its immutable execution. */\nexport async function assertAgentRunExecution(input: {\n  readonly executions: ExecutionStorage\n  readonly projectId: string\n  readonly executionId: string\n  readonly runId: string\n  readonly agentId: string\n}): Promise<void> {\n  const execution = await findAgentRunExecution({\n    executions: input.executions,\n    projectId: input.projectId,\n    executionId: input.executionId,\n    runId: input.runId,\n    serviceAccountId: agentServiceAccountId(input.agentId),\n  })\n  if (!execution) {\n    throw new AgentStorageError(\n      \"invalid_input\",\n      `[Sixb] Execution '${input.executionId}' does not authorize Agent run '${input.runId}'.`\n    )\n  }\n}\n\n/** Validate provider-independent checkpoint fields before entering a storage critical section. */\nexport function assertCreateAgentContextCheckpointInput(\n  input: CreateAgentContextCheckpointInput,\n  prefix = \"Sixb\"\n): void {\n  for (const [name, value] of [\n    [\"id\", input.id],\n    [\"projectId\", input.projectId],\n    [\"threadId\", input.threadId],\n    [\"createdByRunId\", input.createdByRunId],\n    [\"executionToken\", input.executionToken],\n    [\"summary\", input.summary],\n    [\"summaryModelId\", input.summaryModelId],\n  ] as const) {\n    if (value.trim().length === 0) {\n      throw new AgentStorageError(\n        \"invalid_input\",\n        `[${prefix}] Agent context checkpoint '${name}' must not be empty.`\n      )\n    }\n  }\n\n  if (input.summaryFormatVersion !== 1) {\n    throw new AgentStorageError(\n      \"invalid_input\",\n      `[${prefix}] Agent context checkpoint summary format version must be 1.`\n    )\n  }\n  if (input.reason !== \"threshold\" && input.reason !== \"overflow\") {\n    throw new AgentStorageError(\n      \"invalid_input\",\n      `[${prefix}] Agent context checkpoint reason must be 'threshold' or 'overflow'.`\n    )\n  }\n  if (\n    input.expectedPreviousCheckpointId !== null &&\n    input.expectedPreviousCheckpointId.trim().length === 0\n  ) {\n    throw new AgentStorageError(\n      \"invalid_input\",\n      `[${prefix}] Agent context checkpoint expected previous id must not be empty.`\n    )\n  }\n  if (input.createdAt && !Number.isFinite(input.createdAt.getTime())) {\n    throw new AgentStorageError(\n      \"invalid_input\",\n      `[${prefix}] Agent context checkpoint createdAt must be a valid date.`\n    )\n  }\n\n  for (const [name, value, minimum] of [\n    [\"expectedHeadSeq\", input.expectedHeadSeq, 1],\n    [\"summarizedThroughSeq\", input.summarizedThroughSeq, 1],\n    [\"observedHeadSeq\", input.observedHeadSeq, 1],\n    [\"estimatedInputTokensBefore\", input.estimatedInputTokensBefore, 0],\n    [\"estimatedInputTokensAfter\", input.estimatedInputTokensAfter, 0],\n  ] as const) {\n    if (!Number.isSafeInteger(value) || value < minimum) {\n      throw new AgentStorageError(\n        \"invalid_input\",\n        `[${prefix}] Agent context checkpoint '${name}' must be a safe integer greater than or equal to ${minimum}.`\n      )\n    }\n  }\n\n  if (input.observedHeadSeq !== input.expectedHeadSeq) {\n    throw new AgentStorageError(\n      \"invalid_input\",\n      `[${prefix}] Agent context checkpoint observed head must equal its expected message head.`\n    )\n  }\n  if (input.summarizedThroughSeq >= input.observedHeadSeq) {\n    throw new AgentStorageError(\n      \"invalid_input\",\n      `[${prefix}] Agent context checkpoint must retain the triggering head message.`\n    )\n  }\n}\n\n/** Assert that the current delivery still owns the active conversational run. */\nexport function assertAgentContextCheckpointAuthority(input: {\n  readonly create: CreateAgentContextCheckpointInput\n  readonly run: AgentRunRecord | null\n  readonly thread: AgentThreadRecord | null\n  readonly prefix?: string\n}): asserts input is typeof input & {\n  readonly run: AgentRunRecord\n  readonly thread: AgentThreadRecord\n} {\n  const { create, run, thread } = input\n  const prefix = input.prefix ?? \"Sixb\"\n  if (!run) {\n    throw new AgentStorageError(\n      \"run_not_found\",\n      `[${prefix}] Agent run '${create.createdByRunId}' not found for project '${create.projectId}'.`\n    )\n  }\n  if (!thread) {\n    throw new AgentStorageError(\n      \"thread_not_found\",\n      `[${prefix}] Agent thread '${create.threadId}' not found for project '${create.projectId}'.`\n    )\n  }\n  if (run.threadId !== create.threadId) {\n    throw new AgentStorageError(\n      \"invalid_input\",\n      `[${prefix}] Agent run '${run.id}' does not belong to thread '${create.threadId}'.`\n    )\n  }\n  if (run.status !== \"running\") {\n    throw new AgentStorageError(\n      \"invalid_state\",\n      `[${prefix}] Agent run '${run.id}' is not running (status '${run.status}').`\n    )\n  }\n  if (!run.execution || run.execution.token !== create.executionToken) {\n    throw new AgentStorageError(\n      \"execution_lost\",\n      `[${prefix}] Execution token is no longer current on agent run '${run.id}'.`\n    )\n  }\n  if (thread.activeRunId !== run.id) {\n    throw new AgentStorageError(\n      \"invalid_state\",\n      `[${prefix}] Agent run '${run.id}' no longer owns thread '${thread.id}'.`\n    )\n  }\n}\n\n/** Assert both compare-and-swap anchors and the retained-turn boundary. */\nexport function assertAgentContextCheckpointAnchors(input: {\n  readonly create: CreateAgentContextCheckpointInput\n  readonly latest: AgentContextCheckpointRecord | null\n  readonly headSeq: number\n  readonly firstRetained: AgentMessageRecord | null\n  readonly prefix?: string\n}): void {\n  const { create, latest, headSeq, firstRetained } = input\n  const prefix = input.prefix ?? \"Sixb\"\n  if (headSeq !== create.expectedHeadSeq) {\n    throw new AgentStorageError(\n      \"invalid_state\",\n      `[${prefix}] Agent thread '${create.threadId}' message head changed from ${create.expectedHeadSeq} to ${headSeq}.`\n    )\n  }\n\n  const latestId = latest?.id ?? null\n  if (latestId !== create.expectedPreviousCheckpointId) {\n    throw new AgentStorageError(\n      \"invalid_state\",\n      `[${prefix}] Agent thread '${create.threadId}' checkpoint head changed.`\n    )\n  }\n  if (latest && create.summarizedThroughSeq <= latest.summarizedThroughSeq) {\n    throw new AgentStorageError(\n      \"invalid_input\",\n      `[${prefix}] Agent context checkpoint boundary must advance beyond sequence ${latest.summarizedThroughSeq}.`\n    )\n  }\n  if (!firstRetained || firstRetained.seq !== create.summarizedThroughSeq + 1) {\n    throw new AgentStorageError(\n      \"invalid_state\",\n      `[${prefix}] Agent context checkpoint boundary does not align with stored thread messages.`\n    )\n  }\n  if (firstRetained.role !== \"user\") {\n    throw new AgentStorageError(\n      \"invalid_input\",\n      `[${prefix}] Agent context checkpoint must retain a complete turn beginning with a user message.`\n    )\n  }\n}\n\n/** Validate the mutable anchors again before returning an idempotently created checkpoint. */\nexport function assertAgentContextCheckpointReplayState(input: {\n  readonly create: CreateAgentContextCheckpointInput\n  readonly existing: AgentContextCheckpointRecord\n  readonly latest: AgentContextCheckpointRecord | null\n  readonly headSeq: number\n  readonly prefix?: string\n}): void {\n  const prefix = input.prefix ?? \"Sixb\"\n  if (input.headSeq !== input.create.expectedHeadSeq) {\n    throw new AgentStorageError(\n      \"invalid_state\",\n      `[${prefix}] Agent thread '${input.create.threadId}' message head changed from ${input.create.expectedHeadSeq} to ${input.headSeq}.`\n    )\n  }\n  if (input.latest?.id !== input.existing.id) {\n    throw new AgentStorageError(\n      \"invalid_state\",\n      `[${prefix}] Agent thread '${input.create.threadId}' checkpoint head changed after '${input.existing.id}'.`\n    )\n  }\n}\n\n/** Compare the durable semantic payload; delivery token and generated timestamp are not content. */\nexport function agentContextCheckpointMatchesCreateInput(\n  record: AgentContextCheckpointRecord,\n  input: CreateAgentContextCheckpointInput\n): boolean {\n  return (\n    record.id === input.id &&\n    record.projectId === input.projectId &&\n    record.threadId === input.threadId &&\n    record.createdByRunId === input.createdByRunId &&\n    (record.previousCheckpointId ?? null) === input.expectedPreviousCheckpointId &&\n    record.reason === input.reason &&\n    record.summary === input.summary &&\n    record.summaryFormatVersion === input.summaryFormatVersion &&\n    record.summarizedThroughSeq === input.summarizedThroughSeq &&\n    record.observedHeadSeq === input.observedHeadSeq &&\n    record.estimatedInputTokensBefore === input.estimatedInputTokensBefore &&\n    record.estimatedInputTokensAfter === input.estimatedInputTokensAfter &&\n    record.summaryModelId === input.summaryModelId\n  )\n}\n"
-  ],
-  "mappings": "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",
-  "debugId": "C4E16AF3EE9252A464756E2164756E21",
-  "names": []
-}