@kingingwang/pi-darwin-arm64 0.87.0 → 0.99.1

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 (77) hide show
  1. package/bin/CHANGELOG.md +121 -0
  2. package/bin/README.md +25 -711
  3. package/bin/docs/cli-integration.md +106 -0
  4. package/bin/docs/cli.md +329 -0
  5. package/bin/docs/compaction.md +22 -22
  6. package/bin/docs/configuration.md +47 -0
  7. package/bin/docs/containerization.md +109 -82
  8. package/bin/docs/custom-provider.md +109 -722
  9. package/bin/docs/docs.json +147 -99
  10. package/bin/docs/environment-variables.md +3 -5
  11. package/bin/docs/extensions.md +165 -2996
  12. package/bin/docs/how-pi-works.md +49 -0
  13. package/bin/docs/images/interactive-mode.png +0 -0
  14. package/bin/docs/index.md +24 -69
  15. package/bin/docs/json.md +193 -65
  16. package/bin/docs/keybindings.md +58 -103
  17. package/bin/docs/llama-cpp.md +16 -3
  18. package/bin/docs/mcp.md +188 -0
  19. package/bin/docs/message-types.md +261 -0
  20. package/bin/docs/models.md +81 -556
  21. package/bin/docs/packages.md +67 -166
  22. package/bin/docs/prompt-templates.md +31 -68
  23. package/bin/docs/providers.md +103 -240
  24. package/bin/docs/quickstart.md +61 -106
  25. package/bin/docs/rpc-commands.md +860 -0
  26. package/bin/docs/rpc-extension-ui.md +200 -0
  27. package/bin/docs/rpc.md +130 -1555
  28. package/bin/docs/sdk.md +79 -1169
  29. package/bin/docs/security.md +72 -32
  30. package/bin/docs/session-format.md +15 -215
  31. package/bin/docs/sessions.md +35 -141
  32. package/bin/docs/settings.md +117 -377
  33. package/bin/docs/shell-aliases.md +85 -5
  34. package/bin/docs/skills.md +51 -190
  35. package/bin/docs/slash-commands.md +60 -0
  36. package/bin/docs/terminal-setup.md +105 -78
  37. package/bin/docs/termux.md +74 -83
  38. package/bin/docs/themes.md +88 -274
  39. package/bin/docs/tmux.md +31 -39
  40. package/bin/docs/tui.md +74 -910
  41. package/bin/docs/usage.md +54 -272
  42. package/bin/docs/virtual-models.md +114 -0
  43. package/bin/docs/windows.md +45 -17
  44. package/bin/examples/README.md +13 -2
  45. package/bin/examples/extensions/README.md +2 -0
  46. package/bin/examples/extensions/custom-provider-anthropic/package-lock.json +2 -2
  47. package/bin/examples/extensions/custom-provider-anthropic/package.json +1 -1
  48. package/bin/examples/extensions/custom-provider-gitlab-duo/package.json +1 -1
  49. package/bin/examples/extensions/custom-provider-gitlab-duo/test.ts +5 -5
  50. package/bin/examples/extensions/debug-provider.ts +90 -0
  51. package/bin/examples/extensions/gondolin/package-lock.json +2 -2
  52. package/bin/examples/extensions/gondolin/package.json +1 -1
  53. package/bin/examples/extensions/jev-router.ts +113 -0
  54. package/bin/examples/extensions/sandbox/package-lock.json +2 -2
  55. package/bin/examples/extensions/sandbox/package.json +1 -1
  56. package/bin/examples/extensions/with-deps/package-lock.json +2 -2
  57. package/bin/examples/extensions/with-deps/package.json +1 -1
  58. package/bin/examples/rpc-client.ts +35 -0
  59. package/bin/examples/rpc-extension-ui.ts +26 -6
  60. package/bin/examples/sdk/14-codemode-mcp.ts +61 -0
  61. package/bin/examples/sdk/README.md +3 -2
  62. package/bin/export-html/ansi-to-html.d.ts.map +1 -1
  63. package/bin/export-html/ansi-to-html.js.map +1 -1
  64. package/bin/export-html/index.d.ts.map +1 -1
  65. package/bin/export-html/index.js.map +1 -1
  66. package/bin/export-html/template.css +10 -0
  67. package/bin/export-html/template.js +66 -17
  68. package/bin/export-html/tool-renderer.d.ts.map +1 -1
  69. package/bin/export-html/tool-renderer.js.map +1 -1
  70. package/bin/native/darwin/prebuilds/darwin-arm64/darwin-platform.node +0 -0
  71. package/bin/package.json +14 -12
  72. package/bin/pi +2 -2
  73. package/bin/theme/dark.json +59 -72
  74. package/bin/theme/light.json +57 -69
  75. package/bin/theme/theme-schema.json +7 -2
  76. package/package.json +1 -1
  77. package/bin/docs/development.md +0 -90
