@cleocode/contracts 2026.3.74 → 2026.3.76

package/dist/wasm/index.js

@@ -0,0 +1,184 @@
+/**
+ * Central WASM SDK for CLEO Core Contracts
+ *
+ * Provides unified access to all Rust crate WASM modules:
+ * - lafs-core: LAFS envelope types and validation
+ * - conduit-core: Conduit wire types and CANT metadata
+ * - cant-core: CANT grammar parser (via @cleocode/cant)
+ *
+ * Usage:
+ * ```typescript
+ * import { initWasm, lafs, conduit } from '@cleocode/contracts/wasm';
+ *
+ * await initWasm();
+ *
+ * // LAFS
+ * const meta = new lafs.WasmLafsMeta('tasks.list', 'http');
+ * const envelope = lafs.WasmLafsEnvelope.createSuccess('{"tasks":[]}', meta);
+ *
+ * // Conduit
+ * const msg = new conduit.WasmConduitMessage('msg-1', 'agent-a', 'Hello', '2026-03-25T00:00:00Z');
+ * const cant = new conduit.WasmCantMetadata('actionable', '["@agent"]', '["T123"]', '["#tag"]');
+ * ```
+ */
+// WASM module instances
+let lafsModule = null;
+let conduitModule = null;
+let isInitialized = false;
+let isInitializing = false;
+let initPromise = null;
+/**
+ * Initialize all WASM modules
+ * Must be called before using any WASM classes/functions
+ *
+ * @example
+ * ```typescript
+ * import { initWasm, lafs, conduit } from '@cleocode/contracts/wasm';
+ *
+ * await initWasm();
+ *
+ * // Now you can use WASM classes
+ * const meta = new lafs.WasmLafsMeta('tasks.list', 'http');
+ * ```
+ */
+export async function initWasm() {
+    if (isInitialized)
+        return;
+    if (isInitializing) {
+        return initPromise;
+    }
+    isInitializing = true;
+    initPromise = (async () => {
+        try {
+            // Dynamic imports to avoid loading if not needed
+            const [lafs, conduit] = await Promise.all([
+                import('./lafs-core/lafs_core.js'),
+                import('./conduit-core/conduit_core.js'),
+            ]);
+            // Initialize modules
+            await Promise.all([lafs.default(), conduit.default()]);
+            lafsModule = lafs;
+            conduitModule = conduit;
+            isInitialized = true;
+        }
+        catch (_error) {
+            throw new Error('WASM initialization failed. Ensure WASM files are present.');
+        }
+    })();
+    await initPromise;
+    isInitializing = false;
+}
+/**
+ * Check if WASM is initialized and ready to use
+ *
+ * @returns true if WASM modules are loaded and initialized
+ */
+export function isWasmReady() {
+    return isInitialized;
+}
+/**
+ * LAFS Core WASM exports
+ *
+ * Available after calling initWasm():
+ * - WasmLafsTransport - Transport type (Cli, Http, Grpc, Sdk)
+ * - WasmLafsMeta - Metadata for LAFS envelopes
+ * - WasmLafsEnvelope - The main LAFS response envelope
+ * - createTransport() - Helper to create transport from string
+ */
+export const lafs = {
+    /**
+     * LAFS Transport enum
+     * Use WasmLafsTransport.cli(), .http(), .grpc(), or .sdk()
+     */
+    get WasmLafsTransport() {
+        if (!lafsModule)
+            throw new Error('WASM not initialized. Call initWasm() first.');
+        return lafsModule.WasmLafsTransport;
+    },
+    /**
+     * LAFS Metadata constructor
+     * new WasmLafsMeta(operation: string, transport: string)
+     */
+    get WasmLafsMeta() {
+        if (!lafsModule)
+            throw new Error('WASM not initialized. Call initWasm() first.');
+        return lafsModule.WasmLafsMeta;
+    },
+    /**
+     * LAFS Envelope class
+     * Use WasmLafsEnvelope.createSuccess() or .createError()
+     */
+    get WasmLafsEnvelope() {
+        if (!lafsModule)
+            throw new Error('WASM not initialized. Call initWasm() first.');
+        return lafsModule.WasmLafsEnvelope;
+    },
+    /**
+     * Helper function to create transport from string
+     * @param transport - "cli", "http", "grpc", or "sdk"
+     */
+    get createTransport() {
+        if (!lafsModule)
+            throw new Error('WASM not initialized. Call initWasm() first.');
+        return lafsModule.create_transport;
+    },
+};
+/**
+ * Conduit Core WASM exports
+ *
+ * Available after calling initWasm():
+ * - WasmConduitMessage - Agent-to-agent messages
+ * - WasmConduitState - Connection states (Disconnected, Connecting, Connected, etc.)
+ * - WasmCantMetadata - CANT parsing results
+ * - parseConduitMessage() - Parse message from JSON
+ * - createConduitState() - Create state from string
+ */
+export const conduit = {
+    /**
+     * Conduit Message constructor
+     * new WasmConduitMessage(id, from, content, timestamp)
+     */
+    get WasmConduitMessage() {
+        if (!conduitModule)
+            throw new Error('WASM not initialized. Call initWasm() first.');
+        return conduitModule.WasmConduitMessage;
+    },
+    /**
+     * Conduit State enum
+     * Use WasmConduitState.disconnected(), .connecting(), .connected(), etc.
+     */
+    get WasmConduitState() {
+        if (!conduitModule)
+            throw new Error('WASM not initialized. Call initWasm() first.');
+        return conduitModule.WasmConduitState;
+    },
+    /**
+     * CANT Metadata constructor
+     * new WasmCantMetadata(directiveType, addressesJson, taskRefsJson, tagsJson)
+     */
+    get WasmCantMetadata() {
+        if (!conduitModule)
+            throw new Error('WASM not initialized. Call initWasm() first.');
+        return conduitModule.WasmCantMetadata;
+    },
+    /**
+     * Parse a ConduitMessage from JSON string
+     * @param json - JSON string
+     * @returns WasmConduitMessage or undefined
+     */
+    get parseConduitMessage() {
+        if (!conduitModule)
+            throw new Error('WASM not initialized. Call initWasm() first.');
+        return conduitModule.parse_conduit_message;
+    },
+    /**
+     * Create a ConduitState from string
+     * @param state - "disconnected", "connecting", "connected", "reconnecting", "error"
+     */
+    get createConduitState() {
+        if (!conduitModule)
+            throw new Error('WASM not initialized. Call initWasm() first.');
+        return conduitModule.create_conduit_state;
+    },
+};
+//# sourceMappingURL=index.js.map

