agenr 3.1.0 → 3.3.0

package/CHANGELOG.md

@@ -2,6 +2,61 @@
 
 ## [Unreleased]
 
+## [3.3.0] - 2026-06-02
+
+Feature flag defaults, Skeln install policy, and OpenClaw package cleanup release.
+
+### Added
+
+- **Init now records every known feature flag as enabled.** First-run `agenr init` writes the full current feature surface into `config.json`, making staged working-memory, session-tree, and goal-continuation flags explicit.
+- **Fresh Skeln installs now carry a memory-policy default.** The Skeln plugin manifest seeds a conservative `memoryPolicy` that keeps session-start and before-turn injection off while leaving working context available.
+
+### Changed
+
+- **The OpenClaw plugin package now publishes as `@agenr/openclaw-plugin`.** Install docs, build filters, smoke tests, and package metadata were aligned with the new scoped package name.
+- **OpenClaw runtime dependencies now stay with the plugin package.** The root `agenr` package no longer carries OpenClaw as a runtime dependency, while plugin builds and package smoke tests still cover the OpenClaw integration.
+- **Repository release metadata is slimmer.** GitHub Actions CI and the synced release procedure were removed in favor of the local release workflow.
+
+### Validation
+
+Changes since last push to `origin/master`:
+
+- Remove OpenClaw from root runtime dependencies and keep plugin build coverage intact
+- Rename the OpenClaw plugin package to `@agenr/openclaw-plugin` across install docs, build filters, smoke tests, and package metadata
+- Drop GitHub Actions CI and the synced release procedure from the repository
+- Add canonical feature flag keys and have first-run init write every current feature flag as enabled
+- Add a Skeln plugin `memoryPolicy` install default with setup, manifest, and regression coverage
+
+## [3.2.0] - 2026-06-02
+
+Cross-platform packaging, CI smoke coverage, and path handling hardening release.
+
+### Added
+
+- **Repository checks now cover package smoke workflows across platforms.** The release adds local package smoke tooling, Windows simulation, Docker-based Linux checks, and a slimmer Windows CI workflow.
+- **Path handling now has focused cross-platform helpers and tests.** Shared filesystem path utilities and test helpers cover Windows, Linux, and local temporary-path behavior.
+
+### Changed
+
+- **Package build and smoke scripts are more portable.** Root and plugin package scripts now avoid shell-specific assumptions and handle install paths consistently across supported platforms.
+- **Skeln adapter imports now use explicit shared host types.** The Skeln adapter has a dedicated type boundary for host-facing imports, reducing package-resolution friction during plugin builds.
+
+### Fixed
+
+- **Windows package smoke tests are quoting-safe.** Smoke commands now pass arguments separately, preserve path quotes, avoid `npx`, and restore the `cmd.exe` npm shim path needed by Windows runs.
+- **SQLite and temp-path tests now clean up safely on Windows.** Database and test cleanup paths avoid platform-sensitive deletion and quoting failures.
+- **Line-ending and packaging behavior is more deterministic.** Repository checkout and packaging paths are hardened for Linux and Windows release validation.
+
+### Validation
+
+Changes since last push to `origin/master`:
+
+- Add local package smoke, Windows simulation, and Docker Linux test runners
+- Add a slim Windows CI workflow and deterministic LF checkout configuration
+- Harden package smoke command quoting, argument passing, and npm shim handling on Windows
+- Add shared filesystem path helpers and cross-platform test temp-path helpers
+- Harden SQLite, temp path, Skeln adapter, and plugin build paths for cross-platform package validation
+
 ## [3.1.0] - 2026-05-31
 
 Memory fetch tools, Skeln episode lifecycle hardening, and repository packaging cleanup release.

package/README.md

@@ -18,7 +18,7 @@ agenr gives agents a persistent brain: a local SQLite database of durable knowle
 
 It exists because most agent runtimes forget everything important between sessions. Even when a tool has a built-in memory feature, it is often lossy, file-based, or tightly coupled to one surface. agenr keeps memory structured and queryable: facts, decisions, preferences, lessons, milestones, relationships, and session-level episodes live in one local store instead of getting flattened into prompt text.
 
