image-skill 0.1.55 → 0.1.57

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
@@ -4,6 +4,26 @@ This changelog tracks the public `image-skill` CLI package and public skill
4
4
  mirror. The npm package metadata remains the authority for tarball integrity and
5
5
  provenance; this file is the human- and agent-readable release map.
6
6
 
7
+ ## 0.1.57 - 2026-06-16
8
+
9
+ - Release (activation/self-fund): mirror top-up urgency and the no-spend
10
+ payment rail inspection command into hosted `activity list/show`
11
+ `data.next_actions.self_fund`, so agents inspecting their ledger after
12
+ generated work can discover the safe first self-fund step before hitting the
13
+ quota wall. No payment caps, auth semantics, provider routing, wallet action,
14
+ provider spend, media spend, hosted deploy, or production write changed in
15
+ this release bump.
16
+
17
+ ## 0.1.56 - 2026-06-16
18
+
19
+ - Release (activation/self-fund): mirror top-up urgency and the no-spend
20
+ payment rail inspection command into successful hosted create/edit and
21
+ `jobs show` `data.next_actions.self_fund`, so agents with free allowance can
22
+ discover the safe first self-fund step before hitting the quota wall. No
23
+ payment caps, auth semantics, provider routing, wallet action, provider
24
+ spend, media spend, hosted deploy, or production write changed in this
25
+ release bump.
26
+
7
27
  ## 0.1.55 - 2026-06-16
8
28
 
9
29
  - Release (activation/self-fund): mirror top-up urgency and the first no-spend
package/SKILL.md CHANGED
@@ -271,12 +271,18 @@ image-skill activity show EVENT_OR_JOB_OR_ASSET_OR_FEEDBACK
271
271
  After a successful hosted create/edit, prefer `data.next_actions` when present:
272
272
  `inspect_job` and `inspect_asset` are no-spend recovery commands,
273
273
  `iterate_edit` reuses the asset, and `self_fund` promotes a copy-runnable
274
- top-up quote command when `quota.top_up.recommended` is true. That
275
- `quote_command` omits `--idempotency-key`; the public CLI generates and returns
276
- one for retry safety. Use `jobs show` or `jobs wait` for
274
+ top-up quote command when `quota.top_up.recommended` is true. That handoff
275
+ mirrors top-up `urgency`, `urgency_score`, and `urgency_reasons`, and exposes
276
+ `first_safe_command` plus `first_safe_command_effect` for no-spend rail
277
+ inspection before quote/buy. Its `quote_command` omits `--idempotency-key`; the
278
+ public CLI generates and returns one for retry safety. Use `jobs show` or
279
+ `jobs wait` for
277
280
  operational job state, final assets, and retry judgment. Use `activity` for
278
281
  audit trail context (recent jobs, assets, usage events, feedback acceptance,
279
- trace IDs, status changes) you can cite in feedback.
282
+ trace IDs, status changes) you can cite in feedback. `activity list/show` may
283
+ also return `data.next_actions.self_fund` with the same urgency and no-spend
284
+ inspection handoff when the ledger proves generated work and quota says top-up
285
+ setup is recommended.
280
286
  **Do not use `activity` as a wait or recovery command.** Activity is the ledger,
281
287
  not the work queue.
282
288
 
@@ -15,7 +15,7 @@ import { Readable } from "node:stream";
15
15
  import { pipeline } from "node:stream/promises";
16
16
  import os from "node:os";
17
17
 
18
- const VERSION = "0.1.55";
18
+ const VERSION = "0.1.57";
19
19
  const PACKAGE_NAME = "image-skill";
20
20
  const DEFAULT_API_BASE_URL = "https://api.image-skill.com";
21
21
  const DEFAULT_DOCS_BASE_URL = "https://image-skill.com";
package/cli.md CHANGED
@@ -1517,9 +1517,13 @@ input asset metadata where
1517
1517
  applicable. Responses do not include raw prompts, source bytes, base64
1518
1518
  payloads, local paths, full external URLs, bucket names, or object keys.
1519
1519
  When `quota.top_up.recommended` is true, `next_actions.self_fund.quote_command`
