@secapi/cli 1.0.1 → 1.0.2

package/README.md

@@ -40,6 +40,10 @@ Run `bun run scripts/validate/check_cli_doc_snippets.ts` whenever CLI examples,
 command names, or public Mintlify snippets change; it rewrites
 `ops/docs-health/cli-doc-snippets/latest.json`.
 
+Release order: publish `@secapi/sdk-js@1.0.2` before `@secapi/cli@1.0.2`.
+The CLI package depends on `@secapi/sdk-js@^1.0.2`; validating the CLI against a
+local sibling SDK is not enough until the SDK version is available on npm.
+
 ## Connect an agent
 
 Wire the hosted MCP server into your agent client in one command:
@@ -102,7 +106,7 @@ secapi config profiles
 Two binaries are installed: the preferred `secapi` and the compatibility alias `omni-sec`.
 
 ```bash
-secapi --version   # prints the bare package version, e.g. 1.0.1
+secapi --version   # prints the bare package version, e.g. 1.0.2
 secapi --help      # short task-oriented help for common workflows
 secapi help all    # full command inventory
 secapi examples    # local starter workflows for humans and agents

package/dist/index.js

@@ -24249,7 +24249,7 @@ var APP_ONLY_DATABASE_URL_PARAMS = new Set([
 ]);
 var DEFAULT_BASE_URL = "https://api.secapi.ai";
 var DEFAULT_API_VERSION = "2026-03-19";
-var SDK_VERSION = "1.0.1";
+var SDK_VERSION = "1.0.2";
 var POSTHOG_CAPTURE_HOST = "https://us.i.posthog.com";
 var SAFE_RETRY_METHODS = new Set(["GET", "HEAD", "OPTIONS"]);
 var RETRYABLE_STATUSES = new Set([408, 429, 502, 503, 504]);
@@ -26518,6 +26518,34 @@ function factorResponseParams2() {
     include: getListFlag("--include") ?? getListFlag("--expand")
   };
 }
+function getMacroResponseModeFlag(name = "--response-mode") {
+  const raw = getEnumFlag(name, ["compact", "standard", "verbose", "agent", "default"], "macro response mode");
+  return raw === "default" ? "standard" : raw;
+}
+function getMacroViewResponseModeFlag(name = "--view") {
+  const raw = getUniqueFlag(name);
+  if (raw === undefined)
+    return;
+  const aliases = {
+    agent: "agent",
+    compact: "compact",
+    default: "standard",
+    standard: "standard",
+    verbose: "verbose"
+  };
+  const normalized = raw.trim().toLowerCase();
+  const mapped = aliases[normalized];
+  if (mapped)
+    return mapped;
+  throw new Error(`${name} must be one of: default, agent, compact, standard, verbose (macro response view)`);
+}
+function macroResponseParams() {
+  const include = getListFlag("--include") ?? getListFlag("--expand");
+  return {
+    response_mode: getMacroResponseModeFlag("--response-mode") ?? getMacroViewResponseModeFlag("--view"),
+    include: include?.join(",")
+  };
+}
 function factorKeySelectionParams() {
   return {
     keys: getListFlag("--keys") ?? getListFlag("--factors"),
@@ -26984,10 +27012,40 @@ var COMMAND_HELP = {
     examples: ["secapi macro search --q inflation --country US --limit 10"]
   },
   "macro indicators": {
-    usage: "secapi macro indicators --indicator <key> [--country <country>]",
+    usage: "secapi macro indicators --indicator <key> [--country <country>] [--response-mode compact|standard|verbose|agent]",
     summary: "Fetch macro observations for one country and indicator key.",
-    flags: ["--indicator <key>", "--indicator-key <key>", "--country <country>", "--limit <n>"],
-    examples: ["secapi macro indicators --country US --indicator CPIAUCSL --limit 12"]
+    flags: ["--indicator <key>", "--indicator-key <key>", "--country <country>", "--limit <n>", "--response-mode <mode>", "--view <mode>", "--include <fields>", "--expand <fields>"],
+    examples: ["secapi macro indicators --country US --indicator CPIAUCSL --limit 12 --response-mode compact"]
+  },
+  "macro high-signal-pack": {
+    usage: "secapi macro high-signal-pack [--country <country>] [--response-mode compact|standard|verbose|agent]",
+    summary: "Fetch the compact high-signal macro pack for a country, with expansion controls for full series and trust metadata.",
+    flags: ["--country <country>", "--response-mode <mode>", "--view <mode>", "--include <fields>", "--expand <fields>"],
+    examples: ["secapi macro high-signal-pack --country US", "secapi macro high-signal-pack --country US --response-mode standard --include series,trust"]
+  },
+  "macro releases": {
+    usage: "secapi macro releases [--country <country>] [--status released|scheduled] [--limit <n>]",
+    summary: "Fetch released macro history by default, or upcoming scheduled events with --status scheduled.",
+    flags: ["--country <country>", "--indicator <key>", "--indicator-key <key>", "--status <released|scheduled>", "--days <n>", "--limit <n>", "--response-mode <mode>", "--view <mode>", "--include <fields>", "--expand <fields>"],
+    examples: ["secapi macro releases --country US --status released --limit 10", "secapi macro releases --country US --status scheduled --days 45 --response-mode compact"]
+  },
+  "macro calendar": {
+    usage: "secapi macro calendar [--country <country>] [--days <n>] [--limit <n>]",
+    summary: "Fetch upcoming scheduled macro releases only.",
+    flags: ["--country <country>", "--indicator <key>", "--indicator-key <key>", "--days <n>", "--limit <n>", "--response-mode <mode>", "--view <mode>", "--include <fields>", "--expand <fields>"],
+    examples: ["secapi macro calendar --country US --days 30 --limit 12 --response-mode compact"]
+  },
+  "macro forecasts": {
+    usage: "secapi macro forecasts [--country <country>] [--indicator <key>] [--horizons <n>]",
+    summary: "Fetch compact baseline macro forecasts; country-wide calls default to compact at the API.",
+    flags: ["--country <country>", "--indicator <key>", "--indicator-key <key>", "--horizons <n>", "--response-mode <mode>", "--view <mode>", "--include <fields>", "--expand <fields>"],
+    examples: ["secapi macro forecasts --country US --horizons 2 --response-mode compact"]
+  },
+  "macro regimes": {
+    usage: "secapi macro regimes [--country <country>] [--lookback <window>]",
+    summary: "Fetch the current macro regime classification as a list envelope.",
+    flags: ["--country <country>", "--lookback <window>", "--response-mode <mode>", "--view <mode>", "--include <fields>", "--expand <fields>"],
+    examples: ["secapi macro regimes --country US --lookback 18m --response-mode compact"]
   },
   "macro credit-ratings": {
     usage: "secapi macro credit-ratings [--country <country>]",
@@ -27686,7 +27744,12 @@ var AGENT_CONTEXT_COMMAND_OVERRIDES = {
   "intelligence security": { requiredFlags: ["--ticker|--cik"], examples: ["secapi intelligence security --ticker AAPL --view compact"] },
   "limits show": { output: "human_or_json", examples: ["secapi limits show", "secapi limits show --json=false"] },
   "macro search": { requiredFlags: ["--q|--query"], examples: ["secapi macro search --q inflation --country US"] },
-  "macro indicators": { requiredFlags: ["--indicator|--indicator-key"], examples: ["secapi macro indicators --country US --indicator CPIAUCSL"] },
+  "macro indicators": { requiredFlags: ["--indicator|--indicator-key"], examples: ["secapi macro indicators --country US --indicator CPIAUCSL --response-mode compact"] },
+  "macro high-signal-pack": { examples: ["secapi macro high-signal-pack --country US", "secapi macro high-signal-pack --country US --response-mode standard --include series,trust"] },
+  "macro releases": { examples: ["secapi macro releases --country US --status released --limit 10"] },
+  "macro calendar": { examples: ["secapi macro calendar --country US --days 30 --limit 12 --response-mode compact"] },
+  "macro forecasts": { examples: ["secapi macro forecasts --country US --horizons 2 --response-mode compact"] },
+  "macro regimes": { examples: ["secapi macro regimes --country US --lookback 18m --response-mode compact"] },
   "macro credit-ratings": { examples: ["secapi macro credit-ratings --country US"] },
   "macro credit-rating": { requiredFlags: ["--country"], examples: ["secapi macro credit-rating --country US"] },
   me: { output: "human_or_json", examples: ["secapi me", "secapi me --json=false"] },
@@ -28848,14 +28911,16 @@ Run 'secapi ${implementedCommandKey} --help' for supported options.`);
   }
   if (group === "macro" && command === "high-signal-pack") {
     print(await apiClient.macroHighSignalPack({
-      country: getFlag("--country")
+      country: getFlag("--country"),
+      ...macroResponseParams()
     }));
     return;
   }
   if (group === "macro" && command === "regimes") {
     print(await apiClient.macroRegimes({
       country: getFlag("--country"),
-      lookback: getFlag("--lookback")
+      lookback: getFlag("--lookback"),
+      ...macroResponseParams()
     }));
     return;
   }
