@yeshwanthyk/runtime-effect 0.1.0

package/README.md

@@ -0,0 +1,19 @@
+# @yeshwanthyk/runtime-effect
+
+Effect-powered runtime layer for Marvin agents (config, hooks, tools, LSP, sessions).
+
+## Installation
+
+```bash
+npm install @yeshwanthyk/runtime-effect
+```
+
+## Usage
+
+```typescript
+import { RuntimeLayer } from "@yeshwanthyk/runtime-effect/runtime";
+```
+
+## License
+
+MIT

package/dist/agent.d.ts

@@ -0,0 +1,15 @@
+import { Agent, type AgentTransport, type ThinkingLevel } from "@yeshwanthyk/agent-core";
+import type { Api, AgentTool, Model } from "@yeshwanthyk/ai";
+import { Context, Layer } from "effect";
+export interface AgentFactoryService {
+    readonly bootstrapAgent: Agent;
+    readonly createAgent: (options?: {
+        model?: Model<Api>;
+        thinking?: ThinkingLevel;
+    }) => Agent;
+    readonly transport: AgentTransport;
+    readonly tools: AgentTool[];
+}
+export declare const AgentFactoryTag: Context.Tag<AgentFactoryService, AgentFactoryService>;
+export declare const AgentFactoryLayer: Layer.Layer<AgentFactoryService, Error, import("./config.js").ConfigService | import("./tools.js").ToolService | import("./transports.js").TransportService>;
+//# sourceMappingURL=agent.d.ts.map

package/dist/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACzF,OAAO,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAU,KAAK,EAAE,MAAM,QAAQ,CAAC;AAKhD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,cAAc,EAAE,KAAK,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;QAAC,QAAQ,CAAC,EAAE,aAAa,CAAA;KAAE,KAAK,KAAK,CAAC;IAC5F,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC;CAC7B;AAED,eAAO,MAAM,eAAe,uDAAyE,CAAC;AAEtG,eAAO,MAAM,iBAAiB,8JA0B7B,CAAC"}

package/dist/agent.js

