@apholdings/jensen-code 0.0.4 → 0.0.6

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 (161) hide show
  1. package/CHANGELOG.md +3061 -3061
  2. package/README.md +1 -1
  3. package/dist/cli/args.d.ts.map +1 -1
  4. package/dist/cli/args.js +6 -6
  5. package/dist/cli/args.js.map +1 -1
  6. package/dist/config.d.ts +17 -6
  7. package/dist/config.d.ts.map +1 -1
  8. package/dist/config.js +55 -28
  9. package/dist/config.js.map +1 -1
  10. package/dist/core/agent-session.d.ts.map +1 -1
  11. package/dist/core/agent-session.js +10 -0
  12. package/dist/core/agent-session.js.map +1 -1
  13. package/dist/index.d.ts +1 -1
  14. package/dist/index.d.ts.map +1 -1
  15. package/dist/index.js +1 -1
  16. package/dist/index.js.map +1 -1
  17. package/dist/modes/interactive/components/assistant-message.d.ts +1 -6
  18. package/dist/modes/interactive/components/assistant-message.d.ts.map +1 -1
  19. package/dist/modes/interactive/components/assistant-message.js +10 -40
  20. package/dist/modes/interactive/components/assistant-message.js.map +1 -1
  21. package/dist/modes/interactive/components/custom-editor.d.ts +1 -0
  22. package/dist/modes/interactive/components/custom-editor.d.ts.map +1 -1
  23. package/dist/modes/interactive/components/custom-editor.js +5 -0
  24. package/dist/modes/interactive/components/custom-editor.js.map +1 -1
  25. package/dist/modes/interactive/components/tool-execution.d.ts.map +1 -1
  26. package/dist/modes/interactive/components/tool-execution.js +1 -2
  27. package/dist/modes/interactive/components/tool-execution.js.map +1 -1
  28. package/dist/modes/interactive/components/top-bar.d.ts.map +1 -1
  29. package/dist/modes/interactive/components/top-bar.js +1 -1
  30. package/dist/modes/interactive/components/top-bar.js.map +1 -1
  31. package/dist/modes/interactive/components/user-message.d.ts.map +1 -1
  32. package/dist/modes/interactive/components/user-message.js +1 -1
  33. package/dist/modes/interactive/components/user-message.js.map +1 -1
  34. package/dist/modes/interactive/interactive-mode.d.ts +6 -3
  35. package/dist/modes/interactive/interactive-mode.d.ts.map +1 -1
  36. package/dist/modes/interactive/interactive-mode.js +204 -86
  37. package/dist/modes/interactive/interactive-mode.js.map +1 -1
  38. package/dist/utils/frontmatter.d.ts.map +1 -1
  39. package/dist/utils/frontmatter.js +8 -4
  40. package/dist/utils/frontmatter.js.map +1 -1
  41. package/dist/utils/tools-manager.d.ts.map +1 -1
  42. package/dist/utils/tools-manager.js +2 -2
  43. package/dist/utils/tools-manager.js.map +1 -1
  44. package/docs/custom-provider.md +592 -592
  45. package/docs/session.md +412 -412
  46. package/examples/extensions/osgrep.ts +643 -0
  47. package/examples/extensions/subagent/agents.ts +150 -37
  48. package/examples/extensions/subagent/index.ts +634 -513
  49. package/package.json +3 -3
  50. package/examples/README.md +0 -25
  51. package/examples/extensions/README.md +0 -206
  52. package/examples/extensions/antigravity-image-gen.ts +0 -415
  53. package/examples/extensions/auto-commit-on-exit.ts +0 -49
  54. package/examples/extensions/bash-spawn-hook.ts +0 -30
  55. package/examples/extensions/bookmark.ts +0 -50
  56. package/examples/extensions/built-in-tool-renderer.ts +0 -246
  57. package/examples/extensions/claude-rules.ts +0 -86
  58. package/examples/extensions/commands.ts +0 -72
  59. package/examples/extensions/confirm-destructive.ts +0 -59
  60. package/examples/extensions/custom-compaction.ts +0 -114
  61. package/examples/extensions/custom-footer.ts +0 -64
  62. package/examples/extensions/custom-header.ts +0 -73
  63. package/examples/extensions/custom-provider-anthropic/index.ts +0 -604
  64. package/examples/extensions/custom-provider-anthropic/package-lock.json +0 -24
  65. package/examples/extensions/custom-provider-anthropic/package.json +0 -19
  66. package/examples/extensions/custom-provider-gitlab-duo/index.ts +0 -349
  67. package/examples/extensions/custom-provider-gitlab-duo/package.json +0 -16
  68. package/examples/extensions/custom-provider-gitlab-duo/test.ts +0 -82
  69. package/examples/extensions/custom-provider-qwen-cli/index.ts +0 -345
  70. package/examples/extensions/custom-provider-qwen-cli/package.json +0 -16
  71. package/examples/extensions/dirty-repo-guard.ts +0 -56
  72. package/examples/extensions/doom-overlay/README.md +0 -46
  73. package/examples/extensions/doom-overlay/doom/build/doom.js +0 -21
  74. package/examples/extensions/doom-overlay/doom/build/doom.wasm +0 -0
  75. package/examples/extensions/doom-overlay/doom/build.sh +0 -152
  76. package/examples/extensions/doom-overlay/doom/doomgeneric_pi.c +0 -72
  77. package/examples/extensions/doom-overlay/doom-component.ts +0 -132
  78. package/examples/extensions/doom-overlay/doom-engine.ts +0 -173
  79. package/examples/extensions/doom-overlay/doom-keys.ts +0 -104
  80. package/examples/extensions/doom-overlay/index.ts +0 -74
  81. package/examples/extensions/doom-overlay/wad-finder.ts +0 -51
  82. package/examples/extensions/dynamic-resources/SKILL.md +0 -8
  83. package/examples/extensions/dynamic-resources/dynamic.json +0 -79
  84. package/examples/extensions/dynamic-resources/dynamic.md +0 -5
  85. package/examples/extensions/dynamic-resources/index.ts +0 -15
  86. package/examples/extensions/dynamic-tools.ts +0 -74
  87. package/examples/extensions/event-bus.ts +0 -43
  88. package/examples/extensions/file-trigger.ts +0 -41
  89. package/examples/extensions/git-checkpoint.ts +0 -53
  90. package/examples/extensions/handoff.ts +0 -150
  91. package/examples/extensions/hello.ts +0 -25
  92. package/examples/extensions/inline-bash.ts +0 -94
  93. package/examples/extensions/input-transform.ts +0 -43
  94. package/examples/extensions/interactive-shell.ts +0 -196
  95. package/examples/extensions/mac-system-theme.ts +0 -47
  96. package/examples/extensions/message-renderer.ts +0 -59
  97. package/examples/extensions/minimal-mode.ts +0 -426
  98. package/examples/extensions/modal-editor.ts +0 -85
  99. package/examples/extensions/model-status.ts +0 -31
  100. package/examples/extensions/notify.ts +0 -55
  101. package/examples/extensions/overlay-qa-tests.ts +0 -1348
  102. package/examples/extensions/overlay-test.ts +0 -150
  103. package/examples/extensions/permission-gate.ts +0 -34
  104. package/examples/extensions/pirate.ts +0 -47
  105. package/examples/extensions/plan-mode/README.md +0 -65
  106. package/examples/extensions/plan-mode/index.ts +0 -340
  107. package/examples/extensions/plan-mode/utils.ts +0 -168
  108. package/examples/extensions/preset.ts +0 -398
  109. package/examples/extensions/protected-paths.ts +0 -30
  110. package/examples/extensions/provider-payload.ts +0 -14
  111. package/examples/extensions/qna.ts +0 -119
  112. package/examples/extensions/question.ts +0 -264
  113. package/examples/extensions/questionnaire.ts +0 -427
  114. package/examples/extensions/rainbow-editor.ts +0 -88
  115. package/examples/extensions/reload-runtime.ts +0 -37
  116. package/examples/extensions/rpc-demo.ts +0 -124
  117. package/examples/extensions/sandbox/index.ts +0 -318
  118. package/examples/extensions/sandbox/package-lock.json +0 -92
  119. package/examples/extensions/sandbox/package.json +0 -19
  120. package/examples/extensions/send-user-message.ts +0 -97
  121. package/examples/extensions/session-name.ts +0 -27
  122. package/examples/extensions/shutdown-command.ts +0 -63
  123. package/examples/extensions/snake.ts +0 -343
  124. package/examples/extensions/space-invaders.ts +0 -560
  125. package/examples/extensions/ssh.ts +0 -220
  126. package/examples/extensions/status-line.ts +0 -40
  127. package/examples/extensions/subagent/README.md +0 -172
  128. package/examples/extensions/subagent/agents/planner.md +0 -37
  129. package/examples/extensions/subagent/agents/reviewer.md +0 -35
  130. package/examples/extensions/subagent/agents/scout.md +0 -50
  131. package/examples/extensions/subagent/agents/worker.md +0 -24
  132. package/examples/extensions/subagent/prompts/implement-and-review.md +0 -10
  133. package/examples/extensions/subagent/prompts/implement.md +0 -10
  134. package/examples/extensions/subagent/prompts/scout-and-plan.md +0 -9
  135. package/examples/extensions/summarize.ts +0 -195
  136. package/examples/extensions/system-prompt-header.ts +0 -17
  137. package/examples/extensions/timed-confirm.ts +0 -70
  138. package/examples/extensions/titlebar-spinner.ts +0 -58
  139. package/examples/extensions/todo.ts +0 -299
  140. package/examples/extensions/tool-override.ts +0 -143
  141. package/examples/extensions/tools.ts +0 -146
  142. package/examples/extensions/trigger-compact.ts +0 -40
  143. package/examples/extensions/truncated-tool.ts +0 -192
  144. package/examples/extensions/widget-placement.ts +0 -17
  145. package/examples/extensions/with-deps/index.ts +0 -32
  146. package/examples/extensions/with-deps/package-lock.json +0 -31
  147. package/examples/extensions/with-deps/package.json +0 -22
  148. package/examples/rpc-extension-ui.ts +0 -632
  149. package/examples/sdk/01-minimal.ts +0 -22
  150. package/examples/sdk/02-custom-model.ts +0 -49
  151. package/examples/sdk/03-custom-prompt.ts +0 -55
  152. package/examples/sdk/04-skills.ts +0 -46
  153. package/examples/sdk/05-tools.ts +0 -56
  154. package/examples/sdk/06-extensions.ts +0 -88
  155. package/examples/sdk/07-context-files.ts +0 -40
  156. package/examples/sdk/08-prompt-templates.ts +0 -47
  157. package/examples/sdk/09-api-keys-and-oauth.ts +0 -48
  158. package/examples/sdk/10-settings.ts +0 -51
  159. package/examples/sdk/11-sessions.ts +0 -48
  160. package/examples/sdk/12-full-control.ts +0 -82
  161. package/examples/sdk/README.md +0 -145
