@arbium/enterprise-agent-connect 0.1.1 → 0.1.2-dev.9022f22

package/dist/connectors/sql/engines.js

@@ -0,0 +1,292 @@
+import { createRequire } from "node:module";
+import postgres from "postgres";
+export const DEFAULT_PORT = { postgres: 5432, sqlserver: 1433, mysql: 3306, oracle: 1521 };
+// The module imported for each engine; its package is the part before any "/".
+export const DRIVER = { sqlserver: "mssql", mysql: "mysql2/promise", oracle: "oracledb" };
+const POOL_MAX = 3;
+const IDLE_SECONDS = 60;
+const CONNECT_SECONDS = 10;
+/** Splits on :name, skipping quoted text, comments and casts (::type). */
+export function parseStatement(sql) {
+    const parts = [];
+    const names = [];
+    let start = 0;
+    let i = 0;
+    while (i < sql.length) {
+        const c = sql[i];
+        const close = c === "'" || c === '"' || c === "`"
+            ? c
+            : sql.startsWith("--", i)
+                ? "\n"
+                : sql.startsWith("/*", i)
+                    ? "*/"
+                    : null;
+        if (close) {
+            const end = sql.indexOf(close, i + (close.length === 2 ? 2 : 1));
+            i = end < 0 ? sql.length : end + close.length;
+            continue;
+        }
+        const name = c === ":" && sql[i - 1] !== ":" && /^:([a-z][a-z0-9_]*)/.exec(sql.slice(i));
+        if (name) {
+            parts.push(sql.slice(start, i));
+            names.push(name[1]);
+            i += name[0].length;
+            start = i;
+            continue;
+        }
+        i++;
+    }
+    parts.push(sql.slice(start));
+    return { parts, names };
+}
+const render = (s, placeholder) => s.parts.reduce((out, part, i) => out + placeholder(s.names[i - 1], i - 1) + part);
+/** Throws when the engine's driver is not installed, naming what to install. */
+export function assertDriver(engine, app, resolve = createRequire(import.meta.url).resolve) {
+    if (engine === "postgres")
+        return;
+    try {
+        resolve(DRIVER[engine]);
+    }
+    catch {
+        throw new Error(`${app} reaches ${engine}, whose driver is not installed: npm install ${DRIVER[engine].split("/")[0]}`);
+    }
+}
+const load = (name) => import(name).then((m) => m.default ?? m);
+export async function openEngine(engine, target, driver) {
+    if (engine === "postgres")
+        return pgEngine(target, driver ?? postgres);
+    const loaded = driver ?? (await load(DRIVER[engine]));
+    if (engine === "sqlserver")
+        return sqlServerEngine(target, loaded);
+    if (engine === "mysql")
+        return mySqlEngine(target, loaded);
+    return oracleEngine(target, loaded);
+}
+// Rolls a read back, whatever it did.
+class Rollback extends Error {
+}
+export function pgEngine(t, pg) {
+    const sql = pg({
+        host: t.host,
+        port: t.port,
+        database: t.database,
+        username: t.user,
+        password: t.password,
+        ssl: t.tls === "off" ? false : { rejectUnauthorized: t.tls === "verify", servername: t.host },
+        max: POOL_MAX,
+        idle_timeout: IDLE_SECONDS,
+        connect_timeout: CONNECT_SECONDS,
+        onnotice: () => { },
+    });
+    return {
+        async run({ statement, values, write, maxRows, timeoutMs, check }) {
+            const order = [...new Set(statement.names)];
+            const text = render(statement, (name) => `$${order.indexOf(name) + 1}`);
+            const params = order.map((n) => values[n]);
+            let out;
+            await sql
+                .begin(write ? "read write" : "read only", async (tx) => {
+                await tx.unsafe(`set local statement_timeout = ${Math.floor(timeoutMs)}`);
+                if (write) {
+                    const result = await tx.unsafe(text, params);
+                    out = { rows: [...result], rowsAffected: result.count ?? null };
+                }
+                else {
+                    let rows = [];
+                    // A cursor stops the server after maxRows + 1 rows.
+                    for await (const batch of tx.unsafe(text, params).cursor(maxRows + 1)) {
+                        rows = batch;
+                        break;
+                    }
+                    out = { rows, rowsAffected: null };
+                }
+                check(out);
+                if (!write)
+                    throw new Rollback();
+            })
+                .catch((error) => {
+                if (!(error instanceof Rollback))
+                    throw error;
+            });
+            return out;
+        },
+        async version() {
+            const [row] = await sql `select version() as v`;
+            return String(row.v);
+        },
+        close: () => sql.end(),
+    };
+}
+export function sqlServerEngine(t, mssql) {
+    const pool = new mssql.ConnectionPool({
+        server: t.host,
+        port: t.port,
+        database: t.database,
+        user: t.user,
+        password: t.password,
+        pool: { max: POOL_MAX, min: 0, idleTimeoutMillis: IDLE_SECONDS * 1000 },
+        connectionTimeout: CONNECT_SECONDS * 1000,
+        options: {
+            encrypt: t.tls !== "off",
+            trustServerCertificate: t.tls === "insecure",
+            readOnlyIntent: t.readOnly,
+        },
+    });
+    // Connected on first use, and again on the next call after a failed attempt.
+    let connecting = null;
+    const connected = () => (connecting ??= pool.connect().catch((error) => {
+        connecting = null;
+        throw error;
+    }));
+    return {
+        async run({ statement, values, write, maxRows, timeoutMs, check }) {
+            await connected();
+            const tx = new mssql.Transaction(pool);
+            await tx.begin();
+            try {
+                const request = new mssql.Request(tx, { requestTimeout: timeoutMs });
+                for (const name of new Set(statement.names))
+                    request.input(name, values[name]);
+                // ROWCOUNT stops a read after maxRows + 1 rows; a write is never cut short.
+                const text = render(statement, (name) => `@${name}`);
+                const result = await request.query(write ? text : `set rowcount ${maxRows + 1};\n${text}`);
+                const out = {
+                    rows: (result.recordset ?? []),
+                    rowsAffected: write ? result.rowsAffected.reduce((a, b) => a + b, 0) : null,
+                };
+                check(out);
+                await (write ? tx.commit() : tx.rollback());
+                return out;
+            }
+            catch (error) {
+                // The server may already have rolled it back (e.g. after a timeout).
+                await tx.rollback().catch(() => { });
+                throw error;
+            }
+        },
+        async version() {
+            await connected();
+            const result = await pool.request().query("select @@version as v");
+            return String(result.recordset[0].v).split("\n")[0];
+        },
+        close: () => pool.close(),
+    };
+}
+export function mySqlEngine(t, mysql) {
+    const pool = mysql.createPool({
+        host: t.host,
+        port: t.port,
+        database: t.database,
+        user: t.user,
+        password: t.password,
+        ssl: t.tls === "off" ? undefined : { rejectUnauthorized: t.tls === "verify" },
+        connectionLimit: POOL_MAX,
+        maxIdle: 0,
+        idleTimeout: IDLE_SECONDS * 1000,
+        connectTimeout: CONNECT_SECONDS * 1000,
+        supportBigNumbers: true,
+        bigNumberStrings: true,
+    });
+    return {
+        async run({ statement, values, write, maxRows, timeoutMs, check }) {
+            const conn = await pool.getConnection();
+            try {
+                // Session settings outlive the call on a pooled connection, so each call sets its own.
+                await conn.query(`set session sql_select_limit = ${write ? "default" : maxRows + 1}`);
+                await conn.query(`start transaction ${write ? "read write" : "read only"}`);
+                try {
+                    // execute: a server-side prepared statement, the values never in the text.
+                    const [result] = await conn.execute({ sql: render(statement, () => "?"), timeout: timeoutMs }, statement.names.map((n) => values[n] ?? null));
+                    const out = Array.isArray(result)
+                        ? { rows: result, rowsAffected: null }
+                        : { rows: [], rowsAffected: write ? result.affectedRows : null };
+                    check(out);
+                    await conn.query(write ? "commit" : "rollback");
+                    return out;
+                }
+                catch (error) {
+                    await conn.query("rollback").catch(() => { });
+                    throw error;
+                }
+            }
+            finally {
+                conn.release();
+            }
+        },
+        async version() {
+            const [rows] = await pool.query("select version() as v");
+            return String(rows[0].v);
+        },
+        close: () => pool.end(),
+    };
+}
+export function oracleEngine(t, oracledb) {
+    const options = {
+        user: t.user,
+        password: t.password,
+        connectString: `${t.tls === "verify" ? "tcps://" : ""}${t.host}:${t.port}/${t.database}`,
+        sslServerDNMatch: t.tls === "verify",
+        poolMin: 0,
+        poolMax: POOL_MAX,
+        poolIncrement: 1,
+        poolTimeout: IDLE_SECONDS,
+        connectTimeout: CONNECT_SECONDS,
+    };
+    let pool = null;
+    // Large text and binary columns as values, not LOB handles.
+    const fetchTypeHandler = (meta) => meta.dbType === oracledb.DB_TYPE_CLOB || meta.dbType === oracledb.DB_TYPE_NCLOB
+        ? { type: oracledb.STRING }
+        : meta.dbType === oracledb.DB_TYPE_BLOB
+            ? { type: oracledb.BUFFER }
+            : undefined;
+    const connection = async () => {
+        pool ??= oracledb.createPool(options).catch((error) => {
+            pool = null;
+            throw error;
+        });
+        return (await pool).getConnection();
+    };
+    return {
+        async run({ statement, values, write, maxRows, timeoutMs, check }) {
+            const conn = await connection();
+            try {
+                conn.callTimeout = timeoutMs;
+                if (!write)
+                    await conn.execute("set transaction read only");
+                const binds = Object.fromEntries([...new Set(statement.names)].map((n) => [n, values[n]]));
+                const result = await conn.execute(render(statement, (name) => `:${name}`), binds, {
+                    outFormat: oracledb.OUT_FORMAT_OBJECT,
+                    maxRows: write ? 0 : maxRows + 1,
+                    autoCommit: false,
+                    fetchTypeHandler,
+                });
+                const out = {
+                    rows: (result.rows ?? []),
+                    rowsAffected: write ? (result.rowsAffected ?? 0) : null,
+                };
+                check(out);
+                await (write ? conn.commit() : conn.rollback());
+                return out;
+            }
+            catch (error) {
+                await conn.rollback().catch(() => { });
+                throw error;
+            }
+            finally {
+                await conn.close();
+            }
+        },
+        async version() {
+            const conn = await connection();
+            try {
+                await conn.execute("select 1 from dual");
+                return `Oracle ${conn.oracleServerVersionString}`;
+            }
+            finally {
+                await conn.close();
+            }
+        },
+        close: async () => (await pool)?.close(0),
+    };
+}
+//# sourceMappingURL=engines.js.map

