@opengeni/api-router 0.21.14 → 0.22.2

package/dist/index.js

@@ -1,7 +1,7 @@
 import {
   createAppComposition,
   startSlackInteractionPump
-} from "./chunk-R5PDSH2A.js";
+} from "./chunk-HWXJW5C7.js";
 
 // src/index.ts
 import {

package/dist/routes/transcription-recordings.d.ts

@@ -0,0 +1,3 @@
+import { type ApiRouteDeps } from "@opengeni/core";
+import type { Hono } from "hono";
+export declare function registerResumableTranscriptionRoutes(app: Hono, deps: ApiRouteDeps): void;

package/dist/transcription/segmenter.d.ts

@@ -0,0 +1,10 @@
+import type { TranscriptionSegmenter } from "@opengeni/core";
+export declare class TranscriptionSegmenterError extends Error {
+    readonly code: "unavailable" | "invalid_audio" | "cancelled" | "too_large" | "unknown";
+    readonly retryable: boolean;
+    readonly name = "TranscriptionSegmenterError";
+    constructor(message: string, code: "unavailable" | "invalid_audio" | "cancelled" | "too_large" | "unknown", retryable: boolean);
+}
+export declare function createFfmpegTranscriptionSegmenter(input: {
+    ffmpegPath: string;
+}): TranscriptionSegmenter;

package/dist/transcription/service.d.ts

@@ -7,4 +7,9 @@ export declare function createTranscriptionService(input: {
     fetch?: typeof fetch;
     codexFetch?: typeof fetch;
     probeCodex?: (context?: TranscriptionAvailabilityContext) => boolean | Promise<boolean>;
+    /** Test seam for exercising timeout and late-completion behavior quickly. */
+    providerRequestTimeoutMilliseconds?: number;
+    /** Test seam for evaluating persisted absolute deadlines after delayed setup. */
+    now?: () => Date;
 }): TranscriptionService;
+export declare function remainingTranscriptionProviderRequestMilliseconds(providerDeadlineAt: Date, now: Date): number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opengeni/api-router",
-  "version": "0.21.14",
+  "version": "0.22.2",
   "description": "OpenGeni HTTP surface: the Hono adapter/router (createApp), routes, MCP HTTP transport, and HTTP access adapters over @opengeni/core. An engine-distribution surface — its runtime closure includes engine-internal packages.",
   "license": "Apache-2.0",
   "repository": {
@@ -44,17 +44,17 @@
     "@modelcontextprotocol/sdk": "^1.29.0",
     "@opengeni/agent-proto": "^0.3.0",
     "@opengeni/codex": "^0.2.11",
-    "@opengeni/config": "^0.10.14",
-    "@opengeni/contracts": "^0.38.3",
-    "@opengeni/core": "^0.20.16",
-    "@opengeni/db": "^0.27.11",
-    "@opengeni/documents": "^0.5.7",
-    "@opengeni/events": "^0.3.77",
-    "@opengeni/github": "^0.4.30",
+    "@opengeni/config": "^0.11.0",
+    "@opengeni/contracts": "^0.39.0",
+    "@opengeni/core": "^0.21.2",
+    "@opengeni/db": "^0.28.1",
+    "@opengeni/documents": "^0.5.10",
+    "@opengeni/events": "^0.3.80",
+    "@opengeni/github": "^0.4.31",
     "@opengeni/network": "^0.2.0",
-    "@opengeni/observability": "^0.4.16",
-    "@opengeni/runtime": "^0.18.15",
-    "@opengeni/storage": "^0.2.67",
+    "@opengeni/observability": "^0.5.0",
+    "@opengeni/runtime": "^0.18.17",
+    "@opengeni/storage": "^0.2.68",
     "@temporalio/client": "^1.17.0",
     "better-auth": "^1.6.14",
     "hono": "^4.12.18",

package/src/app.ts

@@ -13,6 +13,7 @@ import {
   OPENGENI_CORRELATION_HEADER,
   resolveWorkspaceMemoryEnabled,
   VOICE_INPUT_ACCEPTED_MIME_TYPES,
+  TRANSCRIPTION_RECORDING_PROVIDER_SEGMENT_SECONDS,
   type AccessGrant,
   type ErrorCode,
 } from "@opengeni/contracts";
@@ -77,6 +78,7 @@ import { registerInsightsRoutes } from "./routes/insights";
 import { registerTranscriptionRoutes } from "./routes/transcriptions";
 import { projectClientModel } from "./model-catalog";
 import { createTranscriptionService } from "./transcription/service";
+import { createFfmpegTranscriptionSegmenter } from "./transcription/segmenter";
 import { registerSlackInteractionRoutes } from "./integrations/slack-interactions";
 
 export type {
@@ -103,8 +105,15 @@ export { replaySessionEvents, sseSessionStream, sseWorkspaceControlStream } from
 export const API_MAX_REQUEST_BODY_BYTES = 8 * 1024 * 1024;
 
 /** Effective Hono bodyLimit — API JSON ceiling or voice multipart + multipart overhead. */
-export function apiRequestBodyLimitBytes(settings: { voiceInputMaxSizeBytes: number }): number {
-  return Math.max(API_MAX_REQUEST_BODY_BYTES, settings.voiceInputMaxSizeBytes + 64 * 1024);
+export function apiRequestBodyLimitBytes(settings: {
+  voiceInputMaxSizeBytes: number;
+  voiceInputResumableMaxChunkSizeBytes?: number;
+}): number {
+  return Math.max(
+    API_MAX_REQUEST_BODY_BYTES,
+    settings.voiceInputMaxSizeBytes + 64 * 1024,
+    (settings.voiceInputResumableMaxChunkSizeBytes ?? 0) + 64 * 1024,
+  );
 }
 const API_PUBLIC_ERROR_MESSAGE_MAX_BYTES = 512;
 
@@ -204,6 +213,12 @@ export function createAppComposition(deps: AppDependencies): {
           ...(deps.codexFetch ? { codexFetch: deps.codexFetch } : {}),
         })
       : deps.transcription;
+  const transcriptionSegmenter =
+    deps.transcriptionSegmenter === undefined
+      ? createFfmpegTranscriptionSegmenter({
+          ffmpegPath: deps.settings.voiceInputFfmpegPath,
+        })
+      : deps.transcriptionSegmenter;
   const routeDeps: ApiRouteDeps = {
     ...deps,
     observability,
@@ -214,6 +229,7 @@ export function createAppComposition(deps: AppDependencies): {
     documentIndexer,
     getDocumentServices,
     transcription,
+    transcriptionSegmenter,
     ...(sandboxClient ? { sandboxClient } : {}),
     resumeBoxById,
   };
@@ -440,6 +456,24 @@ export function createAppComposition(deps: AppDependencies): {
           maxDurationSeconds: deps.settings.voiceInputMaxDurationSeconds,
           maxSizeBytes: deps.settings.voiceInputMaxSizeBytes,
           acceptedMimeTypes: [...VOICE_INPUT_ACCEPTED_MIME_TYPES],
+          ...(deps.settings.voiceInputResumableEnabled &&
+          objectStorage &&
+          transcription &&
+          transcriptionSegmenter &&
+          (await transcription.available()) &&
+          (await transcriptionSegmenter.available())
+            ? {
+                resumable: {
+                  maxDurationSeconds: deps.settings.voiceInputResumableMaxDurationSeconds,
+                  maxSizeBytes: deps.settings.voiceInputResumableMaxSizeBytes,
+                  maxChunkSizeBytes: deps.settings.voiceInputResumableMaxChunkSizeBytes,
+                  providerSegmentSeconds: Math.min(
+                    TRANSCRIPTION_RECORDING_PROVIDER_SEGMENT_SECONDS,
+                    deps.settings.voiceInputMaxDurationSeconds,
+                  ),
+                },
+              }
+            : {}),
         },
         productAccessMode: deps.settings.productAccessMode,
         auth: clientAuthConfig(deps.settings),

package/src/mcp/server.ts

@@ -1928,7 +1928,7 @@ function registerFleetTools(
     "sandboxes_list",
     {
       description:
-        "List the sandboxes this session can run on: its own session sandbox plus enrolled selfhosted machines. `liveness` is conservative: online requires observed provider existence and verified workspace readiness. Provider, lease, route, archive, restore, workspace, lease epoch, and route epoch are also reported separately. Use an entry `id` as an attach/swap/run_on target.",
+        "List the sandboxes this session can run on: its own session sandbox plus enrolled selfhosted machines. `liveness` is conservative: online requires observed provider existence and verified workspace readiness. An idle session-home sandbox may report offline/cold/draining and still wake or restore on the next ordinary sandbox operation; never infer that shell/files are unavailable from list liveness alone—only a typed operation/attach failure proves that. Provider, lease, route, archive, restore, workspace, lease epoch, and route epoch are also reported separately. Use an entry `id` as an attach/swap/run_on target.",
       inputSchema: {},
     },
     async () => json(await listFleet(services, await fleetContext())),