Convex Engine

​

Why Convex

​

Convex Execution Model

​

🔐 Ownership Boundary

Ownership Boundary

Convex Owns

Workflow DefinitionsDAG ResolutionGovernance DecisionsBudget EnforcementRun History + AuditAgent Registry

🔌 Gateway Owns

Live LLM ExecutionSession StateRuntime EnvironmentAgent WorkspaceCost Reporting

​

📋 Ownership Table

​

🗂️ Schema Organization

​

⚙️ The Workflow Interpreter

1. Parse the pinned .lobsterX YAML
2. Resolve the DAG into execution layers (groups of parallelizable steps)
3. Dispatch ready steps through the governance pipeline
4. Wait for completion events (callbacks from Bridge)
5. Advance the DAG, evaluate conditions, handle failures
6. Repeat until all steps are resolved or the run fails

​

Convex-Native Agents

​

🕐 Scheduled Operations

​

🔒 Function Model

// Public query -- requires authentication
export const list = query({
  handler: async (ctx) => {
    await requireAuth(ctx);
    // ...
  },
});

// Public mutation -- requires specific permission
export const resolve = mutation({
  handler: async (ctx, args) => {
    await requirePermission(ctx, "governance:approve");
    // ...
  },
});

// Internal mutation -- called by other Convex functions only
export const create = internalMutation({
  handler: async (ctx, args) => {
    // No auth check needed -- caller is trusted
    await ctx.db.insert("approvals", { ... });
  },
});

// Internal action -- side effects, called internally
export const dispatchStep = internalAction({
  handler: async (ctx, args) => {
    // HTTP call to Bridge
  },
});