@clawtrail/context-graph-openclaw 0.1.0 → 0.3.0

package/dist/index.d.ts

@@ -27,4 +27,5 @@ export type { StatusResult } from './tools/status.js';
 export { summarizeSession } from './tools/summarize.js';
 export type { SummarizeResult } from './tools/summarize.js';
 export { hashArgs, hashCommand, hashFileContent, extractBaseCommand, mimeFromExtension, extensionToLanguage } from './util/hash.js';
+export { default as register } from './register.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG5E,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvD,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,YAAY,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,YAAY,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAGhE,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,YAAY,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACnF,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGzD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,mBAAmB,EAAE,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAGjK,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG5D,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG5E,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvD,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,YAAY,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,YAAY,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAGhE,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,YAAY,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACnF,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGzD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,mBAAmB,EAAE,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAGjK,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG5D,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAGpI,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -26,4 +26,6 @@ export { getStatus } from './tools/status.js';
 export { summarizeSession } from './tools/summarize.js';
 // Utilities
 export { hashArgs, hashCommand, hashFileContent, extractBaseCommand, mimeFromExtension, extensionToLanguage } from './util/hash.js';
+// OpenClaw Plugin Entry Point
+export { default as register } from './register.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,UAAU;AACV,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvD,UAAU;AACV,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,YAAY;AACZ,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAE3D,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAG7D,QAAQ;AACR,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAG7D,QAAQ;AACR,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,mBAAmB,EAAE,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAEjK,QAAQ;AACR,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAGxD,YAAY;AACZ,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,UAAU;AACV,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvD,UAAU;AACV,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,YAAY;AACZ,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAE3D,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAG7D,QAAQ;AACR,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAG7D,QAAQ;AACR,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,mBAAmB,EAAE,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAEjK,QAAQ;AACR,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAGxD,YAAY;AACZ,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAEpI,8BAA8B;AAC9B,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,eAAe,CAAC"}

package/dist/register.d.ts

@@ -0,0 +1,35 @@
+/** Hook event names as defined in OpenClaw's PluginHookName type */
+type HookName = 'message_received' | 'tool_result_persist' | 'after_tool_call' | 'session_start' | 'session_end' | 'before_reset' | 'agent_end' | 'gateway_stop';
+interface PluginApi {
+    config?: {
+        plugins?: {
+            entries?: Record<string, {
+                enabled?: boolean;
+                config?: Record<string, unknown>;
+            }>;
+        };
+    };
+    logger?: {
+        info(...args: unknown[]): void;
+        warn(...args: unknown[]): void;
+        error(...args: unknown[]): void;
+    };
+    /** Legacy hook registration — requires config.hooks.internal.enabled */
+    registerHook?(eventName: string, handler: (event: Record<string, unknown>) => Promise<void> | void, meta?: {
+        name?: string;
+        description?: string;
+    }): void;
+    /** Typed hook registration — always active (OpenClaw 2026.2+) */
+    on?(hookName: HookName, handler: (...args: unknown[]) => Promise<void> | void, opts?: {
+        priority?: number;
+    }): void;
+    registerTool?(tool: {
+        name: string;
+        description: string;
+        parameters: Record<string, unknown>;
+        handler: (params: Record<string, unknown>, ctx: Record<string, unknown>) => Promise<unknown>;
+    }): void;
+}
+export default function register(api: PluginApi): void;
+export {};
+//# sourceMappingURL=register.d.ts.map

package/dist/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAaA,oEAAoE;AACpE,KAAK,QAAQ,GACT,kBAAkB,GAClB,qBAAqB,GACrB,iBAAiB,GACjB,eAAe,GACf,aAAa,GACb,cAAc,GACd,WAAW,GACX,cAAc,CAAC;AAEnB,UAAU,SAAS;IACjB,MAAM,CAAC,EAAE;QACP,OAAO,CAAC,EAAE;YACR,OAAO,CAAC,EAAE,MAAM,CACd,MAAM,EACN;gBAAE,OAAO,CAAC,EAAE,OAAO,CAAC;gBAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;aAAE,CACxD,CAAC;SACH,CAAC;KACH,CAAC;IACF,MAAM,CAAC,EAAE;QACP,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAC/B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAC/B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;KACjC,CAAC;IACF,wEAAwE;IACxE,YAAY,CAAC,CACX,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,EACjE,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAC7C,IAAI,CAAC;IACR,iEAAiE;IACjE,EAAE,CAAC,CACD,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,EACrD,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3B,IAAI,CAAC;IACR,YAAY,CAAC,CAAC,IAAI,EAAE;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,OAAO,EAAE,CACP,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KACzB,OAAO,CAAC,OAAO,CAAC,CAAC;KACvB,GAAG,IAAI,CAAC;CACV;AA2GD,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,CA4LrD"}

