agentic-pi 0.2.4 → 0.2.6

package/README.md

@@ -293,6 +293,158 @@ built-in `find`/`grep`.
 When disabled or unavailable, `status: "skipped"` carries a `reason` of
 `disabled-by-flag` or `resolve-failed`.
 
+### 10. Optional OpenTelemetry export via `--otel`
+
+agentic-pi can export **traces and metrics** for its run to any OTLP-compatible
+collector, using the standard OpenTelemetry JS SDK and the standard `OTEL_*`
+environment variables. This is meant for orchestrators (e.g. lastlight) that
+forward `OTEL_*` config into a sandboxed agentic-pi process so Pi's own activity
+shows up in their observability stack.
+
+**Off unless explicitly enabled.** Enablement precedence (highest first):
+
+1. `--no-otel` → force-disabled (wins over everything).
+2. `--otel` → enabled.
+3. env `AGENTIC_PI_OTEL_ENABLED=1` (when neither flag is passed) → enabled.
+4. otherwise → disabled.
+
+A bare `OTEL_EXPORTER_OTLP_ENDPOINT` does **not** enable telemetry on its own —
+enablement is always intentional. Configure the destination with the usual
+`OTEL_EXPORTER_OTLP_ENDPOINT` / `OTEL_EXPORTER_OTLP_HEADERS` /
+`OTEL_EXPORTER_OTLP_TRACES_ENDPOINT` (etc.) variables, or `--otel-endpoint` as a
+base-URL escape hatch.
+
+**Span tree** (one-shot run → a short-lived root span is correct):
+
+```
+agentic_pi.session                 (root; gen_ai.conversation.id = sessionId)
+└── agentic_pi.turn
+    ├── chat <model>               (per assistant message; tokens, cost, finish reason)
+    └── execute_tool <name>        (per tool call; status, duration)
+```
+
+**Metrics**: `gen_ai.client.token.usage`, `gen_ai.client.operation.duration`,
+`agentic_pi.cost.usd`, `agentic_pi.tool.duration`, `agentic_pi.tool.invocations`,
+`agentic_pi.tool.failures`, `agentic_pi.turns`. Attribute names follow the OTEL
+GenAI semantic conventions where stable, namespaced under `agentic_pi.*` otherwise.
+
+**Metadata-only by default.** Raw prompt/message/tool-result content is **never**
+exported unless you pass `--otel-include-content` (or set
+`AGENTIC_PI_OTEL_INCLUDE_CONTENT=1`), in which case content is bounded and
+truncated. Metric dimensions are always metadata (bounded cardinality).
+
+**Trace correlation.** If a W3C `TRACEPARENT` env var is present, the session
+span is parented to it, so a sandboxed agentic-pi run correlates with the
+caller's trace across the process/container boundary.
+
+**Safe by default.** Telemetry never affects the run's exit code, never writes to
+stdout/stderr (SDK diagnostics route to the warning channel), and degrades to a
+warning if the collector is unreachable. When requested, a final
+`extension_status` event mirrors the others:
+
+```jsonl
+{"type":"extension_status","extension":"telemetry","status":"configured","includeContent":false,"sessionId":"…","timestamp":"…"}
+```
+
+A silent default run (no `--otel`) emits no telemetry event at all.
+
+```bash
+# Export to a local collector (e.g. otel-desktop-viewer, Jaeger, Grafana Alloy)
+echo "summarize the repo" | OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318 \
+  node dist/cli.js run --model openai/gpt-5.4-nano --otel --no-session
+```
+
+### 11. Agent skills (`SKILL.md`)
+
+Pi natively implements the [Agent Skills standard](https://agentskills.io) — the
+same `SKILL.md`-in-a-folder convention used by Claude Code and Codex — and
+agentic-pi exposes it. A **skill** is a directory containing a `SKILL.md` with YAML
+frontmatter (`name` + `description`) and freeform instructions, plus any helper
+scripts/references it needs:
+
+```
+roll-dice/
+└── SKILL.md
+```
+
+```markdown
+---
+name: roll-dice
+description: Roll an N-sided die. Use when asked to roll a die or dice.
+---
+
+# Roll Dice
+
+Run `echo $((RANDOM % <sides> + 1))`, replacing `<sides>` with the die size.
+```
+
+**Progressive disclosure.** At startup Pi scans the skill locations and puts only
+each skill's `name` + `description` into the system prompt. When a task matches, the
+agent `read`s the full `SKILL.md` on demand, then loads any referenced scripts/assets
+by relative path. This keeps the prompt small while making many skills available.
+
+**Default locations — already discovered, no flag needed.** Drop a skill into any of:
+
+- Global: `~/.pi/agent/skills/`, `~/.agents/skills/`
+- Project (cwd + ancestors to git root): `.pi/skills/`, `.agents/skills/`
+- Packages: a `skills/` directory or `pi.skills` entry in a dependency's `package.json`
+
+**Mapping an existing skills folder via `--skill`.** To use skills you already keep
+elsewhere — e.g. your Claude Code skills, or a directory mounted into a CI container —
+point at it with `--skill <path>` (repeatable; accepts a directory of skills or a
+single skill). It's **additive even with `--no-skills`**:
+
+```bash
+# Map your Claude Code skills directory straight into the agent
+echo "use the roll-dice skill to roll a d20" | node dist/cli.js run \
+  --model openai/gpt-5.4-nano --no-session --skill ~/.claude/skills
+
+# Load ONLY an explicit folder; suppress all default discovery
+... --no-skills --skill ./ci-skills
+
+# Turn skills off entirely
+... --no-skills
+```
+
+Programmatic callers pass `skillPaths: string[]` / `noSkills: boolean` to `run()`.
+
+**Cross-harness reuse via settings.** Instead of a flag on every run, list skill
+directories in a Pi `settings.json` (under the agent dir) so they always load:
+
+```json
+{
+  "skills": ["~/.claude/skills", "~/.codex/skills"]
+}
+```
+
+**One-shot caveat.** agentic-pi has no interactive mode, so Pi's `/skill:name` slash
+command doesn't apply here — skills are **model-invoked** from the catalog. If the
+model doesn't pick up a skill on its own, name it in the prompt ("use the `roll-dice`
+skill …") to nudge it to load the `SKILL.md`.
+
+**Safe by default.** A `--skill` path that doesn't exist is dropped with a warning
+rather than aborting the run. Skills are a Pi-native *resource* (fed to the resource
+loader), not agentic-pi tools, so they don't appear in the `extension_status` events.
+
+**Observability.** Pi emits no skill-specific event, and skill *usage* only shows up
+indirectly — when the agent loads a skill it `read`s the `SKILL.md`, so it surfaces as
+a normal `tool_execution_start`/`_end` whose `args.path` ends in `SKILL.md`. To make
+*discovery* visible, agentic-pi synthesizes a single `skills_status` event at startup:
+
+```jsonl
+{"type":"skills_status","status":"configured","discovered":2,"skills":[{"name":"roll-dice","source":"/abs/roll-dice/SKILL.md","modelInvocable":true}],"mappedPaths":["/abs/skills"],"noSkills":false,"sessionId":"…","timestamp":"…"}
+```
+
+`status` is `default` (no flags), `configured` (`--skill` paths resolved), or
+`disabled` (`--no-skills`). `modelInvocable` is `false` for skills that set
+`disable-model-invocation: true` (present but never auto-loaded). The event is
+**gated**: a default run that discovers no skills emits nothing, so the golden JSONL
+fixtures stay byte-identical. Programmatic callers read the same data from
+`result.skills`.
+
+> **Security:** a skill can instruct the model to take any action and may bundle code
+> the model runs. Only map skill directories you trust.
+
 ## When to use this
 
 - You have an orchestrator that calls a coding agent once per workflow
@@ -357,7 +509,14 @@ GITHUB_TOKEN=ghp_…
 | `--no-web-search` | Disable the web-search extension (no `web_search`/`web_fetch` tools). |
 | `--no-file-search` | Disable the bundled FFF file-search extension; fall back to Pi's built-in `find`/`grep`. |
 | `--file-search-mode <m>` | FFF mode: `override` (default) \| `tools-only` \| `tools-and-ui`. Overridden by the `PI_FFF_MODE` env var. See section 9. |
+| `--skill <path>` | Load Agent Skills from `<path>` (a skills dir or a single skill). Repeatable; additive even with `--no-skills`. Maps e.g. `~/.claude/skills` into the agent. Default-location skills load without this. See section 11. |
+| `--no-skills` | Disable Pi's default skill discovery. Explicit `--skill` paths still load. |
 | `--web-search-max-calls <n>` | Cap combined `web_search` + `web_fetch` calls per run. Default: 30. |
+| `--otel` | Enable OpenTelemetry traces + metrics export. Off by default. Requires an OTLP endpoint via `OTEL_EXPORTER_OTLP_ENDPOINT` (or `--otel-endpoint`). See section 10. |
+| `--no-otel` | Force-disable OTEL even if `AGENTIC_PI_OTEL_ENABLED=1`. |
+| `--otel-include-content` | Attach prompt/message/tool content to spans (bounded + truncated). Default: metadata-only. |
+| `--otel-service-name <n>` | Override `OTEL_SERVICE_NAME` (default: `agentic-pi`). |
+| `--otel-endpoint <url>` | Override `OTEL_EXPORTER_OTLP_ENDPOINT` base URL. |
 
 Reads the prompt from stdin. Emits JSONL on stdout. Exits 0 on `agent_end`,
 1 on fatal error.
@@ -370,6 +529,7 @@ Reads the prompt from stdin. Emits JSONL on stdout. Exits 0 on `agent_end`,
 {"type":"extension_status","extension":"github","status":"configured","profile":"read","toolCount":18,"sessionId":"<uuid>","timestamp":"…"}
 {"type":"extension_status","extension":"web-search","status":"configured","provider":"tavily","toolCount":2,"maxCalls":30,"sessionId":"<uuid>","timestamp":"…"}
 {"type":"extension_status","extension":"file-search","status":"configured","mode":"override","toolCount":3,"sessionId":"<uuid>","timestamp":"…"}
+{"type":"skills_status","status":"configured","discovered":1,"skills":[{"name":"roll-dice","source":"…/SKILL.md","modelInvocable":true}],"mappedPaths":["…"],"noSkills":false,"sessionId":"<uuid>","timestamp":"…"}
 {"type":"agent_start","sessionId":"<uuid>","timestamp":"…"}
 {"type":"turn_start","sessionId":"<uuid>","timestamp":"…"}
 {"type":"message_start","message":{…},"sessionId":"<uuid>","timestamp":"…"}
@@ -383,8 +543,10 @@ Reads the prompt from stdin. Emits JSONL on stdout. Exits 0 on `agent_end`,
 ```
 
 `extension_status` is emitted once at startup so downstream logs can confirm
-the GitHub profile (and whether auth succeeded). `usage_snapshot` is always
-the last line in a successful run.
+the GitHub profile (and whether auth succeeded). `skills_status` is emitted once
+at startup too, but **only** when skills were configured or discovered (section 11) —
+a default run with no skills omits it entirely. `usage_snapshot` is always the last
+line in a successful run.
 
 ## Programmatic usage
 
@@ -451,6 +613,7 @@ console.log(result.records.length);      // full event log
 | `github` | `{status, reason, profile, toolCount}` \| `undefined` | Mirror of the GitHub `extension_status` event. |
 | `webSearch` | `{status, reason, provider, toolCount, maxCalls}` \| `undefined` | Mirror of the web-search `extension_status` event. |
 | `fileSearch` | `{status, reason, mode, toolCount}` \| `undefined` | Mirror of the FFF file-search `extension_status` event. |
+| `skills` | `{status, discovered, skills: {name, source, modelInvocable}[], mappedPaths, noSkills}` \| `undefined` | Mirror of the `skills_status` event. Absent when none configured/discovered (section 11). |
 | `records` | `EmitterRecord[]` | Every JSONL record in order. Same shape that the CLI writes. |
 | `warnings` | `string[]` | Warnings that would have gone to stderr in CLI mode. |
 

package/dist/args.d.ts

@@ -87,6 +87,38 @@ export interface RunConfig {
      * the same names). Set via `--file-search-mode <override|tools-only|tools-and-ui>`.
      */
     fileSearchMode?: "override" | "tools-only" | "tools-and-ui";
+    /**
+     * Extra Agent Skill paths to load, beyond Pi's default discovery
+     * (~/.pi/agent/skills, ~/.agents/skills, .pi/skills, .agents/skills,
+     * package skills/). Each entry is a directory of skills OR a single skill
+     * dir/file. Set via `--skill <path>` (repeatable). Additive even with
+     * --no-skills.
+     */
+    skillPaths?: string[];
+    /**
+     * Disable Pi's default skill discovery. Explicit --skill paths still load.
+     * Set via `--no-skills`. Default: discovery enabled (Pi's default).
+     */
+    noSkills?: boolean;
+    /**
+     * OpenTelemetry traces + metrics export. Tri-state:
+     *   - `true`  (`--otel`)    → enabled.
+     *   - `false` (`--no-otel`) → force-disabled (wins over env).
+     *   - `undefined` (unset)   → enabled iff env AGENTIC_PI_OTEL_ENABLED is truthy.
+     * Off by default. Requires an OTLP endpoint via OTEL_EXPORTER_OTLP_ENDPOINT
+     * (or `--otel-endpoint`). Standard OTEL_* env vars are honored by the SDK.
+     */
+    otel?: boolean;
+    /**
+     * Export raw prompt/message/tool content on spans (bounded + truncated).
+     * Default: false (metadata-only). Set via `--otel-include-content` or env
+     * AGENTIC_PI_OTEL_INCLUDE_CONTENT.
+     */
+    otelIncludeContent?: boolean;
+    /** Override OTEL_SERVICE_NAME (default: "agentic-pi"). */
+    otelServiceName?: string;
+    /** Override OTEL_EXPORTER_OTLP_ENDPOINT (escape hatch; prefer the env var). */
+    otelEndpoint?: string;
 }
 export declare function printHelp(): void;
 export declare function parseArgs(argv: string[]): RunConfig;

package/dist/args.js

@@ -48,6 +48,25 @@ Flags:
   --file-search-mode <m>     FFF mode: override | tools-only | tools-and-ui.
                               Default: override (FFF replaces built-in find/grep
                               under the same names). Overridden by PI_FFF_MODE env.
+  --skill <path>             Load Agent Skills from <path> (a directory of
+                              skills or a single skill). Repeatable. Additive
+                              even with --no-skills. Maps e.g. ~/.claude/skills
+                              into the agent. Skills in Pi's default locations
+                              (.pi/skills, .agents/skills, ~/.pi/agent/skills)
+                              are discovered automatically without this flag.
+  --no-skills                Disable Pi's default skill discovery. Explicit
+                              --skill paths still load.
+  --otel                     Enable OpenTelemetry traces + metrics export.
+                              Off by default. Requires an OTLP endpoint via
+                              OTEL_EXPORTER_OTLP_ENDPOINT (or --otel-endpoint).
+                              Honors standard OTEL_* env vars. Can also be
+                              enabled with AGENTIC_PI_OTEL_ENABLED=1.
+  --no-otel                  Force-disable OTEL even if AGENTIC_PI_OTEL_ENABLED
+                              is set (highest precedence).
+  --otel-include-content     Attach prompt/message/tool content to spans
+                              (bounded + truncated). Default: metadata-only.
+  --otel-service-name <n>    Override OTEL_SERVICE_NAME (default: agentic-pi).
+  --otel-endpoint <url>      Override OTEL_EXPORTER_OTLP_ENDPOINT base URL.
   --sandbox-image <name>     Image to boot when --sandbox=gondolin. Values:
                               'default' (recommended) — bundled agentic-pi-dev image
                                 with git/gh/node/python/rust baked in (auto-downloaded).
@@ -185,6 +204,16 @@ export function parseArgs(argv) {
             case "--no-file-search":
                 config.fileSearch = false;
                 break;
+            case "--skill": {
+                const v = next().trim();
+                if (!v)
+                    throw new Error("--skill requires a non-empty path");
+                config.skillPaths = [...(config.skillPaths ?? []), v];
+                break;
+            }
+            case "--no-skills":
+                config.noSkills = true;
+                break;
             case "--file-search-mode": {
                 const v = next();
                 if (v !== "override" && v !== "tools-only" && v !== "tools-and-ui") {
@@ -193,6 +222,29 @@ export function parseArgs(argv) {
                 config.fileSearchMode = v;
                 break;
             }
+            case "--otel":
+                config.otel = true;
+                break;
+            case "--no-otel":
+                config.otel = false;
+                break;
+            case "--otel-include-content":
+                config.otelIncludeContent = true;
+                break;
+            case "--otel-service-name": {
+                const v = next().trim();
+                if (!v)
+                    throw new Error("--otel-service-name requires a value");
+                config.otelServiceName = v;
+                break;
+            }
+            case "--otel-endpoint": {
+                const v = next().trim();
+                if (!v)
+                    throw new Error("--otel-endpoint requires a value");
+                config.otelEndpoint = v;
+                break;
+            }
             case "-h":
             case "--help":
                 printHelp();

package/dist/args.js.map

@@ -1 +1 @@
-{"version":3,"file":"args.js","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAsHH,MAAM,UAAU,SAAS;IACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuEtB,CAAC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAc;IACtC,MAAM,MAAM,GAAc;QACxB,KAAK,EAAE,EAAE;QACT,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;QAClB,SAAS,EAAE,KAAK;QAChB,cAAc,EAAE,KAAK;QACrB,0BAA0B,EAAE,KAAK;QACjC,OAAO,EAAE,MAAM;QACf,SAAS,EAAE,IAAI;QACf,UAAU,EAAE,IAAI;KACjB,CAAC;IAEF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,MAAM,IAAI,GAAG,GAAW,EAAE;YACxB,MAAM,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YACpB,IAAI,CAAC,KAAK,SAAS;gBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,GAAG,mBAAmB,CAAC,CAAC;YACrE,OAAO,CAAC,CAAC;QACX,CAAC,CAAC;QACF,QAAQ,GAAG,EAAE,CAAC;YACZ,KAAK,SAAS,CAAC;YACf,KAAK,IAAI;gBACP,MAAM,CAAC,KAAK,GAAG,IAAI,EAAE,CAAC;gBACtB,MAAM;YACR,KAAK,YAAY,CAAC;YAClB,KAAK,WAAW,CAAC,CAAC,CAAC;gBACjB,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC;gBACjB,IAAI,CAAC,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;oBACtE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,EAAE,CAAC,CAAC;gBACpD,CAAC;gBACD,MAAM,CAAC,QAAQ,GAAG,CAA0B,CAAC;gBAC7C,MAAM;YACR,CAAC;YACD,KAAK,WAAW;gBACd,MAAM,CAAC,OAAO,GAAG,IAAI,EAAE,CAAC;gBACxB,MAAM;YACR,KAAK,OAAO;gBACV,MAAM,CAAC,GAAG,GAAG,IAAI,EAAE,CAAC;gBACpB,MAAM;YACR,KAAK,cAAc;gBACjB,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC;gBACxB,MAAM;YACR,KAAK,eAAe;gBAClB,MAAM,CAAC,UAAU,GAAG,IAAI,EAAE,CAAC;gBAC3B,MAAM;YACR,KAAK,oBAAoB;gBACvB,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC;gBAC7B,MAAM;YACR,KAAK,SAAS;gBACZ,MAAM,CAAC,KAAK,GAAG,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gBACtE,MAAM;YACR,KAAK,gCAAgC;gBACnC,MAAM,CAAC,0BAA0B,GAAG,IAAI,CAAC;gBACzC,MAAM;YACR,KAAK,WAAW,CAAC,CAAC,CAAC;gBACjB,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC;gBACjB,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,UAAU,EAAE,CAAC;oBACrC,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,8BAA8B,CAAC,CAAC;gBACzE,CAAC;gBACD,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC;gBACnB,MAAM;YACR,CAAC;YACD,KAAK,iBAAiB,CAAC,CAAC,CAAC;gBACvB,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC;gBACjB,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACnB,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;gBAChE,CAAC;gBACD,MAAM,CAAC,YAAY,GAAG,CAAC,CAAC;gBACxB,MAAM;YACR,CAAC;YACD,KAAK,eAAe,CAAC,CAAC,CAAC;gBACrB,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC;gBACjB,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBAC1B,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;oBACX,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,IAAI,CAAC,CAAC;gBAChE,CAAC;gBACD,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC3B,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;gBAC5B,IAAI,CAAC,0BAA0B,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC1C,MAAM,IAAI,KAAK,CAAC,6DAA6D,GAAG,IAAI,CAAC,CAAC;gBACxF,CAAC;gBACD,MAAM,CAAC,UAAU,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC;gBACjE,MAAM;YACR,CAAC;YACD,KAAK,cAAc,CAAC,CAAC,CAAC;gBACpB,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;gBACxB,IAAI,CAAC,CAAC;oBAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;gBAClE,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;oBAClC,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,IAAI,CAAC,CAAC;gBACtE,CAAC;gBACD,gEAAgE;gBAChE,gEAAgE;gBAChE,+DAA+D;gBAC/D,gEAAgE;gBAChE,kEAAkE;gBAClE,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC;gBAClF,MAAM,CAAC,gBAAgB,GAAG,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC;gBACtC,MAAM;YACR,CAAC;YACD,KAAK,cAAc;gBACjB,MAAM,CAAC,gBAAgB,GAAG,IAAI,CAAC;gBAC/B,MAAM;YACR,KAAK,iBAAiB;gBACpB,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC;gBACzB,MAAM;YACR,KAAK,uBAAuB,CAAC,CAAC,CAAC;gBAC7B,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;gBACxB,IAAI,CAAC,CAAC;oBAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;gBAClE,MAAM,CAAC,iBAAiB,GAAG,CAAC,CAAC;gBAC7B,MAAM;YACR,CAAC;YACD,KAAK,wBAAwB,CAAC,CAAC,CAAC;gBAC9B,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC;gBACjB,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;gBACpB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;oBACxD,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,IAAI,CAAC,CAAC;gBACpF,CAAC;gBACD,MAAM,CAAC,iBAAiB,GAAG,CAAC,CAAC;gBAC7B,MAAM;YACR,CAAC;YACD,KAAK,kBAAkB;gBACrB,MAAM,CAAC,UAAU,GAAG,KAAK,CAAC;gBAC1B,MAAM;YACR,KAAK,SAAS,CAAC,CAAC,CAAC;gBACf,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;gBACxB,IAAI,CAAC,CAAC;oBAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;gBAC7D,MAAM,CAAC,UAAU,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;gBACtD,MAAM;YACR,CAAC;YACD,KAAK,aAAa;gBAChB,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC;gBACvB,MAAM;YACR,KAAK,oBAAoB,CAAC,CAAC,CAAC;gBAC1B,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC;gBACjB,IAAI,CAAC,KAAK,UAAU,IAAI,CAAC,KAAK,YAAY,IAAI,CAAC,KAAK,cAAc,EAAE,CAAC;oBACnE,MAAM,IAAI,KAAK,CACb,+BAA+B,CAAC,mDAAmD,CACpF,CAAC;gBACJ,CAAC;gBACD,MAAM,CAAC,cAAc,GAAG,CAAC,CAAC;gBAC1B,MAAM;YACR,CAAC;YACD,KAAK,QAAQ;gBACX,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;gBACnB,MAAM;YACR,KAAK,WAAW;gBACd,MAAM,CAAC,IAAI,GAAG,KAAK,CAAC;gBACpB,MAAM;YACR,KAAK,wBAAwB;gBAC3B,MAAM,CAAC,kBAAkB,GAAG,IAAI,CAAC;gBACjC,MAAM;YACR,KAAK,qBAAqB,CAAC,CAAC,CAAC;gBAC3B,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;gBACxB,IAAI,CAAC,CAAC;oBAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;gBAChE,MAAM,CAAC,eAAe,GAAG,CAAC,CAAC;gBAC3B,MAAM;YACR,CAAC;YACD,KAAK,iBAAiB,CAAC,CAAC,CAAC;gBACvB,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;gBACxB,IAAI,CAAC,CAAC;oBAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;gBAC5D,MAAM,CAAC,YAAY,GAAG,CAAC,CAAC;gBACxB,MAAM;YACR,CAAC;YACD,KAAK,IAAI,CAAC;YACV,KAAK,QAAQ;gBACX,SAAS,EAAE,CAAC;gBACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB;gBACE,MAAM,IAAI,KAAK,CAAC,iBAAiB,GAAG,EAAE,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAC3E,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,uCAAuC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC;IAC1E,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/extensions/skills/index.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Skills resource entry point.
+ *
+ * Pi implements the Agent Skills standard (https://agentskills.io) natively:
+ * a skill is a directory with a `SKILL.md` (frontmatter `name` + `description`
+ * + instructions). Pi's resource loader discovers skills from default
+ * locations (~/.pi/agent/skills, ~/.agents/skills, project .pi/skills,
+ * .agents/skills, and package `skills/` dirs) and surfaces them to the agent
+ * via progressive disclosure — only names/descriptions are always in context;
+ * the agent `read`s the full SKILL.md on demand.
+ *
+ * Unlike `github`/`web-search`, skills are NOT `customTools`. They're a
+ * Pi-native resource fed to `DefaultResourceLoader` via `additionalSkillPaths`
+ * / `noSkills` (the same channel file-search uses for `additionalExtensionPaths`).
+ * This module's only job is to normalize the operator's `--skill` paths
+ * (tilde + relative → absolute, drop missing ones) so the runner can hand
+ * them straight to the loader.
+ *
+ * Safe-by-default like every other extension: a path that doesn't exist is
+ * dropped with a warning rather than aborting the run.
+ */
+export interface SkillsConfig {
+    /**
+     * Extra skill paths from `--skill <path>` (repeatable). Each entry is a
+     * directory of skills OR a single skill directory/file. Additive even when
+     * `noSkills` is true.
+     */
+    skillPaths?: string[];
+    /** When true, disable Pi's default skill discovery. Explicit paths still load. */
+    noSkills?: boolean;
+    /** Working directory, for resolving relative `--skill` paths. */
+    cwd: string;
+    /** Home directory for `~` expansion. Injectable for tests; default os.homedir(). */
+    home?: string;
+}
+export interface SkillsResult {
+    /**
+     * - "default"    — no flags; rely on Pi's default discovery.
+     * - "configured" — at least one explicit `--skill` path resolved.
+     * - "disabled"   — `--no-skills` with no explicit paths that resolved.
+     */
+    status: "default" | "configured" | "disabled";
+    /** Resolved, existence-checked absolute paths for `additionalSkillPaths`. */
+    additionalSkillPaths: string[];
+    /** Pass-through for `DefaultResourceLoader.noSkills`. */
+    noSkills: boolean;
+    /** Non-fatal issues (e.g. a `--skill` path that doesn't exist). */
+    warnings: string[];
+}
+/** One discovered skill, flattened for the `skills_status` JSONL event. */
+export interface SkillSummary {
+    /** Skill name (from SKILL.md frontmatter). */
+    name: string;
+    /** Absolute path to the skill's SKILL.md. */
+    source: string;
+    /**
+     * Whether the model can auto-invoke it. False when the skill set
+     * `disable-model-invocation: true` (hidden from the system prompt) — worth
+     * surfacing since such a skill is present but won't be picked up on its own.
+     */
+    modelInvocable: boolean;
+}
+export interface SkillsStatusEvent {
+    type: "skills_status";
+    status: SkillsResult["status"];
+    /** Number of skills the resource loader actually discovered. */
+    discovered: number;
+    skills: SkillSummary[];
+    /** Operator-mapped `--skill` paths that resolved (echoed for observability). */
+    mappedPaths: string[];
+    noSkills: boolean;
+}
+/**
+ * Build the `skills_status` event, or null when it should be suppressed.
+ *
+ * Gated so a default run (no skill flags) in a clean environment (no skills
+ * discovered) emits nothing — keeping the golden `test/fixtures/*.jsonl`
+ * byte-identical (AGENTS.md rule #2). It surfaces only when the operator
+ * opted in via `--skill`/`--no-skills` (status !== "default") OR at least one
+ * skill was actually discovered.
+ */
+export declare function buildSkillsStatusEvent(result: SkillsResult, discovered: SkillSummary[]): SkillsStatusEvent | null;
+export declare function loadSkillsExtension(config: SkillsConfig): SkillsResult;

package/dist/extensions/skills/index.js

@@ -0,0 +1,84 @@
+/**
+ * Skills resource entry point.
+ *
+ * Pi implements the Agent Skills standard (https://agentskills.io) natively:
+ * a skill is a directory with a `SKILL.md` (frontmatter `name` + `description`
+ * + instructions). Pi's resource loader discovers skills from default
+ * locations (~/.pi/agent/skills, ~/.agents/skills, project .pi/skills,
+ * .agents/skills, and package `skills/` dirs) and surfaces them to the agent
+ * via progressive disclosure — only names/descriptions are always in context;
+ * the agent `read`s the full SKILL.md on demand.
+ *
+ * Unlike `github`/`web-search`, skills are NOT `customTools`. They're a
+ * Pi-native resource fed to `DefaultResourceLoader` via `additionalSkillPaths`
+ * / `noSkills` (the same channel file-search uses for `additionalExtensionPaths`).
+ * This module's only job is to normalize the operator's `--skill` paths
+ * (tilde + relative → absolute, drop missing ones) so the runner can hand
+ * them straight to the loader.
+ *
+ * Safe-by-default like every other extension: a path that doesn't exist is
+ * dropped with a warning rather than aborting the run.
+ */
+import { existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { isAbsolute, resolve } from "node:path";
+/** Expand a leading `~` and resolve to an absolute path against `cwd`. */
+function resolveSkillPath(raw, cwd, home) {
+    let p = raw;
+    if (p === "~") {
+        p = home;
+    }
+    else if (p.startsWith("~/")) {
+        p = resolve(home, p.slice(2));
+    }
+    return isAbsolute(p) ? p : resolve(cwd, p);
+}
+/**
+ * Build the `skills_status` event, or null when it should be suppressed.
+ *
+ * Gated so a default run (no skill flags) in a clean environment (no skills
+ * discovered) emits nothing — keeping the golden `test/fixtures/*.jsonl`
+ * byte-identical (AGENTS.md rule #2). It surfaces only when the operator
+ * opted in via `--skill`/`--no-skills` (status !== "default") OR at least one
+ * skill was actually discovered.
+ */
+export function buildSkillsStatusEvent(result, discovered) {
+    if (result.status === "default" && discovered.length === 0)
+        return null;
+    return {
+        type: "skills_status",
+        status: result.status,
+        discovered: discovered.length,
+        skills: discovered,
+        mappedPaths: result.additionalSkillPaths,
+        noSkills: result.noSkills,
+    };
+}
+export function loadSkillsExtension(config) {
+    const home = config.home ?? homedir();
+    const noSkills = config.noSkills === true;
+    const warnings = [];
+    const additionalSkillPaths = [];
+    for (const raw of config.skillPaths ?? []) {
+        const abs = resolveSkillPath(raw, config.cwd, home);
+        if (!existsSync(abs)) {
+            // Non-fatal: an operator pointed at a folder that isn't there. Drop it
+            // and warn rather than failing the run (safe-by-default).
+            warnings.push(`skill path not found, ignoring: ${raw}`);
+            continue;
+        }
+        additionalSkillPaths.push(abs);
+    }
+    let status;
+    if (additionalSkillPaths.length > 0) {
+        status = "configured";
+    }
+    else if (noSkills) {
+        status = "disabled";
+    }
+    else {
+        status = "default";
+    }
+    return { status, additionalSkillPaths, noSkills, warnings };
+}
+//# sourceMappingURL=index.js.map

package/dist/extensions/skills/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/extensions/skills/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgChD,0EAA0E;AAC1E,SAAS,gBAAgB,CAAC,GAAW,EAAE,GAAW,EAAE,IAAY;IAC9D,IAAI,CAAC,GAAG,GAAG,CAAC;IACZ,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;QACd,CAAC,GAAG,IAAI,CAAC;IACX,CAAC;SAAM,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;AAC7C,CAAC;AA2BD;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAAoB,EACpB,UAA0B;IAE1B,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACxE,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,UAAU,EAAE,UAAU,CAAC,MAAM;QAC7B,MAAM,EAAE,UAAU;QAClB,WAAW,EAAE,MAAM,CAAC,oBAAoB;QACxC,QAAQ,EAAE,MAAM,CAAC,QAAQ;KAC1B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAAoB;IACtD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,OAAO,EAAE,CAAC;IACtC,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,KAAK,IAAI,CAAC;IAC1C,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,oBAAoB,GAAa,EAAE,CAAC;IAE1C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,UAAU,IAAI,EAAE,EAAE,CAAC;QAC1C,MAAM,GAAG,GAAG,gBAAgB,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACpD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACrB,uEAAuE;YACvE,0DAA0D;YAC1D,QAAQ,CAAC,IAAI,CAAC,mCAAmC,GAAG,EAAE,CAAC,CAAC;YACxD,SAAS;QACX,CAAC;QACD,oBAAoB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC;IAED,IAAI,MAA8B,CAAC;IACnC,IAAI,oBAAoB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpC,MAAM,GAAG,YAAY,CAAC;IACxB,CAAC;SAAM,IAAI,QAAQ,EAAE,CAAC;QACpB,MAAM,GAAG,UAAU,CAAC;IACtB,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,SAAS,CAAC;IACrB,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,oBAAoB,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;AAC9D,CAAC"}

package/dist/run.d.ts

@@ -101,6 +101,33 @@ export interface RunOptions {
      * under the same names). The `PI_FFF_MODE` env var, if set, wins.
      */
     fileSearchMode?: "override" | "tools-only" | "tools-and-ui";
+    /**
+     * Extra Agent Skill paths to load, beyond Pi's default discovery
+     * (`~/.pi/agent/skills`, `~/.agents/skills`, `.pi/skills`, `.agents/skills`,
+     * package `skills/`). Each entry is a directory of skills OR a single skill
+     * dir/file. Additive even with `noSkills`. Maps e.g. `~/.claude/skills` into
+     * the agent.
+     */
+    skillPaths?: string[];
+    /**
+     * Disable Pi's default skill discovery. Explicit `skillPaths` still load.
+     * Default: discovery enabled (Pi's default).
+     */
+    noSkills?: boolean;
+    /**
+     * Enable OTEL traces + metrics export. Default: `false` (or env
+     * `AGENTIC_PI_OTEL_ENABLED=1`). `false` here force-disables. Requires an
+     * OTLP endpoint via `OTEL_EXPORTER_OTLP_ENDPOINT` or `otelEndpoint`.
+     * Standard `OTEL_*` env vars are honored by the SDK. Sandbox/env-driven
+     * callers can leave this unset and rely on `AGENTIC_PI_OTEL_ENABLED`.
+     */
+    otel?: boolean;
+    /** Attach bounded raw content to spans. Default: `false` (metadata-only). */
+    otelIncludeContent?: boolean;
+    /** Override OTEL service name (default: "agentic-pi"). */
+    otelServiceName?: string;
+    /** Override the OTLP endpoint base URL (escape hatch; prefer the env var). */
+    otelEndpoint?: string;
     /**
      * Called for every emitted JSONL record in order. Same shape that the
      * CLI writes to stdout, with `sessionId` and `timestamp` already injected.
@@ -188,6 +215,32 @@ export interface RunResult {
         mode?: string;
         toolCount: number;
     };
+    /**
+     * Mirror of the `skills_status` line. Present only when skills were
+     * configured (`skillPaths`/`noSkills`) or at least one skill was discovered;
+     * absent on a default run with no skills (matching the gated event).
+     */
+    skills?: {
+        status: "default" | "configured" | "disabled";
+        discovered: number;
+        skills: Array<{
+            name: string;
+            source: string;
+            modelInvocable: boolean;
+        }>;
+        mappedPaths: string[];
+        noSkills: boolean;
+    };
+    /**
+     * Mirror of the telemetry `extension_status` line. Present only when OTEL
+     * was requested (enabled or explicitly disabled); absent on a default run.
+     */
+    telemetry?: {
+        status: "configured" | "skipped";
+        reason?: string;
+        message?: string;
+        includeContent?: boolean;
+    };
     /** Every JSONL record the run emitted, in order. */
     records: EmitterRecord[];
     /** Warnings that would have gone to stderr in CLI mode. */

package/dist/run.js

@@ -51,6 +51,12 @@ export async function run(options) {
         webSearchMaxCalls: options.webSearchMaxCalls,
         fileSearch: options.fileSearch ?? true,
         fileSearchMode: options.fileSearchMode,
+        skillPaths: options.skillPaths,
+        noSkills: options.noSkills,
+        otel: options.otel,
+        otelIncludeContent: options.otelIncludeContent,
+        otelServiceName: options.otelServiceName,
+        otelEndpoint: options.otelEndpoint,
     };
     const collector = new CollectorSink(options.onEvent);
     const sink = options.extraSink
@@ -117,6 +123,23 @@ function buildResult(exitCode, records, warnings) {
                         toolCount: r.toolCount ?? 0,
                     };
                 }
+                else if (r.extension === "telemetry") {
+                    result.telemetry = {
+                        status: r.status,
+                        reason: r.reason,
+                        message: r.message,
+                        includeContent: r.includeContent,
+                    };
+                }
+                break;
+            case "skills_status":
+                result.skills = {
+                    status: r.status,
+                    discovered: r.discovered ?? 0,
+                    skills: r.skills ?? [],
+                    mappedPaths: r.mappedPaths ?? [],
+                    noSkills: r.noSkills ?? false,
+                };
                 break;
             case "message_end": {
                 // Accumulate assistant text. Pi's message structure:

package/dist/run.js.map

@@ -1 +1 @@
-{"version":3,"file":"run.js","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"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"}