package/dist/connectors/sql/engines.js.map

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

package/dist/connectors/sql/index.d.ts

@@ -0,0 +1,16 @@
+import { type Toolset } from "../../packages/connector-kit/src/common.js";
+import type { Connector, SqlApp } from "../../packages/connector-kit/src/connector.js";
+import { type Vendor } from "../../packages/connector-kit/src/types.js";
+import { openEngine } from "./engines.js";
+export declare const MAX_ANSWER_BYTES: number;
+export declare function sqlVendor(connector: Connector, open?: typeof openEngine): Vendor;
+export declare function sqlTools(app: SqlApp): Toolset;
+/** Binds to any connector with an `sql` block; createAgentConnect uses it for those. */
+declare const _default: {
+    id: string;
+    create: ({ connector }: import("../../packages/connector-kit/src/connector.js").ConnectorContext) => {
+        vendor: Vendor;
+        toolset: Toolset;
+    };
+};
+export default _default;

package/dist/connectors/sql/index.js

@@ -0,0 +1,214 @@
+import { createHash } from "node:crypto";
+import { z } from "zod";
+import { audited, Denied, json, listLimit, VendorFailed, } from "../../packages/connector-kit/src/common.js";
+import { ConnectError, } from "../../packages/connector-kit/src/types.js";
+import { assertDriver, DEFAULT_PORT, openEngine, parseStatement, } from "./engines.js";
+// The generic module behind every connector.json with an `sql` block: an app reached as a
+// database. Each tool runs the one statement its definition holds, with the agent's values
+// bound as params.
+export const MAX_ANSWER_BYTES = 1024 * 1024;
+const message = (error) => (error instanceof Error ? error.message : String(error));
+export function sqlVendor(connector, open = openEngine) {
+    const app = connector.sql;
+    const port = app.port ?? DEFAULT_PORT[app.engine];
+    const tools = new Map(app.tools.map((t) => [t.name, { ...t, statement: parseStatement(t.sql) }]));
+    // ponytail: a pool per credential, never closed; an old one only idles at 0 connections.
+    const pools = new Map();
+    function engine(c, write) {
+        const target = {
+            host: app.host,
+            port,
+            database: app.database,
+            user: c.config[app.auth.user],
+            password: c.secret[app.auth.password],
+            tls: app.tls,
+            // Only SQL Server opens a read-only connection; elsewhere one pool serves both.
+            readOnly: app.engine === "sqlserver" && !write,
+        };
+        const key = createHash("sha256")
+            .update(JSON.stringify([target.user, target.password, target.readOnly]))
+            .digest("hex");
+        let pool = pools.get(key);
+        if (!pool) {
+            pool = open(app.engine, target);
+            pools.set(key, pool);
+            pool.catch(() => pools.delete(key));
+        }
+        return pool;
+    }
+    return {
+        async connect(fields) {
+            const config = {
+                host: `${app.host}:${port}/${app.database}`,
+            };
+            const secret = {};
+            for (const f of connector.fields) {
+                const value = fields[f.id]?.trim() ?? "";
+                if (!value && f.optional)
+                    continue;
+                if (!value)
+                    throw new ConnectError(`Enter ${f.label}`);
+                (f.secret ? secret : config)[f.id] = value;
+            }
+            return { config, secret, accountLabel: config[connector.accountKey] ?? config.host };
+        },
+        async call(c, request) {
+            const tool = tools.get(request.path.slice(1));
+            if (!tool)
+                throw new Error(`${connector.id} has no query ${request.path}`);
+            const { values, answerLimits } = request.body;
+            try {
+                const out = await (await engine(c, tool.write)).run({
+                    statement: tool.statement,
+                    values,
+                    write: tool.write,
+                    maxRows: app.maxRows,
+                    timeoutMs: app.timeoutSeconds * 1000,
+                    check: ({ rows, rowsAffected }) => {
+                        if (!answerLimits.length)
+                            return;
+                        const undone = tool.write ? "; nothing was changed" : "";
+                        // A change returning fewer rows than it made cannot be checked: refused.
+                        if (rows.length < (rowsAffected ?? 0))
+                            throw new Denied(`This change cannot be checked against this agent's limits${undone}`);
+                        for (const a of answerLimits)
+                            if (!rows.every((row) => within(row, a.column, a.values)))
+                                throw new Denied(`The answer's ${a.column} is outside this agent's limits${undone}`);
+                    },
+                });
+                return { status: 200, data: out };
+            }
+            catch (error) {
+                if (error instanceof Denied)
+                    throw error;
+                throw new ConnectError(`The database refused the call: ${message(error)}`);
+            }
+        },
+        checks: {
+            // A trivial query proving the address, the sign-in and the database name.
+            async database(c) {
+                try {
+                    return { values: [await (await engine(c, false)).version()] };
+                }
+                catch (error) {
+                    throw new ConnectError(`Could not reach the database: ${message(error)}`);
+                }
+            },
+        },
+    };
+}
+function within(row, column, values) {
+    if (!Object.hasOwn(row, column))
+        return false;
+    const v = row[column];
+    return ((typeof v === "string" || typeof v === "number" || typeof v === "bigint") &&
+        values.includes(String(v)));
+}
+// Values JSON can carry: dates as ISO text, bytes as base64, big integers as text.
+function plain(v) {
+    if (v instanceof Date)
+        return v.toISOString();
+    if (Buffer.isBuffer(v) || v instanceof Uint8Array)
+        return Buffer.from(v).toString("base64");
+    if (typeof v === "bigint")
+        return v.toString();
+    return v;
+}
+// The rows that fit in maxRows and MAX_ANSWER_BYTES, and whether any were left out.
+function trim(rows, maxRows) {
+    const out = [];
+    let size = 0;
+    for (const row of rows.slice(0, maxRows)) {
+        const clean = Object.fromEntries(Object.entries(row).map(([k, v]) => [k, plain(v)]));
+        size += Buffer.byteLength(JSON.stringify(clean));
+        if (size > MAX_ANSWER_BYTES)
+            break;
+        out.push(clean);
+    }
+    return { rows: out, truncated: out.length < rows.length };
+}
+const zodType = {
+    string: z.string(),
+    number: z.number(),
+    integer: z.number().int(),
+    boolean: z.boolean(),
+};
+export function sqlTools(app) {
+    return {
+        names: app.tools.map((t) => t.name),
+        register(server, ctx, allowed) {
+            for (const tool of app.tools) {
+                if (!allowed.has(tool.name))
+                    continue;
+                const shape = Object.fromEntries(Object.entries(tool.params).map(([name, p]) => {
+                    const type = zodType[p.type].describe(p.description);
+                    return [name, p.required ? type : type.optional()];
+                }));
+                server.registerTool(tool.name, {
+                    description: tool.description,
+                    inputSchema: z.object(shape).strict(),
+                    annotations: {
+                        readOnlyHint: !tool.write,
+                        destructiveHint: tool.destructive,
+                        openWorldHint: false,
+                    },
+                }, (args) => audited(ctx, tool.name, JSON.stringify(args).slice(0, 300), async (mark) => {
+                    for (const [name, p] of Object.entries(tool.params)) {
+                        const allowedValues = p.limit ? listLimit(ctx.limits, p.limit) : null;
+                        if (!allowedValues)
+                            continue;
+                        // Left out, an optional param would be null, which often means "all of them".
+                        if (args[name] === undefined)
+                            throw new Denied(`${name} is required: this agent is limited to some values`);
+                        if (!allowedValues.includes(String(args[name])))
+                            throw new Denied(`${name} ${String(args[name])} is outside this agent's limits`);
+                    }
+                    const call = {
+                        values: Object.fromEntries(Object.keys(tool.params).map((name) => [name, args[name] ?? null])),
+                        answerLimits: tool.answerLimits.flatMap((a) => {
+                            const values = listLimit(ctx.limits, a.limit);
+                            return values ? [{ column: a.column, values }] : [];
+                        }),
+                    };
+                    let res;
+                    try {
+                        res = await ctx.call({ method: "POST", path: `/${tool.name}`, body: call });
+                    }
+                    catch (error) {
+                        if (error instanceof ConnectError)
+                            throw new VendorFailed(502, error.message);
+                        throw error;
+                    }
+                    mark(res.status);
+                    const { rows, rowsAffected } = res.data;
+                    const answer = trim(rows, app.maxRows);
+                    return json({
+                        ...(tool.write ? { rows_affected: rowsAffected } : {}),
+                        ...answer,
+                        ...(answer.truncated
+                            ? { note: `More rows matched than the ${answer.rows.length} returned` }
+                            : {}),
+                    });
+                }));
+            }
+        },
+    };
+}
+/** Binds to any connector with an `sql` block; createAgentConnect uses it for those. */
+export default {
+    id: "sql",
+    create: ({ connector }) => {
+        const app = connector.sql;
+        assertDriver(app.engine, connector.id);
+        if (app.engine === "oracle" && app.tls === "insecure")
+            throw new Error(`${connector.id}: Oracle checks the server's certificate whenever TLS is on: use verify or off`);
+        for (const tool of app.tools) {
+            const used = new Set(parseStatement(tool.sql).names);
+            const declared = Object.keys(tool.params);
+            if (used.size !== declared.length || declared.some((n) => !used.has(n)))
+                throw new Error(`${connector.id}: ${tool.name} declares params ${declared.join(", ") || "none"} but its sql uses ${[...used].map((n) => `:${n}`).join(", ") || "none"}`);
+        }
+        return { vendor: sqlVendor(connector), toolset: sqlTools(app) };
+    },
+};
+//# sourceMappingURL=index.js.map