@@ -28866,7 +28931,8 @@ Run 'secapi ${implementedCommandKey} --help' for supported options.`);
     print(await apiClient.macroIndicators({
       country: getFlag("--country") ?? "US",
       indicator_key: indicatorKey,
-      limit: getNumberFlag("--limit")
+      limit: getNumberFlag("--limit"),
+      ...macroResponseParams()
     }));
     return;
   }
@@ -28874,14 +28940,20 @@ Run 'secapi ${implementedCommandKey} --help' for supported options.`);
     print(await apiClient.macroReleases({
       country: getFlag("--country"),
       indicator_key: getFlag("--indicator") ?? getFlag("--indicator-key"),
-      limit: getNumberFlag("--limit")
+      status: getEnumFlag("--status", ["released", "scheduled"], "macro release status"),
+      days: getNumberFlag("--days"),
+      limit: getNumberFlag("--limit"),
+      ...macroResponseParams()
     }));
     return;
   }
   if (group === "macro" && command === "calendar") {
     print(await apiClient.macroCalendar({
       country: getFlag("--country"),
-      days: getNumberFlag("--days")
+      indicator_key: getFlag("--indicator") ?? getFlag("--indicator-key"),
+      days: getNumberFlag("--days"),
+      limit: getNumberFlag("--limit"),
+      ...macroResponseParams()
     }));
     return;
   }
