@deepraxis/cli 0.3.0-dev.3266b68 → 0.3.0-dev.3fd59db

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/COMMANDS.md CHANGED
@@ -565,13 +565,13 @@ Handwritten commands: `login`, `logout`, `whoami`, `org list`, `org switch <orga
565
565
  | `praxis api search map` | `search.map.create` | POST `/search/v1/map` | `--url`, `--instructions`, `--max-depth`, `--max-breadth`, `--param-limit`, `--select-paths`, `--select-domains`, `--exclude-paths`, `--exclude-domains`, `--allow-external`, `--timeout`, `--include-usage` |
566
566
  | `praxis api studio codex create` | `studio.codexes.create` | POST `/studio/v1/codexes` | `--name`, `--description` |
567
567
  | `praxis api studio codex delete <codex>` | `studio.codexes.delete` | DELETE `/studio/v1/codexes/{codex}` | |
568
- | `praxis api studio codex entry create` | `studio.codexes.entries.create` | POST `/studio/v1/codexes/{codex}/entries` | `--codex`, `--type`, `--name`, `--group`, `--aliases`, `--case-sensitive`, `--exclude-phrases`, `--description`, `--notes`, `--tracking`, `--images` |
568
+ | `praxis api studio codex entry create` | `studio.codexes.entries.create` | POST `/studio/v1/codexes/{codex}/entries` | `--codex`, `--type`, `--name`, `--group`, `--aliases`, `--case-sensitive`, `--exclude-phrases`, `--description`, `--notes`, `--time`, `--tracking` |
569
569
  | `praxis api studio codex entry delete <entry>` | `studio.codexes.entries.delete` | DELETE `/studio/v1/codexes/{codex}/entries/{entry}` | `--codex` |
570
570
  | `praxis api studio codex entry get <entry>` | `studio.codexes.entries.retrieve` | GET `/studio/v1/codexes/{codex}/entries/{entry}` | `--codex` |
571
571
  | `praxis api studio codex entry list` | `studio.codexes.entries.list` | GET `/studio/v1/codexes/{codex}/entries` | `--codex`, `--page-size`, `--page-token` |
572
- | `praxis api studio codex entry update <entry>` | `studio.codexes.entries.update` | PATCH `/studio/v1/codexes/{codex}/entries/{entry}` | `--codex`, `--update-mask`, `--type`, `--name`, `--group`, `--aliases`, `--case-sensitive`, `--exclude-phrases`, `--description`, `--notes`, `--tracking`, `--images` |
572
+ | `praxis api studio codex entry update <entry>` | `studio.codexes.entries.update` | PATCH `/studio/v1/codexes/{codex}/entries/{entry}` | `--codex`, `--update-mask`, `--type`, `--name`, `--group`, `--aliases`, `--case-sensitive`, `--exclude-phrases`, `--description`, `--notes`, `--time`, `--tracking` |
573
573
  | `praxis api studio codex get <codex>` | `studio.codexes.retrieve` | GET `/studio/v1/codexes/{codex}` | |
574
- | `praxis api studio codex list` | `studio.codexes.list` | GET `/studio/v1/codexes` | `--page-size`, `--page-token` |
574
+ | `praxis api studio codex list` | `studio.codexes.list` | GET `/studio/v1/codexes` | `--page-size`, `--page-token`, `--work` |
575
575
  | `praxis api studio codex update <codex>` | `studio.codexes.update` | PATCH `/studio/v1/codexes/{codex}` | `--update-mask`, `--name`, `--description` |
576
576
  | `praxis api studio genre get <genre>` | `studio.genres.retrieve` | GET `/studio/v1/genres/{genre}` | |
577
577
  | `praxis api studio genre list` | `studio.genres.list` | GET `/studio/v1/genres` | `--include-unavailable` |
@@ -579,10 +579,10 @@ Handwritten commands: `login`, `logout`, `whoami`, `org list`, `org switch <orga
579
579
  | `praxis api studio platform list` | `studio.platforms.list` | GET `/studio/v1/platforms` | `--genre` |
580
580
  | `praxis api studio reviewer list` | `studio.reviewers.list` | GET `/studio/v1/reviewers` | `--kind`, `--page-size`, `--page-token` |
581
581
  | `praxis api studio reviewer update <agent>` | `studio.reviewers.update` | PATCH `/studio/v1/reviewers/{agent}` | `--active` |
