@datar-platform/cli 0.1.0-alpha.0

package/dist/mcp/tools/ask.js

@@ -0,0 +1,66 @@
+/**
+ * Natural-language fallback — forward a free-form question to a Datar A2A agent
+ * (or the orchestrator, which routes for you). This reuses the whole agent
+ * stack (tool-calling, KB grounding, cross-service delegation) for anything the
+ * typed read tools don't cover.
+ *
+ * THIS TOOL CAN ACT. The agent may call mutating endpoints, and token scopes do
+ * NOT reliably stop it (serviceProcedure endpoints skip the scope middleware).
+ * So it is registered only when DATAR_MCP_ALLOW_AGENT=1 — the default read-only
+ * surface omits it entirely. See ./index.ts and the CLI README.
+ */
+import { z } from "zod";
+import { tool } from "../registry.js";
+const SERVICES = [
+    "orchestrator",
+    "drive",
+    "projects",
+    "people",
+    "requests",
+    "inventory",
+    "messages",
+    "social",
+    "procurement",
+    "transact",
+    "isms",
+    "advice",
+];
+export const askTool = tool({
+    name: "datar_ask",
+    description: "Ask a Datar service agent a natural-language question. Defaults to the " +
+        "orchestrator, which routes to the right service(s). Use this for anything " +
+        "not covered by the typed read tools. Returns the agent's reply plus any " +
+        "structured data it produced. CAN ACT — the agent may perform writes.",
+    inputSchema: {
+        message: z
+            .string()
+            .min(1)
+            .max(4000)
+            .describe("The question or instruction."),
+        service: z
+            .enum(SERVICES)
+            .optional()
+            .describe("Target service; omit to use the orchestrator."),
+        contextId: z
+            .string()
+            .optional()
+            .describe("Pass a prior reply's contextId to continue the conversation."),
+    },
+    handler: async (client, args) => {
+        const service = SERVICES.includes(String(args.service))
+            ? args.service
+            : "orchestrator";
+        const res = await client.ai.ask({
+            service,
+            message: String(args.message),
+            contextId: typeof args.contextId === "string" ? args.contextId : undefined,
+        });
+        return {
+            text: res.text,
+            data: res.data,
+            routedTo: res.routedTo,
+            contextId: res.contextId,
+        };
+    },
+});
+//# sourceMappingURL=ask.js.map

