@gotcos/glasses-server 6.38.0 → 6.39.0

package/server/lib/codex-extra-args.ts

@@ -0,0 +1,222 @@
+import { findBannedPermissionArg } from './banned-permission-args.js'
+
+export const CODEX_EXTRA_ARGS_MAX_TOKENS = 32
+export const CODEX_EXTRA_ARGS_MAX_CHARS = 2_000
+
+const BOOLEAN_FLAGS = new Set(['--oss'])
+const VALUE_FLAGS = new Set(['-c', '--config', '--model', '-m', '--local-provider'])
+const ALLOWED_FLAGS = new Set(['--oss', '--local-provider', '--model', '-m', '-c', '--config'])
+const ALLOWED_CONFIG_KEYS = new Set([
+  'model',
+  'model_provider',
+  'oss_provider',
+  'model_reasoning_effort',
+  'service_tier',
+])
+const LOCAL_PROVIDER_VALUES = new Set(['ollama', 'lmstudio'])
+
+export class CodexExtraArgsError extends Error {
+  flag: string
+  constructor(flag: string) {
+    super(`Invalid COS_CODEX_EXTRA_ARGS (${flag}). Edit ~/.cos-glasses/.env and restart the glasses server.`)
+    this.name = 'CodexExtraArgsError'
+    this.flag = flag
+  }
+}
+
+function extraArgsUserMessage(flag: string): string {
+  return `Invalid COS_CODEX_EXTRA_ARGS (${flag}). Edit ~/.cos-glasses/.env and restart the glasses server.`
+}
+
+export function extraArgsErrorMessage(flag: string): string {
+  return extraArgsUserMessage(flag)
+}
+
+function unwrapWholeValue(raw: string): string {
+  if (raw.length >= 2) {
+    const first = raw[0]
+    const last = raw[raw.length - 1]
+    if ((first === '"' && last === '"') || (first === "'" && last === "'")) {
+      return raw.slice(1, -1).trim()
+    }
+  }
+  return raw
+}
+
+function splitUnquotedWhitespace(raw: string): string[] {
+  const tokens: string[] = []
+  let current = ''
+  let quote: '"' | "'" | null = null
+  for (const ch of raw) {
+    if (quote) {
+      current += ch
+      if (ch === quote) quote = null
+      continue
+    }
+    if (ch === '"' || ch === "'") {
+      quote = ch
+      current += ch
+      continue
+    }
+    if (/\s/.test(ch)) {
+      if (current) {
+        tokens.push(current)
+        current = ''
+      }
+      continue
+    }
+    current += ch
+  }
+  if (quote) throw new CodexExtraArgsError('quotes')
+  if (current) tokens.push(current)
+  return tokens
+}
+
+export function parseCodexExtraArgs(raw: string | undefined): string[] {
+  const trimmed = (raw ?? '').trim()
+  if (!trimmed) return []
+  if (trimmed.length > CODEX_EXTRA_ARGS_MAX_CHARS) throw new CodexExtraArgsError('length')
+  const unwrapped = unwrapWholeValue(trimmed)
+  if (!unwrapped) return []
+  const tokens = splitUnquotedWhitespace(unwrapped)
+  if (tokens.length > CODEX_EXTRA_ARGS_MAX_TOKENS) throw new CodexExtraArgsError('length')
+  return tokens
+}
+
+function stripWrappingQuotes(value: string): string {
+  if (value.length >= 2) {
+    const first = value[0]
+    const last = value[value.length - 1]
+    if ((first === '"' && last === '"') || (first === "'" && last === "'")) {
+      return value.slice(1, -1)
+    }
+  }
+  return value
+}
+
+function fusedValueFlag(token: string): string | null {
+  for (const flag of VALUE_FLAGS) {
+    if (token.startsWith(`${flag}=`)) return flag
+  }
+  return null
+}
+
+type Walked =
+  | { kind: 'boolean'; flag: string }
+  | { kind: 'value'; flag: string; value: string }
+
+function walkCodexExtraArgs(args: string[]): Walked[] {
+  const walked: Walked[] = []
+  let i = 0
+  while (i < args.length) {
+    const token = args[i]
+    if (BOOLEAN_FLAGS.has(token)) {
+      walked.push({ kind: 'boolean', flag: token })
+      i += 1
+      continue
+    }
+    const fused = fusedValueFlag(token)
+    if (fused) {
+      const value = token.slice(fused.length + 1)
+      if (!value) throw new CodexExtraArgsError(fused)
+      if (value.startsWith('-')) throw new CodexExtraArgsError(fused)
+      walked.push({ kind: 'value', flag: fused, value })
+      i += 1
+      continue
+    }
+    if (VALUE_FLAGS.has(token)) {
+      const value = args[i + 1]
+      if (value === undefined) throw new CodexExtraArgsError(token)
+      if (value.startsWith('-')) throw new CodexExtraArgsError(token)
+      walked.push({ kind: 'value', flag: token, value })
+      i += 2
+      continue
+    }
+    throw new CodexExtraArgsError(token)
+  }
+  return walked
+}
+
+function configPayloads(walked: Walked[]): { key: string; value: string }[] {
+  const payloads: { key: string; value: string }[] = []
+  for (const step of walked) {
+    if (step.kind !== 'value' || (step.flag !== '-c' && step.flag !== '--config')) continue
+    const eq = step.value.indexOf('=')
+    if (eq <= 0) throw new CodexExtraArgsError(`-c ${stripWrappingQuotes(step.value)}`)
+    const key = stripWrappingQuotes(step.value.slice(0, eq))
+    const value = step.value.slice(eq + 1)
+    payloads.push({ key, value })
+  }
+  return payloads
+}
+
+export function extraIncludesFlag(args: string[], flags: string[]): boolean {
+  for (const token of args) {
+    for (const flag of flags) {
+      if (token === flag || token.startsWith(`${flag}=`)) return true
+    }
+  }
+  return false
+}
+
+export function extraIncludesConfigKey(args: string[], key: string): boolean {
+  const walked = walkCodexExtraArgs(args)
+  return configPayloads(walked).some(payload => payload.key === key)
+}
+
+export function assertSafeCodexExtraArgs(args: string[]): void {
+  if (args.length === 0) return
+  const walked = walkCodexExtraArgs(args)
+  for (const step of walked) {
+    if (!ALLOWED_FLAGS.has(step.flag)) throw new CodexExtraArgsError(step.flag)
+  }
+  const hasOss = walked.some(step => step.kind === 'boolean' && step.flag === '--oss')
+  const hasLocalProvider = extraIncludesFlag(args, ['--local-provider'])
+  const payloads = configPayloads(walked)
+  const hasOssProvider = payloads.some(payload => payload.key === 'oss_provider')
+  const hasModelProvider = payloads.some(payload => payload.key === 'model_provider')
+
+  if (hasOss && hasModelProvider) throw new CodexExtraArgsError('-c model_provider')
+  if (hasOss && !hasLocalProvider && !hasOssProvider) throw new CodexExtraArgsError('--oss')
+  if ((hasLocalProvider || hasOssProvider) && !hasOss) {
+    throw new CodexExtraArgsError(hasLocalProvider ? '--local-provider' : '-c oss_provider')
+  }
+
+  for (const step of walked) {
+    if (step.kind !== 'value') continue
+    if (step.flag === '--local-provider') {
+      if (!LOCAL_PROVIDER_VALUES.has(stripWrappingQuotes(step.value))) {
+        throw new CodexExtraArgsError('--local-provider')
+      }
+    }
+  }
+  for (const payload of payloads) {
+    if (!ALLOWED_CONFIG_KEYS.has(payload.key)) throw new CodexExtraArgsError(`-c ${payload.key}`)
+    if (payload.key === 'oss_provider' && !LOCAL_PROVIDER_VALUES.has(stripWrappingQuotes(payload.value))) {
+      throw new CodexExtraArgsError('-c oss_provider')
+    }
+  }
+
+  const banned = findBannedPermissionArg(args)
+  if (banned !== null) throw new CodexExtraArgsError(banned)
+}
+
+export function skipsCosModel(extra: string[]): boolean {
+  return extraIncludesFlag(extra, ['--model', '-m']) || extraIncludesConfigKey(extra, 'model')
+}
+
+export function skipsCosServiceTier(extra: string[]): boolean {
+  return extraIncludesFlag(extra, ['--oss', '--local-provider'])
+    || extraIncludesConfigKey(extra, 'model_provider')
+    || extraIncludesConfigKey(extra, 'service_tier')
+}
+
+export function skipsCosReasoningEffort(extra: string[]): boolean {
+  return extraIncludesConfigKey(extra, 'model_reasoning_effort')
+    || extraIncludesFlag(extra, ['--oss', '--local-provider'])
+    || extraIncludesConfigKey(extra, 'model_provider')
+}
+
+export function codexEngineFingerprint(extra: string[]): string {
+  return extra.join('\0')
+}

