@koda-sl/baker-cli 0.567.0 → 0.569.0

package/dist/update-FIU2ECYQ.js

@@ -0,0 +1,192 @@
+import {
+  buildProfilePatch,
+  hasProfileEdit,
+  mergeProfile
+} from "./chunk-IJMWEO4P.js";
+import {
+  failAvatarApi,
+  failValidation,
+  updateHints
+} from "./chunk-MYIOR35H.js";
+import {
+  readAvatars,
+  writeAvatars
+} from "./chunk-OFMFBRSL.js";
+import {
+  AVATAR_HANDLE_PATTERN,
+  AVATAR_RELATIONS
+} from "./chunk-2Q7K4F4H.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-R7XDGNZD.js";
+import "./chunk-XHWHBGKX.js";
+import "./chunk-QEREDRZO.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/avatars/update.ts
+import { defineCommand } from "citty";
+
+// src/commands/avatars/relation.ts
+function relationPatch(args) {
+  const relation = typeof args.relation === "string" ? args.relation.trim().toLowerCase() : "";
+  const testimonial = typeof args.testimonial === "string" ? args.testimonial : "";
+  const ids = testimonial.split(",").map((id) => id.trim()).filter(Boolean);
+  const known = AVATAR_RELATIONS.find((r) => r === relation);
+  if (relation && !known) {
+    return { ok: false, message: `--relation "${relation}" is not one of ${AVATAR_RELATIONS.join(", ")}.` };
+  }
+  return {
+    ok: true,
+    patch: { ...known ? { relation: known } : {}, ...ids.length > 0 ? { testimonialIds: ids } : {} }
+  };
+}
+
+// src/commands/avatars/update.ts
+function readUpdateArgs(args) {
+  const handle = (args.handle || args["avatar-handle"])?.trim();
+  if (!handle) {
+    failValidation('An avatar handle is required, e.g. `baker avatars update marta --persona "\u2026"`.');
+  }
+  const name = args.name?.trim();
+  const newHandle = args["new-handle"]?.trim().toLowerCase();
+  const regenerateSheet = Boolean(args["regenerate-sheet"]);
+  const patch = buildProfilePatch(args);
+  const who = relationPatch(args);
+  if (!who.ok) failValidation(who.message);
+  if (patch.subjectDescription === "") {
+    failValidation(
+      "--subject cannot be emptied: it is what the identity sheet was built from. Replace it with a new description of the same length or better, and pass --regenerate-sheet."
+    );
+  }
+  if (newHandle && !AVATAR_HANDLE_PATTERN.test(newHandle)) {
+    failValidation(
+      `--new-handle "${newHandle}" is not usable. Use lowercase letters, numbers and dashes, starting with a letter.`
+    );
+  }
+  if (!name && !newHandle && !hasProfileEdit(patch) && !regenerateSheet && Object.keys(who.patch).length === 0) {
+    failValidation(
+      "Nothing to change. Pass at least one of --name, --new-handle, --subject, --persona, --speech, --motion, --wardrobe, --setting, --accent, --guardrails, --relation, --testimonial, --regenerate-sheet."
+    );
+  }
+  return { handle, name, newHandle, regenerateSheet, patch, who: who.patch };
+}
+registerSchema({
+  command: "avatars.update",
+  description: 'Edit an avatar: rename it, change its handle, rewrite any part of its written profile, set the accent it speaks with, or rebuild its identity sheet. Profile flags are merged over what is stored, so `--persona "\u2026"` alone leaves the subject description intact. When you change --subject, pass --regenerate-sheet in the same call \u2014 otherwise the sheet still shows the person you described before, the words and the face stop matching, and every render drifts. Rebuilding is a ~30s billed render and puts the avatar back to `generating`.',
+  args: {
+    handle: { type: "positional", description: "Handle of the avatar to edit", required: false },
+    "avatar-handle": { type: "string", description: "Handle (alternative to positional)", required: false },
+    name: { type: "string", description: "New display name", required: false },
+    "new-handle": { type: "string", description: "New mention handle (lowercase, dashes)", required: false },
+    subject: {
+      type: "string",
+      description: "Rewrite the identity description. Pass --regenerate-sheet with it, always.",
+      required: false
+    },
+    persona: { type: "string", description: "Who they are on camera", required: false },
+    speech: { type: "string", description: "How they speak", required: false },
+    motion: { type: "string", description: "Body language in video", required: false },
+    wardrobe: { type: "string", description: "Default outfit", required: false },
+    setting: { type: "string", description: "Default surroundings", required: false },
+    guardrails: {
+      type: "string",
+      description: "Comma-separated things they must never do (replaces the stored list; empty string clears it)",
+      required: false
+    },
+    accent: {
+      type: "string",
+      description: "Where their voice is FROM, as a place: 'Spanish from Spain, Madrid accent', 'Mexican Spanish'. THE lever for how they sound \u2014 an avatar has no pinned voice (ADR 0005), so the region directed in the prompt is the only thing steering pronunciation. An adjective like 'clear Spanish accent' is read as NO accent and the clip comes out sounding like nowhere.",
+      required: false
+    },
+    relation: {
+      type: "string",
+      description: "Who this person is to the company: team | founder | customer | partner | creator | role. A customer, partner or creator face appears only in an ad quoting their own published words; only team, founder and role faces are cast freely.",
+      required: false
+    },
+    testimonial: {
+      type: "string",
+      description: "Comma-separated testimonial ids this person gave (their quotes may carry their face in an ad)",
+      required: false
+    },
+    "regenerate-sheet": {
+      type: "boolean",
+      description: "Rebuild the identity sheet (~30s, billed). Required whenever --subject changed.",
+      required: false,
+      default: false
+    }
+  }
+});
+var updateCommand = defineCommand({
+  meta: {
+    name: "update",
+    description: 'Edit an avatar; profile flags merge over what is stored. Example: baker avatars update marta --subject "woman in her early 50s, silver bob" --regenerate-sheet'
+  },
+  args: {
+    handle: { type: "positional", description: "Handle of the avatar to edit", required: false },
+    "avatar-handle": { type: "string", description: "Handle (alternative to positional)", required: false },
+    name: { type: "string", description: "New display name", required: false },
+    "new-handle": { type: "string", description: "New mention handle", required: false },
+    subject: { type: "string", description: "Rewrite the identity description", required: false },
+    persona: { type: "string", description: "Who they are on camera", required: false },
+    speech: { type: "string", description: "How they speak", required: false },
+    motion: { type: "string", description: "Body language in video", required: false },
+    wardrobe: { type: "string", description: "Default outfit", required: false },
+    setting: { type: "string", description: "Default surroundings", required: false },
+    guardrails: { type: "string", description: "Comma-separated rules (empty string clears)", required: false },
+    accent: { type: "string", description: "Where their voice is FROM, as a place", required: false },
+    relation: { type: "string", description: "team | founder | customer | partner | creator | role", required: false },
+    testimonial: { type: "string", description: "Comma-separated testimonial ids this person gave", required: false },
+    "regenerate-sheet": {
+      type: "boolean",
+      description: "Rebuild the identity sheet (~30s, billed)",
+      required: false,
+      default: false
+    }
+  },
+  run: async ({ args }) => {
+    const { handle, name, newHandle, regenerateSheet, patch, who } = readUpdateArgs(args);
+    try {
+      let profile;
+      let subjectChanged = false;
+      if (hasProfileEdit(patch)) {
+        const current = await readAvatars("/api/avatars/get", { handle, full: "1" });
+        profile = mergeProfile(current.profile, patch);
+        subjectChanged = profile.subjectDescription !== current.profile.subjectDescription;
+      }
+      const body = {
+        handle,
+        ...name ? { name } : {},
+        ...newHandle ? { newHandle } : {},
+        ...profile ? { profile } : {},
+        ...regenerateSheet ? { regenerateSheet: true } : {},
+        ...who
+      };
+      const data = await writeAvatars("/api/avatars/update", body);
+      writeJson({
+        ok: true,
+        data,
+        hints: updateHints({
+          avatar: data.avatar,
+          subjectChanged,
+          regeneratedSheet: regenerateSheet,
+          previousHandle: handle
+        })
+      });
+    } catch (err) {
+      failAvatarApi(err, handle);
+    }
+  }
+});
+export {
+  updateCommand
+};
+//# sourceMappingURL=update-FIU2ECYQ.js.map

