@nobulex/sdk 0.1.0

package/dist/telemetry.js

@@ -0,0 +1,241 @@
+/**
+ * OpenTelemetry-compatible instrumentation for the Stele SDK.
+ *
+ * Follows the "bring your own tracer" pattern: all OTel interfaces are
+ * defined inline so consumers can plug in their own OTel SDK without
+ * introducing any external dependency on `@opentelemetry/*` packages.
+ *
+ * @packageDocumentation
+ */
+// ─── OTel-compatible interfaces ──────────────────────────────────────────────
+/** Status code constants compatible with @opentelemetry/api SpanStatusCode. */
+export const SpanStatusCode = {
+    UNSET: 0,
+    OK: 1,
+    ERROR: 2,
+};
+// ─── No-op implementations ──────────────────────────────────────────────────
+/** No-op Span that silently discards all calls. */
+export class NoopSpan {
+    setAttribute(_key, _value) { }
+    setStatus(_status) { }
+    recordException(_error) { }
+    end() { }
+}
+/** No-op Counter that silently discards all calls. */
+export class NoopCounter {
+    add(_value, _attributes) { }
+}
+/** No-op Histogram that silently discards all calls. */
+export class NoopHistogram {
+    record(_value, _attributes) { }
+}
+/** No-op Tracer that returns NoopSpan instances. */
+export class NoopTracer {
+    startSpan(_name, _options) {
+        return new NoopSpan();
+    }
+}
+/** No-op Meter that returns NoopCounter and NoopHistogram instances. */
+export class NoopMeter {
+    createCounter(_name, _options) {
+        return new NoopCounter();
+    }
+    createHistogram(_name, _options) {
+        return new NoopHistogram();
+    }
+}
+/**
+ * Create a SteleMiddleware that wraps each operation with an OTel span.
+ *
+ * For every operation that passes through the middleware pipeline, this
+ * middleware:
+ * - Creates a span named after the operation (e.g. `stele.createCovenant`)
+ * - Sets attributes: `stele.operation`, and any result-specific attributes
+ *   such as `stele.covenant.id`, `stele.evaluation.permitted`
+ * - Records duration via `stele.duration_ms`
+ * - Sets the span status to OK or ERROR
+ * - Records exceptions on failure
+ *
+ * @param options - Optional configuration with a custom tracer.
+ * @returns A SteleMiddleware instance.
+ */
+export function telemetryMiddleware(options) {
+    const tracer = options?.tracer ?? new NoopTracer();
+    return {
+        name: 'telemetry',
+        async before(ctx) {
+            const span = tracer.startSpan(`stele.${ctx.operation}`, {
+                attributes: {
+                    'stele.operation': ctx.operation,
+                },
+            });
+            ctx.metadata._telemetrySpan = span;
+            ctx.metadata._telemetryStart = performance.now();
+            return { proceed: true };
+        },
+        async after(ctx, result) {
+            const span = ctx.metadata._telemetrySpan;
+            if (span) {
+                const start = ctx.metadata._telemetryStart;
+                const durationMs = performance.now() - start;
+                span.setAttribute('stele.duration_ms', durationMs);
+                // Set result-specific attributes
+                if (result && typeof result === 'object') {
+                    const r = result;
+                    if ('id' in r && typeof r.id === 'string') {
+                        span.setAttribute('stele.covenant.id', r.id);
+                    }
+                    if ('valid' in r && typeof r.valid === 'boolean') {
+                        span.setAttribute('stele.verification.valid', r.valid);
+                    }
+                    if ('permitted' in r && typeof r.permitted === 'boolean') {
+                        span.setAttribute('stele.evaluation.permitted', r.permitted);
+                    }
+                }
+                span.setStatus({ code: SpanStatusCode.OK });
+                span.end();
+                delete ctx.metadata._telemetrySpan;
+                delete ctx.metadata._telemetryStart;
+            }
+            return result;
+        },
+        async onError(ctx, error) {
+            const span = ctx.metadata._telemetrySpan;
+            if (span) {
+                const start = ctx.metadata._telemetryStart;
+                const durationMs = performance.now() - start;
+                span.setAttribute('stele.duration_ms', durationMs);
+                span.setStatus({ code: SpanStatusCode.ERROR, message: error.message });
+                span.recordException(error);
+                span.end();
+                delete ctx.metadata._telemetrySpan;
+                delete ctx.metadata._telemetryStart;
+            }
+        },
+    };
+}
+/**
+ * Metrics collector for Stele SDK operations.
+ *
+ * Creates OTel-compatible counters and histograms and exposes a `record()`
+ * method to update them from SteleClient lifecycle events.
+ */
+export class SteleMetrics {
+    _covenantsCreated;
+    _covenantsVerified;
+    _evaluationsTotal;
+    _evaluationsDenied;
+    _operationDuration;
+    constructor(meter) {
+        this._covenantsCreated = meter.createCounter('stele.covenants.created', {
+            description: 'Number of covenants created',
+        });
+        this._covenantsVerified = meter.createCounter('stele.covenants.verified', {
+            description: 'Number of covenants verified',
+        });
+        this._evaluationsTotal = meter.createCounter('stele.evaluations.total', {
+            description: 'Total number of evaluations performed',
+        });
+        this._evaluationsDenied = meter.createCounter('stele.evaluations.denied', {
+            description: 'Number of evaluations that were denied',
+        });
+        this._operationDuration = meter.createHistogram('stele.operation.duration', {
+            description: 'Duration of operations in milliseconds',
+        });
+    }
+    /**
+     * Record a SteleClient event, updating the appropriate metrics.
+     *
+     * @param event - A SteleClient lifecycle event (from the `on()` callback).
+     */
+    record(event) {
+        switch (event.type) {
+            case 'covenant:created':
+                this._covenantsCreated.add(1);
+                break;
+            case 'covenant:verified':
+                this._covenantsVerified.add(1);
+                break;
+            case 'evaluation:completed': {
+                const evalEvent = event;
+                this._evaluationsTotal.add(1);
+                if (!evalEvent.result.permitted) {
+                    this._evaluationsDenied.add(1);
+                }
+                break;
+            }
+            default:
+                // Other event types are observed but do not drive specific counters.
+                break;
+        }
+    }
+    /**
+     * Record an operation duration.
+     *
+     * @param durationMs - Duration in milliseconds.
+     * @param attributes - Optional attributes to attach to the measurement.
+     */
+    recordDuration(durationMs, attributes) {
+        this._operationDuration.record(durationMs, attributes);
+    }
+    /**
+     * Subscribe to all SteleClient events and automatically record metrics.
+     *
+     * @param client - An object with an `on()` method matching SteleClient's API.
+     * @returns An array of disposal functions that unsubscribe all listeners.
+     */
+    bindToClient(client) {
+        const disposers = [];
+        const eventTypes = [
+            'covenant:created',
+            'covenant:verified',
+            'covenant:countersigned',
+            'identity:created',
+            'identity:evolved',
+            'chain:resolved',
+            'chain:validated',
+            'evaluation:completed',
+        ];
+        for (const eventType of eventTypes) {
+            const dispose = client.on(eventType, (data) => {
+                this.record(data);
+            });
+            disposers.push(dispose);
+        }
+        return disposers;
+    }
+}
+/**
+ * Create a matched pair of telemetry middleware and metrics collector.
+ *
+ * This is the recommended entry point for instrumenting the Stele SDK.
+ * If no tracer or meter is provided, no-op implementations are used
+ * so that application code compiles and runs without any OTel dependency.
+ *
+ * @param options - Optional tracer and meter instances.
+ * @returns An object containing the middleware and metrics instances.
+ *
+ * @example
+ * ```typescript
+ * import { createTelemetry } from '@nobulex/sdk';
+ *
+ * // With real OTel SDK:
+ * const { middleware, metrics } = createTelemetry({
+ *   tracer: otelTrace.getTracer('my-app'),
+ *   meter: otelMetrics.getMeter('my-app'),
+ * });
+ *
+ * // Without OTel (no-op, zero overhead):
+ * const { middleware, metrics } = createTelemetry();
+ * ```
+ */
+export function createTelemetry(options) {
+    const tracer = options?.tracer ?? new NoopTracer();
+    const meter = options?.meter ?? new NoopMeter();
+    return {
+        middleware: telemetryMiddleware({ tracer }),
+        metrics: new SteleMetrics(meter),
+    };
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../src/telemetry.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,200 @@
+/**
+ * @nobulex/sdk type definitions.
+ *
+ * SDK-specific types that wrap and extend the lower-level package types
+ * into a unified, ergonomic API surface.
+ */
+import type { KeyPair } from '@nobulex/crypto';
+import type { CovenantDocument, VerificationResult, VerificationCheck, Issuer, Beneficiary, ChainReference, EnforcementConfig, ProofConfig, RevocationConfig, CovenantMetadata, Obligation, PartyRole } from '@nobulex/core';
+import type { CCLDocument, EvaluationResult as CCLEvaluationResult, Statement, Severity } from '@nobulex/ccl';
+import type { AgentIdentity, ModelAttestation, DeploymentContext, LineageEntry } from '@nobulex/identity';
+/** Options for constructing a SteleClient instance. */
+export interface SteleClientOptions {
+    /** Optional pre-generated key pair for signing operations. */
+    keyPair?: KeyPair;
+    /** Optional agent identifier for identity operations. */
+    agentId?: string;
+    /**
+     * When true, the client will throw on verification failures
+     * instead of returning a result with valid=false.
+     */
+    strictMode?: boolean;
+    /** Optional key rotation policy for automatic key lifecycle management. */
+    keyRotation?: {
+        /** Maximum key age in milliseconds before rotation is required. */
+        maxAgeMs: number;
+        /** Grace period in milliseconds where both old and new keys are valid. */
+        overlapPeriodMs: number;
+        /** Optional callback invoked when rotation occurs. */
+        onRotation?: (oldKey: string, newKey: string) => void;
+    };
+}
+/** Options for creating a new covenant through the SDK. */
+export interface CreateCovenantOptions {
+    /** The issuing party. */
+    issuer: Issuer;
+    /** The beneficiary party. */
+    beneficiary: Beneficiary;
+    /** CCL constraint source text. */
+    constraints: string;
+    /** Issuer's private key used to sign the document. If omitted, uses client keyPair. */
+    privateKey?: Uint8Array;
+    /** Optional obligations. */
+    obligations?: Obligation[];
+    /** Optional chain reference to parent covenant. */
+    chain?: ChainReference;
+    /** Optional enforcement configuration. */
+    enforcement?: EnforcementConfig;
+    /** Optional proof configuration. */
+    proof?: ProofConfig;
+    /** Optional revocation configuration. */
+    revocation?: RevocationConfig;
+    /** Optional metadata. */
+    metadata?: CovenantMetadata;
+    /** Optional ISO 8601 expiry timestamp. */
+    expiresAt?: string;
+    /** Optional ISO 8601 activation timestamp. */
+    activatesAt?: string;
+}
+/** Result of evaluating an action against a covenant's constraints. */
+export interface EvaluationResult {
+    /** Whether the action is permitted. */
+    permitted: boolean;
+    /** The matched rule, if any. */
+    matchedRule?: Statement;
+    /** All matching statements. */
+    allMatches: Statement[];
+    /** Human-readable reason for the decision. */
+    reason?: string;
+    /** Severity of the matched rule. */
+    severity?: Severity;
+}
+/** Options for creating a new agent identity through the SDK. */
+export interface CreateIdentityOptions {
+    /** Operator key pair for signing. If omitted, uses client keyPair. */
+    operatorKeyPair?: KeyPair;
+    /** Optional human-readable operator identifier. */
+    operatorIdentifier?: string;
+    /** Model attestation describing the AI model. */
+    model: ModelAttestation;
+    /** List of capabilities this agent has. */
+    capabilities: string[];
+    /** Deployment context describing where the agent runs. */
+    deployment: DeploymentContext;
+}
+/** Options for evolving an existing agent identity. */
+export interface EvolveOptions {
+    /** Operator key pair for signing. If omitted, uses client keyPair. */
+    operatorKeyPair?: KeyPair;
+    /** Type of change being made. */
+    changeType: LineageEntry['changeType'];
+    /** Human-readable description of the change. */
+    description: string;
+    /** The fields being updated. */
+    updates: {
+        model?: ModelAttestation;
+        capabilities?: string[];
+        deployment?: DeploymentContext;
+        operatorPublicKey?: string;
+        operatorIdentifier?: string;
+    };
+    /** Optional explicit reputation carry-forward rate. */
+    reputationCarryForward?: number;
+}
+/** Result of validating a chain of covenant documents. */
+export interface ChainValidationResult {
+    /** Whether the entire chain is valid. */
+    valid: boolean;
+    /** Per-document verification results, ordered from root to leaf. */
+    results: VerificationResult[];
+    /** Narrowing violations found between parent-child pairs. */
+    narrowingViolations: NarrowingViolationEntry[];
+}
+/** A narrowing violation between a specific parent-child pair. */
+export interface NarrowingViolationEntry {
+    /** Index of the child document in the chain. */
+    childIndex: number;
+    /** Index of the parent document in the chain. */
+    parentIndex: number;
+    /** The narrowing violations found. */
+    violations: Array<{
+        childRule: Statement;
+        parentRule: Statement;
+        reason: string;
+    }>;
+}
+/** Event types emitted by SteleClient. */
+export type SteleEventType = 'covenant:created' | 'covenant:verified' | 'covenant:countersigned' | 'identity:created' | 'identity:evolved' | 'chain:resolved' | 'chain:validated' | 'evaluation:completed' | 'key:rotated';
+/** Base event payload. */
+export interface SteleEvent {
+    /** The event type. */
+    type: SteleEventType;
+    /** ISO 8601 timestamp of when the event occurred. */
+    timestamp: string;
+}
+/** Event emitted when a covenant is created. */
+export interface CovenantCreatedEvent extends SteleEvent {
+    type: 'covenant:created';
+    document: CovenantDocument;
+}
+/** Event emitted when a covenant is verified. */
+export interface CovenantVerifiedEvent extends SteleEvent {
+    type: 'covenant:verified';
+    result: VerificationResult;
+}
+/** Event emitted when a covenant is countersigned. */
+export interface CovenantCountersignedEvent extends SteleEvent {
+    type: 'covenant:countersigned';
+    document: CovenantDocument;
+    signerRole: PartyRole;
+}
+/** Event emitted when an identity is created. */
+export interface IdentityCreatedEvent extends SteleEvent {
+    type: 'identity:created';
+    identity: AgentIdentity;
+}
+/** Event emitted when an identity is evolved. */
+export interface IdentityEvolvedEvent extends SteleEvent {
+    type: 'identity:evolved';
+    identity: AgentIdentity;
+    changeType: LineageEntry['changeType'];
+}
+/** Event emitted when a chain is resolved. */
+export interface ChainResolvedEvent extends SteleEvent {
+    type: 'chain:resolved';
+    documents: CovenantDocument[];
+}
+/** Event emitted when a chain is validated. */
+export interface ChainValidatedEvent extends SteleEvent {
+    type: 'chain:validated';
+    result: ChainValidationResult;
+}
+/** Event emitted when an action is evaluated. */
+export interface EvaluationCompletedEvent extends SteleEvent {
+    type: 'evaluation:completed';
+    result: EvaluationResult;
+    action: string;
+    resource: string;
+}
+/** Event emitted when a key rotation occurs. */
+export interface KeyRotatedEvent extends SteleEvent {
+    type: 'key:rotated';
+    previousPublicKey: string;
+    currentPublicKey: string;
+}
+/** Map of event types to their payloads. */
+export interface SteleEventMap {
+    'covenant:created': CovenantCreatedEvent;
+    'covenant:verified': CovenantVerifiedEvent;
+    'covenant:countersigned': CovenantCountersignedEvent;
+    'identity:created': IdentityCreatedEvent;
+    'identity:evolved': IdentityEvolvedEvent;
+    'chain:resolved': ChainResolvedEvent;
+    'chain:validated': ChainValidatedEvent;
+    'evaluation:completed': EvaluationCompletedEvent;
+    'key:rotated': KeyRotatedEvent;
+}
+/** Event handler function type. */
+export type SteleEventHandler<T extends SteleEventType> = (event: SteleEventMap[T]) => void;
+export type { KeyPair, CovenantDocument, VerificationResult, VerificationCheck, Issuer, Beneficiary, ChainReference, EnforcementConfig, ProofConfig, RevocationConfig, CovenantMetadata, Obligation, PartyRole, CCLDocument, CCLEvaluationResult, Statement, Severity, AgentIdentity, ModelAttestation, DeploymentContext, LineageEntry, };
+//# 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,8 @@
+/**
+ * @nobulex/sdk type definitions.
+ *
+ * SDK-specific types that wrap and extend the lower-level package types
+ * into a unified, ergonomic API surface.
+ */
+export {};
+//# 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;;;;;GAKG"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@nobulex/sdk",
+  "version": "0.1.0",
+  "description": "TypeScript SDK for embedding Stele into agent frameworks and applications",
+  "sideEffects": false,
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc --project tsconfig.json",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@nobulex/types": "0.1.0",
+    "@nobulex/crypto": "0.1.0",
+    "@nobulex/core": "0.1.0",
+    "@nobulex/ccl": "0.1.0",
+    "@nobulex/identity": "0.1.0",
+    "@nobulex/store": "0.1.0",
+    "@nobulex/verifier": "0.1.0",
+    "@nobulex/negotiation": "0.1.0"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/agbusiness195/Stele.git",
+    "directory": "packages/sdk"
+  },
+  "homepage": "https://stele.dev",
+  "bugs": {
+    "url": "https://github.com/agbusiness195/stele/issues"
+  },
+  "author": "Stele Labs, Inc.",
+  "keywords": [
+    "stele",
+    "covenant",
+    "ai-accountability",
+    "sdk"
+  ]
+}