@iflow-mcp/jkheadley-instar 0.26.2

package/dist/threadline/OpenClawBridge.js

@@ -0,0 +1,336 @@
+/**
+ * OpenClawBridge — Adapter between OpenClaw's session model and Threadline's
+ * thread-based model.
+ *
+ * Part of Threadline Protocol Phase 6D. OpenClaw (formerly ElizaOS) uses a
+ * session-based agent model with skills (plugins) that define actions,
+ * providers, and evaluators. This bridge translates between that model and
+ * Threadline's thread-based persistent conversations.
+ *
+ * Key mappings:
+ * - OpenClaw roomId → Threadline threadId (via ContextThreadMap)
+ * - OpenClaw userId → Threadline agent identity
+ * - OpenClaw actions → Threadline operations (send, discover, history, status)
+ *
+ * No external SDK dependency — OpenClaw interfaces are defined locally and
+ * all dependencies are injected via config.
+ */
+// ── Constants ──────────────────────────────────────────────────────────
+/** Default trust level for agents arriving via OpenClaw */
+const DEFAULT_TRUST_LEVEL = 'untrusted';
+/** Default token estimate per message when actual count is unavailable */
+const DEFAULT_TOKEN_ESTIMATE = 500;
+// ── Implementation ─────────────────────────────────────────────────────
+export class OpenClawBridge {
+    config;
+    roomToThread;
+    metrics;
+    constructor(config) {
+        this.config = config;
+        this.roomToThread = new Map();
+        this.metrics = {
+            messagesProcessed: 0,
+            threadsActive: 0,
+            errors: 0,
+        };
+    }
+    // ── Actions ───────────────────────────────────────────────────────
+    /**
+     * Get all OpenClaw-compatible actions that this bridge provides.
+     * These can be registered as actions in an OpenClaw skill.
+     */
+    getActions() {
+        return [
+            this.createSendAction(),
+            this.createDiscoverAction(),
+            this.createHistoryAction(),
+            this.createStatusAction(),
+        ];
+    }
+    // ── Message Processing ────────────────────────────────────────────
+    /**
+     * Process an incoming OpenClaw message through the Threadline bridge.
+     * Maps the OpenClaw roomId to a Threadline threadId, checks trust and
+     * compute budgets, then forwards via the sendMessage callback.
+     */
+    async processMessage(runtime, message) {
+        try {
+            const agentIdentity = this.resolveAgentIdentity(runtime, message);
+            const trustLevel = this.getAgentTrustLevel(agentIdentity);
+            // Check trust — untrusted agents can only ping/health, not message
+            if (this.config.trustManager) {
+                const allowed = this.config.trustManager.checkPermission(agentIdentity, 'message');
+                if (!allowed) {
+                    this.metrics.errors++;
+                    return `[bridge-error] Agent "${agentIdentity}" does not have permission to send messages. Current trust level: ${trustLevel}`;
+                }
+            }
+            // Check compute budget
+            if (this.config.computeMeter) {
+                const tokenEstimate = DEFAULT_TOKEN_ESTIMATE;
+                const check = this.config.computeMeter.check(agentIdentity, trustLevel, tokenEstimate);
+                if (!check.allowed) {
+                    this.metrics.errors++;
+                    const retryMsg = check.retryAfterSeconds
+                        ? ` Retry after ${check.retryAfterSeconds} seconds.`
+                        : '';
+                    return `[bridge-error] Compute budget exceeded: ${check.reason}.${retryMsg}`;
+                }
+            }
+            // Resolve thread
+            const { threadId, isNewThread } = this.resolveThread(message.roomId, agentIdentity);
+            // Send through Threadline
+            const response = await this.config.sendMessage({
+                fromAgent: agentIdentity,
+                threadId,
+                message: message.content.text,
+                isNewThread,
+            });
+            // Record compute usage
+            if (this.config.computeMeter) {
+                const tokenCount = response.tokenCount ?? DEFAULT_TOKEN_ESTIMATE;
+                this.config.computeMeter.record(agentIdentity, trustLevel, tokenCount);
+            }
+            // Record interaction
+            if (this.config.trustManager) {
+                this.config.trustManager.recordMessageReceived(agentIdentity);
+                this.config.trustManager.recordInteraction(agentIdentity, true);
+            }
+            this.metrics.messagesProcessed++;
+            return response.message;
+        }
+        catch (err) {
+            this.metrics.errors++;
+            // Record failed interaction
+            const agentIdentity = this.resolveAgentIdentity(runtime, message);
+            if (this.config.trustManager) {
+                this.config.trustManager.recordInteraction(agentIdentity, false, String(err));
+            }
+            const errorMessage = err instanceof Error ? err.message : String(err);
+            return `[bridge-error] Failed to process message: ${errorMessage}`;
+        }
+    }
+    // ── Thread Mapping ────────────────────────────────────────────────
+    /**
+     * Get the Threadline threadId for an OpenClaw roomId + agentId pair.
+     * Returns null if no mapping exists.
+     */
+    getThreadId(roomId, agentId) {
+        // Check ContextThreadMap first (persistent, identity-bound)
+        if (this.config.contextThreadMap) {
+            return this.config.contextThreadMap.getThreadId(roomId, agentId);
+        }
+        // Fall back to in-memory map
+        const key = `${roomId}::${agentId}`;
+        return this.roomToThread.get(key) ?? null;
+    }
+    // ── Metrics ───────────────────────────────────────────────────────
+    /**
+     * Get current bridge metrics.
+     */
+    getMetrics() {
+        return { ...this.metrics };
+    }
+    // ── Private: Action Builders ──────────────────────────────────────
+    createSendAction() {
+        const bridge = this;
+        return {
+            name: 'THREADLINE_SEND',
+            description: 'Send a message to a Threadline agent. The message will be routed through the Threadline protocol with trust verification and compute metering.',
+            validate: async (_runtime, message) => {
+                return !!(message.content?.text?.trim());
+            },
+            handler: async (runtime, message) => {
+                const response = await bridge.processMessage(runtime, message);
+                return { text: response };
+            },
+            examples: [
+                [
+                    { user: '{{user1}}', content: { text: 'Send a message to the research agent: What papers have you found on multi-agent coordination?' } },
+                ],
+                [
+                    { user: '{{user1}}', content: { text: 'Tell the analysis agent to summarize the latest results' } },
+                ],
+            ],
+        };
+    }
+    createDiscoverAction() {
+        const bridge = this;
+        return {
+            name: 'THREADLINE_DISCOVER',
+            description: 'Discover available Threadline agents and their capabilities. Returns a list of agents with trust levels and supported operations.',
+            validate: async () => {
+                return !!bridge.config.discoverAgents;
+            },
+            handler: async () => {
+                if (!bridge.config.discoverAgents) {
+                    return { text: 'Agent discovery is not configured for this bridge.' };
+                }
+                try {
+                    const agents = await bridge.config.discoverAgents();
+                    if (agents.length === 0) {
+                        return { text: 'No Threadline agents are currently available.' };
+                    }
+                    const lines = agents.map(a => {
+                        const trust = a.trustLevel ? ` [trust: ${a.trustLevel}]` : '';
+                        const caps = a.capabilities?.length ? ` — ${a.capabilities.join(', ')}` : '';
+                        return `- ${a.name}${trust}${caps}${a.description ? `: ${a.description}` : ''}`;
+                    });
+                    return { text: `Available Threadline agents:\n${lines.join('\n')}` };
+                }
+                catch (err) {
+                    bridge.metrics.errors++;
+                    const msg = err instanceof Error ? err.message : String(err);
+                    return { text: `[bridge-error] Discovery failed: ${msg}` };
+                }
+            },
+            examples: [
+                [
+                    { user: '{{user1}}', content: { text: 'What agents are available on the Threadline network?' } },
+                ],
+                [
+                    { user: '{{user1}}', content: { text: 'Discover Threadline agents' } },
+                ],
+            ],
+        };
+    }
+    createHistoryAction() {
+        const bridge = this;
+        return {
+            name: 'THREADLINE_HISTORY',
+            description: 'Get conversation history from a Threadline thread. Retrieves recent messages from an ongoing conversation.',
+            validate: async (_runtime, message) => {
+                // Valid if we have a getHistory callback and a room mapping
+                if (!bridge.config.getHistory)
+                    return false;
+                return !!message.roomId;
+            },
+            handler: async (runtime, message) => {
+                if (!bridge.config.getHistory) {
+                    return { text: 'Thread history retrieval is not configured for this bridge.' };
+                }
+                const agentIdentity = bridge.resolveAgentIdentity(runtime, message);
+                const threadId = bridge.getThreadId(message.roomId, agentIdentity);
+                if (!threadId) {
+                    return { text: 'No active thread found for this room. Send a message first to start a conversation.' };
+                }
+                // Parse optional limit from message metadata
+                const limit = typeof message.metadata?.limit === 'number' ? message.metadata.limit : 10;
+                try {
+                    const history = await bridge.config.getHistory(threadId, limit);
+                    if (history.length === 0) {
+                        return { text: 'No messages found in this thread.' };
+                    }
+                    const lines = history.map(h => `[${h.timestamp}] ${h.role}: ${h.content}`);
+                    return { text: `Thread history (${history.length} messages):\n${lines.join('\n')}` };
+                }
+                catch (err) {
+                    bridge.metrics.errors++;
+                    const msg = err instanceof Error ? err.message : String(err);
+                    return { text: `[bridge-error] History retrieval failed: ${msg}` };
+                }
+            },
+            examples: [
+                [
+                    { user: '{{user1}}', content: { text: 'Show me the conversation history with the research agent' } },
+                ],
+                [
+                    { user: '{{user1}}', content: { text: 'Get the last 5 messages from this thread' } },
+                ],
+            ],
+        };
+    }
+    createStatusAction() {
+        const bridge = this;
+        return {
+            name: 'THREADLINE_STATUS',
+            description: 'Check the status of Threadline connections, including thread state, compute budget, and trust levels.',
+            validate: async () => {
+                return true;
+            },
+            handler: async (runtime, message) => {
+                const agentIdentity = bridge.resolveAgentIdentity(runtime, message);
+                const statusLines = ['Threadline Bridge Status:'];
+                // Thread mapping
+                const threadId = bridge.getThreadId(message.roomId, agentIdentity);
+                statusLines.push(`Thread: ${threadId ?? 'no active thread'}`);
+                // Trust level
+                if (bridge.config.trustManager) {
+                    const profile = bridge.config.trustManager.getProfile(agentIdentity);
+                    statusLines.push(`Trust level: ${profile?.level ?? 'unknown (defaults to untrusted)'}`);
+                    const stats = bridge.config.trustManager.getInteractionStats(agentIdentity);
+                    if (stats) {
+                        statusLines.push(`Interactions: ${stats.successfulInteractions} successful, ${stats.failedInteractions} failed (${(stats.successRate * 100).toFixed(1)}% success rate)`);
+                    }
+                }
+                // Compute budget
+                if (bridge.config.computeMeter) {
+                    const trustLevel = bridge.getAgentTrustLevel(agentIdentity);
+                    const check = bridge.config.computeMeter.check(agentIdentity, trustLevel, 0);
+                    statusLines.push(`Compute remaining: ${check.remaining.hourlyTokens} hourly / ${check.remaining.dailyTokens} daily tokens`);
+                }
+                // Bridge metrics
+                const m = bridge.metrics;
+                statusLines.push(`Bridge metrics: ${m.messagesProcessed} processed, ${m.threadsActive} active threads, ${m.errors} errors`);
+                return { text: statusLines.join('\n') };
+            },
+            examples: [
+                [
+                    { user: '{{user1}}', content: { text: 'What is the status of my Threadline connection?' } },
+                ],
+                [
+                    { user: '{{user1}}', content: { text: 'Check Threadline status' } },
+                ],
+            ],
+        };
+    }
+    // ── Private: Helpers ──────────────────────────────────────────────
+    /**
+     * Resolve the Threadline agent identity from an OpenClaw runtime + message.
+     * Uses the OpenClaw userId as the primary identity, falling back to agentId.
+     */
+    resolveAgentIdentity(runtime, message) {
+        // Prefer the message sender's userId as the agent identity
+        return message.userId || runtime.agentId;
+    }
+    /**
+     * Get the trust level for an agent. Falls back to DEFAULT_TRUST_LEVEL
+     * if no trust manager is configured or the agent has no profile.
+     */
+    getAgentTrustLevel(agentIdentity) {
+        if (!this.config.trustManager)
+            return DEFAULT_TRUST_LEVEL;
+        const profile = this.config.trustManager.getProfile(agentIdentity);
+        return profile?.level ?? DEFAULT_TRUST_LEVEL;
+    }
+    /**
+     * Resolve an OpenClaw roomId to a Threadline threadId.
+     * Creates a new mapping if none exists. Returns the threadId and whether
+     * this is a new thread.
+     */
+    resolveThread(roomId, agentIdentity) {
+        // Check persistent ContextThreadMap first
+        if (this.config.contextThreadMap) {
+            const existingThreadId = this.config.contextThreadMap.getThreadId(roomId, agentIdentity);
+            if (existingThreadId) {
+                return { threadId: existingThreadId, isNewThread: false };
+            }
+            // Create new mapping — generate a threadId from the roomId
+            const threadId = `openclaw-${roomId}-${Date.now().toString(36)}`;
+            this.config.contextThreadMap.set(roomId, threadId, agentIdentity);
+            this.metrics.threadsActive++;
+            return { threadId, isNewThread: true };
+        }
+        // Fall back to in-memory mapping
+        const key = `${roomId}::${agentIdentity}`;
+        const existingThreadId = this.roomToThread.get(key);
+        if (existingThreadId) {
+            return { threadId: existingThreadId, isNewThread: false };
+        }
+        const threadId = `openclaw-${roomId}-${Date.now().toString(36)}`;
+        this.roomToThread.set(key, threadId);
+        this.metrics.threadsActive++;
+        return { threadId, isNewThread: true };
+    }
+}
+//# sourceMappingURL=OpenClawBridge.js.map

