@troykelly/openclaw-projects 0.0.1

package/dist/tools/todos.js.map

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

package/dist/types/openclaw-api.d.ts

@@ -0,0 +1,215 @@
+/**
+ * OpenClaw Plugin API types.
+ *
+ * These types define the contract between plugins and the OpenClaw Gateway runtime.
+ * Based on OpenClaw 2026 plugin architecture.
+ *
+ * Reference: docs/knowledge/openclaw-hook-contract.md
+ */
+import type { Logger } from '../logger.js';
+/** JSON Schema for tool parameters */
+export interface JSONSchema {
+    type: 'object' | 'string' | 'number' | 'integer' | 'boolean' | 'array' | 'null';
+    properties?: Record<string, JSONSchemaProperty>;
+    required?: string[];
+    additionalProperties?: boolean | JSONSchema;
+    description?: string;
+    default?: unknown;
+}
+export interface JSONSchemaProperty {
+    type: 'object' | 'string' | 'number' | 'integer' | 'boolean' | 'array' | 'null';
+    description?: string;
+    default?: unknown;
+    enum?: string[];
+    minimum?: number;
+    maximum?: number;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    items?: JSONSchema | JSONSchemaProperty;
+    properties?: Record<string, JSONSchemaProperty>;
+    required?: string[];
+    format?: string;
+}
+/** Tool execution context */
+export interface ToolContext {
+    userId?: string;
+    agentId?: string;
+    sessionId?: string;
+    requestId?: string;
+}
+/** Tool execution result (internal format used by handlers) */
+export interface ToolResult {
+    success: boolean;
+    data?: {
+        content: string;
+        details?: Record<string, unknown>;
+    };
+    error?: string;
+}
+/**
+ * AgentToolResult - The format OpenClaw Gateway expects from tool execute functions.
+ * This is the standard return type for all tool executions.
+ */
+export interface AgentToolResult {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}
+/**
+ * Tool execute function signature as expected by OpenClaw Gateway.
+ *
+ * @param toolCallId - Unique identifier for this tool call
+ * @param params - Tool parameters (validated against JSON Schema)
+ * @param signal - Optional AbortSignal for cancellation
+ * @param onUpdate - Optional callback for streaming partial results
+ */
+export type AgentToolExecute<T = Record<string, unknown>> = (toolCallId: string, params: T, signal?: AbortSignal, onUpdate?: (partial: unknown) => void) => Promise<AgentToolResult>;
+/** Tool definition for api.registerTool() */
+export interface ToolDefinition {
+    /** Tool name (snake_case) */
+    name: string;
+    /** Human-readable description shown to agents */
+    description: string;
+    /** JSON Schema for tool parameters */
+    parameters: JSONSchema;
+    /** Tool execution function (OpenClaw Gateway signature) */
+    execute: AgentToolExecute;
+}
+/**
+ * Hook names using the actual OpenClaw snake_case convention.
+ * Preferred over legacy camelCase names.
+ */
+export type PluginHookName = 'before_agent_start' | 'agent_end' | 'before_compaction' | 'after_compaction' | 'message_received' | 'message_sending' | 'message_sent' | 'before_tool_call' | 'after_tool_call' | 'tool_result_persist' | 'session_start' | 'session_end' | 'gateway_start' | 'gateway_stop';
+/** Event payload for before_agent_start hook */
+export interface PluginHookBeforeAgentStartEvent {
+    /** The user's actual prompt text */
+    prompt: string;
+    /** Previous conversation messages (optional) */
+    messages?: unknown[];
+}
+/** Context passed as second argument to hook handlers */
+export interface PluginHookAgentContext {
+    agentId?: string;
+    sessionKey?: string;
+    workspaceDir?: string;
+    messageProvider?: string;
+}
+/** Return value from before_agent_start hook */
+export interface PluginHookBeforeAgentStartResult {
+    /** Append to the system prompt */
+    systemPrompt?: string;
+    /** Prepend to conversation context */
+    prependContext?: string;
+}
+/** Event payload for agent_end hook */
+export interface PluginHookAgentEndEvent {
+    /** Full conversation messages */
+    messages: unknown[];
+    /** Whether the agent completed successfully */
+    success: boolean;
+    /** Error message if the agent failed */
+    error?: string;
+    /** Duration of the agent run in milliseconds */
+    durationMs?: number;
+}
+/** Legacy hook event types (camelCase) */
+export type HookEvent = 'beforeAgentStart' | 'afterAgentStart' | 'beforeAgentEnd' | 'agentEnd' | 'beforeToolCall' | 'afterToolCall' | 'messageReceived' | 'messageSent';
+/** Legacy hook handler function */
+export type HookHandler<T = unknown> = (event: T) => Promise<T | null | void>;
+/** CLI registration callback */
+export interface CliRegistrationContext {
+    /** Commander program instance */
+    program: {
+        command: (name: string) => {
+            description: (desc: string) => {
+                option: (flags: string, desc: string) => unknown;
+                action: (handler: (...args: unknown[]) => void | Promise<void>) => unknown;
+            };
+        };
+    };
+}
+export type CliRegistrationCallback = (context: CliRegistrationContext) => void;
+/** Service definition for background processes */
+export interface ServiceDefinition {
+    /** Unique service ID */
+    id: string;
+    /** Called when plugin starts */
+    start: () => Promise<void>;
+    /** Called when plugin stops */
+    stop: () => Promise<void>;
+}
+/** OpenClaw Plugin API provided to plugins */
+export interface OpenClawPluginApi {
+    /** Current plugin configuration (validated against configSchema) */
+    config: Record<string, unknown>;
+    /** Logger instance */
+    logger: Logger;
+    /** Plugin ID */
+    pluginId: string;
+    /** Runtime utilities */
+    runtime?: {
+        tts?: {
+            textToSpeechTelephony: (text: string, options?: {
+                voice?: string;
+            }) => Promise<{
+                pcm: Buffer;
+                sampleRate: number;
+            }>;
+        };
+    };
+    /**
+     * Register a tool with the OpenClaw Gateway.
+     * Tools are exposed to agents for execution.
+     */
+    registerTool: (tool: ToolDefinition) => void;
+    /**
+     * Register a lifecycle hook using the modern api.on() method.
+     * Preferred over registerHook(). Uses snake_case hook names.
+     *
+     * @example
+     * api.on('before_agent_start', async (event, ctx) => {
+     *   return { prependContext: 'some context' }
+     * })
+     */
+    on?: <K extends PluginHookName>(hookName: K, handler: (...args: unknown[]) => unknown, opts?: {
+        priority?: number;
+    }) => void;
+    /**
+     * Register a lifecycle hook (legacy method).
+     * Hooks allow intercepting and modifying plugin/agent lifecycle events.
+     *
+     * @deprecated Use api.on() for modern hook registration with proper typing.
+     */
+    registerHook: <T = unknown>(event: HookEvent, handler: HookHandler<T>) => void;
+    /**
+     * Register CLI commands.
+     * Commands are available via `openclaw <plugin-id> <command>`.
+     */
+    registerCli: (callback: CliRegistrationCallback) => void;
+    /**
+     * Register a background service.
+     * Services are started when the plugin loads and stopped when it unloads.
+     */
+    registerService: (service: ServiceDefinition) => void;
+    /**
+     * Register an RPC method for the Gateway.
+     * Methods are exposed as `pluginId.methodName`.
+     */
+    registerGatewayMethod: <T = unknown, R = unknown>(methodName: string, handler: (params: T) => Promise<R>) => void;
+}
+/** Plugin initialization function signature */
+export type PluginInitializer = (api: OpenClawPluginApi) => void | Promise<void>;
+/** Object-based plugin definition (alternative to function export) */
+export interface PluginDefinition {
+    id: string;
+    name: string;
+    configSchema?: JSONSchema;
+    register: PluginInitializer;
+}
+/**
+ * @deprecated Use OpenClawPluginApi instead. This alias is for backwards compatibility only.
+ */
+export type OpenClawPluginAPI = OpenClawPluginApi;
+//# sourceMappingURL=openclaw-api.d.ts.map

