@mind-your-now/myn 0.4.0

package/dist/src/tools/memory.d.ts

@@ -0,0 +1,45 @@
+/**
+ * myn_memory tool - Agent memory remember/recall/forget
+ */
+import type { MynApiClient } from '../client.js';
+export declare const MemoryInputSchema: import("@sinclair/typebox").TObject<{
+    action: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"remember">, import("@sinclair/typebox").TLiteral<"recall">, import("@sinclair/typebox").TLiteral<"forget">, import("@sinclair/typebox").TLiteral<"search">]>;
+    content: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    category: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"user_preference">, import("@sinclair/typebox").TLiteral<"work_context">, import("@sinclair/typebox").TLiteral<"personal_info">, import("@sinclair/typebox").TLiteral<"decision">, import("@sinclair/typebox").TLiteral<"insight">, import("@sinclair/typebox").TLiteral<"routine">]>>;
+    tags: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    importance: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"low">, import("@sinclair/typebox").TLiteral<"medium">, import("@sinclair/typebox").TLiteral<"high">, import("@sinclair/typebox").TLiteral<"critical">]>>;
+    expiresAt: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    memoryId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    query: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    filterCategory: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    filterTags: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+}>;
+export type MemoryInput = typeof MemoryInputSchema.static;
+export declare function executeMemory(client: MynApiClient, input: MemoryInput): Promise<{
+    success: true;
+    data: unknown;
+} | {
+    success: false;
+    error: string;
+    details?: unknown;
+}>;
+export declare function registerMemoryTool(api: OpenClawPluginApi, client: MynApiClient): void;
+interface OpenClawPluginApi {
+    registerTool(tool: {
+        id: string;
+        name: string;
+        description: string;
+        inputSchema: unknown;
+        execute: (input: unknown) => Promise<unknown>;
+    }): void;
+    logger: {
+        debug(message: string): void;
+        info(message: string): void;
+        warn(message: string): void;
+        error(message: string): void;
+    };
+    pluginConfig?: Record<string, unknown>;
+}
+export {};
+//# sourceMappingURL=memory.d.ts.map

package/dist/src/tools/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../src/tools/memory.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGjD,eAAO,MAAM,iBAAiB;;;;;;;;;;;;EAgC5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,OAAO,iBAAiB,CAAC,MAAM,CAAC;AAE1D,wBAAsB,aAAa,CACjC,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,WAAW,GACjB,OAAO,CAAC;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAoBlG;AAkGD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,iBAAiB,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAUrF;AAGD,UAAU,iBAAiB;IACzB,YAAY,CAAC,IAAI,EAAE;QACjB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,OAAO,CAAC;QACrB,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;KAC/C,GAAG,IAAI,CAAC;IACT,MAAM,EAAE;QACN,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;KAC9B,CAAC;IACF,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC"}

package/dist/src/tools/memory.js

