@nomosprotocol/sdk 1.0.0 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (41) hide show
  1. package/README.md +98 -0
  2. package/dist/index.cjs +608 -0
  3. package/dist/index.cjs.map +1 -0
  4. package/dist/index.d.cts +489 -0
  5. package/dist/index.d.ts +489 -4
  6. package/dist/index.js +575 -2
  7. package/dist/index.js.map +1 -1
  8. package/package.json +25 -7
  9. package/dist/errors.d.ts +0 -31
  10. package/dist/errors.d.ts.map +0 -1
  11. package/dist/errors.js +0 -54
  12. package/dist/errors.js.map +0 -1
  13. package/dist/http-client.d.ts +0 -14
  14. package/dist/http-client.d.ts.map +0 -1
  15. package/dist/http-client.js +0 -70
  16. package/dist/http-client.js.map +0 -1
  17. package/dist/index.d.ts.map +0 -1
  18. package/dist/nomos.d.ts +0 -13
  19. package/dist/nomos.d.ts.map +0 -1
  20. package/dist/nomos.js +0 -26
  21. package/dist/nomos.js.map +0 -1
  22. package/dist/resources/artifacts.d.ts +0 -22
  23. package/dist/resources/artifacts.d.ts.map +0 -1
  24. package/dist/resources/artifacts.js +0 -46
  25. package/dist/resources/artifacts.js.map +0 -1
  26. package/dist/resources/decisions.d.ts +0 -24
  27. package/dist/resources/decisions.d.ts.map +0 -1
  28. package/dist/resources/decisions.js +0 -53
  29. package/dist/resources/decisions.js.map +0 -1
  30. package/dist/resources/governance.d.ts +0 -30
  31. package/dist/resources/governance.d.ts.map +0 -1
  32. package/dist/resources/governance.js +0 -33
  33. package/dist/resources/governance.js.map +0 -1
  34. package/dist/types.d.ts +0 -117
  35. package/dist/types.d.ts.map +0 -1
  36. package/dist/types.js +0 -3
  37. package/dist/types.js.map +0 -1
  38. package/dist/util.d.ts +0 -4
  39. package/dist/util.d.ts.map +0 -1
  40. package/dist/util.js +0 -11
  41. package/dist/util.js.map +0 -1