package/dist/wasm/index.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleocode/contracts",
-  "version": "2026.3.74",
+  "version": "2026.3.76",
   "description": "Domain types, interfaces, and contracts for the CLEO ecosystem",
   "type": "module",
   "main": "./dist/index.js",

package/src/agent-registry.ts

@@ -0,0 +1,100 @@
+/**
+ * Agent Registry — Credential management and lifecycle for registered agents.
+ *
+ * Provides typed CRUD operations for agent credentials stored in the
+ * local project database (`.cleo/tasks.db`). API keys are encrypted at
+ * rest using AES-256-GCM with a machine-bound key.
+ *
+ * @see docs/specs/SIGNALDOCK-UNIFIED-AGENT-REGISTRY.md Section 3
+ * @module agent-registry
+ */
+
+// ============================================================================
+// Transport configuration
+// ============================================================================
+
+/** Transport-specific configuration stored per agent credential. */
+export interface TransportConfig {
+  /** Polling interval in milliseconds (for HTTP polling transport). */
+  pollIntervalMs?: number;
+  /** SSE endpoint URL (for Server-Sent Events transport). */
+  sseEndpoint?: string;
+  /** WebSocket URL (for WebSocket transport). */
+  wsUrl?: string;
+  /** HTTP polling endpoint path (for HTTP polling transport). */
+  pollEndpoint?: string;
+}
+
+// ============================================================================
+// Agent credential
+// ============================================================================
+
+/** A registered agent's credentials and profile. */
+export interface AgentCredential {
+  /** Unique agent identifier (e.g. 'cleo-core', 'forge-ts-opus'). */
+  agentId: string;
+  /** Human-readable display name. */
+  displayName: string;
+  /** API key for authentication (`sk_live_*`). Stored encrypted at rest. */
+  apiKey: string;
+  /** Base URL of the messaging API (default: api.signaldock.io, legacy: api.clawmsgr.com). */
+  apiBaseUrl: string;
+  /** Agent classification from the registry (e.g. 'code_dev', 'orchestrator'). */
+  classification?: string;
+  /** Privacy tier controlling discoverability. */
+  privacyTier: 'public' | 'discoverable' | 'private';
+  /** Agent capabilities (e.g. ['chat', 'tools', 'code-execution']). */
+  capabilities: string[];
+  /** Agent skills (e.g. ['coding', 'review', 'testing']). */
+  skills: string[];
+  /** Transport-specific configuration. */
+  transportConfig: TransportConfig;
+  /** Whether this agent is currently active. */
+  isActive: boolean;
+  /** ISO 8601 timestamp of last use (polling, sending, etc.). */
+  lastUsedAt?: string;
+  /** ISO 8601 creation timestamp. */
+  createdAt: string;
+  /** ISO 8601 last update timestamp. */
+  updatedAt: string;
+}
+
+// ============================================================================
+// Registry API
+// ============================================================================
+
+/** Filter options for listing agent credentials. */
+export interface AgentListFilter {
+  /** Filter by active/inactive status. */
+  active?: boolean;
+}
+
+/** CRUD and lifecycle operations for agent credentials. */
+export interface AgentRegistryAPI {
+  /** Register a new agent credential. */
+  register(credential: Omit<AgentCredential, 'createdAt' | 'updatedAt'>): Promise<AgentCredential>;
+
+  /** Get a single agent credential by ID. Returns null if not found. */
+  get(agentId: string): Promise<AgentCredential | null>;
+
+  /** List agent credentials with optional filtering. */
+  list(filter?: AgentListFilter): Promise<AgentCredential[]>;
+
+  /** Update fields on an existing agent credential. */
+  update(
+    agentId: string,
+    updates: Partial<Omit<AgentCredential, 'agentId' | 'createdAt'>>,
+  ): Promise<AgentCredential>;
+
+  /** Remove an agent credential permanently. */
+  remove(agentId: string): Promise<void>;
+
+  /** Rotate an agent's API key (generates new key on cloud, re-encrypts locally). */
+  rotateKey(agentId: string): Promise<{ agentId: string; newApiKey: string }>;
+
+  /** Get the most recently used active agent credential. Returns null if none. */
+  getActive(): Promise<AgentCredential | null>;
+
+  /** Mark an agent as recently used (updates `lastUsedAt`). */
+  markUsed(agentId: string): Promise<void>;
+}

