@codeworksh/cli 0.0.1-dev.20260918040208

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sanchit Kudari <0xsanchit@gmail.com> & Contributors
+
+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/README.md

@@ -0,0 +1,134 @@
+# @codeworksh/cli
+
+Run coding-agent sessions in your repo or a sandbox.
+
+## Installation
+
+```bash
+pnpm add -g @codeworksh/cli
+# or run directly
+pnpm dlx @codeworksh/cli <command>
+```
+
+After install, every command is `codework <command>`.
+
+## Development
+
+From `packages/codework`, or `pnpm cli` at the repo root:
+
+```bash
+pnpm start -- --help
+pnpm start -- models
+pnpm start -- run "Inspect the failing tests"
+```
+
+`start` runs `src/index.ts` with `--conditions=development` so workspace packages resolve to source. The published `codework` binary is the packed `dist` build.
+
+---
+
+## Commands
+
+### `codework run`
+
+Run an agent session with a prompt.
+
+```bash
+# Start a new session
+codework run "Inspect and fix the failing tests"
+
+# Create a session with explicit provider and model
+codework run --provider openai --model gpt-5.5 --thinking high "Plan database migration"
+
+# Continue an existing session
+codework run --session ses_01a070f0 "Now implement the migration script"
+
+# Run in an isolated sandbox (local, daytona, vercel, memory, sqldb)
+codework run --sandbox-driver daytona "Inspect repository"
+codework run --sandbox-driver daytona --sandbox-provider-id <remote-id> "Continue in sandbox"
+```
+
+#### Flags:
+
+- `--server <url>` — Connect to a running RPC server, e.g. `ws://127.0.0.1:7433/rpc`.
+- `-s, --session <id>` — Continue an existing session.
+- `-C, --cwd <path>` — Working directory for a new session.
+- `--sandbox-driver <driver>` — Sandbox driver (`local`, `daytona`, `vercel`, `memory`, `sqldb`). Default: `local`.
+- `--sandbox-id <id>` — Reuse an existing sandbox instance; mutually exclusive with driver/provider coordinates.
+- `--sandbox-provider-id <id>` — Provider ID of an existing remote sandbox.
+- `--provider <id>` — Model catalog provider ID.
+- `--model <id>` — Model ID.
+- `--thinking <level>` — Reasoning effort the model uses before answering (`off`, `minimal`, `low`, `medium`, `high`, `xhigh`, `max`).
+
+Global flags: `--user-config-dir`, `--home`, `--database`.
+
+---
+
+### `codework serve`
+
+Start a persistent server that owns sessions and sandboxes:
+
+```bash
+codework serve --host 127.0.0.1 --port 7433
+codework run --server ws://127.0.0.1:7433/rpc "Inspect the failing tests"
+codework run --server ws://127.0.0.1:7433/rpc --session <id> "Now fix them"
+codework run --server ws://127.0.0.1:7433/rpc --sandbox-id <sandbox-id> "Start another session in this sandbox"
+```
+
+The default address is `127.0.0.1:7433`; `--port 0` picks an available port and prints the actual URL. Set `--home`, `--database`, and `--user-config-dir` on the server. Model credentials, plugins, and working directories are resolved by the server. A remote run does not boot a local harness.
+
+Events are live and not replayed. The client subscribes before admitting its prompt and waits for execution completion after rendering. Lost connections and overflow fail the command; disconnecting leaves server work running. Ctrl-C sends `session.interrupt`, which interrupts the shared session. Remote runs print the sandbox ID for reuse. `session.interrupt` returns `{ interrupted }` as soon as the stop is accepted; `session.wait` is the separate cleanup barrier. A busy period reports itself as `session.execution.started` followed by exactly one of `succeeded`, `failed`, or `interrupted` -- a failure carries a namespaced category (`provider.auth`, `model.not-found`, `sandbox.mount`, ...) that the client renders, and an interruption carries whether it was the user or a server shutdown. Managed sandboxes remain available until explicitly stopped or server shutdown; external sandboxes are not stopped.
+
+The v0 endpoint has no authentication; its default binding is loopback. Plugins publish their own event types by declaring them (`Plugin.define({ events: [...] })`, namespaced `plugin.<plugin-id>.*`); the feed carries those and skips types nothing declared. Invalid payloads for declared types fail with a typed encoding error.
+
+---
+
+### `codework models`
+
+List catalog models as `provider/model`, one per line.
+
+```bash
+# List all models across all providers
+codework models
+
+# List models for a specific provider
+codework models --provider openai
+
+# List all supported provider IDs
+codework models providers
+```
+
+---
+
+### `codework models generate`
+
+Generate or update the `models.gen.json` catalog from model registries.
+
+```bash
+# Generate to CODEWORK_MODELS_FILE or ./models.gen.json
+codework models generate
+
+# Generate into a specific directory (resolves to ./models.gen.json)
+codework models generate .
+
+# Generate to an explicit file path
+codework models generate ./path/to/custom-models.json
+```
+
+---
+
+## Environment Variables
+
+| Variable                       | Description                                          |
+| :----------------------------- | :--------------------------------------------------- |
+| `CODEWORK_MODELS_FILE`         | Path to the generated `models.gen.json` catalog file |
+| `OPENAI_API_KEY`               | API key for OpenAI models                            |
+| `ANTHROPIC_API_KEY`            | API key for Anthropic models                         |
+| `OPENROUTER_API_KEY`           | API key for OpenRouter models                        |
+| `GOOGLE_GENERATIVE_AI_API_KEY` | API key for Google models                            |
+| `XAI_API_KEY`                  | API key for xAI models                               |
+
+---
+
+## License
+
+MIT

