@esso0428/pi-subagents 0.17.16 → 0.17.17

package/dist/types.d.ts

@@ -1,372 +0,0 @@
-/**
- * types.ts — Type definitions for the subagent system.
- */
-import type { ThinkingLevel } from "@earendil-works/pi-ai";
-import type { AgentSession } from "@earendil-works/pi-coding-agent";
-import type { LifetimeUsage } from "./usage.js";
-export type { ThinkingLevel };
-/** Agent type: any string name (built-in defaults or user-defined). */
-export type SubagentType = string;
-/** Names of the three embedded default agents. */
-export declare const DEFAULT_AGENT_NAMES: readonly ["general-purpose", "Explore", "Plan"];
-/** Memory scope for persistent agent memory. */
-export type MemoryScope = "user" | "project" | "local";
-/**
- * Isolation mode for agent execution.
- *
- * `"off"` exists for the caller's benefit, not the runtime's: models that fill
- * every optional parameter had no legal way to decline a single-value
- * `isolation` field and kept spawning worktrees they had just reasoned their
- * way out of (#231, #184). It is an input spelling only —
- * `resolveAgentInvocationConfig` collapses it to `undefined`, so nothing
- * downstream sees a value other than `"worktree"`. In an agent file it is a
- * genuine veto, since agent config outranks tool-call params.
- */
-export type IsolationMode = "worktree" | "off";
-/** Unified agent configuration — used for both default and user-defined agents. */
-export interface AgentConfig {
-    name: string;
-    /** UI name. `display_name` wins; Claude Code's `name` is accepted as a fallback. */
-    displayName?: string;
-    /** Claude Code-compatible name color (named color or #RRGGBB). */
-    color?: string;
-    description: string;
-    builtinToolNames?: string[];
-    /** Raw `ext:` selector entries from the `tools:` CSV, e.g. ["ext:foo", "ext:bar/x"].
-     * Presence of any entry flips extension tools to an explicit allowlist. */
-    extSelectors?: string[];
-    /** Tool denylist — these tools are removed even if `builtinToolNames` or extensions include them. */
-    disallowedTools?: string[];
-    /** true = inherit all, string[] = only listed, false = none */
-    extensions: true | string[] | false;
-    /** Extension-name denylist applied after the `extensions:` include set. Exclude wins.
-     * Plain canonical names only (case-insensitive); no paths, no wildcard. */
-    excludeExtensions?: string[];
-    /** true = inherit all, string[] = only listed, false = none */
-    skills: true | string[] | false;
-    model?: string;
-    thinking?: ThinkingLevel;
-    maxTurns?: number;
-    /** Persist this subagent as a normal pi session instead of keeping it in memory only. */
-    persistSession?: boolean;
-    /** Write the subagent's .output transcript. Defaults to true; false suppresses only that transcript. */
-    outputTranscript?: boolean;
-    /** Optional session directory used when persistSession is true. Omitted = pi's normal session location. */
-    sessionDir?: string;
-    /**
-     * Nested delegation, off by default: undefined = no nested tools;
-     * "all" = any enabled agent; string[] = only those agent types.
-     */
-    allowedSubagents?: "all" | string[];
-    systemPrompt: string;
-    promptMode: "replace" | "append";
-    /** Default for spawn: fork parent conversation. undefined = caller decides. */
-    inheritContext?: boolean;
-    /** Default for spawn: run in background. undefined = caller decides. */
-    runInBackground?: boolean;
-    /** Default for spawn: no extension tools. undefined = caller decides. */
-    isolated?: boolean;
-    /** Persistent memory scope — agents with memory get a persistent directory and MEMORY.md */
-    memory?: MemoryScope;
-    /**
-     * Isolation mode — "worktree" runs the agent in a temporary git worktree,
-     * "off" refuses one even when the caller asks (frontmatter outranks params).
-     */
-    isolation?: IsolationMode;
-    /** true = this is an embedded default agent (informational) */
-    isDefault?: boolean;
-    /** false = agent is hidden from the registry */
-    enabled?: boolean;
-    /** Where this agent was loaded from */
-    source?: "default" | "project" | "global";
-    /** Path of the .md it was loaded from. Unset for embedded defaults. */
-    sourcePath?: string;
-}
-export type JoinMode = 'async' | 'group' | 'smart';
-/**
- * Display mode for the persistent above-editor agent widget.
- * - `all`: show every agent (foreground + background).
- * - `background`: hide foreground agents (they already render inline as the
- *   Agent tool result, #118); show background/queued/scheduled/RPC.
- * - `off`: hide the widget entirely.
- */
-export type WidgetMode = 'all' | 'background' | 'off';
-/**
- * How much of the conversation viewer's transcript is rendered as Markdown.
- * - `off`: every line wraps as literal text, as it did before the mode existed.
- * - `assistant`: assistant text renders as Markdown; tool results stay verbatim
- *   and dim. The default, because assistant text *is* Markdown by contract
- *   while a tool result is arbitrary bytes — a Markdown pass over a log or a
- *   diff eats `#` from shell comments, swallows a `---` line into a setext
- *   heading, re-fences indented output and redraws `| a | b |` as a table.
- *   (Ordered-list renumbering is the one such rewrite actively suppressed —
- *   see `MARKDOWN_OPTIONS` — because it silently changes data, not layout.)
- * - `all`: tool results render as Markdown too, for tools that genuinely emit
- *   it (#210's `ctx_execute`), accepting the rewrites above on ones that don't.
- */
-export type ViewerMarkdownMode = 'off' | 'assistant' | 'all';
-/**
- * How `@handle message` starts an agent that is not already running.
- * - `model`: inject Claude Code's `agent_mention` reminder and let the main
- *   model spawn it with the `Agent` tool, which is what Claude Code does.
- * - `direct`: spawn it here, immediately, with the typed message as its prompt
- *   and no main-model turn spent.
- * - `off`: `@` means only "attach a file" again.
- *
- * Messaging a running agent and resuming a finished one are direct in every
- * mode — Claude Code only differs from us on the *new* invocation.
- */
-export type AgentMentionMode = 'model' | 'direct' | 'off';
-/**
- * What survives a record's eviction so `@handle` keeps working. The live record
- * is discarded after ~10 minutes, but the pi session it wrote is still on disk,
- * and this is the little that is needed to find and describe it again.
- */
-export interface AgentTombstone {
-    handle: string;
-    alias?: string;
-    id: string;
-    type: SubagentType;
-    description: string;
-    /** Always set — a record with no session file is never tombstoned. */
-    sessionFile: string;
-    completedAt: number;
-}
-/**
- * What `@handle` resolved to: an agent still in memory, or the remains of one
- * whose conversation can be reopened from disk.
- */
-export type MentionResolution = {
-    kind: "live";
-    record: AgentRecord;
-} | {
-    kind: "tombstone";
-    entry: AgentTombstone;
-};
-export interface AgentRecord {
-    id: string;
-    type: SubagentType;
-    /**
-     * Typeable name for the `@handle message` prompt mention, derived from the
-     * agent type and numbered when siblings collide (`explore`, `explore-2`).
-     * Top-level agents only — nested children are hidden from every top-level
-     * surface, so nothing can address them.
-     */
-    handle?: string;
-    /**
-     * A second, memorable handle from the spawner's `name` (`@auth-audit`), drawn
-     * from the same namespace as `handle` so the two can never collide. Purely
-     * additive: `handle` is assigned regardless, so a named agent stays reachable
-     * by its type and `@explore` never comes to mean "start another one".
-     */
-    alias?: string;
-    description: string;
-    status: "queued" | "running" | "completed" | "steered" | "aborted" | "stopped" | "error";
-    result?: string;
-    error?: string;
-    toolUses: number;
-    startedAt: number;
-    completedAt?: number;
-    session?: AgentSession;
-    abortController?: AbortController;
-    promise?: Promise<string>;
-    /**
-     * A caller is awaiting this agent inline (`spawnAndWait`) — what
-     * `maxConcurrentForeground` bounds. Distinct from `isBackground === false`,
-     * which says only that the agent has an inline result surface: a detached
-     * cross-extension RPC spawn is foreground by that measure and yet blocks
-     * nobody, so it takes no slot.
-     */
-    blocking?: boolean;
-    /**
-     * Present only while the record is "queued": resolves when it leaves the
-     * queue, started or aborted. `spawnAndWait` waits on this because a queued
-     * record has no `promise` yet. Always resolves, never rejects — a rejection
-     * would escape into the caller's tool `execute` and take down pi's whole
-     * Promise.all tool batch.
-     */
-    startGate?: Promise<void>;
-    groupId?: string;
-    joinMode?: JoinMode;
-    /** Set when result was already consumed via get_subagent_result — suppresses completion notification. */
-    resultConsumed?: boolean;
-    /** Steering messages queued before the session was ready. */
-    pendingSteers?: string[];
-    /** Worktree info if the agent is running in an isolated worktree. */
-    worktree?: {
-        path: string;
-        branch: string;
-        baseSha: string;
-        workPath: string;
-    };
-    /** Worktree cleanup result after agent completion. */
-    worktreeResult?: {
-        hasChanges: boolean;
-        branch?: string;
-    };
-    /** The tool_use_id from the original Agent tool call. */
-    toolCallId?: string;
-    /** Path to the streaming output transcript file. */
-    outputFile?: string;
-    /** Absolute path to the durable project-local transcript while live. */
-    historyFile?: string;
-    /** Project-relative durable transcript path persisted in the parent session. */
-    transcriptPath?: string;
-    /**
-     * The agent's pi session file, when it was persisted (`persist_session`, or
-     * the `rememberAgents` default). Captured so a mention can reopen the
-     * conversation after the record itself has been evicted; undefined for an
-     * in-memory session, which leaves nothing to reopen.
-     */
-    sessionFile?: string;
-    /** Cleanup function for the optional `.output` stream subscription. */
-    outputCleanup?: () => void;
-    /** Cleanup function for the mandatory durable `.pi-subagents` history stream. */
-    historyCleanup?: () => void;
-    /**
-     * Lifetime usage breakdown, accumulated via `message_end` events. Survives
-     * compaction. Total = input + output + cacheWrite (cacheRead deliberately
-     * excluded — see issue #38). Initialized to zeros at spawn.
-     */
-    lifetimeUsage: LifetimeUsage;
-    /** Number of times this agent's session has compacted. Initialized to 0 at spawn. */
-    compactionCount: number;
-    /**
-     * Whether this agent was spawned to run in the background. Tri-state, set at
-     * spawn from `SpawnOptions.isBackground`: `true` = background, `false` =
-     * foreground (has an inline Agent tool-result surface), `undefined` = the
-     * caller never declared it (e.g. a cross-extension RPC spawn, which is detached
-     * and has no inline surface). The widget's background-only filter keys off this
-     * — and excludes only explicit `false`, so `undefined` agents stay visible.
-     * Reliable across ALL spawn paths, unlike the UI-only `invocation` snapshot,
-     * which only the Agent-tool path populates.
-     */
-    isBackground?: boolean;
-    /** Resolved spawn params, captured for UI display. Fixed at spawn time. */
-    invocation?: AgentInvocation;
-    /** Nesting depth: top-level subagent = 1. */
-    depth?: number;
-    /**
-     * The validated `StructuredOutput` payload, as canonical JSON.
-     *
-     * Set only when the spawn asked for a schema. Separate from `result` because
-     * `result` is prose for a reader — previewed in the widget, written to the
-     * transcript, and appended to with the worktree branch note — and JSON that
-     * has been appended to no longer parses.
-     */
-    structuredJson?: string;
-    /** Whether the child needed the extra structured-output prompt. */
-    structuredRetried?: boolean;
-    /** Parent agent ID for ownership-scoped nested controls. */
-    parentAgentId?: string;
-    /**
-     * The workflow run that owns this child, when a workflow spawned it.
-     *
-     * Owned the same way a nested child is owned by its parent: filtered out of
-     * every top-level surface, and outside the `maxConcurrent` pool. See
-     * `isTopLevelAgent`.
-     */
-    workflowId?: string;
-    /** Effective inherited nesting cap for this branch. */
-    maxSubagentDepth?: number;
-    /**
-     * Session id of the root (main) session this branch descends from. Nested
-     * spawns inherit it so their transcripts file under the same session
-     * directory as their ancestors' instead of the child session's own id.
-     */
-    rootSessionId?: string;
-}
-/**
- * What a session reports as its level: pi's `ThinkingLevel` plus the `"off"` a
- * model with thinking disabled reports. Display-only — spawning still takes a
- * `ThinkingLevel`, so this widening cannot leak into an invocation.
- */
-export type EffectiveThinkingLevel = ThinkingLevel | "off";
-export interface AgentInvocation {
-    /** Short display name for tight rows, e.g. "haiku 4.5". Always set once known. */
-    modelName?: string;
-    /** Canonical `provider/id`, for surfaces with room to disambiguate providers. */
-    modelId?: string;
-    /** The level actually in effect, once a session exists to report one. */
-    thinking?: EffectiveThinkingLevel;
-    /**
-     * What the caller asked for, kept only when they did not get it — pi clamped
-     * the level to the model's capabilities, or an agent file's frontmatter
-     * outranked the parameter (#182). The snapshot exists to answer "did the spawn
-     * honor my instructions?" (#62), which it cannot do if the request is lost, so
-     * neither `requested*` field is overwritten once set.
-     */
-    requestedThinking?: EffectiveThinkingLevel;
-    /** The caller's `model` parameter, as written, when an agent file's pin won. */
-    requestedModel?: string;
-    maxTurns?: number;
-    isolated?: boolean;
-    inheritContext?: boolean;
-    runInBackground?: boolean;
-    isolation?: IsolationMode;
-}
-/** Details attached to custom notification messages for visual rendering. */
-export interface NotificationDetails {
-    id: string;
-    description: string;
-    status: string;
-    toolUses: number;
-    turnCount: number;
-    maxTurns?: number;
-    totalTokens: number;
-    /**
-     * Estimated cost in USD, from pi's per-message `usage.cost.total`. Always
-     * populated (0 when the model has no pricing); the renderer decides whether
-     * to show it, per the `showCost` setting.
-     */
-    totalCost?: number;
-    durationMs: number;
-    outputFile?: string;
-    error?: string;
-    resultPreview: string;
-    /** Additional agents in a group notification. */
-    others?: NotificationDetails[];
-}
-export interface EnvInfo {
-    isGitRepo: boolean;
-    branch: string;
-    platform: string;
-}
-/**
- * A subagent spawn registered to fire on a schedule.
- *
- * Stored at `<cwd>/.pi/subagent-schedules/<sessionId>.json`. Session-scoped:
- * survives `/resume` but resets on `/new`, mirroring pi-chonky-tasks.
- */
-export interface ScheduledSubagent {
-    id: string;
-    /** Unique within store. Defaults to `description`. */
-    name: string;
-    description: string;
-    /** Raw user input — cron expr | "+10m" | ISO | "5m". */
-    schedule: string;
-    scheduleType: "cron" | "once" | "interval";
-    /** Computed at create time for interval/once. */
-    intervalMs?: number;
-    subagent_type: SubagentType;
-    prompt: string;
-    model?: string;
-    thinking?: ThinkingLevel;
-    max_turns?: number;
-    isolated?: boolean;
-    isolation?: IsolationMode;
-    enabled: boolean;
-    /** ISO timestamp. */
-    createdAt: string;
-    lastRun?: string;
-    lastStatus?: "success" | "error" | "running";
-    /** Refreshed on every fire and on store load. */
-    nextRun?: string;
-    runCount: number;
-}
-export interface ScheduleStoreData {
-    /** For future migrations. */
-    version: 1;
-    jobs: ScheduledSubagent[];
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,YAAY,EAAE,aAAa,EAAE,CAAC;AAE9B,uEAAuE;AACvE,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC;AAElC,kDAAkD;AAClD,eAAO,MAAM,mBAAmB,iDAAkD,CAAC;AAEnF,gDAAgD;AAChD,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAEvD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,KAAK,CAAC;AAE/C,mFAAmF;AACnF,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,oFAAoF;IACpF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B;+EAC2E;IAC3E,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,qGAAqG;IACrG,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,+DAA+D;IAC/D,UAAU,EAAE,IAAI,GAAG,MAAM,EAAE,GAAG,KAAK,CAAC;IACpC;+EAC2E;IAC3E,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,+DAA+D;IAC/D,MAAM,EAAE,IAAI,GAAG,MAAM,EAAE,GAAG,KAAK,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yFAAyF;IACzF,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,wGAAwG;IACxG,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,2GAA2G;IAC3G,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,KAAK,GAAG,MAAM,EAAE,CAAC;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,SAAS,GAAG,QAAQ,CAAC;IACjC,+EAA+E;IAC/E,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,wEAAwE;IACxE,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,yEAAyE;IACzE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,4FAA4F;IAC5F,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;OAGG;IACH,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,+DAA+D;IAC/D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gDAAgD;IAChD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,uCAAuC;IACvC,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC1C,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAEnD;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,YAAY,GAAG,KAAK,CAAC;AAEtD;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,WAAW,GAAG,KAAK,CAAC;AAE7D;;;;;;;;;;GAUG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;AAE1D;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,YAAY,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,WAAW,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,cAAc,CAAA;CAAE,CAAC;AAEjD,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,YAAY,CAAC;IACnB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;IACzF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1B;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,yGAAyG;IACzG,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,6DAA6D;IAC7D,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,qEAAqE;IACrE,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/E,sDAAsD;IACtD,cAAc,CAAC,EAAE;QAAE,UAAU,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1D,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gFAAgF;IAChF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uEAAuE;IACvE,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IAC3B,iFAAiF;IACjF,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B;;;;OAIG;IACH,aAAa,EAAE,aAAa,CAAC;IAC7B,qFAAqF;IACrF,eAAe,EAAE,MAAM,CAAC;IACxB;;;;;;;;;OASG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mEAAmE;IACnE,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,4DAA4D;IAC5D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,aAAa,GAAG,KAAK,CAAC;AAE3D,MAAM,WAAW,eAAe;IAC9B,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iFAAiF;IACjF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,sBAAsB,CAAC;IAClC;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,sBAAsB,CAAC;IAC3C,gFAAgF;IAChF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,SAAS,CAAC,EAAE,aAAa,CAAC;CAC3B;AAED,6EAA6E;AAC7E,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,MAAM,CAAC,EAAE,mBAAmB,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,OAAO;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC;IAC3C,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB,aAAa,EAAE,YAAY,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,aAAa,CAAC;IAG1B,OAAO,EAAE,OAAO,CAAC;IACjB,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;IAC7C,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,6BAA6B;IAC7B,OAAO,EAAE,CAAC,CAAC;IACX,IAAI,EAAE,iBAAiB,EAAE,CAAC;CAC3B"}

package/dist/types.js

@@ -1,6 +0,0 @@
-/**
- * types.ts — Type definitions for the subagent system.
- */
-/** Names of the three embedded default agents. */
-export const DEFAULT_AGENT_NAMES = ["general-purpose", "Explore", "Plan"];
-//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAWH,kDAAkD;AAClD,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,iBAAiB,EAAE,SAAS,EAAE,MAAM,CAAU,CAAC"}

package/dist/ui/agent-mention.d.ts

@@ -1,83 +0,0 @@
-/**
- * agent-mention.ts — what `@` can address, and the suggestions pi renders for it.
- *
- * A subagent is addressable whether or not it is currently running: a live
- * record is messaged or resumed, an evicted one whose session is still on disk
- * is reopened, and an agent *type* with no instance at all is started. That is
- * the point of the handle — `@explore` means the Explore agent, not "the
- * Explore process that happens to exist right now" — so the roster below unions
- * all three, and the dispatcher and the popup read the same list.
- *
- * Rows are per *agent*, not per handle. An agent given a `name` holds two names
- * (its alias and its type-derived handle) and both resolve, but it lists once,
- * under the alias, with its type moved into the description so the row still
- * says what it is.
- *
- * pi's `CombinedAutocompleteProvider` already owns `@`, where it means "attach a
- * file". Extensions can wrap it (`ctx.ui.addAutocompleteProvider`), so this
- * provider adds the `@` tokens that name an agent and delegates everything else
- * — including all of `applyCompletion`, whose `@`-branch already inserts
- * `item.value` plus a trailing space, which is exactly what a handle needs.
- *
- * Matching mirrors Claude Code: case-insensitive prefix, not fuzzy. What it does
- * NOT mirror is Claude Code dropping files whenever an agent matches. Here `@` is
- * pi's file picker first, and the handles are additive, so a token matching both
- * lists both — agents first. Suppressing on any match sounds narrow and is not:
- * an empty token prefix-matches every handle, so a bare `@` — the gesture people
- * use to browse files — would offer no files at all, and a single letter
- * beginning any handle would do the same.
- *
- * Both halves ship under ONE `prefix`, which is sound because wherever BOTH sides
- * produce rows they measured the same span. pi's `extractAtPrefix` takes the
- * token after the last of `{space, tab, ", ', =}` and keeps it only if it starts
- * with `@`; `MENTION_TRIGGER` matches `@[\w-]*` at the cursor, after start-of-line
- * or `[\s。、？！]`. Where those two disagree, exactly one side answers and there
- * is nothing to merge: `@src/index.ts` and `@"my file` are pi's alone (no handle
- * matches), `=@ex` is pi's alone (`=` is a delimiter to pi, not a boundary to us),
- * and `。@ex` is ours alone (the reverse). A merged response therefore never
- * carries a prefix from one side and an item from the other.
- *
- * Offering never-started types is a deliberate step beyond Claude Code, whose
- * registry holds only live tasks, so an agent you had not launched yet was
- * unaddressable.
- */
-import type { AutocompleteProvider } from "@earendil-works/pi-tui";
-import type { AgentManager } from "../agent-manager.js";
-import type { AgentRecord, AgentTombstone } from "../types.js";
-/**
- * One thing `@` can address, and what sending to it will do. `typeLabel` is the
- * agent's `display_name`, resolved by the caller: this module stays independent
- * of the type registry, but the popup must agree with the Agents widget,
- * which renders the label rather than the raw type.
- */
-export type MentionTarget = {
-    kind: "record";
-    handle: string;
-    record: AgentRecord;
-    typeLabel: string;
-} | {
-    kind: "tombstone";
-    handle: string;
-    entry: AgentTombstone;
-    typeLabel: string;
-} | {
-    kind: "type";
-    handle: string;
-    type: string;
-    description: string;
-};
-/** The registry facts the roster needs, so it stays independent of agent-types. */
-export type TypeInfo = {
-    name: string;
-    description: string;
-};
-/**
- * Everything `@` can reach, in the order the popup lists it: steerable agents
- * first, then the other live ones earliest-launched, then agent types with no
- * live instance. A type whose handle a record already holds is omitted — that
- * name addresses the existing agent, which is what makes `@explore` mean
- * "message the one that's running" and only otherwise "start one".
- */
-export declare function mentionRoster(manager: AgentManager, types: readonly TypeInfo[], displayNameOf?: (type: string) => string): MentionTarget[];
-export declare function createMentionProvider(current: AutocompleteProvider, roster: () => MentionTarget[], isEnabled: () => boolean): AutocompleteProvider;
-//# sourceMappingURL=agent-mention.d.ts.map

package/dist/ui/agent-mention.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent-mention.d.ts","sourceRoot":"","sources":["../../src/ui/agent-mention.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,OAAO,KAAK,EAAoB,oBAAoB,EAA2B,MAAM,wBAAwB,CAAC;AAC9G,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE/D;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC1E;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,cAAc,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC/E;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC;AAExE,mFAAmF;AACnF,MAAM,MAAM,QAAQ,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7D;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,SAAS,QAAQ,EAAE,EAG1B,aAAa,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAqB,GACrD,aAAa,EAAE,CAsCjB;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,MAAM,aAAa,EAAE,EAC7B,SAAS,EAAE,MAAM,OAAO,GACvB,oBAAoB,CA0DtB"}