582
- | `praxis api studio style create` | `studio.styles.create` | POST `/studio/v1/styles` | `--name`, `--description`, `--samples`, `--use`, `--avoid` |
582
+ | `praxis api studio style create` | `studio.styles.create` | POST `/studio/v1/styles` | `--name`, `--description`, `--samples`, `--work`, `--use`, `--avoid` |
583
583
  | `praxis api studio style delete <style>` | `studio.styles.delete` | DELETE `/studio/v1/styles/{style}` | |
584
584
  | `praxis api studio style get <style>` | `studio.styles.retrieve` | GET `/studio/v1/styles/{style}` | |
585
- | `praxis api studio style list` | `studio.styles.list` | GET `/studio/v1/styles` | `--page-size`, `--page-token` |
585
+ | `praxis api studio style list` | `studio.styles.list` | GET `/studio/v1/styles` | `--page-size`, `--page-token`, `--work` |
586
586
  | `praxis api studio style update <style>` | `studio.styles.update` | PATCH `/studio/v1/styles/{style}` | `--update-mask`, `--name`, `--description`, `--samples`, `--use`, `--avoid` |
587
587
  | `praxis api studio template create` | `studio.templates.create` | POST `/studio/v1/templates` | `--genre`, `--name`, `--guide` |
588
588
  | `praxis api studio template delete <template>` | `studio.templates.delete` | DELETE `/studio/v1/templates/{template}` | |
@@ -593,7 +593,7 @@ Handwritten commands: `login`, `logout`, `whoami`, `org list`, `org switch <orga
593
593
  | `praxis api studio theme get <theme>` | `studio.themes.retrieve` | GET `/studio/v1/themes/{theme}` | |
594
594
  | `praxis api studio theme list` | `studio.themes.list` | GET `/studio/v1/themes` | `--platform`, `--page-size`, `--page-token` |
595
595
  | `praxis api studio theme update <theme>` | `studio.themes.update` | PATCH `/studio/v1/themes/{theme}` | `--update-mask`, `--name`, `--html`, `--css`, `--reference-docx`, `--header`, `--footer` |
596
- | `praxis api studio work create` | `studio.works.create` | POST `/studio/v1/works` | `--title`, `--slug`, `--codexes`, `--style`, `--request-id` |
596
+ | `praxis api studio work create` | `studio.works.create` | POST `/studio/v1/works` | `--title`, `--slug`, `--codexes`, `--style`, `--cover`, `--based-on`, `--request-id` |
597
597
  | `praxis api studio work draft create` | `studio.works.drafts.create` | POST `/studio/v1/works/{work}/drafts` | `--work`, `--genre`, `--title`, `--mode`, `--template`, `--request-id` |
598
598
  | `praxis api studio work draft get <draft>` | `studio.works.drafts.retrieve` | GET `/studio/v1/works/{work}/drafts/{draft}` | `--work`, `--expand` |
599
599
  | `praxis api studio work draft get-export <draft>` | `studio.works.drafts.retrieveExport` | GET `/studio/v1/works/{work}/drafts/{draft}/export` | `--work`, `--param-format` |
@@ -629,7 +629,7 @@ Handwritten commands: `login`, `logout`, `whoami`, `org list`, `org switch <orga
629
629
  | `praxis api studio work unit get-context <unit>` | `studio.works.units.retrieveContext` | GET `/studio/v1/works/{work}/units/{unit}/context` | `--work`, `--budget-tokens` |
630
630
  | `praxis api studio work unit move <unit>` | `studio.works.units.move` | POST `/studio/v1/works/{work}/units/{unit}:move` | `--work`, `--expected-revision`, `--parent`, `--after` |
631
631
  | `praxis api studio work unit update <unit>` | `studio.works.units.update` | PATCH `/studio/v1/works/{work}/units/{unit}` | `--work`, `--expected-revision`, `--name`, `--heading`, `--synopsis`, `--points`, `--brief-points`, `--body`, `--synopsis-from-body`, `--status`, `--seconds`, `--confirm-final-edit` |
