@phnx-labs/agents-cli 0.1.0 → 1.14.1

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,7 +70,9 @@ 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';
+/** A file created or modified during a session, discovered from tool_use events. */
 export interface SessionArtifact {
     path: string;
     tool: string;
@@ -66,4 +81,3 @@ export interface SessionArtifact {
     sizeBytes?: number;
     sessionId: string;
 }
-//# sourceMappingURL=types.d.ts.map

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

@@ -49,8 +49,16 @@ export declare function promptConflictStrategy(conflictInfos: ConflictInfo[]): P
  *   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 = 4;
 export declare function generateShimScript(agent: AgentId): string;
 /**
  * Create a shim for an agent.
@@ -71,8 +79,12 @@ export declare function removeShim(agent: AgentId): boolean;
  *   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 = 2;
+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
@@ -83,6 +95,9 @@ export declare function generateVersionedAliasScript(agent: AgentId, version: st
  * 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
@@ -90,6 +105,9 @@ export declare function isVersionedAliasCurrent(agent: AgentId, version: string)
  * 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.
@@ -141,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.
  */
@@ -175,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.
  */
@@ -187,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[];
@@ -225,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