@nomosprotocol/sdk 1.0.0

package/dist/errors.d.ts

@@ -0,0 +1,31 @@
+export type NomosErrorCode = 'authentication_error' | 'authorization_error' | 'rate_limit_error' | 'validation_error' | 'not_found' | 'api_error' | 'network_error';
+export declare class NomosError extends Error {
+    readonly code: NomosErrorCode;
+    readonly status?: number;
+    readonly requestId?: string;
+    constructor(message: string, code: NomosErrorCode, status?: number, requestId?: string);
+}
+export declare class NomosAuthenticationError extends NomosError {
+    constructor(message?: string, requestId?: string);
+}
+export declare class NomosAuthorizationError extends NomosError {
+    constructor(message?: string, requestId?: string);
+}
+export declare class NomosRateLimitError extends NomosError {
+    readonly retryAfter?: number;
+    constructor(message?: string, retryAfter?: number, requestId?: string);
+}
+export declare class NomosValidationError extends NomosError {
+    readonly details?: unknown;
+    constructor(message: string, details?: unknown, requestId?: string);
+}
+export declare class NomosNotFoundError extends NomosError {
+    constructor(message: string, requestId?: string);
+}
+export declare class NomosAPIError extends NomosError {
+    constructor(message: string, status: number, requestId?: string);
+}
+export declare class NomosNetworkError extends NomosError {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GACtB,sBAAsB,GACtB,qBAAqB,GACrB,kBAAkB,GAClB,kBAAkB,GAClB,WAAW,GACX,WAAW,GACX,eAAe,CAAC;AAEpB,qBAAa,UAAW,SAAQ,KAAK;IACnC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;gBAEhB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAOvF;AAED,qBAAa,wBAAyB,SAAQ,UAAU;gBAC1C,OAAO,SAAoB,EAAE,SAAS,CAAC,EAAE,MAAM;CAI5D;AAED,qBAAa,uBAAwB,SAAQ,UAAU;gBACzC,OAAO,SAAkB,EAAE,SAAS,CAAC,EAAE,MAAM;CAI1D;AAED,qBAAa,mBAAoB,SAAQ,UAAU;IACjD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;gBAEjB,OAAO,SAAwB,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAKrF;AAED,qBAAa,oBAAqB,SAAQ,UAAU;IAClD,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;gBAEf,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM;CAKnE;AAED,qBAAa,kBAAmB,SAAQ,UAAU;gBACpC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAIhD;AAED,qBAAa,aAAc,SAAQ,UAAU;gBAC/B,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAIhE;AAED,qBAAa,iBAAkB,SAAQ,UAAU;gBACnC,OAAO,EAAE,MAAM;CAI5B"}

package/dist/errors.js

@@ -0,0 +1,54 @@
+export class NomosError extends Error {
+    constructor(message, code, status, requestId) {
+        super(message);
+        this.name = 'NomosError';
+        this.code = code;
+        this.status = status;
+        this.requestId = requestId;
+    }
+}
+export class NomosAuthenticationError extends NomosError {
+    constructor(message = 'Invalid API key', requestId) {
+        super(message, 'authentication_error', 401, requestId);
+        this.name = 'NomosAuthenticationError';
+    }
+}
+export class NomosAuthorizationError extends NomosError {
+    constructor(message = 'Access denied', requestId) {
+        super(message, 'authorization_error', 403, requestId);
+        this.name = 'NomosAuthorizationError';
+    }
+}
+export class NomosRateLimitError extends NomosError {
+    constructor(message = 'Rate limit exceeded', retryAfter, requestId) {
+        super(message, 'rate_limit_error', 429, requestId);
+        this.name = 'NomosRateLimitError';
+        this.retryAfter = retryAfter;
+    }
+}
+export class NomosValidationError extends NomosError {
+    constructor(message, details, requestId) {
+        super(message, 'validation_error', 400, requestId);
+        this.name = 'NomosValidationError';
+        this.details = details;
+    }
+}
+export class NomosNotFoundError extends NomosError {
+    constructor(message, requestId) {
+        super(message, 'not_found', 404, requestId);
+        this.name = 'NomosNotFoundError';
+    }
+}
+export class NomosAPIError extends NomosError {
+    constructor(message, status, requestId) {
+        super(message, 'api_error', status, requestId);
+        this.name = 'NomosAPIError';
+    }
+}
+export class NomosNetworkError extends NomosError {
+    constructor(message) {
+        super(message, 'network_error');
+        this.name = 'NomosNetworkError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AASA,MAAM,OAAO,UAAW,SAAQ,KAAK;IAKnC,YAAY,OAAe,EAAE,IAAoB,EAAE,MAAe,EAAE,SAAkB;QACpF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,OAAO,wBAAyB,SAAQ,UAAU;IACtD,YAAY,OAAO,GAAG,iBAAiB,EAAE,SAAkB;QACzD,KAAK,CAAC,OAAO,EAAE,sBAAsB,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;QACvD,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF;AAED,MAAM,OAAO,uBAAwB,SAAQ,UAAU;IACrD,YAAY,OAAO,GAAG,eAAe,EAAE,SAAkB;QACvD,KAAK,CAAC,OAAO,EAAE,qBAAqB,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;QACtD,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,UAAU;IAGjD,YAAY,OAAO,GAAG,qBAAqB,EAAE,UAAmB,EAAE,SAAkB;QAClF,KAAK,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;QACnD,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,UAAU;IAGlD,YAAY,OAAe,EAAE,OAAiB,EAAE,SAAkB;QAChE,KAAK,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;QACnD,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,UAAU;IAChD,YAAY,OAAe,EAAE,SAAkB;QAC7C,KAAK,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;QAC5C,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,UAAU;IAC3C,YAAY,OAAe,EAAE,MAAc,EAAE,SAAkB;QAC7D,KAAK,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;QAC/C,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,UAAU;IAC/C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF"}

package/dist/http-client.d.ts

@@ -0,0 +1,14 @@
+export interface HttpClientOptions {
+    apiKey: string;
+    baseUrl: string;
+    maxRetries: number;
+    timeout: number;
+}
+export declare class HttpClient {
+    private readonly opts;
+    constructor(opts: HttpClientOptions);
+    get<T>(path: string): Promise<T>;
+    post<T>(path: string, body: unknown): Promise<T>;
+    private request;
+}
+//# sourceMappingURL=http-client.d.ts.map

package/dist/http-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../src/http-client.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,iBAAiB;IAE9C,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAIhC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;YAIxC,OAAO;CA6DtB"}

package/dist/http-client.js

@@ -0,0 +1,70 @@
+import { NomosAuthenticationError, NomosAuthorizationError, NomosRateLimitError, NomosValidationError, NomosNotFoundError, NomosAPIError, NomosNetworkError, } from './errors.js';
+import { sleep, jitteredBackoff, isRetryable } from './util.js';
+export class HttpClient {
+    constructor(opts) {
+        this.opts = opts;
+    }
+    async get(path) {
+        return this.request('GET', path, undefined);
+    }
+    async post(path, body) {
+        return this.request('POST', path, body);
+    }
+    async request(method, path, body, attempt = 0) {
+        const url = `${this.opts.baseUrl}${path}`;
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.opts.timeout);
+        let res;
+        try {
+            res = await fetch(url, {
+                method,
+                signal: controller.signal,
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-Nomos-Api-Key': this.opts.apiKey,
+                    'User-Agent': 'nomos-sdk/1.0.0',
+                },
+                body: body != null ? JSON.stringify(body) : undefined,
+            });
+        }
+        catch (err) {
+            clearTimeout(timer);
+            if (err.name === 'AbortError') {
+                throw new NomosNetworkError(`Request timed out after ${this.opts.timeout}ms`);
+            }
+            throw new NomosNetworkError(err.message ?? 'Network error');
+        }
+        finally {
+            clearTimeout(timer);
+        }
+        const requestId = res.headers.get('x-request-id') ?? undefined;
+        if (res.ok) {
+            return res.json();
+        }
+        // Retry on 429 / 5xx
+        if (isRetryable(res.status) && attempt < this.opts.maxRetries) {
+            const retryAfter = res.headers.get('retry-after');
+            const delay = retryAfter
+                ? parseInt(retryAfter, 10) * 1000
+                : jitteredBackoff(attempt);
+            await sleep(delay);
+            return this.request(method, path, body, attempt + 1);
+        }
+        let errBody = {};
+        try {
+            errBody = await res.json();
+        }
+        catch { }
+        const message = errBody?.error ?? errBody?.message ?? res.statusText;
+        switch (res.status) {
+            case 401: throw new NomosAuthenticationError(message, requestId);
+            case 403: throw new NomosAuthorizationError(message, requestId);
+            case 404: throw new NomosNotFoundError(message, requestId);
+            case 422:
+            case 400: throw new NomosValidationError(message, errBody?.details, requestId);
+            case 429: throw new NomosRateLimitError(message, res.headers.get('retry-after') ? parseInt(res.headers.get('retry-after'), 10) : undefined, requestId);
+            default: throw new NomosAPIError(message, res.status, requestId);
+        }
+    }
+}
+//# sourceMappingURL=http-client.js.map

package/dist/http-client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { Nomos } from './nomos.js';
+export * from './errors.js';
+export type { NomosConfig, VerifyDecisionParams, VerifyDecisionResult, ListArtifactsParams, ArtifactList, Artifact, GenerateGovernanceParams, GenerateGovernanceResult, DetectContradictionsParams, DetectContradictionsResult, Contradiction, Verdict, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,YAAY,EACV,WAAW,EACX,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,EACZ,QAAQ,EACR,wBAAwB,EACxB,wBAAwB,EACxB,0BAA0B,EAC1B,0BAA0B,EAC1B,aAAa,EACb,OAAO,GACR,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { Nomos } from './nomos.js';
+export * from './errors.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,cAAc,aAAa,CAAC"}

package/dist/nomos.d.ts

@@ -0,0 +1,13 @@
+import { Decisions } from './resources/decisions.js';
+import { Artifacts } from './resources/artifacts.js';
+import { Governance } from './resources/governance.js';
+import * as errors from './errors.js';
+import type { NomosConfig } from './types.js';
+export declare class Nomos {
+    readonly decisions: Decisions;
+    readonly artifacts: Artifacts;
+    readonly governance: Governance;
+    static readonly errors: typeof errors;
+    constructor(apiKey: string, config?: NomosConfig);
+}
+//# sourceMappingURL=nomos.d.ts.map

package/dist/nomos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nomos.d.ts","sourceRoot":"","sources":["../src/nomos.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAM9C,qBAAa,KAAK;IAChB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAEhC,MAAM,CAAC,QAAQ,CAAC,MAAM,gBAAU;gBAEpB,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,WAAgB;CAkBrD"}

package/dist/nomos.js

@@ -0,0 +1,26 @@
+import { HttpClient } from './http-client.js';
+import { Decisions } from './resources/decisions.js';
+import { Artifacts } from './resources/artifacts.js';
+import { Governance } from './resources/governance.js';
+import * as errors from './errors.js';
+const DEFAULT_BASE_URL = 'https://nomos.ai';
+const DEFAULT_MAX_RETRIES = 3;
+const DEFAULT_TIMEOUT = 30000;
+export class Nomos {
+    constructor(apiKey, config = {}) {
+        if (!apiKey || typeof apiKey !== 'string') {
+            throw new errors.NomosAuthenticationError('A valid API key is required. Pass it as the first argument: new Nomos("nms_live_...")');
+        }
+        const http = new HttpClient({
+            apiKey,
+            baseUrl: (config.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, ''),
+            maxRetries: config.maxRetries ?? DEFAULT_MAX_RETRIES,
+            timeout: config.timeout ?? DEFAULT_TIMEOUT,
+        });
+        this.decisions = new Decisions(http);
+        this.artifacts = new Artifacts(http);
+        this.governance = new Governance(http);
+    }
+}
+Nomos.errors = errors;
+//# sourceMappingURL=nomos.js.map

package/dist/nomos.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nomos.js","sourceRoot":"","sources":["../src/nomos.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAGtC,MAAM,gBAAgB,GAAG,kBAAkB,CAAC;AAC5C,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAC9B,MAAM,eAAe,GAAG,KAAM,CAAC;AAE/B,MAAM,OAAO,KAAK;IAOhB,YAAY,MAAc,EAAE,SAAsB,EAAE;QAClD,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC1C,MAAM,IAAI,MAAM,CAAC,wBAAwB,CACvC,uFAAuF,CACxF,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC;YAC1B,MAAM;YACN,OAAO,EAAK,CAAC,MAAM,CAAC,OAAO,IAAI,gBAAgB,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;YACnE,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,mBAAmB;YACpD,OAAO,EAAK,MAAM,CAAC,OAAO,IAAO,eAAe;SACjD,CAAC,CAAC;QAEH,IAAI,CAAC,SAAS,GAAI,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,SAAS,GAAI,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,UAAU,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;;AAnBe,YAAM,GAAG,MAAM,CAAC"}

package/dist/resources/artifacts.d.ts

@@ -0,0 +1,22 @@
+import type { HttpClient } from '../http-client.js';
+import type { Artifact, ArtifactList, ListArtifactsParams } from '../types.js';
+export declare class Artifacts {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Retrieve a single artifact by ID.
+     *
+     * @example
+     * const artifact = await nomos.artifacts.retrieve('loan_approval_v1');
+     * console.log(artifact.ari_score, artifact.autonomy_band);
+     */
+    retrieve(artifactId: string): Promise<Artifact>;
+    /**
+     * List published artifacts on the Exchange with optional filters.
+     *
+     * @example
+     * const { data } = await nomos.artifacts.list({ band: 'autonomous', limit: 10 });
+     */
+    list(params?: ListArtifactsParams): Promise<ArtifactList>;
+}
+//# sourceMappingURL=artifacts.d.ts.map

package/dist/resources/artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../../src/resources/artifacts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAE/E,qBAAa,SAAS;IACR,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C;;;;;;OAMG;IACG,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIrD;;;;;OAKG;IACG,IAAI,CAAC,MAAM,GAAE,mBAAwB,GAAG,OAAO,CAAC,YAAY,CAAC;CAkBpE"}

package/dist/resources/artifacts.js

@@ -0,0 +1,46 @@
+export class Artifacts {
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Retrieve a single artifact by ID.
+     *
+     * @example
+     * const artifact = await nomos.artifacts.retrieve('loan_approval_v1');
+     * console.log(artifact.ari_score, artifact.autonomy_band);
+     */
+    async retrieve(artifactId) {
+        return this.http.get(`/api/exchange/artifacts/${encodeURIComponent(artifactId)}`);
+    }
+    /**
+     * List published artifacts on the Exchange with optional filters.
+     *
+     * @example
+     * const { data } = await nomos.artifacts.list({ band: 'autonomous', limit: 10 });
+     */
+    async list(params = {}) {
+        const qs = new URLSearchParams();
+        if (params.band)
+            qs.set('band', params.band);
+        if (params.domain)
+            qs.set('domain', params.domain);
+        if (params.jurisdiction)
+            qs.set('jurisdiction', params.jurisdiction);
+        if (params.sort)
+            qs.set('sort', params.sort);
+        if (params.limit != null)
+            qs.set('limit', String(params.limit));
+        if (params.offset != null)
+            qs.set('offset', String(params.offset));
+        const query = qs.toString();
+        const raw = await this.http.get(`/api/exchange/artifacts${query ? `?${query}` : ''}`);
+        // API returns { artifacts: [], total: N } — normalise to { data: [], total: N }
+        return {
+            data: Array.isArray(raw) ? raw : (raw.artifacts ?? raw.data ?? []),
+            total: raw.total ?? (Array.isArray(raw) ? raw.length : 0),
+            limit: params.limit ?? 20,
+            offset: params.offset ?? 0,
+        };
+    }
+}
+//# sourceMappingURL=artifacts.js.map

package/dist/resources/artifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.js","sourceRoot":"","sources":["../../src/resources/artifacts.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,SAAS;IACpB,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD;;;;;;OAMG;IACH,KAAK,CAAC,QAAQ,CAAC,UAAkB;QAC/B,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAW,2BAA2B,kBAAkB,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IAC9F,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,IAAI,CAAC,SAA8B,EAAE;QACzC,MAAM,EAAE,GAAG,IAAI,eAAe,EAAE,CAAC;QACjC,IAAI,MAAM,CAAC,IAAI;YAAY,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QACvD,IAAI,MAAM,CAAC,MAAM;YAAU,EAAE,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAC3D,IAAI,MAAM,CAAC,YAAY;YAAI,EAAE,CAAC,GAAG,CAAC,cAAc,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;QACvE,IAAI,MAAM,CAAC,IAAI;YAAY,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QACvD,IAAI,MAAM,CAAC,KAAK,IAAI,IAAI;YAAG,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACjE,IAAI,MAAM,CAAC,MAAM,IAAI,IAAI;YAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QACnE,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAM,0BAA0B,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3F,gFAAgF;QAChF,OAAO;YACL,IAAI,EAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;YACpE,KAAK,EAAG,GAAG,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YAC1D,KAAK,EAAG,MAAM,CAAC,KAAK,IAAI,EAAE;YAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,CAAC;SAC3B,CAAC;IACJ,CAAC;CACF"}

package/dist/resources/decisions.d.ts

@@ -0,0 +1,24 @@
+import type { HttpClient } from '../http-client.js';
+import type { VerifyDecisionParams, VerifyDecisionResult } from '../types.js';
+export declare class Decisions {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Verify whether an AI decision is permitted under a governance artifact.
+     *
+     * Public demo artifacts (pub_*) work without an API key.
+     * Custom artifacts require a valid API key.
+     *
+     * @example
+     * const result = await nomos.decisions.verify({
+     *   artifact_id: 'pub_lending_v1',
+     *   decision_context: { credit_score: 720, loan_amount: 50000 },
+     * });
+     *
+     * if (!result.allowed) {
+     *   throw new Error(`Decision blocked: ${result.verdict_description}`);
+     * }
+     */
+    verify(params: VerifyDecisionParams): Promise<VerifyDecisionResult>;
+}
+//# sourceMappingURL=decisions.d.ts.map

package/dist/resources/decisions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decisions.d.ts","sourceRoot":"","sources":["../../src/resources/decisions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAE9E,qBAAa,SAAS;IACR,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C;;;;;;;;;;;;;;;OAeG;IACG,MAAM,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAiC1E"}

package/dist/resources/decisions.js

@@ -0,0 +1,53 @@
+export class Decisions {
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Verify whether an AI decision is permitted under a governance artifact.
+     *
+     * Public demo artifacts (pub_*) work without an API key.
+     * Custom artifacts require a valid API key.
+     *
+     * @example
+     * const result = await nomos.decisions.verify({
+     *   artifact_id: 'pub_lending_v1',
+     *   decision_context: { credit_score: 720, loan_amount: 50000 },
+     * });
+     *
+     * if (!result.allowed) {
+     *   throw new Error(`Decision blocked: ${result.verdict_description}`);
+     * }
+     */
+    async verify(params) {
+        const { artifact_id, decision_context, proposed_decision, correlation_id } = params;
+        // Public artifacts (pub_*) use the open /verify endpoint — no API key required
+        const isPublic = artifact_id.startsWith('pub_');
+        let raw;
+        if (isPublic) {
+            raw = await this.http.post('/api/v1/verify', {
+                artifact_id,
+                decision: proposed_decision ?? 'evaluate',
+                inputs: decision_context,
+            });
+        }
+        else {
+            raw = await this.http.post('/api/v1/verify-decision', {
+                artifact_id,
+                decision_context,
+                proposed_decision,
+                correlation_id: correlation_id ?? crypto.randomUUID(),
+            });
+        }
+        return {
+            allowed: raw.allowed ?? false,
+            verdict: raw.outcome ?? raw.verdict ?? 'pending_human_review',
+            verdict_description: raw.verdict_description ?? '',
+            rule_reference: raw.rule_reference ?? raw.rule_applied,
+            audit_record: raw.audit_record ?? raw.audit_hash,
+            artifact_id: raw.artifact_id ?? artifact_id,
+            execution_id: raw.execution_id,
+            decided_at: raw.decided_at ?? raw.evaluated_at ?? new Date().toISOString(),
+        };
+    }
+}
+//# sourceMappingURL=decisions.js.map

package/dist/resources/decisions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decisions.js","sourceRoot":"","sources":["../../src/resources/decisions.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,SAAS;IACpB,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CAAC,MAAM,CAAC,MAA4B;QACvC,MAAM,EAAE,WAAW,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,cAAc,EAAE,GAAG,MAAM,CAAC;QAEpF,+EAA+E;QAC/E,MAAM,QAAQ,GAAG,WAAW,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAChD,IAAI,GAAQ,CAAC;QAEb,IAAI,QAAQ,EAAE,CAAC;YACb,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAM,gBAAgB,EAAE;gBAChD,WAAW;gBACX,QAAQ,EAAE,iBAAiB,IAAI,UAAU;gBACzC,MAAM,EAAI,gBAAgB;aAC3B,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAM,yBAAyB,EAAE;gBACzD,WAAW;gBACX,gBAAgB;gBAChB,iBAAiB;gBACjB,cAAc,EAAE,cAAc,IAAI,MAAM,CAAC,UAAU,EAAE;aACtD,CAAC,CAAC;QACL,CAAC;QAED,OAAO;YACL,OAAO,EAAc,GAAG,CAAC,OAAO,IAAI,KAAK;YACzC,OAAO,EAAc,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,OAAO,IAAI,sBAAsB;YACzE,mBAAmB,EAAE,GAAG,CAAC,mBAAmB,IAAI,EAAE;YAClD,cAAc,EAAO,GAAG,CAAC,cAAc,IAAI,GAAG,CAAC,YAAY;YAC3D,YAAY,EAAS,GAAG,CAAC,YAAY,IAAI,GAAG,CAAC,UAAU;YACvD,WAAW,EAAU,GAAG,CAAC,WAAW,IAAI,WAAW;YACnD,YAAY,EAAS,GAAG,CAAC,YAAY;YACrC,UAAU,EAAW,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,YAAY,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpF,CAAC;IACJ,CAAC;CACF"}

package/dist/resources/governance.d.ts

@@ -0,0 +1,30 @@
+import type { HttpClient } from '../http-client.js';
+import type { GenerateGovernanceParams, GenerateGovernanceResult, DetectContradictionsParams, DetectContradictionsResult } from '../types.js';
+export declare class Governance {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Generate a sealed .nomos governance artifact from policy documents
+     * and optional historical decision logs.
+     *
+     * @example
+     * const artifact = await nomos.governance.generate({
+     *   policies: [policyText],
+     *   decision_logs: historicalRows,
+     *   domain: 'loan_approval',
+     * });
+     * console.log(artifact.ari_score, artifact.seal_hash);
+     */
+    generate(params: GenerateGovernanceParams): Promise<GenerateGovernanceResult>;
+    /**
+     * Detect contradictions and conflicts in a rule set before sealing.
+     *
+     * @example
+     * const report = await nomos.governance.detectContradictions({ rules });
+     * if (!report.clean) {
+     *   console.log(report.contradictions);
+     * }
+     */
+    detectContradictions(params: DetectContradictionsParams): Promise<DetectContradictionsResult>;
+}
+//# sourceMappingURL=governance.d.ts.map

package/dist/resources/governance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"governance.d.ts","sourceRoot":"","sources":["../../src/resources/governance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EACV,wBAAwB,EACxB,wBAAwB,EACxB,0BAA0B,EAC1B,0BAA0B,EAC3B,MAAM,aAAa,CAAC;AAErB,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C;;;;;;;;;;;OAWG;IACG,QAAQ,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAInF;;;;;;;;OAQG;IACG,oBAAoB,CAAC,MAAM,EAAE,0BAA0B,GAAG,OAAO,CAAC,0BAA0B,CAAC;CAGpG"}

package/dist/resources/governance.js

@@ -0,0 +1,33 @@
+export class Governance {
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Generate a sealed .nomos governance artifact from policy documents
+     * and optional historical decision logs.
+     *
+     * @example
+     * const artifact = await nomos.governance.generate({
+     *   policies: [policyText],
+     *   decision_logs: historicalRows,
+     *   domain: 'loan_approval',
+     * });
+     * console.log(artifact.ari_score, artifact.seal_hash);
+     */
+    async generate(params) {
+        return this.http.post('/api/v1/generate-governance', params);
+    }
+    /**
+     * Detect contradictions and conflicts in a rule set before sealing.
+     *
+     * @example
+     * const report = await nomos.governance.detectContradictions({ rules });
+     * if (!report.clean) {
+     *   console.log(report.contradictions);
+     * }
+     */
+    async detectContradictions(params) {
+        return this.http.post('/api/v1/detect-contradictions', params);
+    }
+}
+//# sourceMappingURL=governance.js.map

package/dist/resources/governance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"governance.js","sourceRoot":"","sources":["../../src/resources/governance.ts"],"names":[],"mappings":"AAQA,MAAM,OAAO,UAAU;IACrB,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,QAAQ,CAAC,MAAgC;QAC7C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAA2B,6BAA6B,EAAE,MAAM,CAAC,CAAC;IACzF,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,oBAAoB,CAAC,MAAkC;QAC3D,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAA6B,+BAA+B,EAAE,MAAM,CAAC,CAAC;IAC7F,CAAC;CACF"}

package/dist/types.d.ts

@@ -0,0 +1,117 @@
+export interface VerifyDecisionParams {
+    /** Artifact ID from NOMOS Studio or the Exchange */
+    artifact_id: string;
+    /** The data fields this decision is based on */
+    decision_context: Record<string, unknown>;
+    /** Optional: the AI's proposed decision (for audit trail) */
+    proposed_decision?: string;
+    /** Optional: unique ID for idempotency */
+    correlation_id?: string;
+}
+export interface ListArtifactsParams {
+    /** Filter by autonomy band */
+    band?: 'autonomous' | 'bounded' | 'human_governed';
+    /** Filter by domain */
+    domain?: string;
+    /** Filter by jurisdiction tag */
+    jurisdiction?: string;
+    /** Sort order */
+    sort?: 'newest' | 'top_rated' | 'most_used';
+    /** Number of results (default 20, max 100) */
+    limit?: number;
+    /** Pagination offset */
+    offset?: number;
+}
+export interface GenerateGovernanceParams {
+    /** Policy documents as plain text */
+    policies: string[];
+    /** Historical decision logs (CSV rows or JSON objects) */
+    decision_logs?: Record<string, unknown>[];
+    /** Domain name (e.g. "loan_approval") */
+    domain?: string;
+    /** Organisation name */
+    organisation?: string;
+}
+export interface DetectContradictionsParams {
+    /** Array of rules to check */
+    rules: Array<{
+        id: string;
+        condition: string;
+        outcome: string;
+        priority?: number;
+    }>;
+}
+export type Verdict = 'auto_approved' | 'auto_rejected' | 'escalated' | 'pending_human_review';
+export interface VerifyDecisionResult {
+    /** Whether the decision is permitted under current governance */
+    allowed: boolean;
+    /** Machine-readable verdict */
+    verdict: Verdict;
+    /** Human-readable explanation */
+    verdict_description: string;
+    /** The rule that triggered this verdict (if any) */
+    rule_reference?: string;
+    /** SHA-256 hash of the audit record — store this for compliance */
+    audit_record?: string;
+    /** Artifact that governed this decision */
+    artifact_id: string;
+    /** Execution ID for tracing */
+    execution_id?: string;
+    /** ISO timestamp */
+    decided_at: string;
+}
+export interface Artifact {
+    id: string;
+    title: string;
+    description?: string;
+    domain?: string;
+    verification_tier: 'DECLARED' | 'VALIDATED' | 'CERTIFIED' | 'PROVEN' | 'SOVEREIGN';
+    autonomy_band: 'autonomous' | 'bounded' | 'human_governed';
+    ari_score?: number;
+    rule_count?: number;
+    jurisdiction_tags: string[];
+    industry_tags: string[];
+    publisher_org?: string;
+    seal_hash?: string;
+    downloads: number;
+    rating?: number;
+    price_usd: number;
+    published_at?: string;
+    created_at: string;
+}
+export interface ArtifactList {
+    data: Artifact[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+export interface Contradiction {
+    type: 'threshold_conflict' | 'role_conflict' | 'ghost_term' | 'rule_collision' | 'layer_divergence';
+    severity: 'critical' | 'warning' | 'info';
+    rule_ids: string[];
+    description: string;
+    suggested_resolution?: string;
+}
+export interface DetectContradictionsResult {
+    contradiction_count: number;
+    contradictions: Contradiction[];
+    clean: boolean;
+}
+export interface GenerateGovernanceResult {
+    artifact_id: string;
+    seal_hash: string;
+    ari_score: number;
+    autonomy_band: 'autonomous' | 'bounded' | 'human_governed';
+    rule_count: number;
+    verification_tier: string;
+    download_url?: string;
+}
+export interface NomosConfig {
+    /** Base URL override — defaults to https://nomos.ai */
+    baseUrl?: string;
+    /** Max retries on 429 / 5xx (default: 3) */
+    maxRetries?: number;
+    /** Request timeout in ms (default: 30000) */
+    timeout?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,3 @@
+// ─── Request types ──────────────────────────────────────────────────────────
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,+EAA+E"}

package/dist/util.d.ts

@@ -0,0 +1,4 @@
+export declare function sleep(ms: number): Promise<void>;
+export declare function jitteredBackoff(attempt: number, baseMs?: number): number;
+export declare function isRetryable(status: number): boolean;
+//# sourceMappingURL=util.d.ts.map

package/dist/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAAA,wBAAsB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAErD;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAM,GAAG,MAAM,CAGrE;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEnD"}

package/dist/util.js

@@ -0,0 +1,11 @@
+export async function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+export function jitteredBackoff(attempt, baseMs = 500) {
+    const exp = Math.min(baseMs * 2 ** attempt, 16000);
+    return exp * (0.75 + Math.random() * 0.5); // ±25% jitter
+}
+export function isRetryable(status) {
+    return status === 429 || status >= 500;
+}
+//# sourceMappingURL=util.js.map

package/dist/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,EAAU;IACpC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAe,EAAE,MAAM,GAAG,GAAG;IAC3D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,EAAE,KAAK,CAAC,CAAC;IACnD,OAAO,GAAG,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,cAAc;AAC3D,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,OAAO,MAAM,KAAK,GAAG,IAAI,MAAM,IAAI,GAAG,CAAC;AACzC,CAAC"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@nomosprotocol/sdk",
+  "version": "1.0.0",
+  "description": "Official TypeScript SDK for the NOMOS governance runtime",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist"
+  },
+  "keywords": [
+    "nomos",
+    "governance",
+    "ai",
+    "compliance",
+    "sdk"
+  ],
+  "author": "NOMOS",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  }
+}