@passport-agent/langchain 0.0.1

package/dist/__tests__/wrapper.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=wrapper.test.d.ts.map

package/dist/__tests__/wrapper.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrapper.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/wrapper.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/wrapper.test.js

@@ -0,0 +1,89 @@
+import { describe, it, expect, vi } from 'vitest';
+import { PassportIssuer } from '@passport-agent/core';
+import { withPassport, createPassportToolkit } from '../wrapper.js';
+describe('LangChain Integration', () => {
+    function setup() {
+        const issuer = new PassportIssuer();
+        const passport = issuer.issue({
+            principal: 'user:alice@test.com',
+            agent: 'agent:langchain-bot',
+            permissions: ['tool:search', 'tool:read_file', 'tool:write_file'],
+            limits: { maxSpend: 200 },
+        });
+        return { issuer, passport };
+    }
+    const searchTool = {
+        name: 'search',
+        description: 'Search the web',
+        execute: async (args) => ({ results: [`result for ${args['query']}`] }),
+    };
+    const deleteTool = {
+        name: 'delete_db',
+        description: 'Delete database',
+        execute: async () => 'deleted',
+    };
+    describe('withPassport', () => {
+        it('allows permitted tool execution', async () => {
+            const { issuer, passport } = setup();
+            const wrapped = withPassport(searchTool, passport, { issuer });
+            const result = await wrapped.execute({ query: 'test' });
+            expect(result).toEqual({ results: ['result for test'] });
+        });
+        it('blocks unpermitted tools', async () => {
+            const { issuer, passport } = setup();
+            const wrapped = withPassport(deleteTool, passport, { issuer });
+            await expect(wrapped.execute({})).rejects.toThrow('denied');
+        });
+        it('preserves tool name and description', () => {
+            const { issuer, passport } = setup();
+            const wrapped = withPassport(searchTool, passport, { issuer });
+            expect(wrapped.name).toBe('search');
+            expect(wrapped.description).toBe('Search the web');
+        });
+        it('supports custom permission mapping', async () => {
+            const issuer = new PassportIssuer();
+            const passport = issuer.issue({
+                principal: 'user:bob@test.com',
+                agent: 'agent:bot',
+                permissions: ['web:search'],
+            });
+            const wrapped = withPassport(searchTool, passport, {
+                issuer,
+                permissionMapper: (name) => name === 'search' ? 'web:search' : `tool:${name}`,
+            });
+            const result = await wrapped.execute({ query: 'hi' });
+            expect(result).toEqual({ results: ['result for hi'] });
+        });
+        it('enforces spend limits via spendMapper', async () => {
+            const { issuer, passport } = setup();
+            const writeTool = {
+                name: 'write_file',
+                description: 'Write a file',
+                execute: async () => 'written',
+            };
+            const wrapped = withPassport(writeTool, passport, {
+                issuer,
+                spendMapper: (_name, args) => args['cost'] ?? 0,
+            });
+            await wrapped.execute({ cost: 150 });
+            await expect(wrapped.execute({ cost: 100 })).rejects.toThrow('denied');
+        });
+        it('calls onDenied callback', async () => {
+            const { issuer, passport } = setup();
+            const onDenied = vi.fn();
+            const wrapped = withPassport(deleteTool, passport, { issuer, onDenied });
+            await expect(wrapped.execute({})).rejects.toThrow();
+            expect(onDenied).toHaveBeenCalledWith('delete_db', expect.any(String));
+        });
+    });
+    describe('createPassportToolkit', () => {
+        it('wraps all tools with passport checks', async () => {
+            const { issuer, passport } = setup();
+            const tools = createPassportToolkit([searchTool, deleteTool], passport, { issuer });
+            expect(tools).toHaveLength(2);
+            await expect(tools[0].execute({ query: 'test' })).resolves.toBeTruthy();
+            await expect(tools[1].execute({})).rejects.toThrow('denied');
+        });
+    });
+});
+//# sourceMappingURL=wrapper.test.js.map

package/dist/__tests__/wrapper.test.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { withPassport, createPassportToolkit } from './wrapper.js';
+export type { PassportToolConfig, ToolDefinition, ToolResult } from './wrapper.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACnE,YAAY,EAAE,kBAAkB,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { withPassport, createPassportToolkit } from './wrapper.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC"}