@@ -0,0 +1,28 @@
+import { Agent } from "@yeshwanthyk/agent-core";
+import { Context, Effect, Layer } from "effect";
+import { ConfigTag } from "./config.js";
+import { ToolServiceTag } from "./tools.js";
+import { TransportTag } from "./transports.js";
+export const AgentFactoryTag = Context.GenericTag("runtime-effect/AgentFactory");
+export const AgentFactoryLayer = Layer.effect(AgentFactoryTag, Effect.gen(function* () {
+    const config = yield* ConfigTag;
+    const { transport } = yield* TransportTag;
+    const toolService = yield* ToolServiceTag;
+    const tools = yield* toolService.loadBuiltinTools();
+    const createAgent = (options) => new Agent({
+        transport: transport.router,
+        initialState: {
+            systemPrompt: config.config.systemPrompt,
+            model: options?.model ?? config.config.model,
+            thinkingLevel: options?.thinking ?? config.config.thinking,
+            tools,
+        },
+    });
+    return {
+        bootstrapAgent: createAgent(),
+        createAgent,
+        transport: transport.router,
+        tools,
+    };
+}));
+//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAA2C,MAAM,yBAAyB,CAAC;AAEzF,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAS/C,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAC,UAAU,CAAsB,6BAA6B,CAAC,CAAC;AAEtG,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,CAAC,MAAM,CAC3C,eAAe,EACf,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,SAAS,CAAC;IAChC,MAAM,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC,CAAC,YAAY,CAAC;IAC1C,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,cAAc,CAAC;IAC1C,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,WAAW,CAAC,gBAAgB,EAAE,CAAC;IAEpD,MAAM,WAAW,GAAG,CAAC,OAA0D,EAAE,EAAE,CACjF,IAAI,KAAK,CAAC;QACR,SAAS,EAAE,SAAS,CAAC,MAAM;QAC3B,YAAY,EAAE;YACZ,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY;YACxC,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK;YAC5C,aAAa,EAAE,OAAO,EAAE,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ;YAC1D,KAAK;SACN;KACF,CAAC,CAAC;IAEL,OAAO;QACL,cAAc,EAAE,WAAW,EAAE;QAC7B,WAAW;QACX,SAAS,EAAE,SAAS,CAAC,MAAM;QAC3B,KAAK;KACwB,CAAC;AAClC,CAAC,CAAC,CACH,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,65 @@
+import { Layer, Context } from "effect";
+import { type Api, type KnownProvider, type Model } from "@yeshwanthyk/ai";
+import type { ThinkingLevel } from "@yeshwanthyk/agent-core";
+export interface AgentsConfig {
+    global?: {
+        path: string;
+        content: string;
+    };
+    project?: {
+        path: string;
+        content: string;
+    };
+    combined: string;
+}
+export interface EditorConfig {
+    command: string;
+    args: string[];
+}
+export interface LspConfig {
+    enabled: boolean;
+    autoInstall: boolean;
+}
+export interface LoadedAppConfig {
+    provider: KnownProvider;
+    modelId: string;
+    model: Model<Api>;
+    thinking: ThinkingLevel;
+    theme: string;
+    editor?: EditorConfig;
+    systemPrompt: string;
+    agentsConfig: AgentsConfig;
+    configDir: string;
+    configPath: string;
+    lsp: LspConfig;
+}
+export declare const loadAgentsConfig: (options?: {
+    cwd?: string;
+}) => Promise<AgentsConfig>;
+export interface LoadConfigOptions {
+    cwd?: string;
+    configDir?: string;
+    configPath?: string;
+    provider?: string;
+    model?: string;
+    thinking?: ThinkingLevel;
+    systemPrompt?: string;
+    lsp?: LspConfig;
+}
+export declare const loadAppConfig: (options?: LoadConfigOptions) => Promise<LoadedAppConfig>;
+export declare const updateAppConfig: (options: {
+    configDir?: string;
+    configPath?: string;
+}, patch: {
+    provider?: string;
+    model?: string;
+    thinking?: ThinkingLevel;
+    theme?: string;
+    systemPrompt?: string;
+}) => Promise<void>;
+export interface ConfigService {
+    readonly config: LoadedAppConfig;
+}
+export declare const ConfigTag: Context.Tag<ConfigService, ConfigService>;
+export declare const ConfigLayer: (options?: LoadConfigOptions) => Layer.Layer<ConfigService, import("effect/Cause").UnknownException, never>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,OAAO,EAAU,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAA2B,KAAK,GAAG,EAAE,KAAK,aAAa,EAAE,KAAK,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACpG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAgC7D,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,OAAO,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,aAAa,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IAClB,QAAQ,EAAE,aAAa,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,YAAY,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,SAAS,CAAC;CAChB;AAED,eAAO,MAAM,gBAAgB,GAAU,UAAU;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,KAAG,OAAO,CAAC,YAAY,CAmBvF,CAAC;AAgHF,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,CAAC,EAAE,SAAS,CAAC;CACjB;AAED,eAAO,MAAM,aAAa,GAAU,UAAU,iBAAiB,KAAG,OAAO,CAAC,eAAe,CAwExF,CAAC;AAOF,eAAO,MAAM,eAAe,GAC1B,SAAS;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,EACpD,OAAO;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,aAAa,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,KAC5G,OAAO,CAAC,IAAI,CAed,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;CAClC;AAED,eAAO,MAAM,SAAS,2CAAoE,CAAC;AAE3F,eAAO,MAAM,WAAW,GAAI,UAAU,iBAAiB,+EAIpD,CAAC"}

package/dist/config.js

