@guinetik/primitives-ts 0.2.9 → 0.3.0

package/dist/chat.types.d.ts

@@ -1,99 +1,134 @@
 /**
- * Chat types for Claude AI integration in Guinetik Admin Panel
- * Based on feature spec from TL agent grooming
+ * Chat Types
+ * Shared between API and Admin for Claude AI chat functionality
  */
 /**
- * Available Claude models for chat
+ * Available Claude models
  */
 export declare enum ClaudeModel {
+    /** Claude Haiku 3.5 - Fastest, most cost-effective */
     HAIKU_3_5 = "claude-3-5-haiku-20241022",
+    /** Claude Sonnet 3.7 - Extended thinking capability */
     SONNET_3_7 = "claude-3-7-sonnet-20250219",
+    /** Claude Sonnet 4 - Best model for complex reasoning */
     SONNET_4 = "claude-sonnet-4-20250514",
+    /** Claude Opus 4 - Exceptional for specialized complex tasks */
     OPUS_4 = "claude-opus-4-20250514"
 }
 /**
- * Chat session document stored in Firestore
+ * Model metadata for display in UI
+ */
+export interface ClaudeModelInfo {
+    /** Model ID */
+    id: ClaudeModel;
+    /** Display name */
+    name: string;
+    /** Model description */
+    description: string;
+    /** Model tier (for cost indication) */
+    tier: 'fast' | 'balanced' | 'powerful' | 'expert';
+}
+/**
+ * Chat message role
+ */
+export type ChatRole = 'user' | 'assistant';
+/**
+ * Chat session document (Firestore)
  */
 export interface ChatSession {
+    /** Session ID (Firestore document ID) */
     id: string;
+    /** User ID who created the session */
     userId: string;
+    /** Current model for the session */
+    model: ClaudeModel;
+    /** Session creation timestamp */
     createdAt: Date;
+    /** Last update timestamp */
     updatedAt: Date;
+    /** Optional session title (first message summary or user-defined) */
     title?: string;
-    model: string;
 }
 /**
- * Chat message document stored in Firestore
+ * Chat message document (Firestore)
  */
 export interface ChatMessage {
+    /** Message ID (Firestore document ID) */
     id: string;
+    /** Parent session ID */
     sessionId: string;
-    role: 'user' | 'assistant';
+    /** Message role */
+    role: ChatRole;
+    /** Message content */
     content: string;
+    /** Message timestamp */
     timestamp: Date;
-    model: string;
+    /** Model used for this specific message (for assistant messages) */
+    model?: ClaudeModel;
 }
 /**
- * Request payload for sending a chat message
+ * Send message request body
  */
