@nexart/ai-execution 0.10.0 → 0.12.0

package/dist/{types-C5t12OK8.d.cts → types-C_M2xSWK.d.cts}

@@ -87,6 +87,42 @@ interface CerMeta {
     tags?: string[];
     [key: string]: unknown;
 }
+/**
+ * A single upstream signal captured for optional inclusion in a CER.
+ *
+ * Structurally identical to NexArtSignal from @nexart/signals — consumers
+ * using that package can pass NexArtSignal[] directly.
+ *
+ * NexArt does not interpret the meaning of signals or their payload.
+ *
+ * v0.10.0 — included in certificateHash when present via bundle.context.
+ */
+interface CerContextSignal {
+    /** Signal category — free-form. */
+    type: string;
+    /** Upstream system or protocol — free-form. */
+    source: string;
+    /** Position in sequence. */
+    step: number;
+    /** ISO 8601 timestamp. */
+    timestamp: string;
+    /** Actor that produced this signal — free-form. */
+    actor: string;
+    /** Outcome or state — free-form (e.g. "ok", "error", "pending"). */
+    status: string;
+    /** Opaque upstream payload. NexArt does not interpret this field. */
+    payload: Record<string, unknown>;
+}
+/**
+ * Optional top-level context block for a CER bundle.
+ *
+ * Included in certificateHash when present.
+ * Omit entirely (or leave signals empty) to get identical hashing to pre-v0.10.0 bundles.
+ */
+interface CerContext {
+    /** Upstream signals captured as optional evidence. */
+    signals: CerContextSignal[];
+}
 interface CerAiExecutionBundle {
     bundleType: 'cer.ai.execution.v1';
     certificateHash: string;
@@ -100,6 +136,12 @@ interface CerAiExecutionBundle {
      * Satisfies AIEF-02 SHOULD requirement for self-describing artifacts.
      */
     declaration?: BundleDeclaration;
+    /**
+     * v0.10.0 — Optional upstream signal evidence.
+     * INCLUDED in certificateHash computation when present (signals are evidence, not metadata).
+     * Omit to get identical hashing to pre-v0.10.0 bundles.
+     */
+    context?: CerContext;
 }
 declare const CerVerifyCode: {
     readonly OK: "OK";
@@ -229,6 +271,12 @@ interface CertifyDecisionParams {
     workflowId?: string | null;
     conversationId?: string | null;
     prevStepHash?: string | null;
+    /**
+     * v0.10.0 — Optional upstream signals to bind as evidence in the CER.
+     * When provided, included in certificateHash via bundle.context.signals.
+     * Accepts NexArtSignal[] from @nexart/signals directly (structurally compatible).
+     */
+    signals?: CerContextSignal[];
 }
 interface RunBuilderOptions {
     runId?: string;
@@ -335,4 +383,4 @@ interface WrappedExecutionResult {
     bundle: CerAiExecutionBundle;
 }
 
-export { type AiExecutionSnapshotV1 as A, type BundleDeclaration as B, type CreateSnapshotParams as C, type NodeKeysDocument as N, type ProviderCallParams as P, type RunBuilderOptions as R, type StepParams as S, type ToolEvent as T, type VerificationResult as V, type WrappedExecutionParams as W, type CerMeta as a, type CerAiExecutionBundle as b, type CertifyDecisionParams as c, type RunSummary as d, type AttestOptions as e, type AttestationResult as f, type SanitizeStorageOptions as g, type AttestationReceipt as h, type NodeReceiptVerifyResult as i, type SignedAttestationReceipt as j, CerVerifyCode as k, type AiefVerifyResult as l, type RunSummaryVerifyResult as m, type AiefProfile as n, type AiExecutionParameters as o, type AttestationReceiptResult as p, type ClientDefaults as q, type NexArtClient as r, type ProviderCallResult as s, type ProviderConfig as t, type RedactionEnvelope as u, type WrappedExecutionResult as v };
+export { type AiExecutionSnapshotV1 as A, type BundleDeclaration as B, type CreateSnapshotParams as C, type NodeKeysDocument as N, type ProviderCallParams as P, type RunBuilderOptions as R, type StepParams as S, type ToolEvent as T, type VerificationResult as V, type WrappedExecutionParams as W, type CerMeta as a, type CerContextSignal as b, type CerAiExecutionBundle as c, type CertifyDecisionParams as d, type RunSummary as e, type AttestOptions as f, type AttestationResult as g, type SanitizeStorageOptions as h, type AttestationReceipt as i, type NodeReceiptVerifyResult as j, type SignedAttestationReceipt as k, CerVerifyCode as l, type AiefVerifyResult as m, type RunSummaryVerifyResult as n, type AiefProfile as o, type AiExecutionParameters as p, type AttestationReceiptResult as q, type CerContext as r, type ClientDefaults as s, type NexArtClient as t, type ProviderCallResult as u, type ProviderConfig as v, type RedactionEnvelope as w, type WrappedExecutionResult as x };

package/dist/{types-C5t12OK8.d.ts → types-C_M2xSWK.d.ts}

@@ -87,6 +87,42 @@ interface CerMeta {
     tags?: string[];
     [key: string]: unknown;
 }
+/**
+ * A single upstream signal captured for optional inclusion in a CER.
+ *
+ * Structurally identical to NexArtSignal from @nexart/signals — consumers
+ * using that package can pass NexArtSignal[] directly.
+ *
+ * NexArt does not interpret the meaning of signals or their payload.
+ *
+ * v0.10.0 — included in certificateHash when present via bundle.context.
+ */
+interface CerContextSignal {
+    /** Signal category — free-form. */
+    type: string;
+    /** Upstream system or protocol — free-form. */
+    source: string;
+    /** Position in sequence. */
+    step: number;
+    /** ISO 8601 timestamp. */
+    timestamp: string;
+    /** Actor that produced this signal — free-form. */
+    actor: string;
+    /** Outcome or state — free-form (e.g. "ok", "error", "pending"). */
+    status: string;
+    /** Opaque upstream payload. NexArt does not interpret this field. */
+    payload: Record<string, unknown>;
+}
+/**
+ * Optional top-level context block for a CER bundle.
+ *
+ * Included in certificateHash when present.
+ * Omit entirely (or leave signals empty) to get identical hashing to pre-v0.10.0 bundles.
+ */
+interface CerContext {
+    /** Upstream signals captured as optional evidence. */
+    signals: CerContextSignal[];
+}
 interface CerAiExecutionBundle {
     bundleType: 'cer.ai.execution.v1';
     certificateHash: string;
@@ -100,6 +136,12 @@ interface CerAiExecutionBundle {
      * Satisfies AIEF-02 SHOULD requirement for self-describing artifacts.
      */
     declaration?: BundleDeclaration;
+    /**
+     * v0.10.0 — Optional upstream signal evidence.
+     * INCLUDED in certificateHash computation when present (signals are evidence, not metadata).
+     * Omit to get identical hashing to pre-v0.10.0 bundles.
+     */
+    context?: CerContext;
 }
 declare const CerVerifyCode: {
     readonly OK: "OK";
@@ -229,6 +271,12 @@ interface CertifyDecisionParams {
     workflowId?: string | null;
     conversationId?: string | null;
     prevStepHash?: string | null;
+    /**
+     * v0.10.0 — Optional upstream signals to bind as evidence in the CER.
+     * When provided, included in certificateHash via bundle.context.signals.
+     * Accepts NexArtSignal[] from @nexart/signals directly (structurally compatible).
+     */
+    signals?: CerContextSignal[];
 }
 interface RunBuilderOptions {
     runId?: string;
@@ -335,4 +383,4 @@ interface WrappedExecutionResult {
     bundle: CerAiExecutionBundle;
 }
 
-export { type AiExecutionSnapshotV1 as A, type BundleDeclaration as B, type CreateSnapshotParams as C, type NodeKeysDocument as N, type ProviderCallParams as P, type RunBuilderOptions as R, type StepParams as S, type ToolEvent as T, type VerificationResult as V, type WrappedExecutionParams as W, type CerMeta as a, type CerAiExecutionBundle as b, type CertifyDecisionParams as c, type RunSummary as d, type AttestOptions as e, type AttestationResult as f, type SanitizeStorageOptions as g, type AttestationReceipt as h, type NodeReceiptVerifyResult as i, type SignedAttestationReceipt as j, CerVerifyCode as k, type AiefVerifyResult as l, type RunSummaryVerifyResult as m, type AiefProfile as n, type AiExecutionParameters as o, type AttestationReceiptResult as p, type ClientDefaults as q, type NexArtClient as r, type ProviderCallResult as s, type ProviderConfig as t, type RedactionEnvelope as u, type WrappedExecutionResult as v };
+export { type AiExecutionSnapshotV1 as A, type BundleDeclaration as B, type CreateSnapshotParams as C, type NodeKeysDocument as N, type ProviderCallParams as P, type RunBuilderOptions as R, type StepParams as S, type ToolEvent as T, type VerificationResult as V, type WrappedExecutionParams as W, type CerMeta as a, type CerContextSignal as b, type CerAiExecutionBundle as c, type CertifyDecisionParams as d, type RunSummary as e, type AttestOptions as f, type AttestationResult as g, type SanitizeStorageOptions as h, type AttestationReceipt as i, type NodeReceiptVerifyResult as j, type SignedAttestationReceipt as k, CerVerifyCode as l, type AiefVerifyResult as m, type RunSummaryVerifyResult as n, type AiefProfile as o, type AiExecutionParameters as p, type AttestationReceiptResult as q, type CerContext as r, type ClientDefaults as s, type NexArtClient as t, type ProviderCallResult as u, type ProviderConfig as v, type RedactionEnvelope as w, type WrappedExecutionResult as x };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nexart/ai-execution",
-  "version": "0.10.0",
+  "version": "0.12.0",
   "description": "AI Execution Integrity — tamper-evident records and Certified Execution Records (CER) for AI operations",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -37,7 +37,7 @@
   "scripts": {
     "build": "node \"$(node -p 'require.resolve(\"tsup/dist/cli-default\")')\"",
     "build:tsc": "node \"$(node -p 'require.resolve(\"typescript/bin/tsc\")')\"",
-    "test": "node \"$(node -p 'require.resolve(\"typescript/bin/tsc\")')\" && node --test --test-concurrency 1 dist-tsc/__tests__/vectors.test.js dist-tsc/__tests__/fixtures.test.js dist-tsc/__tests__/v020.test.js dist-tsc/__tests__/v030.test.js dist-tsc/__tests__/v040.test.js dist-tsc/__tests__/v041.test.js dist-tsc/__tests__/v042.test.js dist-tsc/__tests__/v050.test.js dist-tsc/__tests__/v060.test.js dist-tsc/__tests__/v070.test.js dist-tsc/__tests__/v071.test.js dist-tsc/__tests__/cerProtocol.test.js dist-tsc/__tests__/langchain.test.js",
+    "test": "node \"$(node -p 'require.resolve(\"typescript/bin/tsc\")')\" && node --test --test-concurrency 1 dist-tsc/__tests__/vectors.test.js dist-tsc/__tests__/fixtures.test.js dist-tsc/__tests__/v020.test.js dist-tsc/__tests__/v030.test.js dist-tsc/__tests__/v040.test.js dist-tsc/__tests__/v041.test.js dist-tsc/__tests__/v042.test.js dist-tsc/__tests__/v050.test.js dist-tsc/__tests__/v060.test.js dist-tsc/__tests__/v070.test.js dist-tsc/__tests__/v071.test.js dist-tsc/__tests__/cerProtocol.test.js dist-tsc/__tests__/langchain.test.js dist-tsc/__tests__/cerSignals.test.js dist-tsc/__tests__/cerPackage.test.js",
     "release": "npm run build && npm run test && npm version patch && npm publish --access public",
     "prepublishOnly": "npm run build && npm run test"
   },