@@ -28889,7 +28961,8 @@ Run 'secapi ${implementedCommandKey} --help' for supported options.`);
     print(await apiClient.macroForecasts({
       country: getFlag("--country"),
       indicator_key: getFlag("--indicator") ?? getFlag("--indicator-key"),
-      horizons: getNumberFlag("--horizons")
+      horizons: getNumberFlag("--horizons"),
+      ...macroResponseParams()
     }));
     return;
   }
@@ -29692,10 +29765,10 @@ ${rendered}`);
     "  secapi macro search --q inflation --country US",
     "  secapi macro high-signal-pack --country US",
     "  secapi macro regimes --country US --lookback 18m",
-    "  secapi macro indicators --country US --indicator CPIAUCSL",
-    "  secapi macro releases --country US",
-    "  secapi macro calendar --country US --days 30",
-    "  secapi macro forecasts --country US",
+    "  secapi macro indicators --country US --indicator CPIAUCSL --response-mode compact",
+    "  secapi macro releases --country US --status released",
+    "  secapi macro calendar --country US --days 30 --limit 12 --response-mode compact",
+    "  secapi macro forecasts --country US --response-mode compact",
     "  secapi macro credit-ratings --country US",
     "",
     "  # Factors",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@secapi/cli",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "SEC API CLI for SEC data shaped for investors and agents",
   "type": "module",
   "bin": {
@@ -40,7 +40,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@secapi/sdk-js": "^1.0.1"
+    "@secapi/sdk-js": "^1.0.2"
   },
   "devDependencies": {
     "@types/node": "^24.10.1",