agentrein 1.0.8

package/dist/agentameClient.d.ts

@@ -0,0 +1,63 @@
+import { AgentameUnavailableError } from './errors';
+export interface AgentameOptions {
+    apiKey: string;
+    serverUrl?: string;
+    failureMode?: 'open' | 'closed';
+}
+export interface SessionOptions {
+    agentId?: string;
+    intent?: string;
+}
+export interface UndoConfig {
+    type: 'slack-correction' | 'http-delete' | 'none';
+    url?: string;
+    headers?: Record<string, string>;
+    body?: Record<string, unknown>;
+}
+export interface Session {
+    id: string;
+    organizationId: string;
+    agentId: string;
+    intent: string | null;
+    status: string;
+    startedAt: string;
+    endedAt: string | null;
+}
+export { AgentameUnavailableError };
+export declare class Agentame {
+    private readonly serverUrl;
+    private readonly apiKey;
+    private readonly failureMode;
+    private token;
+    constructor(options: AgentameOptions);
+    /**
+     * Obtain a JWT token from the Agentame server using the API key.
+     * Caches the token for subsequent requests.
+     */
+    private getToken;
+    /**
+     * Build authorization headers for server requests.
+     */
+    private authHeaders;
+    /**
+     * Create a new agent session on the Agentame server.
+     *
+     * @param options - Session options (agentId + optional intent).
+     *                  Can also pass a plain string for backward compat (agentId).
+     *                  If omitted, a random agentId is generated.
+     */
+    newSession(options?: SessionOptions | string): Promise<Session>;
+    /**
+     * Execute an API call under Agentame's protection.
+     *
+     * 1. Calls fn(...args)
+     * 2. Logs the action to the Agentame server (async, non-blocking)
+     * 3. On failure, triggers server-side rollback
+     *
+     * @param fn      - The function to execute
+     * @param session - The active Agentame session
+     * @param args    - Arguments forwarded to fn
+     */
+    call<T>(fn: Function, session: Session, ...args: any[]): Promise<T>;
+    call<T>(fn: Function, session: Session, undoConfig: UndoConfig, ...args: any[]): Promise<T>;
+}

