@dyyz1993/pi-coding-agent 0.70.6 → 0.74.4

package/docs/rollback-test-cases.md

@@ -0,0 +1,412 @@
+# Rollback Test Cases
+
+## Conventions
+
+- **Entry types**: user message (U), assistant message (A), tool result (T), step-snapshot (S), compaction (C), deletion (D), segment_summary (SS), branch_summary (BS)
+- **File state**: tracked by snapshot hash. Each step-snapshot records baselineTreeHash → snapshotTreeHash
+- **Event log**: records every event in order with data
+
+---
+
+## Case 1: Basic Rollback (Message + Files)
+
+### Scenario
+Create file A → Modify file B → Rollback to "Create file A" message → Both message and files restored
+
+### Steps
+
+| Step | Action | Entries Created | File State | Snapshot |
+|------|--------|-----------------|------------|----------|
+| 1 | User: "create file A" | U1 | — | — |
+| 2 | Assistant creates file A (write tool) | A1, T1 | A exists | S1: baseline=null→hash1 |
+| 3 | User: "modify file B" | U2 | — | — |
+| 4 | Assistant modifies file B (edit tool) | A2, T2 | A, B(modified) | S2: hash1→hash2 |
+| 5 | Rollback to U1 (skipFiles=false) | BS1(skipFiles=false) | A, B(original) | Files restored to S1 state |
+
+### Expected Results
+- leafId points to BS1 (or U1 depending on navigation)
+- File A: exists (was created in step 2)
+- File B: restored to pre-modification state (or deleted if didn't exist before step 4)
+- Messages: only U1 and earlier visible in context
+- Event log: session_tree event fires, file-snapshot restores files
+
+### Event Log
+
+| Order | Event | Data |
+|-------|-------|------|
+| 1 | `session_tree` (step 2) | { type: "step-snapshot", snapshotId: S1, treeHash: hash1 } |
+| 2 | `session_tree` (step 4) | { type: "step-snapshot", snapshotId: S2, treeHash: hash2 } |
+| 3 | `session_tree` (step 5) | { type: "branch_summary", entryId: BS1, rollbackTo: U1, skipFiles: false } |
+| 4 | `file-snapshot` (step 5) | { action: "restore", targetHash: hash1, filesRestored: ["B"] } |
+
+---
+
+## Case 2: Message-Only Rollback (skipFiles=true)
+
+### Scenario
+Modify file A → Modify file B → Modify file A again → Rollback to "Modify file B" message without restoring files
+
+### Steps
+
+| Step | Action | Entries Created | File State | Snapshot |
+|------|--------|-----------------|------------|----------|
+| 1 | User: "modify file A" | U1 | — | — |
+| 2 | Assistant modifies file A (v1) | A1, T1 | A(v1) | S1: null→hash1 |
+| 3 | User: "modify file B" | U2 | — | — |
+| 4 | Assistant modifies file B (v1) | A2, T2 | A(v1), B(v1) | S2: hash1→hash2 |
+| 5 | User: "modify file A again" | U3 | — | — |
+| 6 | Assistant modifies file A (v2) | A3, T3 | A(v2), B(v1) | S3: hash2→hash3 |
+| 7 | Rollback to A2 (skipFiles=true) | BS1(skipFiles=true) | A(v2), B(v1) | No file restoration |
+
+### Expected Results
+- leafId points to position at A2
+- File A: still v2 (not restored)
+- File B: still v1 (not restored)
+- Messages: only U1, A1, T1, U2, A2, T2 visible in context
+- BS1 has skipFiles=true field
+
+### Event Log
+
+| Order | Event | Data |
+|-------|-------|------|
+| 1 | `session_tree` (step 2) | { type: "step-snapshot", snapshotId: S1, treeHash: hash1 } |
+| 2 | `session_tree` (step 4) | { type: "step-snapshot", snapshotId: S2, treeHash: hash2 } |
+| 3 | `session_tree` (step 6) | { type: "step-snapshot", snapshotId: S3, treeHash: hash3 } |
+| 4 | `session_tree` (step 7) | { type: "branch_summary", entryId: BS1, rollbackTo: A2, skipFiles: true } |
+
+---
+
+## Case 3: Rollback After Compaction (Message Only)
+
+### Scenario
+Multiple turns → Compaction triggers → Rollback to pre-compaction message with skipFiles=true
+
+### Steps
+
+| Step | Action | Entries Created | File State | Snapshot |
+|------|--------|-----------------|------------|----------|
+| 1 | User: "create file A" | U1 | — | — |
+| 2 | Assistant creates file A | A1, T1 | A exists | S1 |
+| 3 | User: "create file B" | U2 | — | — |
+| 4 | Assistant creates file B | A2, T2 | A, B | S2 |
+| 5 | User: "create file C" | U3 | — | — |
+| 6 | Assistant creates file C | A3, T3 | A, B, C | S3 |
+| 7 | User: "summarize previous work" | U4 | — | — |
+| 8 | Assistant responds | A4 | A, B, C | S4 (or no change) |
+| 9 | Manual compaction (summarize U1-A3) | C1(summary) | A, B, C | — |
+| 10 | Rollback to U2 (skipFiles=true) | BS1(skipFiles=true) | A, B, C | No file restoration |
+
+### Expected Results
+- leafId before U2 (to re-edit)
+- Messages: compaction summary is gone, U1, A1, T1, U2, A2, T2 visible
+- Files: unchanged (skipFiles=true)
+
+### Event Log
+
+| Order | Event | Data |
+|-------|-------|------|
+| 1 | `session_tree` (step 2) | { type: "step-snapshot", snapshotId: S1 } |
+| 2 | `session_tree` (step 4) | { type: "step-snapshot", snapshotId: S2 } |
+| 3 | `session_tree` (step 6) | { type: "step-snapshot", snapshotId: S3 } |
+| 4 | `session_tree` (step 8) | { type: "step-snapshot", snapshotId: S4 } |
+| 5 | `session_tree` (step 9) | { type: "compaction", entryId: C1, summarized: [U1,A1,T1,U2,A2,T2,U3,A3,T3] } |
+| 6 | `session_tree` (step 10) | { type: "branch_summary", entryId: BS1, rollbackTo: U2, skipFiles: true } |
+| 7 | `session_tree` (step 10, side effect) | { type: "compaction_undone", entryId: C1 } |
+
+---
+
+## Case 4: Rollback After Compaction (Message + Files)
+
+### Scenario
+Same as Case 3 but skipFiles=false
+
+### Steps
+Same as Case 3 through step 9.
+
+| Step | Action | Entries Created | File State | Snapshot |
+|------|--------|-----------------|------------|----------|
+| 10 | Rollback to U2 (skipFiles=false) | BS1(skipFiles=false) | A, B (C removed) | Files restored to S2 state |
+
+### Expected Results
+- leafId before U2
+- Messages: U1, A1, T1, U2, A2, T2 visible (compaction gone)
+- Files: A exists, B exists, C removed (wasn't created yet at step 4)
+
+### Event Log
+
+| Order | Event | Data |
+|-------|-------|------|
+| 1 | `session_tree` (step 2) | { type: "step-snapshot", snapshotId: S1 } |
+| 2 | `session_tree` (step 4) | { type: "step-snapshot", snapshotId: S2 } |
+| 3 | `session_tree` (step 6) | { type: "step-snapshot", snapshotId: S3 } |
+| 4 | `session_tree` (step 8) | { type: "step-snapshot", snapshotId: S4 } |
+| 5 | `session_tree` (step 9) | { type: "compaction", entryId: C1, summarized: [U1..A3,T3] } |
+| 6 | `session_tree` (step 10) | { type: "branch_summary", entryId: BS1, rollbackTo: U2, skipFiles: false } |
+| 7 | `file-snapshot` (step 10) | { action: "restore", targetSnapshot: S2, filesRestored: ["C"], filesDeleted: ["C"] } |
+| 8 | `session_tree` (step 10, side effect) | { type: "compaction_undone", entryId: C1 } |
+
+---
+
+## Case 5: Segment Summary + Deletion + Rollback
+
+### Scenario
+Create A, B, C → Summarize middle messages → Delete a message → Rollback to various positions
+
+### Steps
+
+| Step | Action | Entries Created | File State |
+|------|--------|-----------------|------------|
+| 1 | User: "create file A" | U1 | — |
+| 2 | Assistant creates file A | A1, T1 | A |
+| 3 | User: "create file B" | U2 | — |
+| 4 | Assistant creates file B | A2, T2 | A, B |
+| 5 | User: "create file C" | U3 | — |
+| 6 | Assistant creates file C | A3, T3 | A, B, C |
+| 7 | User: "do some work" | U4 | — |
+| 8 | Assistant responds with tools | A4, T4 | A, B, C (possibly modified) |
+| 9 | Summarize A2-T2 into segment summary | SS1(targets=[A2,T2], summary="Created file B") | A, B, C |
+| 10 | Delete message A4 | D1(targets=[A4]) | A, B, C (files unchanged) |
+| 11 | Rollback to U3 (skipFiles=false) | BS1 | A, B, C restored to step 6 state |
+
+### Expected Results
+- At step 9: A2,T2 replaced by segmentSummary message in LLM context
+- At step 10: A4 excluded from LLM context, files unchanged
+- At step 11: SS1 and D1 are after U3, so rollback goes past them → all messages restored (including A2,T2,A4)
+
+### Event Log
+
+| Order | Event | Data |
+|-------|-------|------|
+| 1 | `session_tree` (step 2) | { type: "step-snapshot", snapshotId: S1 } |
+| 2 | `session_tree` (step 4) | { type: "step-snapshot", snapshotId: S2 } |
+| 3 | `session_tree` (step 6) | { type: "step-snapshot", snapshotId: S3 } |
+| 4 | `session_tree` (step 8) | { type: "step-snapshot", snapshotId: S4 } |
+| 5 | `session_tree` (step 9) | { type: "segment_summary", entryId: SS1, targets: [A2,T2] } |
+| 6 | `session_tree` (step 10) | { type: "deletion", entryId: D1, targets: [A4] } |
+| 7 | `session_tree` (step 11) | { type: "branch_summary", entryId: BS1, rollbackTo: U3, skipFiles: false } |
+| 8 | `file-snapshot` (step 11) | { action: "restore", targetSnapshot: S3, filesRestored: [] } |
+| 9 | `session_tree` (step 11, side effect) | { type: "segment_summary_undone", entryId: SS1 } |
+| 10 | `session_tree` (step 11, side effect) | { type: "deletion_undone", entryId: D1 } |
+
+---
+
+## Case 6: Delete Message + Rollback Restores It
+
+### Scenario
+Delete a specific message → Rollback to before the deletion → Deleted message should reappear
+
+### Steps
+
+| Step | Action | Entries Created | Context Visible |
+|------|--------|-----------------|-----------------|
+| 1 | User: "create file A" | U1 | U1 |
+| 2 | Assistant creates file A | A1, T1 | U1, A1, T1 |
+| 3 | User: "create file B" | U2 | U1, A1, T1, U2 |
+| 4 | Assistant creates file B | A2, T2 | U1, A1, T1, U2, A2, T2 |
+| 5 | Delete A1 (message only) | D1(targets=[A1]) | U1, T1, U2, A2, T2 (A1 excluded, T1 kept) |
+| 6 | Rollback to U2 (skipFiles=true) | BS1(skipFiles=true) | U1, A1, T1, U2 (A1 restored, D1 after rollback point) |
+
+### Expected Results
+- After step 5: A1 excluded from context, but files unchanged
+- After step 6: A1 reappears in context (D1 is after the rollback point)
+- Files: unchanged throughout (skipFiles=true)
+
+### Event Log
+
+| Order | Event | Data |
+|-------|-------|------|
+| 1 | `session_tree` (step 2) | { type: "step-snapshot", snapshotId: S1 } |
+| 2 | `session_tree` (step 4) | { type: "step-snapshot", snapshotId: S2 } |
+| 3 | `session_tree` (step 5) | { type: "deletion", entryId: D1, targets: [A1] } |
+| 4 | `session_tree` (step 6) | { type: "branch_summary", entryId: BS1, rollbackTo: U2, skipFiles: true } |
+| 5 | `session_tree` (step 6, side effect) | { type: "deletion_undone", entryId: D1, restoredEntry: A1 } |
+
+---
+
+## Case 7: Fork Scenario
+
+### Design Decision
+Fork does NOT carry file snapshots. The forked session starts fresh:
+- Object store is shared (content-addressable, files deduplicated)
+- Snapshot index is empty in the forked session
+- First turn_end in the fork creates a new initial snapshot
+- Fork rollback is independent of original session
+- Original session is not affected by fork operations
+
+### Sub-case 7a: Basic Fork
+
+| Step | Action | Entries | File State |
+|------|--------|---------|------------|
+| 1 | User: "create file A" | U1 | — |
+| 2 | Assistant creates file A | A1, T1 | A |
+| 3 | User: "modify file A" | U2 | — |
+| 4 | Assistant modifies file A | A2, T2 | A(modified) |
+| 5 | Fork from U2 | New session with U1, A1, T1, U2 | A(modified) — files not changed by fork |
+| 6 | In fork: "create file B" | U1' | — |
+| 7 | In fork: assistant creates B | A1', T1' | A(modified), B |
+| 8 | In original: file state unchanged | — | A(modified) — no B |
+
+#### Expected Results (7a)
+- Fork session has independent entry tree
+- Original session unaffected by fork operations
+- File state in fork includes working directory state at fork time
+
+#### Event Log (7a)
+
+| Order | Event | Session | Data |
+|-------|-------|---------|------|
+| 1 | `session_tree` | original | { type: "step-snapshot", snapshotId: S1 } |
+| 2 | `session_tree` | original | { type: "step-snapshot", snapshotId: S2 } |
+| 3 | `session_tree` | original | { type: "fork", forkSessionId: "fork-1", fromEntry: U2 } |
+| 4 | `session_tree` | fork | { type: "session_created", forkedFrom: original, entries: [U1,A1,T1,U2] } |
+| 5 | `session_tree` | fork | { type: "step-snapshot", snapshotId: S1' } |
+| 6 | `session_tree` | fork | { type: "step-snapshot", snapshotId: S2' } |
+
+### Sub-case 7b: Fork + Rollback
+
+| Step | Action | Entries | Expected |
+|------|--------|---------|----------|
+| 1-5 | Same as 7a | — | — |
+| 6 | In fork: rollback to U1' (skipFiles=false) | BS1' | Files in fork: A(modified) restored, B removed |
+| 7 | In original: no change | — | Original unaffected |
+
+#### Expected Results (7b)
+- Fork rollback only affects fork session
+- Files in fork: B removed, A stays modified (fork has no pre-fork snapshots to restore to)
+- Original session tree and file state unchanged
+
+#### Event Log (7b)
+
+| Order | Event | Session | Data |
+|-------|-------|---------|------|
+| 1-6 | Same as 7a | — | — |
+| 7 | `session_tree` | fork | { type: "branch_summary", entryId: BS1', rollbackTo: U1', skipFiles: false } |
+| 8 | `file-snapshot` | fork | { action: "restore", filesRestored: ["B"] } |
+
+### Sub-case 7c: Fork of Fork
+
+| Step | Action | Expected |
+|------|--------|----------|
+| 1-5 | Same as 7a | — |
+| 6 | Fork the fork (from fork's current position) | New-new session, fresh snapshot index |
+| 7 | In fork-of-fork: rollback works independently | No cross-contamination |
+
+#### Expected Results (7c)
+- Fork-of-fork has its own independent snapshot index
+- Rollback in fork-of-fork does not affect fork or original
+- No cross-contamination between any session level
+
+---
+
+## Case 8: Rollback Across Multiple Compactions
+
+### Scenario
+Multiple compactions → Rollback to before first compaction
+
+### Steps
+
+| Step | Action | Entries |
+|------|--------|---------|
+| 1-4 | Create files A, B (turns 1-2) | U1,A1,T1,S1, U2,A2,T2,S2 |
+| 5 | Compaction of turns 1-2 | C1 |
+| 6-9 | Create files C, D (turns 3-4) | U3,A3,T3,S3, U4,A4,T4,S4 |
+| 10 | Compaction of turn 3 (C1+U3-A3) | C2 |
+| 11 | Rollback to U2 (skipFiles=false) | BS1 |
+| 12 | Verify: C1, C2 both gone, original messages restored, files restored to S2 state |
+
+### Expected Results
+- Both C1 and C2 are after U2, so rollback undoes both
+- Original messages U1,A1,T1,U2,A2,T2 are restored in context
+- Files: restored to S2 state (A, B exist; C, D removed)
+- Entry tree: BS1 is new leaf, C1/C2 and everything after U2 is in the branch but not traversed
+
+### Event Log
+
+| Order | Event | Data |
+|-------|-------|------|
+| 1 | `session_tree` (step 2) | { type: "step-snapshot", snapshotId: S1 } |
+| 2 | `session_tree` (step 4) | { type: "step-snapshot", snapshotId: S2 } |
+| 3 | `session_tree` (step 5) | { type: "compaction", entryId: C1, summarized: [U1,A1,T1,U2,A2,T2] } |
+| 4 | `session_tree` (step 8) | { type: "step-snapshot", snapshotId: S3 } |
+| 5 | `session_tree` (step 9) | { type: "step-snapshot", snapshotId: S4 } |
+| 6 | `session_tree` (step 10) | { type: "compaction", entryId: C2, summarized: [C1,U3,A3,T3] } |
+| 7 | `session_tree` (step 11) | { type: "branch_summary", entryId: BS1, rollbackTo: U2, skipFiles: false } |
+| 8 | `file-snapshot` (step 11) | { action: "restore", targetSnapshot: S2, filesRestored: ["C","D"], filesDeleted: ["C","D"] } |
+| 9 | `session_tree` (step 11, side effect) | { type: "compaction_undone", entryId: C1 } |
+| 10 | `session_tree` (step 11, side effect) | { type: "compaction_undone", entryId: C2 } |
+
+---
+
+## Case 9: Rollback Then Continue Conversation
+
+### Scenario
+Rollback → Continue working → Rollback again
+
+### Steps
+
+| Step | Action | Entries |
+|------|--------|---------|
+| 1-4 | Create A, modify B | U1,A1,T1,S1, U2,A2,T2,S2 |
+| 5 | Rollback to U1 (skipFiles=false) | BS1, files restored |
+| 6 | User: "create file C" | U3 |
+| 7 | Assistant creates file C | A3, T3, S3 |
+| 8 | Rollback to BS1 (skipFiles=false) | BS2, files restored to post-step-5 state |
+
+### Expected Results
+- Step 5: leafId moves to BS1, files restored to S1 state (A exists, B original)
+- Step 7: new branch created from BS1, S3 snapshots current file state
+- Step 8: leafId moves to BS2, files restored to S1 state again (A exists, B original, C removed)
+- A3/T3/S3 branch still exists in tree (not deleted, just not traversed)
+
+### Event Log
+
+| Order | Event | Data |
+|-------|-------|------|
+| 1 | `session_tree` (step 2) | { type: "step-snapshot", snapshotId: S1 } |
+| 2 | `session_tree` (step 4) | { type: "step-snapshot", snapshotId: S2 } |
+| 3 | `session_tree` (step 5) | { type: "branch_summary", entryId: BS1, rollbackTo: U1, skipFiles: false } |
+| 4 | `file-snapshot` (step 5) | { action: "restore", targetSnapshot: S1 } |
+| 5 | `session_tree` (step 7) | { type: "step-snapshot", snapshotId: S3, branchFrom: BS1 } |
+| 6 | `session_tree` (step 8) | { type: "branch_summary", entryId: BS2, rollbackTo: BS1, skipFiles: false } |
+| 7 | `file-snapshot` (step 8) | { action: "restore", targetSnapshot: S1, filesRestored: ["B"], filesDeleted: ["C"] } |
+
+---
+
+## Case 10: Concurrent Deletion + Summary + Compaction
+
+### Scenario
+All three operations coexist → Rollback through all of them
+
+### Steps
+
+| Step | Action | Entries |
+|------|--------|---------|
+| 1-6 | Create A, B, C (3 turns) | U1,A1,T1,S1, U2,A2,T2,S2, U3,A3,T3,S3 |
+| 7 | Delete A2 | D1(targets=[A2]) |
+| 8 | Summarize A1-T1 | SS1(targets=[A1,T1], summary="Created file A") |
+| 9 | Compact turns 1-3 | C1 |
+| 10 | Rollback to U2 (skipFiles=false) | BS1 |
+| 11 | Verify: D1, SS1, C1 all after rollback point, original messages restored, files at S2 state |
+
+### Expected Results
+- At step 7: A2 excluded from context
+- At step 8: A1,T1 replaced by segment summary in context
+- At step 9: remaining messages summarized into compaction
+- At step 10: D1, SS1, C1 all undone → original messages U1,A1,T1,U2,A2,T2 visible
+- Files: restored to S2 state (A, B exist; C removed)
+
+### Event Log
+
+| Order | Event | Data |
+|-------|-------|------|
+| 1 | `session_tree` (step 2) | { type: "step-snapshot", snapshotId: S1 } |
+| 2 | `session_tree` (step 4) | { type: "step-snapshot", snapshotId: S2 } |
+| 3 | `session_tree` (step 6) | { type: "step-snapshot", snapshotId: S3 } |
+| 4 | `session_tree` (step 7) | { type: "deletion", entryId: D1, targets: [A2] } |
+| 5 | `session_tree` (step 8) | { type: "segment_summary", entryId: SS1, targets: [A1,T1] } |
+| 6 | `session_tree` (step 9) | { type: "compaction", entryId: C1, summarized: [SS1,U2,D1,..] } |
+| 7 | `session_tree` (step 10) | { type: "branch_summary", entryId: BS1, rollbackTo: U2, skipFiles: false } |
+| 8 | `file-snapshot` (step 10) | { action: "restore", targetSnapshot: S2, filesDeleted: ["C"] } |
+| 9 | `session_tree` (step 10, side effect) | { type: "deletion_undone", entryId: D1 } |
+| 10 | `session_tree` (step 10, side effect) | { type: "segment_summary_undone", entryId: SS1 } |
+| 11 | `session_tree` (step 10, side effect) | { type: "compaction_undone", entryId: C1 } |

package/docs/rpc.md

@@ -2,7 +2,7 @@
 
 RPC mode enables headless operation of the coding agent via a JSON protocol over stdin/stdout. This is useful for embedding the agent in other applications, IDEs, or custom UIs.
 
-**Note for Node.js/TypeScript users**: If you're building a Node.js application, consider using `AgentSession` directly from `@mariozechner/pi-coding-agent` instead of spawning a subprocess. See [`src/core/agent-session.ts`](../src/core/agent-session.ts) for the API. For a subprocess-based TypeScript client, see [`src/modes/rpc/rpc-client.ts`](../src/modes/rpc/rpc-client.ts).
+**Note for Node.js/TypeScript users**: If you're building a Node.js application, consider using `AgentSession` directly from `@dyyz1993/pi-coding-agent` instead of spawning a subprocess. See [`src/core/agent-session.ts`](../src/core/agent-session.ts) for the API. For a subprocess-based TypeScript client, see [`src/modes/rpc/rpc-client.ts`](../src/modes/rpc/rpc-client.ts).
 
 ## Starting RPC Mode
 

package/docs/sdk.md

@@ -16,7 +16,7 @@ See [examples/sdk/](../examples/sdk/) for working examples from minimal to full
 ## Quick Start
 
 ```typescript
-import { AuthStorage, createAgentSession, ModelRegistry, SessionManager } from "@mariozechner/pi-coding-agent";
+import { AuthStorage, createAgentSession, ModelRegistry, SessionManager } from "@dyyz1993/pi-coding-agent";
 
 // Set up credential storage and model registry
 const authStorage = AuthStorage.create();
@@ -40,7 +40,7 @@ await session.prompt("What files are in the current directory?");
 ## Installation
 
 ```bash
-npm install @mariozechner/pi-coding-agent
+npm install @dyyz1993/pi-coding-agent
 ```
 
 The SDK is included in the main package. No separate installation needed.
@@ -54,7 +54,7 @@ The main factory function for a single `AgentSession`.
 `createAgentSession()` uses a `ResourceLoader` to supply extensions, skills, prompt templates, themes, and context files. If you do not provide one, it uses `DefaultResourceLoader` with standard discovery.
 
 ```typescript
-import { createAgentSession } from "@mariozechner/pi-coding-agent";
+import { createAgentSession } from "@dyyz1993/pi-coding-agent";
 
 // Minimal: defaults with DefaultResourceLoader
 const { session } = await createAgentSession();
@@ -132,7 +132,7 @@ import {
   createAgentSessionServices,
   getAgentDir,
   SessionManager,
-} from "@mariozechner/pi-coding-agent";
+} from "@dyyz1993/pi-coding-agent";
 
 const createRuntime: CreateAgentSessionRuntimeFactory = async ({ cwd, sessionManager, sessionStartEvent }) => {
   const services = await createAgentSessionServices({ cwd });
@@ -239,7 +239,7 @@ Both `steer()` and `followUp()` expand file-based prompt templates but error on
 
 ### Agent and AgentState
 
-The `Agent` class (from `@mariozechner/pi-agent-core`) handles the core LLM interaction. Access it via `session.agent`.
+The `Agent` class (from `@dyyz1993/pi-agent-core`) handles the core LLM interaction. Access it via `session.agent`.
 
 ```typescript
 // Access current state
@@ -368,8 +368,8 @@ When you pass a custom `ResourceLoader`, `cwd` and `agentDir` no longer control
 ### Model
 
 ```typescript
-import { getModel } from "@mariozechner/pi-ai";
-import { AuthStorage, ModelRegistry } from "@mariozechner/pi-coding-agent";
+import { getModel } from "@dyyz1993/pi-ai";
+import { AuthStorage, ModelRegistry } from "@dyyz1993/pi-coding-agent";
 
 const authStorage = AuthStorage.create();
 const modelRegistry = ModelRegistry.create(authStorage);
@@ -416,7 +416,7 @@ API key resolution priority (handled by AuthStorage):
 4. Fallback resolver (for custom provider keys from `models.json`)
 
 ```typescript
-import { AuthStorage, ModelRegistry } from "@mariozechner/pi-coding-agent";
+import { AuthStorage, ModelRegistry } from "@dyyz1993/pi-coding-agent";
 
 // Default: uses ~/.pi/agent/auth.json and ~/.pi/agent/models.json
 const authStorage = AuthStorage.create();
@@ -452,7 +452,7 @@ const simpleRegistry = ModelRegistry.inMemory(authStorage);
 Use a `ResourceLoader` to override the system prompt:
 
 ```typescript
-import { createAgentSession, DefaultResourceLoader } from "@mariozechner/pi-coding-agent";
+import { createAgentSession, DefaultResourceLoader } from "@dyyz1993/pi-coding-agent";
 
 const loader = new DefaultResourceLoader({
   systemPromptOverride: () => "You are a helpful assistant.",
@@ -472,7 +472,7 @@ import {
   readOnlyTools, // read, grep, find, ls
   readTool, bashTool, editTool, writeTool,
   grepTool, findTool, lsTool,
-} from "@mariozechner/pi-coding-agent";
+} from "@dyyz1993/pi-coding-agent";
 
 // Use built-in tool set
 const { session } = await createAgentSession({
@@ -500,7 +500,7 @@ import {
   createGrepTool,
   createFindTool,
   createLsTool,
-} from "@mariozechner/pi-coding-agent";
+} from "@dyyz1993/pi-coding-agent";
 
 const cwd = "/path/to/project";
 
@@ -530,7 +530,7 @@ const { session } = await createAgentSession({
 
 ```typescript
 import { Type } from "typebox";
-import { createAgentSession, defineTool } from "@mariozechner/pi-coding-agent";
+import { createAgentSession, defineTool } from "@dyyz1993/pi-coding-agent";
 
 // Inline custom tool
 const myTool = defineTool({
@@ -563,7 +563,7 @@ Custom tools passed via `customTools` are combined with extension-registered too
 Extensions are loaded by the `ResourceLoader`. `DefaultResourceLoader` discovers extensions from `~/.pi/agent/extensions/`, `.pi/extensions/`, and settings.json extension sources.
 
 ```typescript
-import { createAgentSession, DefaultResourceLoader } from "@mariozechner/pi-coding-agent";
+import { createAgentSession, DefaultResourceLoader } from "@dyyz1993/pi-coding-agent";
 
 const loader = new DefaultResourceLoader({
   additionalExtensionPaths: ["/path/to/my-extension.ts"],
@@ -585,7 +585,7 @@ Extensions can register tools, subscribe to events, add commands, and more. See
 **Event Bus:** Extensions can communicate via `pi.events`. Pass a shared `eventBus` to `DefaultResourceLoader` if you need to emit or listen from outside:
 
 ```typescript
-import { createEventBus, DefaultResourceLoader } from "@mariozechner/pi-coding-agent";
+import { createEventBus, DefaultResourceLoader } from "@dyyz1993/pi-coding-agent";
 
 const eventBus = createEventBus();
 const loader = new DefaultResourceLoader({
@@ -605,7 +605,7 @@ import {
   createAgentSession,
   DefaultResourceLoader,
   type Skill,
-} from "@mariozechner/pi-coding-agent";
+} from "@dyyz1993/pi-coding-agent";
 
 const customSkill: Skill = {
   name: "my-skill",
@@ -631,7 +631,7 @@ const { session } = await createAgentSession({ resourceLoader: loader });
 ### Context Files
 
 ```typescript
-import { createAgentSession, DefaultResourceLoader } from "@mariozechner/pi-coding-agent";
+import { createAgentSession, DefaultResourceLoader } from "@dyyz1993/pi-coding-agent";
 
 const loader = new DefaultResourceLoader({
   agentsFilesOverride: (current) => ({
@@ -655,7 +655,7 @@ import {
   createAgentSession,
   DefaultResourceLoader,
   type PromptTemplate,
-} from "@mariozechner/pi-coding-agent";
+} from "@dyyz1993/pi-coding-agent";
 
 const customCommand: PromptTemplate = {
   name: "deploy",
@@ -690,7 +690,7 @@ import {
   createAgentSessionServices,
   getAgentDir,
   SessionManager,
-} from "@mariozechner/pi-coding-agent";
+} from "@dyyz1993/pi-coding-agent";
 
 // In-memory (no persistence)
 const { session } = await createAgentSession({
@@ -779,12 +779,12 @@ sm.branchWithSummary(id, "Summary...");  // Branch with context summary
 sm.createBranchedSession(leafId);       // Extract path to new file
 ```
 
-> See [examples/sdk/11-sessions.ts](../examples/sdk/11-sessions.ts) and [docs/session.md](session.md)
+> See [examples/sdk/11-sessions.ts](../examples/sdk/11-sessions.ts) and [Session Format](session-format.md)
 
 ### Settings Management
 
 ```typescript
-import { createAgentSession, SettingsManager, SessionManager } from "@mariozechner/pi-coding-agent";
+import { createAgentSession, SettingsManager, SessionManager } from "@dyyz1993/pi-coding-agent";
 
 // Default: loads from files (global + project merged)
 const { session } = await createAgentSession({
@@ -840,7 +840,7 @@ Use `DefaultResourceLoader` to discover extensions, skills, prompts, themes, and
 import {
   DefaultResourceLoader,
   getAgentDir,
-} from "@mariozechner/pi-coding-agent";
+} from "@dyyz1993/pi-coding-agent";
 
 const loader = new DefaultResourceLoader({
   cwd,
@@ -881,7 +881,7 @@ interface LoadExtensionsResult {
 ## Complete Example
 
 ```typescript
-import { getModel } from "@mariozechner/pi-ai";
+import { getModel } from "@dyyz1993/pi-ai";
 import { Type } from "typebox";
 import {
   AuthStorage,
@@ -893,7 +893,7 @@ import {
   readTool,
   SessionManager,
   SettingsManager,
-} from "@mariozechner/pi-coding-agent";
+} from "@dyyz1993/pi-coding-agent";
 
 // Set up auth storage (custom location)
 const authStorage = AuthStorage.create("/custom/agent/auth.json");
@@ -978,7 +978,7 @@ import {
   getAgentDir,
   InteractiveMode,
   SessionManager,
-} from "@mariozechner/pi-coding-agent";
+} from "@dyyz1993/pi-coding-agent";
 
 const createRuntime: CreateAgentSessionRuntimeFactory = async ({ cwd, sessionManager, sessionStartEvent }) => {
   const services = await createAgentSessionServices({ cwd });
@@ -1018,7 +1018,7 @@ import {
   getAgentDir,
   runPrintMode,
   SessionManager,
-} from "@mariozechner/pi-coding-agent";
+} from "@dyyz1993/pi-coding-agent";
 
 const createRuntime: CreateAgentSessionRuntimeFactory = async ({ cwd, sessionManager, sessionStartEvent }) => {
   const services = await createAgentSessionServices({ cwd });
@@ -1055,7 +1055,7 @@ import {
   getAgentDir,
   runRpcMode,
   SessionManager,
-} from "@mariozechner/pi-coding-agent";
+} from "@dyyz1993/pi-coding-agent";
 
 const createRuntime: CreateAgentSessionRuntimeFactory = async ({ cwd, sessionManager, sessionStartEvent }) => {
   const services = await createAgentSessionServices({ cwd });

package/docs/{session.md → session-format.md}

@@ -28,13 +28,13 @@ Existing sessions are automatically migrated to the current version (v3) when lo
 
 ## Source Files
 
-Source on GitHub ([pi-mono](https://github.com/badlogic/pi-mono)):
-- [`packages/coding-agent/src/core/session-manager.ts`](https://github.com/badlogic/pi-mono/blob/main/packages/coding-agent/src/core/session-manager.ts) - Session entry types and SessionManager
-- [`packages/coding-agent/src/core/messages.ts`](https://github.com/badlogic/pi-mono/blob/main/packages/coding-agent/src/core/messages.ts) - Extended message types (BashExecutionMessage, CustomMessage, etc.)
-- [`packages/ai/src/types.ts`](https://github.com/badlogic/pi-mono/blob/main/packages/ai/src/types.ts) - Base message types (UserMessage, AssistantMessage, ToolResultMessage)
-- [`packages/agent/src/types.ts`](https://github.com/badlogic/pi-mono/blob/main/packages/agent/src/types.ts) - AgentMessage union type
+Source on GitHub ([pi-mono](https://github.com/dyyz1993/pi-mono)):
+- [`packages/coding-agent/src/core/session-manager.ts`](https://github.com/dyyz1993/pi-mono/blob/main/packages/coding-agent/src/core/session-manager.ts) - Session entry types and SessionManager
+- [`packages/coding-agent/src/core/messages.ts`](https://github.com/dyyz1993/pi-mono/blob/main/packages/coding-agent/src/core/messages.ts) - Extended message types (BashExecutionMessage, CustomMessage, etc.)
+- [`packages/ai/src/types.ts`](https://github.com/dyyz1993/pi-mono/blob/main/packages/ai/src/types.ts) - Base message types (UserMessage, AssistantMessage, ToolResultMessage)
+- [`packages/agent/src/types.ts`](https://github.com/dyyz1993/pi-mono/blob/main/packages/agent/src/types.ts) - AgentMessage union type
 
-For TypeScript definitions in your project, inspect `node_modules/@mariozechner/pi-coding-agent/dist/` and `node_modules/@mariozechner/pi-ai/dist/`.
+For TypeScript definitions in your project, inspect `node_modules/@dyyz1993/pi-coding-agent/dist/` and `node_modules/@dyyz1993/pi-ai/dist/`.
 
 ## Message Types