@4djs/assistant 0.1.0 → 0.1.2

package/dist/tools/datastore.d.ts

@@ -0,0 +1,28 @@
+import { type AssistantToolRegistry } from "../core/tool-registry.js";
+export interface DatastoreQueryInput {
+    dataClass: string;
+    filter?: string;
+    filterParams?: Array<{
+        type: string;
+        value: string;
+    }>;
+    sort?: string;
+    order?: "asc" | "desc";
+    limit?: number;
+    page?: number;
+    select?: string[];
+}
+export interface DatastoreToolsAdapter {
+    getCatalog(): Promise<unknown>;
+    getServerInfo(): Promise<unknown>;
+    queryEntities(input: DatastoreQueryInput): Promise<unknown>;
+    getEntity(dataClass: string, key: string): Promise<unknown>;
+    createEntity(dataClass: string, data: Record<string, unknown>): Promise<unknown>;
+    updateEntity(dataClass: string, key: string, data: Record<string, unknown>): Promise<unknown>;
+    deleteEntity(dataClass: string, key: string): Promise<unknown>;
+    /** Return an error message when writes are blocked; null when allowed */
+    assertWritable?(): string | null;
+}
+/** Register the standard 4D datastore REST tools on a registry. */
+export declare function registerDatastoreTools(registry: AssistantToolRegistry, adapter: DatastoreToolsAdapter): AssistantToolRegistry;
+//# sourceMappingURL=datastore.d.ts.map

package/dist/tools/datastore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"datastore.d.ts","sourceRoot":"","sources":["../../src/tools/datastore.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,0BAA0B,CAAC;AAElC,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/B,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAClC,aAAa,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5D,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5D,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACjF,YAAY,CACV,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/D,yEAAyE;IACzE,cAAc,CAAC,IAAI,MAAM,GAAG,IAAI,CAAC;CAClC;AA6LD,mEAAmE;AACnE,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,qBAAqB,EAC/B,OAAO,EAAE,qBAAqB,GAC7B,qBAAqB,CAKvB"}

package/dist/tools/index.d.ts