package/server/lib/even-hub-speaker-role.ts

@@ -0,0 +1,116 @@
+// Even Hub 0.0.14 wearer-vs-other histogram, carried on a meeting chunk.
+// Identity is a suggestion. This module parses and logs. It does not name
+// people and does not change identifyChunkSpeaker.
+
+export type EvenSpeakerRole = 'self' | 'other' | 'unknown'
+export type EvenSpeakerRoleMajority = EvenSpeakerRole | 'tie'
+
+export interface EvenSpeakerRoleHistogram {
+  schema: 1
+  frames: number
+  self: number
+  other: number
+  unknown: number
+  majority: EvenSpeakerRoleMajority
+  directionPresent: number
+  directionLast: number | null
+}
+
+export type EvenSpeakerRoleMode = 'off' | 'log' | 'apply'
+
+export function evenSpeakerRoleMode(): EvenSpeakerRoleMode {
+  const raw = (process.env.COS_EVEN_SPEAKER_ROLE ?? 'log').trim().toLowerCase()
+  if (raw === 'off' || raw === '0' || raw === 'false') return 'off'
+  if (raw === 'apply') return 'apply'
+  return 'log'
+}
+
+let applyNotImplementedWarned = false
+
+/** Gate A is not in this slice. apply must not silently change labels. */
+export function warnEvenSpeakerRoleApplyNotImplemented(): void {
+  if (evenSpeakerRoleMode() !== 'apply' || applyNotImplementedWarned) return
+  applyNotImplementedWarned = true
+  console.warn('[even-role] COS_EVEN_SPEAKER_ROLE=apply is not implemented; logging only')
+}
+
+function majorityOf(self: number, other: number, unknown: number, frames: number): EvenSpeakerRoleMajority {
+  if (frames <= 0) return 'unknown'
+  if (self > other && self > unknown) return 'self'
+  if (other > self && other > unknown) return 'other'
+  if (unknown > self && unknown > other) return 'unknown'
+  return 'tie'
+}
+
+function asNonNegInt(raw: unknown): number | null {
+  const n = typeof raw === 'number' ? raw : typeof raw === 'string' && raw !== '' ? Number(raw) : NaN
+  if (!Number.isFinite(n) || n < 0 || !Number.isInteger(n)) return null
+  return n
+}
+
+/** Compact query `eh=self,other,unknown,frames,directionPresent,directionLast`. */
+export function parseEvenHubSpeakerRoleQuery(raw: unknown): EvenSpeakerRoleHistogram | undefined {
+  if (typeof raw !== 'string' || raw.length === 0) return undefined
+  const parts = raw.split(',')
+  if (parts.length < 4 || parts.length > 6) return undefined
+  const self = asNonNegInt(parts[0])
+  const other = asNonNegInt(parts[1])
+  const unknown = asNonNegInt(parts[2])
+  const frames = asNonNegInt(parts[3])
+  if (self == null || other == null || unknown == null || frames == null) return undefined
+  if (self + other + unknown !== frames) return undefined
+  const directionPresent = parts.length >= 5 ? asNonNegInt(parts[4]) : 0
+  if (directionPresent == null) return undefined
+  let directionLast: number | null = null
+  if (parts.length === 6 && parts[5] !== '') {
+    const last = Number(parts[5])
+    if (!Number.isFinite(last)) return undefined
+    directionLast = last
+  }
+  return {
+    schema: 1,
+    frames,
+    self,
+    other,
+    unknown,
+    majority: majorityOf(self, other, unknown, frames),
+    directionPresent,
+    directionLast,
+  }
+}
+
+export function parseEvenHubSpeakerRoleBody(raw: unknown): EvenSpeakerRoleHistogram | undefined {
+  if (!raw || typeof raw !== 'object') return undefined
+  const o = raw as Record<string, unknown>
+  const self = asNonNegInt(o.self)
+  const other = asNonNegInt(o.other)
+  const unknown = asNonNegInt(o.unknown)
+  const frames = asNonNegInt(o.frames)
+  if (self == null || other == null || unknown == null || frames == null) return undefined
+  if (self + other + unknown !== frames) return undefined
+  const directionPresent = o.directionPresent == null ? 0 : asNonNegInt(o.directionPresent)
+  if (directionPresent == null) return undefined
+  const directionLast = o.directionLast == null || o.directionLast === ''
+    ? null
+    : (typeof o.directionLast === 'number' && Number.isFinite(o.directionLast) ? o.directionLast : null)
+  return {
+    schema: 1,
+    frames,
+    self,
+    other,
+    unknown,
+    majority: majorityOf(self, other, unknown, frames),
+    directionPresent,
+    directionLast,
+  }
+}
+
+export function formatEvenRoleAgreement(opts: {
+  chunkIndex: number
+  even: EvenSpeakerRoleHistogram
+  amp: string
+  emb: string
+  similarity: number
+}): string {
+  return `[even-role] chunk=${opts.chunkIndex} even=${opts.even.majority} amp=${opts.amp} emb=${opts.emb} sim=${opts.similarity.toFixed(2)} frames=${opts.even.frames}`
+}