package/catalog-DobwC9tt.mjs

@@ -0,0 +1,31 @@
+import { M as ModelCatalogError } from "./error-Cr8LvfEq.mjs";
+import { Effect } from "effect";
+import { Model } from "@codeworksh/aikit";
+//#region src/cli/cmd/handlers/models/catalog.ts
+const catalogError = (cause) => {
+	if (typeof cause === "object" && cause !== null && "name" in cause && cause.name === "ModelCatalogLoadError" && "data" in cause && typeof cause.data === "object" && cause.data !== null) {
+		const data = cause.data;
+		if ("path" in data && typeof data.path === "string" && "message" in data && typeof data.message === "string" && "reason" in data && (data.reason === "missing" || data.reason === "unreadable" || data.reason === "empty" || data.reason === "invalid")) return new ModelCatalogError({
+			path: data.path,
+			reason: data.reason,
+			detail: data.message
+		});
+	}
+	return new ModelCatalogError({
+		path: "",
+		reason: "unreadable",
+		detail: cause instanceof Error ? cause.message : "failed to load the model catalog"
+	});
+};
+const loadCatalog = Effect.tryPromise({
+	try: () => Model.getBuiltInModels(),
+	catch: catalogError
+});
+const loadProviders = Effect.tryPromise({
+	try: () => Model.getProviders(),
+	catch: catalogError
+});
+//#endregion
+export { loadProviders as n, loadCatalog as t };
+
+//# sourceMappingURL=catalog-DobwC9tt.mjs.map

package/catalog-DobwC9tt.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-DobwC9tt.mjs","names":["Runner.ModelCatalogError"],"sources":["../../src/cli/cmd/handlers/models/catalog.ts"],"sourcesContent":["import { Model } from \"@codeworksh/aikit\";\nimport { Runner } from \"@codeworksh/harness/effect\";\nimport { Effect } from \"effect\";\n\nconst catalogError = (cause: unknown): Runner.ModelCatalogError => {\n\tif (\n\t\ttypeof cause === \"object\" &&\n\t\tcause !== null &&\n\t\t\"name\" in cause &&\n\t\tcause.name === \"ModelCatalogLoadError\" &&\n\t\t\"data\" in cause &&\n\t\ttypeof cause.data === \"object\" &&\n\t\tcause.data !== null\n\t) {\n\t\tconst data = cause.data;\n\t\tif (\n\t\t\t\"path\" in data &&\n\t\t\ttypeof data.path === \"string\" &&\n\t\t\t\"message\" in data &&\n\t\t\ttypeof data.message === \"string\" &&\n\t\t\t\"reason\" in data &&\n\t\t\t(data.reason === \"missing\" ||\n\t\t\t\tdata.reason === \"unreadable\" ||\n\t\t\t\tdata.reason === \"empty\" ||\n\t\t\t\tdata.reason === \"invalid\")\n\t\t) {\n\t\t\treturn new Runner.ModelCatalogError({\n\t\t\t\tpath: data.path,\n\t\t\t\treason: data.reason,\n\t\t\t\tdetail: data.message,\n\t\t\t});\n\t\t}\n\t}\n\treturn new Runner.ModelCatalogError({\n\t\tpath: \"\",\n\t\treason: \"unreadable\",\n\t\tdetail: cause instanceof Error ? cause.message : \"failed to load the model catalog\",\n\t});\n};\n\nexport const loadCatalog = Effect.tryPromise({\n\ttry: () => Model.getBuiltInModels(),\n\tcatch: catalogError,\n});\n\nexport const loadProviders = Effect.tryPromise({\n\ttry: () => Model.getProviders(),\n\tcatch: catalogError,\n});\n"],"mappings":";;;;AAIA,MAAM,gBAAgB,UAA6C;CAClE,IACC,OAAO,UAAU,YACjB,UAAU,QACV,UAAU,SACV,MAAM,SAAS,2BACf,UAAU,SACV,OAAO,MAAM,SAAS,YACtB,MAAM,SAAS,MACd;EACD,MAAM,OAAO,MAAM;EACnB,IACC,UAAU,QACV,OAAO,KAAK,SAAS,YACrB,aAAa,QACb,OAAO,KAAK,YAAY,YACxB,YAAY,SACX,KAAK,WAAW,aAChB,KAAK,WAAW,gBAChB,KAAK,WAAW,WAChB,KAAK,WAAW,YAEjB,OAAO,IAAIA,kBAAyB;GACnC,MAAM,KAAK;GACX,QAAQ,KAAK;GACb,QAAQ,KAAK;EACd,CAAC;CAEH;CACA,OAAO,IAAIA,kBAAyB;EACnC,MAAM;EACN,QAAQ;EACR,QAAQ,iBAAiB,QAAQ,MAAM,UAAU;CAClD,CAAC;AACF;AAEA,MAAa,cAAc,OAAO,WAAW;CAC5C,WAAW,MAAM,iBAAiB;CAClC,OAAO;AACR,CAAC;AAED,MAAa,gBAAgB,OAAO,WAAW;CAC9C,WAAW,MAAM,aAAa;CAC9B,OAAO;AACR,CAAC"}