blitzreels 0.1.30 → 0.1.31

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.
Files changed (111) hide show
  1. package/README.md +269 -4
  2. package/dist/agent-context.d.ts.map +1 -1
  3. package/dist/agent-context.js +3 -3
  4. package/dist/agent-context.js.map +1 -1
  5. package/dist/cli-command-routing.d.ts.map +1 -1
  6. package/dist/cli-command-routing.js +5 -1
  7. package/dist/cli-command-routing.js.map +1 -1
  8. package/dist/command-registry.d.ts.map +1 -1
  9. package/dist/command-registry.js +26 -0
  10. package/dist/command-registry.js.map +1 -1
  11. package/dist/commands/carousels.d.ts.map +1 -1
  12. package/dist/commands/carousels.js +61 -8
  13. package/dist/commands/carousels.js.map +1 -1
  14. package/dist/commands/characters.d.ts.map +1 -1
  15. package/dist/commands/characters.js +137 -2
  16. package/dist/commands/characters.js.map +1 -1
  17. package/dist/commands/content-batches.d.ts +19 -0
  18. package/dist/commands/content-batches.d.ts.map +1 -0
  19. package/dist/commands/content-batches.js +128 -0
  20. package/dist/commands/content-batches.js.map +1 -0
  21. package/dist/commands/content-review.d.ts +18 -0
  22. package/dist/commands/content-review.d.ts.map +1 -0
  23. package/dist/commands/content-review.js +66 -0
  24. package/dist/commands/content-review.js.map +1 -0
  25. package/dist/commands/creative-learning.d.ts +8 -0
  26. package/dist/commands/creative-learning.d.ts.map +1 -0
  27. package/dist/commands/creative-learning.js +111 -0
  28. package/dist/commands/creative-learning.js.map +1 -0
  29. package/dist/commands/creative-map.d.ts +8 -0
  30. package/dist/commands/creative-map.d.ts.map +1 -0
  31. package/dist/commands/creative-map.js +121 -0
  32. package/dist/commands/creative-map.js.map +1 -0
  33. package/dist/commands/creative-source.d.ts +33 -0
  34. package/dist/commands/creative-source.d.ts.map +1 -0
  35. package/dist/commands/creative-source.js +267 -0
  36. package/dist/commands/creative-source.js.map +1 -0
  37. package/dist/commands/customer-outcomes.d.ts +8 -0
  38. package/dist/commands/customer-outcomes.d.ts.map +1 -0
  39. package/dist/commands/customer-outcomes.js +115 -0
  40. package/dist/commands/customer-outcomes.js.map +1 -0
  41. package/dist/commands/editor.d.ts +20 -0
  42. package/dist/commands/editor.d.ts.map +1 -0
  43. package/dist/commands/editor.js +116 -0
  44. package/dist/commands/editor.js.map +1 -0
  45. package/dist/commands/exports.d.ts.map +1 -1
  46. package/dist/commands/exports.js +57 -0
  47. package/dist/commands/exports.js.map +1 -1
  48. package/dist/commands/generation-review.d.ts +18 -0
  49. package/dist/commands/generation-review.d.ts.map +1 -0
  50. package/dist/commands/generation-review.js +60 -0
  51. package/dist/commands/generation-review.js.map +1 -0
  52. package/dist/commands/generation-wait.d.ts +15 -0
  53. package/dist/commands/generation-wait.d.ts.map +1 -0
  54. package/dist/commands/generation-wait.js +98 -0
  55. package/dist/commands/generation-wait.js.map +1 -0
  56. package/dist/commands/generation.d.ts +5 -0
  57. package/dist/commands/generation.d.ts.map +1 -1
  58. package/dist/commands/generation.js +693 -34
  59. package/dist/commands/generation.js.map +1 -1
  60. package/dist/commands/hosted-drafts.d.ts +8 -0
  61. package/dist/commands/hosted-drafts.d.ts.map +1 -0
  62. package/dist/commands/hosted-drafts.js +125 -0
  63. package/dist/commands/hosted-drafts.js.map +1 -0
  64. package/dist/commands/jobs.d.ts.map +1 -1
  65. package/dist/commands/jobs.js +156 -1
  66. package/dist/commands/jobs.js.map +1 -1
  67. package/dist/commands/knowledge-research.d.ts +10 -0
  68. package/dist/commands/knowledge-research.d.ts.map +1 -0
  69. package/dist/commands/knowledge-research.js +147 -0
  70. package/dist/commands/knowledge-research.js.map +1 -0
  71. package/dist/commands/knowledge.d.ts +37 -0
  72. package/dist/commands/knowledge.d.ts.map +1 -0
  73. package/dist/commands/knowledge.js +164 -0
  74. package/dist/commands/knowledge.js.map +1 -0
  75. package/dist/commands/media-assets.d.ts.map +1 -1
  76. package/dist/commands/media-assets.js +39 -0
  77. package/dist/commands/media-assets.js.map +1 -1
  78. package/dist/commands/project-read.d.ts.map +1 -1
  79. package/dist/commands/project-read.js +25 -4
  80. package/dist/commands/project-read.js.map +1 -1
  81. package/dist/commands/projects.d.ts.map +1 -1
  82. package/dist/commands/projects.js +51 -0
  83. package/dist/commands/projects.js.map +1 -1
  84. package/dist/commands/publishing-posts.d.ts.map +1 -1
  85. package/dist/commands/publishing-posts.js +78 -1
  86. package/dist/commands/publishing-posts.js.map +1 -1
  87. package/dist/commands/recipes.d.ts +24 -0
  88. package/dist/commands/recipes.d.ts.map +1 -0
  89. package/dist/commands/recipes.js +177 -0
  90. package/dist/commands/recipes.js.map +1 -0
  91. package/dist/commands/series.d.ts +1 -2
  92. package/dist/commands/series.d.ts.map +1 -1
  93. package/dist/commands/series.js +132 -1
  94. package/dist/commands/series.js.map +1 -1
  95. package/dist/commands/system.d.ts.map +1 -1
  96. package/dist/commands/system.js +25 -1
  97. package/dist/commands/system.js.map +1 -1
  98. package/dist/commands/text-overlays.d.ts.map +1 -1
  99. package/dist/commands/text-overlays.js +1 -0
  100. package/dist/commands/text-overlays.js.map +1 -1
  101. package/dist/commands/voices.d.ts +16 -0
  102. package/dist/commands/voices.d.ts.map +1 -0
  103. package/dist/commands/voices.js +251 -0
  104. package/dist/commands/voices.js.map +1 -0
  105. package/dist/commands/web-capture.d.ts +10 -0
  106. package/dist/commands/web-capture.d.ts.map +1 -0
  107. package/dist/commands/web-capture.js +149 -0
  108. package/dist/commands/web-capture.js.map +1 -0
  109. package/dist/index.js +96 -0
  110. package/dist/index.js.map +1 -1
  111. package/package.json +2 -2
