Skip to main content

Extension Probe

@swamp/extension-probev2026.11.03.1· AGPL-3.0-or-later· 18d agoBEHAVIORSACCEPTED WARNINGS
01README

Pull a swamp extension into a sandbox, describe its behavior types, and run every method blind, recording what each method did and which methods it could not get to run. This is the runtime half of an extension supply-chain review; static analysis is the other half.

Each probe builds a throwaway box: a fresh swamp repo, a fake home with planted canary credentials, and a logging stub that every tool-path argument and common command name (claude, curl, aws and more) resolves to. Every step runs under nono on Linux, confined to the box, with all network through nono's proxy so each attempt is recorded with its host. Findings use the kind: findings contract, so a reviewer can merge them with their own.

Behaviors only in v1, from the @skunk-ape and @swamp collectives.

Methods

Method What it does
probe Pull target, describe its types, and run each method in input rounds (empty, required, all, boundary) until it succeeds. Writes report-<session> and findings-<session>.
start Referee mode: open a session listing each method that never succeeded, with its last error and schema.
record Referee mode: run one gap method again in a fresh box with your inputs, optionally after other methods (before), and count the attempt.

Usage

swamp vault create local_encryption extension-probe-sandbox
swamp vault put extension-probe-sandbox SWAMP_API_KEY
swamp model create @swamp/extension-probe probe \
  --global-arg 'sandboxApiKey=${{ vault.get(extension-probe-sandbox, SWAMP_API_KEY) }}'
swamp model method run probe probe --input target=@skunk-ape/stef
swamp model method run probe start --input session=skunk-ape-stef

The key must belong to a throwaway collective with no other privileges: the extension under test can read it. Never use your own.

isolation: external skips nono for callers who already run the probe inside a sandbox they control; it needs an exact acknowledgement and reports network and sandbox checks as not observed. See the README.

02Behaviors1
@swamp/extension-probev2026.11.03.1extension_probe.ts
fn probe()
Pull an extension into a fresh sandboxed repo, describe its behavior types, and run every method blind in input rounds (empty, required, all, boundary) until each succeeds. Tool paths point at a logging stub, planted canary credentials catch misuse, and all network goes through nono's proxy. Deterministic: no model calls.
fn start()
Referee mode: open a session from a probe report, listing each method that never succeeded with its last error, description and schema. Runs nothing.
fn record()
Referee mode: run one gap method again in a fresh sandbox with the driving agent's inputs, optionally after a chain of other methods, record the outcome, and count the attempt against maxAttempts.

Resources

report(30d)— Everything the probe observed: each setup step and method run, its inputs, outcome, network attempts, file changes, stub calls and secret sightings. The sandbox key is redacted.
findings(30d)— Rule-based findings in the kind: findings contract @swamp/software-factory and @skunk-ape/stef use, so a reviewer can merge with them behind one gate.
session(30d)— Referee mode: the methods that never succeeded, the attempts made, and the next action for the driving agent.
03Stats
A
100 / 100
Downloads
4
Archive size
62.7 KB
Verified by Swamp
  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types (deprecated)1/1earned
  • Dependencies pass trust audit2/2earned
  • Docs keep secrets in a vault1/1earned
  • Has description1/1earned
  • Platform support declared (or universal)2/2earned
  • License2/2earned
  • Verified public repository2/2earned

05Platforms
06Labels