1520
- is a copy-runnable top-up quote command; it omits `--idempotency-key` so the
1521
- public CLI generates and returns one for retry safety before the agent follows
1522
- the quote response into `credits buy` and `credits status`.
1520
+ is a copy-runnable top-up quote command. `next_actions.self_fund` also mirrors
1521
+ top-up `urgency`, `urgency_score`, and `urgency_reasons`, and exposes
1522
+ `first_safe_command`, `first_safe_command_effect`, `inspect_methods_command`,
1523
+ and `inspect_packs_command` for no-spend payment rail inspection before
1524
+ quote/buy. The quote command omits `--idempotency-key` so the public CLI
1525
+ generates and returns one for retry safety before the agent follows the quote
1526
+ response into `credits buy` and `credits status`.
1523
1527
 
1524
1528
  Provider/model names in this paragraph are preview provenance, not the primary
1525
1529
  public UX. The public selection surface should be Image Skill capabilities and
@@ -1658,6 +1662,11 @@ related job IDs, asset IDs, usage IDs, feedback IDs, trace IDs, status changes,
1658
1662
  and product-memory writes. Use `jobs show` or `jobs wait` when you need
1659
1663
  operational recovery, polling, retry judgment, or final job assets.
1660
1664
 
1665
+ When the ledger proves generated work and current quota says top-up setup is
1666
+ recommended, `data.next_actions.self_fund` mirrors the same urgency and
1667
+ no-spend payment-method inspection handoff returned by successful create/edit
1668
+ and `jobs show`.
1669
+
1661
1670
  Minimum success data:
1662
1671
 
