bopodev-agent-sdk 0.1.9 → 0.1.11

package/src/types.ts

@@ -1,4 +1,4 @@
-import type { ProviderType } from "bopodev-contracts";
+import type { ExecutionOutcome, ProviderType } from "bopodev-contracts";
 
 export type AgentProviderType = ProviderType;
 
@@ -17,6 +17,10 @@ export interface AgentWorkItem {
 export interface AgentState {
   sessionId?: string;
   cwd?: string;
+  cursorSession?: {
+    sessionId: string;
+    cwd?: string;
+  };
   metadata?: Record<string, unknown>;
 }
 
@@ -50,6 +54,7 @@ export interface AdapterExecutionResult {
   tokenInput: number;
   tokenOutput: number;
   usdCost: number;
+  outcome?: ExecutionOutcome;
   nextState?: AgentState;
   trace?: AdapterTrace;
 }
@@ -59,11 +64,45 @@ export interface AgentAdapter {
   execute(context: HeartbeatContext): Promise<AdapterExecutionResult>;
 }
 
+export type AdapterEnvironmentCheckLevel = "info" | "warn" | "error";
+export type AdapterEnvironmentStatus = "pass" | "warn" | "fail";
+
+export interface AdapterEnvironmentCheck {
+  code: string;
+  level: AdapterEnvironmentCheckLevel;
+  message: string;
+  detail?: string;
+  hint?: string;
+}
+
+export interface AdapterEnvironmentResult {
+  providerType: AgentProviderType;
+  status: AdapterEnvironmentStatus;
+  testedAt: string;
+  checks: AdapterEnvironmentCheck[];
+}
+
+export interface AdapterModelOption {
+  id: string;
+  label: string;
+}
+
+export interface AdapterMetadata {
+  providerType: AgentProviderType;
+  label: string;
+  supportsModelSelection: boolean;
+  supportsEnvironmentTest: boolean;
+  supportsWebSearch: boolean;
+  supportsThinkingEffort: boolean;
+  requiresRuntimeCwd: boolean;
+}
+
 export interface AgentRuntimeConfig {
   command?: string;
   args?: string[];
   cwd?: string;
   timeoutMs?: number;
+  abortSignal?: AbortSignal;
   interruptGraceSec?: number;
   retryCount?: number;
   retryBackoffMs?: number;
@@ -79,10 +118,13 @@ export interface AgentRuntimeConfig {
 
 export interface AdapterTrace {
   command?: string;
+  args?: string[];
+  cwd?: string;
   exitCode?: number | null;
   elapsedMs?: number;
   timedOut?: boolean;
   failureType?: string;
+  timeoutSource?: "runtime" | "watchdog" | null;
   usageSource?: "structured" | "estimated" | "none" | "unknown";
   attemptCount?: number;
   attempts?: Array<{
@@ -96,4 +138,51 @@ export interface AdapterTrace {
   }>;
   stdoutPreview?: string;
   stderrPreview?: string;
+  session?: {
+    currentSessionId?: string | null;
+    resumedSessionId?: string | null;
+    resumeAttempted?: boolean;
+    resumeSkippedReason?: string | null;
+    clearedStaleSession?: boolean;
+  };
+  structuredOutputSource?: "stdout" | "stderr";
+  structuredOutputDiagnostics?: {
+    stdoutJsonObjectCount: number;
+    stderrJsonObjectCount: number;
+    stderrStructuredUsageDetected: boolean;
+    stdoutBytes: number;
+    stderrBytes: number;
+    hasAnyOutput: boolean;
+    lastStdoutLine?: string;
+    lastStderrLine?: string;
+    likelyCause:
+      | "no_output_from_runtime"
+      | "json_missing"
+      | "json_on_stderr_only"
+      | "schema_or_shape_mismatch";
+    claudeStopReason?: string;
+    claudeResultSubtype?: string;
+    claudeSessionId?: string;
+    cursorSessionId?: string;
+    cursorErrorMessage?: string;
+    claudeContract?: {
+      commandOverride: boolean;
+      commandLooksClaude: boolean;
+      commandWasProviderAlias: boolean;
+      hasPromptFlag: boolean;
+      hasOutputFormatJson: boolean;
+      outputFormat: string | null;
+      hasMaxTurnsFlag: boolean;
+      hasVerboseFlag: boolean;
+      hasDangerouslySkipPermissions: boolean;
+      hasJsonSchema: boolean;
+      missingRequiredArgs: string[];
+    };
+  };
+  transcript?: Array<{
+    kind: "system" | "assistant" | "thinking" | "tool_call" | "tool_result" | "result" | "stderr";
+    label?: string;
+    text?: string;
+    payload?: string;
+  }>;
 }