@mandible-ai/mandible 0.2.0

package/dist/src/cli/server.js

@@ -0,0 +1,204 @@
+// ============================================================
+// Dashboard Server — HTTP + WebSocket for real-time observability
+// ============================================================
+import { createServer } from 'node:http';
+import { readFile } from 'node:fs/promises';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { WebSocketServer } from 'ws';
+import { createRuntime } from '../core/runtime.js';
+import { EventBus } from '../core/events.js';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+export async function startDevServer(config, options) {
+    const eventBus = new EventBus();
+    const runtimes = [];
+    // Create runtimes with shared event bus
+    for (const colonyDef of config.colonies) {
+        const runtime = createRuntime(colonyDef, { eventBus });
+        runtimes.push(runtime);
+    }
+    // Collect recent events for reconnecting clients
+    const recentEvents = [];
+    const MAX_RECENT = 500;
+    eventBus.on((event) => {
+        recentEvents.push(event);
+        if (recentEvents.length > MAX_RECENT) {
+            recentEvents.splice(0, recentEvents.length - MAX_RECENT);
+        }
+    });
+    // HTTP server
+    const server = createServer(async (req, res) => {
+        const url = new URL(req.url ?? '/', `http://localhost:${options.port}`);
+        // CORS headers
+        res.setHeader('Access-Control-Allow-Origin', '*');
+        res.setHeader('Access-Control-Allow-Methods', 'GET, POST, OPTIONS');
+        res.setHeader('Access-Control-Allow-Headers', 'Content-Type');
+        if (req.method === 'OPTIONS') {
+            res.writeHead(204);
+            res.end();
+            return;
+        }
+        try {
+            if (url.pathname === '/api/state') {
+                const signals = await config.environment.snapshot();
+                sendJson(res, { signals });
+            }
+            else if (url.pathname === '/api/colonies') {
+                const colonies = runtimes.map(rt => ({
+                    name: rt.name,
+                    state: rt.state,
+                    activeCount: rt.activeCount,
+                    concurrency: rt.concurrency,
+                    stats: rt.stats,
+                }));
+                sendJson(res, { colonies });
+            }
+            else if (url.pathname === '/api/stats') {
+                const stats = runtimes.map(rt => ({
+                    name: rt.name,
+                    ...rt.stats,
+                }));
+                sendJson(res, { stats });
+            }
+            else if (url.pathname === '/api/events') {
+                sendJson(res, { events: recentEvents });
+            }
+            else if (url.pathname === '/api/signals' && req.method === 'POST') {
+                const body = await readBody(req);
+                const { type, payload, tags } = JSON.parse(body);
+                const signal = await config.environment.deposit({
+                    type,
+                    payload: payload ?? {},
+                    meta: {
+                        deposited_by: 'dashboard',
+                        tags,
+                    },
+                });
+                sendJson(res, { signal }, 201);
+            }
+            else if (url.pathname === '/' || url.pathname === '/index.html') {
+                await serveDashboard(res);
+            }
+            else {
+                res.writeHead(404);
+                res.end('Not found');
+            }
+        }
+        catch (err) {
+            console.error('Server error:', err);
+            res.writeHead(500);
+            res.end(JSON.stringify({ error: err.message }));
+        }
+    });
+    // WebSocket server
+    const wss = new WebSocketServer({ server });
+    wss.on('connection', (ws) => {
+        // Send recent events on connect for catchup
+        ws.send(JSON.stringify({ type: 'init', events: recentEvents.slice(-100) }));
+    });
+    // Forward runtime events to all connected WebSocket clients
+    eventBus.on((event) => {
+        const message = JSON.stringify({ type: 'event', data: event });
+        for (const client of wss.clients) {
+            if (client.readyState === 1) { // WebSocket.OPEN
+                client.send(message);
+            }
+        }
+    });
+    // Listen for remote events relayed through the signal server
+    if ('onEvent' in config.environment && typeof config.environment.onEvent === 'function') {
+        config.environment.onEvent((event) => {
+            recentEvents.push(event);
+            if (recentEvents.length > MAX_RECENT) {
+                recentEvents.splice(0, recentEvents.length - MAX_RECENT);
+            }
+            const message = JSON.stringify({ type: 'event', data: event });
+            for (const client of wss.clients) {
+                if (client.readyState === 1) {
+                    client.send(message);
+                }
+            }
+        });
+    }
+    // Periodic snapshot broadcast (for concentration decay animation)
+    const snapshotInterval = setInterval(async () => {
+        try {
+            const signals = await config.environment.snapshot();
+            const message = JSON.stringify({ type: 'snapshot', signals });
+            for (const client of wss.clients) {
+                if (client.readyState === 1) {
+                    client.send(message);
+                }
+            }
+        }
+        catch { /* ignore snapshot errors */ }
+    }, 2000);
+    // Start HTTP server
+    server.listen(options.port, () => {
+        console.log(`  dashboard: http://localhost:${options.port}`);
+    });
+    // Start all colony runtimes
+    console.log(`  starting ${runtimes.length} colonies...`);
+    for (const runtime of runtimes) {
+        await runtime.start();
+        console.log(`    + ${runtime.name} [running]`);
+    }
+    console.log('');
+    // Auto-open browser
+    if (options.open) {
+        const url = `http://localhost:${options.port}`;
+        try {
+            const { exec } = await import('node:child_process');
+            const cmd = process.platform === 'darwin' ? 'open' :
+                process.platform === 'win32' ? 'start' : 'xdg-open';
+            exec(`${cmd} ${url}`);
+        }
+        catch { /* ignore open errors */ }
+    }
+    // Graceful shutdown
+    const shutdown = async () => {
+        console.log('\n  shutting down...');
+        clearInterval(snapshotInterval);
+        for (const runtime of runtimes) {
+            await runtime.stop();
+            console.log(`    - ${runtime.name} [stopped]`);
+        }
+        wss.close();
+        server.close();
+        console.log('  done.\n');
+        process.exit(0);
+    };
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
+}
+function sendJson(res, data, status = 200) {
+    res.writeHead(status, { 'Content-Type': 'application/json' });
+    res.end(JSON.stringify(data));
+}
+function readBody(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        req.on('data', (chunk) => chunks.push(chunk));
+        req.on('end', () => resolve(Buffer.concat(chunks).toString()));
+        req.on('error', reject);
+    });
+}
+async function serveDashboard(res) {
+    try {
+        const htmlPath = join(__dirname, 'dashboard.html');
+        const html = await readFile(htmlPath, 'utf-8');
+        res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
+        res.end(html);
+    }
+    catch {
+        res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
+        res.end(FALLBACK_HTML);
+    }
+}
+const FALLBACK_HTML = `<!DOCTYPE html>
+<html><head><title>mandible</title></head>
+<body style="background:#1a1a2e;color:#eee;font-family:monospace;padding:2em">
+<h1>mandible dashboard</h1>
+<p>dashboard.html not found — rebuild the project.</p>
+</body></html>`;
+//# sourceMappingURL=server.js.map

