@oxygen-agent/cli 1.1013.27 → 1.1013.38

package/README.md

@@ -34,4 +34,4 @@ oxygen update
 
 For product documentation, visit https://oxygen-agent.com/docs. For support, visit https://oxygen-agent.com.
 
-Version: 1.1013.27
+Version: 1.1013.38

package/node_modules/@oxygen/cli-ugc/dist/commands.js

@@ -4,7 +4,7 @@ export function registerUgcCommands(program, { request: requestOxygen, handle })
         .command("ugc")
         .description("Manage UGC programs and independent creator participations: voice, posts, approvals, sponsorship and bounded amplification. Requires UGC availability. Start with memberships list in a creator workspace. See the oxygen-ugc skill; JSON reads return web_url for inspection.");
     const groupDescriptions = {
-        programs: "Programs you operate or joined; discover public programs from other brands and apply to them. Lifecycle: create, update, duplicate (settings), archive (stops future work, keeps shared history, reversible with restore) and delete (permanent; only while no creator has ever joined).",
+        programs: "Programs you operate or joined; discover public programs from other brands and apply to or join them. Lifecycle: create, update, duplicate (settings), archive (stops future work, keeps shared history, reversible with restore) and delete (permanent; only while no creator has ever joined).",
         creators: "Creator participations: invite, set one creator's own posting deal, revoke an invite, accept in the creator workspace, connect a sender, change approval authority, or revoke.",
         memberships: "Active programs this creator workspace has joined, each with your deal (posting_target), this period's progress and your published posts. Your own numbers only. Read these before choosing a program for a personal post.",
         applications: "Applications to public programs: the ones you sent as a creator, or the ones your program received as a brand.",
@@ -83,9 +83,15 @@ export function registerUgcCommands(program, { request: requestOxygen, handle })
         .action((options) => handle("ugc creators invitation", options, () => requestOxygen(`/api/cli/ugc?${new URLSearchParams({ view: "invitation", token: String(options.token) })}`)));
     group("programs")
         .command("discover")
-        .description("Public programs from every brand on Oxygen that you can apply to, with each brand's deal and brief excerpt, and whether you already joined or applied. Free, read-only.")
+        .description("Public programs from every brand on Oxygen that you can apply to, with each brand's deal, brief excerpt and join_policy (automatic: you join at once; approval: the brand decides), and whether you already joined or applied. Free, read-only.")
+        .option("--program-id <id>", "Only this program, e.g. the id in a join link (…/ugc?join=<id>).")
         .option("--json", "Print a JSON envelope.")
-        .action((options) => handle("ugc programs discover", options, () => requestOxygen("/api/cli/ugc?view=discover")));
+        .action((options) => handle("ugc programs discover", options, () => {
+        const query = new URLSearchParams({ view: "discover" });
+        if (options.programId)
+            query.set("program_id", String(options.programId));
+        return requestOxygen(`/api/cli/ugc?${query}`);
+    }));
     group("applications")
         .command("list")
         .description("Applications to public programs. Without --program-id: the ones this creator workspace sent, with status. With --program-id: the ones your program received (brand), pending first. Read-only.")
@@ -336,7 +342,13 @@ export function registerUgcCommands(program, { request: requestOxygen, handle })
                 {
                     name: "visibility",
                     kind: "string",
-                    description: "private (default: invitation only) or public (listed in every creator's Discover, where creators apply and you approve).",
+                    description: "private (default: invitation only) or public (listed in every creator's Discover, where creators apply).",
+                    required: false,
+                },
+                {
+                    name: "join_policy",
+                    kind: "string",
+                    description: "Public programs only: approval (default: you approve each application) or automatic (creators join at once, from Discover or the program's join_url). automatic needs --visibility public.",
                     required: false,
                 },
             ],
