nextclaw 0.22.4 → 0.24.0

package/dist/cli/launcher/index.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { t as createNextclawDistribution } from "../../nextclaw-distribution.utils-BJZhAnGk.js";
+import { t as createNextclawDistribution } from "../../nextclaw-distribution.utils-BMyt0993.js";
 import { NextclawDistributionService, runNextclawNpmRuntimeLauncher } from "@nextclaw/service";
 //#region src/cli/launcher/index.ts
 NextclawDistributionService.configure(createNextclawDistribution(import.meta.url));

package/dist/{nextclaw-distribution.utils-BJZhAnGk.js → nextclaw-distribution.utils-BMyt0993.js}

@@ -1,14 +1,15 @@
 import { readFileSync } from "node:fs";
-import { dirname, resolve } from "node:path";
+import { basename, dirname, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 //#region src/cli/shared/lib/distribution/nextclaw-distribution.utils.ts
 function createNextclawDistribution(importMetaUrl) {
-	const packageRoot = resolve(dirname(fileURLToPath(importMetaUrl)), "../../..");
+	const entrypoint = fileURLToPath(importMetaUrl);
+	const packageRoot = resolve(dirname(entrypoint), "../../..");
 	const { version } = JSON.parse(readFileSync(resolve(packageRoot, "package.json"), "utf-8"));
 	return {
 		version: typeof version === "string" ? version : "0.0.0",
-		packageRoot,
 		appEntrypoint: resolve(packageRoot, "dist/cli/app/index.js"),
+		launcherEntrypoint: resolve(dirname(entrypoint), "../launcher", basename(entrypoint)),
 		uiDistDir: resolve(packageRoot, "ui-dist"),
 		runtimeUpdatePublicKeyPath: resolve(packageRoot, "resources/update-bundle-public.pem")
 	};
@@ -16,4 +17,4 @@ function createNextclawDistribution(importMetaUrl) {
 //#endregion
 export { createNextclawDistribution as t };
 
-//# sourceMappingURL=nextclaw-distribution.utils-BJZhAnGk.js.map
+//# sourceMappingURL=nextclaw-distribution.utils-BMyt0993.js.map

package/dist/nextclaw-distribution.utils-BMyt0993.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nextclaw-distribution.utils-BMyt0993.js","names":[],"sources":["../src/cli/shared/lib/distribution/nextclaw-distribution.utils.ts"],"sourcesContent":["import { readFileSync } from \"node:fs\";\nimport { basename, dirname, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport type { NextclawDistribution } from \"@nextclaw/service\";\n\nexport function createNextclawDistribution(importMetaUrl: string): NextclawDistribution {\n  const entrypoint = fileURLToPath(importMetaUrl);\n  const packageRoot = resolve(dirname(entrypoint), \"../../..\");\n  const { version } = JSON.parse(readFileSync(resolve(packageRoot, \"package.json\"), \"utf-8\")) as { version?: string };\n  return {\n    version: typeof version === \"string\" ? version : \"0.0.0\",\n    appEntrypoint: resolve(packageRoot, \"dist/cli/app/index.js\"),\n    launcherEntrypoint: resolve(dirname(entrypoint), \"../launcher\", basename(entrypoint)),\n    uiDistDir: resolve(packageRoot, \"ui-dist\"),\n    runtimeUpdatePublicKeyPath: resolve(packageRoot, \"resources/update-bundle-public.pem\")\n  };\n}\n"],"mappings":";;;;AAKA,SAAgB,2BAA2B,eAA6C;CACtF,MAAM,aAAa,cAAc,cAAc;CAC/C,MAAM,cAAc,QAAQ,QAAQ,WAAW,EAAE,WAAW;CAC5D,MAAM,EAAE,YAAY,KAAK,MAAM,aAAa,QAAQ,aAAa,eAAe,EAAE,QAAQ,CAAC;AAC3F,QAAO;EACL,SAAS,OAAO,YAAY,WAAW,UAAU;EACjD,eAAe,QAAQ,aAAa,wBAAwB;EAC5D,oBAAoB,QAAQ,QAAQ,WAAW,EAAE,eAAe,SAAS,WAAW,CAAC;EACrF,WAAW,QAAQ,aAAa,UAAU;EAC1C,4BAA4B,QAAQ,aAAa,qCAAqC;EACvF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nextclaw",
-  "version": "0.22.4",
+  "version": "0.24.0",
   "description": "Powerful AI assistant for coordinating agents, skills, CLI tools, automations, and messaging apps.",
   "private": false,
   "type": "module",
@@ -41,20 +41,20 @@
     "commander": "^12.1.0",
     "jszip": "^3.10.1",
     "yaml": "^2.8.1",
-    "@nextclaw/core": "0.15.3",
-    "@nextclaw/kernel": "0.6.4",
-    "@nextclaw/mcp": "0.3.3",
-    "@nextclaw/ncp": "0.7.3",
-    "@nextclaw/ncp-agent-runtime": "0.4.3",
-    "@nextclaw/ncp-toolkit": "0.6.4",
-    "@nextclaw/nextclaw-hermes-acp-bridge": "0.3.3",
-    "@nextclaw/nextclaw-ncp-runtime-http-client": "0.3.3",
-    "@nextclaw/nextclaw-ncp-runtime-stdio-client": "0.3.4",
-    "@nextclaw/ncp-mcp": "0.2.3",
-    "@nextclaw/remote": "0.3.4",
-    "@nextclaw/runtime": "0.4.3",
-    "@nextclaw/service": "0.3.4",
-    "@nextclaw/server": "0.15.4"
+    "@nextclaw/core": "0.15.5",
+    "@nextclaw/ncp": "0.7.4",
+    "@nextclaw/ncp-agent-runtime": "0.4.4",
+    "@nextclaw/ncp-mcp": "0.2.5",
+    "@nextclaw/ncp-toolkit": "0.6.5",
+    "@nextclaw/mcp": "0.3.5",
+    "@nextclaw/kernel": "0.6.6",
+    "@nextclaw/nextclaw-ncp-runtime-stdio-client": "0.3.6",
+    "@nextclaw/nextclaw-hermes-acp-bridge": "0.3.4",
+    "@nextclaw/nextclaw-ncp-runtime-http-client": "0.3.4",
+    "@nextclaw/service": "0.3.6",
+    "@nextclaw/runtime": "0.4.5",
+    "@nextclaw/remote": "0.3.6",
+    "@nextclaw/server": "0.15.6"
   },
   "devDependencies": {
     "@types/node": "^20.17.6",
@@ -62,7 +62,7 @@
     "tsx": "^4.19.2",
     "typescript": "^5.6.3",
     "vitest": "^4.1.2",
-    "@nextclaw/ui": "0.15.4"
+    "@nextclaw/ui": "0.15.6"
   },
   "scripts": {
     "dev": "tsx watch --tsconfig ../../scripts/dev/dev-runtime.tsconfig.json src/cli/app/index.ts",

package/resources/USAGE.md

@@ -432,6 +432,31 @@ NextClaw UI now provides an OpenClaw-aligned session operations panel (**Session
 - delete one session
 - localized Sessions UI copy (i18n labels for the panel)
 
+### Project and session management (UI, CLI, and AI)
+
+Projects are maintained independently from sessions, so a project can exist before its first conversation. The default workspace remains the fallback working directory and is not registered as an explicit project.
+
+In the Chat sidebar, switch to the project view and choose **New Project**. The dialog supports empty and knowledge-base templates plus an optional target directory. Its server-side directory picker provides address navigation, back/forward, breadcrumbs, search, refresh, and **New Folder**; leaving the target blank creates a same-named folder under the default workspace.
+
+```bash
+# List projects and templates
+nextclaw projects list --json
+nextclaw projects templates --json
+
+# Create an empty project under the default workspace
+nextclaw projects create research --template empty --json
+
+# Create a knowledge-base project at an explicit path
+nextclaw projects create knowledge --path ~/Projects/knowledge --template knowledge-base --json
+
+# Rename a session and manage its project binding
+nextclaw sessions rename <session-id> "Research session" --json
+nextclaw sessions set-project <session-id> ~/Projects/research --json
+nextclaw sessions clear-project <session-id> --json
+```
+
+The UI, CLI, and built-in AI tools all use the same kernel-owned operations. AI exposes them through `projects_list`, `projects_create`, and `sessions_update`. Project creation never overwrites a non-empty directory. Binding an existing directory registers it as a project; binding the default workspace clears the explicit project binding instead.
+
 This is useful when running multi-agent routing and channel operations long term, because you can clean or retarget problematic sessions without hand-editing files.
 
 ## Agent chat in UI
@@ -496,15 +521,18 @@ Skill loading contract:
 - NextClaw ships with built-in skills and auto-loads them directly from the app package.
 - `<workspace>/skills/` is for custom skills and marketplace-installed skills.
 - With the default workspace, the default skill directory is `~/.nextclaw/workspace/skills/`.
+- When a session is bound to a project, project-only skills load from `<project>/.agents/skills/`.
+- User-wide Agent Skills load from `~/.agents/skills/` and appear in the skill picker under the global source.
+- The skill picker and AI context group project, NextClaw workspace, global, and built-in skills by source.
 - Use `nextclaw skills installed` / `nextclaw skills info <selector>` for the **installed/local domain**.
 - Use `nextclaw marketplace skills search|info|recommend|install|update` for the **marketplace/catalog and installed marketplace lifecycle domain**.
 - `nextclaw skills install <slug>` remains available as a compatibility shortcut for marketplace installation into that directory.
 - Marketplace-installed skills write a local `.nextclaw-install.json` state file so `update` can compare the installed copy with the marketplace source.
 - Built-in marketplace skills are already available by default; marketplace install does not copy them into the workspace when the target skill is built-in.
 - Historical copied built-in skills under `<workspace>/skills/` are deprecated artifacts.
-- If a built-in skill and a workspace skill share the same name, NextClaw ignores the workspace copy and uses the built-in definition as the source of truth.
+- If a built-in skill and another source share the same name, NextClaw uses the built-in definition as the source of truth.
 - If you want to install into a specific project workspace, pass `--workdir <workspace>`.
-- Upstream commands such as `npx skills add ... -g` do not install a skill into NextClaw's workspace and do not make it selectable in NextClaw by themselves.
+- Upstream commands such as `npx skills add ... -g` remain separate from the NextClaw marketplace lifecycle. If they materialize a skill under `~/.agents/skills/`, NextClaw can select it as a global skill, but it is not installed or managed as a NextClaw workspace skill.
 
 
 ---
@@ -543,6 +571,12 @@ Skill loading contract:
 | `nextclaw agents new <agent-id>` | Create a new agent with default home/template/avatar |
 | `nextclaw agents update <agent-id>` | Update an existing agent's display metadata |
 | `nextclaw agents remove <agent-id>` | Remove an extra agent (built-in `main` cannot be removed) |
+| `nextclaw projects list` | List registered projects, including projects without sessions |
+| `nextclaw projects templates` | List built-in project templates |
+| `nextclaw projects create <name>` | Create an empty or knowledge-base project |
+| `nextclaw sessions rename <session-id> <label>` | Rename a session |
+| `nextclaw sessions set-project <session-id> <directory>` | Bind a session to an existing project directory |
+| `nextclaw sessions clear-project <session-id>` | Clear a session project binding |
 | `nextclaw login --api-base <url>` | Start browser sign-in for NextClaw Platform and save the platform token locally (`--no-open` for headless servers, `--email/--password` for direct fallback) |
 | `nextclaw remote enable` | Enable service-managed remote access |
 | `nextclaw remote disable` | Disable service-managed remote access |

package/ui-dist/assets/abnfDiagram-VRR7QNED-BYpK0F5F.js

@@ -0,0 +1 @@
+import{n as e}from"./chunk-5HE753X5-DU81hkcF.js";import{n as t}from"./chunk-Y2CYZVJY-BGrd8tLy.js";import{m as n}from"./src-Dad2ZbCt.js";import"./chunk-WYO6CB5R-Do6SJrnY.js";import"./chunk-VAUOI2AC-Dpcz6BhT.js";import{n as r,r as i,t as a}from"./chunk-MOJQB5TN-BPFLzWgj.js";import{t as o}from"./chunk-JWPE2WC7-DIaTv8kx.js";import{t as s}from"./mermaid-parser.core-Cue18vLo.js";var c=e().RailroadAbnf.parser.LangiumParser,l=t(e=>{let t=e.alternatives.map(u);return t.length===1?t[0]:{type:`choice`,alternatives:t}},`transformAlternation`),u=t(e=>{let t=e.elements.map(f);return t.length===1?t[0]:{type:`sequence`,elements:t}},`transformConcatenation`),d=t(e=>{if(e.includes(`*`)){let[t,n]=e.split(`*`);return{min:t?parseInt(t,10):0,max:n?parseInt(n,10):1/0}}let t=parseInt(e,10);return{min:t,max:t}},`parseRepeat`),f=t(e=>{let t=p(e.primary);if(!e.repeat)return t;let{min:n,max:r}=d(e.repeat);return n===0&&r===1?{type:`optional`,element:t}:{type:`repetition`,element:t,min:n,max:r}},`transformElement`),p=t(e=>{switch(e.$type){case`AbnfStringLiteral`:return{type:`terminal`,value:e.value};case`AbnfNumVal`:return{type:`terminal`,value:e.value};case`AbnfRuleName`:return{type:`nonterminal`,name:e.name};case`AbnfGroup`:return l(e.element);case`AbnfOptionalGroup`:return{type:`optional`,element:l(e.element)};default:throw Error(`Unsupported ABNF primary node: ${e.$type}`)}},`transformPrimary`),m=t(e=>({name:e.name,definition:l(e.definition)}),`transformRule`),h=t(e=>{o(e,a),e.title&&a.setTitle(e.title),e.rules.map(e=>a.addRule(m(e)))},`populateDb`),g={parser:{parse:t(e=>{a.clear(),n.debug(`[ABNF Parser] Starting Langium parse`);let t=c.parse(e);if(t.lexerErrors.length>0||t.parserErrors.length>0)throw new s(t);let r=t.value;n.debug(`[ABNF Parser] Parsed rules:`,r.rules.length),h(r),n.debug(`[ABNF Parser] Parse complete`)},`parse`),parser:{yy:a}},db:a,renderer:i,styles:r};export{g as diagram};