1663
1672
  ```json
@@ -1714,7 +1723,9 @@ image-skill activity show sig_... --json
1714
1723
  `activity show` accepts activity event IDs plus job, asset, usage, feedback, and
1715
1724
  trace references. When the reference is a subject rather than one exact event,
1716
1725
  the response includes matching ledger events so an agent can cite the right
1717
- event without reading telemetry logs.
1726
+ event without reading telemetry logs. When current quota recommends top-up
1727
+ setup after generated work, `data.next_actions.self_fund.first_safe_command`
1728
+ is the no-spend rail inspection command to run before any quote/buy step.
1718
1729
 
1719
1730
  Hosted API equivalent:
1720
1731
 
package/llms.txt CHANGED
@@ -65,7 +65,7 @@ First-run guide loop:
65
65
  5. At any guide stage, read data.checks.quota.top_up. When recommended is true, it includes recommendation_reason, preferred_payment_method, quote_command, quote_command_copy_runnable, quote_command_effect, and quote/buy/status command templates for the browserless x402 top-up path. On quota/payment recovery errors, read error.recovery.top_up: when delegated live-money quoting is allowed, prefer error.recovery.top_up.quote_command to open the top-up path, and use error.recovery.suggested_command for no-spend payment-method inspection. If data.stage is quota_required, data.guide_warning.next_command_safety is live_money_payment_action and data.guide_warning.payment_top_up_path summarizes the live-money path. Run data.self_fund_next_command to start the top-up. It aliases data.next_command and is the first payment command, usually an x402 or Stripe quote. First read data.checks.payments.preferred_method_summary.top_up_path: browserless_agent_self_fund means a wallet-equipped agent can complete the preferred live-money rail without a browser; human_payment_handoff means the agent can create the payment attempt but a human/browser step must complete before credits are granted. If the guide authenticated from env or stdin, prefer data.self_fund_handoff.auth.next_command.with_env or data.self_fund_handoff.auth.next_command.with_stdin so auth follows the payment command. Then follow data.self_fund_handoff.payment_commands.buy and status, and rerun data.self_fund_handoff.after_next once credits are granted. If data.stage is ready_to_create, inspect data.self_fund_preparation before consuming the remaining free allowance. When available and recommended are true, data.self_fund_preparation.quote_command is the pre-wall browserless x402 quote: it creates an authenticated live-money quote/payment object, but data.self_fund_preparation.quote_command_effect must show no provider call, no hosted create, no credit debit, no media write, and no wallet settlement until a later buy/payment step. One Image Skill credit is $0.01. Credit quotes grant prepaid value units; create/edit operations debit model-priced credits reported as cost.credit_pricing. Starter preview currently gives bounded free-preview credits plus a four-job daily cap.
66
66
  5a. When data.stage is quota_required, data.self_fund_handoff mirrors top-up urgency, urgency_score, and urgency_reasons, and exposes first_safe_command plus first_safe_command_effect. Run first_safe_command, usually image-skill credits methods --json, for no-spend rail inspection before quote/buy when delegated spend authority is absent or unclear.
67
67
  6. If data.stage is ready_to_create, data.next_command is the first bounded live create. data.guide_warning.next_command_safety must be live_media_create_credit_debit, data.guide_warning.no_spend_safe must be false, data.guide_warning.spend_required must be true, and data.guide_warning.recommended_command_field must be recommended_no_spend_command. data.auth_ready.ready and data.auth_ready.next_command_auth_ready must be true; data.auth_ready.next_command_requires_auth must be true, and the command can reuse saved config, IMAGE_SKILL_TOKEN, or --token-stdin context without exposing a raw token. data.next_command_effect.label must be live_media_create_credit_debit and its provider_call, hosted_create, credit_debit, and media_write flags are true. data.no_spend_evaluation.stop_here must be true, data.no_spend_evaluation.next_command_is_live_create must be true, and data.no_spend_evaluation.recommended_command_field must be recommended_no_spend_command. Run data.next_command only when media spend is allowed. In no-spend evaluations, or when you only need to prove readiness without media/provider work, stop before data.next_command and run data.recommended_no_spend_command instead. data.recommended_no_spend_command must equal data.no_spend_next_command. data.no_spend_next_command_effect.label must be dry_run_planned_job_no_provider_call_no_credit_debit_no_media_write: no_spend, hosted_create_dry_run, planned_job, and plan_receipt are true; activity_event is job.planned; provider_call, credit_debit, and media_write are false. This dry-run may create a recoverable planned job/activity receipt but no provider execution, debit, downloadable asset, or media write. If the guide authenticated from env or stdin, prefer data.auth_handoff.next_command.with_env or data.auth_handoff.next_command.with_stdin so auth follows the live create. In guide cost output, cost.estimated_usd_per_image and cost.estimated_debit_usd_per_image are the Image Skill debit dollars for one output; cost.estimated_provider_usd_per_image is only the upstream provider estimate. Use the guide's returned max_estimated_usd_per_image because it is sized to the credit debit the agent funds. Add --output-count N only after models show confirms the selected create model supports more than one output; credit_pricing.credits_required is the total debit across outputs, while max_estimated_usd_per_image remains a per-image Image Skill debit guard.
68
- 7. After create, prefer data.next_actions when present: inspect_job and inspect_asset are copy-runnable no-spend recovery commands, iterate_edit is the reusable-asset edit template, and self_fund is the promoted top-up quote handoff when quota.top_up.recommended is true. self_fund.quote_command is copy-runnable and omits --idempotency-key so the public CLI generates and returns one for retry safety; follow the quote response into buy/status. Otherwise use image-skill jobs show JOB_ID to recover status, cost, safety, timestamps, and final assets; image-skill assets get ASSET_URL_OR_ID --output ./result.png to fetch the generated asset without repeating provider work; and image-skill activity list --subject JOB_ID to find ledger events, trace, usage, and asset links to cite.
68
+ 7. After create, prefer data.next_actions when present: inspect_job and inspect_asset are copy-runnable no-spend recovery commands, iterate_edit is the reusable-asset edit template, and self_fund is the promoted top-up quote handoff when quota.top_up.recommended is true. self_fund mirrors urgency, urgency_score, and urgency_reasons, and exposes first_safe_command plus first_safe_command_effect for no-spend rail inspection before quote/buy. self_fund.quote_command is copy-runnable and omits --idempotency-key so the public CLI generates and returns one for retry safety; follow the quote response into buy/status. Otherwise use image-skill jobs show JOB_ID to recover status, cost, safety, timestamps, and final assets; image-skill assets get ASSET_URL_OR_ID --output ./result.png to fetch the generated asset without repeating provider work; and image-skill activity list --subject JOB_ID to find ledger events, trace, usage, asset links, and any data.next_actions.self_fund handoff to cite or follow.
69
69
  8. Leave image-skill feedback create if the first-run flow is confusing, blocked, missing an affordance, or easier through a direct provider than through Image Skill. Feedback auth uses saved config from default signup, IMAGE_SKILL_TOKEN, or --token-stdin; if signup or guide already saved config, run feedback create normally and do not copy a raw token. Never paste tokens into feedback title, body, evidence, issues, or logs. Use image-skill activity show FEEDBACK_ID only when you need to confirm the feedback entered the hosted ledger.
70
70
 
71
71
  Manual escape hatches are not prerequisites. Use image-skill doctor, image-skill models list, image-skill models show MODEL_ID, image-skill whoami, image-skill usage quota, image-skill credits methods, image-skill credits packs list, image-skill credits quote, image-skill credits buy, image-skill credits status, image-skill create --dry-run, and image-skill edit --dry-run only when data.next_command or data.escape_hatches asks for them, or when the task genuinely needs deeper capability, quota, payment, or planning detail.
@@ -218,7 +218,9 @@ Use image-skill activity list/show when an agent needs recent ledger context,
218
218
  auditable event IDs, feedback confirmation, usage links, job/asset links, or
219
219
  trace references. Activity is broader than jobs and can include completed
220
220
  outputs, uploads, usage events, and feedback. Activity does not replace jobs
221
- show/wait for polling, recovery, retry judgment, or final job state.
221
+ show/wait for polling, recovery, retry judgment, or final job state. When
222
+ activity returns data.next_actions.self_fund, run its first_safe_command for
223
+ no-spend rail inspection before any quote/buy step.
222
224
  Current activity event registry: job.completed, job.planned, asset.created,
223
225
  asset.uploaded, usage.credit_consumed, feedback.created,
224
226
  feedback.github_queue.processed, payment.checkout_session.created,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "image-skill",
3
- "version": "0.1.55",
3
+ "version": "0.1.57",
4
4
  "description": "Zero-setup durable creative-media CLI for agents (image + video + audio + 3D): guide-first creation, model and cost inspection, owned URLs, JSON recovery, payments, reusable assets, and feedback.",
5
5
  "type": "module",
6
6
  "private": false,
package/skill.md CHANGED
@@ -271,12 +271,18 @@ image-skill activity show EVENT_OR_JOB_OR_ASSET_OR_FEEDBACK
271
271
  After a successful hosted create/edit, prefer `data.next_actions` when present:
272
272
  `inspect_job` and `inspect_asset` are no-spend recovery commands,
273
273
  `iterate_edit` reuses the asset, and `self_fund` promotes a copy-runnable
274
- top-up quote command when `quota.top_up.recommended` is true. That
275
- `quote_command` omits `--idempotency-key`; the public CLI generates and returns
276
- one for retry safety. Use `jobs show` or `jobs wait` for
274
+ top-up quote command when `quota.top_up.recommended` is true. That handoff
275
+ mirrors top-up `urgency`, `urgency_score`, and `urgency_reasons`, and exposes
276
+ `first_safe_command` plus `first_safe_command_effect` for no-spend rail
277
+ inspection before quote/buy. Its `quote_command` omits `--idempotency-key`; the
278
+ public CLI generates and returns one for retry safety. Use `jobs show` or
279
+ `jobs wait` for
277
280
  operational job state, final assets, and retry judgment. Use `activity` for
278
281
  audit trail context (recent jobs, assets, usage events, feedback acceptance,
279
- trace IDs, status changes) you can cite in feedback.
282
+ trace IDs, status changes) you can cite in feedback. `activity list/show` may
283
+ also return `data.next_actions.self_fund` with the same urgency and no-spend
284
+ inspection handoff when the ledger proves generated work and quota says top-up
285
+ setup is recommended.
280
286
  **Do not use `activity` as a wait or recovery command.** Activity is the ledger,
281
287
  not the work queue.
282
288
 
@@ -271,12 +271,18 @@ image-skill activity show EVENT_OR_JOB_OR_ASSET_OR_FEEDBACK
271
271
  After a successful hosted create/edit, prefer `data.next_actions` when present:
272
272
  `inspect_job` and `inspect_asset` are no-spend recovery commands,
273
273
  `iterate_edit` reuses the asset, and `self_fund` promotes a copy-runnable
274
- top-up quote command when `quota.top_up.recommended` is true. That
275
- `quote_command` omits `--idempotency-key`; the public CLI generates and returns
276
- one for retry safety. Use `jobs show` or `jobs wait` for
274
+ top-up quote command when `quota.top_up.recommended` is true. That handoff
275
+ mirrors top-up `urgency`, `urgency_score`, and `urgency_reasons`, and exposes
276
+ `first_safe_command` plus `first_safe_command_effect` for no-spend rail
277
+ inspection before quote/buy. Its `quote_command` omits `--idempotency-key`; the
278
+ public CLI generates and returns one for retry safety. Use `jobs show` or
279
+ `jobs wait` for
277
280
  operational job state, final assets, and retry judgment. Use `activity` for
278
281
  audit trail context (recent jobs, assets, usage events, feedback acceptance,
279
- trace IDs, status changes) you can cite in feedback.
282
+ trace IDs, status changes) you can cite in feedback. `activity list/show` may
283
+ also return `data.next_actions.self_fund` with the same urgency and no-spend
284
+ inspection handoff when the ledger proves generated work and quota says top-up
285
+ setup is recommended.
280
286
  **Do not use `activity` as a wait or recovery command.** Activity is the ledger,
281
287
  not the work queue.
282
288
 
@@ -1517,9 +1517,13 @@ input asset metadata where
1517
1517
  applicable. Responses do not include raw prompts, source bytes, base64
1518
1518
  payloads, local paths, full external URLs, bucket names, or object keys.
1519
1519
  When `quota.top_up.recommended` is true, `next_actions.self_fund.quote_command`
1520
- is a copy-runnable top-up quote command; it omits `--idempotency-key` so the
1521
- public CLI generates and returns one for retry safety before the agent follows
1522
- the quote response into `credits buy` and `credits status`.
1520
+ is a copy-runnable top-up quote command. `next_actions.self_fund` also mirrors
1521
+ top-up `urgency`, `urgency_score`, and `urgency_reasons`, and exposes
1522
+ `first_safe_command`, `first_safe_command_effect`, `inspect_methods_command`,
1523
+ and `inspect_packs_command` for no-spend payment rail inspection before
1524
+ quote/buy. The quote command omits `--idempotency-key` so the public CLI
1525
+ generates and returns one for retry safety before the agent follows the quote
1526
+ response into `credits buy` and `credits status`.
1523
1527
 
1524
1528
  Provider/model names in this paragraph are preview provenance, not the primary
1525
1529
  public UX. The public selection surface should be Image Skill capabilities and
@@ -1658,6 +1662,11 @@ related job IDs, asset IDs, usage IDs, feedback IDs, trace IDs, status changes,
1658
1662
  and product-memory writes. Use `jobs show` or `jobs wait` when you need
1659
1663
  operational recovery, polling, retry judgment, or final job assets.
1660
1664
 
1665
+ When the ledger proves generated work and current quota says top-up setup is
1666
+ recommended, `data.next_actions.self_fund` mirrors the same urgency and
1667
+ no-spend payment-method inspection handoff returned by successful create/edit
1668
+ and `jobs show`.
1669
+
1661
1670
  Minimum success data:
1662
1671
 
1663
1672
  ```json
