neoctl 0.2.30 → 0.2.32

package/dist/plugins/plugin-system.js

@@ -0,0 +1,189 @@
+import { readdir, readFile } from "node:fs/promises";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+export const NEO_PLUGIN_PROTOCOL = "neo-plugin/v1";
+export const NEO_PLUGIN_MANIFEST = "neo-plugin.json";
+export async function loadNeoPlugins(options) {
+    const roots = normalizeRoots(options.directories);
+    const plugins = [];
+    for (const root of roots)
+        plugins.push(...await loadPluginRoot(root, options));
+    plugins.sort((left, right) => left.id.localeCompare(right.id));
+    assertUnique(plugins.map((plugin) => plugin.id), "duplicate plugin id");
+    assertUnique(plugins.flatMap((plugin) => plugin.tools ?? []).map((tool) => tool.name), "duplicate tool name across plugins");
+    return plugins;
+}
+export function validateNeoPluginManifest(value, manifestPath = NEO_PLUGIN_MANIFEST) {
+    if (!isRecord(value))
+        throw new Error(`invalid plugin manifest ${manifestPath}: expected an object`);
+    if (value.protocol !== NEO_PLUGIN_PROTOCOL) {
+        throw new Error(`invalid plugin manifest ${manifestPath}: protocol must be ${NEO_PLUGIN_PROTOCOL}`);
+    }
+    const id = requireText(value.id, "id", manifestPath);
+    if (!/^[a-z0-9][a-z0-9._-]*$/u.test(id)) {
+        throw new Error(`invalid plugin manifest ${manifestPath}: invalid id ${id}`);
+    }
+    const entry = requireText(value.entry, "entry", manifestPath);
+    if (path.isAbsolute(entry))
+        throw new Error(`invalid plugin manifest ${manifestPath}: entry must be relative`);
+    return {
+        protocol: NEO_PLUGIN_PROTOCOL,
+        id,
+        name: requireText(value.name, "name", manifestPath),
+        version: requireText(value.version, "version", manifestPath),
+        entry,
+        ...(typeof value.defaultEnabled === "boolean" ? { defaultEnabled: value.defaultEnabled } : {}),
+        ...(typeof value.description === "string" && value.description.trim() ? { description: value.description.trim() } : {}),
+    };
+}
+async function loadPluginRoot(root, options) {
+    let entries;
+    try {
+        entries = await readdir(root, { withFileTypes: true });
+    }
+    catch (error) {
+        if (isNodeError(error) && error.code === "ENOENT")
+            return [];
+        throw error;
+    }
+    const directories = entries.filter((entry) => entry.isDirectory()).sort((left, right) => left.name.localeCompare(right.name));
+    const plugins = [];
+    for (const entry of directories) {
+        const pluginDir = path.resolve(root, entry.name);
+        const manifestPath = path.join(pluginDir, NEO_PLUGIN_MANIFEST);
+        let rawManifest;
+        try {
+            rawManifest = await readFile(manifestPath, "utf8");
+        }
+        catch (error) {
+            if (isNodeError(error) && error.code === "ENOENT")
+                continue;
+            throw error;
+        }
+        let parsedManifest;
+        try {
+            parsedManifest = JSON.parse(rawManifest);
+        }
+        catch (error) {
+            throw new Error(`invalid plugin manifest ${manifestPath}: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
+        }
+        const manifest = validateNeoPluginManifest(parsedManifest, manifestPath);
+        const entryPath = resolveContainedEntry(pluginDir, manifest.entry, manifestPath);
+        const module = await import(pathToFileURL(entryPath).href);
+        const factory = module.createPlugin ?? module.default;
+        if (typeof factory !== "function") {
+            throw new Error(`invalid plugin module ${entryPath}: export createPlugin(context) or a default factory`);
+        }
+        const context = Object.freeze({
+            manifest: Object.freeze({ ...manifest }),
+            pluginDir,
+            ...(options.appDataDir ? { appDataDir: path.resolve(options.appDataDir) } : {}),
+            env: Object.freeze({ ...(options.env ?? process.env) }),
+        });
+        const capabilities = normalizeCapabilities(await factory(context), entryPath);
+        plugins.push({
+            id: manifest.id,
+            name: manifest.name,
+            version: manifest.version,
+            description: manifest.description,
+            defaultEnabled: manifest.defaultEnabled !== false,
+            sourceDir: pluginDir,
+            manifestPath,
+            ...capabilities,
+        });
+    }
+    return plugins;
+}
+function normalizeCapabilities(value, entryPath) {
+    if (!isRecord(value))
+        throw new Error(`invalid plugin module ${entryPath}: factory must return an object`);
+    const tools = value.tools === undefined ? [] : requireArray(value.tools, "tools", entryPath);
+    const promptSections = value.promptSections === undefined ? [] : requireArray(value.promptSections, "promptSections", entryPath);
+    for (const [index, tool] of tools.entries())
+        validateTool(tool, index, entryPath);
+    for (const [index, section] of promptSections.entries())
+        validatePromptSection(section, index, entryPath);
+    if (value.route !== undefined && typeof value.route !== "function") {
+        throw new Error(`invalid plugin module ${entryPath}: route must be a function`);
+    }
+    if (value.presentToolResult !== undefined && typeof value.presentToolResult !== "function") {
+        throw new Error(`invalid plugin module ${entryPath}: presentToolResult must be a function`);
+    }
+    const normalizedTools = tools;
+    const normalizedSections = promptSections;
+    assertUnique(normalizedTools.map((tool) => tool.name), `duplicate tool name in plugin module ${entryPath}`);
+    return {
+        tools: [...normalizedTools],
+        promptSections: normalizedSections.map((section) => ({ ...section })),
+        ...(typeof value.presentToolResult === "function" ? { presentToolResult: value.presentToolResult } : {}),
+        ...(typeof value.route === "function" ? { route: value.route } : {}),
+    };
+}
+function validateTool(value, index, entryPath) {
+    if (!isRecord(value))
+        throw new Error(`invalid plugin module ${entryPath}: tools[${index}] must be an object`);
+    if (!requireOptionalText(value.name))
+        throw new Error(`invalid plugin module ${entryPath}: tools[${index}].name is required`);
+    if (!(typeof value.description === "string" || typeof value.description === "function")) {
+        throw new Error(`invalid plugin module ${entryPath}: tools[${index}].description is required`);
+    }
+    if (!isRecord(value.inputSchema))
+        throw new Error(`invalid plugin module ${entryPath}: tools[${index}].inputSchema is required`);
+    if (!isRecord(value.metadata))
+        throw new Error(`invalid plugin module ${entryPath}: tools[${index}].metadata is required`);
+    if (typeof value.execute !== "function" && typeof value.call !== "function") {
+        throw new Error(`invalid plugin module ${entryPath}: tools[${index}] must implement execute or call`);
+    }
+}
+function validatePromptSection(value, index, entryPath) {
+    if (!isRecord(value) || !requireOptionalText(value.name) || typeof value.content !== "string") {
+        throw new Error(`invalid plugin module ${entryPath}: promptSections[${index}] must contain name and content`);
+    }
+    if (value.cacheStable !== undefined && typeof value.cacheStable !== "boolean") {
+        throw new Error(`invalid plugin module ${entryPath}: promptSections[${index}].cacheStable must be boolean`);
+    }
+}
+function resolveContainedEntry(pluginDir, entry, manifestPath) {
+    const resolved = path.resolve(pluginDir, entry);
+    const relative = path.relative(pluginDir, resolved);
+    if (!relative || relative === ".." || relative.startsWith(`..${path.sep}`) || path.isAbsolute(relative)) {
+        throw new Error(`invalid plugin manifest ${manifestPath}: entry must resolve inside the plugin directory`);
+    }
+    return resolved;
+}
+function normalizeRoots(value) {
+    const roots = (Array.isArray(value) ? value : [value])
+        .map((root) => String(root || "").trim())
+        .filter(Boolean)
+        .map((root) => path.resolve(root));
+    return [...new Set(roots)];
+}
+function requireText(value, field, manifestPath) {
+    const text = typeof value === "string" ? value.trim() : "";
+    if (!text)
+        throw new Error(`invalid plugin manifest ${manifestPath}: ${field} is required`);
+    return text;
+}
+function requireArray(value, field, entryPath) {
+    if (!Array.isArray(value))
+        throw new Error(`invalid plugin module ${entryPath}: ${field} must be an array`);
+    return value;
+}
+function requireOptionalText(value) {
+    return typeof value === "string" && Boolean(value.trim());
+}
+function assertUnique(values, message) {
+    const seen = new Set();
+    for (const value of values) {
+        if (seen.has(value))
+            throw new Error(`${message}: ${value}`);
+        seen.add(value);
+    }
+}
+function isRecord(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function isNodeError(error) {
+    return error instanceof Error && "code" in error;
+}
+//# sourceMappingURL=plugin-system.js.map

package/dist/plugins/plugin-system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-system.js","sourceRoot":"","sources":["../../src/plugins/plugin-system.ts"],"names":[],"mappings":"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"}

package/dist/plugins/smoke-plugin-system.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/plugins/smoke-plugin-system.js

@@ -0,0 +1,63 @@
+import assert from "node:assert/strict";
+import { mkdtemp, mkdir, rm, writeFile } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { loadNeoPlugins, NEO_PLUGIN_PROTOCOL, validateNeoPluginManifest } from "./plugin-system.js";
+async function main() {
+    const root = await mkdtemp(path.join(os.tmpdir(), "neo-plugin-smoke-"));
+    const dataDir = path.join(root, "data");
+    try {
+        await createPlugin(root, "beta", false, "beta_tool");
+        await createPlugin(root, "alpha", true, "alpha_tool");
+        await mkdir(path.join(root, "not-a-plugin"), { recursive: true });
+        const plugins = await loadNeoPlugins({
+            directories: root,
+            appDataDir: dataDir,
+            env: { SMOKE_VALUE: "available" },
+        });
+        assert.deepEqual(plugins.map((plugin) => plugin.id), ["alpha", "beta"]);
+        assert.deepEqual(plugins.map((plugin) => plugin.defaultEnabled), [true, false]);
+        assert.deepEqual(plugins.flatMap((plugin) => plugin.tools.map((tool) => tool.name)), ["alpha_tool", "beta_tool"]);
+        assert.equal(plugins[0]?.promptSections[0]?.content, `available:${path.resolve(dataDir)}`);
+        assert.equal(await plugins[0]?.route?.({ method: "GET" }, {}, new URL("http://localhost/alpha"), {}), true);
+        assert.throws(() => validateNeoPluginManifest({ protocol: "other", id: "bad", name: "Bad", version: "1", entry: "index.mjs" }), /protocol must be neo-plugin\/v1/);
+        const missing = await loadNeoPlugins({ directories: path.join(root, "missing") });
+        assert.deepEqual(missing, []);
+        console.log(JSON.stringify({ ok: true, protocol: NEO_PLUGIN_PROTOCOL, plugins: plugins.map((plugin) => plugin.id) }, null, 2));
+    }
+    finally {
+        await rm(root, { recursive: true, force: true });
+    }
+}
+async function createPlugin(root, id, defaultEnabled, toolName) {
+    const pluginDir = path.join(root, id);
+    await mkdir(pluginDir, { recursive: true });
+    await writeFile(path.join(pluginDir, "neo-plugin.json"), JSON.stringify({
+        protocol: NEO_PLUGIN_PROTOCOL,
+        id,
+        name: id.toUpperCase(),
+        version: "1.0.0",
+        entry: "index.mjs",
+        defaultEnabled,
+    }, null, 2));
+    await writeFile(path.join(pluginDir, "index.mjs"), `
+export function createPlugin(context) {
+  return {
+    tools: [{
+      name: ${JSON.stringify(toolName)},
+      description: "smoke tool",
+      inputSchema: { type: "object" },
+      metadata: { readOnly: true, concurrent: true, visible: true },
+      async execute() { return { ok: true, output: context.manifest.id }; },
+    }],
+    promptSections: [{ name: "Smoke", content: context.env.SMOKE_VALUE + ":" + context.appDataDir, cacheStable: true }],
+    route(request, response, url) { return url.pathname === "/" + context.manifest.id; },
+  };
+}
+`, "utf8");
+}
+main().catch((error) => {
+    console.error(error);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=smoke-plugin-system.js.map

package/dist/plugins/smoke-plugin-system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smoke-plugin-system.js","sourceRoot":"","sources":["../../src/plugins/smoke-plugin-system.ts"],"names":[],"mappings":"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"}

package/dist/repl/index.js

@@ -28,7 +28,7 @@ import { SecretStore } from "../secrets/secret-store.js";
 import { InMemorySecretRedactionRegistry } from "../secrets/secret-redaction.js";
 import { createAgentTool, resumeAgentTask } from "../agents/agent-tool.js";
 import { AgentActivityStore } from "../agents/agent-activity.js";
-import { createTaskTools } from "../tasks/task-tools.js";
+import { createSubagentTools } from "../tasks/subagent-tools.js";
 import { TaskStore } from "../tasks/task-store.js";
 import { cliHelpText, isModelReasoningArgument, isValidReplCommandLine, parseCliReplCommandArgs, parseReplCommand, helpText, replCommandDefinitions } from "./commands.js";
 import { markdownRenderKey, MarkdownText } from "./markdown-renderer.js";
@@ -295,7 +295,7 @@ async function createRuntime(options = {}) {
         };
         return resumeAgentTask(taskId, directive, agentRuntime, taskStore, dummyContext);
     };
-    for (const tool of createTaskTools(taskStore, resumeHandler))
+    for (const tool of createSubagentTools(taskStore, resumeHandler))
         tools.register(tool);
     const taskNotificationSource = createTaskNotificationSource(taskStore);
     const engine = new QueryEngine({
@@ -894,6 +894,7 @@ function InkRepl({ runtime, initialCommandLine }) {
         if (event.type === "state")
             return;
         if (event.type === "context.metrics" ||
+            event.type === "context.compacted" ||
             event.type === "usage" ||
             event.type === "tool_call.delta" ||
             event.type === "assistant.delta" ||
@@ -943,6 +944,7 @@ function InkRepl({ runtime, initialCommandLine }) {
         if (event.type === "tool.started") {
             finalizeLiveLine(assistantLineId.current);
             finalizeThinkingLine();
+            assistantLineId.current = undefined;
             return;
         }
         if (event.type === "tool.finished")
@@ -1231,7 +1233,7 @@ function InkRepl({ runtime, initialCommandLine }) {
                 if (runtime.engine !== engine)
                     continue;
                 if (suppressReattachedStreamingRef.current.has(engine)) {
-                    if (event.type === "message" || event.type === "terminal" || event.type === "error" || event.type === "context.metrics" || event.type === "usage") {
+                    if (event.type === "message" || event.type === "terminal" || event.type === "error" || event.type === "context.metrics" || event.type === "context.compacted" || event.type === "usage") {
                         if (event.type === "message" || event.type === "terminal" || event.type === "error")
                             suppressReattachedStreamingRef.current.delete(engine);
                         handleEvent(event);
@@ -2862,6 +2864,8 @@ function thinkingText(message) {
     return text.length > 0 ? text : undefined;
 }
 function reduceStatus(status, event) {
+    if (event.type === "context.compacted")
+        return { ...status, phase: "compacting", detail: `${event.compaction.newWindowMessages} messages in new window`, activityTick: status.activityTick + 1 };
     if (event.type === "state") {
         return {
             ...status,
@@ -3551,8 +3555,9 @@ function formatUsageTotals(totals) {
 }
 function formatManualCompaction(result) {
     if (!result.changed)
-        return "No earlier context available to compact.";
-    return `manual context compacted: ${result.messages.length} messages retained, ${formatNumber(result.charsFreed ?? result.tokensFreed ?? 0)} chars freed`;
+        return "No conversation context available to compact.";
+    const preservedUsers = result.report?.preservedUserMessages ?? result.messages.filter((message) => message.metadata?.compactPreservedUser === true).length;
+    return `manual context compacted: ${result.messages.length} messages in new window, ${preservedUsers} user message(s) preserved`;
 }
 function formatPureCompaction(result) {
     if (!result.changed)
@@ -3657,7 +3662,7 @@ function formatToolUse(toolUse) {
             text: formatPlanToolPayload(toolUse.input),
         };
     }
-    const description = toolUse.name === "exec_command" ? execDescriptionFromInput(toolUse.input) : undefined;
+    const description = toolUse.name === "terminal_run" ? execDescriptionFromInput(toolUse.input) : undefined;
     return {
         kind: "tool",
         title: toolTitle(toolUse.name),
@@ -3712,12 +3717,12 @@ function toolTitle(toolName) {
         skill_validate: "skill validation",
         skill_create: "skill create",
         skill_update: "skill update",
-        TaskList: "task list",
-        TaskGet: "task detail",
-        TaskOutput: "task output",
-        TaskStop: "task stop",
-        TaskResume: "task resume",
-        SendMessage: "task message",
+        subagent_list: "task list",
+        subagent_get: "task detail",
+        subagent_output: "task output",
+        subagent_stop: "task stop",
+        subagent_resume: "task resume",
+        subagent_message: "task message",
     };
     return `\u25c6 ${labels[toolName] ?? `tool: ${toolName}`}`;
 }
@@ -3854,19 +3859,19 @@ function formatToolResult(toolName, output, ok) {
     if (typeof output === "string" && hasAnsi(output)) {
         return { text: output, format: "ansi" };
     }
-    if (toolName === "list" && isRecord(output)) {
+    if (toolName === "file_list" && isRecord(output)) {
         return { text: formatListToolResult(output, ok), format: "ansi" };
     }
-    if (toolName === "read" && isRecord(output)) {
+    if (toolName === "file_read" && isRecord(output)) {
         return { text: formatReadToolResult(output, ok), format: "ansi" };
     }
-    if (toolName === "grep" && isRecord(output)) {
+    if (toolName === "file_search" && isRecord(output)) {
         return { text: formatGrepToolResult(output, ok), format: "ansi" };
     }
-    if (toolName === "search" && isRecord(output)) {
+    if (toolName === "web_search" && isRecord(output)) {
         return { text: formatWebSearchToolResult(output, ok), summaryMaxLines: EXPANDED_SUMMARY_MAX_LINES };
     }
-    if (toolName === "image2" && isRecord(output)) {
+    if (toolName === "image_create" && isRecord(output)) {
         return { text: formatImageGenerationToolResult(output, ok), format: "ansi", summaryMaxLines: 8 };
     }
     if (toolName === "image_note" && isRecord(output)) {