@corenel/term 0.1.0 → 0.2.0

package/dist/chunk-2D7G4YW2.js

@@ -0,0 +1,97 @@
+import {
+  sourceDescription
+} from "./chunk-CB5RFNB4.js";
+
+// src/describe.ts
+import { PermissionService } from "@corenel/harness/guardrail/permission-service";
+import { NAMESPACE_LABELS, resolveNamespace, toolAddress } from "@corenel/harness/tools/namespaces";
+var PREVIEW_LINES = 6;
+var PREVIEW_LINES_ERROR = 12;
+var SUBJECT_WIDTH = 68;
+var ORD_WIDTH = 4;
+function formatOrd(ord) {
+  return `#${ord}`.padEnd(ORD_WIDTH);
+}
+function describeToolCall(_name, args) {
+  const a = args ?? {};
+  const raw = a.path ?? a.file ?? a.command ?? a.cmd ?? a.query ?? a.url;
+  const pattern = typeof a.pattern === "string" ? `/${a.pattern}/` : "";
+  const text = typeof raw === "string" ? raw : pattern;
+  if (!text) return "";
+  const one = text.replace(/\s+/g, " ").trim();
+  return one.length > SUBJECT_WIDTH ? `${one.slice(0, SUBJECT_WIDTH - 1)}\u2026` : one;
+}
+function capPreview(result, isError) {
+  const lines = result.split("\n").map((l) => l.replace(/\s+$/, ""));
+  while (lines.length && !lines[lines.length - 1].trim()) lines.pop();
+  while (lines.length && !lines[0].trim()) lines.shift();
+  if (!lines.length) return [];
+  const cap = isError ? PREVIEW_LINES_ERROR : PREVIEW_LINES;
+  if (lines.length <= cap) return lines;
+  const dropped = lines.length - cap;
+  return [...lines.slice(0, cap), `\u2026 ${dropped} more line${dropped === 1 ? "" : "s"}`];
+}
+function formatTools(tools) {
+  if (!tools.length) return "No tools are available.";
+  const w = Math.max(...tools.map((t) => t.name.length));
+  const line = (t) => `  ${t.name.padEnd(w)}  ${t.mutates ? "*" : " "} ${t.means ?? t.description.split(". ")[0]}`;
+  return [
+    `${tools.length} tools available (* = can change things, and will ask first):`,
+    ...[...tools].sort((a, b) => a.name.localeCompare(b.name)).map(line)
+  ].join("\n");
+}
+var NAMESPACE_COL = 14;
+function formatPolicy(policy, source, tools) {
+  const permission = new PermissionService({ policy });
+  const byNamespace = /* @__PURE__ */ new Map();
+  for (const t of tools) {
+    const ns = resolveNamespace(t);
+    const list = byNamespace.get(ns);
+    if (list) list.push(t);
+    else byNamespace.set(ns, [t]);
+  }
+  const lines = [
+    `${policy.name}${policy.description ? ` -- ${policy.description}` : ""}`,
+    `source: ${sourceDescription(source)}`,
+    "",
+    "effective level per namespace:"
+  ];
+  for (const { ns, label } of NAMESPACE_LABELS) {
+    const nsTools = byNamespace.get(ns);
+    if (!nsTools || nsTools.length === 0) continue;
+    const levels = new Set(nsTools.map((t) => {
+      const subject = {
+        name: t.name,
+        address: toolAddress(t),
+        ...t.mutates !== void 0 ? { mutates: t.mutates } : {},
+        ...t.permission ? { permission: t.permission } : {}
+      };
+      return permission.resolveLevel(subject);
+    }));
+    const levelStr = levels.size === 1 ? [...levels][0] : `mixed (${[...levels].sort().join("/")})`;
+    lines.push(`  ${label.padEnd(NAMESPACE_COL)} ${levelStr}`);
+  }
+  lines.push(
+    "",
+    "caps:",
+    `  max turns       ${policy.maxTurns ?? "none"}`,
+    `  max tool calls  ${policy.maxToolCalls ?? "none"}`,
+    `  on violation    ${policy.onViolation ?? "stop"}`,
+    `  unattended      ${policy.unattended ?? "deny"}`,
+    "",
+    "enforcement -- what actually confines each layer:",
+    "  files    the file service's root confines paths (rejects ../ and symlink escapes) -- this policy does not",
+    "  shell    the working directory is fixed at startup, but the command text itself is not confined by anything here"
+  );
+  return lines.join("\n");
+}
+
+export {
+  PREVIEW_LINES,
+  PREVIEW_LINES_ERROR,
+  formatOrd,
+  describeToolCall,
+  capPreview,
+  formatTools,
+  formatPolicy
+};

package/dist/chunk-CB5RFNB4.js

@@ -0,0 +1,33 @@
+// src/policySource.ts
+import { basename } from "node:path";
+function sourceLabel(source) {
+  switch (source.kind) {
+    case "default":
+      return null;
+    case "builtin":
+      return source.name;
+    case "file":
+    case "project":
+    case "user":
+      return basename(source.path);
+  }
+}
+function sourceDescription(source) {
+  switch (source.kind) {
+    case "default":
+      return "built-in default (no --policy given, none discovered)";
+    case "builtin":
+      return `built-in "${source.name}" (--policy ${source.name})`;
+    case "file":
+      return `from ${source.path} (--policy)`;
+    case "project":
+      return `discovered at ${source.path}`;
+    case "user":
+      return `discovered at ${source.path}`;
+  }
+}
+
+export {
+  sourceLabel,
+  sourceDescription
+};