@sworddut/myclaw 0.1.0

package/README.md

@@ -0,0 +1,93 @@
+# myclaw
+
+A CLI coding agent scaffold (TypeScript + oclif).
+
+## Tech stack
+
+- Node.js 20+
+- TypeScript
+- oclif
+- execa (tool execution)
+- cosmiconfig + dotenv (config)
+- zod (schema)
+- better-sqlite3 (storage, reserved for next step)
+- vitest (tests)
+
+## Quick start
+
+```bash
+npm install
+npm run build
+cp .env.example .env
+# fill OPENAI_API_KEY in .env
+# optional: set model in env
+# OPENAI_MODEL=gpt-4o-mini
+# optional: for openai-compatible third-party endpoint
+# OPENAI_BASE_URL=https://your-endpoint/v1
+node ./bin/run.js init -f
+```
+
+`OPENAI_BASE_URL` and `.myclawrc.json` `baseURL` both support OpenAI-compatible providers.
+Model priority: `.myclawrc.json` `model` > `OPENAI_MODEL` > `gpt-4o-mini`.
+
+## Commands
+
+```bash
+# Show resolved config
+node ./bin/run.js config
+
+# One-shot task
+node ./bin/run.js run "implement hello world"
+
+# Hide step logs and print only final answer
+node ./bin/run.js run --quiet "implement hello world"
+
+# Show raw model responses for each step (debug)
+node ./bin/run.js run --verboseModel "implement hello world"
+
+# Disable interactive approval prompts (sensitive commands auto-denied)
+node ./bin/run.js run --nonInteractive "implement hello world"
+
+# Init local config files
+node ./bin/run.js init
+
+# Scaffolded chat mode
+node ./bin/run.js chat
+```
+
+File mutation safety rules:
+- Existing files must be `read_file` before `write_file`/`apply_patch`.
+- New file creation is blocked by default. Use `write_file` with `allowCreate=true` only when explicitly needed.
+- Destructive shell commands (for example `rm`, `rmdir`, `unlink`, `del`, `git reset --hard`, `git clean`) are treated as sensitive.
+- Sensitive shell commands require interactive approval (`WAITING FOR USER INPUT`), otherwise they are denied.
+- Multiple reads are allowed in one step.
+- Only one mutation (`write_file` or `apply_patch`) is allowed per step.
+
+## Project structure
+
+```txt
+bin/                # CLI entrypoints (prod/dev)
+src/commands/       # CLI commands
+src/core/           # agent orchestration
+src/providers/      # LLM provider abstraction
+src/tools/          # executable tools
+src/config/         # config loader + schema
+test/               # tests
+```
+
+## Known Limitations (v0.1-alpha)
+
+- Tool-calling protocol is JSON-in-text parsing, not native function-calling.
+- No persistent conversation/session memory yet.
+- No git-aware safety flow (branching, checkpoint, rollback) yet.
+- Network/API retries and timeout policies are still basic.
+- Permission model is coarse-grained; no per-tool policy profile yet.
+
+## TODO
+
+- Add interactive `chat` mode with persistent SQLite session history.
+- Add per-step command timeout/retry/backoff controls in config.
+- Add git checkpoint + rollback command before mutation steps.
+- Add path allowlist/denylist policy with per-tool enforcement.
+- Add native tool/function-calling mode when provider supports it.
+- Add E2E regression tests for multi-file debug scenarios.

package/bin/dev.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env -S node --loader tsx
+
+import {execute} from '@oclif/core'
+
+await execute({development: true, dir: import.meta.url})

package/bin/run.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+import {execute} from '@oclif/core'
+
+await execute({dir: import.meta.url})

package/dist/commands/chat.d.ts

@@ -0,0 +1,5 @@
+import { Command } from '@oclif/core';
+export default class Chat extends Command {
+    static description: string;
+    run(): Promise<void>;
+}

package/dist/commands/chat.js

@@ -0,0 +1,8 @@
+import { Command } from '@oclif/core';
+export default class Chat extends Command {
+    static description = 'Interactive chat mode (scaffold only)';
+    async run() {
+        this.log('chat mode is scaffolded; interactive session will be implemented in next step.');
+    }
+}
+//# sourceMappingURL=chat.js.map

package/dist/commands/chat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.js","sourceRoot":"","sources":["../../src/commands/chat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAC,MAAM,aAAa,CAAA;AAEnC,MAAM,CAAC,OAAO,OAAO,IAAK,SAAQ,OAAO;IACvC,MAAM,CAAU,WAAW,GAAG,uCAAuC,CAAA;IAE9D,KAAK,CAAC,GAAG;QACd,IAAI,CAAC,GAAG,CAAC,gFAAgF,CAAC,CAAA;IAC5F,CAAC"}

package/dist/commands/config.d.ts

@@ -0,0 +1,5 @@
+import { Command } from '@oclif/core';
+export default class Config extends Command {
+    static description: string;
+    run(): Promise<void>;
+}

package/dist/commands/config.js

