@respan/cli 0.6.7 → 0.6.8

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 +2 -0
  2. package/dist/hooks/gemini-cli.js +4 -0
  3. package/oclif.manifest.json +532 -532
  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,103 +2208,52 @@
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",
2328
- "hasDynamicHelp": false,
2329
- "multiple": false,
2330
- "type": "option"
2331
- },
2332
- "end-time": {
2333
- "description": "End time filter (ISO 8601)",
2334
- "name": "end-time",
2335
- "hasDynamicHelp": false,
2336
- "multiple": false,
2337
- "type": "option"
2338
- },
2339
- "filter": {
2340
- "description": "Filter in field:operator:value format (repeatable)",
2341
- "name": "filter",
2342
- "hasDynamicHelp": false,
2343
- "multiple": true,
2344
- "type": "option"
2345
- },
2346
- "all-envs": {
2347
- "description": "Include all environments (true/false)",
2348
- "name": "all-envs",
2349
- "hasDynamicHelp": false,
2350
- "multiple": false,
2351
- "type": "option"
2352
- },
2353
- "is-test": {
2354
- "description": "Filter by test (true) or production (false) environment",
2355
- "name": "is-test",
2356
- "hasDynamicHelp": false,
2357
- "multiple": false,
2358
- "type": "option"
2359
- },
2360
- "include-fields": {
2361
- "description": "Comma-separated fields to include in response",
2362
- "name": "include-fields",
2363
- "hasDynamicHelp": false,
2364
- "multiple": false,
2365
- "type": "option"
2366
- }
2367
- },
2368
- "hasDynamicHelp": false,
2369
- "hiddenAliases": [],
2370
- "id": "logs:list",
2371
- "pluginAlias": "@respan/cli",
2372
- "pluginName": "@respan/cli",
2373
- "pluginType": "core",
2374
- "strict": true,
2375
- "enableJsonFlag": false,
2376
- "isESM": true,
2377
- "relativePath": [
2378
- "dist",
2379
- "commands",
2380
- "logs",
2381
- "list.js"
2382
- ]
2383
- },
2384
- "logs:summary": {
2385
- "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",
2388
- "flags": {
2389
- "api-key": {
2390
- "description": "API key (env: RESPAN_API_KEY)",
2391
- "env": "RESPAN_API_KEY",
2392
- "name": "api-key",
2393
- "hasDynamicHelp": false,
2394
- "multiple": false,
2395
- "type": "option"
2396
- },
2397
- "profile": {
2398
- "description": "Named profile to use",
2399
- "name": "profile",
2254
+ "profile": {
2255
+ "description": "Named profile to use",
2256
+ "name": "profile",
2400
2257
  "hasDynamicHelp": false,
2401
2258
  "multiple": false,
2402
2259
  "type": "option"
@@ -2420,39 +2277,16 @@
2420
2277
  "allowNo": false,
2421
2278
  "type": "boolean"
2422
2279
  },
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",
2280
+ "name": {
2281
+ "description": "Prompt name",
2282
+ "name": "name",
2449
2283
  "hasDynamicHelp": false,
2450
2284
  "multiple": false,
2451
2285
  "type": "option"
2452
2286
  },
2453
- "is-test": {
2454
- "description": "Filter by test (true) or production (false) environment",
2455
- "name": "is-test",
2287
+ "description": {
2288
+ "description": "Prompt description",
2289
+ "name": "description",
2456
2290
  "hasDynamicHelp": false,
2457
2291
  "multiple": false,
2458
2292
  "type": "option"
@@ -2460,7 +2294,7 @@
2460
2294
  },
2461
2295
  "hasDynamicHelp": false,
2462
2296
  "hiddenAliases": [],
2463
- "id": "logs:summary",
2297
+ "id": "prompts:update",
2464
2298
  "pluginAlias": "@respan/cli",
2465
2299
  "pluginName": "@respan/cli",
2466
2300
  "pluginType": "core",
@@ -2470,11 +2304,11 @@
2470
2304
  "relativePath": [
2471
2305
  "dist",
2472
2306
  "commands",
2473
- "logs",
2474
- "summary.js"
2307
+ "prompts",
2308
+ "update.js"
2475
2309
  ]
2476
2310
  },
2477
- "prompts:create-version": {
2311
+ "prompts:versions": {
2478
2312
  "aliases": [],
2479
2313
  "args": {
2480
2314
  "prompt-id": {
@@ -2483,7 +2317,7 @@
2483
2317
  "required": true
2484
2318
  }
2485
2319
  },
2486
- "description": "Create a new version of a prompt",
2320
+ "description": "List versions of a prompt",
2487
2321
  "flags": {
2488
2322
  "api-key": {
2489
2323
  "description": "API key (env: RESPAN_API_KEY)",
@@ -2518,40 +2352,11 @@
2518
2352
  "name": "verbose",
2519
2353
  "allowNo": false,
2520
2354
  "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
2355
  }
2551
2356
  },
2552
2357
  "hasDynamicHelp": false,
2553
2358
  "hiddenAliases": [],
2554
- "id": "prompts:create-version",
2359
+ "id": "prompts:versions",
2555
2360
  "pluginAlias": "@respan/cli",
2556
2361
  "pluginName": "@respan/cli",
2557
2362
  "pluginType": "core",
@@ -2562,13 +2367,20 @@
2562
2367
  "dist",
2563
2368
  "commands",
2564
2369
  "prompts",
2565
- "create-version.js"
2370
+ "versions.js"
2566
2371
  ]
2567
2372
  },
2568
- "prompts:create": {
2373
+ "integrate:claude-code": {
2569
2374
  "aliases": [],
2570
2375
  "args": {},
2571
- "description": "Create a new prompt",
2376
+ "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",
2377
+ "examples": [
2378
+ "respan integrate claude-code",
2379
+ "respan integrate claude-code --global",
2380
+ "respan integrate claude-code --local --project-id my-project",
2381
+ "respan integrate claude-code --attrs '{\"env\":\"prod\"}'",
2382
+ "respan integrate claude-code --dry-run"
2383
+ ],
2572
2384
  "flags": {
2573
2385
  "api-key": {
2574
2386
  "description": "API key (env: RESPAN_API_KEY)",
@@ -2604,25 +2416,80 @@
2604
2416
  "allowNo": false,
2605
2417
  "type": "boolean"
2606
2418
  },
2607
- "name": {
2608
- "description": "Prompt name",
2609
- "name": "name",
2610
- "required": true,
2419
+ "local": {
2420
+ "description": "Write per-project config (default)",
2421
+ "exclusive": [
2422
+ "global"
2423
+ ],
2424
+ "name": "local",
2425
+ "allowNo": false,
2426
+ "type": "boolean"
2427
+ },
2428
+ "global": {
2429
+ "description": "Write user-level global config",
2430
+ "exclusive": [
2431
+ "local"
2432
+ ],
2433
+ "name": "global",
2434
+ "allowNo": false,
2435
+ "type": "boolean"
2436
+ },
2437
+ "project-id": {
2438
+ "description": "Respan project ID (added to metadata / resource attributes)",
2439
+ "env": "RESPAN_PROJECT_ID",
2440
+ "name": "project-id",
2611
2441
  "hasDynamicHelp": false,
2612
2442
  "multiple": false,
2613
2443
  "type": "option"
2614
2444
  },
2615
- "description": {
2616
- "description": "Prompt description",
2617
- "name": "description",
2445
+ "base-url": {
2446
+ "description": "Respan API base URL (for enterprise deployments)",
2447
+ "name": "base-url",
2448
+ "default": "https://api.respan.ai/api",
2449
+ "hasDynamicHelp": false,
2450
+ "multiple": false,
2451
+ "type": "option"
2452
+ },
2453
+ "attrs": {
2454
+ "description": "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
2455
+ "name": "attrs",
2456
+ "default": "{}",
2457
+ "hasDynamicHelp": false,
2458
+ "multiple": false,
2459
+ "type": "option"
2460
+ },
2461
+ "customer-id": {
2462
+ "description": "Customer/user identifier for traces (e.g. your name or email)",
2463
+ "env": "RESPAN_CUSTOMER_ID",
2464
+ "name": "customer-id",
2465
+ "hasDynamicHelp": false,
2466
+ "multiple": false,
2467
+ "type": "option"
2468
+ },
2469
+ "span-name": {
2470
+ "description": "Root span name for traces (default: claude-code)",
2471
+ "name": "span-name",
2472
+ "hasDynamicHelp": false,
2473
+ "multiple": false,
2474
+ "type": "option"
2475
+ },
2476
+ "workflow-name": {
2477
+ "description": "Workflow name for traces (default: claude-code)",
2478
+ "name": "workflow-name",
2618
2479
  "hasDynamicHelp": false,
2619
2480
  "multiple": false,
2620
2481
  "type": "option"
2482
+ },
2483
+ "dry-run": {
2484
+ "description": "Preview changes without writing files",
2485
+ "name": "dry-run",
2486
+ "allowNo": false,
2487
+ "type": "boolean"
2621
2488
  }
2622
2489
  },
2623
2490
  "hasDynamicHelp": false,
2624
2491
  "hiddenAliases": [],
2625
- "id": "prompts:create",
2492
+ "id": "integrate:claude-code",
2626
2493
  "pluginAlias": "@respan/cli",
2627
2494
  "pluginName": "@respan/cli",
2628
2495
  "pluginType": "core",
@@ -2632,20 +2499,21 @@
2632
2499
  "relativePath": [
2633
2500
  "dist",
2634
2501
  "commands",
2635
- "prompts",
2636
- "create.js"
2502
+ "integrate",
2503
+ "claude-code.js"
2637
2504
  ]
2638
2505
  },
2639
- "prompts:get": {
2506
+ "integrate:codex-cli": {
2640
2507
  "aliases": [],
2641
- "args": {
2642
- "id": {
2643
- "description": "Prompt ID",
2644
- "name": "id",
2645
- "required": true
2646
- }
2647
- },
2648
- "description": "Get a specific prompt",
2508
+ "args": {},
2509
+ "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",
2510
+ "examples": [
2511
+ "respan integrate codex-cli",
2512
+ "respan integrate codex-cli --global",
2513
+ "respan integrate codex-cli --local --customer-id frank",
2514
+ "respan integrate codex-cli --attrs '{\"env\":\"prod\"}'",
2515
+ "respan integrate codex-cli --dry-run"
2516
+ ],
2649
2517
  "flags": {
2650
2518
  "api-key": {
2651
2519
  "description": "API key (env: RESPAN_API_KEY)",
@@ -2680,75 +2548,81 @@
2680
2548
  "name": "verbose",
2681
2549
  "allowNo": false,
2682
2550
  "type": "boolean"
2683
- }
2684
- },
2685
- "hasDynamicHelp": false,
2686
- "hiddenAliases": [],
2687
- "id": "prompts:get",
2688
- "pluginAlias": "@respan/cli",
2689
- "pluginName": "@respan/cli",
2690
- "pluginType": "core",
2691
- "strict": true,
2692
- "enableJsonFlag": false,
2693
- "isESM": true,
2694
- "relativePath": [
2695
- "dist",
2696
- "commands",
2697
- "prompts",
2698
- "get.js"
2699
- ]
2700
- },
2701
- "prompts:list": {
2702
- "aliases": [],
2703
- "args": {},
2704
- "description": "List prompts",
2705
- "flags": {
2706
- "api-key": {
2707
- "description": "API key (env: RESPAN_API_KEY)",
2708
- "env": "RESPAN_API_KEY",
2709
- "name": "api-key",
2551
+ },
2552
+ "local": {
2553
+ "description": "Write per-project config (default)",
2554
+ "exclusive": [
2555
+ "global"
2556
+ ],
2557
+ "name": "local",
2558
+ "allowNo": false,
2559
+ "type": "boolean"
2560
+ },
2561
+ "global": {
2562
+ "description": "Write user-level global config",
2563
+ "exclusive": [
2564
+ "local"
2565
+ ],
2566
+ "name": "global",
2567
+ "allowNo": false,
2568
+ "type": "boolean"
2569
+ },
2570
+ "project-id": {
2571
+ "description": "Respan project ID (added to metadata / resource attributes)",
2572
+ "env": "RESPAN_PROJECT_ID",
2573
+ "name": "project-id",
2710
2574
  "hasDynamicHelp": false,
2711
2575
  "multiple": false,
2712
2576
  "type": "option"
2713
2577
  },
2714
- "profile": {
2715
- "description": "Named profile to use",
2716
- "name": "profile",
2578
+ "base-url": {
2579
+ "description": "Respan API base URL (for enterprise deployments)",
2580
+ "name": "base-url",
2581
+ "default": "https://api.respan.ai/api",
2717
2582
  "hasDynamicHelp": false,
2718
2583
  "multiple": false,
2719
2584
  "type": "option"
2720
2585
  },
2721
- "json": {
2722
- "description": "Output as JSON",
2723
- "name": "json",
2724
- "allowNo": false,
2725
- "type": "boolean"
2586
+ "attrs": {
2587
+ "description": "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
2588
+ "name": "attrs",
2589
+ "default": "{}",
2590
+ "hasDynamicHelp": false,
2591
+ "multiple": false,
2592
+ "type": "option"
2726
2593
  },
2727
- "csv": {
2728
- "description": "Output as CSV",
2729
- "name": "csv",
2730
- "allowNo": false,
2731
- "type": "boolean"
2594
+ "customer-id": {
2595
+ "description": "Customer/user identifier for traces (e.g. your name or email)",
2596
+ "env": "RESPAN_CUSTOMER_ID",
2597
+ "name": "customer-id",
2598
+ "hasDynamicHelp": false,
2599
+ "multiple": false,
2600
+ "type": "option"
2732
2601
  },
2733
- "verbose": {
2734
- "char": "v",
2735
- "description": "Show verbose output",
2736
- "name": "verbose",
2737
- "allowNo": false,
2738
- "type": "boolean"
2602
+ "span-name": {
2603
+ "description": "Root span name for traces (default: claude-code)",
2604
+ "name": "span-name",
2605
+ "hasDynamicHelp": false,
2606
+ "multiple": false,
2607
+ "type": "option"
2739
2608
  },
2740
- "limit": {
2741
- "description": "Number of results per page",
2742
- "name": "limit",
2743
- "default": 50,
2609
+ "workflow-name": {
2610
+ "description": "Workflow name for traces (default: claude-code)",
2611
+ "name": "workflow-name",
2744
2612
  "hasDynamicHelp": false,
2745
2613
  "multiple": false,
2746
2614
  "type": "option"
2615
+ },
2616
+ "dry-run": {
2617
+ "description": "Preview changes without writing files",
2618
+ "name": "dry-run",
2619
+ "allowNo": false,
2620
+ "type": "boolean"
2747
2621
  }
2748
2622
  },
2749
2623
  "hasDynamicHelp": false,
2750
2624
  "hiddenAliases": [],
2751
- "id": "prompts:list",
2625
+ "id": "integrate:codex-cli",
2752
2626
  "pluginAlias": "@respan/cli",
2753
2627
  "pluginName": "@respan/cli",
2754
2628
  "pluginType": "core",
@@ -2758,20 +2632,20 @@
2758
2632
  "relativePath": [
2759
2633
  "dist",
2760
2634
  "commands",
2761
- "prompts",
2762
- "list.js"
2635
+ "integrate",
2636
+ "codex-cli.js"
2763
2637
  ]
2764
2638
  },
2765
- "prompts:update": {
2639
+ "integrate:gemini-cli": {
2766
2640
  "aliases": [],
2767
- "args": {
2768
- "id": {
2769
- "description": "Prompt ID",
2770
- "name": "id",
2771
- "required": true
2772
- }
2773
- },
2774
- "description": "Update a prompt",
2641
+ "args": {},
2642
+ "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.",
2643
+ "examples": [
2644
+ "respan integrate gemini-cli",
2645
+ "respan integrate gemini-cli --local",
2646
+ "respan integrate gemini-cli --project-id my-project --attrs '{\"env\":\"prod\"}'",
2647
+ "respan integrate gemini-cli --dry-run"
2648
+ ],
2775
2649
  "flags": {
2776
2650
  "api-key": {
2777
2651
  "description": "API key (env: RESPAN_API_KEY)",
@@ -2807,24 +2681,80 @@
2807
2681
  "allowNo": false,
2808
2682
  "type": "boolean"
2809
2683
  },
2810
- "name": {
2811
- "description": "Prompt name",
2812
- "name": "name",
2684
+ "local": {
2685
+ "description": "Write per-project config (default)",
2686
+ "exclusive": [
2687
+ "global"
2688
+ ],
2689
+ "name": "local",
2690
+ "allowNo": false,
2691
+ "type": "boolean"
2692
+ },
2693
+ "global": {
2694
+ "description": "Write user-level global config",
2695
+ "exclusive": [
2696
+ "local"
2697
+ ],
2698
+ "name": "global",
2699
+ "allowNo": false,
2700
+ "type": "boolean"
2701
+ },
2702
+ "project-id": {
2703
+ "description": "Respan project ID (added to metadata / resource attributes)",
2704
+ "env": "RESPAN_PROJECT_ID",
2705
+ "name": "project-id",
2813
2706
  "hasDynamicHelp": false,
2814
2707
  "multiple": false,
2815
2708
  "type": "option"
2816
2709
  },
2817
- "description": {
2818
- "description": "Prompt description",
2819
- "name": "description",
2710
+ "base-url": {
2711
+ "description": "Respan API base URL (for enterprise deployments)",
2712
+ "name": "base-url",
2713
+ "default": "https://api.respan.ai/api",
2714
+ "hasDynamicHelp": false,
2715
+ "multiple": false,
2716
+ "type": "option"
2717
+ },
2718
+ "attrs": {
2719
+ "description": "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
2720
+ "name": "attrs",
2721
+ "default": "{}",
2722
+ "hasDynamicHelp": false,
2723
+ "multiple": false,
2724
+ "type": "option"
2725
+ },
2726
+ "customer-id": {
2727
+ "description": "Customer/user identifier for traces (e.g. your name or email)",
2728
+ "env": "RESPAN_CUSTOMER_ID",
2729
+ "name": "customer-id",
2730
+ "hasDynamicHelp": false,
2731
+ "multiple": false,
2732
+ "type": "option"
2733
+ },
2734
+ "span-name": {
2735
+ "description": "Root span name for traces (default: claude-code)",
2736
+ "name": "span-name",
2737
+ "hasDynamicHelp": false,
2738
+ "multiple": false,
2739
+ "type": "option"
2740
+ },
2741
+ "workflow-name": {
2742
+ "description": "Workflow name for traces (default: claude-code)",
2743
+ "name": "workflow-name",
2820
2744
  "hasDynamicHelp": false,
2821
2745
  "multiple": false,
2822
2746
  "type": "option"
2747
+ },
2748
+ "dry-run": {
2749
+ "description": "Preview changes without writing files",
2750
+ "name": "dry-run",
2751
+ "allowNo": false,
2752
+ "type": "boolean"
2823
2753
  }
2824
2754
  },
2825
2755
  "hasDynamicHelp": false,
2826
2756
  "hiddenAliases": [],
2827
- "id": "prompts:update",
2757
+ "id": "integrate:gemini-cli",
2828
2758
  "pluginAlias": "@respan/cli",
2829
2759
  "pluginName": "@respan/cli",
2830
2760
  "pluginType": "core",
@@ -2834,20 +2764,20 @@
2834
2764
  "relativePath": [
2835
2765
  "dist",
2836
2766
  "commands",
2837
- "prompts",
2838
- "update.js"
2767
+ "integrate",
2768
+ "gemini-cli.js"
2839
2769
  ]
2840
2770
  },
2841
- "prompts:versions": {
2771
+ "integrate:opencode": {
2842
2772
  "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",
2773
+ "args": {},
2774
+ "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.",
2775
+ "examples": [
2776
+ "respan integrate opencode",
2777
+ "respan integrate opencode --global",
2778
+ "respan integrate opencode --project-id my-project --attrs '{\"env\":\"prod\"}'",
2779
+ "respan integrate opencode --dry-run"
2780
+ ],
2851
2781
  "flags": {
2852
2782
  "api-key": {
2853
2783
  "description": "API key (env: RESPAN_API_KEY)",
@@ -2882,11 +2812,81 @@
2882
2812
  "name": "verbose",
2883
2813
  "allowNo": false,
2884
2814
  "type": "boolean"
2815
+ },
2816
+ "local": {
2817
+ "description": "Write per-project config (default)",
2818
+ "exclusive": [
2819
+ "global"
2820
+ ],
2821
+ "name": "local",
2822
+ "allowNo": false,
2823
+ "type": "boolean"
2824
+ },
2825
+ "global": {
2826
+ "description": "Write user-level global config",
2827
+ "exclusive": [
2828
+ "local"
2829
+ ],
2830
+ "name": "global",
2831
+ "allowNo": false,
2832
+ "type": "boolean"
2833
+ },
2834
+ "project-id": {
2835
+ "description": "Respan project ID (added to metadata / resource attributes)",
2836
+ "env": "RESPAN_PROJECT_ID",
2837
+ "name": "project-id",
2838
+ "hasDynamicHelp": false,
2839
+ "multiple": false,
2840
+ "type": "option"
2841
+ },
2842
+ "base-url": {
2843
+ "description": "Respan API base URL (for enterprise deployments)",
2844
+ "name": "base-url",
2845
+ "default": "https://api.respan.ai/api",
2846
+ "hasDynamicHelp": false,
2847
+ "multiple": false,
2848
+ "type": "option"
2849
+ },
2850
+ "attrs": {
2851
+ "description": "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
2852
+ "name": "attrs",
2853
+ "default": "{}",
2854
+ "hasDynamicHelp": false,
2855
+ "multiple": false,
2856
+ "type": "option"
2857
+ },
2858
+ "customer-id": {
2859
+ "description": "Customer/user identifier for traces (e.g. your name or email)",
2860
+ "env": "RESPAN_CUSTOMER_ID",
2861
+ "name": "customer-id",
2862
+ "hasDynamicHelp": false,
2863
+ "multiple": false,
2864
+ "type": "option"
2865
+ },
2866
+ "span-name": {
2867
+ "description": "Root span name for traces (default: claude-code)",
2868
+ "name": "span-name",
2869
+ "hasDynamicHelp": false,
2870
+ "multiple": false,
2871
+ "type": "option"
2872
+ },
2873
+ "workflow-name": {
2874
+ "description": "Workflow name for traces (default: claude-code)",
2875
+ "name": "workflow-name",
2876
+ "hasDynamicHelp": false,
2877
+ "multiple": false,
2878
+ "type": "option"
2879
+ },
2880
+ "dry-run": {
2881
+ "description": "Preview changes without writing files",
2882
+ "name": "dry-run",
2883
+ "allowNo": false,
2884
+ "type": "boolean"
2885
2885
  }
2886
2886
  },
2887
2887
  "hasDynamicHelp": false,
2888
2888
  "hiddenAliases": [],
2889
- "id": "prompts:versions",
2889
+ "id": "integrate:opencode",
2890
2890
  "pluginAlias": "@respan/cli",
2891
2891
  "pluginName": "@respan/cli",
2892
2892
  "pluginType": "core",
@@ -2896,8 +2896,8 @@
2896
2896
  "relativePath": [
2897
2897
  "dist",
2898
2898
  "commands",
2899
- "prompts",
2900
- "versions.js"
2899
+ "integrate",
2900
+ "opencode.js"
2901
2901
  ]
2902
2902
  },
2903
2903
  "traces:get": {
@@ -3459,5 +3459,5 @@
3459
3459
  ]
3460
3460
  }
3461
3461
  },
3462
- "version": "0.6.7"
3462
+ "version": "0.6.8"
3463
3463
  }