@truefoundry/trueforge-core 0.0.0 → 0.1.0

package/dist/agent-session/schemas/turn.js

@@ -0,0 +1,131 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/agent-session/schemas/turn.ts
+var turn_exports = {};
+__export(turn_exports, {
+  CancellationReason: () => CancellationReason,
+  CreateTurnRequestSchema: () => CreateTurnRequestSchema,
+  TurnInputItemSchema: () => TurnInputItemSchema,
+  TurnMetricsSchema: () => TurnMetricsSchema,
+  TurnSchema: () => TurnSchema,
+  TurnStateCancelledReasonSchema: () => TurnStateCancelledReasonSchema,
+  TurnStateCancelledSchema: () => TurnStateCancelledSchema,
+  TurnStateDoneSchema: () => TurnStateDoneSchema,
+  TurnStateErrorSchema: () => TurnStateErrorSchema,
+  TurnStateRunningSchema: () => TurnStateRunningSchema,
+  TurnStateSchema: () => TurnStateSchema
+});
+module.exports = __toCommonJS(turn_exports);
+var import_zod_openapi = require("@hono/zod-openapi");
+var import_schema = require("../../core/events/schema.js");
+var CancellationReason = /* @__PURE__ */ ((CancellationReason2) => {
+  CancellationReason2["ServerExecutionTimeout"] = "server-execution-timeout";
+  CancellationReason2["ClientCancelled"] = "client-cancelled";
+  CancellationReason2["CancelledForNextTurn"] = "cancelled-for-next-turn";
+  CancellationReason2["Abandoned"] = "abandoned";
+  return CancellationReason2;
+})(CancellationReason || {});
+var TurnStateRunningSchema = import_zod_openapi.z.object({
+  status: import_zod_openapi.z.literal("running").describe("Turn is still executing.")
+}).openapi("TurnStateRunning");
+var TurnStateCancelledReasonSchema = import_zod_openapi.z.enum(CancellationReason).describe("Reason for the cancellation.").openapi("TurnStateCancelledReason");
+var TurnMetricsSchema = import_zod_openapi.z.object({
+  total_input_tokens: import_zod_openapi.z.number().int().nonnegative().optional().describe("Total input tokens across model calls in this turn."),
+  total_output_tokens: import_zod_openapi.z.number().int().nonnegative().optional().describe("Total output tokens across model calls in this turn."),
+  total_tokens: import_zod_openapi.z.number().int().nonnegative().optional().describe("Total tokens (input + output) across model calls in this turn."),
+  total_cache_read_tokens: import_zod_openapi.z.number().int().nonnegative().optional().describe("Total cache-read tokens across model calls in this turn."),
+  total_cache_write_tokens: import_zod_openapi.z.number().int().nonnegative().optional().describe("Total cache-write tokens across model calls in this turn."),
+  total_reasoning_tokens: import_zod_openapi.z.number().int().nonnegative().optional().describe("Total reasoning tokens across model calls in this turn."),
+  total_cost_in_usd: import_zod_openapi.z.number().nonnegative().optional().describe("Estimated total cost in USD for this turn.")
+}).openapi("TurnMetrics");
+var TurnStateCancelledSchema = import_zod_openapi.z.object({
+  status: import_zod_openapi.z.literal("cancelled").describe("Turn was cancelled before completion."),
+  reason: TurnStateCancelledReasonSchema,
+  completed_at: import_zod_openapi.z.string().describe("ISO 8601 time when cancellation completed."),
+  metrics: TurnMetricsSchema.optional().describe("Optional billable aggregate for work done before cancel.")
+}).openapi("TurnStateCancelled");
+var TurnStateErrorSchema = import_zod_openapi.z.object({
+  status: import_zod_openapi.z.literal("error").describe("Turn ended with an error."),
+  message: import_zod_openapi.z.string().describe("Human-readable error message."),
+  completed_at: import_zod_openapi.z.string().describe("ISO 8601 time when the error state was recorded."),
+  metrics: TurnMetricsSchema.optional().describe("Optional billable aggregate for work done before the error.")
+}).openapi("TurnStateError");
+var TurnStateDoneSchema = import_zod_openapi.z.object({
+  status: import_zod_openapi.z.literal("done").describe("Turn finished (possibly paused for required actions)."),
+  output: import_zod_openapi.z.union([import_schema.ModelMessageEventSchema, import_zod_openapi.z.null()]).describe("Final `model.message` for the turn, or null when the turn ended paused without a final message."),
+  required_actions: import_zod_openapi.z.array(import_schema.ActionRequiredEventSchema).describe(
+    "Pending actions (`tool.approval_required`, `tool.response_required`, `mcp.auth_required`); empty when none."
+  ),
+  completed_at: import_zod_openapi.z.string().describe("ISO 8601 time when the turn reached a terminal state."),
+  metrics: TurnMetricsSchema.optional().describe("Optional billable aggregate for the whole turn.")
+}).openapi("TurnStateDone");
+var TurnStateSchema = import_zod_openapi.z.discriminatedUnion("status", [
+  TurnStateRunningSchema,
+  TurnStateDoneSchema,
+  TurnStateCancelledSchema,
+  TurnStateErrorSchema
+]).openapi("TurnState");
+var TurnInputItemSchema = import_zod_openapi.z.discriminatedUnion("type", [
+  import_schema.AgentInputUserMessageSchema,
+  import_schema.UserToolApprovalMessageSchema,
+  import_schema.UserToolResponseMessageSchema
+]).openapi("TurnInputItem");
+var TurnSchema = import_zod_openapi.z.object({
+  id: import_zod_openapi.z.string().describe("Unique turn id."),
+  session_id: import_zod_openapi.z.string().describe("Session that owns this turn."),
+  previous_turn_id: import_zod_openapi.z.string().nullable().describe("Prior turn this turn chains from; null for a root turn."),
+  input: import_zod_openapi.z.array(TurnInputItemSchema).optional().describe("Input items supplied when the turn was created."),
+  state: TurnStateSchema,
+  created_at: import_zod_openapi.z.string().describe("ISO 8601 creation timestamp.")
+}).openapi("Turn");
+var CreateTurnRequestSchema = import_zod_openapi.z.object({
+  input: import_zod_openapi.z.array(TurnInputItemSchema).optional().describe(
+    "Turn input items: user messages and/or approval/tool-response resumes. Do not mix user messages with approval or tool-response items."
+  ),
+  previous_turn_id: import_zod_openapi.z.union([import_zod_openapi.z.literal("auto"), import_zod_openapi.z.literal("none"), import_zod_openapi.z.string().min(1)]).optional().default("auto").describe(`Defaults to 'auto' (chain to session last turn). Use 'none' for a new root turn.`).openapi("PreviousTurnIdInput"),
+  stream: import_zod_openapi.z.boolean().optional().default(true).describe("When true (default), stream turn events as SSE. When false, return the running turn immediately.")
+}).superRefine((data, ctx) => {
+  if (!data.input) return;
+  const hasUser = data.input.some((msg) => "type" in msg && msg.type === "user.message");
+  const hasApprovalOrToolResponse = data.input.some(
+    (msg) => "type" in msg && (msg.type === "user.tool_approval" || msg.type === "user.tool_response")
+  );
+  if (hasUser && hasApprovalOrToolResponse) {
+    ctx.addIssue({
+      code: "custom",
+      message: "input must not mix user messages with approval decisions or client-side tool responses"
+    });
+  }
+}).openapi("CreateTurnRequest");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CancellationReason,
+  CreateTurnRequestSchema,
+  TurnInputItemSchema,
+  TurnMetricsSchema,
+  TurnSchema,
+  TurnStateCancelledReasonSchema,
+  TurnStateCancelledSchema,
+  TurnStateDoneSchema,
+  TurnStateErrorSchema,
+  TurnStateRunningSchema,
+  TurnStateSchema
+});
+//# sourceMappingURL=turn.js.map

