@oxygen-agent/cli 1.982.3 → 1.1003.12

package/dist/knowledge-mirror.d.ts

@@ -1,5 +1,5 @@
 export declare const GENERATED_MIRROR_FILE_HEADER = "<!-- generated by oxygen knowledge sync \u2014 local edits are overwritten -->";
-export type MirrorPageRecord = {
+type MirrorPageRecord = {
     id: string;
     revision: number;
     /** sha256 hex of the exact bytes the server rendered and this client wrote. */
@@ -98,7 +98,7 @@ export declare function acquireMirrorLock(dir: string, options?: {
 export declare function releaseMirrorLock(dir: string): void;
 export declare function writeGeneratedIndexFile(dir: string, index: MirrorIndexSnapshot): void;
 export declare function writeGeneratedLogFile(dir: string, entries: MirrorLogEntry[]): void;
-export type MirrorPushCandidate = {
+type MirrorPushCandidate = {
     slug: string;
     /** dirty = tracked page whose local bytes drifted; new = untracked local file. */
     kind: "dirty" | "new";

package/dist/runtime.d.ts

@@ -1,20 +1,5 @@
 declare const DEV_CLI_BINARY = "oxygen-dev";
 declare const PROD_CLI_BINARY = "oxygen";
-/**
- * Pins a terminal to a *host*, not to a profile label.
- *
- * `OXYGEN_PROFILE=default` was the guard prescribed after the last profile drift
- * (OXY-4081), and it cannot work: `default` is a name, and `login` writes an
- * `apiUrl` into whatever name is active — so the profile called `default` became
- * dev and the pin followed it there (OXY-4109). Every credit balance, ticket, and
- * whoami then came back from dev looking exactly like a healthy production answer.
- *
- * The invariant that a staff runbook actually needs is the host it dialed. Set
- * `OXYGEN_REQUIRE_API_URL=https://oxygen-agent.com` and any command that resolves
- * somewhere else refuses to run instead of quietly answering from the wrong
- * environment.
- */
-export declare const REQUIRED_API_URL_ENV = "OXYGEN_REQUIRE_API_URL";
 export type CliBinaryName = typeof DEV_CLI_BINARY | typeof PROD_CLI_BINARY;
 /**
  * Where a command actually sent its request, and what put it there.

package/dist/runtime.js

@@ -17,7 +17,7 @@ const PROD_CLI_BINARY = "oxygen";
  * somewhere else refuses to run instead of quietly answering from the wrong
  * environment.
  */
-export const REQUIRED_API_URL_ENV = "OXYGEN_REQUIRE_API_URL";
+const REQUIRED_API_URL_ENV = "OXYGEN_REQUIRE_API_URL";
 export function resolveCliBinaryName(env = process.env, argv = process.argv) {
     const explicit = normalizeBinaryName(env.OXYGEN_CLI_BINARY ?? env.OXYGEN_CLI_NAME);
     if (explicit)

package/dist/session.d.ts

@@ -1,17 +1,17 @@
 export type SessionStepStatus = "pending" | "running" | "completed" | "error" | "skipped";
-export type SessionStep = {
+type SessionStep = {
     label: string;
     status: SessionStepStatus;
     startedAt: string | null;
     completedAt: string | null;
 };
-export type SessionStatusMessage = {
+type SessionStatusMessage = {
     id: string;
     message: string;
     stepIndex: number | null;
     createdAt: string;
 };
-export type SessionOutput = {
+type SessionOutput = {
     id: string;
     type: "csv" | "file" | "table";
     path: string | null;
@@ -54,3 +54,4 @@ export declare function addSessionOutput(input: {
 export declare function getSessionUsage(input: {
     sessionId?: string | null;
 }): Record<string, unknown>;
+export {};

package/dist/skills.d.ts

@@ -7,7 +7,8 @@ export type SkillsInstallOptions = {
     apiUrl?: string;
     agents?: string | string[];
     skill?: string;
-    project?: boolean;
+    /** `true` for the current directory, or the project directory to install into. */
+    project?: boolean | string;
     copy?: boolean;
 };
 export type SkillsListOptions = {
@@ -33,12 +34,6 @@ export type AutomaticSkillsInstallResult = {
         details?: unknown;
     };
 };
-export type SkillsAccessResponse = {
-    base_url: string;
-    index_url: string;
-    expires_at: string;
-    skills_version?: string;
-};
 export type SkillsInstallSource = {
     authenticated: boolean;
     /** Base URL handed to `npx skills add` (tokenized when authenticated). */
@@ -72,6 +67,12 @@ options: SkillsInstallOptions, runtime?: {
     execFileSync?: ExecFileSyncLike;
     spawnSync?: SpawnSyncLike;
 } & SkillsSourceRuntime): Promise<Record<string, unknown>>;
+/**
+ * `--project` is a bare flag for the current directory, or names the project
+ * directory to install into. `--project .` used to fail with "too many
+ * arguments" (2026-09-16 blind baseline) because the flag took no value.
+ */
+export declare function resolveSkillProjectDir(project: boolean | string | undefined): string | null;
 export declare function runAutomaticSkillsInstall(options?: {
     apiUrl?: string;
     env?: NodeJS.ProcessEnv;

package/dist/skills.js

@@ -2,7 +2,7 @@ import { spawnSync } from "node:child_process";
 import { existsSync, mkdirSync, mkdtempSync, readdirSync, rmSync, writeFileSync } from "node:fs";
 import { homedir, tmpdir } from "node:os";
 import { dirname, join, resolve } from "node:path";
-import { OxygenError, inferUserCapabilityRoute, serializeCapabilityRoute, toFailure, } from "@oxygen/shared";
+import { OxygenError, errorMessage, inferUserCapabilityRoute, serializeCapabilityRoute, toFailure, } from "@oxygen/shared";
 import { defaultApiUrl, loadCredentials, normalizeApiUrl } from "./credentials.js";
 import { requestOxygen } from "./http-client.js";
 import { isRecord, readOption } from "./util.js";
@@ -226,7 +226,8 @@ options, runtime = {}) {
     const env = runtime.env ?? process.env;
     const platform = runtime.platform ?? process.platform;
     const spawn = runtime.spawnSync ?? wrapExecFileSync(runtime.execFileSync) ?? spawnSync;
-    const installLocations = resolveSkillInstallLocations(agents, options.project === true, env);
+    const projectDir = resolveSkillProjectDir(options.project);
+    const installLocations = resolveSkillInstallLocations(agents, projectDir, env);
     // The vendored installer writes immediately once spawned. Tell humans and
     // agents the exact destination first so a default global install is never a
     // surprise, while keeping stdout as one stable JSON envelope under --json.
@@ -268,6 +269,8 @@ options, runtime = {}) {
             const result = spawn(invocation.executable, invocation.args, {
                 encoding: "utf8",
                 env,
+                // A project install lands relative to the installer's working directory.
+                ...(projectDir ? { cwd: projectDir } : {}),
                 stdio: ["ignore", "pipe", "pipe"],
                 windowsHide: true,
                 ...(platform === "win32" ? { windowsVerbatimArguments: true } : {}),
@@ -342,11 +345,25 @@ options, runtime = {}) {
         summary: summarizeInstallOutcome(agents.length, skippedAgents.length, 0),
     };
 }
-function resolveSkillInstallLocations(agents, project, env) {
+/**
+ * `--project` is a bare flag for the current directory, or names the project
+ * directory to install into. `--project .` used to fail with "too many
+ * arguments" (2026-09-16 blind baseline) because the flag took no value.
+ */
+export function resolveSkillProjectDir(project) {
+    if (project === true)
+        return process.cwd();
+    if (typeof project === "string" && project.trim())
+        return resolve(project.trim());
+    return null;
+}
+function resolveSkillInstallLocations(agents, projectDir, env) {
+    const project = projectDir !== null;
+    const base = projectDir ?? process.cwd();
     const projectRoots = {
-        codex: resolve(".agents", "skills"),
-        "claude-code": resolve(".claude", "skills"),
-        cursor: resolve(".agents", "skills"),
+        codex: resolve(base, ".agents", "skills"),
+        "claude-code": resolve(base, ".claude", "skills"),
+        cursor: resolve(base, ".agents", "skills"),
     };
     const globalRoots = {
         codex: join(env.CODEX_HOME?.trim() || join(homedir(), ".codex"), "skills"),
@@ -356,7 +373,7 @@ function resolveSkillInstallLocations(agents, project, env) {
     const roots = project ? projectRoots : globalRoots;
     return agents.map((agent) => ({
         agent,
-        path: roots[agent] ?? (project ? resolve(".agents", "skills") : join(homedir(), ".agents", "skills")),
+        path: roots[agent] ?? (project ? resolve(base, ".agents", "skills") : join(homedir(), ".agents", "skills")),
     }));
 }
 /**
@@ -448,9 +465,6 @@ function stagingFailure(stage, details) {
         exitCode: 1,
     });
 }
-function errorMessage(error) {
-    return error instanceof Error ? error.message : String(error);
-}
 // Best-effort resolution of a skill's declared prerequisite skills from the
 // index. Any failure (unreachable index, parse error, unknown skill) yields no
 // dependencies so a dependency lookup can never block or fail an install.

package/dist/transcript.d.ts

@@ -1,4 +1,4 @@
-export type TranscriptSource = "claude_code" | "codex" | "cursor" | "file";
+type TranscriptSource = "claude_code" | "codex" | "cursor" | "file";
 export type CapturedTranscript = {
     source: TranscriptSource;
     session_id: string | null;
@@ -19,3 +19,4 @@ export declare class TranscriptCaptureError extends Error {
 }
 export declare function captureCurrentTranscript(options?: CaptureOptions): CapturedTranscript | null;
 export declare function collectFeedbackEnvironment(): Record<string, string>;
+export {};

package/dist/ugc-commands.d.ts

@@ -1,6 +1,3 @@
-import { Command } from "commander";
-type Handle = (command: string, options: {
-    json?: boolean;
-}, action: () => Promise<unknown>) => Promise<void>;
-export declare function registerUgcCommands(program: Command, handle: Handle): void;
-export {};
+import type { Command } from "commander";
+import { type UgcCommandDependencies } from "@oxygen/cli-ugc";
+export declare function registerUgcCommands(program: Command, handle: UgcCommandDependencies["handle"]): void;