gooseworks 0.5.0-dev.9.d3e7757f → 0.5.0
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 +17 -26
- package/dist/auth/device-flow.d.ts +10 -0
- package/dist/auth/device-flow.d.ts.map +1 -1
- package/dist/auth/device-flow.js +39 -1
- package/dist/auth/device-flow.js.map +1 -1
- package/dist/commands/doctor.d.ts.map +1 -1
- package/dist/commands/doctor.js +3 -1
- package/dist/commands/doctor.js.map +1 -1
- package/dist/commands/video.d.ts +5 -0
- package/dist/commands/video.d.ts.map +1 -0
- package/dist/commands/video.js +117 -0
- package/dist/commands/video.js.map +1 -0
- package/dist/config.d.ts.map +1 -1
- package/dist/config.js +5 -2
- package/dist/config.js.map +1 -1
- package/dist/environment.d.ts.map +1 -1
- package/dist/environment.js +4 -2
- package/dist/environment.js.map +1 -1
- package/dist/kit/core/bind.d.ts +12 -0
- package/dist/kit/core/bind.d.ts.map +1 -0
- package/dist/kit/core/bind.js +77 -0
- package/dist/kit/core/bind.js.map +1 -0
- package/dist/kit/core/canonical.d.ts +30 -0
- package/dist/kit/core/canonical.d.ts.map +1 -0
- package/dist/kit/core/canonical.js +67 -0
- package/dist/kit/core/canonical.js.map +1 -0
- package/dist/kit/core/check.d.ts +22 -0
- package/dist/kit/core/check.d.ts.map +1 -0
- package/dist/kit/core/check.js +53 -0
- package/dist/kit/core/check.js.map +1 -0
- package/dist/kit/core/device.d.ts +17 -0
- package/dist/kit/core/device.d.ts.map +1 -0
- package/dist/kit/core/device.js +153 -0
- package/dist/kit/core/device.js.map +1 -0
- package/dist/kit/core/errors.d.ts +22 -0
- package/dist/kit/core/errors.d.ts.map +1 -0
- package/dist/kit/core/errors.js +49 -0
- package/dist/kit/core/errors.js.map +1 -0
- package/dist/kit/core/files.d.ts +49 -0
- package/dist/kit/core/files.d.ts.map +1 -0
- package/dist/kit/core/files.js +213 -0
- package/dist/kit/core/files.js.map +1 -0
- package/dist/kit/core/host.d.ts +26 -0
- package/dist/kit/core/host.d.ts.map +1 -0
- package/dist/kit/core/host.js +10 -0
- package/dist/kit/core/host.js.map +1 -0
- package/dist/kit/core/log.d.ts +17 -0
- package/dist/kit/core/log.d.ts.map +1 -0
- package/dist/kit/core/log.js +82 -0
- package/dist/kit/core/log.js.map +1 -0
- package/dist/kit/core/paths.d.ts +27 -0
- package/dist/kit/core/paths.d.ts.map +1 -0
- package/dist/kit/core/paths.js +103 -0
- package/dist/kit/core/paths.js.map +1 -0
- package/dist/kit/core/pieces.d.ts +84 -0
- package/dist/kit/core/pieces.d.ts.map +1 -0
- package/dist/kit/core/pieces.js +374 -0
- package/dist/kit/core/pieces.js.map +1 -0
- package/dist/kit/core/progress-reporter.d.ts +30 -0
- package/dist/kit/core/progress-reporter.d.ts.map +1 -0
- package/dist/kit/core/progress-reporter.js +106 -0
- package/dist/kit/core/progress-reporter.js.map +1 -0
- package/dist/kit/core/progress.d.ts +22 -0
- package/dist/kit/core/progress.d.ts.map +1 -0
- package/dist/kit/core/progress.js +90 -0
- package/dist/kit/core/progress.js.map +1 -0
- package/dist/kit/core/run.d.ts +35 -0
- package/dist/kit/core/run.d.ts.map +1 -0
- package/dist/kit/core/run.js +850 -0
- package/dist/kit/core/run.js.map +1 -0
- package/dist/kit/core/save.d.ts +43 -0
- package/dist/kit/core/save.d.ts.map +1 -0
- package/dist/kit/core/save.js +265 -0
- package/dist/kit/core/save.js.map +1 -0
- package/dist/kit/core/schema.d.ts +5 -0
- package/dist/kit/core/schema.d.ts.map +1 -0
- package/dist/kit/core/schema.js +183 -0
- package/dist/kit/core/schema.js.map +1 -0
- package/dist/kit/core/secrets.d.ts +9 -0
- package/dist/kit/core/secrets.d.ts.map +1 -0
- package/dist/kit/core/secrets.js +60 -0
- package/dist/kit/core/secrets.js.map +1 -0
- package/dist/kit/core/style.d.ts +59 -0
- package/dist/kit/core/style.d.ts.map +1 -0
- package/dist/kit/core/style.js +179 -0
- package/dist/kit/core/style.js.map +1 -0
- package/dist/kit/core/toolchain.d.ts +52 -0
- package/dist/kit/core/toolchain.d.ts.map +1 -0
- package/dist/kit/core/toolchain.js +321 -0
- package/dist/kit/core/toolchain.js.map +1 -0
- package/dist/kit/core/version.d.ts +18 -0
- package/dist/kit/core/version.d.ts.map +1 -0
- package/dist/kit/core/version.js +33 -0
- package/dist/kit/core/version.js.map +1 -0
- package/dist/kit/env.d.ts +42 -0
- package/dist/kit/env.d.ts.map +1 -0
- package/dist/kit/env.js +76 -0
- package/dist/kit/env.js.map +1 -0
- package/dist/kit/line/client.d.ts +82 -0
- package/dist/kit/line/client.d.ts.map +1 -0
- package/dist/kit/line/client.js +325 -0
- package/dist/kit/line/client.js.map +1 -0
- package/dist/kit/line/types.d.ts +178 -0
- package/dist/kit/line/types.d.ts.map +1 -0
- package/dist/kit/line/types.js +18 -0
- package/dist/kit/line/types.js.map +1 -0
- package/dist/kit/maker/browser.d.ts +114 -0
- package/dist/kit/maker/browser.d.ts.map +1 -0
- package/dist/kit/maker/browser.js +547 -0
- package/dist/kit/maker/browser.js.map +1 -0
- package/dist/kit/maker/encode.d.ts +27 -0
- package/dist/kit/maker/encode.d.ts.map +1 -0
- package/dist/kit/maker/encode.js +58 -0
- package/dist/kit/maker/encode.js.map +1 -0
- package/dist/kit/maker/images.d.ts +14 -0
- package/dist/kit/maker/images.d.ts.map +1 -0
- package/dist/kit/maker/images.js +174 -0
- package/dist/kit/maker/images.js.map +1 -0
- package/dist/kit/maker/inputs.d.ts +81 -0
- package/dist/kit/maker/inputs.d.ts.map +1 -0
- package/dist/kit/maker/inputs.js +235 -0
- package/dist/kit/maker/inputs.js.map +1 -0
- package/dist/kit/maker/make.d.ts +19 -0
- package/dist/kit/maker/make.d.ts.map +1 -0
- package/dist/kit/maker/make.js +272 -0
- package/dist/kit/maker/make.js.map +1 -0
- package/dist/kit/maker/page.d.ts +19 -0
- package/dist/kit/maker/page.d.ts.map +1 -0
- package/dist/kit/maker/page.js +276 -0
- package/dist/kit/maker/page.js.map +1 -0
- package/dist/kit/maker/parts/html-frames/1.0.0/part.json +183 -0
- package/dist/kit/maker/parts/html-frames/src/part.d.ts +3 -0
- package/dist/kit/maker/parts/html-frames/src/part.d.ts.map +1 -0
- package/dist/kit/maker/parts/html-frames/src/part.js +10 -0
- package/dist/kit/maker/parts/html-frames/src/part.js.map +1 -0
- package/dist/kit/maker/runtime.d.ts +7 -0
- package/dist/kit/maker/runtime.d.ts.map +1 -0
- package/dist/kit/maker/runtime.js +571 -0
- package/dist/kit/maker/runtime.js.map +1 -0
- package/dist/kit/maker/unzip.d.ts +3 -0
- package/dist/kit/maker/unzip.d.ts.map +1 -0
- package/dist/kit/maker/unzip.js +133 -0
- package/dist/kit/maker/unzip.js.map +1 -0
- package/dist/kit/parts/catalog.d.ts +47 -0
- package/dist/kit/parts/catalog.d.ts.map +1 -0
- package/dist/kit/parts/catalog.js +198 -0
- package/dist/kit/parts/catalog.js.map +1 -0
- package/dist/kit/parts/fs-safe.d.ts +32 -0
- package/dist/kit/parts/fs-safe.d.ts.map +1 -0
- package/dist/kit/parts/fs-safe.js +185 -0
- package/dist/kit/parts/fs-safe.js.map +1 -0
- package/dist/kit/parts/loader.d.ts +50 -0
- package/dist/kit/parts/loader.d.ts.map +1 -0
- package/dist/kit/parts/loader.js +395 -0
- package/dist/kit/parts/loader.js.map +1 -0
- package/dist/kit/parts/semver.d.ts +6 -0
- package/dist/kit/parts/semver.d.ts.map +1 -0
- package/dist/kit/parts/semver.js +44 -0
- package/dist/kit/parts/semver.js.map +1 -0
- package/dist/program.d.ts.map +1 -1
- package/dist/program.js +6 -6
- package/dist/program.js.map +1 -1
- package/dist/skills/installer.d.ts +22 -0
- package/dist/skills/installer.d.ts.map +1 -1
- package/dist/skills/installer.js +56 -8
- package/dist/skills/installer.js.map +1 -1
- package/dist/skills/master-skill.d.ts +11 -70
- package/dist/skills/master-skill.d.ts.map +1 -1
- package/dist/skills/master-skill.js +120 -2900
- package/dist/skills/master-skill.js.map +1 -1
- package/dist/skills/package-freshness.d.ts +19 -0
- package/dist/skills/package-freshness.d.ts.map +1 -1
- package/dist/skills/package-freshness.js +37 -2
- package/dist/skills/package-freshness.js.map +1 -1
- package/dist/skills/routes.d.ts +7 -2
- package/dist/skills/routes.d.ts.map +1 -1
- package/dist/skills/routes.js +21 -25
- package/dist/skills/routes.js.map +1 -1
- package/dist/skills/server-entry-skills.d.ts +14 -0
- package/dist/skills/server-entry-skills.d.ts.map +1 -0
- package/dist/skills/server-entry-skills.js +119 -0
- package/dist/skills/server-entry-skills.js.map +1 -0
- package/dist/skills/staging-content.js +1 -1
- package/package.json +10 -6
- package/skills/goose-ads/SKILL.md +27 -605
- package/skills/goose-product-photos/SKILL.md +24 -217
- package/skills/goose-video/SKILL.md +23 -610
- package/skills/goose-video-local/SKILL.md +3 -1609
- package/skills/gooseworks/SKILL.md +58 -529
- package/skills/make-custom-video/SKILL.md +23 -725
- package/skills/manifest.json +7 -7
- package/skills/routes.json +10 -24
- package/dist/commands/video-local.d.ts +0 -9
- package/dist/commands/video-local.d.ts.map +0 -1
- package/dist/commands/video-local.js +0 -83
- package/dist/commands/video-local.js.map +0 -1
- package/dist/commands/video-save.d.ts +0 -3
- package/dist/commands/video-save.d.ts.map +0 -1
- package/dist/commands/video-save.js +0 -83
- package/dist/commands/video-save.js.map +0 -1
- package/dist/lib/video-local-captions.d.ts +0 -83
- package/dist/lib/video-local-captions.d.ts.map +0 -1
- package/dist/lib/video-local-captions.js +0 -261
- package/dist/lib/video-local-captions.js.map +0 -1
- package/dist/lib/video-local-runtime.d.ts +0 -8
- package/dist/lib/video-local-runtime.d.ts.map +0 -1
- package/dist/lib/video-local-runtime.js +0 -201
- package/dist/lib/video-local-runtime.js.map +0 -1
- package/dist/lib/video-save-mcp.d.ts +0 -9
- package/dist/lib/video-save-mcp.d.ts.map +0 -1
- package/dist/lib/video-save-mcp.js +0 -162
- package/dist/lib/video-save-mcp.js.map +0 -1
- package/dist/lib/video-save.d.ts +0 -77
- package/dist/lib/video-save.d.ts.map +0 -1
- package/dist/lib/video-save.js +0 -440
- package/dist/lib/video-save.js.map +0 -1
- package/dist/skills/custom-video-skill.d.ts +0 -3
- package/dist/skills/custom-video-skill.d.ts.map +0 -1
- package/dist/skills/custom-video-skill.js +0 -6
- package/dist/skills/custom-video-skill.js.map +0 -1
|
@@ -1,619 +1,32 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: goose-video
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
Start a video ad in the same chat. Resolve the brand and suggest supported formats with a
|
|
6
|
-
picker or the returned text choices. An agent that can run shell commands on the customer's
|
|
7
|
-
computer makes the video with goose-video-local; otherwise the GooseWorks coworker makes it.
|
|
8
|
-
Review one complete template plan and total credits before production. Custom videos retain two authenticated review gates in this chat.
|
|
9
|
-
category: ads
|
|
10
|
-
version: 3.1.0
|
|
11
|
-
author: GooseWorks
|
|
12
|
-
tags: [gooseworks, ads, video, local-render, coworker, chat]
|
|
3
|
+
description: "Make a video ad with GooseWorks in this chat: the product first, then the brand read, then video_formats; follow the next_step in every answer."
|
|
4
|
+
version: 4.1.0
|
|
13
5
|
---
|
|
14
6
|
|
|
15
|
-
# GooseWorks
|
|
7
|
+
# GooseWorks video
|
|
16
8
|
|
|
17
|
-
|
|
9
|
+
Use GooseWorks to make the customer's video, here in this chat. For a video already started (named, or sent by a card), call video_read and follow its next_step.
|
|
18
10
|
|
|
19
|
-
|
|
20
|
-
fields, files, polling, models and pipeline steps is for YOU. Never pass it on to them.
|
|
11
|
+
For a new video, in this order. Suggest nothing before step 5 and write no plan before they pick a style.
|
|
21
12
|
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
or your own quality checks. Fix what you can quietly. If they ask how something works, explain it
|
|
29
|
-
simply.
|
|
30
|
-
- **Update them only at milestones they care about**: choices confirmed, script and voices done,
|
|
31
|
-
visuals done, ready to review, finished. One short line each, then stay quiet until the next
|
|
32
|
-
milestone. No update for setup, downloads, uploads or saving.
|
|
33
|
-
- **Money is in credits, with a number**: "the full video uses about N credits". Never "the cheap
|
|
34
|
-
pieces" or "the expensive render".
|
|
35
|
-
- **Problems:** say what it means for them and what they can do, in one or two sentences. No error
|
|
36
|
-
codes or stack traces. Only raise a problem that changes something for them.
|
|
37
|
-
- **Use their words**: script, voice, hook, scene, host, ending, logo, the product shot.
|
|
38
|
-
- **No filler**: no "Great question!", "Certainly!", "I hope this helps!", no restating what they
|
|
39
|
-
just said at length.
|
|
13
|
+
1. The request. If they haven't said what the video is about, ask in one short question.
|
|
14
|
+
2. The brand. Ask which brand only when brand_read lists several; with one, use it.
|
|
15
|
+
3. The product. Unless they named one or want none, ask which product, offering the brand's products by name from brand_read (sections: products). Use the only one if there is one; with none, go on without.
|
|
16
|
+
4. Research. Read the brand kit, learnings and the chosen products with brand_read (sections kit and learnings, plus the products' ids): photos, specs, creative notes. Search the brand's knowledge for them with knowledge_search. Keep a few plain lines of what to say and avoid.
|
|
17
|
+
5. The styles. Call video_formats with the request and the products' ids: [] for none or a style without products. The customer picks; never recommend one. A style they named that the answer lists as available is their pick. Otherwise, with the style card on screen, say one short line and wait; without one, list the fitting styles, each with its name, one line and price as written, and ask which one.
|
|
18
|
+
6. The plan. Call video_create with the picked style and the products, then follow the next_step in every answer: it says how to write the scenes with video_change and what follows.
|
|
40
19
|
|
|
41
|
-
|
|
42
|
-
"Got it: warm tone, home podcast studio, Brielle as the skeptic and Mark as the believer." then
|
|
43
|
-
"Script and voices are done (about 34 seconds)." then "Ready for you to review: the script, voices,
|
|
44
|
-
both hosts and the ending. You can also review your recipe ingredients in the app: <link>. Say go
|
|
45
|
-
here and I'll make the full video (about N credits)."
|
|
20
|
+
## Rules
|
|
46
21
|
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
saved fetch JSON, `gooseworks fetch <slug> --saved-package <file>` returns the current package
|
|
59
|
-
and a hash comparison without changing that file. With MCP, if the advertised `catalog_fetch`
|
|
60
|
-
schema accepts them, send `saved_content_hash` and `saved_dependency_hashes`; otherwise fetch
|
|
61
|
-
normally and compare the returned hashes yourself. Missing hashes mean unknown, not current.
|
|
62
|
-
The server cannot inspect a client's saved files; hash metadata does not certify later edits.
|
|
63
|
-
Fetch current packages into a new run directory and report stale saved instructions. Preserve
|
|
64
|
-
an existing approved run's recorded package; changing that harness requires a reviewed change
|
|
65
|
-
and approval before spending. Hosted installed snapshots use the existing Skills Update action.
|
|
66
|
-
Skill content and a host's cached MCP tool schemas are separate: refreshing one does not refresh
|
|
67
|
-
the other. Check the actual advertised tools before using new fields.
|
|
68
|
-
|
|
69
|
-
## No GooseWorks tools in this session? Call them through the CLI
|
|
70
|
-
|
|
71
|
-
The GooseWorks tools named here (for example `account_whoami`, `brand_onboarding`,
|
|
72
|
-
`brand_read`) normally come from the GooseWorks connector. If they are not registered in this
|
|
73
|
-
session but you have a shell with the `gooseworks` CLI signed in (a cloud sandbox such as
|
|
74
|
-
ChatGPT agent, Meta AI or Grok), call the same tool from the shell:
|
|
75
|
-
|
|
76
|
-
```bash
|
|
77
|
-
npx gooseworks tool <name> '<arguments as a JSON object>'
|
|
78
|
-
```
|
|
79
|
-
|
|
80
|
-
- Run `npx gooseworks tool --list` once first. It prints the server's rules for using the tools
|
|
81
|
-
and every tool name; `npx gooseworks tool <name> --schema` shows one tool's arguments.
|
|
82
|
-
- The result prints as JSON. When a tool answers with a one-line summary, the fields you act on
|
|
83
|
-
(such as `next_step` and ids) follow under "Data:". It exits 1 when the tool reports an error.
|
|
84
|
-
- Nothing renders as a widget here, so tell the user the result in plain words.
|
|
85
|
-
- The same rules apply as over the connector: state the credit total and get the user's yes
|
|
86
|
-
before paid work.
|
|
87
|
-
- If it says you are not logged in, run `npx gooseworks login --device --no-wait`, show the
|
|
88
|
-
user the link and code it prints, and run `npx gooseworks login --device` once they approve.
|
|
89
|
-
|
|
90
|
-
When the tools are registered in this session, call them directly instead.
|
|
91
|
-
|
|
92
|
-
## Purpose
|
|
93
|
-
|
|
94
|
-
Resolve the brand, show supported formats and create one saved project. This is agent
|
|
95
|
-
execution, not a recipe server-order API.
|
|
96
|
-
|
|
97
|
-
**Who makes the video (one rule).** If you can run shell commands on the customer's own
|
|
98
|
-
computer, you make it there with `goose-video-local`: check the toolchain first and, if it
|
|
99
|
-
can't be fixed, hand it off. If you can't, hand it to the GooseWorks coworker with
|
|
100
|
-
`goose_run_task { brand_id, project_id, message: the customer's words }`; the one approval,
|
|
101
|
-
Stop and fixes stay in this chat. Inside the GooseWorks coworker's own sandbox you are the
|
|
102
|
-
coworker: make it yourself and never hand off. A hosted code sandbox is not the customer's
|
|
103
|
-
computer. Decide this yourself, never from the host's name; the server needs no flag for it.
|
|
104
|
-
|
|
105
|
-
**Cards and execution are separate.** A terminal may render without drawing a picker; a chat
|
|
106
|
-
app may draw a picker while the coworker renders. Follow `card.display_hint` for how to show
|
|
107
|
-
things; who makes the video is the rule above. Template-remix review stays in this
|
|
108
|
-
chat. Custom videos use separate authenticated script and ingredient approvals in this same chat.
|
|
109
|
-
Studio is an optional review surface.
|
|
110
|
-
|
|
111
|
-
## Prepare the video workflow and brand before creative work
|
|
112
|
-
|
|
113
|
-
**Installed entry files are bootstrap instructions.** For new work started from an installed
|
|
114
|
-
file or an old chat, fetch `catalog_fetch { type: "skill", slug: "goose-video" }` on the selected
|
|
115
|
-
connection and read its returned content and dependencies before continuing. Use the already
|
|
116
|
-
fetched body when this entry came from that connection in this run; do not recursively fetch
|
|
117
|
-
the same entry. A CLI freshness warning does not block using the current connected package.
|
|
118
|
-
Keep the fetched package and hashes in a new run folder; do not replace edited installed files.
|
|
119
|
-
If current instructions cannot be loaded, resolve the connection before format suggestions,
|
|
120
|
-
script writing or production. Do not continue from an old installed workflow or session notes.
|
|
121
|
-
|
|
122
|
-
**Follow the connector's full-guide requirement when available.** Fetch
|
|
123
|
-
`catalog_fetch { type: "skill", slug: "gooseworks-guide" }` when the connector requires it.
|
|
124
|
-
The only older-server exception is below; it never removes brand preparation or approvals.
|
|
125
|
-
|
|
126
|
-
| Returned guide/workflow state on the selected connection | Required action |
|
|
127
|
-
| --- | --- |
|
|
128
|
-
| Guide returns `not_found`, and this same connection already returned the complete current matching video entry with its required dependencies | Continue with that authoritative entry's workflow, full brand preparation and existing approvals. |
|
|
129
|
-
| Guide has another error, no response, or incomplete content; or the matching entry/dependencies are missing, incomplete or from another connection | Stop before creative work, project writes or paid calls; resolve a compatible connection on this same environment. |
|
|
130
|
-
|
|
131
|
-
A missing custom entry or required custom tool/schema remains unavailable: never substitute
|
|
132
|
-
a template or an import to bypass it. Never hide other fetch errors or continue from cached
|
|
133
|
-
instructions merely because the guide was not found.
|
|
134
|
-
|
|
135
|
-
**For an existing project or batch, read `video_project_read` first.** Determine its actual
|
|
136
|
-
route and saved review state before fetching a recipe or doing local work. Resume an approved
|
|
137
|
-
run with its recorded packages, brand inputs, script and ingredients; do not silently replace
|
|
138
|
-
them with today's release or brand rules. Follow returned preparation requirements and use
|
|
139
|
-
the existing affected review/approval flow for an intentional change. Reads, free drafts,
|
|
140
|
-
imports and existing-job retrieval do not grant permission for new paid production.
|
|
141
|
-
|
|
142
|
-
**For every new plan, resolve the brand and call**
|
|
143
|
-
`brand_read { brand_id, sections: ["summary", "kit", "products", "learnings"] }` **before**
|
|
144
|
-
suggesting formats, mining video angles, writing any script, creating a production plan or
|
|
145
|
-
handing the work to another agent. Use `brand_get_context` with those same four sections only
|
|
146
|
-
when advertised. Reuse a complete read from this run on the same connection and brand.
|
|
147
|
-
Onboarding completion, a summary-only response and earlier session notes do not supply the
|
|
148
|
-
kit, selected product facts or saved rules. If the full read is unavailable, resolve it before
|
|
149
|
-
creative work. Use known kit facts while research is incomplete; do not restart research
|
|
150
|
-
solely because its status is pending. Never invent a product fact or accept a campaign to
|
|
151
|
-
bypass preparation. Then search the Brand Brain (next section) before suggesting formats,
|
|
152
|
-
choosing an angle or asking the user for a brand fact.
|
|
153
|
-
|
|
154
|
-
Carry that context through custom/template/idea routing and delegation. Before writing, make
|
|
155
|
-
the workflow's brand-rules file from those sources: pronunciations, required spoken copy,
|
|
156
|
-
prohibited claims, real logo, font, palette and the selected product's supported facts.
|
|
157
|
-
Entries prefixed `Video preference:` and visual/pacing instructions are creative direction,
|
|
158
|
-
not spoken lines. Use the kit's audience, offer and voice as defaults without an interview.
|
|
159
|
-
The rules file mirrors context; it is not proof of a read or permission to spend. Keep the
|
|
160
|
-
route's existing script, ingredient and budget approvals, including its allowed previews.
|
|
161
|
-
|
|
162
|
-
**Use the server's brand bundle when the selected API returns it.** Project create/read may
|
|
163
|
-
return top-level
|
|
164
|
-
`brand_context`: `{ version: 1, brand_id, digest, loaded_at, sections, brand, kit, products,
|
|
165
|
-
learnings }`. Its sections cover summary, kit, products and learnings.
|
|
166
|
-
|
|
167
|
-
| Returned brand/project response on the selected connection | Required action |
|
|
168
|
-
| --- | --- |
|
|
169
|
-
| A complete authoritative version-1 `brand_context` is returned | Binding is required: use its contents for the plan/rules and include `script_drafts.brand_context_digest = brand_context.digest` with each new/changed script save. |
|
|
170
|
-
| An older API returns the actual four brand sections but no `brand_context` in either the brand read or project response | Prepare from those full sections, write the brand rules and follow the selected connection's existing approval flow and advertised fields. Do not fabricate a receipt or send nonexistent bundle/digest fields. |
|
|
171
|
-
|
|
172
|
-
An incomplete/malformed bundle or missing brand section is a preparation failure, never the
|
|
173
|
-
older-API exception. Once this connection returns an authoritative bundle, use its binding
|
|
174
|
-
contract. `script_drafts.video_brand_context` is server-owned: do not author, replace or forge
|
|
175
|
-
it, and do not invent a read receipt or hash local brand facts into one. Keep the full bundle
|
|
176
|
-
out of client review payloads. If managed generation returns HTTP 409
|
|
177
|
-
`video_brand_context_required`, reload the project and bind the plan to its returned bundle
|
|
178
|
-
through the normal review flow before retrying. That refusal never permits the older-API
|
|
179
|
-
fallback, skipping sections or retrying paid calls blindly. Unchanged approved legacy resumes
|
|
180
|
-
retain their package, context and approvals; an upgrade alone needs no extra approval.
|
|
181
|
-
|
|
182
|
-
**To apply a deliberate brand correction to a new or revised plan**, make a fresh, unfiltered
|
|
183
|
-
`brand_read` of those four sections. When it returns the authoritative bundle, use its
|
|
184
|
-
returned `brand_context.digest` in the complete revised `script_drafts` through the existing
|
|
185
|
-
`video_project_upsert` `patch.script` save; the server verifies the current brand and replaces
|
|
186
|
-
its snapshot with the saved plan. On an older API with no bundle contract, apply the actual
|
|
187
|
-
four-section correction and save the revised draft through its existing flow without inventing
|
|
188
|
-
digest fields. If a connection that already returned a bundle cannot supply the fresh bundle,
|
|
189
|
-
resolve that failure before rebinding. Review and approve the affected script, ingredients and
|
|
190
|
-
budget through the normal flow. Never refresh an ongoing approved run automatically; its
|
|
191
|
-
recorded package and brand inputs stay pinned until an intentional change.
|
|
192
|
-
|
|
193
|
-
## Search the Brand Brain, then propose — before any creative choice or question
|
|
194
|
-
|
|
195
|
-
The Brand Kit is a summary. The brand's saved knowledge (its Brain) holds what the Kit does not:
|
|
196
|
-
rules from past feedback, approved and rejected creatives, customer evidence, approved claims,
|
|
197
|
-
reports and documents. **After `brand_read`, and before you choose an angle, claim, hook,
|
|
198
|
-
product emphasis, format or source ad — and before you ask the user for any brand fact — call
|
|
199
|
-
`knowledge_search { brand_id, query }`** when it is registered. It is free and read-only: no
|
|
200
|
-
approval, no announcement to the customer and no questionnaire.
|
|
201
|
-
|
|
202
|
-
1. **Search for this task, not the whole Brain.** Run one short query (under 500 characters) in
|
|
203
|
-
the user's own words plus the product (for example "ads for <product>: what worked, what to
|
|
204
|
-
avoid") and one with
|
|
205
|
-
`source_types: ["evidence", "claim", "learning", "creative", "document"]` for proof and past
|
|
206
|
-
creative results. Add a query only for a specific open question. Reuse results from this run.
|
|
207
|
-
2. **Keep these states distinct** and record which one each query returned:
|
|
208
|
-
|
|
209
|
-
| Result | Means | Do |
|
|
210
|
-
| --- | --- | --- |
|
|
211
|
-
| `status: "ok"` with matches | Saved knowledge exists | Use it; keep each fact's citation in your working brief |
|
|
212
|
-
| `status: "empty"` | Nothing saved matches this query | Say "no saved evidence for <topic>", never "the brand has no proof" |
|
|
213
|
-
| `refresh_required` | The results shown are current; some changed sources were left out | Use them; search again shortly for anything missing |
|
|
214
|
-
| `building` | The index is not ready | Retry once shortly, then continue with the gap stated |
|
|
215
|
-
| An error, or the tool is not registered | Retrieval failed or is unavailable | Retry an error once, then continue from `brand_read` and treat evidence as unchecked |
|
|
216
|
-
| An empty Kit field | Only that field is blank | Not a search result: still search before asking |
|
|
217
|
-
|
|
218
|
-
3. **Let the findings change the plan.** A `dont`/`must` learning or a rejected creative rules
|
|
219
|
-
options out; an approved or well-rated past creative is a proven angle to lead with; a report
|
|
220
|
-
shows what worked. Claim-grade proof is a result with `approved_ad_claim: true` or the kit's
|
|
221
|
-
`approvedClaims` within their stated applicability; the kit's `proofPoints` are what the
|
|
222
|
-
backend allows an ad to state, used as written. Other Kit text, documents and performance
|
|
223
|
-
numbers are context, never public claims. Never invent an offer, price or result. Judge
|
|
224
|
-
relevance and skip results about another product or business.
|
|
225
|
-
4. **Propose; don't interview.** Lead with one recommended direction (angle, product, source or
|
|
226
|
-
format) and a one-line reason naming what you found, with up to two alternatives. When several
|
|
227
|
-
directions fit (two audiences, products or campaigns), pick the one the evidence favours, such
|
|
228
|
-
as an active campaign or approved past creatives, and name the other as an alternative instead
|
|
229
|
-
of asking. Ask only for a decision the brand read and the search cannot settle, or for spend
|
|
230
|
-
approval. Never ask the user for a fact the Brain already answered.
|
|
231
|
-
Keep directions already chosen (the user's words, a project's creative brief, handed-off
|
|
232
|
-
defaults, approved plans): search only to fill empty fields and to apply saved rules. When a
|
|
233
|
-
returned card or picker presents the choice, your recommendation is its one acknowledgement
|
|
234
|
-
line and the saved plan's defaults, not a separate list.
|
|
235
|
-
5. **Carry an evidence brief** into the routed skill, writer or plan: findings with citations,
|
|
236
|
-
the state of each query, what it ruled out and the open gaps. Tell the customer the findings
|
|
237
|
-
in plain words; the citations stay in the brief.
|
|
238
|
-
|
|
239
|
-
On an approved resume, keep the saved brief and evidence; search again only for a new decision.
|
|
240
|
-
|
|
241
|
-
## Custom videos: check formats first
|
|
242
|
-
|
|
243
|
-
First check the catalog: when the brief names or implies a listed format (for example a street interview, testimonial, podcast or chat video), show that format and its fit through the format flow below, including its support status. Go custom only when no format fits and the customer chooses custom after hearing why; custom keeps that format's hard constraints. For an original brief without a reference template, an Instagram reel/post URL or a direct video URL to study, fetch `catalog_fetch { type: "skill", slug: "make-custom-video" }` and follow it in this same session. It creates format:"custom", custom_mode:"generate" with the brief and optional reference_url. Growth executes in its managed sandbox; connected agents use their shell. Script and actual ingredients are reviewed and separately approved in the same chat before paid production; Studio is optional. Do not force a template that does not fit or that the customer declined, and do not import the reference as a finished video.
|
|
244
|
-
|
|
245
|
-
## Run the format's route check before proposing it
|
|
246
|
-
|
|
247
|
-
A catalog row says what a format is best for and ranks it for the brand. It does not say whether
|
|
248
|
-
the format can make the setup the customer asked for (how many people, mic only, no product).
|
|
249
|
-
Some renderers declare a route selector that decides that; today that is the street interview
|
|
250
|
-
(`render-street-interview`). Before you propose, script or create a street-interview project,
|
|
251
|
-
template or custom, check the request against its routes:
|
|
252
|
-
|
|
253
|
-
| Street route | On screen | Needs | Makes |
|
|
254
|
-
| --- | --- | --- | --- |
|
|
255
|
-
| Guessing (`product-guess`) | Interviewer and up to four people | A physical product to hand over, photographed on its own | A finished video |
|
|
256
|
-
| Conversation (`mic-only`, `product-sample`, `concept-challenge`) | Interviewer and one person | No product photo, phone, screen or UI | A script and prompt preview only, no finished video yet |
|
|
257
|
-
| Street testimonial (its own format) | One person talking to camera, no interviewer | The creator still its recipe prescribes | A finished video, when the catalog lists it |
|
|
258
|
-
|
|
259
|
-
Neither interview route takes a photo of a person: people are described in text, so never
|
|
260
|
-
propose putting a founder's or creator's face in one. Keep the customer's named setup: never
|
|
261
|
-
change the interaction, mode or number of people just to make a check pass.
|
|
262
|
-
|
|
263
|
-
- **Without a shell on the customer's computer**, decide from this table. Do not fetch the renderer: its
|
|
264
|
-
package is far too large for a chat.
|
|
265
|
-
- **With a shell** (the customer's computer or the coworker sandbox), also run its free
|
|
266
|
-
selector, which makes no paid call. If the fetch or the run fails, decide from the table.
|
|
267
|
-
1. Fetch the renderer to a file, not into the conversation: its inline package is over a
|
|
268
|
-
million characters. Either save the JSON from `gooseworks fetch render-street-interview > <file.json>`,
|
|
269
|
-
then write each `scripts` entry as
|
|
270
|
-
`/tmp/gooseworks-scripts/render-street-interview/scripts/<name>` and each `files` entry at
|
|
271
|
-
`/tmp/gooseworks-scripts/render-street-interview/<path>`. Or call
|
|
272
|
-
`catalog_fetch { type: "skill", slug: "render-street-interview", delivery: "archive" }`,
|
|
273
|
-
extract the ZIP, check each file against its `manifest.json` hashes and copy the contents of its
|
|
274
|
-
`agent-config/skills/render-street-interview/` folder into
|
|
275
|
-
`/tmp/gooseworks-scripts/render-street-interview/`. Either way the selector reads
|
|
276
|
-
`references/street-reference-library.json` from that folder.
|
|
277
|
-
2. Write a brief JSON. `mode` and `interaction_type` go in pairs: `product-guess` with
|
|
278
|
-
`product-guess`, or `conversation` with `mic-only`, `product-sample` or `concept-challenge`.
|
|
279
|
-
`offering_type` is exactly `physical`, `service` or `digital` (software, SaaS and apps are
|
|
280
|
-
`digital`). `participants` is a whole number: people interviewed on screen, not counting
|
|
281
|
-
the interviewer. Leave it out when the customer named no count; the selector then uses the
|
|
282
|
-
route's usual cast. When the customer named no interaction, run each mode that could fit.
|
|
283
|
-
3. Run `python3 /tmp/gooseworks-scripts/render-street-interview/scripts/prepare_script_context.py --brief <brief.json> --out <context.json>`.
|
|
284
|
-
Read `status` and `brief_gaps` in the output file, not the exit code: it exits 2 for every
|
|
285
|
-
status except `ready-for-writing`. A Python traceback is not a verdict: the brief or the
|
|
286
|
-
saved files are wrong (for example the reference library in the wrong folder). Fix them and
|
|
287
|
-
run it again.
|
|
288
|
-
4. A run with any `brief_gaps` has not checked the route. Fix every gap and run it again.
|
|
289
|
-
|
|
290
|
-
**An unsupported setup is a stop.** `unsupported-route`, or a request the table rules out,
|
|
291
|
-
means this setup can't be made. Tell the customer plainly, in one line, for example: "A
|
|
292
|
-
three-person mic-only street interview isn't something we can make yet: that version takes one
|
|
293
|
-
person, and the three-person version needs a physical product to hand over." Then offer the
|
|
294
|
-
closest supported options in plain words, each with how it differs. With a shell, these are the
|
|
295
|
-
selector's `alternatives`. Without one, take them from the table:
|
|
296
|
-
|
|
297
|
-
- when only the number of people was the problem, the same setup within its limit: guessing
|
|
298
|
-
(a physical product only) with up to four people, a finished video; or a conversation with
|
|
299
|
-
one person, a script preview only;
|
|
300
|
-
- for something people can't hold (software, a service), a one-person conversation instead
|
|
301
|
-
of guessing;
|
|
302
|
-
- one person talking to camera with no interviewer, if the catalog lists that format;
|
|
303
|
-
- a custom video, untested, that keeps the street format's limits.
|
|
304
|
-
|
|
305
|
-
Never use route names or the script's wording. Do not create the project or write a script for
|
|
306
|
-
it. Go custom only if the customer picks it; a custom video keeps the street format's hard
|
|
307
|
-
constraints, which make-custom-video lists.
|
|
308
|
-
|
|
309
|
-
**A supported setup.** With empty `brief_gaps`, any other status means the route exists.
|
|
310
|
-
`needs-reference` means no observed reference ad matched yet: it does not block proposing the
|
|
311
|
-
format; carry it into the handoff so the script step resolves or reports it before script
|
|
312
|
-
approval. Carry the route too: which one, how many people, finished video or preview only, and
|
|
313
|
-
no person photos. A preview-only route makes a script and prompt preview, not a finished video:
|
|
314
|
-
say so before the customer chooses it.
|
|
315
|
-
|
|
316
|
-
## Route first: is this a new video?
|
|
317
|
-
|
|
318
|
-
Hand off to **`goose-video-local`** now, and stop following this skill, for:
|
|
319
|
-
|
|
320
|
-
- an existing **project** id or a **video batch** id;
|
|
321
|
-
- the app's copy-for-Claude command (it names `goose-video-local`);
|
|
322
|
-
- "remix this video ad template" for a specific app template.
|
|
323
|
-
|
|
324
|
-
Load the current `goose-video-local` entry with
|
|
325
|
-
`catalog_fetch { type: "skill", slug: "goose-video-local" }` on the GooseWorks MCP (older clients:
|
|
326
|
-
`fetch_skill("goose-video-local")`), unless already fetched on this connection in this run.
|
|
327
|
-
It reads the project first and retains an approved run's recorded recipe packages.
|
|
328
|
-
|
|
329
|
-
When they ask **what** to make ("give me video ad ideas", "what angles should I use?", "what's
|
|
330
|
-
working for my competitors?"), fetch **`ad-angle-miner`** (`catalog_fetch { type: "skill", slug: "ad-angle-miner" }`,
|
|
331
|
-
using its advertised tools) and run it with the **video** output. It returns ranked
|
|
332
|
-
video ideas mapped to formats and hands the picked ones to `goose-video-local`.
|
|
333
|
-
|
|
334
|
-
Everything else, including "make me a video ad for <brand>", starts at step 1 below.
|
|
335
|
-
|
|
336
|
-
## Keep the selected connection for the whole run
|
|
337
|
-
|
|
338
|
-
Call `account_whoami` on the connection that owns the brand/project before the first write.
|
|
339
|
-
Keep `environment.name` and the public `environment.api_origin` with this run. Respect the
|
|
340
|
-
user's selected production or staging connection. If multiple connections are available and
|
|
341
|
-
none was selected, resolve that once. Missing or unknown identity is uncertainty, not
|
|
342
|
-
permission to switch. Never infer the environment from credits, billing links or Node mode.
|
|
343
|
-
|
|
344
|
-
Reads, project creation, uploads, generation, polling and final updates all use that same
|
|
345
|
-
connection. If a production request fails, resume or report the failure on production;
|
|
346
|
-
never retry it on staging or recreate the project there. Before retrying a timed-out write,
|
|
347
|
-
read back the existing project or paid request on the selected connection.
|
|
348
|
-
|
|
349
|
-
Local/CLI proxy origin must match `environment.api_origin`. If it differs, use the MCP
|
|
350
|
-
relay on the selected connection (`GW_MEDIA_VIA=mcp`) before paid calls. Do not change
|
|
351
|
-
credentials or API origins to recover a failed write. An explicit user-requested move is
|
|
352
|
-
a separate operation, with the existing project and paid requests reconciled first.
|
|
353
|
-
|
|
354
|
-
## Check assets for the selected format before spending
|
|
355
|
-
|
|
356
|
-
For a template, read its structured `asset_readiness` from
|
|
357
|
-
`video_catalog_list { kind: "formats", brand_id }`. `missing` names gaps;
|
|
358
|
-
`needs_review` means suitability is unverified, including older recipes without
|
|
359
|
-
structured requirements. `ready` describes assets only, not script or budget approval.
|
|
360
|
-
For a custom video, derive requirements from its actual approved scenes.
|
|
361
|
-
|
|
362
|
-
Inspect candidate files for the chosen product and format. A catalog photo can contain
|
|
363
|
-
multiple objects, other products or a person; its existence or approved status does not
|
|
364
|
-
make it a standalone image of the selected product. Check object count, framing, readable
|
|
365
|
-
print and real image bytes. A service conversation has no automatic packshot requirement.
|
|
366
|
-
|
|
367
|
-
Reuse a suitable approved image first. A free crop or cutout is a new file: keep the
|
|
368
|
-
original, inspect the result and include it in the normal ingredient review. When no
|
|
369
|
-
usable input exists, explain the gap before generation. Estimate any paid preparation
|
|
370
|
-
separately before spending. Record the selected asset and inspection in the project
|
|
371
|
-
review set; do not add a separate approval round.
|
|
372
|
-
|
|
373
|
-
## Inputs
|
|
374
|
-
|
|
375
|
-
- A brand, usually named in the request. Resolve it from the accessible brands; one brand needs no question.
|
|
376
|
-
- The customer's goal, occasion, audience, selected angle and constraints when supplied; otherwise propose defaults from the verified kit.
|
|
377
|
-
- The selected format's required assets. Presence does not prove suitability; uncertain assets remain “needs review.”
|
|
378
|
-
|
|
379
|
-
## Save durable brand answers, then verify them
|
|
380
|
-
|
|
381
|
-
Read the selected brand with `brand_read { brand_id, sections: ["summary", "kit", "products", "learnings", "onboarding"] }`
|
|
382
|
-
(older clients: `brand_get_context` with the same sections, only when that tool is advertised).
|
|
383
|
-
Keep founder answers, user corrections, research and your own hypotheses distinct. Reuse
|
|
384
|
-
matching saved answers; ask only about gaps.
|
|
385
|
-
|
|
386
|
-
When the user asks to remember a rule, answers a brand interview, or explicitly corrects a
|
|
387
|
-
standing fact, save that answer in the same turn. The capture request authorizes those answers;
|
|
388
|
-
do not ask for approval again. A direction for this one video stays in its brief. If the scope
|
|
389
|
-
is genuinely ambiguous, ask whether it applies to future videos before saving a standing rule.
|
|
390
|
-
|
|
391
|
-
Use the **live registered schema**. Where supported, call `brand_update` with
|
|
392
|
-
`knowledge_intent: "user_correction"` and `user_statement` containing the user's exact,
|
|
393
|
-
verbatim answer, not your paraphrase or researched text.
|
|
394
|
-
For an inference or suggested improvement, use `knowledge_intent: "agent_proposal"`. Show the
|
|
395
|
-
before/after change from your prior read and proposed value; retain the returned proposal IDs
|
|
396
|
-
and say the user must accept it in the app. Link only a review surface actually returned by a
|
|
397
|
-
tool; the compact `knowledge_updates` response does not itself contain a diff or URL.
|
|
398
|
-
A pending proposal is not a saved fact. Never call an unavailable
|
|
399
|
-
tool or silently relabel research or your inference as something the user said.
|
|
400
|
-
|
|
401
|
-
The safe structured shape is `patch: { knowledge: { positioning?, audience?, voice?,
|
|
402
|
-
instructions?, brandType?, tagline?, valueProps? } }`, using only fields present in the live
|
|
403
|
-
schema. Inferred rules/taste go in an `instructions` proposal with a rationale, never in
|
|
404
|
-
`patch.facts`. Prefix every video-only preference in that proposed text with "Video preference:"
|
|
405
|
-
so it remains production direction after acceptance. Preserve unrelated instructions when
|
|
406
|
-
proposing a merged replacement.
|
|
407
|
-
|
|
408
|
-
| User answer | Canonical write |
|
|
409
|
-
| --- | --- |
|
|
410
|
-
| Primary audience, positioning or voice correction | `patch.knowledge: { audience/positioning/voice: <answer> }` (one actual key). During onboarding, `brand_onboarding { action: "review_research", review: { action: "correct", field, value } }` writes these existing corrections with provenance. |
|
|
411
|
-
| Founder story, customer pains, objections, buying trigger or useful audience detail without a structured field | `patch.facts: [{ kind: "insight", text }]`; retain attribution such as "Founder reports: …" rather than turn a belief into a verified result. |
|
|
412
|
-
| Required wording or pronunciation | `patch.facts: [{ kind: "must", text }]`; pronunciation is exactly `Pronounce "<term>" as "<say_as>"`. |
|
|
413
|
-
| Forbidden claim, word or visual | `patch.facts: [{ kind: "dont", text }]`. |
|
|
414
|
-
| Durable visual, voice or pacing preference | `patch.facts: [{ kind: "do", text }]` for a preference; `dont` for an avoidance; `template_hint` for a preferred format. Prefix video-only preferences with "Video preference:". |
|
|
415
|
-
|
|
416
|
-
Facts are existing `ad_brand_learning` rows with user provenance; they are not a second profile.
|
|
417
|
-
Update a matching rule by its returned `id` instead of adding duplicates. Preserve unrelated
|
|
418
|
-
rules and the user's exact meaning. Only use the legacy facts shape for explicitly user-authored
|
|
419
|
-
answers when the live schema lacks intent fields; agent suggestions still need a proposal path.
|
|
420
|
-
|
|
421
|
-
**Claims and plans have separate gates.** A founder assertion or proof point is not an approved,
|
|
422
|
-
evidence-backed claim or consent to quote a customer. Use the existing evidence/claims and
|
|
423
|
-
operating-plan tools only if registered, following their proposal, evidence and confirmation
|
|
424
|
-
requirements. Never encode a spend cap, approver or emergency stop as a learning. If that write
|
|
425
|
-
path is missing, report the specific unsaved item and keep it pending for the supported review
|
|
426
|
-
surface; do not claim it was saved or create a parallel local profile.
|
|
427
|
-
|
|
428
|
-
After every write, **read back before saying saved**: use `brand_read` with `kit`, `learnings`
|
|
429
|
-
or `onboarding` as appropriate, or `brand_onboarding { action: "status", brand_id }` after an
|
|
430
|
-
onboarding answer. Verify the intended field/rule, its source and the absence of a conflicting
|
|
431
|
-
duplicate. A generic success response, pending proposal, ignored key or truncated result is not
|
|
432
|
-
proof. Report partial saves honestly. Carry the verified rules into the current task and the
|
|
433
|
-
routed skill; claims still pass their own safety gate.
|
|
434
|
-
|
|
435
|
-
## Video taste — reuse examples and preferences
|
|
436
|
-
|
|
437
|
-
When asked to capture video taste, or when the user volunteers a durable video preference,
|
|
438
|
-
first read the saved learnings and `media_list { brand_id, scope: "brand", scope_id: brand_id,
|
|
439
|
-
tags: ["video-taste"], limit: 100 }`. Follow `next_cursor` before deciding an example is absent.
|
|
440
|
-
Do not force a taste interview before an unrelated task or ask again for an existing preference.
|
|
441
|
-
|
|
442
|
-
Save what the user has already supplied first. Then ask only the missing useful question, for
|
|
443
|
-
example: "What do you like about this video—its pace, voice, captions, or look?" An inaccessible
|
|
444
|
-
link can still be saved as a link with the user's explanation; do not pretend you watched it.
|
|
445
|
-
|
|
446
|
-
- **Direct clip or video file:** register with `media_upload { brand_id, scope: "brand",
|
|
447
|
-
scope_id: brand_id, kind: "video", source: { type: "url", url }, tags: ["video-taste", "reference-only"],
|
|
448
|
-
metadata: { purpose: "video_taste", source_url: url, provenance: "user", captured_at: <ISO timestamp>,
|
|
449
|
-
preference: <the user's explanation> } }`. For a file use the live file/bytes upload flow and
|
|
450
|
-
`media_confirm` after a presigned upload. Registration of a URL does not copy or inspect it.
|
|
451
|
-
- **Instagram/post/page link:** the same registration with `kind: "document"`; it is a link
|
|
452
|
-
bookmark, not downloadable footage or an indexed transcript. Do not fabricate a direct clip URL.
|
|
453
|
-
- **Preferences:** save the user's reasons, likes and dislikes through the facts mapping above.
|
|
454
|
-
Read and preserve existing facts before updating one. Do not invent `video_preferences` or
|
|
455
|
-
new `video_lab` keys; the live kit patch accepts only its documented asset fields.
|
|
456
|
-
- **Deduplicate:** reuse a matching returned media row, then `media_update` its title/tags/metadata
|
|
457
|
-
if needed; preserve existing metadata and tags. Do not create another row for the same example.
|
|
458
|
-
Read back with `media_list` and `brand_read` learnings before claiming it was saved.
|
|
459
|
-
Check the returned row belongs to this brand: URL deduplication may return another brand's
|
|
460
|
-
existing row. Do not relabel that row or claim success unless the current brand's scoped read
|
|
461
|
-
actually returns it. Report an unsaved association if no supported attach path is available.
|
|
462
|
-
|
|
463
|
-
Never put third-party taste examples into kit reference images: `kind: "reference"` at brand
|
|
464
|
-
scope writes there. The tags and metadata above record purpose and provenance; **they do not
|
|
465
|
-
grant or enforce usage rights**. Study the structure, pacing and look only. Never use the example's
|
|
466
|
-
footage, face, product, testimonial or claims in a new ad without independently verified permission.
|
|
467
|
-
|
|
468
|
-
Read video-only entries prefixed `Video preference:` from both saved learnings and
|
|
469
|
-
`kit.instructions`, including accepted proposals. Keep them out of required or forbidden
|
|
470
|
-
dialogue. Build a brief from the verified readback: preferred pace, voice, caption treatment, visual style,
|
|
471
|
-
formats to favour/avoid, reference links and the user's reasons. Say what is still unknown.
|
|
472
|
-
Pass it with the brand rules into the existing video workflow. A one-video request overrides a
|
|
473
|
-
default for that project; it does not silently rewrite the brand's standing preference.
|
|
474
|
-
|
|
475
|
-
## Composed Atoms
|
|
476
|
-
|
|
477
|
-
Use the live canonical schemas: brand_read, brand_create, video_catalog_list,
|
|
478
|
-
video_project_upsert, video_project_read, catalog_fetch, goose_run_task and job_cancel.
|
|
479
|
-
An old tool name in a recipe is not grounds for terminal-update advice in a chat host.
|
|
480
|
-
|
|
481
|
-
## Paid media: images, clips, voice
|
|
482
|
-
|
|
483
|
-
**No FAL_KEY, ElevenLabs key or `fal_client` is ever needed.** Use
|
|
484
|
-
`data_post_provider { provider: "fal", path: <model id, e.g. "fal-ai/nano-banana/edit">, body: <model input>, project_id }`
|
|
485
|
-
then `job_get { job_id }`; voice/music use provider:"elevenlabs". Upload local inputs through
|
|
486
|
-
media_upload first. **A missing key is never a blocker.** `photos_generate` is **not** a general
|
|
487
|
-
image tool: it photographs physical catalog products only. Use goose-video-local for the
|
|
488
|
-
runtime, paid approval, asset saving and quality checks.
|
|
489
|
-
|
|
490
|
-
## Workflow
|
|
491
|
-
|
|
492
|
-
### 1. Resolve the brand, quietly when you can
|
|
493
|
-
|
|
494
|
-
Call brand_read without brand_id to list accessible brands. Resolve the customer's name from
|
|
495
|
-
actual returned names. One brand, or exactly one match: state it and continue. Several possible
|
|
496
|
-
brands: show names and websites and ask once. No match: show accessible brands and offer to add
|
|
497
|
-
one only when the customer asks and supplies its website; never guess the URL.
|
|
498
|
-
|
|
499
|
-
Read `brand_read { brand_id, sections: ["summary","kit","products","learnings"] }` before
|
|
500
|
-
choosing a format. Reconcile explicit brand corrections through the durable capture rules.
|
|
501
|
-
A direct video request does not require first-campaign acceptance. Follow any returned
|
|
502
|
-
request-specific setup requirement; never mark research complete or accept a campaign to
|
|
503
|
-
bypass setup. Keep the original request.
|
|
504
|
-
|
|
505
|
-
### 2. Keep the goal and propose defaults
|
|
506
|
-
|
|
507
|
-
Never ask what the ad is for before showing formats. Keep the customer's exact direction.
|
|
508
|
-
Otherwise propose defaults from the verified kit's products, audience, offer and voice and the
|
|
509
|
-
Brain search's evidence brief (proven angles, saved rules, approved claims). Show those defaults
|
|
510
|
-
in the saved plan so any can be changed. Never invent proof or product facts.
|
|
511
|
-
Idea requests still follow ad-angle-miner with the video output.
|
|
512
|
-
|
|
513
|
-
### 3. Show the picker or its text fallback
|
|
514
|
-
|
|
515
|
-
Call `video_catalog_list { kind: "formats", brand_id }`. Every caller gets every format.
|
|
516
|
-
Respect requested limit and next_cursor for more item pages; the card may
|
|
517
|
-
contain a full picker independently of the item page.
|
|
518
|
-
|
|
519
|
-
- **card.display_hint:"widget"**: the picker replaces a format table. Write at most one short
|
|
520
|
-
acknowledgement, print no table or list of the formats, and wait for the selection.
|
|
521
|
-
- **Otherwise**: print card.text_summary as returned. Without a card, show returned rows with
|
|
522
|
-
names, faithful descriptions, needs and demo links, respecting the requested page size.
|
|
523
|
-
Write "no demo yet" when absent. Never put links only in a question control.
|
|
524
|
-
- A format whose card contradicts what they asked for is never Suggested. A `needs_browser`
|
|
525
|
-
format is made only on the customer's computer (the coworker has no browser): if you have no
|
|
526
|
-
shell there and the customer picks one, say it needs GooseWorks running on their computer and
|
|
527
|
-
offer another.
|
|
528
|
-
- `suggested` ranks a row for the brand; it never means the row makes the setup they named.
|
|
529
|
-
Never tell the customer a row is "exactly" what they asked for beyond what its card says. A
|
|
530
|
-
street interview still needs the route check above first.
|
|
531
|
-
- Missing required assets are missing; unknown suitability is “needs review.” Inspect the
|
|
532
|
-
selected format's candidates before spending. Never promise an unverified asset is ready.
|
|
533
|
-
- Template formats use **one plan, one approval with the total in credits**, not approval for
|
|
534
|
-
each paid step. Custom videos retain separate authenticated script/ingredient/budget gates in this chat.
|
|
535
|
-
|
|
536
|
-
### 4. Check this machine can render it
|
|
537
|
-
|
|
538
|
-
- **No shell on the customer's computer:** skip local checks and hand the project off in Step 5.
|
|
539
|
-
Never tell the customer they need Claude Code to start. Give computer setup guidance only if
|
|
540
|
-
asked how to make a `needs_browser` format.
|
|
541
|
-
- **Local shell:** run `gooseworks doctor --no-browser` for common setup (auth/MCP, Node 18+,
|
|
542
|
-
ffmpeg with libx264 (libass only for an ASS caption route), ffprobe). Then fetch the selected template and its capabilities,
|
|
543
|
-
and install documented dependencies in its fetched folder. Do not guess a renderer from a
|
|
544
|
-
format name. For each Node renderer using default Playwright Chromium, run
|
|
545
|
-
`gooseworks doctor --renderer-script "/absolute/path/to/the/fetched/scripts/record.js"` with
|
|
546
|
-
the exact environment used to render, including NODE_PATH and PLAYWRIGHT_BROWSERS_PATH.
|
|
547
|
-
Use the actual script path. Custom browser launch settings need their equivalent exact-runtime
|
|
548
|
-
check. Non-browser capabilities need only their documented runtime checks.
|
|
549
|
-
Never create paid ingredients before the selected renderer passes. Repair and recheck under
|
|
550
|
-
existing setup permissions. If it cannot be fixed, hand the project off in Step 5 (a
|
|
551
|
-
`needs_browser` format can't be: offer another); never silently change the selected format.
|
|
552
|
-
- **Coworker sandbox:** you are the renderer. Follow goose-video-local's sandbox checks; never
|
|
553
|
-
hand off recursively or claim browser capability that the sandbox lacks.
|
|
554
|
-
|
|
555
|
-
### 5. Create the project and hand it off, in this session
|
|
556
|
-
|
|
557
|
-
1. `video_project_upsert { brand_id, name, format: <template_id> }` with no brief (a brief creates
|
|
558
|
-
a concept batch). A street interview is created only after its route check found a supported
|
|
559
|
-
setup. Default
|
|
560
|
-
creation_intent:"format" keeps the style with this brand's content; source_remix requires an
|
|
561
|
-
explicit choice to use source content.
|
|
562
|
-
If they already chose a campaign/concept, include its verified campaign_id and optional
|
|
563
|
-
campaign_concept_id. Read the IDs from that brand's saved campaign; the concept must belong
|
|
564
|
-
to it. Omit unknown IDs and never infer a link or create a campaign solely to file a video.
|
|
565
|
-
2. **You make it** (a shell on the customer's computer, or the coworker sandbox): load
|
|
566
|
-
`catalog_fetch { type: "skill", slug: "goose-video-local" }` and follow it on the same project_id.
|
|
567
|
-
Carry the customer's words, verified defaults, campaign, selected angle and a street
|
|
568
|
-
interview's route check result into its brief.
|
|
569
|
-
3. **No shell there:** `goose_run_task { brand_id, project_id, message }` with the request, selected
|
|
570
|
-
format, defaults and a street interview's route check result. Keep task_id. Continue questions/edits with the same task and project.
|
|
571
|
-
A saved free draft is not a started worker or a complete plan. Follow actual saved state.
|
|
572
|
-
4. When follow.card_follows is true, the card follows progress: do not re-read it in a loop.
|
|
573
|
-
Read again on a customer reply, card action or requested update. A failure or missing saved
|
|
574
|
-
plan needs the returned recovery action; never claim completion or approve an empty plan.
|
|
575
|
-
Approval requires the current complete plan and total. Insufficient balance: offer a shorter
|
|
576
|
-
video or top-up. “Not now” keeps the saved plan.
|
|
577
|
-
5. On the customer's yes, record it with `video_project_upsert { brand_id, project_id, patch:
|
|
578
|
-
{ approve: { user_quote, total_credits } } }`. Its reply says what comes next: the coworker
|
|
579
|
-
gets the approval when it is making the video; otherwise you render it.
|
|
580
|
-
|
|
581
|
-
Do not hand the customer a command to paste somewhere else.
|
|
582
|
-
|
|
583
|
-
## Decision Rules
|
|
584
|
-
|
|
585
|
-
- One sentence is a complete request. Resolve the brand and show formats without a goal interview.
|
|
586
|
-
- One brand in the org: never ask which brand. Cards decide presentation; checks decide execution.
|
|
587
|
-
- Use canonical tools. Preserve campaign context, selected script angles and custom authenticated review gates.
|
|
588
|
-
- Never fabricate readiness, completion, approval or a second project.
|
|
589
|
-
|
|
590
|
-
## Output
|
|
591
|
-
|
|
592
|
-
One project, one current saved plan in this chat, then the finished video. With a widget write one
|
|
593
|
-
line and do not add app_url, brand_url or duplicate video links. A text host gets text_summary
|
|
594
|
-
and its usable delivery link.
|
|
595
|
-
|
|
596
|
-
## Quality Checks
|
|
597
|
-
|
|
598
|
-
- No forced goal question, duplicate table or unsupported shell claim.
|
|
599
|
-
- The exact renderer passed before local paid ingredients; uncertain assets stay uncertain.
|
|
600
|
-
- Selected campaign and angle survive; a single template project has no brief.
|
|
601
|
-
- Current complete plan and total precede approval. Custom script and ingredient gates remain independent; Studio is optional.
|
|
602
|
-
|
|
603
|
-
## Failure Modes
|
|
604
|
-
|
|
605
|
-
| Symptom | Cause | Fix |
|
|
606
|
-
| --- | --- | --- |
|
|
607
|
-
| Picker plus table | Ignored display_hint | Widget: one line; otherwise text_summary |
|
|
608
|
-
| Agent with a shell hands off | Decided from the host, not the rule | Make it here; hand off only without a shell or a fixable toolchain |
|
|
609
|
-
| Chat told it cannot start | Only local execution considered | Create once and delegate to coworker |
|
|
610
|
-
| Worker ends without a plan | Assumed completion means ready | Follow actual failure/recovery state |
|
|
611
|
-
| Two projects for one video | Recreated instead of resuming | Continue same project and task |
|
|
612
|
-
|
|
613
|
-
## Use uploaded footage
|
|
614
|
-
|
|
615
|
-
When the customer asks to use existing footage, check the actual advertised schemas. Use `media_search` with purpose `production`, kind `video`, the brand and current project when needed. Omit query spend for free retrieval. Read facts/scenes with `media_analyze`, then use `media_excerpt` action `inspect` to review actual bounded frames and timed transcript before selecting. A description or thumbnail URL alone is not visual review.
|
|
616
|
-
|
|
617
|
-
Freeze `source_excerpt:{asset_id,analysis_revision,scene_id,start_ms,end_ms,audio_mode}`. Revision is the original-byte SHA, scene may be null for a known user trim, bounds use integer milliseconds, and audio is original or muted. Call `media_excerpt` action `attach` with that exact selection and a stable idempotency key. The returned project remains unfinished and unapproved. Open its existing Studio review; preserve user locks and requested format, and keep footage separate from image packshot indexes. An incompatible format requires an explicit choice before changing it.
|
|
618
|
-
|
|
619
|
-
For custom production, fetch the current shared `video-production-harness` and follow script/ingredient gates. Download the verified original and trim its exact selected window at normal speed with the approved audio. Recheck current revision and production permission before consumption and final upload/completion. Save excerpt lineage in plan and ingredient readback. Missing optional semantics does not require another upload; known user-selected stored footage remains usable. Research and competitor references never become production footage. Selected originals require no paid generation; only newly generated/replaced ingredients consume the approved budget.
|
|
22
|
+
- Talk to marketers: what they get and what they decide, never how it is made.
|
|
23
|
+
- Never mention tools, ids, JSON, commands, software, vendors, models, timings, retries or your checks.
|
|
24
|
+
- Everything happens in this chat: never ask the customer to install anything or use a CLI, slash command or other app; the only commands are gooseworks video check and gooseworks video make <id>, when a next_step gives them.
|
|
25
|
+
- Money is a credit number, exactly as an answer gives it: never dollars, never your own math.
|
|
26
|
+
- Follow the next_step in every answer; it says what to do now.
|
|
27
|
+
- With a card on screen (display_hint "widget"), add at most one short line; never re-list it or its links.
|
|
28
|
+
- Paid work needs the customer's yes to the credit total first. For video only their click on the plan card counts; you never approve.
|
|
29
|
+
- Only the customer's click on the plan card approves a video; a yes typed in chat is not an approval.
|
|
30
|
+
- Where the app can't show the card, give the customer the plan link; they press the button there.
|
|
31
|
+
- Never invent an offer, a claim or proof.
|
|
32
|
+
- GooseWorks holds every provider key and bills the work: never ask for a key, token, password or ad account id, and never call a vendor yourself.
|