@armoriq/sdk-dev 0.2.15 → 0.3.0

package/dist/integrations/google_adk.js

@@ -0,0 +1,301 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArmorIQADKBundle = exports.ArmorIQADK = void 0;
+const client_1 = require("../client");
+/**
+ * Process-wide ArmorIQ factory for ADK-style agents.
+ */
+class ArmorIQADK {
+    client;
+    mode;
+    llm;
+    validitySeconds;
+    defaultMcpName;
+    customParser;
+    bootstrapData;
+    constructor(opts) {
+        this.client = new client_1.ArmorIQClient({
+            apiKey: opts.apiKey,
+            backendEndpoint: opts.backendEndpoint,
+            iapEndpoint: opts.iapEndpoint ?? opts.backendEndpoint,
+            proxyEndpoint: opts.proxyEndpoint ?? opts.backendEndpoint,
+            useProduction: opts.useProduction ?? true,
+            userId: 'agent',
+            agentId: 'agent',
+        });
+        this.defaultMcpName = opts.defaultMcpName;
+        this.customParser = opts.toolNameParser;
+        this.validitySeconds = opts.validitySeconds ?? 300;
+        this.mode = opts.mode ?? 'sdk';
+        this.llm = opts.llm ?? 'agent';
+    }
+    async bootstrap() {
+        if (!this.bootstrapData) {
+            this.bootstrapData = await this.client.bootstrap();
+            const orgName = this.bootstrapData.org?.name ?? 'unknown';
+            const mcps = Array.isArray(this.bootstrapData.mcps)
+                ? this.bootstrapData.mcps.map((m) => m.name)
+                : [];
+            const toolMapSize = Object.keys(this.bootstrapData.toolMap ?? {}).length;
+            console.info(`[armoriq] bootstrap: org=${orgName} mcps=${JSON.stringify(mcps)} toolMap=${toolMapSize}`);
+        }
+        return this.bootstrapData;
+    }
+    async toolNameParser() {
+        if (this.customParser)
+            return this.customParser;
+        const bootstrap = await this.bootstrap();
+        const toolMap = bootstrap.toolMap ?? {};
+        const defaultMcp = this.defaultMcpName;
+        return (toolName) => {
+            const mcp = toolMap[toolName];
+            if (mcp)
+                return { mcp, action: toolName };
+            if (toolName.includes('__')) {
+                const idx = toolName.indexOf('__');
+                return { mcp: toolName.slice(0, idx), action: toolName.slice(idx + 2) };
+            }
+            if (defaultMcp)
+                return { mcp: defaultMcp, action: toolName };
+            return { mcp: 'unknown', action: toolName };
+        };
+    }
+    invalidateUser(userEmail) {
+        this.client.invalidateUser(userEmail);
+    }
+    async forUser(userEmail, opts) {
+        await this.bootstrap();
+        const scope = this.client.forUser(userEmail);
+        const parser = await this.toolNameParser();
+        return new ArmorIQADKBundle({
+            factory: this,
+            scope,
+            parser,
+            userEmail: userEmail.trim().toLowerCase(),
+            goal: opts?.goal ?? 'agent task',
+        });
+    }
+}
+exports.ArmorIQADK = ArmorIQADK;
+/**
+ * Per-request ADK bundle — installs/uninstalls lifecycle callbacks on
+ * one agent and binds them to one user's session.
+ */
+class ArmorIQADKBundle {
+    userEmail;
+    goal;
+    session;
+    factory;
+    scope;
+    parser;
+    planMinted = false;
+    blockedTools = new Set();
+    blockedActions = new Map();
+    agent;
+    saved = {};
+    constructor(args) {
+        this.factory = args.factory;
+        this.scope = args.scope;
+        this.parser = args.parser;
+        this.userEmail = args.userEmail;
+        this.goal = args.goal;
+    }
+    ensureSession() {
+        if (!this.session) {
+            const opts = {
+                mode: this.factory.mode,
+                validitySeconds: this.factory.validitySeconds,
+                llm: this.factory.llm,
+                toolNameParser: this.parser,
+                defaultMcpName: this.factory.defaultMcpName,
+            };
+            this.session = this.scope.startSession(opts);
+        }
+        return this.session;
+    }
+    async afterModel(_callbackContext, llmResponse) {
+        try {
+            if (this.planMinted)
+                return null;
+            const parts = llmResponse?.content?.parts ?? [];
+            const toolCalls = [];
+            for (const p of parts) {
+                const fc = p?.functionCall ?? p?.function_call;
+                if (fc?.name) {
+                    toolCalls.push({ name: fc.name, args: fc.args ? { ...fc.args } : {} });
+                }
+            }
+            if (toolCalls.length === 0)
+                return null;
+            await this.ensureSession().startPlan(toolCalls, this.goal);
+            this.planMinted = true;
+            console.info(`[armoriq] plan minted user=${this.userEmail} tools=${toolCalls.length}`);
+        }
+        catch (exc) {
+            console.warn(`[armoriq] afterModelCallback failed: ${exc.message}`);
+        }
+        return null;
+    }
+    async beforeTool(tool, args, _toolContext) {
+        const toolName = tool?.name ?? String(tool);
+        try {
+            const decision = await this.ensureSession().check(toolName, args ?? {}, this.userEmail);
+            if (!decision.allowed) {
+                const policy = decision.matchedPolicy ? ` (policy: ${decision.matchedPolicy})` : '';
+                if (decision.action === 'hold') {
+                    console.info(`[armoriq] HELD ${toolName} user=${this.userEmail} reason=${decision.reason} — waiting for approval...`);
+                    // 30-min default, 3s → 15s exponential, matches PY hold-retry.
+                    const timeoutMs = 30 * 60 * 1000;
+                    const deadline = Date.now() + timeoutMs;
+                    let pollIntervalMs = 3000;
+                    let attempt = 0;
+                    let approved = false;
+                    let finalDecision = decision;
+                    while (Date.now() < deadline) {
+                        await new Promise((r) => setTimeout(r, pollIntervalMs));
+                        pollIntervalMs = Math.min(pollIntervalMs * 1.5, 15000);
+                        attempt += 1;
+                        const retry = await this.ensureSession().check(toolName, args ?? {}, this.userEmail);
+                        finalDecision = retry;
+                        if (retry.allowed) {
+                            console.info(`[armoriq] APPROVED ${toolName} attempt ${attempt}`);
+                            approved = true;
+                            break;
+                        }
+                        if (retry.action !== 'hold') {
+                            console.info(`[armoriq] REJECTED ${toolName} action=${retry.action}`);
+                            break;
+                        }
+                    }
+                    if (approved)
+                        return null;
+                    const finalPolicy = finalDecision.matchedPolicy
+                        ? ` (policy: ${finalDecision.matchedPolicy})`
+                        : '';
+                    this.blockedTools.add(toolName);
+                    this.blockedActions.set(toolName, finalDecision.action);
+                    if (finalDecision.action === 'hold') {
+                        return {
+                            error: `Approval timed out${finalPolicy}. Reason: ${finalDecision.reason ?? 'policy-hold'}.`,
+                            armoriq_enforcement: {
+                                blocked: true,
+                                action: 'hold',
+                                reason: finalDecision.reason,
+                                matched_policy: finalDecision.matchedPolicy,
+                                tool: toolName,
+                                delegation_id: finalDecision.delegationId,
+                            },
+                        };
+                    }
+                    return {
+                        error: `This action is not permitted${finalPolicy}. Reason: ${finalDecision.reason ?? 'policy-blocked'}.`,
+                        armoriq_enforcement: {
+                            blocked: true,
+                            action: finalDecision.action,
+                            reason: finalDecision.reason,
+                            matched_policy: finalDecision.matchedPolicy,
+                            tool: toolName,
+                            delegation_id: finalDecision.delegationId,
+                        },
+                    };
+                }
+                // Hard block
+                this.blockedTools.add(toolName);
+                this.blockedActions.set(toolName, decision.action);
+                console.info(`[armoriq] BLOCKED ${toolName} user=${this.userEmail} action=${decision.action} reason=${decision.reason}`);
+                return {
+                    error: `This action is not permitted by your organization's policy${policy}. Reason: ${decision.reason ?? 'policy-blocked'}.`,
+                    armoriq_enforcement: {
+                        blocked: true,
+                        action: decision.action,
+                        reason: decision.reason,
+                        matched_policy: decision.matchedPolicy,
+                        tool: toolName,
+                        delegation_id: decision.delegationId,
+                    },
+                };
+            }
+        }
+        catch (exc) {
+            console.warn(`[armoriq] beforeToolCallback failed: ${exc.message}`);
+        }
+        return null;
+    }
+    async afterTool(tool, args, _toolContext, toolResponse) {
+        const toolName = tool?.name ?? String(tool);
+        try {
+            if (this.blockedTools.has(toolName)) {
+                const action = this.blockedActions.get(toolName) ?? 'block';
+                this.blockedActions.delete(toolName);
+                this.blockedTools.delete(toolName);
+                if (action !== 'hold') {
+                    await this.ensureSession().report(toolName, args ?? {}, toolResponse, {
+                        status: 'failed',
+                        errorMessage: 'Blocked by policy',
+                    });
+                }
+                return null;
+            }
+            await this.ensureSession().report(toolName, args ?? {}, toolResponse);
+        }
+        catch (exc) {
+            console.warn(`[armoriq] afterToolCallback failed: ${exc.message}`);
+        }
+        return null;
+    }
+    /**
+     * Attach the three callbacks to the ADK-style agent. Save originals
+     * for uninstall().
+     */
+    install(agent) {
+        this.agent = agent;
+        this.saved = {
+            afterModelCallback: agent.afterModelCallback,
+            beforeToolCallback: agent.beforeToolCallback,
+            afterToolCallback: agent.afterToolCallback,
+        };
+        agent.afterModelCallback = (...args) => this.afterModel(args[0], args[1]);
+        agent.beforeToolCallback = (tool, args, ctx) => this.beforeTool(tool, args, ctx);
+        agent.afterToolCallback = (tool, args, ctx, response) => this.afterTool(tool, args, ctx, response);
+        return this;
+    }
+    uninstall(agent) {
+        const a = agent ?? this.agent;
+        if (!a)
+            return;
+        a.afterModelCallback = this.saved.afterModelCallback;
+        a.beforeToolCallback = this.saved.beforeToolCallback;
+        a.afterToolCallback = this.saved.afterToolCallback;
+    }
+}
+exports.ArmorIQADKBundle = ArmorIQADKBundle;
+//# sourceMappingURL=google_adk.js.map