@@ -1,90 +1,78 @@
1
1
  {
2
2
  "$schema": "https://raw.githubusercontent.com/earendil-works/pi/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
3
3
  "name": "light",
4
+ "appearance": "light",
4
5
  "vars": {
5
- "teal": "#5a8080",
6
- "blue": "#547da7",
7
- "green": "#588458",
8
- "red": "#aa5555",
9
- "yellow": "#9a7326",
10
- "text": "#1f2328",
11
- "mediumGray": "#6c6c6c",
12
- "dimGray": "#767676",
13
- "lightGray": "#b0b0b0",
14
- "selectedBg": "#d0d0e0",
15
- "userMsgBg": "#e8e8e8",
16
- "toolPendingBg": "#e8e8f0",
17
- "toolSuccessBg": "#e8f0e8",
18
- "toolErrorBg": "#f0e8e8",
19
- "customMsgBg": "#ede7f6"
6
+ "text": "okhsl(225 5% 27%)",
7
+ "muted": "okhsl(229 8% 47%)",
8
+ "violet": "okhsl(295 60% 46%)",
9
+ "blue": "okhsl(231 68% 47%)",
10
+ "green": "okhsl(159 75% 46%)",
11
+ "red": "okhsl(20 91% 47%)",
12
+ "yellow": "okhsl(83 99% 47%)",
13
+ "blueBg": "okhsl(235 19% 91%)"
20
14
  },
21
15
  "colors": {
22
- "accent": "teal",
23
- "border": "blue",
24
- "borderAccent": "teal",
25
- "borderMuted": "lightGray",
16
+ "accent": "violet",
17
+ "border": "okhsl(231 67% 55%)",
18
+ "borderAccent": "okhsl(295 59% 55%)",
19
+ "borderMuted": "okhsl(235 7% 66%)",
26
20
  "success": "green",
27
21
  "error": "red",
28
22
  "warning": "yellow",
29
- "muted": "mediumGray",
30
- "dim": "dimGray",
23
+ "muted": "muted",
24
+ "dim": "okhsl(229 7% 59%)",
31
25
  "text": "text",
32
- "thinkingText": "mediumGray",
33
-
34
- "selectedBg": "selectedBg",
35
- "scrollbarTrack": "lightGray",
36
- "scrollbarThumb": "text",
37
- "searchMatchBg": "selectedBg",
38
- "searchMatchText": "text",
39
- "userMessageBg": "userMsgBg",
26
+ "thinkingText": "okhsl(234 8% 55%)",
27
+ "selectedBg": "blueBg",
28
+ "scrollbarTrack": "okhsl(248 3% 90%)",
29
+ "scrollbarThumb": "okhsl(226 7% 65%)",
30
+ "searchMatchBg": "okhsl(56 22% 91%)",
31
+ "searchMatchText": "muted",
32
+ "userMessageBg": "blueBg",
40
33
  "userMessageText": "text",
41
- "customMessageBg": "customMsgBg",
42
- "customMessageText": "text",
43
- "customMessageLabel": "#7e57c2",
44
- "toolPendingBg": "toolPendingBg",
45
- "toolSuccessBg": "toolSuccessBg",
46
- "toolErrorBg": "toolErrorBg",
34
+ "customMessageBg": "okhsl(295 25% 91%)",
35
+ "customMessageText": "muted",
36
+ "customMessageLabel": "violet",
37
+ "toolPendingBg": "okhsl(248 3% 91%)",
38
+ "toolSuccessBg": "okhsl(156 21% 91%)",
39
+ "toolErrorBg": "okhsl(24 23% 91%)",
47
40
  "toolTitle": "text",
48
- "toolOutput": "mediumGray",
49
-
41
+ "toolOutput": "muted",
50
42
  "mdHeading": "yellow",
51
43
  "mdLink": "blue",
52
- "mdLinkUrl": "dimGray",
53
- "mdCode": "teal",
44
+ "mdLinkUrl": "muted",
45
+ "mdCode": "violet",
54
46
  "mdCodeBlock": "green",
55
- "mdCodeBlockBorder": "mediumGray",
56
- "mdQuote": "mediumGray",
57
- "mdQuoteBorder": "mediumGray",
58
- "mdHr": "mediumGray",
59
- "mdListBullet": "green",
60
-
47
+ "mdCodeBlockBorder": "muted",
48
+ "mdQuote": "muted",
49
+ "mdQuoteBorder": "muted",
50
+ "mdHr": "muted",
51
+ "mdListBullet": "violet",
61
52
  "toolDiffAdded": "green",
62
53
  "toolDiffRemoved": "red",
63
- "toolDiffContext": "mediumGray",
64
-
65
- "syntaxComment": "#008000",
66
- "syntaxKeyword": "#0000FF",
67
- "syntaxFunction": "#795E26",
68
- "syntaxVariable": "#001080",
69
- "syntaxString": "#A31515",
70
- "syntaxNumber": "#098658",
71
- "syntaxType": "#267F99",
72
- "syntaxOperator": "#000000",
73
- "syntaxPunctuation": "#000000",
74
-
75
- "thinkingOff": "lightGray",
76
- "thinkingMinimal": "#767676",
77
- "thinkingLow": "blue",
78
- "thinkingMedium": "teal",
79
- "thinkingHigh": "#875f87",
80
- "thinkingXhigh": "#8b008b",
81
- "thinkingMax": "#af005f",
82
-
83
- "bashMode": "green"
54
+ "toolDiffContext": "muted",
55
+ "syntaxComment": "muted",
56
+ "syntaxKeyword": "blue",
57
+ "syntaxFunction": "yellow",
58
+ "syntaxVariable": "okhsl(203 73% 46%)",
59
+ "syntaxString": "okhsl(52 84% 46%)",
60
+ "syntaxNumber": "green",
61
+ "syntaxType": "violet",
62
+ "syntaxOperator": "muted",
63
+ "syntaxPunctuation": "muted",
64
+ "thinkingOff": "okhsl(223 5% 80%)",
65
+ "thinkingMinimal": "okhsl(229 14% 78%)",
66
+ "thinkingLow": "okhsl(232 33% 76%)",
67
+ "thinkingMedium": "okhsl(264 48% 74%)",
68
+ "thinkingHigh": "okhsl(295 62% 72%)",
69
+ "thinkingXhigh": "okhsl(337 74% 70%)",
70
+ "thinkingMax": "okhsl(20 98% 68%)",
71
+ "bashMode": "okhsl(159 74% 55%)"
84
72
  },
85
73
  "export": {
86
- "pageBg": "#f8f8f8",
87
- "cardBg": "#ffffff",
88
- "infoBg": "#fffae6"
74
+ "pageBg": "okhsl(17 3% 94%)",
75
+ "cardBg": "okhsl(17 5% 97%)",
76
+ "infoBg": "okhsl(56 22% 91%)"
89
77
  }
90
78
  }
