@opengeni/api-router 0.30.1 → 1.0.0

package/dist/mcp/scheduled-task-view.d.ts

@@ -60,6 +60,7 @@ export declare function projectScheduledTaskSchedule(schedule: ScheduledTaskSche
 export declare function scheduledTaskMcpSummary(task: ScheduledTask): {
     id: string;
     name: string;
+    executionDigest: string;
     status: "active" | "paused";
     schedule: {
         type: "manual";
@@ -135,9 +136,10 @@ export declare function scheduledTaskMcpSummary(task: ScheduledTask): {
     createdAt: string;
     updatedAt: string;
     configuration: {
+        source: string;
         model: string | null;
         reasoningEffort: "high" | "low" | "max" | "medium" | "minimal" | "none" | "xhigh" | null;
-        sandboxBackend: "blaxel" | "cloudflare" | "daytona" | "docker" | "e2b" | "local" | "modal" | "none" | "runloop" | "selfhosted" | "vercel" | null;
+        sandboxBackend: "blaxel" | "cloudflare" | "daytona" | "docker" | "e2b" | "local" | "modal" | "none" | "opensandbox" | "runloop" | "selfhosted" | "vercel" | null;
         hasGoal: boolean;
         promptBytes: number;
         resourceCount: number;
@@ -180,9 +182,22 @@ export declare function scheduledTaskMcpSummary(task: ScheduledTask): {
         maxBytes: number;
     };
 };
+/** Exact bounded text; JSON escapes preserve even legacy lone UTF-16 units. */
+export declare function scheduledTaskPromptPage(task: ScheduledTask, offset: number, expectedExecutionDigest?: string): {
+    id: string;
+    executionDigest: string;
+    prompt: {
+        text: string;
+        offset: number;
+        nextOffset: number | null;
+        totalLength: number;
+        unit: "utf16";
+    };
+};
 export declare function boundScheduledTaskDetailMcp(task: ScheduledTask): {
     id: string;
     name: string;
+    executionDigest: string;
     status: "active" | "paused";
     schedule: {
         type: "manual";
@@ -258,9 +273,10 @@ export declare function boundScheduledTaskDetailMcp(task: ScheduledTask): {
     createdAt: string;
     updatedAt: string;
     configuration: {
+        source: string;
         model: string | null;
         reasoningEffort: "high" | "low" | "max" | "medium" | "minimal" | "none" | "xhigh" | null;
-        sandboxBackend: "blaxel" | "cloudflare" | "daytona" | "docker" | "e2b" | "local" | "modal" | "none" | "runloop" | "selfhosted" | "vercel" | null;
+        sandboxBackend: "blaxel" | "cloudflare" | "daytona" | "docker" | "e2b" | "local" | "modal" | "none" | "opensandbox" | "runloop" | "selfhosted" | "vercel" | null;
         hasGoal: boolean;
         promptBytes: number;
         resourceCount: number;
@@ -310,7 +326,7 @@ export declare function boundScheduledTaskDetailMcp(task: ScheduledTask): {
             metadataKeys: string[];
             model: string | null;
             reasoningEffort: "high" | "low" | "max" | "medium" | "minimal" | "none" | "xhigh" | null;
-            sandboxBackend: "blaxel" | "cloudflare" | "daytona" | "docker" | "e2b" | "local" | "modal" | "none" | "runloop" | "selfhosted" | "vercel" | null;
+            sandboxBackend: "blaxel" | "cloudflare" | "daytona" | "docker" | "e2b" | "local" | "modal" | "none" | "opensandbox" | "runloop" | "selfhosted" | "vercel" | null;
             goal: {
                 text: string;
                 successCriteria: string | null;
@@ -367,6 +383,7 @@ export declare function boundScheduledTaskMcpPage(input: {
     tasks: {
         id: string;
         name: string;
+        executionDigest: string;
         status: "active" | "paused";
         schedule: {
             type: "manual";
@@ -442,9 +459,10 @@ export declare function boundScheduledTaskMcpPage(input: {
         createdAt: string;
         updatedAt: string;
         configuration: {
+            source: string;
             model: string | null;
             reasoningEffort: "high" | "low" | "max" | "medium" | "minimal" | "none" | "xhigh" | null;
-            sandboxBackend: "blaxel" | "cloudflare" | "daytona" | "docker" | "e2b" | "local" | "modal" | "none" | "runloop" | "selfhosted" | "vercel" | null;
+            sandboxBackend: "blaxel" | "cloudflare" | "daytona" | "docker" | "e2b" | "local" | "modal" | "none" | "opensandbox" | "runloop" | "selfhosted" | "vercel" | null;
             hasGoal: boolean;
             promptBytes: number;
             resourceCount: number;

package/dist/mcp/server.d.ts

@@ -1,11 +1,53 @@
-import { type AccessGrant, type SessionAuthorizationActor, type WorkspaceMemoryPromptMode } from "@opengeni/contracts";
-import { listSessionDiscoverySummaries, type SessionDiscoveryCursor, type SessionDiscoveryOrderBy } from "@opengeni/db";
+import { ResourceRef, type AccessGrant, type GitHubRepository, type SessionAuthorizationActor, type WorkspaceMemoryPromptMode } from "@opengeni/contracts";
+import { listSessionDiscoverySummaries, type SessionDiscoveryCursor, type SessionDiscoveryOrderBy, type MemoryAgentScope } from "@opengeni/db";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import type { ApiRouteDeps } from "@opengeni/core";
+import { type OpenGeniSlackBotClient } from "../integrations/slack-bot.js";
 export type McpServerOptions = {
     requestOrigin?: string | null;
     workspaceMemoryEnabled?: boolean | undefined;
     workspaceMemoryPromptMode?: WorkspaceMemoryPromptMode | undefined;
+    /**
+     * The bound session's typed Memory selector (migration 0427), resolved by
+     * the route from the session row. `off` registers no Memory tools; `user`
+     * and `session` read the workspace layer plus their own private layer and
+     * save into that private layer. Omitted/null keeps the workspace layer.
+     */
+    sessionMemory?: MemoryAgentScope | null | undefined;
+};
+export declare function slackBotFileContentResult(result: Awaited<ReturnType<OpenGeniSlackBotClient["fileContent"]>>): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: {
+        kind: "text";
+        fileId: string;
+        contentType: string;
+        content: string;
+        sizeBytes: null;
+        nextOffset: number | null;
+    };
+} | {
+    structuredContent: {
+        kind: "image";
+        fileId: string;
+        contentType: "image/jpeg" | "image/png" | "image/webp";
+        content: null;
+        sizeBytes: number;
+        nextOffset: null;
+    };
+    content: ({
+        type: "text";
+        text: string;
+        mimeType?: never;
+        data?: never;
+    } | {
+        readonly text?: never;
+        type: "image";
+        mimeType: "image/jpeg" | "image/png" | "image/webp";
+        data: string;
+    })[];
 };
 export declare function buildOpenGeniMcpServer(deps: ApiRouteDeps, grant: AccessGrant, options?: McpServerOptions): McpServer;
 /** Only a prompt explicitly supplied through the human/API channel may redirect a user-paused goal. */
@@ -45,11 +87,182 @@ export declare function memorySlackPublicationActor(actor: Extract<SessionAuthor
     };
     ownerLabel: string | null;
 };
+/**
+ * Project one allowlisted GitHub App repository into the resource an agent or
+ * scheduled task attaches. Every listed repository is in the workspace
+ * allowlist, public or private, so every resource carries the stable ids
+ * that mint the scoped installation token; a bare URI would clone anonymously
+ * and could never push.
+ */
+export declare function repositoryWithScheduledTaskResource(repository: GitHubRepository): GitHubRepository & {
+    resource: ResourceRef;
+};
 export declare function encodeSessionDiscoveryCursor(cursor: SessionDiscoveryCursor): string;
 export declare function decodeSessionDiscoveryCursor(value: string): SessionDiscoveryCursor;
+export declare function capSessionDiscoveryCompactPage(page: Awaited<ReturnType<typeof listSessionDiscoverySummaries>>, options?: {
+    includeLastMessage?: boolean;
+    includeRelatedWork?: boolean;
+}, maxBytes?: number): {
+    sessions: ({
+        id: string;
+        projectId?: string;
+        title: string | null;
+        status: "cancelled" | "failed" | "idle" | "queued" | "recovering" | "requires_action" | "running" | "waiting_capacity";
+        titleTruncated?: boolean;
+        parentSessionId?: string;
+        goal?: {
+            status: "active" | "completed" | "paused";
+            summary: string | null;
+            summaryTruncated?: boolean;
+        };
+        pause?: {
+            state: string;
+            source?: {
+                kind: "session" | "workspace";
+                sessionId?: string;
+                displayName: string | null;
+                displayNameTruncated?: boolean;
+                reason?: string | null;
+                reasonTruncated?: boolean;
+            };
+            additionalBlockerCount?: number;
+        };
+        attention?: {
+            requiresActionDescendants?: number;
+            pausedDescendants?: number;
+            failedDescendants?: number;
+            truncated?: boolean;
+        };
+        relatedWork?: {
+            claims: {
+                id: string;
+                sessionId: string;
+                subject: {
+                    namespace: string;
+                    type: "artifact" | "branch" | "ci_run" | "issue" | "other" | "pull_request" | "release" | "repository";
+                    canonicalKey: string;
+                    displayLabel: string | null;
+                };
+                role: "delivering" | "monitoring" | "reviewing" | "working";
+                state: "active" | "released" | "stale" | "superseded";
+                revision: number;
+                provenance: "explicit_agent" | "session_resource" | "system_lifecycle" | "trusted_integration" | "user_api";
+                version: {
+                    kind: "artifact_version" | "branch_head" | "ci_run" | "git_commit" | "other" | "pull_request_head" | "release_version";
+                    value: string;
+                } | null;
+                observedAt: string;
+                updatedAt: string;
+                settledAt: string | null;
+            }[];
+            claimsTruncated: boolean;
+            match: {
+                class: "exact_subject" | "fuzzy" | "goal" | "title";
+                field: "claim_key" | "claim_label" | "goal" | "subject" | "title";
+                scoreBand: "exact" | "related" | "strong";
+                claimId: string | null;
+            } | null;
+            possibleOverlap: boolean;
+            advisoryOnly: true;
+            noAdditionalAccess: true;
+        };
+        updatedAt: string;
+        queuedPromptCount?: number;
+    } | {
+        id: string;
+        projectId?: string;
+        title: string | null;
+        status: "cancelled" | "failed" | "idle" | "queued" | "recovering" | "requires_action" | "running" | "waiting_capacity";
+        titleTruncated?: boolean;
+        parentSessionId?: string;
+        goal?: {
+            status: "active" | "completed" | "paused";
+            summary: string | null;
+            summaryTruncated?: boolean;
+        };
+        pause?: {
+            state: string;
+            source?: {
+                kind: "session" | "workspace";
+                sessionId?: string;
+                displayName: string | null;
+                displayNameTruncated?: boolean;
+                reason?: string | null;
+                reasonTruncated?: boolean;
+            };
+            additionalBlockerCount?: number;
+        };
+        attention?: {
+            requiresActionDescendants?: number;
+            pausedDescendants?: number;
+            failedDescendants?: number;
+            truncated?: boolean;
+        };
+        relatedWork?: {
+            claims: {
+                id: string;
+                sessionId: string;
+                subject: {
+                    namespace: string;
+                    type: "artifact" | "branch" | "ci_run" | "issue" | "other" | "pull_request" | "release" | "repository";
+                    canonicalKey: string;
+                    displayLabel: string | null;
+                };
+                role: "delivering" | "monitoring" | "reviewing" | "working";
+                state: "active" | "released" | "stale" | "superseded";
+                revision: number;
+                provenance: "explicit_agent" | "session_resource" | "system_lifecycle" | "trusted_integration" | "user_api";
+                version: {
+                    kind: "artifact_version" | "branch_head" | "ci_run" | "git_commit" | "other" | "pull_request_head" | "release_version";
+                    value: string;
+                } | null;
+                observedAt: string;
+                updatedAt: string;
+                settledAt: string | null;
+            }[];
+            claimsTruncated: boolean;
+            match: {
+                class: "exact_subject" | "fuzzy" | "goal" | "title";
+                field: "claim_key" | "claim_label" | "goal" | "subject" | "title";
+                scoreBand: "exact" | "related" | "strong";
+                claimId: string | null;
+            } | null;
+            possibleOverlap: boolean;
+            advisoryOnly: true;
+            noAdditionalAccess: true;
+        };
+        updatedAt: string;
+        queuedPromptCount?: number;
+        latestMessage: {
+            type: "agent.message.completed" | "agent.message.delta" | "agent.model.request" | "agent.model.usage" | "agent.reasoning.delta" | "agent.toolCall.created" | "agent.toolCall.output" | "agent.updated" | "artifact.created" | "codex.account.selection.changed" | "codex.account.switched" | "codex.capacity.resumed" | "codex.capacity.superseded" | "codex.capacity.waiting" | "codex.credential.selected" | "codex.fleet.decision" | "credential.auth_needed" | "fs.changed" | "git.changed" | "goal.cleared" | "goal.completed" | "goal.continuation" | "goal.held" | "goal.paused" | "goal.progress" | "goal.resumed" | "goal.rewrite.proposed" | "goal.rewrite.rejected" | "goal.set" | "goal.updated" | "instruction.confirmation.recovered" | "knowledge.confirmation.recovered" | "knowledge.source.failed" | "knowledge.source.prepared" | "machine.link.lost" | "machine.link.restored" | "machine.op.failed" | "machine.op.recovered" | "machine.runner.restarted" | "memory.corrected" | "memory.saved" | "recording.available" | "recording.failed" | "recording.started" | "rig.setup.completed" | "rig.setup.failed" | "rig.setup.skipped" | "rig.setup.started" | "sandbox.box.created" | "sandbox.box.lost" | "sandbox.box.snapshot" | "sandbox.box.terminated" | "sandbox.command.output.delta" | "sandbox.env.drift" | "sandbox.operation.completed" | "sandbox.operation.failed" | "sandbox.operation.started" | "session.agent.updated" | "session.command.backgrounded" | "session.command.finished" | "session.context.cleared" | "session.context.compacted" | "session.context.compaction.requested" | "session.context.compaction.skipped" | "session.context.compaction.started" | "session.control.paused" | "session.control.resumed" | "session.control.steer_requested" | "session.created" | "session.event.envelope_omitted" | "session.humanInput.requested" | "session.mcp.approval_policy.updated" | "session.model_settings.updated" | "session.personal_resources.attached" | "session.queue.changed" | "session.queue.history" | "session.queue.prompt.cancelled" | "session.realtime.ended" | "session.realtime.started" | "session.requiresAction" | "session.route.reconciled" | "session.runtime.configured" | "session.status.changed" | "session.title_set" | "session.tool_policy.updated" | "session.variable_sets.updated" | "session.visibility.changed" | "session.wait.finished" | "session.wait.started" | "stream.closed" | "stream.opened" | "stream.revoked" | "stream.url.rotated" | "system.update.cancelled" | "system.update.delivered" | "system.update.pending" | "system.update.settled" | "system.update.superseded" | "terminal.pty.exited" | "terminal.pty.output.delta" | "terminal.pty.started" | "tool.auth_needed" | "turn.cancelled" | "turn.capacity_waiting" | "turn.completed" | "turn.dispatch.expired" | "turn.event.rejected_late" | "turn.failed" | "turn.queued" | "turn.recovery.requested" | "turn.started" | "turn.startup.phase.completed" | "turn.startup.phase.failed" | "turn.startup.phase.started" | "turn.superseded" | "usage.exhausted" | "usage.period_reset" | "usage.threshold_reached" | "user.approvalDecision" | "user.humanInputResponse" | "user.message" | "user.pause" | "workspace.inference.paused" | "workspace.inference.resumed" | "workspace.revision.captured" | "workspace.revision.degraded";
+            previewOmitted: boolean;
+            previewOmissionReason: "aggregatePreviewBudget";
+            previewDrillDownTool: "session_events";
+            previewDrillDownInput: {
+                view: "debug";
+                direction: "before";
+                limit: 1;
+                mode: "monitoring";
+                payloadMode: "summary";
+                sessionId: string;
+                includeTypes: ("agent.message.completed" | "agent.message.delta" | "agent.model.request" | "agent.model.usage" | "agent.reasoning.delta" | "agent.toolCall.created" | "agent.toolCall.output" | "agent.updated" | "artifact.created" | "codex.account.selection.changed" | "codex.account.switched" | "codex.capacity.resumed" | "codex.capacity.superseded" | "codex.capacity.waiting" | "codex.credential.selected" | "codex.fleet.decision" | "credential.auth_needed" | "fs.changed" | "git.changed" | "goal.cleared" | "goal.completed" | "goal.continuation" | "goal.held" | "goal.paused" | "goal.progress" | "goal.resumed" | "goal.rewrite.proposed" | "goal.rewrite.rejected" | "goal.set" | "goal.updated" | "instruction.confirmation.recovered" | "knowledge.confirmation.recovered" | "knowledge.source.failed" | "knowledge.source.prepared" | "machine.link.lost" | "machine.link.restored" | "machine.op.failed" | "machine.op.recovered" | "machine.runner.restarted" | "memory.corrected" | "memory.saved" | "recording.available" | "recording.failed" | "recording.started" | "rig.setup.completed" | "rig.setup.failed" | "rig.setup.skipped" | "rig.setup.started" | "sandbox.box.created" | "sandbox.box.lost" | "sandbox.box.snapshot" | "sandbox.box.terminated" | "sandbox.command.output.delta" | "sandbox.env.drift" | "sandbox.operation.completed" | "sandbox.operation.failed" | "sandbox.operation.started" | "session.agent.updated" | "session.command.backgrounded" | "session.command.finished" | "session.context.cleared" | "session.context.compacted" | "session.context.compaction.requested" | "session.context.compaction.skipped" | "session.context.compaction.started" | "session.control.paused" | "session.control.resumed" | "session.control.steer_requested" | "session.created" | "session.event.envelope_omitted" | "session.humanInput.requested" | "session.mcp.approval_policy.updated" | "session.model_settings.updated" | "session.personal_resources.attached" | "session.queue.changed" | "session.queue.history" | "session.queue.prompt.cancelled" | "session.realtime.ended" | "session.realtime.started" | "session.requiresAction" | "session.route.reconciled" | "session.runtime.configured" | "session.status.changed" | "session.title_set" | "session.tool_policy.updated" | "session.variable_sets.updated" | "session.visibility.changed" | "session.wait.finished" | "session.wait.started" | "stream.closed" | "stream.opened" | "stream.revoked" | "stream.url.rotated" | "system.update.cancelled" | "system.update.delivered" | "system.update.pending" | "system.update.settled" | "system.update.superseded" | "terminal.pty.exited" | "terminal.pty.output.delta" | "terminal.pty.started" | "tool.auth_needed" | "turn.cancelled" | "turn.capacity_waiting" | "turn.completed" | "turn.dispatch.expired" | "turn.event.rejected_late" | "turn.failed" | "turn.queued" | "turn.recovery.requested" | "turn.started" | "turn.startup.phase.completed" | "turn.startup.phase.failed" | "turn.startup.phase.started" | "turn.superseded" | "usage.exhausted" | "usage.period_reset" | "usage.threshold_reached" | "user.approvalDecision" | "user.humanInputResponse" | "user.message" | "user.pause" | "workspace.inference.paused" | "workspace.inference.resumed" | "workspace.revision.captured" | "workspace.revision.degraded")[];
+            };
+        } | {
+            type: "agent.message.completed" | "agent.message.delta" | "agent.model.request" | "agent.model.usage" | "agent.reasoning.delta" | "agent.toolCall.created" | "agent.toolCall.output" | "agent.updated" | "artifact.created" | "codex.account.selection.changed" | "codex.account.switched" | "codex.capacity.resumed" | "codex.capacity.superseded" | "codex.capacity.waiting" | "codex.credential.selected" | "codex.fleet.decision" | "credential.auth_needed" | "fs.changed" | "git.changed" | "goal.cleared" | "goal.completed" | "goal.continuation" | "goal.held" | "goal.paused" | "goal.progress" | "goal.resumed" | "goal.rewrite.proposed" | "goal.rewrite.rejected" | "goal.set" | "goal.updated" | "instruction.confirmation.recovered" | "knowledge.confirmation.recovered" | "knowledge.source.failed" | "knowledge.source.prepared" | "machine.link.lost" | "machine.link.restored" | "machine.op.failed" | "machine.op.recovered" | "machine.runner.restarted" | "memory.corrected" | "memory.saved" | "recording.available" | "recording.failed" | "recording.started" | "rig.setup.completed" | "rig.setup.failed" | "rig.setup.skipped" | "rig.setup.started" | "sandbox.box.created" | "sandbox.box.lost" | "sandbox.box.snapshot" | "sandbox.box.terminated" | "sandbox.command.output.delta" | "sandbox.env.drift" | "sandbox.operation.completed" | "sandbox.operation.failed" | "sandbox.operation.started" | "session.agent.updated" | "session.command.backgrounded" | "session.command.finished" | "session.context.cleared" | "session.context.compacted" | "session.context.compaction.requested" | "session.context.compaction.skipped" | "session.context.compaction.started" | "session.control.paused" | "session.control.resumed" | "session.control.steer_requested" | "session.created" | "session.event.envelope_omitted" | "session.humanInput.requested" | "session.mcp.approval_policy.updated" | "session.model_settings.updated" | "session.personal_resources.attached" | "session.queue.changed" | "session.queue.history" | "session.queue.prompt.cancelled" | "session.realtime.ended" | "session.realtime.started" | "session.requiresAction" | "session.route.reconciled" | "session.runtime.configured" | "session.status.changed" | "session.title_set" | "session.tool_policy.updated" | "session.variable_sets.updated" | "session.visibility.changed" | "session.wait.finished" | "session.wait.started" | "stream.closed" | "stream.opened" | "stream.revoked" | "stream.url.rotated" | "system.update.cancelled" | "system.update.delivered" | "system.update.pending" | "system.update.settled" | "system.update.superseded" | "terminal.pty.exited" | "terminal.pty.output.delta" | "terminal.pty.started" | "tool.auth_needed" | "turn.cancelled" | "turn.capacity_waiting" | "turn.completed" | "turn.dispatch.expired" | "turn.event.rejected_late" | "turn.failed" | "turn.queued" | "turn.recovery.requested" | "turn.started" | "turn.startup.phase.completed" | "turn.startup.phase.failed" | "turn.startup.phase.started" | "turn.superseded" | "usage.exhausted" | "usage.period_reset" | "usage.threshold_reached" | "user.approvalDecision" | "user.humanInputResponse" | "user.message" | "user.pause" | "workspace.inference.paused" | "workspace.inference.resumed" | "workspace.revision.captured" | "workspace.revision.degraded";
+            preview: string | null;
+            previewTruncated?: boolean;
+        };
+    })[];
+    total: number;
+    nextCursor: string | null;
+    updatedThrough?: string | null;
+    responseTruncated?: boolean;
+    truncationReason?: string;
+};
 export declare function capSessionDiscoveryPage(page: Awaited<ReturnType<typeof listSessionDiscoverySummaries>>, includeLastMessage: boolean): {
     sessions: {
         id: string;
+        projectId?: string;
         title: string | null;
         titleTruncated: boolean;
         parentSessionId: string | null;
@@ -76,13 +289,51 @@ export declare function capSessionDiscoveryPage(page: Awaited<ReturnType<typeof
             totalDescendants: number;
             runningDescendants: number;
             queuedDescendants: number;
+            waitingDescendants?: number | undefined;
             attentionDescendants: number;
             pausedDescendants: number;
             failedDescendants: number;
+            unreadDescendants?: number | undefined;
+            unreadFailedDescendants?: number | undefined;
+            activelyWorkingDescendants?: number | undefined;
+            attentionSince?: string | null | undefined;
             truncated: boolean;
         };
+        relatedWork: {
+            claims: {
+                id: string;
+                sessionId: string;
+                subject: {
+                    namespace: string;
+                    type: "artifact" | "branch" | "ci_run" | "issue" | "other" | "pull_request" | "release" | "repository";
+                    canonicalKey: string;
+                    displayLabel: string | null;
+                };
+                role: "delivering" | "monitoring" | "reviewing" | "working";
+                state: "active" | "released" | "stale" | "superseded";
+                revision: number;
+                provenance: "explicit_agent" | "session_resource" | "system_lifecycle" | "trusted_integration" | "user_api";
+                version: {
+                    kind: "artifact_version" | "branch_head" | "ci_run" | "git_commit" | "other" | "pull_request_head" | "release_version";
+                    value: string;
+                } | null;
+                observedAt: string;
+                updatedAt: string;
+                settledAt: string | null;
+            }[];
+            claimsTruncated: boolean;
+            match: {
+                class: "exact_subject" | "fuzzy" | "goal" | "title";
+                field: "claim_key" | "claim_label" | "goal" | "subject" | "title";
+                scoreBand: "exact" | "related" | "strong";
+                claimId: string | null;
+            } | null;
+            possibleOverlap: boolean;
+            advisoryOnly: true;
+            noAdditionalAccess: true;
+        };
         latestMessage?: {
-            type: "agent.message.completed" | "agent.message.delta" | "agent.model.request" | "agent.model.usage" | "agent.reasoning.delta" | "agent.toolCall.created" | "agent.toolCall.output" | "agent.updated" | "artifact.created" | "codex.account.switched" | "codex.capacity.resumed" | "codex.capacity.superseded" | "codex.capacity.waiting" | "codex.credential.selected" | "codex.fleet.decision" | "credential.auth_needed" | "fs.changed" | "git.changed" | "goal.cleared" | "goal.completed" | "goal.continuation" | "goal.paused" | "goal.progress" | "goal.resumed" | "goal.rewrite.proposed" | "goal.rewrite.rejected" | "goal.set" | "goal.updated" | "machine.link.lost" | "machine.link.restored" | "machine.op.failed" | "machine.op.recovered" | "machine.runner.restarted" | "memory.corrected" | "memory.saved" | "recording.available" | "recording.failed" | "recording.started" | "rig.setup.completed" | "rig.setup.failed" | "rig.setup.skipped" | "rig.setup.started" | "sandbox.box.created" | "sandbox.box.lost" | "sandbox.box.snapshot" | "sandbox.box.terminated" | "sandbox.command.output.delta" | "sandbox.env.drift" | "sandbox.operation.completed" | "sandbox.operation.failed" | "sandbox.operation.started" | "session.context.cleared" | "session.context.compacted" | "session.context.compaction.requested" | "session.context.compaction.skipped" | "session.context.compaction.started" | "session.control.paused" | "session.control.resumed" | "session.control.steer_requested" | "session.created" | "session.event.envelope_omitted" | "session.humanInput.requested" | "session.mcp.approval_policy.updated" | "session.queue.changed" | "session.queue.history" | "session.queue.prompt.cancelled" | "session.realtime.ended" | "session.realtime.started" | "session.requiresAction" | "session.route.reconciled" | "session.status.changed" | "session.title_set" | "session.tool_policy.updated" | "session.visibility.changed" | "stream.closed" | "stream.opened" | "stream.revoked" | "stream.url.rotated" | "system.update.cancelled" | "system.update.delivered" | "system.update.pending" | "system.update.settled" | "system.update.superseded" | "terminal.pty.exited" | "terminal.pty.output.delta" | "terminal.pty.started" | "tool.auth_needed" | "turn.cancelled" | "turn.capacity_waiting" | "turn.completed" | "turn.event.rejected_late" | "turn.failed" | "turn.queued" | "turn.recovery.requested" | "turn.started" | "turn.superseded" | "user.approvalDecision" | "user.humanInputResponse" | "user.message" | "user.pause" | "workspace.inference.paused" | "workspace.inference.resumed" | "workspace.revision.captured" | "workspace.revision.degraded";
+            type: "agent.message.completed" | "agent.message.delta" | "agent.model.request" | "agent.model.usage" | "agent.reasoning.delta" | "agent.toolCall.created" | "agent.toolCall.output" | "agent.updated" | "artifact.created" | "codex.account.selection.changed" | "codex.account.switched" | "codex.capacity.resumed" | "codex.capacity.superseded" | "codex.capacity.waiting" | "codex.credential.selected" | "codex.fleet.decision" | "credential.auth_needed" | "fs.changed" | "git.changed" | "goal.cleared" | "goal.completed" | "goal.continuation" | "goal.held" | "goal.paused" | "goal.progress" | "goal.resumed" | "goal.rewrite.proposed" | "goal.rewrite.rejected" | "goal.set" | "goal.updated" | "instruction.confirmation.recovered" | "knowledge.confirmation.recovered" | "knowledge.source.failed" | "knowledge.source.prepared" | "machine.link.lost" | "machine.link.restored" | "machine.op.failed" | "machine.op.recovered" | "machine.runner.restarted" | "memory.corrected" | "memory.saved" | "recording.available" | "recording.failed" | "recording.started" | "rig.setup.completed" | "rig.setup.failed" | "rig.setup.skipped" | "rig.setup.started" | "sandbox.box.created" | "sandbox.box.lost" | "sandbox.box.snapshot" | "sandbox.box.terminated" | "sandbox.command.output.delta" | "sandbox.env.drift" | "sandbox.operation.completed" | "sandbox.operation.failed" | "sandbox.operation.started" | "session.agent.updated" | "session.command.backgrounded" | "session.command.finished" | "session.context.cleared" | "session.context.compacted" | "session.context.compaction.requested" | "session.context.compaction.skipped" | "session.context.compaction.started" | "session.control.paused" | "session.control.resumed" | "session.control.steer_requested" | "session.created" | "session.event.envelope_omitted" | "session.humanInput.requested" | "session.mcp.approval_policy.updated" | "session.model_settings.updated" | "session.personal_resources.attached" | "session.queue.changed" | "session.queue.history" | "session.queue.prompt.cancelled" | "session.realtime.ended" | "session.realtime.started" | "session.requiresAction" | "session.route.reconciled" | "session.runtime.configured" | "session.status.changed" | "session.title_set" | "session.tool_policy.updated" | "session.variable_sets.updated" | "session.visibility.changed" | "session.wait.finished" | "session.wait.started" | "stream.closed" | "stream.opened" | "stream.revoked" | "stream.url.rotated" | "system.update.cancelled" | "system.update.delivered" | "system.update.pending" | "system.update.settled" | "system.update.superseded" | "terminal.pty.exited" | "terminal.pty.output.delta" | "terminal.pty.started" | "tool.auth_needed" | "turn.cancelled" | "turn.capacity_waiting" | "turn.completed" | "turn.dispatch.expired" | "turn.event.rejected_late" | "turn.failed" | "turn.queued" | "turn.recovery.requested" | "turn.started" | "turn.startup.phase.completed" | "turn.startup.phase.failed" | "turn.startup.phase.started" | "turn.superseded" | "usage.exhausted" | "usage.period_reset" | "usage.threshold_reached" | "user.approvalDecision" | "user.humanInputResponse" | "user.message" | "user.pause" | "workspace.inference.paused" | "workspace.inference.resumed" | "workspace.revision.captured" | "workspace.revision.degraded";
             preview: string | null;
             previewTruncated: boolean;
         } | null;
@@ -105,6 +356,7 @@ export declare function capSessionDiscoveryPage(page: Awaited<ReturnType<typeof
         omissionReason: "aggregatePreviewBudget" | null;
         drillDownTool: "session_events";
         drillDownInput: {
+            view: "debug";
             direction: "before";
             limit: 1;
             mode: "monitoring";

package/dist/mcp/session-event-view.d.ts

@@ -0,0 +1,94 @@
+import { z } from "zod";
+import type { SessionEventSliceOptions, SessionEventSlicePage } from "@opengeni/db/session-event-slices";
+export declare const SESSION_EVENT_VIEW_MAX_BYTES: number;
+declare const selectionSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    view: z.ZodEnum<{
+        conversation: "conversation";
+        results: "results";
+        tools: "tools";
+    }>;
+    includeArguments: z.ZodBoolean;
+    includeOutput: z.ZodBoolean;
+    callId: z.ZodNullable<z.ZodString>;
+    toolName: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    direction: z.ZodEnum<{
+        after: "after";
+        before: "before";
+    }>;
+    after: z.ZodNumber;
+    before: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+type Selection = z.infer<typeof selectionSchema>;
+export type SessionEventViewInput = {
+    sessionId: string;
+    view?: Selection["view"] | undefined;
+    after?: number | undefined;
+    before?: number | undefined;
+    direction?: Selection["direction"] | undefined;
+    limit?: number | undefined;
+    cursor?: string | undefined;
+    callId?: string | undefined;
+    toolName?: string | undefined;
+    includeArguments?: boolean | undefined;
+    includeOutput?: boolean | undefined;
+};
+type Item = {
+    sequence: number;
+    turnId?: string;
+    role?: string;
+    text?: string;
+} & Record<string, unknown>;
+type ReadPage = (options: SessionEventSliceOptions) => Promise<SessionEventSlicePage>;
+/** A cursor is a bounded selector, never authority. The caller reauthorizes every read. */
+export declare function resolveSessionEventView(input: SessionEventViewInput): {
+    selection: {
+        sessionId: string;
+        view: "conversation" | "results" | "tools";
+        includeArguments: boolean;
+        includeOutput: boolean;
+        callId: string | null;
+        toolName: string | null;
+        limit?: number | undefined;
+        direction: "after" | "before";
+        after: number;
+        before: number | null;
+    };
+    continuation: {
+        v: 1 | 2;
+        selection: {
+            sessionId: string;
+            view: "conversation" | "results" | "tools";
+            includeArguments: boolean;
+            includeOutput: boolean;
+            callId: string | null;
+            toolName: string | null;
+            limit?: number | undefined;
+            direction: "after" | "before";
+            after: number;
+            before: number | null;
+        };
+        sequence: number | null;
+        offset: number;
+    } | null;
+};
+/** Read-only projection over the existing RLS/audit query. No command observations. */
+export declare function readSessionEventView(input: SessionEventViewInput, read: ReadPage): Promise<{
+    view: "conversation" | "results" | "tools";
+    effectiveLimit: number;
+    direction: "after" | "before";
+    events: Item[];
+    nextAfter: number | null;
+    nextBefore: number | null;
+    hasMore: boolean;
+    nextCursor: string | null;
+    sourceExact: boolean;
+    sourceLoss?: {
+        reason: "structured_value_exceeds_budget";
+        completeTextAvailable: false;
+        message: string;
+    };
+    maxBytes: number;
+}>;
+export {};

package/dist/mcp/session-view.d.ts

@@ -8,7 +8,7 @@
  * edge while preserving a usable cursor. It never manufactures an event or
  * advances across an event it did not return.
  */
-import type { Rig, Session, SessionEvent, SessionEventCompactResult, SessionEventPayloadMode, SessionEventReadDirection, SessionEventReadMode } from "@opengeni/contracts";
+import type { Rig, Session, SessionEvent, SessionEventCompactResult, SessionEventPayloadMode, SessionEventReadDirection, SessionEventReadMode, SessionMcpMonitoringSource, SessionQueueSnapshot } from "@opengeni/contracts";
 export declare const SESSION_EVENT_MCP_MAX_BYTES: number;
 export declare const SESSION_EVENT_MCP_FIELD_MAX_CHARS = 4000;
 export declare const DEFAULT_SESSION_DETAIL_CHARS = 6000;
@@ -69,7 +69,62 @@ type SessionDetailFieldFact = {
     deliveredCount?: number;
     measurementBounded?: boolean;
 };
-/** Purpose-built, flat, model-facing detail projection for `session_get`. */
+/** Compact management state; configuration is deliberately excluded, not truncated. */
+export declare function boundSessionCompactDetailMcp(session: Session, monitoring: SessionMcpMonitoringSource, queue: SessionQueueSnapshot | null, maxBytes?: number): {
+    id: string;
+    projectId?: string;
+    title: string | null;
+    status: "cancelled" | "failed" | "idle" | "queued" | "recovering" | "requires_action" | "running" | "waiting_capacity";
+    titleTruncated?: boolean;
+    parentSessionId?: string;
+    activeTurnId?: string;
+    lastSequence: number;
+    goal?: {
+        status: "active" | "completed" | "paused";
+        summary: string | null;
+        summaryTruncated?: boolean;
+        evidence?: string | null;
+        evidenceTruncated?: true;
+        pausedReason?: string | null;
+        pausedReasonTruncated?: true;
+        rationale?: string | null;
+        rationaleTruncated?: true;
+    };
+    progress?: {
+        sequence: number;
+        text: string | null;
+        occurredAt: string;
+        textTruncated?: boolean;
+    };
+    pause?: {
+        state: string;
+        source?: {
+            kind: "session" | "workspace";
+            sessionId?: string;
+            displayName: string | null;
+            displayNameTruncated?: boolean;
+            reason?: string | null;
+            reasonTruncated?: boolean;
+        };
+        additionalBlockerCount?: number;
+    };
+    wait?: {
+        reason: string | null;
+        until: string;
+        reasonTruncated?: boolean;
+    };
+    queue?: {
+        queuedTurns: number;
+        pendingInputs: number;
+        stoppingPreviousAttempt?: boolean;
+    };
+    stopping?: {
+        attempts?: number;
+        backgroundCommands?: number;
+    };
+    updatedAt: string;
+};
+/** Legacy bounded configuration projection for explicit `session_get detail=full`. */
 export declare function boundSessionDetailMcp(session: Session, effectiveControl?: unknown, maxBytes?: number): {
     id: string;
     workspaceId: string;
@@ -83,16 +138,20 @@ export declare function boundSessionDetailMcp(session: Session, effectiveControl
     tools: unknown;
     metadata: unknown;
     model: string;
+    reasoningEffort: "high" | "low" | "max" | "medium" | "minimal" | "none" | "xhigh";
+    latencyMode: "fast" | "priority" | "standard";
     sandboxBackend: string;
     sandboxOs: "linux" | "macos" | "windows";
     sandboxGroupId: string;
     activeSandboxId: string | null;
     activeEpoch: number;
+    variableSetIds: string[];
     variableSetId: string | null;
     environmentId: string | null;
     rigId: string | null;
     rigVersionId: string | null;
     firstPartyMcpPermissions: unknown;
+    effectiveToolPolicy: unknown;
     mcpServers: unknown;
     parentSessionId: string | null;
     createIdempotencyKey: string | null;
@@ -115,9 +174,14 @@ export declare function boundSessionDetailMcp(session: Session, effectiveControl
         totalDescendants: number;
         runningDescendants: number;
         queuedDescendants: number;
+        waitingDescendants?: number | undefined;
         attentionDescendants: number;
         pausedDescendants: number;
         failedDescendants: number;
+        unreadDescendants?: number | undefined;
+        unreadFailedDescendants?: number | undefined;
+        activelyWorkingDescendants?: number | undefined;
+        attentionSince?: string | null | undefined;
         truncated: boolean;
     };
     createdAt: string;