oysterun 1.6.0-beta.2 → 1.6.0-beta.21

package/host-service/test-fixtures/p236-navigation-original.mjs

@@ -0,0 +1,500 @@
+// Test-only frozen oracle from 9fcfdebd9eab499b5aaabe3829acb9c206d33c8a; only the two relative import paths changed.
+import {
+  normalizeCommittedProviderOutputMatrixNotificationCandidate,
+  normalizeProviderCompletionReleaseMarker,
+} from "../complete-message-notification-predicate.mjs";
+import {
+  MATRIX_COMPLETED_TURN_CANDIDATE_INDEX,
+  MATRIX_COMPLETED_TURN_COMPLETION_INDEX,
+  MATRIX_COMPLETED_TURN_NAVIGATION_INDEX_VERSION,
+  assertSchemaCompatible,
+} from "../routec-matrix-sqlite-store.mjs";
+
+const SEMANTIC_NAMESPACE = "org.oysterun.semantic.v1";
+const NAVIGATION_SCHEMA_VERSION =
+  "routec.p206_completed_turn_final_message_neighbors.v1";
+
+export const P203_CALLBACK_COMPLETED_TURN_PROJECTION =
+  "p203.exact_final_committed_assistant.v1";
+
+function parseJson(value) {
+  if (typeof value !== "string") return {};
+  const parsed = JSON.parse(value);
+  return parsed && typeof parsed === "object" && !Array.isArray(parsed)
+    ? parsed
+    : {};
+}
+
+function semanticPayload(content) {
+  const payload = content?.[SEMANTIC_NAMESPACE];
+  return payload && typeof payload === "object" && !Array.isArray(payload)
+    ? payload
+    : {};
+}
+
+export function projectP203CallbackCandidate(
+  event,
+  { targetSessionId, targetProviderTurnId } = {}
+) {
+  const normalized = normalizeCommittedProviderOutputMatrixNotificationCandidate(
+    event
+  );
+  if (!normalized.accepted) {
+    return { accepted: false, disposition: normalized.reason };
+  }
+  const candidate = normalized.candidate;
+  if (candidate.hostSessionId !== targetSessionId) {
+    return { accepted: false, disposition: "target_session_mismatch" };
+  }
+  if (candidate.providerTurnId !== targetProviderTurnId) {
+    return { accepted: false, disposition: "provider_turn_mismatch" };
+  }
+  if (candidate.semanticType !== "message.assistant") {
+    return {
+      accepted: false,
+      disposition: "semantic_type_not_callback_success",
+    };
+  }
+  const body = typeof event?.contentBody === "string" ? event.contentBody : "";
+  if (!body) {
+    return { accepted: false, disposition: "assistant_body_missing" };
+  }
+  return {
+    accepted: true,
+    disposition: "candidate_accepted",
+    projection_policy: P203_CALLBACK_COMPLETED_TURN_PROJECTION,
+    candidate: {
+      matrixEventId: candidate.matrixEventId,
+      providerTurnId: candidate.providerTurnId,
+      body,
+    },
+  };
+}
+
+export function projectP203CallbackCompletion(
+  event,
+  { targetSessionId, targetProviderTurnId, targetMatrixRoomId } = {}
+) {
+  const semantic = event?.semanticPayload || {};
+  if (
+    event?.eventType === "m.room.message" &&
+    semantic.semantic_type === "session_lifecycle" &&
+    semantic.provider_completion_state === "turn_failed"
+  ) {
+    if (!event.matrixEventId) {
+      return { accepted: false, disposition: "matrix_event_id_missing" };
+    }
+    if (!targetMatrixRoomId || event.matrixRoomId !== targetMatrixRoomId) {
+      return { accepted: false, disposition: "target_room_mismatch" };
+    }
+    if (semantic.host_session_id !== targetSessionId) {
+      return { accepted: false, disposition: "target_session_mismatch" };
+    }
+    if (
+      semantic.provider_turn_id !== targetProviderTurnId ||
+      semantic.target_turn_id !== targetProviderTurnId
+    ) {
+      return { accepted: false, disposition: "provider_turn_mismatch" };
+    }
+    return {
+      accepted: true,
+      disposition: "completion_accepted",
+      projection_policy: P203_CALLBACK_COMPLETED_TURN_PROJECTION,
+      completion: {
+        matrixEventId: event.matrixEventId,
+        providerTurnId: semantic.provider_turn_id,
+        targetOutcome: "failed",
+        successful: false,
+        status: "failed",
+      },
+    };
+  }
+  const normalized = normalizeProviderCompletionReleaseMarker(event);
+  if (!normalized.accepted) {
+    return { accepted: false, disposition: normalized.reason };
+  }
+  const release = normalized.release;
+  if (release.hostSessionId !== targetSessionId) {
+    return { accepted: false, disposition: "target_session_mismatch" };
+  }
+  if (targetMatrixRoomId && event?.matrixRoomId !== targetMatrixRoomId) {
+    return { accepted: false, disposition: "target_room_mismatch" };
+  }
+  if (release.providerTurnId !== targetProviderTurnId) {
+    return { accepted: false, disposition: "provider_turn_mismatch" };
+  }
+  const status = String(release.status || "").trim().toLowerCase();
+  let targetOutcome = "failed";
+  if (release.successful) targetOutcome = "completed";
+  else if (["interrupted", "interrupt"].includes(status)) {
+    targetOutcome = "interrupted";
+  } else if (["cancelled", "canceled"].includes(status)) {
+    targetOutcome = "cancelled";
+  }
+  return {
+    accepted: true,
+    disposition: "completion_accepted",
+    projection_policy: P203_CALLBACK_COMPLETED_TURN_PROJECTION,
+    completion: {
+      matrixEventId: release.matrixEventId,
+      providerTurnId: release.providerTurnId,
+      targetOutcome,
+      successful: release.successful,
+      status: release.status,
+    },
+  };
+}
+
+const CANDIDATE_WHERE = `c.room_id = @room_id
+  AND c.is_state = 0
+  AND c.type = 'm.room.message'
+  AND c.semantic_type IN ('message.assistant', 'tool.result', 'tool.failure', 'thinking.reasoning')
+  AND json_extract(c.content_json, '$."org.oysterun.semantic.v1".provider_turn_id') IS NOT NULL
+  AND json_extract(c.content_json, '$."org.oysterun.semantic.v1".provider_turn_id') <> ''
+  AND json_extract(c.content_json, '$."org.oysterun.semantic.v1".provider_completion_marker') =
+    'oysterun_provider_complete_message_notification_v1'
+  AND json_extract(c.content_json, '$."org.oysterun.semantic.v1".provider_completion_state') =
+    'pending_turn_completion'
+  AND COALESCE(json_extract(c.content_json, '$.delta'), 0) <> 1
+  AND COALESCE(json_extract(c.content_json, '$."org.oysterun.semantic.v1".delta'), 0) <> 1`;
+
+const COMPLETION_WHERE = `m.room_id = @room_id
+  AND m.is_state = 0
+  AND m.type = 'm.room.message'
+  AND json_extract(m.content_json, '$."org.oysterun.semantic.v1".provider_completion_marker') =
+    'oysterun_provider_complete_message_notification_v1'
+  AND json_extract(m.content_json, '$."org.oysterun.semantic.v1".provider_completion_turn_id') IS NOT NULL
+  AND json_extract(m.content_json, '$."org.oysterun.semantic.v1".provider_completion_turn_id') <> ''
+  AND json_extract(m.content_json, '$."org.oysterun.semantic.v1".provider_completion_state') =
+    'turn_completed'
+  AND json_extract(m.content_json, '$."org.oysterun.semantic.v1".provider_completion_success') = 1
+  AND LOWER(TRIM(COALESCE(
+    json_extract(m.content_json, '$."org.oysterun.semantic.v1".provider_completion_status'),
+    'completed'
+  ))) NOT IN ('failed', 'error', 'errored', 'interrupted', 'interrupt', 'canceled', 'cancelled')`;
+
+function selectorSql(direction) {
+  if (direction !== "previous" && direction !== "next") {
+    throw new Error(`Completed-turn navigation direction is invalid: ${direction}`);
+  }
+  const comparison = direction === "previous" ? "<" : ">";
+  const order = direction === "previous" ? "DESC" : "ASC";
+  return `WITH candidate_finals AS (
+      SELECT
+        json_extract(c.content_json, '$."org.oysterun.semantic.v1".provider_turn_id') AS provider_turn_id,
+        MAX(c.stream_seq) AS final_seq
+      FROM matrix_events AS c
+      WHERE ${CANDIDATE_WHERE}
+      GROUP BY provider_turn_id
+    ), successful_turns AS (
+      SELECT
+        json_extract(m.content_json, '$."org.oysterun.semantic.v1".provider_completion_turn_id') AS provider_turn_id,
+        MAX(m.stream_seq) AS completion_seq
+      FROM matrix_events AS m
+      WHERE ${COMPLETION_WHERE}
+      GROUP BY provider_turn_id
+    )
+    SELECT c.event_id,
+           c.room_id,
+           c.type,
+           c.stream_seq,
+           c.origin_server_ts,
+           c.content_json,
+           c.unsigned_json,
+           m.event_id AS completion_event_id,
+           m.content_json AS completion_content_json,
+           m.unsigned_json AS completion_unsigned_json
+    FROM candidate_finals AS f
+    JOIN successful_turns AS s ON s.provider_turn_id = f.provider_turn_id
+    JOIN matrix_events AS c ON c.stream_seq = f.final_seq
+    JOIN matrix_events AS m ON m.stream_seq = s.completion_seq
+    WHERE f.final_seq ${comparison} @anchor_seq
+    ORDER BY f.final_seq ${order}
+    LIMIT 1`;
+}
+
+function exactCandidate(row, hostSessionId) {
+  const content = parseJson(row.content_json);
+  return normalizeCommittedProviderOutputMatrixNotificationCandidate({
+    eventType: row.type,
+    matrixEventId: row.event_id,
+    matrixRoomId: row.room_id,
+    hostSessionId,
+    contentBody: typeof content.body === "string" ? content.body : "",
+    contentDelta: content.delta === true,
+    semanticPayload: semanticPayload(content),
+  });
+}
+
+function exactCompletion(row, hostSessionId) {
+  const content = parseJson(row.completion_content_json);
+  return normalizeProviderCompletionReleaseMarker({
+    eventType: "m.room.message",
+    matrixEventId: row.completion_event_id,
+    matrixRoomId: row.room_id,
+    hostSessionId,
+    semanticPayload: semanticPayload(content),
+  });
+}
+
+function readDirectionalTarget(db, { roomId, hostSessionId, anchorSeq, direction }) {
+  const statement = db.prepare(selectorSql(direction));
+  let seekSeq = anchorSeq;
+  while (true) {
+    const row = statement.get({ room_id: roomId, anchor_seq: seekSeq });
+    if (!row) return null;
+    const candidate = exactCandidate(row, hostSessionId);
+    const completion = exactCompletion(row, hostSessionId);
+    if (
+      candidate.accepted &&
+      completion.accepted &&
+      completion.release.successful === true &&
+      candidate.candidate.providerTurnId === completion.release.providerTurnId
+    ) {
+      return {
+        event_id: row.event_id,
+        routec_stream_seq: row.stream_seq,
+        origin_server_ts: Number.isFinite(row.origin_server_ts)
+          ? row.origin_server_ts
+          : null,
+        provider_turn_id: candidate.candidate.providerTurnId,
+      };
+    }
+    seekSeq = row.stream_seq;
+  }
+}
+
+function exactTargetSql() {
+  return `WITH candidate_finals AS (
+      SELECT
+        json_extract(c.content_json, '$."org.oysterun.semantic.v1".provider_turn_id') AS provider_turn_id,
+        MAX(c.stream_seq) AS final_seq
+      FROM matrix_events AS c
+      WHERE ${CANDIDATE_WHERE}
+      GROUP BY provider_turn_id
+    ), successful_turns AS (
+      SELECT
+        json_extract(m.content_json, '$."org.oysterun.semantic.v1".provider_completion_turn_id') AS provider_turn_id,
+        MAX(m.stream_seq) AS completion_seq
+      FROM matrix_events AS m
+      WHERE ${COMPLETION_WHERE}
+      GROUP BY provider_turn_id
+    )
+    SELECT c.event_id,
+           c.room_id,
+           c.type,
+           c.stream_seq,
+           c.origin_server_ts,
+           c.content_json,
+           c.unsigned_json,
+           m.event_id AS completion_event_id,
+           m.content_json AS completion_content_json,
+           m.unsigned_json AS completion_unsigned_json
+    FROM candidate_finals AS f
+    JOIN successful_turns AS s ON s.provider_turn_id = f.provider_turn_id
+    JOIN matrix_events AS c ON c.stream_seq = f.final_seq
+    JOIN matrix_events AS m ON m.stream_seq = s.completion_seq
+    WHERE c.event_id = @event_id
+    LIMIT 1`;
+}
+
+/**
+ * Resolve one exact P206 successfully-completed final-message identity.
+ * This deliberately shares the same indexed SQL predicates and the same
+ * candidate/release normalizers as completed-message navigation.
+ */
+export function readCompletedTurnFinalMessageByEventIdFromSQLite(
+  db,
+  { roomId, hostSessionId, eventId }
+) {
+  assertSchemaCompatible(db);
+  if (!roomId || !hostSessionId || !eventId) return null;
+  const row = db.prepare(exactTargetSql()).get({
+    room_id: roomId,
+    event_id: eventId,
+  });
+  if (!row) return null;
+  const candidate = exactCandidate(row, hostSessionId);
+  const completion = exactCompletion(row, hostSessionId);
+  if (
+    !candidate.accepted ||
+    !completion.accepted ||
+    completion.release.successful !== true ||
+    candidate.candidate.providerTurnId !== completion.release.providerTurnId
+  ) {
+    return null;
+  }
+  return {
+    event_id: row.event_id,
+    routec_stream_seq: row.stream_seq,
+    origin_server_ts: Number.isFinite(row.origin_server_ts)
+      ? row.origin_server_ts
+      : null,
+    provider_turn_id: candidate.candidate.providerTurnId,
+  };
+}
+
+export function readLatestCompletedTurnFinalMessageFromSQLite(
+  db,
+  { roomId, hostSessionId }
+) {
+  assertSchemaCompatible(db);
+  if (!roomId || !hostSessionId) return null;
+  return readDirectionalTarget(db, {
+    roomId,
+    hostSessionId,
+    anchorSeq: latestTimelineSeq(db, roomId) + 1,
+    direction: "previous",
+  });
+}
+
+function anchorRow(db, { roomId, eventId }) {
+  return (
+    db
+      .prepare(
+        `SELECT event_id, stream_seq
+         FROM matrix_events
+         WHERE room_id = ? AND event_id = ? AND is_state = 0`
+      )
+      .get(roomId, eventId) ?? null
+  );
+}
+
+function latestTimelineSeq(db, roomId) {
+  const row = db
+    .prepare(
+      `SELECT stream_seq
+       FROM matrix_events
+       WHERE room_id = ? AND is_state = 0
+       ORDER BY stream_seq DESC
+       LIMIT 1`
+    )
+    .get(roomId);
+  return Number.isSafeInteger(row?.stream_seq) ? row.stream_seq : 0;
+}
+
+export function readCompletedTurnFinalMessageNeighborsFromSQLite(
+  db,
+  { roomId, hostSessionId, anchorEventId = null, anchorPosition = null }
+) {
+  assertSchemaCompatible(db);
+  if (!roomId || !hostSessionId) {
+    throw new Error("Completed-turn navigation requires room and Host session identity");
+  }
+  if (anchorPosition && anchorPosition !== "latest") {
+    return { status: "invalid_anchor", error: "anchor_position must be latest" };
+  }
+  if (!anchorEventId && anchorPosition !== "latest") {
+    return {
+      status: "missing_identity",
+      error: "anchor_event_id or anchor_position=latest required",
+    };
+  }
+
+  const anchor = anchorEventId
+    ? anchorRow(db, { roomId, eventId: anchorEventId })
+    : null;
+  if (anchorEventId && !anchor) {
+    return {
+      status: "anchor_not_found",
+      error: "completed-turn navigation anchor event not found in bound room",
+      matrix_event_id: anchorEventId,
+    };
+  }
+
+  const latestSeq = latestTimelineSeq(db, roomId);
+  const anchorSeq = anchor?.stream_seq ?? latestSeq + 1;
+  const previous = readDirectionalTarget(db, {
+    roomId,
+    hostSessionId,
+    anchorSeq,
+    direction: "previous",
+  });
+  const next = anchor
+    ? readDirectionalTarget(db, {
+        roomId,
+        hostSessionId,
+        anchorSeq,
+        direction: "next",
+      })
+    : null;
+  const latestCompleted = readDirectionalTarget(db, {
+    roomId,
+    hostSessionId,
+    anchorSeq: latestSeq + 1,
+    direction: "previous",
+  });
+  const noCompletedTurns = latestCompleted === null;
+
+  const navigationIndexesPresent = [
+    MATRIX_COMPLETED_TURN_CANDIDATE_INDEX,
+    MATRIX_COMPLETED_TURN_COMPLETION_INDEX,
+  ].every(
+    (name) =>
+      db
+        .prepare(
+          "SELECT 1 AS present FROM sqlite_master WHERE type = 'index' AND name = ?"
+        )
+        .get(name)?.present === 1
+  );
+
+  return {
+    status: "ok",
+    session_id: hostSessionId,
+    matrix_room_id: roomId,
+    anchor: anchor
+      ? {
+          anchor_position: "event",
+          event_id: anchor.event_id,
+          routec_stream_seq: anchor.stream_seq,
+        }
+      : {
+          anchor_position: "latest",
+          event_id: null,
+          routec_stream_seq: latestSeq || null,
+        },
+    previous,
+    next,
+    boundaries: {
+      no_completed_turns: noCompletedTurns,
+      at_first_completed_message: previous === null,
+      at_latest_completed_message: next === null,
+    },
+    proof: {
+      schema_version: NAVIGATION_SCHEMA_VERSION,
+      lookup_source: navigationIndexesPresent
+        ? "routec_matrix_events_completed_turn_expression_indexes"
+        : "routec_matrix_events_completed_turn_sql",
+      lookup_strategy: navigationIndexesPresent
+        ? "indexed_completed_turn_final_message"
+        : "unindexed_completed_turn_final_message",
+      order_by: "final_candidate_stream_seq",
+      candidate_predicate: "complete_message_notification_candidate",
+      completion_predicate: "complete_message_notification_completion",
+      navigation_index_version: navigationIndexesPresent
+        ? MATRIX_COMPLETED_TURN_NAVIGATION_INDEX_VERSION
+        : null,
+      navigation_index_names: navigationIndexesPresent
+        ? [
+            MATRIX_COMPLETED_TURN_CANDIDATE_INDEX,
+            MATRIX_COMPLETED_TURN_COMPLETION_INDEX,
+          ]
+        : [],
+      raw_event_scan_limit: null,
+      raw_event_payload_returned: false,
+      message_body_returned: false,
+    },
+    raw_event_payload_returned: false,
+    message_body_returned: false,
+  };
+}
+
+export function explainCompletedTurnFinalMessageSelectorForTest(
+  db,
+  { roomId, anchorSeq, direction }
+) {
+  assertSchemaCompatible(db);
+  return db
+    .prepare(`EXPLAIN QUERY PLAN ${selectorSql(direction)}`)
+    .all({ room_id: roomId, anchor_seq: anchorSeq });
+}

