@lincyaw/skills 1.0.0-rc.51 → 1.0.0-rc.52

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.51",
3
+ "version": "1.0.0-rc.52",
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.51"
39
+ "@lincyaw/kernel": "1.0.0-rc.52"
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.51",
16
- "hash": "2ccaec9e8b4f00ae4fe278419f613fcdf3bd533e485d2e242edbefd8fcc87e6a"
15
+ "version": "1.0.0-rc.52",
16
+ "hash": "656f01866dc31f47c23a69fa860b3145c02460f75d073d738228e417ba735639"
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.51",
548
+ "version": "1.0.0-rc.52",
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.51",
559
+ "version": "1.0.0-rc.52",
560
560
  "hash": "af8f48dbe9dbc5bd772fa3d6172ae9c9b96626fec2cd7933b4e08f7c5f154b75"
561
561
  }
562
562
  ]
@@ -10,13 +10,20 @@ In Studio, AI source edits use a private candidate workspace while the author ke
10
10
 
11
11
  Web and agents modify the same `lecture.json`. Read the current document version, submit semantic edits or a full JSON document using the workspace's document transaction API, and retain unsaved input on conflict. `baseDocumentVersion` is the authoring CAS version, not a runtime IR digest.
12
12
 
13
- When connected to a workspace MCP host, read `get_authoring_capabilities`, discover saved entities with `get_document_outline`, then read complete values with `read_document_part`. Retain source on every continuation and use returned offsets to assemble explicit JSON-text fragments before parsing once. A changed source returns 409; restart the read rather than combining versions. The full `get_document` remains available to SDK consumers but may exceed the agent's tool-result budget. Changes use `plan_document_change` and `apply_document_change` through the Web transaction and return saved-source verification; generic large change inputs/results are not yet bounded. Compilation is a separate result. Do not substitute mouse automation or an edited runtime snapshot for an available author action. Compiler-only stdio reports these authoring services unavailable.
13
+ When connected to a workspace MCP host, discover saved entities with `get_document_outline`, then read complete values with `read_document_part`. Retain source on every continuation and use returned offsets to assemble explicit JSON-text fragments before parsing once. A changed source returns 409; restart the read rather than combining versions. The full `get_document` remains available to SDK consumers but may exceed the agent's tool-result budget. Changes use `plan_document_change` and `apply_document_change` through the Web transaction and return saved-source verification; generic large change inputs/results are not yet bounded. Compilation is a separate result. Do not substitute mouse automation or an edited runtime snapshot for an available author action. Compiler-only stdio reports these authoring services unavailable.
14
14
 