632
- | `praxis api studio work update <work>` | `studio.works.update` | PATCH `/studio/v1/works/{work}` | `--update-mask`, `--expected-revision`, `--title`, `--slug`, `--codexes`, `--style`, `--archived` |
632
+ | `praxis api studio work update <work>` | `studio.works.update` | PATCH `/studio/v1/works/{work}` | `--update-mask`, `--expected-revision`, `--title`, `--slug`, `--codexes`, `--style`, `--cover`, `--archived` |
633
633
  | `praxis api studio work update-brief <work>` | `studio.works.updateBrief` | PATCH `/studio/v1/works/{work}/brief` | `--expected-revision`, `--text`, `--attachments`, `--remove-points` |
634
634
  | `praxis api ticket activity get` | `ticket.activity.retrieve` | GET `/ticket/v1/activity` | `--repository`, `--page-size`, `--page-token`, `--filter` |
635
635
  | `praxis api ticket comment create` | `ticket.tickets.comments.create` | POST `/ticket/v1/tickets/{number}/comments` | `--ticket`, `--repository`, `--body`, `--in-reply-to` |
package/dist/praxis.js CHANGED
@@ -22535,7 +22535,7 @@ The default is return=minimal: success returns HTTP 201 with an empty body. Send
22535
22535
  resource: "media.speech",
22536
22536
  method: "create",
22537
22537
  summary: "Create speech",
22538
- description: "Synthesise speech from text and store the recording straight into the library. Use library_id from creation or listing; the path segment {library_id} also accepts the literal default, which resolves to the organization’s default library before the credential check, so an agent that has never listed a library can still synthesise. input is the text to speak and voice is required; speed is passed to the provider unchanged, and instructions and language are refused with OPERATION_NOT_SUPPORTED in this release. A voice that names a voice material of this library is refused the same way — voice cloning opens with voices.create. The provider caps one request at a short stretch of text, so a long input is cut into segments at paragraph and sentence boundaries and synthesised in order, then joined into the single recording the library receives: nothing is spoken twice and nothing is dropped. Because the segments are joined byte for byte, a multi-segment input accepts only response_format mp3 (the default) or pcm; opus is available for a single-segment input. A speech job has one result however many segments it took. Synthesis is billed by the model usage it consumes, at the same prices as the model API, and the job records the charge in usage; a request refused before it starts costs nothing. The response is 202 with a queued Job whose type is speech and whose operation is generate; poll GET /media/v1/libraries/{library_id}/jobs/{job_id} until its status is completed or failed, then read the produced asset from the library — the recording carries material_type audio, audio_role voice, ai_generated true, and provenance naming this job, the text spoken and the model. Send Idempotency-Key, or idempotency_key in the body, to retry without synthesising and charging twice. Example: POST /media/v1/libraries/default/audio/speech with {\"input\":\"A red kite above a calm sea at sunrise.\",\"voice\":\"alloy\"}.",
22538
+ description: "Synthesise speech from text and store the recording straight into the library. Use library_id from creation or listing; the path segment {library_id} also accepts the literal default, which resolves to the organization’s default library before the credential check, so an agent that has never listed a library can still synthesise. input is the text to speak and voice is required; speed is passed to the provider unchanged, and instructions and language are refused with OPERATION_NOT_SUPPORTED in this release. Voice cloning is not available yet, so voice is a platform voice name of the chosen model. The provider caps one request at a short stretch of text, so a long input is cut into segments at paragraph and sentence boundaries and synthesised in order, then joined into the single recording the library receives: nothing is spoken twice and nothing is dropped. Because the segments are joined byte for byte, a multi-segment input accepts only response_format mp3 (the default) or pcm; opus is available for a single-segment input. A speech job has one result however many segments it took. Synthesis is billed by the model usage it consumes, at the same prices as the model API, and the job records the charge in usage; a request refused before it starts costs nothing. The response is 202 with a queued Job whose type is speech and whose operation is generate; poll GET /media/v1/libraries/{library_id}/jobs/{job_id} until its status is completed or failed, then read the produced asset from the library — the recording carries material_type audio, audio_role voice, ai_generated true, and provenance naming this job, the text spoken and the model. Send Idempotency-Key, or idempotency_key in the body, to retry without synthesising and charging twice. Example: POST /media/v1/libraries/default/audio/speech with {\"input\":\"A red kite above a calm sea at sunrise.\",\"voice\":\"alloy\"}.",
22539
22539
  http: "POST",
