@xemahq/agent-session-api-client 0.1.2

package/dist/models/sessionDebugSkillDtoSnapshot.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Generated by orval v8.6.2 🍺
+ * Do not edit manually.
+ * Interactive Session API
+ * Real-time interactive AI coding sessions with agent management, file browsing, and activity streaming
+ * OpenAPI spec version: 0.1.0
+ */
+/**
+ * Skill metadata snapshot captured at attach time (name, description, source path).
+ * @nullable
+ */
+export type SessionDebugSkillDtoSnapshot = {
+    [key: string]: unknown;
+} | null;

package/dist/models/sessionDebugSkillDtoSnapshot.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Generated by orval v8.6.2 🍺
+ * Do not edit manually.
+ * Interactive Session API
+ * Real-time interactive AI coding sessions with agent management, file browsing, and activity streaming
+ * OpenAPI spec version: 0.1.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/models/sessionKind.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Generated by orval v8.6.2 🍺
+ * Do not edit manually.
+ * Interactive Session API
+ * Real-time interactive AI coding sessions with agent management, file browsing, and activity streaming
+ * OpenAPI spec version: 0.1.0
+ */
+/**
+ * Session kind.
+ */
+export type SessionKind = typeof SessionKind[keyof typeof SessionKind];
+export declare const SessionKind: {
+    readonly standard: "standard";
+    readonly sandbox: "sandbox";
+};

package/dist/models/sessionKind.js

@@ -0,0 +1,14 @@
+"use strict";
+/**
+ * Generated by orval v8.6.2 🍺
+ * Do not edit manually.
+ * Interactive Session API
+ * Real-time interactive AI coding sessions with agent management, file browsing, and activity streaming
+ * OpenAPI spec version: 0.1.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionKind = void 0;
+exports.SessionKind = {
+    standard: 'standard',
+    sandbox: 'sandbox',
+};

package/dist/models/sessionLockfileDto.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Generated by orval v8.6.2 🍺
+ * Do not edit manually.
+ * Interactive Session API
+ * Real-time interactive AI coding sessions with agent management, file browsing, and activity streaming
+ * OpenAPI spec version: 0.1.0
+ */
+import type { SessionLockfileDtoAgents } from './sessionLockfileDtoAgents';
+import type { SessionLockfileDtoBiomes } from './sessionLockfileDtoBiomes';
+import type { SessionLockfileDtoCapabilities } from './sessionLockfileDtoCapabilities';
+import type { SessionLockfileDtoDeliverableSpecs } from './sessionLockfileDtoDeliverableSpecs';
+import type { SessionLockfileDtoSkills } from './sessionLockfileDtoSkills';
+import type { SessionLockfileDtoWorkflows } from './sessionLockfileDtoWorkflows';
+export interface SessionLockfileDto {
+    /** Resolved kernel semver string at the moment the session was created. */
+    kernel: string;
+    /** Map of capability ref (sans `@major`) to the chosen major version string. */
+    capabilities: SessionLockfileDtoCapabilities;
+    /** Map of biome slug to the chosen published semver. */
+    biomes: SessionLockfileDtoBiomes;
+    /** Map of agent slug to chosen published semver. Optional. */
+    agents?: SessionLockfileDtoAgents;
+    /** Map of workflow slug to chosen published semver. Optional. */
+    workflows?: SessionLockfileDtoWorkflows;
+    /** Map of deliverable-spec slug to chosen published semver. Optional. */
+    deliverableSpecs?: SessionLockfileDtoDeliverableSpecs;
+    /** Map of skill slug to chosen published semver. Optional. */
+    skills?: SessionLockfileDtoSkills;
+}

package/dist/models/sessionLockfileDto.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/models/sessionLockfileDtoAgents.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Generated by orval v8.6.2 🍺
+ * Do not edit manually.
+ * Interactive Session API
+ * Real-time interactive AI coding sessions with agent management, file browsing, and activity streaming
+ * OpenAPI spec version: 0.1.0
+ */
+/**
+ * Map of agent slug to chosen published semver. Optional.
+ */
+export type SessionLockfileDtoAgents = {
+    [key: string]: string;
+};