package/dist/types/openclaw-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openclaw-api.d.ts","sourceRoot":"","sources":["../../src/types/openclaw-api.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAE1C,sCAAsC;AACtC,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAA;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAA;IAC/C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,oBAAoB,CAAC,EAAE,OAAO,GAAG,UAAU,CAAA;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAA;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,UAAU,GAAG,kBAAkB,CAAA;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAA;IAC/C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,6BAA6B;AAC7B,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,+DAA+D;AAC/D,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,CAAC,EAAE;QACL,OAAO,EAAE,MAAM,CAAA;QACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAClC,CAAA;IACD,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAC/C;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAC1D,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,CAAC,EACT,MAAM,CAAC,EAAE,WAAW,EACpB,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,KAClC,OAAO,CAAC,eAAe,CAAC,CAAA;AAE7B,6CAA6C;AAC7C,MAAM,WAAW,cAAc;IAC7B,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAA;IACnB,sCAAsC;IACtC,UAAU,EAAE,UAAU,CAAA;IACtB,2DAA2D;IAC3D,OAAO,EAAE,gBAAgB,CAAA;CAC1B;AAMD;;;GAGG;AACH,MAAM,MAAM,cAAc,GACtB,oBAAoB,GACpB,WAAW,GACX,mBAAmB,GACnB,kBAAkB,GAClB,kBAAkB,GAClB,iBAAiB,GACjB,cAAc,GACd,kBAAkB,GAClB,iBAAiB,GACjB,qBAAqB,GACrB,eAAe,GACf,aAAa,GACb,eAAe,GACf,cAAc,CAAA;AAElB,gDAAgD;AAChD,MAAM,WAAW,+BAA+B;IAC9C,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAA;IACd,gDAAgD;IAChD,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAA;CACrB;AAED,yDAAyD;AACzD,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,gDAAgD;AAChD,MAAM,WAAW,gCAAgC;IAC/C,kCAAkC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,sCAAsC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,uCAAuC;AACvC,MAAM,WAAW,uBAAuB;IACtC,iCAAiC;IACjC,QAAQ,EAAE,OAAO,EAAE,CAAA;IACnB,+CAA+C;IAC/C,OAAO,EAAE,OAAO,CAAA;IAChB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAID,0CAA0C;AAC1C,MAAM,MAAM,SAAS,GACjB,kBAAkB,GAClB,iBAAiB,GACjB,gBAAgB,GAChB,UAAU,GACV,gBAAgB,GAChB,eAAe,GACf,iBAAiB,GACjB,aAAa,CAAA;AAEjB,mCAAmC;AACnC,MAAM,MAAM,WAAW,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,CAAA;AAE7E,gCAAgC;AAChC,MAAM,WAAW,sBAAsB;IACrC,iCAAiC;IACjC,OAAO,EAAE;QACP,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK;YACzB,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK;gBAC7B,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAA;gBAChD,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO,CAAA;aAC3E,CAAA;SACF,CAAA;KACF,CAAA;CACF;AAED,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,EAAE,sBAAsB,KAAK,IAAI,CAAA;AAE/E,kDAAkD;AAClD,MAAM,WAAW,iBAAiB;IAChC,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,gCAAgC;IAChC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1B,+BAA+B;IAC/B,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1B;AAED,8CAA8C;AAC9C,MAAM,WAAW,iBAAiB;IAChC,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAE/B,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAA;IAEd,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAA;IAEhB,wBAAwB;IACxB,OAAO,CAAC,EAAE;QACR,GAAG,CAAC,EAAE;YACJ,qBAAqB,EAAE,CACrB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;gBAAE,KAAK,CAAC,EAAE,MAAM,CAAA;aAAE,KACzB,OAAO,CAAC;gBAAE,GAAG,EAAE,MAAM,CAAC;gBAAC,UAAU,EAAE,MAAM,CAAA;aAAE,CAAC,CAAA;SAClD,CAAA;KACF,CAAA;IAED;;;OAGG;IACH,YAAY,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,IAAI,CAAA;IAE5C;;;;;;;;OAQG;IACH,EAAE,CAAC,EAAE,CAAC,CAAC,SAAS,cAAc,EAC5B,QAAQ,EAAE,CAAC,EACX,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EACxC,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,KACzB,IAAI,CAAA;IAET;;;;;OAKG;IACH,YAAY,EAAE,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,CAAA;IAE9E;;;OAGG;IACH,WAAW,EAAE,CAAC,QAAQ,EAAE,uBAAuB,KAAK,IAAI,CAAA;IAExD;;;OAGG;IACH,eAAe,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI,CAAA;IAErD;;;OAGG;IACH,qBAAqB,EAAE,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EAC9C,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,KAC/B,IAAI,CAAA;CACV;AAED,+CAA+C;AAC/C,MAAM,MAAM,iBAAiB,GAAG,CAAC,GAAG,EAAE,iBAAiB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAEhF,sEAAsE;AACtE,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,CAAC,EAAE,UAAU,CAAA;IACzB,QAAQ,EAAE,iBAAiB,CAAA;CAC5B;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,iBAAiB,CAAA"}

