codexslimedit 0.1.0

package/LICENSE-OPENSLIMEDIT-MIT.txt

@@ -0,0 +1,23 @@
+OpenSlimEdit attribution notice
+
+Copyright (c) 2026 Artur
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/LICENSE.md

@@ -0,0 +1,82 @@
+# License
+
+Portions of this software are licensed as follows:
+
+- All third party components incorporated into the oh-my-opencode Software are licensed under the original license
+  provided by the owner of the applicable component.
+- Content outside of the above mentioned files or restrictions is available under the "Sustainable Use
+  License" as defined below.
+
+## Sustainable Use License
+
+Version 1.0
+
+### Acceptance
+
+By using the software, you agree to all of the terms and conditions below.
+
+### Copyright License
+
+The licensor grants you a non-exclusive, royalty-free, worldwide, non-sublicensable, non-transferable license
+to use, copy, distribute, make available, and prepare derivative works of the software, in each case subject
+to the limitations below.
+
+### Limitations
+
+You may use or modify the software only for your own internal business purposes or for non-commercial or
+personal use. You may distribute the software or provide it to others only if you do so free of charge for
+non-commercial purposes. You may not alter, remove, or obscure any licensing, copyright, or other notices of
+the licensor in the software. Any use of the licensor's trademarks is subject to applicable law.
+
+### Patents
+
+The licensor grants you a license, under any patent claims the licensor can license, or becomes able to
+license, to make, have made, use, sell, offer for sale, import and have imported the software, in each case
+subject to the limitations and conditions in this license. This license does not cover any patent claims that
+you cause to be infringed by modifications or additions to the software. If you or your company make any
+written claim that the software infringes or contributes to infringement of any patent, your patent license
+for the software granted under these terms ends immediately. If your company makes such a claim, your patent
+license ends immediately for work on behalf of your company.
+
+### Notices
+
+You must ensure that anyone who gets a copy of any part of the software from you also gets a copy of these
+terms. If you modify the software, you must include in any modified copies of the software a prominent notice
+stating that you have modified the software.
+
+### No Other Rights
+
+These terms do not imply any licenses other than those expressly granted in these terms.
+
+### Termination
+
+If you use the software in violation of these terms, such use is not licensed, and your license will
+automatically terminate. If the licensor provides you with a notice of your violation, and you cease all
+violation of this license no later than 30 days after you receive that notice, your license will be reinstated
+retroactively. However, if you violate these terms after such reinstatement, any additional violation of these
+terms will cause your license to terminate automatically and permanently.
+
+### No Liability
+
+As far as the law allows, the software comes as is, without any warranty or condition, and the licensor will
+not be liable to you for any damages arising out of these terms or the use or nature of the software, under
+any kind of legal claim.
+
+### Definitions
+
+The "licensor" is the entity offering these terms.
+
+The "software" is the software the licensor makes available under these terms, including any portion of it.
+
+"You" refers to the individual or entity agreeing to these terms.
+
+"Your company" is any legal entity, sole proprietorship, or other kind of organization that you work for, plus
+all organizations that have control over, are under the control of, or are under common control with that
+organization. Control means ownership of substantially all the assets of an entity, or the power to direct its
+management and policies by vote, contract, or otherwise. Control can be direct or indirect.
+
+"Your license" is the license granted to you for the software under these terms.
+
+"Use" means anything you do with the software requiring your license.
+
+"Trademark" means trademarks, service marks, and similar rights.

package/README.md

@@ -0,0 +1,22 @@
+# codexslimedit
+
+Codex-native MCP tools for compact UTF-8 file reads and validated exact or line-range edits. Runs on Node.js 20+ and Bun.
+
+## Use
+
+```sh
+npx codexslimedit
+# or
+bunx codexslimedit
+```
+
+The MCP server exposes:
+
+- `read`: returns a root-relative path and file content without footer boilerplate.
+- `edit`: replaces one unique exact string or a 1-based inclusive line range such as `55-64`, then returns `OK <path>`.
+
+Both tools constrain access to the server working directory. Reads reject non-UTF-8, NUL-containing, missing, non-file, traversal, and symlink-escape targets. Edits validate before writing, reject ambiguous matches and invalid ranges, preserve line endings and file mode, and use same-directory atomic replacement.
+
+## Codex adaptation
+
+This package adapts ideas from OpenSlimEdit for supported Codex extension surfaces. Codex plugins cannot replace descriptions of native tools or replace model-facing `PostToolUse` output, and Codex native patch editing has no OpenCode `oldString` contract. `codexslimedit` therefore provides separate concise MCP tools and makes no upstream token-saving claim.

package/THIRD-PARTY-NOTICES.md

