@nexart/ai-execution 0.2.0 → 0.4.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 (91) hide show
  1. package/README.md +100 -330
  2. package/dist/index.cjs +607 -0
  3. package/dist/index.cjs.map +1 -0
  4. package/dist/index.d.cts +56 -0
  5. package/dist/index.d.ts +55 -11
  6. package/dist/index.mjs +550 -0
  7. package/dist/index.mjs.map +1 -0
  8. package/dist/providers/anthropic.cjs +258 -0
  9. package/dist/providers/anthropic.cjs.map +1 -0
  10. package/dist/providers/anthropic.d.cts +24 -0
  11. package/dist/providers/anthropic.d.ts +7 -5
  12. package/dist/providers/anthropic.mjs +221 -0
  13. package/dist/providers/anthropic.mjs.map +1 -0
  14. package/dist/providers/openai.cjs +259 -0
  15. package/dist/providers/openai.cjs.map +1 -0
  16. package/dist/providers/openai.d.cts +24 -0
  17. package/dist/providers/openai.d.ts +7 -5
  18. package/dist/providers/openai.mjs +222 -0
  19. package/dist/providers/openai.mjs.map +1 -0
  20. package/dist/providers/wrap.cjs +221 -0
  21. package/dist/providers/wrap.cjs.map +1 -0
  22. package/dist/providers/wrap.d.cts +9 -0
  23. package/dist/providers/wrap.d.ts +5 -3
  24. package/dist/providers/wrap.mjs +186 -0
  25. package/dist/providers/wrap.mjs.map +1 -0
  26. package/dist/{types.d.ts → types-DF29BsH5.d.cts} +18 -16
  27. package/dist/types-DF29BsH5.d.ts +155 -0
  28. package/package.json +18 -9
  29. package/dist/__tests__/fixtures.test.d.ts +0 -2
  30. package/dist/__tests__/fixtures.test.d.ts.map +0 -1
  31. package/dist/__tests__/fixtures.test.js +0 -37
  32. package/dist/__tests__/fixtures.test.js.map +0 -1
  33. package/dist/__tests__/v020.test.d.ts +0 -2
  34. package/dist/__tests__/v020.test.d.ts.map +0 -1
  35. package/dist/__tests__/v020.test.js +0 -408
  36. package/dist/__tests__/v020.test.js.map +0 -1
  37. package/dist/__tests__/vectors.test.d.ts +0 -2
  38. package/dist/__tests__/vectors.test.d.ts.map +0 -1
  39. package/dist/__tests__/vectors.test.js +0 -261
  40. package/dist/__tests__/vectors.test.js.map +0 -1
  41. package/dist/archive.d.ts +0 -4
  42. package/dist/archive.d.ts.map +0 -1
  43. package/dist/archive.js +0 -28
  44. package/dist/archive.js.map +0 -1
  45. package/dist/attest.d.ts +0 -3
  46. package/dist/attest.d.ts.map +0 -1
  47. package/dist/attest.js +0 -42
  48. package/dist/attest.js.map +0 -1
  49. package/dist/canonicalJson.d.ts +0 -2
  50. package/dist/canonicalJson.d.ts.map +0 -1
  51. package/dist/canonicalJson.js +0 -38
  52. package/dist/canonicalJson.js.map +0 -1
  53. package/dist/cer.d.ts +0 -7
  54. package/dist/cer.d.ts.map +0 -1
  55. package/dist/cer.js +0 -61
  56. package/dist/cer.js.map +0 -1
  57. package/dist/certify.d.ts +0 -3
  58. package/dist/certify.d.ts.map +0 -1
  59. package/dist/certify.js +0 -27
  60. package/dist/certify.js.map +0 -1
  61. package/dist/errors.d.ts +0 -10
  62. package/dist/errors.d.ts.map +0 -1
  63. package/dist/errors.js +0 -19
  64. package/dist/errors.js.map +0 -1
  65. package/dist/hash.d.ts +0 -6
  66. package/dist/hash.d.ts.map +0 -1
  67. package/dist/hash.js +0 -32
  68. package/dist/hash.js.map +0 -1
  69. package/dist/index.d.ts.map +0 -1
  70. package/dist/index.js +0 -11
  71. package/dist/index.js.map +0 -1
  72. package/dist/providers/anthropic.d.ts.map +0 -1
  73. package/dist/providers/anthropic.js +0 -61
  74. package/dist/providers/anthropic.js.map +0 -1
  75. package/dist/providers/openai.d.ts.map +0 -1
  76. package/dist/providers/openai.js +0 -62
  77. package/dist/providers/openai.js.map +0 -1
  78. package/dist/providers/wrap.d.ts.map +0 -1
  79. package/dist/providers/wrap.js +0 -28
  80. package/dist/providers/wrap.js.map +0 -1
  81. package/dist/run.d.ts +0 -14
  82. package/dist/run.d.ts.map +0 -1
  83. package/dist/run.js +0 -62
  84. package/dist/run.js.map +0 -1
  85. package/dist/snapshot.d.ts +0 -4
  86. package/dist/snapshot.d.ts.map +0 -1
  87. package/dist/snapshot.js +0 -113
  88. package/dist/snapshot.js.map +0 -1
  89. package/dist/types.d.ts.map +0 -1
  90. package/dist/types.js +0 -2
  91. package/dist/types.js.map +0 -1
