@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 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
- ## Getting Started
11
+ ## Requirements
12
12
 
13
- ### 1. Install Node.js 25
13
+ Node.js ≥ 25. Install via [nvm](https://github.com/nvm-sh/nvm): `nvm install 25 && nvm use 25`.
14
14
 
15
- Vincent requires Node.js 25 or later. The easiest way is [nvm](https://github.com/nvm-sh/nvm):
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
- ### 3. Get a Google API key
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 (Prepay and Postpay). 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.
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
- ### 4. Make your first video
33
+ ## Usage
44
34
 
45
35
  ```bash
46
- vincent path/to/product-image.jpg
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
- ## Quickstart
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
- Vincent opens an interactive session. Describe what you want; it will propose a concept,
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-url-or-path] [options]
48
+ vincent [image] [options]
84
49
 
85
- --image <url|path> Product image (also accepted as a positional arg)
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.95.1
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 2.0.0
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.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 [yyyy] [name of copyright owner]
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.7.4
3588
+ semver 7.8.0
3589
3589
  --
3590
3590
  The ISC License
3591
3591