@diffexai/diffex 0.2.1 → 0.2.3

package/dist/core/extensions/loader.js

@@ -25,9 +25,9 @@ import * as _bundledDiffexCodingAgent from "../../index.js";
 import { resolvePath } from "../../utils/paths.js";
 import { readDiffexManifest } from "../diffex-manifest.js";
 import { createEventBus } from "../event-bus.js";
-import { execCommand } from "../exec.js";
-import { createSyntheticSourceInfo } from "../source-info.js";
 import { time } from "../timings.js";
+import { createExtension, createExtensionAPI, createExtensionRuntime } from "./factory.js";
+export { createExtensionRuntime, loadExtensionFromFactory } from "./factory.js";
 /** Modules available to extensions via virtualModules (for compiled Bun binary) */
 const VIRTUAL_MODULES = {
     typebox: _bundledTypebox,
@@ -112,223 +112,6 @@ function useExtensionCacheCwd(cwd) {
     extensionCacheCwd = resolvedCwd;
     return { cwd: resolvedCwd, generation: extensionCacheGeneration };
 }
-/**
- * Create a runtime with throwing stubs for action methods.
- * Runner.bindCore() replaces these with real implementations.
- */
-export function createExtensionRuntime() {
-    const notInitialized = () => {
-        throw new Error("Extension runtime not initialized. Action methods cannot be called during extension loading.");
-    };
-    const state = {};
-    const eventBusUnsubscribers = new Set();
-    const assertActive = () => {
-        if (state.staleMessage) {
-            throw new Error(state.staleMessage);
-        }
-    };
-    const runtime = {
-        sendMessage: notInitialized,
-        sendUserMessage: notInitialized,
-        appendEntry: notInitialized,
-        setSessionName: notInitialized,
-        getSessionName: notInitialized,
-        setLabel: notInitialized,
-        getActiveTools: notInitialized,
-        getAllTools: notInitialized,
-        setActiveTools: notInitialized,
-        // registerTool() is valid during extension load; refresh is only needed post-bind.
-        refreshTools: () => { },
-        getCommands: notInitialized,
-        setModel: () => Promise.reject(new Error("Extension runtime not initialized")),
-        getThinkingLevel: notInitialized,
-        setThinkingLevel: notInitialized,
-        flagValues: new Map(),
-        pendingProviderRegistrations: [],
-        pendingNativeProviderRegistrations: [],
-        assertActive,
-        invalidate: (message) => {
-            if (state.staleMessage)
-                return;
-            state.staleMessage =
-                message ??
-                    "This extension ctx is stale after session replacement or reload. Do not use a captured Diffex API or command ctx after ctx.newSession(), ctx.fork(), ctx.switchSession(), or ctx.reload(). For newSession, fork, and switchSession, move post-replacement work into withSession and use the ctx passed to withSession. For reload, do not use the old ctx after await ctx.reload().";
-            for (const unsubscribe of eventBusUnsubscribers)
-                unsubscribe();
-            eventBusUnsubscribers.clear();
-        },
-        trackEventBusSubscription: (unsubscribe) => {
-            let active = true;
-            const trackedUnsubscribe = () => {
-                if (!active)
-                    return;
-                active = false;
-                eventBusUnsubscribers.delete(trackedUnsubscribe);
-                unsubscribe();
-            };
-            eventBusUnsubscribers.add(trackedUnsubscribe);
-            return trackedUnsubscribe;
-        },
-        // Pre-bind: queue registrations so bindCore() can flush them once the
-        // model registry is available. bindCore() replaces both with direct calls.
-        registerProvider: (name, config, extensionPath = "<unknown>") => {
-            runtime.pendingProviderRegistrations.push({ name, config, extensionPath });
-        },
-        registerNativeProvider: (provider, extensionPath = "<unknown>") => {
-            runtime.pendingNativeProviderRegistrations.push({ provider, extensionPath });
-        },
-        unregisterProvider: (name) => {
-            runtime.pendingProviderRegistrations = runtime.pendingProviderRegistrations.filter((r) => r.name !== name);
-            runtime.pendingNativeProviderRegistrations = runtime.pendingNativeProviderRegistrations.filter((r) => r.provider.id !== name);
-        },
-    };
-    return runtime;
-}
-/**
- * Create the ExtensionAPI for an extension.
- * Registration methods write to the extension object.
- * Action methods delegate to the shared runtime.
- */
-function createExtensionAPI(extension, runtime, cwd, eventBus) {
-    const api = {
-        // Registration methods - write to extension
-        on(event, handler) {
-            runtime.assertActive();
-            const list = extension.handlers.get(event) ?? [];
-            list.push(handler);
-            extension.handlers.set(event, list);
-        },
-        registerTool(tool) {
-            runtime.assertActive();
-            extension.tools.set(tool.name, {
-                definition: tool,
-                sourceInfo: extension.sourceInfo,
-            });
-            runtime.refreshTools();
-        },
-        registerCommand(name, options) {
-            runtime.assertActive();
-            extension.commands.set(name, {
-                name,
-                sourceInfo: extension.sourceInfo,
-                ...options,
-            });
-        },
-        registerShortcut(shortcut, options) {
-            runtime.assertActive();
-            extension.shortcuts.set(shortcut, { shortcut, extensionPath: extension.path, ...options });
-        },
-        registerFlag(name, options) {
-            runtime.assertActive();
-            extension.flags.set(name, { name, extensionPath: extension.path, ...options });
-            if (options.default !== undefined && !runtime.flagValues.has(name)) {
-                runtime.flagValues.set(name, options.default);
-            }
-        },
-        registerMessageRenderer(customType, renderer) {
-            runtime.assertActive();
-            extension.messageRenderers.set(customType, renderer);
-        },
-        registerMarkdownTransformer(transformer) {
-            runtime.assertActive();
-            extension.markdownTransformer = transformer;
-        },
-        registerEntryRenderer(customType, renderer) {
-            runtime.assertActive();
-            extension.entryRenderers ??= new Map();
-            extension.entryRenderers.set(customType, renderer);
-        },
-        // Flag access - checks extension registered it, reads from runtime
-        getFlag(name) {
-            runtime.assertActive();
-            if (!extension.flags.has(name))
-                return undefined;
-            return runtime.flagValues.get(name);
-        },
-        // Action methods - delegate to shared runtime
-        sendMessage(message, options) {
-            runtime.assertActive();
-            runtime.sendMessage(message, options);
-        },
-        sendUserMessage(content, options) {
-            runtime.assertActive();
-            runtime.sendUserMessage(content, options);
-        },
-        appendEntry(customType, data) {
-            runtime.assertActive();
-            runtime.appendEntry(customType, data);
-        },
-        setSessionName(name) {
-            runtime.assertActive();
-            runtime.setSessionName(name);
-        },
-        getSessionName() {
-            runtime.assertActive();
-            return runtime.getSessionName();
-        },
-        setLabel(entryId, label) {
-            runtime.assertActive();
-            runtime.setLabel(entryId, label);
-        },
-        exec(command, args, options) {
-            runtime.assertActive();
-            return execCommand(command, args, options?.cwd ?? cwd, options);
-        },
-        getActiveTools() {
-            runtime.assertActive();
-            return runtime.getActiveTools();
-        },
-        getAllTools() {
-            runtime.assertActive();
-            return runtime.getAllTools();
-        },
-        setActiveTools(toolNames) {
-            runtime.assertActive();
-            runtime.setActiveTools(toolNames);
-        },
-        getCommands() {
-            runtime.assertActive();
-            return runtime.getCommands();
-        },
-        setModel(model) {
-            runtime.assertActive();
-            return runtime.setModel(model);
-        },
-        getThinkingLevel() {
-            runtime.assertActive();
-            return runtime.getThinkingLevel();
-        },
-        setThinkingLevel(level) {
-            runtime.assertActive();
-            runtime.setThinkingLevel(level);
-        },
-        registerProvider(providerOrName, config) {
-            runtime.assertActive();
-            if (typeof providerOrName === "string") {
-                if (!config)
-                    throw new Error("Provider config is required when registering by name");
-                runtime.registerProvider(providerOrName, config, extension.path);
-                return;
-            }
-            runtime.registerNativeProvider(providerOrName, extension.path);
-        },
-        unregisterProvider(name) {
-            runtime.assertActive();
-            runtime.unregisterProvider(name, extension.path);
-        },
-        events: {
-            emit(channel, data) {
-                runtime.assertActive();
-                eventBus.emit(channel, data);
-            },
-            on(channel, handler) {
-                runtime.assertActive();
-                return runtime.trackEventBusSubscription(eventBus.on(channel, handler));
-            },
-        },
-    };
-    return api;
-}
 function isCurrentCacheToken(cacheToken) {
     return (cacheToken !== undefined &&
         extensionCacheCwd === cacheToken.cwd &&
@@ -361,27 +144,6 @@ async function loadExtensionModule(extensionPath, cacheToken) {
     }
     return factory;
 }
-/**
- * Create an Extension object with empty collections.
- */
-function createExtension(extensionPath, resolvedPath) {
-    const source = extensionPath.startsWith("<") && extensionPath.endsWith(">")
-        ? extensionPath.slice(1, -1).split(":")[0] || "temporary"
-        : "local";
-    const baseDir = extensionPath.startsWith("<") ? undefined : path.dirname(resolvedPath);
-    return {
-        path: extensionPath,
-        resolvedPath,
-        sourceInfo: createSyntheticSourceInfo(extensionPath, { source, baseDir }),
-        handlers: new Map(),
-        tools: new Map(),
-        messageRenderers: new Map(),
-        entryRenderers: new Map(),
-        commands: new Map(),
-        flags: new Map(),
-        shortcuts: new Map(),
-    };
-}
 async function loadExtension(extensionPath, cwd, eventBus, runtime, cacheToken) {
     const resolvedPath = resolvePath(extensionPath, cwd, { normalizeUnicodeSpaces: true });
     try {
@@ -401,17 +163,6 @@ async function loadExtension(extensionPath, cwd, eventBus, runtime, cacheToken)
         return { extension: null, error: `Failed to load extension: ${message}` };
     }
 }
-/**
- * Create an Extension from an inline factory function.
- */
-export async function loadExtensionFromFactory(factory, cwd, eventBus, runtime, extensionPath = "<inline>") {
-    const extension = createExtension(extensionPath, extensionPath);
-    const resolvedCwd = resolvePath(cwd);
-    const api = createExtensionAPI(extension, runtime, resolvedCwd, eventBus);
-    await factory(api);
-    time(`${extensionPath} factory`, "extensions");
-    return extension;
-}
 /**
  * Load extensions from paths.
  */

package/dist/core/prompt-templates.js

@@ -1,6 +1,6 @@
 import { existsSync, readdirSync, readFileSync, statSync } from "fs";
 import { basename, dirname, join, resolve, sep } from "path";
-import { CONFIG_DIR_NAME } from "../config.js";
+import { CONFIG_DIR_NAME, IS_PRODUCTION_DISTRIBUTION } from "../config.js";
 import { parseFrontmatter } from "../utils/frontmatter.js";
 import { resolvePath } from "../utils/paths.js";
 import { createSyntheticSourceInfo } from "./source-info.js";
@@ -83,6 +83,8 @@ function loadTemplateFromFile(filePath, sourceInfo) {
         const rawContent = readFileSync(filePath, "utf-8");
         const { frontmatter, body } = parseFrontmatter(rawContent);
         const name = basename(filePath).replace(/\.md$/, "");
+        if (IS_PRODUCTION_DISTRIBUTION && name === "cl")
+            return null;
         // Get description from frontmatter or first non-empty line
         let description = frontmatter.description || "";
         if (!description) {
@@ -225,6 +227,9 @@ export function expandPromptTemplate(text, templates) {
     if (!match)
         return text;
     const templateName = match[1];
+    if (IS_PRODUCTION_DISTRIBUTION && templateName === "cl") {
+        throw new Error("/cl is unavailable in production Diffex installations.");
+    }
     const argsString = match[2] ?? "";
     const template = templates.find((t) => t.name === templateName);
     if (template) {

package/dist/core/resource-loader.js

@@ -1,7 +1,7 @@
 import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
 import { basename, dirname, join, resolve, sep } from "node:path";
 import chalk from "chalk";
-import { CONFIG_DIR_NAME } from "../config.js";
+import { CONFIG_DIR_NAME, getPackageDir, IS_PRODUCTION_DISTRIBUTION } from "../config.js";
 import { loadThemeFromPath } from "../modes/interactive/theme/theme.js";
 import { canonicalizePath, isLocalPath, resolvePath } from "../utils/paths.js";
 import { createEventBus } from "./event-bus.js";
@@ -83,8 +83,13 @@ export function loadProjectContextFiles(options) {
     const resolvedAgentDir = resolvePath(options.agentDir);
     const contextFiles = [];
     const seenPaths = new Set();
+    if (IS_PRODUCTION_DISTRIBUTION) {
+        const path = join(getPackageDir(), "dist", "AGENTS.md");
+        contextFiles.push({ path, content: readFileSync(path, "utf-8") });
+        seenPaths.add(path);
+    }
     const globalContext = loadContextFileFromDir(resolvedAgentDir);
-    if (globalContext) {
+    if (globalContext && !seenPaths.has(globalContext.path)) {
         contextFiles.push(globalContext);
         seenPaths.add(globalContext.path);
     }

package/dist/core/system-prompt.js

@@ -1,7 +1,8 @@
 /**
  * System prompt construction and project context loading
  */
-import { getDocsPath, getExamplesPath, getReadmePath } from "../config.js";
+import { existsSync } from "node:fs";
+import { getDocsPath, getExamplesPath } from "../config.js";
 import { formatSkillsForPrompt } from "./skills.js";
 /** Build the system prompt with tools, guidelines, and context */
 export function buildSystemPrompt(options) {
@@ -37,7 +38,6 @@ export function buildSystemPrompt(options) {
         return prompt;
     }
     // Get absolute paths to documentation and examples
-    const readmePath = getReadmePath();
     const docsPath = getDocsPath();
     const examplesPath = getExamplesPath();
     // Build tools list based on selected tools.
@@ -85,13 +85,14 @@ Guidelines:
 ${guidelines}
 
 Diffex documentation (read only when the user asks about Diffex itself, its SDK, extensions, themes, skills, or TUI):
-- Main documentation: ${readmePath}
+${existsSync(docsPath)
+        ? `- Product website: https://diffex.ai/
 - Additional docs: ${docsPath}
-- Examples: ${examplesPath} (extensions, custom tools, SDK)
-- When reading Diffex docs or examples, resolve docs/... under Additional docs and examples/... under Examples, not the current working directory
-- When asked about: extensions (docs/extensions.md, examples/extensions/), themes (docs/themes.md), skills (docs/skills.md), prompt templates (docs/prompt-templates.md), TUI components (docs/tui.md), keybindings (docs/keybindings.md), SDK integrations (docs/sdk.md), custom providers (docs/custom-provider.md), adding models (docs/models.md), Diffex packages (docs/packages.md), environment variables (docs/environment-variables.md)
-- When working on Diffex topics, read the docs and examples, and follow .md cross-references before implementing
-- Always read Diffex.md files completely and follow links to related docs (e.g., tui.md for TUI API details)`;
+${existsSync(examplesPath) ? `- Examples: ${examplesPath} (extensions, custom tools, SDK)\n- When reading Diffex docs or examples, resolve docs/... under Additional docs and examples/... under Examples, not the current working directory` : "- Resolve docs/... under Additional docs, not the current working directory; example source files are not included in this installation"}
+- When asked about: extensions (docs/extensions.md), themes (docs/themes.md), skills (docs/skills.md), prompt templates (docs/prompt-templates.md), TUI components (docs/tui.md), keybindings (docs/keybindings.md), SDK integrations (docs/sdk.md), custom providers (docs/custom-provider.md), adding models (docs/models.md), Diffex packages (docs/packages.md), environment variables (docs/environment-variables.md)
+- When working on Diffex topics, read the docs and follow .md cross-references before implementing
+- Always read Diffex.md files completely and follow links to related docs (e.g., tui.md for TUI API details)`
+        : "- Product website: https://diffex.ai/"}`;
     if (appendSection) {
         prompt += appendSection;
     }

package/dist/core/tools/subagents.js

@@ -104,6 +104,7 @@ export function createSpawnAgentTool(spawn, assertCanSpawn = () => { }) {
         label: "Spawn Agent",
         description: "Start an independent child agent asynchronously. The tool returns after acceptance, but the enclosing parent prompt remains active until coordinated child work is delivered.",
         promptGuidelines: [
+            "For broad research, audits, or implementation work with independent areas, use spawn_agent to delegate focused subtasks in parallel when available. Request file references and supporting evidence for research and audits, and assign clear, non-overlapping file ownership for implementation work.",
             "After spawning child agents, you may finish the current response. The session waits for the frozen child batch and automatically sends one hidden, name-sorted result message before the parent prompt settles.",
         ],
         parameters: spawnAgentSchema,

package/dist/main.js

@@ -4,7 +4,6 @@
  * This file handles CLI argument parsing and translates them into
  * createAgentSession() options. The SDK does the heavy lifting.
  */
-import { createInterface } from "node:readline";
 import { modelsAreEqual } from "@diffexai/diffex-ai";
 import chalk from "chalk";
 import { parseArgs, printHelp } from "./cli/args.js";
@@ -15,7 +14,7 @@ import { processFileArguments } from "./cli/file-processor.js";
 import { buildInitialMessage } from "./cli/initial-message.js";
 import { listModels } from "./cli/list-models.js";
 import { createProjectTrustContext } from "./cli/project-trust.js";
-import { selectSession } from "./cli/session-picker.js";
+import { applySessionName, createSessionManager, validateForkFlags, validateSessionIdFlags, } from "./cli/session-selection.js";
 import { shouldRunFirstTimeSetup, showFirstTimeSetup, showStartupSelector } from "./cli/startup-ui.js";
 import { APP_NAME, ENV_SESSION_DIR, expandTildePath, getAgentDir, getPackageDir, VERSION } from "./config.js";
 import { createAgentSessionRuntime, } from "./core/agent-session-runtime.js";
@@ -32,7 +31,7 @@ import { ModelRuntime } from "./core/model-runtime.js";
 import { restoreStdout, takeOverStdout } from "./core/output-guard.js";
 import { resolveProjectTrusted } from "./core/project-trust.js";
 import { formatMissingSessionCwdPrompt, getMissingSessionCwdIssue, MissingSessionCwdError, } from "./core/session-cwd.js";
-import { assertValidSessionId, SessionManager } from "./core/session-manager.js";
+import { SessionManager } from "./core/session-manager.js";
 import { SettingsManager } from "./core/settings-manager.js";
 import { printTimings, resetTimings, time } from "./core/timings.js";
 import { hasTrustRequiringProjectResources, ProjectTrustStore } from "./core/trust-manager.js";
@@ -192,171 +191,6 @@ async function prepareInitialMessage(parsed, autoResizeImages, stdinContent) {
         stdinContent,
     });
 }
-/**
- * Resolve a session argument to a file path.
- * If it looks like a path, use as-is. Otherwise try to match as session ID prefix.
- */
-async function findLocalSessionByExactId(sessionId, cwd, sessionDir) {
-    const localSessions = await SessionManager.list(cwd, sessionDir);
-    const localMatch = localSessions.find((s) => s.id === sessionId);
-    return localMatch ? { type: "local", path: localMatch.path } : undefined;
-}
-async function resolveSessionPath(sessionArg, cwd, sessionDir) {
-    // If it looks like a file path, resolve it before handing it to the session manager.
-    if (sessionArg.includes("/") || sessionArg.includes("\\") || sessionArg.endsWith(".jsonl")) {
-        return { type: "path", path: resolvePath(sessionArg, cwd) };
-    }
-    // Try to match as session ID in current project first
-    const localSessions = await SessionManager.list(cwd, sessionDir);
-    const localMatch = localSessions.find((s) => s.id === sessionArg) ?? localSessions.find((s) => s.id.startsWith(sessionArg));
-    if (localMatch) {
-        return { type: "local", path: localMatch.path };
-    }
-    // Try global search across all projects
-    const allSessions = await SessionManager.listAll(sessionDir);
-    const globalMatch = allSessions.find((s) => s.id === sessionArg) ?? allSessions.find((s) => s.id.startsWith(sessionArg));
-    if (globalMatch) {
-        return { type: "global", path: globalMatch.path, cwd: globalMatch.cwd };
-    }
-    // Not found anywhere
-    return { type: "not_found", arg: sessionArg };
-}
-/** Prompt user for yes/no confirmation */
-async function promptConfirm(message) {
-    return new Promise((resolve) => {
-        const rl = createInterface({
-            input: process.stdin,
-            output: process.stdout,
-        });
-        rl.question(`${message} [y/N] `, (answer) => {
-            rl.close();
-            resolve(answer.toLowerCase() === "y" || answer.toLowerCase() === "yes");
-        });
-    });
-}
-function validateForkFlags(parsed) {
-    if (!parsed.fork)
-        return;
-    const conflictingFlags = [
-        parsed.session ? "--session" : undefined,
-        parsed.continue ? "--continue" : undefined,
-        parsed.resume ? "--resume" : undefined,
-        parsed.noSession ? "--no-session" : undefined,
-    ].filter((flag) => flag !== undefined);
-    if (conflictingFlags.length > 0) {
-        console.error(chalk.red(`Error: --fork cannot be combined with ${conflictingFlags.join(", ")}`));
-        process.exit(1);
-    }
-}
-function validateSessionIdFlags(parsed) {
-    if (parsed.sessionId === undefined)
-        return;
-    const conflictingFlags = [
-        parsed.session ? "--session" : undefined,
-        parsed.continue ? "--continue" : undefined,
-        parsed.resume ? "--resume" : undefined,
-    ].filter((flag) => flag !== undefined);
-    if (conflictingFlags.length > 0) {
-        console.error(chalk.red(`Error: --session-id cannot be combined with ${conflictingFlags.join(", ")}`));
-        process.exit(1);
-    }
-    try {
-        assertValidSessionId(parsed.sessionId);
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        console.error(chalk.red(`Error: ${message}`));
-        process.exit(1);
-    }
-}
-function openSessionOrExit(path, sessionDir) {
-    try {
-        return SessionManager.open(path, sessionDir);
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        console.error(chalk.red(`Error: ${message}`));
-        process.exit(1);
-    }
-}
-function forkSessionOrExit(sourcePath, cwd, sessionDir, sessionId) {
-    try {
-        return SessionManager.forkFrom(sourcePath, cwd, sessionDir, { id: sessionId });
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        console.error(chalk.red(`Error: ${message}`));
-        process.exit(1);
-    }
-}
-async function createSessionManager(parsed, cwd, sessionDir, settingsManager) {
-    if (parsed.noSession || parsed.help || parsed.listModels !== undefined) {
-        return SessionManager.inMemory(cwd, parsed.sessionId !== undefined ? { id: parsed.sessionId } : undefined);
-    }
-    if (parsed.fork) {
-        if (parsed.sessionId) {
-            const existingTarget = await findLocalSessionByExactId(parsed.sessionId, cwd, sessionDir);
-            if (existingTarget) {
-                console.error(chalk.red(`Session already exists with id '${parsed.sessionId}'`));
-                process.exit(1);
-            }
-        }
-        const resolved = await resolveSessionPath(parsed.fork, cwd, sessionDir);
-        switch (resolved.type) {
-            case "path":
-            case "local":
-            case "global":
-                return forkSessionOrExit(resolved.path, cwd, sessionDir, parsed.sessionId);
-            case "not_found":
-                console.error(chalk.red(`No session found matching '${resolved.arg}'`));
-                process.exit(1);
-        }
-    }
-    if (parsed.session) {
-        const resolved = await resolveSessionPath(parsed.session, cwd, sessionDir);
-        switch (resolved.type) {
-            case "path":
-            case "local":
-                return openSessionOrExit(resolved.path, sessionDir);
-            case "global": {
-                console.log(chalk.yellow(`Session found in different project: ${resolved.cwd}`));
-                const shouldFork = await promptConfirm("Fork this session into current directory?");
-                if (!shouldFork) {
-                    console.log(chalk.dim("Aborted."));
-                    process.exit(0);
-                }
-                return forkSessionOrExit(resolved.path, cwd, sessionDir);
-            }
-            case "not_found":
-                console.error(chalk.red(`No session found matching '${resolved.arg}'`));
-                process.exit(1);
-        }
-    }
-    if (parsed.resume) {
-        try {
-            const selectedPath = await selectSession((onProgress) => SessionManager.list(cwd, sessionDir, onProgress), (onProgress) => SessionManager.listAll(sessionDir, onProgress), settingsManager);
-            if (!selectedPath) {
-                console.log(chalk.dim("No session selected"));
-                process.exit(0);
-            }
-            return SessionManager.open(selectedPath, sessionDir);
-        }
-        finally {
-            stopThemeWatcher();
-        }
-    }
-    if (parsed.continue) {
-        return SessionManager.continueRecent(cwd, sessionDir);
-    }
-    if (parsed.sessionId) {
-        const existingSession = await findLocalSessionByExactId(parsed.sessionId, cwd, sessionDir);
-        if (existingSession) {
-            return SessionManager.open(existingSession.path, sessionDir);
-        }
-        console.error(chalk.yellow(`Warning: No project session found with id '${parsed.sessionId}'; creating a new session with that id.`));
-    }
-    return SessionManager.create(cwd, sessionDir, { id: parsed.sessionId });
-}
 function buildSessionOptions(parsed, scopedModels, hasExistingSession, modelRuntime, settingsManager) {
     const options = {};
     const diagnostics = [];
@@ -557,14 +391,7 @@ export async function main(args, options) {
             process.exit(1);
         }
     }
-    if (parsed.name !== undefined) {
-        const name = parsed.name.trim();
-        if (!name) {
-            console.error(chalk.red("Error: --name requires a non-empty value"));
-            process.exit(1);
-        }
-        sessionManager.appendSessionInfo(name);
-    }
+    applySessionName(parsed, sessionManager);
     const initialWorkspace = await resolveHarnessWorkspace(sessionManager.getCwd());
     const invocationTraceResult = await createInvocationTrace({
         agentDir: resolveEvolutionWorkspaceStateDirectory(agentDir, initialWorkspace.workspace),

package/dist/node_modules/@diffexai/diffex-agent-core/THIRD-PARTY-NOTICES.txt

@@ -1,2 +1,6 @@
-Diffex modifications copyright 2026 Luntraa, Inc.
-Pi-derived portions retain the complete MIT terms in LICENSE.
+Diffex
+Copyright 2026 Luntraa, Inc.
+
+Where this distribution contains Pi Agent Harness-derived portions,
+those portions retain their MIT terms and copyright notice in LICENSE.
+The Apache-2.0 package declaration does not replace third-party terms.

package/dist/node_modules/@diffexai/diffex-agent-core/distribution-components.json

@@ -1,8 +1,8 @@
 [
   {
     "name": "@diffexai/diffex-agent-core",
-    "version": "0.2.1",
-    "sourceCommit": "f2a661684af35fe6e9a3209c6f9720144e1fd423",
+    "version": "0.2.3",
+    "sourceCommit": "a9a2beea7798edd34c62e836d73a0d50b6260950",
     "license": "Apache-2.0",
     "portions": "Diffex contributions; Pi-derived portions retain MIT terms in LICENSE",
     "notice": "LICENSE",
@@ -10,12 +10,12 @@
   },
   {
     "name": "@diffexai/diffex-ai",
-    "version": "^0.2.1",
+    "version": "^0.2.3",
     "distribution": "resolved separately by package manager; not bundled in this npm tarball"
   },
   {
     "name": "@diffexai/diffex-telemetry",
-    "version": "^0.2.1",
+    "version": "^0.2.3",
     "distribution": "resolved separately by package manager; not bundled in this npm tarball"
   },
   {

package/dist/node_modules/@diffexai/diffex-agent-core/distribution-files.json

@@ -1,5 +1,5 @@
 {
-  "sourceCommit": "f2a661684af35fe6e9a3209c6f9720144e1fd423",
+  "sourceCommit": "a9a2beea7798edd34c62e836d73a0d50b6260950",
   "algorithm": "sha256",
   "files": [
     {

package/dist/node_modules/@diffexai/diffex-agent-core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diffexai/diffex-agent-core",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "General-purpose agent with transport abstraction, state management, and attachment support",
   "type": "module",
   "main": "./dist/index.js",
@@ -29,11 +29,6 @@
   ],
   "author": "Mario Zechner",
   "license": "Apache-2.0",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/diffexai/diffex.git",
-    "directory": "packages/agent"
-  },
   "engines": {
     "node": ">=22.19.0"
   },

package/dist/node_modules/@diffexai/diffex-ai/THIRD-PARTY-NOTICES.txt

@@ -1,2 +1,6 @@
-Diffex modifications copyright 2026 Luntraa, Inc.
-Pi-derived portions retain the complete MIT terms in LICENSE.
+Diffex
+Copyright 2026 Luntraa, Inc.
+
+Where this distribution contains Pi Agent Harness-derived portions,
+those portions retain their MIT terms and copyright notice in LICENSE.
+The Apache-2.0 package declaration does not replace third-party terms.