@@ -397,7 +409,13 @@ export function registerUgcCommands(program, { request: requestOxygen, handle })
                 {
                     name: "visibility",
                     kind: "string",
-                    description: "private (default: invitation only) or public (listed in every creator's Discover, where creators apply and you approve).",
+                    description: "private (invitation only; also turns automatic join off) or public (listed in every creator's Discover, where creators apply).",
+                    required: false,
+                },
+                {
+                    name: "join_policy",
+                    kind: "string",
+                    description: "approval (you approve each application) or automatic (creators join at once, from Discover or the program's join_url). automatic needs a public program. programs get shows join_policy and join_url.",
                     required: false,
                 },
                 {
@@ -544,10 +562,10 @@ export function registerUgcCommands(program, { request: requestOxygen, handle })
         {
             action: "application_create",
             command: "programs apply",
-            description: "Apply to a public program from programs discover, with a short note to the brand. The brand approves or declines; approval makes you a creator in the program and emails you. Free: 0 credits.",
+            description: "Join or apply to a public program from programs discover or a join link: with join_policy automatic you join at once (joined: true, with your participation); otherwise the brand approves or declines (joined: false), and approval makes you a creator and emails you. Free: 0 credits.",
             fields: [
-                { name: "program_id", kind: "string", description: "Public program ID from programs discover.", required: true },
-                { name: "message", kind: "string", description: "Your note to the brand (up to 600 characters).", required: true },
+                { name: "program_id", kind: "string", description: "Public program ID from programs discover or a join link (…/ugc?join=<id>).", required: true },
+                { name: "message", kind: "string", description: "Your note to the brand (up to 600 characters). Required unless the program's join_policy is automatic.", required: false },
                 { name: "linkedin_url", kind: "string", description: "Your LinkedIn profile URL; passing it also saves it to your profile. Omit to use the one on your profile (ugc profile get); if neither exists, ask the person rather than guess.", required: false },
             ],
         },

package/node_modules/@oxygen/shared/dist/ugc.d.ts

@@ -8,6 +8,13 @@ export type UgcPostingTarget = {
 };
 export declare const UGC_POSTING_TARGET_MAX = 100;
 export declare const UGC_POSTING_TARGET_PERIODS: readonly ["week", "month", "total"];
+/**
+ * How creators get into a public program (Tim, 2026-10-09): the brand approves
+ * each application, or an application joins at once. Private programs are
+ * joined by invitation only, so they are always `approval`.
+ */
+export declare const UGC_JOIN_POLICIES: readonly ["approval", "automatic"];
+export type UgcJoinPolicy = (typeof UGC_JOIN_POLICIES)[number];
 /**
  * The operator-written creator brief: one page, not a document (Philipp, 2026-09-23;
  * raised from 1,200 on 2026-09-29, when a natural founder brief ran 1,298 and blind
@@ -44,6 +51,8 @@ export type UgcProgram = {
     /** Posts each creator is expected to publish per period; both null when unset. */
     postingTargetCount?: number | null;
     postingTargetPeriod?: UgcPostingTargetPeriod | null;
+    /** How creators join while the program is public; older rows read as approval. */
+    joinPolicy?: UgcJoinPolicy;
     status: "active" | "archived";
     createdAt: Date;
     updatedAt: Date;

package/node_modules/@oxygen/shared/dist/ugc.js

@@ -1,5 +1,11 @@
 export const UGC_POSTING_TARGET_MAX = 100;
 export const UGC_POSTING_TARGET_PERIODS = ["week", "month", "total"];
+/**
+ * How creators get into a public program (Tim, 2026-10-09): the brand approves
+ * each application, or an application joins at once. Private programs are
+ * joined by invitation only, so they are always `approval`.
+ */
+export const UGC_JOIN_POLICIES = ["approval", "automatic"];
 /**
  * The operator-written creator brief: one page, not a document (Philipp, 2026-09-23;
  * raised from 1,200 on 2026-09-29, when a natural founder brief ran 1,298 and blind

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

@@ -1 +1 @@
-export declare const OXYGEN_BUILD_VERSION = "1.1013.27";
+export declare const OXYGEN_BUILD_VERSION = "1.1013.38";

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.1013.27";
+export const OXYGEN_BUILD_VERSION = "1.1013.38";

package/package.json

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