@magyk/vincent 0.1.14 → 0.1.17
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/CHANGELOG.md +58 -0
- package/README.md +14 -54
- package/dist/THIRD_PARTY_NOTICES.txt +5 -5
- package/dist/vincent.js +1 -1
- package/package.json +2 -2
package/CHANGELOG.md
CHANGED
|
@@ -6,6 +6,64 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
|
|
|
6
6
|
|
|
7
7
|
---
|
|
8
8
|
|
|
9
|
+
## [0.1.17] — 2026-05-14
|
|
10
|
+
|
|
11
|
+
### Fixed
|
|
12
|
+
- **Local image paths with spaces now work** — pasting a path like
|
|
13
|
+
`/Users/alice/Downloads/product shot.png` directly into Vincent no longer
|
|
14
|
+
silently fails. Previously the path was split at the first space, losing
|
|
15
|
+
the extension, so the image was never detected. The fix uses Node's
|
|
16
|
+
`path.extname` and `path.isAbsolute` instead of hand-rolled string checks.
|
|
17
|
+
|
|
18
|
+
---
|
|
19
|
+
|
|
20
|
+
## [0.1.16] — 2026-05-13
|
|
21
|
+
|
|
22
|
+
### Added
|
|
23
|
+
- **Agent memories** — Vincent now remembers guidance and preferences across sessions.
|
|
24
|
+
When you say things like "always ask before generating more than 3 videos", "keep proposals
|
|
25
|
+
to one sentence", or "prefer cinematic lighting", he stores them and applies them to every
|
|
26
|
+
future session automatically.
|
|
27
|
+
- **`/memories` command** — lists all saved guidance and preferences at any time.
|
|
28
|
+
- **`remember` tool** — the agent calls this autonomously when you state a clear rule or
|
|
29
|
+
preference. Two categories: `guidance` (how the agent should operate) and `preference`
|
|
30
|
+
(how output should look). Memories are stored in `~/.local/share/magyk/vincent/memories.json`
|
|
31
|
+
(macOS: `~/Library/Application Support/magyk/vincent/memories.json`).
|
|
32
|
+
|
|
33
|
+
### Changed
|
|
34
|
+
- **Session storage reorganized** — all Vincent data (sessions, memories, future preferences)
|
|
35
|
+
now lives under `~/.local/share/magyk/vincent/` (macOS: `~/Library/Application Support/magyk/vincent/`).
|
|
36
|
+
Sessions are in `vincent/sessions/`. Existing sessions are not migrated — they were in the
|
|
37
|
+
old `genartifacts/pvtui-*` location and will no longer appear in `/resume`. Start a fresh
|
|
38
|
+
session to continue under the new layout.
|
|
39
|
+
|
|
40
|
+
### Removed
|
|
41
|
+
- Unused internal creative preference tools (`set_creative_preferences`, `reset_creative_preferences`)
|
|
42
|
+
that were never exposed to users. Explicit creative preferences are now set via the `remember` tool.
|
|
43
|
+
|
|
44
|
+
---
|
|
45
|
+
|
|
46
|
+
## [0.1.15] — 2026-05-13
|
|
47
|
+
|
|
48
|
+
### Added
|
|
49
|
+
- **`/new` command** — start a fresh session in-place without restarting the TUI.
|
|
50
|
+
Clears the chat, creates a new work directory, and re-shows the welcome message.
|
|
51
|
+
Blocked while an agent operation is in progress; any active proposal is dismissed
|
|
52
|
+
cleanly before the reset.
|
|
53
|
+
- **Conversation history on resume** — when picking up a previous session, the last
|
|
54
|
+
few exchanges (up to ~5 user-assistant pairs) are replayed into the chat so you
|
|
55
|
+
can see where things left off. Thinking traces, tool calls, and internal context
|
|
56
|
+
messages are filtered out; product images are shown inline if the terminal supports it.
|
|
57
|
+
|
|
58
|
+
### Changed
|
|
59
|
+
- **Longer animation prompts for Veo** — when a Veo model is selected, the
|
|
60
|
+
animation prompt generator now targets up to 200 words (previously capped at
|
|
61
|
+
~100 words for all models). Hailuo remains at 100 words. The word budget is
|
|
62
|
+
defined per-model in the capabilities registry, so future models can set their
|
|
63
|
+
own limit without any branching in tool code.
|
|
64
|
+
|
|
65
|
+
---
|
|
66
|
+
|
|
9
67
|
## [0.1.14] — 2026-05-13
|
|
10
68
|
|
|
11
69
|
### Added
|
package/README.md
CHANGED
|
@@ -8,28 +8,18 @@ No video editing skills required.
|
|
|
8
8
|
|
|
9
9
|
Built on Google Gemini (LLM + image generation) and Veo3 (video generation).
|
|
10
10
|
|
|
11
|
-
##
|
|
11
|
+
## Requirements
|
|
12
12
|
|
|
13
|
-
|
|
13
|
+
Node.js ≥ 25. Install via [nvm](https://github.com/nvm-sh/nvm): `nvm install 25 && nvm use 25`.
|
|
14
14
|
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
```bash
|
|
18
|
-
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
|
|
19
|
-
source ~/.nvm/nvm.sh
|
|
20
|
-
nvm install 25
|
|
21
|
-
nvm use 25
|
|
22
|
-
node --version # should print v25.x.x
|
|
23
|
-
```
|
|
24
|
-
|
|
25
|
-
### 2. Install Vincent
|
|
15
|
+
## Install
|
|
26
16
|
|
|
27
17
|
```bash
|
|
28
18
|
npm install -g @magyk/vincent
|
|
29
19
|
vincent --version
|
|
30
20
|
```
|
|
31
21
|
|
|
32
|
-
|
|
22
|
+
## Get a Gemini API key
|
|
33
23
|
|
|
34
24
|
[Google AI Studio](https://aistudio.google.com) is the fastest way to get a key — one key covers the LLM, image generation, and Veo video generation.
|
|
35
25
|
|
|
@@ -38,63 +28,33 @@ vincent --version
|
|
|
38
28
|
3. Click **Create API key**. You can create it in a new or existing Google Cloud project.
|
|
39
29
|
4. Copy the key and keep it somewhere safe — you'll paste it into Vincent on first run.
|
|
40
30
|
|
|
41
|
-
> **Billing note:** AI Studio uses a tiered billing system
|
|
31
|
+
> **Billing note:** AI Studio uses a tiered billing system. New accounts start on a free tier with generous rate limits. For high-volume or production use you'll need to link a billing account.
|
|
42
32
|
|
|
43
|
-
|
|
33
|
+
## Usage
|
|
44
34
|
|
|
45
35
|
```bash
|
|
46
|
-
vincent
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
On first run, Vincent will ask you to paste your Gemini API key — it saves it automatically so you only need to do this once. Then describe what you want; it will propose a concept, generate scene images, animate them with Veo3, and assemble the final video in your working directory.
|
|
50
|
-
|
|
51
|
-
---
|
|
52
|
-
|
|
53
|
-
## Install
|
|
54
|
-
|
|
36
|
+
vincent # start a new session
|
|
37
|
+
vincent product.jpg # start with an image already loaded
|
|
38
|
+
vincent --image product.jpg # same, explicit flag (useful in scripts)
|
|
55
39
|
```
|
|
56
|
-
npm install -g @magyk/vincent
|
|
57
|
-
```
|
|
58
|
-
|
|
59
|
-
Requires Node.js ≥ 25.
|
|
60
40
|
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
```
|
|
64
|
-
export GEMINI_API_KEY=your_key_here
|
|
65
|
-
vincent path/to/product-image.jpg
|
|
66
|
-
```
|
|
41
|
+
**First run:** Vincent will prompt you to paste your Gemini API key — it's saved automatically and you won't be asked again. The TUI will show you how to provide an image and what commands are available.
|
|
67
42
|
|
|
68
|
-
|
|
69
|
-
generate scene images, animate them, and produce a final video in your working directory.
|
|
70
|
-
|
|
71
|
-
## Configuration
|
|
72
|
-
|
|
73
|
-
On first run, Vincent creates a settings file at:
|
|
74
|
-
- **Linux:** `~/.local/share/magyk/settings.json`
|
|
75
|
-
- **macOS:** `~/Library/Application Support/magyk/settings.json`
|
|
76
|
-
|
|
77
|
-
You can also use `/settings` inside the TUI to configure API keys and model preferences,
|
|
78
|
-
or set `GEMINI_API_KEY` in your environment (takes priority over the settings file).
|
|
43
|
+
API keys are stored in `~/.local/share/magyk/settings.json` (Linux) or `~/Library/Application Support/magyk/settings.json` (macOS). You can also use `/settings` inside the TUI to manage them, or set `GEMINI_API_KEY` in your environment (takes priority over the saved key).
|
|
79
44
|
|
|
80
45
|
## Options
|
|
81
46
|
|
|
82
47
|
```
|
|
83
|
-
vincent [image
|
|
48
|
+
vincent [image] [options]
|
|
84
49
|
|
|
85
|
-
--image <url|path> Product image
|
|
50
|
+
--image <url|path> Product image URL or local path (equivalent to positional arg)
|
|
86
51
|
--video-model <id> veo3 or veo3-lite (default: veo3-lite)
|
|
87
52
|
--storage <path> Override artifact output directory
|
|
88
53
|
--self-test Run built-in diagnostics and exit
|
|
54
|
+
--version, -v Print version and exit
|
|
89
55
|
-h, --help Show help
|
|
90
56
|
```
|
|
91
57
|
|
|
92
|
-
## Output
|
|
93
|
-
|
|
94
|
-
Each session creates a directory under `~/.local/share/magyk/genartifacts/` (Linux)
|
|
95
|
-
or `~/Library/Application Support/magyk/genartifacts/` (macOS) containing the original
|
|
96
|
-
image, generated scene images, and the final assembled video.
|
|
97
|
-
|
|
98
58
|
## License
|
|
99
59
|
|
|
100
60
|
See [LICENSE](https://www.npmjs.com/package/@magyk/vincent?activeTab=code) for terms.
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
@anthropic-ai/sdk 0.
|
|
1
|
+
@anthropic-ai/sdk 0.91.1
|
|
2
2
|
--
|
|
3
3
|
Copyright 2023 Anthropic, PBC.
|
|
4
4
|
|
|
@@ -793,7 +793,7 @@ THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
|
|
|
793
793
|
|
|
794
794
|
========================================================================
|
|
795
795
|
|
|
796
|
-
cache-manager-fs-hash
|
|
796
|
+
cache-manager-fs-hash 3.0.0
|
|
797
797
|
--
|
|
798
798
|
The MIT License (MIT)
|
|
799
799
|
|
|
@@ -1151,7 +1151,7 @@ SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
|
|
1151
1151
|
|
|
1152
1152
|
========================================================================
|
|
1153
1153
|
|
|
1154
|
-
exponential-backoff 3.1.
|
|
1154
|
+
exponential-backoff 3.1.3
|
|
1155
1155
|
--
|
|
1156
1156
|
Apache License
|
|
1157
1157
|
Version 2.0, January 2004
|
|
@@ -1341,7 +1341,7 @@ Apache License
|
|
|
1341
1341
|
same "printed page" as the copyright notice for easier
|
|
1342
1342
|
identification within third-party archives.
|
|
1343
1343
|
|
|
1344
|
-
Copyright
|
|
1344
|
+
Copyright 2019 Coveo Solutions Inc.
|
|
1345
1345
|
|
|
1346
1346
|
Licensed under the Apache License, Version 2.0 (the "License");
|
|
1347
1347
|
you may not use this file except in compliance with the License.
|
|
@@ -3585,7 +3585,7 @@ software or this license, under any kind of legal claim.***
|
|
|
3585
3585
|
|
|
3586
3586
|
========================================================================
|
|
3587
3587
|
|
|
3588
|
-
semver 7.
|
|
3588
|
+
semver 7.8.0
|
|
3589
3589
|
--
|
|
3590
3590
|
The ISC License
|
|
3591
3591
|
|