@plurnk/plurnk-meta 2.1.1 → 2.1.3

package/docs/session.md

@@ -0,0 +1,79 @@
+# `session://` — sessions and their entries
+
+## Summary
+
+Coordinate sessions (WORK, FORK), request isolated BARE inference, and manage workspace entries.
+
+Sessions inhabit one workspace. The authority selects a session; a path selects
+an entry rather than controlling that session.
+
+| Address | Meaning | Model access |
+| --- | --- | --- |
+| `session://exampleSessionName` | Named session | WORK/FORK create; SEND messages; READ collects; KILL terminates. |
+| `message://exampleSessionName/ab3d5678` | Retained message | READ/FIND/COPY inspect; SEND replies. Neither EDIT nor KILL changes its source. |
+| `ops://exampleSessionName/1` | What that loop said, or how it ended | READ/FIND/COPY inspect; source is immutable. |
+| `session://exampleSessionName/example.md` | Named scratch entry | Read and write from any session in the workspace. |
+| `persona://examplePersona/PERSONA.md` | Discovered persona role | READ/FIND/COPY inspect; COPY to `session://<name>/AGENTS.md` binds role. |
+| `workspace:///example.md` | Shared commons entry | Read and write. |
+
+The packet's `## Session` block, below the log, names your session, its parent
+(`null` at a root), the loop and turn you are producing, and its `owner`
+(`address` and `interactive`). Addresses are
+literal and keep the same meaning when passed to another session. Scratch
+belongs to the workspace; a namespace does not require a namesake session, and if
+`session://exampleSessionName/AGENTS.md` exists when that session starts (or is written later), its next turn reads the unread revision.
+Generated references live under `plurnk:///` and `mcp:///`, and reference refreshes
+may replace them. EDIT creates or changes an entry, never a session; KILL with
+an entry path deletes that entry, not its session. A control address is scheme
+and authority only: no trailing slash, userinfo, port, query, or fragment.
+Messages and loop outcomes have their own addresses; neither is a scratch
+entry or an actor control.
+
+An entry whose source has a readable projection (HTML, a notebook) carries it
+beside the source as `#readable`, text/markdown, in its own line coordinates;
+the default channel stays the source, and a pattern matches the channel it
+addresses. The projection follows every source write and is never written
+itself.
+
+A READ of an image, PDF or audio source retains its bytes: on a route whose
+model takes that media, every later packet carries them as a native part
+captioned with the READ's log coordinate, until you KILL that READ row. The
+service never re-sends media; a captioned part is your own earlier READ, not a
+new arrival.
+
+## Delegation
+
+[Delegation and messages](plurnk:///delegation.md) covers session
+creation, child observations, waiting, completion, and reply routing.
+
+## BARE inference
+
+BARE makes one isolated call to the model, not a persistent session. Nothing
+reaches it but the fence body: no log, no files, no web, no tools, no memory of
+this loop. It answers from the body and the model's own knowledge alone.
+
+```BARE
+A self-contained prompt, with everything it needs pasted in.
+```
+
+The prompt is not truncated to fit; provider capacity still applies.
+Consecutive BARE calls run concurrently and settle before the turn continues.
+Their answers are ordinary BARE receipts, visible in the next packet.
+
+## Turn sources
+
+| Address | Read-only source in the named session's history |
+| --- | --- |
+| `ops://<session>/<loop>/<turn>` | The exact submitted program, including interstitial text. |
+| `reasoning://<session>/<loop>/<turn>` | Original provider reasoning when exposed, or a harness turn's authored rationale. |
+| `note://<session>/<loop>/<turn>/<item>` | The literal NOTE body, from the program or exposed reasoning; the receipt gives its address. |
+
+The session name is required. Any session in the workspace can READ these
+sources; `log:///` remains your own context. READ brings the selected source
+into your log, and KILL of that READ curates only its log projection, never the
+original evidence. The current turn's reasoning exists when its OPs execute, so
+`READ (reasoning://exampleSessionName/1/3) <1,-1>` from `session://exampleSessionName` on loop 1,
+turn 3 retains it; a turn that produced no reasoning reads empty, and a turn
+that has not happened returns a missing-source result. READ never requests
+inference. Notes are ordinary log items whose read-only sources stay searchable
+(`FIND (note://exampleSessionName/**) /parser/`) and READable after curation or a FORK.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plurnk/plurnk-meta",
-  "version": "2.1.1",
+  "version": "2.1.3",
   "description": "Extension discovery and trust primitives shared by every plurnk kind, and the teaching material the plurnk service gives models: policy, Recap, the plurnk skill and scheme references.",
   "keywords": [
     "plurnk",
@@ -48,7 +48,7 @@
   },
   "scripts": {
     "test:lint": "tsc --noEmit",
-    "test:unit": "node --conditions=plurnk-dev --env-file=.env.defaults --test src/**/*.test.ts",
+    "test:unit": "node --conditions=plurnk-dev --env-file=.env.defaults --experimental-test-coverage --test-coverage-include-all '--test-coverage-include=src/**' --test ${PLURNK_TEST_CONCURRENCY:+--test-concurrency=$PLURNK_TEST_CONCURRENCY} 'src/**/*.test.ts'",
     "test": "npm run test:lint && npm run test:unit",
     "build:clean": "rm -rf dist",
     "build:dist": "tsc -p tsconfig.build.json",
@@ -68,5 +68,5 @@
     "url": "git+https://github.com/plurnk/plurnk-service.git",
     "directory": "plurnk-meta"
   },
-  "gitHead": "f96502a26d62a6f87b22950a9e2006348ac8a6bc"
+  "gitHead": "db65532b51408a2014f7ff53a288d834ff6694f2"
 }