package/dist/threadline/OpenClawBridge.js.map

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

package/dist/threadline/OpenClawSkillManifest.d.ts

@@ -0,0 +1,47 @@
+/**
+ * OpenClawSkillManifest — Generates the OpenClaw skill manifest for publishing
+ * Threadline as an OpenClaw skill on ClawHub.
+ *
+ * Part of Threadline Protocol Phase 6D. The manifest describes the skill's
+ * actions, providers, evaluators, and configuration in the format expected
+ * by OpenClaw's skill registry.
+ */
+export interface SkillManifest {
+    name: string;
+    description: string;
+    version: string;
+    author: string;
+    license: string;
+    actions: Array<{
+        name: string;
+        description: string;
+        examples: Array<Array<{
+            user: string;
+            content: {
+                text: string;
+            };
+        }>>;
+    }>;
+    providers: Array<{
+        name: string;
+        description: string;
+    }>;
+    evaluators: Array<{
+        name: string;
+        description: string;
+    }>;
+    configuration: Record<string, {
+        type: string;
+        description: string;
+        required: boolean;
+        default?: string;
+    }>;
+}
+/**
+ * Generate the OpenClaw skill manifest for the Threadline skill.
+ *
+ * @param version - Manifest version. Defaults to 0.1.0.
+ * @returns The complete skill manifest ready for publishing to ClawHub.
+ */
+export declare function generateSkillManifest(version?: string): SkillManifest;
+//# sourceMappingURL=OpenClawSkillManifest.d.ts.map

