@link-assistant/agent 0.24.2 → 0.24.3

package/README.md

@@ -24,7 +24,7 @@ This is an MVP implementation of an OpenCode-compatible CLI agent, focused on ma
 
 - ✅ **JSON Input/Output**: Compatible with `opencode run --format json --model opencode/minimax-m2.5-free`
 - ✅ **Plain Text Input**: Also accepts plain text messages (auto-converted to JSON format)
-- ✅ **Flexible Model Selection**: Defaults to free OpenCode Zen MiniMax M2.5 Free, supports [OpenCode Zen](https://opencode.ai/docs/zen/), [Claude OAuth](../docs/claude-oauth.md), [Groq](../docs/groq.md), and [OpenRouter](../docs/openrouter.md) providers
+- ✅ **Flexible Model Selection**: Defaults to free OpenCode Zen MiniMax M2.5 Free, supports [OpenCode Zen](https://opencode.ai/docs/zen/), [Formal AI](../docs/formal-ai.md), [Claude OAuth](../docs/claude-oauth.md), [Groq](../docs/groq.md), and [OpenRouter](../docs/openrouter.md) providers
 - ✅ **No Restrictions**: Fully unrestricted file system and command execution access (no sandbox)
 - ✅ **Minimal Footprint**: Built with Bun.sh for maximum efficiency
 - ✅ **Full Tool Support**: 13 tools including websearch, codesearch, batch - all enabled by default
@@ -201,6 +201,10 @@ echo "hi" | agent --model opencode/nemotron-3-super-free
 echo "hi" | agent --model opencode/gpt-5-nano
 echo "hi" | agent --model opencode/big-pickle
 
+# Formal AI local server
+echo "hi" | agent --model formal-ai
+echo "hi" | agent --model @link-assistant/formal-ai
+
 # Premium models (OpenCode Zen subscription)
 echo "hi" | agent --model opencode/sonnet        # Claude Sonnet 4.5
 echo "hi" | agent --model opencode/haiku         # Claude Haiku 4.5
@@ -237,6 +241,7 @@ echo "hi" | agent --model github-copilot/gpt-4o        # Uses Copilot
 ```
 
 See [MODELS.md](../MODELS.md) for complete list of available models and pricing.
+See [docs/formal-ai.md](../docs/formal-ai.md) for Formal AI local server setup.
 See [docs/groq.md](../docs/groq.md) for Groq provider documentation.
 See [docs/openrouter.md](../docs/openrouter.md) for OpenRouter provider documentation.
 See [docs/claude-oauth.md](../docs/claude-oauth.md) for Claude OAuth provider documentation.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@link-assistant/agent",
-  "version": "0.24.2",
+  "version": "0.24.3",
   "description": "A minimal, public domain AI CLI agent compatible with OpenCode's JSON interface. Bun-only runtime.",
   "main": "src/index.js",
   "type": "module",

package/src/provider/provider.ts

@@ -75,7 +75,79 @@ export namespace Provider {
 
   type Source = 'env' | 'config' | 'custom' | 'api';
 
+  const FORMAL_AI_DEFAULT_BASE_URL = 'http://127.0.0.1:8080/api/openai/v1';
+  const FORMAL_AI_API_KEY_ENV = 'FORMAL_AI_API_KEY';
+  const FORMAL_AI_BASE_URL_ENV = 'FORMAL_AI_BASE_URL';
+  const FORMAL_AI_DEFAULT_API_KEY = 'formal-ai';
+
+  function getFormalAiBaseURL(provider?: ModelsDev.Provider) {
+    return (
+      process.env[FORMAL_AI_BASE_URL_ENV] ??
+      provider?.api ??
+      FORMAL_AI_DEFAULT_BASE_URL
+    );
+  }
+
+  function createFormalAiLoader(input?: ModelsDev.Provider) {
+    return {
+      autoload: true,
+      options: {
+        apiKey: process.env[FORMAL_AI_API_KEY_ENV] ?? FORMAL_AI_DEFAULT_API_KEY,
+        baseURL: getFormalAiBaseURL(input),
+      },
+    };
+  }
+
+  function createFormalAiModel(name = 'Formal AI'): ModelsDev.Model {
+    return {
+      id: 'formal-ai',
+      name,
+      release_date: '2026-07-03',
+      attachment: false,
+      reasoning: true,
+      temperature: true,
+      tool_call: true,
+      cost: {
+        input: 0,
+        output: 0,
+        cache_read: 0,
+        cache_write: 0,
+      },
+      limit: {
+        context: 60000,
+        output: 8192,
+      },
+      modalities: {
+        input: ['text'],
+        output: ['text'],
+      },
+      options: {},
+      provider: {
+        npm: '@ai-sdk/openai-compatible',
+      },
+    };
+  }
+
+  function createFormalAiProvider(
+    id: string,
+    name: string
+  ): ModelsDev.Provider {
+    return {
+      id,
+      name,
+      npm: '@ai-sdk/openai-compatible',
+      api: getFormalAiBaseURL(),
+      env: [FORMAL_AI_API_KEY_ENV],
+      models: {
+        'formal-ai': createFormalAiModel('formal-ai'),
+      },
+    };
+  }
+
   const CUSTOM_LOADERS: Record<string, CustomLoader> = {
+    'formal-ai': async (input) => createFormalAiLoader(input),
+    formalai: async (input) => createFormalAiLoader(input),
+    '@link-assistant': async (input) => createFormalAiLoader(input),
     async anthropic(input) {
       // Check if OAuth credentials are available via the auth plugin
       const auth = await Auth.get('anthropic');
@@ -791,6 +863,22 @@ export namespace Provider {
       realIdByKey.set('google/gemini-3-pro', 'gemini-3-pro-preview');
     }
 
+    // Add Formal AI local OpenAI-compatible provider and selectors.
+    // Formal AI serves the canonical model ID "formal-ai"; Agent also accepts
+    // the scoped selector "@link-assistant/formal-ai" as a provider alias.
+    database['formal-ai'] = createFormalAiProvider(
+      'formal-ai',
+      'Formal AI Local Server'
+    );
+    database['formalai'] = createFormalAiProvider(
+      'formalai',
+      'Formal AI Local Server'
+    );
+    database['@link-assistant'] = createFormalAiProvider(
+      '@link-assistant',
+      'Formal AI Local Server (@link-assistant alias)'
+    );
+
     // Add link-assistant echo provider for dry-run testing
     // This synthetic provider echoes back user input without API calls
     // @see https://github.com/link-assistant/agent/issues/89
@@ -1994,6 +2082,17 @@ export namespace Provider {
       }
     }
 
+    if (modelID === 'formal-ai') {
+      const formalAiProvider = s.providers['formal-ai'];
+      if (formalAiProvider && formalAiProvider.info.models[modelID]) {
+        log.info(() => ({
+          message: 'resolved short model name to formal-ai (canonical)',
+          modelID,
+        }));
+        return { providerID: 'formal-ai', modelID };
+      }
+    }
+
     // Check if model exists in any provider
     const matchingProviders: string[] = [];
     for (const [providerID, provider] of Object.entries(s.providers)) {