22540
22540
  path: "/media/v1/libraries/{library_id}/audio/speech",
22541
22541
  streaming: "no",
@@ -29051,7 +29051,7 @@ for more details.`
29051
29051
  resource: "studio.codexes",
29052
29052
  method: "list",
29053
29053
  summary: "List the reference libraries of this organization",
29054
- description: "List the reference libraries this API key organization owns, each with how many entries it holds, so you can choose the one a work draws on. Continue with next_page_token until the answer stops carrying one. A library is shared across works, so the list is the whole organization's rather than one work's.",
29054
+ description: "List the reference libraries this API key organization owns, each with how many entries it holds, so you can choose the one a work draws on. Continue with next_page_token until the answer stops carrying one. Pass work to read one work's own library alone; leave it out for every library the organization owns.",
29055
29055
  http: "GET",
29056
29056
  path: "/studio/v1/codexes",
29057
29057
  streaming: "no",
@@ -29069,6 +29069,12 @@ for more details.`
29069
29069
  type: "string",
29070
29070
  required: false,
29071
29071
  description: "Cursor from the previous answer's next_page_token; it is opaque, so pass it back unchanged and never build one from an id or an offset."
29072
+ },
29073
+ {
29074
+ name: "work",
29075
+ type: "string",
29076
+ required: false,
29077
+ description: "Narrow the list to what belongs to one work, by its wk_ identifier, which is how one work's own setting is told apart from the organization's shared material; omit it to list everything this organization owns."
29072
29078
  }
29073
29079
  ]
29074
29080
  },
@@ -29076,7 +29082,7 @@ for more details.`
29076
29082
  resource: "studio.codexes",
29077
29083
  method: "create",
29078
29084
  summary: "Create a reference library",
29079
- description: "Create a reference library: a shared store of the people, places, products and facts a piece draws on, reusable across works. Attach it to a work with the work update call, and the entries it holds then reach the context packs of that work's units. A library is not private to one work, so the same brand facts can serve every piece that mentions them.",
29085
+ description: "Create a reference library: a store of the people, places, products and facts a piece draws on. Attach it to a work with the work update call, and the entries it holds then reach the context packs of that work's units. A library made this way is shared across works, which suits brand facts several pieces mention; the library a work needs for its own setting is created with the work itself, and the work list call finds it by filtering on work.",
29080
29086
  http: "POST",
29081
29087
  path: "/studio/v1/codexes",
29082
29088
  streaming: "no",
@@ -29226,7 +29232,7 @@ for more details.`
29226
29232
  resource: "studio.codexes.entries",
29227
29233
  method: "create",
29228
29234
  summary: "Add an entry to a reference library",
29229
- description: "Add one entry: a character, a place, a product, a source of facts. Give it the type the genre uses, the name the text will mention, and the description and facts that should reach a writer when it is mentioned. Aliases and excluded phrases keep detection honest, so a common word inside an idiom is not mistaken for the entry. A name already used in the library is refused.",
29235
+ description: "Add one entry: a character, a place, a product, a source of facts. Give it the type the genre uses, the name the text will mention, and the description, notes, facts and story time that should reach a writer when it is mentioned. Attach a picture gallery when the entry should be looked at as well as read. Aliases and excluded phrases keep detection honest, so a common word inside an idiom is not mistaken for the entry. A name already used in the library is refused.",
29230
29236
  http: "POST",
29231
29237
  path: "/studio/v1/codexes/{codex}/entries",
29232
29238
  streaming: "no",
@@ -29311,7 +29317,13 @@ for more details.`
29311
29317
  name: "notes",
29312
29318
  type: "string",
29313
29319
  required: false,
29314
- description: "Notes for people only, which never reach a writer's context pack."
29320
+ description: "Notes on this entry, which reach the writer's context pack on the line after the description and the facts; an empty string adds no line. Write here what the text must respect, not a private remark."
29321
+ },
29322
+ {
29323
+ name: "time",
29324
+ type: "string",
29325
+ required: false,
29326
+ description: "When this entry happens in the story, such as 2037 or 民国二十四年冬; at most 40 characters, and an empty string records no time. It is shown beside the entry and reaches the writer with it."
29315
29327
  },
29316
29328
  {
29317
29329
  name: "tracking",
@@ -29334,9 +29346,9 @@ for more details.`
29334
29346
  {
29335
29347
  name: "images",
29336
29348
  type: "array",
29337
- itemType: "string",
29349
+ itemType: "object",
29338
29350
  required: false,
29339
- description: "Images to attach, referenced by file identifiers that belong to this organization."
29351
+ description: "Picture gallery of this entry, in write order: send pictures with a name and a description, or send a bare file identifier when the picture has no name yet and it is stored with both empty."
29340
29352
  }
