@sage-protocol/openclaw-sage 0.1.9 → 0.1.10

package/README.md

@@ -6,14 +6,14 @@ MCP bridge plugin that exposes Sage Protocol tools inside OpenClaw via Code Mode
 
 - **Code Mode Gateway** - Spawns `sage mcp start` and routes plugin calls through `sage_search`/`sage_execute`/`sage_status`
 - **Agent Profile (Identity Context)** - Injects wallet, active libraries, and skill counts into every turn so the agent knows who it's working for
-- **Auto-Context Injection** - Injects Sage tool context and skill suggestions via `before_prompt_build` (stable context cacheable by providers) with `before_agent_start` legacy fallback
+- **Auto-Context Injection** - Injects Sage tool context and skill suggestions via `before_prompt_build` with stable context cached separately from per-turn dynamic context
 - **Injection Guard** - Optional prompt-injection scanning on outgoing `sage_execute` mutations
 - **Crash Recovery** - Automatically restarts the MCP subprocess on unexpected exits
 - **External Servers** - Sage internal tools are available immediately; only external MCP tools require starting servers first via the Sage app, CLI, or raw MCP `hub_*` tools
 
 ## Agent Profile (Identity Context)
 
-Every OpenClaw session automatically gets Sage Protocol identity context injected via the `before_prompt_build` hook (with `before_agent_start` legacy fallback). Stable context (protocol description, identity, tool docs) goes in `prependSystemContext` so providers can cache it across turns. Dynamic content (skill suggestions, security guard) goes in `prependContext` and refreshes each turn.
+Every OpenClaw session automatically gets Sage Protocol identity context injected via the `before_prompt_build` hook. Stable context (protocol description, identity, tool docs) goes in `prependSystemContext` so providers can cache it across turns. Dynamic content (skill suggestions, security guard) goes in `prependContext` and refreshes each turn.
 
 Example of what gets injected:
 
@@ -52,6 +52,9 @@ openclaw plugins install @sage-protocol/openclaw-sage
 
 After install, **restart the Gateway** for the plugin to take effect.
 
+CI validates the packed tarball against the latest published `openclaw` CLI by running
+`npx openclaw@latest plugins install` in an isolated `OPENCLAW_HOME`.
+
 ### Verify
 
 ```bash
@@ -159,7 +162,7 @@ sage bounties create --mode direct --assignee 0x... --title "Task" --description
 
 ### Auto-Inject / Auto-Suggest
 
-This plugin uses OpenClaw's plugin hook API to inject context at the start of each agent run (`before_agent_start`).
+This plugin uses OpenClaw's plugin hook API to inject context at the start of each prompt build via `before_prompt_build`.
 
 Available config fields:
 

package/dist/index.d.ts

@@ -0,0 +1,79 @@
+import { type TSchema } from "@sinclair/typebox";
+/**
+ * Minimal type stubs for OpenClaw plugin API.
+ *
+ * OpenClaw's jiti runtime resolves "openclaw/plugin-sdk" at load time.
+ * These stubs keep the code compilable standalone.
+ */
+type PluginLogger = {
+    info: (msg: string) => void;
+    warn: (msg: string) => void;
+    error: (msg: string) => void;
+};
+type PluginServiceContext = {
+    config: unknown;
+    workspaceDir?: string;
+    stateDir: string;
+    logger: PluginLogger;
+};
+type PluginApi = {
+    id: string;
+    name: string;
+    logger: PluginLogger;
+    pluginConfig?: Record<string, unknown>;
+    registerTool: (tool: unknown, opts?: {
+        name?: string;
+        optional?: boolean;
+    }) => void;
+    registerService: (service: {
+        id: string;
+        start: (ctx: PluginServiceContext) => void | Promise<void>;
+        stop?: (ctx: PluginServiceContext) => void | Promise<void>;
+    }) => void;
+    on: (hook: string, handler: (...args: unknown[]) => unknown | Promise<unknown>, opts?: {
+        priority?: number;
+    }) => void;
+};
+declare function normalizePrompt(prompt: string, opts?: {
+    maxBytes?: number;
+}): string;
+declare function extractJsonFromMcpResult(result: unknown): unknown;
+type SkillSearchResult = {
+    key?: string;
+    name?: string;
+    description?: string;
+    source?: string;
+    library?: string;
+    mcpServers?: string[];
+};
+declare function formatSkillSuggestions(results: SkillSearchResult[], limit: number): string;
+/**
+ * Convert a single MCP JSON Schema property into a TypeBox type.
+ * Handles nested objects, typed arrays, and enums.
+ */
+declare function jsonSchemaToTypebox(prop: Record<string, unknown>): TSchema;
+/**
+ * Convert an MCP JSON Schema inputSchema into a TypeBox object schema
+ * that OpenClaw's tool system accepts.
+ */
+declare function mcpSchemaToTypebox(inputSchema?: Record<string, unknown>): import("@sinclair/typebox").TObject<{}>;
+declare const plugin: {
+    id: string;
+    name: string;
+    version: string;
+    description: string;
+    register(api: PluginApi): void;
+};
+/** Map common error patterns to actionable hints */
+declare function enrichErrorMessage(err: Error, toolName: string): string;
+export default plugin;
+export declare const __test: {
+    PKG_VERSION: string;
+    SAGE_CONTEXT: string;
+    normalizePrompt: typeof normalizePrompt;
+    extractJsonFromMcpResult: typeof extractJsonFromMcpResult;
+    formatSkillSuggestions: typeof formatSkillSuggestions;
+    mcpSchemaToTypebox: typeof mcpSchemaToTypebox;
+    jsonSchemaToTypebox: typeof jsonSchemaToTypebox;
+    enrichErrorMessage: typeof enrichErrorMessage;
+};