@@ -0,0 +1,147 @@
1
+ import { readFileSync } from "node:fs";
2
+ import { resolve } from "node:path";
3
+ import { knowledgeResearchJobInputSchema, knowledgeResearchListInputSchema, knowledgeResearchRequestSchema, knowledgeResearchStartRequest, knowledgeResearchStartSchema, } from "@blitzreels/sdk";
4
+ import { CliUsageError } from "../cli-errors.js";
5
+ import { commandSpec } from "../command-metadata.js";
6
+ export const KNOWLEDGE_RESEARCH_COMMAND_SPECS = [
7
+ commandSpec({
8
+ command: ["knowledge", "research", "list"],
9
+ discovery: "detail",
10
+ usage: "blitzreels knowledge research list [--status all|active] [--limit 10] [--offset 0] [--json]",
11
+ description: "Find saved workspace research, including jobs started by another agent.",
12
+ flags: ["status", "limit", "offset"],
13
+ }),
14
+ commandSpec({
15
+ command: ["knowledge", "research", "quote"],
16
+ usage: "blitzreels knowledge research quote --spec-file research.json [--json]",
17
+ description: "Quote bounded web research without paid work or reserving balance.",
18
+ flags: [{ name: "spec-file", required: true }],
19
+ }),
20
+ commandSpec({
21
+ command: ["knowledge", "research", "start"],
22
+ discovery: "detail",
23
+ usage: "blitzreels knowledge research start --spec-file research.json --quote-id ID --idempotency-key KEY [--dry-run] [--json]",
24
+ description: "Start quoted research with a total credit cap and an idempotent job receipt.",
25
+ flags: [
26
+ { name: "spec-file", required: true },
27
+ { name: "quote-id", required: true },
28
+ { name: "idempotency-key", required: true },
29
+ ],
30
+ mutates: true,
31
+ dryRunSupported: true,
32
+ }),
33
+ commandSpec({
34
+ command: ["knowledge", "research", "get"],
35
+ discovery: "detail",
36
+ usage: "blitzreels knowledge research get --job-id ID [--json]",
37
+ description: "Read research status, credits, capture metadata and saved brief reference.",
38
+ flags: [{ name: "job-id", required: true }],
39
+ }),
40
+ commandSpec({
41
+ command: ["knowledge", "research", "cancel"],
42
+ discovery: "detail",
43
+ usage: "blitzreels knowledge research cancel --job-id ID [--dry-run] [--json]",
44
+ description: "Stop new research work; completed and uncertain charges remain accounted for.",
45
+ flags: [{ name: "job-id", required: true }],
46
+ mutates: true,
47
+ dryRunSupported: true,
48
+ }),
49
+ commandSpec({
50
+ command: ["knowledge", "research", "resume"],
51
+ discovery: "detail",
52
+ usage: "blitzreels knowledge research resume --job-id ID [--dry-run] [--json]",
53
+ description: "Resume eligible research using accepted prices and its remaining budget.",
54
+ flags: [{ name: "job-id", required: true }],
55
+ mutates: true,
56
+ dryRunSupported: true,
57
+ }),
58
+ ];
59
+ export function createKnowledgeResearchCommandOperation({ helpers, }) {
60
+ const validate = (parse) => {
61
+ try {
62
+ return parse();
63
+ }
64
+ catch (error) {
65
+ throw new CliUsageError({
66
+ code: "invalid_flag_value",
67
+ message: error instanceof Error ? error.message : String(error),
68
+ });
69
+ }
70
+ };
71
+ const input = (flags) => {
72
+ try {
73
+ return knowledgeResearchRequestSchema.parse(JSON.parse(readFileSync(resolve(helpers.requireStringFlag({ flags, name: "spec-file" })), "utf8")));
74
+ }
75
+ catch (error) {
76
+ throw new CliUsageError({
77
+ code: "invalid_flag_value",
78
+ message: error instanceof Error ? error.message : String(error),
79
+ });
80
+ }
81
+ };
82
+ const start = (flags) => validate(() => knowledgeResearchStartSchema.parse({
83
+ ...input(flags),
84
+ quoteId: helpers.requireStringFlag({ flags, name: "quote-id" }),
85
+ idempotencyKey: helpers.requireStringFlag({
86
+ flags,
87
+ name: "idempotency-key",
88
+ }),
89
+ }));
90
+ const job = (flags) => validate(() => knowledgeResearchJobInputSchema.parse({
91
+ jobId: helpers.requireStringFlag({ flags, name: "job-id" }),
92
+ }));
93
+ return {
94
+ name: "knowledge-research",
95
+ matches: ({ command }) => command[0] === "knowledge" && command[1] === "research",
96
+ handle: async ({ context }) => {
97
+ const verb = context.args.command[2];
98
+ const flags = context.args.flags;
99
+ const research = context.client.knowledge.research;
100
+ let value;
101
+ if (verb === "list")
102
+ value = await research.list(validate(() => knowledgeResearchListInputSchema.parse({
103
+ limit: helpers.getNumberFlag({ flags, name: "limit" }) ?? 10,
104
+ offset: helpers.getNumberFlag({ flags, name: "offset" }) ?? 0,
105
+ status: helpers.getStringFlag({ flags, name: "status" }) ?? "all",
106
+ })));
107
+ else if (verb === "quote")
108
+ value = await research.quote(input(flags));
109
+ else if (verb === "start")
110
+ value = await research.start(start(flags));
111
+ else if (verb === "get")
112
+ value = await research.get(job(flags));
113
+ else if (verb === "cancel")
114
+ value = await research.cancel(job(flags));
115
+ else if (verb === "resume")
116
+ value = await research.resume(job(flags));
117
+ else
118
+ return false;
119
+ helpers.printResult({
120
+ json: context.json,
121
+ value,
122
+ human: [JSON.stringify(value)],
123
+ fields: context.fields,
124
+ });
125
+ return true;
126
+ },
127
+ buildDryRun: ({ context, spec }) => {
128
+ const verb = context.args.command[2];
129
+ if (verb === "start")
130
+ return helpers.dryRunRequest({
131
+ spec,
132
+ ...knowledgeResearchStartRequest(start(context.args.flags)),
133
+ notes: undefined,
134
+ });
135
+ if (verb !== "cancel" && verb !== "resume")
136
+ return undefined;
137
+ return helpers.dryRunRequest({
138
+ spec,
139
+ method: "POST",
140
+ path: `/workspace/knowledge/research/${job(context.args.flags).jobId}/${verb}`,
141
+ body: {},
142
+ notes: undefined,
143
+ });
144
+ },
145
+ };
146
+ }
147
+ //# sourceMappingURL=knowledge-research.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"knowledge-research.js","sourceRoot":"","sources":["../../src/commands/knowledge-research.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,37 @@
1
+ import type { Flags } from "../cli-types.js";
2
+ import { type CommandSpec } from "../command-metadata.js";
3
+ import type { DryRunPreview } from "../preview-first-edit.js";
4
+ import type { CommandOperation } from "./command-operation.js";
5
+ export declare const KNOWLEDGE_COMMAND_SPECS: CommandSpec[];
6
+ type Helpers = {
7
+ requireStringFlag: (input: {
8
+ flags: Flags;
9
+ name: string;
10
+ }) => string;
11
+ getStringFlag: (input: {
12
+ flags: Flags;
13
+ name: string;
14
+ }) => string | undefined;
15
+ getNumberFlag: (input: {
16
+ flags: Flags;
17
+ name: string;
18
+ }) => number | undefined;
19
+ printResult: (input: {
20
+ json: boolean;
21
+ value: unknown;
22
+ human: string[];
23
+ fields: string[] | undefined;
24
+ }) => void;
25
+ dryRunRequest: (input: {
26
+ spec: CommandSpec;
27
+ method: string;
28
+ path: string;
29
+ body: unknown;
30
+ notes: string[] | undefined;
31
+ }) => DryRunPreview;
32
+ };
33
+ export declare function createKnowledgeCommandOperation({ helpers, }: {
34
+ helpers: Helpers;
35
+ }): CommandOperation;
36
+ export {};
37
+ //# sourceMappingURL=knowledge.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"knowledge.d.ts","sourceRoot":"","sources":["../../src/commands/knowledge.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,KAAK,WAAW,EAAe,MAAM,wBAAwB,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,eAAO,MAAM,uBAAuB,EAAE,WAAW,EAmEhD,CAAC;AACF,KAAK,OAAO,GAAG;IACb,iBAAiB,EAAE,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,CAAC;IACrE,aAAa,EAAE,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,GAAG,SAAS,CAAC;IAC7E,aAAa,EAAE,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,GAAG,SAAS,CAAC;IAC7E,WAAW,EAAE,CAAC,KAAK,EAAE;QACnB,IAAI,EAAE,OAAO,CAAC;QACd,KAAK,EAAE,OAAO,CAAC;QACf,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;KAC9B,KAAK,IAAI,CAAC;IACX,aAAa,EAAE,CAAC,KAAK,EAAE;QACrB,IAAI,EAAE,WAAW,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,OAAO,CAAC;QACd,KAAK,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;KAC7B,KAAK,aAAa,CAAC;CACrB,CAAC;AAqBF,wBAAgB,+BAA+B,CAAC,EAC9C,OAAO,GACR,EAAE;IACD,OAAO,EAAE,OAAO,CAAC;CAClB,GAAG,gBAAgB,CA0FnB"}
@@ -0,0 +1,164 @@
1
+ import { readFileSync, writeFileSync } from "node:fs";
2
+ import { resolve } from "node:path";
3
+ import { knowledgeApplyRequest, knowledgeApplySchema } from "@blitzreels/sdk";
4
+ import { CliUsageError } from "../cli-errors.js";
5
+ import { commandSpec } from "../command-metadata.js";
6
+ export const KNOWLEDGE_COMMAND_SPECS = [
7
+ commandSpec({
8
+ command: ["knowledge", "list"],
9
+ discovery: "detail",
10
+ usage: "blitzreels knowledge list [--search TEXT] [--limit 20] [--offset 0] [--json]",
11
+ description: "Search current Markdown knowledge with bounded results.",
12
+ flags: ["search", "limit", "offset"],
13
+ }),
14
+ commandSpec({
15
+ command: ["knowledge", "get"],
16
+ discovery: "detail",
17
+ usage: "blitzreels knowledge get --document-id ID [--revision N] [--json]",
18
+ description: "Read a saved knowledge revision and its provenance.",
19
+ flags: [{ name: "document-id", required: true }, "revision"],
20
+ }),
21
+ commandSpec({
22
+ command: ["knowledge", "history"],
23
+ discovery: "detail",
24
+ usage: "blitzreels knowledge history --document-id ID [--limit 20] [--offset 0] [--json]",
25
+ description: "Read immutable knowledge revision metadata.",
26
+ flags: [{ name: "document-id", required: true }, "limit", "offset"],
27
+ }),
28
+ commandSpec({
29
+ command: ["knowledge", "context"],
30
+ usage: "blitzreels knowledge context [--series-id ID] [--json]",
31
+ description: "Read Brand or Series direction and bounded context with owner corrections first.",
32
+ flags: ["series-id"],
33
+ }),
34
+ commandSpec({
35
+ command: ["knowledge", "seed"],
36
+ discovery: "detail",
37
+ usage: "blitzreels knowledge seed [--dry-run] [--json]",
38
+ description: "Import missing brand and creative direction documents without overwriting edits.",
39
+ flags: [],
40
+ mutates: true,
41
+ dryRunSupported: true,
42
+ }),
43
+ commandSpec({
44
+ command: ["knowledge", "export"],
45
+ discovery: "detail",
46
+ usage: "blitzreels knowledge export --document-id ID --out FILE [--revision N] [--json]",
47
+ description: "Write exact saved Markdown to a new local file.",
48
+ flags: [
49
+ { name: "document-id", required: true },
50
+ { name: "out", required: true },
51
+ "revision",
52
+ ],
53
+ }),
54
+ commandSpec({
55
+ command: ["knowledge", "apply"],
56
+ usage: "blitzreels knowledge apply --spec-file brief.json [--markdown-file brief.md] --idempotency-key KEY [--dry-run] [--json]",
57
+ description: "Save a Markdown brief at expectedRevision (0 creates). Optional Markdown file replaces spec content.",
58
+ flags: [
59
+ { name: "spec-file", required: true },
60
+ "markdown-file",
61
+ { name: "idempotency-key", required: true },
62
+ ],
63
+ mutates: true,
64
+ dryRunSupported: true,
65
+ }),
66
+ ];
67
+ function readInput({ flags, helpers }) {
68
+ try {
69
+ const spec = JSON.parse(readFileSync(resolve(helpers.requireStringFlag({ flags, name: "spec-file" })), "utf8"));
70
+ const file = helpers.getStringFlag({ flags, name: "markdown-file" });
71
+ return knowledgeApplySchema.parse({
72
+ ...spec,
73
+ ...(file ? { markdown: readFileSync(resolve(file), "utf8") } : {}),
74
+ });
75
+ }
76
+ catch (error) {
77
+ throw new CliUsageError({
78
+ code: "invalid_flag_value",
79
+ message: error instanceof Error ? error.message : String(error),
80
+ });
81
+ }
82
+ }
83
+ export function createKnowledgeCommandOperation({ helpers, }) {
84
+ return {
85
+ name: "knowledge",
86
+ matches: ({ command }) => command[0] === "knowledge",
87
+ handle: async ({ context }) => {
88
+ const verb = context.args.command[1];
89
+ const flags = context.args.flags;
90
+ const print = (value) => helpers.printResult({
91
+ json: context.json,
92
+ value,
93
+ human: [JSON.stringify(value)],
94
+ fields: context.fields,
95
+ });
96
+ const page = {
97
+ limit: helpers.getNumberFlag({ flags, name: "limit" }) ?? 20,
98
+ offset: helpers.getNumberFlag({ flags, name: "offset" }) ?? 0,
99
+ };
100
+ if (verb === "list")
101
+ print(await context.client.knowledge.list({
102
+ ...page,
103
+ search: helpers.getStringFlag({ flags, name: "search" }) ?? "",
104
+ }));
105
+ else if (verb === "context")
106
+ print(await context.client.knowledge.context({
107
+ seriesId: helpers.getStringFlag({ flags, name: "series-id" }) ?? null,
108
+ }));
109
+ else if (verb === "seed")
110
+ print(await context.client.knowledge.seed());
111
+ else if (verb === "apply")
112
+ print(await context.client.knowledge.apply({
113
+ ...readInput({ flags, helpers }),
114
+ idempotencyKey: helpers.requireStringFlag({
115
+ flags,
116
+ name: "idempotency-key",
117
+ }),
118
+ }));
119
+ else if (["get", "history", "export"].includes(verb ?? "")) {
120
+ const input = {
121
+ documentId: helpers.requireStringFlag({ flags, name: "document-id" }),
122
+ revision: helpers.getNumberFlag({ flags, name: "revision" }) ?? null,
123
+ };
124
+ if (verb === "history")
125
+ print(await context.client.knowledge.history({
126
+ documentId: input.documentId,
127
+ ...page,
128
+ }));
129
+ else if (verb === "get")
130
+ print(await context.client.knowledge.get(input));
131
+ else {
132
+ const file = resolve(helpers.requireStringFlag({ flags, name: "out" }));
133
+ const exported = await context.client.knowledge.export(input);
134
+ writeFileSync(file, exported.markdown, {
135
+ encoding: "utf8",
136
+ flag: "wx",
137
+ });
138
+ print({ file, revision: exported.revision });
139
+ }
140
+ }
141
+ else
142
+ return false;
143
+ return true;
144
+ },
145
+ buildDryRun: ({ context, spec }) => {
146
+ if (context.args.command[1] === "seed")
147
+ return helpers.dryRunRequest({
148
+ spec,
149
+ method: "POST",
150
+ path: "/workspace/knowledge/seed",
151
+ body: {},
152
+ notes: undefined,
153
+ });
154
+ if (context.args.command[1] !== "apply")
155
+ return undefined;
156
+ return helpers.dryRunRequest({
157
+ spec,
158
+ ...knowledgeApplyRequest(readInput({ flags: context.args.flags, helpers })),
159
+ notes: undefined,
160
+ });
161
+ },
162
+ };
163
+ }
164
+ //# sourceMappingURL=knowledge.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"knowledge.js","sourceRoot":"","sources":["../../src/commands/knowledge.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"media-assets.d.ts","sourceRoot":"","sources":["../../src/commands/media-assets.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"media-assets.d.ts","sourceRoot":"","sources":["../../src/commands/media-assets.ts"],"names":[],"mappings":"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"}
@@ -1,5 +1,6 @@
1
1
  import { mkdir, writeFile } from "node:fs/promises";
