@demicodes/shell 0.1.0 → 0.2.0

package/dist/storage-MeB35Df6.d.mts

@@ -0,0 +1,105 @@
+import { u as HostStore } from "./host-DIg4RxcL.mjs";
+import { z } from "zod";
+//#region src/command.d.ts
+type CommandInputSpec = Record<string, z.ZodType>;
+interface CommandOutputSpec {
+  json?: z.ZodType;
+}
+/**
+ * One CLI tree node. Routing (`subcommands`) and execution (`run`) are
+ * independent optional capabilities — registration requires at least one.
+ */
+interface Command {
+  name: string;
+  summary: string;
+  /** Present when this node routes to named children. */
+  subcommands?: Command[];
+  /**
+   * Present when this node is executable with its own args/flags.
+   * Execution-only fields below are only meaningful when `run` is set.
+   */
+  run?: (ctx: CommandRunContext) => Promise<CommandRunResult> | CommandRunResult;
+  effects?: string;
+  successOutput?: string;
+  failureOutput?: string;
+  input?: CommandInputSpec;
+  positionals?: string[];
+  stdinField?: string;
+  output?: CommandOutputSpec;
+  /** Required when `run` is set; an empty array renders no examples section. */
+  examples?: string[];
+}
+interface ParsedCommandInput {
+  /**
+   * Path from root through the selected node, including the root name.
+   * For help: path of the node help was requested for.
+   */
+  path: string[];
+  /** True when the invocation requested `--help`. */
+  help: boolean;
+  values: Record<string, unknown>;
+  json: boolean;
+}
+interface CommandRunContext {
+  argv: string[];
+  parsed: ParsedCommandInput;
+  stdin: CommandStdin;
+  env: Record<string, string>;
+  cwd: string;
+  io: CommandIO;
+  storage: CommandStorage;
+}
+interface CommandRunResult {
+  exitCode: number;
+  metadata?: unknown;
+}
+interface CommandStdin {
+  /** Stdin decoded as UTF-8 text (lossy for non-text input). */
+  text: string;
+  /** Raw stdin bytes, byte-identical to what the pipe delivered. */
+  bytes: Uint8Array;
+}
+declare function emptyStdin(): CommandStdin;
+interface CommandIO {
+  stdout(data: string | Uint8Array): Promise<void> | void;
+  stderr(data: string | Uint8Array): Promise<void> | void;
+}
+interface CommandStorage {
+  readJson<T>(key: string): Promise<T | null>;
+  writeJson<T>(key: string, value: T): Promise<void>;
+  delete(key: string): Promise<void>;
+  list(prefix: string): Promise<string[]>;
+}
+interface CommandExecutionContext {
+  argv: string[];
+  stdin?: CommandStdin;
+  env: Record<string, string>;
+  cwd: string;
+  io: CommandIO;
+  storage: CommandStorage;
+}
+declare class CommandRegistry {
+  private readonly commands;
+  register(command: Command): void;
+  get(name: string): Command | null;
+  list(): Command[];
+  renderHelp(): string;
+}
+declare const COMMAND_HELP_DEFAULTS = "Unless a command states otherwise: success prints raw text on stdout, failure writes an error message to stderr and exits non-zero. Pass --help at any level to print a command's documentation.";
+declare function parseCommandInput(root: Command, argv: string[], stdin?: CommandStdin): ParsedCommandInput;
+declare function runRegisteredCommand(root: Command, ctx: CommandExecutionContext): Promise<CommandRunResult>;
+declare function renderCommandHelp(command: Command, parentPath?: string): string;
+//#endregion
+//#region src/storage.d.ts
+declare class AgentSessionCommandStorage implements CommandStorage {
+  private readonly store;
+  private readonly agentSessionPrefix;
+  constructor(store: HostStore, agentSessionId: string);
+  readJson<T>(key: string): Promise<T | null>;
+  writeJson<T>(key: string, value: T): Promise<void>;
+  delete(key: string): Promise<void>;
+  list(prefix: string): Promise<string[]>;
+  private key;
+}
+//#endregion
+export { runRegisteredCommand as _, CommandIO as a, CommandRegistry as c, CommandStdin as d, CommandStorage as f, renderCommandHelp as g, parseCommandInput as h, CommandExecutionContext as i, CommandRunContext as l, emptyStdin as m, COMMAND_HELP_DEFAULTS as n, CommandInputSpec as o, ParsedCommandInput as p, Command as r, CommandOutputSpec as s, AgentSessionCommandStorage as t, CommandRunResult as u };

package/dist/storage.d.mts

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@demicodes/shell",
   "description": "Sandboxable bash engine and Host contract for Demi.",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "private": false,
   "type": "module",
   "exports": {
@@ -22,8 +22,8 @@
     }
   },
   "dependencies": {
-    "@demicodes/utils": "workspace:*",
-    "@demicodes/just-bash": "workspace:*",
+    "@demicodes/utils": "0.2.0",
+    "@demicodes/just-bash": "3.0.1-demi.4",
     "zod": "^4.0.0"
   },
   "license": "Apache-2.0",

