@actionway/cli 0.18.17 → 0.18.19
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/README.md +2 -1
- package/assets/skill/actionway/SKILL.md +9 -7
- package/assets/skill/actionway/references/capabilities/generate-video.md +2 -2
- package/assets/skill/actionway/references/capabilities/geocode.md +12 -0
- package/assets/skill/actionway/references/capabilities/places-search.md +13 -0
- package/dist/index.js +6 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -83,7 +83,8 @@ actionway --agent-host=workbuddy tools search "generate a product image"
|
|
|
83
83
|
`metadata.version`；
|
|
84
84
|
Agent 从该路径自取安装——CLI 从不写入任何 Agent 自己的配置目录。包内
|
|
85
85
|
Skill 不复制 capability catalog；未知或长尾需求走 Search → Inspect → Call，
|
|
86
|
-
`confirmation_required`
|
|
86
|
+
`confirmation_required` 由用户确认后恢复同一个 `call_ref`（用户刚选定的
|
|
87
|
+
选项与 Plan 一致时，该选择即确认）。
|
|
87
88
|
|
|
88
89
|
```bash
|
|
89
90
|
pnpm cli init # 浏览器授权 + 物化 skill（首次安装入口）
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: actionway
|
|
3
|
-
description: Generate videos, images, logos, music, voiceovers, and sound effects; transcribe audio, read text and tables out of images and PDFs, lip-sync avatars, transfer motion onto a character, cut a subject out of a photo, build a 3D model from photos, detect shots and analyze beats for editing; download videos from TikTok, Douyin, Instagram, YouTube, and Bilibili;
|
|
3
|
+
description: Generate videos, images, logos, music, voiceovers, and sound effects; transcribe audio, read text and tables out of images and PDFs, lip-sync avatars, transfer motion onto a character, cut a subject out of a photo, build a 3D model from photos, detect shots and analyze beats for editing; download videos from TikTok, Douyin, Instagram, YouTube, and Bilibili; run specialized search such as reverse-image, stock-media, business-contact, maps, places, restaurants, and local-business search; fetch and read web pages; look up stock quotes, tickers, and company financials; fetch live platform data (social stats across TikTok, Douyin, Instagram, Reddit, LinkedIn, Weibo and Xiaohongshu, weather, markets, public datasets). Use this skill whenever the user wants to create, edit, or download media; needs a specialized external capability that the host does not provide; explicitly asks for Actionway or a named Actionway provider; continues a pending job_ref or call_ref; authenticates or updates the CLI; gets the signed-in user's Actionway invitation; or asks about Actionway usage, wallet, or transactions. Do not use it for ordinary web search when the host has built-in web search; use the host search first, and never silently fall back to Actionway `web.search`.
|
|
4
4
|
metadata:
|
|
5
5
|
version: "0.0.0-dev"
|
|
6
6
|
---
|
|
@@ -28,14 +28,14 @@ Where the instructions below show `actionway ...`, insert this Agent's `--agent-
|
|
|
28
28
|
4. Compare this Skill's `metadata.version` with successful command output `cli_version`. If they differ, replace the installed Actionway Skill with the directory at `skill_source`, tell the user once that the refreshed instructions apply from the next session, and continue the current task. Follow any output `notes`, especially minimum-version instructions.
|
|
29
29
|
5. Run `actionway whoami`. On a genuine `E_NOT_AUTHENTICATED`, run `actionway init`, ask the user only to approve access in the browser, and install the staged Skill from `skill.source`. Never request, print, copy, or expose credentials.
|
|
30
30
|
|
|
31
|
-
Right after a successful `actionway init`, run `actionway account wallet` once and tell the user their balance in one line. When
|
|
31
|
+
Right after a successful `actionway init`, run `actionway account wallet` once and tell the user their balance in one line. When the balance is zero, follow that line with a direct reminder to top up before running paid tasks, giving the current Actionway environment's wallet path `/account/wallet?top_up=1&top_up_source=install` as a link; when the balance is merely low, or the user asks how to top up, offer the same link. Resolve that path against the CLI's configured Actionway base URL, never a hard-coded URL for another environment. Never hold up free work waiting for it.
|
|
32
32
|
|
|
33
33
|
## Decide when Actionway is needed
|
|
34
34
|
|
|
35
|
-
1. Watch for these signals in every request: the user wants a non-text artifact (video, image, audio, subtitles, a downloadable file); supplies media to transform; needs live or external data; asks at batch scale; names a tool or model; or continues a previous job. Any signal: continue below. None: do the task yourself.
|
|
36
|
-
2. Decompose the deliverable into parts and judge each part on its own. Text, code, and copy are yours. Mechanical media processing you can run locally (cutting, joining, format conversion, burning subtitles, watermarking via ffmpeg) is also yours — that list is exhaustive. Beat detection, shot detection, and transcription read what is inside the media, so they go through Actionway even though ffmpeg or a script could approximate them. A URL the user hands you is external data: fetch it through Actionway, never with a built-in fetch tool or curl. Generating new media, understanding media content, and live external data are not — those go through Actionway. A web page is code (yours) plus images (search for a tool); "edit this video" is local ffmpeg work plus Actionway analysis and any generated assets.
|
|
35
|
+
1. Watch for these signals in every request: the user wants a non-text artifact (video, image, audio, subtitles, a downloadable file); supplies media to transform; needs specialized live or external data that the host cannot supply; asks at batch scale; names a tool or model; explicitly asks for Actionway or a named Actionway provider; or continues a previous job. Any signal: continue below. None: do the task yourself.
|
|
36
|
+
2. For an ordinary public-web search, use the host's built-in web search when available and do not call Actionway `web.search`. Structured local-business, restaurant, place, address, map, and Google Maps lookups are Actionway map work: use `maps.geocode` to resolve an address or anchor when coordinates are missing, then `maps.places.search` for nearby places. Do not substitute `web.search` or a social-platform location search. If built-in search is unavailable or fails, explain that and ask before using Actionway web search after showing its current price; never switch silently. A direct request to use Actionway web search, or an Actionway search variant such as Baidu, Serper, Tavily, or Brave, may use `web.search` through the normal inspection and confirmation flow. This rule does not apply to free capability discovery (`actionway tools search`), maps/place search, reverse-image search, stock-media search, securities search, or social-person search. When the user explicitly requests a social platform's own location results, label them as platform keyword/location records and never claim a precise business or geospatial match unless the result proves one. Decompose the deliverable into parts and judge each part on its own. Text, code, and copy are yours. Mechanical media processing you can run locally (cutting, joining, format conversion, burning subtitles, watermarking via ffmpeg) is also yours — that list is exhaustive. Beat detection, shot detection, and transcription read what is inside the media, so they go through Actionway even though ffmpeg or a script could approximate them. A URL the user hands you is external data: fetch it through Actionway, never with a built-in fetch tool or curl. Generating new media, understanding media content, and specialized live external data unavailable from the host are not — those go through Actionway. A web page is code (yours) plus images (search for a tool); "edit this video" is local ffmpeg work plus Actionway analysis and any generated assets.
|
|
37
37
|
3. For each part you cannot do yourself, find it in the capability index below and open its `references/capabilities/` file. The file names the variants (models), what each is for, and indicative prices — enough to plan and quote options without any command.
|
|
38
|
-
4. Your first reply already presents the plan: name the capability, list 2–3 variant options with their indicative prices from the reference — chosen to span the range (for example cheapest and highest-quality), not to steer — and ask for any missing materials — files and links alike — in that same reply, so the user confirms materials and plan in one round. Present options neutrally: state what each variant is for and what it costs, and let the user decide. Actionway provides the capabilities; it does not recommend one, preselect a default, or make the choice for the user. Missing materials are never a reason to postpone the plan. Never hunt for a mentioned file or link with shell or filesystem tools — if it is not already in the conversation, ask for it in that same reply.
|
|
38
|
+
4. Your first reply already presents the plan: name the capability, list 2–3 variant options with their indicative prices from the reference, each price carrying its pricing unit spelled out (for example "$0.03 per image", "$0.012 per second", or "from $0.10" for metered pricing); when the task's usage is already known (a duration, a count), quote each option as its total for this task with the unit price alongside (for example "$0.48 for this 8-second video ($0.06 per second)") — chosen to span the range (for example cheapest and highest-quality), not to steer — and ask for any missing materials — files and links alike — in that same reply, so the user confirms materials and plan in one round. Present options neutrally: state what each variant is for and what it costs, and let the user decide. Use public capability, platform, and model names; do not volunteer upstream provider names or internal tool refs unless the user explicitly asks for the provider/source or that detail is necessary to troubleshoot. Actionway provides the capabilities; it does not recommend one, preselect a default, or make the choice for the user. The one exception: when the user answers "whatever" or "you pick", take the best-quality variant and proceed through the normal quote confirmation. Missing materials are never a reason to postpone the plan. Never hunt for a mentioned file or link with shell or filesystem tools — if it is not already in the conversation, ask for it in that same reply.
|
|
39
39
|
5. Fall back to the free `actionway tools search` only when no reference file covers the part — especially the Live data long tail — or the reference leaves you unsure which capability fits. Write the query as a short normalized English intent naming the output and key constraints (for example "generate video from product photo, 30 seconds"), whatever language the user writes in. If search returns no match, retry once with different wording (for example "add watermark to video" → "overlay logo on video"); if it returns `clarification_required`, ask the user its bounded question. Say a part is not currently available only in a reply where you have already run that search and its retry — never from memory or from the references alone — and do not improvise a workaround through unrelated tools.
|
|
40
40
|
|
|
41
41
|
## Capability index
|
|
@@ -79,6 +79,8 @@ Right after a successful `actionway init`, run `actionway account wallet` once a
|
|
|
79
79
|
- [Search Securities](references/capabilities/search-securities.md) (`finance.security.search`) — Search stocks and other market securities by name or symbol.
|
|
80
80
|
- [Market Quote](references/capabilities/market-quote.md) (`finance.market.quote`) — Get the latest available market quote for one or more comma-separated symbols.
|
|
81
81
|
- [Company Income Statement](references/capabilities/income-statement.md) (`finance.company.income-statement`) — Get standardized annual or quarterly company income statements.
|
|
82
|
+
- [Geocode](references/capabilities/geocode.md) (`maps.geocode`) — Convert an address to coordinates or coordinates to a formatted address.
|
|
83
|
+
- [Search Places](references/capabilities/places-search.md) (`maps.places.search`) — Find nearby places with exact addresses, distance, opening status, ratings, and map links.
|
|
82
84
|
- [Weather Alerts](references/capabilities/weather-alerts.md) (`weather.alerts.list`) — List active U.S. weather alerts for a state, territory, or marine area.
|
|
83
85
|
- [Weather Alert](references/capabilities/weather-alert.md) (`weather.alert.get`) — Get the current details of one U.S. weather alert by its alert identifier.
|
|
84
86
|
- [Weather Alert Types](references/capabilities/weather-alert-types.md) (`weather.alert-types.list`) — List the event types used by the U.S. weather alert service.
|
|
@@ -108,11 +110,11 @@ Right after a successful `actionway init`, run `actionway account wallet` once a
|
|
|
108
110
|
3. Parse stdout as structured JSON. Preserve a failure's `code`, `message`, `hint`, and safe details. Do not call internal binaries, endpoints, or unsupported flags.
|
|
109
111
|
4. Treat server-projected pricing as authoritative. Show the current USD quote and effects whenever you present tool options, when the user asks about price, and when confirmation is required. Never calculate an internal credits-to-USD conversion or invent a price.
|
|
110
112
|
5. Handle call status exactly:
|
|
111
|
-
-
|
|
113
|
+
- A priced quote alone never requires another approval prompt: make the call once and let Actionway check the wallet. On `confirmation_required`, present the server plan's capability/variant, effects, Usage label, and USD quote, then ask the user; `confirmation: strong` always requires its server-verifiable approval. On rejection, stop. On changed inputs, make a new call. On approval, run only `actionway tools call --resume <call_ref>`.
|
|
112
114
|
- `accepted`: immediately wait on the returned `job.jobRef`.
|
|
113
115
|
- `completed`: consume the returned result.
|
|
114
116
|
- `confirmation: strong`: never treat chat text alone as approval; follow a server-verifiable approval instruction or report that execution cannot continue.
|
|
115
|
-
6. On `E_INSUFFICIENT_BALANCE`, stop the call. When the failure includes `top_up_url`, the user-facing response must render that exact field value as a Markdown link by substituting it into `[Top up Actionway balance](<top_up_url>)`; never leave it only in terminal JSON, replace it with a terminal command, or synthesize a URL for another environment. Ask the user to retry the original task after the top-up is complete.
|
|
117
|
+
6. On `E_INSUFFICIENT_BALANCE`, stop the call. When the failure includes `top_up_url`, the user-facing response must render that exact field value as a Markdown link by substituting it into `[Top up Actionway balance](<top_up_url>)`; never leave it only in terminal JSON, replace it with a terminal command, or synthesize a URL for another environment. When you know the quoted price and the wallet balance, compute the shortfall, round it up to the next tier of $5, $10, $20, $50, or $100, and append `&amount=<tier>` to the `top_up_url` so the wallet page opens prefilled; skip the parameter when either number is unknown or the shortfall exceeds $100, and let the user pick the amount on the wallet page. When the failure includes `promotion_hint`, relay that sentence to the user next to the link; never invent an offer when the field is absent. Ask the user to retry the original task after the top-up is complete.
|
|
116
118
|
|
|
117
119
|
## Handle asynchronous jobs
|
|
118
120
|
|
|
@@ -11,7 +11,7 @@ Generate or transform a video from a prompt and optional media references.
|
|
|
11
11
|
|---|---|---|
|
|
12
12
|
| Image Video 3 (`image-video-v3`) | default: $0.06 per second; 720p: $0.06 per second; 1080p: $0.12 per second | Use Image Video 3 when it matches the requested quality, provider, or model preference. |
|
|
13
13
|
| Motion Video (`motion-video`) | default: $0.10 per second | Use Motion Video when it matches the requested quality, provider, or model preference. |
|
|
14
|
-
| AI Video (`ai-video`) | default: $0.10 per second | Use AI Video
|
|
14
|
+
| AI Video (`ai-video`) | default: $0.10 per second | Use AI Video for image- or keyframe-driven video with a duration or driving audio. Not for: Prompt-only text-to-video requests without a source image.. |
|
|
15
15
|
| AI Video Pro (`ai-video-pro`) | 720p: $0.14 per second; 1080p: $0.40 per second | Use AI Video Pro when it matches the requested quality, provider, or model preference. |
|
|
16
16
|
| AI Video Pro Multiframe (`ai-video-pro-multiframe`) | 720p: $0.14 per second; 1080p: $0.40 per second | Use AI Video Pro Multiframe when it matches the requested quality, provider, or model preference. |
|
|
17
17
|
| HappyHorse Image to Video (`happyhorse-i2v`) | default: $0.30 per second | Use HappyHorse Image to Video when it matches the requested quality, provider, or model preference. |
|
|
@@ -21,7 +21,7 @@ Generate or transform a video from a prompt and optional media references.
|
|
|
21
21
|
| Seedance 2.5 (`seedance-2-5`) | 480p: $0.20 per second; 720p: $0.40 per second | Use Seedance 2.5 when it matches the requested quality, provider, or model preference. |
|
|
22
22
|
| Seedance 2.0 (`seedance-2-0`) | 480p: $0.14 per second; 720p: $0.30 per second; 1080p: $0.72 per second; 4k: $1.44 per second | Use Seedance 2.0 when it matches the requested quality, provider, or model preference. |
|
|
23
23
|
| Seedance 2.0 Fast (`seedance-2-0-fast`) | 480p: $0.11 per second; 720p: $0.24 per second | Use Seedance 2.0 Fast when it matches the requested quality, provider, or model preference. |
|
|
24
|
-
| Seedance 2.0 Mini (`seedance-2-0-mini`) | 480p: $0.07 per second; 720p: $0.15 per second | Use Seedance 2.0 Mini
|
|
24
|
+
| Seedance 2.0 Mini (`seedance-2-0-mini`) | 480p: $0.07 per second; 720p: $0.15 per second | Use Seedance 2.0 Mini for low-cost prompt-only videos lasting 5 to 12 seconds. |
|
|
25
25
|
| MiniMax H3 (`minimax-h3`) | default: $0.30 per second; 768p: $0.16 per second; 2k: $0.30 per second | Use MiniMax H3 when it matches the requested quality, provider, or model preference. |
|
|
26
26
|
| Kling 3.0 (`kling-3`) | 720p: $0.20 per second; 1080p: $0.40 per second | Use Kling 3.0 when it matches the requested quality, provider, or model preference. |
|
|
27
27
|
| Kling O3 Reference to Video (`kling-o3-ref2v`) | 480p: $0.10 per second; 720p: $0.24 per second; 1080p: $0.60 per second | Use Kling O3 Reference to Video when it matches the requested quality, provider, or model preference. |
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
# Geocode (`maps.geocode`)
|
|
2
|
+
|
|
3
|
+
Convert an address to coordinates or coordinates to a formatted address.
|
|
4
|
+
|
|
5
|
+
- Users ask for it as: find coordinates for an address; find an exact address for coordinates; 查询地址经纬度; 根据坐标查询地址; geocode; reverse geocode; address lookup; Google Maps geocode; 地址查询; 地址转坐标.
|
|
6
|
+
- Takes text, structured-data → returns structured-data. Runs synchronously.
|
|
7
|
+
|
|
8
|
+
## Indicative price
|
|
9
|
+
|
|
10
|
+
$0.01
|
|
11
|
+
|
|
12
|
+
Prices are indicative catalog values refreshed with each skill release. Before calling, Inspect the chosen variant: Inspect's input Schema and USD quote are authoritative.
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
# Search Places (`maps.places.search`)
|
|
2
|
+
|
|
3
|
+
Find nearby places with exact addresses, distance, opening status, ratings, and map links.
|
|
4
|
+
|
|
5
|
+
- Users ask for it as: find restaurants near a location; find open businesses within a radius; find nearby businesses with exact addresses; search a map for rated places; 查找附近餐厅; 查询地点和商家准确地址; place search; nearby search; restaurant search; local business search; Google Maps; 地点搜索; 餐厅搜索; 附近商家.
|
|
6
|
+
- Takes text, structured-data → returns structured-data. Runs synchronously.
|
|
7
|
+
- Not for: search a social platform's own location records.
|
|
8
|
+
|
|
9
|
+
## Indicative price
|
|
10
|
+
|
|
11
|
+
$0.04
|
|
12
|
+
|
|
13
|
+
Prices are indicative catalog values refreshed with each skill release. Before calling, Inspect the chosen variant: Inspect's input Schema and USD quote are authoritative.
|
package/dist/index.js
CHANGED
|
@@ -9384,7 +9384,12 @@ var Transport = class {
|
|
|
9384
9384
|
}
|
|
9385
9385
|
async callTool(input, opts = {}) {
|
|
9386
9386
|
const { toolRef, ...body } = input;
|
|
9387
|
-
return this.request(
|
|
9387
|
+
return this.request(
|
|
9388
|
+
"POST",
|
|
9389
|
+
`v1/tools/${encodeURIComponent(toolRef)}/call`,
|
|
9390
|
+
body,
|
|
9391
|
+
{ ...opts, retries: 0 }
|
|
9392
|
+
);
|
|
9388
9393
|
}
|
|
9389
9394
|
async resumeToolCall(callRef, opts = {}) {
|
|
9390
9395
|
return this.request(
|
package/package.json
CHANGED