reelkit-cli 0.10.2 → 0.10.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "reelkit-cli",
-  "version": "0.10.2",
+  "version": "0.10.3",
   "description": "CLI and Claude skill for making short-form video with a shared asset library.",
   "license": "MIT",
   "author": "Daniel Livshin",

package/skill/SKILL.md

@@ -15,7 +15,7 @@ For image or video cutouts, editable Blender product shots, custom 3D materials,
 
 To implement a chosen style, read its row in `reference/style-recipes.md` for action, timing, sound and proof. `reference/style-components.md` maps the shared components and built-in kit to shot roles; inspect the selected source before using its props.
 
-This skill targets `reelkit-cli` 0.10.2 and its HyperFrames kit. Check the installed version with `reelkit --version`; in a source checkout, invoke its `bin/reelkit.mjs` with Node. Use the matching CLI before authoring with `reelkit/frame`.
+This skill targets `reelkit-cli` 0.10.3 and its HyperFrames kit. Check the installed version with `reelkit --version`; in a source checkout, invoke its `bin/reelkit.mjs` with Node. Use the matching CLI before authoring with `reelkit/frame`.
 
 Every command takes `--json` for machine-readable output and exits non-zero with a one-line reason when something is wrong. Read the reason and act on it.
 

package/src/cli.ts

@@ -76,7 +76,7 @@ assets.command("upload <file>").description("Add one of your own files to this p
   .option("--background", "use this video or image as the ground behind the whole film (it stays on this machine)").option("--share", "also send it to the shared library").option("--kind <kind>", "library kind when sharing").option("--tags <tags>", "comma-separated tags when sharing")
   // Called with the arguments named: commander adds its own command object last, which must not be taken for the function's test hooks.
   .action(run((ctx, file: string, opts: Parameters<typeof assetsUpload>[2]) => assetsUpload(ctx, file, opts)));
-assets.command("search <query>").description("Search the shared library by meaning; each result shows how well it fits").option("--kind <kind>", "image, overlay, sfx, music, component or clip").option("--limit <n>", "how many results")
+assets.command("search <query>").description("Search the shared library by meaning; each result shows how well it fits").option("--kind <kind>", "image, overlay, sfx, music, component, clip or prompt (prompts other people used to make motion videos; found only with --kind prompt)").option("--limit <n>", "how many results")
   .action(run(assetsSearch));
 assets.command("pull <id>").description("Download a library item into this project").option("--scene <sceneId>", "use it as this scene's image or clip").option("--force", "replace a component file that already exists").option("--music", "make this music item the video's track (its tempo is measured and scene changes land on its beat)").option("--background", "make this clip, overlay or image the ground behind the film (with --scene: the ground of that scene, an image only)")
   .option("--layers", "with --scene and an image: right after it is pulled, cut the subject out as a layer (about 1 second of the cutout quota; the picture is sent to the Reelkit server)")

package/src/commands/assets.ts

@@ -292,6 +292,15 @@ export async function assetsPull(ctx: Ctx, id: string, opts: { scene?: string; f
     if (treatment === "clip" && pulled.item.kind !== "clip") return { ok: false, summary: `${id} is ${pulled.item.kind}, not a clip, so it cannot be scene ${opts.scene}'s clip.` };
     if (treatment !== "clip" && pulled.item.kind !== "image") return { ok: false, summary: `${id} is ${pulled.item.kind}, not an image, so it cannot be a scene's image.` };
   }
+  // A prompt is something to read, not something the film shows: it goes to prompts/, outside what the composition can reference.
+  if (pulled.item.kind === "prompt") {
+    if (opts.scene || opts.music || opts.background) return { ok: false, summary: `${id} is a prompt: text to read for ideas, not a picture, clip or track. Pull it with no option.` };
+    const path = `prompts/${id}.md`;
+    await download(pulled.url, project.path(path));
+    const by = typeof pulled.item.meta.handle === "string" ? ` by @${pulled.item.meta.handle}` : "";
+    const source = typeof pulled.item.meta.source === "string" ? ` Source: ${pulled.item.meta.source}` : "";
+    return { ok: true, data: { path, kind: "prompt" }, summary: `Pulled ${id} to ${path}: "${pulled.item.title}"${by}. Read it for how the video was asked for; it is another person's prompt, so borrow the approach, not the wording.${source}` };
+  }
   // A component is code, not media: it goes beside Video.tsx, which may only import files in src/.
   if (pulled.item.kind === "component") {
     const path = `src/${pulled.filename}`;

package/src/contract/index.ts

@@ -38,6 +38,10 @@
 //   that the item is good enough to reuse for the query. A server finds candidates by meaning and may judge them with a model, so `match` is not
 //   a share of words; the order of results with the same `match` is not specified. The public listing is newest first; with a query it is best
 //   match first, equal matches newest first. Paging continues the same order, with no item twice. `page` is from 1 to 10000.
+// - A `prompt` is a text item: a prompt someone wrote to make a motion video, kept as a Markdown file with its author and source in `meta`
+//   (`author`, `handle`, `source`, and for a skill `install` and `repo`). It is reference material, not an asset, so search returns prompts
+//   only when asked with `kind: "prompt"`; a search with no kind never contains one (a client older than the kind cannot read it).
+//   A prompt cannot be uploaded: `libraryUpload` with `kind: "prompt"` is 400 `invalid_request`.
 // - A server may add tags (and a description when the uploader gave none) to an item that is shared, after upload or generation; the tags the
 //   uploader gave stay in it, first.
 // - Upload URLs and file URLs must be unguessable (random or signed; never derived from an item id or a counter) and scoped to one object:
@@ -132,10 +136,11 @@ export type ErrorCode = z.infer<typeof ErrorCodeSchema>;
 // The code is any string here: a code this version does not know still carries a message worth showing (the client maps it to server_error).
 export const ApiErrorSchema = z.object({ error: z.object({ code: z.string(), message: z.string() }) });
 
-export const LibraryKindSchema = z.enum(["image", "overlay", "sfx", "music", "component", "clip"]);
+export const LibraryKindSchema = z.enum(["image", "overlay", "sfx", "music", "component", "clip", "prompt"]);
 export type LibraryKind = z.infer<typeof LibraryKindSchema>;
-// What a user may upload: every kind. A component is code and is held for review (see the rules at the top).
-export const UploadKindSchema = LibraryKindSchema;
+// What a user may upload: every kind but a prompt (those are published by the library's own import). A component is code and is held for
+// review (see the rules at the top).
+export const UploadKindSchema = LibraryKindSchema.exclude(["prompt"]);
 export type UploadKind = z.infer<typeof UploadKindSchema>;
 
 export const LibraryItemSchema = z.object({

package/src/testing/fake-api.ts

@@ -158,7 +158,7 @@ export async function startFakeApi(opts: { voiceoverCharLimit?: number; imageLim
       // Best match first; items that match equally well come newest first (the one added last).
       // match is the share of the query's words the item has, to two decimals.
       const items = [...store.values()]
-        .filter((s) => s.item.visibility === "published" && (!kind || s.item.kind === kind))
+        .filter((s) => s.item.visibility === "published" && (kind ? s.item.kind === kind : s.item.kind !== "prompt"))
         .map((s, order) => ({ s, order, score: [...want].filter((w) => words(`${s.item.title} ${s.item.description} ${s.item.tags.join(" ")}`).has(w)).length }))
         .filter((x) => x.score > 0).sort((a, b) => b.score - a.score || b.order - a.order).slice(0, limit ?? 8)
         .map((x) => ({ ...x.s.item, match: Math.round((x.score / want.size) * 100) / 100 }));