@oxygen-agent/cli 1.1014.136 → 1.1014.618

package/node_modules/@oxygen/shared/dist/user-capability-routing.js

@@ -13,6 +13,34 @@ export function capabilityDiscoveryRecovery(query, surface) {
 // the user-facing boundary while preserving table joins and channel-specific
 // connection routes.
 export function inferUserCapabilityRoute(query) {
+    const normalized = query.toLowerCase().replace(/[_-]+/g, " ");
+    if (isUnconfirmedLookupReviewIntent(normalized)) {
+        const route = getCapabilityRouteMatch("observability");
+        if (route)
+            return {
+                ...route,
+                card: { ...route.card, posture: "read_only", execution: "Read the Run and its provider events. Inspect original outcomes and billing evidence before any retry; this read settles nothing and starts no provider call." },
+                recommendedTools: ["oxygen_runs_list", "oxygen_runs_get", "oxygen_observability_events"],
+                recommendedCommands: ["runs list", "runs get", "observability events"],
+                exactCommand: "oxygen runs list --limit 5 --json",
+                exactMcpCall: { tool: "oxygen_runs_list", arguments: { limit: 5 } },
+            };
+    }
+    if (isSignupCompanyResearchReadIntent(normalized)) {
+        const route = getCapabilityRouteMatch("knowledge-graph");
+        if (route)
+            return {
+                ...route,
+                card: { ...route.card, posture: "read_only", execution: "Check saved signup company research, its Run and cited pages. Status spends no credits and starts no research." },
+                recommendedTools: ["oxygen_knowledge_bootstrap", "oxygen_runs_get", "oxygen_knowledge_page_get"],
+                recommendedCommands: ["knowledge bootstrap status", "runs get", "knowledge page get"],
+                exactCommand: "oxygen knowledge bootstrap status --json",
+                exactMcpCall: { tool: "oxygen_knowledge_bootstrap", arguments: { status: true } },
+            };
+    }
+    const oxygents = oxygentsRoute(normalized);
+    if (oxygents)
+        return oxygents;
     if (/\b(ongoing worker|ongoing session|long horizon agent|campaign monitor|watch (?:a |one |this |the |specific )?campaign)\b/i.test(query)) {
         const route = getCapabilityRouteMatch("agents");
         if (route)
@@ -27,6 +55,22 @@ export function inferUserCapabilityRoute(query) {
                 recommendedCommands: ["integrations connect", ...setup.recommendedCommands.filter((command) => command !== "integrations connect")],
             };
     }
+    if (isWikiMetadataInventoryIntent(query)) {
+        const knowledge = getCapabilityRouteMatch("knowledge-graph");
+        if (knowledge)
+            return {
+                ...knowledge,
+                card: {
+                    ...knowledge.card,
+                    posture: "read_only",
+                    execution: "Read bounded stored wiki revision/hash metadata; follow next_cursor for remaining pages. No semantic retrieval, writes or credits.",
+                },
+                recommendedTools: ["oxygen_knowledge_sync_manifest"],
+                recommendedCommands: ["knowledge sync-manifest"],
+                exactCommand: "oxygen knowledge sync-manifest --limit 5 --json",
+                exactMcpCall: { tool: "oxygen_knowledge_sync_manifest", arguments: { limit: 5 } },
+            };
+    }
     const route = inferCapabilityRoute(query);
     const providerConnectionIntent = isSimpleProviderConnectionIntent(query);
     if (!providerConnectionIntent
@@ -42,6 +86,82 @@ export function inferUserCapabilityRoute(query) {
     // intent is exactly what this wrapper exists to answer.
     return getCapabilityRouteMatch("connected-integrations") ?? route;
 }
+function isSignupCompanyResearchReadIntent(query) {
+    return /\bcompany research\b|\bresearch (?:the |my |our )?company\b/.test(query)
+        && /\bsign\s?up\b|\bonboard\w*\b|\bworkspace setup\b|\bnew workspace\b/.test(query)
+        && !/\b(?:start|execute|force|rerun|replay)\b/.test(query);
+}
+function isUnconfirmedLookupReviewIntent(query) {
+    return /\b(?:review|inspect|investigate|check|explain)\b/.test(query)
+        && /\b(?:uncertain|unconfirmed|unknown|unsettled)\b/.test(query)
+        && /\b(?:lookup|provider|supplier|research)\b/.test(query)
+        && /\b(?:outcome|spend|cost|credits?|effect|run)\b/.test(query);
+}
+/**
+ * The `oxygents` operation an ask names (its MCP verb), first match wins: a
+ * removal or copy beats the create words a name can carry ("delete the new
+ * bot"), a group beats its members' verbs, and reading or opening a chat beats
+ * the message words its object carries ("read my chat with it").
+ */
+const OXYGENT_VERBS = [
+    ["delete", /\b(?:delet\w*|remov\w*|eras\w*|destroy\w*|get rid of)\b/],
+    ["duplicate", /\b(?:cop(?:y|ies|ying)|duplicat\w*|clon\w*)\b/],
+    ["notify", /\b(?:notif\w*|mute\w*|unmute\w*|silenc\w*)\b/],
+    ["group_create", /\b(?:creat\w*|start\w*|new|make)\b.*\bgroups?\b|\bgroups?\b.*\b(?:creat\w*|start\w*)\b/],
+    ["groups", /\bgroups?\b/],
+    ["update", /\b(?:renam\w*|edit\w*|updat\w*|chang\w*)\b/],
+    ["pin", /\b(?:pin|pins|pinned|pinning|unpin\w*)\b/],
+    ["hide", /\b(?:hid(?:e|es|ing|den)|unhid\w*)\b/],
+    ["remember", /\bremember\w*\b/],
+    ["forget", /\bforget\w*\b/],
+    ["memory", /\bmemor\w*\b/],
+    ["notes", /\bnotes?\b/],
+    ["routines", /\b(?:routines?|recurring|schedul\w*)\b/],
+    ["task", /\b(?:background|tasks?)\b/],
+    ["activity", /\b(?:activit\w*|work log|runs?)\b/],
+    ["read", /\b(?:unread|mark\w*\b.*\bread)\b/],
+    ["get", /\b(?:read|see|view|show|history|transcript)\b/],
+    ["chat", /\bopen\w*\b/],
+    ["message", /\b(?:message\w*|ask|tell|send|talk|chat|hand\w* off|handoff|delegat\w*)\b/],
+    ["create", /\b(?:creat\w*|add|new|make|set up|spawn|hire)\b/],
+];
+/**
+ * Oxygents (AI teammates, ADR 0032) share the Agents card, whose gateway is the
+ * Agent commands, so an ask naming one got `agent list/create/run` and, in
+ * `commands search`, no `oxygents` command at all (blind CLI evals, 2026-10-13
+ * and 2026-10-14). Only an explicit Oxygent ask moves: a plain "agent" ask,
+ * and a person's human "teammate", keep their owners.
+ */
+function oxygentsRoute(normalized) {
+    if (!/\b(?:oxygents?|ai teammates?)\b/.test(normalized))
+        return null;
+    const route = getCapabilityRouteMatch("agents");
+    if (!route)
+        return null;
+    const verb = OXYGENT_VERBS.find(([, words]) => words.test(normalized))?.[0] ?? "list";
+    const verbs = [...new Set([verb, "list", "get"])];
+    return {
+        ...route,
+        recommendedTools: verbs.map((name) => `oxygen_oxygents_${name}`),
+        recommendedCommands: verbs.map((name) => `oxygents ${name.replace(/_/g, "-")}`),
+        ...(verb === "list"
+            ? { exactCommand: "oxygen oxygents list --json", exactMcpCall: { tool: "oxygen_oxygents_list", arguments: {} } }
+            : {}),
+    };
+}
+/** Manifest reads current, unfiltered page metadata; it cannot satisfy other scopes. */
+function isWikiMetadataInventoryIntent(query) {
+    const normalized = query.toLowerCase().replace(/[_-]+/g, " ");
+    return /\b(?:wiki|knowledge)\b/.test(normalized)
+        && (/\b(?:inventory|manifest)\b/.test(normalized)
+            || (/\bpages?\b/.test(normalized) && /\bcontent hash\b/.test(normalized)))
+        && /\b(?:read|list|inspect|show|get|fetch|view|metadata|revision|content hash|cursor)\b/.test(normalized)
+        && !/\b(?:writ\w*|rewrit\w*|updat\w*|edit\w*|chang\w*|replac\w*|renam\w*|delet\w*|remov\w*|creat\w*|import\w*|generat\w*|propos\w*|approv\w*|restor\w*|rollback|archiv\w*|append\w*|add\w*|mov\w*|pin\w*|seed\w*|sync\w*|publish\w*|unpublish\w*|api key|credentials?|connect\w*)\b/.test(normalized)
+        && !/\b(?:histor\w*|previous|older?|repos?(?:itory|itories)?|github|mount\w*|files?|filter\w*|exclud\w*|except|tombstones?|tag\w*|status(?:es)?|drafts?|types?|only|specific|titles?|paths?|folders?|collections?)\b/.test(normalized)
+        && !/\b(?:at|before|after)\s+(?:revision|version)\b/.test(normalized)
+        && !/\b(?:revision|version)\s+\d/.test(normalized)
+        && !/\b(?:body|bodies|markdown|text|rendered)\b|\bcontent\b(?!\s+hash)/.test(normalized);
+}
 // The words that mean "this is Tables work, not a provider connection". Hand-typing
 // them drifted: the list covered table/row/column/dataset/join/relate but not csv,
 // import, enrich, waterfall, formula, lookup or score -- all of which the Tables card

package/node_modules/@oxygen/shared/dist/version.generated.d.ts

@@ -1 +1 @@
-export declare const OXYGEN_BUILD_VERSION = "1.1014.136";
+export declare const OXYGEN_BUILD_VERSION = "1.1014.618";

package/node_modules/@oxygen/shared/dist/version.generated.js

@@ -1,2 +1,2 @@
 // GENERATED by scripts/ci/version-stamp.mjs from VERSION + git history. Do not edit; do not commit.
-export const OXYGEN_BUILD_VERSION = "1.1014.136";
+export const OXYGEN_BUILD_VERSION = "1.1014.618";

package/node_modules/@oxygen/shared/dist/visual-render.d.ts

@@ -14,6 +14,13 @@ export type VisualRenderRequest = {
     scale: 1 | 2;
     formats: ("png" | "pdf")[];
 };
+/**
+ * What a render costs the customer: nothing (Tim, 2026-10-14: "the rendering
+ * shouldn't cost credits that's just stupid"). The platform's own compute stays
+ * bounded by `maxCostMicros` and the managed-spend limiter. Renders previewed
+ * before then carry the tariff they were quoted in `credits`; none is charged.
+ */
+export declare const VISUAL_RENDER_CREDITS = 0;
 export type VisualRenderProfile = {
     version: typeof VISUAL_RENDER_PROFILE;
     renderSnapshotId: string;
@@ -23,8 +30,9 @@ export type VisualRenderProfile = {
     credits: number;
     maxCostMicros: number;
 };
+/** The same renderer and compute bound. The quoted credits are not part of it: no render is charged. */
 export declare function visualRenderProfilesMatch(a: VisualRenderProfile, b: VisualRenderProfile): boolean;
 export declare function validateVisualFileId(value: unknown): string;
 export declare function parseVisualRenderRequest(value: Record<string, unknown>): VisualRenderRequest;
-/** No default snapshot or tariff: enabling this profile is an explicit deployment operation. */
+/** No default snapshot or compute bound: enabling this profile is an explicit deployment operation. */
 export declare function resolveVisualRenderProfile(env: Record<string, string | undefined>, now?: number): VisualRenderProfile | null;

package/node_modules/@oxygen/shared/dist/visual-render.js

@@ -5,10 +5,18 @@ export const VISUAL_RENDER_LIMITS = Object.freeze({
     maxSourceBytes: 2 * 1024 * 1024, maxOutputBytes: 50 * 1024 * 1024,
     timeoutMs: 120_000,
 });
+/**
+ * What a render costs the customer: nothing (Tim, 2026-10-14: "the rendering
+ * shouldn't cost credits that's just stupid"). The platform's own compute stays
+ * bounded by `maxCostMicros` and the managed-spend limiter. Renders previewed
+ * before then carry the tariff they were quoted in `credits`; none is charged.
+ */
+export const VISUAL_RENDER_CREDITS = 0;
+/** The same renderer and compute bound. The quoted credits are not part of it: no render is charged. */
 export function visualRenderProfilesMatch(a, b) {
     return a.version === b.version && a.renderSnapshotId === b.renderSnapshotId
         && a.validatorSnapshotId === b.validatorSnapshotId && a.rendererDigest === b.rendererDigest
-        && a.expiresAt === b.expiresAt && a.credits === b.credits && a.maxCostMicros === b.maxCostMicros;
+        && a.expiresAt === b.expiresAt && a.maxCostMicros === b.maxCostMicros;
 }
 const uuid = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
 export function validateVisualFileId(value) {
@@ -37,19 +45,18 @@ export function parseVisualRenderRequest(value) {
     }
     return { source_file_ids, width, height, scale, formats: formats };
 }
-/** No default snapshot or tariff: enabling this profile is an explicit deployment operation. */
+/** No default snapshot or compute bound: enabling this profile is an explicit deployment operation. */
 export function resolveVisualRenderProfile(env, now = Date.now()) {
     const renderSnapshotId = env.OXYGEN_VISUAL_RENDER_SNAPSHOT_ID?.trim();
     const validatorSnapshotId = env.OXYGEN_VISUAL_VALIDATOR_SNAPSHOT_ID?.trim();
     const rendererDigest = env.OXYGEN_VISUAL_RENDERER_DIGEST?.trim();
     const expiresAt = env.OXYGEN_VISUAL_PROFILE_EXPIRES_AT?.trim();
-    const credits = Number(env.OXYGEN_VISUAL_RENDER_CREDITS);
     const maxCostMicros = Number(env.OXYGEN_VISUAL_RENDER_MAX_COST_MICROS);
     if (env.OXYGEN_VISUAL_RENDER_ENABLED !== "1" || !renderSnapshotId || !validatorSnapshotId
         || renderSnapshotId === validatorSnapshotId || !rendererDigest || !/^[a-f0-9]{64}$/.test(rendererDigest)
         || !expiresAt || !Number.isFinite(Date.parse(expiresAt)) || Date.parse(expiresAt) <= now + 180_000
-        || !Number.isFinite(credits) || credits <= 0 || credits > 1000
         || !Number.isSafeInteger(maxCostMicros) || maxCostMicros < 50_000 || maxCostMicros > 1_000_000)
         return null;
-    return { version: VISUAL_RENDER_PROFILE, renderSnapshotId, validatorSnapshotId, rendererDigest, expiresAt, credits, maxCostMicros };
+    return { version: VISUAL_RENDER_PROFILE, renderSnapshotId, validatorSnapshotId, rendererDigest, expiresAt,
+        credits: VISUAL_RENDER_CREDITS, maxCostMicros };
 }

package/node_modules/@oxygen/shared/dist/warmup-metrics.d.ts

@@ -0,0 +1,5 @@
+/** SendKit reports placement and independent send totals, not rescues or a failure count.
+ * Normalize old caches at the shared read boundary without rewriting stored evidence.
+ * Other rails retain their explicitly reported rescue and failure counters.
+ */
+export declare function normalizeWarmupMetrics(record: Record<string, unknown> | null, provider?: string | null): Record<string, unknown> | null;

package/node_modules/@oxygen/shared/dist/warmup-metrics.js

@@ -0,0 +1,44 @@
+import { isRecord } from "./type-guards.js";
+const SPAM_PLACEMENT_KEYS = ["landed_spam", "spam", "saved_from_spam", "savedFromSpam", "spam_saved", "rescued_from_spam"];
+const RESCUE_KEYS = SPAM_PLACEMENT_KEYS.slice(2);
+/** SendKit reports placement and independent send totals, not rescues or a failure count.
+ * Normalize old caches at the shared read boundary without rewriting stored evidence.
+ * Other rails retain their explicitly reported rescue and failure counters.
+ */
+export function normalizeWarmupMetrics(record, provider) {
+    if (!record)
+        return null;
+    const managed = [record.provider, provider].some((value) => value === "sendkit" || value === "oxygen_warmup");
+    if (!managed)
+        return record;
+    const normalizeCounts = (row) => {
+        const result = { ...row };
+        const keys = "landed_spam" in row ? ["landed_spam"] : SPAM_PLACEMENT_KEYS;
+        result.landed_spam = keys.map((key) => {
+            const raw = row[key];
+            const value = typeof raw === "number" ? raw : typeof raw === "string" && raw.trim() ? Number(raw) : NaN;
+            return Number.isFinite(value) && value >= 0 ? value : null;
+        }).find((value) => value !== null) ?? null;
+        for (const key of RESCUE_KEYS)
+            delete result[key];
+        delete result.spam;
+        result.saved_from_spam = null;
+        // Even a positive difference is unproven: these totals have different windows.
+        result.failed_to_send = null;
+        result.send_counters_comparable = false;
+        return result;
+    };
+    const result = normalizeCounts(record);
+    for (const key of ["aggregate_data", "summary", "totals"]) {
+        if (isRecord(record[key]))
+            result[key] = normalizeCounts(record[key]);
+    }
+    for (const key of ["daily", "days", "per_day", "email_date_data", "date_data"]) {
+        const rows = record[key];
+        if (Array.isArray(rows))
+            result[key] = rows.map((row) => isRecord(row) ? normalizeCounts(row) : row);
+        else if (isRecord(rows))
+            result[key] = Object.fromEntries(Object.entries(rows).map(([date, row]) => [date, isRecord(row) ? normalizeCounts(row) : row]));
+    }
+    return result;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oxygen-agent/cli",
-  "version": "1.1014.136",
+  "version": "1.1014.618",
   "private": false,
   "license": "UNLICENSED",
   "type": "module",