@oxygen-agent/cli 1.1015.29 → 1.1017.21

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.
Files changed (209) hide show
  1. package/README.md +1 -1
  2. package/dist/command-families/tables/automation.js +1 -1
  3. package/dist/command-families/tables/import-batches.js +1 -1
  4. package/dist/command-families/tables/import-values.js +1 -1
  5. package/dist/command-families/tables/register-reads.js +2 -2
  6. package/dist/command-manifest.js +9 -0
  7. package/dist/command-support.js +2 -2
  8. package/dist/commands/agent.js +2 -2
  9. package/dist/commands/billing.js +1 -1
  10. package/dist/commands/budget.js +1 -1
  11. package/dist/commands/columns.js +2 -2
  12. package/dist/commands/copilot.js +9 -3
  13. package/dist/commands/knowledge.js +3 -3
  14. package/dist/commands/table-runs.js +1 -1
  15. package/dist/commands/verify.js +1 -1
  16. package/dist/customer-operation-commands.js +1 -0
  17. package/dist/knowledge-mirror.js +1 -1
  18. package/dist/visual-commands.js +57 -8
  19. package/dist/workspace-skill-commands.d.ts +1 -1
  20. package/dist/workspace-skill-commands.js +1 -1
  21. package/node_modules/@oxygen/formula/dist/expression.d.ts +7 -0
  22. package/node_modules/@oxygen/formula/dist/expression.js +29 -1
  23. package/node_modules/@oxygen/formula/dist/formula-functions.d.ts +2 -0
  24. package/node_modules/@oxygen/formula/dist/formula-functions.js +6 -2
  25. package/node_modules/@oxygen/shared/dist/agents/reply-oxygent.js +1 -1
  26. package/node_modules/@oxygen/shared/dist/agents/sessions.js +2 -2
  27. package/node_modules/@oxygen/shared/dist/{billing.js → billing/billing.js} +4 -4
  28. package/node_modules/@oxygen/shared/dist/{credit-guidance.js → billing/credit-guidance.js} +1 -1
  29. package/node_modules/@oxygen/shared/dist/{billing-money.js → billing/money.js} +1 -1
  30. package/node_modules/@oxygen/shared/dist/{plan-band.d.ts → billing/plan-band.d.ts} +1 -1
  31. package/node_modules/@oxygen/shared/dist/{plan-band.js → billing/plan-band.js} +2 -2
  32. package/node_modules/@oxygen/shared/dist/{plan-limits.d.ts → billing/plan-limits.d.ts} +2 -2
  33. package/node_modules/@oxygen/shared/dist/{plan-limits.js → billing/plan-limits.js} +5 -5
  34. package/node_modules/@oxygen/shared/dist/{pricing-sheet.d.ts → billing/pricing-sheet.d.ts} +9 -9
  35. package/node_modules/@oxygen/shared/dist/{pricing-sheet.js → billing/pricing-sheet.js} +10 -10
  36. package/node_modules/@oxygen/shared/dist/{repricing.js → billing/repricing.js} +1 -1
  37. package/node_modules/@oxygen/shared/dist/{sending-seats.d.ts → billing/sending-seats.d.ts} +1 -1
  38. package/node_modules/@oxygen/shared/dist/{sending-seats.js → billing/sending-seats.js} +1 -1
  39. package/node_modules/@oxygen/shared/dist/capability-discovery.d.ts +2 -2
  40. package/node_modules/@oxygen/shared/dist/capability-discovery.js +3 -3
  41. package/node_modules/@oxygen/shared/dist/capability-intents/sourcing-and-provider-tools.d.ts +1 -1
  42. package/node_modules/@oxygen/shared/dist/capability-intents/visual-rendering.rules.js +3 -2
  43. package/node_modules/@oxygen/shared/dist/capability-routes/visual-rendering.js +6 -6
  44. package/node_modules/@oxygen/shared/dist/contracts/browser-operations.js +1 -1
  45. package/node_modules/@oxygen/shared/dist/contracts/connectors.js +1 -1
  46. package/node_modules/@oxygen/shared/dist/contracts/copilot-sessions.d.ts +27 -0
  47. package/node_modules/@oxygen/shared/dist/contracts/copilot-sessions.js +13 -0
  48. package/node_modules/@oxygen/shared/dist/contracts/customer-operations.js +2 -1
  49. package/node_modules/@oxygen/shared/dist/contracts/knowledge-content-reads.js +1 -1
  50. package/node_modules/@oxygen/shared/dist/contracts/knowledge-proposal-reads.js +1 -1
  51. package/node_modules/@oxygen/shared/dist/contracts/limits-read.js +2 -2
  52. package/node_modules/@oxygen/shared/dist/contracts/table-query-raw.d.ts +10 -0
  53. package/node_modules/@oxygen/shared/dist/contracts/table-query-raw.js +15 -0
  54. package/node_modules/@oxygen/shared/dist/contracts/teammates.js +2 -2
  55. package/node_modules/@oxygen/shared/dist/{copilot-access.js → copilot/access.js} +2 -2
  56. package/node_modules/@oxygen/shared/dist/{copilot-journeys.js → copilot/journeys.js} +1 -1
  57. package/node_modules/@oxygen/shared/dist/{copilot-playbooks.d.ts → copilot/playbooks.d.ts} +1 -1
  58. package/node_modules/@oxygen/shared/dist/{copilot-playbooks.js → copilot/playbooks.js} +1 -1
  59. package/node_modules/@oxygen/shared/dist/copilot-journeys.generated.js +1 -1
  60. package/node_modules/@oxygen/shared/dist/copilot-playbooks.generated.js +1 -1
  61. package/node_modules/@oxygen/shared/dist/diagnostic-spool.js +10 -1
  62. package/node_modules/@oxygen/shared/dist/feature-gates.d.ts +2 -2
  63. package/node_modules/@oxygen/shared/dist/feature-gates.js +2 -2
  64. package/node_modules/@oxygen/shared/dist/hosted-ai.js +1 -1
  65. package/node_modules/@oxygen/shared/dist/index.d.ts +24 -24
  66. package/node_modules/@oxygen/shared/dist/index.js +24 -24
  67. package/node_modules/@oxygen/shared/dist/{knowledge-bases.js → knowledge/bases.js} +1 -1
  68. package/node_modules/@oxygen/shared/dist/{knowledge-bootstrap.d.ts → knowledge/bootstrap.d.ts} +8 -2
  69. package/node_modules/@oxygen/shared/dist/{knowledge-bootstrap.js → knowledge/bootstrap.js} +9 -3
  70. package/node_modules/@oxygen/shared/dist/{knowledge-links.js → knowledge/links.js} +1 -1
  71. package/node_modules/@oxygen/shared/dist/{knowledge-markdown.js → knowledge/markdown.js} +1 -1
  72. package/node_modules/@oxygen/shared/dist/{knowledge-repository.js → knowledge/repository.js} +1 -1
  73. package/node_modules/@oxygen/shared/dist/{knowledge-seed-content.d.ts → knowledge/seed-content.d.ts} +1 -1
  74. package/node_modules/@oxygen/shared/dist/{knowledge-vault-markdown.js → knowledge/vault-markdown.js} +1 -1
  75. package/node_modules/@oxygen/shared/dist/log-collapse.d.ts +1 -1
  76. package/node_modules/@oxygen/shared/dist/log-collapse.js +1 -1
  77. package/node_modules/@oxygen/shared/dist/mailboxes/freemail-domains.d.ts +1 -1
  78. package/node_modules/@oxygen/shared/dist/mailboxes/freemail-domains.js +1 -1
  79. package/node_modules/@oxygen/shared/dist/media-project.d.ts +34 -0
  80. package/node_modules/@oxygen/shared/dist/media-project.js +58 -0
  81. package/node_modules/@oxygen/shared/dist/onboarding/research.d.ts +25 -1
  82. package/node_modules/@oxygen/shared/dist/onboarding/research.js +27 -1
  83. package/node_modules/@oxygen/shared/dist/pricing-snapshot.generated.js +1 -1
  84. package/node_modules/@oxygen/shared/dist/{publishing-approval.js → publishing/approval.js} +1 -1
  85. package/node_modules/@oxygen/shared/dist/{skill-play-routing.js → recipes/skill-play-routing.js} +1 -1
  86. package/node_modules/@oxygen/shared/dist/{workspace-skills.js → recipes/workspace-skills.js} +2 -2
  87. package/node_modules/@oxygen/shared/dist/search-vocab.d.ts +1 -0
  88. package/node_modules/@oxygen/shared/dist/search-vocab.js +15 -2
  89. package/node_modules/@oxygen/shared/dist/sequences/linkedin-quota-denial.d.ts +1 -1
  90. package/node_modules/@oxygen/shared/dist/sequences/linkedin-quota-denial.js +1 -1
  91. package/node_modules/@oxygen/shared/dist/sequences/sending-limits.d.ts +1 -1
  92. package/node_modules/@oxygen/shared/dist/sequences/whatsapp-sender-limits.d.ts +1 -1
  93. package/node_modules/@oxygen/shared/dist/sequences/whatsapp-sender-limits.js +1 -1
  94. package/node_modules/@oxygen/shared/dist/{network-mining-approval.js → signals/network-mining-approval.js} +1 -1
  95. package/node_modules/@oxygen/shared/dist/{network-mining.js → signals/network-mining.js} +1 -1
  96. package/node_modules/@oxygen/shared/dist/skill-plays.generated.js +1 -1
  97. package/node_modules/@oxygen/shared/dist/spend-safety.d.ts +4 -4
  98. package/node_modules/@oxygen/shared/dist/spend-safety.js +1 -1
  99. package/node_modules/@oxygen/shared/dist/tables/capacity.d.ts +2 -2
  100. package/node_modules/@oxygen/shared/dist/tables/capacity.js +1 -1
  101. package/node_modules/@oxygen/shared/dist/{cell-format.js → tables/cell-format.js} +2 -2
  102. package/node_modules/@oxygen/shared/dist/{column-autofill.js → tables/column-autofill.js} +1 -1
  103. package/node_modules/@oxygen/shared/dist/tables/column-output-fields.js +1 -1
  104. package/node_modules/@oxygen/shared/dist/tables/company-enrichment-fields.js +1 -1
  105. package/node_modules/@oxygen/shared/dist/tables/enrichment-intents.d.ts +1 -1
  106. package/node_modules/@oxygen/shared/dist/tables/enrichment-intents.js +1 -1
  107. package/node_modules/@oxygen/shared/dist/{table-field-types.d.ts → tables/field-types.d.ts} +1 -1
  108. package/node_modules/@oxygen/shared/dist/{table-field-types.js → tables/field-types.js} +1 -1
  109. package/node_modules/@oxygen/shared/dist/{table-filter-operators.js → tables/filter-operators.js} +1 -1
  110. package/node_modules/@oxygen/shared/dist/tables/linkedin-payload-fields.d.ts +78 -0
  111. package/node_modules/@oxygen/shared/dist/tables/linkedin-payload-fields.js +182 -0
  112. package/node_modules/@oxygen/shared/dist/{research-findings.js → tables/research-findings.js} +1 -1
  113. package/node_modules/@oxygen/shared/dist/{research-output-contract.js → tables/research-output-contract.js} +1 -1
  114. package/node_modules/@oxygen/shared/dist/user-capability-routing.js +27 -0
  115. package/node_modules/@oxygen/shared/dist/version.d.ts +1 -1
  116. package/node_modules/@oxygen/shared/dist/version.generated.d.ts +1 -1
  117. package/node_modules/@oxygen/shared/dist/version.generated.js +1 -1
  118. package/node_modules/@oxygen/shared/dist/version.js +1 -1
  119. package/node_modules/@oxygen/shared/dist/visual-render.d.ts +14 -3
  120. package/node_modules/@oxygen/shared/dist/visual-render.js +43 -2
  121. package/node_modules/@oxygen/shared/dist/workflows/workspace-event-catalog.js +3 -3
  122. package/node_modules/@oxygen/shared/dist/workspace-file-storage.d.ts +1 -1
  123. package/node_modules/@oxygen/shared/dist/workspace-file-storage.js +3 -2
  124. package/node_modules/@oxygen/shared/package.json +0 -65
  125. package/node_modules/@oxygen/workflows/dist/recipe-timestamp.d.ts +1 -1
  126. package/node_modules/@oxygen/workflows/dist/recipe-timestamp.js +1 -1
  127. package/package.json +1 -1
  128. /package/node_modules/@oxygen/shared/dist/{billing-anchors.d.ts → billing/anchors.d.ts} +0 -0
  129. /package/node_modules/@oxygen/shared/dist/{billing-anchors.js → billing/anchors.js} +0 -0
  130. /package/node_modules/@oxygen/shared/dist/{billing.d.ts → billing/billing.d.ts} +0 -0
  131. /package/node_modules/@oxygen/shared/dist/{budget-scopes.d.ts → billing/budget-scopes.d.ts} +0 -0
  132. /package/node_modules/@oxygen/shared/dist/{budget-scopes.js → billing/budget-scopes.js} +0 -0
  133. /package/node_modules/@oxygen/shared/dist/{byok-connect.d.ts → billing/byok-connect.d.ts} +0 -0
  134. /package/node_modules/@oxygen/shared/dist/{byok-connect.js → billing/byok-connect.js} +0 -0
  135. /package/node_modules/@oxygen/shared/dist/{cost-estimate-view.d.ts → billing/cost-estimate-view.d.ts} +0 -0
  136. /package/node_modules/@oxygen/shared/dist/{cost-estimate-view.js → billing/cost-estimate-view.js} +0 -0
  137. /package/node_modules/@oxygen/shared/dist/{cost-estimate.d.ts → billing/cost-estimate.d.ts} +0 -0
  138. /package/node_modules/@oxygen/shared/dist/{cost-estimate.js → billing/cost-estimate.js} +0 -0
  139. /package/node_modules/@oxygen/shared/dist/{credit-gate.d.ts → billing/credit-gate.d.ts} +0 -0
  140. /package/node_modules/@oxygen/shared/dist/{credit-gate.js → billing/credit-gate.js} +0 -0
  141. /package/node_modules/@oxygen/shared/dist/{credit-guidance.d.ts → billing/credit-guidance.d.ts} +0 -0
  142. /package/node_modules/@oxygen/shared/dist/{credit-topup-review.d.ts → billing/credit-topup-review.d.ts} +0 -0
  143. /package/node_modules/@oxygen/shared/dist/{credit-topup-review.js → billing/credit-topup-review.js} +0 -0
  144. /package/node_modules/@oxygen/shared/dist/{first-month-offer-window.d.ts → billing/first-month-offer-window.d.ts} +0 -0
  145. /package/node_modules/@oxygen/shared/dist/{first-month-offer-window.js → billing/first-month-offer-window.js} +0 -0
  146. /package/node_modules/@oxygen/shared/dist/{first-month-offer.d.ts → billing/first-month-offer.d.ts} +0 -0
  147. /package/node_modules/@oxygen/shared/dist/{first-month-offer.js → billing/first-month-offer.js} +0 -0
  148. /package/node_modules/@oxygen/shared/dist/{guided-trial-billing.d.ts → billing/guided-trial-billing.d.ts} +0 -0
  149. /package/node_modules/@oxygen/shared/dist/{guided-trial-billing.js → billing/guided-trial-billing.js} +0 -0
  150. /package/node_modules/@oxygen/shared/dist/{billing-money.d.ts → billing/money.d.ts} +0 -0
  151. /package/node_modules/@oxygen/shared/dist/{partner-coupon-bonus.d.ts → billing/partner-coupon-bonus.d.ts} +0 -0
  152. /package/node_modules/@oxygen/shared/dist/{partner-coupon-bonus.js → billing/partner-coupon-bonus.js} +0 -0
  153. /package/node_modules/@oxygen/shared/dist/{plan-capabilities.d.ts → billing/plan-capabilities.d.ts} +0 -0
  154. /package/node_modules/@oxygen/shared/dist/{plan-capabilities.js → billing/plan-capabilities.js} +0 -0
  155. /package/node_modules/@oxygen/shared/dist/{plan-limits-view.d.ts → billing/plan-limits-view.d.ts} +0 -0
  156. /package/node_modules/@oxygen/shared/dist/{plan-limits-view.js → billing/plan-limits-view.js} +0 -0
  157. /package/node_modules/@oxygen/shared/dist/{repricing.d.ts → billing/repricing.d.ts} +0 -0
  158. /package/node_modules/@oxygen/shared/dist/{sending-seat-capacity.d.ts → billing/sending-seat-capacity.d.ts} +0 -0
  159. /package/node_modules/@oxygen/shared/dist/{sending-seat-capacity.js → billing/sending-seat-capacity.js} +0 -0
  160. /package/node_modules/@oxygen/shared/dist/{stripe-price-catalog.d.ts → billing/stripe-price-catalog.d.ts} +0 -0
  161. /package/node_modules/@oxygen/shared/dist/{stripe-price-catalog.js → billing/stripe-price-catalog.js} +0 -0
  162. /package/node_modules/@oxygen/shared/dist/{stripe-subscription-kind.d.ts → billing/stripe-subscription-kind.d.ts} +0 -0
  163. /package/node_modules/@oxygen/shared/dist/{stripe-subscription-kind.js → billing/stripe-subscription-kind.js} +0 -0
  164. /package/node_modules/@oxygen/shared/dist/{copilot-access.d.ts → copilot/access.d.ts} +0 -0
  165. /package/node_modules/@oxygen/shared/dist/{copilot-errors.d.ts → copilot/errors.d.ts} +0 -0
  166. /package/node_modules/@oxygen/shared/dist/{copilot-errors.js → copilot/errors.js} +0 -0
  167. /package/node_modules/@oxygen/shared/dist/{copilot-journeys.d.ts → copilot/journeys.d.ts} +0 -0
  168. /package/node_modules/@oxygen/shared/dist/{copilot-plan.d.ts → copilot/plan.d.ts} +0 -0
  169. /package/node_modules/@oxygen/shared/dist/{copilot-plan.js → copilot/plan.js} +0 -0
  170. /package/node_modules/@oxygen/shared/dist/{copilot-questions.d.ts → copilot/questions.d.ts} +0 -0
  171. /package/node_modules/@oxygen/shared/dist/{copilot-questions.js → copilot/questions.js} +0 -0
  172. /package/node_modules/@oxygen/shared/dist/{knowledge-bases.d.ts → knowledge/bases.d.ts} +0 -0
  173. /package/node_modules/@oxygen/shared/dist/{knowledge-brain-draft.d.ts → knowledge/brain-draft.d.ts} +0 -0
  174. /package/node_modules/@oxygen/shared/dist/{knowledge-brain-draft.js → knowledge/brain-draft.js} +0 -0
  175. /package/node_modules/@oxygen/shared/dist/{knowledge-constants.d.ts → knowledge/constants.d.ts} +0 -0
  176. /package/node_modules/@oxygen/shared/dist/{knowledge-constants.js → knowledge/constants.js} +0 -0
  177. /package/node_modules/@oxygen/shared/dist/{knowledge-links.d.ts → knowledge/links.d.ts} +0 -0
  178. /package/node_modules/@oxygen/shared/dist/{knowledge-markdown.d.ts → knowledge/markdown.d.ts} +0 -0
  179. /package/node_modules/@oxygen/shared/dist/{knowledge-repository.d.ts → knowledge/repository.d.ts} +0 -0
  180. /package/node_modules/@oxygen/shared/dist/{knowledge-seed-content.js → knowledge/seed-content.js} +0 -0
  181. /package/node_modules/@oxygen/shared/dist/{knowledge-vault-markdown.d.ts → knowledge/vault-markdown.d.ts} +0 -0
  182. /package/node_modules/@oxygen/shared/dist/{publishing-approval.d.ts → publishing/approval.d.ts} +0 -0
  183. /package/node_modules/@oxygen/shared/dist/{publishing-limits.d.ts → publishing/limits.d.ts} +0 -0
  184. /package/node_modules/@oxygen/shared/dist/{publishing-limits.js → publishing/limits.js} +0 -0
  185. /package/node_modules/@oxygen/shared/dist/{skill-play-routing.d.ts → recipes/skill-play-routing.d.ts} +0 -0
  186. /package/node_modules/@oxygen/shared/dist/{workspace-skills.d.ts → recipes/workspace-skills.d.ts} +0 -0
  187. /package/node_modules/@oxygen/shared/dist/{network-mining-approval.d.ts → signals/network-mining-approval.d.ts} +0 -0
  188. /package/node_modules/@oxygen/shared/dist/{network-mining-signals.d.ts → signals/network-mining-signals.d.ts} +0 -0
  189. /package/node_modules/@oxygen/shared/dist/{network-mining-signals.js → signals/network-mining-signals.js} +0 -0
  190. /package/node_modules/@oxygen/shared/dist/{network-mining.d.ts → signals/network-mining.d.ts} +0 -0
  191. /package/node_modules/@oxygen/shared/dist/{cell-format.d.ts → tables/cell-format.d.ts} +0 -0
  192. /package/node_modules/@oxygen/shared/dist/{clay-migration-auth-state.d.ts → tables/clay-migration-auth-state.d.ts} +0 -0
  193. /package/node_modules/@oxygen/shared/dist/{clay-migration-auth-state.js → tables/clay-migration-auth-state.js} +0 -0
  194. /package/node_modules/@oxygen/shared/dist/{column-autofill.d.ts → tables/column-autofill.d.ts} +0 -0
  195. /package/node_modules/@oxygen/shared/dist/{column-operation.d.ts → tables/column-operation.d.ts} +0 -0
  196. /package/node_modules/@oxygen/shared/dist/{column-operation.js → tables/column-operation.js} +0 -0
  197. /package/node_modules/@oxygen/shared/dist/{email-verification-batch.d.ts → tables/email-verification-batch.d.ts} +0 -0
  198. /package/node_modules/@oxygen/shared/dist/{email-verification-batch.js → tables/email-verification-batch.js} +0 -0
  199. /package/node_modules/@oxygen/shared/dist/{table-filter-operators.d.ts → tables/filter-operators.d.ts} +0 -0
  200. /package/node_modules/@oxygen/shared/dist/{linkedin-countries.d.ts → tables/linkedin-countries.d.ts} +0 -0
  201. /package/node_modules/@oxygen/shared/dist/{linkedin-countries.js → tables/linkedin-countries.js} +0 -0
  202. /package/node_modules/@oxygen/shared/dist/{linkedin-country-timezones.d.ts → tables/linkedin-country-timezones.d.ts} +0 -0
  203. /package/node_modules/@oxygen/shared/dist/{linkedin-country-timezones.js → tables/linkedin-country-timezones.js} +0 -0
  204. /package/node_modules/@oxygen/shared/dist/{research-depth.d.ts → tables/research-depth.d.ts} +0 -0
  205. /package/node_modules/@oxygen/shared/dist/{research-depth.js → tables/research-depth.js} +0 -0
  206. /package/node_modules/@oxygen/shared/dist/{research-findings.d.ts → tables/research-findings.d.ts} +0 -0
  207. /package/node_modules/@oxygen/shared/dist/{research-output-contract.d.ts → tables/research-output-contract.d.ts} +0 -0
  208. /package/node_modules/@oxygen/shared/dist/{table-run-summary.d.ts → tables/run-summary.d.ts} +0 -0
  209. /package/node_modules/@oxygen/shared/dist/{table-run-summary.js → tables/run-summary.js} +0 -0
