@lincyaw/skills 1.0.0-rc.54 → 1.0.0-rc.56

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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@lincyaw/skills",
3
- "version": "1.0.0-rc.54",
3
+ "version": "1.0.0-rc.56",
4
4
  "description": "Presmium's bundled authoring, animation, presentation and plugin-development skills for coding agents",
5
5
  "license": "Apache-2.0",
6
6
  "repository": {
@@ -36,7 +36,7 @@
36
36
  ],
37
37
  "dependencies": {
38
38
  "jiti": "^2.7.0",
39
- "@lincyaw/kernel": "1.0.0-rc.54"
39
+ "@lincyaw/kernel": "1.0.0-rc.56"
40
40
  },
41
41
  "presmium": {
42
42
  "skills": [
package/skills/index.json CHANGED
@@ -12,8 +12,8 @@
12
12
  "references/publishing.md",
13
13
  "references/writing.md"
14
14
  ],
15
- "version": "1.0.0-rc.54",
16
- "hash": "18a11fb1c9ce18e9f96421195e52350949e8b9f71f5a7620e2122d40ec2a6980"
15
+ "version": "1.0.0-rc.56",
16
+ "hash": "b535c0a660c48a183b2b88aa5fef678241887c634cc794f597ca5facb0baef32"
17
17
  },
18
18
  {
19
19
  "name": "presmium-animate",
@@ -545,7 +545,7 @@
545
545
  "references/team.md",
546
546
  "references/timeline.md"
547
547
  ],
548
- "version": "1.0.0-rc.54",
548
+ "version": "1.0.0-rc.56",
549
549
  "hash": "76dc5b50143b8134b36c010e5416033652071373500f214f4e7b1792af8a0c4a"
550
550
  },
551
551
  {
@@ -556,7 +556,7 @@
556
556
  "references/plugin.md",
557
557
  "references/testing.md"
558
558
  ],
559
- "version": "1.0.0-rc.54",
559
+ "version": "1.0.0-rc.56",
560
560
  "hash": "af8f48dbe9dbc5bd772fa3d6172ae9c9b96626fec2cd7933b4e08f7c5f154b75"
561
561
  }
562
562
  ]
@@ -43,9 +43,9 @@ Each page has one idea and two versions. The reading version is written like a b
43
43
 
44
44
  When the MCP server `presmium` offers author actions (the studio's assistant; or `presmium mcp` while Presmium Studio or `presmium serve` runs for the project, which a new project's `.mcp.json` connects Claude Code to), change the document through them, the same actions the studio's buttons use. The server's instructions list this order too; each tool describes its own parameters.
45
45
 
46
- 1. **Find the target.** `get_context` gives the current saved page, step, narration and actually reported selection. When no editor is connected or several targets are possible, name the document/page explicitly; `list_documents` lists documents. Pending editor state is not saved draft content.
46
+ 1. **Find the target.** `get_context` gives the current saved page, step, narration, aligned stable narrationIds and actually reported selection; script output is capped at 12 blocks and 2000 UTF-16 characters. When no editor is connected or several targets are possible, name the document/page explicitly; `list_documents` lists documents. Pending editor state is not saved draft content.
47
47
  2. **Read the context the edit needs.** An explicit title change goes straight to `rename_page` with `section` (page number from 1, or stable ID) and `title`. For content, use `get_document_outline` and `read_document_part` for the complete values you will change and the relevant surrounding pages. An advertised tool does not require a separate capability request. The external MCP catalog is compact. Find additional actions with `operations`, inspect one by name for generated argument summaries, and request `schema:true` only for a complete input definition. For a tool with variants, select the needed action with `name` and `variant` (for example `editor_action` and `body-drafts.read`); its arguments come from the original schema, without returning the other actions. Dispatch through the matching read/edit/spend/write/agent operation tool. CLI `presmium mcp tools <tool>` returns a summary, `--schema` the complete input schema and `tools --all --json` the full catalog.
48
- 3. **Save in one call.** Use `rename_page` for a title, `edit_narration` for a unique exact phrase replacement or deletion, and the discovered `edit_document` operation for canonical operations on text, blocks, steps, narration, timing and assets. Narration edits default to the current editor page/step; missing or ambiguous original text is refused. Comments, voice, caption scale and component parameters also have generated one-call actions such as `comment_create`, `voice_set` and `caption_scale_set`. The server reads the current source, preflights, saves and verifies the saved source internally; no separate plan/apply/readback requests are needed. Pass optional `source` when the intent depends on a prior read. A 409 requires a fresh read and an explicit decision, never an automatic retry. The owner's MCP credential already authorizes canonical document editing; execution and paid generation keep their confirmation policies. A simple edit returns saved/changed and editor status; request details only for diagnostics. Versions, hashes, plans and source readback stay on the server for ordinary edits. Plan/apply tools remain for complex reviewed changes, page creation/move/deletion and duplication; deletion retains explicit confirmation. A refused approval is final for that request.
48
+ 3. **Save in one call.** Use `rename_page` for a title, `edit_narration` for a unique exact phrase replacement/deletion or `remove` of one whole script block by stable ID (preferred after a read) or 1-based index, and the discovered `edit_document` operation for canonical operations on text, blocks, steps, narration, timing and assets. Narration edits default to the current editor page/step; missing targets or ambiguous original text are refused. Phrase and whole-block modes are exclusive. Use canonical `setStepNarrations` for the complete ordered list of existing script IDs, including an empty list; omitted links are removed while content used by other steps remains. New blocks can be created with `setNarration` earlier in the same atomic batch. Comments, voice, caption scale and component parameters also have generated one-call actions such as `comment_create`, `voice_set` and `caption_scale_set`. The server reads the current source, preflights, saves and verifies the saved source internally; no separate plan/apply/readback requests are needed. Pass optional `source` when the intent depends on a prior read. A 409 requires a fresh read and an explicit decision, never an automatic retry. The owner's MCP credential already authorizes canonical document editing; execution and paid generation keep their confirmation policies. A simple edit returns saved/changed and editor status; request details only for diagnostics. Versions, hashes, plans and source readback stay on the server for ordinary edits. Plan/apply tools remain for complex reviewed changes, page creation/move/deletion and duplication; deletion retains explicit confirmation. A refused approval is final for that request.
49
49
  4. **Use the returned evidence.** For a simple edit, report its saved value and editor feedback; do not run whole-document checks or captures by default. Run `check_document` and `get_diagnostics` for code or structural changes, reported failures, or when requested. Fix what you caused; report what you cannot fix. Pending or unavailable editor feedback does not invalidate a successful save or justify repeating the write.