package/dist/update-HSS6CVUK.js

@@ -0,0 +1,101 @@
+import {
+  ACTION_PRIORITIES,
+  failApi,
+  failValidation,
+  isTempId,
+  parsePriority,
+  parseTagList,
+  writeOk
+} from "./chunk-UJTIMPEE.js";
+import "./chunk-2Q7K4F4H.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-R7XDGNZD.js";
+import "./chunk-XHWHBGKX.js";
+import {
+  apiPost,
+  validateConvexId
+} from "./chunk-QEREDRZO.js";
+import "./chunk-JXTNP3B5.js";
+import {
+  requireChatId
+} from "./chunk-45D6WRCJ.js";
+import {
+  registerSchema
+} from "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/actions/update.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "actions.update",
+  description: "Stage an update on an action (name, description, tags, and/or priority) \u2014 no claim needed; edit any action you're not working on. Accepts either a real action ID or a tempId from `baker actions create` in THIS chat (edits the still-staged task in place \u2014 use this to flesh out a task you just created instead of removing and recreating it). Applies on publish. Blocked only if another chat currently has a real action claimed. --tags REPLACES the tag set; pass --tags '' to clear. --priority accepts urgent|high|medium|low or 'none' to clear back to unset (== normal).",
+  args: {
+    id: { type: "string", description: "Action ID or tempId (temp_*) of a task staged in this chat", required: true },
+    name: { type: "string", description: "New name", required: false },
+    description: {
+      type: "string",
+      description: "New description, in markdown \u2014 `##` headings per section, `-` bullets, `**bold**` for the decisive figures. REPLACES the whole description, so carry over anything still true.",
+      required: false
+    },
+    tags: {
+      type: "string",
+      description: "Comma-separated tag slugs \u2014 REPLACES existing tags ('' clears)",
+      required: false
+    },
+    priority: {
+      type: "string",
+      description: `User priority: ${ACTION_PRIORITIES.join("|")}, or 'none' to clear.`,
+      required: false
+    }
+  }
+});
+var updateCommand = defineCommand({
+  meta: {
+    name: "update",
+    description: 'Stage an update on an action, or edit a task still staged in this chat by its tempId (no claim needed). Example: baker actions update <id-or-tempId> --description "\u2026"'
+  },
+  args: {
+    id: { type: "positional", description: "Action ID or tempId (temp_*)", required: false },
+    "action-id": { type: "string", description: "Action ID or tempId (temp_*)", required: false },
+    name: { type: "string", description: "New name", required: false },
+    description: { type: "string", description: "New description (markdown)", required: false },
+    tags: { type: "string", description: "Comma-separated tag slugs \u2014 REPLACES existing ('' clears)", required: false },
+    priority: { type: "string", description: `Priority: ${ACTION_PRIORITIES.join("|")}|none`, required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const id = args.id || args["action-id"];
+      if (!id) {
+        failValidation("Action ID is required.");
+      }
+      if (!isTempId(id)) {
+        validateConvexId(id);
+      }
+      const tags = parseTagList(args.tags);
+      const priority = parsePriority(args.priority, { allowClear: true });
+      if (args.name === void 0 && args.description === void 0 && tags === void 0 && priority === void 0) {
+        failValidation("Provide at least one of --name, --description, --tags, --priority.");
+      }
+      const chatId = requireChatId();
+      await apiPost("/api/actions/update", {
+        chatId,
+        actionId: id,
+        name: args.name,
+        description: args.description,
+        ...tags !== void 0 ? { tags } : {},
+        ...priority !== void 0 ? { priority } : {}
+      });
+      writeOk();
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+export {
+  updateCommand
+};
+//# sourceMappingURL=update-HSS6CVUK.js.map

package/dist/update-XWL3Q5QY.js

@@ -0,0 +1,155 @@
+import {
+  AUTO_PUBLISH_ARG,
+  NARROWING_ARGS,
+  REACTION_ARGS,
+  SLACK_ARG,
+  TRIGGER_ARG_DESCRIPTION,
+  TRIGGER_KIND_LIST,
+  buildTriggerBody,
+  companiesArg,
+  companiesBody,
+  failApi,
+  failValidation,
+  parseBooleanFlag,
+  reactionBody,
+  refuseAutoPublish,
+  slackBody,
+  validateScheduledAgentRef,
+  writeOk
+} from "./chunk-HH5WM5VA.js";
+import "./chunk-WR5Y64OE.js";
+import "./chunk-2Q7K4F4H.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-R7XDGNZD.js";
+import "./chunk-XHWHBGKX.js";
+import {
+  apiPost
+} from "./chunk-QEREDRZO.js";
+import "./chunk-JXTNP3B5.js";
+import {
+  requireChatId
+} from "./chunk-45D6WRCJ.js";
+import {
+  registerSchema
+} from "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/scheduled-agents/update.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "scheduled-agents.update",
+  description: "Stage an update to a published scheduled agent, or to one this chat staged (temp_agent_*).",
+  args: {
+    id: { type: "string", description: "Published scheduled agent ID or temp_agent_* draft ID", required: true },
+    name: { type: "string", description: "New name", required: false },
+    description: { type: "string", description: "New one-line description", required: false },
+    prompt: { type: "string", description: "Replacement brief \u2014 the whole of what the run does", required: false },
+    cron: { type: "string", description: "5-field cron expression; implies --trigger time.cron", required: false },
+    "run-at": {
+      type: "string",
+      description: "New one-off run time, as an ISO UTC timestamp ending in Z. Must still be in the future \u2014 a time that has passed is refused.",
+      required: false
+    },
+    trigger: { type: "string", description: TRIGGER_ARG_DESCRIPTION, required: false, enum: TRIGGER_KIND_LIST },
+    ...NARROWING_ARGS,
+    occurrences: {
+      type: "string",
+      description: "Replacement list of firings to run on, 1-based and comma-separated",
+      required: false
+    },
+    ...REACTION_ARGS,
+    ...SLACK_ARG,
+    ...companiesArg(),
+    timezone: { type: "string", description: "IANA timezone override", required: false },
+    enabled: { type: "string", description: "Replacement enabled state", required: false, enum: ["true", "false"] }
+  }
+});
+var updateCommand = defineCommand({
+  meta: {
+    name: "update",
+    description: "Stage a scheduled agent update. Examples: baker scheduled-agents update <id> --enabled false | baker scheduled-agents update <id> --trigger form.submitted --form quote"
+  },
+  args: {
+    id: { type: "positional", description: "Scheduled agent ID or temp_agent_* draft ID", required: false },
+    "scheduled-agent-id": {
+      type: "string",
+      description: "Scheduled agent ID (alternative to positional)",
+      required: false
+    },
+    name: { type: "string", description: "New name", required: false },
+    description: { type: "string", description: "New description", required: false },
+    prompt: { type: "string", description: "Replacement brief", required: false },
+    cron: { type: "string", description: "5-field cron expression", required: false },
+    "run-at": { type: "string", description: "ISO UTC timestamp ending in Z, still in the future", required: false },
+    trigger: { type: "string", description: `One of: ${TRIGGER_KIND_LIST.join(", ")}`, required: false },
+    ...NARROWING_ARGS,
+    occurrences: { type: "string", description: "Only these firings, e.g. 1 or 1,3", required: false },
+    ...REACTION_ARGS,
+    ...SLACK_ARG,
+    ...companiesArg(),
+    timezone: { type: "string", description: "IANA timezone override", required: false },
+    enabled: { type: "string", description: "true|false", required: false },
+    ...AUTO_PUBLISH_ARG
+  },
+  run: async ({ args }) => {
+    try {
+      refuseAutoPublish(args);
+      const id = args.id || args["scheduled-agent-id"];
+      if (!id) {
+        failValidation("Scheduled agent ID is required.");
+      }
+      validateScheduledAgentRef(id);
+      const body = { id };
+      let hasPatch = false;
+      for (const key of ["name", "description", "prompt"]) {
+        if (typeof args[key] === "string") {
+          body[key] = args[key];
+          hasPatch = true;
+        }
+      }
+      const trigger = buildTriggerBody(args, { required: false });
+      if (trigger) {
+        Object.assign(body, trigger);
+        hasPatch = true;
+      }
+      const reaction = reactionBody(args);
+      if (Object.keys(reaction).length > 0) {
+        Object.assign(body, reaction);
+        hasPatch = true;
+      }
+      const slack = slackBody(args);
+      if (slack.slack !== void 0) {
+        Object.assign(body, slack);
+        hasPatch = true;
+      }
+      const companies = companiesBody(args);
+      if (companies.companies !== void 0) {
+        Object.assign(body, companies);
+        hasPatch = true;
+      }
+      const enabled = parseBooleanFlag(args.enabled, "--enabled");
+      if (enabled !== void 0) {
+        body.enabled = enabled;
+        hasPatch = true;
+      }
+      if (!hasPatch) {
+        failValidation(
+          "Provide at least one of --name, --description, --prompt, --cron, --run-at, --trigger, --occurrences, --times, --when, --ai-check, --payload, --cooldown, --timezone, --enabled, --slack."
+        );
+      }
+      body.chatId = requireChatId();
+      const response = await apiPost("/api/scheduled-agents/update", body);
+      writeOk(null, response.hints);
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+export {
+  updateCommand
+};
+//# sourceMappingURL=update-XWL3Q5QY.js.map

package/dist/upload-B5SM33MK.js

@@ -0,0 +1,137 @@
+import {
+  runVideoIngest
+} from "./chunk-ZQ7JDYJB.js";
+import "./chunk-FKOECEVC.js";
+import "./chunk-RJ2ETGAQ.js";
+import {
+  detectVideoContentType,
+  uploadLocalVideo
+} from "./chunk-FLQNIFG2.js";
+import {
+  librarySaveHint
+} from "./chunk-I7OJZ7QE.js";
+import "./chunk-G6U45QD3.js";
+import "./chunk-2Q7K4F4H.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-R7XDGNZD.js";
+import "./chunk-XHWHBGKX.js";
+import {
+  ApiError
+} from "./chunk-QEREDRZO.js";
+import "./chunk-JXTNP3B5.js";
+import "./chunk-45D6WRCJ.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-CCYZJMZ7.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/videos/upload.ts
+import { stat } from "fs/promises";
+import { basename } from "path";
+import { defineCommand } from "citty";
+registerSchema({
+  command: "videos.upload",
+  description: "Upload a video to Baker \u2014 a local file (via Mux direct upload) or a remote http(s) URL.",
+  args: {
+    file: { type: "string", description: "Local video file path, or a remote http(s) URL", required: true },
+    "content-type": {
+      type: "string",
+      description: "MIME type (auto-detected from extension if omitted)",
+      required: false
+    },
+    context: {
+      type: "string",
+      description: "What this clip is and what it is for. Feeds the analysis, so it is the single highest-leverage flag here. Example: --context 'Customer testimonial from Maria, shot on her phone for the Q3 retargeting push'",
+      required: false
+    },
+    "dry-run": {
+      type: "boolean",
+      description: "Preview the operation without executing",
+      required: false,
+      default: false
+    }
+  }
+});
+function isRemoteUrl(value) {
+  return /^https?:\/\//i.test(value);
+}
+var uploadCommand = defineCommand({
+  meta: {
+    name: "upload",
+    description: "Upload a video to Baker \u2014 accepts a local file path OR a remote http(s) URL.\n\nLocal: auto-detects content type and uploads via Mux direct upload.\nRemote: hands off to `videos ingest` (direct fetch, or download-then-upload for a YouTube/TikTok/Vimeo page).\n\nExamples:\n  baker videos upload ./demo.mp4\n  baker videos upload https://www.youtube.com/watch?v=abc123"
+  },
+  args: {
+    file: { type: "positional", description: "Local video file path or remote http(s) URL", required: false },
+    "content-type": { type: "string", description: "MIME type (local only \u2014 auto-detected)", required: false },
+    context: {
+      type: "string",
+      description: "What this clip is and what it is for \u2014 who is on camera, which campaign, how it was shot. Start here: the analysis reads it, so it is what makes the clip findable later.",
+      required: false
+    },
+    source: { type: "string", description: "Provenance (URL mode only): url | youtube", required: false },
+    "external-id": { type: "string", description: "Provider asset id (URL mode only)", required: false },
+    "external-url": { type: "string", description: "Canonical page URL (URL mode only)", required: false },
+    "dry-run": { type: "boolean", description: "Preview without executing", required: false, default: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const filePath = args.file;
+      if (!filePath) {
+        writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: "File path or URL is required" } });
+        process.exit(1);
+      }
+      if (isRemoteUrl(filePath)) {
+        await runVideoIngest({
+          urls: [filePath],
+          source: args.source,
+          externalId: args["external-id"],
+          externalUrl: args["external-url"],
+          context: args.context,
+          dryRun: args["dry-run"] === true
+        });
+        return;
+      }
+      const contentType = args["content-type"] || detectVideoContentType(filePath);
+      const descriptionContext = args.context;
+      if (args["dry-run"]) {
+        const fileStats = await stat(filePath);
+        const originalFilename = basename(filePath);
+        writeJson({
+          ok: true,
+          dryRun: true,
+          operation: "videos.upload",
+          params: { file: filePath, contentType, sizeBytes: fileStats.size, originalFilename, descriptionContext }
+        });
+        return;
+      }
+      const { videoId } = await uploadLocalVideo({ file: filePath, contentType, descriptionContext });
+      const saved = librarySaveHint("video library", [videoId]);
+      writeJson({
+        ok: true,
+        data: { videoId },
+        hints: [
+          ...descriptionContext ? [] : [
+            "No --context given. Analysis runs on the frames and audio alone, so who is on camera and which campaign this belongs to will be guessed. Pass --context next time."
+          ],
+          ...saved ? [saved] : []
+        ]
+      });
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeJson({ ok: false, error: { code: err.code, message: err.message } });
+        process.exit(1);
+      }
+      writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+export {
+  uploadCommand
+};
+//# sourceMappingURL=upload-B5SM33MK.js.map