@@ -0,0 +1,131 @@
+/**
+ * myn_memory tool - Agent memory remember/recall/forget
+ */
+import { Type } from '@sinclair/typebox';
+import { jsonResult, errorResult } from '../client.js';
+export const MemoryInputSchema = Type.Object({
+    action: Type.Union([
+        Type.Literal('remember'),
+        Type.Literal('recall'),
+        Type.Literal('forget'),
+        Type.Literal('search')
+    ]),
+    // remember parameters
+    content: Type.Optional(Type.String({ minLength: 1, description: 'Memory content to store' })),
+    category: Type.Optional(Type.Union([
+        Type.Literal('user_preference'),
+        Type.Literal('work_context'),
+        Type.Literal('personal_info'),
+        Type.Literal('decision'),
+        Type.Literal('insight'),
+        Type.Literal('routine')
+    ])),
+    tags: Type.Optional(Type.Array(Type.String())),
+    importance: Type.Optional(Type.Union([
+        Type.Literal('low'),
+        Type.Literal('medium'),
+        Type.Literal('high'),
+        Type.Literal('critical')
+    ])),
+    expiresAt: Type.Optional(Type.String({ format: 'date-time', description: 'Optional expiration date' })),
+    // recall/forget parameters
+    memoryId: Type.Optional(Type.String({ format: 'uuid' })),
+    // search parameters
+    query: Type.Optional(Type.String()),
+    filterCategory: Type.Optional(Type.String()),
+    filterTags: Type.Optional(Type.Array(Type.String())),
+    limit: Type.Optional(Type.Number({ default: 10 }))
+});
+export async function executeMemory(client, input) {
+    try {
+        switch (input.action) {
+            case 'remember':
+                return await remember(client, input);
+            case 'recall':
+                return await recall(client, input);
+            case 'forget':
+                return await forget(client, input);
+            case 'search':
+                return await searchMemories(client, input);
+            default:
+                return errorResult(`Unknown action: ${input.action}`);
+        }
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            return errorResult(error.message);
+        }
+        return errorResult('Unknown error occurred');
+    }
+}
+async function remember(_client, input) {
+    if (!input.content) {
+        return errorResult('content is required for remember action');
+    }
+    // The backend does not expose a POST /api/v1/customers/memories endpoint.
+    // Memories are created automatically through the AI conversation system (Kaia).
+    // To persist a memory, include it naturally in the conversation context so
+    // the backend's AI service stores it on your behalf.
+    return errorResult('Direct memory creation is not supported. Memories are created ' +
+        'automatically through conversations with the AI assistant. ' +
+        'To store a memory, mention it in conversation context.');
+}
+async function recall(client, input) {
+    // The backend only supports GET /api/v1/customers/memories (list all).
+    // There is no GET /api/v1/customers/memories/{memoryId} endpoint.
+    const data = await client.get('/api/v1/customers/memories');
+    if (input.memoryId) {
+        // Filter client-side for a specific memory
+        const memories = Array.isArray(data) ? data : [];
+        const match = memories.find(m => m.memoryId === input.memoryId);
+        if (!match) {
+            return errorResult(`Memory not found: ${input.memoryId}`);
+        }
+        return jsonResult(match);
+    }
+    return jsonResult(data);
+}
+async function forget(client, input) {
+    if (!input.memoryId) {
+        return errorResult('memoryId is required for forget action');
+    }
+    await client.delete(`/api/v1/customers/memories/${input.memoryId}`);
+    return jsonResult({
+        deleted: true,
+        memoryId: input.memoryId
+    });
+}
+async function searchMemories(client, input) {
+    // The backend has no /api/v1/customers/memories/search endpoint.
+    // Fetch all memories and filter client-side.
+    const data = await client.get('/api/v1/customers/memories');
+    let results = Array.isArray(data) ? data : [];
+    // Client-side filtering
+    if (input.query) {
+        const q = input.query.toLowerCase();
+        results = results.filter(m => m.content?.toLowerCase().includes(q) ||
+            m.tags?.some(t => t.toLowerCase().includes(q)));
+    }
+    if (input.filterCategory) {
+        results = results.filter(m => m.category === input.filterCategory);
+    }
+    if (input.filterTags && input.filterTags.length > 0) {
+        results = results.filter(m => input.filterTags.every(tag => m.tags?.includes(tag)));
+    }
+    if (input.limit) {
+        results = results.slice(0, input.limit);
+    }
+    return jsonResult({ results, total: results.length });
+}
+export function registerMemoryTool(api, client) {
+    api.registerTool({
+        id: 'myn_memory',
+        name: 'MYN Memory',
+        description: 'Store and retrieve agent memories. Actions: remember, recall, forget, search.',
+        inputSchema: MemoryInputSchema,
+        async execute(input) {
+            return executeMemory(client, input);
+        }
+    });
+}
+//# sourceMappingURL=memory.js.map

package/dist/src/tools/memory.js.map

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

package/dist/src/tools/myn_a2a_pairing.d.ts