package/dist/models/sessionLockfileDtoAgents.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Generated by orval v8.6.2 🍺
+ * Do not edit manually.
+ * Interactive Session API
+ * Real-time interactive AI coding sessions with agent management, file browsing, and activity streaming
+ * OpenAPI spec version: 0.1.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/models/sessionLockfileDtoBiomes.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Generated by orval v8.6.2 🍺
+ * Do not edit manually.
+ * Interactive Session API
+ * Real-time interactive AI coding sessions with agent management, file browsing, and activity streaming
+ * OpenAPI spec version: 0.1.0
+ */
+/**
+ * Map of biome slug to the chosen published semver.
+ */
+export type SessionLockfileDtoBiomes = {
+    [key: string]: string;
+};

package/dist/models/sessionLockfileDtoBiomes.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Generated by orval v8.6.2 🍺
+ * Do not edit manually.
+ * Interactive Session API
+ * Real-time interactive AI coding sessions with agent management, file browsing, and activity streaming
+ * OpenAPI spec version: 0.1.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/models/sessionLockfileDtoCapabilities.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Generated by orval v8.6.2 🍺
+ * Do not edit manually.
+ * Interactive Session API
+ * Real-time interactive AI coding sessions with agent management, file browsing, and activity streaming
+ * OpenAPI spec version: 0.1.0
+ */
+/**
+ * Map of capability ref (sans `@major`) to the chosen major version string.
+ */
+export type SessionLockfileDtoCapabilities = {
+    [key: string]: string;
+};

package/dist/models/sessionLockfileDtoCapabilities.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Generated by orval v8.6.2 🍺
+ * Do not edit manually.
+ * Interactive Session API
+ * Real-time interactive AI coding sessions with agent management, file browsing, and activity streaming
+ * OpenAPI spec version: 0.1.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/models/sessionLockfileDtoDataEnvelope.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Generated by orval v8.6.2 🍺
+ * Do not edit manually.
+ * Interactive Session API
+ * Real-time interactive AI coding sessions with agent management, file browsing, and activity streaming
+ * OpenAPI spec version: 0.1.0
+ */
+import type { SessionLockfileDto } from './sessionLockfileDto';
+export interface SessionLockfileDtoDataEnvelope {
+    data: SessionLockfileDto;
+}

package/dist/models/sessionLockfileDtoDataEnvelope.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/models/sessionLockfileDtoDeliverableSpecs.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Generated by orval v8.6.2 🍺
+ * Do not edit manually.
+ * Interactive Session API
+ * Real-time interactive AI coding sessions with agent management, file browsing, and activity streaming
+ * OpenAPI spec version: 0.1.0
+ */
+/**
+ * Map of deliverable-spec slug to chosen published semver. Optional.
+ */
+export type SessionLockfileDtoDeliverableSpecs = {
+    [key: string]: string;
+};

package/dist/models/sessionLockfileDtoDeliverableSpecs.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Generated by orval v8.6.2 🍺
+ * Do not edit manually.
+ * Interactive Session API
+ * Real-time interactive AI coding sessions with agent management, file browsing, and activity streaming
+ * OpenAPI spec version: 0.1.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/models/sessionLockfileDtoSkills.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Generated by orval v8.6.2 🍺
+ * Do not edit manually.
+ * Interactive Session API
+ * Real-time interactive AI coding sessions with agent management, file browsing, and activity streaming
+ * OpenAPI spec version: 0.1.0
+ */
+/**
+ * Map of skill slug to chosen published semver. Optional.
+ */
+export type SessionLockfileDtoSkills = {
+    [key: string]: string;
+};

package/dist/models/sessionLockfileDtoSkills.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Generated by orval v8.6.2 🍺
+ * Do not edit manually.
+ * Interactive Session API
+ * Real-time interactive AI coding sessions with agent management, file browsing, and activity streaming
+ * OpenAPI spec version: 0.1.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/models/sessionLockfileDtoWorkflows.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Generated by orval v8.6.2 🍺
+ * Do not edit manually.
+ * Interactive Session API
+ * Real-time interactive AI coding sessions with agent management, file browsing, and activity streaming
+ * OpenAPI spec version: 0.1.0
+ */
+/**
+ * Map of workflow slug to chosen published semver. Optional.
+ */
+export type SessionLockfileDtoWorkflows = {
+    [key: string]: string;
+};

