@emilia-protocol/sdk 0.1.0 → 0.9.0

package/dist/types.d.ts

@@ -0,0 +1,508 @@
+/** Every recognizable entity category in EP. */
+export type EntityType = 'agent' | 'merchant' | 'service_provider' | 'github_app' | 'github_action' | 'mcp_server' | 'npm_package' | 'chrome_extension' | 'shopify_app' | 'marketplace_plugin' | 'agent_tool';
+/** Observable behavioral outcomes — the strongest Phase 1 signal. */
+export type AgentBehavior = 'completed' | 'retried_same' | 'retried_different' | 'abandoned' | 'disputed';
+/** Categories of transactions that can generate receipts. */
+export type TransactionType = 'purchase' | 'service' | 'task_completion' | 'delivery' | 'return';
+/** Named trust policy families. */
+export type TrustPolicy = 'strict' | 'standard' | 'permissive' | 'discovery' | 'github_private_repo_safe_v1' | 'npm_buildtime_safe_v1' | 'browser_extension_safe_v1' | 'mcp_server_safe_v1';
+/** The action output of a trust gate evaluation. */
+export type TrustDecision = 'allow' | 'review' | 'deny';
+/** Lifecycle states of an EP Commit. */
+export type CommitStatus = 'active' | 'revoked' | 'expired' | 'fulfilled';
+/** Action types for EP Commit. */
+export type ActionType = 'install' | 'connect' | 'delegate' | 'transact';
+/** Recognized grounds for filing a dispute. */
+export type DisputeReason = 'fraudulent_receipt' | 'inaccurate_signals' | 'identity_dispute' | 'context_mismatch' | 'duplicate_transaction' | 'coerced_receipt' | 'other';
+/** Lifecycle states of a dispute. */
+export type DisputeStatus = 'pending' | 'responded' | 'under_review' | 'upheld' | 'reversed' | 'dismissed';
+/** Trust domains for domain-specific scoring (EP domain scores). */
+export type TrustDomain = 'financial' | 'code_execution' | 'communication' | 'delegation' | 'infrastructure' | 'content_creation' | 'data_access';
+/** Report classification for human trust reports. */
+export type ReportType = 'wrongly_downgraded' | 'harmed_by_trusted_entity' | 'fraudulent_entity' | 'inaccurate_profile' | 'other';
+/** Confidence tiers in order of increasing evidence strength. */
+export type ConfidenceTier = 'pending' | 'insufficient' | 'provisional' | 'emerging' | 'confident';
+/**
+ * Optional context passed to trust evaluations.
+ * All fields are optional — supply only what is relevant to the action.
+ */
+export interface TrustContext {
+    /** Broad task category, e.g. "data_analysis", "payment", "code_review" */
+    task_type?: string;
+    /** Merchant/product category, e.g. "furniture", "software", "grocery" */
+    category?: string;
+    /** ISO 3166-1 alpha-2 or sub-region, e.g. "US", "US-CA", "EU" */
+    geo?: string;
+    /** Interaction channel, e.g. "api", "chat", "browser" */
+    modality?: string;
+    /** Transaction value bucket, e.g. "low", "medium", "high", "enterprise" */
+    value_band?: string;
+    /** Risk class label for regulated contexts */
+    risk_class?: string;
+    /** Install-specific context fields */
+    host?: string;
+    install_scope?: string;
+    permission_class?: string;
+    data_sensitivity?: string;
+    execution_mode?: string;
+    [key: string]: string | undefined;
+}
+/** Structured boolean claims attached to a receipt. */
+export interface ReceiptClaims {
+    /** Was the item or result delivered? */
+    delivered?: boolean;
+    /** Was it delivered on time? */
+    on_time?: boolean;
+    /** Was the originally stated price honored? */
+    price_honored?: boolean;
+    /** Did the result match the description? */
+    as_described?: boolean;
+    [key: string]: boolean | undefined;
+}
+/** Aggregate behavioral rates derived from receipt history. */
+export interface BehavioralProfile {
+    /** Percentage of interactions that completed successfully (0-100) */
+    completion_rate?: number;
+    /** Percentage that required retry with the same approach (0-100) */
+    retry_rate?: number;
+    /** Percentage abandoned before completion (0-100) */
+    abandon_rate?: number;
+    /** Percentage that resulted in a dispute (0-100) */
+    dispute_rate?: number;
+}
+/** Quality-weighted signal averages across receipt dimensions. */
+export interface SignalProfile {
+    /** Weighted average delivery accuracy score (0-100) */
+    delivery_accuracy?: number;
+    /** Weighted average product/result accuracy score (0-100) */
+    product_accuracy?: number;
+    /** Weighted average price integrity score (0-100) */
+    price_integrity?: number;
+    /** Weighted average return/resolution processing score (0-100) */
+    return_processing?: number;
+    /** Cross-submitter signal consistency (0-1) */
+    consistency?: number;
+}
+/** Breakdown of receipt provenance by verification tier. */
+export interface ProvenanceProfile {
+    /** Map of tier name → fractional share (e.g. { bilateral: 0.6, self_attested: 0.4 }) */
+    breakdown: Record<string, number>;
+    /** Proportion of receipts with bilateral confirmation (0-100) */
+    bilateral_rate?: number;
+}
+/** The nested trust profile returned inside EntityTrustProfile. */
+export interface TrustProfile {
+    behavioral?: BehavioralProfile;
+    signals?: SignalProfile;
+    /** Overall cross-submitter consistency score (0-1) */
+    consistency?: number;
+    provenance?: ProvenanceProfile;
+}
+/** Summary of dispute activity attached to an entity's profile. */
+export interface DisputeSummary {
+    /** Total disputes ever filed */
+    total: number;
+    /** Currently open disputes */
+    active: number;
+    /** Disputes decided in favor of the disputer */
+    reversed: number;
+}
+/** Anomaly detection result surfaced on a trust profile. */
+export interface AnomalyAlert {
+    /** Anomaly classification, e.g. "sudden_drop", "burst_receipts" */
+    type: string;
+    /** Magnitude of the change in score/confidence */
+    delta: number;
+    /** Human-readable alert message */
+    alert: string;
+}
+/** Full trust profile for an entity — the canonical EP read surface. */
+export interface EntityTrustProfile {
+    entity_id: string;
+    display_name: string;
+    entity_type: EntityType;
+    /** Current confidence tier based on quality-gated evidence */
+    current_confidence: ConfidenceTier;
+    /** Whether the entity has established historical evidence */
+    historical_establishment: boolean;
+    /** Quality-gated effective evidence count for current window */
+    effective_evidence_current: number;
+    /** Quality-gated effective evidence count for historical window */
+    effective_evidence_historical: number;
+    /** Raw receipt count (all time) */
+    receipt_count?: number;
+    /** Number of distinct entities that have submitted receipts */
+    unique_submitters?: number;
+    /** Nested behavioral, signal, consistency, and provenance data */
+    trust_profile?: TrustProfile;
+    /** Dispute summary */
+    disputes?: DisputeSummary;
+    /** Present only when an anomaly is detected */
+    anomaly?: AnomalyAlert;
+    /** Legacy 0-100 compatibility score — use trust_profile for decisions */
+    compat_score: number;
+}
+/** Result of evaluating an entity against a named trust policy. */
+export interface TrustEvaluation {
+    entity_id: string;
+    display_name: string;
+    /** The policy that was applied */
+    policy_used: string;
+    /** Canonical trust decision — the primary evaluation field */
+    decision: 'allow' | 'review' | 'deny';
+    /**
+     * @deprecated Derived compatibility field — use `decision` instead.
+     * Equivalent to `decision === 'allow'`.
+     */
+    pass: boolean;
+    confidence: ConfidenceTier;
+    /** Context key used for context-aware evaluation */
+    context_used?: TrustContext;
+    /** Human-readable reasons for the decision */
+    reasons: string[];
+    /** Specific failure reasons (non-empty when decision !== 'allow') */
+    failures?: string[];
+    /** Non-blocking warnings */
+    warnings?: string[];
+    /** URL path for disputes/appeals */
+    appeal_path: string;
+}
+/** A single receipt record. */
+export interface Receipt {
+    receipt_id: string;
+    entity_id: string;
+    /** SHA-256 hash of the canonical receipt payload */
+    receipt_hash: string;
+    transaction_ref: string;
+    transaction_type: TransactionType;
+    agent_behavior?: AgentBehavior;
+    /** ISO 8601 creation timestamp */
+    created_at: string;
+    /** Whether this receipt has been anchored to a Merkle root */
+    anchored?: boolean;
+    /** Whether the Merkle proof verified successfully */
+    verified?: boolean;
+}
+/** Input shape for submitting a single receipt. */
+export interface SubmitReceiptInput {
+    /** Entity this receipt is about */
+    entity_id: string;
+    /** External transaction ID — required, must be unique per entity */
+    transaction_ref: string;
+    transaction_type: TransactionType;
+    /** Observable behavioral outcome — the strongest EP signal */
+    agent_behavior?: AgentBehavior;
+    /** Delivery accuracy score 0-100 */
+    delivery_accuracy?: number;
+    /** Product/result accuracy score 0-100 */
+    product_accuracy?: number;
+    /** Price integrity score 0-100 */
+    price_integrity?: number;
+    /** Return/resolution processing score 0-100 */
+    return_processing?: number;
+    /** Structured boolean claims */
+    claims?: ReceiptClaims;
+    /** Freeform supporting evidence references */
+    evidence?: Record<string, unknown>;
+    /** Context for context-aware trust scoring */
+    context?: TrustContext;
+}
+/** Response from submitting a single receipt. */
+export interface SubmitReceiptResult {
+    receipt: Receipt;
+}
+/** Entity summary returned from search results. */
+export interface EntitySearchResult {
+    entity_id: string;
+    display_name: string;
+    entity_type: EntityType;
+    confidence?: ConfidenceTier;
+    effective_evidence?: number;
+}
+/** A single dispute record. */
+export interface Dispute {
+    dispute_id: string;
+    receipt_id: string;
+    status: DisputeStatus;
+    reason: DisputeReason;
+    description?: string;
+    /** Party that filed the dispute */
+    filed_by?: {
+        display_name: string;
+    };
+    filed_by_type?: string;
+    /** Entity the dispute is about */
+    entity?: {
+        entity_id: string;
+        display_name: string;
+    };
+    /** Response from the receipt submitter */
+    response?: string;
+    /** Resolution decision: "upheld" | "reversed" | "dismissed" */
+    resolution?: string;
+    /** Rationale for the resolution */
+    resolution_rationale?: string;
+    /** ISO 8601 deadline for the respondent to reply */
+    response_deadline?: string;
+}
+/** A single entry in the entity leaderboard. */
+export interface LeaderboardEntry {
+    rank: number;
+    entity_id: string;
+    display_name: string;
+    entity_type: EntityType;
+    confidence?: ConfidenceTier;
+}
+/** Result of a pre-action trust gate check. */
+export interface TrustGateResult {
+    entity_id: string;
+    /** The action that was checked */
+    action: string;
+    /** Gate decision */
+    decision: TrustDecision;
+    /** Policy applied */
+    policy_used: string;
+    confidence: ConfidenceTier;
+    /** Whether a delegation was verified as part of this check */
+    delegation_verified?: boolean;
+    /** Reasons for the decision (especially useful for non-allow decisions) */
+    reasons?: string[];
+    /** Path to appeal a deny decision */
+    appeal_path?: string;
+}
+/** A delegation record authorizing an agent to act for a principal. */
+export interface DelegationRecord {
+    delegation_id: string;
+    /** The authorizing principal's ID */
+    principal_id: string;
+    /** The EP entity ID of the authorized agent */
+    agent_entity_id: string;
+    /** Action scope details (structured object, not array) */
+    scope: Record<string, unknown>;
+    /** Maximum permitted transaction value in USD */
+    max_value_usd?: number;
+    /** ISO 8601 expiry timestamp */
+    expires_at: string;
+    status: 'active' | 'expired' | 'revoked';
+    /** Additional structured constraints on the delegation */
+    constraints?: Record<string, unknown>;
+}
+/** Domain-specific trust score for a single domain. */
+export interface DomainScore {
+    confidence?: ConfidenceTier;
+    evidence_count?: number;
+    completion_rate?: number;
+    dispute_rate?: number;
+}
+/** Domain-specific trust scores for an entity across multiple domains. */
+export interface DomainScoreResult {
+    entity_id: string;
+    domains: Partial<Record<TrustDomain, DomainScore>>;
+}
+/** Result of a software pre-action enforcement check (experimental). */
+export interface InstallPreflightResult {
+    entity_id: string;
+    display_name: string;
+    /** Install decision */
+    decision: 'allow' | 'review' | 'deny';
+    policy_used: string;
+    confidence: ConfidenceTier;
+    /** Reasons for the decision */
+    reasons?: string[];
+    /** Publisher and provenance metadata */
+    software_meta?: {
+        publisher_verified: boolean;
+        provenance_verified: boolean;
+        permission_class?: string;
+    };
+    /** Legacy compatibility score — prefer decision field */
+    score: number;
+}
+/** A principal — the enduring actor behind one or more entities. */
+export interface Principal {
+    principal_id: string;
+    display_name: string;
+    principal_type: string;
+    status: string;
+    bootstrap_verified?: boolean;
+}
+/** Full principal lookup result including controlled entities and bindings. */
+export interface PrincipalLookupResult {
+    principal: Principal;
+    /** EP entities controlled by this principal */
+    entities?: Array<{
+        entity_id: string;
+        display_name: string;
+        entity_type: EntityType;
+    }>;
+    /** Verified identity bindings (e.g. GitHub org, domain) */
+    bindings?: Array<{
+        binding_type: string;
+        binding_target: string;
+        status: string;
+        provenance: string;
+    }>;
+    /** History of identity continuity claims made by or about this principal */
+    continuity_claims?: Array<{
+        old_entity_id: string;
+        new_entity_id: string;
+        reason: string;
+        status: string;
+    }>;
+}
+/** Entity lineage — predecessor and successor relationships. */
+export interface LineageResult {
+    entity_id: string;
+    predecessors?: Array<{
+        from: string;
+        reason: string;
+        status: string;
+        transfer_policy?: string;
+    }>;
+    successors?: Array<{
+        to: string;
+        reason: string;
+        status: string;
+        transfer_policy?: string;
+    }>;
+}
+/** Result of a batch receipt submission. */
+export interface BatchReceiptResult {
+    results: Array<{
+        entity_id: string;
+        success: boolean;
+        receipt_id?: string;
+        error?: string;
+    }>;
+}
+/** Result of a bilateral receipt confirmation. */
+export interface ConfirmReceiptResult {
+    receipt_id: string;
+    confirmed: boolean;
+    recorded_at: string;
+}
+/** A trust policy as returned from the policy registry. */
+export interface TrustPolicyDefinition {
+    name: string;
+    family: string;
+    description: string;
+    min_confidence?: ConfidenceTier;
+}
+/** Public proof metrics from /api/stats. */
+export interface EPStats {
+    total_entities: number;
+    trust_surfaces: number;
+    automated_checks: number;
+    trust_policies: number;
+    mcp_tools: number;
+}
+/** Request shape for issuing an EP Commit. */
+export interface EPCommitRequest {
+    action_type: ActionType;
+    entity_id: string;
+    principal_id?: string;
+    counterparty_entity_id?: string;
+    delegation_id?: string;
+    scope?: Record<string, unknown>;
+    max_value_usd?: number;
+    context?: Record<string, unknown>;
+    policy?: string;
+}
+/** A signed EP Commit — the pre-action commitment record. */
+export interface EPCommit {
+    commit_id: string;
+    action_type: ActionType;
+    entity_id: string;
+    principal_id?: string;
+    counterparty_entity_id?: string;
+    delegation_id?: string;
+    scope?: Record<string, unknown>;
+    max_value_usd?: number;
+    context?: Record<string, unknown>;
+    policy?: string;
+    decision: TrustDecision;
+    status: CommitStatus;
+    expires_at: string;
+    created_at: string;
+    receipt_id?: string;
+    appeal_path?: string;
+    signature?: string;
+}
+/** Result of verifying an EP Commit. Minimum disclosure — no scope, entity_id, or action_type. */
+export interface EPCommitVerification {
+    valid: boolean;
+    status: CommitStatus;
+    decision: TrustDecision;
+    expires_at?: string;
+    reasons: string[];
+}
+/** Response from issuing an EP Commit. */
+export interface EPCommitIssueResult {
+    decision: TrustDecision;
+    commit: EPCommit;
+}
+/** Response from getting an EP Commit's status. */
+export interface EPCommitStatusResult {
+    commit: EPCommit;
+}
+/** Response from revoking an EP Commit. */
+export interface EPCommitRevokeResult {
+    commit_id: string;
+    status: 'revoked';
+    revoked_at: string;
+}
+/** Response from binding a receipt to an EP Commit. */
+export interface EPCommitReceiptResult {
+    commit_id: string;
+    status: 'fulfilled';
+    receipt_id: string;
+}
+/** Configuration options for EPClient. */
+export interface EPClientOptions {
+    /**
+     * EP API base URL.
+     * Defaults to https://emiliaprotocol.ai.
+     * Can also be set via the EP_BASE_URL environment variable.
+     */
+    baseUrl?: string;
+    /**
+     * EP API key (ep_live_...).
+     * Required for authenticated endpoints (submitReceipt, fileDispute, etc.).
+     * Can also be set via the EP_API_KEY environment variable.
+     */
+    apiKey?: string;
+    /**
+     * Request timeout in milliseconds.
+     * Defaults to 30000 (30 seconds).
+     */
+    timeout?: number;
+    /**
+     * Custom fetch implementation.
+     * Useful for testing or environments without native fetch.
+     */
+    fetchImpl?: typeof fetch;
+}
+/**
+ * Thrown when the EP API returns a non-2xx response or a network error occurs.
+ *
+ * @example
+ * try {
+ *   await ep.trustProfile('unknown-entity');
+ * } catch (err) {
+ *   if (err instanceof EPError && err.status === 404) {
+ *     console.log('Entity not found');
+ *   }
+ * }
+ */
+export declare class EPError extends Error {
+    /** HTTP status code, if available */
+    readonly status?: number | undefined;
+    /** API-level error code, if provided */
+    readonly code?: string | undefined;
+    constructor(message: string, 
+    /** HTTP status code, if available */
+    status?: number | undefined, 
+    /** API-level error code, if provided */
+    code?: string | undefined);
+}
+//# 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,35 @@
+// ============================================================================
+// EMILIA Protocol — TypeScript Type Definitions
+// ============================================================================
+// ----------------------------------------------------------------------------
+// Error class
+// ----------------------------------------------------------------------------
+/**
+ * Thrown when the EP API returns a non-2xx response or a network error occurs.
+ *
+ * @example
+ * try {
+ *   await ep.trustProfile('unknown-entity');
+ * } catch (err) {
+ *   if (err instanceof EPError && err.status === 404) {
+ *     console.log('Entity not found');
+ *   }
+ * }
+ */
+export class EPError extends Error {
+    status;
+    code;
+    constructor(message, 
+    /** HTTP status code, if available */
+    status, 
+    /** API-level error code, if provided */
+    code) {
+        super(message);
+        this.status = status;
+        this.code = code;
+        this.name = 'EPError';
+        // Maintain proper prototype chain in environments targeting ES5
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+//# 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;AAC/E,gDAAgD;AAChD,+EAA+E;AAgmB/E,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,OAAQ,SAAQ,KAAK;IAId;IAEA;IALlB,YACE,OAAe;IACf,qCAAqC;IACrB,MAAe;IAC/B,wCAAwC;IACxB,IAAa;QAE7B,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,WAAM,GAAN,MAAM,CAAS;QAEf,SAAI,GAAJ,IAAI,CAAS;QAG7B,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;QACtB,gEAAgE;QAChE,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF"}

package/package.json

@@ -1,8 +1,7 @@
 {
   "name": "@emilia-protocol/sdk",
-  "version": "0.1.0",
-  "description": "TypeScript SDK for EMILIA Protocol (EP) — the trust layer for agentic commerce.",
-  "license": "Apache-2.0",
+  "version": "0.9.0",
+  "description": "Minimal TypeScript SDK for the EMILIA Protocol — 5 core endpoints + signoff.",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -12,22 +11,40 @@
       "types": "./dist/index.d.ts"
     }
   },
-  "files": ["dist", "README.md"],
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ],
+  "sideEffects": false,
   "scripts": {
-    "build": "tsc",
-    "prepublishOnly": "npm run build"
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist",
+    "prepare": "npm run clean && npm run build",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
   },
-  "devDependencies": {
-    "typescript": "^5.5.0"
+  "engines": {
+    "node": ">=18"
   },
   "keywords": [
-    "emilia", "trust", "reputation", "ai-agents", "agentic-commerce",
-    "mcp", "a2a", "ucp", "receipts"
+    "trust",
+    "ai-agents",
+    "emilia-protocol",
+    "handshake",
+    "trust-gate",
+    "signoff"
   ],
+  "license": "Apache-2.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/emiliaprotocol/emilia-protocol",
     "directory": "sdks/typescript"
   },
-  "homepage": "https://emiliaprotocol.ai"
+  "homepage": "https://emiliaprotocol.ai",
+  "devDependencies": {
+    "@types/node": "^25.6.0",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.5"
+  }
 }