-What makes agenr different is the combination of local-first storage, semantic embeddings, hybrid recall, episodic temporal memory, and adapter-friendly architecture. The core is hexagonal, so multiple agent systems can share the same brain over time. Today the production host adapters are the OpenClaw memory plugin (`@agenr/agenr-plugin`) and the Skeln extension (`@agenr/skeln-plugin`). The CLI provides offline ingest, recall, and maintenance against that same database.
+What makes agenr different is the combination of local-first storage, semantic embeddings, hybrid recall, episodic temporal memory, and adapter-friendly architecture. The core is hexagonal, so multiple agent systems can share the same brain over time. Today the production host adapters are the OpenClaw memory plugin (`@agenr/openclaw-plugin`) and the Skeln extension (`@agenr/skeln-plugin`). The CLI provides offline ingest, recall, and maintenance against that same database.
 
 ## Features
 
@@ -59,16 +59,18 @@ Run `agenr init` again any time you want to re-run onboarding, reinstall the plu
 If you already have agenr configured, or you want to install the plugin separately:
 
 ```bash
-openclaw plugins install @agenr/agenr-plugin
+openclaw plugins install @agenr/openclaw-plugin
 openclaw gateway restart
 ```
 
+The main `agenr` CLI package does not depend on the OpenClaw SDK at runtime. OpenClaw installs should use the plugin package above.
+
 `agenr init` normally does this for you, updates `openclaw.json`, and offers an initial ingest pass over existing sessions.
 The OpenClaw plugin id remains `agenr`, so `plugins.entries.agenr`, `plugins.slots.memory`, and existing plugin config keys do not change.
 After the plugin is installed, `openclaw plugins update agenr` continues to target that same plugin id.
 If `plugins.entries.agenr.config` is omitted, the plugin falls back to agenr's normal config resolution: `AGENR_CONFIG_PATH`, then `~/.agenr/config.json`, and the `dbPath` from that config or `~/.agenr/knowledge.db`.
 
-If you want to pin an exact plugin release, install a versioned package spec such as `openclaw plugins install @agenr/agenr-plugin@3.0.0`.
+If you want to pin an exact plugin release, install a versioned package spec such as `openclaw plugins install @agenr/openclaw-plugin@3.0.0`.
 
 For local development or a custom build path, run `pnpm build` first and point OpenClaw at the plugin package root:
 
