@auctra/sdk 0.3.5 → 0.6.1

package/dist/esm/index.js

@@ -1,331 +1,9 @@
-export const AUCTRA_SDK_VERSION = "0.3.5";
-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,
-            intent_anchor_token: input.intentAnchorToken,
-            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,
-            allowed_action_types: input.allowedActionTypes,
-            target_pattern: input.targetPattern,
-            resource_allowlist: input.resourceAllowlist,
-        });
-    }
-    async getIntent(intentId) {
-        return this.request("GET", `/v1/intents/${encodeURIComponent(intentId)}`);
-    }
-    async updateIntentStatus(intentId, status) {
-        return this.updateIntent(intentId, { status });
-    }
-    async updateIntent(intentId, input) {
-        return this.request("PATCH", `/v1/intents/${encodeURIComponent(intentId)}`, {
-            status: input.status,
-            title: input.title,
-            description: input.description,
-            intent_type: input.intentType,
-            risk_level: input.riskLevel,
-            max_risk_level: input.maxRiskLevel,
-            expires_at: input.expiresAt,
-        });
-    }
-    async getAuthorityGraph() {
-        return this.request("GET", "/v1/authority/graph");
-    }
-    async createAuthorityEdge(input) {
-        return this.request("POST", "/v1/authority/edges", {
-            from_actor_id: input.fromActorId,
-            from_actor_type: input.fromActorType,
-            to_actor_id: input.toActorId,
-            to_actor_type: input.toActorType,
-            authority_scope: input.authorityScope,
-            conditions: input.conditions,
-            max_risk_level: input.maxRiskLevel,
-            expires_at: input.expiresAt,
-        });
-    }
-    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 updateAgentStatus(agentId, input) {
-        return this.request("PATCH", `/v1/agents/${encodeURIComponent(agentId)}`, {
-            status: input.status,
-            reason: input.reason,
-            revoke_delegations: input.revokeDelegations,
-            restore_delegations: input.restoreDelegations,
-        });
-    }
-    async deleteAgent(agentId) {
-        return this.request("DELETE", `/v1/agents/${encodeURIComponent(agentId)}`);
-    }
-    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,
-            max_actions_per_window: input.maxActionsPerWindow
-                ? {
-                    count: input.maxActionsPerWindow.count,
-                    window_seconds: input.maxActionsPerWindow.windowSeconds,
-                    action_type: input.maxActionsPerWindow.actionType,
-                }
-                : undefined,
-            max_amount_per_window: input.maxAmountPerWindow
-                ? {
-                    amount: input.maxAmountPerWindow.amount,
-                    window_seconds: input.maxAmountPerWindow.windowSeconds,
-                }
-                : undefined,
-        });
-    }
-    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,
-            max_actions_per_window: input.maxActionsPerWindow
-                ? {
-                    count: input.maxActionsPerWindow.count,
-                    window_seconds: input.maxActionsPerWindow.windowSeconds,
-                    action_type: input.maxActionsPerWindow.actionType,
-                }
-                : undefined,
-            max_amount_per_window: input.maxAmountPerWindow
-                ? {
-                    amount: input.maxAmountPerWindow.amount,
-                    window_seconds: input.maxAmountPerWindow.windowSeconds,
-                }
-                : undefined,
-        });
-    }
-    async simulatePolicy(policyId, input = {}) {
-        return this.request("POST", `/v1/policies/${encodeURIComponent(policyId)}/simulate`, input);
-    }
-    async publishPolicy(policyId, input = {}) {
-        return this.request("POST", `/v1/policies/${encodeURIComponent(policyId)}/publish`, input);
-    }
-    async listActionTypes() {
-        return this.listCustomActionTypes();
-    }
-    async listCustomActionTypes() {
-        return this.request("GET", "/v1/action-types");
-    }
-    async createCustomActionType(input) {
-        return this.request("POST", "/v1/action-types", {
-            id: input.id,
-            label: input.label,
-            description: input.description,
-            category: input.category,
-            policy_type: input.policyType,
-            payload_schema: input.payloadSchema ?? {},
-        });
-    }
-    async listAuditEvents() {
-        return this.request("GET", "/v1/audit-events");
-    }
-    async listApiKeys() {
-        return this.request("GET", "/v1/api-keys");
-    }
-}
+/**
+ * @auctra/sdk — Stage 1.0 public surface.
+ *
+ * Modular layout under src/{types,artifacts,client,authority,action,evidence}.ts.
+ * Canonical API: authority.* / action.* / evidence.* — no createDelegation / evaluateAction.
+ */
+export { AUCTRA_SDK_VERSION } from "./types.js";
+export { AuctraApiError, verifyMandateArtifact, verifyDecisionArtifact } from "./artifacts.js";
+export { Auctra } from "./client.js";