@uru-intelligence/cli 0.3.54 → 0.3.55

package/README.md

@@ -54,6 +54,14 @@ bun src/index.ts gems write 'library/Golden Gems/My Gem.gem' main.html --file ./
 bun src/index.ts library ls library
 bun src/index.ts library search revenue
 bun src/index.ts library mkdir 'library/Golden Gems'
+bun src/index.ts library read 'library/Contexts/Client Brief.md'
+bun src/index.ts library write 'library/Contexts/Client Brief.md' --file ./brief.md --create
+bun src/index.ts library write 'library/Prompts/Sales Email.md' --content "Draft the follow-up." --create
+bun src/index.ts library patch 'library/Prompts/Sales Email.md' --stdin
+bun src/index.ts library cp 'library/Notes/Brief.md' 'library/Archive/Brief.md'
+bun src/index.ts library mv 'library/Notes/Draft.md' 'library/Notes/Final.md'
+bun src/index.ts library rm 'library/Notes/Old.md'
+bun src/index.ts library restore 'library/Notes/Old.md'
 bun src/index.ts datasets query revenue_rows --limit 50 --response-format concise --json
 bun src/index.ts datasets get --params-json '{"dataset_id":"revenue_rows"}'
 bun src/index.ts datasets rows-upsert --params-json '{"dataset_id":"revenue_rows","rows":[{"name":"Acme"}]}'

package/dist/uru.mjs

@@ -6,7 +6,7 @@ import { spawn as spawn3 } from "node:child_process";
 
 // src/types.ts
 var DEFAULT_API_URL = "https://api.uruintelligence.com";
