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 +20 -0
- package/SKILL.md +10 -4
- package/bin/image-skill.mjs +1 -1
- package/cli.md +15 -4
- package/llms.txt +4 -2
- package/package.json +1 -1
- package/skill.md +10 -4
- package/skills/image-skill/SKILL.md +10 -4
- package/skills/image-skill/references/cli.md +15 -4
- package/skills/image-skill/references/llms.txt +4 -2
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
|
-
|
|
276
|
-
|
|
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
|
|
package/bin/image-skill.mjs
CHANGED
|
@@ -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.
|
|
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
|
|
1521
|
-
|
|
1522
|
-
|
|
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,
|
|
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.
|
|
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
|
-
|
|
276
|
-
|
|
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
|
-
|
|
276
|
-
|
|
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
|
|
1521
|
-
|
|
1522
|
-
|
|
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,
|
|
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,
|