50
50
  5. **Inspect appearance when the task needs it.** For layout and animation work, `capture_slides` returns the changed page at rest, with `at` for animation moments and `measure` for element boxes. `capture_reading` checks reading layout and phone width; `capture_overview` reviews a deck. Capture only the affected scope. Saved source and reported editor synchronization do not prove visual layout or playback. Don't script a browser for this.
51
51
  6. **Voiceover and outputs are explicit.** Editing narration never generates audio. Read `get_voiceover_status`, tell the author the engine, the voice and the number of sentences (a cloud engine charges for them), and call `start_voiceover` only after the author agrees; without an MCP host, `presmium voiceover` gives the same report and generates with `--yes`. `build` and `get_builds` make and list outputs. Details in [Lecture production](references/lecture.md) and [Publishing](references/publishing.md).
@@ -1,6 +1,6 @@
1
1
  # Editing with the studio and an agent
2
2
 
3
- For an explicit title change use `rename_page` with the page number or stable ID and title. For other canonical content changes use `edit_document` with operations. Both read the source, preflight, save through the Web transaction/history and verify saved content inside one call; pass optional source when intent depends on an earlier read. Their default receipt is saved/changed plus editor status; details are opt-in. `get_context` reads the current saved editor target; `edit_narration` replaces a unique exact phrase while preserving cue/pronunciation atoms. Pending feedback never means that the save should be repeated. Use plan/apply tools when a change needs separate impact review. The local owner's MCP credential authorizes canonical editing without a second Studio confirmation; execution, browser control and paid generation retain their own policies. External MCP exposes a compact catalog: use `operations` to discover actions and generated argument summaries, then the dispatcher matching its kind; `schema:true` opts into a complete definition. CLI parameter discovery is automatic: `presmium mcp tools <tool>` returns generated summaries, `--schema` returns inputSchema and `tools --all --json` returns the full catalog. Do not look up tool parameters in implementation source.
3
+ For an explicit title change use `rename_page` with the page number or stable ID and title. For other canonical content changes use `edit_document` with operations. Both read the source, preflight, save through the Web transaction/history and verify saved content inside one call; pass optional source when intent depends on an earlier read. Their default receipt is saved/changed plus editor status; details are opt-in. `get_context` reads the current saved editor target; `edit_narration` replaces a unique exact phrase while preserving cue/pronunciation atoms, or removes one complete block with `remove` by stable narration ID or 1-based index. `get_context` aligns saved text with stable IDs (at most 12 blocks / 2000 UTF-16 characters); prefer the ID after reading. Use canonical `setStepNarrations` to replace the complete ordered reference list, removing omitted links and preserving content still used by other steps. Pending feedback never means that the save should be repeated. Use plan/apply tools when a change needs separate impact review. The local owner's MCP credential authorizes canonical editing without a second Studio confirmation; execution, browser control and paid generation retain their own policies. External MCP exposes a compact catalog: use `operations` to discover actions and generated argument summaries, then the dispatcher matching its kind; `schema:true` opts into a complete definition. CLI parameter discovery is automatic: `presmium mcp tools <tool>` returns generated summaries, `--schema` returns inputSchema and `tools --all --json` returns the full catalog. Do not look up tool parameters in implementation source.
4
4
 
5
5
  For an external HTTP MCP client, start Studio and configure `http://127.0.0.1:4321/mcp` (Streamable HTTP) with `Authorization: Bearer <token>` from the token file printed at startup. Studio preserves both for the same launch directory across restarts and upgrades. With `--host 0.0.0.0`, use the printed network MCP URL from other machines. A second Studio needs a different fixed `--preview-port`; an occupied port fails instead of silently changing the URL.
6
6
 
@@ -46,8 +46,9 @@ Expand an animation card's step captions/script area to edit canonical narration
46
46
  For pending production inputs use `editor_action` with `production-drafts.inspect`, `.read` or `.discard`.
47
47
  Discover the selected variant through `operations`; inspect returns at most ten metadata entries without
48
48
  input values. Choose its opaque `draft` for an explicit bounded JSON read, or discard with `confirm:true`.
49
- The native stores cover step hold/pause, caption timing and recording range; recording ranges are memory
50
- only. Discard resets the open field to its saved value without saving the document. Composition, an active
49
+ The native stores cover step hold/pause, caption timing, recording range, voice choices and media clip
50
+ proposals; recording ranges are memory only. Each media clip proposal has its own handle; discarding one
51
+ keeps sibling inputs. Voice and media forms still recover through their own native reopen flow. Discard resets the open field to its saved value without saving the document. Composition, an active
51
52
  save, a changed source or unavailable storage can refuse it and retain the proposal. Local inspect/read
52
53
  still work with invalid saved JSON. Use a fresh inspect after input changes; these stores contain current
53
54
  proposals, not historical backup branches.