@ap3x/cli 0.1.0

package/dist/tools/index.d.ts

@@ -0,0 +1,35 @@
+import type { AnyAgentTool } from "@ap3x/agent-core";
+import { type ToolContext } from "./context";
+export { createToolContext, type ToolContext, type SwarmBackend } from "./context";
+export { createCallAgentTool, createA2aTools } from "./a2a";
+export { createRunSwarmTool, createAutoSwarmTool, createBuildAgentTool, createSwarmTools, } from "./swarm";
+export { createReadTool } from "./read";
+export { createWriteTool } from "./write";
+export { createEditTool } from "./edit";
+export { createBashTool } from "./bash";
+export { createLsTool } from "./ls";
+export { createGrepTool } from "./grep";
+export { createFindTool } from "./find";
+/** Names of every built-in tool the CLI ships. */
+export declare const ALL_TOOL_NAMES: readonly ["read", "bash", "edit", "write", "grep", "find", "ls", "run_swarm", "auto_swarm", "build_agent", "call_agent"];
+/** Names of the tools that only observe (never mutate) the workspace. */
+export declare const READ_ONLY_TOOL_NAMES: readonly ["read", "grep", "find", "ls"];
+/** Build every built-in tool against a context. */
+export declare function createAllTools(ctx?: ToolContext): AnyAgentTool[];
+/**
+ * The standard coding-agent tool set: read, bash, edit, write, grep, find, ls.
+ * Mutating tools (edit/write) are wrapped so concurrent calls serialize.
+ */
+export declare function createCodingTools(ctx?: ToolContext): AnyAgentTool[];
+/** A read-only tool set (no edit/write/bash): read, grep, find, ls. */
+export declare function createReadOnlyTools(ctx?: ToolContext): AnyAgentTool[];
+/** Select a subset of tools by name, preserving the order in `names`. */
+export declare function selectTools(tools: AnyAgentTool[], names: readonly string[]): AnyAgentTool[];
+/**
+ * Serialize file-mutating tools (`edit`, `write`) through a shared promise
+ * chain so concurrent invocations cannot interleave reads and writes and
+ * corrupt a file. Non-mutating tools are returned untouched. The wrapped tools
+ * are also forced to `executionMode: "sequential"` as a second line of defense.
+ */
+export declare function withFileMutationQueue(tools: AnyAgentTool[]): AnyAgentTool[];
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,EAAE,KAAK,WAAW,EAAqB,MAAM,WAAW,CAAC;AAQhE,OAAO,EAAE,iBAAiB,EAAE,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AACnF,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAC5D,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAExC,kDAAkD;AAClD,eAAO,MAAM,cAAc,0HAYjB,CAAC;AAEX,yEAAyE;AACzE,eAAO,MAAM,oBAAoB,yCAA0C,CAAC;AAE5E,mDAAmD;AACnD,wBAAgB,cAAc,CAAC,GAAG,CAAC,EAAE,WAAW,GAAG,YAAY,EAAE,CAWhE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,CAAC,EAAE,WAAW,GAAG,YAAY,EAAE,CAEnE;AAED,uEAAuE;AACvE,wBAAgB,mBAAmB,CAAC,GAAG,CAAC,EAAE,WAAW,GAAG,YAAY,EAAE,CAGrE;AAED,yEAAyE;AACzE,wBAAgB,WAAW,CAAC,KAAK,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,YAAY,EAAE,CAQ3F;AAID;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CAuB3E"}

package/dist/tools/ls.d.ts

@@ -0,0 +1,5 @@
+import { type AnyAgentTool } from "@ap3x/agent-core";
+import type { ToolContext } from "./context";
+/** `ls` — list the entries of a directory (non-recursive), sorted. */
+export declare function createLsTool(ctx: ToolContext): AnyAgentTool;
+//# sourceMappingURL=ls.d.ts.map

package/dist/tools/ls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ls.d.ts","sourceRoot":"","sources":["../../src/tools/ls.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAc,MAAM,kBAAkB,CAAC;AAEjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7C,sEAAsE;AACtE,wBAAgB,YAAY,CAAC,GAAG,EAAE,WAAW,GAAG,YAAY,CA2B3D"}

