agent-relay 3.2.22 → 4.0.0

package/packages/sdk/src/types.ts

@@ -0,0 +1,75 @@
+/**
+ * Shared input/output types for the broker SDK.
+ */
+
+import type { AgentRuntime, HeadlessProvider, MessageInjectionMode, RestartPolicy } from './protocol.js';
+
+export interface SpawnPtyInput {
+  name: string;
+  cli: string;
+  args?: string[];
+  channels?: string[];
+  task?: string;
+  model?: string;
+  cwd?: string;
+  team?: string;
+  shadowOf?: string;
+  shadowMode?: string;
+  idleThresholdSecs?: number;
+  restartPolicy?: RestartPolicy;
+  continueFrom?: string;
+  skipRelayPrompt?: boolean;
+}
+
+export interface SpawnHeadlessInput {
+  name: string;
+  provider: HeadlessProvider;
+  args?: string[];
+  channels?: string[];
+  task?: string;
+  skipRelayPrompt?: boolean;
+}
+
+export type AgentTransport = 'pty' | 'headless';
+
+export interface SpawnProviderInput {
+  name: string;
+  provider: string;
+  transport?: AgentTransport;
+  args?: string[];
+  channels?: string[];
+  task?: string;
+  model?: string;
+  cwd?: string;
+  team?: string;
+  shadowOf?: string;
+  shadowMode?: string;
+  idleThresholdSecs?: number;
+  restartPolicy?: RestartPolicy;
+  continueFrom?: string;
+  skipRelayPrompt?: boolean;
+}
+
+export interface SendMessageInput {
+  to: string;
+  text: string;
+  from?: string;
+  threadId?: string;
+  workspaceId?: string;
+  workspaceAlias?: string;
+  priority?: number;
+  data?: Record<string, unknown>;
+  mode?: MessageInjectionMode;
+}
+
+export interface ListAgent {
+  name: string;
+  runtime: AgentRuntime;
+  provider?: HeadlessProvider;
+  cli?: string;
+  model?: string;
+  team?: string;
+  channels: string[];
+  parent?: string;
+  pid?: number;
+}

package/packages/sdk/src/workflows/validator.ts

@@ -1,4 +1,5 @@
 import type { RelayYamlConfig, AgentDefinition, WorkflowStep } from './types.js';
+import { CodexModels } from '@agent-relay/config';
 
 export interface ValidationIssue {
   severity: 'error' | 'warning' | 'info';
@@ -117,7 +118,24 @@ export function validateWorkflow(config: RelayYamlConfig): ValidationIssue[] {
         });
       }
 
-      // Check 4: non-interactive agent that references relay messaging tools in task
+      // Check 4: codex-spark cannot be used in non-interactive mode
+      const CODEX_SPARK_MODELS: string[] = [CodexModels.GPT_5_3_CODEX_SPARK];
+      if (
+        def.interactive === false &&
+        def.cli === 'codex' &&
+        def.constraints?.model &&
+        (CODEX_SPARK_MODELS.includes(def.constraints.model) || /codex-spark/i.test(def.constraints.model))
+      ) {
+        issues.push({
+          severity: 'error',
+          code: 'CODEX_SPARK_NON_INTERACTIVE',
+          message: `Agent "${step.agent}" uses codex-spark model in non-interactive mode. Codex Spark does not support non-interactive (headless) execution.`,
+          fix: `Switch to a different model (e.g. gpt-5.3-codex) or set the agent to interactive mode.`,
+          location: `step:${step.name}`,
+        });
+      }
+
+      // Check 5: non-interactive agent that references relay messaging tools in task
       if (
         def.interactive === false &&
         (task.includes('mcp__relaycast__message_dm_send') || task.includes('mcp__relaycast__message_post') || task.includes('mcp__relaycast__message_inbox_check'))
@@ -132,7 +150,7 @@ export function validateWorkflow(config: RelayYamlConfig): ValidationIssue[] {
       }
     }
 
-    // Check 5: maxConcurrency vs interactive agent count
+    // Check 6: maxConcurrency vs interactive agent count
     const interactiveSteps = (workflow.steps ?? []).filter((s) => {
       if (s.type === 'deterministic') return false;
       const def = agentMap.get(s.agent ?? '');

package/packages/sdk-py/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "agent-relay-sdk"
-version = "3.2.22"
+version = "4.0.0"
 description = "Python SDK for Agent Relay workflows"
 readme = "README.md"
 license = "Apache-2.0"

package/packages/sdk-py/src/agent_relay/__init__.py

@@ -13,13 +13,9 @@ except ImportError:
 from .models import Models
 from .client import AgentRelayClient, AgentRelayProtocolError, AgentRelayProcessError
 from .protocol import (
-    PROTOCOL_VERSION,
     AgentRuntime,
-    AgentSpec,
     BrokerEvent,
     MessageInjectionMode,
-    ProtocolEnvelope,
-    RestartPolicy as ProtocolRestartPolicy,
 )
 
 # ── Secondary API: Workflow builder (backward compatibility) ──────────────────
@@ -89,13 +85,9 @@ __all__ = [
     "AgentRelayClient",
     "AgentRelayProtocolError",
     "AgentRelayProcessError",
-    "PROTOCOL_VERSION",
     "AgentRuntime",
-    "AgentSpec",
     "BrokerEvent",
     "MessageInjectionMode",
-    "ProtocolEnvelope",
-    "ProtocolRestartPolicy",
     # Workflow builder (backward compat)
     "workflow",
     "WorkflowBuilder",