stella-timeline-plugin 2.0.2 → 2.0.3

package/dist/index.js

@@ -9,7 +9,7 @@ exports.timelinePluginEntry = (0, openclaw_sdk_compat_1.definePluginEntry)({
     name: plugin_metadata_1.TIMELINE_PLUGIN_NAME,
     description: plugin_metadata_1.TIMELINE_PLUGIN_DESCRIPTION,
     register(api) {
-        api.registerTool((0, openclaw_sdk_compat_1.makeTimelineToolRegistration)());
+        api.registerTool((0, openclaw_sdk_compat_1.makeTimelineToolRegistration)(), { optional: true });
     },
 });
 exports.timelinePlugin = (0, openclaw_sdk_compat_1.materializePlugin)(exports.timelinePluginEntry);
@@ -20,7 +20,7 @@ const openClawTimelinePlugin = {
     description: plugin_metadata_1.TIMELINE_PLUGIN_DESCRIPTION,
     register(api) {
         const runtimeApi = api;
-        api.registerTool((0, openclaw_timeline_runtime_1.makeOpenClawTimelineResolveToolFactory)(runtimeApi), { names: [...plugin_metadata_1.TIMELINE_TOOL_NAMES] });
+        api.registerTool((0, openclaw_timeline_runtime_1.makeOpenClawTimelineResolveToolFactory)(runtimeApi), { optional: true });
     },
 };
 exports.default = openClawTimelinePlugin;

package/openclaw.plugin.json

@@ -1,54 +1,54 @@
-{
-  "id": "stella-timeline-plugin",
-  "name": "Stella Timeline Plugin",
-  "version": "2.0.0",
-  "description": "OpenClaw timeline runtime with canonical timeline_resolve, LLM-based temporal reasoning, and guarded append-only writes.",
-  "entry": "dist/index.js",
-  "skills": [
-    "skills/timeline"
-  ],
-  "configSchema": {
-    "type": "object",
-    "properties": {
-      "enableTrace": {
-        "type": "boolean",
-        "default": true,
-        "description": "Whether Timeline writes trace records for each runtime execution."
-      },
-      "traceLogPath": {
-        "type": "string",
-        "description": "Optional trace log path. Relative paths are resolved from the workspace."
-      },
-      "canonicalMemoryRoot": {
-        "type": "string",
-        "description": "Root directory for canonical timeline daily logs. Relative paths are resolved from the workspace."
-      },
-      "reasonerTimeoutMs": {
-        "type": "integer",
-        "default": 90000,
-        "description": "Timeout for the internal timeline reasoner subagent, in milliseconds."
-      },
-      "reasonerSessionPrefix": {
-        "type": "string",
-        "default": "timeline-reasoner",
-        "description": "Session key prefix used for the internal timeline reasoner subagent."
-      },
-      "reasonerMessageLimit": {
-        "type": "integer",
-        "default": 24,
-        "description": "Maximum number of messages retained when reading the internal reasoner transcript."
-      },
-      "sessionHistoryLimit": {
-        "type": "integer",
-        "default": 12,
-        "description": "Maximum number of current-session messages retained by the collector."
-      },
-      "memorySearchMaxResults": {
-        "type": "integer",
-        "default": 6,
-        "description": "Maximum number of results requested when the collector calls OpenClaw memory_search."
-      }
-    },
-    "additionalProperties": false
-  }
-}
+{
+  "id": "stella-timeline-plugin",
+  "name": "Stella Timeline Plugin",
+  "version": "2.0.0",
+  "description": "OpenClaw timeline runtime with canonical timeline_resolve, LLM-based temporal reasoning, and guarded append-only writes.",
+  "entry": "dist/index.js",
+  "skills": [
+    "skills/timeline"
+  ],
+  "configSchema": {
+    "type": "object",
+    "properties": {
+      "enableTrace": {
+        "type": "boolean",
+        "default": true,
+        "description": "Whether Timeline writes trace records for each runtime execution."
+      },
+      "traceLogPath": {
+        "type": "string",
+        "description": "Optional trace log path. Relative paths are resolved from the workspace."
+      },
+      "canonicalMemoryRoot": {
+        "type": "string",
+        "description": "Root directory for canonical timeline daily logs. Relative paths are resolved from the workspace."
+      },
+      "reasonerTimeoutMs": {
+        "type": "integer",
+        "default": 90000,
+        "description": "Timeout for the internal timeline reasoner subagent, in milliseconds."
+      },
+      "reasonerSessionPrefix": {
+        "type": "string",
+        "default": "timeline-reasoner",
+        "description": "Session key prefix used for the internal timeline reasoner subagent."
+      },
+      "reasonerMessageLimit": {
+        "type": "integer",
+        "default": 24,
+        "description": "Maximum number of messages retained when reading the internal reasoner transcript."
+      },
+      "sessionHistoryLimit": {
+        "type": "integer",
+        "default": 12,
+        "description": "Maximum number of current-session messages retained by the collector."
+      },
+      "memorySearchMaxResults": {
+        "type": "integer",
+        "default": 6,
+        "description": "Maximum number of results requested when the collector calls OpenClaw memory_search."
+      }
+    },
+    "additionalProperties": false
+  }
+}

