@swarmclawai/swarmclaw 1.2.3 → 1.2.5

package/src/stores/use-chatroom-store.ts

@@ -2,7 +2,7 @@
 
 import { create } from 'zustand'
 import { api, getStoredAccessKey } from '@/lib/app/api-client'
-import type { Chatroom, ChatroomMessage, ChatroomRoutingRule, SSEEvent } from '@/types'
+import type { Chatroom, ChatroomMessage, SSEEvent } from '@/types'
 import type { PendingFile } from '@/stores/use-chat-store'
 
 interface ToolEvent {
@@ -59,7 +59,7 @@ interface ChatroomState {
 
   loadChatrooms: () => Promise<void>
   loadChatroomById: (id: string) => Promise<Chatroom | null>
-  createChatroom: (data: { name: string; description?: string; agentIds?: string[]; chatMode?: 'sequential' | 'parallel'; autoAddress?: boolean; routingRules?: ChatroomRoutingRule[] }) => Promise<Chatroom>
+  createChatroom: (data: { name: string; description?: string; agentIds?: string[]; chatMode?: 'sequential' | 'parallel'; autoAddress?: boolean; routingGuidance?: string | null }) => Promise<Chatroom>
   updateChatroom: (id: string, data: Partial<Chatroom>) => Promise<void>
   deleteChatroom: (id: string) => Promise<void>
   setCurrentChatroom: (id: string | null) => void

package/src/types/index.ts

@@ -7,6 +7,25 @@ export interface MessageToolEvent {
   toolCallId?: string
 }
 
+export type MessageTaskIntent = 'coding' | 'research' | 'browsing' | 'outreach' | 'scheduling' | 'general'
+export type MessageWorkType = 'coding' | 'research' | 'writing' | 'review' | 'operations' | 'general'
+
+export interface MessageSemanticsSummary {
+  taskIntent: MessageTaskIntent
+  workType: MessageWorkType
+  walletIntent: 'none' | 'read_only' | 'transactional'
+  isDeliverableTask: boolean
+  isBroadGoal: boolean
+  isResearchSynthesis: boolean
+  hasHumanSignals: boolean
+  hasSignificantEvent: boolean
+  wantsScreenshots?: boolean
+  wantsOutboundDelivery?: boolean
+  wantsVoiceDelivery?: boolean
+  explicitToolRequests: string[]
+  confidence: number
+}
+
 export interface Message {
   role: 'user' | 'assistant'
   text: string
@@ -30,6 +49,8 @@ export interface Message {
   streaming?: boolean
   /** Run ID that produced this message — used to scope streaming artifact replacement. */
   runId?: string
+  /** Cached turn semantics used for routing, delegation, and reflection. */
+  semantics?: MessageSemanticsSummary
 }
 
 export type SessionResetMode = 'idle' | 'daily' | 'isolated'
@@ -53,6 +74,216 @@ export interface SessionArchiveState {
   exportPath?: string | null
 }
 
+export type WorkingStateStatus = 'idle' | 'progress' | 'blocked' | 'waiting' | 'completed'
+export type WorkingStateItemStatus = 'active' | 'resolved' | 'superseded'
+
+export interface EvidenceRef {
+  id: string
+  type: 'tool' | 'message' | 'mission' | 'task' | 'artifact' | 'error' | 'approval'
+  summary: string
+  value?: string | null
+  toolName?: string | null
+  toolCallId?: string | null
+  runId?: string | null
+  sessionId?: string | null
+  missionId?: string | null
+  taskId?: string | null
+  createdAt: number
+}
+
+export interface WorkingPlanStep {
+  id: string
+  text: string
+  status: WorkingStateItemStatus
+  createdAt: number
+  updatedAt: number
+}
+
+export interface WorkingFact {
+  id: string
+  statement: string
+  source: 'user' | 'tool' | 'assistant' | 'mission' | 'system'
+  status: WorkingStateItemStatus
+  evidenceIds?: string[]
+  createdAt: number
+  updatedAt: number
+}
+
+export interface WorkingArtifact {
+  id: string
+  label: string
+  kind: 'file' | 'url' | 'approval' | 'message' | 'other'
+  path?: string | null
+  url?: string | null
+  sourceTool?: string | null
+  status: WorkingStateItemStatus
+  evidenceIds?: string[]
+  createdAt: number
+  updatedAt: number
+}
+
+export interface WorkingDecision {
+  id: string
+  summary: string
+  rationale?: string | null
+  status: WorkingStateItemStatus
+  evidenceIds?: string[]
+  createdAt: number
+  updatedAt: number
+}
+
+export interface WorkingBlocker {
+  id: string
+  summary: string
+  kind?: 'approval' | 'credential' | 'human_input' | 'external_dependency' | 'error' | 'other' | null
+  nextAction?: string | null
+  status: WorkingStateItemStatus
+  evidenceIds?: string[]
+  createdAt: number
+  updatedAt: number
+}
+
+export interface WorkingQuestion {
+  id: string
+  question: string
+  status: WorkingStateItemStatus
+  evidenceIds?: string[]
+  createdAt: number
+  updatedAt: number
+}
+
+export interface WorkingHypothesis {
+  id: string
+  statement: string
+  confidence?: 'low' | 'medium' | 'high' | null
+  status: WorkingStateItemStatus
+  evidenceIds?: string[]
+  createdAt: number
+  updatedAt: number
+}
+
+export interface WorkingPlanStepPatch {
+  id?: string | null
+  text: string
+  status?: WorkingStateItemStatus | null
+}
+
+export interface WorkingFactPatch {
+  id?: string | null
+  statement: string
+  source?: WorkingFact['source'] | null
+  status?: WorkingStateItemStatus | null
+  evidenceIds?: string[]
+}
+
+export interface WorkingArtifactPatch {
+  id?: string | null
+  label: string
+  kind?: WorkingArtifact['kind'] | null
+  path?: string | null
+  url?: string | null
+  sourceTool?: string | null
+  status?: WorkingStateItemStatus | null
+  evidenceIds?: string[]
+}
+
+export interface WorkingDecisionPatch {
+  id?: string | null
+  summary: string
+  rationale?: string | null
+  status?: WorkingStateItemStatus | null
+  evidenceIds?: string[]
+}
+
+export interface WorkingBlockerPatch {
+  id?: string | null
+  summary: string
+  kind?: WorkingBlocker['kind']
+  nextAction?: string | null
+  status?: WorkingStateItemStatus | null
+  evidenceIds?: string[]
+}
+
+export interface WorkingQuestionPatch {
+  id?: string | null
+  question: string
+  status?: WorkingStateItemStatus | null
+  evidenceIds?: string[]
+}
+
+export interface WorkingHypothesisPatch {
+  id?: string | null
+  statement: string
+  confidence?: WorkingHypothesis['confidence']
+  status?: WorkingStateItemStatus | null
+  evidenceIds?: string[]
+}
+
+export interface WorkingStatePatch {
+  objective?: string | null
+  summary?: string | null
+  constraints?: string[]
+  successCriteria?: string[]
+  status?: WorkingStateStatus | null
+  nextAction?: string | null
+  planSteps?: WorkingPlanStepPatch[]
+  factsUpsert?: WorkingFactPatch[]
+  artifactsUpsert?: WorkingArtifactPatch[]
+  decisionsAppend?: WorkingDecisionPatch[]
+  blockersUpsert?: WorkingBlockerPatch[]
+  questionsUpsert?: WorkingQuestionPatch[]
+  hypothesesUpsert?: WorkingHypothesisPatch[]
+  evidenceAppend?: EvidenceRef[]
+  supersedeIds?: string[]
+}
+
+export interface SessionWorkingState {
+  sessionId: string
+  missionId?: string | null
+  objective?: string | null
+  summary?: string | null
+  constraints: string[]
+  successCriteria: string[]
+  status: WorkingStateStatus
+  nextAction?: string | null
+  planSteps: WorkingPlanStep[]
+  confirmedFacts: WorkingFact[]
+  artifacts: WorkingArtifact[]
+  decisions: WorkingDecision[]
+  blockers: WorkingBlocker[]
+  openQuestions: WorkingQuestion[]
+  hypotheses: WorkingHypothesis[]
+  evidenceRefs: EvidenceRef[]
+  createdAt: number
+  updatedAt: number
+  lastCompactedAt?: number | null
+}
+
+export interface ExecutionBriefPlanStep {
+  text: string
+  status: WorkingStateItemStatus
+}
+
+export interface ExecutionBrief {
+  sessionId?: string | null
+  missionId?: string | null
+  objective: string | null
+  summary: string | null
+  status: WorkingStateStatus
+  nextAction: string | null
+  plan: ExecutionBriefPlanStep[]
+  blockers: string[]
+  facts: string[]
+  artifacts: string[]
+  constraints: string[]
+  successCriteria: string[]
+  missionStatus?: MissionStatus | null
+  missionPhase?: MissionPhase | null
+  waitState?: MissionWaitState | null
+  evidenceRefs: EvidenceRef[]
+  parentContext: string | null
+}
+
 export type MissionSource =
   | 'chat'
   | 'connector'
@@ -295,9 +526,10 @@ export interface CanvasDocument {
 export type CanvasContent = string | CanvasDocument | null
 
 export type ProviderType = 'claude-cli' | 'codex-cli' | 'opencode-cli' | 'gemini-cli' | 'openai' | 'ollama' | 'anthropic' | 'openclaw' | 'google' | 'deepseek' | 'groq' | 'together' | 'mistral' | 'xai' | 'fireworks' | 'nebius' | 'deepinfra'
+export type ProviderId = ProviderType | (string & {})
 
 export interface ProviderInfo {
-  id: ProviderType
+  id: ProviderId
   name: string
   models: string[]
   defaultModels?: string[]
@@ -338,7 +570,7 @@ export interface Session {
   shortcutForAgentId?: string | null
   cwd: string
   user: string
-  provider: ProviderType
+  provider: ProviderId
   model: string
   ollamaMode?: OllamaMode | null
   credentialId?: string | null
@@ -357,8 +589,9 @@ export interface Session {
     opencode?: string | null
     gemini?: string | null
   }
+  /** @deprecated Messages are stored in session_messages table. Use message-repository. */
   messages: Message[]
-  /** Lightweight summary fields used by list/index APIs to avoid shipping full transcripts. */
+  /** Pre-computed message count (kept in sync by message-repository). */
   messageCount?: number
   lastMessageSummary?: Message | null
   lastAssistantAt?: number | null
@@ -454,6 +687,22 @@ export interface Session {
   canvasContent?: CanvasContent
   /** Tracks how many times each memory ID has been injected via proactive recall in this session. */
   injectedMemoryIds?: Record<string, number>
+  /** Structured working memory that survives compaction and flows through delegation. */
+  runContext?: RunContext | null
+}
+
+export interface RunContext {
+  objective: string | null
+  constraints: string[]
+  keyFacts: string[]
+  discoveries: string[]
+  failedApproaches: string[]
+  currentPlan: string[]
+  completedSteps: string[]
+  blockers: string[]
+  parentContext: string | null
+  updatedAt: number
+  version: number
 }
 
 export type Sessions = Record<string, Session>
@@ -563,7 +812,7 @@ export interface ExtensionPromptBuildResult {
 }
 
 export interface ExtensionModelResolveResult {
-  providerOverride?: ProviderType
+  providerOverride?: ProviderId
   modelOverride?: string
   apiEndpointOverride?: string | null
 }
@@ -596,7 +845,7 @@ export interface ExtensionHooks {
     session: Session
     prompt: string
     message: string
-    provider: ProviderType
+    provider: ProviderId
     model: string
     apiEndpoint?: string | null
   }) => Promise<ExtensionModelResolveResult | void> | ExtensionModelResolveResult | void
@@ -618,7 +867,7 @@ export interface ExtensionHooks {
   llmInput?: (ctx: {
     session: Session
     runId: string
-    provider: ProviderType
+    provider: ProviderId
     model: string
     systemPrompt?: string
     prompt: string
@@ -628,7 +877,7 @@ export interface ExtensionHooks {
   llmOutput?: (ctx: {
     session: Session
     runId: string
-    provider: ProviderType
+    provider: ProviderId
     model: string
     assistantTexts: string[]
     response: string
@@ -741,17 +990,6 @@ export interface ExtensionToolPlanning {
    * this tool is enabled.
    */
   disciplineGuidance?: string[]
-  /**
-   * Optional natural-language cues that indicate when this tool should be
-   * preferred or explicitly invoked. These are declarative hints so the harness
-   * does not need to hard-code every extension-specific workflow centrally.
-   */
-  requestMatchers?: Array<{
-    capability?: string
-    patterns?: string[]
-    requireLiteralUrl?: boolean
-    forbidLiteralUrl?: boolean
-  }>
 }
 
 export interface ExtensionToolDef {
@@ -1056,7 +1294,7 @@ export interface Agent {
   theme?: string
   avatar?: string
   systemPrompt: string
-  provider: ProviderType
+  provider: ProviderId
   model: string
   ollamaMode?: OllamaMode | null
   credentialId?: string | null
@@ -1606,6 +1844,8 @@ export interface Chatroom {
   pinnedMessageIds?: string[]
   chatMode?: 'sequential' | 'parallel'
   autoAddress?: boolean
+  routingGuidance?: string | null
+  /** Legacy deterministic routing config kept only for migration/read compatibility. */
   routingRules?: ChatroomRoutingRule[]
   temporary?: boolean
   topic?: string
@@ -2105,6 +2345,23 @@ export interface AppNotification {
 // --- Session Runs ---
 
 export type SessionRunStatus = 'queued' | 'running' | 'completed' | 'failed' | 'cancelled'
+export type ExecutionKind =
+  | 'session_turn'
+  | 'task_attempt'
+  | 'protocol_step'
+  | 'heartbeat_tick'
+  | 'schedule_wake'
+  | 'repair_turn'
+  | 'subagent_turn'
+
+export type ExecutionOwnerType =
+  | 'session'
+  | 'task'
+  | 'protocol_run'
+  | 'schedule'
+  | 'mission'
+  | 'agent'
+  | 'subagent'
 
 export interface SessionRunHeartbeatConfig {
   ackMaxChars: number
@@ -2134,6 +2391,11 @@ export interface SessionRunRecord {
   id: string
   sessionId: string
   missionId?: string | null
+  kind?: ExecutionKind
+  ownerType?: ExecutionOwnerType | null
+  ownerId?: string | null
+  parentExecutionId?: string | null
+  recoveryPolicy?: 'restart_recoverable' | 'ephemeral' | 'manual' | 'none'
   source: string
   internal: boolean
   mode: string
@@ -2180,6 +2442,10 @@ export interface RunEventRecord {
   id: string
   runId: string
   sessionId: string
+  kind?: ExecutionKind
+  ownerType?: ExecutionOwnerType | null
+  ownerId?: string | null
+  parentExecutionId?: string | null
   timestamp: number
   phase: 'status' | 'event'
   status?: SessionRunStatus
@@ -2615,7 +2881,7 @@ export interface AgentRoutingTarget {
   id: string
   label?: string
   role?: AgentRoutingTargetRole
-  provider: ProviderType
+  provider: ProviderId
   model: string
   ollamaMode?: OllamaMode | null
   credentialId?: string | null
@@ -2631,7 +2897,7 @@ export interface AgentPackEntry {
   id: string
   name: string
   description?: string
-  provider: ProviderType
+  provider: ProviderId
   model: string
   ollamaMode?: OllamaMode | null
   credentialId?: string | null
@@ -2668,7 +2934,7 @@ export interface ExternalAgentRuntime {
   name: string
   sourceType: ExternalAgentSourceType
   status: ExternalAgentStatus
-  provider?: ProviderType | null
+  provider?: ProviderId | null
   model?: string | null
   workspace?: string | null
   transport?: 'http' | 'ws' | 'cli' | 'gateway' | 'custom' | null

package/src/views/settings/section-providers.tsx

@@ -4,7 +4,7 @@ import { useState } from 'react'
 import { useAppStore } from '@/stores/use-app-store'
 import { createCredential, deleteCredential } from '@/lib/chat/chats'
 import { toast } from 'sonner'
-import type { ProviderType } from '@/types'
+import type { ProviderId } from '@/types'
 import type { SettingsSectionProps } from './types'
 
 export function ProvidersSection({ inputClass }: SettingsSectionProps) {
@@ -14,7 +14,7 @@ export function ProvidersSection({ inputClass }: SettingsSectionProps) {
 
   const credList = Object.values(credentials)
 
-  const [addProvider, setAddProvider] = useState<ProviderType | null>(null)
+  const [addProvider, setAddProvider] = useState<ProviderId | null>(null)
   const [newName, setNewName] = useState('')
   const [newKey, setNewKey] = useState('')
   const [deleting, setDeleting] = useState<string | null>(null)