package/README.md CHANGED
@@ -34,4 +34,4 @@ oxygen update
34
34
 
35
35
  For product documentation, visit https://oxygen-agent.com/docs. For support, visit https://oxygen-agent.com.
36
36
 
37
- Version: 1.1015.29
37
+ Version: 1.1017.21
@@ -2,7 +2,7 @@ import { readPositiveInt } from "../../cli-values.js";
2
2
  import { readCsvOption, readPositiveNumber, parseJsonArray } from "../../command-support.js";
3
3
  import { readOption, isRecord } from "../../util.js";
4
4
  import { OxygenError } from "@oxygen/shared/cli-result";
5
- import { PUBLIC_WEBHOOK_INGRESS_PER_TARGET_PER_MINUTE } from "@oxygen/shared/plan-band";
5
+ import { PUBLIC_WEBHOOK_INGRESS_PER_TARGET_PER_MINUTE } from "@oxygen/shared/billing/plan-band";
6
6
  // The only numbers on `tables import --help` used to be --batch-size (a
7
7
  // per-request chunk) and the background threshold, so users read 500 as a
8
8
  // per-file cap. Echo the shared row ceiling and the tiered byte ceilings instead
@@ -1,7 +1,7 @@
1
1
  import { readCount } from "../../command-support.js";
