@auctra/sdk 0.2.0 → 0.3.0

package/dist/esm/index.d.ts

@@ -0,0 +1,355 @@
+export declare const AUCTRA_SDK_VERSION = "0.3.0";
+export type AgentEnvironment = "dev" | "staging" | "production";
+export type AuthorityLevel = "low" | "medium" | "high" | "critical";
+export type Decision = "allowed" | "blocked" | "require_approval";
+export type PolicyType = "spending" | "data_access" | "communication" | "approval";
+export type ActorType = "human" | "agent" | "service" | "tool";
+export type RiskLevel = "low" | "medium" | "high" | "critical";
+export type EvaluateActionInput = {
+    agentId: string;
+    actionType: string;
+    payload?: Record<string, unknown>;
+    claimedIntentId?: string;
+    parentActionId?: string;
+    actor?: {
+        id?: string;
+        type?: ActorType;
+        name?: string;
+    };
+    action?: {
+        target?: string;
+        description?: string;
+        riskLevel?: RiskLevel;
+        metadata?: Record<string, unknown>;
+    };
+};
+export type EvaluateActionResponse = {
+    decision: Decision;
+    risk_score: number;
+    reason: string;
+    delegation_id: string | null;
+    delegator: string | null;
+    sponsor: string;
+    matched_policies: string[];
+    action_request_id: string;
+    intelligence?: {
+        authority_valid: boolean;
+        root_intent_valid: boolean;
+        intent_status: string;
+        trust_summary?: string;
+    };
+};
+export type RequestOptions = {
+    idempotencyKey?: string;
+    signal?: AbortSignal;
+};
+export type AuctraClientOptions = {
+    apiKey: string;
+    baseUrl?: string;
+    timeoutMs?: number;
+    maxRetries?: number;
+    fetch?: typeof fetch;
+};
+export type Agent = {
+    id: string;
+    identity_id: string;
+    name: string;
+    description: string | null;
+    model_provider: "openai" | "anthropic" | "gemini" | "local";
+    model_name: string;
+    environment: AgentEnvironment;
+    authority_level: AuthorityLevel;
+    status: "active" | "suspended" | "restricted" | "compromised";
+    trust_rating: number;
+    sponsor: {
+        id: string;
+        full_name: string;
+        email: string;
+    };
+    created_at: string;
+};
+export type CreateAgentInput = {
+    name: string;
+    modelProvider: Agent["model_provider"];
+    modelName: string;
+    description?: string;
+    environment?: AgentEnvironment;
+    authorityLevel?: AuthorityLevel;
+    sponsorUserId?: string;
+};
+export type Delegation = {
+    id: string;
+    agent: {
+        id: string;
+        name: string;
+    };
+    delegator: {
+        id: string;
+        full_name: string;
+        email: string;
+    };
+    scope: {
+        action_types: string[];
+    };
+    limits: {
+        max_amount?: number;
+        max_count?: number;
+        currency?: string;
+        environment?: AgentEnvironment;
+    };
+    valid_from: string;
+    valid_until: string;
+    status: "active" | "revoked" | "expired";
+    is_active: boolean;
+    created_at: string;
+};
+export type CreateDelegationInput = {
+    agentId: string;
+    actionTypes: string[];
+    validUntil: string;
+    maxAmount?: number;
+    maxCount?: number;
+    environment?: AgentEnvironment;
+    currency?: string;
+    delegatorUserId?: string;
+};
+export type ActionRequest = {
+    id: string;
+    agent_name: string;
+    action_type: string;
+    action_summary: string;
+    payload: Record<string, unknown>;
+    decision: string;
+    decision_reason: string | null;
+    risk_score: number;
+    delegation_id: string | null;
+    policy_ids: string[];
+    pending_approval_id: string | null;
+    created_at: string;
+    decided_at: string | null;
+};
+export type Intent = {
+    id: string;
+    title: string;
+    description: string | null;
+    intent_type: string | null;
+    status: string;
+    risk_level: RiskLevel;
+    max_risk_level: RiskLevel;
+    expires_at: string | null;
+    created_at: string;
+    owner: {
+        id: string;
+        full_name: string;
+        email: string;
+    } | null;
+    linked_actions: number;
+};
+export type IntentDetail = Omit<Intent, "linked_actions"> & {
+    linked_action_records: Array<{
+        action_request_id: string;
+        action_type: string;
+        summary: string;
+        decision: string;
+        alignment_status: string;
+        alignment_score: number | null;
+    }>;
+};
+export type CreateIntentInput = {
+    title: string;
+    description?: string;
+    intentType?: string;
+    riskLevel?: RiskLevel;
+    maxRiskLevel?: RiskLevel;
+    expiresAt?: string;
+};
+export type AuthorityGraph = {
+    nodes: Array<{
+        id: string;
+        type: ActorType;
+        label: string;
+    }>;
+    edges: Array<{
+        id: string;
+        from: string;
+        to: string;
+        fromType: ActorType;
+        toType: ActorType;
+        scope: string;
+        status: string;
+        edgeType: string;
+    }>;
+};
+export type ActionEvaluation = {
+    id: string;
+    action_request_id: string;
+    intent_id: string | null;
+    decision: "allowed" | "requires_approval" | "blocked";
+    risk_score: number;
+    authority_valid: boolean;
+    intent_valid: boolean;
+    root_intent_valid: boolean;
+    reasons: string[];
+    created_at: string;
+};
+export type RootIntentChain = {
+    valid: boolean;
+    root_human_id: string | null;
+    root_intent_id: string | null;
+    reason: string | null;
+    chain: Array<{
+        actionId?: string;
+        actorId: string;
+        actorType: ActorType;
+        intentId?: string;
+        parentActionId?: string;
+        label?: string;
+    }>;
+};
+export type Policy = {
+    id: string;
+    name: string;
+    description: string | null;
+    policy_type: PolicyType;
+    status: "active" | "draft" | "archived";
+    priority: number;
+    conditions: Record<string, unknown>;
+    actions: Record<string, unknown>;
+    created_at: string;
+};
+export type CreatePolicyInput = {
+    name: string;
+    description?: string;
+    policyType: PolicyType;
+    status?: "active" | "draft";
+    priority?: number;
+    actionType?: string;
+    amountGreaterThan?: number;
+    resourceSensitivity?: "public" | "internal" | "confidential" | "pii";
+    externalRecipient?: boolean;
+    environment?: AgentEnvironment;
+    decision: "block" | "require_approval";
+    approverRole?: "owner" | "admin" | "reviewer";
+};
+export type AuditEvent = {
+    id: string;
+    event_type: string;
+    event_summary: string;
+    decision: string | null;
+    decision_reason: string | null;
+    authority_valid_at_action: boolean | null;
+    actor_name: string;
+    approver_name: string | null;
+    policy_applied: string | null;
+    delegation_id: string | null;
+    hash: string | null;
+    previous_hash: string | null;
+    created_at: string;
+};
+export type ApiKeySummary = {
+    id: string;
+    name: string;
+    key_prefix: string;
+    environment: "development" | "production";
+    permissions: string[];
+    status: "active" | "revoked";
+    last_used_at: string | null;
+    created_at: string;
+};
+export declare class AuctraApiError extends Error {
+    readonly status: number;
+    readonly code?: string;
+    readonly details?: unknown;
+    readonly requestId?: string;
+    constructor(message: string, options: {
+        status: number;
+        code?: string;
+        details?: unknown;
+        requestId?: string;
+    });
+}
+export declare class Auctra {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly timeoutMs;
+    private readonly maxRetries;
+    private readonly fetchImpl;
+    constructor(options: AuctraClientOptions);
+    private request;
+    evaluateAction(input: EvaluateActionInput, options?: RequestOptions): Promise<EvaluateActionResponse>;
+    listIntents(): Promise<{
+        intents: Intent[];
+    }>;
+    createIntent(input: CreateIntentInput): Promise<{
+        intent: {
+            id: string;
+            title: string;
+            status: string;
+        };
+    }>;
+    getIntent(intentId: string): Promise<{
+        intent: IntentDetail;
+    }>;
+    getAuthorityGraph(): Promise<{
+        authority_graph: AuthorityGraph;
+    }>;
+    getActionEvaluation(actionRequestId: string): Promise<{
+        evaluation: ActionEvaluation;
+    }>;
+    getRootIntentChain(actionRequestId: string): Promise<{
+        root_intent_chain: RootIntentChain;
+    }>;
+    listAgents(): Promise<{
+        agents: Agent[];
+    }>;
+    getAgent(agentId: string): Promise<{
+        agent: Agent;
+    }>;
+    createAgent(input: CreateAgentInput): Promise<{
+        agent: Agent;
+    }>;
+    listDelegations(): Promise<{
+        delegations: Delegation[];
+    }>;
+    getDelegation(delegationId: string): Promise<{
+        delegation: Delegation;
+    }>;
+    createDelegation(input: CreateDelegationInput): Promise<{
+        delegation: Delegation;
+    }>;
+    revokeDelegation(delegationId: string): Promise<{
+        ok: true;
+    }>;
+    listActionRequests(): Promise<{
+        action_requests: ActionRequest[];
+    }>;
+    approveActionRequest(actionRequestId: string, approverUserId: string, reason?: string): Promise<{
+        ok: true;
+        decision: string;
+        reason: string;
+    }>;
+    rejectActionRequest(actionRequestId: string, approverUserId: string, reason?: string): Promise<{
+        ok: true;
+        decision: string;
+        reason: string;
+    }>;
+    escalateActionRequest(actionRequestId: string, approverUserId: string, reason?: string): Promise<{
+        ok: true;
+        decision: string;
+        reason: string;
+    }>;
+    private resolveActionRequest;
+    listPolicies(): Promise<{
+        policies: Policy[];
+    }>;
+    createPolicy(input: CreatePolicyInput): Promise<{
+        policy: Pick<Policy, "id" | "name" | "status" | "created_at">;
+    }>;
+    listAuditEvents(): Promise<{
+        audit_events: AuditEvent[];
+    }>;
+    listApiKeys(): Promise<{
+        api_keys: ApiKeySummary[];
+    }>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

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

package/dist/esm/index.js

@@ -0,0 +1,242 @@
+export const AUCTRA_SDK_VERSION = "0.3.0";
+export class AuctraApiError extends Error {
+    status;
+    code;
+    details;
+    requestId;
+    constructor(message, options) {
+        super(message);
+        this.name = "AuctraApiError";
+        this.status = options.status;
+        this.code = options.code;
+        this.details = options.details;
+        this.requestId = options.requestId;
+    }
+}
+function retryDelay(response, attempt) {
+    const retryAfter = response?.headers.get("retry-after");
+    if (retryAfter) {
+        const seconds = Number(retryAfter);
+        if (Number.isFinite(seconds))
+            return Math.min(30_000, Math.max(0, seconds * 1_000));
+        const dateDelay = Date.parse(retryAfter) - Date.now();
+        if (Number.isFinite(dateDelay))
+            return Math.min(30_000, Math.max(0, dateDelay));
+    }
+    return Math.min(5_000, 150 * 2 ** attempt);
+}
+function wait(ms, signal) {
+    if (signal?.aborted)
+        return Promise.reject(signal.reason);
+    return new Promise((resolve, reject) => {
+        const timeout = setTimeout(resolve, ms);
+        signal?.addEventListener("abort", () => {
+            clearTimeout(timeout);
+            reject(signal.reason);
+        }, { once: true });
+    });
+}
+export class Auctra {
+    apiKey;
+    baseUrl;
+    timeoutMs;
+    maxRetries;
+    fetchImpl;
+    constructor(options) {
+        if (!options.apiKey.trim())
+            throw new Error("apiKey is required");
+        if (options.timeoutMs !== undefined && options.timeoutMs <= 0) {
+            throw new Error("timeoutMs must be greater than zero");
+        }
+        if (options.maxRetries !== undefined &&
+            (!Number.isInteger(options.maxRetries) || options.maxRetries < 0)) {
+            throw new Error("maxRetries must be a non-negative integer");
+        }
+        this.apiKey = options.apiKey;
+        this.baseUrl = (options.baseUrl ?? "https://console.auctra.tech").replace(/\/$/, "");
+        this.timeoutMs = options.timeoutMs ?? 10_000;
+        this.maxRetries = options.maxRetries ?? 2;
+        this.fetchImpl = options.fetch ?? globalThis.fetch;
+        if (!this.fetchImpl)
+            throw new Error("A fetch implementation is required");
+    }
+    async request(method, path, body, options = {}) {
+        const retryableRequest = method === "GET" || Boolean(options.idempotencyKey);
+        let lastError;
+        for (let attempt = 0; attempt <= this.maxRetries; attempt += 1) {
+            if (options.signal?.aborted)
+                throw options.signal.reason;
+            const timeoutSignal = AbortSignal.timeout(this.timeoutMs);
+            const signal = options.signal
+                ? AbortSignal.any([options.signal, timeoutSignal])
+                : timeoutSignal;
+            let response;
+            try {
+                response = await this.fetchImpl(`${this.baseUrl}${path}`, {
+                    method,
+                    signal,
+                    headers: {
+                        ...(body !== undefined ? { "content-type": "application/json" } : {}),
+                        ...(options.idempotencyKey ? { "idempotency-key": options.idempotencyKey } : {}),
+                        authorization: `Bearer ${this.apiKey}`,
+                        "x-auctra-sdk-version": AUCTRA_SDK_VERSION,
+                    },
+                    ...(body !== undefined ? { body: JSON.stringify(body) } : {}),
+                });
+                const data = (await response.json().catch(() => ({})));
+                if (response.ok)
+                    return data;
+                if (retryableRequest &&
+                    (response.status === 429 || response.status >= 500) &&
+                    attempt < this.maxRetries) {
+                    await wait(retryDelay(response, attempt), options.signal);
+                    continue;
+                }
+                throw new AuctraApiError(typeof data.error === "string" ? data.error : `Auctra API error (${response.status})`, {
+                    status: response.status,
+                    code: typeof data.code === "string" ? data.code : undefined,
+                    details: data.details,
+                    requestId: response.headers.get("x-request-id") ?? undefined,
+                });
+            }
+            catch (error) {
+                lastError = error;
+                if (options.signal?.aborted)
+                    throw options.signal.reason;
+                if (error instanceof AuctraApiError || !retryableRequest || attempt >= this.maxRetries) {
+                    throw error;
+                }
+                await wait(retryDelay(response, attempt), options.signal);
+            }
+        }
+        throw lastError;
+    }
+    async evaluateAction(input, options = {}) {
+        const idempotencyKey = options.idempotencyKey ?? crypto.randomUUID();
+        return this.request("POST", "/v1/action-requests/evaluate", {
+            agent_id: input.agentId,
+            action_type: input.actionType,
+            payload: input.payload ?? {},
+            claimed_intent_id: input.claimedIntentId,
+            parent_action_id: input.parentActionId,
+            actor: input.actor
+                ? {
+                    id: input.actor.id,
+                    type: input.actor.type,
+                    name: input.actor.name,
+                }
+                : undefined,
+            action: input.action
+                ? {
+                    target: input.action.target,
+                    description: input.action.description,
+                    risk_level: input.action.riskLevel,
+                    metadata: input.action.metadata,
+                }
+                : undefined,
+        }, { ...options, idempotencyKey });
+    }
+    async listIntents() {
+        return this.request("GET", "/v1/intents");
+    }
+    async createIntent(input) {
+        return this.request("POST", "/v1/intents", {
+            title: input.title,
+            description: input.description,
+            intent_type: input.intentType,
+            risk_level: input.riskLevel,
+            max_risk_level: input.maxRiskLevel,
+            expires_at: input.expiresAt,
+        });
+    }
+    async getIntent(intentId) {
+        return this.request("GET", `/v1/intents/${encodeURIComponent(intentId)}`);
+    }
+    async getAuthorityGraph() {
+        return this.request("GET", "/v1/authority/graph");
+    }
+    async getActionEvaluation(actionRequestId) {
+        return this.request("GET", `/v1/action-requests/${encodeURIComponent(actionRequestId)}/evaluation`);
+    }
+    async getRootIntentChain(actionRequestId) {
+        return this.request("GET", `/v1/action-requests/${encodeURIComponent(actionRequestId)}/root-intent`);
+    }
+    async listAgents() {
+        return this.request("GET", "/v1/agents");
+    }
+    async getAgent(agentId) {
+        return this.request("GET", `/v1/agents/${encodeURIComponent(agentId)}`);
+    }
+    async createAgent(input) {
+        return this.request("POST", "/v1/agents", {
+            name: input.name,
+            model_provider: input.modelProvider,
+            model_name: input.modelName,
+            description: input.description,
+            environment: input.environment,
+            authority_level: input.authorityLevel,
+            sponsor_user_id: input.sponsorUserId,
+        });
+    }
+    async listDelegations() {
+        return this.request("GET", "/v1/delegations");
+    }
+    async getDelegation(delegationId) {
+        return this.request("GET", `/v1/delegations/${encodeURIComponent(delegationId)}`);
+    }
+    async createDelegation(input) {
+        return this.request("POST", "/v1/delegations", {
+            agent_id: input.agentId,
+            action_types: input.actionTypes,
+            valid_until: input.validUntil,
+            max_amount: input.maxAmount,
+            max_count: input.maxCount,
+            environment: input.environment,
+            currency: input.currency,
+            delegator_user_id: input.delegatorUserId,
+        });
+    }
+    async revokeDelegation(delegationId) {
+        return this.request("POST", `/v1/delegations/${encodeURIComponent(delegationId)}/revoke`, {});
+    }
+    async listActionRequests() {
+        return this.request("GET", "/v1/action-requests");
+    }
+    async approveActionRequest(actionRequestId, approverUserId, reason) {
+        return this.resolveActionRequest(actionRequestId, "approve", approverUserId, reason);
+    }
+    async rejectActionRequest(actionRequestId, approverUserId, reason) {
+        return this.resolveActionRequest(actionRequestId, "reject", approverUserId, reason);
+    }
+    async escalateActionRequest(actionRequestId, approverUserId, reason) {
+        return this.resolveActionRequest(actionRequestId, "escalate", approverUserId, reason);
+    }
+    async resolveActionRequest(actionRequestId, action, approverUserId, reason) {
+        return this.request("POST", `/v1/action-requests/${encodeURIComponent(actionRequestId)}/${action}`, { reason, approver_user_id: approverUserId });
+    }
+    async listPolicies() {
+        return this.request("GET", "/v1/policies");
+    }
+    async createPolicy(input) {
+        return this.request("POST", "/v1/policies", {
+            name: input.name,
+            description: input.description,
+            policy_type: input.policyType,
+            status: input.status,
+            priority: input.priority,
+            action_type: input.actionType,
+            amount_greater_than: input.amountGreaterThan,
+            resource_sensitivity: input.resourceSensitivity,
+            external_recipient: input.externalRecipient,
+            environment: input.environment,
+            decision: input.decision,
+            approver_role: input.approverRole,
+        });
+    }
+    async listAuditEvents() {
+        return this.request("GET", "/v1/audit-events");
+    }
+    async listApiKeys() {
+        return this.request("GET", "/v1/api-keys");
+    }
+}

package/package.json

@@ -1,27 +1,37 @@
 {
   "name": "@auctra/sdk",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Authority delegation SDK for AI agents — evaluate agent actions against delegated authority and org policies",
   "homepage": "https://auctra.tech/docs",
   "bugs": {
     "url": "https://github.com/Matik103/auctra/issues"
   },
   "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/esm/index.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
+      "types": "./dist/esm/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js"
     }
   },
   "files": [
     "dist",
-    "README.md"
+    "src",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
   ],
   "scripts": {
-    "build": "tsc",
-    "prepublishOnly": "npm run build"
+    "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
+    "build": "npm run clean && tsc -p tsconfig.json && tsc -p tsconfig.cjs.json && node scripts/finalize-build.mjs",
+    "test": "npm run build && node --test test/*.test.mjs",
+    "check": "npm run test && npm pack --dry-run",
+    "publish:local": "npm publish --access public --provenance=false",
+    "prepublishOnly": "npm run check"
   },
   "repository": {
     "type": "git",