@@ -0,0 +1,10 @@
+import { Command } from '@oclif/core';
+import { loadConfig } from '../config/load-config.js';
+export default class Config extends Command {
+    static description = 'Print resolved config';
+    async run() {
+        const config = await loadConfig();
+        this.log(JSON.stringify(config, null, 2));
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/commands/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAC,MAAM,aAAa,CAAA;AACnC,OAAO,EAAC,UAAU,EAAC,MAAM,0BAA0B,CAAA;AAEnD,MAAM,CAAC,OAAO,OAAO,MAAO,SAAQ,OAAO;IACzC,MAAM,CAAU,WAAW,GAAG,uBAAuB,CAAA;IAE9C,KAAK,CAAC,GAAG;QACd,MAAM,MAAM,GAAG,MAAM,UAAU,EAAE,CAAA;QACjC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;IAC3C,CAAC"}

package/dist/commands/init.d.ts

@@ -0,0 +1,8 @@
+import { Command } from '@oclif/core';
+export default class Init extends Command {
+    static description: string;
+    static flags: {
+        force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/init.js

@@ -0,0 +1,26 @@
+import { Command, Flags } from '@oclif/core';
+import { mkdir, writeFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+export default class Init extends Command {
+    static description = 'Initialize myclaw config in current directory';
+    static flags = {
+        force: Flags.boolean({ char: 'f', description: 'overwrite existing config' })
+    };
+    async run() {
+        const { flags } = await this.parse(Init);
+        const targetDir = process.cwd();
+        const configPath = resolve(targetDir, '.myclawrc.json');
+        const envPath = resolve(targetDir, '.env.example');
+        await mkdir(targetDir, { recursive: true });
+        await writeFile(configPath, JSON.stringify({
+            provider: 'openai',
+            model: '',
+            baseURL: '',
+            workspace: targetDir
+        }, null, 2) + '\n', { flag: flags.force ? 'w' : 'wx' });
+        await writeFile(envPath, 'OPENAI_API_KEY=\nOPENAI_MODEL=gpt-4o-mini\nOPENAI_BASE_URL=\nANTHROPIC_API_KEY=\n', { flag: flags.force ? 'w' : 'wx' });
+        this.log(`Created ${configPath}`);
+        this.log(`Created ${envPath}`);
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAE,KAAK,EAAC,MAAM,aAAa,CAAA;AAC1C,OAAO,EAAC,KAAK,EAAE,SAAS,EAAC,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAC,OAAO,EAAC,MAAM,WAAW,CAAA;AAEjC,MAAM,CAAC,OAAO,OAAO,IAAK,SAAQ,OAAO;IACvC,MAAM,CAAU,WAAW,GAAG,+CAA+C,CAAA;IAE7E,MAAM,CAAU,KAAK,GAAG;QACtB,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,EAAC,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,2BAA2B,EAAC,CAAC;KAC5E,CAAA;IAEM,KAAK,CAAC,GAAG;QACd,MAAM,EAAC,KAAK,EAAC,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QACtC,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE,CAAA;QAC/B,MAAM,UAAU,GAAG,OAAO,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAA;QACvD,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,EAAE,cAAc,CAAC,CAAA;QAElD,MAAM,KAAK,CAAC,SAAS,EAAE,EAAC,SAAS,EAAE,IAAI,EAAC,CAAC,CAAA;QACzC,MAAM,SAAS,CACb,UAAU,EACV,IAAI,CAAC,SAAS,CACZ;YACE,QAAQ,EAAE,QAAQ;YAClB,KAAK,EAAE,EAAE;YACT,OAAO,EAAE,EAAE;YACX,SAAS,EAAE,SAAS;SACrB,EACD,IAAI,EACJ,CAAC,CACF,GAAG,IAAI,EACR,EAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAC,CACjC,CAAA;QAED,MAAM,SAAS,CACb,OAAO,EACP,mFAAmF,EACnF,EAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAC,CACjC,CAAA;QAED,IAAI,CAAC,GAAG,CAAC,WAAW,UAAU,EAAE,CAAC,CAAA;QACjC,IAAI,CAAC,GAAG,CAAC,WAAW,OAAO,EAAE,CAAC,CAAA;IAChC,CAAC"}

package/dist/commands/run.d.ts

@@ -0,0 +1,13 @@
+import { Command } from '@oclif/core';
+export default class Run extends Command {
+    static description: string;
+    static flags: {
+        quiet: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        verboseModel: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        nonInteractive: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    static args: {
+        task: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/run.js

@@ -0,0 +1,84 @@
+import { Args, Command, Flags } from '@oclif/core';
+import { createInterface } from 'node:readline/promises';
+import { stdin as stdIn, stdout as stdOut } from 'node:process';
+import { runAgentTask } from '../core/agent.js';
+const ANSI = {
+    reset: '\x1b[0m',
+    red: '\x1b[31m',
+    bold: '\x1b[1m'
+};
+function red(text) {
+    return `${ANSI.red}${text}${ANSI.reset}`;
+}
+function redBold(text) {
+    return `${ANSI.red}${ANSI.bold}${text}${ANSI.reset}`;
+}
+function now() {
+    return new Date().toISOString();
+}
+function shorten(text, max = 500) {
+    if (text.length <= max)
+        return text;
+    return `${text.slice(0, max)}\n...[truncated]`;
+}
+function formatEvent(event) {
+    switch (event.type) {
+        case 'start':
+            return `[${now()}] START provider=${event.provider} model=${event.model} workspace=${event.workspace}`;
+        case 'model_response':
+            return `[${now()}] MODEL_RESPONSE step=${event.step}\n${shorten(event.content)}`;
+        case 'tool_call':
+            return `[${now()}] TOOL_CALL step=${event.step} tool=${event.tool} input=${JSON.stringify(event.input)}`;
+        case 'tool_result':
+            return `[${now()}] TOOL_RESULT step=${event.step} tool=${event.tool} ok=${event.ok}\n${shorten(event.output)}`;
+        case 'final':
+            return `[${now()}] FINAL step=${event.step}\n${shorten(event.content)}`;
+        case 'max_steps':
+            return `[${now()}] MAX_STEPS step=${event.step}`;
+    }
+}
+export default class Run extends Command {
+    static description = 'Run a one-shot coding task';
+    static flags = {
+        quiet: Flags.boolean({ description: 'hide execution logs and print only final output' }),
+        verboseModel: Flags.boolean({ description: 'show raw model responses for each step' }),
+        nonInteractive: Flags.boolean({ description: 'disable interactive approval for sensitive commands' })
+    };
+    static args = {
+        task: Args.string({ description: 'task prompt', required: true })
+    };
+    async run() {
+        const { args, flags } = await this.parse(Run);
+        const output = await runAgentTask(args.task, {
+            onSensitiveAction: async ({ tool, command }) => {
+                if (flags.nonInteractive || !stdIn.isTTY) {
+                    this.log(red(`[${now()}] ⚠️ SENSITIVE_REQUEST tool=${tool} auto=deny (non-interactive) command=${command}`));
+                    return false;
+                }
+                this.log(redBold(`[${now()}] 🚨 WAITING FOR USER INPUT`));
+                this.log(red(`[${now()}] ⚠️ SENSITIVE_REQUEST tool=${tool} command=${command}`));
+                const rl = createInterface({ input: stdIn, output: stdOut });
+                try {
+                    const answer = (await rl.question(redBold('🛑 Allow this sensitive command? [y/N] ')))
+                        .trim()
+                        .toLowerCase();
+                    return answer === 'y' || answer === 'yes';
+                }
+                finally {
+                    rl.close();
+                }
+            },
+            onEvent: flags.quiet
+                ? undefined
+                : (event) => {
+                    if (event.type === 'model_response' && !flags.verboseModel)
+                        return;
+                    if (event.type === 'final')
+                        return;
+                    this.log(formatEvent(event));
+                }
+        });
+        this.log(output);
+    }
+}
+//# sourceMappingURL=run.js.map

package/dist/commands/run.js.map

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

package/dist/config/load-config.d.ts

@@ -0,0 +1,2 @@
+import { type AppConfig } from './schema.js';
+export declare function loadConfig(): Promise<AppConfig>;

package/dist/config/load-config.js

@@ -0,0 +1,10 @@
+import { cosmiconfig } from 'cosmiconfig';
+import dotenv from 'dotenv';
+import { appConfigSchema } from './schema.js';
+dotenv.config();
+export async function loadConfig() {
+    const explorer = cosmiconfig('myclaw');
+    const result = await explorer.search();
+    return appConfigSchema.parse(result?.config ?? {});
+}
+//# sourceMappingURL=load-config.js.map

package/dist/config/load-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-config.js","sourceRoot":"","sources":["../../src/config/load-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAC,MAAM,aAAa,CAAA;AACvC,OAAO,MAAM,MAAM,QAAQ,CAAA;AAC3B,OAAO,EAAC,eAAe,EAAiB,MAAM,aAAa,CAAA;AAE3D,MAAM,CAAC,MAAM,EAAE,CAAA;AAEf,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,MAAM,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAA;IACtC,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,MAAM,EAAE,CAAA;IACtC,OAAO,eAAe,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,IAAI,EAAE,CAAC,CAAA;AACpD,CAAC"}

package/dist/config/schema.d.ts

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+export declare const appConfigSchema: z.ZodObject<{
+    provider: z.ZodDefault<z.ZodEnum<["mock", "openai", "anthropic"]>>;
+    model: z.ZodEffects<z.ZodOptional<z.ZodString>, string | undefined, unknown>;
+    baseURL: z.ZodEffects<z.ZodOptional<z.ZodString>, string | undefined, unknown>;
+    workspace: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    provider: "mock" | "openai" | "anthropic";
+    workspace: string;
+    model?: string | undefined;
+    baseURL?: string | undefined;
+}, {
+    provider?: "mock" | "openai" | "anthropic" | undefined;
+    model?: unknown;
+    baseURL?: unknown;
+    workspace?: string | undefined;
+}>;
+export type AppConfig = z.infer<typeof appConfigSchema>;

package/dist/config/schema.js

@@ -0,0 +1,8 @@
+import { z } from 'zod';
+export const appConfigSchema = z.object({
+    provider: z.enum(['mock', 'openai', 'anthropic']).default('openai'),
+    model: z.preprocess((value) => (typeof value === 'string' && value.trim() === '' ? undefined : value), z.string().trim().optional()),
+    baseURL: z.preprocess((value) => (typeof value === 'string' && value.trim() === '' ? undefined : value), z.string().trim().optional()),
+    workspace: z.string().default(process.cwd())
+});
+//# sourceMappingURL=schema.js.map

package/dist/config/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAA;AAErB,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IACnE,KAAK,EAAE,CAAC,CAAC,UAAU,CACjB,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,EACjF,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,CAC7B;IACD,OAAO,EAAE,CAAC,CAAC,UAAU,CACnB,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,EACjF,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,CAC7B;IACD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;CAC7C,CAAC,CAAA"}

package/dist/core/agent.d.ts

@@ -0,0 +1,39 @@
+type ToolName = 'read_file' | 'write_file' | 'apply_patch' | 'list_files' | 'run_shell';
+export type AgentEvent = {
+    type: 'start';
+    provider: string;
+    model: string;
+    workspace: string;
+} | {
+    type: 'model_response';
+    step: number;
+    content: string;
+} | {
+    type: 'tool_call';
+    step: number;
+    tool: ToolName;
+    input: Record<string, unknown>;
+} | {
+    type: 'tool_result';
+    step: number;
+    tool: ToolName;
+    ok: boolean;
+    output: string;
+} | {
+    type: 'final';
+    step: number;
+    content: string;
+} | {
+    type: 'max_steps';
+    step: number;
+};
+type AgentRunOptions = {
+    onEvent?: (event: AgentEvent) => void;
+    maxSteps?: number;
+    onSensitiveAction?: (request: {
+        tool: ToolName;
+        command: string;
+    }) => Promise<boolean> | boolean;
+};
+export declare function runAgentTask(task: string, options?: AgentRunOptions): Promise<string>;
+export {};

package/dist/core/agent.js

@@ -0,0 +1,277 @@
+import { loadConfig } from '../config/load-config.js';
+import { MockProvider } from '../providers/mock-provider.js';
+import { OpenAIProvider } from '../providers/openai-provider.js';
+import { applyTextPatch, fileExists, listFiles, readTextFile, resolveWorkspacePath, writeTextFile } from '../tools/filesystem.js';
+import { runShell } from '../tools/shell.js';
+function nonEmpty(value) {
+    if (!value)
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+function resolveModel(configModel) {
+    return nonEmpty(configModel) ?? nonEmpty(process.env.OPENAI_MODEL) ?? 'gpt-4o-mini';
+}
+function providerFromConfig(name, model, baseURL) {
+    if (name === 'mock')
+        return new MockProvider();
+    if (name === 'openai') {
+        const apiKey = process.env.OPENAI_API_KEY;
+        if (!apiKey) {
+            throw new Error('OPENAI_API_KEY is missing. Set it in your environment or .env file.');
+        }
+        return new OpenAIProvider({
+            apiKey,
+            model,
+            baseUrl: nonEmpty(baseURL) ?? nonEmpty(process.env.OPENAI_BASE_URL)
+        });
+    }
+    throw new Error(`Provider '${name}' is not implemented yet.`);
+}
+function extractJsonBlock(text) {
+    const trimmed = text.trim();
+    if (trimmed.startsWith('{') && trimmed.endsWith('}'))
+        return trimmed;
+    const fenceMatch = trimmed.match(/```json\s*([\s\S]*?)\s*```/i);
+    if (fenceMatch?.[1])
+        return fenceMatch[1];
+    return undefined;
+}
+function extractJsonObjects(text) {
+    const blocks = [];
+    let start = -1;
+    let depth = 0;
+    let inString = false;
+    let escaped = false;
+    for (let i = 0; i < text.length; i += 1) {
+        const ch = text[i];
+        if (inString) {
+            if (escaped) {
+                escaped = false;
+                continue;
+            }
+            if (ch === '\\') {
+                escaped = true;
+                continue;
+            }
+            if (ch === '"')
+                inString = false;
+            continue;
+        }
+        if (ch === '"') {
+            inString = true;
+            continue;
+        }
+        if (ch === '{') {
+            if (depth === 0)
+                start = i;
+            depth += 1;
+            continue;
+        }
+        if (ch === '}') {
+            if (depth === 0)
+                continue;
+            depth -= 1;
+            if (depth === 0 && start >= 0) {
+                blocks.push(text.slice(start, i + 1));
+                start = -1;
+            }
+        }
+    }
+    return blocks;
+}
+function parseToolCalls(text) {
+    const block = extractJsonBlock(text);
+    const candidates = block ? [block] : extractJsonObjects(text);
+    const calls = [];
+    for (const candidate of candidates) {
+        try {
+            const parsed = JSON.parse(candidate);
+            if (parsed.type !== 'tool_call')
+                continue;
+            if (!parsed.tool || !parsed.input)
+                continue;
+            calls.push(parsed);
+        }
+        catch {
+            continue;
+        }
+    }
+    return calls;
+}
+function mutationCount(calls) {
+    return calls.filter((call) => call.tool === 'write_file' || call.tool === 'apply_patch').length;
+}
+function readBeforeWriteError(tool, path) {
+    return `${tool} rejected: existing file '${path}' must be read_file first in this run.`;
+}
+function createFileRejectedError(path) {
+    return `write_file rejected: '${path}' does not exist. Read related files first and use apply_patch, or set allowCreate=true only when explicit file creation is required.`;
+}
+function shellDangerRejectedError(command) {
+    return `run_shell rejected: destructive command blocked. command=${command}`;
+}
+function looksDestructiveCommand(command) {
+    const text = command.toLowerCase().trim();
+    const patterns = [
+        /\brm\b/,
+        /\brmdir\b/,
+        /\bunlink\b/,
+        /\bdel\b/,
+        /\brd\b/, // windows remove directory shorthand can appear in scripts
+        /\bmv\b.+\s\/dev\/null/,
+        /\bgit\s+reset\s+--hard\b/,
+        /\bgit\s+clean\b/
+    ];
+    return patterns.some((pattern) => pattern.test(text));
+}
+async function executeTool(toolCall, workspace, state, options) {
+    try {
+        switch (toolCall.tool) {
+            case 'read_file': {
+                const path = String(toolCall.input.path ?? '');
+                const content = await readTextFile(workspace, path);
+                state.readPaths.add(resolveWorkspacePath(workspace, path));
+                return { ok: true, output: content };
+            }
+            case 'write_file': {
+                const path = String(toolCall.input.path ?? '');
+                const content = String(toolCall.input.content ?? '');
+                const allowCreate = Boolean(toolCall.input.allowCreate ?? false);
+                const existing = await fileExists(workspace, path);
+                const canonicalPath = resolveWorkspacePath(workspace, path);
+                if (!existing && !allowCreate) {
+                    return { ok: false, output: createFileRejectedError(path) };
+                }
+                if (existing && !state.readPaths.has(canonicalPath)) {
+                    return { ok: false, output: readBeforeWriteError('write_file', path) };
+                }
+                await writeTextFile(workspace, path, content);
+                state.readPaths.add(canonicalPath);
+                return { ok: true, output: `Wrote file: ${path}` };
+            }
+            case 'apply_patch': {
+                const path = String(toolCall.input.path ?? '');
+                const search = String(toolCall.input.search ?? '');
+                const replace = String(toolCall.input.replace ?? '');
+                const replaceAll = Boolean(toolCall.input.replaceAll ?? false);
+                const existing = await fileExists(workspace, path);
+                const canonicalPath = resolveWorkspacePath(workspace, path);
+                if (!existing) {
+                    return { ok: false, output: `apply_patch rejected: '${path}' does not exist.` };
+                }
+                if (existing && !state.readPaths.has(canonicalPath)) {
+                    return { ok: false, output: readBeforeWriteError('apply_patch', path) };
+                }
+                const output = await applyTextPatch(workspace, path, search, replace, replaceAll);
+                state.readPaths.add(canonicalPath);
+                return { ok: true, output };
+            }
+            case 'list_files': {
+                const path = String(toolCall.input.path ?? '.');
+                const files = await listFiles(workspace, path);
+                return { ok: true, output: files.join('\n') || '(empty directory)' };
+            }
+            case 'run_shell': {
+                const command = String(toolCall.input.command ?? '');
+                if (looksDestructiveCommand(command)) {
+                    const approved = (await options.onSensitiveAction?.({ tool: 'run_shell', command })) ?? false;
+                    if (!approved) {
+                        return { ok: false, output: shellDangerRejectedError(command) };
+                    }
+                }
+                const output = await runShell(command, workspace);
+                return { ok: true, output };
+            }
+            default:
+                return { ok: false, output: `Unknown tool: ${String(toolCall.tool)}` };
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return { ok: false, output: message };
+    }
+}
+export async function runAgentTask(task, options = {}) {
+    const config = await loadConfig();
+    const resolvedModel = resolveModel(config.model);
+    const provider = providerFromConfig(config.provider, resolvedModel, config.baseURL);
+    const workspace = config.workspace;
+    const maxSteps = options.maxSteps ?? 8;
+    options.onEvent?.({
+        type: 'start',
+        provider: config.provider,
+        model: resolvedModel,
+        workspace
+    });
+    const messages = [
+        {
+            role: 'system',
+            content: [
+                `You are a coding agent running in workspace: ${workspace}.`,
+                'When you need to operate files or shell, respond with ONLY JSON:',
+                '{"type":"tool_call","tool":"read_file|write_file|apply_patch|list_files|run_shell","input":{...}}',
+                'Available tools:',
+                '- read_file: {"path":"relative/path"}',
+                '- write_file: {"path":"relative/path","content":"...","allowCreate":false} (single-file full rewrite)',
+                '- apply_patch: {"path":"relative/path","search":"old text","replace":"new text","replaceAll":false}',
+                '- list_files: {"path":"relative/path optional"}',
+                '- run_shell: {"command":"..."}',
+                'Rules:',
+                '- Existing files MUST be read_file before write_file/apply_patch.',
+                '- New file creation is blocked by default.',
+                '- To create files, write_file input.allowCreate=true is required.',
+                '- Destructive shell commands (e.g., rm/rmdir/unlink/del/git reset --hard/git clean) are blocked.',
+                '- You may call multiple read_file tools in one response.',
+                '- At most one mutation tool (write_file or apply_patch) per response.',
+                'Use relative paths. Never wrap JSON with extra prose when calling tools.',
+                'When finished, return a normal natural-language summary.'
+            ].join('\n')
+        },
+        { role: 'user', content: task }
+    ];
+    const state = { readPaths: new Set() };
+    for (let step = 0; step < maxSteps; step += 1) {
+        const assistantText = await provider.chat(messages);
+        options.onEvent?.({ type: 'model_response', step, content: assistantText });
+        const toolCalls = parseToolCalls(assistantText);
+        if (toolCalls.length === 0) {
+            options.onEvent?.({ type: 'final', step, content: assistantText });
+            return assistantText;
+        }
+        messages.push({ role: 'assistant', content: assistantText });
+        if (mutationCount(toolCalls) > 1) {
+            const output = 'Batch rejected: only one mutation tool (write_file/apply_patch) is allowed per step.';
+            options.onEvent?.({
+                type: 'tool_result',
+                step,
+                tool: toolCalls.find((call) => call.tool === 'write_file' || call.tool === 'apply_patch')?.tool ?? 'write_file',
+                ok: false,
+                output
+            });
+            messages.push({
+                role: 'user',
+                content: `TOOL_RESULT ${JSON.stringify({ tool: 'batch_validation', ok: false, output })}`
+            });
+            continue;
+        }
+        for (const toolCall of toolCalls) {
+            options.onEvent?.({ type: 'tool_call', step, tool: toolCall.tool, input: toolCall.input });
+            const result = await executeTool(toolCall, workspace, state, options);
+            options.onEvent?.({
+                type: 'tool_result',
+                step,
+                tool: toolCall.tool,
+                ok: result.ok,
+                output: result.output
+            });
+            messages.push({
+                role: 'user',
+                content: `TOOL_RESULT ${JSON.stringify({ tool: toolCall.tool, ...result })}`
+            });
+        }
+    }
+    options.onEvent?.({ type: 'max_steps', step: maxSteps });
+    return 'Stopped after maximum tool steps. Please refine the task and retry.';
+}
+//# sourceMappingURL=agent.js.map

package/dist/core/agent.js.map

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

package/dist/index.d.ts

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

package/dist/index.js

@@ -0,0 +1,3 @@
+import { execute } from '@oclif/core';
+await execute({ development: true, dir: import.meta.url });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAC,MAAM,aAAa,CAAA;AAEnC,MAAM,OAAO,CAAC,EAAC,WAAW,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,EAAC,CAAC,CAAA"}

package/dist/providers/mock-provider.d.ts

@@ -0,0 +1,5 @@
+import type { ChatMessage, LLMProvider } from './types.js';
+export declare class MockProvider implements LLMProvider {
+    readonly name = "mock";
+    chat(messages: ChatMessage[]): Promise<string>;
+}

package/dist/providers/mock-provider.js

@@ -0,0 +1,10 @@
+export class MockProvider {
+    name = 'mock';
+    async chat(messages) {
+        const last = messages.at(-1);
+        if (!last)
+            return 'No input provided.';
+        return `Mock response: ${last.content}`;
+    }
+}
+//# sourceMappingURL=mock-provider.js.map

package/dist/providers/mock-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-provider.js","sourceRoot":"","sources":["../../src/providers/mock-provider.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,YAAY;IACd,IAAI,GAAG,MAAM,CAAA;IAEtB,KAAK,CAAC,IAAI,CAAC,QAAuB;QAChC,MAAM,IAAI,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;QAC5B,IAAI,CAAC,IAAI;YAAE,OAAO,oBAAoB,CAAA;QACtC,OAAO,kBAAkB,IAAI,CAAC,OAAO,EAAE,CAAA;IACzC,CAAC;CACF"}

package/dist/providers/openai-provider.d.ts

@@ -0,0 +1,14 @@
+import type { ChatMessage, LLMProvider } from './types.js';
+type OpenAIProviderOptions = {
+    apiKey: string;
+    model: string;
+    baseUrl?: string;
+};
+export declare class OpenAIProvider implements LLMProvider {
+    readonly name = "openai";
+    private readonly client;
+    private readonly model;
+    constructor(options: OpenAIProviderOptions);
+    chat(messages: ChatMessage[]): Promise<string>;
+}
+export {};

package/dist/providers/openai-provider.js

@@ -0,0 +1,63 @@
+import OpenAI from 'openai';
+function safeJsonSnippet(value) {
+    try {
+        return JSON.stringify(value).slice(0, 500);
+    }
+    catch {
+        return '[unserializable response]';
+    }
+}
+function extractText(data) {
+    const messageContent = data?.choices?.[0]?.message?.content;
+    if (typeof messageContent === 'string' && messageContent.trim()) {
+        return messageContent;
+    }
+    if (Array.isArray(messageContent)) {
+        const joined = messageContent
+            .map((part) => {
+            if (typeof part === 'string')
+                return part;
+            if (typeof part?.text === 'string')
+                return part.text;
+            return '';
+        })
+            .join('')
+            .trim();
+        if (joined)
+            return joined;
+    }
+    const textField = data?.choices?.[0]?.text;
+    if (typeof textField === 'string' && textField.trim()) {
+        return textField;
+    }
+    if (typeof data?.output_text === 'string' && data.output_text.trim()) {
+        return data.output_text;
+    }
+    return undefined;
+}
+export class OpenAIProvider {
+    name = 'openai';
+    client;
+    model;
+    constructor(options) {
+        this.model = options.model;
+        const rawBaseUrl = options.baseUrl ?? 'https://api.openai.com/v1';
+        const baseURL = rawBaseUrl.replace(/\/+$/, '');
+        this.client = new OpenAI({
+            apiKey: options.apiKey,
+            baseURL
+        });
+    }
+    async chat(messages) {
+        const completion = await this.client.chat.completions.create({
+            model: this.model,
+            messages
+        });
+        const content = extractText(completion);
+        if (!content) {
+            throw new Error(`OpenAI API returned no readable text. Response snippet: ${safeJsonSnippet(completion)}`);
+        }
+        return content;
+    }
+}
+//# sourceMappingURL=openai-provider.js.map

package/dist/providers/openai-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-provider.js","sourceRoot":"","sources":["../../src/providers/openai-provider.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAA;AAS3B,SAAS,eAAe,CAAC,KAAc;IACrC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,2BAA2B,CAAA;IACpC,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,IAAS;IAC5B,MAAM,cAAc,GAAG,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAA;IAC3D,IAAI,OAAO,cAAc,KAAK,QAAQ,IAAI,cAAc,CAAC,IAAI,EAAE,EAAE,CAAC;QAChE,OAAO,cAAc,CAAA;IACvB,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,cAAc;aAC1B,GAAG,CAAC,CAAC,IAAS,EAAE,EAAE;YACjB,IAAI,OAAO,IAAI,KAAK,QAAQ;gBAAE,OAAO,IAAI,CAAA;YACzC,IAAI,OAAO,IAAI,EAAE,IAAI,KAAK,QAAQ;gBAAE,OAAO,IAAI,CAAC,IAAI,CAAA;YACpD,OAAO,EAAE,CAAA;QACX,CAAC,CAAC;aACD,IAAI,CAAC,EAAE,CAAC;aACR,IAAI,EAAE,CAAA;QACT,IAAI,MAAM;YAAE,OAAO,MAAM,CAAA;IAC3B,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAA;IAC1C,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,CAAC,IAAI,EAAE,EAAE,CAAC;QACtD,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,IAAI,OAAO,IAAI,EAAE,WAAW,KAAK,QAAQ,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC;QACrE,OAAO,IAAI,CAAC,WAAW,CAAA;IACzB,CAAC;IAED,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,MAAM,OAAO,cAAc;IAChB,IAAI,GAAG,QAAQ,CAAA;IACP,MAAM,CAAQ;IACd,KAAK,CAAQ;IAE9B,YAAY,OAA8B;QACxC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAA;QAC1B,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,IAAI,2BAA2B,CAAA;QACjE,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;QAC9C,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC;YACvB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,OAAO;SACR,CAAC,CAAA;IACJ,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,QAAuB;QAChC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;YAC3D,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,QAAQ;SACT,CAAC,CAAA;QACF,MAAM,OAAO,GAAG,WAAW,CAAC,UAAU,CAAC,CAAA;QAEvC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,2DAA2D,eAAe,CAAC,UAAU,CAAC,EAAE,CAAC,CAAA;QAC3G,CAAC;QAED,OAAO,OAAO,CAAA;IAChB,CAAC;CACF"}

package/dist/providers/types.d.ts

@@ -0,0 +1,8 @@
+export type ChatMessage = {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+};
+export interface LLMProvider {
+    readonly name: string;
+    chat(messages: ChatMessage[]): Promise<string>;
+}

package/dist/providers/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/providers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/providers/types.ts"],"names":[],"mappings":""}

package/dist/tools/filesystem.d.ts

@@ -0,0 +1,6 @@
+export declare function resolveWorkspacePath(workspace: string, path: string): string;
+export declare function fileExists(workspace: string, path: string): Promise<boolean>;
+export declare function readTextFile(workspace: string, path: string): Promise<string>;
+export declare function writeTextFile(workspace: string, path: string, content: string): Promise<void>;
+export declare function listFiles(workspace: string, path?: string): Promise<string[]>;
+export declare function applyTextPatch(workspace: string, path: string, search: string, replace: string, replaceAll?: boolean): Promise<string>;

package/dist/tools/filesystem.js

@@ -0,0 +1,49 @@
+import { mkdir, readFile, readdir, writeFile } from 'node:fs/promises';
+import { dirname, resolve, sep } from 'node:path';
+import { access, constants } from 'node:fs';
+function assertInsideWorkspace(workspace, inputPath) {
+    const workspaceRoot = resolve(workspace);
+    const fullPath = resolve(workspaceRoot, inputPath);
+    const inWorkspace = fullPath === workspaceRoot || fullPath.startsWith(`${workspaceRoot}${sep}`);
+    if (!inWorkspace) {
+        throw new Error(`Path '${inputPath}' is outside workspace.`);
+    }
+    return fullPath;
+}
+export function resolveWorkspacePath(workspace, path) {
+    return assertInsideWorkspace(workspace, path);
+}
+export async function fileExists(workspace, path) {
+    const fullPath = assertInsideWorkspace(workspace, path);
+    return new Promise((resolvePromise) => {
+        access(fullPath, constants.F_OK, (error) => {
+            resolvePromise(!error);
+        });
+    });
+}
+export async function readTextFile(workspace, path) {
+    const fullPath = assertInsideWorkspace(workspace, path);
+    return readFile(fullPath, 'utf8');
+}
+export async function writeTextFile(workspace, path, content) {
+    const fullPath = assertInsideWorkspace(workspace, path);
+    await mkdir(dirname(fullPath), { recursive: true });
+    await writeFile(fullPath, content, 'utf8');
+}
+export async function listFiles(workspace, path = '.') {
+    const fullPath = assertInsideWorkspace(workspace, path);
+    return readdir(fullPath);
+}
+export async function applyTextPatch(workspace, path, search, replace, replaceAll = false) {
+    if (!search) {
+        throw new Error('apply_patch requires non-empty "search".');
+    }
+    const original = await readTextFile(workspace, path);
+    if (!original.includes(search)) {
+        throw new Error(`apply_patch could not find target text in ${path}.`);
+    }
+    const updated = replaceAll ? original.split(search).join(replace) : original.replace(search, replace);
+    await writeTextFile(workspace, path, updated);
+    return `Patched file: ${path}`;
+}
+//# sourceMappingURL=filesystem.js.map

package/dist/tools/filesystem.js.map

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

package/dist/tools/shell.d.ts

@@ -0,0 +1 @@
+export declare function runShell(command: string, cwd?: string): Promise<string>;

package/dist/tools/shell.js

@@ -0,0 +1,9 @@
+import { execa } from 'execa';
+export async function runShell(command, cwd = process.cwd()) {
+    const { stdout, stderr, exitCode } = await execa('zsh', ['-lc', command], { cwd, reject: false });
+    const header = `exit_code=${exitCode}`;
+    if (!stdout && !stderr)
+        return '(no output)';
+    return [header, stdout, stderr].filter(Boolean).join('\n');
+}
+//# sourceMappingURL=shell.js.map

package/dist/tools/shell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.js","sourceRoot":"","sources":["../../src/tools/shell.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,EAAC,MAAM,OAAO,CAAA;AAE3B,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,OAAe,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;IACjE,MAAM,EAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAC,GAAG,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,EAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAC,CAAC,CAAA;IAC7F,MAAM,MAAM,GAAG,aAAa,QAAQ,EAAE,CAAA;IACtC,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM;QAAE,OAAO,aAAa,CAAA;IAC5C,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAC5D,CAAC"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@sworddut/myclaw",
+  "version": "0.1.0",
+  "private": false,
+  "description": "A CLI coding agent inspired by Claude Code",
+  "type": "module",
+  "bin": {
+    "myclaw": "bin/run.js"
+  },
+  "files": [
+    "bin",
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsx bin/dev.js",
+    "test": "vitest run",
+    "lint": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@oclif/core": "^4.2.9",
+    "better-sqlite3": "^11.8.1",
+    "cosmiconfig": "^9.0.0",
+    "dotenv": "^16.5.0",
+    "execa": "^9.6.0",
+    "openai": "^6.22.0",
+    "zod": "^3.24.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.10",
+    "tsx": "^4.19.3",
+    "typescript": "^5.8.2",
+    "vitest": "^3.0.9"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "oclif": {
+    "commands": "./dist/commands",
+    "topicSeparator": " "
+  }
+}