package/server/lib/fork-thread.ts

@@ -78,7 +78,6 @@ import {
   buildAttachedEnv,
   classifyStderr,
   extractNativeIdsFromLine,
-  findBannedPermissionArg,
   isAttachedPermissionPolicy,
   resolveProviderBinary,
   type AttachedChildProcess,
@@ -86,6 +85,7 @@ import {
   type AttachedStderrClass,
   type BinaryResolution,
 } from './attached-provider-adapter.js'
+import { findBannedPermissionArg } from './banned-permission-args.js'
 
 /**
  * Providers that can be forked. A strict subset of the attached set.
@@ -261,7 +261,7 @@ export function buildCodexForkArgs(nativeThreadId: string, cwd: string): string[
 /**
  * Build the argv, and REFUSE to hand back one carrying a banned permission flag.
  *
- * The predicate is IMPORTED from the adapter, not re-listed here. Two copies of a
+ * The predicate is IMPORTED from banned-permission-args, not re-listed here. Two copies of a
  * ban list in two modules is precisely the drift `native-thread-id.ts` was created
  * to end: the occupancy detector and the binding store each had their own idea of
  * what a thread id was, and a truncated id walked through the gap. A fork spawns a

package/server/lib/health-static-probes.ts

@@ -6,6 +6,11 @@ import {
   isCursorProviderReady,
   resolveAgentBinary,
 } from './cursor-model-catalog.js'
+import {
+  getOllamaCatalog,
+  getOllamaCatalogSnapshot,
+  isOllamaProviderReady,
+} from './ollama-catalog.js'
 
 const DEFAULT_CACHE_TTL_MS = 30_000
 const PROBE_TIMEOUT_MS = 5_000
@@ -15,9 +20,11 @@ export interface HealthStaticProbeSnapshot {
   claude: string
   codex: string
   cursor: string
+  ollama: string
   claudeAvailable: boolean
   codexAvailable: boolean
   cursorAvailable: boolean
+  ollamaAvailable: boolean
 }
 
 interface CachedProbe<T> {
@@ -153,21 +160,36 @@ async function probeCursor(): Promise<{ value: string; available: boolean }> {
   }
 }
 
+async function probeOllama(): Promise<{ value: string; available: boolean }> {
+  try {
+    const catalog = await getOllamaCatalog()
+    const available = isOllamaProviderReady()
+    if (available) return { value: catalog.model || 'available', available: true }
+    return { value: catalog.error || 'unavailable', available: false }
+  } catch {
+    const snapshot = getOllamaCatalogSnapshot()
+    return { value: snapshot.error || 'error', available: false }
+  }
+}
+
 async function loadStaticHealthProbes(): Promise<HealthStaticProbeSnapshot> {
-  const [python, claude, codex, cursor] = await Promise.all([
+  const [python, claude, codex, cursor, ollama] = await Promise.all([
     probePython(),
     probeClaude(),
     probeCodex(),
     probeCursor(),
+    probeOllama(),
   ])
   return {
     python,
     claude: claude.value,
     codex: codex.value,
     cursor: cursor.value,
+    ollama: ollama.value,
     claudeAvailable: claude.available,
     codexAvailable: codex.available,
     cursorAvailable: cursor.available,
+    ollamaAvailable: ollama.available,
   }
 }
 

package/server/lib/model-router.ts

@@ -1,6 +1,7 @@
 import { callClaudeStreaming, type CallOptions, type StreamCallbacks } from './claude-bridge.js'
 import { callCodexStreaming } from './codex-bridge.js'
 import { callCursorStreaming } from './cursor-bridge.js'
+import { callOllamaStreaming } from './ollama-bridge.js'
 import {
   getOrCreateSession,
   getSessionModel,
@@ -13,6 +14,7 @@ import {
   isCodexModel,
   isClaudeModel,
   isCursorModel,
+  isOllamaModel,
   normalizeModelPreference,
 } from '../../shared/model-preference.js'
 import {
@@ -20,6 +22,10 @@ import {
   isCursorProviderReady,
   resolveCursorModelOption,
 } from './cursor-model-catalog.js'
+import {
+  getOllamaCatalog,
+  isOllamaProviderReady,
+} from './ollama-catalog.js'
 import type { ModelImageInput } from './model-image-input.js'
 
 // Bridges return as soon as their subprocess is spawned, while completion is
@@ -112,6 +118,14 @@ export async function callModelStreaming(
       }
       return await callCursorStreaming(query, sid, lockedCallbacks, resolvedModel, images, reference, globalMsgNum, options)
     }
+    if (isOllamaModel(resolvedModel)) {
+      await getOllamaCatalog()
+      if (!isOllamaProviderReady()) {
+        await lockedCallbacks.onError('ollama-bridge: Ollama is not running. Start ollama serve on this Mac.')
+        return sid
+      }
+      return await callOllamaStreaming(query, sid, lockedCallbacks, images, reference, globalMsgNum, options)
+    }
     if (isCodexModel(resolvedModel)) {
       return await callCodexStreaming(query, sid, lockedCallbacks, resolvedModel, images, reference, globalMsgNum, options)
     }