package/dist/register.js

@@ -0,0 +1,223 @@
+/**
+ * OpenClaw Plugin Entry Point
+ *
+ * Wires the context-graph adapter into OpenClaw's hook-based plugin system.
+ * Registers hooks for session lifecycle approximation and tool call capture,
+ * and optionally auto-submits signed provenance to the ClawTrail API.
+ */
+import { OpenClawAdapter } from './OpenClawAdapter.js';
+// ── Helpers ──────────────────────────────────────────────────────────
+const TAG = '[context-graph]';
+function log(api, level, ...args) {
+    if (api.logger?.[level]) {
+        api.logger[level](TAG, ...args);
+    }
+    else {
+        console[level](TAG, ...args);
+    }
+}
+function createSessionContext(sessionKey, initialMessage, agentId) {
+    const store = new Map();
+    return {
+        sessionKey,
+        initialMessage,
+        agentId,
+        set: (key, value) => store.set(key, value),
+        get: (key) => store.get(key),
+    };
+}
+// ── Auto-submit to ClawTrail API ────────────────────────────────────
+async function submitToClawTrail(adapter, sessionId, submitUrl, apiKey, api) {
+    const MAX_RETRIES = 1;
+    const RETRY_DELAY = 2000;
+    for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
+        try {
+            const { signed } = await adapter.summarizeAndSign(sessionId);
+            if (!signed) {
+                log(api, 'warn', 'No signed submission produced — skipping auto-submit');
+                return;
+            }
+            const response = await fetch(submitUrl, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    Authorization: `Bearer ${apiKey}`,
+                },
+                body: JSON.stringify(signed),
+                signal: AbortSignal.timeout(30_000),
+            });
+            if (response.ok) {
+                const result = (await response.json());
+                log(api, 'info', `Submitted session ${sessionId}:`, `submissionId=${result.submissionId},`, `claims=${result.claimsExtracted}`);
+                return;
+            }
+            const errorBody = await response.text().catch(() => '');
+            log(api, 'warn', `Submit failed (HTTP ${response.status}):`, errorBody.slice(0, 200));
+            // Don't retry client errors (bad request, auth failure, etc.)
+            if (response.status >= 400 && response.status < 500)
+                return;
+        }
+        catch (err) {
+            log(api, 'warn', `Submit error (attempt ${attempt + 1}):`, err instanceof Error ? err.message : String(err));
+        }
+        if (attempt < MAX_RETRIES) {
+            await new Promise((r) => setTimeout(r, RETRY_DELAY));
+        }
+    }
+}
+// ── Plugin Register Function ────────────────────────────────────────
+export default function register(api) {
+    // 1. Read config
+    const pluginEntry = api.config?.plugins?.entries?.['context-graph'];
+    const cfg = (pluginEntry?.config ?? {});
+    if (cfg.enabled === false)
+        return;
+    // 2. Create adapter
+    const adapter = new OpenClawAdapter({
+        enabled: true,
+        contextGraphRoot: cfg.contextGraphRoot ?? '.context-graph',
+        agentId: cfg.agentId,
+        policyPath: cfg.policyPath,
+        detectTests: cfg.detectTests ?? true,
+        detectBuilds: cfg.detectBuilds ?? true,
+        signingKeyPath: cfg.signingKeyPath,
+    });
+    // 3. Session map — keyed by OpenClaw sessionKey
+    const sessions = new Map();
+    // Helper: end session and optionally submit
+    async function endSessionAndSubmit(sessionKey) {
+        const state = sessions.get(sessionKey);
+        if (!state)
+            return;
+        try {
+            await adapter.onSessionEnd(state.ctx);
+            const submitUrl = cfg.submitUrl;
+            const apiKey = cfg.apiKey;
+            const autoSubmit = cfg.autoSubmit !== false; // default true
+            if (autoSubmit && submitUrl && apiKey) {
+                await submitToClawTrail(adapter, state.sessionId, submitUrl, apiKey, api);
+            }
+        }
+        catch (err) {
+            log(api, 'error', 'Error ending session:', err);
+        }
+        finally {
+            sessions.delete(sessionKey);
+        }
+    }
+    // ── Require api.on() — the typed hook API (OpenClaw 2026.2+) ───────
+    if (typeof api.on !== 'function') {
+        log(api, 'warn', 'api.on() not available — hooks will not fire. Upgrade OpenClaw to 2026.2+');
+        return;
+    }
+    const on = api.on; // bind for TS narrowing
+    // ── Hook: message_received → lazy session start ───────────────────
+    on('message_received', async (...args) => {
+        try {
+            const event = (args[0] ?? {});
+            const ctx2 = (args[1] ?? {});
+            const key = ctx2.sessionKey || event.sessionKey || 'default';
+            if (sessions.has(key))
+                return;
+            const msg = event.content ||
+                event.text ||
+                'session';
+            const ctx = createSessionContext(key, msg, cfg.agentId);
+            const session = await adapter.onSessionStart(ctx);
+            sessions.set(key, {
+                ctx,
+                sessionId: session.meta.session_id,
+                startedAt: Date.now(),
+            });
+            log(api, 'info', `Session started: ${session.meta.session_id}`);
+        }
+        catch (err) {
+            log(api, 'warn', 'Failed to start session:', err);
+        }
+    });
+    // ── Hook: tool_result_persist → capture tool call ─────────────────
+    on('tool_result_persist', async (...args) => {
+        try {
+            const event = (args[0] ?? {});
+            const ctx2 = (args[1] ?? {});
+            const key = ctx2.sessionKey || event.sessionKey || 'default';
+            const state = sessions.get(key);
+            if (!state)
+                return;
+            // Defensively read tool info from multiple possible paths
+            const context = event.context;
+            const toolName = (context?.toolName ??
+                event.toolName ??
+                'unknown');
+            const params = (context?.params ??
+                event.params ??
+                {});
+            const result = (context?.result ??
+                event.result ??
+                {});
+            const durationMs = (context?.durationMs ??
+                event.durationMs);
+            const error = event.error
+                ? event.error instanceof Error
+                    ? event.error
+                    : new Error(String(event.error))
+                : undefined;
+            const toolEvent = {
+                toolName,
+                params,
+                result,
+                error,
+                durationMs,
+            };
+            await adapter.onAfterToolCall(toolEvent, state.ctx);
+        }
+        catch (err) {
+            log(api, 'warn', 'Failed to capture tool result:', err);
+        }
+    });
+    // ── Hooks: session_end, before_reset, agent_end → end session ─────
+    for (const hookName of ['session_end', 'before_reset', 'agent_end']) {
+        on(hookName, async (...args) => {
+            const event = (args[0] ?? {});
+            const ctx2 = (args[1] ?? {});
+            const key = ctx2.sessionKey || event.sessionKey || 'default';
+            await endSessionAndSubmit(key);
+        });
+    }
+    // ── Agent tools (optional — depends on api.registerTool) ──────────
+    if (typeof api.registerTool === 'function') {
+        api.registerTool({
+            name: 'context_graph_status',
+            description: 'Check current context graph session status, event count, and capture health.',
+            parameters: { type: 'object', properties: {} },
+            handler: async (_params, ctx) => {
+                const key = ctx.sessionKey || 'default';
+                const state = sessions.get(key);
+                return adapter.getStatus(state?.sessionId);
+            },
+        });
+        api.registerTool({
+            name: 'context_graph_summarize',
+            description: 'Generate metrics and derived claims for the current session.',
+            parameters: { type: 'object', properties: {} },
+            handler: async (_params, ctx) => {
+                const key = ctx.sessionKey || 'default';
+                const state = sessions.get(key);
+                if (!state)
+                    return { status: 'no_active_session' };
+                const { summary, signed } = await adapter.summarizeAndSign(state.sessionId);
+                return {
+                    ...summary,
+                    signed: signed
+                        ? {
+                            payloadHash: signed.payloadHash,
+                            agentId: signed.agentId,
+                        }
+                        : undefined,
+                };
+            },
+        });
+    }
+    log(api, 'info', 'Plugin registered — provenance capture active');
+}
+//# sourceMappingURL=register.js.map

