mohdel 0.111.0 → 0.112.0

package/js/client/call_transcription.js

@@ -0,0 +1,85 @@
+/**
+ * Send a TranscriptionEnvelope to thin-gate's `POST /v1/transcription`.
+ *
+ * Transcription is one-shot: single JSON response body, no streaming,
+ * no cooldown/rate-limit. `audio.fileUri` must be a `file://` or
+ * `data:` URI — `file://` requires that the gate's sessions share a
+ * filesystem with the caller; `data:` carries the bytes inline subject
+ * to the gate's body-size cap.
+ *
+ * @module client/call_transcription
+ */
+
+import { requestUnix } from './transport.js'
+import { MohdelTypedError } from '#core'
+
+/**
+ * @param {import('#core/transcription.js').TranscriptionEnvelope} envelope
+ * @param {object} options
+ * @param {string} options.socketPath
+ * @param {AbortSignal} [options.signal]
+ * @param {string} [options.path]  HTTP path; defaults to '/v1/transcription'
+ * @returns {Promise<import('#core/transcription.js').TranscriptionResult>}
+ */
+export async function callTranscription (envelope, { socketPath, signal, path = '/v1/transcription' }) {
+  const res = await requestUnix({
+    socketPath,
+    path,
+    method: 'POST',
+    body: envelope,
+    signal
+  })
+
+  const body = await readAll(res)
+
+  if (res.statusCode !== 200) {
+    throw MohdelTypedError.fromJSON(parseErrorBody(body, res.statusCode ?? 0))
+  }
+
+  let parsed
+  try {
+    parsed = JSON.parse(body)
+  } catch (e) {
+    throw new MohdelTypedError(
+      'thin-gate returned non-JSON transcription response',
+      { type: 'PROTOCOL_INVALID_EVENT', retryable: false }
+    )
+  }
+
+  if (!parsed || typeof parsed !== 'object' || parsed.status !== 'completed' || typeof parsed.text !== 'string') {
+    throw new MohdelTypedError(
+      'thin-gate returned malformed TranscriptionResult',
+      { type: 'PROTOCOL_INVALID_EVENT', retryable: false }
+    )
+  }
+  return parsed
+}
+
+/**
+ * @param {AsyncIterable<Buffer|string>} stream
+ * @returns {Promise<string>}
+ */
+async function readAll (stream) {
+  let s = ''
+  for await (const c of stream) s += typeof c === 'string' ? c : c.toString('utf8')
+  return s
+}
+
+/**
+ * @param {string} body
+ * @param {number} status
+ * @returns {import('#core/errors.js').TypedError}
+ */
+function parseErrorBody (body, status) {
+  try {
+    const parsed = JSON.parse(body)
+    if (parsed && typeof parsed === 'object' && typeof parsed.type === 'string') {
+      return parsed
+    }
+  } catch {}
+  return {
+    type: 'PROTOCOL_HTTP_ERROR',
+    message: `thin-gate returned HTTP ${status}`,
+    retryable: status >= 500
+  }
+}

package/js/client/index.js

@@ -4,6 +4,7 @@
  * Public surface (0.90):
  *   - call(envelope, { socketPath, signal }): AsyncGenerator<Event>
  *   - callImage(envelope, { socketPath, signal }): Promise<ImageResult>
+ *   - callTranscription(envelope, { socketPath, signal }): Promise<TranscriptionResult>
  *
  * No provider SDKs are imported transitively. This module can be
  * consumed by callers that must not pull openai-node, anthropic-sdk,
@@ -14,3 +15,4 @@
 
 export { call } from './call.js'
 export { callImage } from './call_image.js'
+export { callTranscription } from './call_transcription.js'

package/js/session/driver.js

@@ -16,6 +16,7 @@ import readline from 'node:readline'
 
 import { run } from './run.js'
 import { runImage } from './run_image.js'
+import { runTranscription } from './run_transcription.js'
 import { setCatalog } from './adapters/_catalog.js'
 
 // Bounded memory for pre-dequeue cancels. Hostile/buggy supervisors
@@ -148,6 +149,16 @@ export async function drive (stdin, stdout) {
         } else {
           stdout.write(JSON.stringify({ type: 'error', error: out.error }) + '\n')
         }
+      } else if (envelope.op === 'transcription') {
+        // Same one-shot contract as the image path; shape matches
+        // `js/core/transcription.js` after the tag strip.
+        const { op: _op, ...trEnv } = envelope
+        const out = await runTranscription(trEnv)
+        if (out.ok) {
+          stdout.write(JSON.stringify({ type: 'transcription_done', result: out.result }) + '\n')
+        } else {
+          stdout.write(JSON.stringify({ type: 'error', error: out.error }) + '\n')
+        }
       } else {
         for await (const ev of run(envelope, { signal: controller.signal })) {
           stdout.write(JSON.stringify(ev) + '\n')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mohdel",
-  "version": "0.111.0",
+  "version": "0.112.0",
   "license": "MIT",
   "author": {
     "name": "Christophe Le Bars",
@@ -87,7 +87,7 @@
     "@opentelemetry/exporter-trace-otlp-grpc": "^0.218.0",
     "@opentelemetry/sdk-node": "^0.218.0",
     "chalk": "^5.4.0",
-    "mohdel-thin-gate-linux-x64-gnu": "0.111.0"
+    "mohdel-thin-gate-linux-x64-gnu": "0.112.0"
   },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.104.1",