@agentdeck/shared 0.1.0 → 0.2.0

package/dist/gateway-protocol.d.ts

@@ -0,0 +1,391 @@
+/**
+ * OpenClaw Gateway WebSocket protocol — single source of truth.
+ *
+ * Wire shape: JSON-encoded frames with a `type` discriminator (`req`/`res`/`event`).
+ * Auth: Ed25519 device signature over
+ * `v3|deviceId|clientId|clientMode|role|scopes|signedAtMs|token|nonce|platform|deviceFamily`.
+ * Bridge implementation: `bridge/src/adapters/openclaw.ts` (Node) / `apple/AgentDeck/Daemon/Modules/OpenClawAdapter.swift` (Swift).
+ *
+ * This file is used by `scripts/generate-protocol.sh` to emit Swift/Kotlin bindings
+ * under `generated/protocol/`, ensuring protocol parity across the three implementations.
+ */
+/** Protocol major version. Bridge rejects mismatched Gateway versions. */
+export declare const GATEWAY_PROTOCOL_VERSION = 3;
+/** Default Gateway port (OpenClaw backend). */
+export declare const GATEWAY_DEFAULT_PORT = 18789;
+/** Ed25519 SPKI DER prefix length (bytes before the raw 32-byte key). */
+export declare const ED25519_SPKI_PREFIX_LEN = 12;
+/** Client → Gateway: RPC request. */
+export interface GatewayRequestFrame {
+    type: 'req';
+    id: string;
+    method: GatewayMethodName;
+    params: GatewayMethodParams;
+}
+/** Gateway → Client: RPC response (ok=true) or error (ok=false). */
+export interface GatewayResponseFrame {
+    type: 'res';
+    id: string;
+    ok: boolean;
+    payload?: GatewayMethodResult;
+    error?: GatewayError;
+}
+/** Gateway → Client: unsolicited event. */
+export interface GatewayEventFrame {
+    type: 'event';
+    event: GatewayEventName;
+    payload: GatewayEventPayload;
+    /** Monotonic sequence number (optional, used for ordering on reconnect). */
+    seq?: string;
+    /** Server-side state version for dedup on replay. */
+    stateVersion?: string;
+}
+export type GatewayFrame = GatewayRequestFrame | GatewayResponseFrame | GatewayEventFrame;
+export interface GatewayError {
+    code: string;
+    message: string;
+    details?: unknown;
+}
+export type GatewayMethodName = 'connect' | 'health' | 'models.list' | 'logs.tail' | 'chat.send' | 'chat.abort' | 'exec.approval.resolve' | 'sessions.list' | 'sessions.subscribe' | 'sessions.messages.subscribe' | 'system-presence';
+export type GatewayMethodParams = ConnectParams | HealthParams | ModelsListParams | LogsTailParams | ChatSendParams | ChatAbortParams | ExecApprovalResolveParams | SessionsListParams | SessionsSubscribeParams | SessionsMessagesSubscribeParams | SystemPresenceParams;
+export type GatewayMethodResult = ConnectResult | HealthResult | ModelsListResult | LogsTailResult | ChatSendResult | ChatAbortResult | ExecApprovalResolveResult | SessionsListResult | SessionsSubscribeResult | SessionsMessagesSubscribeResult | SystemPresenceResult;
+export interface ConnectParams {
+    /** Lower bound of protocol versions this client supports. */
+    minProtocol: number;
+    /** Upper bound of protocol versions this client supports. */
+    maxProtocol: number;
+    client: {
+        id: string;
+        displayName: string;
+        version: string;
+        platform: string;
+        deviceFamily?: string;
+        mode: 'backend' | 'frontend' | 'operator' | 'node';
+        instanceId?: string;
+    };
+    role: string;
+    scopes: string[];
+    caps: string[];
+    commands?: string[];
+    permissions?: Record<string, boolean>;
+    locale?: string;
+    userAgent?: string;
+    /** Ed25519 device signature over `v3|deviceId|clientId|clientMode|role|scopes|signedAtMs|token|nonce|platform|deviceFamily`. */
+    device?: DeviceAuth;
+    /** Bearer token issued during device pairing. */
+    auth?: {
+        token?: string;
+        bootstrapToken?: string;
+        deviceToken?: string;
+        password?: string;
+    };
+}
+export interface ConnectResult {
+    type?: 'hello-ok';
+    accepted?: boolean;
+    protocol?: number;
+    server?: {
+        version: string;
+        connId: string;
+    };
+    features?: {
+        methods: string[];
+        events: string[];
+    };
+    auth?: {
+        deviceToken: string;
+        role: string;
+        scopes: string[];
+        issuedAtMs?: number;
+        deviceTokens?: Array<{
+            deviceToken: string;
+            role: string;
+            scopes: string[];
+            issuedAtMs?: number;
+        }>;
+    };
+    policy?: {
+        tickIntervalMs?: number;
+        maxPayload?: number;
+    };
+    sessionToken?: string;
+    expiresAt?: number;
+}
+export interface DeviceAuth {
+    id: string;
+    publicKey: string;
+    signature: string;
+    signedAt: number;
+    nonce: string;
+}
+export interface HealthParams {
+    probe?: boolean;
+}
+export interface HealthResult {
+    ok?: boolean;
+    ts?: number;
+    durationMs?: number;
+    status?: string;
+    checks?: Array<{
+        id?: string;
+        name?: string;
+        status?: string;
+        message?: string;
+    }>;
+    [key: string]: unknown;
+}
+export interface ModelsListParams {
+}
+export interface ModelsListResult {
+    models: OpenClawModel[];
+}
+export interface OpenClawModel {
+    key?: string;
+    id?: string;
+    name?: string;
+    provider?: string;
+    title?: string;
+    available?: boolean;
+    missing?: boolean;
+    tags?: string[];
+    [key: string]: unknown;
+}
+export interface LogsTailParams {
+    cursor?: number;
+    limit?: number;
+    maxBytes?: number;
+}
+export interface LogsTailResult {
+    file?: string;
+    cursor?: number;
+    size?: number;
+    lines: string[];
+    truncated?: boolean;
+    reset?: boolean;
+}
+export interface ChatSendParams {
+    sessionKey: string;
+    message: string;
+    idempotencyKey: string;
+}
+export interface ChatSendResult {
+    runId?: string;
+    accepted: boolean;
+}
+export interface ChatAbortParams {
+    sessionKey: string;
+    runId?: string;
+}
+export interface ChatAbortResult {
+    aborted: boolean;
+}
+export interface ExecApprovalResolveParams {
+    id: string;
+    decision: 'allow' | 'deny';
+}
+export interface ExecApprovalResolveResult {
+    resolved: boolean;
+}
+export interface SessionsListParams {
+    kind?: string;
+}
+export interface SessionsListResult {
+    sessions: GatewaySession[];
+}
+export interface SessionsSubscribeParams {
+}
+export interface SessionsSubscribeResult {
+    subscribed: boolean;
+}
+export interface SessionsMessagesSubscribeParams {
+    key: string;
+}
+export interface SessionsMessagesSubscribeResult {
+    subscribed: boolean;
+    key: string;
+}
+export interface SystemPresenceParams {
+}
+export interface SystemPresenceResult {
+    entries?: GatewayPresenceEntry[];
+    devices?: GatewayPresenceEntry[];
+    [key: string]: unknown;
+}
+export interface GatewaySession {
+    key: string;
+    kind?: string;
+    label?: string;
+    displayName?: string;
+    updatedAt?: number;
+    sessionId?: string;
+}
+/**
+ * Method-name → params/result correlation. `rpcCall` in the Node adapter uses
+ * this to enforce that callers pass the correct params shape for each method
+ * and to infer the result type from the method name.
+ *
+ * When adding a new method: declare its ParamsType and ResultType above,
+ * extend `GatewayMethodName`, and add the entry here. Build-time errors
+ * pinpoint every call site that needs an update.
+ */
+export interface GatewayMethodMap {
+    connect: {
+        params: ConnectParams;
+        result: ConnectResult;
+    };
+    health: {
+        params: HealthParams;
+        result: HealthResult;
+    };
+    'models.list': {
+        params: ModelsListParams;
+        result: ModelsListResult;
+    };
+    'logs.tail': {
+        params: LogsTailParams;
+        result: LogsTailResult;
+    };
+    'chat.send': {
+        params: ChatSendParams;
+        result: ChatSendResult;
+    };
+    'chat.abort': {
+        params: ChatAbortParams;
+        result: ChatAbortResult;
+    };
+    'exec.approval.resolve': {
+        params: ExecApprovalResolveParams;
+        result: ExecApprovalResolveResult;
+    };
+    'sessions.list': {
+        params: SessionsListParams;
+        result: SessionsListResult;
+    };
+    'sessions.subscribe': {
+        params: SessionsSubscribeParams;
+        result: SessionsSubscribeResult;
+    };
+    'sessions.messages.subscribe': {
+        params: SessionsMessagesSubscribeParams;
+        result: SessionsMessagesSubscribeResult;
+    };
+    'system-presence': {
+        params: SystemPresenceParams;
+        result: SystemPresenceResult;
+    };
+}
+export type GatewayEventName = 'connect.challenge' | 'chat' | 'health' | 'session.message' | 'session.tool' | 'sessions.changed' | 'exec.approval.requested' | 'exec.approval.resolved' | 'presence' | 'system-presence' | 'tick' | 'shutdown';
+export type GatewayEventPayload = ConnectChallengePayload | ChatEventPayload | HealthResult | SessionMessagePayload | SessionToolPayload | SessionsChangedPayload | ExecApprovalRequestedPayload | ExecApprovalResolvedPayload | PresencePayload | SystemPresenceResult | TickPayload | ShutdownPayload;
+export interface ConnectChallengePayload {
+    nonce: string;
+    expiresAt?: number;
+}
+export interface ChatEventPayload {
+    state: 'delta' | 'final' | 'aborted' | 'error';
+    runId?: string;
+    sessionKey?: string;
+    /** Incremental text chunk (delta state). */
+    delta?: string;
+    /** Full assembled response (final state). */
+    response?: string;
+    /** Tool invocations observed in this turn. */
+    tools?: ChatToolInvocation[];
+    /** User prompt text, as echoed by Gateway on first delta. */
+    prompt?: string;
+    /** Error message (error state). */
+    error?: string;
+    /** Model identifier used for this turn. */
+    modelId?: string;
+    /** Token accounting (final state). */
+    inputTokens?: number;
+    outputTokens?: number;
+    /** Session identifier when Gateway creates a new session mid-chat. */
+    newSessionId?: string;
+}
+export interface ChatToolInvocation {
+    name: string;
+    input?: unknown;
+    output?: unknown;
+    status?: 'pending' | 'success' | 'error';
+}
+export interface ExecApprovalRequestedPayload {
+    id: string;
+    sessionKey?: string;
+    tool: string;
+    command?: string;
+    reason?: string;
+    /** Options surfaced to the user (default: allow/deny). */
+    options?: Array<{
+        key: string;
+        label: string;
+    }>;
+}
+export interface ExecApprovalResolvedPayload {
+    id: string;
+    decision: 'allow' | 'deny' | 'timeout';
+    sessionKey?: string;
+}
+export interface GatewayPresenceEntry {
+    connected: boolean;
+    clientId?: string;
+    deviceId?: string;
+    roles?: string[];
+    scopes?: string[];
+    displayName?: string;
+    [key: string]: unknown;
+}
+export interface PresencePayload {
+    connected?: boolean;
+    clientId?: string;
+    deviceId?: string;
+    entries?: GatewayPresenceEntry[];
+    devices?: GatewayPresenceEntry[];
+    [key: string]: unknown;
+}
+export interface SessionsChangedPayload {
+    sessions?: GatewaySession[];
+    key?: string;
+    sessionKey?: string;
+    reason?: string;
+}
+export interface SessionMessagePayload {
+    key?: string;
+    sessionKey?: string;
+    role?: string;
+    text?: string;
+    content?: string;
+    message?: unknown;
+    ts?: number;
+    [key: string]: unknown;
+}
+export interface SessionToolPayload {
+    key?: string;
+    sessionKey?: string;
+    name?: string;
+    tool?: string;
+    input?: unknown;
+    output?: unknown;
+    status?: string;
+    ts?: number;
+    [key: string]: unknown;
+}
+export interface TickPayload {
+    serverTime: number;
+}
+export interface ShutdownPayload {
+    reason?: string;
+    restartAt?: number;
+}
+/** On-disk identity, loaded from `~/.openclaw/identity/device.json`. */
+export interface DeviceIdentity {
+    deviceId: string;
+    publicKeyPem: string;
+    privateKeyPem: string;
+}
+/** Loaded from `~/.openclaw/identity/device-auth.json` → `tokens.operator`. */
+export interface DeviceAuthToken {
+    token: string;
+    role: string;
+    scopes: string[];
+}
+//# sourceMappingURL=gateway-protocol.d.ts.map