package/dist/types/openclaw-api.js

@@ -0,0 +1,10 @@
+/**
+ * OpenClaw Plugin API types.
+ *
+ * These types define the contract between plugins and the OpenClaw Gateway runtime.
+ * Based on OpenClaw 2026 plugin architecture.
+ *
+ * Reference: docs/knowledge/openclaw-hook-contract.md
+ */
+export {};
+//# sourceMappingURL=openclaw-api.js.map

package/dist/types/openclaw-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openclaw-api.js","sourceRoot":"","sources":["../../src/types/openclaw-api.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/utils/zod-to-json-schema.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Zod to JSON Schema conversion utilities.
+ *
+ * Converts Zod schemas to JSON Schema format for OpenClaw tool registration.
+ */
+import { type ZodTypeAny } from 'zod';
+import type { JSONSchema } from '../types/openclaw-api.js';
+/**
+ * Convert a Zod schema to JSON Schema.
+ *
+ * Note: This is a simplified converter that handles common cases.
+ * For complex schemas, consider using zodToJsonSchema library.
+ */
+export declare function zodToJsonSchema(schema: ZodTypeAny): JSONSchema;
+/**
+ * Add descriptions to JSON Schema properties from a map.
+ */
+export declare function addDescriptions(schema: JSONSchema, descriptions: Record<string, string>): JSONSchema;
+//# sourceMappingURL=zod-to-json-schema.d.ts.map