@@ -0,0 +1,221 @@
1
+ "use strict";
2
+ var __create = Object.create;
3
+ var __defProp = Object.defineProperty;
4
+ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
5
+ var __getOwnPropNames = Object.getOwnPropertyNames;
6
+ var __getProtoOf = Object.getPrototypeOf;
7
+ var __hasOwnProp = Object.prototype.hasOwnProperty;
8
+ var __export = (target, all) => {
9
+ for (var name in all)
10
+ __defProp(target, name, { get: all[name], enumerable: true });
11
+ };
12
+ var __copyProps = (to, from, except, desc) => {
13
+ if (from && typeof from === "object" || typeof from === "function") {
14
+ for (let key of __getOwnPropNames(from))
15
+ if (!__hasOwnProp.call(to, key) && key !== except)
16
+ __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
17
+ }
18
+ return to;
19
+ };
20
+ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
21
+ // If the importer is in node compatibility mode or this is not an ESM
22
+ // file that has been converted to a CommonJS file using a Babel-
23
+ // compatible transform (i.e. "__esModule" has not been set), then set
24
+ // "default" to the CommonJS "module.exports" for node compatibility.
25
+ isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
26
+ mod
27
+ ));
28
+ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
29
+
30
+ // src/providers/wrap.ts
31
+ var wrap_exports = {};
32
+ __export(wrap_exports, {
33
+ wrapProvider: () => wrapProvider
34
+ });
35
+ module.exports = __toCommonJS(wrap_exports);
36
+ var crypto2 = __toESM(require("crypto"), 1);
37
+
38
+ // src/hash.ts
39
+ var crypto = __toESM(require("crypto"), 1);
40
+
41
+ // src/canonicalJson.ts
42
+ function toCanonicalJson(value) {
43
+ return canonicalize(value);
44
+ }
45
+ function canonicalize(value) {
46
+ if (value === null) {
47
+ return "null";
48
+ }
49
+ if (typeof value === "boolean") {
50
+ return value ? "true" : "false";
51
+ }
52
+ if (typeof value === "number") {
53
+ if (!Number.isFinite(value)) {
54
+ throw new Error(`Non-finite number not allowed in canonical JSON: ${value}`);
55
+ }
56
+ return JSON.stringify(value);
57
+ }
58
+ if (typeof value === "string") {
59
+ return JSON.stringify(value);
60
+ }
61
+ if (Array.isArray(value)) {
62
+ const items = value.map((item) => canonicalize(item));
63
+ return "[" + items.join(",") + "]";
64
+ }
65
+ if (typeof value === "object") {
66
+ const obj = value;
67
+ const keys = Object.keys(obj).sort();
68
+ const entries = keys.map((key) => {
69
+ const val = obj[key];
70
+ if (val === void 0) {
71
+ return null;
72
+ }
73
+ return JSON.stringify(key) + ":" + canonicalize(val);
74
+ }).filter((e) => e !== null);
75
+ return "{" + entries.join(",") + "}";
76
+ }
77
+ throw new Error(`Unsupported type for canonical JSON: ${typeof value}`);
78
+ }
79
+
80
+ // src/hash.ts
81
+ function sha256Hex(data) {
82
+ const hash = crypto.createHash("sha256");
83
+ if (typeof data === "string") {
84
+ hash.update(data, "utf-8");
85
+ } else {
86
+ hash.update(data);
87
+ }
88
+ return hash.digest("hex");
89
+ }
90
+ function hashUtf8(value) {
91
+ return `sha256:${sha256Hex(value)}`;
92
+ }
93
+ function hashCanonicalJson(value) {
94
+ const canonical = toCanonicalJson(value);
95
+ return `sha256:${sha256Hex(canonical)}`;
96
+ }
97
+ function computeInputHash(input) {
98
+ if (typeof input === "string") {
99
+ return hashUtf8(input);
100
+ }
101
+ return hashCanonicalJson(input);
102
+ }
103
+ function computeOutputHash(output) {
104
+ if (typeof output === "string") {
105
+ return hashUtf8(output);
106
+ }
107
+ return hashCanonicalJson(output);
108
+ }
109
+
110
+ // src/snapshot.ts
111
+ var PACKAGE_VERSION = "0.4.0";
112
+ function validateParameters(params) {
113
+ const errors = [];
114
+ if (typeof params.temperature !== "number" || !Number.isFinite(params.temperature)) {
115
+ errors.push(`parameters.temperature must be a finite number, got: ${params.temperature}`);
116
+ }
117
+ if (typeof params.maxTokens !== "number" || !Number.isFinite(params.maxTokens)) {
118
+ errors.push(`parameters.maxTokens must be a finite number, got: ${params.maxTokens}`);
119
+ }
120
+ if (params.topP !== null && (typeof params.topP !== "number" || !Number.isFinite(params.topP))) {
121
+ errors.push(`parameters.topP must be a finite number or null, got: ${params.topP}`);
122
+ }
123
+ if (params.seed !== null && (typeof params.seed !== "number" || !Number.isFinite(params.seed))) {
124
+ errors.push(`parameters.seed must be a finite number or null, got: ${params.seed}`);
125
+ }
126
+ return errors;
127
+ }
128
+ function createSnapshot(params) {
129
+ const paramErrors = validateParameters(params.parameters);
130
+ if (paramErrors.length > 0) {
131
+ throw new Error(`Invalid parameters: ${paramErrors.join("; ")}`);
132
+ }
133
+ const inputHash = computeInputHash(params.input);
134
+ const outputHash = computeOutputHash(params.output);
135
+ const snapshot = {
136
+ type: "ai.execution.v1",
137
+ protocolVersion: "1.2.0",
138
+ executionSurface: "ai",
139
+ executionId: params.executionId,
140
+ timestamp: params.timestamp ?? (/* @__PURE__ */ new Date()).toISOString(),
141
+ provider: params.provider,
142
+ model: params.model,
143
+ modelVersion: params.modelVersion ?? null,
144
+ prompt: params.prompt,
145
+ input: params.input,
146
+ inputHash,
147
+ parameters: {
148
+ temperature: params.parameters.temperature,
149
+ maxTokens: params.parameters.maxTokens,
150
+ topP: params.parameters.topP ?? null,
151
+ seed: params.parameters.seed ?? null
152
+ },
153
+ output: params.output,
154
+ outputHash,
155
+ sdkVersion: params.sdkVersion ?? PACKAGE_VERSION,
156
+ appId: params.appId ?? null
157
+ };
158
+ if (params.runId !== void 0) snapshot.runId = params.runId ?? null;
159
+ if (params.stepId !== void 0) snapshot.stepId = params.stepId ?? null;
160
+ if (params.stepIndex !== void 0) snapshot.stepIndex = params.stepIndex ?? null;
161
+ if (params.workflowId !== void 0) snapshot.workflowId = params.workflowId ?? null;
162
+ if (params.conversationId !== void 0) snapshot.conversationId = params.conversationId ?? null;
163
+ if (params.prevStepHash !== void 0) snapshot.prevStepHash = params.prevStepHash ?? null;
164
+ return snapshot;
165
+ }
166
+
167
+ // src/cer.ts
168
+ function computeCertificateHash(payload) {
169
+ const canonical = toCanonicalJson(payload);
170
+ return `sha256:${sha256Hex(canonical)}`;
171
+ }
172
+ function sealCer(snapshot, options) {
173
+ const createdAt = options?.createdAt ?? (/* @__PURE__ */ new Date()).toISOString();
174
+ const payload = {
175
+ bundleType: "cer.ai.execution.v1",
176
+ createdAt,
177
+ snapshot,
178
+ version: "0.1"
179
+ };
180
+ const certificateHash = computeCertificateHash(payload);
181
+ const bundle = {
182
+ bundleType: "cer.ai.execution.v1",
183
+ certificateHash,
184
+ createdAt,
185
+ version: "0.1",
186
+ snapshot
187
+ };
188
+ if (options?.meta) {
189
+ bundle.meta = options.meta;
190
+ }
191
+ return bundle;
192
+ }
193
+
194
+ // src/providers/wrap.ts
195
+ function wrapProvider(config) {
196
+ return {
197
+ async execute(params) {
198
+ const raw = await config.callFn(params.providerInput);
199
+ const output = config.extractOutput(raw);
200
+ const modelVersion = config.extractModelVersion ? config.extractModelVersion(raw) : params.modelVersion ?? null;
201
+ const snapshot = createSnapshot({
202
+ executionId: params.executionId ?? crypto2.randomUUID(),
203
+ provider: config.provider,
204
+ model: params.model,
205
+ modelVersion,
206
+ prompt: params.prompt,
207
+ input: params.input,
208
+ parameters: params.parameters,
209
+ output,
210
+ appId: params.appId
211
+ });
212
+ const bundle = sealCer(snapshot, { meta: params.meta });
213
+ return { output, snapshot, bundle };
214
+ }
215
+ };
216
+ }
217
+ // Annotate the CommonJS export names for ESM import in node:
218
+ 0 && (module.exports = {
219
+ wrapProvider
220
+ });
221
+ //# sourceMappingURL=wrap.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../src/providers/wrap.ts","../../src/hash.ts","../../src/canonicalJson.ts","../../src/snapshot.ts","../../src/cer.ts"],"sourcesContent":["import * as crypto from 'crypto';\nimport type {\n ProviderConfig,\n WrappedExecutionParams,\n WrappedExecutionResult,\n} from '../types.js';\nimport { createSnapshot } from '../snapshot.js';\nimport { sealCer } from '../cer.js';\n\nexport function wrapProvider<TInput = unknown, TOutput = unknown>(\n config: ProviderConfig<TInput, TOutput>,\n) {\n return {\n async execute(params: WrappedExecutionParams & { providerInput: TInput }): Promise<WrappedExecutionResult> {\n const raw = await config.callFn(params.providerInput);\n const output = config.extractOutput(raw);\n const modelVersion = config.extractModelVersion\n ? config.extractModelVersion(raw)\n : (params.modelVersion ?? null);\n\n const snapshot = createSnapshot({\n executionId: params.executionId ?? crypto.randomUUID(),\n provider: config.provider,\n model: params.model,\n modelVersion,\n prompt: params.prompt,\n input: params.input,\n parameters: params.parameters,\n output,\n appId: params.appId,\n });\n\n const bundle = sealCer(snapshot, { meta: params.meta });\n\n return { output, snapshot, bundle };\n },\n };\n}\n","import * as crypto from 'crypto';\nimport { toCanonicalJson } from './canonicalJson.js';\n\nexport function sha256Hex(data: string | Uint8Array): string {\n const hash = crypto.createHash('sha256');\n if (typeof data === 'string') {\n hash.update(data, 'utf-8');\n } else {\n hash.update(data);\n }\n return hash.digest('hex');\n}\n\nexport function hashUtf8(value: string): string {\n return `sha256:${sha256Hex(value)}`;\n}\n\nexport function hashCanonicalJson(value: unknown): string {\n const canonical = toCanonicalJson(value);\n return `sha256:${sha256Hex(canonical)}`;\n}\n\nexport function computeInputHash(input: string | Record<string, unknown>): string {\n if (typeof input === 'string') {\n return hashUtf8(input);\n }\n return hashCanonicalJson(input);\n}\n\nexport function computeOutputHash(output: string | Record<string, unknown>): string {\n if (typeof output === 'string') {\n return hashUtf8(output);\n }\n return hashCanonicalJson(output);\n}\n","export function toCanonicalJson(value: unknown): string {\n return canonicalize(value);\n}\n\nfunction canonicalize(value: unknown): string {\n if (value === null) {\n return 'null';\n }\n\n if (typeof value === 'boolean') {\n return value ? 'true' : 'false';\n }\n\n if (typeof value === 'number') {\n if (!Number.isFinite(value)) {\n throw new Error(`Non-finite number not allowed in canonical JSON: ${value}`);\n }\n return JSON.stringify(value);\n }\n\n if (typeof value === 'string') {\n return JSON.stringify(value);\n }\n\n if (Array.isArray(value)) {\n const items = value.map(item => canonicalize(item));\n return '[' + items.join(',') + ']';\n }\n\n if (typeof value === 'object') {\n const obj = value as Record<string, unknown>;\n const keys = Object.keys(obj).sort();\n const entries = keys.map(key => {\n const val = obj[key];\n if (val === undefined) {\n return null;\n }\n return JSON.stringify(key) + ':' + canonicalize(val);\n }).filter(e => e !== null);\n return '{' + entries.join(',') + '}';\n }\n\n throw new Error(`Unsupported type for canonical JSON: ${typeof value}`);\n}\n","import type { AiExecutionSnapshotV1, CreateSnapshotParams, VerificationResult, AiExecutionParameters } from './types.js';\nimport { computeInputHash, computeOutputHash } from './hash.js';\n\nconst PACKAGE_VERSION = '0.4.0';\n\nfunction validateParameters(params: AiExecutionParameters): string[] {\n const errors: string[] = [];\n\n if (typeof params.temperature !== 'number' || !Number.isFinite(params.temperature)) {\n errors.push(`parameters.temperature must be a finite number, got: ${params.temperature}`);\n }\n\n if (typeof params.maxTokens !== 'number' || !Number.isFinite(params.maxTokens)) {\n errors.push(`parameters.maxTokens must be a finite number, got: ${params.maxTokens}`);\n }\n\n if (params.topP !== null && (typeof params.topP !== 'number' || !Number.isFinite(params.topP))) {\n errors.push(`parameters.topP must be a finite number or null, got: ${params.topP}`);\n }\n\n if (params.seed !== null && (typeof params.seed !== 'number' || !Number.isFinite(params.seed))) {\n errors.push(`parameters.seed must be a finite number or null, got: ${params.seed}`);\n }\n\n return errors;\n}\n\nexport function createSnapshot(params: CreateSnapshotParams): AiExecutionSnapshotV1 {\n const paramErrors = validateParameters(params.parameters);\n if (paramErrors.length > 0) {\n throw new Error(`Invalid parameters: ${paramErrors.join('; ')}`);\n }\n\n const inputHash = computeInputHash(params.input);\n const outputHash = computeOutputHash(params.output);\n\n const snapshot: AiExecutionSnapshotV1 = {\n type: 'ai.execution.v1',\n protocolVersion: '1.2.0',\n executionSurface: 'ai',\n executionId: params.executionId,\n timestamp: params.timestamp ?? new Date().toISOString(),\n provider: params.provider,\n model: params.model,\n modelVersion: params.modelVersion ?? null,\n prompt: params.prompt,\n input: params.input,\n inputHash,\n parameters: {\n temperature: params.parameters.temperature,\n maxTokens: params.parameters.maxTokens,\n topP: params.parameters.topP ?? null,\n seed: params.parameters.seed ?? null,\n },\n output: params.output,\n outputHash,\n sdkVersion: params.sdkVersion ?? PACKAGE_VERSION,\n appId: params.appId ?? null,\n };\n\n if (params.runId !== undefined) snapshot.runId = params.runId ?? null;\n if (params.stepId !== undefined) snapshot.stepId = params.stepId ?? null;\n if (params.stepIndex !== undefined) snapshot.stepIndex = params.stepIndex ?? null;\n if (params.workflowId !== undefined) snapshot.workflowId = params.workflowId ?? null;\n if (params.conversationId !== undefined) snapshot.conversationId = params.conversationId ?? null;\n if (params.prevStepHash !== undefined) snapshot.prevStepHash = params.prevStepHash ?? null;\n\n return snapshot;\n}\n\nexport function verifySnapshot(snapshot: AiExecutionSnapshotV1): VerificationResult {\n const errors: string[] = [];\n\n if (snapshot.type !== 'ai.execution.v1') {\n errors.push(`Expected type \"ai.execution.v1\", got \"${snapshot.type}\"`);\n }\n\n if (snapshot.protocolVersion !== '1.2.0') {\n errors.push(`Expected protocolVersion \"1.2.0\", got \"${snapshot.protocolVersion}\"`);\n }\n\n if (snapshot.executionSurface !== 'ai') {\n errors.push(`Expected executionSurface \"ai\", got \"${snapshot.executionSurface}\"`);\n }\n\n if (!snapshot.executionId || typeof snapshot.executionId !== 'string') {\n errors.push('executionId must be a non-empty string');\n }\n\n if (!snapshot.timestamp || typeof snapshot.timestamp !== 'string') {\n errors.push('timestamp must be a non-empty string');\n }\n\n if (!snapshot.provider || typeof snapshot.provider !== 'string') {\n errors.push('provider must be a non-empty string');\n }\n\n if (!snapshot.model || typeof snapshot.model !== 'string') {\n errors.push('model must be a non-empty string');\n }\n\n if (!snapshot.prompt || typeof snapshot.prompt !== 'string') {\n errors.push('prompt must be a non-empty string');\n }\n\n if (snapshot.input === undefined || snapshot.input === null) {\n errors.push('input must be a string or object');\n }\n\n if (snapshot.output === undefined || snapshot.output === null) {\n errors.push('output must be a string or object');\n }\n\n const paramErrors = validateParameters(snapshot.parameters);\n errors.push(...paramErrors);\n\n if (!snapshot.inputHash || !snapshot.inputHash.startsWith('sha256:')) {\n errors.push(`inputHash must start with \"sha256:\", got \"${snapshot.inputHash}\"`);\n }\n\n if (!snapshot.outputHash || !snapshot.outputHash.startsWith('sha256:')) {\n errors.push(`outputHash must start with \"sha256:\", got \"${snapshot.outputHash}\"`);\n }\n\n const expectedInputHash = computeInputHash(snapshot.input);\n if (snapshot.inputHash !== expectedInputHash) {\n errors.push(`inputHash mismatch: expected ${expectedInputHash}, got ${snapshot.inputHash}`);\n }\n\n const expectedOutputHash = computeOutputHash(snapshot.output);\n if (snapshot.outputHash !== expectedOutputHash) {\n errors.push(`outputHash mismatch: expected ${expectedOutputHash}, got ${snapshot.outputHash}`);\n }\n\n return { ok: errors.length === 0, errors };\n}\n","import type { AiExecutionSnapshotV1, CerAiExecutionBundle, CerMeta, VerificationResult } from './types.js';\nimport { toCanonicalJson } from './canonicalJson.js';\nimport { sha256Hex } from './hash.js';\nimport { verifySnapshot } from './snapshot.js';\n\ninterface CertificatePayload {\n bundleType: 'cer.ai.execution.v1';\n createdAt: string;\n snapshot: AiExecutionSnapshotV1;\n version: '0.1';\n}\n\nfunction computeCertificateHash(payload: CertificatePayload): string {\n const canonical = toCanonicalJson(payload);\n return `sha256:${sha256Hex(canonical)}`;\n}\n\nexport function sealCer(\n snapshot: AiExecutionSnapshotV1,\n options?: { createdAt?: string; meta?: CerMeta }\n): CerAiExecutionBundle {\n const createdAt = options?.createdAt ?? new Date().toISOString();\n\n const payload: CertificatePayload = {\n bundleType: 'cer.ai.execution.v1',\n createdAt,\n snapshot,\n version: '0.1',\n };\n\n const certificateHash = computeCertificateHash(payload);\n\n const bundle: CerAiExecutionBundle = {\n bundleType: 'cer.ai.execution.v1',\n certificateHash,\n createdAt,\n version: '0.1',\n snapshot,\n };\n\n if (options?.meta) {\n bundle.meta = options.meta;\n }\n\n return bundle;\n}\n\nexport function verifyCer(bundle: CerAiExecutionBundle): VerificationResult {\n const errors: string[] = [];\n\n if (bundle.bundleType !== 'cer.ai.execution.v1') {\n errors.push(`Expected bundleType \"cer.ai.execution.v1\", got \"${bundle.bundleType}\"`);\n }\n\n if (bundle.version !== '0.1') {\n errors.push(`Expected version \"0.1\", got \"${bundle.version}\"`);\n }\n\n if (!bundle.createdAt || typeof bundle.createdAt !== 'string') {\n errors.push('createdAt must be a non-empty string');\n }\n\n if (!bundle.certificateHash || !bundle.certificateHash.startsWith('sha256:')) {\n errors.push(`certificateHash must start with \"sha256:\", got \"${bundle.certificateHash}\"`);\n }\n\n if (!bundle.snapshot) {\n errors.push('snapshot is required');\n return { ok: false, errors };\n }\n\n const snapshotResult = verifySnapshot(bundle.snapshot);\n errors.push(...snapshotResult.errors);\n\n const payload: CertificatePayload = {\n bundleType: 'cer.ai.execution.v1',\n createdAt: bundle.createdAt,\n snapshot: bundle.snapshot,\n version: '0.1',\n };\n\n const expectedHash = computeCertificateHash(payload);\n if (bundle.certificateHash !== expectedHash) {\n errors.push(`certificateHash mismatch: expected ${expectedHash}, got ${bundle.certificateHash}`);\n }\n\n return { ok: errors.length === 0, errors };\n}\n"],"mappings":"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","names":["crypto"]}
@@ -0,0 +1,9 @@
1
+ import { P as ProviderConfig, W as WrappedExecutionParams, h as WrappedExecutionResult } from '../types-DF29BsH5.cjs';
2
+
3
+ declare function wrapProvider<TInput = unknown, TOutput = unknown>(config: ProviderConfig<TInput, TOutput>): {
4
+ execute(params: WrappedExecutionParams & {
5
+ providerInput: TInput;
6
+ }): Promise<WrappedExecutionResult>;
7
+ };
8
+
9
+ export { wrapProvider };
@@ -1,7 +1,9 @@
1
- import type { ProviderConfig, WrappedExecutionParams, WrappedExecutionResult } from '../types.js';
2
- export declare function wrapProvider<TInput = unknown, TOutput = unknown>(config: ProviderConfig<TInput, TOutput>): {
1
+ import { P as ProviderConfig, W as WrappedExecutionParams, h as WrappedExecutionResult } from '../types-DF29BsH5.js';
2
+
3
+ declare function wrapProvider<TInput = unknown, TOutput = unknown>(config: ProviderConfig<TInput, TOutput>): {
3
4
  execute(params: WrappedExecutionParams & {
4
5
  providerInput: TInput;
5
6
  }): Promise<WrappedExecutionResult>;
6
7
  };
7
- //# sourceMappingURL=wrap.d.ts.map
8
+
9
+ export { wrapProvider };
@@ -0,0 +1,186 @@
1
+ // src/providers/wrap.ts
2
+ import * as crypto2 from "crypto";
3
+
4
+ // src/hash.ts
5
+ import * as crypto from "crypto";
6
+
7
+ // src/canonicalJson.ts
8
+ function toCanonicalJson(value) {
9
+ return canonicalize(value);
10
+ }
11
+ function canonicalize(value) {
12
+ if (value === null) {
13
+ return "null";
14
+ }
15
+ if (typeof value === "boolean") {
16
+ return value ? "true" : "false";
17
+ }
18
+ if (typeof value === "number") {
19
+ if (!Number.isFinite(value)) {
20
+ throw new Error(`Non-finite number not allowed in canonical JSON: ${value}`);
21
+ }
22
+ return JSON.stringify(value);
23
+ }
24
+ if (typeof value === "string") {
25
+ return JSON.stringify(value);
26
+ }
27
+ if (Array.isArray(value)) {
28
+ const items = value.map((item) => canonicalize(item));
29
+ return "[" + items.join(",") + "]";
30
+ }
31
+ if (typeof value === "object") {
32
+ const obj = value;
33
+ const keys = Object.keys(obj).sort();
34
+ const entries = keys.map((key) => {
35
+ const val = obj[key];
36
+ if (val === void 0) {
37
+ return null;
38
+ }
39
+ return JSON.stringify(key) + ":" + canonicalize(val);
40
+ }).filter((e) => e !== null);
41
+ return "{" + entries.join(",") + "}";
42
+ }
43
+ throw new Error(`Unsupported type for canonical JSON: ${typeof value}`);
44
+ }
45
+
46
+ // src/hash.ts
47
+ function sha256Hex(data) {
48
+ const hash = crypto.createHash("sha256");
49
+ if (typeof data === "string") {
50
+ hash.update(data, "utf-8");
51
+ } else {
52
+ hash.update(data);
53
+ }
54
+ return hash.digest("hex");
55
+ }
56
+ function hashUtf8(value) {
57
+ return `sha256:${sha256Hex(value)}`;
58
+ }
59
+ function hashCanonicalJson(value) {
60
+ const canonical = toCanonicalJson(value);
61
+ return `sha256:${sha256Hex(canonical)}`;
62
+ }
63
+ function computeInputHash(input) {
64
+ if (typeof input === "string") {
65
+ return hashUtf8(input);
66
+ }
67
+ return hashCanonicalJson(input);
68
+ }
69
+ function computeOutputHash(output) {
70
+ if (typeof output === "string") {
71
+ return hashUtf8(output);
72
+ }
73
+ return hashCanonicalJson(output);
74
+ }
75
+
76
+ // src/snapshot.ts
77
+ var PACKAGE_VERSION = "0.4.0";
78
+ function validateParameters(params) {
79
+ const errors = [];
80
+ if (typeof params.temperature !== "number" || !Number.isFinite(params.temperature)) {
81
+ errors.push(`parameters.temperature must be a finite number, got: ${params.temperature}`);
82
+ }
83
+ if (typeof params.maxTokens !== "number" || !Number.isFinite(params.maxTokens)) {
84
+ errors.push(`parameters.maxTokens must be a finite number, got: ${params.maxTokens}`);
85
+ }
86
+ if (params.topP !== null && (typeof params.topP !== "number" || !Number.isFinite(params.topP))) {
87
+ errors.push(`parameters.topP must be a finite number or null, got: ${params.topP}`);
88
+ }
89
+ if (params.seed !== null && (typeof params.seed !== "number" || !Number.isFinite(params.seed))) {
90
+ errors.push(`parameters.seed must be a finite number or null, got: ${params.seed}`);
91
+ }
92
+ return errors;
93
+ }
94
+ function createSnapshot(params) {
95
+ const paramErrors = validateParameters(params.parameters);
96
+ if (paramErrors.length > 0) {
97
+ throw new Error(`Invalid parameters: ${paramErrors.join("; ")}`);
98
+ }
99
+ const inputHash = computeInputHash(params.input);
100
+ const outputHash = computeOutputHash(params.output);
101
+ const snapshot = {
102
+ type: "ai.execution.v1",
103
+ protocolVersion: "1.2.0",
104
+ executionSurface: "ai",
105
+ executionId: params.executionId,
106
+ timestamp: params.timestamp ?? (/* @__PURE__ */ new Date()).toISOString(),
107
+ provider: params.provider,
108
+ model: params.model,
109
+ modelVersion: params.modelVersion ?? null,
110
+ prompt: params.prompt,
111
+ input: params.input,
112
+ inputHash,
113
+ parameters: {
114
+ temperature: params.parameters.temperature,
115
+ maxTokens: params.parameters.maxTokens,
116
+ topP: params.parameters.topP ?? null,
117
+ seed: params.parameters.seed ?? null
118
+ },
119
+ output: params.output,
120
+ outputHash,
121
+ sdkVersion: params.sdkVersion ?? PACKAGE_VERSION,
122
+ appId: params.appId ?? null
123
+ };
124
+ if (params.runId !== void 0) snapshot.runId = params.runId ?? null;
125
+ if (params.stepId !== void 0) snapshot.stepId = params.stepId ?? null;
126
+ if (params.stepIndex !== void 0) snapshot.stepIndex = params.stepIndex ?? null;
127
+ if (params.workflowId !== void 0) snapshot.workflowId = params.workflowId ?? null;
128
+ if (params.conversationId !== void 0) snapshot.conversationId = params.conversationId ?? null;
129
+ if (params.prevStepHash !== void 0) snapshot.prevStepHash = params.prevStepHash ?? null;
130
+ return snapshot;
131
+ }
132
+
133
+ // src/cer.ts
134
+ function computeCertificateHash(payload) {
135
+ const canonical = toCanonicalJson(payload);
136
+ return `sha256:${sha256Hex(canonical)}`;
137
+ }
138
+ function sealCer(snapshot, options) {
139
+ const createdAt = options?.createdAt ?? (/* @__PURE__ */ new Date()).toISOString();
140
+ const payload = {
141
+ bundleType: "cer.ai.execution.v1",
142
+ createdAt,
143
+ snapshot,
144
+ version: "0.1"
145
+ };
146
+ const certificateHash = computeCertificateHash(payload);
147
+ const bundle = {
148
+ bundleType: "cer.ai.execution.v1",
149
+ certificateHash,
150
+ createdAt,
151
+ version: "0.1",
152
+ snapshot
153
+ };
154
+ if (options?.meta) {
155
+ bundle.meta = options.meta;
156
+ }
157
+ return bundle;
158
+ }
159
+
160
+ // src/providers/wrap.ts
161
+ function wrapProvider(config) {
162
+ return {
163
+ async execute(params) {
164
+ const raw = await config.callFn(params.providerInput);
165
+ const output = config.extractOutput(raw);
166
+ const modelVersion = config.extractModelVersion ? config.extractModelVersion(raw) : params.modelVersion ?? null;
167
+ const snapshot = createSnapshot({
168
+ executionId: params.executionId ?? crypto2.randomUUID(),
169
+ provider: config.provider,
170
+ model: params.model,
171
+ modelVersion,
172
+ prompt: params.prompt,
173
+ input: params.input,
174
+ parameters: params.parameters,
175
+ output,
176
+ appId: params.appId
177
+ });
178
+ const bundle = sealCer(snapshot, { meta: params.meta });
179
+ return { output, snapshot, bundle };
180
+ }
181
+ };
182
+ }
183
+ export {
184
+ wrapProvider
185
+ };
186
+ //# sourceMappingURL=wrap.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../src/providers/wrap.ts","../../src/hash.ts","../../src/canonicalJson.ts","../../src/snapshot.ts","../../src/cer.ts"],"sourcesContent":["import * as crypto from 'crypto';\nimport type {\n ProviderConfig,\n WrappedExecutionParams,\n WrappedExecutionResult,\n} from '../types.js';\nimport { createSnapshot } from '../snapshot.js';\nimport { sealCer } from '../cer.js';\n\nexport function wrapProvider<TInput = unknown, TOutput = unknown>(\n config: ProviderConfig<TInput, TOutput>,\n) {\n return {\n async execute(params: WrappedExecutionParams & { providerInput: TInput }): Promise<WrappedExecutionResult> {\n const raw = await config.callFn(params.providerInput);\n const output = config.extractOutput(raw);\n const modelVersion = config.extractModelVersion\n ? config.extractModelVersion(raw)\n : (params.modelVersion ?? null);\n\n const snapshot = createSnapshot({\n executionId: params.executionId ?? crypto.randomUUID(),\n provider: config.provider,\n model: params.model,\n modelVersion,\n prompt: params.prompt,\n input: params.input,\n parameters: params.parameters,\n output,\n appId: params.appId,\n });\n\n const bundle = sealCer(snapshot, { meta: params.meta });\n\n return { output, snapshot, bundle };\n },\n };\n}\n","import * as crypto from 'crypto';\nimport { toCanonicalJson } from './canonicalJson.js';\n\nexport function sha256Hex(data: string | Uint8Array): string {\n const hash = crypto.createHash('sha256');\n if (typeof data === 'string') {\n hash.update(data, 'utf-8');\n } else {\n hash.update(data);\n }\n return hash.digest('hex');\n}\n\nexport function hashUtf8(value: string): string {\n return `sha256:${sha256Hex(value)}`;\n}\n\nexport function hashCanonicalJson(value: unknown): string {\n const canonical = toCanonicalJson(value);\n return `sha256:${sha256Hex(canonical)}`;\n}\n\nexport function computeInputHash(input: string | Record<string, unknown>): string {\n if (typeof input === 'string') {\n return hashUtf8(input);\n }\n return hashCanonicalJson(input);\n}\n\nexport function computeOutputHash(output: string | Record<string, unknown>): string {\n if (typeof output === 'string') {\n return hashUtf8(output);\n }\n return hashCanonicalJson(output);\n}\n","export function toCanonicalJson(value: unknown): string {\n return canonicalize(value);\n}\n\nfunction canonicalize(value: unknown): string {\n if (value === null) {\n return 'null';\n }\n\n if (typeof value === 'boolean') {\n return value ? 'true' : 'false';\n }\n\n if (typeof value === 'number') {\n if (!Number.isFinite(value)) {\n throw new Error(`Non-finite number not allowed in canonical JSON: ${value}`);\n }\n return JSON.stringify(value);\n }\n\n if (typeof value === 'string') {\n return JSON.stringify(value);\n }\n\n if (Array.isArray(value)) {\n const items = value.map(item => canonicalize(item));\n return '[' + items.join(',') + ']';\n }\n\n if (typeof value === 'object') {\n const obj = value as Record<string, unknown>;\n const keys = Object.keys(obj).sort();\n const entries = keys.map(key => {\n const val = obj[key];\n if (val === undefined) {\n return null;\n }\n return JSON.stringify(key) + ':' + canonicalize(val);\n }).filter(e => e !== null);\n return '{' + entries.join(',') + '}';\n }\n\n throw new Error(`Unsupported type for canonical JSON: ${typeof value}`);\n}\n","import type { AiExecutionSnapshotV1, CreateSnapshotParams, VerificationResult, AiExecutionParameters } from './types.js';\nimport { computeInputHash, computeOutputHash } from './hash.js';\n\nconst PACKAGE_VERSION = '0.4.0';\n\nfunction validateParameters(params: AiExecutionParameters): string[] {\n const errors: string[] = [];\n\n if (typeof params.temperature !== 'number' || !Number.isFinite(params.temperature)) {\n errors.push(`parameters.temperature must be a finite number, got: ${params.temperature}`);\n }\n\n if (typeof params.maxTokens !== 'number' || !Number.isFinite(params.maxTokens)) {\n errors.push(`parameters.maxTokens must be a finite number, got: ${params.maxTokens}`);\n }\n\n if (params.topP !== null && (typeof params.topP !== 'number' || !Number.isFinite(params.topP))) {\n errors.push(`parameters.topP must be a finite number or null, got: ${params.topP}`);\n }\n\n if (params.seed !== null && (typeof params.seed !== 'number' || !Number.isFinite(params.seed))) {\n errors.push(`parameters.seed must be a finite number or null, got: ${params.seed}`);\n }\n\n return errors;\n}\n\nexport function createSnapshot(params: CreateSnapshotParams): AiExecutionSnapshotV1 {\n const paramErrors = validateParameters(params.parameters);\n if (paramErrors.length > 0) {\n throw new Error(`Invalid parameters: ${paramErrors.join('; ')}`);\n }\n\n const inputHash = computeInputHash(params.input);\n const outputHash = computeOutputHash(params.output);\n\n const snapshot: AiExecutionSnapshotV1 = {\n type: 'ai.execution.v1',\n protocolVersion: '1.2.0',\n executionSurface: 'ai',\n executionId: params.executionId,\n timestamp: params.timestamp ?? new Date().toISOString(),\n provider: params.provider,\n model: params.model,\n modelVersion: params.modelVersion ?? null,\n prompt: params.prompt,\n input: params.input,\n inputHash,\n parameters: {\n temperature: params.parameters.temperature,\n maxTokens: params.parameters.maxTokens,\n topP: params.parameters.topP ?? null,\n seed: params.parameters.seed ?? null,\n },\n output: params.output,\n outputHash,\n sdkVersion: params.sdkVersion ?? PACKAGE_VERSION,\n appId: params.appId ?? null,\n };\n\n if (params.runId !== undefined) snapshot.runId = params.runId ?? null;\n if (params.stepId !== undefined) snapshot.stepId = params.stepId ?? null;\n if (params.stepIndex !== undefined) snapshot.stepIndex = params.stepIndex ?? null;\n if (params.workflowId !== undefined) snapshot.workflowId = params.workflowId ?? null;\n if (params.conversationId !== undefined) snapshot.conversationId = params.conversationId ?? null;\n if (params.prevStepHash !== undefined) snapshot.prevStepHash = params.prevStepHash ?? null;\n\n return snapshot;\n}\n\nexport function verifySnapshot(snapshot: AiExecutionSnapshotV1): VerificationResult {\n const errors: string[] = [];\n\n if (snapshot.type !== 'ai.execution.v1') {\n errors.push(`Expected type \"ai.execution.v1\", got \"${snapshot.type}\"`);\n }\n\n if (snapshot.protocolVersion !== '1.2.0') {\n errors.push(`Expected protocolVersion \"1.2.0\", got \"${snapshot.protocolVersion}\"`);\n }\n\n if (snapshot.executionSurface !== 'ai') {\n errors.push(`Expected executionSurface \"ai\", got \"${snapshot.executionSurface}\"`);\n }\n\n if (!snapshot.executionId || typeof snapshot.executionId !== 'string') {\n errors.push('executionId must be a non-empty string');\n }\n\n if (!snapshot.timestamp || typeof snapshot.timestamp !== 'string') {\n errors.push('timestamp must be a non-empty string');\n }\n\n if (!snapshot.provider || typeof snapshot.provider !== 'string') {\n errors.push('provider must be a non-empty string');\n }\n\n if (!snapshot.model || typeof snapshot.model !== 'string') {\n errors.push('model must be a non-empty string');\n }\n\n if (!snapshot.prompt || typeof snapshot.prompt !== 'string') {\n errors.push('prompt must be a non-empty string');\n }\n\n if (snapshot.input === undefined || snapshot.input === null) {\n errors.push('input must be a string or object');\n }\n\n if (snapshot.output === undefined || snapshot.output === null) {\n errors.push('output must be a string or object');\n }\n\n const paramErrors = validateParameters(snapshot.parameters);\n errors.push(...paramErrors);\n\n if (!snapshot.inputHash || !snapshot.inputHash.startsWith('sha256:')) {\n errors.push(`inputHash must start with \"sha256:\", got \"${snapshot.inputHash}\"`);\n }\n\n if (!snapshot.outputHash || !snapshot.outputHash.startsWith('sha256:')) {\n errors.push(`outputHash must start with \"sha256:\", got \"${snapshot.outputHash}\"`);\n }\n\n const expectedInputHash = computeInputHash(snapshot.input);\n if (snapshot.inputHash !== expectedInputHash) {\n errors.push(`inputHash mismatch: expected ${expectedInputHash}, got ${snapshot.inputHash}`);\n }\n\n const expectedOutputHash = computeOutputHash(snapshot.output);\n if (snapshot.outputHash !== expectedOutputHash) {\n errors.push(`outputHash mismatch: expected ${expectedOutputHash}, got ${snapshot.outputHash}`);\n }\n\n return { ok: errors.length === 0, errors };\n}\n","import type { AiExecutionSnapshotV1, CerAiExecutionBundle, CerMeta, VerificationResult } from './types.js';\nimport { toCanonicalJson } from './canonicalJson.js';\nimport { sha256Hex } from './hash.js';\nimport { verifySnapshot } from './snapshot.js';\n\ninterface CertificatePayload {\n bundleType: 'cer.ai.execution.v1';\n createdAt: string;\n snapshot: AiExecutionSnapshotV1;\n version: '0.1';\n}\n\nfunction computeCertificateHash(payload: CertificatePayload): string {\n const canonical = toCanonicalJson(payload);\n return `sha256:${sha256Hex(canonical)}`;\n}\n\nexport function sealCer(\n snapshot: AiExecutionSnapshotV1,\n options?: { createdAt?: string; meta?: CerMeta }\n): CerAiExecutionBundle {\n const createdAt = options?.createdAt ?? new Date().toISOString();\n\n const payload: CertificatePayload = {\n bundleType: 'cer.ai.execution.v1',\n createdAt,\n snapshot,\n version: '0.1',\n };\n\n const certificateHash = computeCertificateHash(payload);\n\n const bundle: CerAiExecutionBundle = {\n bundleType: 'cer.ai.execution.v1',\n certificateHash,\n createdAt,\n version: '0.1',\n snapshot,\n };\n\n if (options?.meta) {\n bundle.meta = options.meta;\n }\n\n return bundle;\n}\n\nexport function verifyCer(bundle: CerAiExecutionBundle): VerificationResult {\n const errors: string[] = [];\n\n if (bundle.bundleType !== 'cer.ai.execution.v1') {\n errors.push(`Expected bundleType \"cer.ai.execution.v1\", got \"${bundle.bundleType}\"`);\n }\n\n if (bundle.version !== '0.1') {\n errors.push(`Expected version \"0.1\", got \"${bundle.version}\"`);\n }\n\n if (!bundle.createdAt || typeof bundle.createdAt !== 'string') {\n errors.push('createdAt must be a non-empty string');\n }\n\n if (!bundle.certificateHash || !bundle.certificateHash.startsWith('sha256:')) {\n errors.push(`certificateHash must start with \"sha256:\", got \"${bundle.certificateHash}\"`);\n }\n\n if (!bundle.snapshot) {\n errors.push('snapshot is required');\n return { ok: false, errors };\n }\n\n const snapshotResult = verifySnapshot(bundle.snapshot);\n errors.push(...snapshotResult.errors);\n\n const payload: CertificatePayload = {\n bundleType: 'cer.ai.execution.v1',\n createdAt: bundle.createdAt,\n snapshot: bundle.snapshot,\n version: '0.1',\n };\n\n const expectedHash = computeCertificateHash(payload);\n if (bundle.certificateHash !== expectedHash) {\n errors.push(`certificateHash mismatch: expected ${expectedHash}, got ${bundle.certificateHash}`);\n }\n\n return { ok: errors.length === 0, errors };\n}\n"],"mappings":"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","names":["crypto"]}
@@ -1,10 +1,10 @@
1
- export interface AiExecutionParameters {
1
+ interface AiExecutionParameters {
2
2
  temperature: number;
3
3
  maxTokens: number;
4
4
  topP: number | null;
5
5
  seed: number | null;
6
6
  }
7
- export interface AiExecutionSnapshotV1 {
7
+ interface AiExecutionSnapshotV1 {
8
8
  type: 'ai.execution.v1';
9
9
  protocolVersion: '1.2.0';
10
10
  executionSurface: 'ai';
@@ -28,12 +28,12 @@ export interface AiExecutionSnapshotV1 {
28
28
  conversationId?: string | null;
29
29
  prevStepHash?: string | null;
30
30
  }
31
- export interface CerMeta {
31
+ interface CerMeta {
32
32
  source?: string;
33
33
  tags?: string[];
34
34
  [key: string]: unknown;
35
35
  }
36
- export interface CerAiExecutionBundle {
36
+ interface CerAiExecutionBundle {
37
37
  bundleType: 'cer.ai.execution.v1';
38
38
  certificateHash: string;
39
39
  createdAt: string;
@@ -41,11 +41,11 @@ export interface CerAiExecutionBundle {
41
41
  snapshot: AiExecutionSnapshotV1;
42
42
  meta?: CerMeta;
43
43
  }
44
- export interface VerificationResult {
44
+ interface VerificationResult {
45
45
  ok: boolean;
46
46
  errors: string[];
47
47
  }
48
- export interface CreateSnapshotParams {
48
+ interface CreateSnapshotParams {
49
49
  executionId: string;
50
50
  timestamp?: string;
51
51
  provider: string;
@@ -64,7 +64,7 @@ export interface CreateSnapshotParams {
64
64
  conversationId?: string | null;
65
65
  prevStepHash?: string | null;
66
66
  }
67
- export interface AttestationResult {
67
+ interface AttestationResult {
68
68
  ok: boolean;
69
69
  attestationId?: string;
70
70
  nodeRuntimeHash?: string;
@@ -73,11 +73,12 @@ export interface AttestationResult {
73
73
  errors?: string[];
74
74
  raw?: unknown;
75
75
  }
76
- export interface AttestOptions {
76
+ interface AttestOptions {
77
77
  nodeUrl: string;
78
78
  apiKey: string;
79
+ timeoutMs?: number;
79
80
  }
80
- export interface CertifyDecisionParams {
81
+ interface CertifyDecisionParams {
81
82
  executionId?: string;
82
83
  timestamp?: string;
83
84
  provider: string;
@@ -97,13 +98,13 @@ export interface CertifyDecisionParams {
97
98
  conversationId?: string | null;
98
99
  prevStepHash?: string | null;
99
100
  }
100
- export interface RunBuilderOptions {
101
+ interface RunBuilderOptions {
101
102
  runId?: string;
102
103
  workflowId?: string | null;
103
104
  conversationId?: string | null;
104
105
  appId?: string | null;
105
106
  }
106
- export interface StepParams {
107
+ interface StepParams {
107
108
  stepId?: string;
108
109
  provider: string;
109
110
  model: string;
@@ -115,7 +116,7 @@ export interface StepParams {
115
116
  timestamp?: string;
116
117
  meta?: CerMeta;
117
118
  }
118
- export interface RunSummary {
119
+ interface RunSummary {
119
120
  runId: string;
120
121
  workflowId: string | null;
121
122
  conversationId: string | null;
@@ -129,13 +130,13 @@ export interface RunSummary {
129
130
  }>;
130
131
  finalStepHash: string | null;
131
132
  }
132
- export interface ProviderConfig<TInput = unknown, TOutput = unknown> {
133
+ interface ProviderConfig<TInput = unknown, TOutput = unknown> {
133
134
  provider: string;
134
135
  callFn: (input: TInput) => Promise<TOutput>;
135
136
  extractOutput: (raw: TOutput) => string | Record<string, unknown>;
136
137
  extractModelVersion?: (raw: TOutput) => string | null;
137
138
  }
138
- export interface WrappedExecutionParams {
139
+ interface WrappedExecutionParams {
139
140
  prompt: string;
140
141
  input: string | Record<string, unknown>;
141
142
  model: string;
@@ -145,9 +146,10 @@ export interface WrappedExecutionParams {
145
146
  meta?: CerMeta;
146
147
  executionId?: string;
147
148
  }
148
- export interface WrappedExecutionResult {
149
+ interface WrappedExecutionResult {
149
150
  output: string | Record<string, unknown>;
150
151
  snapshot: AiExecutionSnapshotV1;
151
152
  bundle: CerAiExecutionBundle;
152
153
  }
153
- //# sourceMappingURL=types.d.ts.map
154
+
155
+ export type { AiExecutionSnapshotV1 as A, CreateSnapshotParams as C, ProviderConfig as P, RunBuilderOptions as R, StepParams as S, VerificationResult as V, WrappedExecutionParams as W, CerMeta as a, CerAiExecutionBundle as b, CertifyDecisionParams as c, RunSummary as d, AttestOptions as e, AttestationResult as f, AiExecutionParameters as g, WrappedExecutionResult as h };