package/dist/mcp/tools/ask.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask.js","sourceRoot":"","sources":["../../../src/mcp/tools/ask.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAEtC,MAAM,QAAQ,GAAG;IACf,cAAc;IACd,OAAO;IACP,UAAU;IACV,QAAQ;IACR,UAAU;IACV,WAAW;IACX,UAAU;IACV,QAAQ;IACR,aAAa;IACb,UAAU;IACV,MAAM;IACN,QAAQ;CACA,CAAC;AAIX,MAAM,CAAC,MAAM,OAAO,GAAY,IAAI,CAAC;IACnC,IAAI,EAAE,WAAW;IACjB,WAAW,EACT,yEAAyE;QACzE,4EAA4E;QAC5E,0EAA0E;QAC1E,sEAAsE;IACxE,WAAW,EAAE;QACX,OAAO,EAAE,CAAC;aACP,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,GAAG,CAAC,IAAI,CAAC;aACT,QAAQ,CAAC,8BAA8B,CAAC;QAC3C,OAAO,EAAE,CAAC;aACP,IAAI,CAAC,QAAQ,CAAC;aACd,QAAQ,EAAE;aACV,QAAQ,CAAC,+CAA+C,CAAC;QAC5D,SAAS,EAAE,CAAC;aACT,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,8DAA8D,CAAC;KAC5E;IACD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;QAC9B,MAAM,OAAO,GAAI,QAA8B,CAAC,QAAQ,CACtD,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CACrB;YACC,CAAC,CAAE,IAAI,CAAC,OAAmB;YAC3B,CAAC,CAAC,cAAc,CAAC;QACnB,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC;YAC9B,OAAO;YACP,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;YAC7B,SAAS,EACP,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;SAClE,CAAC,CAAC;QACH,OAAO;YACL,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,SAAS,EAAE,GAAG,CAAC,SAAS;SACzB,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/mcp/tools/discovery.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Discovery tools — the "what can I do / who am I" surface. These are what make
+ * the harness feel like it's connected to a live org (à la `aws sts get-caller-
+ * identity` + a service catalog): the token resolves the tenant, and the agent
+ * cards provide the endpoint/schema catalog that makes downstream work precise.
+ */
+import type { ResolvedConfig } from "../../config.js";
+import type { ToolDef } from "../registry.js";
+export declare function buildDiscoveryTools(config: ResolvedConfig): ToolDef[];
+//# sourceMappingURL=discovery.d.ts.map

package/dist/mcp/tools/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/discovery.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAqB9C,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,EAAE,CAwErE"}

package/dist/mcp/tools/discovery.js

@@ -0,0 +1,76 @@
+/**
+ * Discovery tools — the "what can I do / who am I" surface. These are what make
+ * the harness feel like it's connected to a live org (à la `aws sts get-caller-
+ * identity` + a service catalog): the token resolves the tenant, and the agent
+ * cards provide the endpoint/schema catalog that makes downstream work precise.
+ */
+import { z } from "zod";
+import { datarGet } from "../../http.js";
+import { tool } from "../registry.js";
+export function buildDiscoveryTools(config) {
+    return [
+        tool({
+            name: "datar_whoami",
+            description: "Resolve the identity this API token maps to: the current user, the " +
+                "organization(s)/tenant the token is bound to, and the base URL. Call " +
+                "this first to confirm you are pointed at the right Datar org.",
+            inputSchema: {},
+            handler: async (client) => {
+                const [profile, tenants] = await Promise.allSettled([
+                    client.query("v2.auth.getProfile"),
+                    client.query("v2.auth.resolveTenantsForSession"),
+                ]);
+                return {
+                    baseUrl: config.baseUrl,
+                    credentialSource: config.source,
+                    user: profile.status === "fulfilled" ? profile.value : null,
+                    tenants: tenants.status === "fulfilled" ? tenants.value : null,
+                    note: "Access is limited to this token's scopes. A read-only token cannot mutate.",
+                };
+            },
+        }),
+        tool({
+            name: "datar_list_services",
+            description: "List all Datar A2A service agents available to this org (drive, " +
+                "people, projects, requests, isms, procurement, inventory, transact, " +
+                "messages, social, advice, orchestrator). The catalog to read first.",
+            inputSchema: {},
+            handler: async (client) => {
+                // tRPC catalog (ids + active provider) …
+                const services = await client.query("v2.ai.agents.listServices");
+                // … enriched with the discoverable agent cards (skills + schemas).
+                let cards = [];
+                try {
+                    cards = await datarGet(config, "/api/a2a/agents");
+                }
+                catch {
+                    // Agent-card route optional / auth-gated differently — ids still useful.
+                }
+                return {
+                    services,
+                    cards: cards.map((c) => ({
+                        name: c.name,
+                        skills: c.skills.map((s) => s.id),
+                    })),
+                };
+            },
+        }),
+        tool({
+            name: "datar_describe_service",
+            description: "Describe one Datar service agent in full: its skills with input/output " +
+                "JSON schemas and examples, straight from the agent card. Use this to " +
+                "learn the exact shape of a service's capabilities before calling them.",
+            inputSchema: {
+                service: z
+                    .string()
+                    .describe("Service id, e.g. 'drive', 'procurement', 'transact'."),
+            },
+            handler: async (_client, args) => {
+                const service = String(args.service);
+                const card = await datarGet(config, `/api/a2a/${service}/.well-known/agent.json`);
+                return card;
+            },
+        }),
+    ];
+}
+//# sourceMappingURL=discovery.js.map

package/dist/mcp/tools/discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../../src/mcp/tools/discovery.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAmBtC,MAAM,UAAU,mBAAmB,CAAC,MAAsB;IACxD,OAAO;QACL,IAAI,CAAC;YACH,IAAI,EAAE,cAAc;YACpB,WAAW,EACT,qEAAqE;gBACrE,uEAAuE;gBACvE,+DAA+D;YACjE,WAAW,EAAE,EAAE;YACf,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;gBACxB,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC;oBAClD,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC;oBAClC,MAAM,CAAC,KAAK,CAAC,kCAAkC,CAAC;iBACjD,CAAC,CAAC;gBACH,OAAO;oBACL,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,gBAAgB,EAAE,MAAM,CAAC,MAAM;oBAC/B,IAAI,EAAE,OAAO,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;oBAC3D,OAAO,EAAE,OAAO,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;oBAC9D,IAAI,EAAE,4EAA4E;iBACnF,CAAC;YACJ,CAAC;SACF,CAAC;QAEF,IAAI,CAAC;YACH,IAAI,EAAE,qBAAqB;YAC3B,WAAW,EACT,kEAAkE;gBAClE,sEAAsE;gBACtE,qEAAqE;YACvE,WAAW,EAAE,EAAE;YACf,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;gBACxB,yCAAyC;gBACzC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;gBACjE,mEAAmE;gBACnE,IAAI,KAAK,GAAgB,EAAE,CAAC;gBAC5B,IAAI,CAAC;oBACH,KAAK,GAAG,MAAM,QAAQ,CAAc,MAAM,EAAE,iBAAiB,CAAC,CAAC;gBACjE,CAAC;gBAAC,MAAM,CAAC;oBACP,yEAAyE;gBAC3E,CAAC;gBACD,OAAO;oBACL,QAAQ;oBACR,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;wBACvB,IAAI,EAAE,CAAC,CAAC,IAAI;wBACZ,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;qBAClC,CAAC,CAAC;iBACJ,CAAC;YACJ,CAAC;SACF,CAAC;QAEF,IAAI,CAAC;YACH,IAAI,EAAE,wBAAwB;YAC9B,WAAW,EACT,yEAAyE;gBACzE,uEAAuE;gBACvE,wEAAwE;YAC1E,WAAW,EAAE;gBACX,OAAO,EAAE,CAAC;qBACP,MAAM,EAAE;qBACR,QAAQ,CAAC,sDAAsD,CAAC;aACpE;YACD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;gBAC/B,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACrC,MAAM,IAAI,GAAG,MAAM,QAAQ,CACzB,MAAM,EACN,YAAY,OAAO,yBAAyB,CAC7C,CAAC;gBACF,OAAO,IAAI,CAAC;YACd,CAAC;SACF,CAAC;KACH,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,23 @@
+/**
+ * Assemble the v1 tool registry.
+ *
+ * READ-ONLY BY DEFAULT — and the guarantee is CLIENT-SIDE, not scope-based:
+ * every discovery/read tool and `datar_query` issue HTTP GETs only, and tRPC
+ * refuses mutations over GET, so they cannot write regardless of the token's
+ * scopes. (Token scopes are NOT a reliable guard here: `serviceProcedure`
+ * endpoints — most of the API — skip the scope-enforcement middleware, so a
+ * "read-scoped" token can still write through them. See the CLI README.)
+ *
+ * `datar_ask` is the ONE tool that can act: it drives an A2A agent, which may
+ * call mutating endpoints. It is therefore OPT-IN — registered only when
+ * `allowAgent` is true (env `DATAR_MCP_ALLOW_AGENT=1`). Default off keeps the
+ * whole surface provably read-only.
+ */
+import type { ResolvedConfig } from "../../config.js";
+import type { ToolDef } from "../registry.js";
+export interface RegistryOptions {
+    /** Register the acting `datar_ask` tool. Default: env DATAR_MCP_ALLOW_AGENT === "1". */
+    allowAgent?: boolean;
+}
+export declare function buildRegistry(config: ResolvedConfig, opts?: RegistryOptions): ToolDef[];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAM9C,MAAM,WAAW,eAAe;IAC9B,wFAAwF;IACxF,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,wBAAgB,aAAa,CAC3B,MAAM,EAAE,cAAc,EACtB,IAAI,GAAE,eAAoB,GACzB,OAAO,EAAE,CASX"}

package/dist/mcp/tools/index.js

@@ -0,0 +1,29 @@
+/**
+ * Assemble the v1 tool registry.
+ *
+ * READ-ONLY BY DEFAULT — and the guarantee is CLIENT-SIDE, not scope-based:
+ * every discovery/read tool and `datar_query` issue HTTP GETs only, and tRPC
+ * refuses mutations over GET, so they cannot write regardless of the token's
+ * scopes. (Token scopes are NOT a reliable guard here: `serviceProcedure`
+ * endpoints — most of the API — skip the scope-enforcement middleware, so a
+ * "read-scoped" token can still write through them. See the CLI README.)
+ *
+ * `datar_ask` is the ONE tool that can act: it drives an A2A agent, which may
+ * call mutating endpoints. It is therefore OPT-IN — registered only when
+ * `allowAgent` is true (env `DATAR_MCP_ALLOW_AGENT=1`). Default off keeps the
+ * whole surface provably read-only.
+ */
+import { askTool } from "./ask.js";
+import { buildDiscoveryTools } from "./discovery.js";
+import { queryTool } from "./query.js";
+import { readTools } from "./reads.js";
+export function buildRegistry(config, opts = {}) {
+    const allowAgent = opts.allowAgent ?? process.env.DATAR_MCP_ALLOW_AGENT === "1";
+    return [
+        ...buildDiscoveryTools(config),
+        ...readTools,
+        queryTool,
+        ...(allowAgent ? [askTool] : []),
+    ];
+}
+//# sourceMappingURL=index.js.map

package/dist/mcp/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mcp/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAOvC,MAAM,UAAU,aAAa,CAC3B,MAAsB,EACtB,OAAwB,EAAE;IAE1B,MAAM,UAAU,GACd,IAAI,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC,qBAAqB,KAAK,GAAG,CAAC;IAC/D,OAAO;QACL,GAAG,mBAAmB,CAAC,MAAM,CAAC;QAC9B,GAAG,SAAS;QACZ,SAAS;QACT,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KACjC,CAAC;AACJ,CAAC"}

package/dist/mcp/tools/query.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Generic read escape hatch — call ANY Datar tRPC *query* by path. Covers read
+ * procedures not given a dedicated typed tool.
+ *
+ * Two guardrails keep this read-only:
+ *  1. Hard guarantee — `client.query()` issues an HTTP GET, and tRPC only serves
+ *     *queries* over GET; a mutation path is rejected by the server.
+ *  2. Early rejection — we refuse paths whose last segment reads like a mutation
+ *     verb, so the harness gets a clear message instead of a server error.
+ * There is deliberately NO `datar_mutate` tool in v1.
+ */
+import type { ToolDef } from "../registry.js";
+/** Returns a reason string if the path looks like a mutation, else null. */
+export declare function rejectIfMutation(path: string): string | null;
+export declare const queryTool: ToolDef;
+//# sourceMappingURL=query.d.ts.map

package/dist/mcp/tools/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/query.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AA2C9C,4EAA4E;AAC5E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAU5D;AAED,eAAO,MAAM,SAAS,EAAE,OAqBtB,CAAC"}

package/dist/mcp/tools/query.js

@@ -0,0 +1,87 @@
+/**
+ * Generic read escape hatch — call ANY Datar tRPC *query* by path. Covers read
+ * procedures not given a dedicated typed tool.
+ *
+ * Two guardrails keep this read-only:
+ *  1. Hard guarantee — `client.query()` issues an HTTP GET, and tRPC only serves
+ *     *queries* over GET; a mutation path is rejected by the server.
+ *  2. Early rejection — we refuse paths whose last segment reads like a mutation
+ *     verb, so the harness gets a clear message instead of a server error.
+ * There is deliberately NO `datar_mutate` tool in v1.
+ */
+import { z } from "zod";
+import { tool } from "../registry.js";
+/** Verbs that mark a tRPC procedure as a mutation in this codebase's naming. */
+const MUTATION_VERBS = [
+    "create",
+    "update",
+    "delete",
+    "remove",
+    "publish",
+    "submit",
+    "approve",
+    "reject",
+    "send",
+    "set",
+    "add",
+    "archive",
+    "cancel",
+    "restore",
+    "star",
+    "move",
+    "generate",
+    "upload",
+    "confirm",
+    "share",
+    "reserve",
+    "release",
+    "fulfill",
+    "adjust",
+    "register",
+    "withdraw",
+    "invoke",
+    "complete",
+    "mark",
+    "flag",
+    "empty",
+    "revoke",
+    "seed",
+    "import",
+    "assign",
+    "provision",
+];
+/** Returns a reason string if the path looks like a mutation, else null. */
+export function rejectIfMutation(path) {
+    const last = path.split(".").pop()?.toLowerCase() ?? "";
+    const hit = MUTATION_VERBS.find((v) => last === v || last.startsWith(v));
+    if (hit) {
+        return `Refusing "${path}": segment "${last}" looks like a mutation (v1 is read-only). Use datar_ask for actions, or mint a write-scoped token in a future version.`;
+    }
+    if (!path.startsWith("v2.")) {
+        return `Refusing "${path}": expected a v2.* tRPC query path (e.g. "v2.drive.file.getCurrentUserFiles").`;
+    }
+    return null;
+}
+export const queryTool = tool({
+    name: "datar_query",
+    description: "Call any Datar tRPC *query* (read) by path, e.g. " +
+        "'v2.drive.file.getCurrentUserFiles'. Read-only: mutation paths are refused. " +
+        "Use datar_list_services / datar_describe_service to discover what exists.",
+    inputSchema: {
+        path: z
+            .string()
+            .describe("tRPC query path, e.g. 'v2.people.org.getActiveMembers'."),
+        input: z
+            .unknown()
+            .optional()
+            .describe("Optional input for the query (object or scalar)."),
+    },
+    handler: async (client, args) => {
+        const path = String(args.path);
+        const reason = rejectIfMutation(path);
+        if (reason)
+            throw new Error(reason);
+        return client.query(path, args.input);
+    },
+});
+//# sourceMappingURL=query.js.map

package/dist/mcp/tools/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../../src/mcp/tools/query.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAEtC,gFAAgF;AAChF,MAAM,cAAc,GAAG;IACrB,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,QAAQ;IACR,SAAS;IACT,QAAQ;IACR,MAAM;IACN,KAAK;IACL,KAAK;IACL,SAAS;IACT,QAAQ;IACR,SAAS;IACT,MAAM;IACN,MAAM;IACN,UAAU;IACV,QAAQ;IACR,SAAS;IACT,OAAO;IACP,SAAS;IACT,SAAS;IACT,SAAS;IACT,QAAQ;IACR,UAAU;IACV,UAAU;IACV,QAAQ;IACR,UAAU;IACV,MAAM;IACN,MAAM;IACN,OAAO;IACP,QAAQ;IACR,MAAM;IACN,QAAQ;IACR,QAAQ;IACR,WAAW;CACZ,CAAC;AAEF,4EAA4E;AAC5E,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IACxD,MAAM,GAAG,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IACzE,IAAI,GAAG,EAAE,CAAC;QACR,OAAO,aAAa,IAAI,eAAe,IAAI,yHAAyH,CAAC;IACvK,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,aAAa,IAAI,gFAAgF,CAAC;IAC3G,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,MAAM,SAAS,GAAY,IAAI,CAAC;IACrC,IAAI,EAAE,aAAa;IACnB,WAAW,EACT,mDAAmD;QACnD,8EAA8E;QAC9E,2EAA2E;IAC7E,WAAW,EAAE;QACX,IAAI,EAAE,CAAC;aACJ,MAAM,EAAE;aACR,QAAQ,CAAC,yDAAyD,CAAC;QACtE,KAAK,EAAE,CAAC;aACL,OAAO,EAAE;aACT,QAAQ,EAAE;aACV,QAAQ,CAAC,kDAAkD,CAAC;KAChE;IACD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;QAC9B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/B,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC;QACpC,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IACxC,CAAC;CACF,CAAC,CAAC"}

package/dist/mcp/tools/reads.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Typed read tools — deterministic, 1:1 wrappers over `@datar-platform/sdk`
+ * read methods. Every handler calls only SDK read methods (tRPC GET). No
+ * mutations. These give the harness precise, schema'd access to the highest-
+ * value data without paying for a nested-LLM agent round-trip.
+ */
+import type { ToolDef } from "../registry.js";
+export declare const readTools: ToolDef[];
+//# sourceMappingURL=reads.d.ts.map

package/dist/mcp/tools/reads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reads.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/reads.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAO9C,eAAO,MAAM,SAAS,EAAE,OAAO,EAsL9B,CAAC"}

package/dist/mcp/tools/reads.js

@@ -0,0 +1,177 @@
+/**
+ * Typed read tools — deterministic, 1:1 wrappers over `@datar-platform/sdk`
+ * read methods. Every handler calls only SDK read methods (tRPC GET). No
+ * mutations. These give the harness precise, schema'd access to the highest-
+ * value data without paying for a nested-LLM agent round-trip.
+ */
+import { z } from "zod";
+import { tool } from "../registry.js";
+const str = (v) => String(v);
+const optStr = (v) => typeof v === "string" && v.length > 0 ? v : undefined;
+export const readTools = [
+    // ── Drive ──────────────────────────────────────────────────────────────
+    tool({
+        name: "drive_list_files",
+        description: "List Drive files. With no folderId, returns the current user's files; " +
+            "pass a folderId to list a specific folder's contents.",
+        inputSchema: {
+            folderId: z
+                .string()
+                .optional()
+                .describe("Folder id, or omit for the user's files."),
+        },
+        handler: (client, args) => client.drive.listFiles(optStr(args.folderId)),
+    }),
+    tool({
+        name: "drive_get_file",
+        description: "Get a single Drive file's metadata by id.",
+        inputSchema: { id: z.string().describe("File id.") },
+        handler: (client, args) => client.drive.getFile(str(args.id)),
+    }),
+    tool({
+        name: "drive_list_folders",
+        description: "List Drive folders for the current user.",
+        inputSchema: {},
+        handler: (client) => client.drive.listFolders(),
+    }),
+    // ── Projects & tasks ───────────────────────────────────────────────────
+    tool({
+        name: "projects_list",
+        description: "List all projects in the org.",
+        inputSchema: {},
+        handler: (client) => client.projects.list(),
+    }),
+    tool({
+        name: "projects_get",
+        description: "Get one project by id.",
+        inputSchema: { id: z.string().describe("Project id.") },
+        handler: (client, args) => client.projects.get(str(args.id)),
+    }),
+    tool({
+        name: "projects_metrics",
+        description: "Get project portfolio metrics (totals, active projects, pending tasks, critical issues).",
+        inputSchema: {},
+        handler: (client) => client.projects.getMetrics(),
+    }),
+    tool({
+        name: "tasks_list",
+        description: "List tasks. Filter by projectId, or assignedToMe, or backlog; omit all for every task.",
+        inputSchema: {
+            projectId: z.string().optional(),
+            assignedToMe: z.boolean().optional(),
+            backlog: z.boolean().optional(),
+        },
+        handler: (client, args) => client.projects.tasks.list({
+            projectId: optStr(args.projectId),
+            assignedToMe: args.assignedToMe === true ? true : undefined,
+            backlog: args.backlog === true ? true : undefined,
+        }),
+    }),
+    // ── People ─────────────────────────────────────────────────────────────
+    tool({
+        name: "people_list",
+        description: "List active members of the org (the token's tenant).",
+        inputSchema: {},
+        handler: (client) => client.query("v2.people.org.getActiveMembers"),
+    }),
+    // ── Requests / approvals ───────────────────────────────────────────────
+    tool({
+        name: "requests_list",
+        description: "List all requests in the org.",
+        inputSchema: {},
+        handler: (client) => client.requests.getAll(),
+    }),
+    tool({
+        name: "requests_pending_approvals",
+        description: "List requests awaiting the current user's approval.",
+        inputSchema: {},
+        handler: (client) => client.requests.getCurrentUserPendingApprovals(),
+    }),
+    // ── Transact (accounts / transactions — e.g. PayFast-backed ledgers) ────
+    tool({
+        name: "transact_list_accounts",
+        description: "List the current user's accounts (expense/income/asset/liability).",
+        inputSchema: {},
+        handler: (client) => client.transact.listAccounts(),
+    }),
+    tool({
+        name: "transact_list_transactions",
+        description: "List transactions. Optionally filter by accountId, or by a startDate/endDate range (ISO dates).",
+        inputSchema: {
+            accountId: z.string().optional(),
+            startDate: z.string().optional(),
+            endDate: z.string().optional(),
+        },
+        handler: (client, args) => client.transact.listTransactions({
+            accountId: optStr(args.accountId),
+            startDate: optStr(args.startDate),
+            endDate: optStr(args.endDate),
+        }),
+    }),
+    // ── Procurement (tenders / suppliers) ──────────────────────────────────
+    tool({
+        name: "procurement_list_tenders",
+        description: "List the org's tenders (buyer side).",
+        inputSchema: {},
+        handler: (client) => client.procurement.listTenders(),
+    }),
+    tool({
+        name: "procurement_list_public_tenders",
+        description: "List published public tenders available to bid on (supplier side).",
+        inputSchema: {},
+        handler: (client) => client.procurement.listPublicTenders(),
+    }),
+    tool({
+        name: "procurement_list_suppliers",
+        description: "List registered suppliers.",
+        inputSchema: {},
+        handler: (client) => client.procurement.listSuppliers(),
+    }),
+    // ── Inventory ──────────────────────────────────────────────────────────
+    tool({
+        name: "inventory_list_items",
+        description: "List inventory items with stock levels.",
+        inputSchema: {},
+        handler: (client) => client.inventory.listItems(),
+    }),
+    tool({
+        name: "inventory_low_stock",
+        description: "List inventory items at or below their low-stock threshold.",
+        inputSchema: {},
+        handler: (client) => client.inventory.getLowStockItems(),
+    }),
+    // ── ISMS (risk / controls) ─────────────────────────────────────────────
+    tool({
+        name: "isms_list_risks",
+        description: "List the ISMS risk register.",
+        inputSchema: {},
+        handler: (client) => client.isms.listRisks(),
+    }),
+    tool({
+        name: "isms_list_controls",
+        description: "List ISMS controls and their implementation status.",
+        inputSchema: {},
+        handler: (client) => client.isms.listControls(),
+    }),
+    // ── Invoicing ──────────────────────────────────────────────────────────
+    tool({
+        name: "invoicing_list_invoices",
+        description: "List invoices.",
+        inputSchema: {},
+        handler: (client) => client.invoicing.listInvoices(),
+    }),
+    tool({
+        name: "invoicing_list_clients",
+        description: "List invoicing clients.",
+        inputSchema: {},
+        handler: (client) => client.invoicing.listClients(),
+    }),
+    // ── Messages ───────────────────────────────────────────────────────────
+    tool({
+        name: "messages_list",
+        description: "List the current user's messages/notifications.",
+        inputSchema: {},
+        handler: (client) => client.messages.list(),
+    }),
+];
+//# sourceMappingURL=reads.js.map

package/dist/mcp/tools/reads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reads.js","sourceRoot":"","sources":["../../../src/mcp/tools/reads.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "@datar-platform/cli",
+  "version": "0.1.0-alpha.0",
+  "private": false,
+  "type": "module",
+  "description": "Datar CLI and MCP server — connect any AI harness (Claude Code, etc.) to a Datar org via an API token. Read + discovery in v1.",
+  "keywords": [
+    "datar",
+    "cli",
+    "mcp",
+    "model-context-protocol",
+    "ai",
+    "agents"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/joesome-Web-Services/datar-turbo.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://datar.co.za",
+  "bin": {
+    "datar": "dist/index.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./mcp": {
+      "types": "./dist/mcp/server.d.ts",
+      "default": "./dist/mcp/server.js"
+    },
+    "./mcp/tools": {
+      "types": "./dist/mcp/tools/index.d.ts",
+      "default": "./dist/mcp/tools/index.js"
+    },
+    "./mcp/registry": {
+      "types": "./dist/mcp/registry.d.ts",
+      "default": "./dist/mcp/registry.js"
+    },
+    "./config": {
+      "types": "./dist/config.d.ts",
+      "default": "./dist/config.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "zod": "^4.1.12",
+    "@datar-platform/sdk": "0.3.0-alpha.3"
+  },
+  "devDependencies": {
+    "@types/node": "^22.18.12",
+    "typescript": "^5.9.3",
+    "vitest": "^2.1.8",
+    "@joesome-web-services/tsconfig": "0.2.11"
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "git clean -xdf .cache .turbo dist node_modules",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "typecheck": "tsgo --noEmit --emitDeclarationOnly false"
+  }
+}