29341
29353
  ]
29342
29354
  }
@@ -29368,7 +29380,7 @@ for more details.`
29368
29380
  resource: "studio.codexes.entries",
29369
29381
  method: "retrieve",
29370
29382
  summary: "Read one reference entry",
29371
- description: "Read one entry in full: its description, its fact ledger, its relations to other entries, its detection settings and its images. Read it before changing it, because an update replaces the fields it names rather than merging them. The entry is addressed by its name in this library, or by its ent_ identifier.",
29383
+ description: "Read one entry in full: its description, its notes, its fact ledger, its relations to other entries, its story time, its detection settings and its picture gallery. Read it before changing it, because an update replaces the fields it names rather than merging them. The entry is addressed by its name in this library, or by its ent_ identifier.",
29372
29384
  http: "GET",
29373
29385
  path: "/studio/v1/codexes/{codex}/entries/{entry}",
29374
29386
  streaming: "no",
@@ -29391,7 +29403,7 @@ for more details.`
29391
29403
  resource: "studio.codexes.entries",
29392
29404
  method: "update",
29393
29405
  summary: "Change what a reference entry says",
29394
- description: "Change one entry: its type, its name, its aliases, its description, its facts, its notes, its tracking setting, its images or its relations. Send update_mask naming exactly the fields you change, because a field the mask leaves out keeps its value while a list field the mask names is replaced whole. Renaming an entry changes what the text has to mention for detection to find it.",
29406
+ description: "Change one entry: its type, its name, its aliases, its description, its facts, its notes, its story time, its tracking setting, its picture gallery or its relations. Send update_mask naming exactly the fields you change, because a field the mask leaves out keeps its value while a list field the mask names is replaced whole. Renaming an entry changes what the text has to mention for detection to find it.",
29395
29407
  http: "PATCH",
29396
29408
  path: "/studio/v1/codexes/{codex}/entries/{entry}",
29397
29409
  streaming: "no",
@@ -29488,7 +29500,13 @@ for more details.`
29488
29500
  name: "notes",
29489
29501
  type: "string",
29490
29502
  required: false,
29491
- description: "New notes for people only, which never reach a writer's context pack."
29503
+ description: "New notes on this entry, replacing the previous ones; they reach the writer's context pack on the line after the description and the facts, and an empty string removes that line."
29504
+ },
29505
+ {
29506
+ name: "time",
29507
+ type: "string",
29508
+ required: false,
29509
+ description: "New story time for this entry, replacing the previous one; at most 40 characters, and an empty string removes the time."
29492
29510
  },
29493
29511
  {
29494
29512
  name: "tracking",
@@ -29511,9 +29529,9 @@ for more details.`
29511
29529
  {
29512
29530
  name: "images",
29513
29531
  type: "array",
29514
- itemType: "string",
29532
+ itemType: "object",
29515
29533
  required: false,
29516
- description: "Complete set of images, replacing the previous ones."
29534
+ description: "Complete picture gallery for this entry, replacing the previous one and keeping the order you send; a picture left out stops being shown beside the entry."
29517
29535
  }
29518
29536
  ]
29519
29537
  }
@@ -29678,6 +29696,12 @@ for more details.`
29678
29696
  type: "string",
29679
29697
  required: false,
29680
29698
  description: "Cursor from the previous answer's next_page_token; it is opaque, so pass it back unchanged and never build one from an id or an offset."
29699
+ },
29700
+ {
29701
+ name: "work",
29702
+ type: "string",
29703
+ required: false,
29704
+ description: "Narrow the list to what belongs to one work, by its wk_ identifier, which is how one work's own setting is told apart from the organization's shared material; omit it to list everything this organization owns."
29681
29705
  }
29682
29706
  ]
29683
29707
  },
@@ -29685,7 +29709,7 @@ for more details.`
29685
29709
  resource: "studio.styles",
29686
29710
  method: "create",