-var CLI_VERSION = "0.3.54";
+var CLI_VERSION = "0.3.55";
 var ExitCode = {
   Ok: 0,
   Failure: 1,
@@ -241,8 +241,12 @@ function buildOperationGroups(op) {
   const libraryOperations = [
     op("library.ls", "library", "List visible Library folders and resources.", "library_query", "ls", "read"),
     op("library.stat", "library", "Read metadata for a visible Library path.", "library_query", "stat", "read"),
+    op("library.read", "library", "Read a visible text-backed Library resource by path.", "library_query", "read", "read"),
     op("library.search", "library", "Search visible Library resources server-side.", "library_query", "search", "read"),
     op("library.mkdir", "library", "Create a Library folder.", "library_fs", "mkdir", "write"),
+    op("library.write", "library", "Create or replace a text-backed Library resource by path.", "library_fs", "write", "write"),
+    op("library.patch", "library", "Replace text content for a text-backed Library resource by path.", "library_fs", "patch", "write"),
+    op("library.cp", "library", "Copy a supported Library item when the backing resource supports copy semantics.", "library_fs", "cp", "write"),
     op("library.mv", "library", "Move or rename a Library item.", "library_fs", "mv", "write"),
     op("library.move_workspace", "library", "Move a Library item to another workspace.", "library_fs", "move_workspace", "destructive"),
     op("library.rm", "library", "Trash a Library item.", "library_fs", "rm", "destructive"),
@@ -250,10 +254,7 @@ function buildOperationGroups(op) {
     op("library.empty_trash", "library", "Permanently empty Library trash.", "library_fs", "empty_trash", "destructive"),
     op("library.upload_preflight", "library", "Preflight a Library upload.", "library_upload", "preflight", "read"),
     op("library.upload_create_session", "library", "Create a direct Library upload session.", "library_upload", "create_session", "write"),
-    op("library.upload_complete_session", "library", "Complete a direct Library upload session.", "library_upload", "complete_session", "write"),
-    op("context.manage", "library", "Manage typed Context Library metadata such as workspace-default, teams, category, and favorite state.", "context_manage", undefined, "write"),
-    op("prompt.render", "library", "Render a typed Prompt Library resource with supplied variables.", "prompt_render", undefined, "read"),
-    op("persona.query", "library", "Query typed Persona Library resources and linked prompt/context resources.", "persona_query", undefined, "read")
+    op("library.upload_complete_session", "library", "Complete a direct Library upload session.", "library_upload", "complete_session", "write")
   ];
   const sharingOperations = [
     op("sharing.share", "sharing", "Share a Library resource with a user, team, or workspace.", "library_collab", "share", "write"),
@@ -416,7 +417,7 @@ function buildOperationGroups(op) {
     op("file.download_for_user", "files", "Prepare a file download for the user.", "DOWNLOAD_FILE_FOR_USER", undefined, "read")
   ];
   const businessSqlOperations = [
-    op("business_sql.transcript", "business_sql", "Query transcript SQL.", "TRANSCRIPT_SQL", undefined, "read"),
+    op("business_sql.transcript", "business_sql", "Query transcript SQL.", "transcript_sql", undefined, "read"),
     op("business_sql.maguire", "business_sql", "Query Maguire SQL.", "MAGUIRE_SQL", undefined, "read"),
     op("business_sql.tyler", "business_sql", "Query Tyler SQL.", "TYLER_SQL", undefined, "read"),
     op("business_sql.cfo", "business_sql", "Query CFO SQL.", "CFO_SQL", undefined, "read"),
@@ -473,7 +474,6 @@ var internalOnlyPlatformToolIds = new Set([
   "MAGUIRE_WRITE_SQL",
   "PEREGRINE_SQL",
   "RESTORE_DATASET_ROWS",
-  "TRANSCRIPT_SQL",
   "TYLER_SQL",
   "UPSERT_DATASET_ROWS"
 ]);
@@ -1184,6 +1184,12 @@ LIBRARY / DATASETS / TOOLS
   uru library ls [path]                             List Library items
   uru library search <query>                        Search Library items
   uru library mkdir <path>                          Create a Library folder
+  uru library read <path>                           Print a text-backed Library resource
+  uru library write <path> --file ./note.md --create Create/replace text-backed Library content
+  uru library patch <path> --content "..."          Replace text-backed Library content
+  uru library cp|mv <path> <target-path>            Copy or move visible Library items
+  uru library rm <path> [--permanent --yes]         Trash or permanently delete Library items
+  uru library restore <path>                        Restore a trashed Library item
   # Prompts, personas, contexts: use typed Library paths such as library/Prompts/Foo.prompt.md
   uru datasets query <dataset-slug> [--limit 50]    Query dataset rows; add --response-format concise for compact output
   uru automations ls|get|create|enable|disable      Manage automations without raw JSON parameters
@@ -1400,8 +1406,20 @@ the check a release gate; security also accepts --deep.
   library: `Usage: uru library ls [path]
        uru library search <query>
        uru library mkdir <path>
+       uru library read <path>
+       uru library write <path> (--file <local-path>|--content <text>|--stdin) [--create]
+       uru library patch <path> (--file <local-path>|--content <text>|--stdin)
+       uru library cp <path> <target-path>
+       uru library mv <path> <target-path>
+       uru library rm <path> [--permanent] [--yes]
+       uru library restore <path>
+       uru library empty-trash --yes
 
-Operate on Library items through platform tools.
+Operate on Library items through platform tools. Use write --create to create
+text-backed Context, Prompt, Persona, note, and plain .md/.txt resources at
+visible Library paths. For binary files, use library_upload through
+\`uru operations run\` or \`uru tools run\`; for Gem child source files, use
+\`uru gems read|write\`.
 `,
   datasets: `Usage: uru datasets query <dataset-slug> [--limit 50] [--offset 0] [--response-format detailed|concise]
 
@@ -3184,8 +3202,8 @@ async function switchWorkspace(ctx, workspaceId) {
 }
 
 // src/local-commands.ts
-import { mkdir as mkdir3, writeFile as writeFile3 } from "node:fs/promises";
-import { dirname as dirname3 } from "node:path";
+import { mkdir as mkdir3, readFile as readFile4, writeFile as writeFile3 } from "node:fs/promises";
+import { dirname as dirname3, resolve as resolve2 } from "node:path";
 var GENERIC_FAMILY_COMMANDS = {
   workspace: "workspace",
   sharing: "sharing",
@@ -3414,7 +3432,109 @@ async function dispatchLibrary(ctx, sub, args) {
     });
     return;
   }
-  throw new CliError("Usage: uru library ls|search|mkdir");
+  if (sub === "read" || sub === "cat") {
+    await emitTool(ctx, "library.read", {
+      path: requireCommandValue(args[0], "Usage: uru library read <path>")
+    }, { textExtractor: extractLibraryTextContent });
+    return;
+  }
+  if (sub === "write") {
+    const flags = parseLocalFlags(args);
+    const path = requireCommandValue(flags.positionals[0], "Usage: uru library write <path> (--file <local-path>|--content <text>|--stdin) [--create]");
+    await emitTool(ctx, "library.write", {
+      path,
+      content: await libraryTextFromFlags(ctx, flags, "write"),
+      create: flags.booleans.has("--create")
+    });
+    return;
+  }
+  if (sub === "patch") {
+    const flags = parseLocalFlags(args);
+    const path = requireCommandValue(flags.positionals[0], "Usage: uru library patch <path> (--file <local-path>|--content <text>|--stdin)");
+    await emitTool(ctx, "library.patch", {
+      path,
+      content: await libraryTextFromFlags(ctx, flags, "patch")
+    });
+    return;
+  }
+  if (sub === "cp" || sub === "copy") {
+    const [path, targetPath] = args;
+    await emitTool(ctx, "library.cp", {
+      path: requireCommandValue(path, "Usage: uru library cp <path> <target-path>"),
+      target_path: requireCommandValue(targetPath, "Usage: uru library cp <path> <target-path>")
+    });
+    return;
+  }
+  if (sub === "mv" || sub === "move" || sub === "rename") {
+    const [path, targetPath] = args;
+    await emitTool(ctx, "library.mv", {
+      path: requireCommandValue(path, "Usage: uru library mv <path> <target-path>"),
+      target_path: requireCommandValue(targetPath, "Usage: uru library mv <path> <target-path>")
+    });
+    return;
+  }
+  if (sub === "rm" || sub === "remove" || sub === "delete") {
+    const flags = parseLocalFlags(args);
+    if ((flags.booleans.has("--permanent") || flags.booleans.has("--hard-delete")) && !ctx.yes && !flags.booleans.has("--yes")) {
+      throw new CliError("Permanent Library deletion cannot be undone. Re-run with --yes to confirm.");
+    }
+    const path = requireCommandValue(flags.positionals[0], "Usage: uru library rm <path> [--permanent] [--yes]");
+    await emitTool(ctx, "library.rm", {
+      path,
+      permanent: flags.booleans.has("--permanent") || flags.booleans.has("--hard-delete")
+    });
+    return;
+  }
+  if (sub === "restore") {
+    await emitTool(ctx, "library.restore", {
+      path: requireCommandValue(args[0], "Usage: uru library restore <path>"),
+      include_trashed: true
+    });
+    return;
+  }
+  if (sub === "empty-trash") {
+    const flags = parseLocalFlags(args);
+    if (!ctx.yes && !flags.booleans.has("--yes")) {
+      throw new CliError("Emptying Library trash permanently deletes all trashed items. Re-run with --yes to confirm.");
+    }
+    await emitTool(ctx, "library.empty_trash", {});
+    return;
+  }
+  throw new CliError("Usage: uru library ls|search|mkdir|read|write|patch|cp|mv|rm|restore|empty-trash");
+}
+async function libraryTextFromFlags(ctx, flags, verb) {
+  const content = flags.values["--content"];
+  const file = flags.values["--file"];
+  const fromStdin = flags.booleans.has("--stdin");
+  const sources = [content !== undefined, file !== undefined, fromStdin].filter(Boolean).length;
+  if (sources !== 1) {
+    throw new CliError(`Library ${verb} requires exactly one of --file <path>, --content <text>, or --stdin.`);
+  }
+  if (content !== undefined) {
+    return content;
+  }
+  if (file !== undefined) {
+    return await readFile4(resolve2(ctx.cwd, file), "utf8");
+  }
+  return await readStdinText(ctx.stdin ?? process.stdin);
+}
+async function readStdinText(stdin) {
+  const chunks = [];
+  for await (const chunk of stdin) {
+    chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(String(chunk)));
+  }
+  return Buffer.concat(chunks).toString("utf8");
+}
+function extractLibraryTextContent(value) {
+  if (!isJsonObject2(value)) {
+    return;
+  }
+  const content = value["content"];
+  if (typeof content === "string") {
+    return content;
+  }
+  const text = value["text"];
+  return typeof text === "string" ? text : undefined;
 }
 async function dispatchDatasets(ctx, sub, args) {
   if (sub !== "query") {
@@ -3623,9 +3743,9 @@ function levenshtein(left, right) {
 }
 
 // src/gem-lifecycle-commands.ts
-import { mkdir as mkdir4, readFile as readFile4, writeFile as writeFile4 } from "node:fs/promises";
+import { mkdir as mkdir4, readFile as readFile5, writeFile as writeFile4 } from "node:fs/promises";
 import { setTimeout as sleep } from "node:timers/promises";
-import { join as join3, resolve as resolve2 } from "node:path";
+import { join as join3, resolve as resolve3 } from "node:path";
 async function dispatchGems(ctx, sub, args, linkedProject) {
   const gemPath = () => gemPathFromArgs(args, linkedProject);
   if (sub === "inspect") {
@@ -3678,7 +3798,7 @@ async function gemInit(ctx, args) {
     params["content"] = flags.values["--content"];
   }
   if (flags.values["--file"] !== undefined) {
-    params["content"] = await readFile4(flags.values["--file"], "utf8");
+    params["content"] = await readFile5(flags.values["--file"], "utf8");
   }
   await emitGemTool(ctx, "gem.init", params);
 }
@@ -4022,7 +4142,7 @@ async function gemWrite(ctx, args) {
   const flags = parseLocalFlags(args);
   const gemPath = requireCommandValue(flags.positionals[0], "Usage: uru gems write <gem-path> <file> --content <text>|--file <local-file>");
   const filePath = requireCommandValue(flags.positionals[1], "Usage: uru gems write <gem-path> <file> --content <text>|--file <local-file>");
-  const content = flags.values["--content"] ?? (flags.values["--file"] === undefined ? undefined : await readFile4(flags.values["--file"], "utf8"));
+  const content = flags.values["--content"] ?? (flags.values["--file"] === undefined ? undefined : await readFile5(flags.values["--file"], "utf8"));
   if (content === undefined) {
     throw new CliError("Gem write requires --content or --file.");
   }
@@ -4179,7 +4299,7 @@ function localFlagNames(flags) {
 async function writeBuildManifest(ctx, outdir, buildResult) {
   const manifest = gemBuildManifestFromBuildResult(buildResult);
   const providerDecision = gemProviderDecisionFromBuildResult(buildResult, manifest);
-  const absoluteOutdir = resolve2(ctx.cwd, outdir);
+  const absoluteOutdir = resolve3(ctx.cwd, outdir);
   await mkdir4(absoluteOutdir, { recursive: true });
   await writeFile4(join3(absoluteOutdir, "gem-build-manifest.json"), `${JSON.stringify(manifest, null, 2)}
 `, { mode: 384 });
@@ -4378,7 +4498,7 @@ function trimLeadingSlashes(value) {
 
 // src/gem-source-commands.ts
 import { mkdir as mkdir5, rm as rm3, writeFile as writeFile5 } from "node:fs/promises";
-import { dirname as dirname4, join as join4, resolve as resolve3 } from "node:path";
+import { dirname as dirname4, join as join4, resolve as resolve4 } from "node:path";
 async function gemSourcePull(ctx, args, linkedProject) {
   const flags = parseLocalFlags(args);
   const gemPath = gemPathFromArgs(flags.positionals, linkedProject);
@@ -4541,7 +4661,7 @@ async function pruneRemoteDeletedSourceFiles(cwd, previousLock, localFilesBefore
       preserved.push(projectPath2);
       continue;
     }
-    await rm3(join4(resolve3(cwd), ...safePath.split("/")), { force: true });
+    await rm3(join4(resolve4(cwd), ...safePath.split("/")), { force: true });
     deleted.push(projectPath2);
   }
   return { deleted, preserved };
@@ -4762,7 +4882,7 @@ async function writePulledSourceFile(cwd, projectPath2, content) {
   if (safePath === null) {
     throw new CliError(`Refusing to write unsafe Gem source path: ${projectPath2}`);
   }
-  const localPath = join4(resolve3(cwd), ...safePath.split("/"));
+  const localPath = join4(resolve4(cwd), ...safePath.split("/"));
   await mkdir5(dirname4(localPath), { recursive: true });
   await writeFile5(localPath, content);
 }
@@ -4817,8 +4937,8 @@ function isConflictLikeError(error) {
 
 // src/token-env-secret-commands.ts
 import { spawn as spawn2 } from "node:child_process";
-import { chmod, mkdir as mkdir6, readFile as readFile5, writeFile as writeFile6 } from "node:fs/promises";
-import { dirname as dirname5, resolve as resolve4 } from "node:path";
+import { chmod, mkdir as mkdir6, readFile as readFile6, writeFile as writeFile6 } from "node:fs/promises";
+import { dirname as dirname5, resolve as resolve5 } from "node:path";
 async function dispatchTokens(ctx, sub, args, linkedProject) {
   if (sub === "create") {
     const flags = parseLocalFlags(args);
@@ -4932,7 +5052,7 @@ async function dispatchEnv(ctx, sub, args, linkedProject) {
     })));
     const secrets = extractSecretRows(result);
     const content = formatEnvTemplate(secrets);
-    const absolutePath = resolve4(ctx.cwd, outputPath);
+    const absolutePath = resolve5(ctx.cwd, outputPath);
     await mkdir6(dirname5(absolutePath), { recursive: true });
     await writeFile6(absolutePath, content, { mode: 384 });
     await chmod(absolutePath, 384);
@@ -4949,8 +5069,8 @@ async function dispatchEnv(ctx, sub, args, linkedProject) {
   }
   if (sub === "run") {
     const parsed = parseEnvRunArgs(args);
-    const envFilePath = resolve4(ctx.cwd, parsed.envFile);
-    const envVars = parseEnvFile(await readFile5(envFilePath, "utf8"));
+    const envFilePath = resolve5(ctx.cwd, parsed.envFile);
+    const envVars = parseEnvFile(await readFile6(envFilePath, "utf8"));
     await runEnvCommand(ctx, parsed.command, envVars);
     return;
   }
@@ -4970,10 +5090,10 @@ async function secretValueFromFlags(ctx, flags) {
   }
   const valueFile = flags.values["--value-file"];
   if (valueFile !== undefined) {
-    return (await readFile5(resolve4(ctx.cwd, valueFile), "utf8")).trimEnd();
+    return (await readFile6(resolve5(ctx.cwd, valueFile), "utf8")).trimEnd();
   }
   if (flags.booleans.has("--value-stdin")) {
-    return await readStdinText(ctx.stdin ?? process.stdin);
+    return await readStdinText2(ctx.stdin ?? process.stdin);
   }
   throw new CliError("Secret put requires --value-file <path> or --value-stdin. Values are never printed by the CLI.");
 }
@@ -5118,7 +5238,7 @@ function redactValues2(content, values) {
   }
   return redacted;
 }
-async function readStdinText(stdin) {
+async function readStdinText2(stdin) {
   const chunks = [];
   for await (const chunk of stdin) {
     chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(String(chunk)));
@@ -5594,14 +5714,14 @@ function writeSystemClipboard(text) {
   const platform = process.platform;
   const command = platform === "darwin" ? "pbcopy" : platform === "win32" ? "clip" : "xclip";
   const args = platform === "linux" ? ["-selection", "clipboard"] : [];
-  return new Promise((resolve5, reject) => {
+  return new Promise((resolve6, reject) => {
     const child = spawn3(command, args, { stdio: ["pipe", "ignore", "ignore"] });
     child.on("error", (error) => {
       reject(new CliError("Could not copy login URL to clipboard. Re-run without --clipboard to print the URL.", { cause: error }));
     });
     child.on("close", (code) => {
       if (code === 0) {
-        resolve5();
+        resolve6();
         return;
       }
       reject(new CliError(`Could not copy login URL to clipboard (${command} exited ${code ?? "unknown"}). Re-run without --clipboard to print the URL.`));

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@uru-intelligence/cli",
-    "version": "0.3.54",
+    "version": "0.3.55",
     "private": false,
     "description": "Uru full-platform command line interface",
     "type": "module",