package/dist/integrations/google_adk.js.map

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

package/dist/models.d.ts

@@ -233,6 +233,37 @@ export interface ApprovedDelegation {
     approverRole: string;
     delegationToken?: string;
 }
+/**
+ * A flat tool-call as surfaced by most LLM frameworks.
+ * Used by plan_builder helpers and ArmorIQSession.startPlan.
+ */
+export interface ToolCall {
+    name: string;
+    args?: Record<string, unknown>;
+}
+/**
+ * Per-MCP credentials forwarded to the proxy via the X-Armoriq-MCP-Auth header.
+ * The discriminated union mirrors the Python SDK's McpCredential shape so
+ * the JSON env blob (ARMORIQ_MCP_CREDENTIALS) is portable across SDKs.
+ */
+export type McpCredential = {
+    authType: 'bearer';
+    token: string;
+} | {
+    authType: 'api_key';
+    apiKey: string;
+    headerName?: string;
+} | {
+    authType: 'basic';
+    username: string;
+    password: string;
+} | {
+    authType: 'none';
+};
+/**
+ * Map of MCP identifier (or upper-snake "safe name") to credential.
+ */
+export type McpCredentialMap = Record<string, McpCredential>;
 /**
  * SDK configuration.
  */
@@ -259,5 +290,10 @@ export interface SDKConfig {
     apiKey?: string;
     /** Use production endpoints */
     useProduction: boolean;
+    /**
+     * Per-MCP credentials. Merged with ARMORIQ_MCP_CREDENTIALS env JSON and
+     * ARMORIQ_MCP_<SAFE_NAME>_* per-MCP env vars; constructor option wins.
+     */
+    mcpCredentials?: McpCredentialMap;
 }
 //# sourceMappingURL=models.d.ts.map

