@guinetik/primitives-ts 0.2.9 → 0.4.0

package/dist/agent.types.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Autonomous Agent Monitoring Types
+ * Shared between API and Admin for agent monitoring features
+ */
+/**
+ * Agent status enum
+ */
+export declare enum AgentStatus {
+    /** Agent is online and idle */
+    ONLINE = "ONLINE",
+    /** Agent is offline or stopped */
+    OFFLINE = "OFFLINE",
+    /** Agent is actively working on a task */
+    WORKING = "WORKING",
+    /** Agent encountered an error */
+    ERROR = "ERROR"
+}
+/**
+ * Individual agent information
+ */
+export interface AgentInfo {
+    /** Unique identifier for the agent */
+    id: string;
+    /** Agent name (e.g., 'dev-agent', 'designer-agent') */
+    name: string;
+    /** Current status of the agent */
+    status: AgentStatus;
+    /** Last time the agent status was updated */
+    updatedAt: Date;
+    /** Optional error message if agent is in ERROR state */
+    errorMessage?: string;
+}
+/**
+ * Summary statistics for all agents
+ */
+export interface AgentSummary {
+    /** Total number of agents */
+    total: number;
+    /** Number of agents currently running */
+    running: number;
+    /** Number of idle agents */
+    idle: number;
+    /** Number of failed/error agents */
+    failed: number;
+}
+/**
+ * Response from agent status endpoint
+ */
+export interface AgentStatusResponse {
+    /** ISO timestamp when status was retrieved */
+    timestamp: string;
+    /** List of all agents and their statuses */
+    agents: AgentInfo[];
+    /** Optional summary statistics */
+    summary?: AgentSummary;
+}
+/**
+ * Response from agent logs endpoint
+ */
+export interface AgentLogsResponse {
+    /** Array of log lines */
+    logs: string[];
+    /** Total number of log lines returned */
+    total: number;
+}
+/**
+ * Query parameters for fetching agent logs
+ */
+export interface AgentLogsQuery {
+    /** Number of log lines to retrieve (default: 50, min: 10, max: 1000) */
+    lines?: number;
+    /** Offset for pagination (default: 0) */
+    offset?: number;
+}
+//# sourceMappingURL=agent.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent.types.d.ts","sourceRoot":"","sources":["../src/agent.types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,oBAAY,WAAW;IACrB,+BAA+B;IAC/B,MAAM,WAAW;IAEjB,kCAAkC;IAClC,OAAO,YAAY;IAEnB,0CAA0C;IAC1C,OAAO,YAAY;IAEnB,iCAAiC;IACjC,KAAK,UAAU;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,sCAAsC;IACtC,EAAE,EAAE,MAAM,CAAC;IAEX,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IAEb,kCAAkC;IAClC,MAAM,EAAE,WAAW,CAAC;IAEpB,6CAA6C;IAC7C,SAAS,EAAE,IAAI,CAAC;IAEhB,wDAAwD;IACxD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IAEd,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAEhB,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IAEb,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAElB,4CAA4C;IAC5C,MAAM,EAAE,SAAS,EAAE,CAAC;IAEpB,kCAAkC;IAClC,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,yBAAyB;IACzB,IAAI,EAAE,MAAM,EAAE,CAAC;IAEf,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/agent.types.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * Autonomous Agent Monitoring Types
+ * Shared between API and Admin for agent monitoring features
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentStatus = void 0;
+/**
+ * Agent status enum
+ */
+var AgentStatus;
+(function (AgentStatus) {
+    /** Agent is online and idle */
+    AgentStatus["ONLINE"] = "ONLINE";
+    /** Agent is offline or stopped */
+    AgentStatus["OFFLINE"] = "OFFLINE";
+    /** Agent is actively working on a task */
+    AgentStatus["WORKING"] = "WORKING";
+    /** Agent encountered an error */
+    AgentStatus["ERROR"] = "ERROR";
+})(AgentStatus || (exports.AgentStatus = AgentStatus = {}));

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.d.ts

@@ -16,6 +16,7 @@ export * from './totp.types';
 export * from './deployment-history.types';
 export * from './github.types';
 export * from './chat.types';
+export * from './agent.types';
 export type { Security, SecurityChallengeOptions, SecurityChallengeResult } from './security.interface';
 export { SecurityLevel } from './security.interface';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,cAAc,cAAc,CAAC;AAG7B,cAAc,gBAAgB,CAAC;AAG/B,cAAc,iBAAiB,CAAC;AAGhC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,2BAA2B,CAAC;AAG1C,cAAc,cAAc,CAAC;AAG7B,cAAc,4BAA4B,CAAC;AAG3C,cAAc,gBAAgB,CAAC;AAG/B,cAAc,cAAc,CAAC;AAG7B,YAAY,EAAE,QAAQ,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACxG,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,cAAc,cAAc,CAAC;AAG7B,cAAc,gBAAgB,CAAC;AAG/B,cAAc,iBAAiB,CAAC;AAGhC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,2BAA2B,CAAC;AAG1C,cAAc,cAAc,CAAC;AAG7B,cAAc,4BAA4B,CAAC;AAG3C,cAAc,gBAAgB,CAAC;AAG/B,cAAc,cAAc,CAAC;AAG7B,cAAc,eAAe,CAAC;AAG9B,YAAY,EAAE,QAAQ,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACxG,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -40,7 +40,9 @@ __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);
+// Agent monitoring types
+__exportStar(require("./agent.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.4.0",
   "description": "Shared TypeScript primitives for Guinetik projects",
   "author": "Guinetik",
   "license": "MIT",