@@ -0,0 +1,42 @@
+/**
+ * myn_a2a_pairing tool — Pair OpenClaw with MYN/Kaia via the A2A protocol.
+ *
+ * MIN-734: openclaw-a2a-lite-v1
+ *
+ * This tool uses direct fetch() calls because A2A authentication uses a
+ * separate key mechanism (X-Agent-Key) from the standard API key (X-API-KEY).
+ */
+export declare const MynA2APairingInputSchema: import("@sinclair/typebox").TObject<{
+    action: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"redeem_invite">, import("@sinclair/typebox").TLiteral<"ping">, import("@sinclair/typebox").TLiteral<"send_message">, import("@sinclair/typebox").TLiteral<"get_agent_card">]>;
+    /** X-Agent-Key value for authenticated A2A requests (after pairing) */
+    agentKey: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    inviteCode: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    agentName: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    displayName: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    outboundEndpoint: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    capabilities: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TAny>>;
+    intent: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"chat">, import("@sinclair/typebox").TLiteral<"briefing">, import("@sinclair/typebox").TLiteral<"ping">]>>;
+    message: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    conversationId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+export type MynA2APairingInput = typeof MynA2APairingInputSchema.static;
+interface OpenClawPluginApi {
+    registerTool(tool: {
+        id: string;
+        name: string;
+        description: string;
+        inputSchema: unknown;
+        execute: (input: unknown) => Promise<unknown>;
+    }): void;
+}
+/**
+ * Register the A2A pairing tool with the plugin API.
+ * @param baseUrl - The MYN API base URL from plugin config (e.g. https://api.mindyournow.com)
+ */
+export declare function registerA2APairingTool(api: OpenClawPluginApi, baseUrl: string): void;
+/**
+ * Execute a MYN A2A pairing action.
+ */
+export declare function myn_a2a_pairing(input: MynA2APairingInput, configuredBaseUrl?: string): Promise<unknown>;
+export {};
+//# sourceMappingURL=myn_a2a_pairing.d.ts.map

package/dist/src/tools/myn_a2a_pairing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"myn_a2a_pairing.d.ts","sourceRoot":"","sources":["../../../src/tools/myn_a2a_pairing.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,eAAO,MAAM,wBAAwB;;IAOnC,uEAAuE;;;;;;;;;;EAYvE,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,OAAO,wBAAwB,CAAC,MAAM,CAAC;AAGxE,UAAU,iBAAiB;IACzB,YAAY,CAAC,IAAI,EAAE;QACjB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,OAAO,CAAC;QACrB,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;KAC/C,GAAG,IAAI,CAAC;CACV;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAoBpF;AAWD;;GAEG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA4G7G"}

package/dist/src/tools/myn_a2a_pairing.js

