@swarmclawai/swarmclaw 0.7.6 → 0.7.8

package/src/lib/setup-defaults.ts

@@ -48,7 +48,7 @@ export const SETUP_PROVIDERS: SetupProviderOption[] = [
   {
     id: 'openclaw',
     name: 'OpenClaw',
-    description: 'Connect one or more local or remote OpenClaw gateways and map different starter agents to each one.',
+    description: 'Deploy or connect official-only local and remote OpenClaw gateways, then map starter agents across your swarm by role, tag, or use case.',
     requiresKey: false,
     supportsEndpoint: true,
     allowMultiple: true,
@@ -481,7 +481,7 @@ export const STARTER_KITS: StarterKit[] = [
     id: 'openclaw_fleet',
     name: 'OpenClaw Fleet',
     description: 'An OpenClaw-first starter setup for local or remote gateways.',
-    detail: 'Designed for users who want multiple OpenClaw-backed agents right away, including remote endpoint assignments.',
+    detail: 'Designed for users who want multiple OpenClaw-backed agents right away, with official-only local deploy, single-VPS, and private-tailnet defaults built into setup.',
     recommendedFor: ['manual'],
     badge: 'OpenClaw',
     agents: [

package/src/lib/tool-definitions.ts

@@ -36,7 +36,8 @@ export const AVAILABLE_TOOLS: ToolDefinition[] = [
  * Granular CRUD tools are now unified under 'manage_platform'.
  */
 export const PLATFORM_TOOLS: ToolDefinition[] = [
-  { id: 'manage_platform', label: 'Platform', description: 'Unified management of agents, tasks, schedules, skills, documents, and secrets' },
+  { id: 'manage_platform', label: 'Platform', description: 'Unified management of agents, projects, tasks, schedules, skills, documents, and secrets' },
+  { id: 'manage_projects', label: 'Projects', description: 'Manage durable project context: objectives, priorities, heartbeat plans, credential needs, and linked resources' },
   { id: 'manage_connectors', label: 'Connectors', description: 'Manage chat platform bridges and send outbound messages' },
   { id: 'manage_chatrooms', label: 'Chatrooms', description: 'Manage SwarmClaw routing rules and multi-agent chatrooms' },
   { id: 'delegate_to_agent', label: 'Assign Agent', description: 'Delegate a task to another specific agent' },

package/src/lib/validation/schemas.ts

@@ -10,6 +10,8 @@ const AgentRoutingTargetSchema = z.object({
   fallbackCredentialIds: z.array(z.string()).optional().default([]),
   apiEndpoint: z.string().nullable().optional().default(null),
   gatewayProfileId: z.string().nullable().optional().default(null),
+  preferredGatewayTags: z.array(z.string()).optional().default([]),
+  preferredGatewayUseCase: z.string().nullable().optional().default(null),
   priority: z.number().int().optional(),
 })
 
@@ -23,6 +25,8 @@ export const AgentCreateSchema = z.object({
   fallbackCredentialIds: z.array(z.string()).optional().default([]),
   apiEndpoint: z.string().nullable().optional().default(null),
   gatewayProfileId: z.string().nullable().optional().default(null),
+  preferredGatewayTags: z.array(z.string()).optional().default([]),
+  preferredGatewayUseCase: z.string().nullable().optional().default(null),
   routingStrategy: z.enum(['single', 'balanced', 'economy', 'premium', 'reasoning']).nullable().optional().default(null),
   routingTargets: z.array(AgentRoutingTargetSchema).optional().default([]),
   isOrchestrator: z.boolean().optional().default(false),
@@ -89,6 +93,11 @@ export const ExternalAgentRegisterSchema = z.object({
   gatewayProfileId: z.string().nullable().optional().default(null),
   capabilities: z.array(z.string()).optional().default([]),
   labels: z.array(z.string()).optional().default([]),
+  lifecycleState: z.enum(['active', 'draining', 'cordoned']).optional().default('active'),
+  gatewayTags: z.array(z.string()).optional().default([]),
+  gatewayUseCase: z.string().nullable().optional().default(null),
+  version: z.string().nullable().optional().default(null),
+  lastHealthNote: z.string().nullable().optional().default(null),
   metadata: z.record(z.string(), z.unknown()).nullable().optional().default(null),
   tokenStats: z.object({
     inputTokens: z.number().nonnegative().optional(),

package/src/types/index.ts

@@ -93,6 +93,8 @@ export interface Session {
   fallbackCredentialIds?: string[]
   apiEndpoint?: string | null
   gatewayProfileId?: string | null
+  routePreferredGatewayTags?: string[]
+  routePreferredGatewayUseCase?: string | null
   claudeSessionId: string | null
   codexThreadId?: string | null
   opencodeSessionId?: string | null
@@ -303,10 +305,36 @@ export interface PluginHooks {
   getOperatingGuidance?: () => string | string[] | null | undefined
 }
 
+export interface PluginToolPlanning {
+  /**
+   * Capability tags that the harness can use for prompt guidance and tool routing.
+   * Examples: research.search, research.fetch, browser.capture, artifact.pdf,
+   * delivery.media, delivery.voice_note.
+   */
+  capabilities?: string[]
+  /**
+   * Concrete usage guidance that should be injected into the system prompt when
+   * 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 plugin-specific workflow centrally.
+   */
+  requestMatchers?: Array<{
+    capability?: string
+    patterns?: string[]
+    requireLiteralUrl?: boolean
+    forbidLiteralUrl?: boolean
+  }>
+}
+
 export interface PluginToolDef {
   name: string
   description: string
   parameters: Record<string, unknown>
+  planning?: PluginToolPlanning
   execute: (args: Record<string, unknown>, ctx: { session: Session; message: string }) => Promise<string | object> | string | object
 }
 
@@ -498,6 +526,8 @@ export interface Agent {
   fallbackCredentialIds?: string[]
   apiEndpoint?: string | null
   gatewayProfileId?: string | null
+  preferredGatewayTags?: string[]
+  preferredGatewayUseCase?: string | null
   routingStrategy?: AgentRoutingStrategy | null
   routingTargets?: AgentRoutingTarget[]
   isOrchestrator?: boolean
@@ -930,6 +960,15 @@ export interface Project {
   name: string
   description: string
   color?: string
+  objective?: string
+  audience?: string
+  priorities?: string[]
+  openObjectives?: string[]
+  capabilityHints?: string[]
+  credentialRequirements?: string[]
+  successMetrics?: string[]
+  heartbeatPrompt?: string
+  heartbeatIntervalSec?: number
   createdAt: number
   updatedAt: number
 }
@@ -1061,6 +1100,8 @@ export interface AppSettings {
   capabilityBlockedTools?: string[]
   capabilityBlockedCategories?: string[]
   capabilityAllowedTools?: string[]
+  taskManagementEnabled?: boolean
+  projectManagementEnabled?: boolean
   // Memory governance
   memoryWorkingTtlHours?: number
   memoryDefaultConfidence?: number
@@ -1124,6 +1165,7 @@ export interface OrchestratorSecret {
   encryptedValue: string
   scope: 'global' | 'agent'
   agentIds: string[]      // if scope === 'agent', which agents can use it
+  projectId?: string
   createdAt: number
   updatedAt: number
 }
@@ -1168,6 +1210,58 @@ export interface ProviderConfig {
 
 export type GatewayProvider = 'openclaw'
 export type GatewayHealthState = 'unknown' | 'healthy' | 'degraded' | 'offline' | 'pending'
+export type OpenClawDeploymentMethod = 'local' | 'bundle' | 'ssh' | 'imported'
+export type OpenClawDeploymentProvider =
+  | 'local'
+  | 'hetzner'
+  | 'digitalocean'
+  | 'vultr'
+  | 'linode'
+  | 'lightsail'
+  | 'gcp'
+  | 'azure'
+  | 'oci'
+  | 'generic'
+  | 'render'
+  | 'fly'
+  | 'railway'
+export type OpenClawRemoteDeployTarget = 'docker' | 'render' | 'fly' | 'railway'
+export type OpenClawUseCaseTemplate = 'local-dev' | 'single-vps' | 'private-tailnet' | 'browser-heavy' | 'team-control'
+export type OpenClawExposurePreset = 'private-lan' | 'tailscale' | 'caddy' | 'nginx' | 'ssh-tunnel'
+
+export interface OpenClawGatewayStats {
+  nodeCount?: number
+  connectedNodeCount?: number
+  pendingNodePairings?: number
+  pairedDeviceCount?: number
+  pendingDevicePairings?: number
+  externalRuntimeCount?: number
+}
+
+export interface OpenClawDeploymentConfig {
+  method?: OpenClawDeploymentMethod | null
+  provider?: OpenClawDeploymentProvider | null
+  remoteTarget?: OpenClawRemoteDeployTarget | null
+  useCase?: OpenClawUseCaseTemplate | null
+  exposure?: OpenClawExposurePreset | null
+  managedBy?: 'swarmclaw' | 'manual' | null
+  targetHost?: string | null
+  sshHost?: string | null
+  sshUser?: string | null
+  sshPort?: number | null
+  sshKeyPath?: string | null
+  sshTargetDir?: string | null
+  image?: string | null
+  version?: string | null
+  lastDeployAt?: number | null
+  lastDeployAction?: string | null
+  lastDeployProcessId?: string | null
+  lastDeploySummary?: string | null
+  lastVerifiedAt?: number | null
+  lastVerifiedOk?: boolean | null
+  lastVerifiedMessage?: string | null
+  lastBackupPath?: string | null
+}
 
 export interface GatewayProfile {
   id: string
@@ -1184,6 +1278,8 @@ export interface GatewayProfile {
   lastModelCount?: number | null
   discoveredHost?: string | null
   discoveredPort?: number | null
+  deployment?: OpenClawDeploymentConfig | null
+  stats?: OpenClawGatewayStats | null
   isDefault?: boolean
   createdAt: number
   updatedAt: number
@@ -1256,6 +1352,8 @@ export interface AgentRoutingTarget {
   fallbackCredentialIds?: string[]
   apiEndpoint?: string | null
   gatewayProfileId?: string | null
+  preferredGatewayTags?: string[]
+  preferredGatewayUseCase?: string | null
   priority?: number
 }
 
@@ -1274,6 +1372,7 @@ export interface AgentPackEntry {
   tools?: string[]
   plugins?: string[]
   capabilities?: string[]
+  elevenLabsVoiceId?: string | null
   soul?: string
   systemPrompt?: string
 }
@@ -1307,6 +1406,11 @@ export interface ExternalAgentRuntime {
   gatewayProfileId?: string | null
   capabilities?: string[]
   labels?: string[]
+  lifecycleState?: 'active' | 'draining' | 'cordoned'
+  gatewayTags?: string[]
+  gatewayUseCase?: string | null
+  version?: string | null
+  lastHealthNote?: string | null
   metadata?: Record<string, unknown> | null
   tokenStats?: {
     inputTokens?: number