agent-finance-cli 0.1.0

package/Cargo.toml

@@ -0,0 +1,31 @@
+[package]
+name = "agent-finance-cli"
+version = "0.1.0"
+edition = "2024"
+license = "MIT OR Apache-2.0"
+repository = "https://github.com/M4n5ter/agent-finance-cli"
+description = "AI Agent-first CLI for no-key financial market data and research context."
+
+[[bin]]
+name = "agent-finance"
+path = "src/main.rs"
+
+[dependencies]
+anyhow = "1.0.102"
+base64 = "0.22.1"
+chrono = "0.4.45"
+chrono-tz = "0.10.4"
+clap = { version = "4.6.1", features = ["derive"] }
+csv = "1.4.0"
+futures-util = "0.3.32"
+prost = "0.14.4"
+rustls = { version = "0.23.40", default-features = false, features = ["ring", "std", "tls12"] }
+serde = { version = "1.0.228", features = ["derive"] }
+serde_json = "1.0.150"
+tokio-tungstenite = { version = "0.29.0", features = ["rustls-tls-webpki-roots"] }
+tokio = { version = "1.52.3", features = ["macros", "rt-multi-thread"] }
+url = "2.5.8"
+zip = { version = "8.6.0", default-features = false, features = ["deflate"] }
+scraper = "0.27.0"
+wreq = { version = "6.0.0-rc.29", default-features = false, features = ["cookies", "deflate", "gzip", "json", "socks", "system-proxy", "tokio-rt", "webpki-roots"] }
+wreq-util = "3.0.0-rc.12"

package/LICENSE-APACHE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/LICENSE-MIT

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 M4n5ter
+
+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,119 @@
+# agent-finance-cli
+
+AI Agent-first CLI for no-key financial market data and research context.
+
+`agent-finance` is designed for human-operated AI agents: the CLI can print its own task-specific skills, then provide current quotes, regular/pre/post/overnight session splits, OHLCV history, local indicators, proxy futures data, no-key research payloads, URL text extraction, provider capability notes, polling, and Yahoo WebSocket streams.
+
+If you are an AI Agent, start here:
+
+```bash
+agent-finance skills get core
+agent-finance skills list
+```
+
+## Install
+
+From npm:
+
+```bash
+npm install -g agent-finance-cli
+```
+
+The npm package installs a prebuilt binary for supported platforms. Rust is not required for the normal npm install path.
+
+If no prebuilt package is available for the current platform, npm falls back to a local source build. That fallback requires Rust/Cargo plus the native toolchain needed by `wreq`/BoringSSL: CMake, Clang/Clang++, libclang, and binutils.
+
+From GitHub:
+
+```bash
+cargo install --git https://github.com/M4n5ter/agent-finance-cli
+```
+
+From a checkout:
+
+```bash
+cargo run --bin agent-finance -- skills get core
+cargo run --bin agent-finance -- price CRDO
+```
+
+Future distribution targets include crates.io and Homebrew.
+
+## Common Commands
+
+```bash
+# Current observable price + regular-market basis.
+agent-finance price CRDO
+agent-finance price CRDO MRVL --json
+
+# Precise regular/pre/post/overnight/provider split.
+agent-finance sessions CRDO
+agent-finance sessions LITE --proxy-symbol LITEUSDT
+
+# History, indicators, futures/proxy data, and streams.
+agent-finance history CRDO --range 1mo --interval 1d
+agent-finance history CRDO --range 5d --interval 1m --session extended --adjustment raw --no-actions
+agent-finance indicators CRDO MRVL --limit 120
+agent-finance futures SPCXUSDT
+agent-finance stream CRDO --messages 5
+agent-finance watch CRDO --interval-seconds 15 --iterations 4
+
+# No-key research and discovery.
+agent-finance fundamentals CRDO
+agent-finance fundamentals CRDO --provider sec-edgar
+agent-finance analysis CRDO
+agent-finance options CRDO --provider robinhood --count 80
+agent-finance ownership CRDO
+agent-finance events CRDO --provider sec-edgar
+agent-finance news CRDO
+agent-finance read-url "https://www.sec.gov/Archives/edgar/data/0001807794/000162828026014017/crdo-20260131.htm"
+agent-finance search "optical interconnect"
+agent-finance screen day_gainers
+agent-finance providers
+```
+
+## Agent Skills
+
+The CLI ships Markdown skills so an AI Agent can learn the exact command surface for the installed version:
+
+```bash
+agent-finance skills list
+agent-finance skills get core --full
+agent-finance skills get price
+agent-finance skills get research-data
+agent-finance skills get providers
+agent-finance skills get history-indicators
+agent-finance skills get futures
+```
+
+## Data Source Rules
+
+- `price SYMBOL` is the default answer to "what is it trading at now?" It returns the current observable price, session, regular-market basis, and local/UTC timestamps.
+- `sessions SYMBOL` is for explicit regular/pre/post/overnight/provider comparisons.
+- `history` defaults to adjusted prices and includes corporate actions unless disabled.
+- `providers` is the source-of-truth capability matrix. Do not infer coverage from provider names.
+- Binance futures / TradFi perps are derivative/proxy prices. They are useful for 24h price discovery, but they are not the legal equity, broker fill, or pre-IPO ownership price.
+- `read-url` is an extraction fallback using direct/Jina/Defuddle readers. It is not a login-capable browser.
+- Dynamic, login-gated, screenshot-sensitive, or noisy pages should be verified with a real browser tool. `agent-browser` and `opencli` are examples, not dependencies.
+
+## Network Defaults
+
+`agent-finance` respects explicit and environment proxy configuration:
+
+```bash
+agent-finance --proxy socks5h://127.0.0.1:7890 price CRDO
+agent-finance --no-proxy price CRDO
+```
+
+Proxy precedence:
+
+1. `--proxy`
+2. `AGENT_FINANCE_PROXY`
+3. `ALL_PROXY`
+4. `HTTPS_PROXY`
+5. `HTTP_PROXY`
+
+No proxy is hardcoded by default.
+
+SEC EDGAR requests use `AGENT_FINANCE_SEC_USER_AGENT` when set, otherwise a project-level user agent.
+
+Disclaimer: this tool is not investment advice; data may be delayed, incomplete, or wrong, and users must verify important facts and follow source terms.