package/dist/register.js.map

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

package/openclaw.plugin.json

@@ -0,0 +1,49 @@
+{
+  "id": "context-graph",
+  "name": "Context Graph — Verifiable Agent Provenance",
+  "version": "0.3.0",
+  "description": "Captures agent execution traces as PROV-O context graphs with hash chain integrity and signed submissions.",
+  "configSchema": {
+    "type": "object",
+    "properties": {
+      "enabled": { "type": "boolean", "default": true },
+      "autoCapture": { "type": "boolean", "default": true },
+      "policyPath": { "type": "string" },
+      "agentId": { "type": "string" },
+      "contextGraphRoot": {
+        "type": "string",
+        "default": ".context-graph",
+        "description": "Path to context-graph storage directory"
+      },
+      "detectTests": { "type": "boolean", "default": true },
+      "detectBuilds": { "type": "boolean", "default": true },
+      "signingKeyPath": {
+        "type": "string",
+        "description": "Path to Ed25519 signing key (auto-generated if missing)"
+      },
+      "submitUrl": {
+        "type": "string",
+        "description": "ClawTrail API endpoint for submitting signed context graphs"
+      },
+      "apiKey": {
+        "type": "string",
+        "description": "ClawTrail agent API key for authentication"
+      },
+      "autoSubmit": {
+        "type": "boolean",
+        "default": true,
+        "description": "Automatically submit signed context graph after each session ends"
+      },
+      "environment": {
+        "type": "string",
+        "enum": ["staging", "production"],
+        "default": "production",
+        "description": "ClawTrail environment"
+      }
+    }
+  },
+  "uiHints": {
+    "apiKey": { "label": "ClawTrail API Key", "sensitive": true }
+  },
+  "skills": ["skills"]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clawtrail/context-graph-openclaw",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "OpenClaw adapter for @clawtrail/context-graph — captures agent execution traces as PROV-O events",
   "type": "module",
   "main": "dist/index.js",
@@ -9,8 +9,15 @@
     ".": {
       "import": "./dist/index.js",
       "types": "./dist/index.d.ts"
+    },
+    "./register": {
+      "import": "./dist/register.js",
+      "types": "./dist/register.d.ts"
     }
   },
