Chat share functionnality (#7)

* feat: enhance chat functionality with session management

- Updated `useChat` hook to accept an optional `initialSession` parameter for initializing chat history.
- Modified `ChatComponent` to handle read-only mode and pass the initial session to the chat hook.
- Enhanced `useSessionManager` to skip loading the current session if chat history is already populated.
- Added session sharing capabilities in the `SessionSidebar`, including loading and managing session shares.
- Introduced new API endpoints for creating, retrieving, and deleting session shares in the backend.

This update improves user experience by allowing session persistence and sharing, enhancing the overall chat functionality.

* Add CI steps for plugin metadata extraction, packaging, and validation; update Go dependencies

* fix: no package

* fix: no cursor plan

* fix: no cursor plan

* fix: no custom expiration

* fix: session read only

* fix: session read only

* fix: e2e tests

* fix: npm run dev

* feat: add Redis support for session sharing and health checks

- Introduced Redis configuration and client creation in the plugin.
- Implemented fallback logic for in-memory storage if Redis is unavailable.
- Updated health check to include Redis connection status.
- Added Redis service to docker-compose for local development.

* go dep

* feat: enhance session sharing with expiration options

- Updated ShareDialog to handle expiration options for shares, including "Never" and specific durations in hours and days.
- Modified sessionShareService to accept both hours and days for expiration, improving flexibility.
- Adjusted tests to validate new expiration logic and ensure correct behavior for share creation.
- Refactored session management to support immediate saving of chat history and session states.
- Cleaned up unused import and export functionalities in the session sidebar component.

* fix: resolve session sharing expiration handling

- Fixed issues with session sharing expiration options not being applied correctly.
- Ensured that both "Never" and specific duration settings are functioning as intended.
- Updated related tests to cover edge cases for expiration logic.

* fix: coverage target

* test: improve session sharing tests for revoke functionality and error handling

- Enhanced the test for revoking session shares by ensuring the "Create Another Share" button is visible after a share is created.
- Added checks for the visibility of the "Existing Shares" label before locating the revoke button.
- Updated error handling test to avoid strict mode violations by using the first() method for the error message element.

* fix bugbot

* fix bugbot

* fix: e2e ?

* fix: e2e ?

* fix: lint

* fix: lint

* fix: lint

* fix: e2e - claude code better?

* fix: claude <3

* fix: claude <3

Author: alexinthesky

.github/workflows/ci.yml

@@ -60,3 +60,33 @@ jobs:
         with:
           version: latest
           args: test
+
+      - name: Get plugin metadata
+        id: metadata
+        run: |
+          sudo apt-get update && sudo apt-get install -y jq
+          
+          export GRAFANA_PLUGIN_ID=$(cat dist/plugin.json | jq -r .id)
+          export GRAFANA_PLUGIN_VERSION=$(cat dist/plugin.json | jq -r .info.version)
+          export GRAFANA_PLUGIN_TYPE=$(cat dist/plugin.json | jq -r .type)
+          export GRAFANA_PLUGIN_ARTIFACT=${GRAFANA_PLUGIN_ID}-${GRAFANA_PLUGIN_VERSION}.zip
+          
+          echo "plugin-id=${GRAFANA_PLUGIN_ID}" >> $GITHUB_OUTPUT
+          echo "plugin-version=${GRAFANA_PLUGIN_VERSION}" >> $GITHUB_OUTPUT
+          echo "plugin-type=${GRAFANA_PLUGIN_TYPE}" >> $GITHUB_OUTPUT
+          echo "archive=${GRAFANA_PLUGIN_ARTIFACT}" >> $GITHUB_OUTPUT
+
+      - name: Package plugin
+        id: package-plugin
+        run: |
+          mv dist $PLUGIN_ID
+          zip $PLUGIN_ARCHIVE $PLUGIN_ID -r
+        env:
+          PLUGIN_ID: ${{ steps.metadata.outputs.plugin-id }}
+          PLUGIN_ARCHIVE: ${{ steps.metadata.outputs.archive }}
+
+      - name: Validate plugin
+        run: |
+          npx -y @grafana/plugin-validator@latest -sourceCodeUri file://./ $PLUGIN_ARCHIVE
+        env:
+          PLUGIN_ARCHIVE: ${{ steps.metadata.outputs.archive }}

.gitignore

@@ -53,3 +53,11 @@ ci/
 .env.local
 .env.development
 .env.production
+
+
+# Grafana plugin
+consensys-asko11y-app/
+consensys-asko11y-app.zip
+
+# Cursor plan file
+.cursor/plans/

AGENTS.md

@@ -211,9 +211,49 @@ pkg/
 **Business Logic** (`src/core/services/SessionService.ts`):
 
 - Always validate org context
-- Implement 10s debounce for auto-save
+- Auto-save when streaming completes (immediate save, no debounce)
 - Maintain org isolation within user's storage (sessions organized by org, but private to each user)
 
+### Session Sharing
+
+**Backend Implementation** (`pkg/plugin/shares.go`, `pkg/plugin/shares_redis.go`):
+
+- **Storage Options**: In-memory (default) or Redis (optional, for production)
+- **Share Store Interface**: `ShareStoreInterface` allows pluggable storage backends
+- **Rate Limiting**: 50 shares per hour per user (prevents abuse)
+- **Expiration Handling**: Supports expiration in days or hours (hours converted to days internally)
+- **Organization Isolation**: Shares are scoped to the organization where created
+- **Secure IDs**: Cryptographically secure share IDs (32-byte random tokens, base64 URL-safe encoded)
+
+**API Endpoints** (`pkg/plugin/plugin.go`):
+
+- `POST /api/sessions/share` - Create a share link
+- `GET /api/sessions/shared/:shareId` - Get shared session (read-only, org-scoped)
+- `DELETE /api/sessions/share/:shareId` - Revoke a share link
+- `GET /api/sessions/:sessionId/shares` - List all shares for a session
+
+**Frontend Implementation** (`src/services/sessionShare.ts`, `src/components/Chat/components/ShareDialog/ShareDialog.tsx`):
+
+- `SessionShareService` - Client service for share operations
+- `ShareDialog` - UI component for creating and managing shares
+- `SharedSession` page (`src/pages/SharedSession.tsx`) - Read-only view for shared sessions
+- Expiration options: 1 hour, 1 day, 7 days, 30 days, 90 days, or never
+- Import functionality: Users can import shared sessions into their account
+
+**Redis Support** (Optional):
+
+- Configure Redis via environment variables or plugin config
+- `RedisShareStore` implements `ShareStoreInterface` for persistent storage
+- Automatic TTL handling (Redis manages expiration)
+- Session index sets for efficient lookup of all shares for a session
+- See `pkg/plugin/shares_redis.go` for implementation details
+
+**Adding Redis Support:**
+
+1. Set Redis connection details in plugin configuration or environment variables
+2. Backend automatically detects Redis availability and uses it if configured
+3. Falls back to in-memory storage if Redis is unavailable
+
 ### Backend Development Workflow
 
 1. Make Go code changes
@@ -352,6 +392,17 @@ docker compose exec grafana curl http://mcp-grafana:8000/mcp
 # Auto-cleanup: triggers at quota limit
 ```
 
+**Session sharing issues:**
+
+```bash
+# Check share link is accessible
+# Verify share hasn't expired (check expiration date)
+# Check organization context (shares are org-scoped)
+# Verify rate limit (50 shares per hour per user)
+# Check Redis connection if using Redis backend
+docker compose logs -f grafana | grep -i "share\|redis"
+```
+
 ## Key Files Reference
 
 ### Entry Points
@@ -364,9 +415,15 @@ docker compose exec grafana curl http://mcp-grafana:8000/mcp
 
 - `pkg/plugin/plugin.go:140-191` - RBAC read-only tool list (`isReadOnlyTool()`)
 - `pkg/plugin/plugin.go:192-233` - RBAC filtering (`filterToolsByRole()`, `canAccessTool()`)
+- `pkg/plugin/plugin.go:600-850` - Session sharing API endpoints
+- `pkg/plugin/shares.go` - In-memory share store implementation
+- `pkg/plugin/shares_redis.go` - Redis-backed share store implementation
 - `pkg/mcp/client.go:49-75` - Multi-tenant header injection
 - `src/core/services/SessionService.ts` - Session business logic
 - `src/core/repositories/GrafanaUserStorageRepository.ts` - Session persistence (uses Grafana UserStorage API - per-user storage with localStorage fallback, organized by organization)
+- `src/services/sessionShare.ts` - Session sharing client service
+- `src/components/Chat/components/ShareDialog/ShareDialog.tsx` - Share dialog UI component
+- `src/pages/SharedSession.tsx` - Shared session read-only view page
 - `src/services/backendMCPClient.ts` - MCP proxy client
 
 ### Configuration

README.md

@@ -132,7 +132,7 @@ See [Grafana documentation on allow_embedding](https://grafana.com/docs/grafana/
 ### 💾 Smart Session Management
 
 **Never Lose Your Work:**
-- **Auto-Save**: All conversations saved every 2 seconds
+- **Auto-Save**: All conversations saved automatically when streaming completes
 - **Session History**: Browse, resume, and manage previous conversations
 - **Organization Scoping**: Sessions organized by Grafana organization within each user's storage (sessions are private to each user)
 - **Import/Export**: Backup sessions as JSON or share with team members
@@ -145,6 +145,24 @@ See [Grafana documentation on allow_embedding](https://grafana.com/docs/grafana/
 - Search through conversation history
 - Export important conversations for documentation
 
+### 🔗 Session Sharing
+
+**Share Conversations with Your Team:**
+- **Shareable Links**: Create secure, shareable links for any chat session
+- **Flexible Expiration**: Set expiration times (1 hour, 1 day, 7 days, 30 days, 90 days, or never)
+- **Read-Only Viewing**: Recipients can view shared sessions in read-only mode
+- **Import to Account**: Import shared sessions into your own account for continued conversation
+- **Revoke Access**: Revoke share links at any time
+- **Rate Limited**: 50 shares per hour per user to prevent abuse
+- **Organization Isolation**: Shares are scoped to the organization where they were created
+
+**How It Works:**
+1. Click the share button on any session
+2. Choose an expiration time (or set to never expire)
+3. Copy the generated share link
+4. Share the link with team members
+5. Recipients can view the session or import it to continue the conversation
+
 ### ⚙️ Customizable Configuration
 
 - **System Prompts**: Customize AI behavior (default, replace, or append mode)
@@ -497,6 +515,18 @@ For detailed troubleshooting, see the [Troubleshooting Guide](src/README.md#trou
 3. Ensure organization context is correct
 4. Review Grafana RBAC policies if using Enterprise
 
+### Session Sharing Issues
+
+**Issue**: Share link not working, expired, or access denied
+
+**Solutions**:
+1. **Check Expiration**: Verify the share link hasn't expired (check expiration date)
+2. **Organization Context**: Ensure accessing from the same Grafana organization where created
+3. **Rate Limit**: Maximum 50 shares per hour per user - wait if limit reached
+4. **Share Revoked**: Creator may have revoked the share link
+5. **Backend Storage**: If using in-memory storage, shares are lost on Grafana restart (use Redis for persistence)
+6. Check Grafana logs: `docker compose logs -f grafana | grep -i share`
+
 ### Build or Development Issues
 
 **Issue**: Plugin fails to build or run in development

docker-compose.yaml

@@ -1,4 +1,17 @@
 services:
+  redis:
+    image: redis:7-alpine
+    ports:
+      - "127.0.0.1:6379:6379"
+    command: redis-server --appendonly yes
+    volumes:
+      - redis-data:/data
+    healthcheck:
+      test: ["CMD", "redis-cli", "ping"]
+      interval: 5s
+      timeout: 3s
+      retries: 5
+
   grafana:
     extends:
       file: .config/docker-compose-base.yaml
@@ -9,6 +22,10 @@ services:
       GF_AUTH_ANONYMOUS_ENABLED: false
       GF_SECURITY_ALLOW_EMBEDDING: true
       LLM_API_KEY: ${LLM_API_KEY:-}
+      GF_PLUGIN_ASKO11Y_REDIS: ${GF_PLUGIN_ASKO11Y_REDIS:-redis://redis:6379/0}
+    depends_on:
+      redis:
+        condition: service_healthy
 
   mcp-grafana:
     image: grafana/mcp-grafana
@@ -55,3 +72,6 @@ services:
     depends_on:
       - mcp-grafana
 
+volumes:
+  redis-data:
+

go.mod

@@ -5,6 +5,8 @@ go 1.25.5
 require (
 	github.com/grafana/grafana-plugin-sdk-go v0.285.0
 	github.com/modelcontextprotocol/go-sdk v1.1.0
+	github.com/redis/go-redis/v9 v9.17.2
+	golang.org/x/time v0.14.0
 )
 
 require (
@@ -15,6 +17,7 @@ require (
 	github.com/cespare/xxhash/v2 v2.3.0 // indirect
 	github.com/cheekybits/genny v1.0.0 // indirect
 	github.com/cpuguy83/go-md2man/v2 v2.0.7 // indirect
+	github.com/dgryski/go-rendezvous v0.0.0-20200823014737-9f7001d12a5f // indirect
 	github.com/fatih/color v1.17.0 // indirect
 	github.com/go-logr/logr v1.4.3 // indirect
 	github.com/go-logr/stdr v1.2.2 // indirect

go.sum

@@ -9,6 +9,10 @@ github.com/apache/thrift v0.22.0 h1:r7mTJdj51TMDe6RtcmNdQxgn9XcyfGDOzegMDRg47uc=
 github.com/apache/thrift v0.22.0/go.mod h1:1e7J/O1Ae6ZQMTYdy9xa3w9k+XHWPfRvdPyJeynQ+/g=
 github.com/beorn7/perks v1.0.1 h1:VlbKKnNfV8bJzeqoa4cOKqO6bYr3WgKZxO8Z16+hsOM=
 github.com/beorn7/perks v1.0.1/go.mod h1:G2ZrVWU2WbWT9wwq4/hrbKbnv/1ERSJQ0ibhJ6rlkpw=
+github.com/bsm/ginkgo/v2 v2.12.0 h1:Ny8MWAHyOepLGlLKYmXG4IEkioBysk6GpaRTLC8zwWs=
+github.com/bsm/ginkgo/v2 v2.12.0/go.mod h1:SwYbGRRDovPVboqFv0tPTcG1sN61LM1Z4ARdbAV9g4c=
+github.com/bsm/gomega v1.27.10 h1:yeMWxP2pV2fG3FgAODIY8EiRE3dy0aeFYt4l7wh6yKA=
+github.com/bsm/gomega v1.27.10/go.mod h1:JyEr/xRbxbtgWNi8tIEVPUYZ5Dzef52k01W3YH0H+O0=
 github.com/bufbuild/protocompile v0.14.1 h1:iA73zAf/fyljNjQKwYzUHD6AD4R8KMasmwa/FBatYVw=
 github.com/bufbuild/protocompile v0.14.1/go.mod h1:ppVdAIhbr2H8asPk6k4pY7t9zB1OU5DoEw9xY/FUi1c=
 github.com/cenkalti/backoff/v5 v5.0.3 h1:ZN+IMa753KfX5hd8vVaMixjnqRZ3y8CuJKRKj1xcsSM=
@@ -24,6 +28,8 @@ github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSs
 github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
 github.com/davecgh/go-spew v1.1.2-0.20180830191138-d8f796af33cc h1:U9qPSI2PIWSS1VwoXQT9A3Wy9MM3WgvqSxFWenqJduM=
 github.com/davecgh/go-spew v1.1.2-0.20180830191138-d8f796af33cc/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
+github.com/dgryski/go-rendezvous v0.0.0-20200823014737-9f7001d12a5f h1:lO4WD4F/rVNCu3HqELle0jiPLLBs70cWOduZpkS1E78=
+github.com/dgryski/go-rendezvous v0.0.0-20200823014737-9f7001d12a5f/go.mod h1:cuUVRXasLTGF7a8hSLbxyZXjz+1KgoB3wDUb6vlszIc=
 github.com/fatih/color v1.13.0/go.mod h1:kLAiJbzzSOZDVNGyDpeOxJ47H46qBXwg5ILebYFFOfk=
 github.com/fatih/color v1.17.0 h1:GlRw1BRJxkpqUCBKzKOw098ed57fEsKeNjpTe3cSjK4=
 github.com/fatih/color v1.17.0/go.mod h1:YZ7TlrGPkiz6ku9fK3TLD/pl3CpsiFyu8N92HLgmosI=
@@ -149,6 +155,8 @@ github.com/prometheus/common v0.67.4 h1:yR3NqWO1/UyO1w2PhUvXlGQs/PtFmoveVO0KZ4+L
 github.com/prometheus/common v0.67.4/go.mod h1:gP0fq6YjjNCLssJCQp0yk4M8W6ikLURwkdd/YKtTbyI=
 github.com/prometheus/procfs v0.16.1 h1:hZ15bTNuirocR6u0JZ6BAHHmwS1p8B4P6MRqxtzMyRg=
 github.com/prometheus/procfs v0.16.1/go.mod h1:teAbpZRB1iIAJYREa1LsoWUXykVXA1KlTmWl8x/U+Is=
+github.com/redis/go-redis/v9 v9.17.2 h1:P2EGsA4qVIM3Pp+aPocCJ7DguDHhqrXNhVcEp4ViluI=
+github.com/redis/go-redis/v9 v9.17.2/go.mod h1:u410H11HMLoB+TP67dz8rL9s6QW2j76l0//kSOd3370=
 github.com/rivo/uniseg v0.2.0/go.mod h1:J6wj4VEh+S6ZtnVlnTBMWIodfgj8LQOQFoIToxlJtxc=
 github.com/rivo/uniseg v0.4.7 h1:WUdvkW8uEhrYfLC4ZzdpI2ztxP1I582+49Oc5Mq64VQ=
 github.com/rivo/uniseg v0.4.7/go.mod h1:FN3SvrM+Zdj16jyLfmOkMNblXMcoc8DfTHruCPUcx88=
@@ -269,6 +277,8 @@ golang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ=
 golang.org/x/text v0.3.3/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ=
 golang.org/x/text v0.32.0 h1:ZD01bjUt1FQ9WJ0ClOL5vxgxOI/sVCNgX1YtKwcY0mU=
 golang.org/x/text v0.32.0/go.mod h1:o/rUWzghvpD5TXrTIBuJU77MTaN0ljMWE47kxGJQ7jY=
+golang.org/x/time v0.14.0 h1:MRx4UaLrDotUKUdCIqzPC48t1Y9hANFKIRpNx+Te8PI=
+golang.org/x/time v0.14.0/go.mod h1:eL/Oa2bBBK0TkX57Fyni+NgnyQQN4LitPmob2Hjnqw4=
 golang.org/x/tools v0.0.0-20180917221912-90fa682c2a6e/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ=
 golang.org/x/tools v0.0.0-20191119224855-298f0cb1881e/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo=
 golang.org/x/tools v0.0.0-20200619180055-7c47624df98f/go.mod h1:EkVYQZoAsY45+roYkvgYkIh4xh/qjgUK9TdY2XT94GE=

package-lock.json

@@ -28,7 +28,12 @@
     "coverage": "npm run coverage:clean && npm run coverage:unit && npm run build:frontend:coverage && npm run e2e:coverage && npm run coverage:merge",
     "server": "docker compose up --build",
     "sign": "npx --yes @grafana/sign-plugin@latest",
-    "backend:mod": "go mod tidy"
+    "backend:mod": "go mod tidy",
+    "validate": "npm run validate:build && npm run validate:archive && npm run validate:run",
+    "validate:build": "npm run build:prod",
+    "validate:archive": "PLUGIN_ID=$(node -e \"console.log(require('./src/plugin.json').id)\") && rm -rf \"${PLUGIN_ID}\" \"${PLUGIN_ID}.zip\" && mkdir -p \"${PLUGIN_ID}\" && cp -r dist/* \"${PLUGIN_ID}/\" && zip -qr \"${PLUGIN_ID}.zip\" \"${PLUGIN_ID}\" && echo \"Created ${PLUGIN_ID}.zip\"",
+    "validate:run": "PLUGIN_ID=$(node -e \"console.log(require('./src/plugin.json').id)\") && npx -y @grafana/plugin-validator@latest -sourceCodeUri file://. \"${PLUGIN_ID}.zip\"",
+    "validate:clean": "PLUGIN_ID=$(node -e \"console.log(require('./src/plugin.json').id)\") && rm -rf \"${PLUGIN_ID}\" \"${PLUGIN_ID}.zip\""
   },
   "author": "Consensys",
   "license": "MIT",
@@ -38,7 +43,7 @@
     "@babel/preset-react": "^7.28.5",
     "@babel/preset-typescript": "^7.28.5",
     "@grafana/eslint-config": "^8.2.0",
-    "@grafana/plugin-e2e": "^2.2.0",
+    "@grafana/plugin-e2e": "^3.1.4",
     "@grafana/tsconfig": "^2.0.0",
     "@istanbuljs/nyc-config-typescript": "^1.0.2",
     "@jest/test-sequencer": "^29.7.0",