package/dist/storage-DJxxqyZA.d.mts

@@ -1,111 +0,0 @@
-import { u as HostStore } from "./host-BfjoIvF3.mjs";
-import { z } from "zod";
-
-//#region src/command.d.ts
-type CommandInputSpec = Record<string, z.ZodType>;
-/**
- * A command is a tree of arbitrary depth, matching standard CLI semantics
- * (cobra/click): group nodes (`CommandSpec`) route and render help, leaf nodes
- * (`CommandSubcommandSpec`) carry the input schema and the executable. The
- * registry registers root groups; `<path...> prompt` renders help at any group.
- */
-interface CommandSpec {
-  name: string;
-  summary: string;
-  subcommands: CommandNode[];
-}
-type CommandNode = CommandSpec | CommandSubcommandSpec;
-declare function isCommandGroup(node: CommandNode): node is CommandSpec;
-interface CommandSubcommandSpec {
-  name: string;
-  summary: string;
-  effects?: string;
-  successOutput?: string;
-  failureOutput?: string;
-  input?: CommandInputSpec;
-  positionals?: string[];
-  stdinField?: string;
-  output?: CommandOutputSpec;
-  examples: string[];
-  run(ctx: CommandRunContext): Promise<CommandRunResult> | CommandRunResult;
-}
-interface CommandOutputSpec {
-  json?: z.ZodType;
-}
-interface ParsedCommandInput {
-  /** Leaf subcommand name, or 'prompt' for the help pseudo-subcommand. */
-  subcommand: string;
-  /**
-   * Segments after the root command name: group names down to the leaf. For
-   * 'prompt' it is the path of the group the help applies to (empty = root).
-   */
-  path: string[];
-  values: Record<string, unknown>;
-  json: boolean;
-}
-interface CommandRunContext {
-  argv: string[];
-  parsed: ParsedCommandInput;
-  stdin: CommandStdin;
-  env: Record<string, string>;
-  cwd: string;
-  io: CommandIO;
-  storage: CommandStorage;
-}
-interface CommandRunResult {
-  exitCode: number;
-  metadata?: unknown;
-}
-interface CommandStdin {
-  text: string;
-}
-/** A non-text content item a command emits to the model, peer to stdout text. */
-type CommandAsset = {
-  type: 'image';
-  mediaType: string;
-  data: string;
-};
-interface CommandIO {
-  stdout(data: string | Uint8Array): Promise<void> | void;
-  stderr(data: string | Uint8Array): Promise<void> | void;
-  asset(asset: CommandAsset): Promise<void> | void;
-}
-interface CommandStorage {
-  readJson<T>(key: string): Promise<T | null>;
-  writeJson<T>(key: string, value: T): Promise<void>;
-  delete(key: string): Promise<void>;
-  list(prefix: string): Promise<string[]>;
-}
-interface CommandExecutionContext {
-  argv: string[];
-  stdin?: CommandStdin;
-  env: Record<string, string>;
-  cwd: string;
-  io: CommandIO;
-  storage: CommandStorage;
-}
-declare class CommandRegistry {
-  private readonly commands;
-  register(spec: CommandSpec): void;
-  get(name: string): CommandSpec | null;
-  list(): CommandSpec[];
-  renderPrompt(): string;
-}
-declare const COMMAND_PROMPT_DEFAULTS = "Unless a subcommand states otherwise: success prints raw text on stdout, failure writes an error message to stderr and exits non-zero.";
-declare function parseCommandInput(spec: CommandSpec, argv: string[], stdin?: CommandStdin): ParsedCommandInput;
-declare function runRegisteredCommand(spec: CommandSpec, ctx: CommandExecutionContext): Promise<CommandRunResult>;
-declare function renderCommandPrompt(spec: CommandSpec, parentPath?: string): string;
-//#endregion
-//#region src/storage.d.ts
-declare class AgentSessionCommandStorage implements CommandStorage {
-  private readonly store;
-  private readonly agentSessionPrefix;
-  constructor(store: HostStore, agentSessionId: string);
-  readJson<T>(key: string): Promise<T | null>;
-  writeJson<T>(key: string, value: T): Promise<void>;
-  delete(key: string): Promise<void>;
-  list(prefix: string): Promise<string[]>;
-  private key;
-}
-//#endregion
-export { isCommandGroup as _, CommandIO as a, runRegisteredCommand as b, CommandOutputSpec as c, CommandRunResult as d, CommandSpec as f, ParsedCommandInput as g, CommandSubcommandSpec as h, CommandExecutionContext as i, CommandRegistry as l, CommandStorage as m, COMMAND_PROMPT_DEFAULTS as n, CommandInputSpec as o, CommandStdin as p, CommandAsset as r, CommandNode as s, AgentSessionCommandStorage as t, CommandRunContext as u, parseCommandInput as v, renderCommandPrompt as y };