@@ -14,6 +14,11 @@
14
14
  "pattern": "^[^/]+$",
15
15
  "description": "Theme name. Must not contain '/' because it is reserved for automatic light/dark theme settings."
16
16
  },
17
+ "appearance": {
18
+ "type": "string",
19
+ "enum": ["dark", "light"],
20
+ "description": "Background the theme is designed for. Detected from the theme colors when omitted."
21
+ },
17
22
  "vars": {
18
23
  "type": "object",
19
24
  "description": "Reusable color variables",
@@ -21,7 +26,7 @@
21
26
  "oneOf": [
22
27
  {
23
28
  "type": "string",
24
- "description": "Hex color (#RRGGBB), variable reference, or empty string for terminal default"
29
+ "description": "Hex color (#RGB or #RRGGBB), OKLCH or OKHSL color, variable reference, or empty string for terminal default"
25
30
  },
26
31
  {
27
32
  "type": "integer",
@@ -342,7 +347,7 @@
342
347
  "oneOf": [
343
348
  {
344
349
  "type": "string",
345
- "description": "Hex color (#RRGGBB), variable reference, or empty string for terminal default"
350
+ "description": "Hex color (#RGB or #RRGGBB), OKLCH or OKHSL color, variable reference, or empty string for terminal default"
346
351
  },
347
352
  {
348
353
  "type": "integer",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@kingingwang/pi-darwin-arm64",
3
- "version": "0.87.0",
3
+ "version": "0.99.1",
4
4
  "description": "Pi standalone binary for darwin-arm64 (fork distribution)",
5
5
  "license": "MIT",
6
6
  "os": [
@@ -1,90 +0,0 @@
1
- # Development
2
-
3
- See [AGENTS.md](https://github.com/earendil-works/pi/blob/main/AGENTS.md) for additional guidelines.
4
-
5
- ## Setup
6
-
7
- ```bash
8
- git clone https://github.com/earendil-works/pi
9
- cd pi
10
- npm install
11
- npm run build
12
- ```
13
-
14
- Run from source:
15
-
16
- ```bash
17
- /path/to/pi/pi-test.sh
18
- ```
19
-
20
- The script can be run from any directory. Pi keeps the caller's current working directory.
21
-
22
- ### Experimental remote harness
23
-
24
- The remote harness server/client integration is development-only. Run it from the repository with:
25
-
26
- ```bash
27
- PI_EXPERIMENTAL=1 ./pi-test.sh server
28
- PI_EXPERIMENTAL=1 ./pi-test.sh client
29
- ```
30
-
31
- `PI_SERVER_DIR` overrides the server profile and socket directory (default: `~/.pi/server`). `PI_SERVER_ID` selects the logical server ID when `--server-id` is omitted.
32
-
33
- The `client` and `experimental/plugin` package subpaths resolve only under the `source` condition in a checkout. Their implementations and the server/client commands are excluded from npm packages and standalone binaries. `pi-client`, `pi-protocol`, and `pi-server` are development dependencies of coding-agent, not runtime dependencies. The local SDK and stdio RPC API are unchanged.
34
-
35
- ## Forking / Rebranding
36
-
37
- Configure via `package.json`:
38
-
39
- ```json
40
- {
41
- "piConfig": {
42
- "name": "pi",
43
- "configDir": ".pi"
44
- }
45
- }
46
- ```
47
-
48
- Change `name`, `configDir`, and `bin` field for your fork. Affects CLI banner, config paths, and environment variable names.
49
-
50
- ## Path Resolution
51
-
52
- Three execution modes: npm install, standalone binary, tsx from source.
53
-
54
- **Always use `src/config.ts`** for package assets:
55
-
56
- ```typescript
57
- import { getPackageDir, getThemeDir } from "./config.js";
58
- ```
59
-
60
- Never use `__dirname` directly for package assets.
61
-
62
- ## Debug Command
63
-
64
- `/debug` (hidden) writes to `~/.pi/agent/pi-debug.log`:
65
- - Rendered TUI lines with ANSI codes
66
- - Last messages sent to the LLM
67
-
68
- ## Testing
69
-
70
- ```bash
71
- ./test.sh # Run non-LLM tests (no API keys needed)
72
- npm test # Run all tests
73
- npm test -- test/specific.test.ts # Run specific test
74
- ```
75
-
76
- ### Published package smoke test
77
-
78
- After building, run `npm run check:package-install`. It packs the public packages and installs only coding-agent as a direct dependency in a temporary directory outside the repository. Local tarball overrides select declared transitive dependencies without installing development-only packages. The check verifies SDK imports and CLI startup without credentials or model requests.
79
-
80
- `npm run check` also checks runtime dependency declarations and rejects excluded development sources pulled into a package's build through imports.
81
-
82
- ## Project Structure
83
-
84
- ```
85
- packages/
86
- ai/ # LLM provider abstraction
87
- agent/ # Agent loop and message types
88
- tui/ # Terminal UI components
89
- coding-agent/ # CLI and interactive mode
90
- ```