Skip to main content

Showcase pack

v0.2.15

Synthetic pack that demonstrates every action-schema feature in one place: all arg types, every validation, both parsers, both kinds, opts envelope bounds, and per-action redaction rules. Not a production pack — use it as a reference when authoring real ones.

5 allowed by default
Pack ID
showcase
Vendor
emisar
OS
linux
Actions
5
Required binaries. Install these on the host before relying on the pack — an action that calls a missing one fails at run time.
bash

Install

emisar pack install fetches this pack, re-validates it, and verifies its content hash against the --hash below — the exact bytes this page was rendered against, so a tampered copy is rejected — before copying it into the runner's packs dir. The command reloads a running daemon itself; no manual restart.

on the runner host
sudo emisar pack install showcase --hash sha256:84ef3e19785e5fd8ee97617340e3c2802af2819603e9a9f7bd6969e2a4f2f41f

Setup

Reference pack only — every action runs a trivial local command (echo or a bundled script) and authenticates to nothing. No env vars or credentials to provision; do not use it in production.

Verify it works

Runs showcase.every_arg_type, a low-risk read that confirms the pack can reach its target. Run it on the host once the pack is installed; pack install runs it for you.

on the runner host
sudo emisar pack verify showcase

Install and configure a pack walks through the whole sequence on a host.

Actions 5 total

View on GitHub
  • showcase.every_arg_type exec low Low — read-only or trivially reversible

    One arg of every type

    Show a reference action: one argument of every supported type with a representative validation. Look here when you need to remember the YAML shape for `string_array`, `integer_array`, `duration`, etc.

    View source on GitHub
  • showcase.json_output exec low Low — read-only or trivially reversible

    Parse stdout as JSON, with action-local redaction

    Demonstrate `parser: json` plus an extra regex redaction rule scoped to this action. The rule sits *in front of* the global rules — useful when an action emits a known secret shape that the global rules don't cover.

    View source on GitHub
  • showcase.opts_envelope exec low Low — read-only or trivially reversible

    Demonstrate opts.timeout and opts.max_stdout_bytes clamping

    Sleep briefly and emit a fixed payload. The interesting bit is the execution/output envelope: cloud-supplied opts.timeout is clamped to [2s, 30s] regardless of what the LLM asked for, and stdout caps are bounded between 1 KiB and 64 KiB.

    View source on GitHub
  • showcase.path_validation exec low Low — read-only or trivially reversible

    Read-only file inspection with path allowlist

    Show a reference action for path-typed arguments. Demonstrates allowed prefixes plus an explicit deny list. The combined effect: the caller may inspect anything under /var/log or /tmp, except /var/log/secure and anything under /tmp/private.

    View source on GitHub
  • showcase.script_action script low Low — read-only or trivially reversible

    Run a packaged shell script

    Call a packaged shell script. The interpreter is explicit (/bin/bash), the script path is resolved relative to the pack root, and the script's SHA-256 is journaled with every invocation so tampering is detectable after the fact.

    View source on GitHub