@@ -1714,7 +1723,9 @@ image-skill activity show sig_... --json
1714
1723
  `activity show` accepts activity event IDs plus job, asset, usage, feedback, and
1715
1724
  trace references. When the reference is a subject rather than one exact event,
1716
1725
  the response includes matching ledger events so an agent can cite the right
1717
- event without reading telemetry logs.
1726
+ event without reading telemetry logs. When current quota recommends top-up
1727
+ setup after generated work, `data.next_actions.self_fund.first_safe_command`
1728
+ is the no-spend rail inspection command to run before any quote/buy step.
1718
1729
 
1719
1730
  Hosted API equivalent:
1720
1731
 
@@ -65,7 +65,7 @@ First-run guide loop:
65
65
  5. At any guide stage, read data.checks.quota.top_up. When recommended is true, it includes recommendation_reason, preferred_payment_method, quote_command, quote_command_copy_runnable, quote_command_effect, and quote/buy/status command templates for the browserless x402 top-up path. On quota/payment recovery errors, read error.recovery.top_up: when delegated live-money quoting is allowed, prefer error.recovery.top_up.quote_command to open the top-up path, and use error.recovery.suggested_command for no-spend payment-method inspection. If data.stage is quota_required, data.guide_warning.next_command_safety is live_money_payment_action and data.guide_warning.payment_top_up_path summarizes the live-money path. Run data.self_fund_next_command to start the top-up. It aliases data.next_command and is the first payment command, usually an x402 or Stripe quote. First read data.checks.payments.preferred_method_summary.top_up_path: browserless_agent_self_fund means a wallet-equipped agent can complete the preferred live-money rail without a browser; human_payment_handoff means the agent can create the payment attempt but a human/browser step must complete before credits are granted. If the guide authenticated from env or stdin, prefer data.self_fund_handoff.auth.next_command.with_env or data.self_fund_handoff.auth.next_command.with_stdin so auth follows the payment command. Then follow data.self_fund_handoff.payment_commands.buy and status, and rerun data.self_fund_handoff.after_next once credits are granted. If data.stage is ready_to_create, inspect data.self_fund_preparation before consuming the remaining free allowance. When available and recommended are true, data.self_fund_preparation.quote_command is the pre-wall browserless x402 quote: it creates an authenticated live-money quote/payment object, but data.self_fund_preparation.quote_command_effect must show no provider call, no hosted create, no credit debit, no media write, and no wallet settlement until a later buy/payment step. One Image Skill credit is $0.01. Credit quotes grant prepaid value units; create/edit operations debit model-priced credits reported as cost.credit_pricing. Starter preview currently gives bounded free-preview credits plus a four-job daily cap.