@@ -0,0 +1,3 @@
+# Third-party notices
+
+OpenSlimEdit concepts and naming are attributed to Artur. Its MIT license is preserved in `LICENSE-OPENSLIMEDIT-MIT.txt`. This package does not bundle upstream source code.

package/dist/cli.js

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+import { a as CODEX_SLIM_EDIT_VERSION, n as runCodexSlimEditMcpStdioServer, o as isVersionRequest, s as stackOrMessageFromError } from "./mcp.js";
+import { stderr } from "node:process";
+//#region src/cli.ts
+/** Starts the CodexSlimEdit MCP stdio entrypoint. */
+async function main() {
+	if (isVersionRequest(process.argv.slice(2))) {
+		process.stdout.write(`${CODEX_SLIM_EDIT_VERSION}\n`);
+		return;
+	}
+	await runCodexSlimEditMcpStdioServer(process.stdin, process.stdout);
+}
+main().catch((error) => {
+	stderr.write(`${stackOrMessageFromError(error)}\n`);
+	process.exitCode = 1;
+});
+//#endregion

package/dist/index.d.ts

@@ -0,0 +1,77 @@
+import type { Readable, Writable } from "node:stream";
+
+/** Current independent codexslimedit package version. */
+export declare const CODEX_SLIM_EDIT_VERSION = "0.1.0";
+
+/** Returns whether command-line arguments request the package version. */
+export declare function isVersionRequest(args: readonly string[]): boolean;
+
+/** Identifies a workspace file operation failure. */
+export type WorkspaceFileErrorCode =
+  | "EXACT_MATCH_NOT_FOUND"
+  | "DUPLICATE_MATCH"
+  | "INVALID_RANGE"
+  | "NOT_A_FILE"
+  | "NOT_FOUND"
+  | "PATH_OUTSIDE_ROOT"
+  | "UNREADABLE_FILE"
+  | "UNSUPPORTED_TEXT"
+  | "WRITE_FAILED";
+
+/** Reports a typed, actionable workspace file operation failure. */
+export declare class WorkspaceFileError extends Error {
+  /** Creates a workspace file operation error. */
+  constructor(code: WorkspaceFileErrorCode, message: string);
+  readonly code: WorkspaceFileErrorCode;
+}
+
+/** Input shared by workspace file operations. */
+export interface WorkspaceFileInput {
+  /** Workspace root used to constrain file access. */
+  readonly root: string;
+  /** Relative path to the target file. */
+  readonly filePath: string;
+}
+
+/** Input for an exact-content or inclusive-line-range edit. */
+export interface EditWorkspaceFileInput extends WorkspaceFileInput {
+  /** Exact text to replace, or an inclusive 1-based `N` or `N-M` line range. */
+  readonly oldString: string;
+  /** Replacement text. */
+  readonly newString: string;
+}
+
+/** Content returned by a workspace file operation. */
+export interface WorkspaceFileResult {
+  /** Canonical root-relative path. */
+  readonly path: string;
+  /** UTF-8 file content after the operation. */
+  readonly content: string;
+}
+
+/** Options for the CodexSlimEdit MCP server. */
+export interface CodexSlimEditMcpOptions {
+  /** Workspace root; defaults to the server process current directory. */
+  readonly root?: string;
+}
+
+/** Reads a regular UTF-8 text file inside the workspace root. */
+export declare function readWorkspaceFile(input: WorkspaceFileInput): Promise<WorkspaceFileResult>;
+
+/** Applies one validated exact-content or inclusive-line-range edit atomically. */
+export declare function editWorkspaceFile(
+  input: EditWorkspaceFileInput,
+): Promise<WorkspaceFileResult>;
+
+/** Handles one CodexSlimEdit MCP JSON-RPC request. */
+export declare function handleCodexSlimEditMcpRequest(
+  input: unknown,
+  options?: CodexSlimEditMcpOptions,
+): Promise<unknown>;
+
+/** Runs the CodexSlimEdit MCP server over stdio. */
+export declare function runCodexSlimEditMcpStdioServer(
+  input: Readable,
+  output: Writable,
+  options?: CodexSlimEditMcpOptions,
+): Promise<void>;

package/dist/index.js

@@ -0,0 +1,2 @@
+import { a as CODEX_SLIM_EDIT_VERSION, c as WorkspaceFileError, i as readWorkspaceFile, n as runCodexSlimEditMcpStdioServer, o as isVersionRequest, r as editWorkspaceFile, t as handleCodexSlimEditMcpRequest } from "./mcp.js";
+export { CODEX_SLIM_EDIT_VERSION, WorkspaceFileError, editWorkspaceFile, handleCodexSlimEditMcpRequest, isVersionRequest, readWorkspaceFile, runCodexSlimEditMcpStdioServer };