@clampd/sdk 0.5.1 → 0.5.2

package/dist/langchain.d.ts

@@ -0,0 +1,30 @@
+/**
+ * LangChain.js adapter for Clampd.
+ *
+ * Routes tool calls through the Clampd proxy so every LLM-initiated
+ * action is classified, policy-checked, scoped, and audit-logged.
+ *
+ * Requires @langchain/core as a peer dependency.
+ */
+import { ClampdClient } from "./client.js";
+export interface ClampdDatabaseToolOptions {
+    client: ClampdClient;
+    targetUrl?: string;
+}
+/**
+ * Create a LangChain DynamicStructuredTool that proxies database
+ * queries through the Clampd 9-stage security pipeline.
+ *
+ * ```ts
+ * const tool = await createClampdDatabaseTool({ client });
+ * const result = await tool.invoke({ query: "SELECT 1" });
+ * ```
+ */
+export declare function createClampdDatabaseTool(opts: ClampdDatabaseToolOptions): Promise<import("@langchain/core/tools").DynamicStructuredTool<import("zod").ZodObject<{
+    query: import("zod").ZodString;
+}, import("zod/v4/core").$strip>, {
+    query: string;
+}, {
+    query: string;
+}, string, unknown, "database.query">>;
+//# sourceMappingURL=langchain.d.ts.map

package/dist/langchain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"langchain.d.ts","sourceRoot":"","sources":["../src/langchain.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAsB,MAAM,aAAa,CAAC;AAiC/D,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,YAAY,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID;;;;;;;;GAQG;AACH,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,yBAAyB;;;WAeI,MAAM;;;uCAwB1C"}

package/dist/langchain.js

@@ -0,0 +1,66 @@
+/**
+ * LangChain.js adapter for Clampd.
+ *
+ * Routes tool calls through the Clampd proxy so every LLM-initiated
+ * action is classified, policy-checked, scoped, and audit-logged.
+ *
+ * Requires @langchain/core as a peer dependency.
+ */
+// ── Lazy imports with helpful errors ───────────────────────────────
+async function loadDeps() {
+    let DynamicStructuredTool;
+    let z;
+    try {
+        const toolsMod = await import("@langchain/core/tools");
+        DynamicStructuredTool = toolsMod.DynamicStructuredTool;
+    }
+    catch {
+        throw new Error("@langchain/core is required for the LangChain adapter. " +
+            "Install with: npm install @langchain/core");
+    }
+    try {
+        const zodMod = await import("zod");
+        z = zodMod.z;
+    }
+    catch {
+        throw new Error("zod is required for the LangChain adapter. " +
+            "Install with: npm install zod");
+    }
+    return { DynamicStructuredTool, z };
+}
+// ── Factory ────────────────────────────────────────────────────────
+/**
+ * Create a LangChain DynamicStructuredTool that proxies database
+ * queries through the Clampd 9-stage security pipeline.
+ *
+ * ```ts
+ * const tool = await createClampdDatabaseTool({ client });
+ * const result = await tool.invoke({ query: "SELECT 1" });
+ * ```
+ */
+export async function createClampdDatabaseTool(opts) {
+    const { DynamicStructuredTool, z } = await loadDeps();
+    const targetUrl = opts.targetUrl ?? "http://mock-tool:5555";
+    const schema = z.object({
+        query: z.string().describe("SQL query to execute"),
+    });
+    return new DynamicStructuredTool({
+        name: "database.query",
+        description: "Execute a SQL query against the database. " +
+            "The query is security-scanned before execution.",
+        schema,
+        func: async ({ query }) => {
+            const result = await opts.client.proxy("database.query", { query }, targetUrl, `Agent executing SQL: ${query.slice(0, 200)}`);
+            if (!result.allowed) {
+                return (`BLOCKED: ${result.denial_reason} ` +
+                    `(risk_score=${result.risk_score.toFixed(2)}, ` +
+                    `latency=${result.latency_ms}ms)`);
+            }
+            return (`ALLOWED: ${JSON.stringify(result.tool_response)} ` +
+                `(risk_score=${result.risk_score.toFixed(2)}, ` +
+                `scope=${result.scope_granted}, ` +
+                `latency=${result.latency_ms}ms)`);
+        },
+    });
+}
+//# sourceMappingURL=langchain.js.map

package/dist/langchain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"langchain.js","sourceRoot":"","sources":["../src/langchain.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,sEAAsE;AAEtE,KAAK,UAAU,QAAQ;IACrB,IAAI,qBAAmF,CAAC;IACxF,IAAI,CAAyB,CAAC;IAE9B,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;QACvD,qBAAqB,GAAG,QAAQ,CAAC,qBAAqB,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,yDAAyD;YACvD,2CAA2C,CAC9C,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;IACf,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,6CAA6C;YAC3C,+BAA+B,CAClC,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,qBAAqB,EAAE,CAAC,EAAE,CAAC;AACtC,CAAC;AASD,sEAAsE;AAEtE;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,IAA+B;IAE/B,MAAM,EAAE,qBAAqB,EAAE,CAAC,EAAE,GAAG,MAAM,QAAQ,EAAE,CAAC;IACtD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,uBAAuB,CAAC;IAE5D,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;QACtB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;KACnD,CAAC,CAAC;IAEH,OAAO,IAAI,qBAAqB,CAAC;QAC/B,IAAI,EAAE,gBAAgB;QACtB,WAAW,EACT,4CAA4C;YAC5C,iDAAiD;QACnD,MAAM;QACN,IAAI,EAAE,KAAK,EAAE,EAAE,KAAK,EAAqB,EAAmB,EAAE;YAC5D,MAAM,MAAM,GAAkB,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CACnD,gBAAgB,EAChB,EAAE,KAAK,EAAE,EACT,SAAS,EACT,wBAAwB,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAC9C,CAAC;YAEF,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,OAAO,CACL,YAAY,MAAM,CAAC,aAAa,GAAG;oBACnC,eAAe,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;oBAC/C,WAAW,MAAM,CAAC,UAAU,KAAK,CAClC,CAAC;YACJ,CAAC;YAED,OAAO,CACL,YAAY,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG;gBACnD,eAAe,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;gBAC/C,SAAS,MAAM,CAAC,aAAa,IAAI;gBACjC,WAAW,MAAM,CAAC,UAAU,KAAK,CAClC,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clampd/sdk",
-  "version": "0.5.1",
+  "version": "0.5.2",
   "description": "Runtime security SDK for AI agents — guard tool calls in 1 line",
   "type": "module",
   "main": "./dist/index.js",
@@ -10,6 +10,10 @@
       "import": "./dist/index.js",
       "require": "./dist/index.cjs",
       "types": "./dist/index.d.ts"
+    },
+    "./langchain": {
+      "import": "./dist/langchain.js",
+      "types": "./dist/langchain.d.ts"
     }
   },
   "files": [
@@ -45,9 +49,11 @@
     "node": ">=18.0.0"
   },
   "devDependencies": {
+    "@langchain/core": "^1.1.35",
     "@types/node": "^20.14.0",
     "typescript": "^5.9.3",
-    "vitest": "^3.2.4"
+    "vitest": "^3.2.4",
+    "zod": "^4.3.6"
   },
   "peerDependencies": {
     "@langchain/core": ">=0.2.0"