@@ -0,0 +1,166 @@
+/**
+ * myn_a2a_pairing tool — Pair OpenClaw with MYN/Kaia via the A2A protocol.
+ *
+ * MIN-734: openclaw-a2a-lite-v1
+ *
+ * This tool uses direct fetch() calls because A2A authentication uses a
+ * separate key mechanism (X-Agent-Key) from the standard API key (X-API-KEY).
+ */
+import { Type } from '@sinclair/typebox';
+import { errorResult, jsonResult } from '../client.js';
+import { computeCapabilityHash } from './capabilityHash.js';
+import { checkAndSync } from './syncOnMismatch.js';
+export const MynA2APairingInputSchema = Type.Object({
+    action: Type.Union([
+        Type.Literal('redeem_invite'),
+        Type.Literal('ping'),
+        Type.Literal('send_message'),
+        Type.Literal('get_agent_card'),
+    ]),
+    /** X-Agent-Key value for authenticated A2A requests (after pairing) */
+    agentKey: Type.Optional(Type.String({ description: 'Agent key from redeem_invite response' })),
+    // redeem_invite fields
+    inviteCode: Type.Optional(Type.String({ description: 'Invite code from MYN Settings (e.g. ABC-12345)' })),
+    agentName: Type.Optional(Type.String({ description: 'Lowercase alphanumeric agent name (e.g. "openclaw")' })),
+    displayName: Type.Optional(Type.String()),
+    outboundEndpoint: Type.Optional(Type.String({ description: 'HTTPS URL where MYN calls this agent (optional — use "none" if not available)' })),
+    capabilities: Type.Optional(Type.Array(Type.Any(), { description: 'Capability objects for the manifest' })),
+    // send_message fields
+    intent: Type.Optional(Type.Union([Type.Literal('chat'), Type.Literal('briefing'), Type.Literal('ping')])),
+    message: Type.Optional(Type.String()),
+    conversationId: Type.Optional(Type.String()),
+});
+/**
+ * Register the A2A pairing tool with the plugin API.
+ * @param baseUrl - The MYN API base URL from plugin config (e.g. https://api.mindyournow.com)
+ */
+export function registerA2APairingTool(api, baseUrl) {
+    api.registerTool({
+        id: 'myn_a2a_pairing',
+        name: 'MYN A2A Pairing',
+        description: `Pair OpenClaw with MYN/Kaia via A2A protocol. The MYN API URL is already configured — do NOT guess or change it.
+
+IMPORTANT: If this tool returns an error, STOP IMMEDIATELY and report the error to the user. Do NOT retry with different URLs or parameters. Do NOT try to discover endpoints. The configuration is correct; errors mean something else is wrong.
+
+Actions:
+- redeem_invite: Redeem an invite code. Required: inviteCode, agentName. Optional: outboundEndpoint, displayName, capabilities.
+- ping: Ping MYN after pairing. Required: agentKey.
+- send_message: Send a message. Required: agentKey, message.
+- get_agent_card: Fetch MYN's agent card (no auth needed).
+
+For redeem_invite, use agentName "openclaw" and outboundEndpoint "none" if no public endpoint is available.`,
+        inputSchema: MynA2APairingInputSchema,
+        async execute(input) {
+            return myn_a2a_pairing(input, baseUrl);
+        }
+    });
+}
+async function a2aFetch(url, options) {
+    const response = await fetch(url, options);
+    if (!response.ok) {
+        const text = await response.text().catch(() => response.statusText);
+        throw new Error(`HTTP ${response.status}: ${text}`);
+    }
+    return response.status === 204 ? null : response.json();
+}
+/**
+ * Execute a MYN A2A pairing action.
+ */
+export async function myn_a2a_pairing(input, configuredBaseUrl) {
+    const base = (configuredBaseUrl ?? 'https://api.mindyournow.com').replace(/\/$/, '');
+    const caps = input.capabilities ?? [];
+    try {
+        switch (input.action) {
+            case 'get_agent_card': {
+                const data = await a2aFetch(`${base}/.well-known/agent.json`, { method: 'GET' });
+                return jsonResult(data);
+            }
+            case 'redeem_invite': {
+                if (!input.inviteCode || !input.agentName) {
+                    return errorResult('STOP: inviteCode and agentName are required. Do not retry — ask the user for the missing values.');
+                }
+                const manifest = {
+                    schemaVersion: '1.0',
+                    agentInfo: { name: input.agentName, version: '1.0.0' },
+                    capabilities: caps,
+                };
+                const capabilityHash = computeCapabilityHash(manifest);
+                const body = {
+                    inviteCode: input.inviteCode,
+                    agentName: input.agentName,
+                    displayName: input.displayName ?? input.agentName,
+                    outboundEndpoint: input.outboundEndpoint || 'none',
+                    capabilityHash,
+                    capabilityManifest: manifest,
+                };
+                const data = await a2aFetch(`${base}/api/v1/agent/redeem-invite`, {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json' },
+                    body: JSON.stringify(body),
+                });
+                return jsonResult({
+                    ...data,
+                    capabilityHash,
+                    note: 'Store mynInboundKey securely — use it as agentKey in future calls.',
+                });
+            }
+            case 'ping': {
+                if (!input.agentKey)
+                    return errorResult('STOP: agentKey is required for ping. This comes from the redeem_invite response (mynInboundKey).');
+                const pingData = await a2aFetch(`${base}/a2a/message`, {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json', 'X-Agent-Key': input.agentKey },
+                    body: JSON.stringify({ from: input.agentName ?? 'openclaw', intent: 'ping' }),
+                });
+                // Ping responses also carry capabilityUpdatePending — sync if flagged
+                if (caps.length > 0) {
+                    const pingManifest = {
+                        schemaVersion: '1.0',
+                        agentInfo: { name: input.agentName ?? 'openclaw', version: '1.0.0' },
+                        capabilities: caps,
+                    };
+                    checkAndSync(pingData, base, input.agentKey, pingManifest);
+                }
+                return jsonResult(pingData);
+            }
+            case 'send_message': {
+                if (!input.agentKey)
+                    return errorResult('STOP: agentKey is required for send_message.');
+                if (!input.message)
+                    return errorResult('STOP: message is required for send_message.');
+                const msgBody = {
+                    from: input.agentName ?? 'openclaw',
+                    intent: input.intent ?? 'chat',
+                    message: input.message,
+                };
+                if (input.conversationId)
+                    msgBody.conversationId = input.conversationId;
+                const manifest = caps.length > 0 ? {
+                    schemaVersion: '1.0',
+                    agentInfo: { name: input.agentName ?? 'openclaw', version: '1.0.0' },
+                    capabilities: caps,
+                } : null;
+                if (manifest) {
+                    msgBody.capabilityHash = computeCapabilityHash(manifest);
+                }
+                const data = await a2aFetch(`${base}/a2a/message`, {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json', 'X-Agent-Key': input.agentKey },
+                    body: JSON.stringify(msgBody),
+                });
+                // Auto-sync capabilities when server signals a hash mismatch — MIN-734
+                if (manifest) {
+                    checkAndSync(data, base, input.agentKey, manifest);
+                }
+                return jsonResult(data);
+            }
+            default:
+                return errorResult(`Unknown action: ${input.action}`);
+        }
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return errorResult(`STOP: A2A request failed: ${msg}. Do NOT retry with different URLs — the API URL is pre-configured. Report this error to the user.`);
+    }
+}
+//# sourceMappingURL=myn_a2a_pairing.js.map

