getcompanion-ai/co-mono
1
0
Fork 0
mirror of https://github.com/getcompanion-ai/co-mono.git synced 2026-04-15 18:01:22 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

Rename /clear to /new, update hook events to before_new/new

Browse source 
Closes #305 - took direct rename approach instead of alias system

Thanks @mitsuhiko for the nudge!
This commit is contained in:
Mario Zechner 2025-12-25 04:15:10 +01:00
parent 0427445242
commit 454ea1d36a
11 changed files with 56 additions and 35 deletions
Download patch file Download diff file Expand all files Collapse all files

14
packages/coding-agent/CHANGELOG.md
View file

@ -2,6 +2,20 @@
## [Unreleased]
### Breaking Changes
- **Renamed `/clear` to `/new`**: The command to start a fresh session is now `/new`. Hook event reasons `before_clear`/`clear` are now `before_new`/`new`. Merry Christmas [@mitsuhiko](https://github.com/mitsuhiko)! ([#305](https://github.com/badlogic/pi-mono/pull/305))
### Added
- **Auto-space before pasted file paths**: When pasting a file path (starting with `/`, `~`, or `.`) after a word character, a space is automatically prepended. ([#307](https://github.com/badlogic/pi-mono/pull/307) by [@mitsuhiko](https://github.com/mitsuhiko))
- **Word navigation in input fields**: Added Ctrl+Left/Right and Alt+Left/Right for word-by-word cursor movement. ([#306](https://github.com/badlogic/pi-mono/pull/306) by [@kim0](https://github.com/kim0))
- **Full Unicode input**: Input fields now accept Unicode characters beyond ASCII. ([#306](https://github.com/badlogic/pi-mono/pull/306) by [@kim0](https://github.com/kim0))
### Fixed
- **Readline-style Ctrl+W**: Now skips trailing whitespace before deleting the preceding word, matching standard readline behavior. ([#306](https://github.com/badlogic/pi-mono/pull/306) by [@kim0](https://github.com/kim0))
## [0.28.0] - 2025-12-25
### Changed

2
packages/coding-agent/README.md
View file

@ -197,7 +197,7 @@ The agent reads, writes, and edits files, and executes commands via bash.
| `/resume` | Switch to a different session (interactive selector) |
| `/login` | OAuth login for subscription-based models |
| `/logout` | Clear OAuth tokens |
| `/clear` | Clear context and start fresh session |
| `/new` | Start a new session |
| `/copy` | Copy last agent message to clipboard |
| `/compact [instructions]` | Manually compact conversation context |
| `/autocompact` | Toggle automatic context compaction |

6
packages/coding-agent/docs/custom-tools.md
View file

@ -186,7 +186,7 @@ interface ToolSessionEvent {
entries: SessionEntry[]; // All session entries
sessionFile: string | null; // Current session file
previousSessionFile: string | null; // Previous session file
reason: "start" | "switch" | "branch" | "clear";
reason: "start" | "switch" | "branch" | "new";
}
```
@ -194,7 +194,7 @@ interface ToolSessionEvent {
- `start`: Initial session load on startup
- `switch`: User switched to a different session (`/resume`)
- `branch`: User branched from a previous message (`/branch`)
- `clear`: User cleared the session (`/clear`)
- `new`: User started a new session (`/new`)
### State Management Pattern
@ -250,7 +250,7 @@ const factory: CustomToolFactory = (pi) => {
This pattern ensures:
- When user branches, state is correct for that point in history
- When user switches sessions, state matches that session
- When user clears, state resets
- When user starts a new session, state resets
## Custom Rendering

18
packages/coding-agent/docs/hooks.md
View file

@ -125,10 +125,10 @@ user switches session (/resume)
├─► session (reason: "before_switch", can cancel)
└─► session (reason: "switch", AFTER switch)
user clears session (/clear)
user starts new session (/new)
│
├─► session (reason: "before_clear", can cancel)
└─► session (reason: "clear", AFTER clear)
├─► session (reason: "before_new", can cancel)
└─► session (reason: "new", AFTER new session starts)
context compaction (auto or /compact)
│
@ -151,12 +151,12 @@ pi.on("session", async (event, ctx) => {
// event.entries: SessionEntry[] - all session entries
// event.sessionFile: string | null - current session file (null with --no-session)
// event.previousSessionFile: string | null - previous session file
// event.reason: "start" | "before_switch" | "switch" | "before_clear" | "clear" |
// event.reason: "start" | "before_switch" | "switch" | "before_new" | "new" |
// "before_branch" | "branch" | "before_compact" | "compact" | "shutdown"
// event.targetTurnIndex: number - only for "before_branch" and "branch"
// Cancel a before_* action:
if (event.reason === "before_clear") {
if (event.reason === "before_new") {
return { cancel: true };
}
@ -171,7 +171,7 @@ pi.on("session", async (event, ctx) => {
**Reasons:**
- `start`: Initial session load on startup
- `before_switch` / `switch`: User switched sessions (`/resume`)
- `before_clear` / `clear`: User cleared the session (`/clear`)
- `before_new` / `new`: User started a new session (`/new`)
- `before_branch` / `branch`: User branched the session (`/branch`)
- `before_compact` / `compact`: Context compaction (auto or `/compact`)
- `shutdown`: Process is exiting (double Ctrl+C, Ctrl+D, or SIGTERM)
@ -848,9 +848,9 @@ Session switch:
Clear:
-> AgentSession.reset()
-> hookRunner.emit({ type: "session", reason: "before_clear", ... }) # can cancel
-> [if not cancelled: clear happens]
-> hookRunner.emit({ type: "session", reason: "clear", ... })
-> hookRunner.emit({ type: "session", reason: "before_new", ... }) # can cancel
-> [if not cancelled: new session starts]
-> hookRunner.emit({ type: "session", reason: "new", ... })
Shutdown (interactive mode):
-> handleCtrlC() or handleCtrlD()

2
packages/coding-agent/examples/hooks/confirm-destructive.ts
View file

@ -10,7 +10,7 @@ import type { HookAPI } from "@mariozechner/pi-coding-agent/hooks";
export default function (pi: HookAPI) {
pi.on("session", async (event, ctx) => {
// Only handle before_* events (the ones that can be cancelled)
if (event.reason === "before_clear") {
if (event.reason === "before_new") {
if (!ctx.hasUI) return;
const confirmed = await ctx.ui.confirm(

8
packages/coding-agent/examples/hooks/dirty-repo-guard.ts
View file

@ -10,7 +10,7 @@ import type { HookAPI } from "@mariozechner/pi-coding-agent/hooks";
export default function (pi: HookAPI) {
pi.on("session", async (event, ctx) => {
// Only guard destructive actions
if (event.reason !== "before_clear" && event.reason !== "before_switch" && event.reason !== "before_branch") {
if (event.reason !== "before_new" && event.reason !== "before_switch" && event.reason !== "before_branch") {
return;
}
@ -36,11 +36,7 @@ export default function (pi: HookAPI) {
const changedFiles = stdout.trim().split("\n").filter(Boolean).length;
const action =
event.reason === "before_clear"
? "clear session"
: event.reason === "before_switch"
? "switch session"
: "branch";
event.reason === "before_new" ? "new session" : event.reason === "before_switch" ? "switch session" : "branch";
const choice = await ctx.ui.select(`You have ${changedFiles} uncommitted file(s). ${action} anyway?`, [
"Yes, proceed anyway",

10
packages/coding-agent/src/core/agent-session.ts
View file

@ -517,14 +517,14 @@ export class AgentSession {
const previousSessionFile = this.sessionFile;
const entries = this.sessionManager.getEntries();
// Emit before_clear event (can be cancelled)
// Emit before_new event (can be cancelled)
if (this._hookRunner?.hasHandlers("session")) {
const result = (await this._hookRunner.emit({
type: "session",
entries,
sessionFile: this.sessionFile,
previousSessionFile: null,
reason: "before_clear",
reason: "before_new",
})) as SessionEventResult | undefined;
if (result?.cancel) {
@ -539,7 +539,7 @@ export class AgentSession {
this._queuedMessages = [];
this._reconnectToAgent();
// Emit session event with reason "clear" to hooks
// Emit session event with reason "new" to hooks
if (this._hookRunner) {
this._hookRunner.setSessionFile(this.sessionFile);
await this._hookRunner.emit({
@ -547,12 +547,12 @@ export class AgentSession {
entries: [],
sessionFile: this.sessionFile,
previousSessionFile,
reason: "clear",
reason: "new",
});
}
// Emit session event to custom tools
await this._emitToolSessionEvent("clear", previousSessionFile);
await this._emitToolSessionEvent("new", previousSessionFile);
return true;
}

4
packages/coding-agent/src/core/custom-tools/types.ts
View file

@ -51,10 +51,10 @@ export interface SessionEvent {
entries: SessionEntry[];
/** Current session file path, or null in --no-session mode */
sessionFile: string | null;
/** Previous session file path, or null for "start" and "clear" */
/** Previous session file path, or null for "start" and "new" */
previousSessionFile: string | null;
/** Reason for the session event */
reason: "start" | "switch" | "branch" | "clear";
reason: "start" | "switch" | "branch" | "new";
}
/** Rendering options passed to renderResult */

6
packages/coding-agent/src/core/hooks/types.ts
View file

@ -99,7 +99,7 @@ interface SessionEventBase {
entries: SessionEntry[];
/** Current session file path, or null in --no-session mode */
sessionFile: string | null;
/** Previous session file path, or null for "start" and "clear" */
/** Previous session file path, or null for "start" and "new" */
previousSessionFile: string | null;
}
@ -110,7 +110,7 @@ interface SessionEventBase {
* Lifecycle:
* - start: Initial session load
* - before_switch / switch: Session switch (e.g., /resume command)
* - before_clear / clear: Session clear (e.g., /clear command)
* - before_new / new: New session (e.g., /new command)
* - before_branch / branch: Session branch (e.g., /branch command)
* - before_compact / compact: Before/after context compaction
* - shutdown: Process exit (SIGINT/SIGTERM)
@ -120,7 +120,7 @@ interface SessionEventBase {
*/
export type SessionEvent =
| (SessionEventBase & {
reason: "start" | "switch" | "clear" | "before_switch" | "before_clear" | "shutdown";
reason: "start" | "switch" | "new" | "before_switch" | "before_new" | "shutdown";
})
| (SessionEventBase & {
reason: "branch" | "before_branch";

8
packages/coding-agent/src/modes/interactive/interactive-mode.ts
View file

@ -169,7 +169,7 @@ export class InteractiveMode {
{ name: "logout", description: "Logout from OAuth provider" },
{ name: "queue", description: "Select message queue mode (opens selector UI)" },
{ name: "theme", description: "Select color theme (opens selector UI)" },
{ name: "clear", description: "Clear context and start a fresh session" },
{ name: "new", description: "Start a new session" },
{ name: "compact", description: "Manually compact the session context" },
{ name: "autocompact", description: "Toggle automatic context compaction" },
{ name: "resume", description: "Resume a different session" },
@ -672,7 +672,7 @@ export class InteractiveMode {
this.editor.setText("");
return;
}
if (text === "/clear") {
if (text === "/new") {
this.editor.setText("");
await this.handleClearCommand();
return;
@ -1843,9 +1843,7 @@ export class InteractiveMode {
this.isFirstUserMessage = true;
this.chatContainer.addChild(new Spacer(1));
this.chatContainer.addChild(
new Text(`${theme.fg("accent", "✓ Context cleared")}\n${theme.fg("muted", "Started fresh session")}`, 1, 1),
);
this.chatContainer.addChild(new Text(`${theme.fg("accent", "✓ New session started")}`, 1, 1));
this.ui.requestRender();
}

13
packages/tui/CHANGELOG.md Normal file
View file

@ -0,0 +1,13 @@
# Changelog
## [Unreleased]
### Added
- **Auto-space before pasted file paths**: When pasting a file path (starting with `/`, `~`, or `.`) and the cursor is after a word character, a space is automatically prepended for better readability. Useful when dragging screenshots from macOS. ([#307](https://github.com/badlogic/pi-mono/pull/307) by [@mitsuhiko](https://github.com/mitsuhiko))
- **Word navigation for Input component**: Added Ctrl+Left/Right and Alt+Left/Right support for word-by-word cursor movement. ([#306](https://github.com/badlogic/pi-mono/pull/306) by [@kim0](https://github.com/kim0))
- **Full Unicode input**: Input component now accepts Unicode characters beyond ASCII. ([#306](https://github.com/badlogic/pi-mono/pull/306) by [@kim0](https://github.com/kim0))
### Fixed
- **Readline-style Ctrl+W**: Now skips trailing whitespace before deleting the preceding word, matching standard readline behavior. ([#306](https://github.com/badlogic/pi-mono/pull/306) by [@kim0](https://github.com/kim0))