package/package.json

@@ -1,73 +1,73 @@
-{
-  "name": "stella-timeline-plugin",
-  "version": "2.0.2",
-  "description": "Native OpenClaw timeline plugin with a canonical timeline_resolve tool, bundled skill routing, and guarded append-only writes.",
-  "keywords": [
-    "openclaw",
-    "skill",
-    "timeline",
-    "memory",
-    "ai-agent",
-    "episode",
-    "persona"
-  ],
-  "author": "tao.zang",
-  "license": "MIT-0",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/tower1229/Her"
-  },
-  "homepage": "https://github.com/tower1229/Her#readme",
-  "bugs": {
-    "url": "https://github.com/tower1229/Her/issues"
-  },
-  "engines": {
-    "node": ">=22.0.0"
-  },
-  "scripts": {
-    "prebuild": "node -e \"require('fs').rmSync('dist', { recursive: true, force: true })\"",
-    "build": "tsc -p tsconfig.build.json",
-    "typecheck": "tsc --noEmit",
-    "test": "node node_modules/jest/bin/jest.js --runInBand",
-    "test:unit": "node node_modules/jest/bin/jest.js --runInBand",
-    "test:smoke": "node ./scripts/run-openclaw-smoke.mjs",
-    "test:live-experience": "node ./scripts/run-openclaw-live-e2e.mjs",
-    "migrate:memory": "node ./scripts/migrate-existing-memory.mjs --apply",
-    "setup:workspace": "node ./scripts/setup-openclaw-workspace.mjs",
-    "doctor:workspace": "node ./scripts/doctor-openclaw-workspace.mjs",
-    "verify": "npm run typecheck && npm run build && npm run test:unit",
-    "pack:plugin": "npm pack",
-    "release": "node ./scripts/release.mjs"
-  },
-  "bin": {
-    "openclaw-timeline-setup": "./bin/openclaw-timeline-setup.mjs",
-    "openclaw-timeline-doctor": "./bin/openclaw-timeline-doctor.mjs"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "devDependencies": {
-    "@types/jest": "^30.0.0",
-    "@types/node": "^20.x",
-    "jest": "^29.x",
-    "ts-jest": "^29.x",
-    "typescript": "^5.x"
-  },
-  "main": "dist/index.js",
-  "files": [
-    "dist",
-    "bin",
-    "scripts",
-    "templates",
-    "skills",
-    "openclaw.plugin.json",
-    "LICENSE",
-    "README.md",
-    "README_ZH.md"
-  ],
-  "openclaw": {
-    "extensions": [
-      "./dist/index.js"
-    ]
-  }
+{
+  "name": "stella-timeline-plugin",
+  "version": "2.0.3",
+  "description": "Native OpenClaw timeline plugin with a canonical timeline_resolve tool, bundled skill routing, and guarded append-only writes.",
+  "keywords": [
+    "openclaw",
+    "skill",
+    "timeline",
+    "memory",
+    "ai-agent",
+    "episode",
+    "persona"
+  ],
+  "author": "tao.zang",
+  "license": "MIT-0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tower1229/Her"
+  },
+  "homepage": "https://github.com/tower1229/Her#readme",
+  "bugs": {
+    "url": "https://github.com/tower1229/Her/issues"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "scripts": {
+    "prebuild": "node -e \"require('fs').rmSync('dist', { recursive: true, force: true })\"",
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "node node_modules/jest/bin/jest.js --runInBand",
+    "test:unit": "node node_modules/jest/bin/jest.js --runInBand",
+    "test:smoke": "node ./scripts/run-openclaw-smoke.mjs",
+    "test:live-experience": "node ./scripts/run-openclaw-live-e2e.mjs",
+    "migrate:memory": "node ./scripts/migrate-existing-memory.mjs --apply",
+    "setup:workspace": "node ./scripts/setup-openclaw-workspace.mjs",
+    "doctor:workspace": "node ./scripts/doctor-openclaw-workspace.mjs",
+    "verify": "npm run typecheck && npm run build && npm run test:unit",
+    "pack:plugin": "npm pack",
+    "release": "node ./scripts/release.mjs"
+  },
+  "bin": {
+    "openclaw-timeline-setup": "./bin/openclaw-timeline-setup.mjs",
+    "openclaw-timeline-doctor": "./bin/openclaw-timeline-doctor.mjs"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "@types/node": "^20.x",
+    "jest": "^29.x",
+    "ts-jest": "^29.x",
+    "typescript": "^5.x"
+  },
+  "main": "dist/index.js",
+  "files": [
+    "dist",
+    "bin",
+    "scripts",
+    "templates",
+    "skills",
+    "openclaw.plugin.json",
+    "LICENSE",
+    "README.md",
+    "README_ZH.md"
+  ],
+  "openclaw": {
+    "extensions": [
+      "./dist/index.js"
+    ]
+  }
 }

package/scripts/doctor-openclaw-workspace.mjs

@@ -1,153 +1,94 @@
-#!/usr/bin/env node
-import fs from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-import {
-  detectAgentsContract,
-  detectSoulContract,
-  normalizeRootName,
-  resolveCanonicalRootPath,
-} from './workspace-contract.mjs';
-
-const PLUGIN_ID = 'stella-timeline-plugin';
-const DEFAULT_OPENCLAW_CONFIG = path.join(os.homedir(), '.openclaw', 'openclaw.json');
-
-function parseArgs(argv) {
-  const options = {
-    workspace: path.resolve(process.cwd()),
-    canonicalRootName: 'memory',
-    openclawConfig: DEFAULT_OPENCLAW_CONFIG,
-    skipOpenclawConfig: false,
-  };
-
-  for (let i = 0; i < argv.length; i += 1) {
-    const arg = argv[i];
-    if (arg === '--workspace') {
-      options.workspace = path.resolve(argv[++i] || '');
-      continue;
-    }
-    if (arg === '--canonical-root-name') {
-      options.canonicalRootName = normalizeRootName(argv[++i] || '');
-      continue;
-    }
-    if (arg === '--openclaw-config') {
-      options.openclawConfig = path.resolve(argv[++i] || '');
-      continue;
-    }
-    if (arg === '--skip-openclaw-config') {
-      options.skipOpenclawConfig = true;
-      continue;
-    }
-    if (arg === '--help' || arg === '-h') {
-      printHelp();
-      process.exit(0);
-    }
-    throw new Error(`Unknown argument: ${arg}`);
-  }
-
-  return options;
-}
-
-function printHelp() {
-  console.log([
-    'Usage: openclaw-timeline-doctor [options]',
-    '',
-    'Checks whether the required Timeline workspace contracts and openclaw.json config are present.',
-    '',
-    'Options:',
-    '  --workspace <dir>         Workspace to check AGENTS.md / SOUL.md (default: cwd)',
-    '  --canonical-root-name <n> Memory root folder name (default: memory)',
-    '  --openclaw-config <path>  Path to openclaw.json (default: ~/.openclaw/openclaw.json)',
-    '  --skip-openclaw-config    Skip checking openclaw.json',
-  ].join('\n'));
-}
-
-function readText(filePath) {
-  return fs.existsSync(filePath) ? fs.readFileSync(filePath, 'utf8') : '';
-}
-
-function check(label, passed, successDetail, failureDetail) {
-  const prefix = passed ? '[ok]' : '[missing]';
-  console.log(`${prefix} ${label}: ${passed ? successDetail : failureDetail}`);
-  return passed;
-}
-
-function readOpenclawConfig(configPath) {
-  if (!fs.existsSync(configPath)) return null;
-  try {
-    return JSON.parse(fs.readFileSync(configPath, 'utf8'));
-  } catch {
-    return null;
-  }
-}
-
-function main() {
-  const options = parseArgs(process.argv.slice(2));
-  const agentsPath = path.join(options.workspace, 'AGENTS.md');
-  const soulPath = path.join(options.workspace, 'SOUL.md');
-  const canonicalRootPath = resolveCanonicalRootPath(options.workspace, options.canonicalRootName);
-
-  const agentsContent = readText(agentsPath);
-  const soulContent = readText(soulPath);
-
-  let ok = true;
-  ok = check(
-    'AGENTS contract',
-    fs.existsSync(agentsPath) && detectAgentsContract(agentsContent),
-    agentsPath,
-    `${agentsPath} is missing the Timeline daily-log contract`,
-  ) && ok;
-  ok = check(
-    'SOUL contract',
-    fs.existsSync(soulPath) && detectSoulContract(soulContent),
-    soulPath,
-    `${soulPath} is missing the Timeline recall contract`,
-  ) && ok;
-  ok = check(
-    'Canonical memory root',
-    fs.existsSync(canonicalRootPath),
-    canonicalRootPath,
-    `${canonicalRootPath} does not exist`,
-  ) && ok;
-
-  if (!options.skipOpenclawConfig) {
-    const config = readOpenclawConfig(options.openclawConfig);
-    if (!config) {
-      ok = check('openclaw.json', false, '', `${options.openclawConfig} not found or not valid JSON`) && ok;
-    } else {
-      const pluginAllowed = Array.isArray(config.plugins?.allow) && config.plugins.allow.includes(PLUGIN_ID);
-      const pluginEnabled = config.plugins?.entries?.[PLUGIN_ID]?.enabled === true;
-      const pluginPathSet = Array.isArray(config.plugins?.load?.paths) && config.plugins.load.paths.length > 0;
-
-      ok = check(
-        `plugins.allow contains "${PLUGIN_ID}"`,
-        pluginAllowed,
-        options.openclawConfig,
-        `add "${PLUGIN_ID}" to plugins.allow in ${options.openclawConfig}`,
-      ) && ok;
-      ok = check(
-        `plugins.entries.${PLUGIN_ID}.enabled`,
-        pluginEnabled,
-        options.openclawConfig,
-        `set plugins.entries.${PLUGIN_ID}.enabled=true in ${options.openclawConfig}`,
-      ) && ok;
-      ok = check(
-        'plugins.load.paths is set',
-        pluginPathSet,
-        options.openclawConfig,
-        `add plugin directory to plugins.load.paths in ${options.openclawConfig}`,
-      ) && ok;
-    }
-  }
-
-  if (!ok) {
-    process.exitCode = 1;
-  }
-}
-
-try {
-  main();
-} catch (error) {
-  console.error(error instanceof Error ? error.message : String(error));
-  process.exit(1);
-}
+#!/usr/bin/env node
+import fs from 'node:fs';
+import path from 'node:path';
+import {
+  detectAgentsContract,
+  detectSoulContract,
+  normalizeRootName,
+  resolveCanonicalRootPath,
+} from './workspace-contract.mjs';
+
+function parseArgs(argv) {
+  const options = {
+    workspace: path.resolve(process.cwd()),
+    canonicalRootName: 'memory',
+  };
+
+  for (let i = 0; i < argv.length; i += 1) {
+    const arg = argv[i];
+    if (arg === '--workspace') {
+      options.workspace = path.resolve(argv[++i] || '');
+      continue;
+    }
+    if (arg === '--canonical-root-name') {
+      options.canonicalRootName = normalizeRootName(argv[++i] || '');
+      continue;
+    }
+    if (arg === '--help' || arg === '-h') {
+      printHelp();
+      process.exit(0);
+    }
+    throw new Error(`Unknown argument: ${arg}`);
+  }
+
+  return options;
+}
+
+function printHelp() {
+  console.log([
+    'Usage: openclaw-timeline-doctor [--workspace <dir>] [--canonical-root-name <name>]',
+    '',
+    'Checks whether the required Timeline workspace contracts are present.',
+  ].join('\n'));
+}
+
+function readText(filePath) {
+  return fs.existsSync(filePath) ? fs.readFileSync(filePath, 'utf8') : '';
+}
+
+function check(label, passed, successDetail, failureDetail) {
+  const prefix = passed ? '[ok]' : '[missing]';
+  console.log(`${prefix} ${label}: ${passed ? successDetail : failureDetail}`);
+  return passed;
+}
+
+function main() {
+  const options = parseArgs(process.argv.slice(2));
+  const agentsPath = path.join(options.workspace, 'AGENTS.md');
+  const soulPath = path.join(options.workspace, 'SOUL.md');
+  const canonicalRootPath = resolveCanonicalRootPath(options.workspace, options.canonicalRootName);
+
+  const agentsContent = readText(agentsPath);
+  const soulContent = readText(soulPath);
+
+  let ok = true;
+  ok = check(
+    'AGENTS contract',
+    fs.existsSync(agentsPath) && detectAgentsContract(agentsContent),
+    agentsPath,
+    `${agentsPath} is missing the Timeline daily-log contract`,
+  ) && ok;
+  ok = check(
+    'SOUL contract',
+    fs.existsSync(soulPath) && detectSoulContract(soulContent),
+    soulPath,
+    `${soulPath} is missing the Timeline recall contract`,
+  ) && ok;
+  ok = check(
+    'Canonical memory root',
+    fs.existsSync(canonicalRootPath),
+    canonicalRootPath,
+    `${canonicalRootPath} does not exist`,
+  ) && ok;
+
+  if (!ok) {
+    process.exitCode = 1;
+  }
+}
+
+try {
+  main();
+} catch (error) {
+  console.error(error instanceof Error ? error.message : String(error));
+  process.exit(1);
+}