@tangleai/assistant 0.21.1 → 0.24.1

package/src/settings.js

@@ -1,11 +1,12 @@
-//@ts-check
 import { PROVIDERS } from '@tangleai/models/providers';
 export const PROVIDER_OPTIONS = Object.entries(PROVIDERS)
-  .map(([value, preset]) => ({ value, label: preset.label, local: preset.local }));
-
+    .map(([value, preset]) => ({ value, label: preset.label, local: preset.local }));
 export function isConfigured(s) {
-  if (s.model.trim() === '') return false;
-  if (s.provider === 'custom') return s.baseUrl.trim() !== '';
-  if (s.provider === 'openrouter') return s.apiKey.trim() !== '';
-  return true; // local runtimes (Ollama, LM Studio) need no key
+    if (s.model.trim() === '')
+        return false;
+    if (s.provider === 'custom')
+        return s.baseUrl.trim() !== '';
+    if (s.provider === 'openrouter')
+        return s.apiKey.trim() !== '';
+    return true; // local runtimes (Ollama, LM Studio) need no key
 }

package/src/state.d.ts

@@ -1,11 +1,17 @@
-/** @param {any} [aiSettings] @param {any} [aiChat] */
-export function createAssistantState(aiSettings?: any, aiChat?: any): {
+export declare const DEFAULT_AI_SETTINGS: {
+    provider: string;
+    baseUrl: string;
+    model: string;
+    apiKey: string;
+};
+/** @param [aiSettings] @param [aiChat] */
+export declare function createAssistantState(aiSettings?: any, aiChat?: any): {
     open: boolean;
     settingsOpen: boolean;
     probe: {
         status: string;
-        detail: any;
-        models: any[];
+        detail: null;
+        models: never[];
     };
     reasoningChars: number;
     settings: any;
@@ -13,20 +19,14 @@ export function createAssistantState(aiSettings?: any, aiChat?: any): {
     draft: string;
     pending: string;
     status: string;
-    activity: any;
-    error: any;
-    goal: any;
+    activity: null;
+    error: null;
+    goal: null;
     goalDraft: string;
     memories: number;
-    persistence: any;
-    retention: any;
+    persistence: null;
+    retention: null;
     archived: number;
     remembering: boolean;
-    remembered: any;
+    remembered: null;
 };
-export namespace DEFAULT_AI_SETTINGS {
-    let provider: string;
-    let baseUrl: string;
-    let model: string;
-    let apiKey: string;
-}

package/src/state.js

@@ -1,40 +1,39 @@
-//@ts-check
 export const DEFAULT_AI_SETTINGS = {
-  provider: 'openrouter',  // 'openrouter' | 'ollama' | 'lmstudio' | 'custom'
-  baseUrl: '',             // required for 'custom'; overrides the preset otherwise
-  model: '',               // e.g. 'qwen/qwen3-4b' or a local model name
-  apiKey: '',              // bring your own; local runtimes need none
+    provider: 'openrouter', // 'openrouter' | 'ollama' | 'lmstudio' | 'custom'
+    baseUrl: '', // required for 'custom'; overrides the preset otherwise
+    model: '', // e.g. 'qwen/qwen3-4b' or a local model name
+    apiKey: '', // bring your own; local runtimes need none
 };
-/** @param {any} [aiSettings] @param {any} [aiChat] */
+/** @param [aiSettings] @param [aiChat] */
 export function createAssistantState(aiSettings = null, aiChat = null) {
- return {
-      open: false,
-      settingsOpen: false,
-      // the settings "Test connection" probe: idle | busy | ok | fail,
-      // a human detail line, and the model ids a successful probe found
-      probe: { status: 'idle', detail: null, models: [] },
-      // reasoning characters streamed this turn (thinking models emit
-      // reasoning before - or instead of - visible content)
-      reasoningChars: 0,
-      settings: { ...DEFAULT_AI_SETTINGS, ...(aiSettings ?? {}) },
-      // visible transcript: { role, content }; restored from local
-      // storage so a page reload keeps the conversation
-      messages: Array.isArray(aiChat?.messages) ? structuredClone(aiChat.messages) : [],
-      draft: '',             // composer text
-      pending: '',           // the assistant reply currently streaming
-      status: 'idle',        // 'idle' | 'streaming' | 'error'
-      activity: null,        // the tool the model is currently calling
-      error: null,
-      // the @tangleai/context ledger, as the panel shows it. Read from the
-      // ledger (not mirrored into it): the objective is durable state and
-      // this slice is a view of it, so a reload shows what storage holds
-      // rather than what this tab last typed.
-      goal: null,            // { objective, progress: [ { at, note, evidence } ] }
-      goalDraft: '',         // the objective composer
-      memories: 0,           // evidenced facts carried into every turn
-      persistence: null, retention: null,
-      archived: 0,           // dropped rounds sitting in slots, recallable
-      remembering: false,    // a refinement is in flight
-      remembered: null,      // what the last refinement did, in one line
+    return {
+        open: false,
+        settingsOpen: false,
+        // the settings "Test connection" probe: idle | busy | ok | fail,
+        // a human detail line, and the model ids a successful probe found
+        probe: { status: 'idle', detail: null, models: [] },
+        // reasoning characters streamed this turn (thinking models emit
+        // reasoning before - or instead of - visible content)
+        reasoningChars: 0,
+        settings: { ...DEFAULT_AI_SETTINGS, ...(aiSettings ?? {}) },
+        // visible transcript: { role, content }; restored from local
+        // storage so a page reload keeps the conversation
+        messages: Array.isArray(aiChat?.messages) ? structuredClone(aiChat.messages) : [],
+        draft: '', // composer text
+        pending: '', // the assistant reply currently streaming
+        status: 'idle', // 'idle' | 'streaming' | 'error'
+        activity: null, // the tool the model is currently calling
+        error: null,
+        // the @tangleai/context ledger, as the panel shows it. Read from the
+        // ledger (not mirrored into it): the objective is durable state and
+        // this slice is a view of it, so a reload shows what storage holds
+        // rather than what this tab last typed.
+        goal: null, // { objective, progress: [ { at, note, evidence } ] }
+        goalDraft: '', // the objective composer
+        memories: 0, // evidenced facts carried into every turn
+        persistence: null, retention: null,
+        archived: 0, // dropped rounds sitting in slots, recallable
+        remembering: false, // a refinement is in flight
+        remembered: null, // what the last refinement did, in one line
     };
 }

package/src/viewmodel.d.ts

@@ -1,5 +1,5 @@
-/** @param {any} ai @param {(source: string) => any} renderMarkdown */
-export function assistantView(ai: any, renderMarkdown: (source: string) => any): {
+/** @param ai @param renderMarkdown */
+export declare function assistantView(ai: any, renderMarkdown: (source: string) => any): {
     open: any;
     status: any;
     activity: any;
@@ -42,7 +42,7 @@ export function assistantView(ai: any, renderMarkdown: (source: string) => any):
             evidence: any;
         }[];
         more: number;
-    };
+    } | null;
     goalDraft: any;
     memories: any;
     memoryLabel: string;

package/src/viewmodel.js

@@ -1,77 +1,75 @@
-//@ts-check
-import { PROVIDER_OPTIONS, isConfigured } from './settings.js';
-/** @param {any} ai @param {(source: string) => any} renderMarkdown */
+import { PROVIDER_OPTIONS, isConfigured } from "./settings.js";
+/** @param ai @param renderMarkdown */
 export function assistantView(ai, renderMarkdown) {
-  const s = ai.settings;
-  const configured = isConfigured(s);
-  return {
-    open: ai.open,
-    status: ai.status,
-    activity: ai.activity,
-    error: ai.error,
-    draft: ai.draft,
-    configured,
-    // the settings form shows until the assistant can actually run, or
-    // whenever the user opens it explicitly
-    showSettings: ai.settingsOpen || !configured,
-    settings: {
-      provider: s.provider,
-      baseUrl: s.baseUrl,
-      model: s.model,
-      apiKey: s.apiKey,
-      needsKey: s.provider === 'openrouter' || s.provider === 'custom',
-      probe: {
-        status: ai.probe.status,
-        detail: ai.probe.detail,
-        busy: ai.probe.status === 'busy',
-        ok: ai.probe.status === 'ok',
-        fail: ai.probe.status === 'fail',
-        models: ai.probe.models.map((id) => ({ id })),
-      },
-    },
-    providers: PROVIDER_OPTIONS.map((p) => ({ ...p, selected: p.value === s.provider })),
-    empty: ai.messages.length === 0,
-    messages: ai.messages.map((m) => (m.role === 'user'
-      ? { role: 'user', text: m.content }
-      : { role: 'assistant', article: renderMarkdown(m.content) })),
-    // the reply currently streaming in (plain text: it changes per token)
-    streaming: ai.status === 'streaming',
-    pending: ai.pending,
-    // the quiet-phase label: reasoning models think before they speak,
-    // and watching the thinking grow beats a blind spinner
-    thinkingLabel: ai.reasoningChars > 0
-      ? `Thinking… (${ai.reasoningChars} characters of reasoning)`
-      : 'Thinking…',
-    // the ledger: a persistent objective, what has been recorded against
-    // it, and what a compacted session can still reach. Every number here
-    // is derived from the ledger read, so the panel cannot claim a
-    // memory the store does not hold.
-    goal: ai.goal === null ? null : {
-      objective: ai.goal.objective,
-      entries: ai.goal.progress.length + (ai.goal.checkpoint?.sources.length ?? 0),
-      checkpointLabel: ai.goal.checkpoint ? `${ai.goal.checkpoint.sources.length} earlier progress entries retained with their evidence.` : '',
-      // newest first: the last thing that happened is the thing a reader
-      // wants, and the whole log would push the conversation off screen
-      progress: [...ai.goal.progress].reverse().slice(0, PROGRESS_SHOWN)
-        .map((entry) => ({ note: entry.note, evidence: entry.evidence })),
-      more: Math.max(0, ai.goal.progress.length - PROGRESS_SHOWN),
-    },
-    goalDraft: ai.goalDraft,
-    memories: ai.memories,
-    memoryLabel: `${ai.memories} remembered fact${ai.memories === 1 ? '' : 's'}`,
-    persistenceLabel: ai.persistence?.error ? `Storage failed: ${ai.persistence.error}`
-      : ai.persistence?.concurrency === 'single-writer' ? 'Use one tab at a time to update remembered state.' : '',
-    retentionLabel: ai.retention?.evicted?.length
-      ? `${ai.retention.evicted.length} earlier archive address(es) evicted under the storage budget.` : '',
-    archived: ai.archived,
-    // said in full sentences, because "12" beside a chat is not
-    // information: a compacted session has to LOOK recoverable
-    archivedLabel: `${ai.archived} earlier round${ai.archived === 1 ? '' : 's'} archived —`
-      + ' the assistant can fetch any of them back with recall.',
-    remembering: ai.remembering,
-    remembered: ai.remembered,
-  };
+    const s = ai.settings;
+    const configured = isConfigured(s);
+    return {
+        open: ai.open,
+        status: ai.status,
+        activity: ai.activity,
+        error: ai.error,
+        draft: ai.draft,
+        configured,
+        // the settings form shows until the assistant can actually run, or
+        // whenever the user opens it explicitly
+        showSettings: ai.settingsOpen || !configured,
+        settings: {
+            provider: s.provider,
+            baseUrl: s.baseUrl,
+            model: s.model,
+            apiKey: s.apiKey,
+            needsKey: s.provider === 'openrouter' || s.provider === 'custom',
+            probe: {
+                status: ai.probe.status,
+                detail: ai.probe.detail,
+                busy: ai.probe.status === 'busy',
+                ok: ai.probe.status === 'ok',
+                fail: ai.probe.status === 'fail',
+                models: ai.probe.models.map((id) => ({ id })),
+            },
+        },
+        providers: PROVIDER_OPTIONS.map((p) => ({ ...p, selected: p.value === s.provider })),
+        empty: ai.messages.length === 0,
+        messages: ai.messages.map((m) => (m.role === 'user'
+            ? { role: 'user', text: m.content }
+            : { role: 'assistant', article: renderMarkdown(m.content) })),
+        // the reply currently streaming in (plain text: it changes per token)
+        streaming: ai.status === 'streaming',
+        pending: ai.pending,
+        // the quiet-phase label: reasoning models think before they speak,
+        // and watching the thinking grow beats a blind spinner
+        thinkingLabel: ai.reasoningChars > 0
+            ? `Thinking… (${ai.reasoningChars} characters of reasoning)`
+            : 'Thinking…',
+        // the ledger: a persistent objective, what has been recorded against
+        // it, and what a compacted session can still reach. Every number here
+        // is derived from the ledger read, so the panel cannot claim a
+        // memory the store does not hold.
+        goal: ai.goal === null ? null : {
+            objective: ai.goal.objective,
+            entries: ai.goal.progress.length + (ai.goal.checkpoint?.sources.length ?? 0),
+            checkpointLabel: ai.goal.checkpoint ? `${ai.goal.checkpoint.sources.length} earlier progress entries retained with their evidence.` : '',
+            // newest first: the last thing that happened is the thing a reader
+            // wants, and the whole log would push the conversation off screen
+            progress: [...ai.goal.progress].reverse().slice(0, PROGRESS_SHOWN)
+                .map((entry) => ({ note: entry.note, evidence: entry.evidence })),
+            more: Math.max(0, ai.goal.progress.length - PROGRESS_SHOWN),
+        },
+        goalDraft: ai.goalDraft,
+        memories: ai.memories,
+        memoryLabel: `${ai.memories} remembered fact${ai.memories === 1 ? '' : 's'}`,
+        persistenceLabel: ai.persistence?.error ? `Storage failed: ${ai.persistence.error}`
+            : ai.persistence?.concurrency === 'single-writer' ? 'Use one tab at a time to update remembered state.' : '',
+        retentionLabel: ai.retention?.evicted?.length
+            ? `${ai.retention.evicted.length} earlier archive address(es) evicted under the storage budget.` : '',
+        archived: ai.archived,
+        // said in full sentences, because "12" beside a chat is not
+        // information: a compacted session has to LOOK recoverable
+        archivedLabel: `${ai.archived} earlier round${ai.archived === 1 ? '' : 's'} archived —`
+            + ' the assistant can fetch any of them back with recall.',
+        remembering: ai.remembering,
+        remembered: ai.remembered,
+    };
 }
-
 /** Progress entries the panel shows before it says "and N more". */
 const PROGRESS_SHOWN = 3;

package/src/views.d.ts

@@ -7,7 +7,7 @@
  * text because it changes per token.
  */
 /** One instance owns its datalist identifier and host copy. */
-export function createAssistantRules(modelListId: any): ({
+export declare function createAssistantRules(modelListId: any): ({
     match: string;
     mode: string;
     body: (string | {
@@ -149,6 +149,26 @@ export function createAssistantRules(modelListId: any): ({
         } | {
             $if: (string | {
                 $if: (string | (string | {
+                    class: string;
+                    on: {
+                        submit: {
+                            action: string;
+                            preventDefault: boolean;
+                        };
+                    };
+                } | (string | {
+                    type: string;
+                    class: string;
+                    spellcheck: string;
+                    placeholder: string;
+                    value: string;
+                    on: {
+                        input: string;
+                    };
+                })[] | (string | {
+                    type: string;
+                    class: string;
+                })[])[] | (string | {
                     class: string;
                     $if?: undefined;
                 } | (string | {
@@ -196,26 +216,6 @@ export function createAssistantRules(modelListId: any): ({
                         class: string;
                     })[])[];
                     class?: undefined;
-                })[])[] | (string | {
-                    class: string;
-                    on: {
-                        submit: {
-                            action: string;
-                            preventDefault: boolean;
-                        };
-                    };
-                } | (string | {
-                    type: string;
-                    class: string;
-                    spellcheck: string;
-                    placeholder: string;
-                    value: string;
-                    on: {
-                        input: string;
-                    };
-                })[] | (string | {
-                    type: string;
-                    class: string;
                 })[])[])[];
             })[];
             class?: undefined;