29687
29711
  summary: "Create a writing style",
29688
- description: "Create a style: the voice a piece is written in, held as samples rather than as adjectives. Samples matter more than a description, so paste one to five paragraphs of writing the piece should sound like, and put the words to avoid into avoid so the banned-word check uses them. Attach a style to a work, or to one draft of it, and its samples then reach every context pack.",
29712
+ description: "Create a style: the voice a piece is written in, held as samples rather than as adjectives. Samples matter more than a description, so paste one to five paragraphs of writing the piece should sound like, and put the words to avoid into avoid so the banned-word check uses them. A style belongs to the work you name in work, and a work may only attach its own styles, so create the style with the work it will be used in. Attach a style to a work, or to one draft of it, and its samples then reach every context pack.",
29689
29713
  http: "POST",
29690
29714
  path: "/studio/v1/styles",
29691
29715
  streaming: "no",
@@ -29714,6 +29738,19 @@ for more details.`
29714
29738
  required: false,
29715
29739
  description: "One to five paragraphs of writing in the intended voice; these paragraphs are what reach a writer, so choose them carefully."
29716
29740
  },
29741
+ {
29742
+ name: "pictures",
29743
+ type: "array",
29744
+ itemType: "object",
29745
+ required: false,
29746
+ description: "Picture samples to store with the style, in the order you send them; a bare file identifier is stored as a picture with no name and no description."
29747
+ },
29748
+ {
29749
+ name: "work",
29750
+ type: "string",
29751
+ required: false,
29752
+ description: "Work this style should belong to, by its wk_ identifier; pass it so the work can attach the style later, since a work may only use its own styles. Omit it for a style that belongs to no single work."
29753
+ },
29717
29754
  {
29718
29755
  name: "use",
29719
29756
  type: "array",
@@ -29777,7 +29814,7 @@ for more details.`
29777
29814
  resource: "studio.styles",
29778
29815
  method: "update",
29779
29816
  summary: "Change a writing style",
29780
- description: "Change a style: its name, its description, its samples, its use and avoid lists, or its glossary. Send update_mask naming exactly the fields you change; a list the mask names is replaced whole. Adding a term to the glossary or to avoid also changes what the deterministic checks flag, so a work that uses this style sees new findings on its next check.",
29817
+ description: "Change a style: its name, its description, its samples, its picture samples, its use and avoid lists, or its glossary. Send update_mask naming exactly the fields you change; a list the mask names is replaced whole. Adding a term to the glossary or to avoid also changes what the deterministic checks flag, so a work that uses this style sees new findings on its next check.",
29781
29818
  http: "PATCH",
29782
29819
  path: "/studio/v1/styles/{style}",
29783
29820
  streaming: "no",
@@ -29819,6 +29856,13 @@ for more details.`
29819
29856
  required: false,
29820
29857
  description: "Complete set of sample paragraphs, replacing the previous ones; removing a sample removes it from every later context pack."
29821
29858
  },
29859
+ {
29860
+ name: "pictures",
29861
+ type: "array",
29862
+ itemType: "object",
29863
+ required: false,
29864
+ description: "Complete picture gallery for this style, replacing the previous one and keeping the order you send; a picture left out stops being shown."
29865
+ },
29822
29866
  {
29823
29867
  name: "use",
29824
29868
  type: "array",
@@ -30190,7 +30234,7 @@ for more details.`
30190
30234
  resource: "studio.works",
30191
30235
  method: "create",
30192
30236
  summary: "Create a work with its goal",
30193
- description: "Create a work: one deliverable piece plus everything around it. Pass the goal the writing serves — the reader, what that reader should get or do, the one-sentence message and the constraints — and the original brief the person gave in their own words. A slug is derived from the title unless you pass one. The work starts with no drafts; create the first one with the drafts create call, because the genre decides the structure.",
30237
+ description: "Create a work: one deliverable piece plus everything around it. Pass the goal the writing serves — the reader, what that reader should get or do, the one-sentence message and the constraints — and the original brief the person gave in their own words. A slug is derived from the title unless you pass one. The work starts with no drafts; create the first one with the drafts create call, because the genre decides the structure. A reference library belongs to the work and is created with it, so the setting written later stays this work's own; pass based_on to start from another work and have its setting and styles copied in as your own.",
30194
30238
  http: "POST",
