Update VSCode extension to use agent API

Author: ddaspit

package-lock.json

@@ -6,7 +6,7 @@ import { Observable, Subject } from 'rxjs';
 
 import { DeepAgentConfig } from './deep-agent-config';
 import { DeepAgentToolDefinition } from './deep-agent-tool';
-import { createWorkspaceTools } from './deep-agent-workspace-tools';
+import { createWorkspaceTools } from './deep-agent-tools';
 
 type DeepAgent = ReturnType<typeof createDeepAgent>;
 

packages/deep-agent/src/deep-agent-provider.ts

@@ -1,7 +1,9 @@
-import { WorkspaceAccessor } from '@sillsdev/lynx';
+import { Document, DocumentAccessor, WorkspaceAccessor } from '@sillsdev/lynx';
 import { tool } from 'langchain';
 import { z } from 'zod';
 
+import { DeepAgentToolDefinition } from './deep-agent-tool';
+
 const diagnosticSchema = z.object({
   code: z.union([z.string(), z.number()]),
   source: z.string(),
@@ -38,7 +40,8 @@ export function createWorkspaceTools<T>(workspace: WorkspaceAccessor<T>) {
       },
       {
         name: 'get_diagnostic_actions',
-        description: 'Get available fix actions for a specific diagnostic issue in a document',
+        description:
+          'Get available fix actions for a specific diagnostic issue in a document. An action will either contain a `command` to execute by calling `execute_diagnostic_command` or `edits` to apply directly to the document.',
         schema: z.object({
           uri: z.string().describe('The document URI'),
           diagnostic: diagnosticSchema.describe('The diagnostic to get actions for'),
@@ -76,3 +79,31 @@ export function createWorkspaceTools<T>(workspace: WorkspaceAccessor<T>) {
     ),
   ];
 }
+
+export function createDocumentAccessorTools<T extends Document = Document>(
+  documents: DocumentAccessor<T>,
+): DeepAgentToolDefinition[] {
+  return [
+    {
+      name: 'get_active_documents',
+      description: 'Returns a list of all documents currently open in the workspace with their URIs and formats.',
+      schema: z.object({}),
+      async execute(_args: unknown) {
+        const docs = await documents.active();
+        return JSON.stringify(docs.map((doc) => ({ uri: doc.uri, format: doc.format })));
+      },
+    },
+    {
+      name: 'get_document',
+      description: 'Returns the URI, format, version, and full text content of a workspace document by URI.',
+      schema: z.object({ uri: z.string().describe('The URI of the document to retrieve.') }),
+      async execute({ uri }: { uri: string }) {
+        const doc = await documents.get(uri);
+        if (doc == null) {
+          return JSON.stringify({ error: `Document not found: ${uri}` });
+        }
+        return JSON.stringify({ uri: doc.uri, format: doc.format, version: doc.version, content: doc.getText() });
+      },
+    },
+  ];
+}

…-agent/src/deep-agent-workspace-tools.ts …kages/deep-agent/src/deep-agent-tools.tspackages/deep-agent/src/deep-agent-workspace-tools.ts renamed to packages/deep-agent/src/deep-agent-tools.ts packages/deep-agent/src/deep-agent-workspace-tools.ts renamed to packages/deep-agent/src/deep-agent-tools.ts

@@ -2,4 +2,4 @@ export type { DeepAgentConfig } from './deep-agent-config';
 export { DeepAgentProvider } from './deep-agent-provider';
 export type { DeepAgentSubAgentDefinition } from './deep-agent-sub-agent';
 export type { DeepAgentToolDefinition } from './deep-agent-tool';
-export { createWorkspaceTools } from './deep-agent-workspace-tools';
+export { createDocumentAccessorTools, createWorkspaceTools } from './deep-agent-tools';

packages/deep-agent/src/index.ts

@@ -14,12 +14,21 @@
   "license": "MIT",
   "description": "",
   "engines": {
-    "vscode": "^1.75.0"
+    "vscode": "^1.93.0"
   },
   "activationEvents": [
     "onLanguage:usfm"
   ],
   "contributes": {
+    "chatParticipants": [
+      {
+        "id": "lynx.chatParticipant",
+        "fullName": "Lynx",
+        "name": "lynx",
+        "description": "Bible translation assistant that helps with translation quality checks, formatting, and diagnostics.",
+        "isSticky": true
+      }
+    ],
     "languages": [
       {
         "id": "usfm",
@@ -41,17 +50,40 @@
           "type": "string",
           "default": "",
           "description": "Path to a JSON file for persisting dismissed diagnostics. If empty, dismissals are stored in memory only."
+        },
+        "lynx.agent.enabled": {
+          "type": "boolean",
+          "default": false,
+          "description": "Enable the Lynx agent and chat participant."
+        },
+        "lynx.agent.provider": {
+          "type": "string",
+          "enum": ["anthropic", "openai", "google-genai"],
+          "default": "anthropic",
+          "description": "LLM provider for the Lynx agent."
+        },
+        "lynx.agent.model": {
+          "type": "string",
+          "default": "",
+          "description": "Model identifier for the Lynx agent. If empty, a sensible default is used based on the provider."
+        },
+        "lynx.agent.apiKey": {
+          "type": "string",
+          "default": "",
+          "description": "API key for the Lynx agent. If empty, falls back to the provider's environment variable (ANTHROPIC_API_KEY, OPENAI_API_KEY, or GOOGLE_API_KEY)."
         }
       }
     }
   },
   "dependencies": {
+    "langchain": "^1.3.1",
     "@sillsdev/lynx": "*",
+    "@sillsdev/lynx-deep-agent": "*",
     "@sillsdev/lynx-examples": "*",
     "@sillsdev/lynx-punctuation-checker": "*",
     "@sillsdev/lynx-usfm": "*",
-    "vscode-languageclient": "^9.0.1",
-    "vscode-languageserver": "^9.0.1"
+    "rxjs": "^7.8.2",
+    "zod": "^3.23.0"
   },
   "devDependencies": {
     "@repo/eslint-config": "*",