package/dist/models/sessionLockfileDtoWorkflows.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Generated by orval v8.6.2 🍺
+ * Do not edit manually.
+ * Interactive Session API
+ * Real-time interactive AI coding sessions with agent management, file browsing, and activity streaming
+ * OpenAPI spec version: 0.1.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/models/sessionMessageRole.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Generated by orval v8.6.2 🍺
+ * Do not edit manually.
+ * Interactive Session API
+ * Real-time interactive AI coding sessions with agent management, file browsing, and activity streaming
+ * OpenAPI spec version: 0.1.0
+ */
+export type SessionMessageRole = typeof SessionMessageRole[keyof typeof SessionMessageRole];
+export declare const SessionMessageRole: {
+    readonly user: "user";
+    readonly assistant: "assistant";
+    readonly system: "system";
+    readonly tool: "tool";
+};

package/dist/models/sessionMessageRole.js

@@ -0,0 +1,16 @@
+"use strict";
+/**
+ * Generated by orval v8.6.2 🍺
+ * Do not edit manually.
+ * Interactive Session API
+ * Real-time interactive AI coding sessions with agent management, file browsing, and activity streaming
+ * OpenAPI spec version: 0.1.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionMessageRole = void 0;
+exports.SessionMessageRole = {
+    user: 'user',
+    assistant: 'assistant',
+    system: 'system',
+    tool: 'tool',
+};

package/dist/models/sessionParticipantDto.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Generated by orval v8.6.2 🍺
+ * Do not edit manually.
+ * Interactive Session API
+ * Real-time interactive AI coding sessions with agent management, file browsing, and activity streaming
+ * OpenAPI spec version: 0.1.0
+ */
+import type { ParticipantRole } from './participantRole';
+import type { ParticipantSubjectKind } from './participantSubjectKind';
+export interface SessionParticipantDto {
+    /** Participant row id. */
+    id: string;
+    /** Session this participant belongs to. */
+    sessionId: string;
+    /** Discriminator on `subjectRef`. Closed set — `org_user` for a Xema-identity user (Keycloak sub) or `external_guest` for a delegated-session subject minted by `app-runtime-api`. */
+    subjectKind: ParticipantSubjectKind;
+    /** Opaque per-kind reference. `org_user`: Keycloak user id. `external_guest`: `external-user:<hash>` from the minted token `sub`. */
+    subjectRef: string;
+    displayName: string;
+    avatarUrl?: string;
+    /** Role inside this session. Closed set. */
+    role: ParticipantRole;
+    /** ISO-8601 timestamp of the invite. */
+    invitedAt: string;
+    /** Subject ref of the inviter. */
+    invitedBy: string;
+    /** ISO-8601 timestamp of the last message this participant posted on the session. Null until they post their first message. */
+    lastSeenAt?: string;
+}

package/dist/models/sessionParticipantDto.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/models/sessionParticipantDtoDataEnvelope.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Generated by orval v8.6.2 🍺
+ * Do not edit manually.
+ * Interactive Session API
+ * Real-time interactive AI coding sessions with agent management, file browsing, and activity streaming
+ * OpenAPI spec version: 0.1.0
+ */
+import type { SessionParticipantDto } from './sessionParticipantDto';
+export interface SessionParticipantDtoDataEnvelope {
+    data: SessionParticipantDto;
+}

package/dist/models/sessionParticipantDtoDataEnvelope.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/models/sessionPauseReason.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Generated by orval v8.6.2 🍺
+ * Do not edit manually.
+ * Interactive Session API
+ * Real-time interactive AI coding sessions with agent management, file browsing, and activity streaming
+ * OpenAPI spec version: 0.1.0
+ */
+/**
+ * Why the session left `active` for `paused`. `user` = explicit pause (needs an explicit resume); `allocation_lost` = the worker allocation was reaped out-of-band and the next user interaction auto-resumes. Frontend distinguishes the two so the user only sees the "resume required" affordance when their action is actually required.
+ */
+export type SessionPauseReason = typeof SessionPauseReason[keyof typeof SessionPauseReason];
+export declare const SessionPauseReason: {
+    readonly user: "user";
+    readonly allocation_lost: "allocation_lost";
+};

package/dist/models/sessionPauseReason.js