package/bin/agent-finance.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+
+const { spawnSync } = require("node:child_process");
+
+const { resolveBinary } = require("../npm/resolve-binary");
+
+const binary = resolveBinary();
+
+if (!binary) {
+  console.error(
+    "agent-finance binary was not found. Reinstall agent-finance-cli, or install Rust/Cargo so the npm fallback build can run.",
+  );
+  process.exit(127);
+}
+
+const result = spawnSync(binary, process.argv.slice(2), { stdio: "inherit" });
+
+if (result.error) {
+  console.error(result.error.message);
+  process.exit(1);
+}
+
+if (result.signal) {
+  process.kill(process.pid, result.signal);
+}
+
+process.exit(result.status ?? 1);

package/npm/check-binary-links.js

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+
+const fs = require("node:fs");
+const path = require("node:path");
+const { spawnSync } = require("node:child_process");
+
+const binary = path.resolve(process.argv[2] || "");
+if (!binary || !fs.existsSync(binary)) {
+  fail(`binary does not exist: ${binary || "<missing>"}`);
+}
+
+const platform = process.platform;
+
+if (platform === "linux") {
+  run("file", [binary]);
+  run("ldd", [binary]);
+  run("readelf", ["-d", binary]);
+} else if (platform === "darwin") {
+  run("file", [binary]);
+  run("otool", ["-L", binary]);
+} else if (platform === "win32") {
+  run(binary, ["--help"]);
+  const dumpbin = spawnSync("where", ["dumpbin"], { encoding: "utf8" });
+  if (dumpbin.status === 0) {
+    run("dumpbin", ["/DEPENDENTS", binary]);
+  } else {
+    console.log("dumpbin is unavailable; executable smoke test completed");
+  }
+} else {
+  run(binary, ["--help"]);
+  console.log(`no platform-specific dynamic-link checker for ${platform}`);
+}
+
+function run(command, args) {
+  const result = spawnSync(command, args, { encoding: "utf8" });
+  if (result.stdout) {
+    process.stdout.write(result.stdout);
+  }
+  if (result.stderr) {
+    process.stderr.write(result.stderr);
+  }
+  if (result.status !== 0) {
+    fail(`${command} ${args.join(" ")} failed with status ${result.status}`);
+  }
+}
+
+function fail(message) {
+  console.error(message);
+  process.exit(1);
+}