@@ -0,0 +1,4 @@
+export type { DatastoreQueryInput, DatastoreToolsAdapter, } from "./datastore.js";
+export { registerDatastoreTools } from "./datastore.js";
+export { connectExternalTools, createAssistantToolRegistry, resolveAssistantToolHooks, type AssistantToolHandler, type AssistantToolRegistry, } from "../core/tool-registry.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,yBAAyB,EACzB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,GAC3B,MAAM,0BAA0B,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,249 @@
+// src/core/tool-registry.ts
+function toolResultOk(data) {
+  return {
+    content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+    structuredContent: data
+  };
+}
+function toolResultErr(message) {
+  return {
+    content: [{ type: "text", text: message }],
+    isError: true
+  };
+}
+
+class AssistantToolRegistryImpl {
+  entries = new Map;
+  register(handler) {
+    const name = handler.definition.name;
+    if (!name.trim()) {
+      throw new Error("Tool definition.name is required");
+    }
+    this.entries.set(name, { handler, active: true });
+    return this;
+  }
+  deactivate(name) {
+    const entry = this.entries.get(name);
+    if (!entry)
+      return false;
+    entry.active = false;
+    return true;
+  }
+  activate(name) {
+    const entry = this.entries.get(name);
+    if (!entry)
+      return false;
+    entry.active = true;
+    return true;
+  }
+  isActive(name) {
+    const entry = this.entries.get(name);
+    return entry?.active ?? false;
+  }
+  has(name) {
+    return this.entries.has(name);
+  }
+  async listTools() {
+    return [...this.entries.values()].filter((entry) => entry.active).map((entry) => entry.handler.definition);
+  }
+  async invokeTool(name, args) {
+    const entry = this.entries.get(name);
+    if (!entry?.active) {
+      return toolResultErr(`Unknown tool: ${name}`);
+    }
+    try {
+      return await entry.handler.invoke(args);
+    } catch (error) {
+      return toolResultErr(error instanceof Error ? error.message : String(error));
+    }
+  }
+}
+function createAssistantToolRegistry() {
+  return new AssistantToolRegistryImpl;
+}
+function resolveAssistantToolHooks(registry) {
+  return {
+    listTools: () => registry.listTools(),
+    invokeTool: (name, args) => registry.invokeTool(name, args)
+  };
+}
+function connectExternalTools(registry, external) {
+  const names = external.listTools().map((definition) => {
+    registry.register({
+      definition,
+      invoke: (args) => external.invokeTool(definition.name, args)
+    });
+    return definition.name;
+  });
+  return () => {
+    for (const name of names) {
+      registry.deactivate(name);
+    }
+  };
+}
+
+// src/tools/datastore.ts
+function parseQueryArgs(args) {
+  const filterParams = Array.isArray(args.filterParams) ? args.filterParams.map((value) => ({
+    type: typeof value === "number" ? "number" : typeof value === "boolean" ? "boolean" : "string",
+    value: String(value)
+  })) : undefined;
+  return {
+    dataClass: String(args.dataClass ?? ""),
+    filter: typeof args.filter === "string" ? args.filter : undefined,
+    filterParams,
+    sort: typeof args.sort === "string" ? args.sort : undefined,
+    order: args.order === "asc" ? "asc" : "desc",
+    limit: typeof args.limit === "number" ? args.limit : undefined,
+    page: typeof args.page === "number" ? args.page : undefined,
+    select: Array.isArray(args.select) ? args.select.map(String) : undefined
+  };
+}
+function buildDatastoreToolHandlers(adapter) {
+  return [
+    {
+      definition: {
+        name: "get_catalog",
+        description: "Return the 4D REST catalog: dataclasses, attributes, methods, and entity counts.",
+        inputSchema: {
+          type: "object",
+          properties: {},
+          additionalProperties: false
+        }
+      },
+      invoke: async () => toolResultOk(await adapter.getCatalog())
+    },
+    {
+      definition: {
+        name: "get_server_info",
+        description: "Return server info: cache, entity sets, sessions, and privileges.",
+        inputSchema: {
+          type: "object",
+          properties: {},
+          additionalProperties: false
+        }
+      },
+      invoke: async () => toolResultOk(await adapter.getServerInfo())
+    },
+    {
+      definition: {
+        name: "query_entities",
+        description: "Query entities from a dataclass with optional filter, sort, and pagination.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            dataClass: { type: "string", description: "Dataclass name" },
+            filter: { type: "string", description: "4D filter expression" },
+            filterParams: {
+              type: "array",
+              items: {},
+              description: "Values for :1, :2, … placeholders in the filter"
+            },
+            sort: { type: "string", description: "Attribute to sort by" },
+            order: { type: "string", enum: ["asc", "desc"] },
+            limit: { type: "number", description: "Page size (default 20)" },
+            page: { type: "number", description: "Page number (default 1)" },
+            select: {
+              type: "array",
+              items: { type: "string" },
+              description: "Attributes to return"
+            }
+          },
+          required: ["dataClass"]
+        }
+      },
+      invoke: async (args) => toolResultOk(await adapter.queryEntities(parseQueryArgs(args)))
+    },
+    {
+      definition: {
+        name: "get_entity",
+        description: "Get a single entity by primary key.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            dataClass: { type: "string" },
+            key: { type: "string", description: "Entity primary key" }
+          },
+          required: ["dataClass", "key"]
+        }
+      },
+      invoke: async (args) => toolResultOk(await adapter.getEntity(String(args.dataClass ?? ""), String(args.key ?? "")))
+    },
+    {
+      definition: {
+        name: "create_entity",
+        description: "Create a new entity in a dataclass.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            dataClass: { type: "string" },
+            data: {
+              type: "object",
+              description: "Attribute values for the new entity"
+            }
+          },
+          required: ["dataClass", "data"]
+        }
+      },
+      invoke: async (args) => {
+        const writeError = adapter.assertWritable?.() ?? null;
+        if (writeError)
+          return toolResultErr(writeError);
+        return toolResultOk(await adapter.createEntity(String(args.dataClass ?? ""), args.data ?? {}));
+      }
+    },
+    {
+      definition: {
+        name: "update_entity",
+        description: "Update an existing entity.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            dataClass: { type: "string" },
+            key: { type: "string" },
+            data: { type: "object", description: "Fields to update" }
+          },
+          required: ["dataClass", "key", "data"]
+        }
+      },
+      invoke: async (args) => {
+        const writeError = adapter.assertWritable?.() ?? null;
+        if (writeError)
+          return toolResultErr(writeError);
+        return toolResultOk(await adapter.updateEntity(String(args.dataClass ?? ""), String(args.key ?? ""), args.data ?? {}));
+      }
+    },
+    {
+      definition: {
+        name: "delete_entity",
+        description: "Delete an entity by primary key.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            dataClass: { type: "string" },
+            key: { type: "string" }
+          },
+          required: ["dataClass", "key"]
+        }
+      },
+      invoke: async (args) => {
+        const writeError = adapter.assertWritable?.() ?? null;
+        if (writeError)
+          return toolResultErr(writeError);
+        return toolResultOk(await adapter.deleteEntity(String(args.dataClass ?? ""), String(args.key ?? "")));
+      }
+    }
+  ];
+}
+function registerDatastoreTools(registry, adapter) {
+  for (const handler of buildDatastoreToolHandlers(adapter)) {
+    registry.register(handler);
+  }
+  return registry;
+}
+export {
+  resolveAssistantToolHooks,
+  registerDatastoreTools,
+  createAssistantToolRegistry,
+  connectExternalTools
+};

