core capability actions

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

Part of the workflow capability catalog. Result envelope and usage patterns: ../capabilities.md.

capability:core.agent_health

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

Inputs (params):

(none)

Outputs: InvokeResult JSON (see ../capabilities.md). Read domain fields under data; use text when present.

Usage:

  - id: agent_health_step
    action: capability:core.agent_health

capability:core.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):

Outputs: InvokeResult JSON (see ../capabilities.md). Read domain fields under data; use text when present.

Usage:

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

capability:core.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):

Outputs: InvokeResult JSON (see ../capabilities.md). Read domain fields under data; use text when present.

Usage:

  - id: clip_create_step
    action: capability:core.clip_create
    params:
      content: "..."  # required
      created_by: "..."

capability:core.clip_get

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

Inputs (params):

Outputs: InvokeResult JSON (see ../capabilities.md). Read domain fields under data; use text when present.

Usage:

  - id: clip_get_step
    action: capability:core.clip_get
    params:
      slug: "..."  # required

capability:core.clip_health

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

Inputs (params):

(none)

Outputs: InvokeResult JSON (see ../capabilities.md). Read domain fields under data; use text when present.

Usage:

  - id: clip_health_step
    action: capability:core.clip_health

capability:core.health

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

Inputs (params):

(none)

Outputs: InvokeResult JSON (see ../capabilities.md). Read domain fields under data; use text when present.

Usage:

  - id: health_step
    action: capability:core.health

capability:core.http_request

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

Inputs (params):

Outputs: InvokeResult JSON (see ../capabilities.md). Read domain fields under data; use text when present.

Usage:

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

capability:core.kv_delete

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

Inputs (params):

Outputs: InvokeResult JSON (see ../capabilities.md). Read domain fields under data; use text when present.

Usage:

  - id: kv_delete_step
    action: capability:core.kv_delete
    params:
      namespace: "..."  # required
      key: "..."  # required
      uid: "..."

capability:core.kv_get

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

Inputs (params):

Outputs: InvokeResult JSON (see ../capabilities.md). Read domain fields under data; use text when present.

Usage:

  - id: kv_get_step
    action: capability:core.kv_get
    params:
      namespace: "..."  # required
      key: "..."  # required
      uid: "..."

capability:core.kv_set

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

Inputs (params):

Outputs: InvokeResult JSON (see ../capabilities.md). Read domain fields under data; use text when present.

Usage:

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

capability:core.notify_health

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

Inputs (params):

(none)

Outputs: InvokeResult JSON (see ../capabilities.md). Read domain fields under data; use text when present.

Usage:

  - id: notify_health_step
    action: capability:core.notify_health

capability:core.notify_send

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

Inputs (params):

Outputs: InvokeResult JSON (see ../capabilities.md). Read domain fields under data; use text when present.

Usage:

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

capability:core.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):

Outputs: InvokeResult JSON (see ../capabilities.md). Read domain fields under data; use text when present.

Usage:

  - id: run_code_step
    action: capability:core.run_code
    params:
      language: "..."  # required
      code: "..."  # required
      filename: "..."
      workdir: "..."

capability:core.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):

Outputs: InvokeResult JSON (see ../capabilities.md). Read domain fields under data; use text when present.

Usage:

  - id: run_terminal_step
    action: capability:core.run_terminal
    params:
      command: "..."  # required
      workdir: "..."