package/dist/agent-session/schemas/turn.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/agent-session/schemas/turn.ts"],"sourcesContent":["/** Turn product schemas: turn state, input items, and create-turn request. */\nimport { z } from '@hono/zod-openapi';\nimport {\n  ActionRequiredEventSchema,\n  AgentInputUserMessageSchema,\n  ModelMessageEventSchema,\n  UserToolApprovalMessageSchema,\n  UserToolResponseMessageSchema,\n} from '../../core/events/schema';\n\nexport enum CancellationReason {\n  // AbortController.abort() reason for the max-execution timer.\n  ServerExecutionTimeout = 'server-execution-timeout',\n  // Emitted when the client cancels the run.\n  ClientCancelled = 'client-cancelled',\n  // Prior turn aborted because the client started a new turn.\n  CancelledForNextTurn = 'cancelled-for-next-turn',\n  // Process shutting down (SIGTERM/SIGINT).\n  Abandoned = 'abandoned',\n}\n\nexport const TurnStateRunningSchema = z\n  .object({\n    status: z.literal('running').describe('Turn is still executing.'),\n  })\n  .openapi('TurnStateRunning');\n\nexport const TurnStateCancelledReasonSchema = z\n  .enum(CancellationReason)\n  .describe('Reason for the cancellation.')\n  .openapi('TurnStateCancelledReason');\n\n/** Billable aggregate for one turn. */\nexport const TurnMetricsSchema = z\n  .object({\n    total_input_tokens: z\n      .number()\n      .int()\n      .nonnegative()\n      .optional()\n      .describe('Total input tokens across model calls in this turn.'),\n    total_output_tokens: z\n      .number()\n      .int()\n      .nonnegative()\n      .optional()\n      .describe('Total output tokens across model calls in this turn.'),\n    total_tokens: z\n      .number()\n      .int()\n      .nonnegative()\n      .optional()\n      .describe('Total tokens (input + output) across model calls in this turn.'),\n    total_cache_read_tokens: z\n      .number()\n      .int()\n      .nonnegative()\n      .optional()\n      .describe('Total cache-read tokens across model calls in this turn.'),\n    total_cache_write_tokens: z\n      .number()\n      .int()\n      .nonnegative()\n      .optional()\n      .describe('Total cache-write tokens across model calls in this turn.'),\n    total_reasoning_tokens: z\n      .number()\n      .int()\n      .nonnegative()\n      .optional()\n      .describe('Total reasoning tokens across model calls in this turn.'),\n    total_cost_in_usd: z.number().nonnegative().optional().describe('Estimated total cost in USD for this turn.'),\n  })\n  .openapi('TurnMetrics');\n\nexport const TurnStateCancelledSchema = z\n  .object({\n    status: z.literal('cancelled').describe('Turn was cancelled before completion.'),\n    reason: TurnStateCancelledReasonSchema,\n    completed_at: z.string().describe('ISO 8601 time when cancellation completed.'),\n    metrics: TurnMetricsSchema.optional().describe('Optional billable aggregate for work done before cancel.'),\n  })\n  .openapi('TurnStateCancelled');\n\nexport const TurnStateErrorSchema = z\n  .object({\n    status: z.literal('error').describe('Turn ended with an error.'),\n    message: z.string().describe('Human-readable error message.'),\n    completed_at: z.string().describe('ISO 8601 time when the error state was recorded.'),\n    metrics: TurnMetricsSchema.optional().describe('Optional billable aggregate for work done before the error.'),\n  })\n  .openapi('TurnStateError');\n\nexport const TurnStateDoneSchema = z\n  .object({\n    status: z.literal('done').describe('Turn finished (possibly paused for required actions).'),\n    output: z\n      .union([ModelMessageEventSchema, z.null()])\n      .describe('Final `model.message` for the turn, or null when the turn ended paused without a final message.'),\n    required_actions: z\n      .array(ActionRequiredEventSchema)\n      .describe(\n        'Pending actions (`tool.approval_required`, `tool.response_required`, `mcp.auth_required`); empty when none.',\n      ),\n    completed_at: z.string().describe('ISO 8601 time when the turn reached a terminal state.'),\n    metrics: TurnMetricsSchema.optional().describe('Optional billable aggregate for the whole turn.'),\n  })\n  .openapi('TurnStateDone');\n\nexport const TurnStateSchema = z\n  .discriminatedUnion('status', [\n    TurnStateRunningSchema,\n    TurnStateDoneSchema,\n    TurnStateCancelledSchema,\n    TurnStateErrorSchema,\n  ])\n  .openapi('TurnState');\n\nexport const TurnInputItemSchema = z\n  .discriminatedUnion('type', [\n    AgentInputUserMessageSchema,\n    UserToolApprovalMessageSchema,\n    UserToolResponseMessageSchema,\n  ])\n  .openapi('TurnInputItem');\n\nexport const TurnSchema = z\n  .object({\n    id: z.string().describe('Unique turn id.'),\n    session_id: z.string().describe('Session that owns this turn.'),\n    previous_turn_id: z.string().nullable().describe('Prior turn this turn chains from; null for a root turn.'),\n    input: z.array(TurnInputItemSchema).optional().describe('Input items supplied when the turn was created.'),\n    state: TurnStateSchema,\n    created_at: z.string().describe('ISO 8601 creation timestamp.'),\n  })\n  .openapi('Turn');\n\n/**\n * Wire type for the previous_turn_id field. Includes the default so the schema\n * can be referenced directly without re-wrapping (re-wrapping strips the $ref).\n */\nexport const CreateTurnRequestSchema = z\n  .object({\n    input: z\n      .array(TurnInputItemSchema)\n      .optional()\n      .describe(\n        'Turn input items: user messages and/or approval/tool-response resumes. Do not mix user messages with approval or tool-response items.',\n      ),\n    previous_turn_id: z\n      .union([z.literal('auto'), z.literal('none'), z.string().min(1)])\n      .optional()\n      .default('auto')\n      .describe(`Defaults to 'auto' (chain to session last turn). Use 'none' for a new root turn.`)\n      .openapi('PreviousTurnIdInput'),\n    stream: z\n      .boolean()\n      .optional()\n      .default(true)\n      .describe('When true (default), stream turn events as SSE. When false, return the running turn immediately.'),\n  })\n  .superRefine((data, ctx) => {\n    if (!data.input) return;\n    const hasUser = data.input.some(msg => 'type' in msg && msg.type === 'user.message');\n    const hasApprovalOrToolResponse = data.input.some(\n      msg => 'type' in msg && (msg.type === 'user.tool_approval' || msg.type === 'user.tool_response'),\n    );\n    if (hasUser && hasApprovalOrToolResponse) {\n      ctx.addIssue({\n        code: 'custom',\n        message: 'input must not mix user messages with approval decisions or client-side tool responses',\n      });\n    }\n  })\n  .openapi('CreateTurnRequest');\n\nexport type Turn = z.infer<typeof TurnSchema>;\nexport type TurnInputItem = z.infer<typeof TurnInputItemSchema>;\nexport type TurnState = z.infer<typeof TurnStateSchema>;\nexport type TerminalTurnState = Exclude<TurnState, { status: 'running' }>;\nexport type TurnMetrics = z.infer<typeof TurnMetricsSchema>;\n"],"mappings":"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","names":["CancellationReason"]}

package/dist/agent-session/schemas/turn.mjs

@@ -0,0 +1,102 @@
+// src/agent-session/schemas/turn.ts
+import { z } from "@hono/zod-openapi";
+import {
+  ActionRequiredEventSchema,
+  AgentInputUserMessageSchema,
+  ModelMessageEventSchema,
+  UserToolApprovalMessageSchema,
+  UserToolResponseMessageSchema
+} from "../../core/events/schema.mjs";
+var CancellationReason = /* @__PURE__ */ ((CancellationReason2) => {
+  CancellationReason2["ServerExecutionTimeout"] = "server-execution-timeout";
+  CancellationReason2["ClientCancelled"] = "client-cancelled";
+  CancellationReason2["CancelledForNextTurn"] = "cancelled-for-next-turn";
+  CancellationReason2["Abandoned"] = "abandoned";
+  return CancellationReason2;
+})(CancellationReason || {});
+var TurnStateRunningSchema = z.object({
+  status: z.literal("running").describe("Turn is still executing.")
+}).openapi("TurnStateRunning");
+var TurnStateCancelledReasonSchema = z.enum(CancellationReason).describe("Reason for the cancellation.").openapi("TurnStateCancelledReason");
+var TurnMetricsSchema = z.object({
+  total_input_tokens: z.number().int().nonnegative().optional().describe("Total input tokens across model calls in this turn."),
+  total_output_tokens: z.number().int().nonnegative().optional().describe("Total output tokens across model calls in this turn."),
+  total_tokens: z.number().int().nonnegative().optional().describe("Total tokens (input + output) across model calls in this turn."),
+  total_cache_read_tokens: z.number().int().nonnegative().optional().describe("Total cache-read tokens across model calls in this turn."),
+  total_cache_write_tokens: z.number().int().nonnegative().optional().describe("Total cache-write tokens across model calls in this turn."),
+  total_reasoning_tokens: z.number().int().nonnegative().optional().describe("Total reasoning tokens across model calls in this turn."),
+  total_cost_in_usd: z.number().nonnegative().optional().describe("Estimated total cost in USD for this turn.")
+}).openapi("TurnMetrics");
+var TurnStateCancelledSchema = z.object({
+  status: z.literal("cancelled").describe("Turn was cancelled before completion."),
+  reason: TurnStateCancelledReasonSchema,
+  completed_at: z.string().describe("ISO 8601 time when cancellation completed."),
+  metrics: TurnMetricsSchema.optional().describe("Optional billable aggregate for work done before cancel.")
+}).openapi("TurnStateCancelled");
+var TurnStateErrorSchema = z.object({
+  status: z.literal("error").describe("Turn ended with an error."),
+  message: z.string().describe("Human-readable error message."),
+  completed_at: z.string().describe("ISO 8601 time when the error state was recorded."),
+  metrics: TurnMetricsSchema.optional().describe("Optional billable aggregate for work done before the error.")
+}).openapi("TurnStateError");
+var TurnStateDoneSchema = z.object({
+  status: z.literal("done").describe("Turn finished (possibly paused for required actions)."),
+  output: z.union([ModelMessageEventSchema, z.null()]).describe("Final `model.message` for the turn, or null when the turn ended paused without a final message."),
+  required_actions: z.array(ActionRequiredEventSchema).describe(
+    "Pending actions (`tool.approval_required`, `tool.response_required`, `mcp.auth_required`); empty when none."
+  ),
+  completed_at: z.string().describe("ISO 8601 time when the turn reached a terminal state."),
+  metrics: TurnMetricsSchema.optional().describe("Optional billable aggregate for the whole turn.")
+}).openapi("TurnStateDone");
+var TurnStateSchema = z.discriminatedUnion("status", [
+  TurnStateRunningSchema,
+  TurnStateDoneSchema,
+  TurnStateCancelledSchema,
+  TurnStateErrorSchema
+]).openapi("TurnState");
+var TurnInputItemSchema = z.discriminatedUnion("type", [
+  AgentInputUserMessageSchema,
+  UserToolApprovalMessageSchema,
+  UserToolResponseMessageSchema
+]).openapi("TurnInputItem");
+var TurnSchema = z.object({
+  id: z.string().describe("Unique turn id."),
+  session_id: z.string().describe("Session that owns this turn."),
+  previous_turn_id: z.string().nullable().describe("Prior turn this turn chains from; null for a root turn."),
+  input: z.array(TurnInputItemSchema).optional().describe("Input items supplied when the turn was created."),
+  state: TurnStateSchema,
+  created_at: z.string().describe("ISO 8601 creation timestamp.")
+}).openapi("Turn");
+var CreateTurnRequestSchema = z.object({
+  input: z.array(TurnInputItemSchema).optional().describe(
+    "Turn input items: user messages and/or approval/tool-response resumes. Do not mix user messages with approval or tool-response items."
+  ),
+  previous_turn_id: z.union([z.literal("auto"), z.literal("none"), z.string().min(1)]).optional().default("auto").describe(`Defaults to 'auto' (chain to session last turn). Use 'none' for a new root turn.`).openapi("PreviousTurnIdInput"),
+  stream: z.boolean().optional().default(true).describe("When true (default), stream turn events as SSE. When false, return the running turn immediately.")
+}).superRefine((data, ctx) => {
+  if (!data.input) return;
+  const hasUser = data.input.some((msg) => "type" in msg && msg.type === "user.message");
+  const hasApprovalOrToolResponse = data.input.some(
+    (msg) => "type" in msg && (msg.type === "user.tool_approval" || msg.type === "user.tool_response")
+  );
+  if (hasUser && hasApprovalOrToolResponse) {
+    ctx.addIssue({
+      code: "custom",
+      message: "input must not mix user messages with approval decisions or client-side tool responses"
+    });
+  }
+}).openapi("CreateTurnRequest");
+export {
+  CancellationReason,
+  CreateTurnRequestSchema,
+  TurnInputItemSchema,
+  TurnMetricsSchema,
+  TurnSchema,
+  TurnStateCancelledReasonSchema,
+  TurnStateCancelledSchema,
+  TurnStateDoneSchema,
+  TurnStateErrorSchema,
+  TurnStateRunningSchema,
+  TurnStateSchema
+};
+//# sourceMappingURL=turn.mjs.map

package/dist/agent-session/schemas/turn.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/agent-session/schemas/turn.ts"],"sourcesContent":["/** Turn product schemas: turn state, input items, and create-turn request. */\nimport { z } from '@hono/zod-openapi';\nimport {\n  ActionRequiredEventSchema,\n  AgentInputUserMessageSchema,\n  ModelMessageEventSchema,\n  UserToolApprovalMessageSchema,\n  UserToolResponseMessageSchema,\n} from '../../core/events/schema';\n\nexport enum CancellationReason {\n  // AbortController.abort() reason for the max-execution timer.\n  ServerExecutionTimeout = 'server-execution-timeout',\n  // Emitted when the client cancels the run.\n  ClientCancelled = 'client-cancelled',\n  // Prior turn aborted because the client started a new turn.\n  CancelledForNextTurn = 'cancelled-for-next-turn',\n  // Process shutting down (SIGTERM/SIGINT).\n  Abandoned = 'abandoned',\n}\n\nexport const TurnStateRunningSchema = z\n  .object({\n    status: z.literal('running').describe('Turn is still executing.'),\n  })\n  .openapi('TurnStateRunning');\n\nexport const TurnStateCancelledReasonSchema = z\n  .enum(CancellationReason)\n  .describe('Reason for the cancellation.')\n  .openapi('TurnStateCancelledReason');\n\n/** Billable aggregate for one turn. */\nexport const TurnMetricsSchema = z\n  .object({\n    total_input_tokens: z\n      .number()\n      .int()\n      .nonnegative()\n      .optional()\n      .describe('Total input tokens across model calls in this turn.'),\n    total_output_tokens: z\n      .number()\n      .int()\n      .nonnegative()\n      .optional()\n      .describe('Total output tokens across model calls in this turn.'),\n    total_tokens: z\n      .number()\n      .int()\n      .nonnegative()\n      .optional()\n      .describe('Total tokens (input + output) across model calls in this turn.'),\n    total_cache_read_tokens: z\n      .number()\n      .int()\n      .nonnegative()\n      .optional()\n      .describe('Total cache-read tokens across model calls in this turn.'),\n    total_cache_write_tokens: z\n      .number()\n      .int()\n      .nonnegative()\n      .optional()\n      .describe('Total cache-write tokens across model calls in this turn.'),\n    total_reasoning_tokens: z\n      .number()\n      .int()\n      .nonnegative()\n      .optional()\n      .describe('Total reasoning tokens across model calls in this turn.'),\n    total_cost_in_usd: z.number().nonnegative().optional().describe('Estimated total cost in USD for this turn.'),\n  })\n  .openapi('TurnMetrics');\n\nexport const TurnStateCancelledSchema = z\n  .object({\n    status: z.literal('cancelled').describe('Turn was cancelled before completion.'),\n    reason: TurnStateCancelledReasonSchema,\n    completed_at: z.string().describe('ISO 8601 time when cancellation completed.'),\n    metrics: TurnMetricsSchema.optional().describe('Optional billable aggregate for work done before cancel.'),\n  })\n  .openapi('TurnStateCancelled');\n\nexport const TurnStateErrorSchema = z\n  .object({\n    status: z.literal('error').describe('Turn ended with an error.'),\n    message: z.string().describe('Human-readable error message.'),\n    completed_at: z.string().describe('ISO 8601 time when the error state was recorded.'),\n    metrics: TurnMetricsSchema.optional().describe('Optional billable aggregate for work done before the error.'),\n  })\n  .openapi('TurnStateError');\n\nexport const TurnStateDoneSchema = z\n  .object({\n    status: z.literal('done').describe('Turn finished (possibly paused for required actions).'),\n    output: z\n      .union([ModelMessageEventSchema, z.null()])\n      .describe('Final `model.message` for the turn, or null when the turn ended paused without a final message.'),\n    required_actions: z\n      .array(ActionRequiredEventSchema)\n      .describe(\n        'Pending actions (`tool.approval_required`, `tool.response_required`, `mcp.auth_required`); empty when none.',\n      ),\n    completed_at: z.string().describe('ISO 8601 time when the turn reached a terminal state.'),\n    metrics: TurnMetricsSchema.optional().describe('Optional billable aggregate for the whole turn.'),\n  })\n  .openapi('TurnStateDone');\n\nexport const TurnStateSchema = z\n  .discriminatedUnion('status', [\n    TurnStateRunningSchema,\n    TurnStateDoneSchema,\n    TurnStateCancelledSchema,\n    TurnStateErrorSchema,\n  ])\n  .openapi('TurnState');\n\nexport const TurnInputItemSchema = z\n  .discriminatedUnion('type', [\n    AgentInputUserMessageSchema,\n    UserToolApprovalMessageSchema,\n    UserToolResponseMessageSchema,\n  ])\n  .openapi('TurnInputItem');\n\nexport const TurnSchema = z\n  .object({\n    id: z.string().describe('Unique turn id.'),\n    session_id: z.string().describe('Session that owns this turn.'),\n    previous_turn_id: z.string().nullable().describe('Prior turn this turn chains from; null for a root turn.'),\n    input: z.array(TurnInputItemSchema).optional().describe('Input items supplied when the turn was created.'),\n    state: TurnStateSchema,\n    created_at: z.string().describe('ISO 8601 creation timestamp.'),\n  })\n  .openapi('Turn');\n\n/**\n * Wire type for the previous_turn_id field. Includes the default so the schema\n * can be referenced directly without re-wrapping (re-wrapping strips the $ref).\n */\nexport const CreateTurnRequestSchema = z\n  .object({\n    input: z\n      .array(TurnInputItemSchema)\n      .optional()\n      .describe(\n        'Turn input items: user messages and/or approval/tool-response resumes. Do not mix user messages with approval or tool-response items.',\n      ),\n    previous_turn_id: z\n      .union([z.literal('auto'), z.literal('none'), z.string().min(1)])\n      .optional()\n      .default('auto')\n      .describe(`Defaults to 'auto' (chain to session last turn). Use 'none' for a new root turn.`)\n      .openapi('PreviousTurnIdInput'),\n    stream: z\n      .boolean()\n      .optional()\n      .default(true)\n      .describe('When true (default), stream turn events as SSE. When false, return the running turn immediately.'),\n  })\n  .superRefine((data, ctx) => {\n    if (!data.input) return;\n    const hasUser = data.input.some(msg => 'type' in msg && msg.type === 'user.message');\n    const hasApprovalOrToolResponse = data.input.some(\n      msg => 'type' in msg && (msg.type === 'user.tool_approval' || msg.type === 'user.tool_response'),\n    );\n    if (hasUser && hasApprovalOrToolResponse) {\n      ctx.addIssue({\n        code: 'custom',\n        message: 'input must not mix user messages with approval decisions or client-side tool responses',\n      });\n    }\n  })\n  .openapi('CreateTurnRequest');\n\nexport type Turn = z.infer<typeof TurnSchema>;\nexport type TurnInputItem = z.infer<typeof TurnInputItemSchema>;\nexport type TurnState = z.infer<typeof TurnStateSchema>;\nexport type TerminalTurnState = Exclude<TurnState, { status: 'running' }>;\nexport type TurnMetrics = z.infer<typeof TurnMetricsSchema>;\n"],"mappings":"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","names":["CancellationReason"]}

package/dist/agent-session/store/ISessionStore.d.ts

@@ -0,0 +1,310 @@
+import type { JsonValue } from '../../core/capabilities/AgentCapability';
+import type { MCPServerInitInfo, ThreadOverwriteContextEvent } from '../../core/events/schema';
+import type { AgentThreadSnapshot, ContextMessage, SubAgentCompletionMarker } from '../../core/runtime/AgentThread.types';
+import type { CurrentContextUsage } from '../../core/runtime/contextUsage';
+import type { SandboxInfo } from '../../core/sandbox/Sandbox';
+import type { SessionRecord } from '../models/SessionRecord';
+import type { TurnRecord } from '../models/TurnRecord';
+import type { PersistedTurnEvent, SessionEventItem } from '../schemas/events';
+import type { TokenPagination } from '../schemas/pagination';
+import type { TerminalTurnState } from '../schemas/turn';
+/**
+ * Caller-supplied fields for creating a session; the store owns timestamps and tip state.
+ * `agent` is a discriminated reference | inline binding.
+ */
+export type CreateSessionInput<TSessionCustom extends object = Record<string, never>> = Pick<SessionRecord<TSessionCustom>, 'tenant_id' | 'session_id' | 'agent' | 'created_by'> & {
+    custom: TSessionCustom | null;
+};
+/**
+ * PATCH fields for an existing session; `undefined` fields are left unchanged.
+ * `agent` may be set only on inline sessions, and only as an inline arm (`{ type: 'inline', spec }`).
+ */
+export type UpdateSessionInput<TSessionCustom extends object = Record<string, never>> = Pick<SessionRecord<TSessionCustom>, 'tenant_id' | 'session_id'> & {
+    agent: Extract<SessionRecord<TSessionCustom>['agent'], {
+        type: 'inline';
+    }> | undefined;
+    title: SessionRecord<TSessionCustom>['title'] | undefined;
+};
+export interface GetSessionInput {
+    tenant_id: string;
+    session_id: string;
+}
+export interface DeleteSessionInput {
+    tenant_id: string;
+    session_id: string;
+}
+export interface ListSessionsInput {
+    tenant_id: string;
+    limit: number;
+    page_token: string | undefined;
+    order: 'asc' | 'desc' | undefined;
+    /** Inclusive lower bound on `created_at` (instant). */
+    start_timestamp: Date | undefined;
+    /** Inclusive upper bound on `created_at` (instant). */
+    end_timestamp: Date | undefined;
+    /** When set, only sessions bound to this named agent id. */
+    agent_id: string | undefined;
+    /** When set, only sessions created by this identity. */
+    created_by: string | undefined;
+}
+/** Turn row fields without assembled snapshot (create input / listTurns). */
+export type TurnRecordWithoutSnapshot<TTurnCustom extends object = Record<string, never>> = Omit<TurnRecord<TTurnCustom>, 'snapshot'>;
+/** Thread registration; mutable per-turn data arrives through dedicated createTurn fields. */
+export type NewThreadInit = Omit<AgentThreadSnapshot, 'context' | 'current_context_usage' | 'completion' | 'capability_state'>;
+/** Full post-send capability map for one thread. */
+export type ThreadCapabilityStateInit = Pick<AgentThreadSnapshot, 'thread_id' | 'capability_state'>;
+/** One drained send() append batch for one thread; writer = the new turn. */
+export interface TurnContextAppend {
+    thread_id: string;
+    context: ContextMessage[];
+    current_context_usage: CurrentContextUsage | null;
+}
+export interface CreateTurnInput<TTurnCustom extends object = Record<string, never>> {
+    turn: TurnRecordWithoutSnapshot<TTurnCustom>;
+    /** Threads absent on the previous turn (turn 1: the root thread; else empty). */
+    new_threads: NewThreadInit[];
+    /**
+     * All new messages, for new and carried-forward threads alike — collected by
+     * draining orchestrator.send() BEFORE this call. Draining without persisting is
+     * safe: send() mutates only in-memory threads, and if createTurn fails the whole
+     * in-memory state (orchestrator, threads, resolver) is discarded — so either this
+     * turn commits atomically with its appends, or nothing was persisted at all.
+     */
+    new_context_appends: TurnContextAppend[];
+    /**
+     * Complete post-send capability maps: exactly one entry per turn thread.
+     * Authoritative for this turn; the store does not carry capability rows forward.
+     */
+    capability_states: ThreadCapabilityStateInit[];
+    /** Set only if session.title is NULL (first write wins). */
+    update_session_title_if_not_exist: string | null;
+}
+export interface FreezeAndGetTurnInput {
+    session_id: string;
+    turn_id: string;
+    /** Caller-built cancelled turn.done event; store persists atomically with state flip when it cancels. */
+    turn_done_event: PersistedTurnEvent;
+}
+export interface GetTurnInput {
+    session_id: string;
+    turn_id: string;
+}
+export interface ListTurnsInput {
+    session_id: string;
+    limit: number;
+    page_token: string | undefined;
+}
+export interface UpdateTurnStateInput {
+    session_id: string;
+    turn_id: string;
+    state: TerminalTurnState;
+    /** Caller-built turn.done; written atomically with the state flip in the same tx. */
+    turn_done_event: PersistedTurnEvent;
+}
+export interface AppendToEventsInput {
+    session_id: string;
+    turn_id: string;
+    events: PersistedTurnEvent[];
+}
+export interface AddThreadsInput {
+    session_id: string;
+    turn_id: string;
+    threads: AgentThreadSnapshot[];
+}
+export interface RemoveThreadsInput {
+    session_id: string;
+    turn_id: string;
+    thread_ids: string[];
+}
+export interface AppendToThreadContextInput {
+    session_id: string;
+    turn_id: string;
+    thread_id: string;
+    context: ContextMessage[];
+    current_context_usage: CurrentContextUsage | null;
+    completion: SubAgentCompletionMarker | null;
+}
+export interface OverwriteThreadContextInput {
+    session_id: string;
+    turn_id: string;
+    event: ThreadOverwriteContextEvent;
+}
+export interface PatchMCPServersInput {
+    session_id: string;
+    turn_id: string;
+    mcp_servers: MCPServerInitInfo[];
+}
+export interface PatchSandboxInfoInput {
+    session_id: string;
+    turn_id: string;
+    sandbox_info: SandboxInfo;
+}
+export interface PatchThreadCapabilityStateInput {
+    session_id: string;
+    turn_id: string;
+    thread_id: string;
+    key: string;
+    state: JsonValue;
+}
+export interface ListTurnEventsInput {
+    session_id: string;
+    turn_id: string;
+    limit: number;
+    page_token: string | undefined;
+    order: 'asc' | 'desc' | undefined;
+}
+export interface ListSessionEventsInput {
+    session_id: string;
+    limit: number;
+    page_token: string | undefined;
+    last_turn_id: string | undefined;
+}
+/**
+ * Session/turn persistence contract. Pure durability: no streaming, SSE, or
+ * subscription members. Callers authorize the parent session before using
+ * turn-scoped operations, which rely on globally unique session_id values.
+ * Capability maps are initialized atomically by createTurn and subsequently
+ * updated through patchThreadCapabilityState. Agent binding is session-scoped
+ * as a discriminated `agent` (ref | value); named agents are not hydrated on read.
+ */
+export interface ISessionStore<TSessionCustom extends object = Record<string, never>, TTurnCustom extends object = Record<string, never>> {
+    /**
+     * Persists a discriminated `agent` (ref | value). SQL backends may flatten to columns.
+     * `session_id` is globally unique across tenants.
+     * Persists caller-supplied `created_by` (immutable after create).
+     * Sets `last_activity_timestamp_ms` (= now) on create.
+     */
+    createSession(input: CreateSessionInput<TSessionCustom>): Promise<void>;
+    /** Permanently removes a session and all related data; missing sessions are a no-op. */
+    deleteSession(input: DeleteSessionInput): Promise<void>;
+    /**
+     * Returns the session as stored (ref agents are not hydrated to a value).
+     * Does **not** bump `last_activity_timestamp_ms` (read path).
+     */
+    getSession(input: GetSessionInput): Promise<SessionRecord<TSessionCustom> | undefined>;
+    /**
+     * PATCH semantics — update only the provided fields:
+     * - agent: replace inline binding (inline sessions only; reference → invariant error).
+     * - title: set/replace the session title.
+     * Bumps `last_activity_timestamp_ms` (= now) in the same update.
+     */
+    updateSession(input: UpdateSessionInput<TSessionCustom>): Promise<void>;
+    /**
+     * Paginated list of the tenant's sessions ordered by `updated_at`
+     * (`order` defaults to `desc`, `session_id` tie-break). `page_token` is a
+     * keyset cursor on `(updated_at, session_id)`. `start_timestamp` /
+     * `end_timestamp` are inclusive instant bounds on `created_at`. Optional
+     * `agent_id` filters ref-bound sessions; optional `created_by` filters by
+     * creator identity. Does **not** bump `last_activity_timestamp_ms` (read path).
+     */
+    listSessions(input: ListSessionsInput): Promise<{
+        data: SessionRecord<TSessionCustom>[];
+        pagination: TokenPagination;
+    }>;
+    /**
+     * Creates the turn AND advances `session.last_turn_id`. Context merging is the
+     * store's responsibility: `new_context_appends` and `new_threads` are applied
+     * on top of the previous turn's snapshot when `turn.previous_turn_id` is set.
+     * `capability_states` is the complete authoritative map for every resulting
+     * thread and is persisted directly without store-side carry-forward.
+     *
+     * Atomicity (store contract): insert turn + set `last_turn_id` (+ session
+     * turn-list append if the backend has one) MUST be one atomic unit per
+     * session. Concurrent createTurn on the same session must not drop a turn
+     * row or leave `last_turn_id` pointing at a turn that was never created.
+     * The implementation supplies the mechanism (session lock, row lock/tx, …).
+     *
+     * Also bumps `session.last_activity_timestamp_ms` in that same atomic unit.
+     *
+     * Fork semantics for `turn.previous_turn_id`:
+     * - `null` — new root turn (no parent); always allowed.
+     * - string — fork/chain from that turn when it exists. Tip-equality is NOT
+     *   required; concurrent forks from the same tip both succeed. Unknown id is
+     *   allowed (relaxed) and treated as no inheritance. If that turn exists and
+     *   is still `running`, reject with {@link PreviousTurnRunningError} —
+     *   callers must {@link freezeAndGetTurn} first.
+     * `last_turn_id` always advances to the new turn in the same atomic unit.
+     *
+     * `update_session_title_if_not_exist`: when set AND `session.title` is
+     * unset/null, set it in the same atomic unit; an existing title is NEVER
+     * overwritten (first write wins). The caller derives the value; the store
+     * only conditionally sets it.
+     */
+    createTurn(input: CreateTurnInput<TTurnCustom>): Promise<void>;
+    /**
+     * One tx: (a) conditionally cancel a running turn with
+     * {@link CancellationReason.CancelledForNextTurn}; (b) if it did cancel,
+     * insert the caller-built `turn_done_event` — already-terminal turns skip the
+     * event insert; (c) return the now-immutable turn record. Missing turn →
+     * {@link TurnNotFoundError}.
+     */
+    freezeAndGetTurn(input: FreezeAndGetTurnInput): Promise<TurnRecord<TTurnCustom>>;
+    /** Returns the turn record, or undefined if not found in this session. */
+    getTurn(input: GetTurnInput): Promise<TurnRecord<TTurnCustom> | undefined>;
+    /** Paginated list of turn rows (no snapshot); use getTurn for assembled snapshot. */
+    listTurns(input: ListTurnsInput): Promise<{
+        data: TurnRecordWithoutSnapshot<TTurnCustom>[];
+        pagination: TokenPagination;
+    }>;
+    /**
+     * Writes the terminal state and `turn_done_event` atomically. Store contract —
+     * **first terminal write wins**:
+     * - Allowed: `running` → `done` | `cancelled` | `error`.
+     * - Rejected with **409** (or equivalent conflict): any write when status is already
+     *   terminal — including done→cancelled, cancelled→done, error→*, terminal→running.
+     * - Missing turn → 404 / not-found.
+     *
+     * Check under the same concurrency control as other turn mutations (lock/CAS) —
+     * not a racy read-then-write outside the critical section.
+     */
+    updateTurnState(input: UpdateTurnStateInput): Promise<void>;
+    /**
+     * Durable event log for the turn. MUST include lifecycle rows: a
+     * `TurnCreatedEvent` at the start of the stream and a terminal `TurnDoneEvent`
+     * (or its cancelled/error shape) at the end. Every turn written through this
+     * API persists lifecycle in the stream — implementations never synthesize
+     * missing created/done rows on read. Every event MUST carry `id` and
+     * `created_at`; `id` is a monotonic ULID and is the primary within-turn sort
+     * key. `created_at` records event creation time but is not the order key.
+     */
+    appendToEvents(input: AppendToEventsInput): Promise<void>;
+    /** Adds thread snapshots to the turn (sub-agent spawns). */
+    addThreads(input: AddThreadsInput): Promise<void>;
+    /** Removes threads from the turn by id. */
+    removeThreads(input: RemoveThreadsInput): Promise<void>;
+    /** Appends messages to a thread's context; optionally updates usage / completion marker. */
+    appendToThreadContext(input: AppendToThreadContextInput): Promise<void>;
+    /** Replaces a thread's context wholesale (context-overwrite event). */
+    overwriteThreadContext(input: OverwriteThreadContextInput): Promise<void>;
+    /** Patches the turn snapshot's MCP server init info (by source id). */
+    patchMCPServers(input: PatchMCPServersInput): Promise<void>;
+    /** Patches the turn snapshot's sandbox info (id for cross-turn reattach). */
+    patchSandboxInfo(input: PatchSandboxInfoInput): Promise<void>;
+    /** Generic capability KV — store has zero Plan/feature knowledge. */
+    patchThreadCapabilityState(input: PatchThreadCapabilityStateInput): Promise<void>;
+    /** Paginated read ordered lexically by monotonic `event.id` (asc default). */
+    listTurnEvents(input: ListTurnEventsInput): Promise<{
+        data: PersistedTurnEvent[];
+        pagination: TokenPagination;
+    }>;
+    /**
+     * Paginated session-wide feed of persisted events across turns, including
+     * turn.created / turn.done lifecycle rows. Reads only — never synthesizes.
+     *
+     * Includes events from **running** turns (the HTTP layer may 409 separately;
+     * that is not store semantics). Ordering: newest turn first, then monotonic
+     * `event.id` descending within each turn. `last_turn_id` anchors the window
+     * to that turn plus its ancestors; when omitted, the session's current
+     * `last_turn_id` selects the active branch. Continuation page tokens encode
+     * that anchor and take precedence over `last_turn_id`, so later session
+     * activity cannot move an in-progress pagination walk to another branch.
+     * `ancestor_ids` may include only the previous N ancestors and need not reach
+     * the root — implementations must spill through older turns' own
+     * `ancestor_ids` when needed. Sibling branches from forks are excluded.
+     */
+    listSessionEvents(input: ListSessionEventsInput): Promise<{
+        data: SessionEventItem[];
+        pagination: TokenPagination;
+    }>;
+}
+//# sourceMappingURL=ISessionStore.d.ts.map

package/dist/agent-session/store/ISessionStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ISessionStore.d.ts","sourceRoot":"","sources":["../../../src/agent-session/store/ISessionStore.ts"],"names":[],"mappings":"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"}

package/dist/agent-session/store/ISessionStore.js

@@ -0,0 +1,19 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/agent-session/store/ISessionStore.ts
+var ISessionStore_exports = {};
+module.exports = __toCommonJS(ISessionStore_exports);
+//# sourceMappingURL=ISessionStore.js.map