@respan/cli 0.6.7 → 0.6.9

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.
Files changed (4) hide show
  1. package/dist/hooks/gemini-cli.cjs +109 -48
  2. package/dist/hooks/gemini-cli.js +132 -57
  3. package/oclif.manifest.json +678 -678
  4. package/package.json +1 -1
package/oclif.manifest.json CHANGED
@@ -1583,17 +1583,10 @@
1583
1583
  "list.js"
1584
1584
  ]
1585
1585
  },
1586
- "integrate:claude-code": {
1586
+ "logs:create": {
1587
1587
  "aliases": [],
1588
1588
  "args": {},
1589
- "description": "Integrate Respan with Claude Code.\n\nInstalls a Stop hook that reads conversation transcripts and sends\nthem to Respan as structured spans (chat, tool, thinking).\n\nScope:\n --global Install hook script + register in ~/.claude/settings.json\n --local Write credentials + enable flag to .claude/settings.local.json\n (default) Both: install hook globally + enable for current project",
1590
- "examples": [
1591
- "respan integrate claude-code",
1592
- "respan integrate claude-code --global",
1593
- "respan integrate claude-code --local --project-id my-project",
1594
- "respan integrate claude-code --attrs '{\"env\":\"prod\"}'",
1595
- "respan integrate claude-code --dry-run"
1596
- ],
1589
+ "description": "Create a log span",
1597
1590
  "flags": {
1598
1591
  "api-key": {
1599
1592
  "description": "API key (env: RESPAN_API_KEY)",
@@ -1629,80 +1622,101 @@
1629
1622
  "allowNo": false,
1630
1623
  "type": "boolean"
1631
1624
  },
1632
- "local": {
1633
- "description": "Write per-project config (default)",
1634
- "exclusive": [
1635
- "global"
1636
- ],
1637
- "name": "local",
1638
- "allowNo": false,
1639
- "type": "boolean"
1640
- },
1641
- "global": {
1642
- "description": "Write user-level global config",
1643
- "exclusive": [
1644
- "local"
1645
- ],
1646
- "name": "global",
1647
- "allowNo": false,
1648
- "type": "boolean"
1649
- },
1650
- "project-id": {
1651
- "description": "Respan project ID (added to metadata / resource attributes)",
1652
- "env": "RESPAN_PROJECT_ID",
1653
- "name": "project-id",
1625
+ "input": {
1626
+ "description": "Input text or JSON",
1627
+ "name": "input",
1628
+ "required": true,
1654
1629
  "hasDynamicHelp": false,
1655
1630
  "multiple": false,
1656
1631
  "type": "option"
1657
1632
  },
1658
- "base-url": {
1659
- "description": "Respan API base URL (for enterprise deployments)",
1660
- "name": "base-url",
1661
- "default": "https://api.respan.ai/api",
1633
+ "output": {
1634
+ "description": "Output text or JSON",
1635
+ "name": "output",
1662
1636
  "hasDynamicHelp": false,
1663
1637
  "multiple": false,
1664
1638
  "type": "option"
1665
1639
  },
1666
- "attrs": {
1667
- "description": "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
1668
- "name": "attrs",
1669
- "default": "{}",
1640
+ "model": {
1641
+ "description": "Model name",
1642
+ "name": "model",
1670
1643
  "hasDynamicHelp": false,
1671
1644
  "multiple": false,
1672
1645
  "type": "option"
1673
1646
  },
1674
- "customer-id": {
1675
- "description": "Customer/user identifier for traces (e.g. your name or email)",
1676
- "env": "RESPAN_CUSTOMER_ID",
1677
- "name": "customer-id",
1647
+ "metadata": {
1648
+ "description": "Metadata as JSON string",
1649
+ "name": "metadata",
1678
1650
  "hasDynamicHelp": false,
1679
1651
  "multiple": false,
1680
1652
  "type": "option"
1681
- },
1682
- "span-name": {
1683
- "description": "Root span name for traces (default: claude-code)",
1684
- "name": "span-name",
1653
+ }
1654
+ },
1655
+ "hasDynamicHelp": false,
1656
+ "hiddenAliases": [],
1657
+ "id": "logs:create",
1658
+ "pluginAlias": "@respan/cli",
1659
+ "pluginName": "@respan/cli",
1660
+ "pluginType": "core",
1661
+ "strict": true,
1662
+ "enableJsonFlag": false,
1663
+ "isESM": true,
1664
+ "relativePath": [
1665
+ "dist",
1666
+ "commands",
1667
+ "logs",
1668
+ "create.js"
1669
+ ]
1670
+ },
1671
+ "logs:get": {
1672
+ "aliases": [],
1673
+ "args": {
1674
+ "id": {
1675
+ "description": "Span ID",
1676
+ "name": "id",
1677
+ "required": true
1678
+ }
1679
+ },
1680
+ "description": "Get a specific log span",
1681
+ "flags": {
1682
+ "api-key": {
1683
+ "description": "API key (env: RESPAN_API_KEY)",
1684
+ "env": "RESPAN_API_KEY",
1685
+ "name": "api-key",
1685
1686
  "hasDynamicHelp": false,
1686
1687
  "multiple": false,
1687
1688
  "type": "option"
1688
1689
  },
1689
- "workflow-name": {
1690
- "description": "Workflow name for traces (default: claude-code)",
1691
- "name": "workflow-name",
1690
+ "profile": {
1691
+ "description": "Named profile to use",
1692
+ "name": "profile",
1692
1693
  "hasDynamicHelp": false,
1693
1694
  "multiple": false,
1694
1695
  "type": "option"
1695
1696
  },
1696
- "dry-run": {
1697
- "description": "Preview changes without writing files",
1698
- "name": "dry-run",
1697
+ "json": {
1698
+ "description": "Output as JSON",
1699
+ "name": "json",
1700
+ "allowNo": false,
1701
+ "type": "boolean"
1702
+ },
1703
+ "csv": {
1704
+ "description": "Output as CSV",
1705
+ "name": "csv",
1706
+ "allowNo": false,
1707
+ "type": "boolean"
1708
+ },
1709
+ "verbose": {
1710
+ "char": "v",
1711
+ "description": "Show verbose output",
1712
+ "name": "verbose",
1699
1713
  "allowNo": false,
1700
1714
  "type": "boolean"
1701
1715
  }
1702
1716
  },
1703
1717
  "hasDynamicHelp": false,
1704
1718
  "hiddenAliases": [],
1705
- "id": "integrate:claude-code",
1719
+ "id": "logs:get",
1706
1720
  "pluginAlias": "@respan/cli",
1707
1721
  "pluginName": "@respan/cli",
1708
1722
  "pluginType": "core",
@@ -1712,21 +1726,14 @@
1712
1726
  "relativePath": [
1713
1727
  "dist",
1714
1728
  "commands",
1715
- "integrate",
1716
- "claude-code.js"
1729
+ "logs",
1730
+ "get.js"
1717
1731
  ]
1718
1732
  },
1719
- "integrate:codex-cli": {
1733
+ "logs:list": {
1720
1734
  "aliases": [],
1721
1735
  "args": {},
1722
- "description": "Integrate Respan with Codex CLI.\n\nInstalls a notify hook that reads session JSONL files and sends\nthem to Respan as structured spans (chat, tool, reasoning).\n\nScope:\n --global Install hook script + register notify in ~/.codex/config.toml\n --local Write .codex/respan.json with customer_id, span_name, etc.\n (default) Both: install hook globally + config for current project",
1723
- "examples": [
1724
- "respan integrate codex-cli",
1725
- "respan integrate codex-cli --global",
1726
- "respan integrate codex-cli --local --customer-id frank",
1727
- "respan integrate codex-cli --attrs '{\"env\":\"prod\"}'",
1728
- "respan integrate codex-cli --dry-run"
1729
- ],
1736
+ "description": "List and filter LLM request logs (spans).\n\nSupports pagination, sorting, time range, and server-side filtering.\n\nFILTER SYNTAX: field:operator:value\n\nOPERATORS:\n (empty) Exact match model::gpt-4\n not Not equal status_code:not:200\n gt Greater than cost:gt:0.01\n gte Greater than/equal latency:gte:1.0\n lt Less than cost:lt:0.5\n lte Less than/equal prompt_tokens:lte:100\n contains Contains substring error_message:contains:timeout\n icontains Case-insensitive model:icontains:gpt\n startswith Starts with model:startswith:gpt\n endswith Ends with model:endswith:mini\n in Value in list model:in:gpt-4,gpt-4o\n isnull Is null error_message:isnull:true\n iexact Case-insens. exact status:iexact:success\n\nFILTERABLE FIELDS (logs):\n model, status_code, status, cost, latency, prompt_tokens,\n completion_tokens, customer_identifier, custom_identifier,\n thread_identifier, trace_unique_id, span_name, span_workflow_name,\n environment, log_type, error_message, failed, provider_id,\n deployment_name, prompt_name, prompt_id, unique_id, stream,\n temperature, max_tokens, tokens_per_second, time_to_first_token,\n total_request_tokens, metadata__<key>, scores__<evaluator_id>\n\nEXAMPLES:\n --filter model::gpt-4o --filter cost:gt:0.01\n --filter status_code:not:200\n --filter metadata__env::production\n --filter model:in:gpt-4,gpt-4o",
1730
1737
  "flags": {
1731
1738
  "api-key": {
1732
1739
  "description": "API key (env: RESPAN_API_KEY)",
@@ -1762,80 +1769,75 @@
1762
1769
  "allowNo": false,
1763
1770
  "type": "boolean"
1764
1771
  },
1765
- "local": {
1766
- "description": "Write per-project config (default)",
1767
- "exclusive": [
1768
- "global"
1769
- ],
1770
- "name": "local",
1771
- "allowNo": false,
1772
- "type": "boolean"
1773
- },
1774
- "global": {
1775
- "description": "Write user-level global config",
1776
- "exclusive": [
1777
- "local"
1778
- ],
1779
- "name": "global",
1780
- "allowNo": false,
1781
- "type": "boolean"
1772
+ "limit": {
1773
+ "description": "Number of results per page (max 1000)",
1774
+ "name": "limit",
1775
+ "default": 50,
1776
+ "hasDynamicHelp": false,
1777
+ "multiple": false,
1778
+ "type": "option"
1782
1779
  },
1783
- "project-id": {
1784
- "description": "Respan project ID (added to metadata / resource attributes)",
1785
- "env": "RESPAN_PROJECT_ID",
1786
- "name": "project-id",
1780
+ "page": {
1781
+ "description": "Page number",
1782
+ "name": "page",
1783
+ "default": 1,
1787
1784
  "hasDynamicHelp": false,
1788
1785
  "multiple": false,
1789
1786
  "type": "option"
1790
1787
  },
1791
- "base-url": {
1792
- "description": "Respan API base URL (for enterprise deployments)",
1793
- "name": "base-url",
1794
- "default": "https://api.respan.ai/api",
1788
+ "sort-by": {
1789
+ "description": "Sort field (prefix with - for descending, e.g. -cost, -latency)",
1790
+ "name": "sort-by",
1795
1791
  "hasDynamicHelp": false,
1796
1792
  "multiple": false,
1797
1793
  "type": "option"
1798
1794
  },
1799
- "attrs": {
1800
- "description": "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
1801
- "name": "attrs",
1802
- "default": "{}",
1795
+ "start-time": {
1796
+ "description": "Start time filter (ISO 8601)",
1797
+ "name": "start-time",
1803
1798
  "hasDynamicHelp": false,
1804
1799
  "multiple": false,
1805
1800
  "type": "option"
1806
1801
  },
1807
- "customer-id": {
1808
- "description": "Customer/user identifier for traces (e.g. your name or email)",
1809
- "env": "RESPAN_CUSTOMER_ID",
1810
- "name": "customer-id",
1802
+ "end-time": {
1803
+ "description": "End time filter (ISO 8601)",
1804
+ "name": "end-time",
1811
1805
  "hasDynamicHelp": false,
1812
1806
  "multiple": false,
1813
1807
  "type": "option"
1814
1808
  },
1815
- "span-name": {
1816
- "description": "Root span name for traces (default: claude-code)",
1817
- "name": "span-name",
1809
+ "filter": {
1810
+ "description": "Filter in field:operator:value format (repeatable)",
1811
+ "name": "filter",
1812
+ "hasDynamicHelp": false,
1813
+ "multiple": true,
1814
+ "type": "option"
1815
+ },
1816
+ "all-envs": {
1817
+ "description": "Include all environments (true/false)",
1818
+ "name": "all-envs",
1818
1819
  "hasDynamicHelp": false,
1819
1820
  "multiple": false,
1820
1821
  "type": "option"
1821
1822
  },
1822
- "workflow-name": {
1823
- "description": "Workflow name for traces (default: claude-code)",
1824
- "name": "workflow-name",
1823
+ "is-test": {
1824
+ "description": "Filter by test (true) or production (false) environment",
1825
+ "name": "is-test",
1825
1826
  "hasDynamicHelp": false,
1826
1827
  "multiple": false,
1827
1828
  "type": "option"
1828
1829
  },
1829
- "dry-run": {
1830
- "description": "Preview changes without writing files",
1831
- "name": "dry-run",
1832
- "allowNo": false,
1833
- "type": "boolean"
1830
+ "include-fields": {
1831
+ "description": "Comma-separated fields to include in response",
1832
+ "name": "include-fields",
1833
+ "hasDynamicHelp": false,
1834
+ "multiple": false,
1835
+ "type": "option"
1834
1836
  }
1835
1837
  },
1836
1838
  "hasDynamicHelp": false,
1837
1839
  "hiddenAliases": [],
1838
- "id": "integrate:codex-cli",
1840
+ "id": "logs:list",
1839
1841
  "pluginAlias": "@respan/cli",
1840
1842
  "pluginName": "@respan/cli",
1841
1843
  "pluginType": "core",
@@ -1845,20 +1847,14 @@
1845
1847
  "relativePath": [
1846
1848
  "dist",
1847
1849
  "commands",
1848
- "integrate",
1849
- "codex-cli.js"
1850
+ "logs",
1851
+ "list.js"
1850
1852
  ]
1851
1853
  },
1852
- "integrate:gemini-cli": {
1854
+ "logs:summary": {
1853
1855
  "aliases": [],
1854
1856
  "args": {},
1855
- "description": "Integrate Respan with Gemini CLI.\n\nInstalls an AfterModel hook that captures LLM request/response data\nand sends it to Respan as structured spans with model, token counts,\nand input/output.\n\nScope:\n --global Write to ~/.gemini/settings.json (default)\n --local Write to .gemini/settings.json in project root\n\nNote: Gemini CLI ignores workspace-level telemetry settings, so\n--global is the default.",
1856
- "examples": [
1857
- "respan integrate gemini-cli",
1858
- "respan integrate gemini-cli --local",
1859
- "respan integrate gemini-cli --project-id my-project --attrs '{\"env\":\"prod\"}'",
1860
- "respan integrate gemini-cli --dry-run"
1861
- ],
1857
+ "description": "Get aggregated summary statistics for log spans in a time range.\n\nReturns total cost, total tokens, request count, and score summaries.\n\nFILTER SYNTAX: field:operator:value\n\nOPERATORS:\n (empty) Exact match model::gpt-4\n not Not equal status_code:not:200\n gt Greater than cost:gt:0.01\n gte Greater than/equal latency:gte:1.0\n lt Less than cost:lt:0.5\n lte Less than/equal prompt_tokens:lte:100\n contains Contains substring error_message:contains:timeout\n icontains Case-insensitive model:icontains:gpt\n startswith Starts with model:startswith:gpt\n endswith Ends with model:endswith:mini\n in Value in list model:in:gpt-4,gpt-4o\n isnull Is null error_message:isnull:true\n iexact Case-insens. exact status:iexact:success\n\nFILTERABLE FIELDS (logs):\n model, status_code, status, cost, latency, prompt_tokens,\n completion_tokens, customer_identifier, custom_identifier,\n thread_identifier, trace_unique_id, span_name, span_workflow_name,\n environment, log_type, error_message, failed, provider_id,\n deployment_name, prompt_name, prompt_id, unique_id, stream,\n temperature, max_tokens, tokens_per_second, time_to_first_token,\n total_request_tokens, metadata__<key>, scores__<evaluator_id>\n\nEXAMPLES:\n --filter model::gpt-4o --filter cost:gt:0.01\n --filter status_code:not:200\n --filter metadata__env::production\n --filter model:in:gpt-4,gpt-4o",
1862
1858
  "flags": {
1863
1859
  "api-key": {
1864
1860
  "description": "API key (env: RESPAN_API_KEY)",
@@ -1894,80 +1890,47 @@
1894
1890
  "allowNo": false,
1895
1891
  "type": "boolean"
1896
1892
  },
1897
- "local": {
1898
- "description": "Write per-project config (default)",
1899
- "exclusive": [
1900
- "global"
1901
- ],
1902
- "name": "local",
1903
- "allowNo": false,
1904
- "type": "boolean"
1893
+ "start-time": {
1894
+ "description": "Start time (ISO 8601)",
1895
+ "name": "start-time",
1896
+ "required": true,
1897
+ "hasDynamicHelp": false,
1898
+ "multiple": false,
1899
+ "type": "option"
1905
1900
  },
1906
- "global": {
1907
- "description": "Write user-level global config",
1908
- "exclusive": [
1909
- "local"
1910
- ],
1911
- "name": "global",
1912
- "allowNo": false,
1913
- "type": "boolean"
1914
- },
1915
- "project-id": {
1916
- "description": "Respan project ID (added to metadata / resource attributes)",
1917
- "env": "RESPAN_PROJECT_ID",
1918
- "name": "project-id",
1919
- "hasDynamicHelp": false,
1920
- "multiple": false,
1921
- "type": "option"
1922
- },
1923
- "base-url": {
1924
- "description": "Respan API base URL (for enterprise deployments)",
1925
- "name": "base-url",
1926
- "default": "https://api.respan.ai/api",
1927
- "hasDynamicHelp": false,
1928
- "multiple": false,
1929
- "type": "option"
1930
- },
1931
- "attrs": {
1932
- "description": "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
1933
- "name": "attrs",
1934
- "default": "{}",
1901
+ "end-time": {
1902
+ "description": "End time (ISO 8601)",
1903
+ "name": "end-time",
1904
+ "required": true,
1935
1905
  "hasDynamicHelp": false,
1936
1906
  "multiple": false,
1937
1907
  "type": "option"
1938
1908
  },
1939
- "customer-id": {
1940
- "description": "Customer/user identifier for traces (e.g. your name or email)",
1941
- "env": "RESPAN_CUSTOMER_ID",
1942
- "name": "customer-id",
1909
+ "filter": {
1910
+ "description": "Filter in field:operator:value format (repeatable)",
1911
+ "name": "filter",
1943
1912
  "hasDynamicHelp": false,
1944
- "multiple": false,
1913
+ "multiple": true,
1945
1914
  "type": "option"
1946
1915
  },
1947
- "span-name": {
1948
- "description": "Root span name for traces (default: claude-code)",
1949
- "name": "span-name",
1916
+ "all-envs": {
1917
+ "description": "Include all environments (true/false)",
1918
+ "name": "all-envs",
1950
1919
  "hasDynamicHelp": false,
1951
1920
  "multiple": false,
1952
1921
  "type": "option"
1953
1922
  },
1954
- "workflow-name": {
1955
- "description": "Workflow name for traces (default: claude-code)",
1956
- "name": "workflow-name",
1923
+ "is-test": {
1924
+ "description": "Filter by test (true) or production (false) environment",
1925
+ "name": "is-test",
1957
1926
  "hasDynamicHelp": false,
1958
1927
  "multiple": false,
1959
1928
  "type": "option"
1960
- },
1961
- "dry-run": {
1962
- "description": "Preview changes without writing files",
1963
- "name": "dry-run",
1964
- "allowNo": false,
1965
- "type": "boolean"
1966
1929
  }
1967
1930
  },
1968
1931
  "hasDynamicHelp": false,
1969
1932
  "hiddenAliases": [],
1970
- "id": "integrate:gemini-cli",
1933
+ "id": "logs:summary",
1971
1934
  "pluginAlias": "@respan/cli",
1972
1935
  "pluginName": "@respan/cli",
1973
1936
  "pluginType": "core",
@@ -1977,20 +1940,20 @@
1977
1940
  "relativePath": [
1978
1941
  "dist",
1979
1942
  "commands",
1980
- "integrate",
1981
- "gemini-cli.js"
1943
+ "logs",
1944
+ "summary.js"
1982
1945
  ]
1983
1946
  },
1984
- "integrate:opencode": {
1947
+ "prompts:create-version": {
1985
1948
  "aliases": [],
1986
- "args": {},
1987
- "description": "Integrate Respan with OpenCode.\n\nOpenCode's built-in OTel does not work reliably, so this uses the\ncommunity opencode-otel plugin instead.\n\nScope:\n --local Write plugin config to project root (default)\n --global Write to ~/.config/opencode/plugins/otel.json\n The opencode-otel package is always installed globally.",
1988
- "examples": [
1989
- "respan integrate opencode",
1990
- "respan integrate opencode --global",
1991
- "respan integrate opencode --project-id my-project --attrs '{\"env\":\"prod\"}'",
1992
- "respan integrate opencode --dry-run"
1993
- ],
1949
+ "args": {
1950
+ "prompt-id": {
1951
+ "description": "Prompt ID",
1952
+ "name": "prompt-id",
1953
+ "required": true
1954
+ }
1955
+ },
1956
+ "description": "Create a new version of a prompt",
1994
1957
  "flags": {
1995
1958
  "api-key": {
1996
1959
  "description": "API key (env: RESPAN_API_KEY)",
@@ -2026,80 +1989,39 @@
2026
1989
  "allowNo": false,
2027
1990
  "type": "boolean"
2028
1991
  },
2029
- "local": {
2030
- "description": "Write per-project config (default)",
2031
- "exclusive": [
2032
- "global"
2033
- ],
2034
- "name": "local",
2035
- "allowNo": false,
2036
- "type": "boolean"
2037
- },
2038
- "global": {
2039
- "description": "Write user-level global config",
2040
- "exclusive": [
2041
- "local"
2042
- ],
2043
- "name": "global",
2044
- "allowNo": false,
2045
- "type": "boolean"
2046
- },
2047
- "project-id": {
2048
- "description": "Respan project ID (added to metadata / resource attributes)",
2049
- "env": "RESPAN_PROJECT_ID",
2050
- "name": "project-id",
2051
- "hasDynamicHelp": false,
2052
- "multiple": false,
2053
- "type": "option"
2054
- },
2055
- "base-url": {
2056
- "description": "Respan API base URL (for enterprise deployments)",
2057
- "name": "base-url",
2058
- "default": "https://api.respan.ai/api",
2059
- "hasDynamicHelp": false,
2060
- "multiple": false,
2061
- "type": "option"
2062
- },
2063
- "attrs": {
2064
- "description": "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
2065
- "name": "attrs",
2066
- "default": "{}",
1992
+ "messages": {
1993
+ "description": "Messages as JSON array string",
1994
+ "name": "messages",
1995
+ "required": true,
2067
1996
  "hasDynamicHelp": false,
2068
1997
  "multiple": false,
2069
1998
  "type": "option"
2070
1999
  },
2071
- "customer-id": {
2072
- "description": "Customer/user identifier for traces (e.g. your name or email)",
2073
- "env": "RESPAN_CUSTOMER_ID",
2074
- "name": "customer-id",
2000
+ "model": {
2001
+ "description": "Model name",
2002
+ "name": "model",
2075
2003
  "hasDynamicHelp": false,
2076
2004
  "multiple": false,
2077
2005
  "type": "option"
2078
2006
  },
2079
- "span-name": {
2080
- "description": "Root span name for traces (default: claude-code)",
2081
- "name": "span-name",
2007
+ "temperature": {
2008
+ "description": "Temperature value",
2009
+ "name": "temperature",
2082
2010
  "hasDynamicHelp": false,
2083
2011
  "multiple": false,
2084
2012
  "type": "option"
2085
2013
  },
2086
- "workflow-name": {
2087
- "description": "Workflow name for traces (default: claude-code)",
2088
- "name": "workflow-name",
2014
+ "max-tokens": {
2015
+ "description": "Max tokens",
2016
+ "name": "max-tokens",
2089
2017
  "hasDynamicHelp": false,
2090
2018
  "multiple": false,
2091
2019
  "type": "option"
2092
- },
2093
- "dry-run": {
2094
- "description": "Preview changes without writing files",
2095
- "name": "dry-run",
2096
- "allowNo": false,
2097
- "type": "boolean"
2098
2020
  }
2099
2021
  },
2100
2022
  "hasDynamicHelp": false,
2101
2023
  "hiddenAliases": [],
2102
- "id": "integrate:opencode",
2024
+ "id": "prompts:create-version",
2103
2025
  "pluginAlias": "@respan/cli",
2104
2026
  "pluginName": "@respan/cli",
2105
2027
  "pluginType": "core",
@@ -2109,14 +2031,14 @@
2109
2031
  "relativePath": [
2110
2032
  "dist",
2111
2033
  "commands",
2112
- "integrate",
2113
- "opencode.js"
2034
+ "prompts",
2035
+ "create-version.js"
2114
2036
  ]
2115
2037
  },
2116
- "logs:create": {
2038
+ "prompts:create": {
2117
2039
  "aliases": [],
2118
2040
  "args": {},
2119
- "description": "Create a log span",
2041
+ "description": "Create a new prompt",
2120
2042
  "flags": {
2121
2043
  "api-key": {
2122
2044
  "description": "API key (env: RESPAN_API_KEY)",
@@ -2152,31 +2074,17 @@
2152
2074
  "allowNo": false,
2153
2075
  "type": "boolean"
2154
2076
  },
2155
- "input": {
2156
- "description": "Input text or JSON",
2157
- "name": "input",
2077
+ "name": {
2078
+ "description": "Prompt name",
2079
+ "name": "name",
2158
2080
  "required": true,
2159
2081
  "hasDynamicHelp": false,
2160
2082
  "multiple": false,
2161
2083
  "type": "option"
2162
2084
  },
2163
- "output": {
2164
- "description": "Output text or JSON",
2165
- "name": "output",
2166
- "hasDynamicHelp": false,
2167
- "multiple": false,
2168
- "type": "option"
2169
- },
2170
- "model": {
2171
- "description": "Model name",
2172
- "name": "model",
2173
- "hasDynamicHelp": false,
2174
- "multiple": false,
2175
- "type": "option"
2176
- },
2177
- "metadata": {
2178
- "description": "Metadata as JSON string",
2179
- "name": "metadata",
2085
+ "description": {
2086
+ "description": "Prompt description",
2087
+ "name": "description",
2180
2088
  "hasDynamicHelp": false,
2181
2089
  "multiple": false,
2182
2090
  "type": "option"
@@ -2184,7 +2092,7 @@
2184
2092
  },
2185
2093
  "hasDynamicHelp": false,
2186
2094
  "hiddenAliases": [],
2187
- "id": "logs:create",
2095
+ "id": "prompts:create",
2188
2096
  "pluginAlias": "@respan/cli",
2189
2097
  "pluginName": "@respan/cli",
2190
2098
  "pluginType": "core",
@@ -2194,20 +2102,20 @@
2194
2102
  "relativePath": [
2195
2103
  "dist",
2196
2104
  "commands",
2197
- "logs",
2105
+ "prompts",
2198
2106
  "create.js"
2199
2107
  ]
2200
2108
  },
2201
- "logs:get": {
2109
+ "prompts:get": {
2202
2110
  "aliases": [],
2203
2111
  "args": {
2204
2112
  "id": {
2205
- "description": "Span ID",
2113
+ "description": "Prompt ID",
2206
2114
  "name": "id",
2207
2115
  "required": true
2208
2116
  }
2209
2117
  },
2210
- "description": "Get a specific log span",
2118
+ "description": "Get a specific prompt",
2211
2119
  "flags": {
2212
2120
  "api-key": {
2213
2121
  "description": "API key (env: RESPAN_API_KEY)",
@@ -2246,7 +2154,7 @@
2246
2154
  },
2247
2155
  "hasDynamicHelp": false,
2248
2156
  "hiddenAliases": [],
2249
- "id": "logs:get",
2157
+ "id": "prompts:get",
2250
2158
  "pluginAlias": "@respan/cli",
2251
2159
  "pluginName": "@respan/cli",
2252
2160
  "pluginType": "core",
@@ -2256,14 +2164,14 @@
2256
2164
  "relativePath": [
2257
2165
  "dist",
2258
2166
  "commands",
2259
- "logs",
2167
+ "prompts",
2260
2168
  "get.js"
2261
2169
  ]
2262
2170
  },
2263
- "logs:list": {
2171
+ "prompts:list": {
2264
2172
  "aliases": [],
2265
2173
  "args": {},
2266
- "description": "List and filter LLM request logs (spans).\n\nSupports pagination, sorting, time range, and server-side filtering.\n\nFILTER SYNTAX: field:operator:value\n\nOPERATORS:\n (empty) Exact match model::gpt-4\n not Not equal status_code:not:200\n gt Greater than cost:gt:0.01\n gte Greater than/equal latency:gte:1.0\n lt Less than cost:lt:0.5\n lte Less than/equal prompt_tokens:lte:100\n contains Contains substring error_message:contains:timeout\n icontains Case-insensitive model:icontains:gpt\n startswith Starts with model:startswith:gpt\n endswith Ends with model:endswith:mini\n in Value in list model:in:gpt-4,gpt-4o\n isnull Is null error_message:isnull:true\n iexact Case-insens. exact status:iexact:success\n\nFILTERABLE FIELDS (logs):\n model, status_code, status, cost, latency, prompt_tokens,\n completion_tokens, customer_identifier, custom_identifier,\n thread_identifier, trace_unique_id, span_name, span_workflow_name,\n environment, log_type, error_message, failed, provider_id,\n deployment_name, prompt_name, prompt_id, unique_id, stream,\n temperature, max_tokens, tokens_per_second, time_to_first_token,\n total_request_tokens, metadata__<key>, scores__<evaluator_id>\n\nEXAMPLES:\n --filter model::gpt-4o --filter cost:gt:0.01\n --filter status_code:not:200\n --filter metadata__env::production\n --filter model:in:gpt-4,gpt-4o",
2174
+ "description": "List prompts",
2267
2175
  "flags": {
2268
2176
  "api-key": {
2269
2177
  "description": "API key (env: RESPAN_API_KEY)",
@@ -2300,66 +2208,85 @@
2300
2208
  "type": "boolean"
2301
2209
  },
2302
2210
  "limit": {
2303
- "description": "Number of results per page (max 1000)",
2211
+ "description": "Number of results per page",
2304
2212
  "name": "limit",
2305
2213
  "default": 50,
2306
2214
  "hasDynamicHelp": false,
2307
2215
  "multiple": false,
2308
2216
  "type": "option"
2309
- },
2310
- "page": {
2311
- "description": "Page number",
2312
- "name": "page",
2313
- "default": 1,
2314
- "hasDynamicHelp": false,
2315
- "multiple": false,
2316
- "type": "option"
2317
- },
2318
- "sort-by": {
2319
- "description": "Sort field (prefix with - for descending, e.g. -cost, -latency)",
2320
- "name": "sort-by",
2217
+ }
2218
+ },
2219
+ "hasDynamicHelp": false,
2220
+ "hiddenAliases": [],
2221
+ "id": "prompts:list",
2222
+ "pluginAlias": "@respan/cli",
2223
+ "pluginName": "@respan/cli",
2224
+ "pluginType": "core",
2225
+ "strict": true,
2226
+ "enableJsonFlag": false,
2227
+ "isESM": true,
2228
+ "relativePath": [
2229
+ "dist",
2230
+ "commands",
2231
+ "prompts",
2232
+ "list.js"
2233
+ ]
2234
+ },
2235
+ "prompts:update": {
2236
+ "aliases": [],
2237
+ "args": {
2238
+ "id": {
2239
+ "description": "Prompt ID",
2240
+ "name": "id",
2241
+ "required": true
2242
+ }
2243
+ },
2244
+ "description": "Update a prompt",
2245
+ "flags": {
2246
+ "api-key": {
2247
+ "description": "API key (env: RESPAN_API_KEY)",
2248
+ "env": "RESPAN_API_KEY",
2249
+ "name": "api-key",
2321
2250
  "hasDynamicHelp": false,
2322
2251
  "multiple": false,
2323
2252
  "type": "option"
2324
2253
  },
2325
- "start-time": {
2326
- "description": "Start time filter (ISO 8601)",
2327
- "name": "start-time",
2254
+ "profile": {
2255
+ "description": "Named profile to use",
2256
+ "name": "profile",
2328
2257
  "hasDynamicHelp": false,
2329
2258
  "multiple": false,
2330
2259
  "type": "option"
2331
2260
  },
2332
- "end-time": {
2333
- "description": "End time filter (ISO 8601)",
2334
- "name": "end-time",
2335
- "hasDynamicHelp": false,
2336
- "multiple": false,
2337
- "type": "option"
2261
+ "json": {
2262
+ "description": "Output as JSON",
2263
+ "name": "json",
2264
+ "allowNo": false,
2265
+ "type": "boolean"
2338
2266
  },
2339
- "filter": {
2340
- "description": "Filter in field:operator:value format (repeatable)",
2341
- "name": "filter",
2342
- "hasDynamicHelp": false,
2343
- "multiple": true,
2344
- "type": "option"
2267
+ "csv": {
2268
+ "description": "Output as CSV",
2269
+ "name": "csv",
2270
+ "allowNo": false,
2271
+ "type": "boolean"
2345
2272
  },
2346
- "all-envs": {
2347
- "description": "Include all environments (true/false)",
2348
- "name": "all-envs",
2349
- "hasDynamicHelp": false,
2350
- "multiple": false,
2351
- "type": "option"
2273
+ "verbose": {
2274
+ "char": "v",
2275
+ "description": "Show verbose output",
2276
+ "name": "verbose",
2277
+ "allowNo": false,
2278
+ "type": "boolean"
2352
2279
  },
2353
- "is-test": {
2354
- "description": "Filter by test (true) or production (false) environment",
2355
- "name": "is-test",
2280
+ "name": {
2281
+ "description": "Prompt name",
2282
+ "name": "name",
2356
2283
  "hasDynamicHelp": false,
2357
2284
  "multiple": false,
2358
2285
  "type": "option"
2359
2286
  },
2360
- "include-fields": {
2361
- "description": "Comma-separated fields to include in response",
2362
- "name": "include-fields",
2287
+ "description": {
2288
+ "description": "Prompt description",
2289
+ "name": "description",
2363
2290
  "hasDynamicHelp": false,
2364
2291
  "multiple": false,
2365
2292
  "type": "option"
@@ -2367,7 +2294,7 @@
2367
2294
  },
2368
2295
  "hasDynamicHelp": false,
2369
2296
  "hiddenAliases": [],
2370
- "id": "logs:list",
2297
+ "id": "prompts:update",
2371
2298
  "pluginAlias": "@respan/cli",
2372
2299
  "pluginName": "@respan/cli",
2373
2300
  "pluginType": "core",
@@ -2377,14 +2304,20 @@
2377
2304
  "relativePath": [
2378
2305
  "dist",
2379
2306
  "commands",
2380
- "logs",
2381
- "list.js"
2307
+ "prompts",
2308
+ "update.js"
2382
2309
  ]
2383
2310
  },
2384
- "logs:summary": {
2311
+ "prompts:versions": {
2385
2312
  "aliases": [],
2386
- "args": {},
2387
- "description": "Get aggregated summary statistics for log spans in a time range.\n\nReturns total cost, total tokens, request count, and score summaries.\n\nFILTER SYNTAX: field:operator:value\n\nOPERATORS:\n (empty) Exact match model::gpt-4\n not Not equal status_code:not:200\n gt Greater than cost:gt:0.01\n gte Greater than/equal latency:gte:1.0\n lt Less than cost:lt:0.5\n lte Less than/equal prompt_tokens:lte:100\n contains Contains substring error_message:contains:timeout\n icontains Case-insensitive model:icontains:gpt\n startswith Starts with model:startswith:gpt\n endswith Ends with model:endswith:mini\n in Value in list model:in:gpt-4,gpt-4o\n isnull Is null error_message:isnull:true\n iexact Case-insens. exact status:iexact:success\n\nFILTERABLE FIELDS (logs):\n model, status_code, status, cost, latency, prompt_tokens,\n completion_tokens, customer_identifier, custom_identifier,\n thread_identifier, trace_unique_id, span_name, span_workflow_name,\n environment, log_type, error_message, failed, provider_id,\n deployment_name, prompt_name, prompt_id, unique_id, stream,\n temperature, max_tokens, tokens_per_second, time_to_first_token,\n total_request_tokens, metadata__<key>, scores__<evaluator_id>\n\nEXAMPLES:\n --filter model::gpt-4o --filter cost:gt:0.01\n --filter status_code:not:200\n --filter metadata__env::production\n --filter model:in:gpt-4,gpt-4o",
2313
+ "args": {
2314
+ "prompt-id": {
2315
+ "description": "Prompt ID",
2316
+ "name": "prompt-id",
2317
+ "required": true
2318
+ }
2319
+ },
2320
+ "description": "List versions of a prompt",
2388
2321
  "flags": {
2389
2322
  "api-key": {
2390
2323
  "description": "API key (env: RESPAN_API_KEY)",
@@ -2419,48 +2352,11 @@
2419
2352
  "name": "verbose",
2420
2353
  "allowNo": false,
2421
2354
  "type": "boolean"
2422
- },
2423
- "start-time": {
2424
- "description": "Start time (ISO 8601)",
2425
- "name": "start-time",
2426
- "required": true,
2427
- "hasDynamicHelp": false,
2428
- "multiple": false,
2429
- "type": "option"
2430
- },
2431
- "end-time": {
2432
- "description": "End time (ISO 8601)",
2433
- "name": "end-time",
2434
- "required": true,
2435
- "hasDynamicHelp": false,
2436
- "multiple": false,
2437
- "type": "option"
2438
- },
2439
- "filter": {
2440
- "description": "Filter in field:operator:value format (repeatable)",
2441
- "name": "filter",
2442
- "hasDynamicHelp": false,
2443
- "multiple": true,
2444
- "type": "option"
2445
- },
2446
- "all-envs": {
2447
- "description": "Include all environments (true/false)",
2448
- "name": "all-envs",
2449
- "hasDynamicHelp": false,
2450
- "multiple": false,
2451
- "type": "option"
2452
- },
2453
- "is-test": {
2454
- "description": "Filter by test (true) or production (false) environment",
2455
- "name": "is-test",
2456
- "hasDynamicHelp": false,
2457
- "multiple": false,
2458
- "type": "option"
2459
2355
  }
2460
2356
  },
2461
2357
  "hasDynamicHelp": false,
2462
2358
  "hiddenAliases": [],
2463
- "id": "logs:summary",
2359
+ "id": "prompts:versions",
2464
2360
  "pluginAlias": "@respan/cli",
2465
2361
  "pluginName": "@respan/cli",
2466
2362
  "pluginType": "core",
@@ -2470,20 +2366,20 @@
2470
2366
  "relativePath": [
2471
2367
  "dist",
2472
2368
  "commands",
2473
- "logs",
2474
- "summary.js"
2369
+ "prompts",
2370
+ "versions.js"
2475
2371
  ]
2476
2372
  },
2477
- "prompts:create-version": {
2373
+ "traces:get": {
2478
2374
  "aliases": [],
2479
2375
  "args": {
2480
- "prompt-id": {
2481
- "description": "Prompt ID",
2482
- "name": "prompt-id",
2376
+ "id": {
2377
+ "description": "Trace ID",
2378
+ "name": "id",
2483
2379
  "required": true
2484
2380
  }
2485
2381
  },
2486
- "description": "Create a new version of a prompt",
2382
+ "description": "Get a specific trace",
2487
2383
  "flags": {
2488
2384
  "api-key": {
2489
2385
  "description": "API key (env: RESPAN_API_KEY)",
@@ -2518,40 +2414,11 @@
2518
2414
  "name": "verbose",
2519
2415
  "allowNo": false,
2520
2416
  "type": "boolean"
2521
- },
2522
- "messages": {
2523
- "description": "Messages as JSON array string",
2524
- "name": "messages",
2525
- "required": true,
2526
- "hasDynamicHelp": false,
2527
- "multiple": false,
2528
- "type": "option"
2529
- },
2530
- "model": {
2531
- "description": "Model name",
2532
- "name": "model",
2533
- "hasDynamicHelp": false,
2534
- "multiple": false,
2535
- "type": "option"
2536
- },
2537
- "temperature": {
2538
- "description": "Temperature value",
2539
- "name": "temperature",
2540
- "hasDynamicHelp": false,
2541
- "multiple": false,
2542
- "type": "option"
2543
- },
2544
- "max-tokens": {
2545
- "description": "Max tokens",
2546
- "name": "max-tokens",
2547
- "hasDynamicHelp": false,
2548
- "multiple": false,
2549
- "type": "option"
2550
2417
  }
2551
2418
  },
2552
2419
  "hasDynamicHelp": false,
2553
2420
  "hiddenAliases": [],
2554
- "id": "prompts:create-version",
2421
+ "id": "traces:get",
2555
2422
  "pluginAlias": "@respan/cli",
2556
2423
  "pluginName": "@respan/cli",
2557
2424
  "pluginType": "core",
@@ -2561,14 +2428,14 @@
2561
2428
  "relativePath": [
2562
2429
  "dist",
2563
2430
  "commands",
2564
- "prompts",
2565
- "create-version.js"
2431
+ "traces",
2432
+ "get.js"
2566
2433
  ]
2567
2434
  },
2568
- "prompts:create": {
2435
+ "traces:list": {
2569
2436
  "aliases": [],
2570
2437
  "args": {},
2571
- "description": "Create a new prompt",
2438
+ "description": "List and filter traces.\n\nA trace represents a complete workflow execution containing multiple spans.\n\nFILTER SYNTAX: field:operator:value\n\nOPERATORS:\n (empty) Exact match model::gpt-4\n not Not equal status_code:not:200\n gt Greater than cost:gt:0.01\n gte Greater than/equal latency:gte:1.0\n lt Less than cost:lt:0.5\n lte Less than/equal prompt_tokens:lte:100\n contains Contains substring error_message:contains:timeout\n icontains Case-insensitive model:icontains:gpt\n startswith Starts with model:startswith:gpt\n endswith Ends with model:endswith:mini\n in Value in list model:in:gpt-4,gpt-4o\n isnull Is null error_message:isnull:true\n iexact Case-insens. exact status:iexact:success\n\nFILTERABLE FIELDS (traces):\n trace_unique_id, customer_identifier, environment, span_count,\n llm_call_count, error_count, total_cost, total_tokens,\n total_prompt_tokens, total_completion_tokens, duration,\n span_workflow_name, metadata__<key>\n\nEXAMPLES:\n --filter model::gpt-4o --filter cost:gt:0.01\n --filter status_code:not:200\n --filter metadata__env::production\n --filter model:in:gpt-4,gpt-4o",
2572
2439
  "flags": {
2573
2440
  "api-key": {
2574
2441
  "description": "API key (env: RESPAN_API_KEY)",
@@ -2604,25 +2471,62 @@
2604
2471
  "allowNo": false,
2605
2472
  "type": "boolean"
2606
2473
  },
2607
- "name": {
2608
- "description": "Prompt name",
2609
- "name": "name",
2610
- "required": true,
2474
+ "limit": {
2475
+ "description": "Number of results per page",
2476
+ "name": "limit",
2477
+ "default": 10,
2611
2478
  "hasDynamicHelp": false,
2612
2479
  "multiple": false,
2613
2480
  "type": "option"
2614
2481
  },
2615
- "description": {
2616
- "description": "Prompt description",
2617
- "name": "description",
2482
+ "page": {
2483
+ "description": "Page number",
2484
+ "name": "page",
2485
+ "default": 1,
2486
+ "hasDynamicHelp": false,
2487
+ "multiple": false,
2488
+ "type": "option"
2489
+ },
2490
+ "sort-by": {
2491
+ "description": "Sort field (prefix with - for descending)",
2492
+ "name": "sort-by",
2493
+ "default": "-timestamp",
2494
+ "hasDynamicHelp": false,
2495
+ "multiple": false,
2496
+ "type": "option"
2497
+ },
2498
+ "start-time": {
2499
+ "description": "Start time filter (ISO 8601)",
2500
+ "name": "start-time",
2501
+ "hasDynamicHelp": false,
2502
+ "multiple": false,
2503
+ "type": "option"
2504
+ },
2505
+ "end-time": {
2506
+ "description": "End time filter (ISO 8601)",
2507
+ "name": "end-time",
2508
+ "hasDynamicHelp": false,
2509
+ "multiple": false,
2510
+ "type": "option"
2511
+ },
2512
+ "environment": {
2513
+ "description": "Environment filter",
2514
+ "name": "environment",
2618
2515
  "hasDynamicHelp": false,
2619
2516
  "multiple": false,
2620
2517
  "type": "option"
2518
+ },
2519
+ "filter": {
2520
+ "description": "Filter in field:operator:value format (repeatable)",
2521
+ "name": "filter",
2522
+ "hasDynamicHelp": false,
2523
+ "multiple": true,
2524
+ "type": "option"
2621
2525
  }
2622
2526
  },
2623
2527
  "hasDynamicHelp": false,
2624
2528
  "hiddenAliases": [],
2625
- "id": "prompts:create",
2529
+ "id": "traces:list",
2626
2530
  "pluginAlias": "@respan/cli",
2627
2531
  "pluginName": "@respan/cli",
2628
2532
  "pluginType": "core",
@@ -2632,20 +2536,14 @@
2632
2536
  "relativePath": [
2633
2537
  "dist",
2634
2538
  "commands",
2635
- "prompts",
2636
- "create.js"
2539
+ "traces",
2540
+ "list.js"
2637
2541
  ]
2638
2542
  },
2639
- "prompts:get": {
2543
+ "traces:summary": {
2640
2544
  "aliases": [],
2641
- "args": {
2642
- "id": {
2643
- "description": "Prompt ID",
2644
- "name": "id",
2645
- "required": true
2646
- }
2647
- },
2648
- "description": "Get a specific prompt",
2545
+ "args": {},
2546
+ "description": "Get a summary of traces for a time range",
2649
2547
  "flags": {
2650
2548
  "api-key": {
2651
2549
  "description": "API key (env: RESPAN_API_KEY)",
@@ -2680,11 +2578,27 @@
2680
2578
  "name": "verbose",
2681
2579
  "allowNo": false,
2682
2580
  "type": "boolean"
2581
+ },
2582
+ "start-time": {
2583
+ "description": "Start time (ISO 8601)",
2584
+ "name": "start-time",
2585
+ "required": true,
2586
+ "hasDynamicHelp": false,
2587
+ "multiple": false,
2588
+ "type": "option"
2589
+ },
2590
+ "end-time": {
2591
+ "description": "End time (ISO 8601)",
2592
+ "name": "end-time",
2593
+ "required": true,
2594
+ "hasDynamicHelp": false,
2595
+ "multiple": false,
2596
+ "type": "option"
2683
2597
  }
2684
2598
  },
2685
2599
  "hasDynamicHelp": false,
2686
2600
  "hiddenAliases": [],
2687
- "id": "prompts:get",
2601
+ "id": "traces:summary",
2688
2602
  "pluginAlias": "@respan/cli",
2689
2603
  "pluginName": "@respan/cli",
2690
2604
  "pluginType": "core",
@@ -2694,14 +2608,14 @@
2694
2608
  "relativePath": [
2695
2609
  "dist",
2696
2610
  "commands",
2697
- "prompts",
2698
- "get.js"
2611
+ "traces",
2612
+ "summary.js"
2699
2613
  ]
2700
2614
  },
2701
- "prompts:list": {
2615
+ "users:create": {
2702
2616
  "aliases": [],
2703
2617
  "args": {},
2704
- "description": "List prompts",
2618
+ "description": "Create a new user (customer)",
2705
2619
  "flags": {
2706
2620
  "api-key": {
2707
2621
  "description": "API key (env: RESPAN_API_KEY)",
@@ -2737,10 +2651,31 @@
2737
2651
  "allowNo": false,
2738
2652
  "type": "boolean"
2739
2653
  },
2740
- "limit": {
2741
- "description": "Number of results per page",
2742
- "name": "limit",
2743
- "default": 50,
2654
+ "identifier": {
2655
+ "description": "Customer identifier",
2656
+ "name": "identifier",
2657
+ "required": true,
2658
+ "hasDynamicHelp": false,
2659
+ "multiple": false,
2660
+ "type": "option"
2661
+ },
2662
+ "name": {
2663
+ "description": "Customer name",
2664
+ "name": "name",
2665
+ "hasDynamicHelp": false,
2666
+ "multiple": false,
2667
+ "type": "option"
2668
+ },
2669
+ "email": {
2670
+ "description": "Customer email",
2671
+ "name": "email",
2672
+ "hasDynamicHelp": false,
2673
+ "multiple": false,
2674
+ "type": "option"
2675
+ },
2676
+ "metadata": {
2677
+ "description": "Metadata as JSON string",
2678
+ "name": "metadata",
2744
2679
  "hasDynamicHelp": false,
2745
2680
  "multiple": false,
2746
2681
  "type": "option"
@@ -2748,7 +2683,7 @@
2748
2683
  },
2749
2684
  "hasDynamicHelp": false,
2750
2685
  "hiddenAliases": [],
2751
- "id": "prompts:list",
2686
+ "id": "users:create",
2752
2687
  "pluginAlias": "@respan/cli",
2753
2688
  "pluginName": "@respan/cli",
2754
2689
  "pluginType": "core",
@@ -2758,20 +2693,20 @@
2758
2693
  "relativePath": [
2759
2694
  "dist",
2760
2695
  "commands",
2761
- "prompts",
2762
- "list.js"
2696
+ "users",
2697
+ "create.js"
2763
2698
  ]
2764
2699
  },
2765
- "prompts:update": {
2700
+ "users:get": {
2766
2701
  "aliases": [],
2767
2702
  "args": {
2768
2703
  "id": {
2769
- "description": "Prompt ID",
2704
+ "description": "Customer identifier",
2770
2705
  "name": "id",
2771
2706
  "required": true
2772
2707
  }
2773
2708
  },
2774
- "description": "Update a prompt",
2709
+ "description": "Get a specific user (customer)",
2775
2710
  "flags": {
2776
2711
  "api-key": {
2777
2712
  "description": "API key (env: RESPAN_API_KEY)",
@@ -2806,25 +2741,11 @@
2806
2741
  "name": "verbose",
2807
2742
  "allowNo": false,
2808
2743
  "type": "boolean"
2809
- },
2810
- "name": {
2811
- "description": "Prompt name",
2812
- "name": "name",
2813
- "hasDynamicHelp": false,
2814
- "multiple": false,
2815
- "type": "option"
2816
- },
2817
- "description": {
2818
- "description": "Prompt description",
2819
- "name": "description",
2820
- "hasDynamicHelp": false,
2821
- "multiple": false,
2822
- "type": "option"
2823
2744
  }
2824
2745
  },
2825
2746
  "hasDynamicHelp": false,
2826
2747
  "hiddenAliases": [],
2827
- "id": "prompts:update",
2748
+ "id": "users:get",
2828
2749
  "pluginAlias": "@respan/cli",
2829
2750
  "pluginName": "@respan/cli",
2830
2751
  "pluginType": "core",
@@ -2834,20 +2755,14 @@
2834
2755
  "relativePath": [
2835
2756
  "dist",
2836
2757
  "commands",
2837
- "prompts",
2838
- "update.js"
2758
+ "users",
2759
+ "get.js"
2839
2760
  ]
2840
2761
  },
2841
- "prompts:versions": {
2762
+ "users:list": {
2842
2763
  "aliases": [],
2843
- "args": {
2844
- "prompt-id": {
2845
- "description": "Prompt ID",
2846
- "name": "prompt-id",
2847
- "required": true
2848
- }
2849
- },
2850
- "description": "List versions of a prompt",
2764
+ "args": {},
2765
+ "description": "List users (customers)",
2851
2766
  "flags": {
2852
2767
  "api-key": {
2853
2768
  "description": "API key (env: RESPAN_API_KEY)",
@@ -2882,11 +2797,41 @@
2882
2797
  "name": "verbose",
2883
2798
  "allowNo": false,
2884
2799
  "type": "boolean"
2800
+ },
2801
+ "limit": {
2802
+ "description": "Number of results per page",
2803
+ "name": "limit",
2804
+ "default": 20,
2805
+ "hasDynamicHelp": false,
2806
+ "multiple": false,
2807
+ "type": "option"
2808
+ },
2809
+ "page": {
2810
+ "description": "Page number",
2811
+ "name": "page",
2812
+ "default": 1,
2813
+ "hasDynamicHelp": false,
2814
+ "multiple": false,
2815
+ "type": "option"
2816
+ },
2817
+ "sort-by": {
2818
+ "description": "Sort field",
2819
+ "name": "sort-by",
2820
+ "hasDynamicHelp": false,
2821
+ "multiple": false,
2822
+ "type": "option"
2823
+ },
2824
+ "environment": {
2825
+ "description": "Environment filter",
2826
+ "name": "environment",
2827
+ "hasDynamicHelp": false,
2828
+ "multiple": false,
2829
+ "type": "option"
2885
2830
  }
2886
2831
  },
2887
2832
  "hasDynamicHelp": false,
2888
2833
  "hiddenAliases": [],
2889
- "id": "prompts:versions",
2834
+ "id": "users:list",
2890
2835
  "pluginAlias": "@respan/cli",
2891
2836
  "pluginName": "@respan/cli",
2892
2837
  "pluginType": "core",
@@ -2896,20 +2841,20 @@
2896
2841
  "relativePath": [
2897
2842
  "dist",
2898
2843
  "commands",
2899
- "prompts",
2900
- "versions.js"
2844
+ "users",
2845
+ "list.js"
2901
2846
  ]
2902
2847
  },
2903
- "traces:get": {
2848
+ "users:update": {
2904
2849
  "aliases": [],
2905
2850
  "args": {
2906
2851
  "id": {
2907
- "description": "Trace ID",
2852
+ "description": "Customer identifier",
2908
2853
  "name": "id",
2909
2854
  "required": true
2910
2855
  }
2911
2856
  },
2912
- "description": "Get a specific trace",
2857
+ "description": "Update a user (customer)",
2913
2858
  "flags": {
2914
2859
  "api-key": {
2915
2860
  "description": "API key (env: RESPAN_API_KEY)",
@@ -2944,11 +2889,32 @@
2944
2889
  "name": "verbose",
2945
2890
  "allowNo": false,
2946
2891
  "type": "boolean"
2892
+ },
2893
+ "name": {
2894
+ "description": "Customer name",
2895
+ "name": "name",
2896
+ "hasDynamicHelp": false,
2897
+ "multiple": false,
2898
+ "type": "option"
2899
+ },
2900
+ "email": {
2901
+ "description": "Customer email",
2902
+ "name": "email",
2903
+ "hasDynamicHelp": false,
2904
+ "multiple": false,
2905
+ "type": "option"
2906
+ },
2907
+ "metadata": {
2908
+ "description": "Metadata as JSON string",
2909
+ "name": "metadata",
2910
+ "hasDynamicHelp": false,
2911
+ "multiple": false,
2912
+ "type": "option"
2947
2913
  }
2948
2914
  },
2949
2915
  "hasDynamicHelp": false,
2950
2916
  "hiddenAliases": [],
2951
- "id": "traces:get",
2917
+ "id": "users:update",
2952
2918
  "pluginAlias": "@respan/cli",
2953
2919
  "pluginName": "@respan/cli",
2954
2920
  "pluginType": "core",
@@ -2958,14 +2924,21 @@
2958
2924
  "relativePath": [
2959
2925
  "dist",
2960
2926
  "commands",
2961
- "traces",
2962
- "get.js"
2927
+ "users",
2928
+ "update.js"
2963
2929
  ]
2964
2930
  },
2965
- "traces:list": {
2931
+ "integrate:claude-code": {
2966
2932
  "aliases": [],
2967
2933
  "args": {},
2968
- "description": "List and filter traces.\n\nA trace represents a complete workflow execution containing multiple spans.\n\nFILTER SYNTAX: field:operator:value\n\nOPERATORS:\n (empty) Exact match model::gpt-4\n not Not equal status_code:not:200\n gt Greater than cost:gt:0.01\n gte Greater than/equal latency:gte:1.0\n lt Less than cost:lt:0.5\n lte Less than/equal prompt_tokens:lte:100\n contains Contains substring error_message:contains:timeout\n icontains Case-insensitive model:icontains:gpt\n startswith Starts with model:startswith:gpt\n endswith Ends with model:endswith:mini\n in Value in list model:in:gpt-4,gpt-4o\n isnull Is null error_message:isnull:true\n iexact Case-insens. exact status:iexact:success\n\nFILTERABLE FIELDS (traces):\n trace_unique_id, customer_identifier, environment, span_count,\n llm_call_count, error_count, total_cost, total_tokens,\n total_prompt_tokens, total_completion_tokens, duration,\n span_workflow_name, metadata__<key>\n\nEXAMPLES:\n --filter model::gpt-4o --filter cost:gt:0.01\n --filter status_code:not:200\n --filter metadata__env::production\n --filter model:in:gpt-4,gpt-4o",
2934
+ "description": "Integrate Respan with Claude Code.\n\nInstalls a Stop hook that reads conversation transcripts and sends\nthem to Respan as structured spans (chat, tool, thinking).\n\nScope:\n --global Install hook script + register in ~/.claude/settings.json\n --local Write credentials + enable flag to .claude/settings.local.json\n (default) Both: install hook globally + enable for current project",
2935
+ "examples": [
2936
+ "respan integrate claude-code",
2937
+ "respan integrate claude-code --global",
2938
+ "respan integrate claude-code --local --project-id my-project",
2939
+ "respan integrate claude-code --attrs '{\"env\":\"prod\"}'",
2940
+ "respan integrate claude-code --dry-run"
2941
+ ],
2969
2942
  "flags": {
2970
2943
  "api-key": {
2971
2944
  "description": "API key (env: RESPAN_API_KEY)",
@@ -3001,62 +2974,80 @@
3001
2974
  "allowNo": false,
3002
2975
  "type": "boolean"
3003
2976
  },
3004
- "limit": {
3005
- "description": "Number of results per page",
3006
- "name": "limit",
3007
- "default": 10,
2977
+ "local": {
2978
+ "description": "Write per-project config (default)",
2979
+ "exclusive": [
2980
+ "global"
2981
+ ],
2982
+ "name": "local",
2983
+ "allowNo": false,
2984
+ "type": "boolean"
2985
+ },
2986
+ "global": {
2987
+ "description": "Write user-level global config",
2988
+ "exclusive": [
2989
+ "local"
2990
+ ],
2991
+ "name": "global",
2992
+ "allowNo": false,
2993
+ "type": "boolean"
2994
+ },
2995
+ "project-id": {
2996
+ "description": "Respan project ID (added to metadata / resource attributes)",
2997
+ "env": "RESPAN_PROJECT_ID",
2998
+ "name": "project-id",
3008
2999
  "hasDynamicHelp": false,
3009
3000
  "multiple": false,
3010
3001
  "type": "option"
3011
3002
  },
3012
- "page": {
3013
- "description": "Page number",
3014
- "name": "page",
3015
- "default": 1,
3003
+ "base-url": {
3004
+ "description": "Respan API base URL (for enterprise deployments)",
3005
+ "name": "base-url",
3006
+ "default": "https://api.respan.ai/api",
3016
3007
  "hasDynamicHelp": false,
3017
3008
  "multiple": false,
3018
3009
  "type": "option"
3019
3010
  },
3020
- "sort-by": {
3021
- "description": "Sort field (prefix with - for descending)",
3022
- "name": "sort-by",
3023
- "default": "-timestamp",
3011
+ "attrs": {
3012
+ "description": "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
3013
+ "name": "attrs",
3014
+ "default": "{}",
3024
3015
  "hasDynamicHelp": false,
3025
3016
  "multiple": false,
3026
3017
  "type": "option"
3027
3018
  },
3028
- "start-time": {
3029
- "description": "Start time filter (ISO 8601)",
3030
- "name": "start-time",
3019
+ "customer-id": {
3020
+ "description": "Customer/user identifier for traces (e.g. your name or email)",
3021
+ "env": "RESPAN_CUSTOMER_ID",
3022
+ "name": "customer-id",
3031
3023
  "hasDynamicHelp": false,
3032
3024
  "multiple": false,
3033
3025
  "type": "option"
3034
3026
  },
3035
- "end-time": {
3036
- "description": "End time filter (ISO 8601)",
3037
- "name": "end-time",
3027
+ "span-name": {
3028
+ "description": "Root span name for traces (default: claude-code)",
3029
+ "name": "span-name",
3038
3030
  "hasDynamicHelp": false,
3039
3031
  "multiple": false,
3040
3032
  "type": "option"
3041
3033
  },
3042
- "environment": {
3043
- "description": "Environment filter",
3044
- "name": "environment",
3034
+ "workflow-name": {
3035
+ "description": "Workflow name for traces (default: claude-code)",
3036
+ "name": "workflow-name",
3045
3037
  "hasDynamicHelp": false,
3046
3038
  "multiple": false,
3047
3039
  "type": "option"
3048
3040
  },
3049
- "filter": {
3050
- "description": "Filter in field:operator:value format (repeatable)",
3051
- "name": "filter",
3052
- "hasDynamicHelp": false,
3053
- "multiple": true,
3054
- "type": "option"
3041
+ "dry-run": {
3042
+ "description": "Preview changes without writing files",
3043
+ "name": "dry-run",
3044
+ "allowNo": false,
3045
+ "type": "boolean"
3055
3046
  }
3056
3047
  },
3057
3048
  "hasDynamicHelp": false,
3058
3049
  "hiddenAliases": [],
3059
- "id": "traces:list",
3050
+ "id": "integrate:claude-code",
3060
3051
  "pluginAlias": "@respan/cli",
3061
3052
  "pluginName": "@respan/cli",
3062
3053
  "pluginType": "core",
@@ -3066,14 +3057,21 @@
3066
3057
  "relativePath": [
3067
3058
  "dist",
3068
3059
  "commands",
3069
- "traces",
3070
- "list.js"
3060
+ "integrate",
3061
+ "claude-code.js"
3071
3062
  ]
3072
3063
  },
3073
- "traces:summary": {
3064
+ "integrate:codex-cli": {
3074
3065
  "aliases": [],
3075
3066
  "args": {},
3076
- "description": "Get a summary of traces for a time range",
3067
+ "description": "Integrate Respan with Codex CLI.\n\nInstalls a notify hook that reads session JSONL files and sends\nthem to Respan as structured spans (chat, tool, reasoning).\n\nScope:\n --global Install hook script + register notify in ~/.codex/config.toml\n --local Write .codex/respan.json with customer_id, span_name, etc.\n (default) Both: install hook globally + config for current project",
3068
+ "examples": [
3069
+ "respan integrate codex-cli",
3070
+ "respan integrate codex-cli --global",
3071
+ "respan integrate codex-cli --local --customer-id frank",
3072
+ "respan integrate codex-cli --attrs '{\"env\":\"prod\"}'",
3073
+ "respan integrate codex-cli --dry-run"
3074
+ ],
3077
3075
  "flags": {
3078
3076
  "api-key": {
3079
3077
  "description": "API key (env: RESPAN_API_KEY)",
@@ -3109,111 +3107,80 @@
3109
3107
  "allowNo": false,
3110
3108
  "type": "boolean"
3111
3109
  },
3112
- "start-time": {
3113
- "description": "Start time (ISO 8601)",
3114
- "name": "start-time",
3115
- "required": true,
3116
- "hasDynamicHelp": false,
3117
- "multiple": false,
3118
- "type": "option"
3110
+ "local": {
3111
+ "description": "Write per-project config (default)",
3112
+ "exclusive": [
3113
+ "global"
3114
+ ],
3115
+ "name": "local",
3116
+ "allowNo": false,
3117
+ "type": "boolean"
3119
3118
  },
3120
- "end-time": {
3121
- "description": "End time (ISO 8601)",
3122
- "name": "end-time",
3123
- "required": true,
3124
- "hasDynamicHelp": false,
3125
- "multiple": false,
3126
- "type": "option"
3127
- }
3128
- },
3129
- "hasDynamicHelp": false,
3130
- "hiddenAliases": [],
3131
- "id": "traces:summary",
3132
- "pluginAlias": "@respan/cli",
3133
- "pluginName": "@respan/cli",
3134
- "pluginType": "core",
3135
- "strict": true,
3136
- "enableJsonFlag": false,
3137
- "isESM": true,
3138
- "relativePath": [
3139
- "dist",
3140
- "commands",
3141
- "traces",
3142
- "summary.js"
3143
- ]
3144
- },
3145
- "users:create": {
3146
- "aliases": [],
3147
- "args": {},
3148
- "description": "Create a new user (customer)",
3149
- "flags": {
3150
- "api-key": {
3151
- "description": "API key (env: RESPAN_API_KEY)",
3152
- "env": "RESPAN_API_KEY",
3153
- "name": "api-key",
3119
+ "global": {
3120
+ "description": "Write user-level global config",
3121
+ "exclusive": [
3122
+ "local"
3123
+ ],
3124
+ "name": "global",
3125
+ "allowNo": false,
3126
+ "type": "boolean"
3127
+ },
3128
+ "project-id": {
3129
+ "description": "Respan project ID (added to metadata / resource attributes)",
3130
+ "env": "RESPAN_PROJECT_ID",
3131
+ "name": "project-id",
3154
3132
  "hasDynamicHelp": false,
3155
3133
  "multiple": false,
3156
3134
  "type": "option"
3157
3135
  },
3158
- "profile": {
3159
- "description": "Named profile to use",
3160
- "name": "profile",
3136
+ "base-url": {
3137
+ "description": "Respan API base URL (for enterprise deployments)",
3138
+ "name": "base-url",
3139
+ "default": "https://api.respan.ai/api",
3161
3140
  "hasDynamicHelp": false,
3162
3141
  "multiple": false,
3163
3142
  "type": "option"
3164
3143
  },
3165
- "json": {
3166
- "description": "Output as JSON",
3167
- "name": "json",
3168
- "allowNo": false,
3169
- "type": "boolean"
3170
- },
3171
- "csv": {
3172
- "description": "Output as CSV",
3173
- "name": "csv",
3174
- "allowNo": false,
3175
- "type": "boolean"
3176
- },
3177
- "verbose": {
3178
- "char": "v",
3179
- "description": "Show verbose output",
3180
- "name": "verbose",
3181
- "allowNo": false,
3182
- "type": "boolean"
3183
- },
3184
- "identifier": {
3185
- "description": "Customer identifier",
3186
- "name": "identifier",
3187
- "required": true,
3144
+ "attrs": {
3145
+ "description": "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
3146
+ "name": "attrs",
3147
+ "default": "{}",
3188
3148
  "hasDynamicHelp": false,
3189
3149
  "multiple": false,
3190
3150
  "type": "option"
3191
3151
  },
3192
- "name": {
3193
- "description": "Customer name",
3194
- "name": "name",
3152
+ "customer-id": {
3153
+ "description": "Customer/user identifier for traces (e.g. your name or email)",
3154
+ "env": "RESPAN_CUSTOMER_ID",
3155
+ "name": "customer-id",
3195
3156
  "hasDynamicHelp": false,
3196
3157
  "multiple": false,
3197
3158
  "type": "option"
3198
3159
  },
3199
- "email": {
3200
- "description": "Customer email",
3201
- "name": "email",
3160
+ "span-name": {
3161
+ "description": "Root span name for traces (default: claude-code)",
3162
+ "name": "span-name",
3202
3163
  "hasDynamicHelp": false,
3203
3164
  "multiple": false,
3204
3165
  "type": "option"
3205
3166
  },
3206
- "metadata": {
3207
- "description": "Metadata as JSON string",
3208
- "name": "metadata",
3167
+ "workflow-name": {
3168
+ "description": "Workflow name for traces (default: claude-code)",
3169
+ "name": "workflow-name",
3209
3170
  "hasDynamicHelp": false,
3210
3171
  "multiple": false,
3211
3172
  "type": "option"
3173
+ },
3174
+ "dry-run": {
3175
+ "description": "Preview changes without writing files",
3176
+ "name": "dry-run",
3177
+ "allowNo": false,
3178
+ "type": "boolean"
3212
3179
  }
3213
3180
  },
3214
3181
  "hasDynamicHelp": false,
3215
3182
  "hiddenAliases": [],
3216
- "id": "users:create",
3183
+ "id": "integrate:codex-cli",
3217
3184
  "pluginAlias": "@respan/cli",
3218
3185
  "pluginName": "@respan/cli",
3219
3186
  "pluginType": "core",
@@ -3223,20 +3190,20 @@
3223
3190
  "relativePath": [
3224
3191
  "dist",
3225
3192
  "commands",
3226
- "users",
3227
- "create.js"
3193
+ "integrate",
3194
+ "codex-cli.js"
3228
3195
  ]
3229
3196
  },
3230
- "users:get": {
3197
+ "integrate:gemini-cli": {
3231
3198
  "aliases": [],
3232
- "args": {
3233
- "id": {
3234
- "description": "Customer identifier",
3235
- "name": "id",
3236
- "required": true
3237
- }
3238
- },
3239
- "description": "Get a specific user (customer)",
3199
+ "args": {},
3200
+ "description": "Integrate Respan with Gemini CLI.\n\nInstalls an AfterModel hook that captures LLM request/response data\nand sends it to Respan as structured spans with model, token counts,\nand input/output.\n\nScope:\n --global Write to ~/.gemini/settings.json (default)\n --local Write to .gemini/settings.json in project root\n\nNote: Gemini CLI ignores workspace-level telemetry settings, so\n--global is the default.",
3201
+ "examples": [
3202
+ "respan integrate gemini-cli",
3203
+ "respan integrate gemini-cli --local",
3204
+ "respan integrate gemini-cli --project-id my-project --attrs '{\"env\":\"prod\"}'",
3205
+ "respan integrate gemini-cli --dry-run"
3206
+ ],
3240
3207
  "flags": {
3241
3208
  "api-key": {
3242
3209
  "description": "API key (env: RESPAN_API_KEY)",
@@ -3271,97 +3238,81 @@
3271
3238
  "name": "verbose",
3272
3239
  "allowNo": false,
3273
3240
  "type": "boolean"
3274
- }
3275
- },
3276
- "hasDynamicHelp": false,
3277
- "hiddenAliases": [],
3278
- "id": "users:get",
3279
- "pluginAlias": "@respan/cli",
3280
- "pluginName": "@respan/cli",
3281
- "pluginType": "core",
3282
- "strict": true,
3283
- "enableJsonFlag": false,
3284
- "isESM": true,
3285
- "relativePath": [
3286
- "dist",
3287
- "commands",
3288
- "users",
3289
- "get.js"
3290
- ]
3291
- },
3292
- "users:list": {
3293
- "aliases": [],
3294
- "args": {},
3295
- "description": "List users (customers)",
3296
- "flags": {
3297
- "api-key": {
3298
- "description": "API key (env: RESPAN_API_KEY)",
3299
- "env": "RESPAN_API_KEY",
3300
- "name": "api-key",
3301
- "hasDynamicHelp": false,
3302
- "multiple": false,
3303
- "type": "option"
3304
- },
3305
- "profile": {
3306
- "description": "Named profile to use",
3307
- "name": "profile",
3308
- "hasDynamicHelp": false,
3309
- "multiple": false,
3310
- "type": "option"
3311
3241
  },
3312
- "json": {
3313
- "description": "Output as JSON",
3314
- "name": "json",
3242
+ "local": {
3243
+ "description": "Write per-project config (default)",
3244
+ "exclusive": [
3245
+ "global"
3246
+ ],
3247
+ "name": "local",
3315
3248
  "allowNo": false,
3316
3249
  "type": "boolean"
3317
3250
  },
3318
- "csv": {
3319
- "description": "Output as CSV",
3320
- "name": "csv",
3251
+ "global": {
3252
+ "description": "Write user-level global config",
3253
+ "exclusive": [
3254
+ "local"
3255
+ ],
3256
+ "name": "global",
3321
3257
  "allowNo": false,
3322
3258
  "type": "boolean"
3323
3259
  },
3324
- "verbose": {
3325
- "char": "v",
3326
- "description": "Show verbose output",
3327
- "name": "verbose",
3328
- "allowNo": false,
3329
- "type": "boolean"
3260
+ "project-id": {
3261
+ "description": "Respan project ID (added to metadata / resource attributes)",
3262
+ "env": "RESPAN_PROJECT_ID",
3263
+ "name": "project-id",
3264
+ "hasDynamicHelp": false,
3265
+ "multiple": false,
3266
+ "type": "option"
3330
3267
  },
3331
- "limit": {
3332
- "description": "Number of results per page",
3333
- "name": "limit",
3334
- "default": 20,
3268
+ "base-url": {
3269
+ "description": "Respan API base URL (for enterprise deployments)",
3270
+ "name": "base-url",
3271
+ "default": "https://api.respan.ai/api",
3335
3272
  "hasDynamicHelp": false,
3336
3273
  "multiple": false,
3337
3274
  "type": "option"
3338
3275
  },
3339
- "page": {
3340
- "description": "Page number",
3341
- "name": "page",
3342
- "default": 1,
3276
+ "attrs": {
3277
+ "description": "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
3278
+ "name": "attrs",
3279
+ "default": "{}",
3343
3280
  "hasDynamicHelp": false,
3344
3281
  "multiple": false,
3345
3282
  "type": "option"
3346
3283
  },
3347
- "sort-by": {
3348
- "description": "Sort field",
3349
- "name": "sort-by",
3284
+ "customer-id": {
3285
+ "description": "Customer/user identifier for traces (e.g. your name or email)",
3286
+ "env": "RESPAN_CUSTOMER_ID",
3287
+ "name": "customer-id",
3350
3288
  "hasDynamicHelp": false,
3351
3289
  "multiple": false,
3352
3290
  "type": "option"
3353
3291
  },
3354
- "environment": {
3355
- "description": "Environment filter",
3356
- "name": "environment",
3292
+ "span-name": {
3293
+ "description": "Root span name for traces (default: claude-code)",
3294
+ "name": "span-name",
3295
+ "hasDynamicHelp": false,
3296
+ "multiple": false,
3297
+ "type": "option"
3298
+ },
3299
+ "workflow-name": {
3300
+ "description": "Workflow name for traces (default: claude-code)",
3301
+ "name": "workflow-name",
3357
3302
  "hasDynamicHelp": false,
3358
3303
  "multiple": false,
3359
3304
  "type": "option"
3305
+ },
3306
+ "dry-run": {
3307
+ "description": "Preview changes without writing files",
3308
+ "name": "dry-run",
3309
+ "allowNo": false,
3310
+ "type": "boolean"
3360
3311
  }
3361
3312
  },
3362
3313
  "hasDynamicHelp": false,
3363
3314
  "hiddenAliases": [],
3364
- "id": "users:list",
3315
+ "id": "integrate:gemini-cli",
3365
3316
  "pluginAlias": "@respan/cli",
3366
3317
  "pluginName": "@respan/cli",
3367
3318
  "pluginType": "core",
@@ -3371,20 +3322,20 @@
3371
3322
  "relativePath": [
3372
3323
  "dist",
3373
3324
  "commands",
3374
- "users",
3375
- "list.js"
3325
+ "integrate",
3326
+ "gemini-cli.js"
3376
3327
  ]
3377
3328
  },
3378
- "users:update": {
3329
+ "integrate:opencode": {
3379
3330
  "aliases": [],
3380
- "args": {
3381
- "id": {
3382
- "description": "Customer identifier",
3383
- "name": "id",
3384
- "required": true
3385
- }
3386
- },
3387
- "description": "Update a user (customer)",
3331
+ "args": {},
3332
+ "description": "Integrate Respan with OpenCode.\n\nOpenCode's built-in OTel does not work reliably, so this uses the\ncommunity opencode-otel plugin instead.\n\nScope:\n --local Write plugin config to project root (default)\n --global Write to ~/.config/opencode/plugins/otel.json\n The opencode-otel package is always installed globally.",
3333
+ "examples": [
3334
+ "respan integrate opencode",
3335
+ "respan integrate opencode --global",
3336
+ "respan integrate opencode --project-id my-project --attrs '{\"env\":\"prod\"}'",
3337
+ "respan integrate opencode --dry-run"
3338
+ ],
3388
3339
  "flags": {
3389
3340
  "api-key": {
3390
3341
  "description": "API key (env: RESPAN_API_KEY)",
@@ -3420,31 +3371,80 @@
3420
3371
  "allowNo": false,
3421
3372
  "type": "boolean"
3422
3373
  },
3423
- "name": {
3424
- "description": "Customer name",
3425
- "name": "name",
3374
+ "local": {
3375
+ "description": "Write per-project config (default)",
3376
+ "exclusive": [
3377
+ "global"
3378
+ ],
3379
+ "name": "local",
3380
+ "allowNo": false,
3381
+ "type": "boolean"
3382
+ },
3383
+ "global": {
3384
+ "description": "Write user-level global config",
3385
+ "exclusive": [
3386
+ "local"
3387
+ ],
3388
+ "name": "global",
3389
+ "allowNo": false,
3390
+ "type": "boolean"
3391
+ },
3392
+ "project-id": {
3393
+ "description": "Respan project ID (added to metadata / resource attributes)",
3394
+ "env": "RESPAN_PROJECT_ID",
3395
+ "name": "project-id",
3426
3396
  "hasDynamicHelp": false,
3427
3397
  "multiple": false,
3428
3398
  "type": "option"
3429
3399
  },
3430
- "email": {
3431
- "description": "Customer email",
3432
- "name": "email",
3400
+ "base-url": {
3401
+ "description": "Respan API base URL (for enterprise deployments)",
3402
+ "name": "base-url",
3403
+ "default": "https://api.respan.ai/api",
3433
3404
  "hasDynamicHelp": false,
3434
3405
  "multiple": false,
3435
3406
  "type": "option"
3436
3407
  },
3437
- "metadata": {
3438
- "description": "Metadata as JSON string",
3439
- "name": "metadata",
3408
+ "attrs": {
3409
+ "description": "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
3410
+ "name": "attrs",
3411
+ "default": "{}",
3440
3412
  "hasDynamicHelp": false,
3441
3413
  "multiple": false,
3442
3414
  "type": "option"
3415
+ },
3416
+ "customer-id": {
3417
+ "description": "Customer/user identifier for traces (e.g. your name or email)",
3418
+ "env": "RESPAN_CUSTOMER_ID",
3419
+ "name": "customer-id",
3420
+ "hasDynamicHelp": false,
3421
+ "multiple": false,
3422
+ "type": "option"
3423
+ },
3424
+ "span-name": {
3425
+ "description": "Root span name for traces (default: claude-code)",
3426
+ "name": "span-name",
3427
+ "hasDynamicHelp": false,
3428
+ "multiple": false,
3429
+ "type": "option"
3430
+ },
3431
+ "workflow-name": {
3432
+ "description": "Workflow name for traces (default: claude-code)",
3433
+ "name": "workflow-name",
3434
+ "hasDynamicHelp": false,
3435
+ "multiple": false,
3436
+ "type": "option"
3437
+ },
3438
+ "dry-run": {
3439
+ "description": "Preview changes without writing files",
3440
+ "name": "dry-run",
3441
+ "allowNo": false,
3442
+ "type": "boolean"
3443
3443
  }
3444
3444
  },
3445
3445
  "hasDynamicHelp": false,
3446
3446
  "hiddenAliases": [],
3447
- "id": "users:update",
3447
+ "id": "integrate:opencode",
3448
3448
  "pluginAlias": "@respan/cli",
3449
3449
  "pluginName": "@respan/cli",
3450
3450
  "pluginType": "core",
@@ -3454,10 +3454,10 @@
3454
3454
  "relativePath": [
3455
3455
  "dist",
3456
3456
  "commands",
3457
- "users",
3458
- "update.js"
3457
+ "integrate",
3458
+ "opencode.js"
3459
3459
  ]
3460
3460
  }
3461
3461
  },
3462
- "version": "0.6.7"
3462
+ "version": "0.6.9"
3463
3463
  }