66
66
  5a. When data.stage is quota_required, data.self_fund_handoff mirrors top-up urgency, urgency_score, and urgency_reasons, and exposes first_safe_command plus first_safe_command_effect. Run first_safe_command, usually image-skill credits methods --json, for no-spend rail inspection before quote/buy when delegated spend authority is absent or unclear.
67
67
  6. If data.stage is ready_to_create, data.next_command is the first bounded live create. data.guide_warning.next_command_safety must be live_media_create_credit_debit, data.guide_warning.no_spend_safe must be false, data.guide_warning.spend_required must be true, and data.guide_warning.recommended_command_field must be recommended_no_spend_command. data.auth_ready.ready and data.auth_ready.next_command_auth_ready must be true; data.auth_ready.next_command_requires_auth must be true, and the command can reuse saved config, IMAGE_SKILL_TOKEN, or --token-stdin context without exposing a raw token. data.next_command_effect.label must be live_media_create_credit_debit and its provider_call, hosted_create, credit_debit, and media_write flags are true. data.no_spend_evaluation.stop_here must be true, data.no_spend_evaluation.next_command_is_live_create must be true, and data.no_spend_evaluation.recommended_command_field must be recommended_no_spend_command. Run data.next_command only when media spend is allowed. In no-spend evaluations, or when you only need to prove readiness without media/provider work, stop before data.next_command and run data.recommended_no_spend_command instead. data.recommended_no_spend_command must equal data.no_spend_next_command. data.no_spend_next_command_effect.label must be dry_run_planned_job_no_provider_call_no_credit_debit_no_media_write: no_spend, hosted_create_dry_run, planned_job, and plan_receipt are true; activity_event is job.planned; provider_call, credit_debit, and media_write are false. This dry-run may create a recoverable planned job/activity receipt but no provider execution, debit, downloadable asset, or media write. If the guide authenticated from env or stdin, prefer data.auth_handoff.next_command.with_env or data.auth_handoff.next_command.with_stdin so auth follows the live create. In guide cost output, cost.estimated_usd_per_image and cost.estimated_debit_usd_per_image are the Image Skill debit dollars for one output; cost.estimated_provider_usd_per_image is only the upstream provider estimate. Use the guide's returned max_estimated_usd_per_image because it is sized to the credit debit the agent funds. Add --output-count N only after models show confirms the selected create model supports more than one output; credit_pricing.credits_required is the total debit across outputs, while max_estimated_usd_per_image remains a per-image Image Skill debit guard.
