@oxygen-agent/cli 1.1014.1874 → 1.1014.1895

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -34,4 +34,4 @@ oxygen update
34
34
 
35
35
  For product documentation, visit https://oxygen-agent.com/docs. For support, visit https://oxygen-agent.com.
36
36
 
37
- Version: 1.1014.1874
37
+ Version: 1.1014.1895
@@ -103,6 +103,18 @@ export declare function canReadProductSkillInstructions(name: string, entitlemen
103
103
  agencyPartner: boolean;
104
104
  internalDev?: boolean;
105
105
  }): boolean;
106
+ /**
107
+ * Largest `oxygen_skills_get` result, in serialized characters, that an agent
108
+ * runtime keeps whole in the transcript instead of storing it behind a preview.
109
+ * A play or reference is read to be followed: stored, the model saw only the
110
+ * file list in the 600-character preview, and a stored copy holds the body on one
111
+ * escaped line that grep and line reads cut at 4,000 characters. Sized to fit
112
+ * every served Markdown file whole (largest 2026-10-23: oxygen-ugc/operations.md,
113
+ * 39,744 escaped characters; plays at most 13,550; SKILL.md at most 8,136), pinned
114
+ * by the skills get route test. Only the 203 KB oxygen-gtm/prompts.json asset is
115
+ * over it, and it is over the store's ceiling too.
116
+ */
117
+ export declare const PRODUCT_SKILL_READ_INLINE_CHARS = 48000;
106
118
  /** Identify hosted instruction bodies by native tool lineage, never by user prose. */