@@ -1,196 +0,0 @@
1
- /**
2
- * Interactive Shell Commands Extension
3
- *
4
- * Enables running interactive commands (vim, git rebase -i, htop, etc.)
5
- * with full terminal access. The TUI suspends while they run.
6
- *
7
- * Usage:
8
- * pi -e examples/extensions/interactive-shell.ts
9
- *
10
- * !vim file.txt # Auto-detected as interactive
11
- * !i any-command # Force interactive mode with !i prefix
12
- * !git rebase -i HEAD~3
13
- * !htop
14
- *
15
- * Configuration via environment variables:
16
- * INTERACTIVE_COMMANDS - Additional commands (comma-separated)
17
- * INTERACTIVE_EXCLUDE - Commands to exclude (comma-separated)
18
- *
19
- * Note: This only intercepts user `!` commands, not agent bash tool calls.
20
- * If the agent runs an interactive command, it will fail (which is fine).
21
- */
22
-
23
- import { spawnSync } from "node:child_process";
24
- import type { ExtensionAPI } from "@apholdings/jensen-code";
25
-
26
- // Default interactive commands - editors, pagers, git ops, TUIs
27
- const DEFAULT_INTERACTIVE_COMMANDS = [
28
- // Editors
29
- "vim",
30
- "nvim",
31
- "vi",
32
- "nano",
33
- "emacs",
34
- "pico",
35
- "micro",
36
- "helix",
37
- "hx",
38
- "kak",
39
- // Pagers
40
- "less",
41
- "more",
42
- "most",
43
- // Git interactive
44
- "git commit",
45
- "git rebase",
46
- "git merge",
47
- "git cherry-pick",
48
- "git revert",
49
- "git add -p",
50
- "git add --patch",
51
- "git add -i",
52
- "git add --interactive",
53
- "git stash -p",
54
- "git stash --patch",
55
- "git reset -p",
56
- "git reset --patch",
57
- "git checkout -p",
58
- "git checkout --patch",
59
- "git difftool",
60
- "git mergetool",
61
- // System monitors
62
- "htop",
63
- "top",
64
- "btop",
65
- "glances",
66
- // File managers
67
- "ranger",
68
- "nnn",
69
- "lf",
70
- "mc",
71
- "vifm",
72
- // Git TUIs
73
- "tig",
74
- "lazygit",
75
- "gitui",
76
- // Fuzzy finders
77
- "fzf",
78
- "sk",
79
- // Remote sessions
80
- "ssh",
81
- "telnet",
82
- "mosh",
83
- // Database clients
84
- "psql",
85
- "mysql",
86
- "sqlite3",
87
- "mongosh",
88
- "redis-cli",
89
- // Kubernetes/Docker
90
- "kubectl edit",
91
- "kubectl exec -it",
92
- "docker exec -it",
93
- "docker run -it",
94
- // Other
95
- "tmux",
96
- "screen",
97
- "ncdu",
98
- ];
99
-
100
- function getInteractiveCommands(): string[] {
101
- const additional =
102
- process.env.INTERACTIVE_COMMANDS?.split(",")
103
- .map((s) => s.trim())
104
- .filter(Boolean) ?? [];
105
- const excluded = new Set(process.env.INTERACTIVE_EXCLUDE?.split(",").map((s) => s.trim().toLowerCase()) ?? []);
106
- return [...DEFAULT_INTERACTIVE_COMMANDS, ...additional].filter((cmd) => !excluded.has(cmd.toLowerCase()));
107
- }
108
-
109
- function isInteractiveCommand(command: string): boolean {
110
- const trimmed = command.trim().toLowerCase();
111
- const commands = getInteractiveCommands();
112
-
113
- for (const cmd of commands) {
114
- const cmdLower = cmd.toLowerCase();
115
- // Match at start
116
- if (trimmed === cmdLower || trimmed.startsWith(`${cmdLower} `) || trimmed.startsWith(`${cmdLower}\t`)) {
117
- return true;
118
- }
119
- // Match after pipe: "cat file | less"
120
- const pipeIdx = trimmed.lastIndexOf("|");
121
- if (pipeIdx !== -1) {
122
- const afterPipe = trimmed.slice(pipeIdx + 1).trim();
123
- if (afterPipe === cmdLower || afterPipe.startsWith(`${cmdLower} `)) {
124
- return true;
125
- }
126
- }
127
- }
128
- return false;
129
- }
130
-
131
- export default function (pi: ExtensionAPI) {
132
- pi.on("user_bash", async (event, ctx) => {
133
- let command = event.command;
134
- let forceInteractive = false;
135
-
136
- // Check for !i prefix (command comes without the leading !)
137
- // The prefix parsing happens before this event, so we check if command starts with "i "
138
- if (command.startsWith("i ") || command.startsWith("i\t")) {
139
- forceInteractive = true;
140
- command = command.slice(2).trim();
141
- }
142
-
143
- const shouldBeInteractive = forceInteractive || isInteractiveCommand(command);
144
- if (!shouldBeInteractive) {
145
- return; // Let normal handling proceed
146
- }
147
-
148
- // No UI available (print mode, RPC, etc.)
149
- if (!ctx.hasUI) {
150
- return {
151
- result: { output: "(interactive commands require TUI)", exitCode: 1, cancelled: false, truncated: false },
152
- };
153
- }
154
-
155
- // Use ctx.ui.custom() to get TUI access, then run the command
156
- const exitCode = await ctx.ui.custom<number | null>((tui, _theme, _kb, done) => {
157
- // Stop TUI to release terminal
158
- tui.stop();
159
-
160
- // Clear screen
161
- process.stdout.write("\x1b[2J\x1b[H");
162
-
163
- // Run command with full terminal access
164
- const shell = process.env.SHELL || "/bin/sh";
165
- const result = spawnSync(shell, ["-c", command], {
166
- stdio: "inherit",
167
- env: process.env,
168
- });
169
-
170
- // Restart TUI
171
- tui.start();
172
- tui.requestRender(true);
173
-
174
- // Signal completion
175
- done(result.status);
176
-
177
- // Return empty component (immediately disposed since done() was called)
178
- return { render: () => [], invalidate: () => {} };
179
- });
180
-
181
- // Return result to prevent default bash handling
182
- const output =
183
- exitCode === 0
184
- ? "(interactive command completed successfully)"
185
- : `(interactive command exited with code ${exitCode})`;
186
-
187
- return {
188
- result: {
189
- output,
190
- exitCode: exitCode ?? 1,
191
- cancelled: false,
192
- truncated: false,
193
- },
194
- };
195
- });
196
- }
@@ -1,47 +0,0 @@
1
- /**
2
- * Syncs pi theme with macOS system appearance (dark/light mode).
3
- *
4
- * Usage:
5
- * pi -e examples/extensions/mac-system-theme.ts
6
- */
7
-
8
- import { exec } from "node:child_process";
9
- import { promisify } from "node:util";
10
- import type { ExtensionAPI } from "@apholdings/jensen-code";
11
-
12
- const execAsync = promisify(exec);
13
-
14
- async function isDarkMode(): Promise<boolean> {
15
- try {
16
- const { stdout } = await execAsync(
17
- "osascript -e 'tell application \"System Events\" to tell appearance preferences to return dark mode'",
18
- );
19
- return stdout.trim() === "true";
20
- } catch {
21
- return false;
22
- }
23
- }
24
-
25
- export default function (pi: ExtensionAPI) {
26
- let intervalId: ReturnType<typeof setInterval> | null = null;
27
-
28
- pi.on("session_start", async (_event, ctx) => {
29
- let currentTheme = (await isDarkMode()) ? "dark" : "light";
30
- ctx.ui.setTheme(currentTheme);
31
-
32
- intervalId = setInterval(async () => {
33
- const newTheme = (await isDarkMode()) ? "dark" : "light";
34
- if (newTheme !== currentTheme) {
35
- currentTheme = newTheme;
36
- ctx.ui.setTheme(currentTheme);
37
- }
38
- }, 2000);
39
- });
40
-
41
- pi.on("session_shutdown", () => {
42
- if (intervalId) {
43
- clearInterval(intervalId);
44
- intervalId = null;
45
- }
46
- });
47
- }
@@ -1,59 +0,0 @@
1
- /**
2
- * Custom message rendering example.
3
- *
4
- * Shows how to use registerMessageRenderer to control how custom messages
5
- * appear in the TUI, with colors, formatting, and expandable details.
6
- *
7
- * Usage: /status [message] - sends a status message with custom rendering
8
- */
9
-
10
- import type { ExtensionAPI } from "@apholdings/jensen-code";
11
- import { Box, Text } from "@apholdings/jensen-tui";
12
-
13
- export default function (pi: ExtensionAPI) {
14
- // Register custom renderer for "status-update" messages
15
- pi.registerMessageRenderer("status-update", (message, { expanded }, theme) => {
16
- const details = message.details as { level: string; timestamp: number } | undefined;
17
- const level = details?.level ?? "info";
18
-
19
- // Color based on level
20
- const color = level === "error" ? "error" : level === "warn" ? "warning" : "success";
21
- const prefix = theme.fg(color, `[${level.toUpperCase()}]`);
22
-
23
- let text = `${prefix} ${message.content}`;
24
-
25
- // Show timestamp when expanded
26
- if (expanded && details?.timestamp) {
27
- const time = new Date(details.timestamp).toLocaleTimeString();
28
- text += `\n${theme.fg("dim", ` at ${time}`)}`;
29
- }
30
-
31
- // Use Box with customMessageBg for consistent styling
32
- const box = new Box(1, 1, (t) => theme.bg("customMessageBg", t));
33
- box.addChild(new Text(text, 0, 0));
34
- return box;
35
- });
36
-
37
- // Command to send status messages
38
- pi.registerCommand("status", {
39
- description: "Send a status message (usage: /status [warn|error] message)",
40
- handler: async (args, _ctx) => {
41
- const parts = args.trim().split(/\s+/);
42
- let level = "info";
43
- let content = args.trim();
44
-
45
- // Check for level prefix
46
- if (parts[0] === "warn" || parts[0] === "error") {
47
- level = parts[0];
48
- content = parts.slice(1).join(" ") || "Status update";
49
- }
50
-
51
- pi.sendMessage({
52
- customType: "status-update",
53
- content,
54
- display: true,
55
- details: { level, timestamp: Date.now() },
56
- });
57
- },
58
- });
59
- }