@chaoschain/sdk 0.2.3 → 0.3.0

package/dist/providers/compute/index.d.cts

@@ -1,4 +1,4 @@
-import { o as ComputeProvider } from '../../types-CEFAgoAM.cjs';
+import { o as ComputeProvider } from '../../types-BBVtx_jV.cjs';
 import 'ethers';
 
 /**

package/dist/providers/compute/index.d.ts

@@ -1,4 +1,4 @@
-import { o as ComputeProvider } from '../../types-CEFAgoAM.js';
+import { o as ComputeProvider } from '../../types-BBVtx_jV.js';
 import 'ethers';
 
 /**

package/dist/providers/storage/index.d.cts

@@ -1,5 +1,5 @@
-export { I as IPFSLocalStorage } from '../../IPFSLocal-DqzD3Y7I.cjs';
-import { n as StorageProvider, U as UploadOptions, i as UploadResult } from '../../types-CEFAgoAM.cjs';
+export { I as IPFSLocalStorage } from '../../IPFSLocal-zRj6kG8e.cjs';
+import { n as StorageProvider, U as UploadOptions, i as UploadResult } from '../../types-BBVtx_jV.cjs';
 import 'ethers';
 
 /**

package/dist/providers/storage/index.d.ts

@@ -1,5 +1,5 @@
-export { I as IPFSLocalStorage } from '../../IPFSLocal-BCIADaOU.js';
-import { n as StorageProvider, U as UploadOptions, i as UploadResult } from '../../types-CEFAgoAM.js';
+export { I as IPFSLocalStorage } from '../../IPFSLocal-B4hnMEfS.js';
+import { n as StorageProvider, U as UploadOptions, i as UploadResult } from '../../types-BBVtx_jV.js';
 import 'ethers';
 
 /**

package/dist/{types-CEFAgoAM.d.cts → types-BBVtx_jV.d.cts}

@@ -39,11 +39,24 @@ interface WorkVerificationResult {
     signals?: AgencySignals;
 }
 /**
- * Verifier assessment — optional overrides for each dimension.
+ * Verifier assessment for production scoring.
+ * Compliance and efficiency are REQUIRED — verifier agents must provide them.
  * Values can be in 0..1 (normalized) or 0..100 (integer); the SDK
  * auto-detects and normalizes internally.
  */
 type VerifierAssessment = {
+    complianceScore: number;
+    efficiencyScore: number;
+    initiativeScore?: number;
+    collaborationScore?: number;
+    reasoningScore?: number;
+    rationale?: string;
+};
+/**
+ * Relaxed assessment for demo/test use only.
+ * All fields optional — missing compliance/efficiency fall back to signals or 0.
+ */
+type DemoAssessment = {
     initiativeScore?: number;
     collaborationScore?: number;
     reasoningScore?: number;
@@ -76,6 +89,8 @@ type AgencySignals = {
         requiredArtifactsPresent?: string[];
         missingArtifacts?: string[];
         durationMs?: number;
+        fragmentationPenalty?: number;
+        overcomplexityPenalty?: number;
     };
 };
 type ScoreRange = {
@@ -177,26 +192,37 @@ declare function extractAgencySignals(evidence: EvidencePackage[], context?: Sig
  */
 declare function computeDepth(evidence: EvidencePackage[]): number;
 /**
- * Composes a final on-chain score vector from deterministic signals and
- * optional verifier assessment.
+ * Production score vector composition for verifier agents.
+ *
+ * Compliance and efficiency are REQUIRED — verifier agents must explicitly
+ * provide these based on their judgment + deterministic signals. Throws if
+ * either is missing.
  *
- * For each dimension:
- *   - If the verifier provides an override → use it (normalized)
- *   - Otherwise → use the deterministic signal
- *   - If the signal is also undefined → 0
+ * Initiative, collaboration, and reasoning default to deterministic signals
+ * unless the verifier provides overrides.
  *
  * Input values can be in 0..1 or 0..100; the SDK auto-detects.
  * Output is always integer tuple [0..100] × 5 ready for contract submission.
  */
-declare function composeScoreVector(signals: AgencySignals, assessment?: VerifierAssessment): [number, number, number, number, number];
+declare function composeScoreVector(signals: AgencySignals, assessment: VerifierAssessment): [number, number, number, number, number];
 /**
- * Convenience wrapper: extract signals + compose score vector in one call.
+ * Demo/test score vector composition — all fields optional.
+ *
+ * Falls back to deterministic signals (or 0) for any missing dimension.
+ * Use this for demo scripts and testing only — production verifier agents
+ * must use composeScoreVector() which enforces compliance/efficiency.
+ */
+declare function composeScoreVectorWithDefaults(signals: AgencySignals, assessment?: DemoAssessment): [number, number, number, number, number];
+/**
+ * @deprecated
+ * Demo helper for quick scoring without verifier judgment.
+ * Verifier agents should use verifyWorkEvidence() + composeScoreVector().
  *
+ * Convenience wrapper: extract signals + compose score vector in one call.
  * Returns [Initiative, Collaboration, Reasoning, Compliance, Efficiency]
  * as integers 0..100 for on-chain submission.
- *
- * Compliance and efficiency come from signals when available, or from the
- * verifier-provided `options`. No hardcoded placeholders.
+ * Uses composeScoreVectorWithDefaults internally — compliance and efficiency
+ * fall back to signals or 0 when not provided.
  */
 declare function derivePoAScores(evidence: EvidencePackage[], options?: {
     compliance?: number;
@@ -694,11 +720,17 @@ interface GatewayClientConfig {
 }
 interface PendingWorkItem {
     work_id: string;
+    data_hash: string;
     agent_id: number;
+    worker_address: string;
+    studio_address: string;
     epoch: number | null;
     submitted_at: string;
     evidence_anchor: string | null;
     derivation_root: string | null;
+    studio_policy_version: string;
+    work_mandate_id: string;
+    task_type: string;
 }
 interface PendingWorkResponse {
     version: string;
@@ -753,4 +785,4 @@ interface DKGNodeData {
     canonicalHash?: string;
 }
 
-export { AgentRole as A, extractAgencySignals as B, type ContractAddresses as C, type DKGNodeData as D, composeScoreVector as E, type FeedbackParams as F, type GatewayClientConfig as G, rangeFit as H, type IntegrityProof as I, type EvidencePackage as J, type WorkEvidenceVerificationResult as K, type WorkVerificationResult as L, type AgencySignals as M, NetworkConfig as N, type VerifierAssessment as O, type PendingWorkResponse as P, type ScoreRange as Q, type EngineeringStudioPolicy as R, ScoreSubmissionMode as S, type TEEAttestation as T, type UploadOptions as U, type ValidationRequestParams as V, type WalletConfig as W, type X402PaymentParams as X, type WorkMandate as Y, type SignalExtractionContext as Z, type NetworkInfo as a, type GatewayHealthResponse as b, type WorkflowStatus as c, type WorkEvidenceResponse as d, type ChaosChainSDKConfig as e, type AgentMetadata as f, type AgentRegistration as g, PaymentMethod as h, type UploadResult as i, type WorkflowError as j, type FeedbackRecord as k, type ValidationRequest as l, type X402Payment as m, type StorageProvider as n, type ComputeProvider as o, type TransactionResult as p, ValidationStatus as q, WorkflowType as r, WorkflowState as s, type WorkflowProgress as t, type PendingWorkItem as u, type XMTPMessageData as v, computeDepth as w, derivePoAScores as x, validateEvidenceGraph as y, verifyWorkEvidence as z };
+export { type SignalExtractionContext as $, AgentRole as A, extractAgencySignals as B, type ContractAddresses as C, type DKGNodeData as D, composeScoreVector as E, type FeedbackParams as F, type GatewayClientConfig as G, composeScoreVectorWithDefaults as H, type IntegrityProof as I, rangeFit as J, type EvidencePackage as K, type WorkEvidenceVerificationResult as L, type WorkVerificationResult as M, NetworkConfig as N, type AgencySignals as O, type PendingWorkResponse as P, type VerifierAssessment as Q, type DemoAssessment as R, ScoreSubmissionMode as S, type TEEAttestation as T, type UploadOptions as U, type ValidationRequestParams as V, type WalletConfig as W, type X402PaymentParams as X, type ScoreRange as Y, type EngineeringStudioPolicy as Z, type WorkMandate as _, type NetworkInfo as a, type GatewayHealthResponse as b, type WorkflowStatus as c, type WorkEvidenceResponse as d, type ChaosChainSDKConfig as e, type AgentMetadata as f, type AgentRegistration as g, PaymentMethod as h, type UploadResult as i, type WorkflowError as j, type FeedbackRecord as k, type ValidationRequest as l, type X402Payment as m, type StorageProvider as n, type ComputeProvider as o, type TransactionResult as p, ValidationStatus as q, WorkflowType as r, WorkflowState as s, type WorkflowProgress as t, type PendingWorkItem as u, type XMTPMessageData as v, computeDepth as w, derivePoAScores as x, validateEvidenceGraph as y, verifyWorkEvidence as z };

package/dist/{types-CEFAgoAM.d.ts → types-BBVtx_jV.d.ts}

@@ -39,11 +39,24 @@ interface WorkVerificationResult {
     signals?: AgencySignals;
 }
 /**
- * Verifier assessment — optional overrides for each dimension.
+ * Verifier assessment for production scoring.
+ * Compliance and efficiency are REQUIRED — verifier agents must provide them.
  * Values can be in 0..1 (normalized) or 0..100 (integer); the SDK
  * auto-detects and normalizes internally.
  */
 type VerifierAssessment = {
+    complianceScore: number;
+    efficiencyScore: number;
+    initiativeScore?: number;
+    collaborationScore?: number;
+    reasoningScore?: number;
+    rationale?: string;
+};
+/**
+ * Relaxed assessment for demo/test use only.
+ * All fields optional — missing compliance/efficiency fall back to signals or 0.
+ */
+type DemoAssessment = {
     initiativeScore?: number;
     collaborationScore?: number;
     reasoningScore?: number;
@@ -76,6 +89,8 @@ type AgencySignals = {
         requiredArtifactsPresent?: string[];
         missingArtifacts?: string[];
         durationMs?: number;
+        fragmentationPenalty?: number;
+        overcomplexityPenalty?: number;
     };
 };
 type ScoreRange = {
@@ -177,26 +192,37 @@ declare function extractAgencySignals(evidence: EvidencePackage[], context?: Sig
  */
 declare function computeDepth(evidence: EvidencePackage[]): number;
 /**
- * Composes a final on-chain score vector from deterministic signals and
- * optional verifier assessment.
+ * Production score vector composition for verifier agents.
+ *
+ * Compliance and efficiency are REQUIRED — verifier agents must explicitly
+ * provide these based on their judgment + deterministic signals. Throws if
+ * either is missing.
  *
- * For each dimension:
- *   - If the verifier provides an override → use it (normalized)
- *   - Otherwise → use the deterministic signal
- *   - If the signal is also undefined → 0
+ * Initiative, collaboration, and reasoning default to deterministic signals
+ * unless the verifier provides overrides.
  *
  * Input values can be in 0..1 or 0..100; the SDK auto-detects.
  * Output is always integer tuple [0..100] × 5 ready for contract submission.
  */
-declare function composeScoreVector(signals: AgencySignals, assessment?: VerifierAssessment): [number, number, number, number, number];
+declare function composeScoreVector(signals: AgencySignals, assessment: VerifierAssessment): [number, number, number, number, number];
 /**
- * Convenience wrapper: extract signals + compose score vector in one call.
+ * Demo/test score vector composition — all fields optional.
+ *
+ * Falls back to deterministic signals (or 0) for any missing dimension.
+ * Use this for demo scripts and testing only — production verifier agents
+ * must use composeScoreVector() which enforces compliance/efficiency.
+ */
+declare function composeScoreVectorWithDefaults(signals: AgencySignals, assessment?: DemoAssessment): [number, number, number, number, number];
+/**
+ * @deprecated
+ * Demo helper for quick scoring without verifier judgment.
+ * Verifier agents should use verifyWorkEvidence() + composeScoreVector().
  *
+ * Convenience wrapper: extract signals + compose score vector in one call.
  * Returns [Initiative, Collaboration, Reasoning, Compliance, Efficiency]
  * as integers 0..100 for on-chain submission.
- *
- * Compliance and efficiency come from signals when available, or from the
- * verifier-provided `options`. No hardcoded placeholders.
+ * Uses composeScoreVectorWithDefaults internally — compliance and efficiency
+ * fall back to signals or 0 when not provided.
  */
 declare function derivePoAScores(evidence: EvidencePackage[], options?: {
     compliance?: number;
@@ -694,11 +720,17 @@ interface GatewayClientConfig {
 }
 interface PendingWorkItem {
     work_id: string;
+    data_hash: string;
     agent_id: number;
+    worker_address: string;
+    studio_address: string;
     epoch: number | null;
     submitted_at: string;
     evidence_anchor: string | null;
     derivation_root: string | null;
+    studio_policy_version: string;
+    work_mandate_id: string;
+    task_type: string;
 }
 interface PendingWorkResponse {
     version: string;
@@ -753,4 +785,4 @@ interface DKGNodeData {
     canonicalHash?: string;
 }
 
-export { AgentRole as A, extractAgencySignals as B, type ContractAddresses as C, type DKGNodeData as D, composeScoreVector as E, type FeedbackParams as F, type GatewayClientConfig as G, rangeFit as H, type IntegrityProof as I, type EvidencePackage as J, type WorkEvidenceVerificationResult as K, type WorkVerificationResult as L, type AgencySignals as M, NetworkConfig as N, type VerifierAssessment as O, type PendingWorkResponse as P, type ScoreRange as Q, type EngineeringStudioPolicy as R, ScoreSubmissionMode as S, type TEEAttestation as T, type UploadOptions as U, type ValidationRequestParams as V, type WalletConfig as W, type X402PaymentParams as X, type WorkMandate as Y, type SignalExtractionContext as Z, type NetworkInfo as a, type GatewayHealthResponse as b, type WorkflowStatus as c, type WorkEvidenceResponse as d, type ChaosChainSDKConfig as e, type AgentMetadata as f, type AgentRegistration as g, PaymentMethod as h, type UploadResult as i, type WorkflowError as j, type FeedbackRecord as k, type ValidationRequest as l, type X402Payment as m, type StorageProvider as n, type ComputeProvider as o, type TransactionResult as p, ValidationStatus as q, WorkflowType as r, WorkflowState as s, type WorkflowProgress as t, type PendingWorkItem as u, type XMTPMessageData as v, computeDepth as w, derivePoAScores as x, validateEvidenceGraph as y, verifyWorkEvidence as z };
+export { type SignalExtractionContext as $, AgentRole as A, extractAgencySignals as B, type ContractAddresses as C, type DKGNodeData as D, composeScoreVector as E, type FeedbackParams as F, type GatewayClientConfig as G, composeScoreVectorWithDefaults as H, type IntegrityProof as I, rangeFit as J, type EvidencePackage as K, type WorkEvidenceVerificationResult as L, type WorkVerificationResult as M, NetworkConfig as N, type AgencySignals as O, type PendingWorkResponse as P, type VerifierAssessment as Q, type DemoAssessment as R, ScoreSubmissionMode as S, type TEEAttestation as T, type UploadOptions as U, type ValidationRequestParams as V, type WalletConfig as W, type X402PaymentParams as X, type ScoreRange as Y, type EngineeringStudioPolicy as Z, type WorkMandate as _, type NetworkInfo as a, type GatewayHealthResponse as b, type WorkflowStatus as c, type WorkEvidenceResponse as d, type ChaosChainSDKConfig as e, type AgentMetadata as f, type AgentRegistration as g, PaymentMethod as h, type UploadResult as i, type WorkflowError as j, type FeedbackRecord as k, type ValidationRequest as l, type X402Payment as m, type StorageProvider as n, type ComputeProvider as o, type TransactionResult as p, ValidationStatus as q, WorkflowType as r, WorkflowState as s, type WorkflowProgress as t, type PendingWorkItem as u, type XMTPMessageData as v, computeDepth as w, derivePoAScores as x, validateEvidenceGraph as y, verifyWorkEvidence as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chaoschain/sdk",
-  "version": "0.2.3",
+  "version": "0.3.0",
   "type": "module",
   "description": "TypeScript SDK for building verifiable AI agents on ChaosChain",
   "main": "./dist/index.cjs",