package/dist/threadline/OpenClawSkillManifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenClawSkillManifest.d.ts","sourceRoot":"","sources":["../../src/threadline/OpenClawSkillManifest.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE;gBAAE,IAAI,EAAE,MAAM,CAAA;aAAE,CAAA;SAAE,CAAC,CAAC,CAAC;KACrE,CAAC,CAAC;IACH,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxD,UAAU,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzD,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE;QAC5B,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,OAAO,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;CACJ;AAeD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,aAAa,CAuIrE"}

package/dist/threadline/OpenClawSkillManifest.js

@@ -0,0 +1,148 @@
+/**
+ * OpenClawSkillManifest — Generates the OpenClaw skill manifest for publishing
+ * Threadline as an OpenClaw skill on ClawHub.
+ *
+ * Part of Threadline Protocol Phase 6D. The manifest describes the skill's
+ * actions, providers, evaluators, and configuration in the format expected
+ * by OpenClaw's skill registry.
+ */
+// ── Constants ────────────────────────────────────────────────────────
+const SKILL_NAME = '@threadline/openclaw-skill';
+const SKILL_DESCRIPTION = 'Threadline Protocol skill for OpenClaw — enables persistent thread-based ' +
+    'conversations with Ed25519 cryptographic identity, trust management, and ' +
+    'compute metering across the Threadline agent mesh.';
+const SKILL_AUTHOR = 'SageMindAI';
+const SKILL_LICENSE = 'MIT';
+const DEFAULT_VERSION = '0.1.0';
+// ── Implementation ───────────────────────────────────────────────────
+/**
+ * Generate the OpenClaw skill manifest for the Threadline skill.
+ *
+ * @param version - Manifest version. Defaults to 0.1.0.
+ * @returns The complete skill manifest ready for publishing to ClawHub.
+ */
+export function generateSkillManifest(version) {
+    return {
+        name: SKILL_NAME,
+        description: SKILL_DESCRIPTION,
+        version: version ?? DEFAULT_VERSION,
+        author: SKILL_AUTHOR,
+        license: SKILL_LICENSE,
+        actions: [
+            {
+                name: 'THREADLINE_SEND',
+                description: 'Send a message to a Threadline agent. The message is routed through ' +
+                    'the Threadline protocol with trust verification and compute metering. ' +
+                    'Automatically maps OpenClaw rooms to Threadline threads.',
+                examples: [
+                    [
+                        { user: '{{user1}}', content: { text: 'Send a message to the research agent: What papers have you found on multi-agent coordination?' } },
+                    ],
+                    [
+                        { user: '{{user1}}', content: { text: 'Tell the analysis agent to summarize the latest results' } },
+                    ],
+                ],
+            },
+            {
+                name: 'THREADLINE_DISCOVER',
+                description: 'Discover available Threadline agents and their capabilities. Returns ' +
+                    'a list of agents with their trust levels and supported operations.',
+                examples: [
+                    [
+                        { user: '{{user1}}', content: { text: 'What agents are available on the Threadline network?' } },
+                    ],
+                    [
+                        { user: '{{user1}}', content: { text: 'Discover Threadline agents' } },
+                    ],
+                ],
+            },
+            {
+                name: 'THREADLINE_HISTORY',
+                description: 'Get conversation history from a Threadline thread. Retrieves recent ' +
+                    'messages from an ongoing conversation with a remote agent.',
+                examples: [
+                    [
+                        { user: '{{user1}}', content: { text: 'Show me the conversation history with the research agent' } },
+                    ],
+                    [
+                        { user: '{{user1}}', content: { text: 'Get the last 5 messages from this thread' } },
+                    ],
+                ],
+            },
+            {
+                name: 'THREADLINE_STATUS',
+                description: 'Check the status of Threadline connections, including active thread ' +
+                    'state, compute budget remaining, trust levels, and bridge metrics.',
+                examples: [
+                    [
+                        { user: '{{user1}}', content: { text: 'What is the status of my Threadline connection?' } },
+                    ],
+                    [
+                        { user: '{{user1}}', content: { text: 'Check Threadline status' } },
+                    ],
+                ],
+            },
+        ],
+        providers: [
+            {
+                name: 'threadline-context',
+                description: 'Provides Threadline context to the agent, including active threads, ' +
+                    'trust profiles of known agents, and recent conversation summaries. ' +
+                    'Injected into the agent state on each evaluation cycle.',
+            },
+            {
+                name: 'threadline-identity',
+                description: 'Provides the agent\'s Threadline identity information, including its ' +
+                    'Ed25519 public key, agent name, and network capabilities.',
+            },
+        ],
+        evaluators: [
+            {
+                name: 'threadline-trust',
+                description: 'Evaluates incoming messages against Threadline trust policies. Checks ' +
+                    'whether the sending agent has sufficient trust level for the requested ' +
+                    'operation and whether compute budgets are within limits.',
+            },
+            {
+                name: 'threadline-coherence',
+                description: 'Evaluates conversation coherence across thread boundaries. Detects ' +
+                    'when a conversation has drifted from its original topic or when a ' +
+                    'thread should be forked into a new conversation.',
+            },
+        ],
+        configuration: {
+            THREADLINE_STATE_DIR: {
+                type: 'string',
+                description: 'Directory for Threadline state files (thread maps, trust profiles, compute meters).',
+                required: true,
+            },
+            THREADLINE_AGENT_NAME: {
+                type: 'string',
+                description: 'The agent\'s name in the Threadline network. Used for identity resolution.',
+                required: true,
+            },
+            THREADLINE_TRUST_DEFAULT: {
+                type: 'string',
+                description: 'Default trust level for unknown agents. One of: untrusted, verified, trusted, autonomous.',
+                required: false,
+                default: 'untrusted',
+            },
+            THREADLINE_HOURLY_TOKEN_LIMIT: {
+                type: 'number',
+                description: 'Override for the hourly token budget. If not set, uses the default for the agent\'s trust level.',
+                required: false,
+            },
+            THREADLINE_DAILY_TOKEN_LIMIT: {
+                type: 'number',
+                description: 'Override for the daily token budget. If not set, uses the default for the agent\'s trust level.',
+                required: false,
+            },
+            THREADLINE_DISCOVERY_ENDPOINT: {
+                type: 'string',
+                description: 'URL of the Threadline agent discovery endpoint. If not set, discovery returns only locally known agents.',
+                required: false,
+            },
+        },
+    };
+}
+//# sourceMappingURL=OpenClawSkillManifest.js.map

