@blade-ai/orca 0.5.16 → 0.5.17-darwin-arm64

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,4 +1,4 @@
1
- # Orca
1
+ # Orca Agent
2
2
 
3
3
  [![Latest release](https://img.shields.io/github/v/release/echoVic/orca-agent)](https://github.com/echoVic/orca-agent/releases/latest)
4
4
  [![npm](https://img.shields.io/npm/v/@blade-ai/orca)](https://www.npmjs.com/package/@blade-ai/orca)
@@ -7,18 +7,20 @@
7
7
  [![Windows CI](https://img.shields.io/github/actions/workflow/status/echoVic/orca-agent/windows-ci.yml?branch=main&label=windows)](https://github.com/echoVic/orca-agent/actions/workflows/windows-ci.yml)
8
8
  [![GitHub stars](https://img.shields.io/github/stars/echoVic/orca-agent)](https://github.com/echoVic/orca-agent/stargazers)
9
9
 
10
- A DeepSeek-native coding agent for your terminal.
10
+ Orca Agent is a DeepSeek-native coding agent for your terminal.
11
11
 
12
- Give Orca a task and it reads code, edits files, runs commands, verifies the
12
+ Give Orca Agent a task and it reads code, edits files, runs commands, verifies the
13
13
  result, and keeps working until the task is done or it needs you. Use the TUI
14
14
  for interactive work or `orca exec` for scripts and CI. Orca is built in Rust,
15
15
  runs locally, and is MIT licensed.
16
16
 
17
17
  [English](README.md) · [简体中文](README.zh-CN.md) · [日本語](README.ja-JP.md) · [Tiếng Việt](README.vi.md) · [한국어](README.ko-KR.md) · [Español](README.es-419.md) · [Português](README.pt-BR.md)
18
18
 
19
+ > **Naming.** Orca Agent is unrelated to other projects named "Orca", including the stablyai/orca desktop agent orchestrator, Plotly's `orca` package, and the GNOME Orca screen reader. This repository is the DeepSeek-native terminal coding agent at [orcaagent.dev](https://orcaagent.dev/).
20
+
19
21
  [Website](https://orcaagent.dev/) · [Changelog](https://orcaagent.dev/changelog/) · [Releases](https://github.com/echoVic/orca-agent/releases/latest) · [npm](https://www.npmjs.com/package/@blade-ai/orca)
20
22
 
21
- ![Orca's first run: trust the workspace, then enter a DeepSeek API key](docs/demo.gif)
23
+ ![Orca Agent's first run: trust the workspace, then enter a DeepSeek API key](docs/demo.gif)
22
24
 
23
25
  ## Install
24
26
 
@@ -66,8 +68,11 @@ re-parsing; legacy string commands use the resolved shell dialect.
66
68
  ```bash
67
69
  export DEEPSEEK_API_KEY=sk-...
68
70
 
69
- orca # open the terminal UI
71
+ orca # open the terminal UI (Full Access by default)
72
+ orca --yolo # start with Full Access (full-auto)
73
+ orca --yolo --continue # resume the latest session with Full Access
70
74
  orca exec "fix the failing test" # run headlessly
75
+ orca exec --yolo "finish the task" # run headlessly with Full Access
71
76
  printf '%s' "$INSTRUCTION" | orca exec # keep arbitrary prompt text out of argv
72
77
  orca exec --verifier "cargo test" "fix it" # verify before finishing
73
78
  orca exec resume SESSION_ID "continue" # resume a headless session
@@ -75,7 +80,9 @@ orca exec resume --last "continue" # resume the most recent session
75
80
  orca exec resume SID --resume-at MID "continue" # resume up to a message boundary
76
81
  orca --resume [SESSION_ID] # resume a saved conversation
77
82
  orca --fork SESSION_ID # fork a saved conversation
78
- orca --mode=acp # connect an ACP client
83
+ orca acp # connect an ACP client
84
+ orca app-server # serve the JSON-RPC app protocol
85
+ orca --plan exec --json -C ./project "inspect it" # read-only JSONL run
79
86
  orca doctor # check the key, trust, and sandbox locally
80
87
  ```
81
88
 
@@ -97,6 +104,11 @@ continue untrusted: trust lets Orca load the project's configuration,
97
104
  instructions, skills, agents, and workflows, and never enables or bypasses the
98
105
  OS sandbox. Then type a task and press `Enter`.
99
106
 
107
+ New TUI sessions default to Full Access (`full-auto`, also called yolo) when no
108
+ mode is configured. An explicit `--mode`, `ORCA_MODE`, or user config mode takes
109
+ precedence. Resuming keeps the conversation’s saved mode; use `--yolo` to force
110
+ Full Access on resume. Headless `exec` and shared daemons default to `auto-edit`.
111
+
100
112
  - **Mention and command.** `@` mentions files, skills, plugins, and MCP
101
113
  resources; `$` inserts a skill; `/` opens the command menu; `?` lists every
102
114
  key. `Ctrl+V` attaches a clipboard image.
@@ -115,11 +127,13 @@ OS sandbox. Then type a task and press `Enter`.
115
127
  stops the whole turn instead. On a window panel, press `4` to keep the
116
128
  window and let Orca continue. An MCP tool can also be always
117
129
  allowed, alone or with its whole server, as a rule saved to your config. `Shift+Tab` cycles
118
- `suggest` → `auto-edit` → `full-auto` → `plan`. Entering `full-auto` asks for
119
- an explicit Full Access confirmation; the running task picks it up at its
120
- next tool call, while tools already running and subagents already launched
121
- keep their original policy. Mode changes last for the session and are never
122
- saved.
130
+ `suggest` → `auto-edit` → `full-auto` → `plan`. While waiting for approval,
131
+ `Shift+Tab` opens Full Access confirmation directly. Confirming applies
132
+ `full-auto` without waiting for the turn to finish; answer the original
133
+ pending request once to continue. The next tool call uses the new policy,
134
+ while tools already admitted and subagents already launched keep their
135
+ original policy. Mode changes are recorded in the current conversation and restored on resume;
136
+ they do not change the default mode in your config.
123
137
  - **Background work.** `/tasks` shows the tasks dock under the conversation,
124
138
  where background turns, subagents, commands, monitors, and workflow children
125
139
  appear. `/agents` opens the Agent Workspace with each task's live
@@ -219,8 +233,8 @@ recall, storage, privacy, and deletion.
219
233
  - Exposes stable JSONL, app-server, and Agent Client Protocol (ACP) contracts
220
234
  for editors, harnesses, and CI.
221
235
 
222
- Configuration priority is environment variables, CLI arguments, config files,
223
- then defaults. Run `orca --help` or `orca exec --help` for the full command
236
+ Configuration priority is CLI arguments, environment variables, trusted project
237
+ configuration, user configuration, then defaults. Run `orca --help` or `orca exec --help` for the full command
224
238
  surface. User configuration lives at `~/.orca/config.toml`; trusted projects
225
239
  can also provide `.orca/config.toml`, `AGENTS.md`, rules, skills, and workflows.
226
240
 
package/package.json CHANGED
@@ -1,33 +1,25 @@
1
1
  {
2
- "name": "@blade-ai/orca",
3
- "version": "0.5.16",
4
- "description": "Orca CLI: a DeepSeek-native coding agent.",
5
- "homepage": "https://orcaagent.dev/",
6
2
  "license": "MIT",
7
- "bin": {
8
- "orca": "bin/orca.js"
9
- },
10
- "type": "module",
11
- "engines": {
12
- "node": ">=16"
13
- },
3
+ "homepage": "https://orcaagent.dev/",
14
4
  "files": [
15
- "bin/orca.js",
16
- "bin/signals.js",
5
+ "vendor",
17
6
  "README.md",
18
7
  "LICENSE"
19
8
  ],
20
9
  "repository": {
21
10
  "type": "git",
22
- "url": "git+https://github.com/echoVic/orca-agent.git",
23
- "directory": "npm/orca"
11
+ "url": "git+https://github.com/echoVic/orca-agent.git"
12
+ },
13
+ "engines": {
14
+ "node": ">=16"
24
15
  },
25
- "optionalDependencies": {
26
- "@blade-ai/orca-darwin-arm64": "npm:@blade-ai/orca@0.5.16-darwin-arm64",
27
- "@blade-ai/orca-darwin-x64": "npm:@blade-ai/orca@0.5.16-darwin-x64",
28
- "@blade-ai/orca-linux-arm64": "npm:@blade-ai/orca@0.5.16-linux-arm64",
29
- "@blade-ai/orca-linux-x64": "npm:@blade-ai/orca@0.5.16-linux-x64",
30
- "@blade-ai/orca-win32-arm64": "npm:@blade-ai/orca@0.5.16-win32-arm64",
31
- "@blade-ai/orca-win32-x64": "npm:@blade-ai/orca@0.5.16-win32-x64"
32
- }
16
+ "name": "@blade-ai/orca",
17
+ "version": "0.5.17-darwin-arm64",
18
+ "description": "Native Orca binary for darwin/arm64.",
19
+ "os": [
20
+ "darwin"
21
+ ],
22
+ "cpu": [
23
+ "arm64"
24
+ ]
33
25
  }
@@ -0,0 +1,4 @@
1
+ [diffend] Oversized file quarantined before diffing.
2
+ name: package/vendor/aarch64-apple-darwin/bin/orca
3
+ size: 68896784 bytes
4
+ sha256: 295ed4373c621cdd4c3443aef021e4fe37cf53f1a44ea27b5506892c5369bda0
package/bin/orca.js DELETED
@@ -1,131 +0,0 @@
1
- #!/usr/bin/env node
2
-
3
- import { spawn } from "node:child_process";
4
- import { existsSync, realpathSync } from "node:fs";
5
- import { createRequire } from "node:module";
6
- import path from "node:path";
7
- import { fileURLToPath, pathToFileURL } from "node:url";
8
-
9
- const __filename = fileURLToPath(import.meta.url);
10
- const __dirname = path.dirname(__filename);
11
- const require = createRequire(import.meta.url);
12
-
13
- // Run through npm's `.bin` link with `node --preserve-symlinks-main`, as the
14
- // release smoke runs it, this module's own URL is the link's: a module beside
15
- // it is found from the real file's directory, not the link's.
16
- const { signalDispositions } = await import(
17
- pathToFileURL(path.join(path.dirname(realpathSync(__filename)), "signals.js")).href
18
- );
19
-
20
- const TARGETS = {
21
- "darwin:arm64": {
22
- packageName: "@blade-ai/orca-darwin-arm64",
23
- targetTriple: "aarch64-apple-darwin",
24
- binaryName: "orca"
25
- },
26
- "darwin:x64": {
27
- packageName: "@blade-ai/orca-darwin-x64",
28
- targetTriple: "x86_64-apple-darwin",
29
- binaryName: "orca"
30
- },
31
- "linux:arm64": {
32
- packageName: "@blade-ai/orca-linux-arm64",
33
- targetTriple: "aarch64-unknown-linux-gnu",
34
- binaryName: "orca"
35
- },
36
- "linux:x64": {
37
- packageName: "@blade-ai/orca-linux-x64",
38
- targetTriple: "x86_64-unknown-linux-gnu",
39
- binaryName: "orca"
40
- },
41
- "win32:arm64": {
42
- packageName: "@blade-ai/orca-win32-arm64",
43
- targetTriple: "aarch64-pc-windows-msvc",
44
- binaryName: "orca.exe"
45
- },
46
- "win32:x64": {
47
- packageName: "@blade-ai/orca-win32-x64",
48
- targetTriple: "x86_64-pc-windows-msvc",
49
- binaryName: "orca.exe"
50
- }
51
- };
52
-
53
- const target = TARGETS[`${process.platform}:${process.arch}`];
54
- if (!target) {
55
- throw new Error(`Unsupported platform: ${process.platform} (${process.arch})`);
56
- }
57
-
58
- function findExecutable() {
59
- let vendorRoot;
60
- try {
61
- const packageJsonPath = require.resolve(`${target.packageName}/package.json`);
62
- vendorRoot = path.join(path.dirname(packageJsonPath), "vendor");
63
- } catch {
64
- vendorRoot = path.join(__dirname, "..", "vendor");
65
- }
66
-
67
- const executable = path.join(vendorRoot, target.targetTriple, "bin", target.binaryName);
68
- if (existsSync(executable)) {
69
- return executable;
70
- }
71
-
72
- throw new Error(
73
- `Missing optional dependency ${target.packageName}. Reinstall with: npm install -g @blade-ai/orca`
74
- );
75
- }
76
-
77
- const binaryPath = findExecutable();
78
- const env = {
79
- ...process.env,
80
- ORCA_MANAGED_BY_NPM: "1",
81
- ORCA_MANAGED_PACKAGE_ROOT: realpathSync(path.join(__dirname, "..")),
82
- ORCA_NODE_PATH: process.env.ORCA_NODE_PATH || process.execPath
83
- };
84
-
85
- // Register before spawn: a fast child can announce readiness while spawn is
86
- // still returning. SIGINT must never take Node's default exit path in that gap.
87
- let child;
88
- const pendingSignals = new Set();
89
- const dispositions = signalDispositions(process.platform);
90
- const handledSignals = Object.keys(dispositions);
91
- const forwardSignal = (signal) => {
92
- if (!child) {
93
- pendingSignals.add(signal);
94
- } else if (!child.killed) {
95
- child.kill(signal);
96
- }
97
- };
98
-
99
- for (const signal of handledSignals) {
100
- process.on(signal, dispositions[signal] === "forward" ? () => forwardSignal(signal) : () => {});
101
- }
102
-
103
- child = spawn(binaryPath, process.argv.slice(2), {
104
- stdio: "inherit",
105
- env
106
- });
107
- child.on("error", (error) => {
108
- console.error(error);
109
- process.exit(1);
110
- });
111
- for (const signal of pendingSignals) forwardSignal(signal);
112
- pendingSignals.clear();
113
-
114
- const result = await new Promise((resolve) => {
115
- child.on("exit", (code, signal) => {
116
- if (signal) {
117
- resolve({ type: "signal", signal });
118
- } else {
119
- resolve({ type: "code", exitCode: code ?? 1 });
120
- }
121
- });
122
- });
123
-
124
- if (result.type === "signal") {
125
- for (const signal of handledSignals) {
126
- process.removeAllListeners(signal);
127
- }
128
- process.kill(process.pid, result.signal);
129
- } else {
130
- process.exit(result.exitCode);
131
- }
package/bin/signals.js DELETED
@@ -1,14 +0,0 @@
1
- // What the launcher does with each signal it takes over while the native
2
- // binary runs, on `platform` (a `process.platform` value): "forward" passes
3
- // the signal on to the binary, "ignore" only keeps it from ending the launcher.
4
- //
5
- // On Windows child.kill() is TerminateProcess whatever the signal, which would
6
- // end orca.exe before it can stop its run and exit with 130. Ctrl+C is left to
7
- // the console, which delivers it to orca.exe too, as it shares the launcher's
8
- // console; the launcher stays up and exits with orca.exe's code.
9
- export function signalDispositions(platform) {
10
- if (platform === "win32") {
11
- return { SIGINT: "ignore", SIGTERM: "forward" };
12
- }
13
- return { SIGINT: "forward", SIGTERM: "forward", SIGHUP: "forward" };
14
- }