package/dist/connectors/sql/index.js.map

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

package/dist/connectors/teams/index.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("../microsoft/client.js").BuiltinModule;
+export default _default;

package/dist/connectors/teams/tools.d.ts

@@ -0,0 +1,7 @@
+import { type TeamsAccess } from "../../packages/server/src/teams/runtime.js";
+import { type ToolContext, type Toolset } from "../../packages/connector-kit/src/common.js";
+/** The service gives Teams tools the agent's own bot beside the usual context. */
+export type TeamsToolContext = ToolContext & {
+    teams?: TeamsAccess;
+};
+export declare const teamsTools: Toolset;

package/dist/connectors/teams/tools.js

@@ -12,9 +12,10 @@ const CHAT = /^(19:[A-Za-z0-9_.-]+@(thread\.v2|unq\.gbl\.spaces)|a:[A-Za-z0-9_.-
 const MESSAGE = /^\d{1,20}$/;
 const MAX_TEXT = 20_000;
 function access(ctx) {
-    if (!ctx.teams)
+    const { teams } = ctx;
+    if (!teams)
         throw new Error("Teams tools need the agent's bot");
-    return ctx.teams;
+    return teams;
 }
 const teamsLimit = (ctx) => listLimit(ctx.limits, "teams");
 const channelsLimit = (ctx) => listLimit(ctx.limits, "channels");