package/dist/src/tools/myn_a2a_pairing.js.map

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

package/dist/src/tools/planning.d.ts

@@ -0,0 +1,56 @@
+/**
+ * myn_planning tool - AI planning and scheduling
+ */
+import type { MynApiClient } from '../client.js';
+export declare const PlanningInputSchema: import("@sinclair/typebox").TObject<{
+    action: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"plan">, import("@sinclair/typebox").TLiteral<"schedule_all">, import("@sinclair/typebox").TLiteral<"reschedule">]>;
+    goal: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    constraints: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+        availableHours: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+        preferredTimes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+        avoidTimes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+        deadline: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        priority: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"CRITICAL">, import("@sinclair/typebox").TLiteral<"OPPORTUNITY_NOW">, import("@sinclair/typebox").TLiteral<"OVER_THE_HORIZON">]>>;
+    }>>;
+    tasks: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+        title: import("@sinclair/typebox").TString;
+        estimatedDuration: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+        dependsOn: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+        fixedTime: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    }>>>;
+    date: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    respectExisting: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    bufferMinutes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    taskIds: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    reason: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    targetDate: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    spreadOverDays: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+}>;
+export type PlanningInput = typeof PlanningInputSchema.static;
+export declare function executePlanning(client: MynApiClient, input: PlanningInput): Promise<{
+    success: true;
+    data: unknown;
+} | {
+    success: false;
+    error: string;
+    details?: unknown;
+}>;
+export declare function registerPlanningTool(api: OpenClawPluginApi, client: MynApiClient): void;
+interface OpenClawPluginApi {
+    registerTool(tool: {
+        id: string;
+        name: string;
+        description: string;
+        inputSchema: unknown;
+        execute: (input: unknown) => Promise<unknown>;
+    }): void;
+    logger: {
+        debug(message: string): void;
+        info(message: string): void;
+        warn(message: string): void;
+        error(message: string): void;
+    };
+    pluginConfig?: Record<string, unknown>;
+}
+export {};
+//# sourceMappingURL=planning.d.ts.map

