Merge pull request #557 from devforth/add-tools-to-completion-adapter

feat: add ajv as a dependency and enhance CompletionAdapter with tool…

Author: ivictbor

adminforth/package.json

@@ -73,6 +73,7 @@
     "@inquirer/prompts": "^7.4.1",
     "@qdrant/js-client-rest": "^1.17.0",
     "@types/express": "^4.17.21",
+    "ajv": "^8.18.0",
     "arg": "^5.0.2",
     "ast-types": "^0.14.2",
     "better-sqlite3": "^11.10.0",

adminforth/pnpm-lock.yaml

@@ -1,9 +1,18 @@
+import type { JSONSchemaType } from "ajv";
+
 export type CompletionStreamEvent = {
   type: "output" | "reasoning";
   delta: string;
   text: string;
   source?: "summary" | "text";
 };
+
+export type CompletionTool<Input = Record<string, any>, Output = any> = {
+  name: string;
+  input_schema: JSONSchemaType<Input>;
+  description?: string;
+  handler: (input: Input) => Promise<Output> | Output;
+};
 export interface CompletionAdapter {
 
   /**
@@ -26,6 +35,7 @@ export interface CompletionAdapter {
     maxTokens: number,
     outputSchema?: any,
     reasoningEffort?: 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh',
+    tools?: CompletionTool[],
     onChunk?: (
       chunk: string,
       event?: CompletionStreamEvent,