package/dist/gateway-protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-protocol.d.ts","sourceRoot":"","sources":["../src/gateway-protocol.ts"],"names":[],"mappings":"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"}

package/dist/gateway-protocol.js

@@ -0,0 +1,19 @@
+/**
+ * OpenClaw Gateway WebSocket protocol — single source of truth.
+ *
+ * Wire shape: JSON-encoded frames with a `type` discriminator (`req`/`res`/`event`).
+ * Auth: Ed25519 device signature over
+ * `v3|deviceId|clientId|clientMode|role|scopes|signedAtMs|token|nonce|platform|deviceFamily`.
+ * Bridge implementation: `bridge/src/adapters/openclaw.ts` (Node) / `apple/AgentDeck/Daemon/Modules/OpenClawAdapter.swift` (Swift).
+ *
+ * This file is used by `scripts/generate-protocol.sh` to emit Swift/Kotlin bindings
+ * under `generated/protocol/`, ensuring protocol parity across the three implementations.
+ */
+// ===== Protocol version =====
+/** Protocol major version. Bridge rejects mismatched Gateway versions. */
+export const GATEWAY_PROTOCOL_VERSION = 3;
+/** Default Gateway port (OpenClaw backend). */
+export const GATEWAY_DEFAULT_PORT = 18789;
+/** Ed25519 SPKI DER prefix length (bytes before the raw 32-byte key). */
+export const ED25519_SPKI_PREFIX_LEN = 12;
+//# sourceMappingURL=gateway-protocol.js.map

