@agentmeshhq/agent 0.4.18 → 0.4.20

package/dist/runtime/types.d.ts

@@ -0,0 +1,158 @@
+/**
+ * Runtime Adapter Types
+ *
+ * Cross-runner runtime I/O contract for AgentMesh chat/control.
+ * Provides normalized event-based output instead of tmux pane scraping.
+ */
+/**
+ * Output modes for runtime chat responses
+ */
+export type OutputMode = "clean" | "raw" | "structured";
+/**
+ * Structured output metadata
+ */
+export interface StructuredOutput {
+    /** The cleaned LLM reply text */
+    content: string;
+    /** Raw captured output (for debugging) */
+    rawOutput: string;
+    /** Capture metadata */
+    metadata: {
+        /** ISO timestamp when output was captured */
+        capturedAt: string;
+        /** Number of lines captured from tmux */
+        linesCaptured: number;
+        /** Time taken to stabilize in milliseconds */
+        stabilizationMs: number;
+        /** Whether output was truncated */
+        truncated: boolean;
+        /** Delivery path: 'opencode-serve:<port>' or 'tmux-fallback' */
+        delivery_path?: string;
+    };
+    /** Parsing metadata */
+    parsing: {
+        /** Whether the output was successfully parsed */
+        success: boolean;
+        /** Parser used (e.g., 'tmux-regex', 'ansi-strip', 'json-events') */
+        parser: string;
+        /** Error message if parsing failed */
+        error?: string;
+    };
+}
+/**
+ * Runtime event types
+ */
+export type RuntimeEventType = "output.start" | "output.chunk" | "output.complete" | "output.error" | "runner.ready" | "runner.busy" | "tool.start" | "tool.complete" | "message.delta" | "message.complete";
+/**
+ * Runtime event from runner
+ */
+export interface RuntimeEvent {
+    /** Event type */
+    type: RuntimeEventType;
+    /** ISO timestamp */
+    timestamp: string;
+    /** Event payload (type-specific) */
+    payload: unknown;
+    /** Correlation ID for request/response pairing */
+    correlationId?: string;
+}
+/**
+ * Chat input request
+ */
+export interface ChatInputRequest {
+    /** Message content to inject */
+    content: string;
+    /** Output mode preference */
+    outputMode: OutputMode;
+    /** Message ID for correlation */
+    messageId: string;
+    /** Workspace ID */
+    workspace: string;
+    /** Agent ID */
+    agentId: string;
+}
+/**
+ * Chat output response
+ */
+export type ChatOutputResponse = {
+    mode: "clean";
+    content: string;
+} | {
+    mode: "raw";
+    content: string;
+} | {
+    mode: "structured";
+    data: StructuredOutput;
+};
+/**
+ * Runtime adapter interface
+ *
+ * Implementations provide runner-specific I/O handling.
+ */
+export interface RuntimeAdapter {
+    /** Adapter identifier */
+    readonly id: string;
+    /** Human-readable name */
+    readonly displayName: string;
+    /** Supported runner types */
+    readonly supportedRunners: string[];
+    /** Whether this adapter supports structured events */
+    readonly supportsStructuredEvents: boolean;
+    /**
+     * Check if this adapter can handle the given session
+     */
+    canHandle(sessionName: string): boolean | Promise<boolean>;
+    /**
+     * Inject chat input into the runtime session
+     */
+    injectInput(sessionName: string, request: ChatInputRequest): boolean | Promise<boolean>;
+    /**
+     * Capture output from the runtime session
+     */
+    captureOutput(sessionName: string, request: ChatInputRequest): ChatOutputResponse | Promise<ChatOutputResponse>;
+    /**
+     * Wait for stable output and return in requested mode
+     */
+    waitForOutput(sessionName: string, request: ChatInputRequest, options?: WaitForOutputOptions): Promise<ChatOutputResponse>;
+}
+/**
+ * Options for waitForOutput
+ */
+export interface WaitForOutputOptions {
+    /** Poll interval in milliseconds (default: 2000) */
+    pollMs?: number;
+    /** Stabilization time in milliseconds (default: 5000) */
+    stableMs?: number;
+    /** Hard timeout in milliseconds (default: 60000) */
+    timeoutMs?: number;
+    /** Maximum lines to capture (default: 120) */
+    maxLines?: number;
+}
+/**
+ * Adapter capability flags
+ */
+export interface AdapterCapabilities {
+    /** Supports JSON event streaming */
+    jsonEvents: boolean;
+    /** Supports ANSI stripping */
+    ansiStripping: boolean;
+    /** Supports prompt detection */
+    promptDetection: boolean;
+    /** Supports tool execution tracking */
+    toolTracking: boolean;
+    /** Supports mid-work chat (while tools running) */
+    midWorkChat: boolean;
+}
+/**
+ * Runner detection result
+ */
+export interface RunnerDetectionResult {
+    /** Detected runner type */
+    runnerType: string;
+    /** Detected runner version (if available) */
+    version?: string;
+    /** Whether structured events are available */
+    structuredEventsAvailable: boolean;
+    /** Recommended adapter ID */
+    recommendedAdapter: string;
+}

package/dist/runtime/types.js

@@ -0,0 +1,8 @@
+/**
+ * Runtime Adapter Types
+ *
+ * Cross-runner runtime I/O contract for AgentMesh chat/control.
+ * Provides normalized event-based output instead of tmux pane scraping.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/runtime/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/runtime/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentmeshhq/agent",
-  "version": "0.4.18",
+  "version": "0.4.20",
   "description": "AgentMesh Agent Wrapper - Turn any AI coding assistant into a dispatchable, nudge-able agent",
   "type": "module",
   "main": "dist/index.js",