package/dist/models.d.ts.map

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

package/dist/plan_builder.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Plan-shape helpers used by ArmorIQSession and framework integrations.
+ *
+ * Most LLM frameworks surface tool calls as a flat list of {name, args}.
+ * The SDK accepts that shape directly so plugin code doesn't have to
+ * hand-construct {goal, steps: [...]} every time.
+ *
+ * Mirrors armoriq_sdk/plan_builder.py — outputs the same plan shape and
+ * hash digest so PY and TS sides round-trip cleanly.
+ */
+import { ToolCall } from './models';
+export type ToolNameParser = (toolName: string) => {
+    mcp: string;
+    action: string;
+};
+/**
+ * Default tool-name convention: `<MCP>__<action>`. Matches the proxy's
+ * MCP gateway and the convention used by sdk-admin-agent.
+ *
+ *   "Stripe__create_payment" -> { mcp: "Stripe", action: "create_payment" }
+ *   "create_payment"          -> uses defaultMcpName, else throws.
+ */
+export declare function defaultToolNameParser(defaultMcpName?: string): ToolNameParser;
+export interface PlanStep {
+    action: string;
+    tool: string;
+    mcp: string;
+    params: Record<string, unknown>;
+    description: string;
+}
+export interface BuiltPlan {
+    goal: string;
+    steps: PlanStep[];
+}
+/**
+ * Build an SDK-shaped plan dict from a flat list of tool calls.
+ */
+export declare function buildPlanFromToolCalls(toolCalls: Array<ToolCall | {
+    name: string;
+    args?: Record<string, unknown>;
+}>, goal?: string, toolNameParser?: ToolNameParser, defaultMcpName?: string): BuiltPlan;
+/**
+ * Stable hash over a tool-calls list — used by ArmorIQSession to skip
+ * re-minting when the LLM re-emits the same plan in the same turn.
+ *
+ * Uses JSON.stringify with no key sorting, matching the Python side's
+ * json.dumps(separators=(",",":")), so TS and PY produce matching digests.
+ */
+export declare function hashToolCalls(toolCalls: Array<ToolCall | {
+    name: string;
+    args?: Record<string, unknown>;
+}>): string;
+//# sourceMappingURL=plan_builder.d.ts.map

