LoomCycle Run icon

LoomCycle Run

Spawn and manage loomcycle agent runs over HTTP+SSE

LoomCycle Run

AI-generated

Summary

Spawns a LoomCycle agent run with a prompt and streams it to completion. The properties also declare other run operations (get status, wait, cancel, compact, get transcript, spawn batch, list agents) under the same resource, but this description covers Spawn.

Inputs

  • agent (required) — Agent to run, chosen from the list loaded from the loomcycle library (yaml and dynamic AgentDefs) or set by expression.
  • prompt (required) — User prompt sent to the agent. Sent as a trusted-text segment by default.
  • userId — Overrides the credential's Default User ID for this run.
  • userTier — Overrides the credential's Default User Tier for this run.
  • treatPromptAsUntrusted — If true, wraps the prompt as an untrusted block so the agent treats it as data. Use it for end-user input such as a Slack message.
  • additionalFields — Optional per-run settings: Agent ID, Session ID (continue an existing session), Allowed Hosts, Allowed Tools (comma-separated), Compaction JSON, Metadata JSON, Sampling JSON, Run Timeout (seconds), Per-Tool Credentials (template strings only), User Bearer, and Web Search Host Filter (drop or keep, only meaningful with Allowed Hosts).

Output shape

One output item per input item, built from the run's streamed events once the run ends. Expect run identifiers such as agent_id, run_id and session_id, which other operations use. The exact field layout is not visible in the provided source.

The node blocks for the full run duration. Transport and HTTP failures (auth, backpressure, busy or unknown session) are raised as errors. Failures inside the run appear as error events in the stream. Because the source is elided, the precise output shape is unconfirmed.

Examples

Example 1: Summarize an incoming Slack message with an agent while treating the text as untrusted data.

Agent: summarizer; Prompt: {{$json.text}}; Treat Prompt as Untrusted: on.

Example 2: Continue a prior conversation with a restricted tool set and a time limit.

Agent: support-bot; Additional Fields: Session ID from earlier Spawn output, Allowed Tools 'WebFetch', Run Timeout 120.

Links

Discussion