@modootoday/pmcp 0.13.0 → 0.13.1

package/NOTICE

@@ -40,9 +40,11 @@ their own terms and are not covered by the licence above.
   @modelcontextprotocol/core     MIT   Copyright (c) Anthropic, PBC
   zod                            MIT   Copyright (c) Colin McDonnell
   semver                         ISC   See the dependency's LICENSE file.
+  smol-toml              BSD-3-Clause   Copyright (c) Squirrel Chat et al.
+  yaml                           ISC   Copyright Eemeli Aro
 
-The MIT License permits this distribution provided the above notices are
-retained. Full licence texts ship with those packages.
+Full licence texts and copyright notices ship with those packages. Their
+respective licence terms govern distribution of those dependencies.
 
 @huggingface/transformers is an optional peer dependency. It is never
 distributed with this package; a user who wants semantic ranking installs it

package/README.md

@@ -95,6 +95,24 @@ The [configuration guide](docs/project-configuration.md) covers importing
 existing servers, environment references, shared skills and rules, shell guards
 and memory metadata.
 
+## Manage native terminals
+
+PMCP 0.13.0 or later can show a native main runtime, its worker terminals and a
+coordination panel in one terminal workspace. The optional harness and TUI need
+Linux, tmux, util-linux flock, Node.js 22 or later and a working user systemd
+manager. Provider login, folder trust and tool approvals remain native.
+
+```sh
+npx @modootoday/pmcp --version
+npx @modootoday/pmcp harness doctor
+npx @modootoday/pmcp tui doctor
+```
+
+Follow the [native terminal guide](docs/terminal-harness.md) to create an owned
+group and sessions, then [open a terminal workspace](docs/terminal-workspace.md).
+Views start read only; acquiring control and stopping a runtime are explicit
+actions. This optional CLI feature does not add execution tools to the MCP server.
+
 ## Everyday commands
 
 Run these with `npx @modootoday/pmcp`, or with `pmcp` when it is on your PATH:
@@ -130,7 +148,7 @@ With no command, pmcp serves MCP on stdio.
 | [Local mailbox](docs/mailbox.md)                       | Actor credentials, messages, receipts and library integration |
 | [HTTP hosting](docs/hosting.md)                        | Authentication, catalog access and request controls           |
 | [Native terminal control](docs/terminal-harness.md)    | Owned sessions, explicit input, Docker profiles and recovery  |
-| [Terminal workspace](docs/terminal-workspace.md)       | A layout, read-only observation, control and visible failures |
+| [Terminal workspace](docs/terminal-workspace.md)       | Main and worker panels, observation, control and failures     |
 | [Security policy](SECURITY.md)                         | Reporting vulnerabilities                                     |
 
 Semantic search is optional and requires `@huggingface/transformers` installed

package/dist/cli.js