package/dist/gateway-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-protocol.js","sourceRoot":"","sources":["../src/gateway-protocol.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,+BAA+B;AAE/B,0EAA0E;AAC1E,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC;AAE1C,+CAA+C;AAC/C,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,CAAC;AAE1C,yEAAyE;AACzE,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,CAAC"}

package/dist/index.d.ts

@@ -1,6 +1,17 @@
 export * from './states.js';
 export * from './protocol.js';
+export * from './gateway-protocol.js';
+export * from './command-builders.js';
 export * from './adapter.js';
 export * from './voice-paths.js';
 export * from './net-utils.js';
+export * from './timeline.js';
+export * from './format-utils.js';
+export * from './timeline-summarizer.js';
+export * from './session-utils.js';
+export * from './state-colors.js';
+export * from './svg-renderers/index.js';
+export * from './llm-settings.js';
+export * from './eval-schema.js';
+export * from './telemetry-envelope.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC"}

package/dist/index.js

@@ -1,6 +1,17 @@
 export * from './states.js';
 export * from './protocol.js';
+export * from './gateway-protocol.js';
+export * from './command-builders.js';
 export * from './adapter.js';
 export * from './voice-paths.js';
 export * from './net-utils.js';
+export * from './timeline.js';
+export * from './format-utils.js';
+export * from './timeline-summarizer.js';
+export * from './session-utils.js';
+export * from './state-colors.js';
+export * from './svg-renderers/index.js';
+export * from './llm-settings.js';
+export * from './eval-schema.js';
+export * from './telemetry-envelope.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC"}