15
15
  To see a page as the presentation shows it, call `capture_slides` with its section: it returns PNG pictures (and their files in the service's state directory) of every step's rest frame, or of the steps and `at` moments you name (milliseconds into a step's animation, drawn by the same step clock a lecture export uses, so a picture is the same each time it is taken). `measure` adds the boxes of the elements matching a CSS selector, in slide pixels, with their text and `data-*` attributes; `appearance: 'dark'`, `scale: 2` and `clip` cover the dark theme, fine detail and one region; `captions: false` leaves out the captions drawn over the slide, and each frame's narration is in the result as text either way. At most 12 pictures a call. `arrive: 'backward'` reaches each step from the step after it, as a presenter going back does, with the page's own clock: compare it with the direct picture; `capture-page-reloaded` means going back reloaded the page. `capture_overview` takes every page at once (each page's last step, or every step with `steps: 'all'`) into one directory named in reading order, with sheets of labelled thumbnails; it is the material of a cold-read review. `capture_reading` takes one page of the reading version at a window `width` (default 1280, 390 for a phone), scrolled through so that its components load, at rest, cut at 8000 pixels. A scene whose code doesn't bundle fails alone: its page shows the failure, the capture's `problems` say why, and `check_document` (like `presmium check`) reports it as a `presmium.preview.code` error with its file and line. When the whole document can't be prepared the capture fails with `capture-preview-failed`, and `get_diagnostics` holds the reason.
16
16
 
17
- For existing workspace audio, read `get_audio_authoring_capabilities`, then call `inspect_workspace_audio` with the saved source and a permitted same-document workspace-relative path. Pass the returned exact file path, SHA-256 and byte length to `import_workspace_audio`; inspect the resulting saved asset with `inspect_document_audio`. These use the Web media transaction and readback, with agent origin and required-review enforcement. Keep the same change ID when reconciling a lost response; receipts are process-local and only reusable while their result remains current. Import does not create narration or a clip and does not start ASR or TTS.
18
-
19
- For an existing workspace image, read `get_image_authoring_capabilities` for the current source, then call `inspect_workspace_image` with that source and a same-document workspace-relative path such as `<document>/figure.png`. Pass the returned exact `file` object to `import_workspace_image` with a fresh change ID. It uses the Web image transaction, records agent origin and refuses when review is required; a stale source returns 409 and a changed file returns `image-file-changed`, both before the author is asked to approve. When the author denies the request or it times out, the tool returns `operation-not-allowed` (403, not retryable): do not retry it on your own; ask the author. Import only registers the asset: to show it, insert an `image` block with its `assetId` and an `alt` text through `plan_document_change` and `apply_document_change`.
17
+ For existing workspace audio or images, call `import_workspace_audio({path})` or
18
+ `import_workspace_image({path})` with a same-document workspace-relative path. No separate capability,
19
+ source or inspection request is needed. The host pins source and actual SHA-256/bytes before approval and
20
+ rechecks them at commit. To adopt recorded audio, call `adopt_recording({stepId, assetId})`; source and
21
+ asset hash are managed internally. Ordinary results are compact. Pass optional `source` for intent based
22
+ on a prior read, and `details:true` for verification details. Advanced `request` preserves the original
23
+ explicit native contract; do not mix it with ordinary fields. `operations` derives `inputChoices` for
24
+ these alternatives from the schema. A conflict or lost response requires checking saved assets/steps,
25
+ not automatically repeating an import. Import only registers an asset; insert an image block with its
26
+ assetId and alt text separately, and explicitly choose an audio asset before adopting it as narration.
20
27
 
21
28
  Every tool that writes the document (`apply_document_change`, `apply_page_change`, `apply_page_duplication`, `apply_authoring_action`, `undo/redo/revert_document_change`, `import_workspace_audio`, `import_workspace_image`, `adopt_recording`, `change_media_clip`, `apply_transcription_adoption`) checks the request before the author is asked: a stale source, a changed or missing file, a wrong SHA-256, an unknown or changed plan, a missing deletion confirmation, a history target that is no longer next or an uncommitted edit returns its error at once, without an approval request. Fix the request (read the current source, plan again) instead of asking the author to approve it. The write checks again after approval: if the document changed while the author was deciding, it returns 409 and writes nothing.
22
29
 
@@ -91,7 +91,7 @@ Cue content supplies stable targets and actions; `production.cueTimings` owns de
91
91
 
92
92
  Local audio `production.mediaClips` can reference an existing canonical audio asset in the same document. Set `sourceRange` in milliseconds, an attached stable step and offset, `volume` from 0 to 1, and optional `muted`; muting retains the volume. The inspected audio range must fit entirely inside that confirmed step. Adjust trimming, offset or the authored hold when it does not fit; the plan does not retime cues or cross steps automatically. These clips mix with cached speech in preview and video export, without generating or changing captions. Files must be non-hidden, regular local audio; symlinks, remote/shared paths and video are rejected. Use the source-bound `production-asset` reader to inspect a referenced AssetID and the plan diagnostics to confirm availability. Saving JSON does not confirm the actual audio range.
93
93
 
94
- To use original audio as narration, use Video’s **Original audio → Use as step voiceover**, or explicitly call the shared `adopt_recording` action for a saved source, stable step, audio asset and actual SHA-256; see `DocumentRecordingAdoption`. This sets `voiceSource.recording`, never a fabricated media clip. Each effective step plays its selected source range once; without a range it plays the whole file. In Video, **Narration range** edits the already adopted same-asset step with real in/out bounds. Restore full changes pending input and needs explicit Apply. Editing one step does not trim the asset or another step. Without an explicitly applied valid manual timing map, current Narration display text forms one whole-clip caption without word alignment; empty narration produces no caption. Trim keeps the whole authored script as an unaligned step caption and requires review; original ASR word times do not become trimmed alignment. Continuous cross-step recording, internal pauses, non-start cues and conflicting narration starts remain unsupported. Adoption preserves all narration and pronunciation, and does not start ASR, TTS or playback. The accepted version is prepared paused; late replies preserve newer input and microphone captures. Browser-controlled recording evidence does not verify a physical microphone, and MCP recording-client control uses the same mounted candidate through `editor_action`.
94
+ To use original audio as narration, use Video’s **Original audio → Use as step voiceover**, or explicitly call the shared `adopt_recording` action with `stepId` and `assetId`; the host pins the saved source and actual SHA-256 internally before approval; see `DocumentRecordingAdoption`. This sets `voiceSource.recording`, never a fabricated media clip. Each effective step plays its selected source range once; without a range it plays the whole file. In Video, **Narration range** edits the already adopted same-asset step with real in/out bounds. Restore full changes pending input and needs explicit Apply. Editing one step does not trim the asset or another step. Without an explicitly applied valid manual timing map, current Narration display text forms one whole-clip caption without word alignment; empty narration produces no caption. Trim keeps the whole authored script as an unaligned step caption and requires review; original ASR word times do not become trimmed alignment. Continuous cross-step recording, internal pauses, non-start cues and conflicting narration starts remain unsupported. Adoption preserves all narration and pronunciation, and does not start ASR, TTS or playback. The accepted version is prepared paused; late replies preserve newer input and microphone captures. Browser-controlled recording evidence does not verify a physical microphone, and MCP recording-client control uses the same mounted candidate through `editor_action`.
95
95
 
96
96
  In Video production, use **Audio clip → Import audio**, then select the asset and edit the paired in/out fields, step offset, volume and mute. Import only adds an asset; **Add to step** or **Apply** explicitly saves the clip. Invalid text remains editable. **Restore full** changes the pending range; removing a clip retains the asset. Pending input follows its document, stable step and clip; accepting a saved media change prepares that version and stays paused.
97
97