@@ -0,0 +1,14 @@
+"use strict";
+/**
+ * Generated by orval v8.6.2 🍺
+ * Do not edit manually.
+ * Interactive Session API
+ * Real-time interactive AI coding sessions with agent management, file browsing, and activity streaming
+ * OpenAPI spec version: 0.1.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionPauseReason = void 0;
+exports.SessionPauseReason = {
+    user: 'user',
+    allocation_lost: 'allocation_lost',
+};

package/dist/models/sessionProvisioningPhase.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Generated by orval v8.6.2 🍺
+ * Do not edit manually.
+ * Interactive Session API
+ * Real-time interactive AI coding sessions with agent management, file browsing, and activity streaming
+ * OpenAPI spec version: 0.1.0
+ */
+/**
+ * Fine-grained provisioning phase advanced by the pool-api progress webhook. Starts at `queued`, transitions through the acquire pipeline, and lands at `ready` or `failed`. Complements the coarse `status` field.
+ */
+export type SessionProvisioningPhase = typeof SessionProvisioningPhase[keyof typeof SessionProvisioningPhase];
+export declare const SessionProvisioningPhase: {
+    readonly queued: "queued";
+    readonly worker_launching: "worker_launching";
+    readonly worker_waiting_ready: "worker_waiting_ready";
+    readonly credentials_injecting: "credentials_injecting";
+    readonly workspace_preparing: "workspace_preparing";
+    readonly config_writing: "config_writing";
+    readonly config_reloading: "config_reloading";
+    readonly model_verifying: "model_verifying";
+    readonly tools_verifying: "tools_verifying";
+    readonly ready: "ready";
+    readonly failed: "failed";
+};

package/dist/models/sessionProvisioningPhase.js