2
2
  import { requestOxygen } from "../../http-client.js";
3
3
  import { OxygenError } from "@oxygen/shared/cli-result";
4
- import { MAX_CLI_JSON_BODY_BYTES } from "@oxygen/shared/plan-limits";
4
+ import { MAX_CLI_JSON_BODY_BYTES } from "@oxygen/shared/billing/plan-limits";
5
5
  export async function writeImportBatchWithAutoSplit(input) {
6
6
  const body = {
7
7
  table: input.tableRef,
@@ -5,7 +5,7 @@ import { oxygenAppUrl } from "../../help.js";
5
5
  import { STREAMED_FILE_IMPORT_MIN_BYTES } from "../../streamed-file-import.js";
6
6
  import { OxygenError } from "@oxygen/shared/cli-result";
7
7
  import { MAX_BUFFERED_IMPORT_PARSE_BYTES } from "@oxygen/shared/tables/file-import";
8
- import { PLAN_LIMITS, MAX_CLI_JSON_BODY_BYTES } from "@oxygen/shared/plan-limits";
8
+ import { PLAN_LIMITS, MAX_CLI_JSON_BODY_BYTES } from "@oxygen/shared/billing/plan-limits";
9
9
  import { createHash } from "node:crypto";
10
10
  import { readFileSync } from "node:fs";
11
11
  export const LARGE_IMPORT_BACKGROUND_ROW_THRESHOLD = 500;
@@ -8,7 +8,7 @@ import { OxygenError, success } from "@oxygen/shared/cli-result";
8
8
  import { TABLE_LIST_QUERY_CONTRACT, tableListQueryParams } from "@oxygen/shared/contracts/table-list";
9
9
  import { TABLE_QUERY_GRID_CONTRACT } from "@oxygen/shared/contracts/table-query-grid";
10
10
  import { TABLE_QUERY_CLI_DEFAULT_LIMIT, TABLE_QUERY_CLI_DEFAULT_MAX_CHARS, tableQueryRawResultFits, tableQueryRawRecovery } from "@oxygen/shared/contracts/table-query-raw";
11
- import { FILTER_TREE_OPERATORS } from "@oxygen/shared/table-filter-operators";
11
+ import { FILTER_TREE_OPERATORS } from "@oxygen/shared/tables/filter-operators";
12
12
  import { Command } from "commander";
13
13
  import { handleTablesTidySuggestAction } from "./display.js";
14
14
  import { readSortJsonOption } from "./automation.js";
@@ -39,7 +39,7 @@ export function registerReads({ tablesCommand, handleAsyncAction }) {
39
39
  });
40
40
  }));
