@agentxjs/types 0.0.6 → 0.2.0

package/dist/index-usKuk41S.d.ts

@@ -0,0 +1,299 @@
+import { B as BaseAgentEvent, U as UserMessage, A as AssistantMessage, T as ToolCallMessage, a as ToolResultMessage } from './ToolResultMessage-CDG2L7Zv.js';
+import { E as ErrorMessage } from './ErrorMessage-BoIh3MIO.js';
+
+/**
+ * Agent Stream Events
+ *
+ * Real-time streaming events from LLM.
+ * - source: "agent"
+ * - category: "stream"
+ * - intent: "notification"
+ *
+ * Note: These have same event types as DriveableEvent (environment/stream),
+ * but with full SystemEvent structure (source, category, intent, context).
+ */
+
+/**
+ * Base type for stream events
+ */
+interface AgentStreamEventBase<T extends string, D> extends BaseAgentEvent<T, D, "stream"> {
+}
+/**
+ * Stop reason for message completion
+ */
+type StopReason = "end_turn" | "max_tokens" | "stop_sequence" | "tool_use";
+/**
+ * AgentMessageStartEvent - Streaming message begins
+ */
+interface AgentMessageStartEvent extends AgentStreamEventBase<"message_start", {
+    messageId: string;
+    model: string;
+}> {
+}
+/**
+ * AgentMessageDeltaEvent - Message-level updates (usage info)
+ */
+interface AgentMessageDeltaEvent extends AgentStreamEventBase<"message_delta", {
+    usage?: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+}> {
+}
+/**
+ * AgentMessageStopEvent - Streaming message completes
+ */
+interface AgentMessageStopEvent extends AgentStreamEventBase<"message_stop", {
+    stopReason?: StopReason;
+}> {
+}
+/**
+ * AgentTextDeltaEvent - Incremental text output
+ */
+interface AgentTextDeltaEvent extends AgentStreamEventBase<"text_delta", {
+    text: string;
+}> {
+}
+/**
+ * AgentToolUseStartEvent - Tool use block started
+ */
+interface AgentToolUseStartEvent extends AgentStreamEventBase<"tool_use_start", {
+    toolCallId: string;
+    toolName: string;
+}> {
+}
+/**
+ * AgentInputJsonDeltaEvent - Incremental tool input JSON
+ */
+interface AgentInputJsonDeltaEvent extends AgentStreamEventBase<"input_json_delta", {
+    partialJson: string;
+}> {
+}
+/**
+ * AgentToolUseStopEvent - Tool use block completed
+ */
+interface AgentToolUseStopEvent extends AgentStreamEventBase<"tool_use_stop", {
+    toolCallId: string;
+    toolName: string;
+    input: Record<string, unknown>;
+}> {
+}
+/**
+ * AgentToolResultEvent - Tool execution result
+ */
+interface AgentToolResultEvent extends AgentStreamEventBase<"tool_result", {
+    toolCallId: string;
+    result: unknown;
+    isError?: boolean;
+}> {
+}
+/**
+ * AgentErrorReceivedEvent - Error received from environment
+ *
+ * Processed by MealyMachine to produce:
+ * - error_occurred (StateEvent)
+ * - error_message (MessageEvent)
+ */
+interface AgentErrorReceivedEvent extends AgentStreamEventBase<"error_received", {
+    /** Error message (human-readable) */
+    message: string;
+    /** Error code (e.g., "rate_limit_error", "api_error") */
+    errorCode?: string;
+}> {
+}
+/**
+ * AgentStreamEvent - All stream events
+ */
+type AgentStreamEvent = AgentMessageStartEvent | AgentMessageDeltaEvent | AgentMessageStopEvent | AgentTextDeltaEvent | AgentToolUseStartEvent | AgentInputJsonDeltaEvent | AgentToolUseStopEvent | AgentToolResultEvent | AgentErrorReceivedEvent;
+/**
+ * AgentStreamEventType - String literal union
+ */
+type AgentStreamEventType = AgentStreamEvent["type"];
+/**
+ * Type guard: is this a stream event?
+ */
+declare function isAgentStreamEvent(event: {
+    source?: string;
+    category?: string;
+}): event is AgentStreamEvent;
+
+/**
+ * Agent State Events
+ *
+ * Events that trigger AgentState transitions.
+ * - source: "agent"
+ * - category: "state"
+ * - intent: "notification"
+ *
+ * Note: These are events that AFFECT state, not "state" themselves.
+ */
+
+/**
+ * Base type for state events
+ */
+interface AgentStateEventBase<T extends string, D> extends BaseAgentEvent<T, D, "state"> {
+}
+/**
+ * ConversationQueuedEvent - Message queued for processing
+ */
+interface ConversationQueuedEvent extends AgentStateEventBase<"conversation_queued", {
+    messageId: string;
+}> {
+}
+/**
+ * ConversationStartEvent - Conversation started
+ */
+interface ConversationStartEvent extends AgentStateEventBase<"conversation_start", {
+    messageId: string;
+}> {
+}
+/**
+ * ConversationThinkingEvent - Agent is thinking
+ */
+interface ConversationThinkingEvent extends AgentStateEventBase<"conversation_thinking", Record<string, never>> {
+}
+/**
+ * ConversationRespondingEvent - Agent is responding
+ */
+interface ConversationRespondingEvent extends AgentStateEventBase<"conversation_responding", Record<string, never>> {
+}
+/**
+ * ConversationEndEvent - Conversation ended
+ */
+interface ConversationEndEvent extends AgentStateEventBase<"conversation_end", {
+    reason: "completed" | "interrupted" | "error";
+}> {
+}
+/**
+ * ConversationInterruptedEvent - Conversation interrupted
+ */
+interface ConversationInterruptedEvent extends AgentStateEventBase<"conversation_interrupted", {
+    reason: string;
+}> {
+}
+/**
+ * ToolPlannedEvent - Tool use planned
+ */
+interface ToolPlannedEvent extends AgentStateEventBase<"tool_planned", {
+    toolId: string;
+    toolName: string;
+}> {
+}
+/**
+ * ToolExecutingEvent - Tool is executing
+ */
+interface ToolExecutingEvent extends AgentStateEventBase<"tool_executing", {
+    toolId: string;
+    toolName: string;
+    input: Record<string, unknown>;
+}> {
+}
+/**
+ * ToolCompletedEvent - Tool execution completed
+ */
+interface ToolCompletedEvent extends AgentStateEventBase<"tool_completed", {
+    toolId: string;
+    toolName: string;
+    result: unknown;
+}> {
+}
+/**
+ * ToolFailedEvent - Tool execution failed
+ */
+interface ToolFailedEvent extends AgentStateEventBase<"tool_failed", {
+    toolId: string;
+    toolName: string;
+    error: string;
+}> {
+}
+/**
+ * ErrorOccurredEvent - Error occurred during processing
+ */
+interface ErrorOccurredEvent extends AgentStateEventBase<"error_occurred", {
+    code: string;
+    message: string;
+    recoverable: boolean;
+    category?: string;
+}> {
+}
+/**
+ * AgentStateEvent - All state events
+ */
+type AgentStateEvent = ConversationQueuedEvent | ConversationStartEvent | ConversationThinkingEvent | ConversationRespondingEvent | ConversationEndEvent | ConversationInterruptedEvent | ToolPlannedEvent | ToolExecutingEvent | ToolCompletedEvent | ToolFailedEvent | ErrorOccurredEvent;
+/**
+ * AgentStateEventType - String literal union
+ */
+type AgentStateEventType = AgentStateEvent["type"];
+/**
+ * Type guard: is this a state event?
+ */
+declare function isAgentStateEvent(event: {
+    source?: string;
+    category?: string;
+}): event is AgentStateEvent;
+
+/**
+ * Agent Message Events
+ *
+ * Complete message events assembled from stream events.
+ * Events directly wrap Message objects - no transformation needed.
+ * - source: "agent"
+ * - category: "message"
+ * - intent: "notification"
+ */
+
+/**
+ * Base type for message events
+ */
+interface AgentMessageEventBase<T extends string, D> extends BaseAgentEvent<T, D, "message"> {
+}
+/**
+ * UserMessageEvent - User sent a message
+ * Data: Complete UserMessage object
+ */
+interface UserMessageEvent extends AgentMessageEventBase<"user_message", UserMessage> {
+}
+/**
+ * AssistantMessageEvent - Assistant response message
+ * Data: Complete AssistantMessage object
+ */
+interface AssistantMessageEvent extends AgentMessageEventBase<"assistant_message", AssistantMessage> {
+}
+/**
+ * ToolCallMessageEvent - Tool call message (part of assistant turn)
+ * Data: Complete ToolCallMessage object
+ */
+interface ToolCallMessageEvent extends AgentMessageEventBase<"tool_call_message", ToolCallMessage> {
+}
+/**
+ * ToolResultMessageEvent - Tool result message
+ * Data: Complete ToolResultMessage object
+ */
+interface ToolResultMessageEvent extends AgentMessageEventBase<"tool_result_message", ToolResultMessage> {
+}
+/**
+ * ErrorMessageEvent - Error message displayed in chat
+ * Data: Complete ErrorMessage object
+ *
+ * Generated when error_received StreamEvent is processed by MealyMachine.
+ * Displayed in the chat history so users can see what went wrong.
+ */
+interface ErrorMessageEvent extends AgentMessageEventBase<"error_message", ErrorMessage> {
+}
+/**
+ * AgentMessageEvent - All message events
+ */
+type AgentMessageEvent = UserMessageEvent | AssistantMessageEvent | ToolCallMessageEvent | ToolResultMessageEvent | ErrorMessageEvent;
+/**
+ * AgentMessageEventType - String literal union
+ */
+type AgentMessageEventType = AgentMessageEvent["type"];
+/**
+ * Type guard: is this a message event?
+ */
+declare function isAgentMessageEvent(event: {
+    source?: string;
+    category?: string;
+}): event is AgentMessageEvent;
+
+export { type AgentStreamEvent as A, type AgentStateEventBase as B, type ConversationQueuedEvent as C, type AgentStateEventType as D, type ErrorOccurredEvent as E, isAgentStateEvent as F, type AgentMessageEventBase as G, type AgentMessageEventType as H, isAgentMessageEvent as I, type StopReason as S, type ToolPlannedEvent as T, type UserMessageEvent as U, type AgentMessageStartEvent as a, type AgentMessageDeltaEvent as b, type AgentMessageStopEvent as c, type AgentTextDeltaEvent as d, type AgentToolUseStartEvent as e, type AgentInputJsonDeltaEvent as f, type AgentToolUseStopEvent as g, type AgentToolResultEvent as h, type AgentStateEvent as i, type ConversationStartEvent as j, type ConversationThinkingEvent as k, type ConversationRespondingEvent as l, type ConversationEndEvent as m, type ConversationInterruptedEvent as n, type ToolExecutingEvent as o, type ToolCompletedEvent as p, type ToolFailedEvent as q, type AgentMessageEvent as r, type AssistantMessageEvent as s, type ToolCallMessageEvent as t, type ToolResultMessageEvent as u, type ErrorMessageEvent as v, type AgentStreamEventBase as w, type AgentErrorReceivedEvent as x, type AgentStreamEventType as y, isAgentStreamEvent as z };