@@ -0,0 +1,23 @@
+"use strict";
+/**
+ * Generated by orval v8.6.2 🍺
+ * Do not edit manually.
+ * Interactive Session API
+ * Real-time interactive AI coding sessions with agent management, file browsing, and activity streaming
+ * OpenAPI spec version: 0.1.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionProvisioningPhase = void 0;
+exports.SessionProvisioningPhase = {
+    queued: 'queued',
+    worker_launching: 'worker_launching',
+    worker_waiting_ready: 'worker_waiting_ready',
+    credentials_injecting: 'credentials_injecting',
+    workspace_preparing: 'workspace_preparing',
+    config_writing: 'config_writing',
+    config_reloading: 'config_reloading',
+    model_verifying: 'model_verifying',
+    tools_verifying: 'tools_verifying',
+    ready: 'ready',
+    failed: 'failed',
+};

package/dist/models/sessionResponseDto.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Generated by orval v8.6.2 🍺
+ * Do not edit manually.
+ * Interactive Session API
+ * Real-time interactive AI coding sessions with agent management, file browsing, and activity streaming
+ * OpenAPI spec version: 0.1.0
+ */
+import type { BranchStrategy } from './branchStrategy';
+import type { SessionContextWindowSnapshotDto } from './sessionContextWindowSnapshotDto';
+import type { SessionPauseReason } from './sessionPauseReason';
+import type { SessionProvisioningPhase } from './sessionProvisioningPhase';
+import type { SessionResponseDtoFailureMetaJson } from './sessionResponseDtoFailureMetaJson';
+import type { SessionResponseDtoHandoffOutput } from './sessionResponseDtoHandoffOutput';
+import type { SessionResponseDtoModelSelection } from './sessionResponseDtoModelSelection';
+import type { SessionResponseDtoToolSelectionItem } from './sessionResponseDtoToolSelectionItem';
+import type { SessionStatus } from './sessionStatus';
+import type { SessionTokenUsageDto } from './sessionTokenUsageDto';
+export interface SessionResponseDto {
+    /** Session identifier (cuid) */
+    id: string;
+    /** Owning organization ID (Keycloak group ID) */
+    orgId: string;
+    /** Project this session belongs to */
+    projectId: string;
+    /**
+       * Human-readable session title set at creation or inherited from profile
+       * @nullable
+       */
+    title?: string | null;
+    status: SessionStatus;
+    /**
+       * Biome-owned domain key attached to this session runtime. Null means generic interactive session.
+       * @nullable
+       */
+    sessionDomainKey?: string | null;
+    /**
+       * Opaque domain row identifier associated with `sessionDomainKey` (for example a brainstorming id).
+       * @nullable
+       */
+    sessionDomainRef?: string | null;
+    /** Internal agent slug resolved from profile */
+    agentSlug: string;
+    /** @nullable */
+    modelId?: string | null;
+    /** @nullable */
+    resolvedConfigHash?: string | null;
+    /** @nullable */
+    repositoryId?: string | null;
+    /** @nullable */
+    branchName?: string | null;
+    branchStrategy: BranchStrategy;
+    tokenUsage?: SessionTokenUsageDto | null;
+    /** @nullable */
+    budgetLimit?: number | null;
+    /** Latest OpenCode context-window snapshot, mirrored from the most recent `step_finished` frame and reset to zeros on `session.compacted`. Null until the first turn completes — the composer chip stays hidden in that window because we cannot honestly report the system-prompt size before any usage lands. */
+    contextWindowSnapshot?: SessionContextWindowSnapshotDto | null;
+    /**
+       * Pipeline run that owns this session (set when the session is created by a pipeline-run request). Sourced from RequestContext, never client-supplied.
+       * @nullable
+       */
+    pipelineRunId?: string | null;
+    /**
+       * Workflow-engine job-run id that spawned this session. Only meaningful when `pipelineRunId` is also set — together they let the workflow-runtime worker route the eventual handoff signal back to the right job-level promise.
+       * @nullable
+       */
+    jobRunId?: string | null;
+    /**
+       * Structured deliverable contract emitted by the in-session agent (the JSON written to `/workspace/deliverables/contract.json` against the session's `deliverableSpecRef`). Captured idempotently on the first `POST /sessions/:id/handoff`. `null` until the agent has handed off.
+       * @nullable
+       */
+    handoffOutput?: SessionResponseDtoHandoffOutput;
+    /**
+       * When the handoff arrived. Mirrors `handoffOutput` presence.
+       * @nullable
+       */
+    handoffAt?: string | null;
+    /**
+       * Reference to the session this one was forked from (via POST /sessions/:id/fork). Stamped server-side from the URL; API clients cannot forge parentage. Null for sessions created directly.
+       * @nullable
+       */
+    parentSessionId?: string | null;
+    /** @nullable */
+    prUrl?: string | null;
+    /**
+       * Human-readable reason the session moved to failed status
+       * @nullable
+       */
+    failureReason?: string | null;
+    /** Fine-grained provisioning phase advanced by the pool-api progress webhook. Starts at `queued`, transitions through the acquire pipeline, and lands at `ready` or `failed`. Complements the coarse `status` field. */
+    provisioningPhase: SessionProvisioningPhase;
+    /** Timestamp the session entered the current `provisioningPhase`. Used by UIs to render per-phase elapsed time. */
+    provisioningPhaseSince: string;
+    /**
+       * Human-readable hint attached when provisioning fails; `null` while still in progress or on success.
+       * @nullable
+       */
+    provisioningFailureHint?: string | null;
+    /**
+       * Stable, machine-readable failure code paired with `failureReason` when the failure has structured recovery info. Frontend branches on this to render code-specific UX (e.g. `REPO_EMPTY` → "push your first commit"). `null` when the failure was unstructured (transport, timeout) — fall back to `failureReason`.
+       * @nullable
+       */
+    failureCode?: string | null;
+    /**
+       * Structured payload paired with `failureCode`. Shape is code-specific. For clone failures: `{ slug, requestedBranch, availableBranches, defaultBranchSuggestion }`.
+       * @nullable
+       */
+    failureMetaJson?: SessionResponseDtoFailureMetaJson;
+    /** Workspace-relative paths the snapshot tar includes on pause and restores on resume. Pinned at session create so an in-flight session is never surprised by later config changes — the snapshot stays self-describing. Empty array means only OpenCode internal state (chat DB, message storage, plans) is preserved. */
+    workspacePersistPaths: string[];
+    /**
+       * Current model selection override. Either a ConcreteModelRef `{kind: "concrete", modelId, providerSlug?, temperature?}` or a StrategyModelRef `{kind: "strategy", modelClass, temperature?}`. Null = no override; the agent's default modelClass strategy cascade resolves the model per prompt.
+       * @nullable
+       */
+    modelSelection?: SessionResponseDtoModelSelection;
+    /** Tool selection for this session — a flat list of ToolSelectionEntry records from `@xemahq/kernel-contracts/mcp-tool`. Either `{kind: "provider", providerKind, resourceId}` (all tools from the resource) or `{kind: "tool", providerKind, resourceId, toolName}` (narrowed). Empty array (default) means OpenCode built-ins only — no MCP auto-mounted at session boot. Updated via PATCH /sessions/:id/tools. */
+    toolSelection: SessionResponseDtoToolSelectionItem[];
+    /**
+       * Agent Composition reference (`slug@version`) — the single source of truth for this session: agent + sub-agent tree, per-node skills, tools, model overrides, and the `/workspace/` filesystem layout. Resolved via llm-registry-api `GET /compositions/resolve/:ref` at launch and on resume. Null for a sandbox session (it resolves its DRAFT composition by `sandboxCompositionId` instead) or a session created before the Phase 6 cutover backfill.
+       * @nullable
+       */
+    compositionRef: string | null;
+    /** Virtual provider keys currently materialised in the worker's opencode.jsonc. The FE picker uses this to decide whether a model switch will trigger a hot-add (cross-provider) or route directly (provider already mounted). Empty array before the first /control/setup applies. */
+    opencodeProviders: string[];
+    createdBy: string;
+    lastActivityAt: string;
+    /** @nullable */
+    pausedAt?: string | null;
+    /** Why the session left `active` for `paused`. `user` = explicit pause (needs an explicit resume); `allocation_lost` = the worker allocation was reaped out-of-band and the next user interaction auto-resumes. Frontend distinguishes the two so the user only sees the "resume required" affordance when their action is actually required. */
+    pauseReason?: SessionPauseReason | null;
+    /** @nullable */
+    completedAt?: string | null;
+    createdAt: string;
+    updatedAt: string;
+}