package/dist/agentameClient.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Agentame = exports.AgentameUnavailableError = void 0;
+const axios_1 = require("axios");
+const errors_1 = require("./errors");
+Object.defineProperty(exports, "AgentameUnavailableError", { enumerable: true, get: function () { return errors_1.AgentameUnavailableError; } });
+// ─── Agentame Client ─────────────────────────────────────
+class Agentame {
+    constructor(options) {
+        this.token = null;
+        this.serverUrl = options.serverUrl || 'https://agentame.up.railway.app';
+        this.apiKey = options.apiKey;
+        this.failureMode = options.failureMode ?? 'open';
+    }
+    // ── Authentication ──────────────────────────────────
+    /**
+     * Obtain a JWT token from the Agentame server using the API key.
+     * Caches the token for subsequent requests.
+     */
+    async getToken() {
+        if (this.token)
+            return this.token;
+        try {
+            const res = await axios_1.default.post(`${this.serverUrl}/auth/token`, {
+                apiKey: this.apiKey,
+            });
+            this.token = res.data.data.token;
+            return this.token;
+        }
+        catch (err) {
+            throw new errors_1.AgentameUnavailableError(`Failed to authenticate with Agentame server: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    /**
+     * Build authorization headers for server requests.
+     */
+    async authHeaders() {
+        const token = await this.getToken();
+        return { Authorization: `Bearer ${token}` };
+    }
+    // ── newSession ───────────────────────────────────────
+    /**
+     * Create a new agent session on the Agentame server.
+     *
+     * @param options - Session options (agentId + optional intent).
+     *                  Can also pass a plain string for backward compat (agentId).
+     *                  If omitted, a random agentId is generated.
+     */
+    async newSession(options) {
+        const resolved = typeof options === 'string'
+            ? { agentId: options, intent: undefined }
+            : options ?? {};
+        const agentId = resolved.agentId ?? crypto.randomUUID();
+        const intent = resolved.intent;
+        const headers = await this.authHeaders();
+        const res = await axios_1.default.post(`${this.serverUrl}/sessions`, { agentId, intent }, { headers });
+        return res.data.data;
+    }
+    async call(fn, session, ...args) {
+        // Detect if first extra arg is an UndoConfig object
+        let undoConfig;
+        let callArgs = args;
+        if (args.length > 0 &&
+            args[0] &&
+            typeof args[0] === 'object' &&
+            'type' in args[0] &&
+            ['slack-correction', 'http-delete', 'none'].includes(args[0].type)) {
+            undoConfig = args[0];
+            callArgs = args.slice(1);
+        }
+        const headers = await this.authHeaders();
+        try {
+            const result = await fn(...callArgs);
+            // Log action to server (fire-and-forget)
+            axios_1.default.post(`${this.serverUrl}/sessions/${session.id}/actions`, {
+                apiName: fn.name || 'anonymous',
+                operationType: 'CREATE',
+                payload: callArgs[0] ?? {},
+                response: result,
+                status: 'SUCCESS',
+                undoConfig,
+            }, { headers }).catch(() => { });
+            return result;
+        }
+        catch (error) {
+            // Trigger server-side rollback
+            await axios_1.default.post(`${this.serverUrl}/sessions/${session.id}/rollback`, {}, { headers }).catch(() => { });
+            throw error;
+        }
+    }
+}
+exports.Agentame = Agentame;

package/dist/agentreinClient.d.ts

@@ -0,0 +1,63 @@
+import { AgentreinUnavailableError } from './errors';
+export interface AgentreinOptions {
+    apiKey: string;
+    serverUrl?: string;
+    failureMode?: 'open' | 'closed';
+}
+export interface SessionOptions {
+    agentId?: string;
+    intent?: string;
+}
+export interface UndoConfig {
+    type: 'slack-correction' | 'http-delete' | 'none';
+    url?: string;
+    headers?: Record<string, string>;
+    body?: Record<string, unknown>;
+}
+export interface Session {
+    id: string;
+    organizationId: string;
+    agentId: string;
+    intent: string | null;
+    status: string;
+    startedAt: string;
+    endedAt: string | null;
+}
+export { AgentreinUnavailableError };
+export declare class Agentrein {
+    private readonly serverUrl;
+    private readonly apiKey;
+    private readonly failureMode;
+    private token;
+    constructor(options: AgentreinOptions);
+    /**
+     * Obtain a JWT token from the Agentrein server using the API key.
+     * Caches the token for subsequent requests.
+     */
+    private getToken;
+    /**
+     * Build authorization headers for server requests.
+     */
+    private authHeaders;
+    /**
+     * Create a new agent session on the Agentrein server.
+     *
+     * @param options - Session options (agentId + optional intent).
+     *                  Can also pass a plain string for backward compat (agentId).
+     *                  If omitted, a random agentId is generated.
+     */
+    newSession(options?: SessionOptions | string): Promise<Session>;
+    /**
+     * Execute an API call under Agentrein's protection.
+     *
+     * 1. Calls fn(...args)
+     * 2. Logs the action to the Agentrein server (async, non-blocking)
+     * 3. On failure, triggers server-side rollback
+     *
+     * @param fn      - The function to execute
+     * @param session - The active Agentrein session
+     * @param args    - Arguments forwarded to fn
+     */
+    call<T>(fn: Function, session: Session, ...args: any[]): Promise<T>;
+    call<T>(fn: Function, session: Session, undoConfig: UndoConfig, ...args: any[]): Promise<T>;
+}

package/dist/agentreinClient.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Agentrein = exports.AgentreinUnavailableError = void 0;
+const axios_1 = require("axios");
+const errors_1 = require("./errors");
+Object.defineProperty(exports, "AgentreinUnavailableError", { enumerable: true, get: function () { return errors_1.AgentreinUnavailableError; } });
+// ─── Agentrein Client ─────────────────────────────────────
+class Agentrein {
+    constructor(options) {
+        this.token = null;
+        this.serverUrl = options.serverUrl || 'https://api.agentrein.com';
+        this.apiKey = options.apiKey;
+        this.failureMode = options.failureMode ?? 'open';
+    }
+    // ── Authentication ──────────────────────────────────
+    /**
+     * Obtain a JWT token from the Agentrein server using the API key.
+     * Caches the token for subsequent requests.
+     */
+    async getToken() {
+        if (this.token)
+            return this.token;
+        try {
+            const res = await axios_1.default.post(`${this.serverUrl}/auth/token`, {
+                apiKey: this.apiKey,
+            });
+            this.token = res.data.data.token;
+            return this.token;
+        }
+        catch (err) {
+            throw new errors_1.AgentreinUnavailableError(`Failed to authenticate with Agentrein server: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    /**
+     * Build authorization headers for server requests.
+     */
+    async authHeaders() {
+        const token = await this.getToken();
+        return { Authorization: `Bearer ${token}` };
+    }
+    // ── newSession ───────────────────────────────────────
+    /**
+     * Create a new agent session on the Agentrein server.
+     *
+     * @param options - Session options (agentId + optional intent).
+     *                  Can also pass a plain string for backward compat (agentId).
+     *                  If omitted, a random agentId is generated.
+     */
+    async newSession(options) {
+        const resolved = typeof options === 'string'
+            ? { agentId: options, intent: undefined }
+            : options ?? {};
+        const agentId = resolved.agentId ?? crypto.randomUUID();
+        const intent = resolved.intent;
+        const headers = await this.authHeaders();
+        const res = await axios_1.default.post(`${this.serverUrl}/sessions`, { agentId, intent }, { headers });
+        return res.data.data;
+    }
+    async call(fn, session, ...args) {
+        // Detect if first extra arg is an UndoConfig object
+        let undoConfig;
+        let callArgs = args;
+        if (args.length > 0 &&
+            args[0] &&
+            typeof args[0] === 'object' &&
+            'type' in args[0] &&
+            ['slack-correction', 'http-delete', 'none'].includes(args[0].type)) {
+            undoConfig = args[0];
+            callArgs = args.slice(1);
+        }
+        const headers = await this.authHeaders();
+        try {
+            const result = await fn(...callArgs);
+            // Log action to server (fire-and-forget)
+            axios_1.default.post(`${this.serverUrl}/sessions/${session.id}/actions`, {
+                apiName: fn.name || 'anonymous',
+                operationType: 'CREATE',
+                payload: callArgs[0] ?? {},
+                response: result,
+                status: 'SUCCESS',
+                undoConfig,
+            }, { headers }).catch(() => { });
+            return result;
+        }
+        catch (error) {
+            // Trigger server-side rollback
+            await axios_1.default.post(`${this.serverUrl}/sessions/${session.id}/rollback`, {}, { headers }).catch(() => { });
+            throw error;
+        }
+    }
+}
+exports.Agentrein = Agentrein;

package/dist/errors.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Custom errors for the Agentrein SDK.
+ */
+export declare class AgentreinUnavailableError extends Error {
+    constructor(message?: string);
+}
+export declare class ApprovalRejectedError extends Error {
+    constructor(apiName: string, reason?: string);
+}
+export declare class ApprovalTimeoutError extends Error {
+    constructor(apiName: string, timeoutMinutes: number);
+}

package/dist/errors.js

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * Custom errors for the Agentrein SDK.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApprovalTimeoutError = exports.ApprovalRejectedError = exports.AgentreinUnavailableError = void 0;
+class AgentreinUnavailableError extends Error {
+    constructor(message) {
+        super(message ?? 'Agentrein safety layer is unavailable');
+        this.name = 'AgentreinUnavailableError';
+    }
+}
+exports.AgentreinUnavailableError = AgentreinUnavailableError;
+class ApprovalRejectedError extends Error {
+    constructor(apiName, reason) {
+        super(`Action "${apiName}" was rejected by a human reviewer${reason ? `: ${reason}` : ''}`);
+        this.name = 'ApprovalRejectedError';
+    }
+}
+exports.ApprovalRejectedError = ApprovalRejectedError;
+class ApprovalTimeoutError extends Error {
+    constructor(apiName, timeoutMinutes) {
+        super(`Action "${apiName}" was not approved within ${timeoutMinutes} minutes — auto-rejected`);
+        this.name = 'ApprovalTimeoutError';
+    }
+}
+exports.ApprovalTimeoutError = ApprovalTimeoutError;

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "agentrein",
+  "version": "1.0.8",
+  "main": "dist/agentreinClient.js",
+  "types": "dist/agentreinClient.d.ts",
+  "files": [
+    "dist/",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "axios": "^1.6.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0"
+  }
+}