@ap3x/cli 0.1.0

package/dist/cli.d.ts

@@ -0,0 +1,135 @@
+import { type A2aBinding, serveA2a } from "@ap3x/a2a";
+import { type StreamFn } from "@ap3x/agent-core";
+import type { AnthropicLoginResult, LoginAnthropicOptions } from "./auth/anthropic-login";
+import type { LoginResult, LoginWithChatGPTOptions } from "./auth/codex-login";
+import type { CopilotLoginResult, LoginGitHubCopilotOptions } from "./auth/copilot-login";
+import { type CronCliDeps } from "./cron/cron-cli";
+import { type InteractiveInput, type InteractiveRenderer } from "./modes";
+import { type AgentSessionRuntime } from "./sdk";
+import { type PartialSettings, type Settings, SettingsManager } from "./settings";
+/** The run mode dispatched from parsed arguments. F2 implements each runner. */
+export type RunMode = "interactive" | "print" | "rpc" | "help" | "version" | "login" | "logout" | "serve";
+/** Output format for {@link RunMode} "print". */
+export type PrintFormat = "text" | "json";
+/** Fully parsed CLI options. */
+export interface ParsedArgs {
+    mode: RunMode;
+    /** Initial prompt (positional args joined), if any. */
+    prompt?: string;
+    /** Model id override (e.g. "claude-sonnet-4-5"). */
+    model?: string;
+    /** Provider slug override. */
+    provider?: string;
+    /** Print-mode output format. */
+    format: PrintFormat;
+    /** Resume an existing session by id. */
+    resume?: string;
+    /** Continue the most recent session. */
+    continueSession: boolean;
+    /** Working directory override. */
+    cwd?: string;
+    /** Explicit active tool set (comma-separated on the CLI). */
+    tools?: string[];
+    /** Reasoning intensity override. */
+    thinking?: "off" | "minimal" | "low" | "medium" | "high" | "xhigh";
+    /** Override the config directory (maps to AP3X_CONFIG_DIR). */
+    configDir?: string;
+    /** `serve`: port to bind (0 = ephemeral). Default 7423. */
+    port?: number;
+    /** `serve`: host to bind. Default 127.0.0.1. */
+    host?: string;
+    /** `serve`: bearer token callers must present (overrides settings). */
+    a2aToken?: string;
+    /** `serve`: transport bindings to mount. Default ["jsonrpc"]. */
+    a2aBindings?: A2aBinding[];
+    /** `serve`: cap retained TERMINAL tasks; 0 = unbounded. Default {@link DEFAULT_SERVE_MAX_RETAINED_TASKS}. */
+    maxRetainedTasks?: number;
+    /** `serve`: cap retained context transcripts (LRU); 0 = unbounded. Default {@link DEFAULT_SERVE_MAX_RETAINED_CONTEXTS}. */
+    maxRetainedContexts?: number;
+    /** Unknown flags encountered during parsing (reported, not fatal in F1). */
+    unknown: string[];
+}
+/** Raised for malformed argument input (e.g. a flag missing its value). */
+export declare class ArgError extends Error {
+    constructor(message: string);
+}
+/**
+ * Parse the raw CLI argument vector into {@link ParsedArgs}. Supports the full
+ * F1 flag surface; the actual run-mode dispatch is F2. Long flags accept either
+ * `--flag value` or `--flag=value`. Unknown flags are collected (not fatal) so
+ * the caller can decide how strict to be.
+ */
+export declare function parseArgs(args: string[]): ParsedArgs;
+/** Translate parsed args into a {@link PartialSettings} flag layer. */
+export declare function argsToSettings(parsed: ParsedArgs): PartialSettings;
+/** The CLI help text. */
+export declare function printHelp(): string;
+/** The version banner. */
+export declare function printVersion(): string;
+/** A sink for CLI output; injectable so tests don't write to real stdio. */
+export interface CliIO {
+    out: (text: string) => void;
+    err: (text: string) => void;
+}
+export declare function resolveRuntime(parsed: ParsedArgs, overrides?: {
+    /**
+     * Custom provider stream function threaded into the runtime's backend
+     * (tests inject a capturing/canned stream so no provider call happens).
+     * Production callers omit it — the wiring is otherwise identical.
+     */
+    streamFn?: StreamFn;
+    /**
+     * Replace the base system prompt (the env-aware coding prompt) wholesale.
+     * Used by `ap3x cron` payloads that carry their own systemPrompt; skills
+     * still compose on top when the read tool is active.
+     */
+    systemPrompt?: string;
+}): Promise<{
+    runtime: AgentSessionRuntime;
+    resolved: Settings;
+    settings: SettingsManager;
+    /**
+     * First-run auth signal (R10): true when a model resolved but no usable
+     * credential was found (no API key AND no auth headers). `main()` turns this
+     * into an actionable message instead of failing deep in a provider call.
+     * Optional so injected faux runtimes (tests) opt out by omission (undefined =
+     * no gate).
+     */
+    authMissing?: boolean;
+}>;
+/** Options for {@link main}; every IO/runtime seam is injectable for tests. */
+export interface MainOptions {
+    io?: CliIO;
+    /** Override runtime/settings construction (tests inject a faux backend). */
+    buildRuntime?: (parsed: ParsedArgs) => Promise<{
+        runtime: AgentSessionRuntime;
+        resolved: Settings;
+        settings: SettingsManager;
+        authMissing?: boolean;
+    }>;
+    /** Override the interactive input source (tests script a sequence). */
+    interactiveInput?: InteractiveInput;
+    /** Override the interactive renderer (tests capture lines). */
+    interactiveRenderer?: InteractiveRenderer;
+    /** Override the ChatGPT/Codex login flow (tests inject; no real IO). */
+    loginCodex?: (options?: LoginWithChatGPTOptions) => Promise<LoginResult>;
+    /** Override the Anthropic (Claude Pro/Max) login flow (tests inject). */
+    loginAnthropic?: (options?: LoginAnthropicOptions) => Promise<AnthropicLoginResult>;
+    /** Override the GitHub Copilot device-code login flow (tests inject). */
+    loginCopilot?: (options?: LoginGitHubCopilotOptions) => Promise<CopilotLoginResult>;
+    /** `serve` shutdown seam: aborting stops the server (tests; SIGINT otherwise). */
+    serveSignal?: AbortSignal;
+    /** `serve` override: inspect/replace the A2A publish call (tests spy the options). */
+    serveA2a?: typeof serveA2a;
+    /** `cron` dependency overrides (tests stub the store dir / executor / signal). */
+    cronDeps?: Partial<Omit<CronCliDeps, "io">>;
+}
+/**
+ * The CLI entry point. Parses arguments and dispatches to a run mode:
+ * help/version print and exit; `print` runs a single-shot task; `rpc` runs the
+ * JSONL loop over stdio; otherwise the interactive REPL. Honors `resume` /
+ * `continue` by recording the intent on the built runtime. Returns a process
+ * exit code (no bare `process.exit` in the testable path).
+ */
+export declare function main(args: string[], options?: MainOptions): Promise<number>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

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