package/dist/models/sessionResponseDto.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/models/sessionResponseDtoDataEnvelope.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Generated by orval v8.6.2 🍺
+ * Do not edit manually.
+ * Interactive Session API
+ * Real-time interactive AI coding sessions with agent management, file browsing, and activity streaming
+ * OpenAPI spec version: 0.1.0
+ */
+import type { SessionResponseDto } from './sessionResponseDto';
+export interface SessionResponseDtoDataEnvelope {
+    data: SessionResponseDto;
+}

package/dist/models/sessionResponseDtoDataEnvelope.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/models/sessionResponseDtoFailureMetaJson.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Generated by orval v8.6.2 🍺
+ * Do not edit manually.
+ * Interactive Session API
+ * Real-time interactive AI coding sessions with agent management, file browsing, and activity streaming
+ * OpenAPI spec version: 0.1.0
+ */
+/**
+ * Structured payload paired with `failureCode`. Shape is code-specific. For clone failures: `{ slug, requestedBranch, availableBranches, defaultBranchSuggestion }`.
+ * @nullable
+ */
+export type SessionResponseDtoFailureMetaJson = {
+    [key: string]: unknown;
+} | null;

package/dist/models/sessionResponseDtoFailureMetaJson.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Generated by orval v8.6.2 🍺
+ * Do not edit manually.
+ * Interactive Session API
+ * Real-time interactive AI coding sessions with agent management, file browsing, and activity streaming
+ * OpenAPI spec version: 0.1.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/models/sessionResponseDtoHandoffOutput.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Generated by orval v8.6.2 🍺
+ * Do not edit manually.
+ * Interactive Session API
+ * Real-time interactive AI coding sessions with agent management, file browsing, and activity streaming
+ * OpenAPI spec version: 0.1.0
+ */
+/**
+ * Structured deliverable contract emitted by the in-session agent (the JSON written to `/workspace/deliverables/contract.json` against the session's `deliverableSpecRef`). Captured idempotently on the first `POST /sessions/:id/handoff`. `null` until the agent has handed off.
+ * @nullable
+ */
+export type SessionResponseDtoHandoffOutput = {
+    [key: string]: unknown;
+} | null;

package/dist/models/sessionResponseDtoHandoffOutput.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Generated by orval v8.6.2 🍺
+ * Do not edit manually.
+ * Interactive Session API
+ * Real-time interactive AI coding sessions with agent management, file browsing, and activity streaming
+ * OpenAPI spec version: 0.1.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });