@agledger/sdk 1.1.0 → 2.0.0

package/dist/client.d.ts

@@ -20,6 +20,7 @@ import { AdminResource } from './resources/admin.js';
 import { A2aResource } from './resources/a2a.js';
 import { CapabilitiesResource } from './resources/capabilities.js';
 import { NotarizeResource } from './resources/notarize.js';
+import { EnterprisesResource } from './resources/enterprises.js';
 export declare class AgledgerClient {
     private readonly http;
     readonly mandates: MandatesResource;
@@ -39,6 +40,7 @@ export declare class AgledgerClient {
     readonly a2a: A2aResource;
     readonly capabilities: CapabilitiesResource;
     readonly notarize: NotarizeResource;
+    readonly enterprises: EnterprisesResource;
     /** Rate limit info from the most recent API response. Null if headers not present. */
     get rateLimitInfo(): RateLimitInfo | null;
     constructor(options: AgledgerClientOptions);

package/dist/client.js

@@ -20,6 +20,7 @@ import { AdminResource } from './resources/admin.js';
 import { A2aResource } from './resources/a2a.js';
 import { CapabilitiesResource } from './resources/capabilities.js';
 import { NotarizeResource } from './resources/notarize.js';
+import { EnterprisesResource } from './resources/enterprises.js';
 export class AgledgerClient {
     http;
     mandates;
@@ -39,6 +40,7 @@ export class AgledgerClient {
     a2a;
     capabilities;
     notarize;
+    enterprises;
     /** Rate limit info from the most recent API response. Null if headers not present. */
     get rateLimitInfo() {
         return this.http.rateLimitInfo;
@@ -63,6 +65,7 @@ export class AgledgerClient {
         this.a2a = new A2aResource(http);
         this.capabilities = new CapabilitiesResource(http);
         this.notarize = new NotarizeResource(http);
+        this.enterprises = new EnterprisesResource(http);
     }
 }
 //# sourceMappingURL=client.js.map

package/dist/errors.d.ts

@@ -25,6 +25,8 @@ export declare class AgledgerApiError extends AgledgerError {
     readonly code: string;
     readonly requestId?: string;
     readonly details?: ValidationErrorDetail[] | Record<string, unknown>;
+    /** Link to documentation for this error code. */
+    readonly docUrl: string;
     /**
      * Whether this error is retryable.
      * - Uses the API's `retryable` field if present
@@ -32,6 +34,14 @@ export declare class AgledgerApiError extends AgledgerError {
      */
     readonly retryable: boolean;
     constructor(status: number, body: ApiErrorResponse);
+    /** Whether this error is retryable (429, 5xx, network errors). Delegates to the `retryable` property. */
+    isRetryable(): boolean;
+    /** Whether this is an input error (400) — the request itself is malformed; fix it and retry. */
+    isInputError(): boolean;
+    /** Whether this is a state error (422) — the resource is in the wrong state; do not retry the same request. */
+    isStateError(): boolean;
+    /** Whether this is an auth error (401/403) — check credentials or scopes. */
+    isAuthError(): boolean;
     /** Field-level validation errors, normalized from various API formats. */
     get validationErrors(): ValidationErrorDetail[];
 }
@@ -39,6 +49,10 @@ export declare class AuthenticationError extends AgledgerApiError {
     constructor(body: ApiErrorResponse);
 }
 export declare class PermissionError extends AgledgerApiError {
+    /** Scopes required by the endpoint but missing from the key. Empty if not a scope error. */
+    readonly missingScopes: string[];
+    /** Scopes the key has. Null if not included in the response. */
+    readonly keyScopes: string[] | null;
     constructor(body: ApiErrorResponse);
 }
 export declare class NotFoundError extends AgledgerApiError {

package/dist/errors.js

@@ -27,6 +27,8 @@ export class AgledgerApiError extends AgledgerError {
     code;
     requestId;
     details;
+    /** Link to documentation for this error code. */
+    docUrl;
     /**
      * Whether this error is retryable.
      * - Uses the API's `retryable` field if present
@@ -41,6 +43,23 @@ export class AgledgerApiError extends AgledgerError {
         this.requestId = body.requestId;
         this.details = body.details;
         this.retryable = body.retryable ?? (status === 429 || status >= 500);
+        this.docUrl = `https://docs.agledger.ai/errors/${this.code}`;
+    }
+    /** Whether this error is retryable (429, 5xx, network errors). Delegates to the `retryable` property. */
+    isRetryable() {
+        return this.retryable;
+    }
+    /** Whether this is an input error (400) — the request itself is malformed; fix it and retry. */
+    isInputError() {
+        return this.status === 400;
+    }
+    /** Whether this is a state error (422) — the resource is in the wrong state; do not retry the same request. */
+    isStateError() {
+        return this.status === 422;
+    }
+    /** Whether this is an auth error (401/403) — check credentials or scopes. */
+    isAuthError() {
+        return this.status === 401 || this.status === 403;
     }
     /** Field-level validation errors, normalized from various API formats. */
     get validationErrors() {
@@ -66,9 +85,16 @@ export class AuthenticationError extends AgledgerApiError {
     }
 }
 export class PermissionError extends AgledgerApiError {
+    /** Scopes required by the endpoint but missing from the key. Empty if not a scope error. */
+    missingScopes;
+    /** Scopes the key has. Null if not included in the response. */
+    keyScopes;
     constructor(body) {
         super(403, body);
         this.name = 'PermissionError';
+        const details = body.details;
+        this.missingScopes = Array.isArray(details?.missingScopes) ? details.missingScopes : [];
+        this.keyScopes = Array.isArray(details?.keyScopes) ? details.keyScopes : null;
     }
 }
 export class NotFoundError extends AgledgerApiError {

package/dist/http.d.ts

@@ -18,8 +18,9 @@ export declare class HttpClient {
     constructor(options: AgledgerClientOptions);
     get<T>(path: string, params?: Record<string, unknown>, options?: RequestOptions): Promise<T>;
     post<T>(path: string, body?: unknown, options?: RequestOptions): Promise<T>;
+    put<T>(path: string, body?: unknown, options?: RequestOptions): Promise<T>;
     patch<T>(path: string, body?: unknown, options?: RequestOptions): Promise<T>;
-    delete<T>(path: string, options?: RequestOptions): Promise<T>;
+    delete<T>(path: string, body?: unknown, options?: RequestOptions): Promise<T>;
     /**
      * Fetch a list endpoint and normalize the response into Page<T>.
      * Handles both current inconsistent responses (bare arrays, various envelope shapes)

package/dist/http.js

@@ -42,13 +42,17 @@ export class HttpClient {
         const url = this.buildUrl(path);
         return this.request('POST', url, body, options);
     }
+    async put(path, body, options) {
+        const url = this.buildUrl(path);
+        return this.request('PUT', url, body, options);
+    }
     async patch(path, body, options) {
         const url = this.buildUrl(path);
         return this.request('PATCH', url, body, options);
     }
-    async delete(path, options) {
+    async delete(path, body, options) {
         const url = this.buildUrl(path);
-        return this.request('DELETE', url, undefined, options);
+        return this.request('DELETE', url, body, options);
     }
     /**
      * Fetch a list endpoint and normalize the response into Page<T>.
@@ -101,7 +105,7 @@ export class HttpClient {
     }
     async request(method, url, body, options) {
         // Idempotency keys for all mutating methods
-        const needsIdempotencyKey = method === 'POST' || method === 'PATCH' || method === 'DELETE';
+        const needsIdempotencyKey = method === 'POST' || method === 'PUT' || method === 'PATCH' || method === 'DELETE';
         const idempotencyKey = options?.idempotencyKey ??
             (needsIdempotencyKey
                 ? `${this.idempotencyKeyPrefix}${crypto.randomUUID()}`

package/dist/index.d.ts

@@ -6,7 +6,7 @@
  * @packageDocumentation
  */
 export { AgledgerClient } from './client.js';
-export type { AgledgerClientOptions, RequestOptions, ListParams, Page, AutoPaginateOptions, BatchResult, BulkCreateResult, ContractType, ContractSchema, SchemaValidationResult, Denomination, ProcurementCriteria, DeliverableCriteria, DataProcessingCriteria, TransactionCriteria, OrchestrationCriteria, CommunicationCriteria, AuthorizationCriteria, InfrastructureCriteria, DestructiveCriteria, ProcurementEvidence, DeliverableEvidence, DataProcessingEvidence, TransactionEvidence, OrchestrationEvidence, CommunicationEvidence, AuthorizationEvidence, InfrastructureEvidence, DestructiveEvidence, CriteriaMap, EvidenceMap, CriteriaFor, EvidenceFor, TypedCreateMandateParams, TypedSubmitReceiptParams, MandateStatus, MandateTransitionAction, OperatingMode, RiskClassification, Mandate, CreateMandateParams, UpdateMandateParams, ListMandatesParams, SearchMandatesParams, DelegateMandateParams, CreateAgentMandateParams, RespondToMandateParams, ReceiptStatus, Receipt, SubmitReceiptParams, UpdateReceiptParams, VerificationOutcome, SettlementSignal, VerificationResult, VerificationStatus, DisputeStatus, Dispute, CreateDisputeParams, ResolveDisputeParams, WebhookEventType, Webhook, CreateWebhookParams, UpdateWebhookParams, WebhookDelivery, WebhookTestResult, ReputationTier, ReputationScore, ReputationHistoryEntry, AgledgerEvent, AuditChain, RateLimitInfo, DashboardSummary, DashboardMetrics, DashboardMetricsParams, DashboardAgent, DashboardAgentParams, ComplianceExport, ExportComplianceParams, AiImpactAssessment, CreateAiImpactAssessmentParams, EuAiActReport, AccountType, AccountProfile, RegisterParams, RegisterResult, HealthResponse, StatusComponent, StatusResponse, ConformanceResponse, AdminEnterprise, AdminAgent, AdminApiKey, WebhookDlqEntry, SystemHealth, UpdateTrustLevelParams, SetCapabilitiesParams, AgentCard, JsonRpcRequest, JsonRpcResponse, ProxyMode, InterceptorAction, ConfidenceLevel, SidecarMandateStatus, SessionOutcome, ProxySession, CreateSessionParams, ToolCallBatchItem, SidecarMandateBatchItem, SidecarReceiptBatchItem, ToolCatalogBatchItem, SyncSessionParams, SyncSessionResult, ProxySidecarMandate, ProxySidecarReceipt, ProxyToolCall, ProxyToolCatalogEntry, UpdateSidecarMandateParams, SessionAnalytics, AnalyticsSummary, MandateSummary, AlignmentAnalysis, NotarizeStatus, NotarizedMandate, NotarizeTransition, NotarizeMandateParams, NotarizeMandateResult, NotarizeCounterProposeParams, NotarizeReceiptParams, NotarizeReceiptResult, NotarizeVerdictParams, NotarizeVerifyParams, NotarizeVerifyResult, NotarizeHistory, ApiErrorResponse, ValidationErrorDetail, 
+export type { AgledgerClientOptions, RequestOptions, ListParams, Page, AutoPaginateOptions, BatchResult, BulkCreateResult, ContractType, ContractSchema, SchemaValidationResult, Denomination, ProcurementCriteria, DeliverableCriteria, DataProcessingCriteria, TransactionCriteria, OrchestrationCriteria, CommunicationCriteria, AuthorizationCriteria, InfrastructureCriteria, DestructiveCriteria, ProcurementEvidence, DeliverableEvidence, DataProcessingEvidence, TransactionEvidence, OrchestrationEvidence, CommunicationEvidence, AuthorizationEvidence, InfrastructureEvidence, DestructiveEvidence, CriteriaMap, EvidenceMap, CriteriaFor, EvidenceFor, TypedCreateMandateParams, TypedSubmitReceiptParams, MandateStatus, MandateTransitionAction, OperatingMode, VerificationMode, RiskClassification, Mandate, CreateMandateParams, UpdateMandateParams, ListMandatesParams, SearchMandatesParams, DelegateMandateParams, CreateAgentMandateParams, RespondToMandateParams, ReceiptStatus, Receipt, SubmitReceiptParams, UpdateReceiptParams, VerificationOutcome, SettlementSignal, VerificationResult, VerificationStatus, DisputeStatus, Dispute, CreateDisputeParams, ResolveDisputeParams, WebhookEventType, Webhook, CreateWebhookParams, UpdateWebhookParams, WebhookDelivery, WebhookTestResult, ReputationTier, ReputationScore, ReputationHistoryEntry, AgledgerEvent, AuditChain, RateLimitInfo, DashboardSummary, DashboardMetrics, DashboardMetricsParams, DashboardAgent, DashboardAgentParams, ComplianceExport, ExportComplianceParams, AiImpactAssessment, CreateAiImpactAssessmentParams, EuAiActReport, AccountType, AccountProfile, RegisterParams, RegisterResult, HealthResponse, StatusComponent, StatusResponse, ConformanceResponse, AdminEnterprise, AdminAgent, AdminApiKey, CreateApiKeyParams, CreateApiKeyResult, WebhookDlqEntry, SystemHealth, UpdateTrustLevelParams, SetCapabilitiesParams, AgentCard, JsonRpcRequest, JsonRpcResponse, ProxyMode, InterceptorAction, ConfidenceLevel, SidecarMandateStatus, SessionOutcome, ProxySession, CreateSessionParams, ToolCallBatchItem, SidecarMandateBatchItem, SidecarReceiptBatchItem, ToolCatalogBatchItem, SyncSessionParams, SyncSessionResult, ProxySidecarMandate, ProxySidecarReceipt, ProxyToolCall, ProxyToolCatalogEntry, UpdateSidecarMandateParams, SessionAnalytics, AnalyticsSummary, MandateSummary, AlignmentAnalysis, NotarizeStatus, NotarizedMandate, NotarizeTransition, NotarizeMandateParams, NotarizeMandateResult, NotarizeCounterProposeParams, NotarizeReceiptParams, NotarizeReceiptResult, NotarizeVerdictParams, NotarizeVerifyParams, NotarizeVerifyResult, NotarizeHistory, EnterpriseAgentStatus, EnterpriseAgentRecord, ApprovalConfig, ApproveAgentParams, RevokeAgentParams, UpdateAgentStatusParams, BulkApproveAgentParams, BulkApproveResult, ListEnterpriseAgentsParams, ApiErrorResponse, ValidationErrorDetail, 
 /** @deprecated Use `ListParams` */
 PaginationParams, 
 /** @deprecated Use `Page<T>` */
@@ -16,4 +16,8 @@ CursorPaginatedResponse,
 /** @deprecated Use `AgledgerEvent` */
 AuditEvent, } from './types.js';
 export { AgledgerError, AgledgerApiError, AuthenticationError, PermissionError, NotFoundError, ValidationError, UnprocessableError, RateLimitError, ConnectionError, TimeoutError, } from './errors.js';
+export { Scopes, ScopeProfiles } from './scopes.js';
+export type { Scope, ScopeProfile, ScopeProfileName } from './scopes.js';
+export { MANDATE_TRANSITIONS, TERMINAL_STATUSES, canTransitionTo, getValidTransitions, isTerminalStatus, } from './mandate-lifecycle.js';
+export { mandateToContext, receiptToContext, errorToContext } from './prompt-context.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -9,4 +9,10 @@
 export { AgledgerClient } from './client.js';
 // Error classes
 export { AgledgerError, AgledgerApiError, AuthenticationError, PermissionError, NotFoundError, ValidationError, UnprocessableError, RateLimitError, ConnectionError, TimeoutError, } from './errors.js';
+// Scopes
+export { Scopes, ScopeProfiles } from './scopes.js';
+// Mandate State Machine
+export { MANDATE_TRANSITIONS, TERMINAL_STATUSES, canTransitionTo, getValidTransitions, isTerminalStatus, } from './mandate-lifecycle.js';
+// Prompt Context Builders
+export { mandateToContext, receiptToContext, errorToContext } from './prompt-context.js';
 //# sourceMappingURL=index.js.map

package/dist/mandate-lifecycle.d.ts

@@ -0,0 +1,23 @@
+/**
+ * AGLedger™ SDK — Mandate State Machine
+ * Patent Pending. Copyright 2026 AGLedger LLC. All rights reserved.
+ *
+ * Pure logic, zero dependencies. Mirrors the API's state machine.
+ */
+import type { MandateStatus } from './types.js';
+/**
+ * Valid state transitions for mandates. Each key is a status, and its value
+ * is the list of statuses it can transition to.
+ *
+ * Unknown statuses return empty arrays for forward compatibility.
+ */
+export declare const MANDATE_TRANSITIONS: Record<string, readonly string[]>;
+/** Statuses with no outbound transitions. */
+export declare const TERMINAL_STATUSES: readonly string[];
+/** Check whether a transition from `current` to `target` is valid. Unknown statuses return false. */
+export declare function canTransitionTo(current: MandateStatus, target: MandateStatus): boolean;
+/** Get valid next statuses for a given status. Unknown statuses return []. */
+export declare function getValidTransitions(status: MandateStatus): readonly string[];
+/** Check whether a status is terminal (no outbound transitions). Unknown statuses return false. */
+export declare function isTerminalStatus(status: MandateStatus): boolean;
+//# sourceMappingURL=mandate-lifecycle.d.ts.map

package/dist/mandate-lifecycle.js

@@ -0,0 +1,54 @@
+/**
+ * AGLedger™ SDK — Mandate State Machine
+ * Patent Pending. Copyright 2026 AGLedger LLC. All rights reserved.
+ *
+ * Pure logic, zero dependencies. Mirrors the API's state machine.
+ */
+/**
+ * Valid state transitions for mandates. Each key is a status, and its value
+ * is the list of statuses it can transition to.
+ *
+ * Unknown statuses return empty arrays for forward compatibility.
+ */
+export const MANDATE_TRANSITIONS = {
+    DRAFT: ['REGISTERED', 'PROPOSED', 'CANCELLED_DRAFT'],
+    PROPOSED: ['REGISTERED', 'REJECTED', 'CANCELLED_DRAFT', 'PROPOSED'],
+    REGISTERED: ['ACTIVE', 'CANCELLED_PRE_WORK'],
+    ACTIVE: ['RECEIPT_ACCEPTED', 'RECEIPT_INVALID', 'EXPIRED', 'CANCELLED_PRE_WORK', 'CANCELLED_IN_PROGRESS'],
+    RECEIPT_INVALID: ['RECEIPT_ACCEPTED', 'RECEIPT_INVALID', 'EXPIRED', 'CANCELLED_IN_PROGRESS'],
+    RECEIPT_ACCEPTED: ['VERIFYING'],
+    VERIFYING: ['VERIFIED_PASS', 'VERIFIED_FAIL'],
+    VERIFIED_PASS: ['FULFILLED', 'VERIFIED_FAIL'],
+    VERIFIED_FAIL: ['REMEDIATED', 'VERIFIED_PASS', 'REVISION_REQUESTED'],
+    REVISION_REQUESTED: ['RECEIPT_ACCEPTED', 'RECEIPT_INVALID', 'EXPIRED', 'CANCELLED_IN_PROGRESS'],
+    FULFILLED: [],
+    REMEDIATED: [],
+    EXPIRED: [],
+    CANCELLED_DRAFT: [],
+    CANCELLED_PRE_WORK: [],
+    CANCELLED_IN_PROGRESS: [],
+    REJECTED: [],
+};
+/** Statuses with no outbound transitions. */
+export const TERMINAL_STATUSES = Object.entries(MANDATE_TRANSITIONS)
+    .filter(([, targets]) => targets.length === 0)
+    .map(([status]) => status);
+/** Check whether a transition from `current` to `target` is valid. Unknown statuses return false. */
+export function canTransitionTo(current, target) {
+    const targets = MANDATE_TRANSITIONS[current];
+    if (!targets)
+        return false;
+    return targets.includes(target);
+}
+/** Get valid next statuses for a given status. Unknown statuses return []. */
+export function getValidTransitions(status) {
+    return MANDATE_TRANSITIONS[status] ?? [];
+}
+/** Check whether a status is terminal (no outbound transitions). Unknown statuses return false. */
+export function isTerminalStatus(status) {
+    const targets = MANDATE_TRANSITIONS[status];
+    if (!targets)
+        return false;
+    return targets.length === 0;
+}
+//# sourceMappingURL=mandate-lifecycle.js.map

package/dist/prompt-context.d.ts

@@ -0,0 +1,16 @@
+/**
+ * AGLedger™ SDK — Prompt Context Builders
+ * Patent Pending. Copyright 2026 AGLedger LLC. All rights reserved.
+ *
+ * LLM-friendly compact summaries for mandates, receipts, and errors.
+ * Zero dependencies beyond types.
+ */
+import type { Mandate, Receipt } from './types.js';
+import type { AgledgerApiError } from './errors.js';
+/** Compact one-line summary of a mandate for LLM context injection. */
+export declare function mandateToContext(m: Mandate): string;
+/** Compact one-line summary of a receipt for LLM context injection. */
+export declare function receiptToContext(r: Receipt): string;
+/** Compact error summary with actionable guidance for LLM agents. */
+export declare function errorToContext(e: AgledgerApiError): string;
+//# sourceMappingURL=prompt-context.d.ts.map

package/dist/prompt-context.js

@@ -0,0 +1,47 @@
+/**
+ * AGLedger™ SDK — Prompt Context Builders
+ * Patent Pending. Copyright 2026 AGLedger LLC. All rights reserved.
+ *
+ * LLM-friendly compact summaries for mandates, receipts, and errors.
+ * Zero dependencies beyond types.
+ */
+import { RateLimitError } from './errors.js';
+/** Compact one-line summary of a mandate for LLM context injection. */
+export function mandateToContext(m) {
+    const parts = [`Mandate ${m.id} [${m.contractType}] status=${m.status}`];
+    if (m.agentId)
+        parts.push(`agent=${m.agentId}`);
+    if (m.deadline)
+        parts.push(`deadline=${m.deadline}`);
+    if (m.parentMandateId)
+        parts.push(`parent=${m.parentMandateId}`);
+    return parts.join(' ');
+}
+/** Compact one-line summary of a receipt for LLM context injection. */
+export function receiptToContext(r) {
+    const parts = [`Receipt ${r.id} for mandate ${r.mandateId} status=${r.status}`];
+    if (r.verificationOutcome)
+        parts.push(`outcome=${r.verificationOutcome}`);
+    if (r.agentId)
+        parts.push(`agent=${r.agentId}`);
+    return parts.join(' ');
+}
+/** Compact error summary with actionable guidance for LLM agents. */
+export function errorToContext(e) {
+    const code = e.code !== 'unknown' ? ` [${e.code}]` : '';
+    const base = `Error ${e.status}${code}: ${e.message}`;
+    if (e.isRetryable()) {
+        if (e instanceof RateLimitError && e.retryAfter != null) {
+            return base + ` Retry after ${e.retryAfter}s.`;
+        }
+        return base + ' Retryable.';
+    }
+    if (e.isStateError())
+        return base + ' Do not retry.';
+    if (e.isAuthError())
+        return base + ' Check credentials/scopes.';
+    if (e.isInputError())
+        return base + ' Fix the request and retry.';
+    return base;
+}
+//# sourceMappingURL=prompt-context.js.map

package/dist/resources/admin.d.ts

@@ -5,35 +5,42 @@
  * Platform-only operations. Requires platform-level API key.
  */
 import type { HttpClient } from '../http.js';
-import type { AdminEnterprise, AdminAgent, AdminApiKey, WebhookDlqEntry, SystemHealth, UpdateTrustLevelParams, SetCapabilitiesParams, Page, ListParams, RequestOptions, ContractType } from '../types.js';
+import type { AdminEnterprise, AdminAgent, AdminApiKey, WebhookDlqEntry, SystemHealth, UpdateTrustLevelParams, SetCapabilitiesParams, Page, ListParams, RequestOptions, ContractType, CreateApiKeyParams, CreateApiKeyResult } from '../types.js';
 export declare class AdminResource {
     private readonly http;
     constructor(http: HttpClient);
+    /** List all enterprises on the platform. */
     listEnterprises(params?: ListParams, options?: RequestOptions): Promise<Page<AdminEnterprise>>;
+    /** List all registered agents on the platform. */
     listAgents(params?: ListParams, options?: RequestOptions): Promise<Page<AdminAgent>>;
+    /** Update an account's trust level (sandbox, active, verified). */
     updateTrustLevel(accountId: string, params: UpdateTrustLevelParams, options?: RequestOptions): Promise<Record<string, unknown>>;
+    /** Set an agent's contract type capabilities. */
     setCapabilities(agentId: string, params: SetCapabilitiesParams, options?: RequestOptions): Promise<Record<string, unknown>>;
+    /** Get capabilities of all agents in the fleet. */
     getFleetCapabilities(options?: RequestOptions): Promise<Page<{
         agentId: string;
         capabilities: ContractType[];
     }>>;
+    /** List all API keys on the platform. */
     listApiKeys(params?: ListParams, options?: RequestOptions): Promise<Page<AdminApiKey>>;
-    createApiKey(params: {
-        ownerId: string;
-        ownerType: string;
-    }, options?: RequestOptions): Promise<{
-        apiKey: string;
-        keyId: string;
-    }>;
+    /** Create a new API key with optional scopes or scope profile. */
+    createApiKey(params: CreateApiKeyParams, options?: RequestOptions): Promise<CreateApiKeyResult>;
+    /** Enable or disable an API key. */
     toggleApiKey(keyId: string, active: boolean, options?: RequestOptions): Promise<AdminApiKey>;
+    /** Revoke multiple API keys at once. */
     bulkRevokeApiKeys(keyIds: string[], options?: RequestOptions): Promise<{
         revoked: number;
     }>;
+    /** List webhook dead-letter queue entries. */
     listDlq(params?: ListParams, options?: RequestOptions): Promise<Page<WebhookDlqEntry>>;
+    /** Retry a single dead-letter queue entry. */
     retryDlq(dlqId: string, options?: RequestOptions): Promise<Record<string, unknown>>;
+    /** Retry all dead-letter queue entries. */
     retryAllDlq(options?: RequestOptions): Promise<{
         retried: number;
     }>;
+    /** Get system health metrics (platform admin). */
     getSystemHealth(options?: RequestOptions): Promise<SystemHealth>;
 }
 //# sourceMappingURL=admin.d.ts.map

package/dist/resources/admin.js

@@ -9,47 +9,55 @@ export class AdminResource {
     constructor(http) {
         this.http = http;
     }
-    // --- Enterprises ---
+    /** List all enterprises on the platform. */
     async listEnterprises(params, options) {
         return this.http.getPage('/v1/admin/enterprises', params, options);
     }
-    // --- Agents ---
+    /** List all registered agents on the platform. */
     async listAgents(params, options) {
         return this.http.getPage('/v1/admin/agents', params, options);
     }
+    /** Update an account's trust level (sandbox, active, verified). */
     async updateTrustLevel(accountId, params, options) {
         return this.http.patch(`/v1/admin/accounts/${accountId}/trust-level`, params, options);
     }
+    /** Set an agent's contract type capabilities. */
     async setCapabilities(agentId, params, options) {
         return this.http.patch(`/v1/admin/agents/${agentId}/capabilities`, params, options);
     }
+    /** Get capabilities of all agents in the fleet. */
     async getFleetCapabilities(options) {
         return this.http.getPage('/v1/admin/agents/capabilities', undefined, options);
     }
-    // --- API Keys ---
+    /** List all API keys on the platform. */
     async listApiKeys(params, options) {
         return this.http.getPage('/v1/admin/api-keys', params, options);
     }
+    /** Create a new API key with optional scopes or scope profile. */
     async createApiKey(params, options) {
         return this.http.post('/v1/admin/api-keys', params, options);
     }
+    /** Enable or disable an API key. */
     async toggleApiKey(keyId, active, options) {
         return this.http.patch(`/v1/admin/api-keys/${keyId}`, { active }, options);
     }
+    /** Revoke multiple API keys at once. */
     async bulkRevokeApiKeys(keyIds, options) {
         return this.http.post('/v1/admin/api-keys/bulk-revoke', { keyIds }, options);
     }
-    // --- Webhook DLQ ---
+    /** List webhook dead-letter queue entries. */
     async listDlq(params, options) {
         return this.http.getPage('/v1/admin/webhook-dlq', params, options);
     }
+    /** Retry a single dead-letter queue entry. */
     async retryDlq(dlqId, options) {
         return this.http.post(`/v1/admin/webhook-dlq/${dlqId}/retry`, undefined, options);
     }
+    /** Retry all dead-letter queue entries. */
     async retryAllDlq(options) {
         return this.http.post('/v1/admin/webhook-dlq/retry-all', undefined, options);
     }
-    // --- System Health ---
+    /** Get system health metrics (platform admin). */
     async getSystemHealth(options) {
         return this.http.get('/v1/admin/system-health', undefined, options);
     }

package/dist/resources/compliance.d.ts

@@ -7,7 +7,9 @@ import type { ComplianceExport, ExportComplianceParams, AiImpactAssessment, Crea
 export declare class ComplianceResource {
     private readonly http;
     constructor(http: HttpClient);
+    /** Start a compliance data export. */
     export(params: ExportComplianceParams, options?: RequestOptions): Promise<ComplianceExport>;
+    /** Check the status of a compliance export. */
     getExportStatus(exportId: string, options?: RequestOptions): Promise<ComplianceExport>;
     /**
      * Poll until a compliance export is ready or timeout.
@@ -18,17 +20,22 @@ export declare class ComplianceResource {
         timeoutMs?: number;
         signal?: AbortSignal;
     }): Promise<ComplianceExport>;
+    /** Create an AI impact assessment for a mandate (EU AI Act). */
     createAssessment(mandateId: string, params: CreateAiImpactAssessmentParams, options?: RequestOptions): Promise<AiImpactAssessment>;
+    /** Get the AI impact assessment for a mandate. */
     getAssessment(mandateId: string, options?: RequestOptions): Promise<AiImpactAssessment>;
+    /** Get the EU AI Act compliance report for the enterprise. */
     getEuAiActReport(params?: {
         from?: string;
         to?: string;
     }, options?: RequestOptions): Promise<EuAiActReport>;
+    /** Get the enterprise audit report. */
     getEnterpriseReport(params?: {
         from?: string;
         to?: string;
         format?: string;
     }, options?: RequestOptions): Promise<Record<string, unknown>>;
+    /** Trigger LLM-powered audit analysis for a mandate. */
     analyzeAudit(mandateId: string, options?: RequestOptions): Promise<Record<string, unknown>>;
 }
 //# sourceMappingURL=compliance.d.ts.map

package/dist/resources/compliance.js

@@ -7,10 +7,11 @@ export class ComplianceResource {
     constructor(http) {
         this.http = http;
     }
-    // --- Compliance Export ---
+    /** Start a compliance data export. */
     async export(params, options) {
         return this.http.post('/v1/compliance/export', params, options);
     }
+    /** Check the status of a compliance export. */
     async getExportStatus(exportId, options) {
         return this.http.get(`/v1/compliance/export/${exportId}`, undefined, options);
     }
@@ -33,20 +34,23 @@ export class ComplianceResource {
         }
         throw new Error(`Export ${exportId} did not complete within ${timeout}ms`);
     }
-    // --- EU AI Act ---
+    /** Create an AI impact assessment for a mandate (EU AI Act). */
     async createAssessment(mandateId, params, options) {
         return this.http.post(`/v1/mandates/${mandateId}/ai-impact-assessment`, params, options);
     }
+    /** Get the AI impact assessment for a mandate. */
     async getAssessment(mandateId, options) {
         return this.http.get(`/v1/mandates/${mandateId}/ai-impact-assessment`, undefined, options);
     }
+    /** Get the EU AI Act compliance report for the enterprise. */
     async getEuAiActReport(params, options) {
         return this.http.get('/v1/compliance/eu-ai-act/report', params, options);
     }
-    // --- Audit Reports ---
+    /** Get the enterprise audit report. */
     async getEnterpriseReport(params, options) {
         return this.http.get('/v1/audit/enterprise-report', params, options);
     }
+    /** Trigger LLM-powered audit analysis for a mandate. */
     async analyzeAudit(mandateId, options) {
         return this.http.post('/v1/audit/enterprise-report/analyze', { mandateId }, options);
     }

package/dist/resources/dashboard.d.ts

@@ -7,8 +7,11 @@ import type { DashboardSummary, DashboardMetrics, DashboardMetricsParams, Dashbo
 export declare class DashboardResource {
     private readonly http;
     constructor(http: HttpClient);
+    /** Get a high-level dashboard summary (mandate counts, active agents, etc.). */
     getSummary(options?: RequestOptions): Promise<DashboardSummary>;
+    /** Get dashboard metrics over a time range. */
     getMetrics(params?: DashboardMetricsParams, options?: RequestOptions): Promise<DashboardMetrics>;
+    /** List agents with dashboard-level activity stats. */
     listAgents(params?: DashboardAgentParams, options?: RequestOptions): Promise<Page<DashboardAgent>>;
 }
 //# sourceMappingURL=dashboard.d.ts.map

package/dist/resources/dashboard.js

@@ -7,12 +7,15 @@ export class DashboardResource {
     constructor(http) {
         this.http = http;
     }
+    /** Get a high-level dashboard summary (mandate counts, active agents, etc.). */
     async getSummary(options) {
         return this.http.get('/v1/dashboard/summary', undefined, options);
     }
+    /** Get dashboard metrics over a time range. */
     async getMetrics(params, options) {
         return this.http.get('/v1/dashboard/metrics', params, options);
     }
+    /** List agents with dashboard-level activity stats. */
     async listAgents(params, options) {
         return this.http.getPage('/v1/dashboard/agents', params, options);
     }

package/dist/resources/disputes.d.ts

@@ -7,10 +7,15 @@ import type { Dispute, CreateDisputeParams, ResolveDisputeParams, RequestOptions
 export declare class DisputesResource {
     private readonly http;
     constructor(http: HttpClient);
+    /** Create a dispute on a mandate. */
     create(mandateId: string, params: CreateDisputeParams, options?: RequestOptions): Promise<Dispute>;
+    /** Get the dispute for a mandate. */
     get(mandateId: string, options?: RequestOptions): Promise<Dispute>;
+    /** Escalate a dispute to the next review tier. */
     escalate(mandateId: string, reason: string, options?: RequestOptions): Promise<Dispute>;
+    /** Submit additional evidence for a dispute. */
     submitEvidence(mandateId: string, evidence: Record<string, unknown>, options?: RequestOptions): Promise<Dispute>;
+    /** Resolve a dispute with a resolution and optional amount. */
     resolve(mandateId: string, params: ResolveDisputeParams, options?: RequestOptions): Promise<Dispute>;
 }
 //# sourceMappingURL=disputes.d.ts.map

package/dist/resources/disputes.js

@@ -7,18 +7,23 @@ export class DisputesResource {
     constructor(http) {
         this.http = http;
     }
+    /** Create a dispute on a mandate. */
     async create(mandateId, params, options) {
         return this.http.post(`/v1/mandates/${mandateId}/dispute`, params, options);
     }
+    /** Get the dispute for a mandate. */
     async get(mandateId, options) {
         return this.http.get(`/v1/mandates/${mandateId}/dispute`, undefined, options);
     }
+    /** Escalate a dispute to the next review tier. */
     async escalate(mandateId, reason, options) {
         return this.http.post(`/v1/mandates/${mandateId}/dispute/escalate`, { reason }, options);
     }
+    /** Submit additional evidence for a dispute. */
     async submitEvidence(mandateId, evidence, options) {
         return this.http.post(`/v1/mandates/${mandateId}/dispute/evidence`, evidence, options);
     }
+    /** Resolve a dispute with a resolution and optional amount. */
     async resolve(mandateId, params, options) {
         return this.http.post(`/v1/mandates/${mandateId}/dispute/resolve`, params, options);
     }

package/dist/resources/enterprises.d.ts

@@ -0,0 +1,27 @@
+/**
+ * AGLedger™ SDK — Enterprises Resource (Agent Approval Registry)
+ * Patent Pending. Copyright 2026 AGLedger LLC. All rights reserved.
+ */
+import type { HttpClient } from '../http.js';
+import type { EnterpriseAgentRecord, ApprovalConfig, ApproveAgentParams, RevokeAgentParams, UpdateAgentStatusParams, BulkApproveAgentParams, BulkApproveResult, ListEnterpriseAgentsParams, Page, RequestOptions } from '../types.js';
+export declare class EnterprisesResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** Approve an agent for an enterprise (idempotent PUT). */
+    approveAgent(enterpriseId: string, agentId: string, params?: ApproveAgentParams, options?: RequestOptions): Promise<EnterpriseAgentRecord>;
+    /** Revoke an agent's approval for an enterprise. */
+    revokeAgent(enterpriseId: string, agentId: string, params?: RevokeAgentParams, options?: RequestOptions): Promise<void>;
+    /** Update an agent's status (e.g., suspend or reactivate). */
+    updateAgentStatus(enterpriseId: string, agentId: string, params: UpdateAgentStatusParams, options?: RequestOptions): Promise<EnterpriseAgentRecord>;
+    /** Approve multiple agents at once. */
+    bulkApprove(enterpriseId: string, params: BulkApproveAgentParams, options?: RequestOptions): Promise<BulkApproveResult>;
+    /** List agents for an enterprise, optionally filtered by status. */
+    listAgents(enterpriseId: string, params?: ListEnterpriseAgentsParams, options?: RequestOptions): Promise<Page<EnterpriseAgentRecord>>;
+    /** Get a single agent's approval record. */
+    getAgent(enterpriseId: string, agentId: string, options?: RequestOptions): Promise<EnterpriseAgentRecord>;
+    /** Get the enterprise's agent approval configuration. */
+    getApprovalConfig(enterpriseId: string, options?: RequestOptions): Promise<ApprovalConfig>;
+    /** Set the enterprise's agent approval configuration. */
+    setApprovalConfig(enterpriseId: string, params: ApprovalConfig, options?: RequestOptions): Promise<ApprovalConfig>;
+}
+//# sourceMappingURL=enterprises.d.ts.map