`core` capability operations

core capability operations

Core runtime primitives: notify, clip, agent, HTTP, sandboxed exec, and KV

Part of the pipeline capability catalog. Index: ../capabilities.md.

agent_health

Agent subsystem health for the signed-in caller. Read-only.
Example: {}

Inputs (params):

(none)

Usage:

  - name: agent_health_step
    capability: core
    operation: agent_health

agent_run

Execute one autonomous agent turn with a prompt for the signed-in caller. Creates or updates data.
Example: {"prompt":"example"} (mutation)

Inputs (params):

Param Type Required Description
prompt string yes User prompt
uid string no Owner UID
tools []string no Tool allowlist
skills []string no Skill allowlist
memory_scope string no Memory scope; defaults to pipeline name

Usage:

  - name: agent_run_step
    capability: core
    operation: agent_run
    params:
      prompt: "..."  # required
      uid: "..."
      tools: ["..."]
      skills: ["..."]
      memory_scope: "..."

clip_create

Create a markdown clip and return its public URL for the signed-in caller. Creates or updates data.
Example: {"content":"example"} (mutation)

Inputs (params):

Param Type Required Description
content string yes Markdown body
created_by string no Optional creator identifier

Usage:

  - name: clip_create_step
    capability: core
    operation: clip_create
    params:
      content: "..."  # required
      created_by: "..."

clip_get

Get a markdown clip by slug for the signed-in caller. Read-only.
Example: {"slug":"example"}

Inputs (params):

Param Type Required Description
slug string yes Clip slug

Usage:

  - name: clip_get_step
    capability: core
    operation: clip_get
    params:
      slug: "..."  # required

clip_health

Clip subsystem health for the signed-in caller. Read-only.
Example: {}

Inputs (params):

(none)

Usage:

  - name: clip_health_step
    capability: core
    operation: clip_health

health

Core runtime health for the signed-in caller. Read-only.
Example: {}

Inputs (params):

(none)

Usage:

  - name: health_step
    capability: core
    operation: health

http_request

Perform an outbound HTTP request for the signed-in caller. Creates or updates data.
Example: {"url":"example"} (mutation)

Inputs (params):

Param Type Required Description
url string yes Request URL
method string no HTTP method (default GET)
headers map[string]any no Request headers
body string no Request body
timeout_seconds number no Timeout in seconds

Usage:

  - name: http_request_step
    capability: core
    operation: http_request
    params:
      url: "..."  # required
      method: "..."
      headers: {}
      body: "..."
      timeout_seconds: 0

kv_delete

Delete a persistent KV value for the signed-in caller. Deletes or removes data.
Example: {"namespace":"example"} (mutation)

Inputs (params):

Param Type Required Description
namespace string yes Namespace (core/ prefix applied)
key string yes Key
uid string no Owner UID; defaults to instance scope

Usage:

  - name: kv_delete_step
    capability: core
    operation: kv_delete
    params:
      namespace: "..."  # required
      key: "..."  # required
      uid: "..."

kv_get

Get a persistent KV value for the signed-in caller. Read-only.
Example: {"namespace":"example"}

Inputs (params):

Param Type Required Description
namespace string yes Namespace (core/ prefix applied)
key string yes Key
uid string no Owner UID; defaults to instance scope

Usage:

  - name: kv_get_step
    capability: core
    operation: kv_get
    params:
      namespace: "..."  # required
      key: "..."  # required
      uid: "..."

kv_set

Set a persistent KV value for the signed-in caller. Creates or updates data.
Example: {"namespace":"example"} (mutation)

Inputs (params):

Param Type Required Description
namespace string yes Namespace (core/ prefix applied)
key string yes Key
value any yes JSON-serializable value
uid string no Owner UID; defaults to instance scope
ttl_seconds number no Optional TTL

Usage:

  - name: kv_set_step
    capability: core
    operation: kv_set
    params:
      namespace: "..."  # required
      key: "..."  # required
      value: ...  # required
      uid: "..."
      ttl_seconds: 0

notify_health

Notify subsystem health for the signed-in caller. Read-only.
Example: {}

Inputs (params):

(none)

Usage:

  - name: notify_health_step
    capability: core
    operation: notify_health

notify_send

Send a notification using a template for the signed-in caller. Creates or updates data.
Example: {"template_id":"example"} (mutation)

Inputs (params):

Param Type Required Description
template_id string yes Template ID to render
channels []string yes Channels to send to
payload map[string]any no Template data payload
uid string no Owner UID; pipeline injects Event.UID when omitted

Usage:

  - name: notify_send_step
    capability: core
    operation: notify_send
    params:
      template_id: "..."  # required
      channels: ["..."]  # required
      payload: {}
      uid: "..."

run_code

Run source code in the configured workspace sandbox for the signed-in caller. Creates or updates data.
Example: {"language":"example"} (mutation)

Inputs (params):

Param Type Required Description
language string yes python or shell
code string yes Source code
filename string no Optional filename hint
workdir string no Relative workdir under workspace

Usage:

  - name: run_code_step
    capability: core
    operation: run_code
    params:
      language: "..."  # required
      code: "..."  # required
      filename: "..."
      workdir: "..."

run_terminal

Run a shell command in the configured workspace sandbox for the signed-in caller. Creates or updates data.
Example: {"command":"example"} (mutation)

Inputs (params):

Param Type Required Description
command string yes Shell command
workdir string no Relative workdir under workspace

Usage:

  - name: run_terminal_step
    capability: core
    operation: run_terminal
    params:
      command: "..."  # required
      workdir: "..."