@sayknow-cli/coding-agent 0.7.15 → 0.7.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 +16 -0
- package/dist/types/defaults/skc-ui-skills.d.ts +1 -1
- package/dist/types/hooks/ui-skill-keywords.d.ts +10 -5
- package/dist/types/sdk/bus/telegram-daemon-contract.d.ts +8 -3
- package/dist/types/session/auto-resume.d.ts +5 -4
- package/package.json +7 -7
- package/src/defaults/skc/ui-skills/NOTICE.md +12 -8
- package/src/defaults/skc/ui-skills/emil-design-eng/SKILL.md +2 -70
- package/src/defaults/skc/ui-skills/stageshow/SKILL.md +1581 -0
- package/src/defaults/skc-ui-skills.ts +3 -0
- package/src/hooks/ui-skill-keywords.ts +51 -34
- package/src/internal-urls/docs-index.generated.ts +1 -1
- package/src/prompts/agents/executor.md +1 -1
- package/src/prompts/system/system-prompt.md +1 -1
- package/src/sdk/bus/telegram-daemon-contract.ts +8 -3
- package/src/session/agent-session.ts +14 -11
- package/src/session/auto-resume.ts +11 -9
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,22 @@
|
|
|
2
2
|
|
|
3
3
|
## [Unreleased]
|
|
4
4
|
|
|
5
|
+
## [0.7.17] - 2026-11-05
|
|
6
|
+
|
|
7
|
+
### Added
|
|
8
|
+
|
|
9
|
+
- Benji Taylor's [Stageshow](https://benji.org/stageshow) skill (MIT, 1.1.1) is now bundled as `stageshow` and is the design center for all frontend work: every frontend prompt routes to `stageshow` first, then the matching specialized skill, then `emil-design-eng`, and the system and executor prompts require it for real product UI as well as faux UI. Its `SKILL.md` ships with every `references/*.md` file inlined; the React kit, gold examples and filming scripts are not bundled, so for faux UI builds the agent installs the full skill into the project itself. The earlier adapted Stageshow section in `emil-design-eng` is replaced by a pointer to `stageshow`. The routing directive now quotes the prompt text that matched instead of the skill name.
|
|
10
|
+
|
|
11
|
+
### Fixed
|
|
12
|
+
|
|
13
|
+
- A turn that streamed only blank text before failing is now dropped and retried on the same model instead of stopping the session. Long Grok sessions hit this when grok-4.7 degenerated into a few thousand whitespace tokens and xAI aborted the stream with "Internal error during token generation"; the whitespace counted as visible output, so neither retry nor auto-resume ran. A code-less "internal error" also now counts as a server failure for the default retry policy.
|
|
14
|
+
|
|
15
|
+
## [0.7.16] - 2026-11-03
|
|
16
|
+
|
|
17
|
+
### Fixed
|
|
18
|
+
|
|
19
|
+
- Upgrading now replaces a Telegram daemon that is already running from an older release, so the rejected-token poll pause from 0.7.15 takes effect without a manual daemon restart. The daemon serving epoch moves to 4 and the generation to 32; the next session start reloads an epoch-3 daemon.
|
|
20
|
+
|
|
5
21
|
## [0.7.15] - 2026-11-03
|
|
6
22
|
|
|
7
23
|
### Added
|
|
@@ -6,7 +6,7 @@ import type { Skill } from "../extensibility/skills";
|
|
|
6
6
|
* Sources and deliberate exclusions are documented in
|
|
7
7
|
* `skc/ui-skills/NOTICE.md`; regenerate with `scripts/build-ui-skill-bundle.ts`.
|
|
8
8
|
*/
|
|
9
|
-
export declare const BUNDLED_SKC_UI_SKILL_NAMES: readonly ["emil-design-eng", "animate", "review-animations", "improve-animations", "find-animation-opportunities", "pick-ui-library", "prototype", "mobile-native", "animation-vocabulary", "apple-design", "ask-sonner", "appllama-app-design-skill", "react-bits"];
|
|
9
|
+
export declare const BUNDLED_SKC_UI_SKILL_NAMES: readonly ["stageshow", "emil-design-eng", "animate", "review-animations", "improve-animations", "find-animation-opportunities", "pick-ui-library", "prototype", "mobile-native", "animation-vocabulary", "apple-design", "ask-sonner", "appllama-app-design-skill", "react-bits"];
|
|
10
10
|
export type BundledSkcUiSkillName = (typeof BUNDLED_SKC_UI_SKILL_NAMES)[number];
|
|
11
11
|
export declare function getEmbeddedSkcUiSkills(): Skill[];
|
|
12
12
|
export declare function withEmbeddedSkcUiSkills(skills: Skill[]): Skill[];
|
|
@@ -19,12 +19,17 @@ export interface UiSkillKeywordDefinition {
|
|
|
19
19
|
priority: number;
|
|
20
20
|
pattern: RegExp;
|
|
21
21
|
}
|
|
22
|
+
/**
|
|
23
|
+
* SKC's design center. Every frontend match loads it first, ahead of the
|
|
24
|
+
* specialized lead and the craft baseline, whatever the surface.
|
|
25
|
+
*/
|
|
26
|
+
export declare const UI_SKILL_CORE: BundledSkcUiSkillName;
|
|
22
27
|
/** Base craft skill paired with any specialized web frontend match. */
|
|
23
28
|
export declare const UI_SKILL_BASE: BundledSkcUiSkillName;
|
|
24
29
|
/**
|
|
25
30
|
* Ordered specialized detectors. The first (highest priority) match selects the
|
|
26
|
-
* lead skill; `
|
|
27
|
-
* review work.
|
|
31
|
+
* lead skill; `stageshow` is loaded ahead of it and `emil-design-eng` after it
|
|
32
|
+
* as the craft baseline for build and review work.
|
|
28
33
|
*/
|
|
29
34
|
export declare const UI_SKILL_KEYWORD_DEFINITIONS: readonly UiSkillKeywordDefinition[];
|
|
30
35
|
export interface UiSkillKeywordMatch {
|
|
@@ -33,13 +38,13 @@ export interface UiSkillKeywordMatch {
|
|
|
33
38
|
priority: number;
|
|
34
39
|
}
|
|
35
40
|
/**
|
|
36
|
-
* Detect frontend UI/UX intent. Returns
|
|
37
|
-
* specific
|
|
41
|
+
* Detect frontend UI/UX intent. Returns `stageshow` first, then the most
|
|
42
|
+
* specific match, then `emil-design-eng` as the craft baseline.
|
|
38
43
|
*/
|
|
39
44
|
export declare function detectUiSkillKeywords(text: string): UiSkillKeywordMatch[];
|
|
40
45
|
/**
|
|
41
46
|
* Build the `UserPromptSubmit` directive that makes the agent load the matching
|
|
42
|
-
* bundled UI
|
|
47
|
+
* bundled UI skills for this turn. Returns null when the prompt is not frontend
|
|
43
48
|
* UI/UX work.
|
|
44
49
|
*/
|
|
45
50
|
export declare function buildUiSkillActivationContext(text: string): string | null;
|
|
@@ -41,11 +41,16 @@ export declare const NOTIFICATION_PROTOCOL_VERSION = 3;
|
|
|
41
41
|
* and capability-versioned mixed-host compatibility.
|
|
42
42
|
* Generation 31 lets a Windows controller wait for a cooperative stop and has
|
|
43
43
|
* the owner watch its control request during a long poll (upstream #6174).
|
|
44
|
+
* Generation 32 pauses getUpdates with backoff while Telegram rejects the bot
|
|
45
|
+
* token and records the rejection for `skc notify health`, so an upgraded host
|
|
46
|
+
* reloads a predecessor that would otherwise poll a revoked token every second.
|
|
44
47
|
*/
|
|
45
|
-
export declare const DAEMON_GENERATION =
|
|
48
|
+
export declare const DAEMON_GENERATION = 32;
|
|
46
49
|
/**
|
|
47
50
|
* Serving-compatibility boundary for daemon lifecycle requests. Epoch 1 covers
|
|
48
51
|
* all builds published before this field existed; epoch 2 covered generation 29;
|
|
49
|
-
*
|
|
52
|
+
* epoch 3 covered generations 30-31; epoch 4 reloads those predecessors into
|
|
53
|
+
* generation 32 so a revoked bot token stops being polled every second.
|
|
54
|
+
* Bump this to force serving convergence and reload of compatible live predecessors.
|
|
50
55
|
*/
|
|
51
|
-
export declare const SERVING_EPOCH =
|
|
56
|
+
export declare const SERVING_EPOCH = 4;
|
|
@@ -35,11 +35,12 @@ export interface AutoResumeMarker {
|
|
|
35
35
|
interruptedCallIds: string[];
|
|
36
36
|
}
|
|
37
37
|
/**
|
|
38
|
-
* A failed attempt that streamed only private reasoning
|
|
39
|
-
*
|
|
40
|
-
*
|
|
38
|
+
* A failed attempt that streamed no answer: only private reasoning and/or blank text
|
|
39
|
+
* (e.g. a whitespace decode loop the provider then aborted), no tool call. Nothing in
|
|
40
|
+
* it is part of the answer and its signed blocks can never be replayed, so recovery
|
|
41
|
+
* drops it and asks the same model again instead of stopping.
|
|
41
42
|
*/
|
|
42
|
-
export declare function
|
|
43
|
+
export declare function isAnswerlessFailure(message: AgentMessage | undefined): boolean;
|
|
43
44
|
/**
|
|
44
45
|
* The transcript before its trailing unexecuted tool-call failure, without the error
|
|
45
46
|
* placeholder results paired with its calls; undefined when the tail is anything else.
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"type": "module",
|
|
3
3
|
"name": "@sayknow-cli/coding-agent",
|
|
4
|
-
"version": "0.7.
|
|
4
|
+
"version": "0.7.17",
|
|
5
5
|
"description": "Sayknow-CLI CLI with read, bash, edit, write tools and session management",
|
|
6
6
|
"homepage": "https://sayknow-cli.com",
|
|
7
7
|
"author": "jaybeyond",
|
|
@@ -54,12 +54,12 @@
|
|
|
54
54
|
"@agentclientprotocol/sdk": "1.3.0",
|
|
55
55
|
"@babel/parser": "^7.29.3",
|
|
56
56
|
"@mozilla/readability": "^0.6.0",
|
|
57
|
-
"@sayknow-cli/stats": "0.7.
|
|
58
|
-
"@sayknow-cli/agent-core": "0.7.
|
|
59
|
-
"@sayknow-cli/ai": "0.7.
|
|
60
|
-
"@sayknow-cli/natives": "0.7.
|
|
61
|
-
"@sayknow-cli/tui": "0.7.
|
|
62
|
-
"@sayknow-cli/utils": "0.7.
|
|
57
|
+
"@sayknow-cli/stats": "0.7.17",
|
|
58
|
+
"@sayknow-cli/agent-core": "0.7.17",
|
|
59
|
+
"@sayknow-cli/ai": "0.7.17",
|
|
60
|
+
"@sayknow-cli/natives": "0.7.17",
|
|
61
|
+
"@sayknow-cli/tui": "0.7.17",
|
|
62
|
+
"@sayknow-cli/utils": "0.7.17",
|
|
63
63
|
"@puppeteer/browsers": "^2.13.0",
|
|
64
64
|
"@types/turndown": "5.0.6",
|
|
65
65
|
"@xterm/headless": "^6.0.0",
|
|
@@ -10,7 +10,8 @@ Regenerate with:
|
|
|
10
10
|
```bash
|
|
11
11
|
bun scripts/build-ui-skill-bundle.ts \
|
|
12
12
|
--source emilkowalski=<checkout> \
|
|
13
|
-
--source appllama=<checkout>
|
|
13
|
+
--source appllama=<checkout> \
|
|
14
|
+
--source benjitaylor=<checkout>
|
|
14
15
|
```
|
|
15
16
|
|
|
16
17
|
Only `SKILL.md` is compiled into the binary, and a bundled skill's `baseDir`
|
|
@@ -24,6 +25,7 @@ loose companion files here expecting them to be readable at runtime.
|
|
|
24
25
|
| --- | --- | --- |
|
|
25
26
|
| [emilkowalski/skills](https://github.com/emilkowalski/skills) | MIT (`LICENSE.emilkowalski`), Copyright (c) 2026 Emil Kowalski | `emil-design-eng`, `animate`, `review-animations`, `improve-animations`, `find-animation-opportunities`, `pick-ui-library`, `prototype`, `mobile-native`, `animation-vocabulary`, `apple-design`, `ask-sonner` |
|
|
26
27
|
| [Appllama/appllama-skills](https://github.com/Appllama/appllama-skills) | MIT (`LICENSE.appllama`) | `appllama-app-design-skill` |
|
|
28
|
+
| [benjitaylor/skills](https://github.com/benjitaylor/skills) at `299140f` (Stageshow 1.1.1, [write-up](https://benji.org/stageshow)) | MIT (`LICENSE.benjitaylor`, from `stageshow/LICENSE`), Copyright (c) 2026 Benji Taylor | `stageshow` (`SKILL.md`, `references/*.md` and `NOTICE.md` inlined) |
|
|
27
29
|
|
|
28
30
|
## SKC overlays
|
|
29
31
|
|
|
@@ -31,14 +33,16 @@ loose companion files here expecting them to be readable at runtime.
|
|
|
31
33
|
generator splices into a vendored skill right after its `## SKC invocation`
|
|
32
34
|
block, so a regeneration keeps them.
|
|
33
35
|
|
|
34
|
-
| Overlay |
|
|
35
|
-
| --- | --- |
|
|
36
|
-
| `
|
|
36
|
+
| Overlay | Purpose |
|
|
37
|
+
| --- | --- |
|
|
38
|
+
| `stageshow`: "SKC: the design center — mandatory for all frontend work" | Makes Stageshow the bar for every frontend surface, says which rules apply to real UI versus faux UI, and how it fits with the other bundled skills |
|
|
39
|
+
| `emil-design-eng`: "Stageshow is the design center — mandatory" | Points the craft baseline at `stageshow` and defers conflicts to it |
|
|
37
40
|
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
41
|
+
The Stageshow kit, examples, `teaching/`, filming scripts and playground are not
|
|
42
|
+
vendored: they are React/TS sources (unreadable from an embedded skill) and
|
|
43
|
+
include app-icon artwork the Stageshow MIT license does not cover. The overlay
|
|
44
|
+
tells the agent to install the full skill into the user's project for faux UI
|
|
45
|
+
builds with `npx -y skills@latest add benjitaylor/skills --skill stageshow -a universal -y`.
|
|
42
46
|
|
|
43
47
|
## Deliberate exclusions
|
|
44
48
|
|
|
@@ -11,77 +11,9 @@ SKC loads this skill automatically for matching frontend UI/UX work.
|
|
|
11
11
|
Do not wait for a follow-up question. Apply the craft rules immediately
|
|
12
12
|
and keep going on the user's actual task.
|
|
13
13
|
|
|
14
|
-
##
|
|
14
|
+
## Stageshow is the design center — mandatory
|
|
15
15
|
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
Adapted from [Stageshow](https://benji.org/stageshow) by Benji Taylor (MIT).
|
|
19
|
-
|
|
20
|
-
### Use the Stageshow kit
|
|
21
|
-
|
|
22
|
-
The full Stageshow skill ships a React kit (stage, windows, phones, cursor, motion parts), gold examples and filming scripts that cannot be embedded here. For any faux UI build, install it into the user's project yourself with `npx -y skills@latest add benjitaylor/skills --skill stageshow -a universal -y`, load `stageshow` with the `skill` tool, and start from its closest gold example. Do not ask the user to run the install. If it fails (offline, blocked registry), say so once and apply the rules below by hand.
|
|
23
|
-
|
|
24
|
-
### How this fits with the rest of this skill
|
|
25
|
-
|
|
26
|
-
- **Depicted UI feedback stays real.** A press, menu, tooltip or toggle inside the demo follows this skill: under 300ms, ease-out custom curves, `scale(0.97)` on press, never from `scale(0)`. Only storytelling motion (travel, arrivals, camera, holds) runs slower; that is the "Marketing/explanatory" row of the duration table.
|
|
27
|
-
- **Stagger** stays 40-80ms between items in a scene, inside this skill's 30-80ms band. Tiles of a grid are the one exception: 80-120ms apart.
|
|
28
|
-
- **Reduced motion** shows the demo's poster frame: a complete still that tells the story with the result on screen. Movement is dropped, not the payoff.
|
|
29
|
-
- **Frequency rule.** A demo loop is decorative and rarely seen; it never blocks interaction and never reacts to the page's keyboard input.
|
|
30
|
-
- **Review output** still uses the Before/After/Why table from Review Format.
|
|
31
|
-
|
|
32
|
-
### The one idea
|
|
33
|
-
|
|
34
|
-
**It reads as a real product, simplified to what the viewer needs, framed with intent, and every motion has a cause.**
|
|
35
|
-
|
|
36
|
-
Five ways it fails:
|
|
37
|
-
|
|
38
|
-
- **Too much.** Real text in every row, numbers everywhere, everything packed. The more detail, the more it looks generated.
|
|
39
|
-
- **Wireframe.** Two gray blobs and a button: built too small, or stripped of what made it recognizable.
|
|
40
|
-
- **Boxed.** A whole window shrunk into a card with even margins, like a pasted screenshot.
|
|
41
|
-
- **Flat.** Every object the same weight in the same bordered card; the eye has nowhere to land.
|
|
42
|
-
- **Bland.** A gray window with a cursor whatever the brief said. The brief's look and energy are the point.
|
|
43
|
-
|
|
44
|
-
The fix: a full, structured screen in quiet grays, real words only where the story is (usually 3 to 7 strings), placeholder lines for the rest, room to breathe, and a crop that puts the eye on the story. Simplify the words, not the context.
|
|
45
|
-
|
|
46
|
-
### Workflow (decide before writing code)
|
|
47
|
-
|
|
48
|
-
1. **Medium and place.** Still or animation (loop, once in view, hover); where it sits and at what size. Design at the shown size (about 720 × 340 beside copy, 900-1100 wide full-width, 400 × 300 for a card) and ship a redesigned compact version for a 358px phone column.
|
|
49
|
-
2. **Look.** Map the product's real tokens, icons and chrome. Otherwise pick a theme (light, dark, blueprint, glass), a palette (accent or mono) and a fidelity (minimal, standard, realistic). A brief with a style gets that style in full.
|
|
50
|
-
3. **Story.** Three to five beats and a payoff, 10 to 16 seconds. No cursor move you cannot explain. Data never rewinds in view without a cause. Between a richer story and a calmer frame, choose the frame.
|
|
51
|
-
4. **Start from the closest example** and decide the crop before building, so nothing past the crop gets built.
|
|
52
|
-
5. **Screen.** Spend the word budget on the story; mark what the cursor touches and measure positions, never hard-code them.
|
|
53
|
-
6. **Choreograph.** Keep elements mounted so exits animate. Animate the relationship, not just the object: a new row carries the rows below it. Beats overlap, groups stagger, the payoff holds, and the loop ends where it began or resets with a visible cause.
|
|
54
|
-
7. **Rehearse.** Set the poster frame first. Film the whole loop at the shown width and at 390, step through every press, menu, morph and the loop seam, fix the largest fault first (framing, then hierarchy, then motion, then polish), and compare against the closest gold example.
|
|
55
|
-
|
|
56
|
-
### Framing
|
|
57
|
-
|
|
58
|
-
- One hero object, at most one or two satellites of different kinds. A satellite straddles the hero's edge about half outside and covers chrome, not content.
|
|
59
|
-
- Crop only filler. The payoff, the action, cursor targets and every real word stay whole. Crop 10-40% of the hero off stage; it fills at least two thirds of the stage width and runs off an edge.
|
|
60
|
-
- The stage masks everything. One gutter, measured in the final crop, on every edge: a full gutter or well past it, never just short.
|
|
61
|
-
- No plate behind a hero on a white or dark page, no window floating with air on four sides, no dead corners at any point in the loop.
|
|
62
|
-
- Real chrome only: no address bar on a native Mac app, no hand-drawn status bar or home indicator. Windows keep their device's shape.
|
|
63
|
-
- Start flat and frontal. Depth comes from shadow, z-order and scale; a tilt must be earned against the straight version.
|
|
64
|
-
|
|
65
|
-
### Motion and the cursor
|
|
66
|
-
|
|
67
|
-
- Story motion uses two curves: travel `cubic-bezier(0.45, 0, 0.1, 1)`, arrival from nowhere `cubic-bezier(0.25, 0.8, 0.25, 1)` over 0.8-1s. Travel has a departure, clear travel and a soft arrival.
|
|
68
|
-
- Content moves instead of swapping; numbers roll only the digits that changed. Holding a result means stopping, with no new pulse.
|
|
69
|
-
- The cursor moves like a hand: shallow arcs timed by distance, presses you can see. It never covers the words it clicks, changes kind (I-beam, hand) by morphing as it crosses into an element, and every move travels to the next action. Use one cursor style per site; with no cursor, never walk a focus ring as a stand-in.
|
|
70
|
-
- On phones, use touch, not the macOS arrow, and act where people do: tap the notification, then act in the app.
|
|
71
|
-
- The camera needs a reason: push in only when the payoff is too small to read, once per story, in and back out.
|
|
72
|
-
|
|
73
|
-
### Check before handing over
|
|
74
|
-
|
|
75
|
-
- Content that swaps instead of moving.
|
|
76
|
-
- Gray placeholder bars where the eye lands; filler belongs at the edges.
|
|
77
|
-
- A plate behind the window, or a window floating with air on four sides.
|
|
78
|
-
- Empty bands, cut controls or cut shadows.
|
|
79
|
-
- Stock AI marks and made-up logos: sparkles, purple, a letter in a colored square.
|
|
80
|
-
- Busy rows and uneven insets.
|
|
81
|
-
- Long holds, or a reset with no cause.
|
|
82
|
-
- A text selection that is not under the I-beam.
|
|
83
|
-
- A hand-drawn status bar or home indicator.
|
|
84
|
-
- A centered amount centered together with its sign.
|
|
16
|
+
SKC loads `stageshow` before this skill for every frontend task. Its one idea (a real product, simplified to what the viewer needs, framed with intent, every motion with a cause), its five failures (too much, wireframe, boxed, flat, bland) and its craft, framing, motion and verify references are the bar for every surface; this skill adds component and interaction craft on top. Faux product UI (hero or feature-card demos, bento tiles, cursor walkthroughs, product shots, mocked app screens) is built by `stageshow` in full. Where the two disagree, `stageshow`'s "How Stageshow fits with the other bundled UI skills" section decides. If `stageshow` is not loaded in this turn yet, load it with the `skill` tool now.
|
|
85
17
|
|
|
86
18
|
|
|
87
19
|
## Core Philosophy
|