package/dist/utils/zod-to-json-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-to-json-schema.d.ts","sourceRoot":"","sources":["../../src/utils/zod-to-json-schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAK,KAAK,UAAU,EAAE,MAAM,KAAK,CAAA;AACxC,OAAO,KAAK,EAAE,UAAU,EAAsB,MAAM,0BAA0B,CAAA;AAE9E;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAE9D;AAwGD;;GAEG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,UAAU,EAClB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC,UAAU,CAWZ"}

package/dist/utils/zod-to-json-schema.js

@@ -0,0 +1,132 @@
+/**
+ * Zod to JSON Schema conversion utilities.
+ *
+ * Converts Zod schemas to JSON Schema format for OpenClaw tool registration.
+ */
+import { z } from 'zod';
+/**
+ * Convert a Zod schema to JSON Schema.
+ *
+ * Note: This is a simplified converter that handles common cases.
+ * For complex schemas, consider using zodToJsonSchema library.
+ */
+export function zodToJsonSchema(schema) {
+    return convertZodType(schema);
+}
+function convertZodType(schema) {
+    // Unwrap optional/nullable
+    if (schema instanceof z.ZodOptional || schema instanceof z.ZodNullable) {
+        return convertZodType(schema.unwrap());
+    }
+    // Unwrap default
+    if (schema instanceof z.ZodDefault) {
+        const inner = convertZodType(schema._def.innerType);
+        return { ...inner, default: schema._def.defaultValue() };
+    }
+    // String
+    if (schema instanceof z.ZodString) {
+        const result = { type: 'string' };
+        const checks = schema._def.checks ?? [];
+        for (const check of checks) {
+            if (check.kind === 'min')
+                result.minLength = check.value;
+            if (check.kind === 'max')
+                result.maxLength = check.value;
+            if (check.kind === 'regex')
+                result.pattern = check.regex.source;
+            if (check.kind === 'email')
+                result.format = 'email';
+            if (check.kind === 'uuid')
+                result.format = 'uuid';
+            if (check.kind === 'url')
+                result.format = 'uri';
+        }
+        if (schema.description)
+            result.description = schema.description;
+        return result;
+    }
+    // Number
+    if (schema instanceof z.ZodNumber) {
+        const checks = schema._def.checks ?? [];
+        const isInt = checks.some((c) => c.kind === 'int');
+        const result = { type: isInt ? 'integer' : 'number' };
+        for (const check of checks) {
+            if (check.kind === 'min')
+                result.minimum = check.value;
+            if (check.kind === 'max')
+                result.maximum = check.value;
+        }
+        if (schema.description)
+            result.description = schema.description;
+        return result;
+    }
+    // Boolean
+    if (schema instanceof z.ZodBoolean) {
+        const result = { type: 'boolean' };
+        if (schema.description)
+            result.description = schema.description;
+        return result;
+    }
+    // Enum
+    if (schema instanceof z.ZodEnum) {
+        const result = {
+            type: 'string',
+            enum: schema._def.values,
+        };
+        if (schema.description)
+            result.description = schema.description;
+        return result;
+    }
+    // Array
+    if (schema instanceof z.ZodArray) {
+        const result = {
+            type: 'array',
+            items: convertZodType(schema._def.type),
+        };
+        if (schema.description)
+            result.description = schema.description;
+        return result;
+    }
+    // Object
+    if (schema instanceof z.ZodObject) {
+        const shape = schema._def.shape();
+        const properties = {};
+        const required = [];
+        for (const [key, value] of Object.entries(shape)) {
+            properties[key] = convertZodType(value);
+            // Check if field is required (not optional)
+            if (!(value instanceof z.ZodOptional) && !(value instanceof z.ZodDefault)) {
+                required.push(key);
+            }
+        }
+        const result = {
+            type: 'object',
+            properties,
+        };
+        if (required.length > 0) {
+            result.required = required;
+        }
+        if (schema.description) {
+            result.description = schema.description;
+        }
+        return result;
+    }
+    // Fallback for unknown types
+    return { type: 'object' };
+}
+/**
+ * Add descriptions to JSON Schema properties from a map.
+ */
+export function addDescriptions(schema, descriptions) {
+    const result = { ...schema };
+    if (result.properties) {
+        result.properties = { ...result.properties };
+        for (const [key, desc] of Object.entries(descriptions)) {
+            if (result.properties[key]) {
+                result.properties[key] = { ...result.properties[key], description: desc };
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=zod-to-json-schema.js.map

package/dist/utils/zod-to-json-schema.js.map

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

package/openclaw.plugin.json

@@ -0,0 +1,229 @@
+{
+  "id": "openclaw-projects",
+  "name": "OpenClaw Projects Plugin",
+  "description": "Memory provider with projects, todos, and contacts integration",
+  "version": "2.1.0",
+  "kind": "memory",
+  "main": "dist/index.js",
+  "skillsDir": "skills",
+  "configSchema": {
+    "type": "object",
+    "properties": {
+      "apiUrl": {
+        "type": "string",
+        "description": "Backend API URL (must be HTTPS in production)"
+      },
+      "apiKey": {
+        "type": "string",
+        "description": "API authentication key (direct value, least secure)"
+      },
+      "apiKeyFile": {
+        "type": "string",
+        "description": "Path to file containing API key (e.g., ~/.secrets/api_key)"
+      },
+      "apiKeyCommand": {
+        "type": "string",
+        "description": "Command to execute to get API key (e.g., op read op://Personal/openclaw/api_key)"
+      },
+      "twilioAccountSid": {
+        "type": "string",
+        "description": "Twilio Account SID (direct value)"
+      },
+      "twilioAccountSidFile": {
+        "type": "string",
+        "description": "Path to file containing Twilio Account SID"
+      },
+      "twilioAccountSidCommand": {
+        "type": "string",
+        "description": "Command to get Twilio Account SID"
+      },
+      "twilioAuthToken": {
+        "type": "string",
+        "description": "Twilio Auth Token (direct value)"
+      },
+      "twilioAuthTokenFile": {
+        "type": "string",
+        "description": "Path to file containing Twilio Auth Token"
+      },
+      "twilioAuthTokenCommand": {
+        "type": "string",
+        "description": "Command to get Twilio Auth Token"
+      },
+      "twilioPhoneNumber": {
+        "type": "string",
+        "description": "Twilio Phone Number (direct value)"
+      },
+      "twilioPhoneNumberFile": {
+        "type": "string",
+        "description": "Path to file containing Twilio Phone Number"
+      },
+      "twilioPhoneNumberCommand": {
+        "type": "string",
+        "description": "Command to get Twilio Phone Number"
+      },
+      "postmarkToken": {
+        "type": "string",
+        "description": "Postmark API Token (direct value)"
+      },
+      "postmarkTokenFile": {
+        "type": "string",
+        "description": "Path to file containing Postmark Token"
+      },
+      "postmarkTokenCommand": {
+        "type": "string",
+        "description": "Command to get Postmark Token"
+      },
+      "postmarkFromEmail": {
+        "type": "string",
+        "format": "email",
+        "description": "Postmark From Email address (direct value)"
+      },
+      "postmarkFromEmailFile": {
+        "type": "string",
+        "description": "Path to file containing Postmark From Email"
+      },
+      "postmarkFromEmailCommand": {
+        "type": "string",
+        "description": "Command to get Postmark From Email"
+      },
+      "secretCommandTimeout": {
+        "type": "integer",
+        "minimum": 1000,
+        "maximum": 30000,
+        "default": 5000,
+        "description": "Timeout for secret command execution in milliseconds"
+      },
+      "autoRecall": {
+        "type": "boolean",
+        "default": true,
+        "description": "Automatically recall relevant memories on conversation start"
+      },
+      "autoCapture": {
+        "type": "boolean",
+        "default": true,
+        "description": "Automatically capture important information as memories"
+      },
+      "userScoping": {
+        "type": "string",
+        "enum": ["agent", "identity", "session"],
+        "default": "agent",
+        "description": "How to scope user memories"
+      }
+    },
+    "required": ["apiUrl"],
+    "anyOf": [
+      { "required": ["apiKey"] },
+      { "required": ["apiKeyFile"] },
+      { "required": ["apiKeyCommand"] }
+    ]
+  },
+  "uiHints": {
+    "apiUrl": {
+      "label": "Backend URL",
+      "placeholder": "https://api.openclaw-projects.example.com",
+      "helpText": "The URL of your OpenClaw Projects backend API"
+    },
+    "apiKey": {
+      "label": "API Key",
+      "sensitive": true,
+      "placeholder": "sk-...",
+      "helpText": "Direct API key value (least secure, for development)"
+    },
+    "apiKeyFile": {
+      "label": "API Key File",
+      "placeholder": "~/.secrets/openclaw-api-key",
+      "helpText": "Path to a file containing your API key"
+    },
+    "apiKeyCommand": {
+      "label": "API Key Command",
+      "placeholder": "op read op://Personal/openclaw/api_key",
+      "helpText": "Command to retrieve API key (e.g., 1Password CLI)"
+    },
+    "twilioAccountSid": {
+      "label": "Twilio Account SID",
+      "sensitive": true,
+      "group": "Twilio SMS"
+    },
+    "twilioAccountSidFile": {
+      "label": "Twilio Account SID File",
+      "group": "Twilio SMS"
+    },
+    "twilioAccountSidCommand": {
+      "label": "Twilio Account SID Command",
+      "group": "Twilio SMS"
+    },
+    "twilioAuthToken": {
+      "label": "Twilio Auth Token",
+      "sensitive": true,
+      "group": "Twilio SMS"
+    },
+    "twilioAuthTokenFile": {
+      "label": "Twilio Auth Token File",
+      "group": "Twilio SMS"
+    },
+    "twilioAuthTokenCommand": {
+      "label": "Twilio Auth Token Command",
+      "group": "Twilio SMS"
+    },
+    "twilioPhoneNumber": {
+      "label": "Twilio Phone Number",
+      "sensitive": true,
+      "placeholder": "+15551234567",
+      "group": "Twilio SMS"
+    },
+    "twilioPhoneNumberFile": {
+      "label": "Twilio Phone Number File",
+      "group": "Twilio SMS"
+    },
+    "twilioPhoneNumberCommand": {
+      "label": "Twilio Phone Number Command",
+      "group": "Twilio SMS"
+    },
+    "postmarkToken": {
+      "label": "Postmark Token",
+      "sensitive": true,
+      "group": "Postmark Email"
+    },
+    "postmarkTokenFile": {
+      "label": "Postmark Token File",
+      "group": "Postmark Email"
+    },
+    "postmarkTokenCommand": {
+      "label": "Postmark Token Command",
+      "group": "Postmark Email"
+    },
+    "postmarkFromEmail": {
+      "label": "Postmark From Email",
+      "placeholder": "noreply@example.com",
+      "group": "Postmark Email"
+    },
+    "postmarkFromEmailFile": {
+      "label": "Postmark From Email File",
+      "group": "Postmark Email"
+    },
+    "postmarkFromEmailCommand": {
+      "label": "Postmark From Email Command",
+      "group": "Postmark Email"
+    },
+    "secretCommandTimeout": {
+      "label": "Secret Command Timeout",
+      "helpText": "Timeout in milliseconds for secret retrieval commands",
+      "group": "Advanced"
+    },
+    "autoRecall": {
+      "label": "Auto-Recall",
+      "helpText": "Automatically inject relevant memories at conversation start",
+      "group": "Memory"
+    },
+    "autoCapture": {
+      "label": "Auto-Capture",
+      "helpText": "Automatically store important information as memories",
+      "group": "Memory"
+    },
+    "userScoping": {
+      "label": "User Scoping",
+      "helpText": "How to isolate memories between users",
+      "group": "Memory"
+    }
+  }
+}