package/dist/plan_builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan_builder.d.ts","sourceRoot":"","sources":["../src/plan_builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEpC,MAAM,MAAM,cAAc,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnF;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,cAAc,CAkB7E;AAMD,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,KAAK,CAAC,QAAQ,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC,EAC7E,IAAI,CAAC,EAAE,MAAM,EACb,cAAc,CAAC,EAAE,cAAc,EAC/B,cAAc,CAAC,EAAE,MAAM,GACtB,SAAS,CAcX;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,KAAK,CAAC,QAAQ,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC,GAC5E,MAAM,CAOR"}

package/dist/plan_builder.js

@@ -0,0 +1,110 @@
+"use strict";
+/**
+ * Plan-shape helpers used by ArmorIQSession and framework integrations.
+ *
+ * Most LLM frameworks surface tool calls as a flat list of {name, args}.
+ * The SDK accepts that shape directly so plugin code doesn't have to
+ * hand-construct {goal, steps: [...]} every time.
+ *
+ * Mirrors armoriq_sdk/plan_builder.py — outputs the same plan shape and
+ * hash digest so PY and TS sides round-trip cleanly.
+ */
+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.defaultToolNameParser = defaultToolNameParser;
+exports.buildPlanFromToolCalls = buildPlanFromToolCalls;
+exports.hashToolCalls = hashToolCalls;
+const crypto = __importStar(require("crypto"));
+/**
+ * Default tool-name convention: `<MCP>__<action>`. Matches the proxy's
+ * MCP gateway and the convention used by sdk-admin-agent.
+ *
+ *   "Stripe__create_payment" -> { mcp: "Stripe", action: "create_payment" }
+ *   "create_payment"          -> uses defaultMcpName, else throws.
+ */
+function defaultToolNameParser(defaultMcpName) {
+    return (toolName) => {
+        const idx = toolName.indexOf('__');
+        if (idx === -1) {
+            if (!defaultMcpName) {
+                throw new Error(`Tool "${toolName}" is not namespaced as <MCP>__<action> and no defaultMcpName was set on the session.`);
+            }
+            return { mcp: defaultMcpName, action: toolName };
+        }
+        const mcp = toolName.slice(0, idx);
+        const action = toolName.slice(idx + 2);
+        if (!mcp || !action) {
+            throw new Error(`Tool "${toolName}" has a malformed MCP prefix.`);
+        }
+        return { mcp, action };
+    };
+}
+function asToolCall(tc) {
+    return { name: tc.name, args: tc.args ?? {} };
+}
+/**
+ * Build an SDK-shaped plan dict from a flat list of tool calls.
+ */
+function buildPlanFromToolCalls(toolCalls, goal, toolNameParser, defaultMcpName) {
+    const parser = toolNameParser ?? defaultToolNameParser(defaultMcpName);
+    const steps = toolCalls.map((tc) => {
+        const call = asToolCall(tc);
+        const { mcp, action } = parser(call.name);
+        return {
+            action,
+            tool: action,
+            mcp,
+            params: call.args ?? {},
+            description: `Call ${action} on ${mcp}`,
+        };
+    });
+    return { goal: goal ?? 'agent task', steps };
+}
+/**
+ * Stable hash over a tool-calls list — used by ArmorIQSession to skip
+ * re-minting when the LLM re-emits the same plan in the same turn.
+ *
+ * Uses JSON.stringify with no key sorting, matching the Python side's
+ * json.dumps(separators=(",",":")), so TS and PY produce matching digests.
+ */
+function hashToolCalls(toolCalls) {
+    const canonicalList = toolCalls.map((tc) => ({
+        name: asToolCall(tc).name,
+        args: asToolCall(tc).args ?? {},
+    }));
+    const canonical = JSON.stringify(canonicalList);
+    return crypto.createHash('sha256').update(canonical, 'utf8').digest('hex');
+}
+//# sourceMappingURL=plan_builder.js.map

