Pi Agent / Object Storage Diagnosis

S3 diagnosis agent for Pi

StorageOps turns Pi Coding Agent into an object storage specialist by installing S3 diagnostic skills, Pi extension tools, deterministic helpers, and compact eval cases.

Python · Pi Coding Agent · S3-compatible · 15 skills · 4 tools

Pi Agent package

Skills and tools define the diagnosis

StorageOps installs an object-storage diagnosis package into Pi: diagnostic skills, extension tools, deterministic helpers, and compact eval cases.

0115 diagnostic skills

Security, protocol compatibility, CLI/SDK behavior, performance, networking, lifecycle, migration, consistency, logs, notifications, and triage.

024 Pi extension tools

detect_domain · scan_secrets · search_memory · capture_http_trace

03deterministic helper scripts

Inspect policy, SigV4, payload hashes, ETags, throttling, access logs, migration estimates, and endpoint reachability.

04golden-case evals

Regression cases keep agent output stable as skills and tools evolve.

input: error, command, config, redacted logoutput: cause, evidence, confidence, next checks
15 diagnostic skills4 Pi extension toolsManaged httpmon helperGolden-case evals

A look inside

Turn Pi into a storage diagnosis agent

StorageOps is not just a guide. It installs object-storage skills, Pi extension tools, helper scripts, and eval cases so Pi can diagnose S3-compatible failures.

pi extension: storageopsskills + tools loaded
0115 diagnostic skills

Organized around auth, signing, throttling, consistency, migration, logs, and other storage domains.

024 Pi tools

detect_domain, scan_secrets, search_memory, and capture_http_trace route and gather evidence.

03deterministic helpers

Inspect SigV4, ETags, payload hashes, throttling, access logs, and endpoint reachability.

04eval cases

Golden cases keep agent behavior stable as skills and tools change.

Agent topology

Skills decide; tools collect evidence

StorageOps is not a prompt pack. It breaks Pi diagnosis into domain skills, evidence tools, deterministic helpers, and evals.

Skills15

Auth, signing, throttling, consistency, migration, logs, notifications, and more.

Tools4

detect_domain, scan_secrets, search_memory, and capture_http_trace.

Evalsgolden

Golden cases and size gates keep the agent package compact and repeatable.

What it solves

Use it when

You want Pi to diagnose S3-compatible failures such as AccessDenied, SlowDown, SignatureDoesNotMatch, checksum drift, lifecycle issues, or migration surprises.

It is not

A cloud console, storage SDK, or standalone monitoring platform. It is an agent package: skills, tools, helper scripts, and routing rules for Pi.

What you install

A Pi extension, 15 diagnostic skill packs, 4 tools for bounded evidence collection, a managed httpmon helper, deterministic scripts, and eval cases.

Skills and tools

Skill coverage

Skills cover security, protocol compatibility, CLI/SDK behavior, performance, networking, lifecycle cost, replication, migration, consistency, logs, notifications, and triage.

Pi extension tools

`scan_secrets`, `detect_domain`, `search_memory`, and `capture_http_trace` help Pi route the issue and gather redacted evidence.

Helper scripts

Deterministic scripts inspect policies, SigV4 inputs, payload hashes, ETags, throttling, access logs, migration estimates, and endpoint reachability.

Eval discipline

Golden cases, skill/eval packs, size gates, and validation targets keep the agent package compact, repeatable, and safer to change.

Why it exists

Skills and tools define the agent

Pi is the runtime. StorageOps is the object-storage expertise layer: domain-specific skills decide how to reason, while extension tools collect bounded evidence without dumping secrets into the prompt.

The product is useful because the agent has a taxonomy, tools, helper scripts, and regression cases. It is not a generic chatbot wrapper around S3 error messages.

Diagnosis flow

01

Invoke Pi

Run `storageops --print` or start an interactive Pi session with logs, errors, configs, or a short failure description.

02

Route to skills

`detect_domain` and the skill taxonomy steer Pi toward auth, signing, throttling, consistency, lifecycle, migration, or another storage domain.

03

Use tools

Pi can scan secrets, search prior sessions, or capture a sanitized HTTP trace through the managed httpmon helper.

04

Diagnose

The agent returns likely cause, confidence, evidence, next checks, and safe changes grounded in the selected skills and tool output.

Failure domains

Object storage diagnosis domains

AccessDeniedSlowDownSignatureDoesNotMatchBadDigeststale readslifecycle surprisesfailed notificationsmigration drift

StorageOps is organized around recurring S3-compatible failure domains, with skills and tools that help Pi reason inside each one.

Questions & how-to

What makes it an agent rather than a checklist?

The Pi runtime can call StorageOps tools, load domain skills, search prior sessions, and combine deterministic helper output with reasoning.

What should I paste first?

Start with the exact error, command or SDK call, endpoint style, relevant config names, and a redacted log excerpt. The skills and tools narrow the next evidence request.

When does capture_http_trace matter?

Use it when the diagnosis depends on request details hidden by a CLI or SDK: headers, redirects, retry behavior, canonical request shape, payload hashes, or provider metadata.

Bring the error, leave out the secrets

Open repository