package/dist/src/tools/planning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planning.d.ts","sourceRoot":"","sources":["../../../src/tools/planning.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGjD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;EAkC9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,OAAO,mBAAmB,CAAC,MAAM,CAAC;AAE9D,wBAAsB,eAAe,CACnC,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAkBlG;AA8BD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,iBAAiB,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAUvF;AAGD,UAAU,iBAAiB;IACzB,YAAY,CAAC,IAAI,EAAE;QACjB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,OAAO,CAAC;QACrB,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;KAC/C,GAAG,IAAI,CAAC;IACT,MAAM,EAAE;QACN,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;KAC9B,CAAC;IACF,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC"}

package/dist/src/tools/planning.js

@@ -0,0 +1,94 @@
+/**
+ * myn_planning tool - AI planning and scheduling
+ */
+import { Type } from '@sinclair/typebox';
+import { jsonResult, errorResult } from '../client.js';
+export const PlanningInputSchema = Type.Object({
+    action: Type.Union([
+        Type.Literal('plan'),
+        Type.Literal('schedule_all'),
+        Type.Literal('reschedule')
+    ]),
+    // plan parameters
+    goal: Type.Optional(Type.String({ description: 'What you want to accomplish' })),
+    constraints: Type.Optional(Type.Object({
+        availableHours: Type.Optional(Type.Number()),
+        preferredTimes: Type.Optional(Type.Array(Type.String())),
+        avoidTimes: Type.Optional(Type.Array(Type.String())),
+        deadline: Type.Optional(Type.String({ format: 'date-time' })),
+        priority: Type.Optional(Type.Union([
+            Type.Literal('CRITICAL'),
+            Type.Literal('OPPORTUNITY_NOW'),
+            Type.Literal('OVER_THE_HORIZON')
+        ]))
+    })),
+    tasks: Type.Optional(Type.Array(Type.Object({
+        title: Type.String(),
+        estimatedDuration: Type.Optional(Type.Number()), // in minutes
+        dependsOn: Type.Optional(Type.Array(Type.String())),
+        fixedTime: Type.Optional(Type.String({ format: 'date-time' }))
+    }))),
+    // schedule_all parameters
+    date: Type.Optional(Type.String({ format: 'date' })),
+    respectExisting: Type.Optional(Type.Boolean({ default: true })),
+    bufferMinutes: Type.Optional(Type.Number({ default: 15 })),
+    // reschedule parameters
+    taskIds: Type.Optional(Type.Array(Type.String({ format: 'uuid' }))),
+    reason: Type.Optional(Type.String()),
+    targetDate: Type.Optional(Type.String({ format: 'date' })),
+    spreadOverDays: Type.Optional(Type.Number({ default: 1 }))
+});
+export async function executePlanning(client, input) {
+    try {
+        switch (input.action) {
+            case 'plan':
+                return await createPlan(client, input);
+            case 'schedule_all':
+                return await scheduleAll(client, input);
+            case 'reschedule':
+                return await reschedule(client, input);
+            default:
+                return errorResult(`Unknown action: ${input.action}`);
+        }
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            return errorResult(error.message);
+        }
+        return errorResult('Unknown error occurred');
+    }
+}
+async function createPlan(client, _input) {
+    // Triggers the AI planning engine to plan/schedule tasks for the current user.
+    // The backend PlanningController at GET /planning/plan handles this automatically
+    // based on the authenticated user's tasks — no request body is needed.
+    const data = await client.get('/planning/plan');
+    return jsonResult({ result: data });
+}
+async function scheduleAll(client, _input) {
+    // Auto-schedules all eligible tasks (today or past start date, not completed,
+    // not OVER_THE_HORIZON/PARKING_LOT) for the authenticated user, then triggers planning.
+    // The backend PlanningController at GET /planning/scheduleAll handles this automatically.
+    const data = await client.get('/planning/scheduleAll');
+    return jsonResult({ result: data });
+}
+async function reschedule(client, input) {
+    // "Kick the can" — reschedules overdue/today tasks into the future based on priority.
+    // Optionally pass rebalance=true to redistribute all uncompleted tasks evenly.
+    // The backend PlanningController at GET /planning/kickTheCan handles this automatically.
+    const rebalance = input.spreadOverDays && input.spreadOverDays > 1 ? 'true' : 'false';
+    const data = await client.get(`/planning/kickTheCan?rebalance=${rebalance}`);
+    return jsonResult(data);
+}
+export function registerPlanningTool(api, client) {
+    api.registerTool({
+        id: 'myn_planning',
+        name: 'MYN Planning',
+        description: 'AI-powered planning and scheduling. Actions: plan, schedule_all, reschedule.',
+        inputSchema: PlanningInputSchema,
+        async execute(input) {
+            return executePlanning(client, input);
+        }
+    });
+}
+//# sourceMappingURL=planning.js.map