package/dist/threadline/OpenClawSkillManifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenClawSkillManifest.js","sourceRoot":"","sources":["../../src/threadline/OpenClawSkillManifest.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAyBH,wEAAwE;AAExE,MAAM,UAAU,GAAG,4BAA4B,CAAC;AAChD,MAAM,iBAAiB,GACrB,2EAA2E;IAC3E,2EAA2E;IAC3E,oDAAoD,CAAC;AACvD,MAAM,YAAY,GAAG,YAAY,CAAC;AAClC,MAAM,aAAa,GAAG,KAAK,CAAC;AAC5B,MAAM,eAAe,GAAG,OAAO,CAAC;AAEhC,wEAAwE;AAExE;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,iBAAiB;QAC9B,OAAO,EAAE,OAAO,IAAI,eAAe;QACnC,MAAM,EAAE,YAAY;QACpB,OAAO,EAAE,aAAa;QAEtB,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,iBAAiB;gBACvB,WAAW,EACT,sEAAsE;oBACtE,wEAAwE;oBACxE,0DAA0D;gBAC5D,QAAQ,EAAE;oBACR;wBACE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,+FAA+F,EAAE,EAAE;qBAC1I;oBACD;wBACE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,yDAAyD,EAAE,EAAE;qBACpG;iBACF;aACF;YACD;gBACE,IAAI,EAAE,qBAAqB;gBAC3B,WAAW,EACT,uEAAuE;oBACvE,oEAAoE;gBACtE,QAAQ,EAAE;oBACR;wBACE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,sDAAsD,EAAE,EAAE;qBACjG;oBACD;wBACE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,4BAA4B,EAAE,EAAE;qBACvE;iBACF;aACF;YACD;gBACE,IAAI,EAAE,oBAAoB;gBAC1B,WAAW,EACT,sEAAsE;oBACtE,4DAA4D;gBAC9D,QAAQ,EAAE;oBACR;wBACE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,0DAA0D,EAAE,EAAE;qBACrG;oBACD;wBACE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,0CAA0C,EAAE,EAAE;qBACrF;iBACF;aACF;YACD;gBACE,IAAI,EAAE,mBAAmB;gBACzB,WAAW,EACT,sEAAsE;oBACtE,oEAAoE;gBACtE,QAAQ,EAAE;oBACR;wBACE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,iDAAiD,EAAE,EAAE;qBAC5F;oBACD;wBACE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,yBAAyB,EAAE,EAAE;qBACpE;iBACF;aACF;SACF;QAED,SAAS,EAAE;YACT;gBACE,IAAI,EAAE,oBAAoB;gBAC1B,WAAW,EACT,sEAAsE;oBACtE,qEAAqE;oBACrE,yDAAyD;aAC5D;YACD;gBACE,IAAI,EAAE,qBAAqB;gBAC3B,WAAW,EACT,uEAAuE;oBACvE,2DAA2D;aAC9D;SACF;QAED,UAAU,EAAE;YACV;gBACE,IAAI,EAAE,kBAAkB;gBACxB,WAAW,EACT,wEAAwE;oBACxE,yEAAyE;oBACzE,0DAA0D;aAC7D;YACD;gBACE,IAAI,EAAE,sBAAsB;gBAC5B,WAAW,EACT,qEAAqE;oBACrE,oEAAoE;oBACpE,kDAAkD;aACrD;SACF;QAED,aAAa,EAAE;YACb,oBAAoB,EAAE;gBACpB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,qFAAqF;gBAClG,QAAQ,EAAE,IAAI;aACf;YACD,qBAAqB,EAAE;gBACrB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,4EAA4E;gBACzF,QAAQ,EAAE,IAAI;aACf;YACD,wBAAwB,EAAE;gBACxB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,2FAA2F;gBACxG,QAAQ,EAAE,KAAK;gBACf,OAAO,EAAE,WAAW;aACrB;YACD,6BAA6B,EAAE;gBAC7B,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kGAAkG;gBAC/G,QAAQ,EAAE,KAAK;aAChB;YACD,4BAA4B,EAAE;gBAC5B,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,iGAAiG;gBAC9G,QAAQ,EAAE,KAAK;aAChB;YACD,6BAA6B,EAAE;gBAC7B,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,0GAA0G;gBACvH,QAAQ,EAAE,KAAK;aAChB;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/threadline/RateLimiter.d.ts