package/dist/plan_builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan_builder.js","sourceRoot":"","sources":["../src/plan_builder.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAcH,sDAkBC;AAsBD,wDAmBC;AASD,sCASC;AAzFD,+CAAiC;AAKjC;;;;;;GAMG;AACH,SAAgB,qBAAqB,CAAC,cAAuB;IAC3D,OAAO,CAAC,QAAgB,EAAE,EAAE;QAC1B,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;YACf,IAAI,CAAC,cAAc,EAAE,CAAC;gBACpB,MAAM,IAAI,KAAK,CACb,SAAS,QAAQ,sFAAsF,CACxG,CAAC;YACJ,CAAC;YACD,OAAO,EAAE,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;QACnD,CAAC;QACD,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACnC,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;QACvC,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,SAAS,QAAQ,+BAA+B,CAAC,CAAC;QACpE,CAAC;QACD,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;IACzB,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,EAA+D;IACjF,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;AAChD,CAAC;AAeD;;GAEG;AACH,SAAgB,sBAAsB,CACpC,SAA6E,EAC7E,IAAa,EACb,cAA+B,EAC/B,cAAuB;IAEvB,MAAM,MAAM,GAAG,cAAc,IAAI,qBAAqB,CAAC,cAAc,CAAC,CAAC;IACvE,MAAM,KAAK,GAAe,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;QAC7C,MAAM,IAAI,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC;QAC5B,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1C,OAAO;YACL,MAAM;YACN,IAAI,EAAE,MAAM;YACZ,GAAG;YACH,MAAM,EAAG,IAAI,CAAC,IAAgC,IAAI,EAAE;YACpD,WAAW,EAAE,QAAQ,MAAM,OAAO,GAAG,EAAE;SACxC,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,IAAI,EAAE,IAAI,IAAI,YAAY,EAAE,KAAK,EAAE,CAAC;AAC/C,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,aAAa,CAC3B,SAA6E;IAE7E,MAAM,aAAa,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QAC3C,IAAI,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC,IAAI;QACzB,IAAI,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC,IAAI,IAAI,EAAE;KAChC,CAAC,CAAC,CAAC;IACJ,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;IAChD,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC7E,CAAC"}

