couchloop-eq-mcp 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Greg Wisenberg
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,358 @@
+# CouchLoop MCP Server
+
+Turn conversations into guided journeys that remember where you left off.
+
+## Overview
+
+CouchLoop MCP Server provides stateful, resumable conversation experiences for AI agents. It manages sessions, progress checkpoints, and guided journeys - enabling multi-turn experiences that survive interruptions and span multiple conversations.
+
+### What This Is
+- State management infrastructure for AI conversations
+- Journey/workflow orchestration layer
+- Session persistence and resumption
+- MCP (Model Context Protocol) server for ChatGPT and Claude
+
+### What This Is NOT
+- A chatbot or conversational AI
+- A therapy/clinical tool (no PHI)
+- A UI layer (headless, works behind existing chat interfaces)
+
+## Features
+
+- **7 MCP Tools** for session management, checkpoints, journeys, and insights
+- **5 MCP Resources** for read-only context access
+- **3 Pre-built Journeys**: Daily Reflection, Gratitude Practice, Weekly Review
+- **Stateful Sessions** that can be paused and resumed
+- **Progress Tracking** with checkpoints and step advancement
+- **User Context** management with preferences and history
+- **OAuth 2.0** authentication for ChatGPT App Store
+
+## Quick Start
+
+### Prerequisites
+
+- Node.js 18+
+- PostgreSQL database (via Supabase)
+- npm or yarn
+
+### Installation
+
+1. Clone the repository:
+```bash
+git clone https://github.com/wisenbergg/couchloop-mcp.git
+cd couchloop-mcp
+```
+
+2. Install dependencies:
+```bash
+npm install
+```
+
+3. Set up environment variables:
+```bash
+cp .env.example .env
+```
+
+Edit `.env` with your configuration:
+
+### Supabase Setup
+
+1. Create a new project at [supabase.com](https://supabase.com)
+2. Get your credentials from Project Settings > API:
+   - `SUPABASE_URL`: Your project URL
+   - `SUPABASE_ANON_KEY`: Your anon/public key
+   - `SUPABASE_SERVICE_ROLE_KEY`: Your service role key
+3. Get database URL from Project Settings > Database:
+   - `DATABASE_URL`: Your PostgreSQL connection string
+
+### Environment Configuration
+
+```env
+# Database (Supabase)
+DATABASE_URL=postgresql://postgres:[password]@db.[project].supabase.co:5432/postgres
+SUPABASE_URL=https://[project].supabase.co
+SUPABASE_ANON_KEY=your-anon-key
+SUPABASE_SERVICE_ROLE_KEY=your-service-role-key
+
+# OAuth (for ChatGPT App Store)
+OAUTH_CLIENT_ID=couchloop_chatgpt
+OAUTH_CLIENT_SECRET=generate-a-secure-secret
+OAUTH_REDIRECT_URI=https://chat.openai.com/aip/plugin/oauth/callback
+JWT_SECRET=minimum-32-character-secret-key-here
+
+# Server
+PORT=3000
+NODE_ENV=development
+LOG_LEVEL=info
+```
+
+### Database Setup
+
+1. Push schema to database:
+```bash
+npm run db:push
+```
+
+2. Seed journey definitions:
+```bash
+npm run db:seed
+```
+
+3. (Optional) Open Drizzle Studio to view data:
+```bash
+npm run db:studio
+```
+
+### Running the Server
+
+#### Development Mode
+```bash
+npm run dev
+```
+
+#### Production Mode
+```bash
+npm run build
+npm start
+```
+
+## MCP Tools
+
+### Session Management
+
+#### `create_session`
+Start a new guided session, optionally with a journey.
+
+```json
+{
+  "journey_slug": "daily-reflection",
+  "context": "Evening check-in"
+}
+```
+
+#### `resume_session`
+Resume a previously paused session.
+
+```json
+{
+  "session_id": "uuid-here"
+}
+```
+
+### Progress Tracking
+
+#### `save_checkpoint`
+Save progress or capture a key moment.
+
+```json
+{
+  "session_id": "uuid-here",
+  "key": "mood",
+  "value": "calm and reflective",
+  "advance_step": true
+}
+```
+
+#### `get_journey_status`
+Get current progress in a session/journey.
+
+```json
+{
+  "session_id": "uuid-here"
+}
+```
+
+### Journeys
+
+#### `list_journeys`
+List available guided journeys.
+
+```json
+{
+  "tag": "reflection"
+}
+```
+
+### Insights
+
+#### `save_insight`
+Capture a meaningful insight from the conversation.
+
+```json
+{
+  "content": "I notice I'm more energized in the mornings",
+  "session_id": "uuid-here",
+  "tags": ["self-awareness", "energy"]
+}
+```
+
+#### `get_user_context`
+Get relevant context about the user for personalization.
+
+```json
+{
+  "include_recent_insights": true,
+  "include_session_history": true
+}
+```
+
+## MCP Resources
+
+- `session://current` - Current active session state
+- `journey://daily-reflection` - Daily Reflection journey definition
+- `journey://gratitude-practice` - Gratitude Practice journey definition
+- `journey://weekly-review` - Weekly Review journey definition
+- `context://user` - User preferences and recent history
+
+## Available Journeys
+
+### Daily Reflection (5 minutes)
+A brief check-in to process your day and capture key moments.
+- Check in with current mood
+- Identify memorable moment
+- Release what's not needed
+- Summarize and save insights
+
+### Gratitude Practice (3 minutes)
+Notice and name three things you appreciate.
+- Something small that made today better
+- Something about yourself you're grateful for
+- Someone you appreciate
+
+### Weekly Review (10 minutes)
+Look back on your week and set intentions.
+- Describe the week's tone
+- Acknowledge accomplishments
+- Notice challenges
+- Set intention for next week
+
+## Development
+
+### Scripts
+
+```bash
+# Development with hot reload
+npm run dev
+
+# Build TypeScript
+npm run build
+
+# Run tests
+npm test
+
+# Type checking
+npm run typecheck
+
+# Linting
+npm run lint
+
+# Database operations
+npm run db:push       # Push schema to database
+npm run db:seed       # Seed journeys
+npm run db:studio     # Open Drizzle Studio
+npm run db:migrate    # Run migrations
+
+# Setup helpers
+npm run setup         # Install deps and build
+npm run setup:db      # Initialize database
+```
+
+### Project Structure
+
+```
+src/
+├── index.ts              # MCP server entrypoint
+├── tools/                # MCP tool implementations
+├── resources/            # MCP resource handlers
+├── workflows/            # Journey definitions and engine
+├── db/                   # Database schema and client
+├── auth/                 # OAuth 2.0 implementation
+├── types/                # TypeScript type definitions
+└── utils/                # Logging and error handling
+api/
+└── oauth/                # OAuth endpoints for Vercel
+    ├── authorize.ts      # Authorization endpoint
+    └── token.ts          # Token exchange endpoint
+```
+
+## Deployment
+
+### Vercel Deployment
+
+1. Install Vercel CLI:
+```bash
+npm install -g vercel
+```
+
+2. Set up environment variables:
+```bash
+vercel env add DATABASE_URL
+vercel env add SUPABASE_URL
+vercel env add SUPABASE_ANON_KEY
+vercel env add SUPABASE_SERVICE_ROLE_KEY
+vercel env add OAUTH_CLIENT_ID
+vercel env add OAUTH_CLIENT_SECRET
+vercel env add OAUTH_REDIRECT_URI
+vercel env add JWT_SECRET
+```
+
+3. Deploy to Vercel:
+```bash
+# Deploy to preview
+npm run vercel
+
+# Deploy to production
+npm run vercel:prod
+```
+
+4. Your OAuth endpoints will be available at:
+   - `https://your-app.vercel.app/api/oauth/authorize`
+   - `https://your-app.vercel.app/api/oauth/token`
+
+### ChatGPT App Store Submission
+
+1. Update OAuth redirect URI in `.env` to match ChatGPT's callback
+2. Ensure all OAuth endpoints are working
+3. Create test credentials for reviewers
+4. Prepare privacy policy at `/docs/PRIVACY_POLICY.md`
+5. Submit via ChatGPT developer portal with:
+   - App name: CouchLoop (or your chosen name)
+   - Description: Turn conversations into guided journeys
+   - OAuth authorization URL: `https://your-app.vercel.app/api/oauth/authorize`
+   - OAuth token URL: `https://your-app.vercel.app/api/oauth/token`
+   - Scopes: read, write
+
+## Testing
+
+Run the test suite:
+
+```bash
+npm test
+```
+
+Run tests in watch mode:
+
+```bash
+npm run test:watch
+```
+
+## Contributing
+
+Contributions are welcome! Please read our contributing guidelines and submit PRs to the main branch.
+
+## License
+
+MIT License - see LICENSE file for details
+
+## Support
+
+- GitHub Issues: [Report bugs or request features](https://github.com/wisenbergg/couchloop-mcp/issues)
+- Documentation: [Full API documentation](./docs/API.md)
+
+## Acknowledgments
+
+Built with:
+- [Model Context Protocol SDK](https://github.com/anthropics/mcp-sdk)
+- [Supabase](https://supabase.com)
+- [Drizzle ORM](https://orm.drizzle.team)
+- [TypeScript](https://www.typescriptlang.org)

package/assets/logo/README.md

@@ -0,0 +1,12 @@
+# Logo Assets
+
+Place your logo files in this directory. Recommended formats:
+- PNG (for transparency support)
+- SVG (for scalability)
+- ICO (for favicon)
+
+Suggested filenames:
+- `logo.png` - Main logo
+- `logo.svg` - Vector version
+- `favicon.ico` - Browser favicon
+- `logo-small.png` - Small version for UI elements

package/dist/auth/middleware.d.ts

@@ -0,0 +1,8 @@
+export interface AuthContext {
+    userId: string;
+    clientId: string;
+    scope: string;
+}
+export declare function validateToken(authHeader?: string): Promise<AuthContext>;
+export declare function extractAuthHeader(args: any): string | undefined;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/auth/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/auth/middleware.ts"],"names":[],"mappings":"AAqBA,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,aAAa,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAsB7E;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,GAAG,GAAG,MAAM,GAAG,SAAS,CAoB/D"}

package/dist/auth/middleware.js

@@ -0,0 +1,59 @@
+import { jwtVerify } from 'jose';
+import { AuthenticationError } from '../utils/errors.js';
+// Only validate JWT_SECRET when running as web server (not in MCP mode)
+const isMCPMode = process.env.MCP_MODE === 'true';
+let JWT_SECRET;
+if (!isMCPMode) {
+    // Ensure JWT_SECRET is properly set for web server mode
+    if (!process.env.JWT_SECRET) {
+        throw new Error('JWT_SECRET environment variable must be set when not in MCP mode');
+    }
+    if (process.env.JWT_SECRET.length < 32) {
+        throw new Error('JWT_SECRET must be at least 32 characters long');
+    }
+    JWT_SECRET = new TextEncoder().encode(process.env.JWT_SECRET);
+}
+else {
+    // Use a placeholder for MCP mode (JWT not used in MCP)
+    JWT_SECRET = new TextEncoder().encode('mcp-mode-placeholder-not-used-for-auth');
+}
+export async function validateToken(authHeader) {
+    if (!authHeader) {
+        throw new AuthenticationError('No authorization header');
+    }
+    if (!authHeader.startsWith('Bearer ')) {
+        throw new AuthenticationError('Invalid authorization header format');
+    }
+    const token = authHeader.slice(7); // Remove "Bearer " prefix
+    try {
+        const { payload } = await jwtVerify(token, JWT_SECRET);
+        return {
+            userId: payload.sub,
+            clientId: payload.client_id,
+            scope: payload.scope,
+        };
+    }
+    catch (error) {
+        throw new AuthenticationError('Invalid or expired token');
+    }
+}
+export function extractAuthHeader(args) {
+    // MCP protocol might pass auth in various ways
+    // Check common patterns
+    if (args?._auth?.authorization) {
+        return args._auth.authorization;
+    }
+    if (args?.authorization) {
+        return args.authorization;
+    }
+    if (args?.headers?.authorization) {
+        return args.headers.authorization;
+    }
+    // In production mode, require authentication
+    if (process.env.NODE_ENV === 'production') {
+        return undefined;
+    }
+    // In development, allow unauthenticated requests
+    return 'Bearer development-token';
+}
+//# sourceMappingURL=middleware.js.map

package/dist/auth/middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../../src/auth/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,wEAAwE;AACxE,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,MAAM,CAAC;AAElD,IAAI,UAAsB,CAAC;AAC3B,IAAI,CAAC,SAAS,EAAE,CAAC;IACf,wDAAwD;IACxD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;IACtF,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IACD,UAAU,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;AAChE,CAAC;KAAM,CAAC;IACN,uDAAuD;IACvD,UAAU,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,wCAAwC,CAAC,CAAC;AAClF,CAAC;AAQD,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,UAAmB;IACrD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,mBAAmB,CAAC,yBAAyB,CAAC,CAAC;IAC3D,CAAC;IAED,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,mBAAmB,CAAC,qCAAqC,CAAC,CAAC;IACvE,CAAC;IAED,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,0BAA0B;IAE7D,IAAI,CAAC;QACH,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,SAAS,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QAEvD,OAAO;YACL,MAAM,EAAE,OAAO,CAAC,GAAa;YAC7B,QAAQ,EAAE,OAAO,CAAC,SAAmB;YACrC,KAAK,EAAE,OAAO,CAAC,KAAe;SAC/B,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,mBAAmB,CAAC,0BAA0B,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAS;IACzC,+CAA+C;IAC/C,wBAAwB;IACxB,IAAI,IAAI,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC;IAClC,CAAC;IACD,IAAI,IAAI,EAAE,aAAa,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IACD,IAAI,IAAI,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC;IACpC,CAAC;IAED,6CAA6C;IAC7C,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;QAC1C,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,iDAAiD;IACjD,OAAO,0BAA0B,CAAC;AACpC,CAAC"}

package/dist/clients/shrinkChatClient.d.ts

@@ -0,0 +1,195 @@
+import { z } from 'zod';
+export declare const ShrinkResponseSchema: z.ZodObject<{
+    reply: z.ZodOptional<z.ZodString>;
+    response_text: z.ZodOptional<z.ZodString>;
+    content: z.ZodOptional<z.ZodString>;
+    messageId: z.ZodOptional<z.ZodString>;
+    crisisDetected: z.ZodOptional<z.ZodBoolean>;
+    crisisLevel: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+    crisis_level: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+    crisisHandled: z.ZodOptional<z.ZodBoolean>;
+    crisis_confidence: z.ZodOptional<z.ZodNumber>;
+    emotions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    therapeuticTechnique: z.ZodOptional<z.ZodString>;
+    resources: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+        title: z.ZodString;
+        url: z.ZodOptional<z.ZodString>;
+        phone: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: string;
+        title: string;
+        description?: string | undefined;
+        url?: string | undefined;
+        phone?: string | undefined;
+    }, {
+        type: string;
+        title: string;
+        description?: string | undefined;
+        url?: string | undefined;
+        phone?: string | undefined;
+    }>, "many">>;
+    escalationPath: z.ZodOptional<z.ZodString>;
+    threadId: z.ZodOptional<z.ZodString>;
+    meta: z.ZodOptional<z.ZodObject<{
+        rag_confidence: z.ZodOptional<z.ZodNumber>;
+        emotionalTone: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        therapeuticElements: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        rag_confidence?: number | undefined;
+        emotionalTone?: string[] | undefined;
+        therapeuticElements?: string[] | undefined;
+    }, {
+        rag_confidence?: number | undefined;
+        emotionalTone?: string[] | undefined;
+        therapeuticElements?: string[] | undefined;
+    }>>;
+    memory_high_relevance_count: z.ZodOptional<z.ZodNumber>;
+    error: z.ZodOptional<z.ZodString>;
+    error_type: z.ZodOptional<z.ZodString>;
+    message: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    threadId?: string | undefined;
+    content?: string | undefined;
+    crisis_level?: string | number | undefined;
+    crisisLevel?: string | number | undefined;
+    resources?: {
+        type: string;
+        title: string;
+        description?: string | undefined;
+        url?: string | undefined;
+        phone?: string | undefined;
+    }[] | undefined;
+    escalationPath?: string | undefined;
+    message?: string | undefined;
+    error?: string | undefined;
+    reply?: string | undefined;
+    response_text?: string | undefined;
+    messageId?: string | undefined;
+    crisisDetected?: boolean | undefined;
+    crisisHandled?: boolean | undefined;
+    crisis_confidence?: number | undefined;
+    emotions?: string[] | undefined;
+    therapeuticTechnique?: string | undefined;
+    meta?: {
+        rag_confidence?: number | undefined;
+        emotionalTone?: string[] | undefined;
+        therapeuticElements?: string[] | undefined;
+    } | undefined;
+    memory_high_relevance_count?: number | undefined;
+    error_type?: string | undefined;
+}, {
+    threadId?: string | undefined;
+    content?: string | undefined;
+    crisis_level?: string | number | undefined;
+    crisisLevel?: string | number | undefined;
+    resources?: {
+        type: string;
+        title: string;
+        description?: string | undefined;
+        url?: string | undefined;
+        phone?: string | undefined;
+    }[] | undefined;
+    escalationPath?: string | undefined;
+    message?: string | undefined;
+    error?: string | undefined;
+    reply?: string | undefined;
+    response_text?: string | undefined;
+    messageId?: string | undefined;
+    crisisDetected?: boolean | undefined;
+    crisisHandled?: boolean | undefined;
+    crisis_confidence?: number | undefined;
+    emotions?: string[] | undefined;
+    therapeuticTechnique?: string | undefined;
+    meta?: {
+        rag_confidence?: number | undefined;
+        emotionalTone?: string[] | undefined;
+        therapeuticElements?: string[] | undefined;
+    } | undefined;
+    memory_high_relevance_count?: number | undefined;
+    error_type?: string | undefined;
+}>;
+export declare const ErrorResponseSchema: z.ZodObject<{
+    error: z.ZodOptional<z.ZodString>;
+    message: z.ZodOptional<z.ZodString>;
+    error_type: z.ZodOptional<z.ZodString>;
+    code: z.ZodOptional<z.ZodString>;
+    details: z.ZodOptional<z.ZodAny>;
+}, "strip", z.ZodTypeAny, {
+    code?: string | undefined;
+    message?: string | undefined;
+    error?: string | undefined;
+    error_type?: string | undefined;
+    details?: any;
+}, {
+    code?: string | undefined;
+    message?: string | undefined;
+    error?: string | undefined;
+    error_type?: string | undefined;
+    details?: any;
+}>;
+export type ShrinkResponse = z.infer<typeof ShrinkResponseSchema>;
+export type ErrorResponse = z.infer<typeof ErrorResponseSchema>;
+export declare class ShrinkChatClient {
+    private circuitBreaker;
+    private retryStrategy;
+    constructor();
+    /**
+     * Detect if a message contains crisis indicators
+     */
+    private detectCrisisContent;
+    private request;
+    /**
+     * Send a message through the shrink-chat therapeutic stack
+     * Note: Threads are created lazily - no need for separate thread creation
+     */
+    sendMessage(threadId: string, prompt: string, options?: {
+        memoryContext?: string;
+        enhancedContext?: any;
+        history?: Array<{
+            role: string;
+            content: string;
+        }>;
+        systemPrompt?: string;
+        conversationType?: string;
+        idempotencyKey?: string;
+    }): Promise<ShrinkResponse>;
+    /**
+     * Stream a message response (SSE)
+     */
+    streamMessage(prompt: string, threadId: string, options?: {
+        memoryContext?: string;
+        enhancedContext?: any;
+        history?: Array<{
+            role: string;
+            content: string;
+        }>;
+        systemPrompt?: string;
+        conversationType?: string;
+        signal?: AbortSignal;
+    }): AsyncGenerator<any>;
+    /**
+     * Get recent messages for a thread
+     */
+    getRecentMessages(threadId: string, limit?: number): Promise<any>;
+    /**
+     * Log a message (for offline/manual logging)
+     */
+    logMessage(threadId: string, role: 'user' | 'assistant', content: string, idempotencyKey?: string): Promise<any>;
+    /**
+     * Health check for the shrink-chat API
+     */
+    healthCheck(): Promise<boolean>;
+    /**
+     * Generate a new thread ID (client-side)
+     * Threads are created lazily server-side when first message is sent
+     */
+    generateThreadId(): string;
+    /**
+     * Get circuit breaker status
+     */
+    getCircuitBreakerStatus(): import("../utils/circuitBreaker.js").CircuitBreakerStatistics;
+}
+export declare function getShrinkChatClient(): ShrinkChatClient;
+//# sourceMappingURL=shrinkChatClient.d.ts.map

package/dist/clients/shrinkChatClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shrinkChatClient.d.ts","sourceRoot":"","sources":["../../src/clients/shrinkChatClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAqBxB,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+B/B,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;EAM9B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,aAAa,CAAgB;;IAYrC;;OAEG;IACH,OAAO,CAAC,mBAAmB;YAiBb,OAAO;IAwDrB;;;OAGG;IACG,WAAW,CACf,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;QACR,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,eAAe,CAAC,EAAE,GAAG,CAAC;QACtB,OAAO,CAAC,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACnD,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,GACA,OAAO,CAAC,cAAc,CAAC;IAwI1B;;OAEG;IACI,aAAa,CAClB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;QACR,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,eAAe,CAAC,EAAE,GAAG,CAAC;QACtB,OAAO,CAAC,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACnD,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,MAAM,CAAC,EAAE,WAAW,CAAC;KACtB,GACA,cAAc,CAAC,GAAG,CAAC;IAyDtB;;OAEG;IACG,iBAAiB,CACrB,QAAQ,EAAE,MAAM,EAChB,KAAK,GAAE,MAAW,GACjB,OAAO,CAAC,GAAG,CAAC;IAOf;;OAEG;IACG,UAAU,CACd,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GAAG,WAAW,EAC1B,OAAO,EAAE,MAAM,EACf,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,GAAG,CAAC;IAaf;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IASrC;;;OAGG;IACH,gBAAgB,IAAI,MAAM;IAI1B;;OAEG;IACH,uBAAuB;CAGxB;AAKD,wBAAgB,mBAAmB,IAAI,gBAAgB,CAKtD"}