872b0adb48
Split flat docs/ into user-docs/ (guides, config, troubleshooting) and dev/ (ADRs, architecture, extension guides, proposals). Updated docs/README.md index to reflect new paths.
54 lines
1.1 KiB
Markdown
54 lines
1.1 KiB
Markdown
# Compaction & Session Control
|
|
|
|
|
|
### Custom Compaction
|
|
|
|
Override the default compaction behavior:
|
|
|
|
```typescript
|
|
pi.on("session_before_compact", async (event, ctx) => {
|
|
const { preparation, branchEntries, customInstructions, signal } = event;
|
|
|
|
// Option 1: Cancel compaction
|
|
return { cancel: true };
|
|
|
|
// Option 2: Provide custom summary
|
|
return {
|
|
compaction: {
|
|
summary: "Custom summary of conversation so far...",
|
|
firstKeptEntryId: preparation.firstKeptEntryId,
|
|
tokensBefore: preparation.tokensBefore,
|
|
}
|
|
};
|
|
});
|
|
```
|
|
|
|
### Triggering Compaction
|
|
|
|
```typescript
|
|
ctx.compact({
|
|
customInstructions: "Focus on the authentication changes",
|
|
onComplete: (result) => ctx.ui.notify("Compacted!", "info"),
|
|
});
|
|
```
|
|
|
|
### Session Control (Commands Only)
|
|
|
|
```typescript
|
|
pi.registerCommand("handoff", {
|
|
handler: async (args, ctx) => {
|
|
// Create a new session with initial context
|
|
await ctx.newSession({
|
|
setup: async (sm) => {
|
|
sm.appendMessage({
|
|
role: "user",
|
|
content: [{ type: "text", text: "Context: " + args }],
|
|
timestamp: Date.now(),
|
|
});
|
|
},
|
|
});
|
|
},
|
|
});
|
|
```
|
|
|
|
---
|