package/skills/plurnk/SKILL.md

@@ -13,12 +13,12 @@ description: Plurnk harness configurations, extensions, and definitions.
 | Every installed package's settings and defaults | [Complete .env.defaults](.env.defaults) |
 | Plugins, extensions, clients and hooks: what each reaches and how it loads | [Extending Plurnk](references/extensibility.md) |
 | Each installed package's contract and type declarations | `packages/<package name>/SPEC.md`, `dist/*.d.ts` |
-| Worker hierarchy, messaging, and delegation | [Worker reference](worker:///_plurnk/plurnk/worker.md) |
-| Which project files you can see, and why a file is missing | [Membership](worker:///_plurnk/plurnk/members.md) |
-| Agent Skills, MCP servers, and A2A agents: what each is and how one is added | `worker:///_plurnk/plurnk/skills.md`, `mcp.md`, `a2a.md` |
-| Running code: the shell and each interpreter's body, stdin, arguments, exit status | `worker:///_plurnk/plurnk/sh.md`, `node.md`, `python3.md`, … |
-| Enabled MCP server invocations and schemas | `worker:///_plurnk/tools/` |
-| Built-in executors and scheme references | `worker:///_plurnk/plurnk/` |
+| Session hierarchy, messaging, and delegation | [Session reference](plurnk:///session.md) |
+| Which project files you can see, and why a file is missing | [Membership](mcp:///plurnk_members.md) |
+| Agent Skills, MCP servers, environment variables, and schedules | `mcp:///plurnk_skills.md`, `mcp:///plurnk_mcp.md`, `mcp:///plurnk_env.md`, `mcp:///plurnk_schedule.md` |
+| Running code: the shell and each interpreter's body, stdin, arguments, exit status | `plurnk:///sh.md`, `plurnk:///js.md`, `plurnk:///python3.md`, … |
+| Enabled MCP server invocations and schemas | `mcp:///` |
+| Built-in executors and scheme references | `plurnk:///` |
 
 READ the relevant reference; FIND can select paths and search their bodies.
 Defaults describe available settings, not the operator's effective configuration.

package/skills/plurnk/references/extensibility.md

@@ -14,12 +14,11 @@ before it cannot do:
 - **Configuration** when what the integration needs already exists: a setting in
   the cascade, or a definition in `mcp.json` or a skill root.
 - **A skill** when the model needs knowledge, or a script it runs with its existing
-  runtimes (`sh`, `node`).
+  runtimes (`sh`, `js`).
 - **An MCP server** when X has an API the model calls as tools. A server X already
   publishes needs only its definition.
 - **A plugin** when skills and MCP servers install together, or travel to other agents.
-- **A client** when X drives Plurnk from outside: an application through AG-UI, an
-  agent through A2A.
+- **A client** when X drives Plurnk from outside through ACP.
 - **A hook** when X hears about Plurnk's lifecycle events and answers nothing.
 - **An extension** only when the model needs something new inside the daemon that
   none of the above can add: a runtime, an address scheme, a media-type reader, a
@@ -34,13 +33,12 @@ before it cannot do:
 | --- | --- | --- | --- |
 | Skill | a directory holding `SKILL.md` | `skill://<name>/` | none |
 | MCP server | one MCP definition | a runtime named for the server, its tools as invocation targets, and its resources as an address scheme | none: a process or a URL |
-| A2A agent | one Agent Card URL | `a2a://<alias>`, a peer that takes tasks | none: a remote agent |
 | Plugin | a directory holding `plugin.json`, `skills/` and `mcp.json` | its skills and MCP servers | none, unless it declares an extension |
 | Extension | a package declaring one kind | a runtime, an address scheme, a media-type reader, a model provider, a page materializer, or what a module contributes | trusted, in the daemon |
 
-Skills, MCP servers and A2A agents are definitions. The `skills`, `mcp` and
-`a2a` runtimes add, replace, enable, disable and remove them in the current workspace,
-and `worker:///_plurnk/plurnk/skills.md`, `mcp.md` and `a2a.md` show each
+Skills and MCP servers are definitions. The `plurnk_skills` and
+`plurnk_mcp` runtimes (`add`, `replace`, `enable`, `disable`, and `remove` tools) manage them in the current workspace,
+and `mcp:///plurnk_skills.md` and `mcp:///plurnk_mcp.md` show each
 definition's form. A definition needs no restart; an extension loads only when
 the daemon starts.
 
@@ -48,8 +46,7 @@ the daemon starts.
 
 | Surface | Shape | Code in the daemon |
 | --- | --- | --- |
-| Application | an AG-UI client: `POST /agui` with `RunAgentInput` on the daemon's listener (`PLURNK_PORT`) returns an event stream | none |
-| Agent | an A2A client of the exposure that `PLURNK_A2A_EXPOSE` mounts | none |
+| Application | an ACP v2 client: WebSocket or Streamable HTTP JSON-RPC 2.0 at `/acp` on the daemon's listener (`PLURNK_PORT`) | none |
 | Command | the executable in `PLURNK_HOOKS_COMMAND`, run once per event named in `PLURNK_HOOKS_EVENTS` with one JSON line on stdin; its output and exit status change nothing | none |
 | Protocol server | a module that declares mounts and serves its routes on the daemon's listener | trusted, in the daemon |
 
@@ -68,8 +65,8 @@ An extension is one package of one kind, declared once: under `plurnk` in its
 | `module` | lifecycle membership: a definition family behind the shared management verbs, a protocol server, or an event observer | `module` | `skill://plurnk/packages/@plurnk/plurnk-modules/SPEC.md` |
 
 - An extension loads when the daemon starts, from the service's installed npm
-  packages. A module also loads from a plugin in `$XDG_CONFIG_HOME/plurnk/plugins/`
-  or `~/.agents/plugins/`. A plugin in a project's `.agents/plugins/` contributes
+  packages. A module also loads from a plugin in `$XDG_CONFIG_HOME/plurnk/plugins/`,
+  `$XDG_CONFIG_HOME/agents/plugins/`, or `~/.agents/plugins/`. A plugin in a project's `.agents/plugins/` contributes
   its skills and MCP servers, never code, and a package written into the project
   loads nothing until it is installed among the service's npm packages.
 - `PLURNK_EXTENSIONS_TRUSTED_ONLY` gates loading: `@plurnk/*` packages always
@@ -81,8 +78,7 @@ An extension is one package of one kind, declared once: under `plurnk` in its
 
 A module exposing read-only resource folders can use `registerResourceTreeScheme`
 from `@plurnk/plurnk-schemes`: it supplies names and original bytes; the host owns
-MIME handling, entry projections and ordinary selection. See {§resource-tree-scheme}
-in that package's contract. `@plurnk/plurnk-skills` is the built-in example; its
+MIME handling, entry projections and ordinary selection (`skill://plurnk/packages/@plurnk/plurnk-schemes/SPEC.md`). `@plurnk/plurnk-skills` is the built-in example; its
 contract is `skill://plurnk/packages/@plurnk/plurnk-skills/SPEC.md`.
 
 ## Examples

package/dist/AgentPluginFiles.d.ts

@@ -1,10 +0,0 @@
-import { type ManifestResult } from "./AgentPluginManifest.ts";
-export default class AgentPluginFiles {
-    static inside(root: string, candidate: string): boolean;
-    static resolved(path: string): Promise<string | null>;
-    static contained(root: string, candidate: string): Promise<boolean>;
-    static manifest(directory: string, { signal }?: {
-        signal?: AbortSignal;
-    }): Promise<ManifestResult | null>;
-}
-//# sourceMappingURL=AgentPluginFiles.d.ts.map

package/dist/AgentPluginFiles.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"AgentPluginFiles.d.ts","sourceRoot":"","sources":["../src/AgentPluginFiles.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAGjF,MAAM,CAAC,OAAO,OAAO,gBAAgB;IACjC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAGtD;IAED,OAAa,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQ1D;IAED,OAAa,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAMxE;IAGD,OAAa,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,GAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CA6BlH;CACJ"}

package/dist/AgentPluginFiles.js

@@ -1,68 +0,0 @@
-import { lstat, readFile, realpath, stat } from "node:fs/promises";
-import { dirname, isAbsolute, join, relative, sep } from "node:path";
-import { validateManifest } from "./AgentPluginManifest.js";
-// {§agent-plugins-containment} Shared by portable components and extension admission.
-export default class AgentPluginFiles {
-    static inside(root, candidate) {
-        const path = relative(root, candidate);
-        return path !== ".." && !path.startsWith(`..${sep}`) && !isAbsolute(path);
-    }
-    static async resolved(path) {
-        try {
-            return await realpath(path);
-        }
-        catch (cause) {
-            const code = cause.code;
-            if (code === "ENOENT" || code === "ENOTDIR")
-                return null;
-            throw cause;
-        }
-    }
-    static async contained(root, candidate) {
-        if (!AgentPluginFiles.inside(root, candidate))
-            return false;
-        const real = await AgentPluginFiles.resolved(candidate);
-        if (real !== null)
-            return AgentPluginFiles.inside(root, real);
-        // A missing leaf can still escape through an existing symlinked parent.
-        return candidate !== root && AgentPluginFiles.contained(root, dirname(candidate));
-    }
-    // null is absence, not an invalid manifest that permits another format to take its place.
-    static async manifest(directory, { signal } = {}) {
-        signal?.throwIfAborted();
-        const authored = join(directory, "plugin.json");
-        try {
-            await lstat(authored);
-        }
-        catch (cause) {
-            const code = cause.code;
-            if (code === "ENOENT" || code === "ENOTDIR")
-                return null;
-            throw cause;
-        }
-        const root = await AgentPluginFiles.resolved(directory);
-        if (root === null)
-            return null;
-        const location = await AgentPluginFiles.resolved(authored);
-        if (location === null) {
-            return { rejected: { section: "5.1", message: "plugin.json does not resolve to a regular file" }, ignored: [] };
-        }
-        if (!AgentPluginFiles.inside(root, location)) {
-            return { rejected: { section: "4.1", message: "plugin.json resolves outside the plugin root" }, ignored: [] };
-        }
-        if (!(await stat(location)).isFile()) {
-            return { rejected: { section: "5.1", message: "plugin.json is not a regular file" }, ignored: [] };
-        }
-        let value;
-        try {
-            value = JSON.parse(await readFile(location, { encoding: "utf8", signal }));
-        }
-        catch (cause) {
-            if (!(cause instanceof SyntaxError))
-                throw cause;
-            return { rejected: { section: "5.2", message: "plugin.json is not valid JSON" }, ignored: [] };
-        }
-        return validateManifest(value);
-    }
-}
-//# sourceMappingURL=AgentPluginFiles.js.map

package/dist/AgentPluginFiles.js.map

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

package/dist/AgentPluginFormat.d.ts

@@ -1,10 +0,0 @@
-export declare const AGENT_PLUGINS_VERSION = "1.0.0";
-export declare const PLUGIN_SCHEMA = "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json";
-export declare const MCP_SCHEMA = "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json";
-export declare const schemaVersion: (identifier: string, kind: "plugin" | "mcp") => string | null;
-export declare const expandPlaceholders: (value: string, { root, data }: {
-    root: string;
-    data: string;
-}) => string;
-export declare const isObject: (value: unknown) => value is Record<string, unknown>;
-//# sourceMappingURL=AgentPluginFormat.d.ts.map

package/dist/AgentPluginFormat.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"AgentPluginFormat.d.ts","sourceRoot":"","sources":["../src/AgentPluginFormat.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,qBAAqB,UAAU,CAAC;AAC7C,eAAO,MAAM,aAAa,+DAA+D,CAAC;AAC1F,eAAO,MAAM,UAAU,4DAA4D,CAAC;AAGpF,eAAO,MAAM,aAAa,eAAgB,MAAM,QAAQ,QAAQ,GAAG,KAAK,KAAG,MAAM,GAAG,IACsC,CAAC;AAG3H,eAAO,MAAM,kBAAkB,UAAW,MAAM,kBAAkB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,KAAG,MAC8B,CAAC;AAElI,eAAO,MAAM,QAAQ,UAAW,OAAO,KAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CACD,CAAC"}

package/dist/AgentPluginFormat.js

@@ -1,10 +0,0 @@
-// {§agent-plugins-manifest} Shared inert Agent Plugins format primitives.
-export const AGENT_PLUGINS_VERSION = "1.0.0";
-export const PLUGIN_SCHEMA = "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json";
-export const MCP_SCHEMA = "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json";
-// A canonical identifier names its version; any other string is not an Agent Plugins identifier.
-export const schemaVersion = (identifier, kind) => new RegExp(`^https://agent-plugins\\.org/schemas/([^/]+)/${kind}\\.schema\\.json$`, "u").exec(identifier)?.[1] ?? null;
-// {§agent-plugins-expansion} One textual pass: text a replacement introduces is never scanned again.
-export const expandPlaceholders = (value, { root, data }) => value.replaceAll(/\$\{(PLUGIN_ROOT|PLUGIN_DATA)\}/gu, (_placeholder, name) => (name === "PLUGIN_ROOT" ? root : data));
-export const isObject = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
-//# sourceMappingURL=AgentPluginFormat.js.map

package/dist/AgentPluginFormat.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"AgentPluginFormat.js","sourceRoot":"","sources":["../src/AgentPluginFormat.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,MAAM,CAAC,MAAM,qBAAqB,GAAG,OAAO,CAAC;AAC7C,MAAM,CAAC,MAAM,aAAa,GAAG,4DAA4D,CAAC;AAC1F,MAAM,CAAC,MAAM,UAAU,GAAG,yDAAyD,CAAC;AAEpF,iGAAiG;AACjG,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,UAAkB,EAAE,IAAsB,EAAiB,EAAE,CACvF,IAAI,MAAM,CAAC,gDAAgD,IAAI,mBAAmB,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AAE3H,qGAAqG;AACrG,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,KAAa,EAAE,EAAE,IAAI,EAAE,IAAI,EAAkC,EAAU,EAAE,CACxG,KAAK,CAAC,UAAU,CAAC,mCAAmC,EAAE,CAAC,YAAY,EAAE,IAAY,EAAE,EAAE,CAAC,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAElI,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAoC,EAAE,CACzE,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC"}

package/dist/AgentPluginManifest.d.ts

@@ -1,32 +0,0 @@
-import { PLUGIN_SCHEMA } from "./AgentPluginFormat.ts";
-export { AGENT_PLUGINS_VERSION, MCP_SCHEMA, PLUGIN_SCHEMA, expandPlaceholders, isObject, schemaVersion } from "./AgentPluginFormat.ts";
-export interface Finding {
-    readonly section: string;
-    readonly message: string;
-}
-export interface PluginAuthor {
-    readonly name?: string;
-    readonly email?: string;
-    readonly url?: string;
-}
-export interface PluginManifest {
-    readonly $schema: typeof PLUGIN_SCHEMA;
-    readonly name: string;
-    readonly version?: string;
-    readonly description?: string;
-    readonly author?: PluginAuthor;
-    readonly homepage?: string;
-    readonly repository?: string;
-    readonly license?: string;
-    readonly keywords?: readonly string[];
-    readonly extensions?: Readonly<Record<string, Readonly<Record<string, unknown>>>>;
-}
-export type ManifestResult = {
-    readonly manifest: PluginManifest;
-    readonly ignored: readonly Finding[];
-} | {
-    readonly rejected: Finding;
-    readonly ignored: readonly Finding[];
-};
-export declare const validateManifest: (value: unknown) => ManifestResult;
-//# sourceMappingURL=AgentPluginManifest.d.ts.map

package/dist/AgentPluginManifest.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"AgentPluginManifest.d.ts","sourceRoot":"","sources":["../src/AgentPluginManifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAA2B,MAAM,wBAAwB,CAAC;AAChF,OAAO,EAAE,qBAAqB,EAAE,UAAU,EAAE,aAAa,EAAE,kBAAkB,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvI,MAAM,WAAW,OAAO;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACzB;AAGD,MAAM,WAAW,cAAc;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,aAAa,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;CACrF;AAED,MAAM,MAAM,cAAc,GACpB;IAAE,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,OAAO,EAAE,CAAA;CAAE,GAC3E;IAAE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,OAAO,EAAE,CAAA;CAAE,CAAC;AAQ3E,eAAO,MAAM,gBAAgB,UAAW,OAAO,KAAG,cAkCjD,CAAC"}

package/dist/AgentPluginManifest.js

@@ -1,52 +0,0 @@
-import { PLUGIN_SCHEMA, isObject, schemaVersion } from "./AgentPluginFormat.js";
-export { AGENT_PLUGINS_VERSION, MCP_SCHEMA, PLUGIN_SCHEMA, expandPlaceholders, isObject, schemaVersion } from "./AgentPluginFormat.js";
-const FIELDS = new Set(["$schema", "name", "version", "description", "author", "homepage", "repository", "license", "keywords", "extensions"]);
-const STRINGS = ["version", "description", "homepage", "repository", "license"];
-const AUTHOR = new Set(["name", "email", "url"]);
-const NAME = /^(?!.*(?:--|\.\.))[a-z0-9](?:[a-z0-9.-]*[a-z0-9])?$/u;
-// {§agent-plugins-manifest} Unknown fields and a non-object `extensions` are the only non-fatal violations.
-export const validateManifest = (value) => {
-    if (!isObject(value))
-        return { rejected: { section: "5.2", message: "plugin.json must contain a top-level JSON object" }, ignored: [] };
-    const ignored = Object.keys(value).filter((key) => !FIELDS.has(key))
-        .map((key) => ({ section: "5.2", message: `unknown top-level field ${JSON.stringify(key)} is ignored` }));
-    const reject = (section, message) => ({ rejected: { section, message }, ignored });
-    const { $schema, name, author, keywords, extensions } = value;
-    if (typeof $schema !== "string")
-        return reject("5.3", "required field $schema is missing or not a string");
-    if ($schema !== PLUGIN_SCHEMA) {
-        const version = schemaVersion($schema, "plugin");
-        return reject("5.2", version === null
-            ? `$schema ${JSON.stringify($schema)} is not a canonical Agent Plugins manifest identifier`
-            : `Agent Plugins ${version} is not supported; this client implements 1.0.0`);
-    }
-    if (typeof name !== "string")
-        return reject("5.3", "required field name is missing or not a string");
-    if (name.length === 0 || name.length > 64 || !NAME.test(name))
-        return reject("5.5", `name ${JSON.stringify(name)} violates the plugin name constraints`);
-    const nonString = STRINGS.find((field) => value[field] !== undefined && typeof value[field] !== "string");
-    if (nonString !== undefined)
-        return reject("5.4", `${nonString} must be a string`);
-    if (author !== undefined) {
-        if (!isObject(author))
-            return reject("5.4", "author must be an object");
-        const invalid = Object.keys(author).find((key) => !AUTHOR.has(key) || typeof author[key] !== "string");
-        if (invalid !== undefined)
-            return reject("5.4", `author may hold only string name, email, and url; found ${JSON.stringify(invalid)}`);
-    }
-    if (keywords !== undefined && !(Array.isArray(keywords) && keywords.every((keyword) => typeof keyword === "string"))) {
-        return reject("5.4", "keywords must be an array of strings");
-    }
-    if (extensions !== undefined && !isObject(extensions)) {
-        ignored.push({ section: "8.1", message: "extensions is not an object and is ignored" });
-    }
-    else if (extensions !== undefined) {
-        const member = Object.keys(extensions).find((namespace) => !isObject(extensions[namespace]));
-        if (member !== undefined)
-            return reject("8.1", `extensions member ${JSON.stringify(member)} must be an object`);
-    }
-    const manifest = Object.fromEntries(Object.entries(value)
-        .filter(([key]) => FIELDS.has(key) && !(key === "extensions" && !isObject(extensions))));
-    return { manifest: manifest, ignored };
-};
-//# sourceMappingURL=AgentPluginManifest.js.map

package/dist/AgentPluginManifest.js.map

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

package/docs/worker.md

@@ -1,80 +0,0 @@
-# `worker://` — workers and their entries
-
-## Summary
-
-Coordinate workers (WORK, FORK), request isolated BARE inference, and manage workspace entries.
-
-Workers inhabit one workspace. The authority selects a worker; a path selects
-an entry rather than controlling that worker.
-
-| Address | Meaning | Model access |
-| --- | --- | --- |
-| `worker://exampleWorkerName` | Named worker | WORK/FORK create; SEND messages; READ collects; KILL terminates. |
-| `message://exampleWorkerName/ab3d5678` | Retained message | READ/FIND/COPY inspect; SEND replies. Neither EDIT nor KILL changes its source. |
-| `ops://exampleWorkerName/1` | What that loop said, or how it ended | READ/FIND/COPY inspect; source is immutable. |
-| `worker://exampleWorkerName/example.md` | Named scratch entry | Read and write from any worker in the workspace. |
-| `worker:///example.md` | Shared commons entry | Read and write. |
-
-The packet's `## Worker` block, below the log, names your worker, its parent
-(`null` at a root), and the loop and turn you are producing. Addresses are
-literal and keep the same meaning when passed to another worker. Scratch
-belongs to the workspace; a namespace does not require a namesake worker.
-Generated references live under `worker:///_plurnk/`, and reference refreshes
-may replace them. EDIT creates or changes an entry, never a worker; KILL with
-an entry path deletes that entry, not its worker. A control address is scheme
-and authority only: no trailing slash, userinfo, port, query, or fragment.
-Messages and loop outcomes have their own addresses; neither is a scratch
-entry or an actor control.
-
-An entry whose source has a readable projection (HTML, a notebook) carries it
-beside the source as `#readable`, text/markdown, in its own line coordinates;
-the default channel stays the source, and a pattern matches the channel it
-addresses. The projection follows every source write and is never written
-itself.
-
-A READ of an image, PDF or audio source retains its bytes: on a route whose
-model takes that media, every later packet carries them as a native part
-captioned with the READ's log coordinate, until you KILL that READ row. The
-service never re-sends media; a captioned part is your own earlier READ, not a
-new arrival.
-
-## Delegation
-
-[Delegation and messages](worker:///_plurnk/plurnk/delegation.md) covers worker
-creation, child observations, waiting, completion, and reply routing.
-
-## BARE inference
-
-BARE makes one isolated call to the model, not a persistent worker. Nothing
-reaches it but the fence body: no log, no files, no web, no tools, no memory of
-this loop. It answers from the body and the model's own knowledge alone, so it
-cannot look anything up, and what it does not know it will guess. Use it to
-isolate a sub-problem whose complete inputs fit in the body — a long text to
-judge, a tangle to reason through without the log in view — never to search,
-recall, or fetch.
-
-```BARE
-A self-contained prompt, with everything it needs pasted in.
-```
-
-The prompt is not truncated to fit; provider capacity still applies.
-Consecutive BARE calls run concurrently and settle before the turn continues.
-Their answers are ordinary BARE receipts, visible in the next packet.
-
-## Turn sources
-
-| Address | Read-only source in the named worker's history |
-| --- | --- |
-| `ops://<worker>/<loop>/<turn>` | The exact submitted program, including interstitial text. |
-| `reasoning://<worker>/<loop>/<turn>` | Original provider reasoning when exposed, or a harness turn's authored rationale. |
-| `note://<worker>/<loop>/<turn>/<item>` | The literal NOTE body, from the program or exposed reasoning; the receipt gives its address. |
-
-The worker name is required. Any worker in the workspace can READ these
-sources; `log:///` remains your own context. READ brings the selected source
-into your log, and KILL of that READ curates only its log projection, never the
-original evidence. The current turn's reasoning exists when its OPs execute, so
-`READ (reasoning://exampleWorkerName/1/3) <1,-1>` from `worker://exampleWorkerName` on loop 1,
-turn 3 retains it; a turn that produced no reasoning reads empty, and a turn
-that has not happened returns a missing-source result. READ never requests
-inference. Notes are ordinary log items whose read-only sources stay searchable
-(`FIND (note://exampleWorkerName/**) /parser/`) and READable after curation or a FORK.