41
41
  tablesCommand.addCommand(addContractFlags(new Command("query"), TABLE_QUERY_GRID_CONTRACT, {
42
- format: { valueName: "<format>", help: "Grid cell previews/state: default 50, cap 200, optional stats/fill/window. Omit for raw filters, fields, search, sorts or offsets. JSON cells are null; their digests live in __oxygen_grid_cell_previews. Use tables rows inspect --projection value for complete values." },
42
+ format: { valueName: "<format>", help: "Grid cell previews/state: default 50, cap 200, optional stats/fill/window. Omit for raw filters, fields, search, sorts or offsets. JSON cells are null; their digests (projections for LinkedIn enrichment payloads) live in __oxygen_grid_cell_previews. Use tables rows inspect --projection value for complete values." },
43
43
  max_chars: { help: "Maximum compact JSON envelope characters for raw or grid reads (1,000-100,000). Raw defaults to 12,000." },
44
44
  })
45
45
  .description("Read raw Table rows or --format grid cell previews/state with grid.nextCursor, in a JSON envelope. Use tables preview --summary-only for fill rates; tables export <table> --format table renders raw rows. Grid supports stats/fill/window options and refuses raw selectors.")
@@ -186,6 +186,12 @@ const MUTATING_COMMANDS = new Set([
186
186
  // Runs the isolated renderer and writes its pages back as workspace files. It
187
187
  // is free since 2026-10-14, so no --approved/--max-credits flag reports it.
188
188
  "visuals render-start",
189
+ "visuals source-create",
190
+ "visuals render-preview",
191
+ "visuals render-cancel",
192
+ "visuals asset-upload",
193
+ "visuals asset-upload-prepare",
194
+ "visuals asset-upload-complete",
189
195
  // The plain standup view in an interactive terminal moves the user's Home
190
196
  // "last seen" marker, as a web Home visit does; `--json`, or output that is not
191
197
  // a terminal (an agent's shell, a pipe), is a pure read that leaves it alone
@@ -286,6 +292,9 @@ const ZERO_CREDIT_APPROVAL_COMMANDS = new Set([
286
292
  // `workflows run <id>` gets an existing Workflow run; `workflows call` creates
287
293
  // one. Keep the exception exact so genuine `run` actions remain mutations.
288
294
  const READ_ONLY_COMMANDS = new Set([
295
+ "visuals file-get",
296
+ "visuals render-get",
297
+ "visuals download",
289
298
  "workflows run",
290
299
  // `history` is a mutating verb for `whatsapp history` (it backfills a chat);
291
300
  // these two only read a row's and a cell's recorded changes.
@@ -8,10 +8,10 @@ import { acquireMirrorLock, deletePageFile, emptyMirrorState, findMirrorSlugByPa
8
8
  import { waitForCliRun } from "./run-wait.js";
9
9
  import { redactTranscriptSecrets } from "./transcript.js";
10
10
  import { isRecord, readOption } from "./util.js";
11
- import { formatCellForDisplay } from "@oxygen/shared/cell-format";
11
+ import { formatCellForDisplay } from "@oxygen/shared/tables/cell-format";
12
12
  import { OxygenError, success } from "@oxygen/shared/cli-result";
13
13
  import { COLLAB_SUBJECT_KINDS, SUBJECT_PATH_FORMS_PROSE, formatSubjectPath, parseSubjectPath, parseSubjectRef } from "@oxygen/shared/collab";
14
- import { tableRunSummary } from "@oxygen/shared/table-run-summary";
14
+ import { tableRunSummary } from "@oxygen/shared/tables/run-summary";
15
15
  import { describeWorkflowStatusChange, parseWorkflowStatusChange } from "@oxygen/shared/workflows/status-change";
16
16
  import { createHash } from "node:crypto";
17
17
  import { readFileSync } from "node:fs";
@@ -3,7 +3,7 @@ import { readPositiveNumber } from "../command-support.js";
3
3
  import { requestOxygen } from "../http-client.js";
4
4
  import { readOption } from "../util.js";
5
5
  import { OxygenError } from "@oxygen/shared/cli-result";
6
- import { PUBLIC_WEBHOOK_INGRESS_PER_TARGET_PER_MINUTE } from "@oxygen/shared/plan-band";
6
+ import { PUBLIC_WEBHOOK_INGRESS_PER_TARGET_PER_MINUTE } from "@oxygen/shared/billing/plan-band";
7
7
  import { Command } from "commander";
8
8
  const AGENT_MODEL_POLICY_HELP = "Model policy JSON: level low (Fast), medium (Balanced, default), or high (Max); credential_mode managed or organization_byok.";
9
9
  const AGENT_TOOL_POLICY_HELP = "Tool policy JSON. Effects: read, internal_write, paid, external_write. Ask-before-changes preset: {\"mode\":\"scoped\",\"rules\":[{\"decision\":\"allow\",\"effect\":\"read\"},{\"decision\":\"ask\",\"effect\":\"internal_write\"},{\"decision\":\"ask\",\"effect\":\"paid\"},{\"decision\":\"ask\",\"effect\":\"external_write\"}]}. Full mode requires --confirm-full-access.";
@@ -262,7 +262,7 @@ export function registerAgentFamily(program, handleAsyncAction) {
262
262
  }));
263
263
  }))
264
264
  .addCommand(new Command("files")
265
- .description("List tenant-owned Agent context files.")
265
+ .description("List tenant-owned workspace files, including media, fonts and editable sources.")
266
266
  .option("--limit <n>", "Maximum files (1-500).")
267
267
  .option("--json", "Print a JSON envelope.")
268
268
  .action(async (options) => {
@@ -4,7 +4,7 @@ import { defaultApiUrl } from "../credentials.js";
4
4
  import { oxygenAppUrl } from "../help.js";
5
5
  import { requestOxygen } from "../http-client.js";
6
6
  import { readOption } from "../util.js";
7
- import { PURCHASABLE_PLAN_KEYS, planVolumeBonusPercent, resolveBasePricingPlan } from "@oxygen/shared/billing";
7
+ import { PURCHASABLE_PLAN_KEYS, planVolumeBonusPercent, resolveBasePricingPlan } from "@oxygen/shared/billing/billing";
8
8
  import { CANCELLATION_REASON_VALUES } from "@oxygen/shared/sequences/cancellation-reasons";
9
9
  import { OxygenError } from "@oxygen/shared/cli-result";
10
10
  import { Command, Option } from "commander";
@@ -1,7 +1,7 @@
1
1
  import { readPositiveNumber } from "../command-support.js";
2
2
  import { requestOxygen } from "../http-client.js";
3
3
  import { readOption } from "../util.js";
4
- import { formatPublicBudgetScopes } from "@oxygen/shared/budget-scopes";
4
+ import { formatPublicBudgetScopes } from "@oxygen/shared/billing/budget-scopes";
5
5
  import { Command } from "commander";
6
6
  export function registerBudgetFamily(program, handleAsyncAction) {
7
7
  program
@@ -7,8 +7,8 @@ import { requestOxygen } from "../http-client.js";
7
7
  import { runLocalCustomHttpColumn } from "../local-custom-http-column.js";
8
8
  import { isRecord, readOption } from "../util.js";
9
9
  import { OxygenError } from "@oxygen/shared/cli-result";
10
- import { AI_COLUMN_CREDITS, AI_COLUMN_WEB_SEARCH_TYPICAL_CREDITS } from "@oxygen/shared/pricing-sheet";
11
- import { lookupColumnDataType } from "@oxygen/shared/table-field-types";
10
+ import { AI_COLUMN_CREDITS, AI_COLUMN_WEB_SEARCH_TYPICAL_CREDITS } from "@oxygen/shared/billing/pricing-sheet";
11
+ import { lookupColumnDataType } from "@oxygen/shared/tables/field-types";
12
12
  import { sleep } from "@oxygen/shared/timing";
13
13
  import { Command, Option } from "commander";
14
14
  import { randomUUID } from "node:crypto";
@@ -8,8 +8,8 @@ import { resolveCliBinaryName } from "../runtime.js";
8
8
  import { isRecord, readOption } from "../util.js";
9
9
  import { OxygenError } from "@oxygen/shared/cli-result";
10
10
  import { COPILOT_SESSIONS_LIST_CONTRACT } from "@oxygen/shared/contracts/copilot-sessions";
11
- import { formatCopilotPlanDuration, formatCopilotPlanSeconds, normalizeCopilotPlanStepStatus } from "@oxygen/shared/copilot-plan";
12
- import { COPILOT_ASK_USER_TOOL_NAME, normalizeCopilotQuestions } from "@oxygen/shared/copilot-questions";
11
+ import { formatCopilotPlanDuration, formatCopilotPlanSeconds, normalizeCopilotPlanStepStatus } from "@oxygen/shared/copilot/plan";
12
+ import { COPILOT_ASK_USER_TOOL_NAME, normalizeCopilotQuestions } from "@oxygen/shared/copilot/questions";
13
13
  import { Command, Option } from "commander";
14
14
  import { readFileSync } from "node:fs";
15
15
  import { basename, resolve } from "node:path";
@@ -573,9 +573,15 @@ export function registerCopilotFamily(program, handleAsyncAction) {
573
573
  .argument("<sessionId>", "Copilot session id.")
574
574
  .argument("<approvalId>", "Approval id from the approval_requested event.")
575
575
  .option("--reject", "Reject the action instead of approving it.")
576
+ .option("--body <text>", "Reviewed message body. Requires --expected-args-hash from the approval read.")
577
+ .option("--html <html>", "Reviewed HTML email. Supply --body with it.")
578
+ .option("--expected-args-hash <hash>", "Exact args_hash of the reviewed approval.")
576
579
  .option("--json", "Print a JSON envelope.")
577
580
  .action(async (sessionId, approvalId, options) => {
578
- await handleAsyncAction("copilot approve", options, () => requestOxygen(`/api/cli/copilot/sessions/${encodeURIComponent(sessionId)}/approvals/${encodeURIComponent(approvalId)}`, { method: "POST", body: { decision: options.reject ? "reject" : "approve" } }));
581
+ await handleAsyncAction("copilot approve", options, () => requestOxygen(`/api/cli/copilot/sessions/${encodeURIComponent(sessionId)}/approvals/${encodeURIComponent(approvalId)}`, { method: "POST", body: { decision: options.reject ? "reject" : "approve",
582
+ ...(options.expectedArgsHash ? { expected_args_hash: options.expectedArgsHash } : {}),
583
+ ...(options.body !== undefined || options.html !== undefined ? { edits: { ...(options.body !== undefined ? { body: options.body } : {}), ...(options.html !== undefined ? { html: options.html } : {}) } } : {}),
584
+ } }));
579
585
  }))
580
586
  .addCommand(new Command("interrupt")
581
587
  .description("Stop the turn a Workspace Copilot session is currently working on, leaving the session open for your next message.")
@@ -10,9 +10,9 @@ import { readOption } from "../util.js";
10
10
  import { OxygenError } from "@oxygen/shared/cli-result";
11
11
  import { knowledgeIndexReadContract, knowledgePageReadContract } from "@oxygen/shared/contracts/knowledge-content-reads";
12
12
  import { knowledgeProposalWindowContract } from "@oxygen/shared/contracts/knowledge-proposal-reads";
13
- import { KNOWLEDGE_BOOTSTRAP_MAX_CREDITS } from "@oxygen/shared/knowledge-bootstrap";
14
- import { KNOWLEDGE_PAGE_TYPES } from "@oxygen/shared/knowledge-constants";
15
- import { parseKnowledgePageMarkdown } from "@oxygen/shared/knowledge-markdown";
13
+ import { KNOWLEDGE_BOOTSTRAP_MAX_CREDITS } from "@oxygen/shared/knowledge/bootstrap";
14
+ import { KNOWLEDGE_PAGE_TYPES } from "@oxygen/shared/knowledge/constants";
15
+ import { parseKnowledgePageMarkdown } from "@oxygen/shared/knowledge/markdown";
16
16
  import { Command, Option } from "commander";
17
17
  import { networkMiningHostServed } from "../network-mining-host.js";
18
18
  import { existsSync, readFileSync } from "node:fs";
@@ -4,7 +4,7 @@ import { formatRows, normalizeExportRowsFormat, parseJsonArray, readCsvOption, r
4
4
  import { requestOxygen } from "../http-client.js";
5
5
  import { isRecord, readOption } from "../util.js";
6
6
  import { OxygenError } from "@oxygen/shared/cli-result";
7
- import { tableRunSummary } from "@oxygen/shared/table-run-summary";
7
+ import { tableRunSummary } from "@oxygen/shared/tables/run-summary";
8
8
  import { Command } from "commander";
9
9
  import { writeFileSync } from "node:fs";
10
10
  function readTableRunActions(options) {
@@ -3,7 +3,7 @@ import { requestOxygen } from "../http-client.js";
3
3
  import { isRecord } from "../util.js";
4
4
  import { chunk } from "@oxygen/shared/array-utils";
5
5
  import { OxygenError, exitCodeForOxygenError } from "@oxygen/shared/cli-result";
6
- import { EMAIL_VERIFICATION_LIST_MAX, EMAIL_VERIFICATION_LIVE_PAGE_MAX, leadingEmailVerificationNextAction, summarizeEmailVerificationResults, } from "@oxygen/shared/email-verification-batch";
6
+ import { EMAIL_VERIFICATION_LIST_MAX, EMAIL_VERIFICATION_LIVE_PAGE_MAX, leadingEmailVerificationNextAction, summarizeEmailVerificationResults, } from "@oxygen/shared/tables/email-verification-batch";
7
7
  import { roundCredits } from "@oxygen/shared/spend-safety";
8
8
  import { Command } from "commander";
9
9
  export function registerVerifyFamily(program, handleAsyncAction) {
@@ -38,6 +38,7 @@ const GROUP_PURPOSES = {
38
38
  "onboarding activation": "Resume your dev-pilot activation and its native resources.",
39
39
  };
40
40
  const OPERATION_FLAGS = {
41
+ "copilot history": { session_id: { help: "Oxygent chat.session_id from oxygents get/list." } },
41
42
  "agent session activate": {
42
43
  revision: { help: "Current session revision returned by agent session preview; must match the reviewed configuration." },
43
44
  preview_token: { help: "Exact preview_token from agent session preview, binding reviewed resources, actions, schedule and credit caps. Pass unchanged; --approved is separate. Preview again after changes." },
@@ -2,7 +2,7 @@
2
2
  // pure filesystem state, no network. The mirror stores SERVER-rendered markdown
3
3
  // bytes verbatim: the server renders + hashes every page (content_sha256) and the
4
4
  // client never re-renders, so renderer drift can't mass-quarantine mirrors (see
5
- // packages/shared/src/knowledge-markdown.ts). Layout:
5
+ // packages/shared/src/knowledge/markdown.ts). Layout:
6
6
  //
7
7
  // <configDir>/knowledge/<api-host>/<org-id>/
8
8
  // <slug>.md synced wiki pages (server bytes, 0600)
@@ -1,15 +1,57 @@
1
1
  import { Option } from "commander";
2
2
  import { createHash } from "node:crypto";
3
3
  import { readFileSync, statSync, writeFileSync } from "node:fs";
4
- import { resolve } from "node:path";
4
+ import { resolve, basename } from "node:path";
5
5
  import { OxygenError } from "@oxygen/shared/cli-result";
6
6
  import { requestOxygen } from "./http-client.js";
7
7
  import { waitForVisualRender } from "./visual-render-wait.js";
8
+ function parseJsonOption(value) {
9
+ try {
10
+ return JSON.parse(value);
11
+ }
12
+ catch {
13
+ throw new OxygenError("invalid_input", "Supply valid JSON for composition settings or asset bindings.");
14
+ }
15
+ }
8
16
  export function registerVisualCommands(program, handle) {
9
- const visuals = program.command("visuals").description("Author, render, inspect and download GTM infographics using tenant workspace files and governed render jobs.");
10
- visuals.command("source-create").description("Save an immutable HTML/CSS/SVG source revision; no code executes.")
17
+ const visuals = program.command("visuals").description("Create editable graphics and short videos with workspace fonts, media and reusable components; render, inspect and download.");
18
+ visuals.command("asset-upload").description("Upload an image, font, media clip or reusable component directly to private workspace storage (max 100 MiB); no code executes.")
19
+ .requiredOption("--file <path>", "Local asset file.").option("--resume-file-id <id>", "Resume the same file reservation after an interrupted transfer.").option("--name <name>", "Stored filename, defaults to the local basename.").option("--json", "Print a JSON envelope.")
20
+ .action((options) => handle("visuals asset upload", options, async () => {
21
+ if (statSync(options.file).size > 100 * 1024 * 1024)
22
+ throw new OxygenError("workspace_file_too_large", "Asset must fit within 100 MiB.");
23
+ const bytes = readFileSync(options.file);
24
+ if (bytes.length > 100 * 1024 * 1024)
25
+ throw new OxygenError("workspace_file_too_large", "Asset must fit within 100 MiB.");
26
+ const ticket = await requestOxygen("/api/cli/visuals/assets", {
27
+ method: "POST", body: { action: options.resumeFileId ? "resume" : "prepare", ...(options.resumeFileId ? { file_id: options.resumeFileId } : {}), name: options.name ?? basename(options.file), size_bytes: bytes.length, sha256: createHash("sha256").update(bytes).digest("hex") },
28
+ });
29
+ if (ticket?.already_uploaded && ticket.file?.status === "ready")
30
+ return { file: ticket.file, already_uploaded: true };
31
+ if (!ticket || typeof ticket.file?.id !== "string" || typeof ticket.upload_url !== "string" || typeof ticket.upload_content_type !== "string") {
32
+ throw new OxygenError("invalid_response", "The asset upload reservation did not return a transfer URL and file ID.");
33
+ }
34
+ const response = await fetch(ticket.upload_url, { method: "PUT", headers: { "content-type": ticket.upload_content_type }, body: new Uint8Array(bytes), signal: AbortSignal.timeout(300_000), redirect: "error" }).catch(() => {
35
+ throw new OxygenError("media_asset_upload_failed", "The transfer outcome is unknown. Try asset-upload-complete first, or upload the same file with --resume-file-id using this file_id.", { details: { file_id: ticket.file.id } });
36
+ });
37
+ if (!response.ok)
38
+ throw new OxygenError("media_asset_upload_failed", "The asset upload did not complete. Retry the original file with --resume-file-id using this file_id.", { details: { file_id: ticket.file.id, status: response.status } });
39
+ return requestOxygen("/api/cli/visuals/assets", { method: "POST", body: { action: "complete", file_id: ticket.file.id } }).catch((error) => {
40
+ const failure = error instanceof OxygenError ? error : new OxygenError("media_asset_completion_unconfirmed", "File verification was not confirmed.");
41
+ throw new OxygenError(failure.code, `${failure.message} Retry the same file with --resume-file-id using this file_id.`, { details: { file_id: ticket.file.id } });
42
+ });
43
+ }));
44
+ visuals.command("asset-upload-prepare").description("Reserve an asset upload and return a short-lived private PUT URL.")
45
+ .option("--resume-file-id <id>", "Refresh a pending reservation instead of creating one.").requiredOption("--name <name>", "Asset filename.").requiredOption("--size-bytes <n>", "Exact byte length, at most 100 MiB.")
46
+ .requiredOption("--sha256 <hash>", "SHA-256 of original bytes.").option("--json", "Print a JSON envelope.")
47
+ .action((options) => handle("visuals asset upload prepare", options, () => requestOxygen("/api/cli/visuals/assets", { method: "POST", body: { action: options.resumeFileId ? "resume" : "prepare", ...(options.resumeFileId ? { file_id: options.resumeFileId } : {}), name: options.name, size_bytes: Number(options.sizeBytes), sha256: options.sha256 } })));
48
+ visuals.command("asset-upload-complete <file-id>").description("Verify a direct upload's original bytes against its reservation and make the asset ready.").option("--json", "Print a JSON envelope.")
49
+ .action((id, options) => handle("visuals asset upload complete", options, () => requestOxygen("/api/cli/visuals/assets", { method: "POST", body: { action: "complete", file_id: id } })));
50
+ visuals.command("source-create").description("Save an immutable HTML composition or reusable CSS/JavaScript/JSON component; no code executes.")
11
51
  .requiredOption("--name <name>", "Workspace filename.")
12
52
  .requiredOption("--file <path>", "Local HTML source file (max 1.5 MB).")
53
+ .option("--composition-json <json>", "Layout, output, timing and asset bindings saved with the HTML revision.")
54
+ .option("--source-type <type>", "html (default), css, javascript or json.")
13
55
  .option("--parent-file-id <id>", "Previous source revision UUID.").option("--json", "Print a JSON envelope.")
14
56
  .action((options) => handle("visuals source create", options, async () => {
15
57
  if (statSync(options.file).size > 1_500_000)
@@ -17,7 +59,7 @@ export function registerVisualCommands(program, handle) {
17
59
  const bytes = readFileSync(options.file);
18
60
  if (bytes.length > 1_500_000)
19
61
  throw new OxygenError("visual_source_limit", "HTML source must fit within 1.5 MB.");
20
- return requestOxygen("/api/cli/visuals/sources", { method: "POST", body: { name: options.name, html: bytes.toString("utf8"), ...(options.parentFileId ? { parent_file_id: options.parentFileId } : {}) } });
62
+ return requestOxygen("/api/cli/visuals/sources", { method: "POST", body: { name: options.name, html: bytes.toString("utf8"), ...(options.compositionJson ? { composition: parseJsonOption(options.compositionJson) } : {}), ...(options.parentFileId ? { parent_file_id: options.parentFileId } : {}), ...(options.sourceType ? { source_type: options.sourceType } : {}) } });
21
63
  }));
22
64
  visuals.command("file-get <file-id>").description("Read source, file metadata, provenance and web/download links.").option("--json", "Print a JSON envelope.")
23
65
  .action((id, options) => handle("visuals file get", options, () => requestOxygen(`/api/cli/visuals/files/${encodeURIComponent(id)}`)));
@@ -32,12 +74,19 @@ export function registerVisualCommands(program, handle) {
32
74
  writeFileSync(options.out, bytes, { flag: "wx", mode: 0o600 });
33
75
  return { path: resolve(options.out), ...data.file };
34
76
  }));
35
- visuals.command("render-preview").description("Preview rendering without starting compute; rendering is free.")
77
+ visuals.command("render-preview").description("Save a render preview record and exact scope hash; 0 credits, no compute.")
36
78
  .requiredOption("--source-file-ids <ids>", "Comma-separated HTML file UUIDs in page order.")
37
- .option("--width <pixels>", "CSS pixel width.", "1080").option("--height <pixels>", "CSS pixel height.", "1350")
38
- .option("--scale <1|2>", "PNG scale.", "1").option("--formats <png,pdf>", "Output formats.", "png")
79
+ .option("--width <pixels>", "CSS pixel width; static defaults to 1080, motion to 720.").option("--height <pixels>", "CSS pixel height; static defaults to 1350, motion to 1280.")
80
+ .option("--scale <1|2>", "PNG scale.").option("--formats <formats>", "png,pdf for static, mp4 for hyperframes.")
81
+ .option("--render-profile <profile>", "static (default) or hyperframes; independent of the CLI login profile.")
82
+ .option("--assets-json <json>", "Asset bindings: [{file_id,path}], resolved and hash-bound by preview.")
83
+ .option("--fps <n>", "Motion frame rate: 24 (default) or 30.").option("--duration <seconds>", "Motion duration up to 10 seconds; default 5.")
39
84
  .option("--json", "Print a JSON envelope.")
40
- .action((options) => handle("visuals render preview", options, () => requestOxygen("/api/cli/visuals/renders", { method: "POST", body: { source_file_ids: options.sourceFileIds.split(",").map((s) => s.trim()), width: Number(options.width), height: Number(options.height), scale: Number(options.scale), formats: options.formats.split(",") } })));
85
+ .action((options) => handle("visuals render preview", options, () => requestOxygen("/api/cli/visuals/renders", { method: "POST", body: { source_file_ids: options.sourceFileIds.split(",").map((s) => s.trim()),
86
+ width: Number(options.width ?? (options.renderProfile === "hyperframes" ? 720 : 1080)), height: Number(options.height ?? (options.renderProfile === "hyperframes" ? 1280 : 1350)),
87
+ ...(options.scale ? { scale: Number(options.scale) } : {}), ...(options.formats ? { formats: options.formats.split(",") } : {}),
88
+ ...(options.renderProfile ? { profile: options.renderProfile } : {}), ...(options.assetsJson ? { assets: parseJsonOption(options.assetsJson) } : {}),
89
+ ...(options.fps ? { fps: Number(options.fps) } : {}), ...(options.duration ? { duration: Number(options.duration) } : {}) } })));
41
90
  visuals.command("render-start <render-id>").description("Start an exact preview as one idempotent render job; rendering is free.")
42
91
  .requiredOption("--scope-hash <hash>", "Exact preview scope hash.")
43
92
  // Rendering became free on 2026-10-14; the approval flags it needed are retired.
@@ -1,5 +1,5 @@
1
1
  import { Command } from "commander";
2
- import { type WorkspaceSkillFile } from "@oxygen/shared/workspace-skills";
2
+ import { type WorkspaceSkillFile } from "@oxygen/shared/recipes/workspace-skills";
3
3
  /** Never follow symlinks or read binary files out of a local skill folder. */
4
4
  export declare function readWorkspaceSkillDirectory(directory: string): Promise<WorkspaceSkillFile[]>;
5
5
  type Handle = (command: string, options: {
@@ -2,7 +2,7 @@ import { lstat, readdir, readFile } from "node:fs/promises";
2
2
  import { join, resolve } from "node:path";
3
3
  import { OxygenError } from "@oxygen/shared/cli-result";
4
4
  import { WORKSPACE_SKILL_OPERATIONS } from "@oxygen/shared/contracts/workspace-skills";
5
- import { authorWorkspaceSkill, parseWorkspaceSkillBundle, WORKSPACE_SKILL_MAX_BYTES, WORKSPACE_SKILL_MAX_FILES, WORKSPACE_SKILL_MAX_FILE_BYTES, } from "@oxygen/shared/workspace-skills";
5
+ import { authorWorkspaceSkill, parseWorkspaceSkillBundle, WORKSPACE_SKILL_MAX_BYTES, WORKSPACE_SKILL_MAX_FILES, WORKSPACE_SKILL_MAX_FILE_BYTES, } from "@oxygen/shared/recipes/workspace-skills";
6
6
  import { requestOxygen } from "./http-client.js";
7
7
  /** Never follow symlinks or read binary files out of a local skill folder. */
8
8
  export async function readWorkspaceSkillDirectory(directory) {
@@ -64,6 +64,13 @@ export declare function validateFormulaRegexLiterals(ast: FormulaAst): void;
64
64
  * reading; only a new write is refused, with the concat form to use instead.
65
65
  */
66
66
  export declare function validateFormulaTextJoin(expression: string): void;
67
+ /**
68
+ * SAVE-TIME ONLY, like validateFormulaTextJoin: refuse a text literal as an
69
+ * arithmetic operand. `+ - * / %` read both sides as numbers, so
70
+ * `"https://" + website` parses and stores, then fails on every row and the
71
+ * column reads null. A literal that reads as a number ("42") stays allowed.
72
+ */
73
+ export declare function validateFormulaArithmeticText(expression: string): void;
67
74
  /** Validate syntax, supported functions, and arity without evaluating any data. */
68
75
  export declare function validateFormulaExpression(expression: string, options?: ParseOptions): void;
69
76
  export declare function walkExpression(node: FormulaAst, visit: (node: FormulaAst) => void): void;
@@ -1,4 +1,4 @@
1
- import { FORMULA_FUNCTION_REGISTRY, MAX_FORMULA_REGEX_PATTERN_LENGTH, checkFormulaFunctionArity, formulaExpressionError, unsupportedFormulaFunctionError, } from "./formula-functions.js";
1
+ import { FORMULA_FUNCTION_REGISTRY, MAX_FORMULA_REGEX_PATTERN_LENGTH, checkFormulaFunctionArity, formulaExpressionError, isFormulaNumericText, unsupportedFormulaFunctionError, } from "./formula-functions.js";
2
2
  /**
3
3
  * Functions evaluated against the whole column rather than the current scope.
4
4
  * They are intercepted before registry dispatch (the registry entry carries
@@ -94,6 +94,34 @@ export function validateFormulaTextJoin(expression) {
94
94
  throw formulaExpressionError("|| is logical or in formulas, not text joining; join text with concat(first_name, \" \", last_name).", { position: token.position, expression, hint: "Use concat(a, b, ...) to join text; || and or compare truth values." });
95
95
  });
96
96
  }
97
+ const ARITHMETIC_OPERATORS = new Set(["+", "-", "*", "/", "%"]);
98
+ /**
99
+ * SAVE-TIME ONLY, like validateFormulaTextJoin: refuse a text literal as an
100
+ * arithmetic operand. `+ - * / %` read both sides as numbers, so
101
+ * `"https://" + website` parses and stores, then fails on every row and the
102
+ * column reads null. A literal that reads as a number ("42") stays allowed.
103
+ */
104
+ export function validateFormulaArithmeticText(expression) {
105
+ walkExpression(parseFormulaExpression(expression), (node) => {
106
+ // Unary operators are + - and not, so this keeps unary + and - too.
107
+ if ((node.type !== "binary" && node.type !== "unary") || !ARITHMETIC_OPERATORS.has(node.operator))
108
+ return;
109
+ for (const operand of node.type === "binary" ? [node.left, node.right] : [node.argument]) {
110
+ if (operand.type !== "literal" || typeof operand.value !== "string")
111
+ continue;
112
+ if (isFormulaNumericText(operand.value))
113
+ continue;
114
+ throw formulaExpressionError(node.operator === "+"
115
+ ? "+ adds numbers in formulas; join text with concat(\"https://\", website)."
116
+ : `${node.operator} works on numbers in formulas, and ${JSON.stringify(operand.value)} is not a number.`, {
117
+ operator: node.operator,
118
+ value: operand.value,
119
+ expression,
120
+ hint: "+ - * / % take numbers or numeric text; use concat(a, b, ...) to join text.",
121
+ });
122
+ }
123
+ });
124
+ }
97
125
  /** Validate syntax, supported functions, and arity without evaluating any data. */
98
126
  export function validateFormulaExpression(expression, options = {}) {
99
127
  validateFormulaAst(parseFormulaExpression(expression, options));
@@ -42,6 +42,8 @@ export declare const MAX_FORMULA_REGEX_INPUT_LENGTH = 20000;
42
42
  export declare function formulaExpressionError(message: string, details: Record<string, unknown>): OxygenError;
43
43
  export declare function isBlankFormulaValue(value: unknown): boolean;
44
44
  export declare function stringifyFormulaValue(value: unknown): string;
45
+ /** Text that arithmetic reads as a number: non-blank and finite ("42", " 1e3 "). */
46
+ export declare function isFormulaNumericText(value: string): boolean;
45
47
  export declare function readFormulaNumber(value: unknown, operator: string): number;
46
48
  export declare function toFormulaBoolean(value: unknown): boolean;
47
49
  export declare function compareFormulaValues(left: unknown, right: unknown): number;
@@ -1,6 +1,6 @@
1
1
  import { OxygenError } from "@oxygen/shared/cli-result";
2
2
  import { walkJsonPath } from "@oxygen/shared/json-path";
3
- import { resolveLinkedInCountry } from "@oxygen/shared/linkedin-countries";
3
+ import { resolveLinkedInCountry } from "@oxygen/shared/tables/linkedin-countries";
4
4
  import { md5Hex, sha256Hex } from "./hash.js";
5
5
  import { normalizeDomain, normalizeEmail, normalizeLinkedinUrl, } from "./value-normalizers.js";
6
6
  import { classifyEmailType, cleanJobTitle, normalizeCompanyName, splitDelimitedList, } from "./value-cleaners.js";
@@ -42,10 +42,14 @@ export function stringifyFormulaValue(value) {
42
42
  return String(value);
43
43
  return JSON.stringify(value);
44
44
  }
45
+ /** Text that arithmetic reads as a number: non-blank and finite ("42", " 1e3 "). */
46
+ export function isFormulaNumericText(value) {
47
+ return value.trim().length > 0 && Number.isFinite(Number(value));
48
+ }
45
49
  export function readFormulaNumber(value, operator) {
46
50
  if (typeof value === "number" && Number.isFinite(value))
47
51
  return value;
48
- if (typeof value === "string" && value.trim() && Number.isFinite(Number(value))) {
52
+ if (typeof value === "string" && isFormulaNumericText(value)) {
49
53
  return Number(value);
50
54
  }
51
55
  throw formulaExpressionError("Formula numeric operation requires numeric values.", {
@@ -1,4 +1,4 @@
1
- import { networkMiningEnabled } from "../network-mining.js";
1
+ import { networkMiningEnabled } from "../signals/network-mining.js";
2
2
  /** Dev reply testing: a model may prepare replies, but cannot approve a batch. */
3
3
  export const REPLY_OXYGENT_TEMPLATE = "reply";
4
4
  export const REPLY_BATCH_DEFAULT_SIZE = 10;
@@ -1,11 +1,11 @@
1
1
  import { agentsEnabled, agentsEnabledIn } from "../agents-enabled.js";
2
2
  import { guidedActivationEnabled } from "../onboarding/guided-activation.js";
3
- import { networkMiningEnabled } from "../network-mining.js";
3
+ import { networkMiningEnabled } from "../signals/network-mining.js";
4
4
  import { validateContract } from "../contracts/schema.js";
5
5
  import { GUIDED_ACTIVATION_SCAN_POLICY_CONTRACT } from "../contracts/guided-activation.js";
6
6
  import { isStaffEmail } from "../staff.js";
7
7
  import { OxygenError } from "../cli-result.js";
8
- import { RESEARCH_FINDING_ACTIVITY_TYPE } from "../research-findings.js";
8
+ import { RESEARCH_FINDING_ACTIVITY_TYPE } from "../tables/research-findings.js";
9
9
  import { servedWorkspaceEventCatalog, WORKSPACE_EVENT_CATALOG } from "../workflows/workspace-event-catalog.js";
10
10
  import { agentSessionScheduleProblem } from "./session-schedule.js";
11
11
  /** The routine marker of a session's settings, or null for a general session. */
@@ -1,9 +1,9 @@
1
- import { CREDITS_PER_USD as SNAPSHOT_CREDITS_PER_USD, PRICING_PLAN_SNAPSHOT, MANAGED_INBOX_CREDITS_PER_MONTH as SNAPSHOT_MANAGED_MAILBOX_CREDITS_PER_MONTH, SENDING_MAILBOX_CREDITS_PER_MONTH as SNAPSHOT_SENDING_MAILBOX_CREDITS_PER_MONTH, SENDING_ENTRA_MAILBOX_CREDITS_PER_MONTH, } from "./pricing-snapshot.generated.js";
2
- import { isEntraMailbox } from "./mailboxes/email-infrastructure-policy.js";
3
- import { currentSubscriptionGrantSlice, dueSubscriptionGrantSlices, } from "./billing-anchors.js";
1
+ import { CREDITS_PER_USD as SNAPSHOT_CREDITS_PER_USD, PRICING_PLAN_SNAPSHOT, MANAGED_INBOX_CREDITS_PER_MONTH as SNAPSHOT_MANAGED_MAILBOX_CREDITS_PER_MONTH, SENDING_MAILBOX_CREDITS_PER_MONTH as SNAPSHOT_SENDING_MAILBOX_CREDITS_PER_MONTH, SENDING_ENTRA_MAILBOX_CREDITS_PER_MONTH, } from "../pricing-snapshot.generated.js";
2
+ import { isEntraMailbox } from "../mailboxes/email-infrastructure-policy.js";
3
+ import { currentSubscriptionGrantSlice, dueSubscriptionGrantSlices, } from "./anchors.js";
4
4
  import { freeTierEntitlementEnabled } from "./plan-capabilities.js";
5
5
  import { AUTOMATION_STEP_CREDITS_REPRICING, AUTOMATION_STEPS_COUNT_TOWARD_RUN_CAP_REPRICING, isRepricingInForce, BYOK_PLATFORM_FEE_REPRICING, OXYGEN_49_BYOK_REPRICING, repricedValue, TOPUP_RATE_REPRICING, } from "./repricing.js";
6
- import { asRecordOrNull } from "./type-guards.js";
6
+ import { asRecordOrNull } from "../type-guards.js";
7
7
  export const WEEKLY_USAGE_WINDOW_DAYS = 7;
8
8
  export const BILLING_CURRENCIES = ["usd"];
9
9
  export const DEFAULT_BILLING_CURRENCY = "usd";
@@ -1,4 +1,4 @@
1
- import { normalizeQuotedCredits, roundQuotedCredits } from "./billing-money.js";
1
+ import { normalizeQuotedCredits, roundQuotedCredits } from "./money.js";
2
2
  const DEFAULT_HEADROOM_MULTIPLIER = 1.25;
3
3
  /**
4
4
  * Size a ceiling from the EXPECTED cost plus a variance band, rather than from
@@ -1,4 +1,4 @@
1
- import { OxygenError } from "./cli-result.js";
1
+ import { OxygenError } from "../cli-result.js";
2
2
  /** Milli-credit amounts shared by quoting and ledger settlement. Rounding policies
3
3
  * are deliberately distinct: a positive hold rounds up, a quote rounds nearest,
4
4
  * and persisted usage keeps its historical decimal rounding. */
@@ -1,6 +1,6 @@
1
1
  import { type LimitsTier } from "./plan-limits.js";
2
2
  import { type RepricingOptions } from "./repricing.js";
3
- import { type WorkspaceTableCapacityStatus } from "./tables/capacity.js";
3
+ import { type WorkspaceTableCapacityStatus } from "../tables/capacity.js";
4
4
  /**
5
5
  * The seven plan bands of the 2026-09 repricing (spec § 4, slice S06): free
6
6
  * plus one band per Oxygen plan size. They sit BESIDE the five-rung
@@ -1,8 +1,8 @@
1
1
  import { planVolumeBonusCredits, planVolumeBonusPercent, resolveBasePricingPlan } from "./billing.js";
2
2
  import { planLimitsForTier, limitsTierForPlanTier, resolveCronMinIntervalMinutes, resolvePlanAgentCreditLimits, } from "./plan-limits.js";
3
- import { COPILOT_ATTENDED_INFERENCE_CREDIT_CEILING, DEFAULT_AUTO_RUN_BATCH_CREDIT_CEILING, DEFAULT_BYOK_COLUMN_RUN_MAX_ROWS, DEFAULT_BYOK_PROVIDER_DAILY_CALL_CAP, DEFAULT_TRIGGER_RUN_CREDIT_CEILING, copilotApprovalFreeAllowanceForBand, resolveOrgDailySpendGuard, resolveSpendSafetyPlanTier, } from "./spend-safety.js";
3
+ import { COPILOT_ATTENDED_INFERENCE_CREDIT_CEILING, DEFAULT_AUTO_RUN_BATCH_CREDIT_CEILING, DEFAULT_BYOK_COLUMN_RUN_MAX_ROWS, DEFAULT_BYOK_PROVIDER_DAILY_CALL_CAP, DEFAULT_TRIGGER_RUN_CREDIT_CEILING, copilotApprovalFreeAllowanceForBand, resolveOrgDailySpendGuard, resolveSpendSafetyPlanTier, } from "../spend-safety.js";
4
4
  import { isRepricingInForce, tenthOfMonthlyCreditsRoundedHalfUp, } from "./repricing.js";
5
- import { describeWorkspaceTableCapacityStatus, resolveWorkspaceTableCapacity, } from "./tables/capacity.js";
5
+ import { describeWorkspaceTableCapacityStatus, resolveWorkspaceTableCapacity, } from "../tables/capacity.js";
6
6
  export const PLAN_BAND_ORDER = [
7
7
  "free",
8
8
  "49",
@@ -1,5 +1,5 @@
1
1
  import { type RepricingOptions } from "./repricing.js";
2
- export { CONNECTION_CEILING_ABOVE_DEFAULT_APPROVAL_KIND } from "./connection-approval.js";
2
+ export { CONNECTION_CEILING_ABOVE_DEFAULT_APPROVAL_KIND } from "../connection-approval.js";
3
3
  /**
4
4
  * The five enforcement rungs of the per-plan limits ladder. Every PlanTier maps
5
5
  * onto exactly one rung: "free" doubles as the unentitled fallback (no live
@@ -104,7 +104,7 @@ export type PlanLimits = {
104
104
  * capacity and the workspace-wide envelope.
105
105
  */
106
106
  export declare const TABLE_IMPORT_ROW_LIMIT: number;
107
- export { VERCEL_REQUEST_BODY_LIMIT_BYTES } from "./tables/import-limits.js";
107
+ export { VERCEL_REQUEST_BODY_LIMIT_BYTES } from "../tables/import-limits.js";
108
108
  /**
109
109
  * OXYGEN's own JSON-body ceiling for every `/api/cli/*` route (enforced by
110
110
  * `assertCliJsonBodyWithinLimit` on the content-length header). Shared so the CLI
@@ -1,9 +1,9 @@
1
1
  import { resolveBasePricingPlan } from "./billing.js";
2
- import { OxygenError } from "./cli-result.js";
3
- import { WORKSPACE_TABLE_CAPACITY } from "./tables/capacity.js";
2
+ import { OxygenError } from "../cli-result.js";
3
+ import { WORKSPACE_TABLE_CAPACITY } from "../tables/capacity.js";
4
4
  import { findRepricedValue, repricedValue } from "./repricing.js";
5
- import { CONNECTION_CEILING_ABOVE_DEFAULT_APPROVAL_KIND } from "./connection-approval.js";
6
- export { CONNECTION_CEILING_ABOVE_DEFAULT_APPROVAL_KIND } from "./connection-approval.js";
5
+ import { CONNECTION_CEILING_ABOVE_DEFAULT_APPROVAL_KIND } from "../connection-approval.js";
6
+ export { CONNECTION_CEILING_ABOVE_DEFAULT_APPROVAL_KIND } from "../connection-approval.js";
7
7
  export const LIMITS_TIER_ORDER = [
8
8
  "free",
9
9
  "starter",
@@ -26,7 +26,7 @@ export const TABLE_IMPORT_ROW_LIMIT = WORKSPACE_TABLE_CAPACITY.tableRowLimit;
26
26
  // The platform request-body ceiling belongs to the same question as the import
27
27
  // ceilings below ("how big can an import be"), but it must stay importable from a
28
28
  // browser bundle, so it is defined in ./tables/import-limits and re-exported here.
29
- export { VERCEL_REQUEST_BODY_LIMIT_BYTES } from "./tables/import-limits.js";
29
+ export { VERCEL_REQUEST_BODY_LIMIT_BYTES } from "../tables/import-limits.js";
30
30
  /**
31
31
  * OXYGEN's own JSON-body ceiling for every `/api/cli/*` route (enforced by
32
32
  * `assertCliJsonBodyWithinLimit` on the content-length header). Shared so the CLI