pi-goosedump 0.3.4 → 0.3.5

package/README.md

@@ -21,7 +21,7 @@ Once installed, pi-goosedump registers a tool and a slash command:
 
 ### Tool: `goosedump`
 
-The agent can browse session history with:
+The agent can browse the current session by default or a named session with `contextId`:
 
 | Action   | Description                              |
 | -------- | ---------------------------------------- |
@@ -34,9 +34,10 @@ Examples:
 
 ```
 goosedump({ action: "list" })
+goosedump({ action: "search", query: "bug fix" })
 goosedump({ action: "search", contextId: "abc123", query: "bug fix" })
-goosedump({ action: "expand", contextId: "abc123", ids: ["entry-a", "entry-b"] })
-goosedump({ action: "view", contextId: "abc123" })
+goosedump({ action: "expand", ids: ["entry-a", "entry-b"] })
+goosedump({ action: "view" })
 ```
 
 ### Command: `/goosedump`

package/index.ts

@@ -551,13 +551,14 @@ export function createGoosedumpIntegration(
           name: 'goosedump',
           label: 'goosedump',
           description:
-            'Browse coding agent session history. List all sessions, or view/search within a session. Supports ranked search, compact overview, and result expansion. Default scope is active lineage.',
+            'Browse coding agent session history. List all sessions, or view/search the current or a named session. Supports ranked search, compact overview, and result expansion. Default scope is active lineage.',
           promptSnippet:
-            'goosedump({ action: "search", contextId, query, scope?, page? }) - search session history',
+            'goosedump({ action: "search", query, contextId?, scope?, page? }) - search session history; omit contextId for current session',
           promptGuidelines: [
             'When researching past conversation history, use goosedump to find relevant context.',
             'Start with compact ranked search (compact: true) for quick overview, then expand interesting entries.',
             'Default scope is "lineage" (current branch); use scope: "all" to include all entries in the session.',
+            'Omit contextId to search, expand, or view the current Pi session; use list first for other sessions.',
           ],
           parameters: Type.Object({
             action: Type.Union(
@@ -574,7 +575,8 @@ export function createGoosedumpIntegration(
             ),
             contextId: Type.Optional(
               Type.String({
-                description: 'Context/session ID (required for search, expand, view)',
+                description:
+                  'Context/session ID (defaults to current session for search, expand, view)',
               }),
             ),
             query: Type.Optional(
@@ -605,7 +607,7 @@ export function createGoosedumpIntegration(
               }),
             ),
           }),
-          async execute(_id, params, _signal, _onUpdate, _ctx): Promise<AgentToolResult<void>> {
+          async execute(_id, params, _signal, _onUpdate, ctx): Promise<AgentToolResult<void>> {
             if (!goosedumpEnabled || !goosedumpReady) {
               return {
                 content: [
@@ -641,9 +643,15 @@ export function createGoosedumpIntegration(
                 }
 
                 case 'search': {
-                  if (!params.contextId) {
+                  const contextId = params.contextId ?? currentSessionContextId(ctx);
+                  if (!contextId) {
                     return {
-                      content: [{ type: 'text', text: 'contextId is required for search' }],
+                      content: [
+                        {
+                          type: 'text',
+                          text: 'contextId is required for search when no current session is available',
+                        },
+                      ],
                       details: undefined,
                     };
                   }
@@ -655,7 +663,7 @@ export function createGoosedumpIntegration(
                     };
                   }
 
-                  const result = goosedumpContext(params.contextId, {
+                  const result = goosedumpContext(contextId, {
                     scope: params.scope ?? 'lineage',
                     grep: params.query,
                     compact: params.compact ?? true,
@@ -683,9 +691,15 @@ export function createGoosedumpIntegration(
                 }
 
                 case 'expand': {
-                  if (!params.contextId) {
+                  const contextId = params.contextId ?? currentSessionContextId(ctx);
+                  if (!contextId) {
                     return {
-                      content: [{ type: 'text', text: 'contextId is required for expand' }],
+                      content: [
+                        {
+                          type: 'text',
+                          text: 'contextId is required for expand when no current session is available',
+                        },
+                      ],
                       details: undefined,
                     };
                   }
@@ -700,7 +714,7 @@ export function createGoosedumpIntegration(
                   }
 
                   const messages = goosedumpExpand(
-                    params.contextId,
+                    contextId,
                     params.ids,
                     params.scope ?? 'lineage',
                   );
@@ -719,23 +733,27 @@ export function createGoosedumpIntegration(
                 }
 
                 case 'view': {
-                  if (!params.contextId) {
+                  const contextId = params.contextId ?? currentSessionContextId(ctx);
+                  if (!contextId) {
                     return {
-                      content: [{ type: 'text', text: 'contextId is required for view' }],
+                      content: [
+                        {
+                          type: 'text',
+                          text: 'contextId is required for view when no current session is available',
+                        },
+                      ],
                       details: undefined,
                     };
                   }
 
-                  const result = goosedumpContext(params.contextId, {
+                  const result = goosedumpContext(contextId, {
                     scope: params.scope ?? 'lineage',
                     compact: false,
                   });
 
                   if (result.messages.length === 0) {
                     return {
-                      content: [
-                        { type: 'text', text: `Session "${params.contextId}" has no messages.` },
-                      ],
+                      content: [{ type: 'text', text: `Session "${contextId}" has no messages.` }],
                       details: undefined,
                     };
                   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-goosedump",
-  "version": "0.3.4",
+  "version": "0.3.5",
   "description": "Coding agent context data browser plugin for pi",
   "keywords": [
     "goosedump",