package/dist/types.d.ts DELETED
@@ -1,117 +0,0 @@
1
- export interface VerifyDecisionParams {
2
- /** Artifact ID from NOMOS Studio or the Exchange */
3
- artifact_id: string;
4
- /** The data fields this decision is based on */
5
- decision_context: Record<string, unknown>;
6
- /** Optional: the AI's proposed decision (for audit trail) */
7
- proposed_decision?: string;
8
- /** Optional: unique ID for idempotency */
9
- correlation_id?: string;
10
- }
11
- export interface ListArtifactsParams {
12
- /** Filter by autonomy band */
13
- band?: 'autonomous' | 'bounded' | 'human_governed';
14
- /** Filter by domain */
15
- domain?: string;
16
- /** Filter by jurisdiction tag */
17
- jurisdiction?: string;
18
- /** Sort order */
19
- sort?: 'newest' | 'top_rated' | 'most_used';
20
- /** Number of results (default 20, max 100) */
21
- limit?: number;
22
- /** Pagination offset */
23
- offset?: number;
24
- }
25
- export interface GenerateGovernanceParams {
26
- /** Policy documents as plain text */
27
- policies: string[];
28
- /** Historical decision logs (CSV rows or JSON objects) */
29
- decision_logs?: Record<string, unknown>[];
30
- /** Domain name (e.g. "loan_approval") */
31
- domain?: string;
32
- /** Organisation name */
33
- organisation?: string;
34
- }
35
- export interface DetectContradictionsParams {
36
- /** Array of rules to check */
37
- rules: Array<{
38
- id: string;
39
- condition: string;
40
- outcome: string;
41
- priority?: number;
42
- }>;
43
- }
44
- export type Verdict = 'auto_approved' | 'auto_rejected' | 'escalated' | 'pending_human_review';
45
- export interface VerifyDecisionResult {
46
- /** Whether the decision is permitted under current governance */
47
- allowed: boolean;
48
- /** Machine-readable verdict */
49
- verdict: Verdict;
50
- /** Human-readable explanation */
51
- verdict_description: string;
52
- /** The rule that triggered this verdict (if any) */
53
- rule_reference?: string;
54
- /** SHA-256 hash of the audit record — store this for compliance */
55
- audit_record?: string;
56
- /** Artifact that governed this decision */
57
- artifact_id: string;
58
- /** Execution ID for tracing */
59
- execution_id?: string;
60
- /** ISO timestamp */
61
- decided_at: string;
62
- }
63
- export interface Artifact {
64
- id: string;
65
- title: string;
66
- description?: string;
67
- domain?: string;
68
- verification_tier: 'DECLARED' | 'VALIDATED' | 'CERTIFIED' | 'PROVEN' | 'SOVEREIGN';
69
- autonomy_band: 'autonomous' | 'bounded' | 'human_governed';
70
- ari_score?: number;
71
- rule_count?: number;
72
- jurisdiction_tags: string[];
73
- industry_tags: string[];
74
- publisher_org?: string;
75
- seal_hash?: string;
76
- downloads: number;
77
- rating?: number;
78
- price_usd: number;
79
- published_at?: string;
80
- created_at: string;
81
- }
82
- export interface ArtifactList {
83
- data: Artifact[];
84
- total: number;
85
- limit: number;
86
- offset: number;
87
- }
88
- export interface Contradiction {
89
- type: 'threshold_conflict' | 'role_conflict' | 'ghost_term' | 'rule_collision' | 'layer_divergence';
90
- severity: 'critical' | 'warning' | 'info';
91
- rule_ids: string[];
92
- description: string;
93
- suggested_resolution?: string;
94
- }
95
- export interface DetectContradictionsResult {
96
- contradiction_count: number;
97
- contradictions: Contradiction[];
98
- clean: boolean;
99
- }
100
- export interface GenerateGovernanceResult {
101
- artifact_id: string;
102
- seal_hash: string;
103
- ari_score: number;
104
- autonomy_band: 'autonomous' | 'bounded' | 'human_governed';
105
- rule_count: number;
106
- verification_tier: string;
107
- download_url?: string;
108
- }
109
- export interface NomosConfig {
110
- /** Base URL override — defaults to https://nomos.ai */
111
- baseUrl?: string;
112
- /** Max retries on 429 / 5xx (default: 3) */
113
- maxRetries?: number;
114
- /** Request timeout in ms (default: 30000) */
115
- timeout?: number;
116
- }
117
- //# sourceMappingURL=types.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
package/dist/types.js DELETED
@@ -1,3 +0,0 @@
1
- // ─── Request types ──────────────────────────────────────────────────────────
2
- export {};
3
- //# sourceMappingURL=types.js.map
package/dist/types.js.map DELETED
@@ -1 +0,0 @@
1
- {"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,+EAA+E"}
package/dist/util.d.ts DELETED
@@ -1,4 +0,0 @@
1
- export declare function sleep(ms: number): Promise<void>;
2
- export declare function jitteredBackoff(attempt: number, baseMs?: number): number;
3
- export declare function isRetryable(status: number): boolean;
4
- //# sourceMappingURL=util.d.ts.map
@@ -1 +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 DELETED
@@ -1,11 +0,0 @@
1
- export async function sleep(ms) {
2
- return new Promise(resolve => setTimeout(resolve, ms));
3
- }
4
- export function jitteredBackoff(attempt, baseMs = 500) {
5
- const exp = Math.min(baseMs * 2 ** attempt, 16000);
6
- return exp * (0.75 + Math.random() * 0.5); // ±25% jitter
7
- }
8
- export function isRetryable(status) {
9
- return status === 429 || status >= 500;
10
- }
11
- //# sourceMappingURL=util.js.map
package/dist/util.js.map DELETED
@@ -1 +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"}