-export interface SendChatMessageRequest {
+export interface SendMessageRequest {
+    /** Optional session ID (creates new session if not provided) */
     sessionId?: string;
+    /** User message content */
     message: string;
-    model: string;
+    /** Model to use for response */
+    model: ClaudeModel;
 }
 /**
- * Response from sending a chat message
+ * Send message response
  */
-export interface SendChatMessageResponse {
+export interface SendMessageResponse {
+    /** Session ID (existing or newly created) */
     sessionId: string;
+    /** Assistant's response content */
     response: string;
-    messageId: string;
-}
-/**
- * Request payload for creating a new chat session
- */
-export interface CreateChatSessionRequest {
-    model: string;
-}
-/**
- * Response from creating a new chat session
- */
-export interface CreateChatSessionResponse {
-    sessionId: string;
+    /** User message ID */
+    userMessageId: string;
+    /** Assistant message ID */
+    assistantMessageId: string;
 }
 /**
- * Response for listing chat sessions
+ * Get chat sessions response
  */
-export interface ListChatSessionsResponse {
+export interface GetChatSessionsResponse {
+    /** List of chat sessions */
     sessions: ChatSession[];
+    /** Total number of sessions */
+    total: number;
 }
 /**
- * Response for listing messages in a session
+ * Get session messages response
  */
-export interface ListChatMessagesResponse {
+export interface GetSessionMessagesResponse {
+    /** List of messages in the session */
     messages: ChatMessage[];
+    /** Total number of messages */
+    total: number;
 }
 /**
- * Model information for the models endpoint
+ * Create new session request
  */
-export interface ChatModel {
-    id: string;
-    name: string;
-    description: string;
+export interface CreateSessionRequest {
+    /** Initial model for the session */
+    model: ClaudeModel;
+    /** Optional session title */
+    title?: string;
 }
 /**
- * Response for listing available models
+ * Create new session response
  */
-export interface ListChatModelsResponse {
-    models: ChatModel[];
+export interface CreateSessionResponse {
+    /** Newly created session */
+    session: ChatSession;
 }
 /**
- * Chat service configuration
+ * Get available models response
  */
-export interface ChatConfig {
-    maxTokens: number;
-    systemPrompt: string;
-    rateLimitRpm: number;
-    maxMessageLength: number;
+export interface GetModelsResponse {
+    /** List of available models */
+    models: ClaudeModelInfo[];
 }
 //# sourceMappingURL=chat.types.d.ts.map

package/dist/chat.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat.types.d.ts","sourceRoot":"","sources":["../src/chat.types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,oBAAY,WAAW;IACrB,SAAS,8BAA8B;IACvC,UAAU,+BAA+B;IACzC,QAAQ,6BAA6B;IACrC,MAAM,2BAA2B;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;CAC1B"}
+{"version":3,"file":"chat.types.d.ts","sourceRoot":"","sources":["../src/chat.types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,oBAAY,WAAW;IACrB,sDAAsD;IACtD,SAAS,8BAA8B;IAEvC,uDAAuD;IACvD,UAAU,+BAA+B;IAEzC,yDAAyD;IACzD,QAAQ,6BAA6B;IAErC,gEAAgE;IAChE,MAAM,2BAA2B;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,eAAe;IACf,EAAE,EAAE,WAAW,CAAC;IAEhB,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IAEb,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC;IAEpB,uCAAuC;IACvC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,CAAC;CACnD;AAED;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,yCAAyC;IACzC,EAAE,EAAE,MAAM,CAAC;IAEX,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IAEf,oCAAoC;IACpC,KAAK,EAAE,WAAW,CAAC;IAEnB,iCAAiC;IACjC,SAAS,EAAE,IAAI,CAAC;IAEhB,4BAA4B;IAC5B,SAAS,EAAE,IAAI,CAAC;IAEhB,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,yCAAyC;IACzC,EAAE,EAAE,MAAM,CAAC;IAEX,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAC;IAElB,mBAAmB;IACnB,IAAI,EAAE,QAAQ,CAAC;IAEf,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAEhB,wBAAwB;IACxB,SAAS,EAAE,IAAI,CAAC;IAEhB,oEAAoE;IACpE,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;IAEhB,gCAAgC;IAChC,KAAK,EAAE,WAAW,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAElB,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IAEjB,sBAAsB;IACtB,aAAa,EAAE,MAAM,CAAC;IAEtB,2BAA2B;IAC3B,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,4BAA4B;IAC5B,QAAQ,EAAE,WAAW,EAAE,CAAC;IAExB,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,sCAAsC;IACtC,QAAQ,EAAE,WAAW,EAAE,CAAC;IAExB,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,oCAAoC;IACpC,KAAK,EAAE,WAAW,CAAC;IAEnB,6BAA6B;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,4BAA4B;IAC5B,OAAO,EAAE,WAAW,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,+BAA+B;IAC/B,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B"}

package/dist/chat.types.js

@@ -1,17 +1,21 @@
 "use strict";
 /**
- * Chat types for Claude AI integration in Guinetik Admin Panel
- * Based on feature spec from TL agent grooming
+ * Chat Types
+ * Shared between API and Admin for Claude AI chat functionality
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ClaudeModel = void 0;
 /**
- * Available Claude models for chat
+ * Available Claude models
  */
 var ClaudeModel;
 (function (ClaudeModel) {
+    /** Claude Haiku 3.5 - Fastest, most cost-effective */
     ClaudeModel["HAIKU_3_5"] = "claude-3-5-haiku-20241022";
+    /** Claude Sonnet 3.7 - Extended thinking capability */
     ClaudeModel["SONNET_3_7"] = "claude-3-7-sonnet-20250219";
+    /** Claude Sonnet 4 - Best model for complex reasoning */
     ClaudeModel["SONNET_4"] = "claude-sonnet-4-20250514";
+    /** Claude Opus 4 - Exceptional for specialized complex tasks */
     ClaudeModel["OPUS_4"] = "claude-opus-4-20250514";
 })(ClaudeModel || (exports.ClaudeModel = ClaudeModel = {}));

package/dist/index.js

@@ -40,7 +40,7 @@ __exportStar(require("./totp.types"), exports);
 __exportStar(require("./deployment-history.types"), exports);
 // GitHub API types
 __exportStar(require("./github.types"), exports);
-// Chat types for Claude AI integration
+// Chat system types
 __exportStar(require("./chat.types"), exports);
 var security_interface_1 = require("./security.interface");
 Object.defineProperty(exports, "SecurityLevel", { enumerable: true, get: function () { return security_interface_1.SecurityLevel; } });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guinetik/primitives-ts",
-  "version": "0.2.9",
+  "version": "0.3.0",
   "description": "Shared TypeScript primitives for Guinetik projects",
   "author": "Guinetik",
   "license": "MIT",