2
2
  import { dirname, resolve } from "node:path";
3
+ import { narrationReadInputSchema } from "@blitzreels/contracts";
3
4
  import { CliUsageError } from "../cli-errors.js";
4
5
  import { commandSpec } from "../command-metadata.js";
5
6
  import { requireDeleteConfirmation, } from "../preview-first-edit.js";
@@ -30,6 +31,12 @@ export const MEDIA_ASSET_COMMAND_SPECS = [
30
31
  usage: "blitzreels media verify --asset-id ID [--json]",
31
32
  flags: ["asset-id"],
32
33
  }),
34
+ commandSpec({
35
+ command: ["media", "narration"],
36
+ usage: "blitzreels media narration --asset-id ID [--limit 200] [--offset 0] [--json]",
37
+ description: "Read retained voice inputs, audio identity, measured duration and paginated word timing.",
38
+ flags: ["asset-id", "limit", "offset"],
39
+ }),
33
40
  commandSpec({
34
41
  command: ["media", "download"],
35
42
  usage: "blitzreels media download --asset-id ID --output ./source.mp4 [--timeout-ms 300000] [--json]",
@@ -321,6 +328,37 @@ async function handleMediaAssetCommand({ context, helpers, }) {
321
328
  if (group !== "media") {
322
329
  return false;
323
330
  }
331
+ if (action === "narration") {
332
+ const input = narrationReadInputSchema.safeParse({
333
+ assetId: helpers.requireStringFlag({ flags, name: "asset-id" }),
334
+ limit: helpers.getNumberFlag({ flags, name: "limit" }) ?? 200,
335
+ offset: helpers.getNumberFlag({ flags, name: "offset" }) ?? 0,
336
+ });
337
+ if (!input.success)
338
+ throw new CliUsageError({
339
+ code: "invalid_arguments",
340
+ message: input.error.issues
341
+ .map((issue) => `${issue.path.join(".")}: ${issue.message}`)
342
+ .join("; "),
343
+ });
344
+ const result = await context.client.media.narration(input.data);
345
+ helpers.printResult({
346
+ json: context.json,
347
+ value: result,
348
+ human: result.take
349
+ ? [
350
+ `${result.assetId}: ${result.take.durationSeconds}s (${result.take.durationSource}), ${result.bounds.total} words`,
351
+ ...result.wordTimings.map((word) => `${word.startSeconds}-${word.endSeconds}: ${word.word}`),
352
+ ...(result.bounds.hasMore
353
+ ? [
354
+ `Next offset: ${result.bounds.offset + result.bounds.returned}`,
355
+ ]
356
+ : []),
357
+ ]
358
+ : [`${result.assetId}: no retained narration take`],
359
+ });
360
+ return true;
361
+ }
324
362
  if (action === "list") {
325
363
  const result = await context.client.media.list({
326
364
  folderId: helpers.getStringFlag({ flags, name: "folder-id" }),
@@ -1362,6 +1400,7 @@ function matchesMediaAssetCommand({ command }) {
1362
1400
  return [
1363
1401
  "list",
1364
1402
  "get",
1403
+ "narration",
1365
1404
  "verify",
1366
1405
  "download",
1367
1406
  "delete",