package/npm/check-package.js

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+
+const fs = require("node:fs");
+const path = require("node:path");
+
+const { PACKAGES } = require("./platform");
+
+const root = path.resolve(__dirname, "..");
+const packageJson = JSON.parse(fs.readFileSync(path.join(root, "package.json"), "utf8"));
+const optional = packageJson.optionalDependencies || {};
+const expectedPackages = Object.values(PACKAGES).sort();
+const optionalPackages = Object.keys(optional).sort();
+
+assertArrayEquals(optionalPackages, expectedPackages, "optionalDependencies must match platform map");
+
+for (const packageName of expectedPackages) {
+  if (optional[packageName] !== packageJson.version) {
+    fail(`${packageName} version must match root package version ${packageJson.version}`);
+  }
+}
+
+for (const file of ["bin/", "npm/", "src/", "skills/", "Cargo.toml", "Cargo.lock"]) {
+  if (!packageJson.files.includes(file)) {
+    fail(`package.json files must include ${file}`);
+  }
+}
+
+console.log("npm package metadata is consistent");
+
+function assertArrayEquals(actual, expected, message) {
+  if (actual.length !== expected.length || actual.some((value, index) => value !== expected[index])) {
+    fail(`${message}\nactual: ${JSON.stringify(actual)}\nexpected: ${JSON.stringify(expected)}`);
+  }
+}
+
+function fail(message) {
+  console.error(message);
+  process.exit(1);
+}

package/npm/create-platform-package.js

@@ -0,0 +1,90 @@
+#!/usr/bin/env node
+
+const fs = require("node:fs");
+const path = require("node:path");
+
+const { executableName } = require("./platform");
+
+const options = parseArgs(process.argv.slice(2));
+const root = path.resolve(__dirname, "..");
+const rootPackage = readJson(path.join(root, "package.json"));
+const packageName = required(options, "package");
+const os = required(options, "os");
+const cpu = required(options, "cpu");
+const binary = path.resolve(required(options, "binary"));
+const outDir = path.resolve(required(options, "out"));
+
+if (!fs.existsSync(binary)) {
+  fail(`binary does not exist: ${binary}`);
+}
+
+fs.rmSync(outDir, { recursive: true, force: true });
+fs.mkdirSync(path.join(outDir, "bin"), { recursive: true });
+
+const targetBinary = path.join(outDir, "bin", executableName(os));
+fs.copyFileSync(binary, targetBinary);
+fs.chmodSync(targetBinary, 0o755);
+
+for (const file of ["LICENSE-MIT", "LICENSE-APACHE"]) {
+  fs.copyFileSync(path.join(root, file), path.join(outDir, file));
+}
+
+fs.writeFileSync(
+  path.join(outDir, "README.md"),
+  `# ${packageName}\n\nPrebuilt ${os}/${cpu} binary package for \`agent-finance-cli\`.\n\nInstall the main package instead:\n\n\`\`\`bash\nnpm install -g agent-finance-cli\n\`\`\`\n`,
+);
+
+writeJson(path.join(outDir, "package.json"), {
+  name: packageName,
+  version: rootPackage.version,
+  description: `Prebuilt ${os}/${cpu} binary for agent-finance-cli.`,
+  license: rootPackage.license,
+  repository: rootPackage.repository,
+  homepage: rootPackage.homepage,
+  bugs: rootPackage.bugs,
+  os: [os],
+  cpu: [cpu],
+  bin: {
+    "agent-finance": `bin/${executableName(os)}`,
+  },
+  files: ["bin/", "README.md", "LICENSE-MIT", "LICENSE-APACHE"],
+  publishConfig: {
+    access: "public",
+  },
+});
+
+console.log(`created ${packageName} in ${outDir}`);
+
+function parseArgs(args) {
+  const parsed = {};
+  for (let index = 0; index < args.length; index += 2) {
+    const key = args[index];
+    const value = args[index + 1];
+    if (!key?.startsWith("--") || value === undefined) {
+      fail(`invalid arguments: ${args.join(" ")}`);
+    }
+    parsed[key.slice(2)] = value;
+  }
+  return parsed;
+}
+
+function required(options, name) {
+  const value = options[name];
+  if (!value) {
+    fail(`missing --${name}`);
+  }
+  return value;
+}
+
+function readJson(file) {
+  return JSON.parse(fs.readFileSync(file, "utf8"));
+}
+
+function writeJson(file, value) {
+  fs.writeFileSync(file, `${JSON.stringify(value, null, 2)}\n`);
+}
+
+function fail(message) {
+  console.error(message);
+  process.exit(1);
+}