@@ -94,7 +96,7 @@ If `config.json` is not next to `dbPath`, add `"configPath": "/path/to/config.js
 
 Migration note:
 
-- Existing users who originally installed the plugin from the `agenr` package should reinstall once with `openclaw plugins install @agenr/agenr-plugin` so OpenClaw records the new npm package source.
+- Existing users who originally installed the plugin from the `agenr` package should reinstall once with `openclaw plugins install @agenr/openclaw-plugin` so OpenClaw records the new npm package source.
 - After that reinstall, `openclaw plugins update agenr` should continue to work because updates key off the plugin id `agenr`.
 
 ## Quick Start - Skeln Plugin (manual)
@@ -254,7 +256,7 @@ agenr scenarios run --kind store --preserve --verbose
 | Problem                                                           | What to check                                                                                                                                                                                                                        |
 | ----------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
 | `agenr init` cannot complete setup                                | Re-run `agenr setup` and verify the selected auth method is actually available. Subscription flows depend on the relevant external login being present, and non-OpenAI extraction setups still need a separate OpenAI embedding key. |
-| `openclaw plugins install @agenr/agenr-plugin` fails              | Make sure the `openclaw` CLI is installed and on `PATH`. For local development, run `pnpm build` and use `plugins.load.paths` instead.                                                                                               |
+| `openclaw plugins install @agenr/openclaw-plugin` fails           | Make sure the `openclaw` CLI is installed and on `PATH`. For local development, run `pnpm build` and use `plugins.load.paths` instead.                                                                                               |
 | `agenr recall` or `agenr_recall` fails with embedding/auth errors | Embeddings always use OpenAI. Confirm `credentials.openaiApiKey` is configured, or re-run `agenr setup` to set the embedding key explicitly.                                                                                         |
 | SQLite says the database is locked                                | Avoid running multiple writers against the same DB at once. Stop overlapping ingest/reset runs, restart the OpenClaw gateway if needed, then retry.                                                                                  |
 | OpenClaw does not pick up the plugin                              | Restart the gateway, confirm `plugins.slots.memory` is `agenr`, confirm `plugins.allow` contains `agenr`, and for dev installs confirm `plugins.load.paths` points at the built `packages/openclaw-plugin` directory.                |

package/dist/adapters/skeln/index.d.ts

@@ -1,7 +1,65 @@
-import { ExtensionContext, ExtensionAPI } from 'skeln';
-import { C as ClaimSlotPolicyConfig, a as ClaimSlotPolicy } from '../../claim-slot-policy-CdrW_1l4.js';
-import { E as EntryType, b as RecallPorts, r as ProcedureDatabasePort, t as Entry, u as DatabasePort, v as EpisodeDatabasePort, w as EmbeddingPort, L as LlmPort } from '../../ports-CpzWESmZ.js';
-import { AgentMessage } from '@earendil-works/pi-agent-core';
+import { TSchema } from 'typebox';
+import { AgentToolResult, AgentMessage } from '@earendil-works/pi-agent-core';
+import { E as EntryType, c as RecallPorts, P as ProcedureDatabasePort, C as ClaimSlotPolicyConfig, t as Entry, u as ClaimSlotPolicy, v as DatabasePort, w as EpisodeDatabasePort, x as EmbeddingPort, L as LlmPort } from '../../claim-slot-policy-CQ-h0GaV.js';
+
+/** Minimal branch-entry shape needed for before-turn visibility filtering. */
+interface SkelnBranchEntryLike {
+    /** Session tree entry discriminator. */
+    type?: unknown;
+    /** Session tree entry id. */
+    id?: unknown;
+    /** Parent id retained for compatibility with Skeln entries. */
+    parentId?: unknown;
+    /** Message payload when this is a message entry. */
+    message?: unknown;
+    /** First replayed entry after compaction when this is a compaction entry. */
+    firstKeptEntryId?: unknown;
+}
+
+/** Minimal Skeln extension API surface used by the agenr adapter. */
+interface ExtensionAPI {
+    /** Reads one extension setting supplied by Skeln config. */
+    getSetting(key: string): unknown;
+    /** Registers one model-facing tool with the Skeln runtime. */
+    registerTool(tool: SkelnToolDefinition): void;
+}
+/** Minimal Skeln session manager surface used by the agenr adapter. */
+interface SkelnSessionManager {
+    /** Returns the active Skeln session id. */
+    getSessionId(): string | number;
+    /** Returns the active session working directory. */
+    getCwd(): string;
+    /** Returns the active session JSONL file path when available. */
+    getSessionFile(): string;
+    /** Returns active branch entries visible to before-turn recall. */
+    getBranch(): SkelnBranchEntryLike[];
+}
+/** Minimal Skeln extension context surface used by the agenr adapter. */
+interface ExtensionContext {
+    /** Current working directory when provided directly by newer Skeln hosts. */
+    cwd?: string;
+    /** Session manager for identity, cwd fallback, and transcript location. */
+    sessionManager: SkelnSessionManager;
+}
+/** Tool-update callback shape accepted by Skeln tool handlers. */
+type SkelnToolUpdateCallback = (update: unknown) => void;
+/** Minimal Skeln tool definition shape registered by the agenr adapter. */
+interface SkelnToolDefinition {
+    /** Tool name exposed to the model. */
+    name: string;
+    /** Human-readable label shown by host UI. */
+    label?: string;
+    /** Tool description shown to the model and host UI. */
+    description: string;
+    /** Optional prompt snippet injected by Skeln. */
+    promptSnippet?: string;
+    /** Optional model-facing usage guidelines injected by Skeln. */
+    promptGuidelines?: string[];
+    /** TypeBox-compatible parameter schema. */
+    parameters?: TSchema;
+    /** Executes one Skeln tool call. */
+    execute(toolCallId: string, params: unknown, signal: AbortSignal | undefined, onUpdate: SkelnToolUpdateCallback | undefined, context: ExtensionContext): AgentToolResult<Record<string, unknown>> | Promise<AgentToolResult<Record<string, unknown>>>;
+}
 
 /**
  * Canonical feature flags for staged working-memory, session-memory, and goal rollout.