openclaw-clarke 0.4.0

package/README.md

@@ -0,0 +1,66 @@
+# openclaw-clarke
+
+CLARKE (Cognitive Learning Augmentation Retrieval Knowledge Engine) plugin for [OpenClaw](https://github.com/openclaw/openclaw).
+
+Gives your OpenClaw agent persistent memory, learned context, and self-improving skills — all injected programmatically into every LLM call.
+
+## Install
+
+```bash
+openclaw plugins install openclaw-clarke
+```
+
+## What It Does
+
+- **Every LLM call** gets CLARKE context injected into the system prompt (policies, decisions, skills, domain knowledge)
+- **Every user query** gets retrieval-augmented with relevant documents, memory, and decisions
+- **Every response** feeds back into CLARKE's learning loop for continuous improvement
+
+## Hooks
+
+| Hook | Purpose |
+|------|---------|
+| `agent:bootstrap` | Inject CLARKE identity into bootstrap files |
+| `before_prompt_build` | Inject session context (cached 60s) into system prompt |
+| `before_agent_reply` | Query-specific RAG augmentation |
+| `session_start` | Greeting + cache invalidation + auto-registration |
+| `llm_output` | Implicit feedback for learning loop |
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `clarke_status` | System health, agents, policies |
+| `clarke_recall` | Query CLARKE memory |
+| `clarke_teach` | Submit knowledge and corrections |
+| `clarke_review` | List pending directive proposals |
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `/clarke` | Dashboard |
+| `/clarke_recall <question>` | Query memory |
+| `/clarke_teach <knowledge>` | Teach CLARKE |
+
+## Prerequisites
+
+CLARKE backend must be running. See the [setup guide](https://github.com/nicktanix/clarke_v2#openclaw).
+
+## Configuration
+
+Set these environment variables (or configure via `openclaw.json`):
+
+```bash
+CLARKE_API_URL=http://localhost:8000
+CLARKE_TENANT_ID=<auto-registered>
+CLARKE_PROJECT_ID=<auto-registered>
+CLARKE_AGENT_SLUG=clarke-operator
+```
+
+Tenant and project IDs are auto-registered from the workspace path on first session start.
+
+## License
+
+Polyform Noncommercial 1.0.0 — free for personal and noncommercial use.
+For commercial licensing: nick@neill.cloud

package/dist/cache.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Simple TTL cache for CLARKE session context.
+ *
+ * The before_prompt_build hook fires on every LLM call. We cache the
+ * CLARKE context response to avoid hitting the API on every single call.
+ * Default TTL is 60 seconds — context refreshes at most once per minute.
+ */
+export declare class TTLCache<T> {
+    private ttlMs;
+    private value;
+    private expiresAt;
+    constructor(ttlMs?: number);
+    get(): T | null;
+    set(value: T): void;
+    invalidate(): void;
+    /**
+     * Get cached value, or fetch and cache a new one.
+     */
+    getOrFetch(fetcher: () => Promise<T | null>): Promise<T | null>;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,qBAAa,QAAQ,CAAC,CAAC;IAIT,OAAO,CAAC,KAAK;IAHzB,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,SAAS,CAAa;gBAEV,KAAK,GAAE,MAAe;IAE1C,GAAG,IAAI,CAAC,GAAG,IAAI;IAOf,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI;IAKnB,UAAU,IAAI,IAAI;IAKlB;;OAEG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;CAYtE"}

package/dist/cache.js

@@ -0,0 +1,44 @@
+/**
+ * Simple TTL cache for CLARKE session context.
+ *
+ * The before_prompt_build hook fires on every LLM call. We cache the
+ * CLARKE context response to avoid hitting the API on every single call.
+ * Default TTL is 60 seconds — context refreshes at most once per minute.
+ */
+export class TTLCache {
+    ttlMs;
+    value = null;
+    expiresAt = 0;
+    constructor(ttlMs = 60_000) {
+        this.ttlMs = ttlMs;
+    }
+    get() {
+        if (this.value !== null && Date.now() < this.expiresAt) {
+            return this.value;
+        }
+        return null;
+    }
+    set(value) {
+        this.value = value;
+        this.expiresAt = Date.now() + this.ttlMs;
+    }
+    invalidate() {
+        this.value = null;
+        this.expiresAt = 0;
+    }
+    /**
+     * Get cached value, or fetch and cache a new one.
+     */
+    async getOrFetch(fetcher) {
+        const cached = this.get();
+        if (cached !== null) {
+            return cached;
+        }
+        const fresh = await fetcher();
+        if (fresh !== null) {
+            this.set(fresh);
+        }
+        return fresh;
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,OAAO,QAAQ;IAIC;IAHZ,KAAK,GAAa,IAAI,CAAC;IACvB,SAAS,GAAW,CAAC,CAAC;IAE9B,YAAoB,QAAgB,MAAM;QAAtB,UAAK,GAAL,KAAK,CAAiB;IAAG,CAAC;IAE9C,GAAG;QACD,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;YACvD,OAAO,IAAI,CAAC,KAAK,CAAC;QACpB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,GAAG,CAAC,KAAQ;QACV,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;IAC3C,CAAC;IAED,UAAU;QACR,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,OAAgC;QAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC1B,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACpB,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,OAAO,EAAE,CAAC;QAC9B,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAClB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/clarke-client.d.ts

@@ -0,0 +1,72 @@
+/**
+ * CLARKE API client for the OpenClaw plugin.
+ *
+ * Uses native fetch() — no dependencies. Reads config from environment
+ * variables or plugin configuration.
+ */
+export interface ClarkeConfig {
+    endpoint: string;
+    tenantId: string;
+    projectId: string;
+    agentSlug: string;
+    workspace: string;
+}
+/**
+ * Resolve CLARKE config from environment variables.
+ *
+ * If CLARKE_TENANT_ID and CLARKE_PROJECT_ID are set, uses them directly.
+ * Otherwise, auto-registers with the CLARKE backend using the workspace
+ * path to derive a project name (each workspace gets its own CLARKE project).
+ */
+export declare function resolveConfig(): ClarkeConfig | null;
+/**
+ * Get or create the singleton CLARKE config.
+ */
+export declare function getClarkeConfig(): ClarkeConfig | null;
+/**
+ * Auto-register this workspace with CLARKE if tenant/project IDs aren't set.
+ *
+ * Calls POST /admin/setup with the workspace path as the project name.
+ * The endpoint is idempotent — same workspace path always returns the same IDs.
+ */
+export declare function ensureRegistered(config: ClarkeConfig): Promise<ClarkeConfig>;
+/**
+ * Fetch CLARKE session context as rendered markdown.
+ */
+export declare function fetchSessionContext(config: ClarkeConfig): Promise<string | null>;
+/**
+ * Fetch CLARKE health status.
+ */
+export declare function fetchHealth(config: ClarkeConfig): Promise<{
+    status: string;
+    version: string;
+} | null>;
+/**
+ * List agent profiles for the tenant.
+ */
+export declare function listAgents(config: ClarkeConfig): Promise<any[]>;
+/**
+ * List active policies for the tenant.
+ */
+export declare function listPolicies(config: ClarkeConfig): Promise<any[]>;
+/**
+ * Send a query through the CLARKE broker for retrieval-augmented context.
+ *
+ * Returns the broker's answer (which includes grounded context from
+ * policies, decisions, docs, and episodic memory) plus the request_id
+ * for feedback submission.
+ */
+export declare function queryBroker(config: ClarkeConfig, message: string, sessionId?: string): Promise<{
+    answer: string;
+    requestId: string;
+    degradedMode: boolean;
+} | null>;
+/**
+ * Submit feedback on a CLARKE query response.
+ */
+export declare function submitFeedback(config: ClarkeConfig, requestId: string, accepted: boolean, notes?: string): Promise<void>;
+/**
+ * Build a concise greeting string for session start.
+ */
+export declare function fetchGreeting(config: ClarkeConfig): Promise<string>;
+//# sourceMappingURL=clarke-client.d.ts.map

package/dist/clarke-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clarke-client.d.ts","sourceRoot":"","sources":["../src/clarke-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAID;;;;;;GAMG;AACH,wBAAgB,aAAa,IAAI,YAAY,GAAG,IAAI,CAkBnD;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,YAAY,GAAG,IAAI,CAKrD;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,YAAY,CAAC,CA8BvB;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAmBxB;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAUrD;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAarE;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAYvE;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAAC,CAwB9E;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,OAAO,EACjB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAiBf;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CA0BzE"}

package/dist/clarke-client.js

@@ -0,0 +1,228 @@
+/**
+ * CLARKE API client for the OpenClaw plugin.
+ *
+ * Uses native fetch() — no dependencies. Reads config from environment
+ * variables or plugin configuration.
+ */
+let _config = null;
+/**
+ * Resolve CLARKE config from environment variables.
+ *
+ * If CLARKE_TENANT_ID and CLARKE_PROJECT_ID are set, uses them directly.
+ * Otherwise, auto-registers with the CLARKE backend using the workspace
+ * path to derive a project name (each workspace gets its own CLARKE project).
+ */
+export function resolveConfig() {
+    const endpoint = process.env.CLARKE_API_URL || process.env.CLARKE_ENDPOINT || "";
+    const agentSlug = process.env.CLARKE_AGENT_SLUG || "clarke-operator";
+    const workspace = process.env.OPENCLAW_WORKSPACE || process.cwd();
+    if (!endpoint)
+        return null;
+    let tenantId = process.env.CLARKE_TENANT_ID || "";
+    let projectId = process.env.CLARKE_PROJECT_ID || "";
+    // If IDs are pre-configured, use them
+    if (tenantId && projectId) {
+        return { endpoint, tenantId, projectId, agentSlug, workspace };
+    }
+    // Otherwise, we'll auto-register on first use (see ensureRegistered)
+    return { endpoint, tenantId, projectId, agentSlug, workspace };
+}
+/**
+ * Get or create the singleton CLARKE config.
+ */
+export function getClarkeConfig() {
+    if (!_config) {
+        _config = resolveConfig();
+    }
+    return _config;
+}
+/**
+ * Auto-register this workspace with CLARKE if tenant/project IDs aren't set.
+ *
+ * Calls POST /admin/setup with the workspace path as the project name.
+ * The endpoint is idempotent — same workspace path always returns the same IDs.
+ */
+export async function ensureRegistered(config) {
+    if (config.tenantId && config.projectId)
+        return config;
+    try {
+        // Derive a project name from the workspace path
+        const projectName = `openclaw:${config.workspace.replace(/\//g, ":")}`;
+        const resp = await fetch(`${config.endpoint}/admin/setup`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+                tenant_name: "openclaw",
+                project_name: projectName,
+            }),
+            signal: AbortSignal.timeout(10_000),
+        });
+        if (resp.ok) {
+            const data = (await resp.json());
+            config.tenantId = data.tenant_id;
+            config.projectId = data.project_id;
+        }
+    }
+    catch {
+        // Non-fatal — config will have empty IDs, API calls will fail gracefully
+    }
+    return config;
+}
+/**
+ * Fetch CLARKE session context as rendered markdown.
+ */
+export async function fetchSessionContext(config) {
+    try {
+        const resp = await fetch(`${config.endpoint}/agents/session-context`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+                tenant_id: config.tenantId,
+                project_id: config.projectId,
+                agent_slug: config.agentSlug,
+                format: "markdown",
+            }),
+            signal: AbortSignal.timeout(15_000),
+        });
+        if (!resp.ok)
+            return null;
+        return await resp.text();
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Fetch CLARKE health status.
+ */
+export async function fetchHealth(config) {
+    try {
+        const resp = await fetch(`${config.endpoint}/health`, {
+            signal: AbortSignal.timeout(5_000),
+        });
+        if (!resp.ok)
+            return null;
+        return (await resp.json());
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * List agent profiles for the tenant.
+ */
+export async function listAgents(config) {
+    try {
+        const url = new URL(`${config.endpoint}/agents/profiles`);
+        url.searchParams.set("tenant_id", config.tenantId);
+        url.searchParams.set("status", "active");
+        const resp = await fetch(url.toString(), {
+            signal: AbortSignal.timeout(5_000),
+        });
+        if (!resp.ok)
+            return [];
+        return (await resp.json());
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * List active policies for the tenant.
+ */
+export async function listPolicies(config) {
+    try {
+        const url = new URL(`${config.endpoint}/policy`);
+        url.searchParams.set("tenant_id", config.tenantId);
+        const resp = await fetch(url.toString(), {
+            signal: AbortSignal.timeout(5_000),
+        });
+        if (!resp.ok)
+            return [];
+        return (await resp.json());
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Send a query through the CLARKE broker for retrieval-augmented context.
+ *
+ * Returns the broker's answer (which includes grounded context from
+ * policies, decisions, docs, and episodic memory) plus the request_id
+ * for feedback submission.
+ */
+export async function queryBroker(config, message, sessionId) {
+    try {
+        const resp = await fetch(`${config.endpoint}/query`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+                tenant_id: config.tenantId,
+                project_id: config.projectId,
+                user_id: "openclaw-agent",
+                message,
+                session_id: sessionId,
+            }),
+            signal: AbortSignal.timeout(30_000),
+        });
+        if (!resp.ok)
+            return null;
+        const data = (await resp.json());
+        return {
+            answer: data.answer || "",
+            requestId: data.request_id || "",
+            degradedMode: data.degraded_mode || false,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Submit feedback on a CLARKE query response.
+ */
+export async function submitFeedback(config, requestId, accepted, notes) {
+    try {
+        await fetch(`${config.endpoint}/feedback`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+                request_id: requestId,
+                tenant_id: config.tenantId,
+                user_id: "openclaw-agent",
+                accepted,
+                notes,
+            }),
+            signal: AbortSignal.timeout(5_000),
+        });
+    }
+    catch {
+        // Best-effort, don't fail the interaction
+    }
+}
+/**
+ * Build a concise greeting string for session start.
+ */
+export async function fetchGreeting(config) {
+    const health = await fetchHealth(config);
+    if (!health) {
+        return "CLARKE is offline | start with: make dev";
+    }
+    const agents = await listAgents(config);
+    const policies = await listPolicies(config);
+    const parts = [`CLARKE is ${health.status}`];
+    const stats = [];
+    if (agents.length > 0) {
+        stats.push(`${agents.length} agent${agents.length !== 1 ? "s" : ""}`);
+    }
+    if (policies.length > 0) {
+        stats.push(`${policies.length} ${policies.length !== 1 ? "policies" : "policy"}`);
+    }
+    if (stats.length > 0) {
+        parts.push(stats.join(", "));
+    }
+    parts.push("/clarke for dashboard");
+    return parts.join(" | ");
+}
+//# sourceMappingURL=clarke-client.js.map

package/dist/clarke-client.js.map

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

package/dist/hooks/before-reply.d.ts

@@ -0,0 +1,17 @@
+/**
+ * before_agent_reply hook — augment user queries with CLARKE retrieval.
+ *
+ * Fires after the user message is received but before the LLM runs.
+ * Sends the user's message through CLARKE's broker which performs
+ * semantic search, reranking, and context composition against the
+ * user's specific query. The retrieved context is appended to the
+ * system prompt so the LLM has both:
+ *   1. Session-level context (from before_prompt_build — policies, skills, etc.)
+ *   2. Query-specific context (from this hook — relevant docs, decisions, memory)
+ *
+ * This is the RAG layer — it makes every user message retrieval-augmented.
+ */
+export declare function handleBeforeReply(event: any): Promise<{
+    appendSystemContext: string;
+} | undefined>;
+//# sourceMappingURL=before-reply.d.ts.map

package/dist/hooks/before-reply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"before-reply.d.ts","sourceRoot":"","sources":["../../src/hooks/before-reply.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,GAAG,GACT,OAAO,CAAC;IAAE,mBAAmB,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAAC,CAmCtD"}

package/dist/hooks/before-reply.js

@@ -0,0 +1,50 @@
+/**
+ * before_agent_reply hook — augment user queries with CLARKE retrieval.
+ *
+ * Fires after the user message is received but before the LLM runs.
+ * Sends the user's message through CLARKE's broker which performs
+ * semantic search, reranking, and context composition against the
+ * user's specific query. The retrieved context is appended to the
+ * system prompt so the LLM has both:
+ *   1. Session-level context (from before_prompt_build — policies, skills, etc.)
+ *   2. Query-specific context (from this hook — relevant docs, decisions, memory)
+ *
+ * This is the RAG layer — it makes every user message retrieval-augmented.
+ */
+import { getClarkeConfig, queryBroker } from "../clarke-client.js";
+import { lastQueryResult } from "../index.js";
+export async function handleBeforeReply(event) {
+    const config = getClarkeConfig();
+    if (!config)
+        return undefined;
+    // Extract the user's message from the event
+    const userMessage = event.message?.content || event.message?.text || "";
+    if (!userMessage || userMessage.length < 5)
+        return undefined;
+    // Skip CLARKE queries for slash commands (handled by skills/MCP)
+    if (userMessage.startsWith("/clarke"))
+        return undefined;
+    // Query the CLARKE broker for retrieval-augmented context
+    const result = await queryBroker(config, userMessage, event.sessionId);
+    if (!result || !result.answer)
+        return undefined;
+    // Store the result so llm_output can submit feedback
+    lastQueryResult.requestId = result.requestId;
+    lastQueryResult.query = userMessage;
+    // Build the augmented context block
+    const augmented = [
+        "\n\n<!-- CLARKE Query Context (retrieval-augmented) -->",
+        `The CLARKE broker retrieved the following context for this specific query.`,
+        `Use this alongside the session context above. Cite sources when referencing.`,
+        "",
+        result.answer,
+        result.degradedMode
+            ? "\n*Note: CLARKE is in degraded mode — some retrieval sources were unavailable.*"
+            : "",
+        "<!-- /CLARKE Query Context -->",
+    ]
+        .filter(Boolean)
+        .join("\n");
+    return { appendSystemContext: augmented };
+}
+//# sourceMappingURL=before-reply.js.map

package/dist/hooks/before-reply.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"before-reply.js","sourceRoot":"","sources":["../../src/hooks/before-reply.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,KAAU;IAEV,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;IACjC,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAE9B,4CAA4C;IAC5C,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,EAAE,OAAO,IAAI,KAAK,CAAC,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC;IACxE,IAAI,CAAC,WAAW,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAE7D,iEAAiE;IACjE,IAAI,WAAW,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,SAAS,CAAC;IAExD,0DAA0D;IAC1D,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IACvE,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAEhD,qDAAqD;IACrD,eAAe,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;IAC7C,eAAe,CAAC,KAAK,GAAG,WAAW,CAAC;IAEpC,oCAAoC;IACpC,MAAM,SAAS,GAAG;QAChB,yDAAyD;QACzD,4EAA4E;QAC5E,8EAA8E;QAC9E,EAAE;QACF,MAAM,CAAC,MAAM;QACb,MAAM,CAAC,YAAY;YACjB,CAAC,CAAC,iFAAiF;YACnF,CAAC,CAAC,EAAE;QACN,gCAAgC;KACjC;SACE,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO,EAAE,mBAAmB,EAAE,SAAS,EAAE,CAAC;AAC5C,CAAC"}

package/dist/hooks/bootstrap.d.ts

@@ -0,0 +1,9 @@
+/**
+ * agent:bootstrap hook — inject CLARKE identity into OpenClaw bootstrap files.
+ *
+ * Fires before workspace bootstrap files are injected into the system prompt.
+ * We add a lightweight AGENTS.md with CLARKE connection metadata so the agent
+ * knows CLARKE is active from the start.
+ */
+export declare function handleBootstrap(event: any): Promise<void>;
+//# sourceMappingURL=bootstrap.d.ts.map

package/dist/hooks/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../src/hooks/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,wBAAsB,eAAe,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAsC/D"}

package/dist/hooks/bootstrap.js

@@ -0,0 +1,47 @@
+/**
+ * agent:bootstrap hook — inject CLARKE identity into OpenClaw bootstrap files.
+ *
+ * Fires before workspace bootstrap files are injected into the system prompt.
+ * We add a lightweight AGENTS.md with CLARKE connection metadata so the agent
+ * knows CLARKE is active from the start.
+ */
+import { getClarkeConfig } from "../clarke-client.js";
+export async function handleBootstrap(event) {
+    const config = getClarkeConfig();
+    if (!config)
+        return;
+    const bootstrapContent = `# CLARKE-Managed Agent
+
+This agent's context is dynamically managed by CLARKE (Cognitive Learning
+Augmentation Retrieval Knowledge Engine). Policies, decisions, skills,
+and domain knowledge are injected into every prompt automatically via
+the before_prompt_build hook.
+
+## Available Commands
+- /clarke — system dashboard and status
+- /clarke-agent — manage agent profiles
+- /clarke-skill — author and ingest skills
+- /clarke-teach — record decisions, policies, corrections
+- /clarke-recall — query CLARKE memory
+- /clarke-review — approve self-improvement proposals
+- /clarke-ingest — feed documents into CLARKE
+- /clarke-configure — view and modify settings
+
+## How Context Works
+CLARKE injects context before every LLM call. You don't need to read
+files or query memory manually — relevant policies, decisions, skills,
+and domain knowledge are already in your system prompt. When sources
+conflict, follow the trust ordering: Policy > Decisions > Documents >
+Episodic Memory > Semantic Neighbors.
+
+## Learning Loop
+Every interaction builds CLARKE's memory. When users correct you, those
+corrections accumulate and may become behavioral directives. Encourage
+users to provide feedback — it directly improves future responses.
+`;
+    event.context?.bootstrapFiles?.push({
+        basename: "AGENTS.md",
+        content: bootstrapContent,
+    });
+}
+//# sourceMappingURL=bootstrap.js.map

package/dist/hooks/bootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../../src/hooks/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,KAAU;IAC9C,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;IACjC,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4B1B,CAAC;IAEA,KAAK,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,CAAC;QAClC,QAAQ,EAAE,WAAW;QACrB,OAAO,EAAE,gBAAgB;KAC1B,CAAC,CAAC;AACL,CAAC"}

package/dist/hooks/llm-output.d.ts

@@ -0,0 +1,13 @@
+/**
+ * llm_output hook — feed interactions back to CLARKE for learning.
+ *
+ * Fires after the LLM responds. Submits positive feedback to CLARKE
+ * so the learning loop can track which retrieval plans worked. This
+ * is fire-and-forget (parallel hook) — it never blocks the response.
+ *
+ * Combined with user corrections via /clarke-teach, this creates the
+ * full feedback loop: every interaction either reinforces or corrects
+ * CLARKE's retrieval patterns.
+ */
+export declare function handleLlmOutput(_event: any): Promise<void>;
+//# sourceMappingURL=llm-output.d.ts.map

package/dist/hooks/llm-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-output.d.ts","sourceRoot":"","sources":["../../src/hooks/llm-output.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,wBAAsB,eAAe,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBhE"}

package/dist/hooks/llm-output.js

@@ -0,0 +1,28 @@
+/**
+ * llm_output hook — feed interactions back to CLARKE for learning.
+ *
+ * Fires after the LLM responds. Submits positive feedback to CLARKE
+ * so the learning loop can track which retrieval plans worked. This
+ * is fire-and-forget (parallel hook) — it never blocks the response.
+ *
+ * Combined with user corrections via /clarke-teach, this creates the
+ * full feedback loop: every interaction either reinforces or corrects
+ * CLARKE's retrieval patterns.
+ */
+import { getClarkeConfig, submitFeedback } from "../clarke-client.js";
+import { lastQueryResult } from "../index.js";
+export async function handleLlmOutput(_event) {
+    const config = getClarkeConfig();
+    if (!config)
+        return;
+    // If we queried CLARKE for this interaction, submit implicit positive feedback
+    // (the user didn't correct it, so it was presumably acceptable)
+    const { requestId } = lastQueryResult;
+    if (requestId) {
+        await submitFeedback(config, requestId, true, "Implicit positive — user did not correct the response.");
+        // Clear for next interaction
+        lastQueryResult.requestId = "";
+        lastQueryResult.query = "";
+    }
+}
+//# sourceMappingURL=llm-output.js.map

package/dist/hooks/llm-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-output.js","sourceRoot":"","sources":["../../src/hooks/llm-output.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAAW;IAC/C,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;IACjC,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,+EAA+E;IAC/E,gEAAgE;IAChE,MAAM,EAAE,SAAS,EAAE,GAAG,eAAe,CAAC;IACtC,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,cAAc,CAClB,MAAM,EACN,SAAS,EACT,IAAI,EACJ,wDAAwD,CACzD,CAAC;QAEF,6BAA6B;QAC7B,eAAe,CAAC,SAAS,GAAG,EAAE,CAAC;QAC/B,eAAe,CAAC,KAAK,GAAG,EAAE,CAAC;IAC7B,CAAC;AACH,CAAC"}