@blade-ai/orca 0.5.16 → 0.5.17-darwin-x64
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 +27 -13
- package/package.json +15 -23
- package/vendor/x86_64-apple-darwin/bin/orca +4 -0
- package/bin/orca.js +0 -131
- package/bin/signals.js +0 -14
package/README.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# Orca
|
|
1
|
+
# Orca Agent
|
|
2
2
|
|
|
3
3
|
[](https://github.com/echoVic/orca-agent/releases/latest)
|
|
4
4
|
[](https://www.npmjs.com/package/@blade-ai/orca)
|
|
@@ -7,18 +7,20 @@
|
|
|
7
7
|
[](https://github.com/echoVic/orca-agent/actions/workflows/windows-ci.yml)
|
|
8
8
|
[](https://github.com/echoVic/orca-agent/stargazers)
|
|
9
9
|
|
|
10
|
-
|
|
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
|
-

|
|
23
|
+

|
|
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
|
|
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`.
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
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
|
|
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
|
-
"
|
|
8
|
-
"orca": "bin/orca.js"
|
|
9
|
-
},
|
|
10
|
-
"type": "module",
|
|
11
|
-
"engines": {
|
|
12
|
-
"node": ">=16"
|
|
13
|
-
},
|
|
3
|
+
"homepage": "https://orcaagent.dev/",
|
|
14
4
|
"files": [
|
|
15
|
-
"
|
|
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
|
-
|
|
11
|
+
"url": "git+https://github.com/echoVic/orca-agent.git"
|
|
12
|
+
},
|
|
13
|
+
"engines": {
|
|
14
|
+
"node": ">=16"
|
|
24
15
|
},
|
|
25
|
-
"
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
"
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
16
|
+
"name": "@blade-ai/orca",
|
|
17
|
+
"version": "0.5.17-darwin-x64",
|
|
18
|
+
"description": "Native Orca binary for darwin/x64.",
|
|
19
|
+
"os": [
|
|
20
|
+
"darwin"
|
|
21
|
+
],
|
|
22
|
+
"cpu": [
|
|
23
|
+
"x64"
|
|
24
|
+
]
|
|
33
25
|
}
|
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
|
-
}
|