toolcraft 0.0.4 → 0.0.6

package/dist/cli.js

@@ -7,6 +7,7 @@ import { mergeApprovalsGroup } from "./human-in-loop/approvals-commands.js";
 import { invokeWithHumanInLoop } from "./human-in-loop/index.js";
 import { resolveMcpProxies } from "./mcp-proxy.js";
 import { getExpectedNumberDescription, isValidNumberSchemaValue } from "./number-schema.js";
+import { findEntrypointPackageMetadata } from "./package-metadata.js";
 import { renderResult } from "./renderer.js";
 const RESERVED_SERVICE_NAMES = new Set(["params", "secrets", "fetch", "fs", "env", "progress"]);
 const NULL_OPTION_VALUE = Symbol("toolcraft.cli.null");
@@ -1990,6 +1991,7 @@ export async function runCLI(roots, options = {}) {
     const casing = options.casing ?? "kebab";
     const services = (options.services ?? {});
     const runtimeOptions = options.humanInLoop ?? {};
+    const version = options.version ?? findEntrypointPackageMetadata(process.argv[1])?.version;
     const servicesWithBuiltIns = {
         ...services,
         runtimeOptions,
@@ -2000,7 +2002,7 @@ export async function runCLI(roots, options = {}) {
     };
     validateServices(services);
     if (hasHelpFlag(process.argv)) {
-        await renderGeneratedHelp(root, process.argv, options);
+        await renderGeneratedHelp(root, process.argv, { ...options, version });
         return;
     }
     const program = new CommanderCommand();
@@ -2009,8 +2011,8 @@ export async function runCLI(roots, options = {}) {
     program.showHelpAfterError();
     program.addHelpCommand(false);
     addGlobalOptions(program);
-    if (options.version !== undefined) {
-        program.version(options.version, "--version");
+    if (version !== undefined) {
+        program.version(version, "--version");
     }
     let lastActionCommand;
     const execute = async (state) => {

package/dist/index.d.ts

@@ -179,5 +179,7 @@ export declare function defineGroup<TServices extends object = EmptyServices, TN
 export declare function getCommandSourcePath(command: Command<any, any, any, any>): string | undefined;
 export { S, toJsonSchema } from "toolcraft-schema";
 export { ApprovalDeclinedError, UserError };
+export { findPackageMetadata, packageMetadata } from "./package-metadata.js";
+export type { PackageMetadata } from "./package-metadata.js";
 export type { AnySchema, ArraySchema, BooleanSchema, EnumSchema, JsonSchema, NumberSchema, ObjectSchema, OptionalSchema, Static, StringSchema } from "toolcraft-schema";
 export type { HumanInLoopConfig, HumanInLoopPending, HumanInLoopRuntimeOptions };

package/dist/index.js

@@ -429,3 +429,4 @@ export function getCommandSourcePath(command) {
 }
 export { S, toJsonSchema } from "toolcraft-schema";
 export { ApprovalDeclinedError, UserError };
+export { findPackageMetadata, packageMetadata } from "./package-metadata.js";

package/dist/mcp.d.ts

@@ -7,7 +7,7 @@ type CmdkitServer = Omit<TinyServer, "connect"> & {
 };
 export interface RunMCPOptions<TServices extends object = Record<string, unknown>> {
     name: string;
-    version: string;
+    version?: string;
     humanInLoop?: HumanInLoopRuntimeOptions;
     /**
      * Optional allowlist of MCP tool names or group prefixes.

package/dist/mcp.js

@@ -6,6 +6,7 @@ import { mergeApprovalsGroup } from "./human-in-loop/approvals-commands.js";
 import { ApprovalDeclinedError, invokeWithHumanInLoop, } from "./human-in-loop/index.js";
 import { hasMcpProxyGroups, resolveMcpProxies } from "./mcp-proxy.js";
 import { getExpectedNumberDescription, isValidNumberSchemaValue } from "./number-schema.js";
+import { findEntrypointPackageMetadata } from "./package-metadata.js";
 import { filterSchemaForScope } from "./schema-scope.js";
 const RESERVED_SERVICE_NAMES = new Set(["params", "secrets", "fetch", "fs", "env", "progress"]);
 function normalizeRoots(roots) {
@@ -365,7 +366,8 @@ function createResolvedMCPServer(root, options) {
     };
     validateServices(services);
     const tools = enumerateTools(root, casing, options.tools);
-    const server = createServer({ name: options.name, version: options.version });
+    const version = resolveMCPVersion(options.version);
+    const server = createServer({ name: options.name, version });
     for (const tool of tools) {
         server.tool(tool.name, tool.description, tool.inputSchema, async (argumentsValue) => {
             try {
@@ -406,6 +408,13 @@ function createResolvedMCPServer(root, options) {
         },
     };
 }
+function resolveMCPVersion(version) {
+    const resolvedVersion = version ?? findEntrypointPackageMetadata(process.argv[1])?.version;
+    if (resolvedVersion === undefined) {
+        throw new Error("MCP version is required when no package.json version can be inferred from the entrypoint.");
+    }
+    return resolvedVersion;
+}
 function createDeferredMCPServer(root, options) {
     let serverPromise;
     const resolveServer = () => {

package/dist/package-metadata.d.ts

@@ -0,0 +1,10 @@
+export interface PackageMetadata {
+    name?: string;
+    path: string;
+    version?: string;
+}
+type PackageMetadataInput = string | URL;
+export declare function findPackageMetadata(from: PackageMetadataInput): PackageMetadata | undefined;
+export declare function packageMetadata(from?: PackageMetadataInput): PackageMetadata;
+export declare function findEntrypointPackageMetadata(entrypoint: string | undefined): PackageMetadata | undefined;
+export {};

package/dist/package-metadata.js

@@ -0,0 +1,62 @@
+import { existsSync, readFileSync, statSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+function pathFromInput(from) {
+    if (from instanceof URL) {
+        return fileURLToPath(from);
+    }
+    if (from.startsWith("file:")) {
+        return fileURLToPath(from);
+    }
+    return path.resolve(from);
+}
+function getSearchDirectory(from) {
+    const resolved = pathFromInput(from);
+    try {
+        return statSync(resolved).isDirectory() ? resolved : path.dirname(resolved);
+    }
+    catch {
+        return path.dirname(resolved);
+    }
+}
+function readPackageMetadata(packageJsonPath) {
+    const parsed = JSON.parse(readFileSync(packageJsonPath, "utf8"));
+    const metadata = { path: packageJsonPath };
+    if (typeof parsed.name === "string") {
+        metadata.name = parsed.name;
+    }
+    if (typeof parsed.version === "string") {
+        metadata.version = parsed.version;
+    }
+    return metadata;
+}
+export function findPackageMetadata(from) {
+    let current = getSearchDirectory(from);
+    while (true) {
+        const packageJsonPath = path.join(current, "package.json");
+        if (existsSync(packageJsonPath)) {
+            return readPackageMetadata(packageJsonPath);
+        }
+        const parent = path.dirname(current);
+        if (parent === current) {
+            return undefined;
+        }
+        current = parent;
+    }
+}
+export function packageMetadata(from = process.cwd()) {
+    const metadata = findPackageMetadata(from);
+    if (metadata === undefined) {
+        throw new Error(`No package.json found from ${pathFromInput(from)}.`);
+    }
+    return metadata;
+}
+export function findEntrypointPackageMetadata(entrypoint) {
+    if (entrypoint === undefined || entrypoint.length === 0) {
+        return undefined;
+    }
+    if (!path.isAbsolute(entrypoint) && !entrypoint.startsWith("file:")) {
+        return undefined;
+    }
+    return findPackageMetadata(entrypoint);
+}

package/node_modules/@poe-code/agent-defs/dist/agents/claude-code.d.ts

@@ -0,0 +1,2 @@
+import type { AgentDefinition } from "../types.js";
+export declare const claudeCodeAgent: AgentDefinition;

package/node_modules/@poe-code/agent-defs/dist/agents/claude-code.js

@@ -0,0 +1,15 @@
+export const claudeCodeAgent = {
+    id: "claude-code",
+    name: "claude-code",
+    label: "Claude Code",
+    summary: "Configure Claude Code to route through Poe.",
+    aliases: ["claude"],
+    binaryName: "claude",
+    configPath: "~/.claude/settings.json",
+    branding: {
+        colors: {
+            dark: "#C15F3C",
+            light: "#C15F3C"
+        }
+    }
+};

package/node_modules/@poe-code/agent-defs/dist/agents/claude-desktop.d.ts

@@ -0,0 +1,2 @@
+import type { AgentDefinition } from "../types.js";
+export declare const claudeDesktopAgent: AgentDefinition;

package/node_modules/@poe-code/agent-defs/dist/agents/claude-desktop.js

@@ -0,0 +1,13 @@
+export const claudeDesktopAgent = {
+    id: "claude-desktop",
+    name: "claude-desktop",
+    label: "Claude Desktop",
+    summary: "Anthropic's official desktop application for Claude",
+    configPath: "~/.claude/settings.json",
+    branding: {
+        colors: {
+            dark: "#D97757",
+            light: "#D97757"
+        }
+    }
+};

package/node_modules/@poe-code/agent-defs/dist/agents/codex.d.ts

@@ -0,0 +1,2 @@
+import type { AgentDefinition } from "../types.js";
+export declare const codexAgent: AgentDefinition;

package/node_modules/@poe-code/agent-defs/dist/agents/codex.js

@@ -0,0 +1,14 @@
+export const codexAgent = {
+    id: "codex",
+    name: "codex",
+    label: "Codex",
+    summary: "Configure Codex to use Poe as the model provider.",
+    binaryName: "codex",
+    configPath: "~/.codex/config.toml",
+    branding: {
+        colors: {
+            dark: "#D5D9DF",
+            light: "#7A7F86"
+        }
+    }
+};

package/node_modules/@poe-code/agent-defs/dist/agents/goose.d.ts

@@ -0,0 +1,2 @@
+import type { AgentDefinition } from "../types.js";
+export declare const gooseAgent: AgentDefinition;

package/node_modules/@poe-code/agent-defs/dist/agents/goose.js

@@ -0,0 +1,14 @@
+export const gooseAgent = {
+    id: "goose",
+    name: "goose",
+    label: "Goose",
+    summary: "Block's open-source AI agent with ACP support.",
+    binaryName: "goose",
+    configPath: "~/.config/goose/config.yaml",
+    branding: {
+        colors: {
+            dark: "#FF6B35",
+            light: "#E85D26"
+        }
+    }
+};

package/node_modules/@poe-code/agent-defs/dist/agents/index.d.ts

@@ -0,0 +1,7 @@
+export { claudeCodeAgent } from "./claude-code.js";
+export { claudeDesktopAgent } from "./claude-desktop.js";
+export { codexAgent } from "./codex.js";
+export { openCodeAgent } from "./opencode.js";
+export { kimiAgent } from "./kimi.js";
+export { gooseAgent } from "./goose.js";
+export { poeAgentAgent } from "./poe-agent.js";

package/node_modules/@poe-code/agent-defs/dist/agents/index.js

@@ -0,0 +1,7 @@
+export { claudeCodeAgent } from "./claude-code.js";
+export { claudeDesktopAgent } from "./claude-desktop.js";
+export { codexAgent } from "./codex.js";
+export { openCodeAgent } from "./opencode.js";
+export { kimiAgent } from "./kimi.js";
+export { gooseAgent } from "./goose.js";
+export { poeAgentAgent } from "./poe-agent.js";

package/node_modules/@poe-code/agent-defs/dist/agents/kimi.d.ts

@@ -0,0 +1,2 @@
+import type { AgentDefinition } from "../types.js";
+export declare const kimiAgent: AgentDefinition;

package/node_modules/@poe-code/agent-defs/dist/agents/kimi.js

@@ -0,0 +1,15 @@
+export const kimiAgent = {
+    id: "kimi",
+    name: "kimi",
+    label: "Kimi",
+    summary: "Configure Kimi CLI to use Poe API",
+    aliases: ["kimi-cli"],
+    binaryName: "kimi",
+    configPath: "~/.kimi/config.toml",
+    branding: {
+        colors: {
+            dark: "#7B68EE",
+            light: "#6A5ACD"
+        }
+    }
+};

package/node_modules/@poe-code/agent-defs/dist/agents/opencode.d.ts

@@ -0,0 +1,2 @@
+import type { AgentDefinition } from "../types.js";
+export declare const openCodeAgent: AgentDefinition;

package/node_modules/@poe-code/agent-defs/dist/agents/opencode.js

@@ -0,0 +1,14 @@
+export const openCodeAgent = {
+    id: "opencode",
+    name: "opencode",
+    label: "OpenCode CLI",
+    summary: "Configure OpenCode CLI to use the Poe API.",
+    binaryName: "opencode",
+    configPath: "~/.config/opencode/config.json",
+    branding: {
+        colors: {
+            dark: "#4A4F55",
+            light: "#2F3338"
+        }
+    }
+};

package/node_modules/@poe-code/agent-defs/dist/agents/poe-agent.d.ts

@@ -0,0 +1,2 @@
+import type { AgentDefinition } from "../types.js";
+export declare const poeAgentAgent: AgentDefinition;

package/node_modules/@poe-code/agent-defs/dist/agents/poe-agent.js

@@ -0,0 +1,13 @@
+export const poeAgentAgent = {
+    id: "poe-agent",
+    name: "poe-agent",
+    label: "Poe Agent",
+    summary: "Run one-shot prompts with the built-in Poe agent runtime.",
+    configPath: "~/.poe-code/config.json",
+    branding: {
+        colors: {
+            dark: "#A465F7",
+            light: "#7A3FD3"
+        }
+    }
+};

package/node_modules/@poe-code/agent-defs/dist/index.d.ts

@@ -0,0 +1,5 @@
+export type { AgentDefinition } from "./types.js";
+export type { AgentSpecifier } from "./specifier.js";
+export { claudeCodeAgent, claudeDesktopAgent, codexAgent, openCodeAgent, kimiAgent, gooseAgent, poeAgentAgent } from "./agents/index.js";
+export { allAgents, resolveAgentId } from "./registry.js";
+export { parseAgentSpecifier, formatAgentSpecifier, normalizeAgentId } from "./specifier.js";

package/node_modules/@poe-code/agent-defs/dist/index.js

@@ -0,0 +1,3 @@
+export { claudeCodeAgent, claudeDesktopAgent, codexAgent, openCodeAgent, kimiAgent, gooseAgent, poeAgentAgent } from "./agents/index.js";
+export { allAgents, resolveAgentId } from "./registry.js";
+export { parseAgentSpecifier, formatAgentSpecifier, normalizeAgentId } from "./specifier.js";

package/node_modules/@poe-code/agent-defs/dist/registry.d.ts

@@ -0,0 +1,3 @@
+import type { AgentDefinition } from "./types.js";
+export declare const allAgents: AgentDefinition[];
+export declare function resolveAgentId(input: string): string | undefined;

package/node_modules/@poe-code/agent-defs/dist/registry.js

@@ -0,0 +1,26 @@
+import { claudeCodeAgent, claudeDesktopAgent, codexAgent, openCodeAgent, kimiAgent, gooseAgent, poeAgentAgent } from "./agents/index.js";
+export const allAgents = [
+    claudeCodeAgent,
+    claudeDesktopAgent,
+    codexAgent,
+    openCodeAgent,
+    kimiAgent,
+    gooseAgent,
+    poeAgentAgent
+];
+const lookup = new Map();
+for (const agent of allAgents) {
+    const values = [agent.id, agent.name, ...(agent.aliases ?? [])];
+    for (const value of values) {
+        const normalized = value.toLowerCase();
+        if (!lookup.has(normalized)) {
+            lookup.set(normalized, agent.id);
+        }
+    }
+}
+export function resolveAgentId(input) {
+    if (!input) {
+        return undefined;
+    }
+    return lookup.get(input.toLowerCase());
+}

package/node_modules/@poe-code/agent-defs/dist/specifier.d.ts

@@ -0,0 +1,7 @@
+export interface AgentSpecifier {
+    agent: string;
+    model?: string;
+}
+export declare function parseAgentSpecifier(input: string): AgentSpecifier;
+export declare function formatAgentSpecifier(specifier: AgentSpecifier): string;
+export declare function normalizeAgentId(input: string): string;

package/node_modules/@poe-code/agent-defs/dist/specifier.js

@@ -0,0 +1,27 @@
+import { resolveAgentId } from "./registry.js";
+export function parseAgentSpecifier(input) {
+    const colonIndex = input.indexOf(":");
+    if (colonIndex === -1) {
+        return { agent: input.trim() };
+    }
+    const agent = input.slice(0, colonIndex).trim();
+    const model = input.slice(colonIndex + 1).trim();
+    return {
+        agent,
+        ...(model.length > 0 ? { model } : {}),
+    };
+}
+export function formatAgentSpecifier(specifier) {
+    if (specifier.model) {
+        return `${specifier.agent}:${specifier.model}`;
+    }
+    return specifier.agent;
+}
+export function normalizeAgentId(input) {
+    const specifier = parseAgentSpecifier(input.trim());
+    const agent = resolveAgentId(specifier.agent) ?? specifier.agent;
+    return formatAgentSpecifier({
+        agent,
+        model: specifier.model
+    });
+}

package/node_modules/@poe-code/agent-defs/dist/types.d.ts

@@ -0,0 +1,16 @@
+export interface AgentDefinition {
+    id: string;
+    name: string;
+    label: string;
+    summary: string;
+    aliases?: string[];
+    /** Binary name for CLI agents. Optional for GUI-only apps like Claude Desktop. */
+    binaryName?: string;
+    configPath: string;
+    branding: {
+        colors: {
+            dark: string;
+            light: string;
+        };
+    };
+}

package/node_modules/@poe-code/agent-defs/dist/types.js

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

package/node_modules/@poe-code/agent-defs/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@poe-code/agent-defs",
+  "version": "0.0.1",
+  "private": true,
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc"
+  },
+  "files": [
+    "dist"
+  ]
+}

package/node_modules/@poe-code/config-mutations/dist/execution/apply-mutation.d.ts

@@ -0,0 +1,5 @@
+import type { Mutation, MutationContext, MutationOutcome, MutationDetails, MutationOptions } from "../types.js";
+export declare function applyMutation(mutation: Mutation, context: MutationContext, options: MutationOptions): Promise<{
+    outcome: MutationOutcome;
+    details: MutationDetails;
+}>;