@demicodes/shell 0.11.0 → 0.13.0

package/README.md

@@ -5,10 +5,13 @@ A sandboxable bash engine for Demi. Commands run through a `Host` abstraction
 same agent can target local, container, remote, or in-memory backends.
 
 - `BashEnvironment` — long-running shell sessions with `exec` / `status` / `write`
-  / `abort` and a `/@` virtual filesystem of command artifacts.
+  / `abort` returning `ShellCommandStatus`, plus a `/@` virtual filesystem of
+  command artifacts.
 - `Host` contract (see [Implement a Host](../../docs/guides/implement-a-host.md)).
-- Built on a vendored fork of `just-bash`.
+- Built on a forked `just-bash` workspace package.
 
 Subpaths: `@demicodes/shell/storage`, `@demicodes/shell/host-fs`.
+See [docs/shell-yield-control-plan.md](../../docs/shell-yield-control-plan.md) for
+the model-facing control surface and yield wakeups.
 
 Part of [Demi](../../README.md). Apache-2.0.

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 import { a as HostProcess, c as HostSpawnHandle, i as HostFileSystem, l as HostSpawnParams, n as HostDirent, o as HostProcessOutputChunk, r as HostFileStat, s as HostSpawnExit, t as Host, u as HostStore } from "./host-DIg4RxcL.mjs";
 import { HostBackedFileSystem, VirtualFileSystemNode, VirtualFileSystemProvider, virtualDirectory, virtualFile } from "./host-fs.mjs";
-import { _ as runRegisteredCommand, a as CommandIO, c as CommandRegistry, d as CommandStdin, f as CommandStorage, g as renderCommandHelp, h as parseCommandInput, i as CommandExecutionContext, l as CommandRunContext, m as emptyStdin, n as COMMAND_HELP_DEFAULTS, o as CommandInputSpec, p as ParsedCommandInput, r as Command, s as CommandOutputSpec, t as AgentSessionCommandStorage, u as CommandRunResult } from "./storage-DB9hjZ2G.mjs";
+import { _ as runRegisteredCommand, a as CommandIO, c as CommandRegistry, d as CommandStdin, f as CommandStorage, g as renderCommandHelp, h as parseCommandInput, i as CommandExecutionContext, l as CommandRunContext, m as emptyStdin, n as COMMAND_HELP_DEFAULTS, o as CommandInputSpec, p as ParsedCommandInput, r as Command, s as CommandOutputSpec, t as AgentSessionCommandStorage, u as CommandRunResult } from "./storage-ylShLr2v.mjs";
 import { CommandName } from "@demicodes/just-bash/commands";
 import { Interpreter, InterpreterState } from "@demicodes/just-bash/interpreter";
 import { CommandRegistry as CommandRegistry$1, ExecResult } from "@demicodes/just-bash/types";

package/dist/index.mjs

@@ -121,8 +121,7 @@ const EXECUTION_ONLY_FIELDS = [
 	"input",
 	"positionals",
 	"stdinField",
-	"output",
-	"examples"
+	"output"
 ];
 const COMMAND_NAME_PATTERN = /^[A-Za-z0-9][A-Za-z0-9_-]*$/;
 var CommandRegistry = class {
@@ -292,11 +291,6 @@ function renderCommandHelp(command, parentPath = "") {
 		if (command.stdinField) lines.push(`    stdin/heredoc: ${command.stdinField}`);
 		if (command.output?.json) lines.push("    --json: emits machine-readable JSON for this command");
 		else lines.push("    --json: accepted only when this command defines JSON output");
-		const examples = command.examples ?? [];
-		if (examples.length > 0) {
-			lines.push("    Examples:");
-			for (const example of examples) lines.push(indent(example, 6));
-		}
 	}
 	const children = command.subcommands ?? [];
 	if (children.length > 0) {
@@ -312,9 +306,9 @@ function validateCommandTree(command, path) {
 	const hasRun = typeof command.run === "function";
 	const children = command.subcommands ?? [];
 	if (!hasRun && children.length === 0) throw new Error(`CommandRegistry: "${path}" must have run() and/or subcommands`);
-	if (hasRun) {
-		if (!Array.isArray(command.examples)) throw new Error(`CommandRegistry: "${path}" defines run() but is missing examples[]`);
-	} else for (const field of EXECUTION_ONLY_FIELDS) if (command[field] !== void 0) throw new Error(`CommandRegistry: "${path}" sets ${field} without run()`);
+	if (!hasRun) {
+		for (const field of EXECUTION_ONLY_FIELDS) if (command[field] !== void 0) throw new Error(`CommandRegistry: "${path}" sets ${field} without run()`);
+	}
 	if (hasRun) {
 		const input = command.input ?? {};
 		if (command.stdinField && !(command.stdinField in input)) throw new Error(`CommandRegistry: "${path}" stdinField "${command.stdinField}" is not in input`);
@@ -364,10 +358,6 @@ function coerceValue(schema, value) {
 function formatField(field, schema, positional, stdin) {
 	return `${positional ? `<${field}>` : `--${field}`}${stdin ? " (from stdin/heredoc)" : ""}${schema.description ? ` - ${schema.description}` : ""}`;
 }
-function indent(text, spaces) {
-	const prefix = " ".repeat(spaces);
-	return text.split("\n").map((line) => `${prefix}${line}`).join("\n");
-}
 function isArraySchema(schema) {
 	const unwrapped = unwrapSchema(schema);
 	return zodTypeName(unwrapped) === "array" || zodTypeName(unwrapped) === "ZodArray";

package/dist/{storage-DB9hjZ2G.d.mts → storage-ylShLr2v.d.mts}

@@ -26,8 +26,6 @@ interface Command {
   positionals?: string[];
   stdinField?: string;
   output?: CommandOutputSpec;
-  /** Required when `run` is set; an empty array renders no examples section. */
-  examples?: string[];
 }
 interface ParsedCommandInput {
   /**

package/dist/storage.d.mts

@@ -1,2 +1,2 @@
-import { t as AgentSessionCommandStorage } from "./storage-DB9hjZ2G.mjs";
+import { t as AgentSessionCommandStorage } from "./storage-ylShLr2v.mjs";
 export { AgentSessionCommandStorage };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@demicodes/shell",
   "description": "Sandboxable bash engine and Host contract for Demi.",
-  "version": "0.11.0",
+  "version": "0.13.0",
   "private": false,
   "type": "module",
   "exports": {
@@ -20,7 +20,7 @@
   },
   "dependencies": {
     "@demicodes/just-bash": "^3.0.1-demi.5",
-    "@demicodes/utils": "^0.11.0",
+    "@demicodes/utils": "^0.13.0",
     "zod": "^4.0.0"
   },
   "license": "Apache-2.0",