package/dist/src/cli/server.js.map

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

package/dist/src/cloud/client.d.ts

@@ -0,0 +1,30 @@
+import type { CloudConfig, Project, CreateProjectRequest, DeployRequest, DeployResult, ColonyStatus, ZoneStatus, CreateApiKeyResponse } from './types.js';
+export declare class MandibleCloudError extends Error {
+    code: string;
+    status: number;
+    constructor(code: string, message: string, status: number);
+}
+export declare class MandibleCloudClient {
+    private apiUrl;
+    private apiKey;
+    private project?;
+    constructor(config: CloudConfig);
+    createProject(req: CreateProjectRequest): Promise<Project>;
+    getProject(id?: string): Promise<Project>;
+    listProjects(): Promise<Project[]>;
+    deleteProject(id?: string): Promise<void>;
+    deploy(req: DeployRequest, projectId?: string): Promise<DeployResult>;
+    listColonies(projectId?: string): Promise<ColonyStatus[]>;
+    destroyColony(colonyName: string, projectId?: string): Promise<void>;
+    teardown(projectId?: string): Promise<void>;
+    listZones(projectId?: string): Promise<ZoneStatus[]>;
+    getZone(zoneId: string, projectId?: string): Promise<ZoneStatus>;
+    createApiKey(projectId?: string): Promise<CreateApiKeyResponse>;
+    revokeApiKey(keyId: string): Promise<void>;
+    private get;
+    private post;
+    private del;
+    private fetch;
+    private requireProject;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/src/cloud/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/cloud/client.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,WAAW,EACX,OAAO,EACP,oBAAoB,EACpB,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,UAAU,EAEV,oBAAoB,EAErB,MAAM,YAAY,CAAC;AAEpB,qBAAa,kBAAmB,SAAQ,KAAK;IACxB,IAAI,EAAE,MAAM;IAA0B,MAAM,EAAE,MAAM;gBAApD,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAS,MAAM,EAAE,MAAM;CAIxE;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAC,CAAS;gBAEb,MAAM,EAAE,WAAW;IAUzB,aAAa,CAAC,GAAG,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;IAI1D,UAAU,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIzC,YAAY,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAIlC,aAAa,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQzC,MAAM,CAAC,GAAG,EAAE,aAAa,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAIrE,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAIzD,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW3C,SAAS,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAIpD,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAQhE,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAI/D,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAQlC,GAAG;YAIH,IAAI;YAQJ,GAAG;YAIH,KAAK;IAyBnB,OAAO,CAAC,cAAc;CAMvB"}

package/dist/src/cloud/client.js

@@ -0,0 +1,124 @@
+// ============================================================
+// Mandible Cloud — API Client
+// ============================================================
+// HTTP client for the Mandible Cloud REST API.
+// Handles project management, colony deployment, zone status.
+// ============================================================
+export class MandibleCloudError extends Error {
+    code;
+    status;
+    constructor(code, message, status) {
+        super(message);
+        this.code = code;
+        this.status = status;
+        this.name = 'MandibleCloudError';
+    }
+}
+export class MandibleCloudClient {
+    apiUrl;
+    apiKey;
+    project;
+    constructor(config) {
+        this.apiUrl = config.apiUrl.replace(/\/$/, '');
+        this.apiKey = config.apiKey;
+        this.project = config.project;
+    }
+    // ----------------------------------------------------------
+    // Projects
+    // ----------------------------------------------------------
+    async createProject(req) {
+        return this.post('/v1/projects', req);
+    }
+    async getProject(id) {
+        return this.get(`/v1/projects/${id ?? this.requireProject()}`);
+    }
+    async listProjects() {
+        return this.get('/v1/projects');
+    }
+    async deleteProject(id) {
+        return this.del(`/v1/projects/${id ?? this.requireProject()}`);
+    }
+    // ----------------------------------------------------------
+    // Deploy / Colonies
+    // ----------------------------------------------------------
+    async deploy(req, projectId) {
+        return this.post(`/v1/projects/${projectId ?? this.requireProject()}/deploy`, req);
+    }
+    async listColonies(projectId) {
+        return this.get(`/v1/projects/${projectId ?? this.requireProject()}/colonies`);
+    }
+    async destroyColony(colonyName, projectId) {
+        return this.del(`/v1/projects/${projectId ?? this.requireProject()}/colonies/${colonyName}`);
+    }
+    async teardown(projectId) {
+        const colonies = await this.listColonies(projectId);
+        for (const colony of colonies) {
+            await this.destroyColony(colony.name, projectId);
+        }
+    }
+    // ----------------------------------------------------------
+    // Zones
+    // ----------------------------------------------------------
+    async listZones(projectId) {
+        return this.get(`/v1/projects/${projectId ?? this.requireProject()}/zones`);
+    }
+    async getZone(zoneId, projectId) {
+        return this.get(`/v1/projects/${projectId ?? this.requireProject()}/zones/${zoneId}`);
+    }
+    // ----------------------------------------------------------
+    // API Keys
+    // ----------------------------------------------------------
+    async createApiKey(projectId) {
+        return this.post(`/v1/auth/keys`, { project: projectId ?? this.requireProject() });
+    }
+    async revokeApiKey(keyId) {
+        return this.del(`/v1/auth/keys/${keyId}`);
+    }
+    // ----------------------------------------------------------
+    // HTTP helpers
+    // ----------------------------------------------------------
+    async get(path) {
+        return this.fetch(path, { method: 'GET' });
+    }
+    async post(path, body) {
+        return this.fetch(path, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(body),
+        });
+    }
+    async del(path) {
+        return this.fetch(path, { method: 'DELETE' });
+    }
+    async fetch(path, init) {
+        const url = `${this.apiUrl}${path}`;
+        const response = await globalThis.fetch(url, {
+            ...init,
+            headers: {
+                ...init.headers,
+                'Authorization': `Bearer ${this.apiKey}`,
+                'User-Agent': 'mandible-sdk/0.1.0',
+            },
+        });
+        if (!response.ok) {
+            let error;
+            try {
+                error = await response.json();
+            }
+            catch {
+                error = { code: 'UNKNOWN', message: response.statusText };
+            }
+            throw new MandibleCloudError(error.code, error.message, response.status);
+        }
+        if (response.status === 204)
+            return undefined;
+        return response.json();
+    }
+    requireProject() {
+        if (!this.project) {
+            throw new Error('No project specified. Pass project to constructor or method.');
+        }
+        return this.project;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/src/cloud/client.js.map

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

package/dist/src/cloud/index.d.ts

@@ -0,0 +1,5 @@
+export { RemoteEnvironment } from '../environments/remote/index.js';
+export type { RemoteEnvConfig } from '../environments/remote/index.js';
+export { MandibleCloudClient, MandibleCloudError } from './client.js';
+export type { CloudConfig, Project, CreateProjectRequest, DeployRequest, DeployColonyConfig, DeployResult, DeployedColony, ZoneState, ZoneStatus, ZoneMetrics, ZoneResources, ColonyStatus, ApiKey, CreateApiKeyResponse, ApiError, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/cloud/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cloud/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,YAAY,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtE,YAAY,EACV,WAAW,EACX,OAAO,EACP,oBAAoB,EACpB,aAAa,EACb,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACd,SAAS,EACT,UAAU,EACV,WAAW,EACX,aAAa,EACb,YAAY,EACZ,MAAM,EACN,oBAAoB,EACpB,QAAQ,GACT,MAAM,YAAY,CAAC"}

package/dist/src/cloud/index.js

@@ -0,0 +1,3 @@
+export { RemoteEnvironment } from '../environments/remote/index.js';
+export { MandibleCloudClient, MandibleCloudError } from './client.js';
+//# sourceMappingURL=index.js.map

package/dist/src/cloud/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cloud/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAEpE,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC"}

package/dist/src/cloud/types.d.ts

@@ -0,0 +1,104 @@
+export interface CloudConfig {
+    apiUrl: string;
+    apiKey: string;
+    project?: string;
+}
+export interface Project {
+    id: string;
+    name: string;
+    signalServerUrl: string;
+    createdAt: string;
+    colonyCount: number;
+}
+export interface CreateProjectRequest {
+    name: string;
+}
+export interface DeployRequest {
+    colonies: DeployColonyConfig[];
+}
+export interface DeployColonyConfig {
+    name: string;
+    image?: string;
+    sensors: Array<{
+        query: {
+            type?: string | string[];
+            unclaimed?: boolean;
+            minConcentration?: number;
+            tags?: string[];
+        };
+        pollInterval?: number;
+    }>;
+    claimStrategy: string;
+    concurrency: number;
+    config?: Record<string, unknown>;
+    resources?: ZoneResources;
+}
+export interface ZoneResources {
+    targetCpus?: number;
+    maxCpus?: number;
+    targetMemoryMb?: number;
+    maxMemoryMb?: number;
+}
+export interface DeployResult {
+    projectId: string;
+    colonies: DeployedColony[];
+    signalServerUrl: string;
+    dashboardUrl: string;
+}
+export interface DeployedColony {
+    name: string;
+    zoneId: string;
+    zoneName: string;
+    state: ZoneState;
+    resources: ZoneResources;
+    createdAt: string;
+}
+export type ZoneState = 'creating' | 'created' | 'ready' | 'running' | 'exited' | 'destroying' | 'destroyed' | 'failed';
+export interface ZoneStatus {
+    zoneId: string;
+    zoneName: string;
+    colony: string;
+    state: ZoneState;
+    resources: ZoneResources;
+    metrics?: ZoneMetrics;
+    createdAt: string;
+    uptimeSeconds: number;
+}
+export interface ZoneMetrics {
+    cpuUsagePercent: number;
+    memoryUsedMb: number;
+    memoryTotalMb: number;
+    signalsProcessed: number;
+    signalsDeposited: number;
+    errors: number;
+}
+export interface ColonyStatus {
+    name: string;
+    zone: ZoneStatus;
+    runtimeStats: {
+        signalsSensed: number;
+        signalsClaimed: number;
+        signalsProcessed: number;
+        signalsDeposited: number;
+        claimConflicts: number;
+        errors: number;
+        avgProcessingMs: number;
+    };
+}
+export interface ApiKey {
+    id: string;
+    prefix: string;
+    project: string;
+    createdAt: string;
+    lastUsedAt?: string;
+}
+export interface CreateApiKeyResponse {
+    id: string;
+    key: string;
+    prefix: string;
+}
+export interface ApiError {
+    code: string;
+    message: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/cloud/types.d.ts.map

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

package/dist/src/cloud/types.js

@@ -0,0 +1,9 @@
+// ============================================================
+// Mandible Cloud — API Types
+// ============================================================
+// TypeScript types for the Mandible Cloud REST API.
+// These define the contract between the open-source CLI/client
+// and the private Cloud API server.
+// ============================================================
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/cloud/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/cloud/types.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,6BAA6B;AAC7B,+DAA+D;AAC/D,oDAAoD;AACpD,+DAA+D;AAC/D,oCAAoC;AACpC,+DAA+D"}

package/dist/src/core/attestation.d.ts

@@ -0,0 +1,63 @@
+import type { Signal, Attestation, ColonyIdentity, TrustPolicy, SigningConfig, VerificationResult } from './types.js';
+/**
+ * Generate a new Ed25519 colony identity.
+ * Uses @noble/ed25519 — portable across Node, browsers, and edge workers.
+ * Keys are raw 32-byte values, hex-encoded for storage.
+ */
+export declare function generateIdentity(name: string, environment: string, metadata?: Record<string, unknown>): Promise<ColonyIdentity>;
+/**
+ * Create a canonical hash of the signal content that gets signed.
+ * Signs: type + payload + caused_by — the immutable semantic content.
+ * Excludes: id, meta timestamps, concentration (mutable runtime state).
+ */
+export declare function canonicalHash(signal: Signal<any>): string;
+/**
+ * Create a canonical hash for an attestation.
+ * Each attestation signs over the previous signature in the chain,
+ * creating a linked chain of custody.
+ */
+export declare function attestationHash(signalId: string, sourceEnvironment: string, targetEnvironment: string, timestamp: number, previousSignature?: string): string;
+/**
+ * Sign a signal using a colony's private key.
+ * Returns a new signal with signature and signer set in meta.
+ * Does NOT mutate the original signal.
+ */
+export declare function signSignal<T>(signal: Signal<T>, identity: ColonyIdentity): Promise<Signal<T>>;
+/**
+ * Create a signing function that can be used as middleware.
+ * Automatically signs all signals deposited by a colony.
+ */
+export declare function createSigner(config: SigningConfig): <T>(signal: Signal<T>) => Promise<Signal<T>>;
+/**
+ * Verify a signal's colony signature.
+ * Returns true if the signature is valid for the signer's public key.
+ */
+export declare function verifySignature(signal: Signal): Promise<boolean>;
+/**
+ * Verify an entire attestation chain.
+ * Walks the chain from first attestation to last, checking:
+ *   1. Each attestation's signature is valid
+ *   2. The chain links correctly (each signs over the previous)
+ *   3. Source/target environments are consistent across the chain
+ */
+export declare function verifyAttestationChain(signalId: string, attestations: Attestation[]): Promise<Array<{
+    attester: string;
+    valid: boolean;
+    reason: string;
+}>>;
+/**
+ * Full signal verification: colony signature + attestation chain.
+ * Returns a VerificationResult with the determined trust level.
+ */
+export declare function verifySignal(signal: Signal, policy?: TrustPolicy): Promise<VerificationResult>;
+/**
+ * Create an attestation for a signal being bridged between environments.
+ * The bridge signs the transfer, appending to the attestation chain.
+ */
+export declare function createAttestation(signalId: string, sourceEnvironment: string, targetEnvironment: string, bridgeIdentity: ColonyIdentity, existingAttestations?: Attestation[]): Promise<Attestation>;
+/**
+ * Prepare a signal for bridging: add attestation and source metadata.
+ * Returns a new signal ready to deposit in the target environment.
+ */
+export declare function prepareForBridge(signal: Signal, sourceEnvironment: string, targetEnvironment: string, bridgeIdentity: ColonyIdentity): Promise<Signal>;
+//# sourceMappingURL=attestation.d.ts.map

package/dist/src/core/attestation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attestation.d.ts","sourceRoot":"","sources":["../../../src/core/attestation.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EACV,MAAM,EACN,WAAW,EACX,cAAc,EAEd,WAAW,EACX,aAAa,EACb,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAkBpB;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,cAAc,CAAC,CAYzB;AAMD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAOzD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,iBAAiB,EAAE,MAAM,EACzB,iBAAiB,EAAE,MAAM,EACzB,SAAS,EAAE,MAAM,EACjB,iBAAiB,CAAC,EAAE,MAAM,GACzB,MAAM,CASR;AAMD;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAYnG;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,IAClC,CAAC,EAAE,QAAQ,MAAM,CAAC,CAAC,CAAC,KAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAUxD;AAMD;;;GAGG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAetE;AAED;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,WAAW,EAAE,GAC1B,OAAO,CAAC,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CA4CtE;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAiHpG;AAMD;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,iBAAiB,EAAE,MAAM,EACzB,iBAAiB,EAAE,MAAM,EACzB,cAAc,EAAE,cAAc,EAC9B,oBAAoB,CAAC,EAAE,WAAW,EAAE,GACnC,OAAO,CAAC,WAAW,CAAC,CAwBtB;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,iBAAiB,EAAE,MAAM,EACzB,iBAAiB,EAAE,MAAM,EACzB,cAAc,EAAE,cAAc,GAC7B,OAAO,CAAC,MAAM,CAAC,CAkBjB"}