@agentxjs/types 0.0.1

package/dist/index.js

@@ -0,0 +1,151 @@
+// src/common/logger/LogLevel.ts
+var LogLevel = /* @__PURE__ */ ((LogLevel2) => {
+  LogLevel2[LogLevel2["DEBUG"] = 0] = "DEBUG";
+  LogLevel2[LogLevel2["INFO"] = 1] = "INFO";
+  LogLevel2[LogLevel2["WARN"] = 2] = "WARN";
+  LogLevel2[LogLevel2["ERROR"] = 3] = "ERROR";
+  LogLevel2[LogLevel2["SILENT"] = 4] = "SILENT";
+  return LogLevel2;
+})(LogLevel || {});
+
+// src/llm/StopReason.ts
+function isStopReason(value) {
+  return [
+    "end_turn",
+    "max_tokens",
+    "tool_use",
+    "stop_sequence",
+    "content_filter",
+    "error",
+    "other"
+  ].includes(value);
+}
+
+// src/mcp/McpProtocol.ts
+var LATEST_PROTOCOL_VERSION = "2025-06-18";
+var SUPPORTED_PROTOCOL_VERSIONS = ["2025-06-18", "2025-03-26", "2024-11-05"];
+
+// src/guards/MessageGuards.ts
+function isUserMessage(message) {
+  return message.subtype === "user";
+}
+function isAssistantMessage(message) {
+  return message.subtype === "assistant";
+}
+function isSystemMessage(message) {
+  return message.subtype === "system";
+}
+function isToolCallMessage(message) {
+  return message.subtype === "tool-call";
+}
+function isToolResultMessage(message) {
+  return message.subtype === "tool-result";
+}
+
+// src/guards/ContentPartGuards.ts
+function isTextPart(part) {
+  return part.type === "text";
+}
+function isThinkingPart(part) {
+  return part.type === "thinking";
+}
+function isImagePart(part) {
+  return part.type === "image";
+}
+function isFilePart(part) {
+  return part.type === "file";
+}
+function isToolCallPart(part) {
+  return part.type === "tool-call";
+}
+function isToolResultPart(part) {
+  return part.type === "tool-result";
+}
+
+// src/guards/EventGuards.ts
+var STATE_EVENT_TYPE_NAMES = [
+  "agent_initializing",
+  "agent_ready",
+  "agent_destroyed",
+  "conversation_queued",
+  "conversation_start",
+  "conversation_thinking",
+  "conversation_responding",
+  "conversation_end",
+  "conversation_interrupted",
+  "tool_planned",
+  "tool_executing",
+  "tool_completed",
+  "tool_failed",
+  "error_occurred"
+];
+var STATE_EVENT_TYPES = new Set(STATE_EVENT_TYPE_NAMES);
+var MESSAGE_EVENT_TYPE_NAMES = [
+  "user_message",
+  "assistant_message",
+  "tool_call_message",
+  "tool_result_message"
+];
+var MESSAGE_EVENT_TYPES = new Set(MESSAGE_EVENT_TYPE_NAMES);
+var ERROR_EVENT_TYPE_NAMES = ["error"];
+var ERROR_EVENT_TYPES = new Set(ERROR_EVENT_TYPE_NAMES);
+var TURN_EVENT_TYPE_NAMES = ["turn_request", "turn_response"];
+var TURN_EVENT_TYPES = new Set(TURN_EVENT_TYPE_NAMES);
+var STREAM_EVENT_TYPE_NAMES = [
+  "message_start",
+  "message_delta",
+  "message_stop",
+  "text_content_block_start",
+  "text_delta",
+  "text_content_block_stop",
+  "tool_use_content_block_start",
+  "input_json_delta",
+  "tool_use_content_block_stop",
+  "tool_call",
+  "tool_result",
+  "interrupted"
+];
+var STREAM_EVENT_TYPES = new Set(STREAM_EVENT_TYPE_NAMES);
+function isStateEvent(event) {
+  return "type" in event && STATE_EVENT_TYPES.has(event.type);
+}
+function isMessageEvent(event) {
+  return "type" in event && MESSAGE_EVENT_TYPES.has(event.type);
+}
+function isTurnEvent(event) {
+  return "type" in event && TURN_EVENT_TYPES.has(event.type);
+}
+function isStreamEvent(event) {
+  return "type" in event && STREAM_EVENT_TYPES.has(event.type);
+}
+function isErrorEvent(event) {
+  return "type" in event && ERROR_EVENT_TYPES.has(event.type);
+}
+export {
+  ERROR_EVENT_TYPE_NAMES,
+  LATEST_PROTOCOL_VERSION,
+  LogLevel,
+  MESSAGE_EVENT_TYPE_NAMES,
+  STATE_EVENT_TYPE_NAMES,
+  STREAM_EVENT_TYPE_NAMES,
+  SUPPORTED_PROTOCOL_VERSIONS,
+  TURN_EVENT_TYPE_NAMES,
+  isAssistantMessage,
+  isErrorEvent,
+  isFilePart,
+  isImagePart,
+  isMessageEvent,
+  isStateEvent,
+  isStopReason,
+  isStreamEvent,
+  isSystemMessage,
+  isTextPart,
+  isThinkingPart,
+  isToolCallMessage,
+  isToolCallPart,
+  isToolResultMessage,
+  isToolResultPart,
+  isTurnEvent,
+  isUserMessage
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/common/logger/LogLevel.ts","../src/llm/StopReason.ts","../src/mcp/McpProtocol.ts","../src/guards/MessageGuards.ts","../src/guards/ContentPartGuards.ts","../src/guards/EventGuards.ts"],"sourcesContent":["/**\n * LogLevel - Standard log level enumeration\n *\n * Defines the severity levels for logging.\n */\n\nexport enum LogLevel {\n  DEBUG = 0,\n  INFO = 1,\n  WARN = 2,\n  ERROR = 3,\n  SILENT = 4,\n}\n","/**\n * Reason why the LLM stopped generating\n *\n * Based on common stop reasons across multiple LLM providers:\n * - Anthropic Claude: end_turn, max_tokens, tool_use, stop_sequence\n * - OpenAI: stop, length, tool_calls, content_filter\n * - Vercel AI SDK: stop, length, tool-calls, content-filter, error, other\n */\nexport type StopReason =\n  /**\n   * Natural completion - model decided to stop\n   */\n  | \"end_turn\"\n\n  /**\n   * Reached maximum token limit\n   */\n  | \"max_tokens\"\n\n  /**\n   * Model requested tool usage\n   */\n  | \"tool_use\"\n\n  /**\n   * Encountered a custom stop sequence\n   */\n  | \"stop_sequence\"\n\n  /**\n   * Content filter triggered\n   */\n  | \"content_filter\"\n\n  /**\n   * Error occurred during generation\n   */\n  | \"error\"\n\n  /**\n   * Other/unknown reason\n   */\n  | \"other\";\n\n/**\n * Type guard to check if a string is a valid StopReason\n */\nexport function isStopReason(value: string): value is StopReason {\n  return [\n    \"end_turn\",\n    \"max_tokens\",\n    \"tool_use\",\n    \"stop_sequence\",\n    \"content_filter\",\n    \"error\",\n    \"other\",\n  ].includes(value);\n}\n","/**\n * MCP Protocol Version\n *\n * Model Context Protocol version constants.\n * Based on the official MCP specification.\n */\nexport const LATEST_PROTOCOL_VERSION = \"2025-06-18\" as const;\n\nexport const SUPPORTED_PROTOCOL_VERSIONS = [\"2025-06-18\", \"2025-03-26\", \"2024-11-05\"] as const;\n\nexport type McpProtocolVersion = (typeof SUPPORTED_PROTOCOL_VERSIONS)[number];\n","import type { Message } from \"~/message/Message\";\nimport type { UserMessage } from \"~/message/UserMessage\";\nimport type { AssistantMessage } from \"~/message/AssistantMessage\";\nimport type { SystemMessage } from \"~/message/SystemMessage\";\nimport type { ToolCallMessage } from \"~/message/ToolCallMessage\";\nimport type { ToolResultMessage } from \"~/message/ToolResultMessage\";\n\n/**\n * Type guard for UserMessage\n */\nexport function isUserMessage(message: Message): message is UserMessage {\n  return message.subtype === \"user\";\n}\n\n/**\n * Type guard for AssistantMessage (text response, not tool call)\n */\nexport function isAssistantMessage(message: Message): message is AssistantMessage {\n  return message.subtype === \"assistant\";\n}\n\n/**\n * Type guard for SystemMessage\n */\nexport function isSystemMessage(message: Message): message is SystemMessage {\n  return message.subtype === \"system\";\n}\n\n/**\n * Type guard for ToolCallMessage\n */\nexport function isToolCallMessage(message: Message): message is ToolCallMessage {\n  return message.subtype === \"tool-call\";\n}\n\n/**\n * Type guard for ToolResultMessage\n */\nexport function isToolResultMessage(message: Message): message is ToolResultMessage {\n  return message.subtype === \"tool-result\";\n}\n","import type { ContentPart } from \"~/message/parts/ContentPart\";\nimport type { TextPart } from \"~/message/parts/TextPart\";\nimport type { ThinkingPart } from \"~/message/parts/ThinkingPart\";\nimport type { ImagePart } from \"~/message/parts/ImagePart\";\nimport type { FilePart } from \"~/message/parts/FilePart\";\nimport type { ToolCallPart } from \"~/message/parts/ToolCallPart\";\nimport type { ToolResultPart } from \"~/message/parts/ToolResultPart\";\n\n/**\n * Type guard for TextPart\n */\nexport function isTextPart(part: ContentPart): part is TextPart {\n  return part.type === \"text\";\n}\n\n/**\n * Type guard for ThinkingPart\n */\nexport function isThinkingPart(part: ContentPart): part is ThinkingPart {\n  return part.type === \"thinking\";\n}\n\n/**\n * Type guard for ImagePart\n */\nexport function isImagePart(part: ContentPart): part is ImagePart {\n  return part.type === \"image\";\n}\n\n/**\n * Type guard for FilePart\n */\nexport function isFilePart(part: ContentPart): part is FilePart {\n  return part.type === \"file\";\n}\n\n/**\n * Type guard for ToolCallPart\n */\nexport function isToolCallPart(part: ContentPart): part is ToolCallPart {\n  return part.type === \"tool-call\";\n}\n\n/**\n * Type guard for ToolResultPart\n */\nexport function isToolResultPart(part: ContentPart): part is ToolResultPart {\n  return part.type === \"tool-result\";\n}\n","/**\n * Event Type Guards\n *\n * Runtime type guards for event classification.\n */\n\nimport type { AgentOutput } from \"~/agent/AgentOutput\";\nimport type { StateEventType } from \"~/event/state\";\nimport type { StreamEventType } from \"~/event/stream\";\nimport type { MessageEventType } from \"~/event/message\";\nimport type { TurnEventType } from \"~/event/turn\";\nimport type { ErrorEvent } from \"~/event/error\";\n\n/**\n * State event type names (single source of truth)\n */\nexport const STATE_EVENT_TYPE_NAMES = [\n  \"agent_initializing\",\n  \"agent_ready\",\n  \"agent_destroyed\",\n  \"conversation_queued\",\n  \"conversation_start\",\n  \"conversation_thinking\",\n  \"conversation_responding\",\n  \"conversation_end\",\n  \"conversation_interrupted\",\n  \"tool_planned\",\n  \"tool_executing\",\n  \"tool_completed\",\n  \"tool_failed\",\n  \"error_occurred\",\n] as const;\n\nconst STATE_EVENT_TYPES = new Set<string>(STATE_EVENT_TYPE_NAMES);\n\n/**\n * Message event type names (single source of truth)\n */\nexport const MESSAGE_EVENT_TYPE_NAMES = [\n  \"user_message\",\n  \"assistant_message\",\n  \"tool_call_message\",\n  \"tool_result_message\",\n] as const;\n\nconst MESSAGE_EVENT_TYPES = new Set<string>(MESSAGE_EVENT_TYPE_NAMES);\n\n/**\n * Error event type names (single source of truth)\n * Error is independent from 4-layer hierarchy, transportable via SSE\n */\nexport const ERROR_EVENT_TYPE_NAMES = [\"error\"] as const;\n\nconst ERROR_EVENT_TYPES = new Set<string>(ERROR_EVENT_TYPE_NAMES);\n\n/**\n * Turn event type names (single source of truth)\n */\nexport const TURN_EVENT_TYPE_NAMES = [\"turn_request\", \"turn_response\"] as const;\n\nconst TURN_EVENT_TYPES = new Set<string>(TURN_EVENT_TYPE_NAMES);\n\n/**\n * Stream event type names (single source of truth)\n */\nexport const STREAM_EVENT_TYPE_NAMES = [\n  \"message_start\",\n  \"message_delta\",\n  \"message_stop\",\n  \"text_content_block_start\",\n  \"text_delta\",\n  \"text_content_block_stop\",\n  \"tool_use_content_block_start\",\n  \"input_json_delta\",\n  \"tool_use_content_block_stop\",\n  \"tool_call\",\n  \"tool_result\",\n  \"interrupted\",\n] as const;\n\nconst STREAM_EVENT_TYPES = new Set<string>(STREAM_EVENT_TYPE_NAMES);\n\n/**\n * Check if event is a StateEvent\n */\nexport function isStateEvent(event: AgentOutput): event is StateEventType {\n  return \"type\" in event && STATE_EVENT_TYPES.has(event.type);\n}\n\n/**\n * Check if event is a MessageEvent\n */\nexport function isMessageEvent(event: AgentOutput): event is MessageEventType {\n  return \"type\" in event && MESSAGE_EVENT_TYPES.has(event.type);\n}\n\n/**\n * Check if event is a TurnEvent\n */\nexport function isTurnEvent(event: AgentOutput): event is TurnEventType {\n  return \"type\" in event && TURN_EVENT_TYPES.has(event.type);\n}\n\n/**\n * Check if event is a StreamEvent\n */\nexport function isStreamEvent(event: AgentOutput): event is StreamEventType {\n  return \"type\" in event && STREAM_EVENT_TYPES.has(event.type);\n}\n\n/**\n * Check if event is an ErrorEvent\n */\nexport function isErrorEvent(event: AgentOutput): event is ErrorEvent {\n  return \"type\" in event && ERROR_EVENT_TYPES.has(event.type);\n}\n"],"mappings":";AAMO,IAAK,WAAL,kBAAKA,cAAL;AACL,EAAAA,oBAAA,WAAQ,KAAR;AACA,EAAAA,oBAAA,UAAO,KAAP;AACA,EAAAA,oBAAA,UAAO,KAAP;AACA,EAAAA,oBAAA,WAAQ,KAAR;AACA,EAAAA,oBAAA,YAAS,KAAT;AALU,SAAAA;AAAA,GAAA;;;ACyCL,SAAS,aAAa,OAAoC;AAC/D,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,EAAE,SAAS,KAAK;AAClB;;;ACnDO,IAAM,0BAA0B;AAEhC,IAAM,8BAA8B,CAAC,cAAc,cAAc,YAAY;;;ACE7E,SAAS,cAAc,SAA0C;AACtE,SAAO,QAAQ,YAAY;AAC7B;AAKO,SAAS,mBAAmB,SAA+C;AAChF,SAAO,QAAQ,YAAY;AAC7B;AAKO,SAAS,gBAAgB,SAA4C;AAC1E,SAAO,QAAQ,YAAY;AAC7B;AAKO,SAAS,kBAAkB,SAA8C;AAC9E,SAAO,QAAQ,YAAY;AAC7B;AAKO,SAAS,oBAAoB,SAAgD;AAClF,SAAO,QAAQ,YAAY;AAC7B;;;AC7BO,SAAS,WAAW,MAAqC;AAC9D,SAAO,KAAK,SAAS;AACvB;AAKO,SAAS,eAAe,MAAyC;AACtE,SAAO,KAAK,SAAS;AACvB;AAKO,SAAS,YAAY,MAAsC;AAChE,SAAO,KAAK,SAAS;AACvB;AAKO,SAAS,WAAW,MAAqC;AAC9D,SAAO,KAAK,SAAS;AACvB;AAKO,SAAS,eAAe,MAAyC;AACtE,SAAO,KAAK,SAAS;AACvB;AAKO,SAAS,iBAAiB,MAA2C;AAC1E,SAAO,KAAK,SAAS;AACvB;;;AChCO,IAAM,yBAAyB;AAAA,EACpC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEA,IAAM,oBAAoB,IAAI,IAAY,sBAAsB;AAKzD,IAAM,2BAA2B;AAAA,EACtC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEA,IAAM,sBAAsB,IAAI,IAAY,wBAAwB;AAM7D,IAAM,yBAAyB,CAAC,OAAO;AAE9C,IAAM,oBAAoB,IAAI,IAAY,sBAAsB;AAKzD,IAAM,wBAAwB,CAAC,gBAAgB,eAAe;AAErE,IAAM,mBAAmB,IAAI,IAAY,qBAAqB;AAKvD,IAAM,0BAA0B;AAAA,EACrC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEA,IAAM,qBAAqB,IAAI,IAAY,uBAAuB;AAK3D,SAAS,aAAa,OAA6C;AACxE,SAAO,UAAU,SAAS,kBAAkB,IAAI,MAAM,IAAI;AAC5D;AAKO,SAAS,eAAe,OAA+C;AAC5E,SAAO,UAAU,SAAS,oBAAoB,IAAI,MAAM,IAAI;AAC9D;AAKO,SAAS,YAAY,OAA4C;AACtE,SAAO,UAAU,SAAS,iBAAiB,IAAI,MAAM,IAAI;AAC3D;AAKO,SAAS,cAAc,OAA8C;AAC1E,SAAO,UAAU,SAAS,mBAAmB,IAAI,MAAM,IAAI;AAC7D;AAKO,SAAS,aAAa,OAAyC;AACpE,SAAO,UAAU,SAAS,kBAAkB,IAAI,MAAM,IAAI;AAC5D;","names":["LogLevel"]}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@agentxjs/types",
+  "version": "0.0.1",
+  "description": "Type definitions for Deepractice AgentX ecosystem",
+  "type": "module",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "agentx",
+    "agent",
+    "types",
+    "typescript",
+    "deepractice"
+  ],
+  "author": "Deepractice AI",
+  "license": "MIT",
+  "devDependencies": {
+    "tsup": "^8.0.1",
+    "typescript": "^5.3.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "clean": "rm -rf dist",
+    "lint": "eslint .",
+    "typecheck": "tsc --noEmit",
+    "dev": "tsup --watch"
+  }
+}