@dobby.ai/dobby 0.1.0 → 0.1.2

package/dist/src/cli/program.js

@@ -1,12 +1,22 @@
+import { existsSync, readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
 import { Command } from "commander";
-import { runConfigEditCommand, runConfigListCommand, runConfigSchemaListCommand, runConfigSchemaShowCommand, runConfigShowCommand, } from "./commands/config.js";
-import { runConfigureCommand } from "./commands/configure.js";
+import { runConfigListCommand, runConfigSchemaListCommand, runConfigSchemaShowCommand, runConfigShowCommand, } from "./commands/config.js";
 import { runCronAddCommand, runCronListCommand, runCronPauseCommand, runCronRemoveCommand, runCronResumeCommand, runCronRunCommand, runCronStatusCommand, runCronUpdateCommand, } from "./commands/cron.js";
 import { runDoctorCommand } from "./commands/doctor.js";
 import { runExtensionInstallCommand, runExtensionListCommand, runExtensionUninstallCommand, } from "./commands/extension.js";
 import { runInitCommand } from "./commands/init.js";
 import { runStartCommand } from "./commands/start.js";
-import { runBindingListCommand, runBindingRemoveCommand, runBindingSetCommand, runBotListCommand, runBotSetCommand, runRouteListCommand, runRouteRemoveCommand, runRouteSetCommand, } from "./commands/topology.js";
+function loadCliVersion() {
+    const candidates = [
+        fileURLToPath(new URL("../../package.json", import.meta.url)),
+        fileURLToPath(new URL("../../../package.json", import.meta.url)),
+    ];
+    const fallbackCandidate = fileURLToPath(new URL("../../package.json", import.meta.url));
+    const packageJsonPath = candidates.find((candidate) => existsSync(candidate)) ?? fallbackCandidate;
+    return JSON.parse(readFileSync(packageJsonPath, "utf-8")).version;
+}
+const CLI_VERSION = loadCliVersion();
 /**
  * Builds the top-level dobby CLI program and registers all subcommands.
  */
@@ -14,6 +24,7 @@ export function buildProgram() {
     const program = new Command();
     program
         .name("dobby")
+        .version(CLI_VERSION)
         .description("Discord-first local agent gateway")
         .showHelpAfterError()
         .action(async () => {
@@ -31,125 +42,7 @@ export function buildProgram() {
         .action(async () => {
         await runInitCommand();
     });
-    program
-        .command("configure")
-        .description("Interactive configuration wizard")
-        .option("--section <section>", "Config section (repeatable): provider|connector|route|binding|sandbox|data", (value, previous) => [...previous, value], [])
-        .action(async (opts) => {
-        await runConfigureCommand({
-            sections: opts.section,
-        });
-    });
-    const botCommand = program.command("bot").description("Manage bot connector settings");
-    botCommand
-        .command("list")
-        .description("List configured bot connectors")
-        .option("--json", "Output JSON", false)
-        .action(async (opts) => {
-        await runBotListCommand({
-            json: Boolean(opts.json),
-        });
-    });
-    botCommand
-        .command("set")
-        .description("Update one bot connector")
-        .argument("<connectorId>", "Connector instance ID")
-        .option("--name <name>", "Discord botName")
-        .option("--token <token>", "Discord botToken")
-        .action(async (connectorId, opts) => {
-        await runBotSetCommand({
-            connectorId,
-            ...(typeof opts.name === "string" ? { name: opts.name } : {}),
-            ...(typeof opts.token === "string" ? { token: opts.token } : {}),
-        });
-    });
-    const bindingCommand = program.command("binding").description("Manage connector source-route bindings");
-    bindingCommand
-        .command("list")
-        .description("List bindings")
-        .option("--connector <id>", "Filter by connector instance ID")
-        .option("--json", "Output JSON", false)
-        .action(async (opts) => {
-        await runBindingListCommand({
-            ...(typeof opts.connector === "string" ? { connectorId: opts.connector } : {}),
-            json: Boolean(opts.json),
-        });
-    });
-    bindingCommand
-        .command("set")
-        .description("Create or update one binding")
-        .argument("<bindingId>", "Binding ID")
-        .requiredOption("--connector <id>", "Connector instance ID")
-        .requiredOption("--source-type <type>", "Source type: channel|chat")
-        .requiredOption("--source-id <id>", "Source ID")
-        .requiredOption("--route <id>", "Route ID")
-        .action(async (bindingId, opts) => {
-        if (opts.sourceType !== "channel" && opts.sourceType !== "chat") {
-            throw new Error("--source-type must be channel or chat");
-        }
-        await runBindingSetCommand({
-            bindingId,
-            connectorId: opts.connector,
-            sourceType: opts.sourceType,
-            sourceId: opts.sourceId,
-            routeId: opts.route,
-        });
-    });
-    bindingCommand
-        .command("remove")
-        .description("Remove one binding")
-        .argument("<bindingId>", "Binding ID")
-        .action(async (bindingId) => {
-        await runBindingRemoveCommand({
-            bindingId,
-        });
-    });
-    const routeCommand = program.command("route").description("Manage route profiles");
-    routeCommand
-        .command("list")
-        .description("List route profiles")
-        .option("--json", "Output JSON", false)
-        .action(async (opts) => {
-        await runRouteListCommand({
-            json: Boolean(opts.json),
-        });
-    });
-    routeCommand
-        .command("set")
-        .description("Create or update one route")
-        .argument("<routeId>", "Route ID")
-        .option("--project-root <path>", "Route project root")
-        .option("--tools <profile>", "Route tools profile: full|readonly")
-        .option("--provider <id>", "Provider instance ID")
-        .option("--sandbox <id>", "Sandbox instance ID")
-        .option("--mentions <policy>", "Mention policy: required|optional")
-        .action(async (routeId, opts) => {
-        if (typeof opts.mentions === "string"
-            && opts.mentions !== "required"
-            && opts.mentions !== "optional") {
-            throw new Error("--mentions must be required or optional");
-        }
-        await runRouteSetCommand({
-            routeId,
-            ...(typeof opts.projectRoot === "string" ? { projectRoot: opts.projectRoot } : {}),
-            ...(typeof opts.tools === "string" ? { tools: opts.tools } : {}),
-            ...(typeof opts.provider === "string" ? { providerId: opts.provider } : {}),
-            ...(typeof opts.sandbox === "string" ? { sandboxId: opts.sandbox } : {}),
-            ...(typeof opts.mentions === "string" ? { mentions: opts.mentions } : {}),
-        });
-    });
-    routeCommand
-        .command("remove")
-        .description("Remove one route")
-        .argument("<routeId>", "Route ID")
-        .option("--cascade-bindings", "Remove bindings that reference this route", false)
-        .action(async (routeId, opts) => {
-        await runRouteRemoveCommand({
-            routeId,
-            cascadeBindings: Boolean(opts.cascadeBindings),
-        });
-    });
-    const configCommand = program.command("config").description("Inspect and edit config");
+    const configCommand = program.command("config").description("Inspect config");
     configCommand
         .command("show")
         .description("Show full config or one section")
@@ -172,15 +65,6 @@ export function buildProgram() {
             json: Boolean(opts.json),
         });
     });
-    configCommand
-        .command("edit")
-        .description("Interactive edit for high-frequency sections")
-        .option("--section <section>", "Edit section (repeatable): provider|connector|route|binding", (value, previous) => [...previous, value], [])
-        .action(async (opts) => {
-        await runConfigEditCommand({
-            sections: opts.section,
-        });
-    });
     const configSchemaCommand = configCommand.command("schema").description("Inspect extension config schemas");
     configSchemaCommand
         .command("list")
@@ -253,7 +137,6 @@ export function buildProgram() {
         .requiredOption("--route <id>", "Route ID")
         .requiredOption("--channel <id>", "Delivery channel/chat ID")
         .option("--thread <id>", "Delivery thread ID")
-        .option("--session-policy <policy>", "Session policy: stateless|shared-session", "stateless")
         .option("--at <iso>", "Run once at ISO timestamp")
         .option("--every-ms <ms>", "Run at fixed interval in milliseconds")
         .option("--cron <expr>", "Cron expression")
@@ -268,7 +151,6 @@ export function buildProgram() {
             routeId: opts.route,
             channelId: opts.channel,
             ...(typeof opts.thread === "string" ? { threadId: opts.thread } : {}),
-            sessionPolicy: opts.sessionPolicy,
             ...(typeof opts.at === "string" ? { at: opts.at } : {}),
             ...(parsedEveryMs !== null && Number.isFinite(parsedEveryMs) ? { everyMs: parsedEveryMs } : {}),
             ...(typeof opts.cron === "string" ? { cronExpr: opts.cron } : {}),
@@ -322,7 +204,6 @@ export function buildProgram() {
         .option("--channel <id>", "Delivery channel/chat ID")
         .option("--thread <id>", "Delivery thread ID")
         .option("--clear-thread", "Unset delivery thread", false)
-        .option("--session-policy <policy>", "Session policy: stateless|shared-session")
         .option("--at <iso>", "Run once at ISO timestamp")
         .option("--every-ms <ms>", "Run at fixed interval in milliseconds")
         .option("--cron <expr>", "Cron expression")
@@ -339,9 +220,6 @@ export function buildProgram() {
             ...(typeof opts.channel === "string" ? { channelId: opts.channel } : {}),
             ...(typeof opts.thread === "string" ? { threadId: opts.thread } : {}),
             clearThread: Boolean(opts.clearThread),
-            ...(typeof opts.sessionPolicy === "string"
-                ? { sessionPolicy: opts.sessionPolicy }
-                : {}),
             ...(typeof opts.at === "string" ? { at: opts.at } : {}),
             ...(parsedEveryMs !== null && Number.isFinite(parsedEveryMs) ? { everyMs: parsedEveryMs } : {}),
             ...(typeof opts.cron === "string" ? { cronExpr: opts.cron } : {}),

package/dist/src/cli/shared/config-io.js

@@ -1,8 +1,8 @@
-import { existsSync, readFileSync } from "node:fs";
 import { access, mkdir, readFile, rename, rm, writeFile } from "node:fs/promises";
 import { dirname, isAbsolute, resolve } from "node:path";
 import { homedir } from "node:os";
 import { loadGatewayConfig } from "../../core/routing.js";
+import { findDobbyRepoRoot, isDobbyRepoRoot } from "../../shared/dobby-repo.js";
 /**
  * Default config file path used by all CLI commands.
  */
@@ -19,25 +19,6 @@ function expandHome(value) {
     }
     return value;
 }
-/**
- * Returns true when a directory looks like the dobby repository root.
- */
-function isDobbyRepoRoot(candidateDir) {
-    const packageJsonPath = resolve(candidateDir, "package.json");
-    const repoConfigPath = resolve(candidateDir, "config", "gateway.json");
-    const localExtensionsScriptPath = resolve(candidateDir, "scripts", "local-extensions.mjs");
-    if (!existsSync(packageJsonPath) || !existsSync(repoConfigPath) || !existsSync(localExtensionsScriptPath)) {
-        return false;
-    }
-    try {
-        const packageJsonRaw = readFileSync(packageJsonPath, "utf-8");
-        const parsed = JSON.parse(packageJsonRaw);
-        return parsed.name === "dobby";
-    }
-    catch {
-        return false;
-    }
-}
 function resolveConfigBaseDir(configPath) {
     const absoluteConfigPath = resolve(configPath);
     const configDir = dirname(absoluteConfigPath);
@@ -51,17 +32,8 @@ function resolveConfigBaseDir(configPath) {
  * Scans current directory and ancestors to find a local dobby repo config path.
  */
 function findDobbyRepoConfigPath(startDir) {
-    let currentDir = resolve(startDir);
-    while (true) {
-        if (isDobbyRepoRoot(currentDir)) {
-            return resolve(currentDir, "config", "gateway.json");
-        }
-        const parentDir = dirname(currentDir);
-        if (parentDir === currentDir) {
-            return null;
-        }
-        currentDir = parentDir;
-    }
+    const repoRoot = findDobbyRepoRoot(startDir);
+    return repoRoot ? resolve(repoRoot, "config", "gateway.json") : null;
 }
 /**
  * Resolves config path source by priority: env override -> local repo -> default home path.

package/dist/src/cli/shared/config-mutators.js

@@ -42,6 +42,7 @@ function asRouteDefaults(value) {
         };
     }
     return {
+        ...(typeof value.projectRoot === "string" && value.projectRoot.trim().length > 0 ? { projectRoot: value.projectRoot } : {}),
         ...(typeof value.provider === "string" && value.provider.trim().length > 0 ? { provider: value.provider } : {}),
         ...(typeof value.sandbox === "string" && value.sandbox.trim().length > 0 ? { sandbox: value.sandbox } : {}),
         tools: value.tools === "readonly" ? "readonly" : "full",
@@ -54,12 +55,12 @@ function asRoutes(value) {
     }
     const normalized = {};
     for (const [routeId, route] of Object.entries(value)) {
-        if (!isRecord(route) || typeof route.projectRoot !== "string" || route.projectRoot.trim().length === 0) {
+        if (!isRecord(route)) {
             continue;
         }
         normalized[routeId] = {
             ...route,
-            projectRoot: route.projectRoot,
+            ...(typeof route.projectRoot === "string" && route.projectRoot.trim().length > 0 ? { projectRoot: route.projectRoot } : {}),
             ...(route.tools === "readonly" ? { tools: "readonly" } : {}),
             ...(route.mentions === "optional" ? { mentions: "optional" } : {}),
             ...(typeof route.provider === "string" && route.provider.trim().length > 0 ? { provider: route.provider } : {}),
@@ -69,6 +70,15 @@ function asRoutes(value) {
     }
     return normalized;
 }
+function asDefaultBinding(value) {
+    if (!isRecord(value) || typeof value.route !== "string" || value.route.trim().length === 0) {
+        return undefined;
+    }
+    return {
+        ...value,
+        route: value.route,
+    };
+}
 function asBindings(value) {
     if (!isRecord(value)) {
         return {};
@@ -109,13 +119,14 @@ export function ensureGatewayConfigShape(config) {
     const normalizedSandboxesDefault = typeof config.sandboxes?.default === "string" && config.sandboxes.default.trim().length > 0
         ? config.sandboxes.default
         : "host.builtin";
-    const routeDefaults = asRouteDefaults(config.routes?.defaults);
+    const routeDefaults = asRouteDefaults(config.routes?.default);
     if (!routeDefaults.provider && normalizedProvidersDefault) {
         routeDefaults.provider = normalizedProvidersDefault;
     }
     if (!routeDefaults.sandbox && normalizedSandboxesDefault) {
         routeDefaults.sandbox = normalizedSandboxesDefault;
     }
+    const defaultBinding = asDefaultBinding(config.bindings?.default);
     return {
         ...config,
         extensions: {
@@ -138,11 +149,12 @@ export function ensureGatewayConfigShape(config) {
         },
         routes: {
             ...(isRecord(config.routes) ? config.routes : {}),
-            defaults: routeDefaults,
+            default: routeDefaults,
             items: asRoutes(config.routes?.items),
         },
         bindings: {
             ...(isRecord(config.bindings) ? config.bindings : {}),
+            ...(defaultBinding ? { default: defaultBinding } : {}),
             items: asBindings(config.bindings?.items),
         },
         data: {
@@ -283,11 +295,11 @@ export function setDefaultProviderIfMissingOrInvalid(config) {
     const defaultProvider = next.providers.default;
     if (defaultProvider && items[defaultProvider]) {
         config.providers = next.providers;
-        if (!next.routes.defaults.provider) {
+        if (!next.routes.default.provider) {
             config.routes = {
                 ...next.routes,
                 defaults: {
-                    ...next.routes.defaults,
+                    ...next.routes.default,
                     provider: defaultProvider,
                 },
             };
@@ -306,8 +318,8 @@ export function setDefaultProviderIfMissingOrInvalid(config) {
     };
     config.routes = {
         ...next.routes,
-        defaults: {
-            ...next.routes.defaults,
+        default: {
+            ...next.routes.default,
             provider: candidates[0],
         },
     };
@@ -315,7 +327,7 @@ export function setDefaultProviderIfMissingOrInvalid(config) {
 export function upsertRoute(config, routeId, profile) {
     const next = ensureGatewayConfigShape(config);
     next.routes.items[routeId] = {
-        projectRoot: profile.projectRoot,
+        ...(typeof profile.projectRoot === "string" && profile.projectRoot.trim().length > 0 ? { projectRoot: profile.projectRoot } : {}),
         ...(profile.tools ? { tools: profile.tools } : {}),
         ...(profile.mentions ? { mentions: profile.mentions } : {}),
         ...(profile.provider ? { provider: profile.provider } : {}),
@@ -335,6 +347,18 @@ export function upsertBinding(config, bindingId, binding) {
         items: next.bindings.items,
     };
 }
+export function setDefaultBinding(config, binding) {
+    const next = ensureGatewayConfigShape(config);
+    const normalizedBinding = binding ? structuredClone(binding) : undefined;
+    config.bindings = {
+        ...next.bindings,
+        ...(normalizedBinding ? { default: normalizedBinding } : {}),
+        items: next.bindings.items,
+    };
+    if (!normalizedBinding) {
+        delete config.bindings.default;
+    }
+}
 export function listContributionIds(config) {
     const next = ensureGatewayConfigShape(config);
     return {

package/dist/src/cli/shared/configure-sections.js

@@ -1,6 +1,6 @@
 import { cancel, confirm, isCancel, note, password, select, text, } from "@clack/prompts";
 import JSON5 from "json5";
-import { ensureGatewayConfigShape, setDefaultProviderIfMissingOrInvalid, upsertBinding, upsertConnectorInstance, upsertProviderInstance, upsertRoute, } from "./config-mutators.js";
+import { ensureGatewayConfigShape, setDefaultBinding, setDefaultProviderIfMissingOrInvalid, upsertBinding, upsertConnectorInstance, upsertProviderInstance, upsertRoute, } from "./config-mutators.js";
 import { DEFAULT_DISCORD_BOT_NAME, DISCORD_CONNECTOR_CONTRIBUTION_ID, } from "./discord-config.js";
 import { promptConfigFromSchema } from "./schema-prompts.js";
 export const CONFIGURE_SECTION_VALUES = ["provider", "connector", "route", "binding", "sandbox", "data"];
@@ -147,7 +147,7 @@ async function configureProviderSection(config, context) {
             throw new Error("Configure cancelled.");
         }
         next.providers.default = String(defaultProvider);
-        next.routes.defaults.provider = String(defaultProvider);
+        next.routes.default.provider = String(defaultProvider);
     }
     Object.assign(config, next);
 }
@@ -229,11 +229,32 @@ async function configureRouteSection(config) {
     }
     const routeId = String(targetRoute) === "__new" ? await requiredText("New route ID", "main") : String(targetRoute);
     const existing = routeItems[routeId];
-    const projectRoot = await requiredText("projectRoot", existing?.projectRoot ?? process.cwd());
+    const defaultProjectRoot = next.routes.default.projectRoot;
+    let projectRoot = existing?.projectRoot;
+    if (defaultProjectRoot) {
+        const projectRootMode = await select({
+            message: "projectRoot",
+            options: [
+                { value: "__default", label: `Use route default (${defaultProjectRoot})` },
+                { value: "__custom", label: "Set explicit projectRoot" },
+            ],
+            initialValue: existing?.projectRoot ? "__custom" : "__default",
+        });
+        if (isCancel(projectRootMode)) {
+            cancel("Configure cancelled.");
+            throw new Error("Configure cancelled.");
+        }
+        projectRoot = projectRootMode === "__custom"
+            ? await requiredText("projectRoot", existing?.projectRoot ?? defaultProjectRoot)
+            : undefined;
+    }
+    else {
+        projectRoot = await requiredText("projectRoot", existing?.projectRoot ?? process.cwd());
+    }
     const tools = await select({
         message: "tools",
         options: [
-            { value: "__default", label: `Use route default (${next.routes.defaults.tools ?? "full"})` },
+            { value: "__default", label: `Use route default (${next.routes.default.tools ?? "full"})` },
             { value: "full", label: "full" },
             { value: "readonly", label: "readonly" },
         ],
@@ -246,7 +267,7 @@ async function configureRouteSection(config) {
     const mentions = await select({
         message: "mentions",
         options: [
-            { value: "__default", label: `Use route default (${next.routes.defaults.mentions ?? "required"})` },
+            { value: "__default", label: `Use route default (${next.routes.default.mentions ?? "required"})` },
             { value: "required", label: "required" },
             { value: "optional", label: "optional" },
         ],
@@ -261,7 +282,7 @@ async function configureRouteSection(config) {
         ? await select({
             message: "provider",
             options: [
-                { value: "__default", label: `Use route default (${(next.routes.defaults.provider ?? next.providers.default) || "(unset)"})` },
+                { value: "__default", label: `Use route default (${(next.routes.default.provider ?? next.providers.default) || "(unset)"})` },
                 ...providerIds.map((id) => ({ value: id, label: id })),
             ],
             initialValue: existing?.provider ?? "__default",
@@ -275,7 +296,7 @@ async function configureRouteSection(config) {
     const sandboxValue = await select({
         message: "sandbox",
         options: [
-            { value: "__default", label: `Use route default (${next.routes.defaults.sandbox ?? next.sandboxes.default})` },
+            { value: "__default", label: `Use route default (${next.routes.default.sandbox ?? next.sandboxes.default})` },
             ...sandboxIds.map((id) => ({ value: id, label: id })),
         ],
         initialValue: existing?.sandbox ?? "__default",
@@ -286,7 +307,7 @@ async function configureRouteSection(config) {
     }
     const systemPromptFile = await optionalText("systemPromptFile (optional)", existing?.systemPromptFile ?? "");
     upsertRoute(next, routeId, {
-        projectRoot,
+        ...(projectRoot ? { projectRoot } : {}),
         ...(tools !== "__default" ? { tools: String(tools) } : {}),
         ...(mentions !== "__default" ? { mentions: String(mentions) } : {}),
         ...(providerValue !== "__default" ? { provider: String(providerValue) } : {}),
@@ -306,19 +327,39 @@ async function configureBindingSection(config) {
         throw new Error("No routes found. Configure routes first.");
     }
     const targetBinding = bindingChoices.length === 0
-        ? "__new"
+        ? (next.bindings.default ? "__default" : "__new")
         : await select({
             message: "Select binding",
             options: [
+                { value: "__default", label: next.bindings.default ? "Edit default direct-message binding" : "Create default direct-message binding" },
                 ...bindingChoices.map((id) => ({ value: id, label: id })),
                 { value: "__new", label: "Create new binding" },
             ],
-            initialValue: bindingChoices[0],
+            initialValue: next.bindings.default ? "__default" : bindingChoices[0],
         });
     if (isCancel(targetBinding)) {
         cancel("Configure cancelled.");
         throw new Error("Configure cancelled.");
     }
+    const routeIds = Object.keys(next.routes.items).sort((a, b) => a.localeCompare(b));
+    if (String(targetBinding) === "__default") {
+        const defaultRouteId = await select({
+            message: "Default direct-message route",
+            options: routeIds.map((id) => ({ value: id, label: id })),
+            initialValue: next.bindings.default?.route && routeIds.includes(next.bindings.default.route)
+                ? next.bindings.default.route
+                : routeIds[0],
+        });
+        if (isCancel(defaultRouteId)) {
+            cancel("Configure cancelled.");
+            throw new Error("Configure cancelled.");
+        }
+        setDefaultBinding(next, {
+            route: String(defaultRouteId),
+        });
+        Object.assign(config, next);
+        return;
+    }
     const bindingId = String(targetBinding) === "__new"
         ? await requiredText("New binding ID", "discord.main.main")
         : String(targetBinding);
@@ -346,7 +387,6 @@ async function configureBindingSection(config) {
         throw new Error("Configure cancelled.");
     }
     const sourceId = await requiredText("source.id", existing?.source.id);
-    const routeIds = Object.keys(next.routes.items).sort((a, b) => a.localeCompare(b));
     const routeId = await select({
         message: "route",
         options: routeIds.map((id) => ({ value: id, label: id })),
@@ -386,7 +426,7 @@ async function configureSandboxSection(config) {
         throw new Error("Configure cancelled.");
     }
     next.sandboxes.default = String(defaultSandbox);
-    next.routes.defaults.sandbox = String(defaultSandbox);
+    next.routes.default.sandbox = String(defaultSandbox);
     Object.assign(config, next);
 }
 async function configureDataSection(config) {