package/dist/tools/read.d.ts

@@ -0,0 +1,9 @@
+import { type AnyAgentTool } from "@ap3x/agent-core";
+import type { ToolContext } from "./context";
+/**
+ * `read` — read a text file (numbered line window) or an image (base64
+ * {@link ImageContent}). Images are detected by magic bytes and returned in a
+ * form vision models can view.
+ */
+export declare function createReadTool(ctx: ToolContext): AnyAgentTool;
+//# sourceMappingURL=read.d.ts.map

package/dist/tools/read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../src/tools/read.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,YAAY,EAAc,MAAM,kBAAkB,CAAC;AAEvF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AA0J7C;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,WAAW,GAAG,YAAY,CAqD7D"}

package/dist/tools/swarm.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Swarm orchestration tools for the coding agent. These let the `ap3x` agent
+ * spin up a team of sub-agents — each backed by the SAME model + auth the CLI is
+ * already using (so the swarm runs on the caller's subscription/credentials).
+ *
+ * Two tools:
+ * - `run_swarm`  — explicit orchestration: you pick the architecture and define
+ *   each specialist agent.
+ * - `auto_swarm` — goal → team: an LLM "architect" designs the team + topology
+ *   from a one-line goal, then it is built and run.
+ *
+ * Every sub-agent is constructed via {@link makeAgent}, which threads the
+ * session model + resolved auth into the swarms {@link Agent}. The tools are only
+ * registered when the session actually has a swarm backend (see
+ * {@link createSwarmTools}); they additionally early-error if invoked without one.
+ */
+import { type AnyAgentTool } from "@ap3x/agent-core";
+import type { ToolContext } from "./context";
+/**
+ * `run_swarm` — explicit multi-agent orchestration. The caller picks the
+ * architecture and defines each specialist agent; every agent is built on the
+ * session model + auth, then a {@link SwarmRouter} of the chosen type runs the task.
+ */
+export declare function createRunSwarmTool(ctx: ToolContext): AnyAgentTool;
+/**
+ * `auto_swarm` — describe a goal and an LLM architect designs the team + topology,
+ * which is then built (every agent on the session model + auth) and run.
+ */
+export declare function createAutoSwarmTool(ctx: ToolContext): AnyAgentTool;
+/**
+ * `build_agent` — design a SINGLE specialist agent from a role description (an
+ * LLM architect synthesizes its name + system prompt), then optionally run it on
+ * a task. The designed agent is built on the session model + auth. With no
+ * `task`, the designed spec is returned so it can be reused.
+ */
+export declare function createBuildAgentTool(ctx: ToolContext): AnyAgentTool;
+/**
+ * The swarm tool set — only available when the session can orchestrate (i.e. it
+ * resolved a model + auth into {@link ToolContext.swarm}).
+ */
+export declare function createSwarmTools(ctx: ToolContext): AnyAgentTool[];
+//# sourceMappingURL=swarm.d.ts.map

package/dist/tools/swarm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swarm.d.ts","sourceRoot":"","sources":["../../src/tools/swarm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,KAAK,YAAY,EAAc,MAAM,kBAAkB,CAAC;AAcjE,OAAO,KAAK,EAAgB,WAAW,EAAE,MAAM,WAAW,CAAC;AA4F3D;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,WAAW,GAAG,YAAY,CA8DjE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,WAAW,GAAG,YAAY,CAuElE;AAmBD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,WAAW,GAAG,YAAY,CAqEnE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,WAAW,GAAG,YAAY,EAAE,CAIjE"}

package/dist/tools/walk.d.ts

@@ -0,0 +1,48 @@
+/**
+ * A compiled `.gitignore` line. `re` is tested against either the whole
+ * root-relative POSIX path (when `anchored`) or just the basename (otherwise).
+ */
+export interface GitignoreRule {
+    negated: boolean;
+    dirOnly: boolean;
+    anchored: boolean;
+    re: RegExp;
+}
+/** Result of {@link walkFiles}. `truncated` signals the safety cap bit the walk. */
+export interface WalkResult {
+    files: string[];
+    truncated: boolean;
+}
+/**
+ * Parse `.gitignore` text into ordered rules. Covers the common, high-value
+ * subset: blank/`#` comment lines are skipped; `!` negates; a trailing `/` makes
+ * a rule directory-only; a leading `/` (or a mid-pattern `/`) anchors to the
+ * gitignore's directory, otherwise the pattern matches a name at any depth.
+ * Last matching rule wins (so a later `!` re-includes).
+ *
+ * ponytail: deliberately NOT covered this slice (root-level .gitignore is the
+ * task scope): nested per-directory .gitignore, `.gitignore` escaping of `#`/`!`
+ * with backslash, character classes `[a-z]`. Add when a nested-ignore item lands.
+ */
+export declare function parseGitignore(content: string): GitignoreRule[];
+/**
+ * Whether `path` (root-relative, POSIX separators) is ignored by `rules`. Later
+ * matching rules override earlier ones, so `!name` after `name` re-includes.
+ */
+export declare function isGitignored(rules: GitignoreRule[], path: string, isDir: boolean): boolean;
+/**
+ * Recursively walk a directory, yielding file paths relative to `root`. Skips
+ * `.git`/build dirs and anything matched by the root `.gitignore`; symlinks are
+ * not followed. The walk is bounded by a HIGH safety cap (`maxEntries`) rather
+ * than a silent low ceiling — when the cap bites, `truncated` is set so callers
+ * can warn instead of silently dropping matches. Ignored dirs prune the walk.
+ *
+ * ponytail: because ignored directories are pruned, a `!child` cannot re-include
+ * a file under an ignored parent — this matches git's own limitation.
+ */
+export declare function walkFiles(root: string, options?: {
+    maxEntries?: number;
+    ignore?: Set<string>;
+    rules?: GitignoreRule[];
+}): Promise<WalkResult>;
+//# sourceMappingURL=walk.d.ts.map

package/dist/tools/walk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk.d.ts","sourceRoot":"","sources":["../../src/tools/walk.ts"],"names":[],"mappings":"AAUA;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,oFAAoF;AACpF,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;CACpB;AAmCD;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,EAAE,CA2B/D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,aAAa,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAS1F;AAUD;;;;;;;;;GASG;AACH,wBAAsB,SAAS,CAC7B,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,aAAa,EAAE,CAAA;CAAE,GAC/E,OAAO,CAAC,UAAU,CAAC,CA6CrB"}

package/dist/tools/write.d.ts

@@ -0,0 +1,9 @@
+import { type AnyAgentTool } from "@ap3x/agent-core";
+import type { ToolContext } from "./context";
+/**
+ * `write` — create or overwrite a file with the given content. Parent
+ * directories are created as needed. This is a mutating tool: serialize it with
+ * {@link withFileMutationQueue} to avoid interleaved writes.
+ */
+export declare function createWriteTool(ctx: ToolContext): AnyAgentTool;
+//# sourceMappingURL=write.d.ts.map

package/dist/tools/write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../src/tools/write.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAc,MAAM,kBAAkB,CAAC;AAEjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7C;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,WAAW,GAAG,YAAY,CA4B9D"}

package/dist/trace/trace-cli.d.ts

@@ -0,0 +1,9 @@
+import type { CliIO } from "../cli";
+export interface TraceCliDeps {
+    io: CliIO;
+    /** `--config-dir`-style override for the traces directory's parent. */
+    configDir?: string;
+}
+export declare function printTraceHelp(): string;
+export declare function runTraceCli(args: string[], deps: TraceCliDeps): Promise<number>;
+//# sourceMappingURL=trace-cli.d.ts.map

package/dist/trace/trace-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-cli.d.ts","sourceRoot":"","sources":["../../src/trace/trace-cli.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAEpC,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,KAAK,CAAC;IACV,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,cAAc,IAAI,MAAM,CAevC;AA8DD,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CA0ErF"}

package/dist/utils/clipboard.d.ts

@@ -0,0 +1,23 @@
+/**
+ * A best-effort clipboard sink. {@link copyToClipboard} resolves `true` on a
+ * successful copy and `false` when no clipboard mechanism is available — it
+ * never throws, so callers can offer "copy" without guarding for headless
+ * environments.
+ */
+export interface Clipboard {
+    copy(text: string): Promise<boolean>;
+}
+/** Spawns a platform clipboard helper, piping `text` to its stdin. */
+export type ClipboardRunner = (command: string, args: string[], text: string) => Promise<boolean>;
+/**
+ * Best-effort copy to the system clipboard. Returns `false` (never throws) when
+ * the platform helper is missing or fails. `os` and `runner` are injectable for
+ * tests so this stays free of real subprocess side-effects.
+ */
+export declare function copyToClipboard(text: string, options?: {
+    os?: NodeJS.Platform;
+    runner?: ClipboardRunner;
+}): Promise<boolean>;
+/** A clipboard that silently discards everything (headless / opt-out default). */
+export declare const noopClipboard: Clipboard;
+//# sourceMappingURL=clipboard.d.ts.map

package/dist/utils/clipboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard.d.ts","sourceRoot":"","sources":["../../src/utils/clipboard.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACtC;AAED,sEAAsE;AACtE,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAgClG;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,EAAE,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAAC,MAAM,CAAC,EAAE,eAAe,CAAA;CAAO,GAC/D,OAAO,CAAC,OAAO,CAAC,CAMlB;AAED,kFAAkF;AAClF,eAAO,MAAM,aAAa,EAAE,SAE3B,CAAC"}

package/dist/utils/git.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Runs a git subcommand and returns trimmed stdout, or `undefined` when git is
+ * unavailable / the command fails (e.g. outside a repo). Injectable so tests do
+ * not shell out.
+ */
+export type GitRunner = (args: string[], cwd: string) => Promise<string | undefined>;
+/** The default runner: invokes the real `git` binary via execFile. */
+export declare const defaultGitRunner: GitRunner;
+/** Absolute path of the git repository root containing `cwd`, if any. */
+export declare function repoRoot(cwd?: string, run?: GitRunner): Promise<string | undefined>;
+/** Current branch name (or `undefined` in a detached HEAD / non-repo). */
+export declare function currentBranch(cwd?: string, run?: GitRunner): Promise<string | undefined>;
+//# sourceMappingURL=git.d.ts.map

package/dist/utils/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/utils/git.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;AAErF,sEAAsE;AACtE,eAAO,MAAM,gBAAgB,EAAE,SAS3B,CAAC;AAEL,yEAAyE;AACzE,wBAAsB,QAAQ,CAC5B,GAAG,GAAE,MAAsB,EAC3B,GAAG,GAAE,SAA4B,GAChC,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAG7B;AAED,0EAA0E;AAC1E,wBAAsB,aAAa,CACjC,GAAG,GAAE,MAAsB,EAC3B,GAAG,GAAE,SAA4B,GAChC,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAI7B"}

package/dist/utils/highlight.d.ts

@@ -0,0 +1,23 @@
+/**
+ * A deliberately light syntax highlighter. It wraps a small set of token classes
+ * (keywords, strings, comments, numbers) in ANSI color codes for terminal
+ * output. It is language-agnostic and lossy by design — full grammar-aware
+ * highlighting is out of scope for the CLI; this is just enough to make code
+ * blocks readable. Pass {@link NO_HIGHLIGHT} (or `color: false`) to disable.
+ */
+export interface HighlightTheme {
+    keyword: string;
+    string: string;
+    comment: string;
+    number: string;
+    reset: string;
+}
+/** A no-op theme: every slot is empty, so {@link highlight} returns input as-is. */
+export declare const NO_HIGHLIGHT: HighlightTheme;
+/**
+ * Highlight a snippet. With the default ANSI theme, line comments (`//`, `#`),
+ * double/single-quoted strings, numeric literals, and keywords are colored.
+ * With {@link NO_HIGHLIGHT} the input is returned unchanged.
+ */
+export declare function highlight(code: string, theme?: HighlightTheme): string;
+//# sourceMappingURL=highlight.d.ts.map

package/dist/utils/highlight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"highlight.d.ts","sourceRoot":"","sources":["../../src/utils/highlight.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAUD,oFAAoF;AACpF,eAAO,MAAM,YAAY,EAAE,cAM1B,CAAC;AA+CF;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,cAAqB,GAAG,MAAM,CAM5E"}

package/dist/utils/index.d.ts

@@ -0,0 +1,6 @@
+export { formatResumeCommand } from "./resume";
+export { repoRoot, currentBranch, type GitRunner, defaultGitRunner } from "./git";
+export { copyToClipboard, type Clipboard, noopClipboard, type ClipboardRunner, } from "./clipboard";
+export { checkForUpdate, type VersionCheckOptions, type VersionCheckResult, type VersionFetcher, } from "./version-check";
+export { highlight, type HighlightTheme, NO_HIGHLIGHT } from "./highlight";
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,KAAK,SAAS,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAC;AAClF,OAAO,EACL,eAAe,EACf,KAAK,SAAS,EACd,aAAa,EACb,KAAK,eAAe,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,cAAc,EACd,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,cAAc,GACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/utils/resume.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Format the shell command a user runs to resume a session (§10 #51). The result
+ * ALWAYS begins with the AP3X binary name (`ap3x `) sourced from
+ * {@link APP_NAME}, never a hardcoded binary name. Covered by tests.
+ *
+ * @example formatResumeCommand("session-abc") // "ap3x --resume session-abc"
+ */
+export declare function formatResumeCommand(sessionId: string): string;
+//# sourceMappingURL=resume.d.ts.map

package/dist/utils/resume.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume.d.ts","sourceRoot":"","sources":["../../src/utils/resume.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE7D"}

package/dist/utils/version-check.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Compares the running version against a "latest" version obtained from an
+ * injectable fetcher. There is NO hardcoded external endpoint and no default
+ * network call: a check only runs when the caller supplies both a `source` URL
+ * and a `fetcher`, honoring the project's no-telemetry rule (the check is OFF by
+ * default).
+ */
+export interface VersionCheckResult {
+    current: string;
+    latest?: string;
+    updateAvailable: boolean;
+    /** Set when the check could not complete (no source, fetch error, …). */
+    skipped?: string;
+}
+/** Resolves the latest published version string from `source`. May reject. */
+export type VersionFetcher = (source: string, signal?: AbortSignal) => Promise<string>;
+export interface VersionCheckOptions {
+    /** Where to look up the latest version. Required — none is assumed. */
+    source?: string;
+    /** How to fetch it. Required — there is no built-in network default. */
+    fetcher?: VersionFetcher;
+    /** The running version. Defaults to the CLI {@link VERSION}. */
+    current?: string;
+    signal?: AbortSignal;
+}
+/** Compare two `a.b.c` version strings. Returns -1 / 0 / 1 (missing parts = 0). */
+export declare function compareVersions(a: string, b: string): number;
+/**
+ * Run a version check. Skips (no network, returns `skipped`) unless both a
+ * `source` and a `fetcher` are provided. Fetch failures degrade to a skipped
+ * result rather than throwing.
+ */
+export declare function checkForUpdate(options?: VersionCheckOptions): Promise<VersionCheckResult>;
+//# sourceMappingURL=version-check.d.ts.map

package/dist/utils/version-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-check.d.ts","sourceRoot":"","sources":["../../src/utils/version-check.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,OAAO,CAAC;IACzB,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,8EAA8E;AAC9E,MAAM,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAEvF,MAAM,WAAW,mBAAmB;IAClC,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,mFAAmF;AACnF,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAU5D;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,kBAAkB,CAAC,CAmB7B"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@ap3x/cli",
+  "version": "0.1.0",
+  "description": "Interactive coding-agent CLI",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AP3X-Dev/AP3X.git",
+    "directory": "packages/cli"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "ap3x": "./dist/bin.js"
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsup src/index.ts src/bin.ts --format esm --clean --tsconfig tsconfig.build.json && tsc -p tsconfig.build.json",
+    "prepublishOnly": "node ../../scripts/publish-gate.mjs",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@ap3x/a2a": "2.0.0",
+    "@ap3x/agent-core": "0.1.0",
+    "@ap3x/ai": "0.1.0",
+    "@ap3x/cadence": "0.1.0",
+    "@ap3x/observe": "0.1.0",
+    "@ap3x/swarms": "0.1.0",
+    "@ap3x/tui": "0.1.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "yaml": "^2.9.0"
+  }
+}