@@ -0,0 +1,232 @@
+import { promises as fs } from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { Effect, Layer, Context } from "effect";
+import { getModels, getProviders } from "@yeshwanthyk/ai";
+const GLOBAL_AGENTS_PATHS = [
+    () => path.join(os.homedir(), ".config", "marvin", "agents.md"),
+    () => path.join(os.homedir(), ".codex", "agents.md"),
+    () => path.join(os.homedir(), ".claude", "CLAUDE.md"),
+];
+const projectAgentsPaths = (cwd) => [
+    () => path.join(cwd, "AGENTS.md"),
+    () => path.join(cwd, "CLAUDE.md"),
+];
+const readFileIfExists = async (p) => {
+    try {
+        return await fs.readFile(p, "utf8");
+    }
+    catch {
+        return undefined;
+    }
+};
+const loadFirstExisting = async (pathFns) => {
+    for (const pathFn of pathFns) {
+        const p = pathFn();
+        const content = await readFileIfExists(p);
+        if (content !== undefined) {
+            return { path: p, content };
+        }
+    }
+    return undefined;
+};
+export const loadAgentsConfig = async (options) => {
+    const cwd = options?.cwd ?? process.cwd();
+    const global = await loadFirstExisting(GLOBAL_AGENTS_PATHS);
+    const project = await loadFirstExisting(projectAgentsPaths(cwd));
+    const parts = [];
+    if (global)
+        parts.push(global.content);
+    if (project)
+        parts.push(project.content);
+    const config = {
+        combined: parts.join("\n\n---\n\n"),
+    };
+    if (global) {
+        config.global = global;
+    }
+    if (project) {
+        config.project = project;
+    }
+    return config;
+};
+const isThinkingLevel = (value) => value === "off" ||
+    value === "minimal" ||
+    value === "low" ||
+    value === "medium" ||
+    value === "high" ||
+    value === "xhigh";
+const fileExists = async (p) => {
+    try {
+        await fs.stat(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+const readJsonIfExists = async (p) => {
+    if (!(await fileExists(p)))
+        return undefined;
+    const raw = await fs.readFile(p, "utf8");
+    return JSON.parse(raw);
+};
+const resolveConfigDir = () => path.join(os.homedir(), ".config", "marvin");
+const resolveProvider = (raw) => {
+    if (typeof raw !== "string" || !raw.trim())
+        return undefined;
+    const providers = getProviders();
+    return providers.includes(raw) ? raw : undefined;
+};
+const resolveModel = (provider, raw) => {
+    if (typeof raw !== "string" || !raw.trim())
+        return undefined;
+    const models = getModels(provider);
+    return models.find((m) => m.id === raw);
+};
+const parseModelSpec = (raw) => {
+    if (typeof raw !== "string")
+        return {};
+    const first = raw
+        .split(",")
+        .map((value) => value.trim())
+        .find((value) => value.length > 0);
+    if (!first)
+        return {};
+    const slashIndex = first.indexOf("/");
+    if (slashIndex === -1) {
+        return { modelId: first };
+    }
+    const providerId = first.slice(0, slashIndex).trim();
+    const modelId = first.slice(slashIndex + 1).trim();
+    const provider = getProviders().find((p) => p === providerId);
+    const result = {};
+    if (provider)
+        result.provider = provider;
+    if (modelId.length > 0)
+        result.modelId = modelId;
+    return result;
+};
+const resolveEditorConfig = (raw) => {
+    if (typeof raw === "string") {
+        const parts = raw.trim().split(/\s+/).filter(Boolean);
+        const command = parts[0] ?? "";
+        if (!command)
+            return undefined;
+        return { command, args: parts.slice(1) };
+    }
+    if (Array.isArray(raw)) {
+        const parts = raw.filter((value) => typeof value === "string" && value.trim().length > 0);
+        const command = parts[0] ?? "";
+        if (!command)
+            return undefined;
+        return { command, args: parts.slice(1) };
+    }
+    if (typeof raw === "object" && raw !== null) {
+        const obj = raw;
+        const command = typeof obj.command === "string" ? obj.command.trim() : "";
+        if (!command)
+            return undefined;
+        const args = Array.isArray(obj.args)
+            ? obj.args.filter((value) => typeof value === "string")
+            : [];
+        return { command, args };
+    }
+    return undefined;
+};
+const isRecord = (value) => typeof value === "object" && value !== null;
+const readBoolean = (value, key) => {
+    const raw = value[key];
+    return typeof raw === "boolean" ? raw : undefined;
+};
+const resolveLspConfig = (override, raw) => {
+    if (override) {
+        return { enabled: override.enabled, autoInstall: override.autoInstall };
+    }
+    if (raw === false) {
+        return { enabled: false, autoInstall: false };
+    }
+    if (isRecord(raw)) {
+        const enabled = readBoolean(raw, "enabled");
+        const autoInstall = readBoolean(raw, "autoInstall");
+        return { enabled: enabled ?? true, autoInstall: autoInstall ?? true };
+    }
+    return { enabled: true, autoInstall: true };
+};
+export const loadAppConfig = async (options) => {
+    const configDir = options?.configDir ?? resolveConfigDir();
+    const configPath = options?.configPath ?? path.join(configDir, "config.json");
+    const rawConfig = (await readJsonIfExists(configPath)) ?? {};
+    const rawObj = typeof rawConfig === "object" && rawConfig !== null ? rawConfig : {};
+    const nestedConfig = typeof rawObj.config === "object" && rawObj.config !== null ? rawObj.config : {};
+    const providerRaw = options?.provider ??
+        (typeof nestedConfig.provider === "string" ? nestedConfig.provider : undefined) ??
+        (typeof rawObj.provider === "string" ? rawObj.provider : undefined);
+    const modelSpecRaw = options?.model ??
+        (typeof nestedConfig.model === "string" ? nestedConfig.model : undefined) ??
+        (typeof rawObj.model === "string" ? rawObj.model : undefined);
+    const parsedModel = parseModelSpec(modelSpecRaw);
+    const resolvedProvider = parsedModel.provider ?? resolveProvider(providerRaw);
+    if (!resolvedProvider) {
+        throw new Error(`Invalid or missing provider. Set "provider" in ${configPath} or pass --provider. Known: ${getProviders().join(", ")}`);
+    }
+    const model = resolveModel(resolvedProvider, parsedModel.modelId);
+    if (!model) {
+        const available = getModels(resolvedProvider)
+            .slice(0, 8)
+            .map((m) => m.id)
+            .join(", ");
+        throw new Error(`Invalid or missing model for provider ${resolvedProvider}. Set "model" in ${configPath} or pass --model. Examples: ${available}`);
+    }
+    const thinkingRaw = options?.thinking ?? rawObj.thinking;
+    const thinking = isThinkingLevel(thinkingRaw) ? thinkingRaw : "off";
+    const themeRaw = rawObj.theme;
+    const theme = typeof themeRaw === "string" && themeRaw.trim() ? themeRaw.trim() : "marvin";
+    const editorRaw = typeof nestedConfig.editor !== "undefined" ? nestedConfig.editor : rawObj.editor;
+    const editor = resolveEditorConfig(editorRaw) ?? { command: "nvim", args: [] };
+    const agentsConfig = await loadAgentsConfig({ cwd: options?.cwd ?? process.cwd() });
+    const basePrompt = options?.systemPrompt ??
+        (typeof rawObj.systemPrompt === "string" && rawObj.systemPrompt.trim().length > 0
+            ? rawObj.systemPrompt
+            : "You are a helpful coding agent. Use tools (read, bash, edit, write) when needed.");
+    const systemPrompt = agentsConfig.combined ? `${basePrompt}\n\n${agentsConfig.combined}` : basePrompt;
+    const lsp = resolveLspConfig(options?.lsp, rawObj.lsp);
+    return {
+        provider: resolvedProvider,
+        modelId: model.id,
+        model,
+        thinking,
+        theme,
+        editor,
+        systemPrompt,
+        agentsConfig,
+        configDir,
+        configPath,
+        lsp,
+    };
+};
+const writeConfigFile = async (p, value) => {
+    await fs.mkdir(path.dirname(p), { recursive: true });
+    await fs.writeFile(p, JSON.stringify(value, null, 2) + "\n", "utf8");
+};
+export const updateAppConfig = async (options, patch) => {
+    const configDir = options.configDir ?? resolveConfigDir();
+    const configPath = options.configPath ?? path.join(configDir, "config.json");
+    const existing = (await readJsonIfExists(configPath)) ?? {};
+    const existingObj = typeof existing === "object" && existing !== null ? existing : {};
+    const next = { ...existingObj };
+    if (patch.provider)
+        next.provider = patch.provider;
+    if (patch.model)
+        next.model = patch.model;
+    if (patch.thinking)
+        next.thinking = patch.thinking;
+    if (patch.theme)
+        next.theme = patch.theme;
+    if (patch.systemPrompt)
+        next.systemPrompt = patch.systemPrompt;
+    await writeConfigFile(configPath, next);
+};
+export const ConfigTag = Context.GenericTag("runtime-effect/ConfigService");
+export const ConfigLayer = (options) => Layer.effect(ConfigTag, Effect.tryPromise(() => loadAppConfig(options)).pipe(Effect.map((config) => ({ config }))));
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/extensibility/custom-commands.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Custom slash command loader
+ *
+ * Loads markdown templates from ~/.config/marvin/commands/*.md
+ * Commands are expanded with $ARGUMENTS placeholder or appended args.
+ */
+import { Context, Layer } from "effect";
+import type { ValidationIssue } from "./schema.js";
+export interface CustomCommand {
+    name: string;
+    description: string;
+    template: string;
+}
+export interface CustomCommandLoadResult {
+    commands: Map<string, CustomCommand>;
+    issues: ValidationIssue[];
+}
+/**
+ * Load custom commands from a config directory.
+ * @param configDir - Base config directory (e.g., ~/.config/marvin)
+ */
+export declare function loadCustomCommands(configDir: string): CustomCommandLoadResult;
+/**
+ * Expand a custom command template with arguments.
+ *
+ * - Replaces $ARGUMENTS with the raw args string
+ * - If no $ARGUMENTS placeholder and args exist, appends args after two newlines
+ *
+ * @param template - The command template
+ * @param args - Raw argument string (everything after the command name)
+ * @returns Expanded prompt text
+ */
+export declare function expandCommand(template: string, args: string): string;
+export interface CustomCommandService extends CustomCommandLoadResult {
+}
+export declare const CustomCommandTag: Context.Tag<CustomCommandService, CustomCommandService>;
+export interface CustomCommandLayerOptions {
+    configDir?: string;
+    loader?: (configDir: string) => CustomCommandLoadResult;
+}
+export declare const CustomCommandLayer: (options?: CustomCommandLayerOptions) => Layer.Layer<CustomCommandService, never, import("../config.js").ConfigService | import("../instrumentation.js").InstrumentationService>;
+/**
+ * Try to expand a slash command input.
+ *
+ * @param input - Raw input starting with /
+ * @param builtInNames - Set of built-in command names (to avoid shadowing)
+ * @param customCommands - Map of custom commands
+ * @returns Expanded text if matched, or null if not a custom command
+ */
+export declare function tryExpandCustomCommand(input: string, builtInNames: Set<string>, customCommands: Map<string, CustomCommand>): string | null;
+//# sourceMappingURL=custom-commands.d.ts.map

package/dist/extensibility/custom-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-commands.d.ts","sourceRoot":"","sources":["../../src/extensibility/custom-commands.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,OAAO,EAAU,KAAK,EAAE,MAAM,QAAQ,CAAA;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAKlD,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;CAChB;AAYD,MAAM,WAAW,uBAAuB;IACvC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;IACpC,MAAM,EAAE,eAAe,EAAE,CAAA;CACzB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,uBAAuB,CA4D7E;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAYpE;AAED,MAAM,WAAW,oBAAqB,SAAQ,uBAAuB;CAAG;AAExE,eAAO,MAAM,gBAAgB,yDAAkF,CAAA;AAE/G,MAAM,WAAW,yBAAyB;IACzC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,uBAAuB,CAAA;CACvD;AAED,eAAO,MAAM,kBAAkB,GAAI,UAAU,yBAAyB,4IAwBpE,CAAA;AAEF;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACrC,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,EACzB,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,GACxC,MAAM,GAAG,IAAI,CAiBf"}

package/dist/extensibility/custom-commands.js

@@ -0,0 +1,139 @@
+/**
+ * Custom slash command loader
+ *
+ * Loads markdown templates from ~/.config/marvin/commands/*.md
+ * Commands are expanded with $ARGUMENTS placeholder or appended args.
+ */
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { Context, Effect, Layer } from "effect";
+import { validateCustomCommand, issueFromError } from "./validation.js";
+import { ConfigTag } from "../config.js";
+import { InstrumentationTag } from "../instrumentation.js";
+/** Valid command name: alphanumeric, starting with letter/digit, allowing _ and - */
+const VALID_NAME_PATTERN = /^[A-Za-z0-9][A-Za-z0-9_-]*$/;
+const createInvalidNameIssue = (path, message) => ({
+    kind: "command",
+    severity: "error",
+    path,
+    message,
+});
+/**
+ * Load custom commands from a config directory.
+ * @param configDir - Base config directory (e.g., ~/.config/marvin)
+ */
+export function loadCustomCommands(configDir) {
+    const commands = new Map();
+    const issues = [];
+    const commandsDir = join(configDir, "commands");
+    if (!existsSync(commandsDir)) {
+        return { commands, issues };
+    }
+    let entries;
+    try {
+        entries = readdirSync(commandsDir);
+    }
+    catch (error) {
+        issues.push(issueFromError("command", commandsDir, error));
+        return { commands, issues };
+    }
+    for (const entry of entries) {
+        if (!entry.endsWith(".md"))
+            continue;
+        const name = entry.slice(0, -3); // Remove .md extension
+        const filePath = join(commandsDir, entry);
+        if (!VALID_NAME_PATTERN.test(name)) {
+            issues.push(createInvalidNameIssue(filePath, `Invalid command name "${name}". Use letters, numbers, _ or -.`));
+            continue;
+        }
+        let content;
+        try {
+            content = readFileSync(filePath, "utf-8");
+        }
+        catch (error) {
+            issues.push(issueFromError("command", filePath, error));
+            continue;
+        }
+        // Extract description from first non-empty line, truncated to 60 chars
+        const lines = content.split("\n");
+        let description = `/${name}`;
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (trimmed) {
+                description = trimmed.length > 60 ? trimmed.slice(0, 57) + "..." : trimmed;
+                break;
+            }
+        }
+        const manifest = {
+            name,
+            description,
+            template: content,
+        };
+        issues.push(...validateCustomCommand(manifest, filePath));
+        commands.set(name, manifest);
+    }
+    return { commands, issues };
+}
+/**
+ * Expand a custom command template with arguments.
+ *
+ * - Replaces $ARGUMENTS with the raw args string
+ * - If no $ARGUMENTS placeholder and args exist, appends args after two newlines
+ *
+ * @param template - The command template
+ * @param args - Raw argument string (everything after the command name)
+ * @returns Expanded prompt text
+ */
+export function expandCommand(template, args) {
+    const trimmedArgs = args.trim();
+    if (template.includes("$ARGUMENTS")) {
+        return template.replace(/\$ARGUMENTS/g, trimmedArgs);
+    }
+    if (trimmedArgs) {
+        return `${template}\n\n${trimmedArgs}`;
+    }
+    return template;
+}
+export const CustomCommandTag = Context.GenericTag("runtime-effect/CustomCommandService");
+export const CustomCommandLayer = (options) => Layer.effect(CustomCommandTag, Effect.gen(function* () {
+    const configDir = options?.configDir ??
+        (yield* ConfigTag).config.configDir;
+    const instrumentation = yield* InstrumentationTag;
+    const loader = options?.loader ?? loadCustomCommands;
+    const result = yield* Effect.sync(() => loader(configDir));
+    for (const issue of result.issues) {
+        instrumentation.record({ type: "extensibility:validation-issue", issue });
+    }
+    instrumentation.record({
+        type: "extensibility:commands-loaded",
+        count: result.commands.size,
+        names: Array.from(result.commands.keys()),
+    });
+    return result;
+}));
+/**
+ * Try to expand a slash command input.
+ *
+ * @param input - Raw input starting with /
+ * @param builtInNames - Set of built-in command names (to avoid shadowing)
+ * @param customCommands - Map of custom commands
+ * @returns Expanded text if matched, or null if not a custom command
+ */
+export function tryExpandCustomCommand(input, builtInNames, customCommands) {
+    const trimmed = input.trim();
+    if (!trimmed.startsWith("/"))
+        return null;
+    // Parse command name and args
+    const withoutSlash = trimmed.slice(1);
+    const spaceIdx = withoutSlash.indexOf(" ");
+    const commandName = spaceIdx === -1 ? withoutSlash : withoutSlash.slice(0, spaceIdx);
+    const args = spaceIdx === -1 ? "" : withoutSlash.slice(spaceIdx + 1);
+    // Built-ins take precedence (no override in v1)
+    if (builtInNames.has(commandName))
+        return null;
+    const cmd = customCommands.get(commandName);
+    if (!cmd)
+        return null;
+    return expandCommand(cmd.template, args);
+}
+//# sourceMappingURL=custom-commands.js.map

package/dist/extensibility/custom-commands.js.map

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

package/dist/extensibility/custom-tools/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Custom tools module exports.
+ */
+export { loadCustomTools } from "./loader.js";
+export type { CustomAgentTool, CustomToolFactory, CustomToolsLoadResult, ExecOptions, ExecResult, LoadedCustomTool, RenderResultOptions, SendRef, SessionEvent, ToolAPI, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/extensibility/custom-tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/extensibility/custom-tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC7C,YAAY,EACX,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,mBAAmB,EACnB,OAAO,EACP,YAAY,EACZ,OAAO,GACP,MAAM,YAAY,CAAA"}

package/dist/extensibility/custom-tools/index.js

@@ -0,0 +1,5 @@
+/**
+ * Custom tools module exports.
+ */
+export { loadCustomTools } from "./loader.js";
+//# sourceMappingURL=index.js.map

package/dist/extensibility/custom-tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/extensibility/custom-tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA"}

package/dist/extensibility/custom-tools/loader.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Custom tool loader - discovers and loads TypeScript tool modules.
+ *
+ * Tools are loaded from:
+ *   - ~/.config/marvin/tools/*.ts (single-file tools)
+ *   - ~/.config/marvin/tools/<name>/index.ts (directory-based tools)
+ *
+ * Uses Bun's native import() which handles TypeScript directly.
+ */
+import type { CustomToolsLoadResult, SendRef } from "./types.js";
+/**
+ * Discover and load tools from the config directory.
+ * Loads from ~/.config/marvin/tools/*.ts
+ *
+ * @param configDir - Base config directory (e.g., ~/.config/marvin)
+ * @param cwd - Current working directory for tool execution
+ * @param builtInToolNames - Names of built-in tools to check for conflicts
+ * @param sendRef - Ref for send handler (set by App after initialization)
+ */
+export declare function loadCustomTools(configDir: string, cwd: string, builtInToolNames: string[], sendRef: SendRef, hasUI: boolean): Promise<CustomToolsLoadResult>;
+/**
+ * Get built-in tool names from an array of tools.
+ */
+//# sourceMappingURL=loader.d.ts.map

package/dist/extensibility/custom-tools/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/extensibility/custom-tools/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EAEX,qBAAqB,EAIrB,OAAO,EAEP,MAAM,YAAY,CAAA;AAyKnB;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACpC,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,gBAAgB,EAAE,MAAM,EAAE,EAC1B,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,OAAO,GACZ,OAAO,CAAC,qBAAqB,CAAC,CAgEhC;AAED;;GAEG"}