package/npm/platform.js

@@ -0,0 +1,33 @@
+const path = require("node:path");
+
+const PACKAGES = {
+  "darwin-arm64": "agent-finance-cli-darwin-arm64",
+  "darwin-x64": "agent-finance-cli-darwin-x64",
+  "linux-arm64": "agent-finance-cli-linux-arm64",
+  "linux-x64": "agent-finance-cli-linux-x64",
+  "win32-x64": "agent-finance-cli-win32-x64",
+};
+
+function platformKey(platform = process.platform, arch = process.arch) {
+  return `${platform}-${arch}`;
+}
+
+function platformPackageName(platform = process.platform, arch = process.arch) {
+  return PACKAGES[platformKey(platform, arch)];
+}
+
+function executableName(platform = process.platform) {
+  return platform === "win32" ? "agent-finance.exe" : "agent-finance";
+}
+
+function localBuildBinary(root, platform = process.platform) {
+  return path.join(root, "target", "release", executableName(platform));
+}
+
+module.exports = {
+  PACKAGES,
+  executableName,
+  localBuildBinary,
+  platformKey,
+  platformPackageName,
+};

package/npm/postinstall.js

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+
+const { spawnSync } = require("node:child_process");
+const path = require("node:path");
+
+const { localBuildBinary, platformKey, platformPackageName } = require("./platform");
+const { resolveBinary } = require("./resolve-binary");
+
+const root = path.resolve(__dirname, "..");
+
+if (resolveBinary({ silent: true })) {
+  process.exit(0);
+}
+
+const packageName = platformPackageName();
+if (!packageName) {
+  console.error(`agent-finance-cli does not publish a prebuilt binary for ${platformKey()}.`);
+} else {
+  console.error(`Prebuilt package ${packageName} was not installed.`);
+}
+console.error("Falling back to local Rust build.");
+console.error(
+  "Local builds require Rust/Cargo plus a native toolchain for wreq/BoringSSL, including CMake, Clang/Clang++, libclang, and binutils.",
+);
+
+const env = {
+  ...process.env,
+  CC: process.env.CC || "clang",
+  CXX: process.env.CXX || "clang++",
+};
+
+const result = spawnSync("cargo", ["build", "--release", "--locked"], {
+  cwd: root,
+  env,
+  stdio: "inherit",
+});
+
+if (result.error) {
+  if (result.error.code === "ENOENT") {
+    console.error("agent-finance-cli requires Rust/Cargo to build during npm install.");
+    console.error("Install Rust from https://rustup.rs/ and then reinstall this package.");
+    console.error("Also install CMake, Clang/Clang++, libclang, and binutils for local fallback builds.");
+    process.exit(127);
+  }
+  console.error(result.error.message);
+  process.exit(1);
+}
+
+if (result.signal) {
+  process.kill(process.pid, result.signal);
+}
+
+if (result.status !== 0) {
+  process.exit(result.status ?? 1);
+}
+
+if (!resolveBinary({ silent: true }) && !require("node:fs").existsSync(localBuildBinary(root))) {
+  console.error("Cargo build completed but agent-finance binary was not found.");
+  process.exit(1);
+}
+
+process.exit(0);