package/dist/session.d.ts

@@ -0,0 +1,75 @@
+/**
+ * ArmorIQSession — the core primitive for framework integrations.
+ *
+ * Mirrors armoriq_sdk/session.py. Two main usage shapes:
+ *
+ * 1. Observe mode (default, local) — MCP stays on the agent side:
+ *      session.startPlan(toolCalls);
+ *      const decision = session.enforce(toolName, toolArgs);
+ *      // ... framework calls MCP directly ...
+ *      await session.report(toolName, toolArgs, result);
+ *
+ * 2. Proxy mode — routes through the Armoriq proxy:
+ *      session.startPlan(toolCalls);
+ *      return session.dispatch(toolName, toolArgs);
+ */
+import { ArmorIQClient } from './client';
+import { IntentToken, ToolCall } from './models';
+import { ToolNameParser } from './plan_builder';
+export type SessionMode = 'local' | 'proxy' | 'sdk';
+export interface SessionOptions {
+    toolNameParser?: ToolNameParser;
+    defaultMcpName?: string;
+    validitySeconds?: number;
+    llm?: string;
+    mode?: SessionMode;
+}
+export interface EnforceResult {
+    allowed: boolean;
+    action: 'allow' | 'block' | 'hold';
+    reason?: string;
+    delegationId?: string;
+    matchedPolicy?: string;
+}
+export interface ReportOptions {
+    status?: 'success' | 'failed' | 'error';
+    errorMessage?: string;
+    durationMs?: number;
+    isDelegated?: boolean;
+    delegatedBy?: string;
+    delegatedTo?: string;
+}
+type ToolCallInput = ToolCall | {
+    name: string;
+    args?: Record<string, unknown>;
+};
+export declare class ArmorIQSession {
+    userEmail?: string;
+    private client;
+    private toolNameParser;
+    private defaultMcpName?;
+    private validitySeconds;
+    private llm;
+    private mode;
+    private stepIndex;
+    private currentPlanHash?;
+    private currentToken?;
+    private mcpByAction;
+    private declaredTools;
+    constructor(client: ArmorIQClient, opts?: SessionOptions);
+    startPlan(toolCalls: ToolCallInput[], goal?: string): Promise<IntentToken>;
+    enforceLocal(toolName: string, toolArgs: Record<string, unknown>): EnforceResult;
+    enforceSdk(toolName: string, toolArgs: Record<string, unknown>, userEmail?: string): Promise<EnforceResult>;
+    enforce(toolName: string, toolArgs: Record<string, unknown>): Promise<EnforceResult>;
+    check(toolName: string, toolArgs: Record<string, unknown>, userEmail?: string): Promise<EnforceResult>;
+    report(toolName: string, toolArgs: Record<string, unknown>, result: unknown, opts?: ReportOptions): Promise<void>;
+    dispatch(toolName: string, toolArgs: Record<string, unknown>): Promise<unknown>;
+    private handleHold;
+    private static extractAmount;
+    private evaluateAmountThreshold;
+    reset(): void;
+    get currentTokenValue(): IntentToken | undefined;
+    get currentMode(): SessionMode;
+}
+export {};
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

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