@atrib/recall 0.12.14 → 0.12.16

package/dist/index.d.ts

@@ -1,4 +1,36 @@
 #!/usr/bin/env node
+/**
+ * @atrib/recall - local signed-record recall MCP server.
+ *
+ * Exposes the base recall tool plus sibling query-shape tools to the host agent.
+ * Reads signed-record jsonl mirrors (per spec §5.9), VERIFIES the Ed25519
+ * signature on each record before returning it, and tags every entry with
+ * signature_verified so the agent can distinguish provable past from tampered
+ * or partial mirror state.
+ *
+ * Mirror discovery (in priority order):
+ *   1. ATRIB_RECORD_FILE - single explicit jsonl file. Back-compat with
+ *      pre-0.4.0 callers that pinned a specific producer's mirror.
+ *   2. ATRIB_MIRROR_DIR - directory; recall reads every `*.jsonl` inside.
+ *      Default: ~/.atrib/records (the spec §5.9 well-known mirror namespace).
+ *
+ * Two on-disk shapes are accepted, matching D062 / spec §5.9:
+ *   - Bare AtribRecord (legacy producers):           {spec_version, ...}
+ *   - Envelope (D062 sidecar form):                  {record: {...}, proof?, _local?}
+ * Both round-trip through verifyRecord; the parser picks the right inner shape.
+ *
+ * Trust scope: signature verification is local-only. A passing signature_verified
+ * proves the record was signed by the named creator_key; it does NOT prove the
+ * record was committed to log.atrib.dev. To confirm log inclusion, the caller
+ * should fetch the inclusion proof from the log API.
+ *
+ * Configuration via environment variables:
+ *   ATRIB_RECORD_FILE - single explicit file (overrides directory scan).
+ *   ATRIB_MIRROR_DIR - directory to scan. Default: ~/.atrib/records.
+ *   ATRIB_LOG_ORIGIN - origin used in human-readable messages.
+ *                        Default: log.atrib.dev
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { AtribRecord, EventTypeShortName } from '@atrib/mcp';
 export type ImportanceLabel = 'critical' | 'high' | 'medium' | 'low' | 'noise';
 export declare const IMPORTANCE_NUMERIC: Record<ImportanceLabel, number>;
@@ -277,4 +309,9 @@ export declare function discoverRecords(recordFile?: string): {
     files: string[];
 };
 export declare function recall(args: RecallArgs, recordFile?: string): Promise<RecallResult>;
+export interface AtribRecallServer {
+    mcp: McpServer;
+}
+export declare function registerAtribRecallTools(server: McpServer): void;
+export declare function createAtribRecallServer(): AtribRecallServer;
 export {};