package/dist/src/tools/planning.js.map

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

package/dist/src/tools/profile.d.ts

@@ -0,0 +1,47 @@
+/**
+ * myn_profile tool - User info, goals, and preferences
+ */
+import type { MynApiClient } from '../client.js';
+export declare const ProfileInputSchema: import("@sinclair/typebox").TObject<{
+    action: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"get_info">, import("@sinclair/typebox").TLiteral<"get_goals">, import("@sinclair/typebox").TLiteral<"update_goals">, import("@sinclair/typebox").TLiteral<"preferences">]>;
+    goals: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+        id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        title: import("@sinclair/typebox").TString;
+        description: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        targetDate: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        priority: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"low">, import("@sinclair/typebox").TLiteral<"medium">, import("@sinclair/typebox").TLiteral<"high">]>>;
+        status: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"active">, import("@sinclair/typebox").TLiteral<"completed">, import("@sinclair/typebox").TLiteral<"paused">, import("@sinclair/typebox").TLiteral<"abandoned">]>>;
+    }>>>;
+    goalId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    preferenceKey: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    preferenceValue: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnknown>;
+    preferenceCategory: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"notifications">, import("@sinclair/typebox").TLiteral<"display">, import("@sinclair/typebox").TLiteral<"ai">, import("@sinclair/typebox").TLiteral<"privacy">, import("@sinclair/typebox").TLiteral<"integrations">]>>;
+}>;
+export type ProfileInput = typeof ProfileInputSchema.static;
+export declare function executeProfile(client: MynApiClient, input: ProfileInput): Promise<{
+    success: true;
+    data: unknown;
+} | {
+    success: false;
+    error: string;
+    details?: unknown;
+}>;
+export declare function registerProfileTool(api: OpenClawPluginApi, client: MynApiClient): void;
+interface OpenClawPluginApi {
+    registerTool(tool: {
+        id: string;
+        name: string;
+        description: string;
+        inputSchema: unknown;
+        execute: (input: unknown) => Promise<unknown>;
+    }): void;
+    logger: {
+        debug(message: string): void;
+        info(message: string): void;
+        warn(message: string): void;
+        error(message: string): void;
+    };
+    pluginConfig?: Record<string, unknown>;
+}
+export {};
+//# sourceMappingURL=profile.d.ts.map

package/dist/src/tools/profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.d.ts","sourceRoot":"","sources":["../../../src/tools/profile.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGjD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;EAoC7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,OAAO,kBAAkB,CAAC,MAAM,CAAC;AAE5D,wBAAsB,cAAc,CAClC,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,YAAY,GAClB,OAAO,CAAC;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAoBlG;AA2GD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,iBAAiB,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAUtF;AAGD,UAAU,iBAAiB;IACzB,YAAY,CAAC,IAAI,EAAE;QACjB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,OAAO,CAAC;QACrB,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;KAC/C,GAAG,IAAI,CAAC;IACT,MAAM,EAAE;QACN,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;KAC9B,CAAC;IACF,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC"}