package/host-service/update-reminder-state.mjs

@@ -26,6 +26,7 @@ const UPDATE_OPERATION_TERMINAL_STATUSES = new Set([
   "update_check_failed",
   "version_mismatch",
   "restart_complete",
+  "restart_rejected",
   "superseded_reconciled",
 ]);
 
@@ -462,6 +463,9 @@ export function readUpdateOperationState({ configDir = getConfigDir() } = {}) {
       state.operation_cleanup_completed === true,
     rollback_completed: state.rollback_completed === true,
     restart_attempted: state.restart_attempted === true,
+    continuity_path: normalizeString(state.continuity_path),
+    continuity_state: normalizeString(state.continuity_state),
+    user_path_verification: normalizeStructuredObject(state.user_path_verification),
     diagnostic_summary: normalizeStructuredObject(state.diagnostic_summary),
     root_failure: normalizeStructuredObject(state.root_failure),
     rollback_result: normalizeStructuredObject(state.rollback_result),
@@ -545,6 +549,9 @@ export function writeUpdateOperationState(
       state.operation_cleanup_completed === true,
     rollback_completed: state.rollback_completed === true,
     restart_attempted: state.restart_attempted === true,
+    continuity_path: normalizeString(state.continuity_path),
+    continuity_state: normalizeString(state.continuity_state),
+    user_path_verification: normalizeStructuredObject(state.user_path_verification),
     diagnostic_summary: normalizeStructuredObject(state.diagnostic_summary),
     root_failure: normalizeStructuredObject(state.root_failure),
     rollback_result: normalizeStructuredObject(state.rollback_result),

package/host-service/voice-input-receipt-store.mjs

@@ -0,0 +1,60 @@
+import Database from 'better-sqlite3';
+import { mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { createHash } from 'node:crypto';
+import { getHostDbPath } from './config.mjs';
+
+// Audio never enters this store. The fingerprint binds the exact finalized segment.
+export const voiceInputFingerprint = (metadata) => createHash('sha256').update(JSON.stringify([
+  metadata.recordingId, metadata.segmentIndex, metadata.durationMs,
+  metadata.mimeType.split(';')[0].trim().toLowerCase(), metadata.size, metadata.audioSha256,
+])).digest('hex');
+const failure = (message, code) => Object.assign(new Error(message), { code });
+export class VoiceInputReceiptStore {
+  constructor({ dbPath = getHostDbPath() } = {}) {
+    mkdirSync(dirname(dbPath), { recursive: true });
+    this.db = new Database(dbPath);
+    this.db.pragma('journal_mode = WAL');
+    this.db.pragma('synchronous = FULL');
+    this.db.exec(`CREATE TABLE IF NOT EXISTS voice_input_receipts (
+      session_id TEXT NOT NULL, capture_id TEXT NOT NULL, fingerprint TEXT,
+      generation INTEGER NOT NULL, state TEXT NOT NULL, result TEXT,
+      updated_at TEXT NOT NULL, PRIMARY KEY(session_id,capture_id))`);
+    if (!this.db.pragma('table_info(voice_input_receipts)').some(column => column.name === 'identity_json')) this.db.exec('ALTER TABLE voice_input_receipts ADD COLUMN identity_json TEXT');
+    // A process loss after paid work started is ambiguous, never safe to replay.
+    this.db.prepare("UPDATE voice_input_receipts SET state='outcome_unknown', updated_at=? WHERE state='provider_started'").run(new Date().toISOString());
+  }
+  get(sessionId, captureId) {
+    const row = this.db.prepare('SELECT * FROM voice_input_receipts WHERE session_id=? AND capture_id=?').get(sessionId, captureId);
+    return row ? { state: row.state, attempt_generation: row.generation, ...(row.identity_json ? { identity: JSON.parse(row.identity_json) } : {}), ...(row.result ? { result: JSON.parse(row.result) } : {}) } : { state: 'not_received', attempt_generation: 0 };
+  }
+  begin(sessionId, captureId, fingerprint, generation = 1, explicitRetry = false, identity = null) {
+    if (!Number.isSafeInteger(generation) || generation < 1) throw failure('Invalid recording attempt generation.', 'voice_input_attempt_invalid');
+    return this.db.transaction(() => {
+      const old = this.db.prepare('SELECT * FROM voice_input_receipts WHERE session_id=? AND capture_id=?').get(sessionId, captureId);
+      if (old) {
+        if (old.state === 'released') throw failure('Recording was removed.', 'voice_input_released');
+        if (old.fingerprint !== fingerprint) throw failure('Recording identity conflicts with its saved payload.', 'voice_input_receipt_conflict');
+        if (old.generation === generation) return this.get(sessionId, captureId);
+        if (!explicitRetry || generation !== old.generation + 1 || !['failed_retryable','failed_terminal','outcome_unknown'].includes(old.state)) throw failure('Recording attempt cannot be replayed.', 'voice_input_attempt_conflict');
+        this.db.prepare("UPDATE voice_input_receipts SET generation=?,state='received',result=NULL,updated_at=? WHERE session_id=? AND capture_id=?").run(generation,new Date().toISOString(),sessionId,captureId);
+      } else {
+        if (generation !== 1 || explicitRetry) throw failure('Recording attempt is unknown.', 'voice_input_attempt_conflict');
+        this.db.prepare('INSERT INTO voice_input_receipts (session_id,capture_id,fingerprint,generation,state,result,updated_at,identity_json) VALUES (?,?,?,?,?,?,?,?)').run(sessionId,captureId,fingerprint,generation,'received',null,new Date().toISOString(),identity ? JSON.stringify(identity) : null);
+      }
+      return this.get(sessionId,captureId);
+    })();
+  }
+  start(sessionId,captureId,generation) {
+    return this.db.prepare("UPDATE voice_input_receipts SET state='provider_started',updated_at=? WHERE session_id=? AND capture_id=? AND generation=? AND state='received'").run(new Date().toISOString(),sessionId,captureId,generation).changes === 1;
+  }
+  complete(sessionId,captureId,generation,state,result) {
+    if (!['succeeded','failed_retryable','failed_terminal','outcome_unknown'].includes(state)) throw new Error('Invalid receipt terminal state.');
+    return this.db.prepare("UPDATE voice_input_receipts SET state=?,result=?,updated_at=? WHERE session_id=? AND capture_id=? AND generation=? AND state='provider_started'").run(state,JSON.stringify(result),new Date().toISOString(),sessionId,captureId,generation).changes === 1;
+  }
+  release(sessionId,captureId) {
+    this.db.prepare("INSERT INTO voice_input_receipts (session_id,capture_id,fingerprint,generation,state,result,updated_at) VALUES (?,?,NULL,1,'released',NULL,?) ON CONFLICT(session_id,capture_id) DO UPDATE SET state='released',result=NULL,updated_at=excluded.updated_at").run(sessionId,captureId,new Date().toISOString());
+    return this.get(sessionId,captureId);
+  }
+  close() { this.db.close(); }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oysterun",
-  "version": "1.6.0-beta.2",
+  "version": "1.6.0-beta.21",
   "type": "module",
   "description": "Oysterun Host installer and local service",
   "bin": {

package/static/site/blog/en/index.html

@@ -13,6 +13,23 @@
     <link rel="alternate" hreflang="zh-Hant" href="https://oysterun.com/blog/zh/index.html" />
     <link rel="alternate" type="text/markdown" href="/blog/en/index.md" />
     <link rel="describedby" href="/llms.txt" type="text/plain" />
+    <meta property="og:title" content="Blog — Oysterun" />
+    <meta property="og:description" content="Read bilingual product and engineering notes from Oysterun." />
+    <meta property="og:type" content="website" />
+    <meta property="og:url" content="https://oysterun.com/blog/en/index.html" />
+    <meta property="og:site_name" content="Oysterun" />
+    <meta property="og:locale" content="en_US" />
+    <meta property="og:image" content="https://oysterun.com/assets/oysterun-social-preview.png" />
+    <meta property="og:image:secure_url" content="https://oysterun.com/assets/oysterun-social-preview.png" />
+    <meta property="og:image:type" content="image/png" />
+    <meta property="og:image:width" content="1200" />
+    <meta property="og:image:height" content="630" />
+    <meta property="og:image:alt" content="Oysterun connecting a phone to a computer running AI agents" />
+    <meta name="twitter:card" content="summary_large_image" />
+    <meta name="twitter:title" content="Blog — Oysterun" />
+    <meta name="twitter:description" content="Read bilingual product and engineering notes from Oysterun." />
+    <meta name="twitter:image" content="https://oysterun.com/assets/oysterun-social-preview.png" />
+    <meta name="twitter:image:alt" content="Oysterun connecting a phone to a computer running AI agents" />
 
   </head>
   <body>

package/static/site/blog/generated_manifest.json

@@ -2,7 +2,7 @@
   "schema": "oysterun.static_blog_manifest.v3",
   "content_schema": "oysterun.static_content_bundle.v2",
   "shell_schema": "oysterun.static_site_shell.v3",
-  "shell_sha256": "1b499d9ab1382144b285cf0dc75c00da0d3e3095aed750a0110025be3f93caa3",
+  "shell_sha256": "59cae2adbf15880e4b558edbf255409493d2a10ae820d10e7bf3ab33f1c78c7a",
   "generated_slugs": [
     "voice-input-model-experiment"
   ],
@@ -32,17 +32,17 @@
         "type": "svg"
       },
       "content_sha256": "49a68eec9d4d83126308962f646d673dacd526b867b2d3818b834c06a893e1a9",
-      "shell_sha256": "1b499d9ab1382144b285cf0dc75c00da0d3e3095aed750a0110025be3f93caa3",
+      "shell_sha256": "59cae2adbf15880e4b558edbf255409493d2a10ae820d10e7bf3ab33f1c78c7a",
       "files": [
         {
           "path": "en/index.html",
-          "size": 97758,
-          "sha256": "0fd8d384ddb4fdf6e096c13dd62d4b26122262384645a99336e3c19ecf7e83b2"
+          "size": 99425,
+          "sha256": "2912695661fd8ab3184f2676e930f924f78911b9e5f643ca44bd56b0e8616cf4"
         },
         {
           "path": "zh/index.html",
-          "size": 132388,
-          "sha256": "5b0d1a028d8459d3c4911583e6e4953979d26581bbd575e9bce65554d6060a73"
+          "size": 134033,
+          "sha256": "d77ae4aea1bed74d79d726e8303c40980b18bbc11bf700eb52282a420bbaa2d2"
         },
         {
           "path": "assets/article.css",
@@ -97,18 +97,18 @@
   ],
   "generated_index": {
     "path": "index.html",
-    "sha256": "c220a9dfee4da37dc302f56cbdf9fe27c2fdf09b76087f99b25ebcaa7dc670c8"
+    "sha256": "4a5c23ee4e46c2609748a188eaa1e480eef93e27800311336ec1aa28cc5d1dae"
   },
   "generated_indexes": [
     {
       "language": "zh",
       "path": "zh/index.html",
-      "sha256": "38ea738b6bf92f75ae63c2a6f105fdb2d645af8673e7a49c5aee08397de09928"
+      "sha256": "16c877bb32e43b2b529020d90b572112b3b7b0f7e3bb6670af1df91593497311"
     },
     {
       "language": "en",
       "path": "en/index.html",
-      "sha256": "e6ffc934a75bfa64c46df7ec926e8b0567450b595239f8414695ef94b6e243c0"
+      "sha256": "ec6c7b405c88a4fd692b2dfdcc89eb3c3e4537e3f3eaaa6bd9fd8671e0ba3f3c"
     }
   ]
 }