@armoriq/sdk-dev 0.2.15 → 0.3.0

package/dist/config.js

@@ -0,0 +1,215 @@
+"use strict";
+/**
+ * armoriq.yaml configuration models and loader.
+ *
+ * Mirrors armoriq_sdk/config.py shape so the same file is portable
+ * between the two SDKs.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArmorIQConfigError = exports.DEFAULT_PROXY_URL = void 0;
+exports.resolveEnvReference = resolveEnvReference;
+exports.parseArmorIQConfig = parseArmorIQConfig;
+exports.loadArmorIQConfig = loadArmorIQConfig;
+exports.resolveEnvReferences = resolveEnvReferences;
+exports.saveArmorIQConfig = saveArmorIQConfig;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const yaml = __importStar(require("js-yaml"));
+exports.DEFAULT_PROXY_URL = 'https://customer-proxy.armoriq.ai';
+class ArmorIQConfigError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ArmorIQConfigError';
+    }
+}
+exports.ArmorIQConfigError = ArmorIQConfigError;
+/**
+ * Resolve `$ENV_VAR` or `${ENV_VAR}` references against process.env.
+ * Returns the original string when it is not an env reference.
+ */
+function resolveEnvReference(value) {
+    if (typeof value !== 'string')
+        return value;
+    if (value.startsWith('${') && value.endsWith('}')) {
+        return process.env[value.slice(2, -1)] ?? '';
+    }
+    if (value.startsWith('$') && value.length > 1 && !value.includes(' ')) {
+        return process.env[value.slice(1)] ?? '';
+    }
+    return value;
+}
+function normalizeAuth(value) {
+    if (value === null || value === undefined)
+        return { type: 'none' };
+    if (typeof value === 'string')
+        return { type: value };
+    return value;
+}
+function validateIdentity(raw) {
+    if (!raw || typeof raw !== 'object') {
+        throw new ArmorIQConfigError('identity is required');
+    }
+    for (const k of ['api_key', 'user_id', 'agent_id']) {
+        if (typeof raw[k] !== 'string' || !raw[k]) {
+            throw new ArmorIQConfigError(`identity.${k} is required`);
+        }
+    }
+    return { api_key: raw.api_key, user_id: raw.user_id, agent_id: raw.agent_id };
+}
+function validateAuth(raw) {
+    const a = normalizeAuth(raw);
+    if (a.type === 'bearer' && !a.token) {
+        throw new ArmorIQConfigError("bearer auth requires 'token'");
+    }
+    if (a.type === 'api_key' && !a.api_key) {
+        throw new ArmorIQConfigError("api_key auth requires 'api_key'");
+    }
+    if (a.type !== 'bearer' && a.type !== 'api_key' && a.type !== 'none') {
+        throw new ArmorIQConfigError(`unknown auth type: ${a.type}`);
+    }
+    return a;
+}
+function parseArmorIQConfig(raw) {
+    if (!raw || typeof raw !== 'object') {
+        throw new ArmorIQConfigError('config root must be an object');
+    }
+    const version = raw.version ?? 'v1';
+    if (version !== 'v1') {
+        throw new ArmorIQConfigError(`unsupported config version: ${version}`);
+    }
+    const environment = raw.environment ?? 'sandbox';
+    if (environment !== 'sandbox' && environment !== 'production') {
+        throw new ArmorIQConfigError(`environment must be sandbox or production, got: ${environment}`);
+    }
+    const proxy = {
+        url: raw.proxy?.url ?? exports.DEFAULT_PROXY_URL,
+        timeout: raw.proxy?.timeout ?? 30,
+        max_retries: raw.proxy?.max_retries ?? 3,
+    };
+    const policy = {
+        allow: Array.isArray(raw.policy?.allow) ? raw.policy.allow : [],
+        deny: Array.isArray(raw.policy?.deny) ? raw.policy.deny : [],
+    };
+    const intent = {
+        ttl_seconds: raw.intent?.ttl_seconds ?? 300,
+        require_csrg: raw.intent?.require_csrg ?? true,
+    };
+    const mcpServersRaw = Array.isArray(raw.mcp_servers) ? raw.mcp_servers : [];
+    const mcpServers = mcpServersRaw.map((s, i) => {
+        if (!s.id || typeof s.id !== 'string') {
+            throw new ArmorIQConfigError(`mcp_servers[${i}].id is required`);
+        }
+        if (!s.url || typeof s.url !== 'string') {
+            throw new ArmorIQConfigError(`mcp_servers[${i}].url is required`);
+        }
+        return {
+            id: s.id,
+            url: s.url,
+            description: s.description,
+            auth: validateAuth(s.auth),
+        };
+    });
+    const ids = mcpServers.map((s) => s.id);
+    if (new Set(ids).size !== ids.length) {
+        throw new ArmorIQConfigError("mcp_servers contain duplicate 'id' values");
+    }
+    return {
+        version: 'v1',
+        identity: validateIdentity(raw.identity),
+        environment,
+        proxy,
+        mcp_servers: mcpServers,
+        policy,
+        intent,
+    };
+}
+function loadArmorIQConfig(filePath = 'armoriq.yaml') {
+    const resolved = path.resolve(filePath);
+    if (!fs.existsSync(resolved)) {
+        throw new ArmorIQConfigError(`Config file not found: ${resolved}`);
+    }
+    const raw = yaml.load(fs.readFileSync(resolved, 'utf-8')) ?? {};
+    return parseArmorIQConfig(raw);
+}
+/**
+ * Resolve every `$VAR` reference in the config against process.env.
+ * Returns a new config with the references replaced by their values.
+ */
+function resolveEnvReferences(config) {
+    return {
+        ...config,
+        identity: {
+            api_key: resolveEnvReference(config.identity.api_key),
+            user_id: resolveEnvReference(config.identity.user_id),
+            agent_id: resolveEnvReference(config.identity.agent_id),
+        },
+        mcp_servers: config.mcp_servers.map((s) => ({
+            ...s,
+            url: resolveEnvReference(s.url),
+            auth: s.auth.type === 'bearer'
+                ? { type: 'bearer', token: resolveEnvReference(s.auth.token ?? '') }
+                : s.auth.type === 'api_key'
+                    ? { type: 'api_key', api_key: resolveEnvReference(s.auth.api_key ?? '') }
+                    : s.auth,
+        })),
+    };
+}
+function saveArmorIQConfig(config, filePath = 'armoriq.yaml') {
+    const data = {
+        version: config.version,
+        identity: { ...config.identity },
+        environment: config.environment,
+        proxy: { ...config.proxy },
+        mcp_servers: config.mcp_servers.map((s) => {
+            const out = {
+                id: s.id,
+                url: s.url,
+                auth: s.auth.type === 'none'
+                    ? 'none'
+                    : s.auth.type === 'bearer'
+                        ? { type: 'bearer', token: s.auth.token }
+                        : { type: 'api_key', api_key: s.auth.api_key },
+            };
+            if (s.description)
+                out.description = s.description;
+            return out;
+        }),
+        policy: { allow: config.policy.allow, deny: config.policy.deny },
+        intent: { ttl_seconds: config.intent.ttl_seconds, require_csrg: config.intent.require_csrg },
+    };
+    fs.writeFileSync(filePath, yaml.dump(data, { sortKeys: false }), 'utf-8');
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/index.d.ts

@@ -8,10 +8,13 @@
  * @author ArmorIQ Team <license@armoriq.io>
  * @version 0.2.6
  */
-export { ArmorIQClient } from './client';
+export { ArmorIQClient, ArmorIQUserScope } from './client';
+export { ArmorIQSession, SessionOptions, SessionMode, EnforceResult, ReportOptions, } from './session';
 export { ArmorIQException, InvalidTokenException, IntentMismatchException, MCPInvocationException, TokenExpiredException, DelegationException, ConfigurationException, PolicyBlockedException, PolicyHoldException, } from './exceptions';
-export { IntentToken, PlanCapture, MCPInvocation, MCPInvocationResult, DelegationRequest, DelegationResult, SDKConfig, MCPSemanticMetadata, ToolSemanticEntry, PolicyContext, InvokeOptions, HoldInfo, DelegationRequestParams, DelegationRequestResult, ApprovedDelegation, } from './models';
-export declare const VERSION = "0.2.6";
+export { IntentToken, PlanCapture, MCPInvocation, MCPInvocationResult, DelegationRequest, DelegationResult, SDKConfig, MCPSemanticMetadata, ToolSemanticEntry, PolicyContext, InvokeOptions, HoldInfo, DelegationRequestParams, DelegationRequestResult, ApprovedDelegation, ToolCall, McpCredential, McpCredentialMap, } from './models';
+export { defaultToolNameParser, buildPlanFromToolCalls, hashToolCalls, ToolNameParser, PlanStep, BuiltPlan, } from './plan_builder';
+export { ArmorIQConfig, ArmorIQConfigError, IdentityConfig, ProxyConfig, MCPAuthConfig, MCPAuthType, MCPServerConfig, PolicyConfig, IntentConfig, Environment, loadArmorIQConfig, parseArmorIQConfig, resolveEnvReference, resolveEnvReferences, saveArmorIQConfig, DEFAULT_PROXY_URL, } from './config';
+export declare const VERSION = "0.3.0";
 export declare const AUTHOR = "ArmorIQ Team";
 export declare const EMAIL = "license@armoriq.io";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,WAAW,EACX,WAAW,EACX,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,SAAS,EACT,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,QAAQ,EACR,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,UAAU,CAAC;AAElB,eAAO,MAAM,OAAO,UAAU,CAAC;AAC/B,eAAO,MAAM,MAAM,iBAAiB,CAAC;AACrC,eAAO,MAAM,KAAK,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC3D,OAAO,EACL,cAAc,EACd,cAAc,EACd,WAAW,EACX,aAAa,EACb,aAAa,GACd,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,WAAW,EACX,WAAW,EACX,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,SAAS,EACT,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,QAAQ,EACR,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,EAClB,QAAQ,EACR,aAAa,EACb,gBAAgB,GACjB,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,aAAa,EACb,cAAc,EACd,QAAQ,EACR,SAAS,GACV,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,WAAW,EACX,aAAa,EACb,WAAW,EACX,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,UAAU,CAAC;AAElB,eAAO,MAAM,OAAO,UAAU,CAAC;AAC/B,eAAO,MAAM,MAAM,iBAAiB,CAAC;AACrC,eAAO,MAAM,KAAK,uBAAuB,CAAC"}

package/dist/index.js

@@ -10,9 +10,12 @@
  * @version 0.2.6
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EMAIL = exports.AUTHOR = exports.VERSION = exports.IntentToken = exports.PolicyHoldException = exports.PolicyBlockedException = exports.ConfigurationException = exports.DelegationException = exports.TokenExpiredException = exports.MCPInvocationException = exports.IntentMismatchException = exports.InvalidTokenException = exports.ArmorIQException = exports.ArmorIQClient = void 0;
+exports.EMAIL = exports.AUTHOR = exports.VERSION = exports.DEFAULT_PROXY_URL = exports.saveArmorIQConfig = exports.resolveEnvReferences = exports.resolveEnvReference = exports.parseArmorIQConfig = exports.loadArmorIQConfig = exports.ArmorIQConfigError = exports.hashToolCalls = exports.buildPlanFromToolCalls = exports.defaultToolNameParser = exports.IntentToken = exports.PolicyHoldException = exports.PolicyBlockedException = exports.ConfigurationException = exports.DelegationException = exports.TokenExpiredException = exports.MCPInvocationException = exports.IntentMismatchException = exports.InvalidTokenException = exports.ArmorIQException = exports.ArmorIQSession = exports.ArmorIQUserScope = exports.ArmorIQClient = void 0;
 var client_1 = require("./client");
 Object.defineProperty(exports, "ArmorIQClient", { enumerable: true, get: function () { return client_1.ArmorIQClient; } });
+Object.defineProperty(exports, "ArmorIQUserScope", { enumerable: true, get: function () { return client_1.ArmorIQUserScope; } });
+var session_1 = require("./session");
+Object.defineProperty(exports, "ArmorIQSession", { enumerable: true, get: function () { return session_1.ArmorIQSession; } });
 var exceptions_1 = require("./exceptions");
 Object.defineProperty(exports, "ArmorIQException", { enumerable: true, get: function () { return exceptions_1.ArmorIQException; } });
 Object.defineProperty(exports, "InvalidTokenException", { enumerable: true, get: function () { return exceptions_1.InvalidTokenException; } });
@@ -25,7 +28,19 @@ Object.defineProperty(exports, "PolicyBlockedException", { enumerable: true, get
 Object.defineProperty(exports, "PolicyHoldException", { enumerable: true, get: function () { return exceptions_1.PolicyHoldException; } });
 var models_1 = require("./models");
 Object.defineProperty(exports, "IntentToken", { enumerable: true, get: function () { return models_1.IntentToken; } });
-exports.VERSION = '0.2.6';
+var plan_builder_1 = require("./plan_builder");
+Object.defineProperty(exports, "defaultToolNameParser", { enumerable: true, get: function () { return plan_builder_1.defaultToolNameParser; } });
+Object.defineProperty(exports, "buildPlanFromToolCalls", { enumerable: true, get: function () { return plan_builder_1.buildPlanFromToolCalls; } });
+Object.defineProperty(exports, "hashToolCalls", { enumerable: true, get: function () { return plan_builder_1.hashToolCalls; } });
+var config_1 = require("./config");
+Object.defineProperty(exports, "ArmorIQConfigError", { enumerable: true, get: function () { return config_1.ArmorIQConfigError; } });
+Object.defineProperty(exports, "loadArmorIQConfig", { enumerable: true, get: function () { return config_1.loadArmorIQConfig; } });
+Object.defineProperty(exports, "parseArmorIQConfig", { enumerable: true, get: function () { return config_1.parseArmorIQConfig; } });
+Object.defineProperty(exports, "resolveEnvReference", { enumerable: true, get: function () { return config_1.resolveEnvReference; } });
+Object.defineProperty(exports, "resolveEnvReferences", { enumerable: true, get: function () { return config_1.resolveEnvReferences; } });
+Object.defineProperty(exports, "saveArmorIQConfig", { enumerable: true, get: function () { return config_1.saveArmorIQConfig; } });
+Object.defineProperty(exports, "DEFAULT_PROXY_URL", { enumerable: true, get: function () { return config_1.DEFAULT_PROXY_URL; } });
+exports.VERSION = '0.3.0';
 exports.AUTHOR = 'ArmorIQ Team';
 exports.EMAIL = 'license@armoriq.io';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAEH,mCAAyC;AAAhC,uGAAA,aAAa,OAAA;AACtB,2CAUsB;AATpB,8GAAA,gBAAgB,OAAA;AAChB,mHAAA,qBAAqB,OAAA;AACrB,qHAAA,uBAAuB,OAAA;AACvB,oHAAA,sBAAsB,OAAA;AACtB,mHAAA,qBAAqB,OAAA;AACrB,iHAAA,mBAAmB,OAAA;AACnB,oHAAA,sBAAsB,OAAA;AACtB,oHAAA,sBAAsB,OAAA;AACtB,iHAAA,mBAAmB,OAAA;AAErB,mCAgBkB;AAfhB,qGAAA,WAAW,OAAA;AAiBA,QAAA,OAAO,GAAG,OAAO,CAAC;AAClB,QAAA,MAAM,GAAG,cAAc,CAAC;AACxB,QAAA,KAAK,GAAG,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAEH,mCAA2D;AAAlD,uGAAA,aAAa,OAAA;AAAE,0GAAA,gBAAgB,OAAA;AACxC,qCAMmB;AALjB,yGAAA,cAAc,OAAA;AAMhB,2CAUsB;AATpB,8GAAA,gBAAgB,OAAA;AAChB,mHAAA,qBAAqB,OAAA;AACrB,qHAAA,uBAAuB,OAAA;AACvB,oHAAA,sBAAsB,OAAA;AACtB,mHAAA,qBAAqB,OAAA;AACrB,iHAAA,mBAAmB,OAAA;AACnB,oHAAA,sBAAsB,OAAA;AACtB,oHAAA,sBAAsB,OAAA;AACtB,iHAAA,mBAAmB,OAAA;AAErB,mCAmBkB;AAlBhB,qGAAA,WAAW,OAAA;AAoBb,+CAOwB;AANtB,qHAAA,qBAAqB,OAAA;AACrB,sHAAA,sBAAsB,OAAA;AACtB,6GAAA,aAAa,OAAA;AAMf,mCAiBkB;AAfhB,4GAAA,kBAAkB,OAAA;AASlB,2GAAA,iBAAiB,OAAA;AACjB,4GAAA,kBAAkB,OAAA;AAClB,6GAAA,mBAAmB,OAAA;AACnB,8GAAA,oBAAoB,OAAA;AACpB,2GAAA,iBAAiB,OAAA;AACjB,2GAAA,iBAAiB,OAAA;AAGN,QAAA,OAAO,GAAG,OAAO,CAAC;AAClB,QAAA,MAAM,GAAG,cAAc,CAAC;AACxB,QAAA,KAAK,GAAG,oBAAoB,CAAC"}

package/dist/integrations/google_adk.d.ts

@@ -0,0 +1,107 @@
+/**
+ * ArmorIQ — Google ADK integration (TypeScript).
+ *
+ * Mirrors armoriq_sdk/integrations/google_adk.py.
+ *
+ * Multi-user pattern:
+ *
+ *     import { ArmorIQADK } from '@armoriq/sdk/integrations/google_adk';
+ *     const armoriq = new ArmorIQADK({ apiKey: process.env.ARMORIQ_API_KEY! });
+ *
+ *     // per-request, inside your chat handler:
+ *     const scope = await armoriq.forUser(userEmail, { goal: message });
+ *     scope.install(rootAgent);
+ *     try {
+ *       for await (const event of runner.runAsync(...)) { ... }
+ *     } finally {
+ *       scope.uninstall(rootAgent);
+ *     }
+ *
+ * The bundle installs three ADK lifecycle callbacks on the agent:
+ *   afterModelCallback  → mint intent token from LLM tool calls
+ *   beforeToolCallback  → enforce per-user policy, block/hold if needed
+ *   afterToolCallback   → audit report
+ *
+ * "Agent" here is duck-typed — anything with three settable callback
+ * properties works. We don't take a hard dep on a specific TS ADK
+ * package because there isn't a single dominant one yet; the contract
+ * is a bag of three async functions.
+ */
+import { ArmorIQClient, ArmorIQUserScope } from '../client';
+import { ArmorIQSession, SessionMode } from '../session';
+import { ToolNameParser } from '../plan_builder';
+export interface ArmorIQADKOptions {
+    apiKey: string;
+    backendEndpoint?: string;
+    iapEndpoint?: string;
+    proxyEndpoint?: string;
+    useProduction?: boolean;
+    defaultMcpName?: string;
+    toolNameParser?: ToolNameParser;
+    validitySeconds?: number;
+    mode?: SessionMode;
+    llm?: string;
+}
+/**
+ * The minimal agent shape we need: three settable callback slots.
+ * Mirrors what google-adk-python expects on its Agent class.
+ */
+export interface AdkLikeAgent {
+    afterModelCallback?: (...args: any[]) => Promise<unknown> | unknown;
+    beforeToolCallback?: (tool: any, args: any, ctx?: any) => Promise<unknown> | unknown;
+    afterToolCallback?: (tool: any, args: any, ctx?: any, response?: any) => Promise<unknown> | unknown;
+}
+/**
+ * Process-wide ArmorIQ factory for ADK-style agents.
+ */
+export declare class ArmorIQADK {
+    readonly client: ArmorIQClient;
+    readonly mode: SessionMode;
+    readonly llm: string;
+    readonly validitySeconds: number;
+    readonly defaultMcpName?: string;
+    private customParser?;
+    private bootstrapData?;
+    constructor(opts: ArmorIQADKOptions);
+    bootstrap(): Promise<Record<string, any>>;
+    private toolNameParser;
+    invalidateUser(userEmail: string): void;
+    forUser(userEmail: string, opts?: {
+        goal?: string;
+    }): Promise<ArmorIQADKBundle>;
+}
+/**
+ * Per-request ADK bundle — installs/uninstalls lifecycle callbacks on
+ * one agent and binds them to one user's session.
+ */
+export declare class ArmorIQADKBundle {
+    readonly userEmail: string;
+    readonly goal: string;
+    session?: ArmorIQSession;
+    private factory;
+    private scope;
+    private parser;
+    private planMinted;
+    private blockedTools;
+    private blockedActions;
+    private agent?;
+    private saved;
+    constructor(args: {
+        factory: ArmorIQADK;
+        scope: ArmorIQUserScope;
+        parser: ToolNameParser;
+        userEmail: string;
+        goal: string;
+    });
+    private ensureSession;
+    private afterModel;
+    private beforeTool;
+    private afterTool;
+    /**
+     * Attach the three callbacks to the ADK-style agent. Save originals
+     * for uninstall().
+     */
+    install(agent: AdkLikeAgent): this;
+    uninstall(agent?: AdkLikeAgent): void;
+}
+//# sourceMappingURL=google_adk.d.ts.map

package/dist/integrations/google_adk.d.ts.map

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