package/package.json

@@ -1,52 +1,57 @@
 {
-	"name": "@4djs/assistant",
-	"version": "0.1.0",
-	"type": "module",
-	"types": "./dist/react/index.d.ts",
-	"files": [
-		"dist"
-	],
-	"exports": {
-		".": {
-			"types": "./dist/react/index.d.ts",
-			"import": "./dist/index.js"
-		},
-		"./core": {
-			"types": "./dist/core/index.d.ts",
-			"import": "./dist/core/index.js"
-		},
-		"./styles.css": "./dist/styles.css"
-	},
-	"scripts": {
-		"typecheck": "tsc --noEmit",
-		"build": "bun run build:core && bun run build:react && bun run build:styles && bun run build:types",
-		"build:core": "bun build ./src/core/index.ts --outdir ./dist/core --target node --format esm",
-		"build:react": "bun build ./src/react/index.ts --outdir ./dist --target browser --external react --external react-dom --format esm",
-		"build:styles": "mkdir -p dist && cp src/styles/assistant.css dist/styles.css",
-		"build:types": "tsc -p tsconfig.build.json && bun ./scripts/normalize-dts.ts",
-		"prepack": "bun run build"
-	},
-	"dependencies": {
-		"highlight.js": "11.11.1",
-		"katex": "0.17.0",
-		"lucide-react": "^0.511.0",
-		"mermaid": "11.15.0",
-		"react-markdown": "10.1.0",
-		"rehype-katex": "7.0.1",
-		"remark-gfm": "4.0.1",
-		"remark-math": "6.0.0",
-		"zustand": "^5.0.5"
-	},
-	"peerDependencies": {
-		"react": "^19.0.0",
-		"react-dom": "^19.0.0"
-	},
-	"devDependencies": {
-		"@4d/typescript-config": "workspace:*",
-		"@types/react": "^19.1.2",
-		"@types/react-dom": "^19.1.2",
-		"react": "^19.1.0",
-		"react-dom": "^19.1.0",
-		"typescript": "catalog:"
-	}
+  "name": "@4djs/assistant",
+  "version": "0.1.2",
+  "type": "module",
+  "types": "./dist/react/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/react/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./core": {
+      "types": "./dist/core/index.d.ts",
+      "import": "./dist/core/index.js"
+    },
+    "./tools": {
+      "types": "./dist/tools/index.d.ts",
+      "import": "./dist/tools/index.js"
+    },
+    "./styles.css": "./dist/styles.css"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "build": "bun run build:core && bun run build:tools && bun run build:react && bun run build:styles && bun run build:types",
+    "build:core": "bun build ./src/core/index.ts --outdir ./dist/core --target browser --format esm --external react --external react-dom",
+    "build:tools": "bun build ./src/tools/index.ts --outdir ./dist/tools --target browser --format esm --external @4djs/assistant/core",
+    "build:react": "bun build ./src/react/index.ts --outdir ./dist --target browser --format esm --external react --external react-dom --external react/jsx-runtime --external react/jsx-dev-runtime --external @4djs/assistant/core",
+    "build:styles": "mkdir -p dist && cp src/styles/assistant.css dist/styles.css",
+    "build:types": "tsc -p tsconfig.build.json && bun ./scripts/normalize-dts.ts",
+    "prepack": "bun run build"
+  },
+  "dependencies": {
+    "highlight.js": "11.11.1",
+    "katex": "0.17.0",
+    "lucide-react": "^0.511.0",
+    "mermaid": "11.15.0",
+    "react-markdown": "10.1.0",
+    "rehype-katex": "7.0.1",
+    "remark-gfm": "4.0.1",
+    "remark-math": "6.0.0",
+    "zustand": "^5.0.5"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
+  },
+  "devDependencies": {
+    "@4d/typescript-config": "workspace:*",
+    "@types/react": "^19.1.2",
+    "@types/react-dom": "^19.1.2",
+    "react": "^19.1.0",
+    "react-dom": "^19.1.0",
+    "typescript": "catalog:"
+  }
 }