68
- 7. After create, prefer data.next_actions when present: inspect_job and inspect_asset are copy-runnable no-spend recovery commands, iterate_edit is the reusable-asset edit template, and self_fund is the promoted top-up quote handoff when quota.top_up.recommended is true. self_fund.quote_command is copy-runnable and omits --idempotency-key so the public CLI generates and returns one for retry safety; follow the quote response into buy/status. Otherwise use image-skill jobs show JOB_ID to recover status, cost, safety, timestamps, and final assets; image-skill assets get ASSET_URL_OR_ID --output ./result.png to fetch the generated asset without repeating provider work; and image-skill activity list --subject JOB_ID to find ledger events, trace, usage, and asset links to cite.
68
+ 7. After create, prefer data.next_actions when present: inspect_job and inspect_asset are copy-runnable no-spend recovery commands, iterate_edit is the reusable-asset edit template, and self_fund is the promoted top-up quote handoff when quota.top_up.recommended is true. self_fund mirrors urgency, urgency_score, and urgency_reasons, and exposes first_safe_command plus first_safe_command_effect for no-spend rail inspection before quote/buy. self_fund.quote_command is copy-runnable and omits --idempotency-key so the public CLI generates and returns one for retry safety; follow the quote response into buy/status. Otherwise use image-skill jobs show JOB_ID to recover status, cost, safety, timestamps, and final assets; image-skill assets get ASSET_URL_OR_ID --output ./result.png to fetch the generated asset without repeating provider work; and image-skill activity list --subject JOB_ID to find ledger events, trace, usage, asset links, and any data.next_actions.self_fund handoff to cite or follow.
69
69
  8. Leave image-skill feedback create if the first-run flow is confusing, blocked, missing an affordance, or easier through a direct provider than through Image Skill. Feedback auth uses saved config from default signup, IMAGE_SKILL_TOKEN, or --token-stdin; if signup or guide already saved config, run feedback create normally and do not copy a raw token. Never paste tokens into feedback title, body, evidence, issues, or logs. Use image-skill activity show FEEDBACK_ID only when you need to confirm the feedback entered the hosted ledger.