+  "openclaw": {
+    "extensions": ["./dist/register.js"]
+  },
   "scripts": {
     "build": "tsc",
     "dev": "tsc --watch",
@@ -28,7 +35,9 @@
   ],
   "license": "MIT",
   "files": [
-    "dist"
+    "dist",
+    "openclaw.plugin.json",
+    "skills"
   ],
   "engines": {
     "node": ">=20"

package/skills/context-graph/SKILL.md

@@ -0,0 +1,32 @@
+---
+name: context-graph
+description: Verifiable provenance tracking for your agent work sessions
+user-invocable: true
+---
+
+# Context Graph — Verifiable Provenance
+
+You have Context Graph installed. It automatically captures your tool calls
+into a local, tamper-evident provenance graph.
+
+## What It Does
+
+- Every tool call you make (file reads/writes, shell commands, git operations)
+  is recorded as a PROV-O event with a hash chain.
+- Test runs and builds are automatically detected and tracked with pass/fail metrics.
+- At session end, claims are derived from your work (e.g., "CanFixBuild", "CanRunTests").
+- All data is local by default. Nothing leaves the machine without explicit action.
+- Submissions are signed with Ed25519 for non-repudiation.
+
+## Available Tools
+
+- `context-graph.status`: Check current session status, event count, and capture health.
+- `context-graph.summarize`: Generate metrics and claims for the current session.
+
+## Guidelines
+
+- Context Graph captures your tool calls automatically. No action needed from you.
+- When the user asks about your work history or session progress, use `context-graph.status`.
+- When the user asks for a summary of your work, use `context-graph.summarize`.
+- Never include raw code, secrets, or file contents in notes. Redaction is handled automatically.
+- Privacy: file contents are never logged. Diffs and commands are hashed, not stored.