30195
30239
  path: "/studio/v1/works",
30196
30240
  streaming: "no",
@@ -30229,13 +30273,25 @@ for more details.`
30229
30273
  type: "array",
30230
30274
  itemType: "string",
30231
30275
  required: false,
30232
- description: "Reference libraries to attach at creation; a library owned by another organization is refused rather than attached."
30276
+ description: "Shared reference libraries to attach at creation, on top of the work's own library, which is always created with it; a library owned by another organization is refused rather than attached."
30233
30277
  },
30234
30278
  {
30235
30279
  name: "style",
30236
30280
  type: "string",
30237
30281
  required: false,
30238
- description: "Style to attach to the work, whose samples and glossary then reach every context pack unless a draft overrides it."
30282
+ description: "Style to attach to the work, whose samples and glossary then reach every context pack unless a draft overrides it. A new work has no styles of its own yet, so leave this out and attach one after creating a style with work set to this work."
30283
+ },
30284
+ {
30285
+ name: "cover",
30286
+ type: "string",
30287
+ required: false,
30288
+ description: "Cover image for the work, by a file identifier that belongs to this organization; leave it out for a work with no cover."
30289
+ },
30290
+ {
30291
+ name: "based_on",
30292
+ type: "string",
30293
+ required: false,
30294
+ description: "Work to copy at creation, by its wk_ identifier or its slug: its own library's entries, its styles and the style it uses come into this new work as its own copies, and the source is recorded as this work's baseline. The two works are independent afterwards, and drafts are not copied. Use it to start a sequel or a variant from an existing setting instead of rebuilding the setting; a source work this organization does not own answers BASELINE_NOT_FOUND."
30239
30295
  },
30240
30296
  {
30241
30297
  name: "labels",
@@ -30358,7 +30414,13 @@ for more details.`
30358
30414
  name: "style",
30359
30415
  type: "string",
30360
30416
  required: false,
30361
- description: "Style to attach to the work, replacing the previous one; send an empty value to detach the style entirely."
30417
+ description: "Style to attach to the work, replacing the previous one; send an empty value to detach the style entirely. It must be one of this work's own styles — name a style created with work set to this work — and the style of another work is refused with STYLE_NOT_IN_WORK."
30418
+ },
30419
+ {
30420
+ name: "cover",
30421
+ type: "string",
30422
+ required: false,
30423
+ description: "Cover image to set, by a file identifier that belongs to this organization, replacing the previous cover; send null with cover named in the update mask to clear the cover."
30362
30424
  },
30363
30425
  {
30364
30426
  name: "labels",
@@ -32407,7 +32469,7 @@ for more details.`
32407
32469
  name: "filter",
32408
32470
  type: "string",
32409
32471
  required: false,
32410
- description: "Search qualifier subset: is/state, reason, label/-label, no, assignee, author, mentions, milestone, type, kind, assignee-kind, in and sort; write each qualifier as field:value (for example, is:open milestone:5), never field=value. Unknown qualifiers return INVALID_PARAMS. Passed unchanged to the service."
32472
+ description: "Search qualifier subset: is/state, reason, label/-label, no, assignee, owner, author, mentions, milestone, type, kind, assignee-kind, in and sort (owner:<subject>|none|*|me and no:owner match the single ticket owner; assignee: matches the GitHub-compatible assignees); write each qualifier as field:value (for example, is:open milestone:5), never field=value. Unknown qualifiers return INVALID_PARAMS. Passed unchanged to the service."
32411
32473
  }
32412
32474
  ]
32413
32475
  },
@@ -52908,7 +52970,7 @@ function startProgress(ctx, write = (text) => writeOutput({ stderr: text })) {
52908
52970
  }
52909
52971
 
52910
52972
  // src/main.ts
52911
- var version = "0.3.0-dev.3266b68";
52973
+ var version = "0.3.0-dev.3fd59db";
52912
52974
  var commands = commandTree(operations);
52913
52975
  var manual = [...workflows.map((w) => w.words), [API_WORD]];
52914
52976
  function route(argv) {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@deepraxis/cli",
3
- "version": "0.3.0-dev.3266b68",
3
+ "version": "0.3.0-dev.3fd59db",
4
4
  "type": "module",
5
5
  "bin": {
6
6
  "praxis": "dist/praxis.js"