@phnx-labs/agents-cli 1.12.0 → 1.14.2

package/dist/lib/session/types.d.ts

@@ -1,5 +1,16 @@
-export type SessionAgentId = 'claude' | 'codex' | 'gemini' | 'opencode' | 'openclaw';
+/**
+ * Session data model.
+ *
+ * Normalized types that unify the different session storage formats used by
+ * Claude (JSONL), Codex (JSONL events), Gemini (single JSON), and OpenCode.
+ * Everything in the session pipeline -- discovery, parsing, rendering --
+ * speaks these types.
+ */
+/** Agents that store session data on disk and can be discovered by `agents sessions`. */
+export type SessionAgentId = 'claude' | 'codex' | 'gemini' | 'opencode' | 'openclaw' | 'rush' | 'hermes';
+/** All agents with session discovery support, in display order. */
 export declare const SESSION_AGENTS: SessionAgentId[];
+/** A single normalized event within a session (message, tool call, thinking, etc.). */
 export interface SessionEvent {
     type: 'message' | 'tool_use' | 'tool_result' | 'thinking' | 'error' | 'init' | 'result' | 'usage' | 'attachment';
     agent: SessionAgentId;
@@ -22,12 +33,14 @@ export interface SessionEvent {
     mediaType?: string;
     sizeBytes?: number;
 }
+/** Metadata attached when a session was spawned by `agents teams`. */
 export interface TeamOrigin {
     /** Teammate name if set, otherwise first 8 chars of the agent UUID. */
     handle?: string;
     /** Agent mode: 'plan', 'edit', or 'full'. */
     mode?: string;
 }
+/** Lightweight metadata for a discovered session, used in listings and pickers. */
 export interface SessionMeta {
     id: string;
     shortId: string;
@@ -57,5 +70,14 @@ export interface SessionMeta {
     /** BM25 relevance score from the most recent content-index search */
     _bm25Score?: number;
 }
+/** Output format for rendering a session's content. */
 export type ViewMode = 'summary' | 'markdown' | 'json';
-//# sourceMappingURL=types.d.ts.map
+/** A file created or modified during a session, discovered from tool_use events. */
+export interface SessionArtifact {
+    path: string;
+    tool: string;
+    timestamp: string;
+    exists: boolean;
+    sizeBytes?: number;
+    sessionId: string;
+}

package/dist/lib/session/types.js

@@ -1,2 +1,10 @@
-export const SESSION_AGENTS = ['claude', 'codex', 'gemini', 'opencode', 'openclaw'];
-//# sourceMappingURL=types.js.map
+/**
+ * Session data model.
+ *
+ * Normalized types that unify the different session storage formats used by
+ * Claude (JSONL), Codex (JSONL events), Gemini (single JSON), and OpenCode.
+ * Everything in the session pipeline -- discovery, parsing, rendering --
+ * speaks these types.
+ */
+/** All agents with session discovery support, in display order. */
+export const SESSION_AGENTS = ['claude', 'codex', 'gemini', 'opencode', 'openclaw', 'rush', 'hermes'];

package/dist/lib/shims.d.ts

@@ -26,7 +26,7 @@ export declare function promptConflictStrategy(conflictInfos: ConflictInfo[]): P
  * Generate the shim script content for an agent.
  *
  * The shim resolves the version in order:
- * 1. .agents-version in cwd (walk up to root)
+ * 1. agents.yaml in project root (walk up from $PWD, skip ~/.agents/agents.yaml)
  * 2. ~/.agents/agents.yaml default
  *
  * If version is specified but not installed, auto-installs it.
@@ -46,8 +46,19 @@ export declare function promptConflictStrategy(conflictInfos: ConflictInfo[]): P
  *        shim hook for non-@-capable agents.
  *   v3 — sync/refresh-memory flag renamed `--version` → `--agent-version`
  *        so it no longer collides with commander's top-level `--version`.
+ *   v4 — project version marker changed from `.agents-version` to a
+ *        root-level `agents.yaml`; shim now skips ~/.agents/agents.yaml
+ *        when walking up for a project marker.
+ *   v5 — emit CODEX_HOME for codex shims so the versioned config (permissions,
+ *        sandbox_mode, rules/agents-deny.rules) is actually read by the codex
+ *        binary instead of $HOME/.codex.
+ *   v6 — hard-disable Codex startup update checks in the generated shims.
+ */
+export declare const SHIM_SCHEMA_VERSION = 6;
+/**
+ * Generate the full bash shim script for the given agent. The returned string
+ * is written to ~/.agents/shims/{cliCommand} and made executable.
  */
-export declare const SHIM_SCHEMA_VERSION = 3;
 export declare function generateShimScript(agent: AgentId): string;
 /**
  * Create a shim for an agent.
@@ -57,11 +68,47 @@ export declare function createShim(agent: AgentId): string;
  * Remove the shim for an agent.
  */
 export declare function removeShim(agent: AgentId): boolean;
+/**
+ * Current versioned-alias schema. Bump whenever `generateVersionedAliasScript`
+ * changes in a way that requires existing on-disk aliases to be regenerated.
+ *
+ * History:
+ *   v1 — implicit (no marker); no CLAUDE_CONFIG_DIR export, so direct
+ *        `claude@X` invocations leaked into ~/.claude (the default version's
+ *        symlinked home) and `agents view` never saw the login.
+ *   v2 — emit CLAUDE_CONFIG_DIR for claude aliases so each version has its
+ *        own isolated config/OAuth slot; stamp a version marker so stale
+ *        aliases can be detected and regenerated.
+ *   v3 — emit CODEX_HOME for codex aliases so direct `codex@X` invocations
+ *        read the versioned permissions/rules instead of $HOME/.codex.
+ *   v4 — direct aliases read binaries and config homes from ~/.agents-system.
+ *   v5 — hard-disable Codex startup update checks in versioned aliases.
+ */
+export declare const VERSIONED_ALIAS_SCHEMA_VERSION = 5;
 /**
  * Generate a versioned alias script that directly execs a specific version.
  * e.g., claude@2.0.65 -> directly runs that version's binary
  */
 export declare function generateVersionedAliasScript(agent: AgentId, version: string): string;
+/**
+ * Read the schema version of an on-disk versioned alias. Returns null if the
+ * alias doesn't exist or is a pre-v2 alias (no marker — treated as stale).
+ */
+export declare function readVersionedAliasSchemaVersion(agent: AgentId, version: string): number | null;
+/**
+ * True if the on-disk versioned alias matches the current schema version.
+ */
+export declare function isVersionedAliasCurrent(agent: AgentId, version: string): boolean;
+/**
+ * Regenerate a versioned alias if missing or stale. Mirrors ensureShimCurrent
+ * for the main shim — callers can surface a one-line notice when something
+ * was upgraded.
+ */
+export declare function ensureVersionedAliasCurrent(agent: AgentId, version: string): 'created' | 'updated' | 'current';
+/**
+ * Get the filesystem path for a versioned alias script.
+ */
+export declare function getVersionedAliasPath(agent: AgentId, version: string): string;
 /**
  * Create a versioned alias for a specific agent version.
  * e.g., claude@2.0.65
@@ -112,6 +159,34 @@ export declare function switchHomeFileSymlinks(agent: AgentId, version: string):
     switched: string[];
     errors: string[];
 };
+/**
+ * Claude reads `.claude.json` at `$CLAUDE_CONFIG_DIR/.claude.json`. Our shim
+ * points CLAUDE_CONFIG_DIR at `<ver>/home/.claude`, so Claude's real config
+ * file lives at `<ver>/home/.claude/.claude.json` (INSIDE), while
+ * `switchHomeFileSymlinks` manages `<ver>/home/.claude.json` (OUTSIDE).
+ *
+ * To keep both views consistent we make INSIDE a symlink to OUTSIDE. Claude's
+ * atomic write (`Uf6`) resolves symlinks before the tmp+rename cycle, so the
+ * symlink survives across writes and OUTSIDE remains the single source of
+ * truth that agents-cli's home-file machinery already manages.
+ *
+ * This function idempotently reconciles one version:
+ *   - INSIDE missing: create symlink -> `../.claude.json` (create OUTSIDE if needed).
+ *   - INSIDE already symlink to OUTSIDE: no-op.
+ *   - INSIDE is a real file: it's the authoritative auth state (Claude was
+ *     writing to it). Move its content to OUTSIDE (merging with OUTSIDE,
+ *     INSIDE wins for `oauthAccount`), then replace INSIDE with the symlink.
+ *   - Symlink points elsewhere: replace it.
+ */
+export declare function ensureClaudeInsideSymlink(version: string): void;
+/**
+ * Apply `ensureClaudeInsideSymlink` to every installed Claude version.
+ * Safe to call repeatedly; per-version calls are idempotent.
+ */
+export declare function ensureAllClaudeInsideSymlinks(): {
+    migrated: string[];
+    errors: string[];
+};
 /**
  * Get the current config symlink target version, if any.
  */
@@ -146,6 +221,14 @@ export declare function getShimPath(agent: AgentId): string;
  * resolving against PATH, excluding the managed shim itself.
  */
 export declare function getPathShadowingExecutable(agent: AgentId): string | null;
+/**
+ * Check if the agent's CLI command is shadowed by a shell alias.
+ *
+ * Shell aliases live in the user's session and aren't visible from a Node.js
+ * child process. We do a best-effort scan of common RC files for `alias
+ * <command>=` patterns. Returns false when detection is inconclusive.
+ */
+export declare function hasAliasShadowingShim(agent: AgentId): boolean;
 /**
  * Check if shims directory is in PATH.
  */
@@ -158,18 +241,24 @@ export declare function getPathSetupInstructions(): string;
  * Add shims directory to shell PATH configuration.
  * Returns true if added, false if already present or failed.
  */
-export declare function addShimsToPath(): {
+export declare function addShimsToPath(overrides?: {
+    homeDir?: string;
+    shell?: string;
+    shimsDir?: string;
+}): {
     success: boolean;
     alreadyPresent?: boolean;
     rcFile?: string;
     error?: string;
 };
+export declare function listAgentsWithInstalledVersions(): AgentId[];
 /**
  * Create shims for all installed agents.
  */
 export declare function ensureAllShims(): void;
 /**
- * Resource diff between two versions.
+ * Resource diff between two versions. Each field lists resources present in
+ * the current version but missing from the target.
  */
 export interface ResourceDiff {
     commands: string[];
@@ -196,4 +285,3 @@ export declare function hasResourceDiff(diff: ResourceDiff): boolean;
  * Only copies resources listed in the diff (i.e., ones missing in target).
  */
 export declare function copyResourcesToVersion(agent: AgentId, fromVersion: string, toVersion: string, diff: ResourceDiff): void;
-//# sourceMappingURL=shims.d.ts.map