@@ -9013,7 +9013,7 @@ function registerMailboxTools(server, service) {
 
 // src/mcp.ts
 var SERVER_NAME = "pmcp";
-var SERVER_VERSION = "0.13.0";
+var SERVER_VERSION = "0.13.1";
 function registerSkillTools(server, tools) {
   registerCatalogTool(server, tools);
   registerFindTool(server, tools);
@@ -14428,7 +14428,7 @@ function dispatch(argv, options2 = {}) {
   }
   return run(command2, rest, { ui, env, cwd });
 }
-var VERSION = "0.13.0";
+var VERSION = "0.13.1";
 async function run(command2, argv, context) {
   try {
     return await command2.run({

package/dist/{embed-BW6AWD1e.d.ts → embed-BBhv3y5x.d.ts}

@@ -1,4 +1,4 @@
-import { E as Embedder } from './server-9w4R1caM.js';
+import { E as Embedder } from './server-CwWcRjqz.js';
 import { E as EncoderOptions } from './encoder-DGRy9skC.js';
 
 /**

package/dist/http.d.ts

@@ -1,6 +1,6 @@
-import { S as SkillServerOptions, E as Embedder, a as SkillEntry } from './server-9w4R1caM.js';
-import { L as LoadEmbedderOptions } from './embed-BW6AWD1e.js';
-export { l as loadEmbedder } from './embed-BW6AWD1e.js';
+import { S as SkillServerOptions, E as Embedder, a as SkillEntry } from './server-CwWcRjqz.js';
+import { L as LoadEmbedderOptions } from './embed-BBhv3y5x.js';
+export { l as loadEmbedder } from './embed-BBhv3y5x.js';
 import { M as MailboxService } from './service-qpCsOXkQ.js';
 export { D as DEFAULT_MODEL_ID } from './encoder-DGRy9skC.js';
 import 'zod';

package/dist/http.js

@@ -2190,7 +2190,7 @@ function registerMailboxTools(server, service) {
 
 // src/mcp.ts
 var SERVER_NAME = "pmcp";
-var SERVER_VERSION = "0.13.0";
+var SERVER_VERSION = "0.13.1";
 function registerSkillTools(server, tools) {
   registerCatalogTool(server, tools);
   registerFindTool(server, tools);

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-import { I as IntentCache, R as Ranking, S as SkillServerOptions, E as Embedder, C as CatalogOptions, a as SkillEntry, M as MetadataValue, b as SkillTools } from './server-9w4R1caM.js';
-export { A as ASSET_KINDS, c as AssetKind, B as BundleFile, d as CATALOG_PAGE_MAX, e as CATALOG_PAGE_SIZE, f as COMPATIBILITY_MAX, g as CallResponse, h as CatalogItem, i as CatalogResponse, j as Classified, D as DEFAULT_FIND_LIMIT, k as DESCRIBE_FILE_LIMIT, l as DESCRIPTION_MAX, F as FileKind, m as FindOptions, n as FindResult, o as IntentCacheStats, K as KindFilter, p as MAX_SKILL_DEPTH, q as Match, r as MetadataLeaf, N as NAME_MAX, s as READ_BUDGET_BYTES, t as RUNTIMES, u as ReadResult, v as Runtime, w as SKIPPED_DIRS, x as SkillBundle, y as SkillFile, z as SkillFileContent, G as SkillFileListing, H as SkillFilters, J as bundleResponseSchema, L as bundleSkill, O as catalogResponseSchema, P as classify, Q as cosine, T as createSkillTools, U as describeResponseSchema, V as detectRuntime, W as displayPath, X as find, Y as findResultSchema, Z as isUtf8Text, _ as kindOf, $ as lexicalScore, a0 as listSkillFiles, a1 as mimeOf, a2 as normaliseIntent, a3 as parseSkillFrontmatter, a4 as readBody, a5 as readCatalog, a6 as readFrontmatter, a7 as readSkillFile, a8 as runtimeOfClient, a9 as specProblems, aa as verifiedRuntimesOf, ab as withoutBody } from './server-9w4R1caM.js';
-import { L as LoadEmbedderOptions } from './embed-BW6AWD1e.js';
-export { E as EntryVectorStore, e as encodeEntries, l as loadEmbedder, o as openEntryVectors } from './embed-BW6AWD1e.js';
+import { I as IntentCache, R as Ranking, S as SkillServerOptions, E as Embedder, C as CatalogOptions, a as SkillEntry, M as MetadataValue, b as SkillTools } from './server-CwWcRjqz.js';
+export { A as ASSET_KINDS, c as AssetKind, B as BundleFile, d as CATALOG_PAGE_MAX, e as CATALOG_PAGE_SIZE, f as COMPATIBILITY_MAX, g as CallResponse, h as CatalogItem, i as CatalogResponse, j as Classified, D as DEFAULT_FIND_LIMIT, k as DESCRIBE_FILE_LIMIT, l as DESCRIPTION_MAX, F as FileKind, m as FindOptions, n as FindResult, o as IntentCacheStats, K as KindFilter, p as MAX_SKILL_DEPTH, q as Match, r as MetadataLeaf, N as NAME_MAX, s as READ_BUDGET_BYTES, t as RUNTIMES, u as ReadResult, v as Runtime, w as SKIPPED_DIRS, x as SkillBundle, y as SkillFile, z as SkillFileContent, G as SkillFileListing, H as SkillFilters, J as bundleResponseSchema, L as bundleSkill, O as catalogResponseSchema, P as classify, Q as cosine, T as createSkillTools, U as describeResponseSchema, V as detectRuntime, W as displayPath, X as find, Y as findResultSchema, Z as isUtf8Text, _ as kindOf, $ as lexicalScore, a0 as listSkillFiles, a1 as mimeOf, a2 as normaliseIntent, a3 as parseSkillFrontmatter, a4 as readBody, a5 as readCatalog, a6 as readFrontmatter, a7 as readSkillFile, a8 as runtimeOfClient, a9 as specProblems, aa as verifiedRuntimesOf, ab as withoutBody } from './server-CwWcRjqz.js';
+import { L as LoadEmbedderOptions } from './embed-BBhv3y5x.js';
+export { E as EntryVectorStore, e as encodeEntries, l as loadEmbedder, o as openEntryVectors } from './embed-BBhv3y5x.js';
 export { D as DEFAULT_MODEL_ID, a as EmbeddingModel, b as EncoderDtype, E as EncoderOptions, c as EncoderSpec, R as ResolvedEncoder, e as embeddingModels, d as encoderSpec, r as resolveEncoder } from './encoder-DGRy9skC.js';
 import { P as ProjectConfig } from './config-CJ43_oBS.js';
 export { C as CONFIG_FILE, a as CatalogSection, b as ConfigError, E as EmbeddingSection, f as findConfig, r as readConfig } from './config-CJ43_oBS.js';
@@ -282,7 +282,7 @@ declare function resolveSkillFileUri(uri: string, entries: readonly SkillEntry[]
 
 /** Reported to the host on connect. */
 declare const SERVER_NAME = "pmcp";
-declare const SERVER_VERSION = "0.13.0";
+declare const SERVER_VERSION = "0.13.1";
 /**
  * Registers the skill_* tools on a server.
  *

package/dist/index.js

@@ -4497,7 +4497,7 @@ function registerMailboxTools(server, service) {
 
 // src/mcp.ts
 var SERVER_NAME = "pmcp";
-var SERVER_VERSION = "0.13.0";
+var SERVER_VERSION = "0.13.1";
 function registerSkillTools(server, tools) {
   registerCatalogTool(server, tools);
   registerFindTool(server, tools);

package/dist/stdio.d.ts

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { serveStdio } from '@modelcontextprotocol/server/stdio';
-import { S as SkillServerOptions, C as CatalogOptions } from './server-9w4R1caM.js';
+import { S as SkillServerOptions, C as CatalogOptions } from './server-CwWcRjqz.js';
 import { M as MailboxService } from './service-qpCsOXkQ.js';
 import { M as MailboxAttachmentOptions } from './attachment-tU5FZrgZ.js';
 import 'zod';

package/dist/stdio.js

@@ -1837,7 +1837,7 @@ function registerMailboxTools(server, service) {
 
 // src/mcp.ts
 var SERVER_NAME = "pmcp";
-var SERVER_VERSION = "0.13.0";
+var SERVER_VERSION = "0.13.1";
 function registerSkillTools(server, tools) {
   registerCatalogTool(server, tools);
   registerFindTool(server, tools);

package/docs/terminal-workspace.md

@@ -1,11 +1,12 @@
 # Terminal workspace
 
-Use pmcp tui to view an existing main runtime and its workers in one terminal.
+Use `pmcp tui` to view an existing main runtime and its workers in one terminal.
 The main conversation stays in its native interface. PMCP adds a worker dock,
 coordination panel and explicit control switching. Provider login, folder trust
 and tool approvals stay in their native screens.
 
-The host requires Linux, tmux, util-linux flock, Node.js 22 or later and a working
+This feature requires PMCP 0.13.0 or later. The host requires Linux, tmux,
+util-linux flock, Node.js 22 or later and a working
 user systemd manager. The PMCP CLI supports Node or Bun; pane helpers use Node.
 The presentation gets its own 512 MiB, 128-task, one-CPU scope. Native sessions
 retain their existing group budgets and execution profile.
@@ -16,6 +17,7 @@ First [create a harness group and its sessions](terminal-harness.md). Set GROUP_
 to that group's private state path, then check prerequisites and create a view:
 
 ```sh
+pmcp --version
 pmcp tui doctor
 pmcp tui create --group-file "$GROUP_FILE" --columns 160 --rows 48
 ```
@@ -38,18 +40,18 @@ Views refer to an existing owned group and do not start a provider.
 
 Press Ctrl-g, release it, then press a key:
 
-| Key | Action | CLI operation |
-| --- | --- | --- |
-| m | Return to main and release worker control | main |
-| w or 1–4 | Observe a worker | observe --index 1 |
-| c | Request control of the current native target | control |
-| r | Release control | release |
-| h | Read owned native history | history |
-| b | Show configured inbox metadata | mailbox |
-| g | Open compact management window | management |
-| d | Detach the view, preserving runtimes | detach |
-| ! | Dismiss the last visible error | dismiss |
-| ? | Show key help | Help in the status line |
+| Key      | Action                                       | CLI operation           |
+| -------- | -------------------------------------------- | ----------------------- |
+| m        | Return to main and release worker control    | main                    |
+| w or 1–4 | Observe a worker                             | observe --index 1       |
+| c        | Request control of the current native target | control                 |
+| r        | Release control                              | release                 |
+| h        | Read owned native history                    | history                 |
+| b        | Show configured inbox metadata               | mailbox                 |
+| g        | Open compact management window               | management              |
+| d        | Detach the view, preserving runtimes         | detach                  |
+| !        | Dismiss the last visible error               | dismiss                 |
+| ?        | Show key help                                | Help in the status line |
 
 CLI operations use pmcp tui OPERATION --view "$VIEW_FILE". Worker indices follow
 the dock; CLI observe supports all available indices. Press Ctrl-g twice to

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modootoday/pmcp",
-  "version": "0.13.0",
+  "version": "0.13.1",
   "license": "Elastic-2.0",
   "author": "modootoday",
   "description": "Use the skills your packages already ship, and keep your AI tools' project configuration in one place.",
@@ -71,9 +71,10 @@
     "clean": "rimraf dist",
     "catalog:refresh": "node scripts/refresh-catalog.mjs",
     "observations:refresh": "node scripts/refresh-observations.mjs",
-    "site:build": "node scripts/build-catalog-pages.mjs && node scripts/build-observation-pages.mjs && node scripts/build-sitemap.mjs",
+    "site:build": "node scripts/build-site-assets.mjs && node scripts/build-catalog-pages.mjs && node scripts/build-observation-pages.mjs && node scripts/build-guide-pages.mjs && node scripts/build-sitemap.mjs",
+    "docs:check": "prettier --check --ignore-path /dev/null README.md docs/*.md && node scripts/build-guide-pages.mjs --check && node scripts/build-site-assets.mjs --check",
     "site:deployed": "node scripts/check-deployed.mjs",
-    "prepack": "npm run build && npm run typecheck && npm test",
+    "prepack": "npm run docs:check && npm run build && npm run typecheck && npm test",
     "format": "prettier --write .",
     "format:check": "prettier --check ."
   },
@@ -96,8 +97,11 @@
     "@types/node": "^22.15.21",
     "@types/semver": "7.8.0",
     "@typescript/native-preview": "7.0.0-dev.20260707.2",
+    "esbuild": "0.27.4",
+    "marked": "18.1.0",
     "prettier": "^3.6.2",
     "rimraf": "^6.0.1",
+    "three": "0.186.1",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
     "vitest": "^4.0.18"

package/dist/{server-9w4R1caM.d.ts → server-CwWcRjqz.d.ts}

@@ -346,11 +346,11 @@ declare const catalogItemSchema: z.ZodObject<{
         mcp: "mcp";
     }>>;
     verifiedRuntimes: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-        antigravity: "antigravity";
         "claude-code": "claude-code";
         "codex-cli": "codex-cli";
         "gemini-cli": "gemini-cli";
         "grok-cli": "grok-cli";
+        antigravity: "antigravity";
     }>>>;
     verified: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$loose>;
@@ -372,11 +372,11 @@ declare const catalogResponseSchema: z.ZodObject<{
                 mcp: "mcp";
             }>>;
             verifiedRuntimes: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-                antigravity: "antigravity";
                 "claude-code": "claude-code";
                 "codex-cli": "codex-cli";
                 "gemini-cli": "gemini-cli";
                 "grok-cli": "grok-cli";
+                antigravity: "antigravity";
             }>>>;
             verified: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$loose>>;
@@ -388,11 +388,11 @@ declare const findResultSchema: z.ZodObject<{
         lexical: "lexical";
     }>;
     runtime: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-        antigravity: "antigravity";
         "claude-code": "claude-code";
         "codex-cli": "codex-cli";
         "gemini-cli": "gemini-cli";
         "grok-cli": "grok-cli";
+        antigravity: "antigravity";
     }>>>;
     matches: z.ZodArray<z.ZodObject<{
         name: z.ZodString;
@@ -400,11 +400,11 @@ declare const findResultSchema: z.ZodObject<{
         description: z.ZodString;
         score: z.ZodNumber;
         verifiedRuntimes: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-            antigravity: "antigravity";
             "claude-code": "claude-code";
             "codex-cli": "codex-cli";
             "gemini-cli": "gemini-cli";
             "grok-cli": "grok-cli";
+            antigravity: "antigravity";
         }>>>;
         verified: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$loose>>;