@demicodes/shell 0.20.0 → 0.22.0

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 import { a as HostFileSystem, c as HostProcessOutputChunk, d as HostSpawnParams, f as HostStore, i as HostFileStat, l as HostSpawnExit, m as createLogicalHostCwd, n as HostCwd, o as HostIdentity, p as SpawnErrorKind, r as HostDirent, s as HostProcess, t as Host, u as HostSpawnHandle } from "./host-BupAFtK6.mjs";
 import { HostBackedFileSystem, HostBackedFileSystemOptions } 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-BDRwHNOB.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-C0nS_VXD.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";
@@ -77,6 +77,8 @@ interface ForegroundProcess {
   exitPromise: Promise<HostSpawnExit>;
   outputSinks: Record<1 | 2, ForegroundSink>;
   abortController: AbortController;
+  /** The resolved registered command's `runningHint`, surfaced on running command statuses. */
+  runningHint?: string;
 }
 interface ForegroundSink {
   kind: 'visible' | 'file' | 'null';
@@ -244,6 +246,8 @@ type ShellCommandStatus = {
   output: ShellOutputView;
   runningMs: number;
   idleMs: number;
+  /** The running foreground registered command's `runningHint`, when it declares one. */
+  runningHint?: string;
 } | {
   status: 'aborted';
   shellId: string;

package/dist/index.mjs

@@ -135,7 +135,8 @@ const EXECUTION_ONLY_FIELDS = [
 	"input",
 	"positionals",
 	"stdinField",
-	"output"
+	"output",
+	"runningHint"
 ];
 const COMMAND_NAME_PATTERN = /^[A-Za-z0-9][A-Za-z0-9_-]*$/;
 var CommandRegistry = class {
@@ -712,7 +713,7 @@ function commandToForkCommand(session, command, storage, host, captureLimitBytes
 		execute: async (args, ctx) => {
 			const stdin = decodeForkStdin(ctx.stdin);
 			const argv = [command.name, ...args];
-			const job = new VirtualForegroundJob(session, command.name, args, ctx.cwd, captureLimitBytes);
+			const job = new VirtualForegroundJob(session, command.name, args, ctx.cwd, captureLimitBytes, resolveRunningHint(command, args));
 			job.install();
 			try {
 				const result = await Promise.race([runRegisteredCommand(command, {
@@ -784,7 +785,7 @@ var VirtualForegroundJob = class {
 	killedPromise;
 	exitPromise;
 	installed = false;
-	constructor(session, command, args, cwd, captureLimitBytes) {
+	constructor(session, command, args, cwd, captureLimitBytes, runningHint) {
 		this.session = session;
 		this.captureLimitBytes = captureLimitBytes;
 		this.exitPromise = new Promise((resolve) => {
@@ -835,7 +836,8 @@ var VirtualForegroundJob = class {
 			stderrPump: Promise.resolve(),
 			exitPromise: this.exitPromise,
 			outputSinks: createOutputSinks(session.fs, cwd, void 0),
-			abortController: this.abortController
+			abortController: this.abortController,
+			...runningHint !== void 0 ? { runningHint } : {}
 		};
 		this.io = {
 			stdout: (data) => {
@@ -920,6 +922,16 @@ function toBytes(data) {
 	return typeof data === "string" ? encodeUtf8(data) : data;
 }
 async function* emptyByteStream() {}
+/** The `runningHint` of the executed node argv selects (flags never collide with subcommand names). */
+function resolveRunningHint(command, args) {
+	let node = command;
+	for (const token of args) {
+		const child = node.subcommands?.find((candidate) => candidate.name === token);
+		if (!child) break;
+		node = child;
+	}
+	return node.runningHint;
+}
 function treeConsumesStdin(command) {
 	if (command.stdinField) return true;
 	return command.subcommands?.some(treeConsumesStdin) ?? false;
@@ -1803,6 +1815,11 @@ var BashEnvironment = class {
 			...base,
 			status: "aborted"
 		};
+		if (foreground?.commandId === record.id && foreground.runningHint !== void 0) return {
+			...base,
+			status: "running",
+			runningHint: foreground.runningHint
+		};
 		return {
 			...base,
 			status: "running"

package/dist/{storage-BDRwHNOB.d.mts → storage-C0nS_VXD.d.mts}

@@ -25,6 +25,13 @@ interface Command {
   positionals?: string[];
   stdinField?: string;
   output?: CommandOutputSpec;
+  /**
+   * Replaces the generic "check again with shell_status, or call yield" next
+   * hint in model-facing shell results while this command is the running
+   * foreground job. For long-running commands whose running state should not
+   * be watched with status/yield polling (e.g. an attended child agent).
+   */
+  runningHint?: string;
 }
 interface ParsedCommandInput {
   /**

package/dist/storage.d.mts

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

package/package.json

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