@sixb/cli-core 0.1.9 → 0.2.0

package/src/index.ts

@@ -1,10 +1,18 @@
 export type { ApiClientOptions } from "./api-client"
 export { ApiClient } from "./api-client"
-export { isHelp, requestsHelp } from "./arguments"
+export { requestsHelp } from "./arguments"
 export type { InstanceCommand } from "./commands"
 export { INSTANCE_COMMANDS, isInstanceCommand } from "./commands"
 export { renderInstanceHelp } from "./commands/metadata"
-export { asRecord, isFileError } from "./commands/shared"
+export type { SandboxStatusReport } from "./commands/system"
+export { AGENT_RUNTIME_PROFILE } from "./commands/system"
+export type { AgentMemoryManifest, AgentMemoryRepo } from "./memory"
+export {
+  AGENT_MEMORY_ENTRY,
+  AGENT_MEMORY_MANIFEST,
+  AGENT_MEMORY_STARTER,
+  agentMemoryFileHash,
+} from "./memory"
 export {
   CliError,
   EXIT_API,
@@ -13,7 +21,6 @@ export {
   INSTANCE_CLI_VERSION,
   reportError,
   writeJson,
-  writeText,
 } from "./output"
 export type {
   InstanceCliMode,
@@ -22,3 +29,5 @@ export type {
   SandboxInstanceCliMode,
 } from "./run"
 export { createInstanceApiClient, runInstanceCli } from "./run"
+export type { SandboxCliAssets } from "./sandbox-cli"
+export { loadSandboxCliAssets } from "./sandbox-cli"

package/src/main.ts

@@ -0,0 +1,41 @@
+#!/usr/bin/env node
+
+// The `sixb` a sandbox runs: the API commands people run, plus the run's own (`status`,
+// `context`, `memory`, `history`). `bun run generate:sandbox-cli` bundles it into generated/sixb.mjs.
+import { isHelp } from "./arguments"
+import { isInstanceCommand } from "./commands"
+import { history } from "./commands/history"
+import { memory } from "./commands/memory"
+import { renderInstanceHelp } from "./commands/metadata"
+import { context, status } from "./commands/system"
+import { fail, INSTANCE_CLI_VERSION, reportError, writeText } from "./output"
+import { createInstanceApiClient, runInstanceCli } from "./run"
+
+async function main(args: readonly string[]): Promise<void> {
+  const [command, ...rest] = args
+  if (!command || isHelp(command)) return writeText(renderInstanceHelp())
+  if (command === "--version" || command === "version") {
+    return writeText(`sixb CLI ${INSTANCE_CLI_VERSION}`)
+  }
+  if (command === "status") return status(rest, sandboxMode())
+  if (command === "context") return context(rest)
+  if (command === "memory") return memory(rest, sandboxMode())
+  if (command === "history") return history(createInstanceApiClient(sandboxMode()), rest)
+  if (!isInstanceCommand(command)) fail(`Unknown command '${command}'. Run 'sixb --help'.`)
+
+  await runInstanceCli({ args, mode: sandboxMode() })
+}
+
+function sandboxMode() {
+  return {
+    kind: "sandbox" as const,
+    baseUrl: process.env.SIXB_API_BASE_URL ?? "",
+    runContextPath: process.env.SIXB_RUN_CONTEXT ?? "",
+  }
+}
+
+try {
+  await main(process.argv.slice(2))
+} catch (error) {
+  process.exitCode = reportError(error)
+}

package/src/memory.ts

@@ -0,0 +1,30 @@
+import { createHash } from "node:crypto"
+
+/**
+ * The Agent's memory as installed in its sandbox: the worker writes each repo under
+ * `$SIXB_MEMORY_DIR/<repo>/` with a manifest of what it loaded, and `sixb memory` saves the files
+ * that differ from it.
+ */
+export type AgentMemoryRepo = "user" | "project"
+
+/** Where the manifest is, relative to `$SIXB_CONTEXT_DIR`. */
+export const AGENT_MEMORY_MANIFEST = "context/memory.json"
+
+export const AGENT_MEMORY_ENTRY = "MEMORY.md"
+
+/** What a repo starts from before its first save; it is saved with the first save. */
+export const AGENT_MEMORY_STARTER = "# Memory\n\n"
+
+/** What the local copy was loaded from: the revision and each file's SHA-256, by path. */
+export interface AgentMemoryManifest {
+  readonly repos: Partial<Record<AgentMemoryRepo, AgentMemoryManifestRepo>>
+}
+
+export interface AgentMemoryManifestRepo {
+  readonly revision: number
+  readonly files: Readonly<Record<string, string>>
+}
+
+export function agentMemoryFileHash(contents: string): string {
+  return createHash("sha256").update(contents).digest("hex")
+}

package/src/policies.ts

@@ -8,6 +8,11 @@ export const CLI_LIMITS = {
   linkPage: { default: 100, maximum: 1_000 },
   /** The server lists at most 200 members per page. */
   users: { default: 20, maximum: 200 },
+  /** A page of a conversation's messages, as `sixb history` prints them. */
+  history: { default: 20, maximum: 100 },
+  /** The server's dataset bounds: 100 versions and 1,000 rows per page. */
+  datasetVersions: { default: 20, maximum: 100 },
+  datasetRows: { default: 100, maximum: 1_000 },
   inspect: {
     depth: { default: 2, maximum: 3 },
     objects: { default: 20, maximum: 100 },

package/src/run.ts

@@ -3,6 +3,7 @@ import { dispatch } from "./commands"
 
 export interface SandboxInstanceCliMode {
   readonly kind: "sandbox"
+  /** The sandbox's credentialed address for the API: the run's token is added on the way out. */
   readonly baseUrl: string
   readonly runContextPath: string
 }
@@ -36,11 +37,11 @@ export function createInstanceApiClient(mode: InstanceCliMode): ApiClient {
         : "The selected Sixb profile has no API URL.",
     unavailableMessage:
       mode.kind === "sandbox"
-        ? "The Sixb API gateway could not be reached."
+        ? "The Sixb API could not be reached from the sandbox."
         : "The Sixb API could not be reached.",
     unavailableHint:
       mode.kind === "sandbox"
-        ? "Run 'sixb doctor' to verify the sandbox runtime and gateway."
+        ? "Run 'sixb status' to verify the sandbox runtime and its API access."
         : "Run 'sixb status' to verify the current profile.",
   })
 }

package/src/sandbox-cli.ts

@@ -0,0 +1,18 @@
+import { readFile } from "node:fs/promises"
+
+/** The `sixb` a sandbox installs: a shell launcher and the bundle it runs on Bun or Node. */
+export interface SandboxCliAssets {
+  readonly launcher: string
+  readonly artifact: Uint8Array
+}
+
+let cachedAssets: Promise<SandboxCliAssets> | undefined
+
+/** Read from beside this module: `src/` in the workspace, `dist/` once built. */
+export function loadSandboxCliAssets(): Promise<SandboxCliAssets> {
+  cachedAssets ??= Promise.all([
+    readFile(new URL("./bin/sixb", import.meta.url), "utf8"),
+    readFile(new URL("./generated/sixb.mjs", import.meta.url)),
+  ]).then(([launcher, artifact]) => ({ launcher, artifact }))
+  return cachedAssets
+}