package/dist/llm-settings.d.ts

@@ -0,0 +1,52 @@
+/**
+ * MLX model pin loader — single source of truth for which MLX model
+ * AgentDeck uses across probe, timeline summarizer, label summarizer,
+ * and APME judge.
+ *
+ * Source: ~/.agentdeck/settings.json → `llm.mlx.{endpoint,model}`.
+ * Falls back to legacy `apme.judge.{endpoint,model}` for backward compat.
+ * Placeholder model ids ("qwen3-30b", "default", empty) are treated as unset.
+ *
+ * Mirrored in Swift by apple/AgentDeck/Daemon/Apme/ApmeSettings.swift
+ * (LlmMlxConfig). Keep the two in sync when fields change.
+ */
+/** Final fallback when neither settings nor probe yield a model id. */
+export declare const MLX_FALLBACK_MODEL = "mlx-community/Qwen3.6-35B-A3B-4bit";
+export interface MlxSettings {
+    /** Base URL (no /chat/completions suffix). */
+    endpoint: string;
+    /** Pinned model id, or null when user hasn't chosen one. */
+    model: string | null;
+}
+export declare function loadMlxSettings(): MlxSettings;
+/** Force a reload on next call — used by tests and after settings writes. */
+export declare function clearMlxSettingsCache(): void;
+/**
+ * Resolve the MLX model id for an actual inference call.
+ * Priority: pinned settings → caller-supplied probe result → hardcoded fallback.
+ */
+export declare function resolveMlxModel(probeFirst?: string | null): string;
+/**
+ * Pick one model id from a live probe catalog. Returns `null` when the
+ * server is unreachable or advertises no usable model — UI should render
+ * "MLX · Not detected" rather than silently masquerading the fallback as
+ * active (the fallback id won't exist on the user's disk and every
+ * summarize call would fail).
+ *
+ * Priority — mirrors the 4-layer policy documented in CLAUDE.md:
+ *   1. caller-supplied pin if present in catalog
+ *   2. `MLX_FALLBACK_MODEL` (3.6 family) if present in catalog — keeps the
+ *      codebase's chosen default in sync with what the dashboard advertises
+ *   3. first catalog entry (preserves the `auto-pick first` behavior added
+ *      in commit 2b7b38b3 for the many-models case)
+ *   4. null — no catalog
+ */
+export declare function pickMlxModel(catalog: string[] | null | undefined, pin?: string | null): string | null;
+/**
+ * Return a full chat-completions URL for the configured endpoint.
+ * MLX-VLM uses `/chat/completions`; MLX-LM historically also answers on
+ * `/v1/chat/completions`. We use the non-v1 path to match existing callers
+ * (timeline-summarizer, label-summarizer, apme runner all hit /chat/completions).
+ */
+export declare function mlxChatUrl(): string;
+//# sourceMappingURL=llm-settings.d.ts.map