package/src/conduit.ts

@@ -1,7 +1,10 @@
 /**
  * Conduit Protocol — Agent-to-agent communication interface.
  *
- * SignalDock implements this interface. CleoOS consumes it.
+ * This is a CLIENT-SIDE interface. Implementations call a messaging
+ * backend (SignalDock REST API, local napi-rs, etc.). SignalDock is
+ * the canonical backend; it does NOT implement this TypeScript interface.
+ *
  * CLEO Core defines the contract in @cleocode/contracts.
  *
  * This is the canonical TypeScript interface for the Conduit Protocol
@@ -81,16 +84,20 @@ export interface ConduitStateChange {
 // ============================================================================
 
 /**
- * The Conduit Protocol interface.
+ * The Conduit Protocol interface — high-level agent messaging.
+ *
+ * Conduit wraps a Transport adapter, adding messaging semantics.
  *
  * Implementations:
- * - ClawMsgrPollingService (CleoOS Electron main process — polls cloud API)
- * - LocalSignalDock (napi-rs binding — WebSocket to local SignalDock runtime)
- * - ClawMsgrWorker (CLI polling script — clawmsgr-worker.py wrapper)
+ * - `ConduitClient` (`@cleocode/core` — wraps any Transport)
+ * - `HttpTransport` (HTTP polling to cloud SignalDock API)
+ * - `LocalTransport` (napi-rs in-process — embedded SignalDock, future)
+ * - `SseTransport` (Server-Sent Events — real-time cloud, future)
  *
  * Consumers:
- * - CleoOS tRPC routers (wire into orchestration, session management)
- * - @cleocode/core facade (sessions.serialize/restore, orchestration commands)
+ * - `@cleocode/cleo` CLI (`cleo agent watch/poll/send`)
+ * - `@cleocode/runtime` (background polling, SSE connections)
+ * - CleoOS Electron (embedded SignalDock via LocalTransport)
  * - Agent spawners (deliver task assignments, collect results)
  */
 export interface Conduit {

package/src/data-accessor.ts

@@ -17,6 +17,26 @@ import type { ArchivedTask } from './archive.js';
 import type { Session } from './session.js';
 import type { Task, TaskPriority, TaskSize, TaskStatus, TaskType } from './task.js';
 
+/**
+ * Agent instance row shape for DataAccessor methods.
+ * Mirrors the agent_instances Drizzle table in core but avoids Drizzle dependency.
+ */
+export interface DataAccessorAgentInstance {
+  id: string;
+  agentType: string;
+  status: string;
+  sessionId: string | null;
+  taskId: string | null;
+  startedAt: string;
+  lastHeartbeat: string;
+  stoppedAt: string | null;
+  errorCount: number;
+  totalTasksCompleted: number;
+  capacity: string;
+  metadataJson: string | null;
+  parentAgentId: string | null;
+}
+
 /** Archive-specific fields for task upsert. */
 export interface ArchiveFields {
   archivedAt?: string;
@@ -83,6 +103,7 @@ export interface TaskFieldUpdates {
   modifiedBy?: string | null;
   sessionId?: string | null;
   updatedAt?: string | null;
+  assignee?: string | null;
 }
 
 /**
@@ -227,6 +248,41 @@ export interface DataAccessor {
 
   /** Remove a single session by ID. */
   removeSingleSession(sessionId: string): Promise<void>;
+
+  // ---- Agent instances ----
+
+  /** List agent instances with optional filters. Returns rows from agent_instances table. */
+  listAgentInstances(filters?: {
+    status?: string | string[];
+    agentType?: string | string[];
+  }): Promise<DataAccessorAgentInstance[]>;
+
+  /** Get a single agent instance by ID. Returns null if not found. */
+  getAgentInstance(agentId: string): Promise<DataAccessorAgentInstance | null>;
+
+  // ---- Agent task claiming ----
+
+  /**
+   * Atomically claim a task for an agent.
+   *
+   * Uses `UPDATE ... WHERE assignee IS NULL OR assignee = agentId` to prevent
+   * race conditions. Throws if the task is already claimed by a different agent.
+   *
+   * @param taskId - ID of the task to claim.
+   * @param agentId - Agent identifier claiming the task.
+   * @throws {Error} When the task is not found or is already claimed by another agent.
+   */
+  claimTask(taskId: string, agentId: string): Promise<void>;
+
+  /**
+   * Release a claimed task, clearing its assignee.
+   *
+   * No-op if the task is not currently claimed.
+   *
+   * @param taskId - ID of the task to unclaim.
+   * @throws {Error} When the task is not found.
+   */
+  unclaimTask(taskId: string): Promise<void>;
 }
 
 // Factory functions (createDataAccessor, getAccessor) live in @cleocode/core,

package/src/index.ts

@@ -8,6 +8,13 @@
 
 // === Provider Adapter Contracts ===
 export type { AdapterHealthStatus, CLEOProviderAdapter } from './adapter.js';
+// === Agent Registry (credential management) ===
+export type {
+  AgentCredential,
+  AgentListFilter,
+  AgentRegistryAPI,
+  TransportConfig,
+} from './agent-registry.js';
 // === Archive Types ===
 export type {
   ArchiveCycleTimesReport,
@@ -76,6 +83,7 @@ export type {
   ArchiveFields,
   ArchiveFile,
   DataAccessor,
+  DataAccessorAgentInstance,
   QueryTasksResult,
   TaskFieldUpdates,
   TaskQueryFilters,
@@ -313,7 +321,12 @@ export type {
   TesseraTemplate,
   TesseraVariable,
 } from './tessera.js';
-export type { AdapterTransportProvider } from './transport.js';
+// === Transport (low-level wire protocol) ===
+export type {
+  AdapterTransportProvider,
+  Transport,
+  TransportConnectConfig,
+} from './transport.js';
 // === WarpChain Types ===
 export type {
   ChainShape,
@@ -329,3 +342,6 @@ export type {
   WarpLink,
   WarpStage,
 } from './warp-chain.js';
+
+// === WASM SDK (Rust crate bindings) ===
+export * as wasm from './wasm/index.js';

package/src/lafs.ts

@@ -2,7 +2,7 @@
  * LAFS (LLM-Agent-First Schema) unified envelope types.
  *
  * Defines canonical LAFS types inline (contracts has ZERO external dependencies).
- * In the main CLEO codebase these are re-exported from @cleocode/lafs-protocol;
+ * In the main CLEO codebase these are re-exported from @cleocode/lafs;
  * here they are defined as plain interfaces for maximum portability.
  *
  * @epic T4654
@@ -10,7 +10,7 @@
  */
 
 // ---------------------------------------------------------------------------
-// Canonical LAFS types (inlined from @cleocode/lafs-protocol)
+// Canonical LAFS types (inlined from @cleocode/lafs)
 // ---------------------------------------------------------------------------
 
 /** LAFS error category. */

package/src/task.ts

@@ -214,6 +214,9 @@ export interface Task {
    * @task T060
    */
   pipelineStage?: string | null;
+
+  /** Agent ID that has claimed/is assigned to this task. Null when unclaimed. */
+  assignee?: string | null;
 }
 
 // ---------------------------------------------------------------------------

package/src/transport.ts

@@ -1,12 +1,76 @@
 /**
- * Transport provider interface for CLEO provider adapters.
- * Allows providers to supply custom inter-agent transport mechanisms.
- * @task T5240
+ * Transport — Low-level wire protocol adapters for agent messaging.
+ *
+ * Transport is the HOW layer: it moves messages over the wire using
+ * HTTP polling, SSE, WebSocket, or in-process napi-rs calls.
+ *
+ * The Conduit interface (conduit.ts) wraps Transport to provide
+ * high-level messaging semantics (WHAT the agent wants to do).
+ *
+ * @see docs/specs/SIGNALDOCK-UNIFIED-AGENT-REGISTRY.md Section 4
+ * @module transport
  */
 
+import type { TransportConfig } from './agent-registry.js';
+import type { ConduitMessage } from './conduit.js';
+
+// ============================================================================
+// Transport connection config
+// ============================================================================
+
+/** Configuration passed to Transport.connect(). */
+export interface TransportConnectConfig extends TransportConfig {
+  /** Agent ID to connect as. */
+  agentId: string;
+  /** API key for authentication. */
+  apiKey: string;
+  /** Base URL of the messaging API. */
+  apiBaseUrl: string;
+}
+
+// ============================================================================
+// Transport interface
+// ============================================================================
+
+/** Low-level wire transport for agent messaging. */
+export interface Transport {
+  /** Transport name for logging/debugging (e.g. 'http', 'sse', 'ws', 'local'). */
+  readonly name: string;
+
+  /** Connect to the messaging backend. */
+  connect(config: TransportConnectConfig): Promise<void>;
+
+  /** Disconnect from the messaging backend. */
+  disconnect(): Promise<void>;
+
+  /** Send a message payload. */
+  push(
+    to: string,
+    content: string,
+    options?: {
+      conversationId?: string;
+      replyTo?: string;
+    },
+  ): Promise<{ messageId: string }>;
+
+  /** Poll for new messages (non-destructive peek). */
+  poll(options?: { limit?: number; since?: string }): Promise<ConduitMessage[]>;
+
+  /** Acknowledge processed messages (marks as delivered). */
+  ack(messageIds: string[]): Promise<void>;
+
+  /** Subscribe to real-time events (SSE/WebSocket). Returns unsubscribe. */
+  subscribe?(handler: (message: ConduitMessage) => void): () => void;
+}
+
+// ============================================================================
+// Legacy adapter (kept for backward compatibility during migration)
+// ============================================================================
+
+/** @deprecated Use Transport instead. Will be removed after unification. */
 export interface AdapterTransportProvider {
-  /** Create a transport instance for inter-agent communication */
+  /** Create a transport instance for inter-agent communication. */
   createTransport(): unknown;
-  /** Name of this transport type for logging/debugging */
+  /** Name of this transport type for logging/debugging. */
   readonly transportName: string;
 }