package/dist/index.cjs

@@ -3,10 +3,6 @@ var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
 var __copyProps = (to, from, except, desc) => {
   if (from && typeof from === "object" || typeof from === "function") {
     for (let key of __getOwnPropNames(from))
@@ -18,185 +14,6 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
-var index_exports = {};
-__export(index_exports, {
-  ERROR_EVENT_TYPE_NAMES: () => ERROR_EVENT_TYPE_NAMES,
-  LATEST_PROTOCOL_VERSION: () => LATEST_PROTOCOL_VERSION,
-  LogLevel: () => LogLevel,
-  MESSAGE_EVENT_TYPE_NAMES: () => MESSAGE_EVENT_TYPE_NAMES,
-  STATE_EVENT_TYPE_NAMES: () => STATE_EVENT_TYPE_NAMES,
-  STREAM_EVENT_TYPE_NAMES: () => STREAM_EVENT_TYPE_NAMES,
-  SUPPORTED_PROTOCOL_VERSIONS: () => SUPPORTED_PROTOCOL_VERSIONS,
-  TURN_EVENT_TYPE_NAMES: () => TURN_EVENT_TYPE_NAMES,
-  isAssistantMessage: () => isAssistantMessage,
-  isErrorEvent: () => isErrorEvent,
-  isFilePart: () => isFilePart,
-  isImagePart: () => isImagePart,
-  isMessageEvent: () => isMessageEvent,
-  isStateEvent: () => isStateEvent,
-  isStopReason: () => isStopReason,
-  isStreamEvent: () => isStreamEvent,
-  isSystemMessage: () => isSystemMessage,
-  isTextPart: () => isTextPart,
-  isThinkingPart: () => isThinkingPart,
-  isToolCallMessage: () => isToolCallMessage,
-  isToolCallPart: () => isToolCallPart,
-  isToolResultMessage: () => isToolResultMessage,
-  isToolResultPart: () => isToolResultPart,
-  isTurnEvent: () => isTurnEvent,
-  isUserMessage: () => isUserMessage
-});
-module.exports = __toCommonJS(index_exports);
-
-// 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);
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  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
-});
+var src_exports = {};
+module.exports = __toCommonJS(src_exports);
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../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 * AgentX Types - Industry-level type definitions for AI Agent ecosystem\n *\n * 140+ TypeScript files, zero runtime dependencies.\n *\n * ## ADR: Isomorphic Architecture\n *\n * AgentX uses an isomorphic architecture for \"Define Once, Run Anywhere\":\n *\n * ```\n * ┌─────────────────────────────────────────────────────────────┐\n * │                    Application Code                         │\n * │                    (identical)                              │\n * │   const agentx = createAgentX(runtime);                     │\n * │   agentx.definitions.register(MyDef);                       │\n * └────────────────────────┬────────────────────────────────────┘\n *                          │\n *          ┌───────────────┴───────────────┐\n *          │                               │\n *          ▼                               ▼\n * ┌─────────────────────┐       ┌─────────────────────┐\n * │   Server Runtime    │       │   Browser Runtime   │\n * │   SQLiteRepository  │       │   RemoteRepository  │\n * │   (direct DB write) │       │   (HTTP → Server)   │\n * └─────────────────────┘       └─────────────────────┘\n * ```\n *\n * **Key Insight**: Business logic (agentx/) and infrastructure (runtime/) are separated.\n * Through Repository interface, same business code runs on Server or Browser.\n *\n * ## Module Structure\n *\n * | Module      | Purpose                                      | Layer          |\n * |-------------|----------------------------------------------|----------------|\n * | agentx/     | Business API (defineAgent, createAgentX)     | Business Logic |\n * | runtime/    | Infrastructure (Repository, Container)       | Infrastructure |\n * | definition/ | AgentDefinition (like Dockerfile)            | Source Layer   |\n * | image/      | AgentImage = MetaImage | DerivedImage        | Build Artifact |\n * | session/    | Session (user conversation)                  | Runtime        |\n * | agent/      | Agent core contracts                         | Core Layer     |\n * | event/      | 4-layer events (Stream→State→Message→Turn)   | Event Layer    |\n * | message/    | Message formats and content parts            | Message Layer  |\n *\n * ## Key ADR References\n *\n * - `agentx/index.ts` - Business API layer design\n * - `runtime/index.ts` - Infrastructure layer design\n * - `runtime/repository/index.ts` - Repository isomorphic design\n * - `issues/022-runtime-agentx-isomorphic-architecture.md` - Full architecture doc\n *\n * @packageDocumentation\n */\n\n// ============================================================================\n// Docker-style Layered Architecture\n// AgentFile/Code → Definition → MetaImage → Session → Agent\n// ============================================================================\n\n// Agent state\nexport type { AgentState } from \"./agent/AgentState\";\n\n// User types\nexport * from \"./user\";\n\n// Definition types (Docker-style: source template, like Dockerfile)\nexport * from \"./definition\";\n\n// Image types (Docker-style: built artifact, like Docker Image)\nexport * from \"./image\";\n\n// ============================================================================\n// Business Logic Layer (Platform API)\n// Platform-agnostic, isomorphic\n// ============================================================================\n\n// Platform context (AgentX) - includes defineAgent, createAgentX\n// This is the business logic entry point, isomorphic via Runtime\nexport * from \"./agentx\";\n\n// ============================================================================\n// Infrastructure Layer (Runtime)\n// Provides Repository, Container, Sandbox\n// ============================================================================\n\n// Runtime resource types (includes Repository for isomorphic storage)\n// Repository is key to isomorphism: SQLiteRepository vs RemoteRepository\nexport * from \"./runtime\";\n\n// ============================================================================\n// Core Contracts\n// Agent, Driver, Presenter, etc.\n// ============================================================================\n\n// Agent contracts\nexport * from \"./agent\";\n\n// Common internal infrastructure (logger, etc.)\nexport * from \"./common\";\n\n// Error types\nexport * from \"./error\";\n\n// Message types\nexport * from \"./message\";\n\n// Event types (4-layer: Stream → State → Message → Turn)\nexport * from \"./event\";\n\n// LLM types\nexport * from \"./llm\";\n\n// MCP types (Model Context Protocol)\nexport * from \"./mcp\";\n\n// Session types\nexport * from \"./session\";\n\n// Type guards\nexport * from \"./guards\";\n","/**\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":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACMO,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"]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @agentxjs/types - Type definitions for AgentX AI Agent platform\n *\n * ## Package Structure\n *\n * ```\n * @agentxjs/types\n * │\n * ├── /agent          AgentEngine domain (independent, testable)\n * │   ├── AgentEngine, AgentDriver, AgentPresenter\n * │   ├── AgentEvent, StreamEvent, AgentStateEvent, AgentMessageEvent\n * │   └── Message, UserMessage, AssistantMessage, ToolCallMessage\n * │\n * ├── /runtime        Runtime domain (Container, Session, Sandbox)\n * │   ├── Runtime, Agent, Container, AgentImage\n * │   └── /internal   LLM, Sandbox, MCP, Environment\n * │\n * ├── /event          SystemEvent and all runtime events\n * │   ├── SystemEvent (source, category, intent, context)\n * │   └── DriveableEvent, ConnectionEvent, CommandEvent\n * │\n * ├── /agentx         AgentX high-level API types\n * │   └── AgentX, DefinitionAPI, ImageAPI, RuntimeAPI\n * │\n * └── /common         Shared infrastructure (Logger)\n * ```\n *\n * ## Submodule Imports (Recommended)\n *\n * ```typescript\n * // AgentEngine domain\n * import type { AgentEngine, AgentDriver } from \"@agentxjs/types/agent\";\n *\n * // Runtime domain\n * import type { Runtime, Agent, Container } from \"@agentxjs/types/runtime\";\n *\n * // Event system\n * import type { SystemEvent, DriveableEvent } from \"@agentxjs/types/event\";\n *\n * // High-level API\n * import type { AgentX } from \"@agentxjs/types/agentx\";\n * ```\n *\n * ## Two-Domain Architecture\n *\n * AgentEngine domain is independent and can be tested without Runtime:\n * - AgentEvent: lightweight (type, timestamp, data)\n * - StreamEvent → MealyMachine → AgentOutput\n *\n * Runtime domain manages the complete system:\n * - SystemEvent: full context (source, category, intent, context)\n * - Container lifecycle, Session persistence, Sandbox isolation\n *\n * Driver/Presenter bridge the two domains.\n *\n * @packageDocumentation\n */\n\n// ============================================================================\n// Common (shared infrastructure)\n// ============================================================================\n\nexport * from \"./common\";\n\n// ============================================================================\n// Backwards Compatibility Re-exports\n// ============================================================================\n\n// Persistence types moved to runtime/internal, re-export for compatibility\nexport type {\n  Persistence,\n  ImageRepository,\n  ContainerRepository,\n  SessionRepository,\n  ImageRecord,\n  ContainerRecord,\n  SessionRecord,\n} from \"./runtime/internal/persistence\";\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}