package/dist/llm-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-settings.d.ts","sourceRoot":"","sources":["../src/llm-settings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAQH,uEAAuE;AACvE,eAAO,MAAM,kBAAkB,uCAAuC,CAAC;AAIvE,MAAM,WAAW,WAAW;IAC1B,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAqBD,wBAAgB,eAAe,IAAI,WAAW,CAqC7C;AAED,6EAA6E;AAC7E,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAKlE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,GAAG,SAAS,EACpC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,GAClB,MAAM,GAAG,IAAI,CAKf;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC"}

package/dist/llm-settings.js

@@ -0,0 +1,118 @@
+/**
+ * MLX model pin loader — single source of truth for which MLX model
+ * AgentDeck uses across probe, timeline summarizer, label summarizer,
+ * and APME judge.
+ *
+ * Source: ~/.agentdeck/settings.json → `llm.mlx.{endpoint,model}`.
+ * Falls back to legacy `apme.judge.{endpoint,model}` for backward compat.
+ * Placeholder model ids ("qwen3-30b", "default", empty) are treated as unset.
+ *
+ * Mirrored in Swift by apple/AgentDeck/Daemon/Apme/ApmeSettings.swift
+ * (LlmMlxConfig). Keep the two in sync when fields change.
+ */
+import { readFileSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+const DEFAULT_ENDPOINT = 'http://127.0.0.1:8800';
+/** Final fallback when neither settings nor probe yield a model id. */
+export const MLX_FALLBACK_MODEL = 'mlx-community/Qwen3.6-35B-A3B-4bit';
+const PLACEHOLDER_MODEL_IDS = new Set(['', 'default', 'qwen3-30b']);
+let cached = null;
+const CACHE_TTL_MS = 30_000;
+function settingsPath() {
+    const dir = process.env.AGENTDECK_DATA_DIR || join(homedir(), '.agentdeck');
+    return join(dir, 'settings.json');
+}
+function isPlaceholder(m) {
+    if (typeof m !== 'string')
+        return true;
+    return PLACEHOLDER_MODEL_IDS.has(m.trim());
+}
+function stripChatSuffix(url) {
+    return url
+        .replace(/\/v1\/chat\/completions$/, '')
+        .replace(/\/chat\/completions$/, '');
+}
+export function loadMlxSettings() {
+    if (cached && Date.now() - cached.at < CACHE_TTL_MS) {
+        return cached.value;
+    }
+    let endpoint = DEFAULT_ENDPOINT;
+    let model = null;
+    try {
+        const raw = JSON.parse(readFileSync(settingsPath(), 'utf-8'));
+        const llmMlx = (raw.llm?.mlx ?? {});
+        if (typeof llmMlx.endpoint === 'string' && llmMlx.endpoint.length > 0) {
+            endpoint = stripChatSuffix(llmMlx.endpoint);
+        }
+        if (!isPlaceholder(llmMlx.model)) {
+            model = llmMlx.model.trim();
+        }
+        // Legacy fallback: apme.judge.{endpoint,model}
+        if (model === null || endpoint === DEFAULT_ENDPOINT) {
+            const judge = (raw.apme?.judge ?? {});
+            if (model === null && !isPlaceholder(judge.model)) {
+                model = judge.model.trim();
+            }
+            if (endpoint === DEFAULT_ENDPOINT && typeof judge.endpoint === 'string' && judge.endpoint.length > 0) {
+                endpoint = stripChatSuffix(judge.endpoint);
+            }
+        }
+    }
+    catch {
+        // file missing or malformed — keep defaults
+    }
+    const value = { endpoint, model };
+    cached = { at: Date.now(), value };
+    return value;
+}
+/** Force a reload on next call — used by tests and after settings writes. */
+export function clearMlxSettingsCache() {
+    cached = null;
+}
+/**
+ * Resolve the MLX model id for an actual inference call.
+ * Priority: pinned settings → caller-supplied probe result → hardcoded fallback.
+ */
+export function resolveMlxModel(probeFirst) {
+    const { model } = loadMlxSettings();
+    if (model)
+        return model;
+    if (probeFirst && probeFirst.length > 0)
+        return probeFirst;
+    return MLX_FALLBACK_MODEL;
+}
+/**
+ * Pick one model id from a live probe catalog. Returns `null` when the
+ * server is unreachable or advertises no usable model — UI should render
+ * "MLX · Not detected" rather than silently masquerading the fallback as
+ * active (the fallback id won't exist on the user's disk and every
+ * summarize call would fail).
+ *
+ * Priority — mirrors the 4-layer policy documented in CLAUDE.md:
+ *   1. caller-supplied pin if present in catalog
+ *   2. `MLX_FALLBACK_MODEL` (3.6 family) if present in catalog — keeps the
+ *      codebase's chosen default in sync with what the dashboard advertises
+ *   3. first catalog entry (preserves the `auto-pick first` behavior added
+ *      in commit 2b7b38b3 for the many-models case)
+ *   4. null — no catalog
+ */
+export function pickMlxModel(catalog, pin) {
+    if (!catalog || catalog.length === 0)
+        return null;
+    if (pin && pin.length > 0 && catalog.includes(pin))
+        return pin;
+    if (catalog.includes(MLX_FALLBACK_MODEL))
+        return MLX_FALLBACK_MODEL;
+    return catalog[0];
+}
+/**
+ * Return a full chat-completions URL for the configured endpoint.
+ * MLX-VLM uses `/chat/completions`; MLX-LM historically also answers on
+ * `/v1/chat/completions`. We use the non-v1 path to match existing callers
+ * (timeline-summarizer, label-summarizer, apme runner all hit /chat/completions).
+ */
+export function mlxChatUrl() {
+    return `${loadMlxSettings().endpoint}/chat/completions`;
+}
+//# sourceMappingURL=llm-settings.js.map

package/dist/llm-settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-settings.js","sourceRoot":"","sources":["../src/llm-settings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAE7B,MAAM,gBAAgB,GAAG,uBAAuB,CAAC;AAEjD,uEAAuE;AACvE,MAAM,CAAC,MAAM,kBAAkB,GAAG,oCAAoC,CAAC;AAEvE,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC;AASpE,IAAI,MAAM,GAA8C,IAAI,CAAC;AAC7D,MAAM,YAAY,GAAG,MAAM,CAAC;AAE5B,SAAS,YAAY;IACnB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,YAAY,CAAC,CAAC;IAC5E,OAAO,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;AACpC,CAAC;AAED,SAAS,aAAa,CAAC,CAAU;IAC/B,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACvC,OAAO,qBAAqB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED,SAAS,eAAe,CAAC,GAAW;IAClC,OAAO,GAAG;SACP,OAAO,CAAC,0BAA0B,EAAE,EAAE,CAAC;SACvC,OAAO,CAAC,sBAAsB,EAAE,EAAE,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,IAAI,MAAM,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,EAAE,GAAG,YAAY,EAAE,CAAC;QACpD,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC;IACD,IAAI,QAAQ,GAAG,gBAAgB,CAAC;IAChC,IAAI,KAAK,GAAkB,IAAI,CAAC;IAChC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,EAAE,EAAE,OAAO,CAAC,CAA4B,CAAC;QAEzF,MAAM,MAAM,GAAG,CAAE,GAAG,CAAC,GAAqC,EAAE,GAAG,IAAI,EAAE,CAEpE,CAAC;QACF,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtE,QAAQ,GAAG,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC9C,CAAC;QACD,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YACjC,KAAK,GAAI,MAAM,CAAC,KAAgB,CAAC,IAAI,EAAE,CAAC;QAC1C,CAAC;QAED,+CAA+C;QAC/C,IAAI,KAAK,KAAK,IAAI,IAAI,QAAQ,KAAK,gBAAgB,EAAE,CAAC;YACpD,MAAM,KAAK,GAAG,CAAE,GAAG,CAAC,IAAwC,EAAE,KAAK,IAAI,EAAE,CAExE,CAAC;YACF,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;gBAClD,KAAK,GAAI,KAAK,CAAC,KAAgB,CAAC,IAAI,EAAE,CAAC;YACzC,CAAC;YACD,IAAI,QAAQ,KAAK,gBAAgB,IAAI,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACrG,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YAC7C,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,4CAA4C;IAC9C,CAAC;IACD,MAAM,KAAK,GAAgB,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAC/C,MAAM,GAAG,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC;IACnC,OAAO,KAAK,CAAC;AACf,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,qBAAqB;IACnC,MAAM,GAAG,IAAI,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,UAA0B;IACxD,MAAM,EAAE,KAAK,EAAE,GAAG,eAAe,EAAE,CAAC;IACpC,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC;IACxB,IAAI,UAAU,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,UAAU,CAAC;IAC3D,OAAO,kBAAkB,CAAC;AAC5B,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,YAAY,CAC1B,OAAoC,EACpC,GAAmB;IAEnB,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAClD,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IAC/D,IAAI,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC;QAAE,OAAO,kBAAkB,CAAC;IACpE,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU;IACxB,OAAO,GAAG,eAAe,EAAE,CAAC,QAAQ,mBAAmB,CAAC;AAC1D,CAAC"}