workflow-xml

name	Workflow XML
description	This skill should be used when the user asks about "workflow XML", "planner", "agent dependencies", "workflow parsing", "task orchestration", or needs to understand the workflow system in XSky.
version	1.0.0

Workflow XML in XSky

This skill provides knowledge for the workflow planning and execution system.

Workflow XML Format

<workflow name="Task Name" taskId="uuid">
  <agent name="browser" id="1">
    <task>Navigate and search</task>
  </agent>
  <agent name="llm" id="2" depends="1">
    <task>Analyze results</task>
    <input>{{agent_1_result}}</input>
  </agent>
</workflow>

Agent Attributes

Attribute	Required	Description
name	Yes	Agent type (browser, llm, file, shell)
id	Yes	Unique ID for dependencies
depends	No	Comma-separated dependency IDs

Dependency Resolution

No depends → Runs immediately
Same depends → Runs in parallel
Sequential depends → Runs in order

Example:

<!-- Agent 1: No depends - runs first -->
<agent name="browser" id="1">...</agent>

<!-- Agent 2 & 3: Both depend on 1 - run in parallel -->
<agent name="llm" id="2" depends="1">...</agent>
<agent name="llm" id="3" depends="1">...</agent>

<!-- Agent 4: Depends on 2,3 - runs after both complete -->
<agent name="file" id="4" depends="2,3">...</agent>

Variable References

<!-- Previous agent result -->
<input>{{agent_1_result}}</input>

<!-- Context variable -->
<input>{{variable_name}}</input>

<!-- User input -->
<input>{{context.user_input}}</input>

Programmatic Workflow Creation

import { buildSimpleAgentWorkflow } from "@xsky/ai-agent-core";

const workflow = buildSimpleAgentWorkflow({
  name: "My Workflow",
  agents: [
    { name: "browser", task: "Go to URL" },
    { name: "llm", task: "Analyze", dependsOnPrevious: true }
  ]
});

Manual Execution

const workflow: Workflow = {
  name: "Custom",
  taskId: uuidv4(),
  agents: [/* ... */]
};

const xsky = new XSky(config);
await xsky.initContext(workflow);
const result = await xsky.execute(workflow.taskId);

Key Source Files

File	Purpose
packages/ai-agent-core/src/core/plan.ts	Planner implementation
packages/ai-agent-core/src/common/xml.ts	XML parsing utilities
packages/ai-agent-core/src/types/core.types.ts	Core types (Workflow)
packages/ai-agent-core/src/prompt/plan.ts	Planning prompts