107
119
  export declare function readProductSkillInstructionResult(capabilityName: string, result: unknown): {
108
120
  slug: string | null;
@@ -800,6 +800,18 @@ export function canReadProductSkillInstructions(name, entitlements) {
800
800
  : undefined;
801
801
  return audience === "workspace" || (audience === "internal_dev" && entitlements.internalDev === true) || (audience === "agency_partner" && entitlements.agencyPartner);
802
802
  }
803
+ /**
804
+ * Largest `oxygen_skills_get` result, in serialized characters, that an agent
805
+ * runtime keeps whole in the transcript instead of storing it behind a preview.
806
+ * A play or reference is read to be followed: stored, the model saw only the
807
+ * file list in the 600-character preview, and a stored copy holds the body on one
808
+ * escaped line that grep and line reads cut at 4,000 characters. Sized to fit
809
+ * every served Markdown file whole (largest 2026-10-23: oxygen-ugc/operations.md,
810
+ * 39,744 escaped characters; plays at most 13,550; SKILL.md at most 8,136), pinned
811
+ * by the skills get route test. Only the 203 KB oxygen-gtm/prompts.json asset is
812
+ * over it, and it is over the store's ceiling too.
813
+ */
814
+ export const PRODUCT_SKILL_READ_INLINE_CHARS = 48_000;
803
815
  /** Identify hosted instruction bodies by native tool lineage, never by user prose. */
804
816
  export function readProductSkillInstructionResult(capabilityName, result) {
805
817
  if (capabilityName !== "oxygen_skills_get")
@@ -13,9 +13,13 @@ export type LogContext = {
13
13
  item_id?: string | undefined;
14
14
  worker_id?: string | undefined;
15
15
  surface?: "mcp" | "cli" | "web" | "worker" | undefined;
16
+ /** The browser's PostHog session (apps/web `analytics/posthog-session`): finds the replay. */
17
+ posthog_session_id?: string | undefined;
16
18
  };
17
19
  export declare function withLogContext<T>(ctx: LogContext, fn: () => T): T;
18
20
  export declare function enterLogContext(ctx: LogContext): void;
21
+ /** The active request's PostHog session, so its server-side events join the replay. */
22
+ export declare function currentPostHogSessionId(): string | undefined;
19
23
  export declare function logLevelForHttpStatus(status: number): LogLevel;
20
24
  export type LogSink = (record: Record<string, unknown>) => void;
21
25
  export declare function takeWebLogVolumeCount(): number;
@@ -34,6 +34,10 @@ export function enterLogContext(ctx) {
34
34
  function getLogContext() {
35
35
  return store.getStore() ?? {};
36
36
  }
37
+ /** The active request's PostHog session, so its server-side events join the replay. */
38
+ export function currentPostHogSessionId() {
39
+ return store.getStore()?.posthog_session_id;
40
+ }
37
41
  const CANONICAL_SURFACES = new Set(["mcp", "cli", "web", "worker"]);
38
42
  // Call-site fields deliberately win over the ambient context (a caller must be able to
39
43
  // override org_id, provider, run_id...). `surface` is the one exception: it is a RESERVED
@@ -58,3 +58,22 @@ export declare function onboardingResearchToolAllowed(toolId: unknown): boolean;
58
58
  export declare const ONBOARDING_RESEARCH_HUB_SLUGS: readonly ["company", "offers", "icp", "plays", "signals", "competitors", "team"];
59
59
  /** Knowledge page types a research sub-agent may not write: canonical voice and positioning stay proposal-gated. */
60
60
  export declare const ONBOARDING_RESEARCH_DENIED_PAGE_TYPES: readonly ["voice", "brand", "positioning", "message_playbook", "playbook"];
61
+ export type OnboardingResearchHubPage = {
62
+ slug: (typeof ONBOARDING_RESEARCH_HUB_SLUGS)[number];
63
+ title: string;
64
+ type: "entity" | "topic";
65
+ status: "draft";
66
+ summary: string;
67
+ body: string;
68
+ };
69
+ /**
70
+ * The seven hub pages the research links its pages to, written by the server
71
+ * before the research turn starts. The turn's first model call wrote them, and
72
+ * the researchers waited on that call: 9.4 s of a 41 s research in production
73
+ * (2026-10-23), for pages that only restate the company and link each other.
74
+ */
75
+ export declare function onboardingResearchHubPages(company: {
76
+ name?: string | null;
77
+ website?: string | null;
78
+ linkedin_url?: string | null;
79
+ }): OnboardingResearchHubPage[];
@@ -75,3 +75,36 @@ export function onboardingResearchToolAllowed(toolId) {
75
75
  export const ONBOARDING_RESEARCH_HUB_SLUGS = ["company", "offers", "icp", "plays", "signals", "competitors", "team"];
76
76
  /** Knowledge page types a research sub-agent may not write: canonical voice and positioning stay proposal-gated. */
77
77
  export const ONBOARDING_RESEARCH_DENIED_PAGE_TYPES = ["voice", "brand", "positioning", "message_playbook", "playbook"];
78
+ const HUB_TOPICS = [
79
+ { slug: "offers", title: "Offers", collects: "what the company sells, to whom and at what price" },
80
+ { slug: "icp", title: "ICP & buyers", collects: "the companies that fit best and the people who buy" },
81
+ { slug: "plays", title: "Outbound plays", collects: "the outbound plays worth running first" },
82
+ { slug: "signals", title: "Signals", collects: "the events that make a company ready to buy now" },
83
+ { slug: "competitors", title: "Competitors", collects: "who the company competes with and how it differs" },
84
+ { slug: "team", title: "Team & sales", collects: "the company's people and how it sells today" },
85
+ ];
86
+ /**
87
+ * The seven hub pages the research links its pages to, written by the server
88
+ * before the research turn starts. The turn's first model call wrote them, and
89
+ * the researchers waited on that call: 9.4 s of a 41 s research in production
90
+ * (2026-10-23), for pages that only restate the company and link each other.
91
+ */
92
+ export function onboardingResearchHubPages(company) {
93
+ const name = company.name?.trim() || "Your company";
94
+ const facts = [
95
+ company.website?.trim() ? `Website: ${company.website.trim()}` : null,
96
+ company.linkedin_url?.trim() ? `LinkedIn: ${company.linkedin_url.trim()}` : null,
97
+ ].filter((line) => line !== null);
98
+ return [
99
+ {
100
+ slug: "company", title: name, type: "entity", status: "draft",
101
+ summary: `${name}: the company this workspace sells for.`,
102
+ body: [`# ${name}`, ...facts, "", ...HUB_TOPICS.map((hub) => `- [[${hub.slug}]]: ${hub.collects}`)].join("\n"),
103
+ },
104
+ ...HUB_TOPICS.map((hub) => ({
105
+ slug: hub.slug, title: hub.title, type: "topic", status: "draft",
106
+ summary: `${hub.title} for ${name}: ${hub.collects}.`,
107
+ body: `# ${hub.title}\nThis hub collects ${hub.collects} for [[company]].`,
108
+ })),
109
+ ];
110
+ }
@@ -1 +1 @@
1
- export declare const OXYGEN_BUILD_VERSION = "1.1014.1874";
1
+ export declare const OXYGEN_BUILD_VERSION = "1.1014.1895";
@@ -1,2 +1,2 @@
1
1
  // GENERATED by scripts/ci/version-stamp.mjs from VERSION + git history. Do not edit; do not commit.
2
- export const OXYGEN_BUILD_VERSION = "1.1014.1874";
2
+ export const OXYGEN_BUILD_VERSION = "1.1014.1895";
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@oxygen-agent/cli",
3
- "version": "1.1014.1874",
3
+ "version": "1.1014.1895",
4
4
  "private": false,
5
5
  "license": "UNLICENSED",
6
6
  "type": "module",