package/dist/cron/agent-executor.d.ts

@@ -0,0 +1,45 @@
+/**
+ * The AP3X agent-backed {@link Executor} for `ap3x cron`. cadence owns the WHEN
+ * (due computation, exactly-once, retries, timeouts); this executor owns the
+ * WHAT: it validates the schedule's payload and runs ONE agent turn with the
+ * payload's prompt.
+ *
+ * Every fire is a fresh one-shot run: no conversation carries over between
+ * occurrences (each fire builds its own runtime/session, exactly like
+ * `ap3x -p "<prompt>"`). The actual prompt run is injected as a
+ * {@link CronPromptRunner} so the executor itself stays free of runtime/auth
+ * wiring — `main()` supplies the production runner (built on `resolveRuntime`)
+ * and tests supply a stub.
+ */
+import type { ExecutionContext, ExecutionOutcome, Executor } from "@ap3x/cadence";
+/** What a cron schedule's `payload` must carry to be runnable by the agent. */
+export declare const CronPayloadSchema: import("@sinclair/typebox").TObject<{
+    prompt: import("@sinclair/typebox").TString;
+    model: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    provider: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    systemPrompt: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+/** The validated shape of {@link CronPayloadSchema}. */
+export interface CronPayload {
+    prompt: string;
+    model?: string;
+    provider?: string;
+    systemPrompt?: string;
+}
+/** One prompt run handed to the injected runner. */
+export interface CronPromptRun extends CronPayload {
+    /** Aborted by the cadence engine on timeout or shutdown. */
+    signal: AbortSignal;
+}
+/**
+ * Runs one agent turn and resolves with the final assistant text. Must reject
+ * (or return promptly) when `signal` aborts.
+ */
+export type CronPromptRunner = (run: CronPromptRun) => Promise<string>;
+/** cadence Executor that runs each occurrence as a one-shot agent prompt. */
+export declare class CronAgentExecutor implements Executor {
+    #private;
+    constructor(runPrompt: CronPromptRunner);
+    execute(ctx: ExecutionContext): Promise<ExecutionOutcome>;
+}
+//# sourceMappingURL=agent-executor.d.ts.map

package/dist/cron/agent-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-executor.d.ts","sourceRoot":"","sources":["../../src/cron/agent-executor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAIlF,+EAA+E;AAC/E,eAAO,MAAM,iBAAiB;;;;;EAK5B,CAAC;AAEH,wDAAwD;AACxD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,oDAAoD;AACpD,MAAM,WAAW,aAAc,SAAQ,WAAW;IAChD,4DAA4D;IAC5D,MAAM,EAAE,WAAW,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAEvE,6EAA6E;AAC7E,qBAAa,iBAAkB,YAAW,QAAQ;;gBAGpC,SAAS,EAAE,gBAAgB;IAIjC,OAAO,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAyBhE"}

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

@@ -0,0 +1,27 @@
+import { type Clock, type Executor } from "@ap3x/cadence";
+import type { CliIO } from "../cli";
+/** Injectable dependencies for {@link runCronCli}; tests stub every seam. */
+export interface CronCliDeps {
+    io: CliIO;
+    /**
+     * Build the executor `run` fires occurrences through. Receives the
+     * `--config-dir` override (if any) so the production agent runner resolves
+     * settings/auth from the same config dir the store lives under.
+     */
+    createExecutor: (configDir?: string) => Executor;
+    /** Store directory override (tests use a temp dir). Default: `<configDir>/cron`. */
+    storeDir?: string;
+    /** Clock override (tests inject a TestClock). Default: the system clock. */
+    clock?: Clock;
+    /** Id source override (tests pin ids). Default: `crypto.randomUUID`. */
+    idFactory?: () => string;
+    /** `run` shutdown seam: aborting stops the scheduler (tests; SIGINT otherwise). */
+    signal?: AbortSignal;
+    /** Engine poll cadence override for `run`. */
+    pollIntervalMs?: number;
+}
+/** The `ap3x cron` help text. */
+export declare function printCronHelp(): string;
+/** Run the `ap3x cron` subcommand tree. Never throws; returns an exit code. */
+export declare function runCronCli(args: string[], deps: CronCliDeps): Promise<number>;
+//# sourceMappingURL=cron-cli.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cron-cli.d.ts","sourceRoot":"","sources":["../../src/cron/cron-cli.ts"],"names":[],"mappings":"AAeA,OAAO,EACL,KAAK,KAAK,EAEV,KAAK,QAAQ,EAKd,MAAM,eAAe,CAAC;AAEvB,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAOpC,6EAA6E;AAC7E,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,KAAK,CAAC;IACV;;;;OAIG;IACH,cAAc,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,KAAK,QAAQ,CAAC;IACjD,oFAAoF;IACpF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,MAAM,CAAC;IACzB,mFAAmF;IACnF,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,8CAA8C;IAC9C,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,iCAAiC;AACjC,wBAAgB,aAAa,IAAI,MAAM,CA0CtC;AAmDD,+EAA+E;AAC/E,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CA8MnF"}

package/dist/cron/schedule-file.d.ts

@@ -0,0 +1,7 @@
+import type { NewSchedule } from "@ap3x/cadence";
+export declare class ScheduleFileError extends Error {
+    constructor(message: string);
+}
+/** Parses a markdown schedule file: YAML frontmatter = schedule config, body = agent prompt. */
+export declare function parseScheduleFile(content: string, filePath: string): NewSchedule;
+//# sourceMappingURL=schedule-file.d.ts.map

package/dist/cron/schedule-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-file.d.ts","sourceRoot":"","sources":["../../src/cron/schedule-file.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAGjD,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,OAAO,EAAE,MAAM;CAI5B;AA8BD,gGAAgG;AAChG,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW,CAgChF"}

package/dist/glob.d.ts

@@ -0,0 +1,12 @@
+/**
+ * A tiny, dependency-free glob matcher supporting the subset the CLI needs:
+ * `*` (any run of non-separator chars), `**` (any run including separators),
+ * `?` (a single non-separator char), and literal segments. Paths are matched
+ * with `/` separators. This is deliberately small — not a full POSIX glob — and
+ * keeps `@ap3x/cli` free of external glob dependencies.
+ */
+/** Compile a glob pattern into an anchored regular expression. */
+export declare function globToRegExp(pattern: string): RegExp;
+/** Test whether `path` (using `/` separators) matches `pattern`. */
+export declare function minimatch(path: string, pattern: string): boolean;
+//# sourceMappingURL=glob.d.ts.map

package/dist/glob.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob.d.ts","sourceRoot":"","sources":["../src/glob.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,kEAAkE;AAClE,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAqBpD;AAED,oEAAoE;AACpE,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAEhE"}

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

@@ -0,0 +1,11 @@
+import type { CliIO } from "../cli";
+export interface HooksCliDeps {
+    io: CliIO;
+    /** `--config-dir`-style override for the user hooks file. */
+    configDir?: string;
+    /** Project root; default process.cwd(). */
+    cwd?: string;
+}
+export declare function printHooksHelp(): string;
+export declare function runHooksCli(args: string[], deps: HooksCliDeps): Promise<number>;
+//# sourceMappingURL=hooks-cli.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-cli.d.ts","sourceRoot":"","sources":["../../src/hooks/hooks-cli.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAEpC,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,KAAK,CAAC;IACV,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,cAAc,IAAI,MAAM,CAmBvC;AAwDD,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAgFrF"}

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+export declare const PACKAGE = "@ap3x/cli";
+export declare const VERSION = "0.1.0";
+export { APP_NAME, DISPLAY_NAME, CONFIG_DIR_NAME, ENV_PREFIX, ENV_CONFIG_DIR, SETTINGS_FILE_NAME, SESSIONS_DIR_NAME, LOGS_DIR_NAME, SKILLS_DIR_NAME, resolveConfigDir, resolveSettingsPath, resolveSessionsDir, resolveLogsDir, resolveSkillsDir, CRON_DIR_NAME, resolveCronDir, HOOKS_FILE_NAME, resolveHooksPath, TRACES_DIR_NAME, resolveTracesDir, } from "./branding";
+export { CronAgentExecutor, CronPayloadSchema, type CronPayload, type CronPromptRun, type CronPromptRunner, } from "./cron/agent-executor";
+export { type CronCliDeps, printCronHelp, runCronCli } from "./cron/cron-cli";
+export { type HooksCliDeps, printHooksHelp, runHooksCli } from "./hooks/hooks-cli";
+export { type TraceCliDeps, printTraceHelp, runTraceCli } from "./trace/trace-cli";
+export { loadSkillsFromDir, composeSystemPromptWithSkills } from "./skills";
+export { buildCodingAgentSystemPrompt, resolveEnvContext, type EnvContext, } from "./system-prompt";
+export { type Settings, type PartialSettings, type RemoteAgentConfig, DEFAULT_SETTINGS, parsePartialSettings, SettingsManager, settingsFromEnv, mergeSettings, } from "./settings";
+export { type ParsedArgs, type RunMode, type PrintFormat, type CliIO, type MainOptions, ArgError, main, resolveRuntime, parseArgs, argsToSettings, printHelp, printVersion, } from "./cli";
+export { InteractiveMode, welcomeBanner, type InteractiveModeOptions, type InteractiveInput, type InteractiveRenderer, runPrintMode, type PrintModeOptions, runRpcMode, RpcClient, RpcCommandSchema, RPC_COMMANDS, parseRpcLine, frameResponse, nodeRpcInput, nodeRpcOutput, type RpcCommand, type RpcResponse, type RpcError, type RpcSessionState, type RpcInput, type RpcOutput, type RpcModeOptions, renderAgentEvent, renderUsage, assistantText, toPrintJson, type PrintJsonResult, } from "./modes";
+export { BUILTIN_SLASH_COMMANDS, type SlashCommand, type SlashContext, type SlashResult, dispatchSlashCommand, findSlashCommand, isSlashCommand, } from "./slash-commands";
+export { type CallbackParams, DEFAULT_CALLBACK_PORTS, defaultOpenBrowser, type LoginResult, type LoginWithChatGPTOptions, type LoopbackServer, loginWithChatGPT, logoutCodex, type StartLoopbackServer, startRealLoopbackServer, } from "./auth/codex-login";
+export { type CopilotLoginResult, type LoginGitHubCopilotOptions, loginGitHubCopilot, } from "./auth/copilot-login";
+export { type AnthropicCallbackParams, type AnthropicLoginResult, type AnthropicLoopbackServer, DEFAULT_ANTHROPIC_CALLBACK_PORTS, type LoginAnthropicOptions, loginAnthropic, logoutAnthropic, parseAuthorizationInput, refreshAnthropic, type RefreshAnthropicOptions, type StartAnthropicLoopbackServer, startRealAnthropicLoopbackServer, } from "./auth/anthropic-login";
+export { formatResumeCommand, repoRoot, currentBranch, type GitRunner, defaultGitRunner, copyToClipboard, type Clipboard, noopClipboard, type ClipboardRunner, checkForUpdate, type VersionCheckOptions, type VersionCheckResult, type VersionFetcher, highlight, type HighlightTheme, NO_HIGHLIGHT, } from "./utils";
+export { AgentSession, type AgentSessionEvent, type AgentSessionListener, type AgentSessionOptions, type AgentSessionServices, AgentSessionRuntime, type AgentSessionRuntimeConfig, createAgentSession, createAgentSessionFromServices, createAgentSessionServices, createAgentSessionRuntime, createAgentSessionRuntimeFromServices, createSession, } from "./sdk";
+export { type ToolContext, type SwarmBackend, createToolContext, createReadTool, createWriteTool, createEditTool, createBashTool, createLsTool, createGrepTool, createFindTool, createAllTools, createCodingTools, createReadOnlyTools, createRunSwarmTool, createAutoSwarmTool, createBuildAgentTool, createSwarmTools, createCallAgentTool, createA2aTools, selectTools, withFileMutationQueue, ALL_TOOL_NAMES, READ_ONLY_TOOL_NAMES, } from "./tools";
+export { globToRegExp, minimatch } from "./glob";
+export { MODELS, getModel, getModels, getProviders, getSupportedThinkingLevels, clampThinkingLevel, modelsAreEqual, calculateCost, getEnvApiKey, findEnvKeys, type Model, } from "@ap3x/ai";
+export { Session, createSessionId, buildSessionContext, InMemorySessionStorage, JsonlSessionStorage, type SessionStorage, type SessionContext, type SessionMetadata, type SessionEntry, } from "@ap3x/agent-core";
+export { compact, shouldCompact, estimateContextTokens, DEFAULT_COMPACTION_SETTINGS, type CompactionSettings, type CompactionResult, } from "@ap3x/agent-core";
+export { type AgentBackend, type AgentRunResult, type AgentRunOptions, Ap3xRuntimeBackend, createRuntimeBackend, Agent, type AgentMessage, type AnyAgentTool, defineTool, } from "@ap3x/agent-core";
+export { matchBlocklist, isBlockedCommand } from "@ap3x/agent-core";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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