70
70
 
71
71
  Manual escape hatches are not prerequisites. Use image-skill doctor, image-skill models list, image-skill models show MODEL_ID, image-skill whoami, image-skill usage quota, image-skill credits methods, image-skill credits packs list, image-skill credits quote, image-skill credits buy, image-skill credits status, image-skill create --dry-run, and image-skill edit --dry-run only when data.next_command or data.escape_hatches asks for them, or when the task genuinely needs deeper capability, quota, payment, or planning detail.
@@ -218,7 +218,9 @@ Use image-skill activity list/show when an agent needs recent ledger context,
218
218
  auditable event IDs, feedback confirmation, usage links, job/asset links, or
219
219
  trace references. Activity is broader than jobs and can include completed
220
220
  outputs, uploads, usage events, and feedback. Activity does not replace jobs
221
- show/wait for polling, recovery, retry judgment, or final job state.
221
+ show/wait for polling, recovery, retry judgment, or final job state. When
222
+ activity returns data.next_actions.self_fund, run its first_safe_command for
223
+ no-spend rail inspection before any quote/buy step.
222
224
  Current activity event registry: job.completed, job.planned, asset.created,
223
225
  asset.uploaded, usage.credit_consumed, feedback.created,
224
226
  feedback.github_queue.processed, payment.checkout_session.created,