package/dist/wrapper.d.ts

@@ -0,0 +1,22 @@
+import type { SignedPassport } from '@passport-agent/core';
+import { PassportIssuer } from '@passport-agent/core';
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    execute: (args: Record<string, unknown>) => unknown | Promise<unknown>;
+}
+export interface ToolResult {
+    name: string;
+    result?: unknown;
+    error?: string;
+    authorized: boolean;
+}
+export interface PassportToolConfig {
+    issuer: PassportIssuer;
+    permissionMapper?: (toolName: string) => string;
+    spendMapper?: (toolName: string, args: Record<string, unknown>) => number;
+    onDenied?: (toolName: string, reason: string) => void;
+}
+export declare function withPassport(tool: ToolDefinition, passport: SignedPassport, config: PassportToolConfig): ToolDefinition;
+export declare function createPassportToolkit(tools: ToolDefinition[], passport: SignedPassport, config: PassportToolConfig): ToolDefinition[];
+//# sourceMappingURL=wrapper.d.ts.map

package/dist/wrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrapper.d.ts","sourceRoot":"","sources":["../src/wrapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAmB,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACxE;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,cAAc,CAAC;IACvB,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;IAChD,WAAW,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC;IAC1E,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACvD;AAED,wBAAgB,YAAY,CAC1B,IAAI,EAAE,cAAc,EACpB,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,kBAAkB,GACzB,cAAc,CAqBhB;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,cAAc,EAAE,EACvB,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,kBAAkB,GACzB,cAAc,EAAE,CAElB"}

package/dist/wrapper.js

@@ -0,0 +1,23 @@
+export function withPassport(tool, passport, config) {
+    const mapPermission = config.permissionMapper ?? ((name) => `tool:${name}`);
+    const mapSpend = config.spendMapper ?? (() => 0);
+    return {
+        name: tool.name,
+        description: tool.description,
+        execute: async (args) => {
+            const permission = mapPermission(tool.name);
+            const spend = mapSpend(tool.name, args);
+            const authResult = config.issuer.authorize(passport, permission, spend);
+            if (!authResult.allowed) {
+                const msg = `Tool "${tool.name}" denied: ${authResult.reason}`;
+                config.onDenied?.(tool.name, authResult.reason ?? 'Unknown');
+                throw new Error(msg);
+            }
+            return tool.execute(args);
+        },
+    };
+}
+export function createPassportToolkit(tools, passport, config) {
+    return tools.map((tool) => withPassport(tool, passport, config));
+}
+//# sourceMappingURL=wrapper.js.map

package/dist/wrapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrapper.js","sourceRoot":"","sources":["../src/wrapper.ts"],"names":[],"mappings":"AAuBA,MAAM,UAAU,YAAY,CAC1B,IAAoB,EACpB,QAAwB,EACxB,MAA0B;IAE1B,MAAM,aAAa,GAAG,MAAM,CAAC,gBAAgB,IAAI,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;IACpF,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;IAEjD,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,OAAO,EAAE,KAAK,EAAE,IAA6B,EAAE,EAAE;YAC/C,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC5C,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACxC,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;YAExE,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;gBACxB,MAAM,GAAG,GAAG,SAAS,IAAI,CAAC,IAAI,aAAa,UAAU,CAAC,MAAM,EAAE,CAAC;gBAC/D,MAAM,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,MAAM,IAAI,SAAS,CAAC,CAAC;gBAC7D,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC;YACvB,CAAC;YAED,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,KAAuB,EACvB,QAAwB,EACxB,MAA0B;IAE1B,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;AACnE,CAAC"}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@passport-agent/langchain",
+  "version": "0.0.1",
+  "description": "LangChain integration for Agent Passport — wrap tools with passport authorization",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "lint": "tsc --noEmit"
+  },
+  "files": ["dist"],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/priyansh-x/passport-agent",
+    "directory": "packages/langchain"
+  },
+  "dependencies": {
+    "@passport-agent/core": "workspace:*"
+  },
+  "devDependencies": {
+    "vitest": "^3.0.0"
+  }
+}