@@ -0,0 +1,105 @@
+/**
+ * RateLimiter — Rate limiting for inter-agent communication.
+ *
+ * Part of Threadline Protocol Phase 5 (Section 7.7). Enforces per-agent,
+ * per-thread, global, burst, machine-aggregate, and spawn-request rate limits.
+ *
+ * Uses sliding window counters for accurate rate limiting (not fixed windows).
+ *
+ * Storage: In-memory with periodic persistence to {stateDir}/threadline/rate-limits.json
+ */
+export interface RateLimitConfig {
+    perAgentInbound: {
+        limit: number;
+        windowMs: number;
+    };
+    perAgentOutbound: {
+        limit: number;
+        windowMs: number;
+    };
+    perThread: {
+        limit: number;
+        windowMs: number;
+    };
+    globalInbound: {
+        limit: number;
+        windowMs: number;
+    };
+    perAgentBurst: {
+        limit: number;
+        windowMs: number;
+    };
+    machineAggregate: {
+        limit: number;
+        windowMs: number;
+    };
+    spawnRequests: {
+        limit: number;
+        windowMs: number;
+    };
+}
+export type RateLimitType = keyof RateLimitConfig;
+export interface RateLimitResult {
+    allowed: boolean;
+    remaining: number;
+    resetAt: number;
+}
+export interface RateLimitStatus {
+    type: RateLimitType;
+    key: string;
+    currentCount: number;
+    limit: number;
+    windowMs: number;
+    remaining: number;
+    isLimited: boolean;
+}
+export declare const DEFAULT_RATE_LIMITS: RateLimitConfig;
+export declare class RateLimiter {
+    private readonly threadlineDir;
+    private readonly filePath;
+    private readonly config;
+    private readonly nowFn;
+    /**
+     * Nested map: type → key → sliding window
+     * e.g., 'perAgentInbound' → 'agent-x' → { events: [...] }
+     */
+    private windows;
+    constructor(options: {
+        stateDir: string;
+        config?: Partial<RateLimitConfig>;
+        nowFn?: () => number;
+    });
+    /**
+     * Check if a rate limit would be exceeded.
+     * Does NOT record an event — use recordEvent() to consume a slot.
+     */
+    checkLimit(type: RateLimitType, key: string): RateLimitResult;
+    /**
+     * Record an event against a rate limit.
+     * Returns the check result after recording.
+     */
+    recordEvent(type: RateLimitType, key: string): RateLimitResult;
+    /**
+     * Quick check if an agent is rate limited for inbound or outbound.
+     */
+    isRateLimited(agentName: string, direction: 'inbound' | 'outbound'): boolean;
+    /**
+     * Get current rate limit status for an agent or all limits.
+     */
+    getStatus(agentName?: string): RateLimitStatus[];
+    /**
+     * Reset rate limits. If type and key provided, resets that specific limit.
+     * If only type provided, resets all keys for that type.
+     * If neither provided, resets everything.
+     */
+    reset(type?: RateLimitType, key?: string): void;
+    /**
+     * Persist current state to disk.
+     * Call periodically (e.g., every 5 minutes) for crash recovery.
+     */
+    persistToDisk(): void;
+    private getWindow;
+    private buildStatus;
+    private loadFromDisk;
+}
+//# sourceMappingURL=RateLimiter.d.ts.map