vespin 0.1.0 → 0.2.0

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/vespin.mjs CHANGED
@@ -17235,7 +17235,7 @@ var fromTransformBracket = (f) => fromTransform(fnUntraced2(function* (upstream,
17235
17235
  const pull = yield* onError2(f(upstream, scope3, closableScope), onCause);
17236
17236
  return onError2(pull, onCause);
17237
17237
  }));
17238
- var toTransform = (channel) => channel.transform;
17238
+ var toTransform = (channel2) => channel2.transform;
17239
17239
  var DefaultChunkSize = 4096;
17240
17240
  var asyncQueue = (scope3, f, options2) => make16({
17241
17241
  capacity: options2?.bufferSize,
@@ -17730,9 +17730,9 @@ var mergeAll3 = /* @__PURE__ */ dual(2, (channels, {
17730
17730
  yield* raceFirst2(semaphore.take(1), andThen4(join(pullFiber), never2));
17731
17731
  }
17732
17732
  }
17733
- const channel = pullFiber === void 0 ? yield* pull : yield* join(pullFiber);
17733
+ const channel2 = pullFiber === void 0 ? yield* pull : yield* join(pullFiber);
17734
17734
  const childScope = forkUnsafe2(forkedScope);
17735
- const childPull = yield* toTransform(channel)(upstream, childScope);
17735
+ const childPull = yield* toTransform(channel2)(upstream, childScope);
17736
17736
  while (fibers.size >= concurrencyN) {
17737
17737
  const fiber4 = headUnsafe(fibers);
17738
17738
  fibers.delete(fiber4);
@@ -17786,7 +17786,7 @@ var merge4 = /* @__PURE__ */ dual((args2) => isChannel(args2[0]) && isChannel(ar
17786
17786
  }
17787
17787
  }
17788
17788
  }
17789
- const runSide = (side, channel, scope3) => toTransform(channel)(upstream, scope3).pipe(flatMap5((pull) => pull.pipe(flatMap5((value4) => offer(queue, value4)), forever4)), onError2((cause) => onExitPrimitive2(doneExitFromCause(cause), (exit3) => close(scope3, exit3)).pipe(matchCauseEffect2({
17789
+ const runSide = (side, channel2, scope3) => toTransform(channel2)(upstream, scope3).pipe(flatMap5((pull) => pull.pipe(flatMap5((value4) => offer(queue, value4)), forever4)), onError2((cause) => onExitPrimitive2(doneExitFromCause(cause), (exit3) => close(scope3, exit3)).pipe(matchCauseEffect2({
17790
17790
  onFailure: (cause2) => onExit5(side, cause2),
17791
17791
  onSuccess: () => onExit5(side, cause)
17792
17792
  }))), forkIn2(forkedScope));
@@ -17877,11 +17877,11 @@ var pipeToOrFail = /* @__PURE__ */ dual(2, (self, that) => fromTransform((upstre
17877
17877
  const upstreamPull = catchCause3(upstream2, (cause) => isDoneCause(cause) ? failCause4(cause) : die5(Done2(cause)));
17878
17878
  return map9(toTransform(that)(upstreamPull, scope3), (pull) => catchDefect2(pull, (defect) => isDone3(defect) ? failCause4(defect.value) : die5(defect)));
17879
17879
  })));
17880
- var unwrap2 = (channel) => fromTransform((upstream, scope3) => {
17880
+ var unwrap2 = (channel2) => fromTransform((upstream, scope3) => {
17881
17881
  let pull;
17882
17882
  return succeed7(suspend3(() => {
17883
17883
  if (pull) return pull;
17884
- return channel.pipe(provide(scope3), flatMap5((channel2) => toTransform(channel2)(upstream, scope3)), flatMap5((pull_) => pull = pull_));
17884
+ return channel2.pipe(provide(scope3), flatMap5((channel3) => toTransform(channel3)(upstream, scope3)), flatMap5((pull_) => pull = pull_));
17885
17885
  }));
17886
17886
  });
17887
17887
  var scoped3 = (self) => fromTransformBracket((upstream, scope3, forkedScope) => map9(provide(toTransform(self)(upstream, scope3), forkedScope), provide(forkedScope)));
@@ -18086,8 +18086,8 @@ var streamVariance = {
18086
18086
  _E: identity,
18087
18087
  _A: identity
18088
18088
  };
18089
- var Stream = function(channel) {
18090
- this.channel = channel;
18089
+ var Stream = function(channel2) {
18090
+ this.channel = channel2;
18091
18091
  };
18092
18092
  Stream.prototype = {
18093
18093
  [TypeId24]: streamVariance,
@@ -18095,7 +18095,7 @@ Stream.prototype = {
18095
18095
  return pipeArguments(this, arguments);
18096
18096
  }
18097
18097
  };
18098
- var fromChannel = (channel) => new Stream(channel);
18098
+ var fromChannel = (channel2) => new Stream(channel2);
18099
18099
 
18100
18100
  // ../../node_modules/.pnpm/effect@4.0.4/node_modules/effect/dist/Sink.js
18101
18101
  var TypeId25 = "~effect/Sink";
@@ -18114,7 +18114,7 @@ var SinkProto = {
18114
18114
  }
18115
18115
  };
18116
18116
  var isSink = (u) => hasProperty(u, TypeId25);
18117
- var fromChannel2 = (channel) => fromTransform2((upstream, scope3) => toTransform(channel)(upstream, scope3).pipe(flatMap5(forever4({
18117
+ var fromChannel2 = (channel2) => fromTransform2((upstream, scope3) => toTransform(channel2)(upstream, scope3).pipe(flatMap5(forever4({
18118
18118
  disableYield: true
18119
18119
  })), catchDone(succeed7)));
18120
18120
  var fromTransform2 = (transform5) => {
@@ -19939,8 +19939,8 @@ var share = /* @__PURE__ */ dual(2, (self, options2) => map9(make20({
19939
19939
  acquire: broadcast(self, options2),
19940
19940
  idleTimeToLive: options2.idleTimeToLive
19941
19941
  }), (ref2) => unwrap4(get6(ref2))));
19942
- var pipeThroughChannel = /* @__PURE__ */ dual(2, (self, channel) => fromChannel3(pipeTo(self.channel, channel)));
19943
- var pipeThroughChannelOrFail = /* @__PURE__ */ dual(2, (self, channel) => fromChannel3(pipeToOrFail(self.channel, channel)));
19942
+ var pipeThroughChannel = /* @__PURE__ */ dual(2, (self, channel2) => fromChannel3(pipeTo(self.channel, channel2)));
19943
+ var pipeThroughChannelOrFail = /* @__PURE__ */ dual(2, (self, channel2) => fromChannel3(pipeToOrFail(self.channel, channel2)));
19944
19944
  var pipeThrough = /* @__PURE__ */ dual(2, (self, sink) => self.channel.pipe(pipeToOrFail(toChannel(sink)), concatWith(([_, leftover]) => leftover ? succeed8(leftover) : empty7), fromChannel3));
19945
19945
  var collect = (self) => fromEffect2(runCollect(self));
19946
19946
  var accumulate = (self) => mapAccumArray(self, empty2, (acc, as5) => {
@@ -37876,13 +37876,13 @@ var FileImpl = class extends PartBase {
37876
37876
  contentType;
37877
37877
  content;
37878
37878
  contentEffect;
37879
- constructor(info2, channel) {
37879
+ constructor(info2, channel2) {
37880
37880
  super();
37881
37881
  this.key = info2.name;
37882
37882
  this.name = info2.filename ?? info2.name;
37883
37883
  this.contentType = info2.contentType;
37884
- this.content = fromChannel3(channel);
37885
- this.contentEffect = mkUint8Array(channel);
37884
+ this.content = fromChannel3(channel2);
37885
+ this.contentEffect = mkUint8Array(channel2);
37886
37886
  }
37887
37887
  toJSON() {
37888
37888
  return {
@@ -41216,7 +41216,8 @@ var THREAD_LINE_EVENT = {
41216
41216
  };
41217
41217
  var START_LINE_BRIEF = {
41218
41218
  PROMPT: "prompt",
41219
- PLAN: "plan",
41219
+ // Note that the value says "plan", the description's name before it, because every start line written before the rename carries it.
41220
+ DESCRIPTION: "plan",
41220
41221
  CONTINUE: "continue",
41221
41222
  FORK: "fork"
41222
41223
  };
@@ -41720,11 +41721,11 @@ var HOST_TARGET = {
41720
41721
  DARWIN_ARM64: "darwin-arm64"
41721
41722
  };
41722
41723
  var HOST_RELEASE = {
41723
- VERSION: "0.9.1",
41724
+ VERSION: "0.10.0",
41724
41725
  SHA256: {
41725
- [HOST_TARGET.LINUX_X64]: "b9899a07d06aff273d0635d769c583d78fcaf7b5569956588819e15bb04da2b5",
41726
- [HOST_TARGET.LINUX_ARM64]: "9fbe523328ee636b31fe73831d95f69771677db70f133da18b9a6fe8fb24e808",
41727
- [HOST_TARGET.DARWIN_ARM64]: "5b1cbd4deca7fff7cfe5035c1059f9b11a71a3ac86b776d1d09947e0a974d06e"
41726
+ [HOST_TARGET.LINUX_X64]: "5e8ad1fa4c089f921022c90c47b52308230086e128ddcd70dc655c6bc6ebb8bc",
41727
+ [HOST_TARGET.LINUX_ARM64]: "e1e66b5c038ce6aaed5fc9ecc1cc15fa815a628a5537fbe6912fb84894f21aab",
41728
+ [HOST_TARGET.DARWIN_ARM64]: "a00dd2fa3de6c500d37bbed41f72e413bd9afb7cc0039c51ee57478d1ef4b4d5"
41728
41729
  }
41729
41730
  };
41730
41731
 
@@ -41783,12 +41784,6 @@ var HOSTED_API_ERROR = {
41783
41784
  AGENT_NOT_READY: "agent-not-ready",
41784
41785
  /** The agent's session has ended for good: its sandbox cannot be reached again, and only a new agent goes on from here. */
41785
41786
  AGENT_RETIRED: "agent-retired",
41786
- /**
41787
- * The agent runs on a native harness whose sandbox image is still being
41788
- * prepared, so it could not start or take the message yet; nothing was
41789
- * written, and the same request a little later, under the same key, is taken.
41790
- */
41791
- AGENT_IMAGE_PREPARING: "agent-image-preparing",
41792
41787
  /**
41793
41788
  * The agent runs on a native harness (Claude Code or Codex) that this part
41794
41789
  * of the app cannot reach yet, such as a call, which runs on eve alone; nothing
@@ -41863,6 +41858,8 @@ var HOSTED_API_ERROR = {
41863
41858
  ALREADY_INVITED: "already-invited",
41864
41859
  /** The coding agent's sandbox is stopped, so no shell starts in it until the developer resumes it; nothing was started. */
41865
41860
  SANDBOX_STOPPED: "sandbox-stopped",
41861
+ /** The coding agent's sandbox can never resume: its snapshot expired or was deleted, its saved files with it, and the agent's next turn starts a fresh one. Nothing was resumed. */
41862
+ SANDBOX_SNAPSHOT_GONE: "sandbox-snapshot-gone",
41866
41863
  /** A skill of that name is already installed in the scope asked: the account's own, or the workspace's. Nothing was installed. */
41867
41864
  SKILL_NAME_TAKEN: "skill-name-taken",
41868
41865
  /** A skill's files were refused: a file past its bound, a `SKILL.md` that breaks the convention, or a credential-shaped literal. Nothing was installed. */
@@ -42289,6 +42286,26 @@ var INTEGRATION_NAME = {
42289
42286
  [INTEGRATION_PROVIDER.VERCEL]: "Vercel",
42290
42287
  [INTEGRATION_PROVIDER.YCOMBINATOR]: "Y Combinator"
42291
42288
  };
42289
+ var INTEGRATION_PURPOSE = {
42290
+ [INTEGRATION_PROVIDER.EXECUTOR]: "The apps, APIs, and skills you set up in Executor",
42291
+ [INTEGRATION_PROVIDER.GITHUB]: "Issues, pull requests, and code, as you",
42292
+ [INTEGRATION_PROVIDER.GMAIL]: "Read mail and write drafts",
42293
+ [INTEGRATION_PROVIDER.GOOGLE_CALENDAR]: "Events, invitations, and free time",
42294
+ [INTEGRATION_PROVIDER.GOOGLE_DRIVE]: "Docs, sheets, and files",
42295
+ [INTEGRATION_PROVIDER.GRANOLA]: "Meeting notes and transcripts",
42296
+ [INTEGRATION_PROVIDER.LINEAR]: "Issues, projects, and cycles",
42297
+ [INTEGRATION_PROVIDER.MERCURY]: "Accounts, transactions, and payments",
42298
+ [INTEGRATION_PROVIDER.NEON]: "Postgres projects, branches, and SQL",
42299
+ [INTEGRATION_PROVIDER.NOTION]: "Pages, databases, and comments",
42300
+ [INTEGRATION_PROVIDER.POSTHOG]: "Analytics, feature flags, and experiments",
42301
+ [INTEGRATION_PROVIDER.RESEND]: "Send email and read delivery logs",
42302
+ [INTEGRATION_PROVIDER.SENTRY]: "Errors, traces, and releases",
42303
+ [INTEGRATION_PROVIDER.SLACK]: "Messages, channels, and threads",
42304
+ [INTEGRATION_PROVIDER.STRIPE]: "Payments, customers, and subscriptions",
42305
+ [INTEGRATION_PROVIDER.SUPABASE]: "Postgres, auth, storage, and edge functions",
42306
+ [INTEGRATION_PROVIDER.VERCEL]: "Deployments, logs, and domains",
42307
+ [INTEGRATION_PROVIDER.YCOMBINATOR]: "Bookface companies, founders, and investors"
42308
+ };
42292
42309
  var INTEGRATION_GRANT = {
42293
42310
  /** A sign-in to the provider through Vercel Connect, begun from Settings › Integrations and ended there. */
42294
42311
  CONNECT: "connect",
@@ -43605,9 +43622,9 @@ var AGENT_BOUNDS = {
43605
43622
  MAX_MESSAGE_CHARS: 16e3,
43606
43623
  /**
43607
43624
  * The most characters a `start_agent` call's prompt may spell, trimmed, and its note apart:
43608
- * room for an orchestrator's brief to a worker on a long plan, quoted whole. Both together,
43625
+ * room for an orchestrator's brief to a worker on a long description, quoted whole. Both together,
43609
43626
  * with the headings around them, stay under a task's own bound (`TASK_BOUNDS.MAX_BODY_CHARS`),
43610
- * which a start on the plan already hands an agent whole as its first message.
43627
+ * which a start on the description already hands an agent whole as its first message.
43611
43628
  */
43612
43629
  MAX_START_WORDS_CHARS: 64e3,
43613
43630
  /** The most characters eve's id for a tool call may spell, which is how a subagent's transcript is named on the path. */
@@ -43620,7 +43637,7 @@ var AGENT_BOUNDS = {
43620
43637
  MAX_ARCHIVE_REASON_CHARS: 500,
43621
43638
  /** The most characters the words a workspace's agents are found by may spell. */
43622
43639
  MAX_SEARCH_CHARS: 200,
43623
- /** The most agents a workspace's list offers, newest first: enough to choose one an automation's runs go to. */
43640
+ /** The most agents one page of a workspace's list offers, newest first: enough to choose one an automation's runs go to; `nextOffset` names the next page. */
43624
43641
  MAX_WORKSPACE_AGENTS: 50,
43625
43642
  /** The most MCP servers one agent's list may name, and the most characters one name may spell: room for every provider and then some, never a document. */
43626
43643
  MAX_SERVERS: 32,
@@ -43771,7 +43788,8 @@ var DEVICE_LEASE = {
43771
43788
  MS: 5 * 60 * 1e3
43772
43789
  };
43773
43790
  var AGENT_BRIEF = {
43774
- PLAN: "plan",
43791
+ // Note that the value says "plan", the description's name before it, because a released desktop decodes it.
43792
+ DESCRIPTION: "plan",
43775
43793
  // Note that the value says "task", because a released desktop decodes it.
43776
43794
  PROMPT: "task",
43777
43795
  BLANK: "blank"
@@ -44073,7 +44091,8 @@ var AGENT_WORKSPACE_QUERY = {
44073
44091
  WORKSPACE_ID: "workspaceId",
44074
44092
  REPOSITORY: "repository",
44075
44093
  WORDS: "words",
44076
- ARCHIVED: AGENT_LIST_QUERY.ARCHIVED
44094
+ ARCHIVED: AGENT_LIST_QUERY.ARCHIVED,
44095
+ OFFSET: "offset"
44077
44096
  };
44078
44097
  var AGENT_ARCHIVER = {
44079
44098
  MEMBER: "member",
@@ -44177,9 +44196,9 @@ var agentSummarySchema = Schema_exports.Struct({
44177
44196
  stoppable: Schema_exports.optionalKey(Schema_exports.Literal(false)),
44178
44197
  /**
44179
44198
  * What the agent was handed as its first message, so its tab draws a
44180
- * plan as the plan's card, a task as the developer's own message, and,
44199
+ * description as the description's card, a task as the developer's own message, and,
44181
44200
  * for an agent started blank, its first line as any other line. Absent
44182
- * from a service older than the task, which handed every agent the plan.
44201
+ * from a service older than the task, which handed every agent the description.
44183
44202
  */
44184
44203
  brief: Schema_exports.optionalKey(Schema_exports.Literals(Object.values(AGENT_BRIEF))),
44185
44204
  /** Epoch milliseconds the agent was archived; absent while it is not, and from a service before archiving. */
@@ -44311,6 +44330,10 @@ var agentPageAnswerSchema = Schema_exports.Struct({ agent: agentPageSchema });
44311
44330
  var agentListAnswerSchema = Schema_exports.Struct({
44312
44331
  agents: Schema_exports.Array(agentSummarySchema)
44313
44332
  });
44333
+ var agentWorkspaceListAnswerSchema = Schema_exports.Struct({
44334
+ ...agentListAnswerSchema.fields,
44335
+ nextOffset: Schema_exports.optionalKey(Schema_exports.Int)
44336
+ });
44314
44337
  var PULL_REQUEST_STATE = {
44315
44338
  OPEN: "open",
44316
44339
  DRAFT: "draft",
@@ -52511,7 +52534,9 @@ var accountInboxEntrySchema = Schema_exports.Struct({
52511
52534
  unread: Schema_exports.optionalKey(Schema_exports.Boolean),
52512
52535
  /** Whether the item holds an ask open, rather than being a notice; absent from a service before it, which the desktop reads as asking. */
52513
52536
  asking: Schema_exports.optionalKey(Schema_exports.Boolean),
52514
- /** Until when the reader snoozed the item, in epoch milliseconds, which marked it read for them; null where they did not, and absent from a service before snoozing. */
52537
+ /** When the reader's reminder on the item comes due, in epoch milliseconds, while nothing has changed on it since; null where they set none or a change ended it, and absent from a service before reminders. */
52538
+ remindAt: Schema_exports.optionalKey(Schema_exports.NullOr(countedNumber)),
52539
+ /** `remindAt` under the key a desktop from before the rename reads, which the service still fills and no client reads: the key goes with the minimum supported desktop version. */
52515
52540
  snoozedUntil: Schema_exports.optionalKey(Schema_exports.NullOr(countedNumber))
52516
52541
  });
52517
52542
  var accountInboxTaskSchema = Schema_exports.Struct({
@@ -52548,7 +52573,9 @@ var accountTasklessEntrySchema = Schema_exports.Struct({
52548
52573
  unread: Schema_exports.optionalKey(Schema_exports.Boolean),
52549
52574
  /** Whether the item holds an ask open, as a task's item says it, and on the same terms. */
52550
52575
  asking: Schema_exports.optionalKey(Schema_exports.Boolean),
52551
- /** Until when the reader snoozed the item, as a task's item says it, and on the same terms. */
52576
+ /** When the reader's reminder on the item comes due, as a task's item says it, and on the same terms. */
52577
+ remindAt: Schema_exports.optionalKey(Schema_exports.NullOr(countedNumber)),
52578
+ /** `remindAt` under the key a desktop from before the rename reads, as a task's item carries it, and on the same terms. */
52552
52579
  snoozedUntil: Schema_exports.optionalKey(Schema_exports.NullOr(countedNumber))
52553
52580
  });
52554
52581
  var accountInboxAutomationSchema = Schema_exports.Struct({
@@ -52901,7 +52928,7 @@ var SITE_READ = {
52901
52928
  var TASK_BOUNDS = {
52902
52929
  /** The most characters a task's name may spell. */
52903
52930
  MAX_NAME_CHARS: 200,
52904
- /** A document body past this is not a plan a coding agent can take in one prompt. */
52931
+ /** A document body past this is not a description a coding agent can take in one prompt. */
52905
52932
  MAX_BODY_CHARS: 2e5,
52906
52933
  MAX_ASSUMPTIONS: 200,
52907
52934
  MAX_ASSUMPTION_CHARS: 2e3,
@@ -52956,14 +52983,14 @@ var workspaceIdSchema = Schema_exports.String.check(
52956
52983
  Schema_exports.isNonEmpty(),
52957
52984
  Schema_exports.isMaxLength(TASK_BOUNDS.MAX_WORKSPACE_ID_CHARS)
52958
52985
  );
52959
- var planAssumptionSchema = Schema_exports.Struct({
52986
+ var descriptionAssumptionSchema = Schema_exports.Struct({
52960
52987
  /** The assumption as one plain sentence. */
52961
52988
  text: trimmedText2(TASK_BOUNDS.MAX_ASSUMPTION_CHARS)
52962
52989
  });
52963
- var planDocumentSchema = Schema_exports.Struct({
52964
- /** The plan's whole text, as written. */
52990
+ var descriptionDocumentSchema = Schema_exports.Struct({
52991
+ /** The description's whole text, as written. */
52965
52992
  body: Schema_exports.String.check(Schema_exports.isMaxLength(TASK_BOUNDS.MAX_BODY_CHARS)),
52966
- assumptions: Schema_exports.Array(planAssumptionSchema).check(
52993
+ assumptions: Schema_exports.Array(descriptionAssumptionSchema).check(
52967
52994
  Schema_exports.isMaxLength(TASK_BOUNDS.MAX_ASSUMPTIONS)
52968
52995
  )
52969
52996
  });
@@ -53115,14 +53142,14 @@ var repositoryPinRequestSchema = Schema_exports.Struct({
53115
53142
  var TASK_LIST_QUERY = {
53116
53143
  ARCHIVED: "archived"
53117
53144
  };
53118
- var PLAN_ACTOR = {
53145
+ var DESCRIPTION_ACTOR = {
53119
53146
  DEVELOPER: "developer",
53120
53147
  NOTETAKER: "notetaker",
53121
53148
  AGENT: "agent",
53122
53149
  EARLIER: "earlier"
53123
53150
  };
53124
53151
  var taskOriginSchema = Schema_exports.Struct({
53125
- actor: Schema_exports.Literals([PLAN_ACTOR.NOTETAKER, PLAN_ACTOR.AGENT]),
53152
+ actor: Schema_exports.Literals([DESCRIPTION_ACTOR.NOTETAKER, DESCRIPTION_ACTOR.AGENT]),
53126
53153
  agentId: Schema_exports.optionalKey(wireUuidSchema)
53127
53154
  });
53128
53155
  var taskRunsOnSchema = Schema_exports.Struct({
@@ -53319,11 +53346,11 @@ var agentEditLineSchema = Schema_exports.Struct({
53319
53346
  /** Epoch milliseconds of the save. */
53320
53347
  at: countedNumber
53321
53348
  });
53322
- var planEditorSchema = memberRefSchema;
53323
- var planLastEditSchema = Schema_exports.Struct({
53324
- actor: Schema_exports.Literals(Object.values(PLAN_ACTOR)),
53349
+ var descriptionEditorSchema = memberRefSchema;
53350
+ var descriptionLastEditSchema = Schema_exports.Struct({
53351
+ actor: Schema_exports.Literals(Object.values(DESCRIPTION_ACTOR)),
53325
53352
  /** The member who wrote it; absent for a coding agent's, for one nobody can be named for, and from a service before writers were kept. */
53326
- by: Schema_exports.optionalKey(planEditorSchema),
53353
+ by: Schema_exports.optionalKey(descriptionEditorSchema),
53327
53354
  /** The coding agent as its row names it now; present only where a coding agent wrote it. */
53328
53355
  label: Schema_exports.optionalKey(trimmedText2(TASK_BOUNDS.MAX_NAME_CHARS)),
53329
53356
  /** The coding agent that wrote it, which the window finds among the task's agents; absent for any other writer and from a service before it. */
@@ -53333,31 +53360,31 @@ var planLastEditSchema = Schema_exports.Struct({
53333
53360
  /** Always false, since the app takes no calls; a released desktop still requires it. */
53334
53361
  duringCall: Schema_exports.Boolean
53335
53362
  });
53336
- var PLAN_SECTION_BOUNDS = {
53363
+ var DESCRIPTION_SECTION_BOUNDS = {
53337
53364
  /** The most characters of a heading a section is known by; a longer heading is known by its first this many. */
53338
53365
  MAX_HEADING_CHARS: 1e3,
53339
- /** The most sections a plan names a last save for. */
53366
+ /** The most sections a description names a last save for. */
53340
53367
  MAX_SECTIONS: 500
53341
53368
  };
53342
- var planSectionEditSchema = Schema_exports.Struct({
53369
+ var descriptionSectionEditSchema = Schema_exports.Struct({
53343
53370
  section: Schema_exports.String.check(
53344
- Schema_exports.isMaxLength(PLAN_SECTION_BOUNDS.MAX_HEADING_CHARS)
53371
+ Schema_exports.isMaxLength(DESCRIPTION_SECTION_BOUNDS.MAX_HEADING_CHARS)
53345
53372
  ),
53346
- ...planLastEditSchema.fields
53373
+ ...descriptionLastEditSchema.fields
53347
53374
  });
53348
53375
  var taskSchema = Schema_exports.Struct({
53349
53376
  ...taskSummaryFields,
53350
- document: planDocumentSchema,
53377
+ document: descriptionDocumentSchema,
53351
53378
  /** Optional on the wire so a task from a service without the journal still reads; none is no edits. */
53352
53379
  agentEdits: Schema_exports.optionalKey(
53353
53380
  Schema_exports.Array(agentEditLineSchema).check(Schema_exports.isMaxLength(MAX_AGENT_EDITS))
53354
53381
  ),
53355
53382
  /** Absent for a task nobody has written since history began, and from a service before it. */
53356
- lastEdit: Schema_exports.optionalKey(planLastEditSchema),
53383
+ lastEdit: Schema_exports.optionalKey(descriptionLastEditSchema),
53357
53384
  /** The save that last changed each section, for the sections a save has changed; absent from a service before documents. */
53358
53385
  sectionEdits: Schema_exports.optionalKey(
53359
- Schema_exports.Array(planSectionEditSchema).check(
53360
- Schema_exports.isMaxLength(PLAN_SECTION_BOUNDS.MAX_SECTIONS)
53386
+ Schema_exports.Array(descriptionSectionEditSchema).check(
53387
+ Schema_exports.isMaxLength(DESCRIPTION_SECTION_BOUNDS.MAX_SECTIONS)
53361
53388
  )
53362
53389
  ),
53363
53390
  /** The tasks this one waits on, by id, the earliest added first, each one the reader reaches; absent from a service before blocks. */
@@ -53402,34 +53429,36 @@ var taskDeleteAnswerSchema = Schema_exports.Struct({
53402
53429
  deleted: Schema_exports.Literal(true),
53403
53430
  txid: Schema_exports.optionalKey(taskTxidSchema)
53404
53431
  });
53405
- var PLAN_HISTORY_BOUNDS = {
53432
+ var DESCRIPTION_HISTORY_BOUNDS = {
53406
53433
  /** The most revisions one read of the history carries. */
53407
53434
  PAGE: 50
53408
53435
  };
53409
- var planRevisionSeqSchema = Schema_exports.Int.check(Schema_exports.isGreaterThanOrEqualTo(1));
53410
- var planRevisionLineSchema = Schema_exports.Struct({
53411
- seq: planRevisionSeqSchema,
53412
- lastEdit: planLastEditSchema,
53436
+ var descriptionRevisionSeqSchema = Schema_exports.Int.check(
53437
+ Schema_exports.isGreaterThanOrEqualTo(1)
53438
+ );
53439
+ var descriptionRevisionLineSchema = Schema_exports.Struct({
53440
+ seq: descriptionRevisionSeqSchema,
53441
+ lastEdit: descriptionLastEditSchema,
53413
53442
  /** The coding agent that wrote it; absent for any other writer, once the agent's row is gone, and from a service before it. */
53414
53443
  agentId: Schema_exports.optionalKey(wireUuidSchema),
53415
53444
  /** Epoch milliseconds of the revision's first save. */
53416
53445
  startedAt: countedNumber,
53417
53446
  changes: countedNumber,
53418
53447
  restoredFrom: Schema_exports.optionalKey(
53419
- Schema_exports.Struct({ seq: planRevisionSeqSchema, at: countedNumber })
53448
+ Schema_exports.Struct({ seq: descriptionRevisionSeqSchema, at: countedNumber })
53420
53449
  )
53421
53450
  });
53422
- var planRevisionsAnswerSchema = Schema_exports.Struct({
53423
- revisions: Schema_exports.Array(planRevisionLineSchema).check(
53424
- Schema_exports.isMaxLength(PLAN_HISTORY_BOUNDS.PAGE)
53451
+ var descriptionRevisionsAnswerSchema = Schema_exports.Struct({
53452
+ revisions: Schema_exports.Array(descriptionRevisionLineSchema).check(
53453
+ Schema_exports.isMaxLength(DESCRIPTION_HISTORY_BOUNDS.PAGE)
53425
53454
  ),
53426
- earlier: Schema_exports.optionalKey(planRevisionSeqSchema)
53455
+ earlier: Schema_exports.optionalKey(descriptionRevisionSeqSchema)
53427
53456
  });
53428
- var planRevisionAnswerSchema = Schema_exports.Struct({
53457
+ var descriptionRevisionAnswerSchema = Schema_exports.Struct({
53429
53458
  revision: Schema_exports.Struct({
53430
- seq: planRevisionSeqSchema,
53431
- document: planDocumentSchema,
53432
- previous: Schema_exports.NullOr(planDocumentSchema)
53459
+ seq: descriptionRevisionSeqSchema,
53460
+ document: descriptionDocumentSchema,
53461
+ previous: Schema_exports.NullOr(descriptionDocumentSchema)
53433
53462
  })
53434
53463
  });
53435
53464
  var CODE_REF_MAX_LINES = 200;
@@ -53609,7 +53638,7 @@ var MENTION_BOUNDS = {
53609
53638
  /** The most characters a mention's target may spell: an anchor or a path at its bound, every character encoded as UTF-8's widest, and the task's id. */
53610
53639
  MAX_TARGET_CHARS: 24e3,
53611
53640
  /** The most characters an anchor may spell: a heading at its bound, each character lowered into as many as two, and a suffix telling it from an earlier one. */
53612
- MAX_ANCHOR_CHARS: PLAN_SECTION_BOUNDS.MAX_HEADING_CHARS * 2 + 16,
53641
+ MAX_ANCHOR_CHARS: DESCRIPTION_SECTION_BOUNDS.MAX_HEADING_CHARS * 2 + 16,
53613
53642
  /** The most characters a task's id may spell; the service mints them far shorter. */
53614
53643
  MAX_TASK_ID_CHARS: 200,
53615
53644
  /** The most characters a repository path may spell. */
@@ -54340,11 +54369,24 @@ var inboxItemSchema = Schema_exports.Struct({
54340
54369
  */
54341
54370
  unread: Schema_exports.optionalKey(Schema_exports.Boolean),
54342
54371
  /**
54343
- * Until when the member reading it snoozed the item, in epoch
54344
- * milliseconds, which snoozing marked it read for them: it stays out of
54345
- * their Inbox while it is read and this is ahead, and comes back unread
54346
- * once this passes. Absent where they did not snooze it, and from a
54347
- * service before snoozing.
54372
+ * Whether the member reading it marked the item unread and has not read
54373
+ * it since, which leaves it `unread` whatever else does: what brings a
54374
+ * thread closed without an answer back to their Inbox's Open. Absent
54375
+ * where they did not, and from a service before it.
54376
+ */
54377
+ markedUnread: Schema_exports.optionalKey(Schema_exports.Boolean),
54378
+ /**
54379
+ * When the reminder the member reading it set on the item comes due, in
54380
+ * epoch milliseconds: it stays out of their Inbox while this is ahead, and
54381
+ * comes back once this passes, read or unread as it stands. Absent where
54382
+ * they set none or a change ended it since, and from a service before
54383
+ * reminders.
54384
+ */
54385
+ remindAt: Schema_exports.optionalKey(countedNumber),
54386
+ /**
54387
+ * `remindAt` under the key a desktop from before the rename reads, which
54388
+ * the service still fills and no client reads: the key goes with the
54389
+ * minimum supported desktop version.
54348
54390
  */
54349
54391
  snoozedUntil: Schema_exports.optionalKey(countedNumber)
54350
54392
  });
@@ -54418,7 +54460,7 @@ var inboxReadStateSchema = Schema_exports.Struct({
54418
54460
  ...writtenIn
54419
54461
  });
54420
54462
  var LATEST_INSTANT = 864e13;
54421
- var inboxSnoozeRequestSchema = Schema_exports.Struct({
54463
+ var inboxRemindRequestSchema = Schema_exports.Struct({
54422
54464
  until: Schema_exports.NullOr(countedNumber.check(Schema_exports.isLessThanOrEqualTo(LATEST_INSTANT)))
54423
54465
  });
54424
54466
  var inboxReadAllRequestSchema = Schema_exports.Struct({
@@ -55193,7 +55235,7 @@ var pageVersionSchema = Schema_exports.Struct({
55193
55235
  ...pageLineSchema.fields,
55194
55236
  html: pageHtmlSchema
55195
55237
  });
55196
- var planPageVersionAnswerSchema = Schema_exports.Struct({ page: pageVersionSchema });
55238
+ var taskPageVersionAnswerSchema = Schema_exports.Struct({ page: pageVersionSchema });
55197
55239
  var pagePlaceSchema = Schema_exports.Union([
55198
55240
  Schema_exports.Struct({ taskId: Schema_exports.NonEmptyString }),
55199
55241
  Schema_exports.Struct({ agentId: Schema_exports.NonEmptyString })
@@ -55388,13 +55430,13 @@ var FAILED_RUN_WINDOW_MILLIS = 7 * 24 * 60 * 60 * 1e3;
55388
55430
  var taskRecordLiveAnswerSchema = Schema_exports.Struct({
55389
55431
  url: Schema_exports.String,
55390
55432
  queries: Schema_exports.Struct({
55391
- plan: sealedLiveQuerySchema,
55433
+ description: sealedLiveQuerySchema,
55392
55434
  pages: sealedLiveQuerySchema,
55393
55435
  calls: sealedLiveQuerySchema,
55394
55436
  code: sealedLiveQuerySchema
55395
55437
  })
55396
55438
  });
55397
- var taskPlanLiveRowSchema = Schema_exports.Struct({
55439
+ var taskDescriptionLiveRowSchema = Schema_exports.Struct({
55398
55440
  taskId: Schema_exports.String,
55399
55441
  savedAt: Schema_exports.Finite
55400
55442
  });
@@ -55407,7 +55449,7 @@ var taskCodeLiveRowSchema = Schema_exports.Struct({
55407
55449
  calls: Schema_exports.String
55408
55450
  });
55409
55451
  var taskRecordLiveRowsSchema = Schema_exports.Struct({
55410
- plan: Schema_exports.Array(taskPlanLiveRowSchema),
55452
+ description: Schema_exports.Array(taskDescriptionLiveRowSchema),
55411
55453
  pages: Schema_exports.Array(taskPageLiveRowSchema),
55412
55454
  code: Schema_exports.Array(taskCodeLiveRowSchema)
55413
55455
  });
@@ -55525,8 +55567,9 @@ var inboxLiveFileSchema = Schema_exports.Struct({
55525
55567
  messageId: Schema_exports.NullOr(Schema_exports.String),
55526
55568
  position: Schema_exports.NullOr(countedNumber)
55527
55569
  });
55570
+ var { snoozedUntil: _beforeRemindAt, ...liveItemFields } = inboxItemSchema.fields;
55528
55571
  var inboxLiveRowSchema = Schema_exports.Struct({
55529
- ...inboxItemSchema.fields,
55572
+ ...liveItemFields,
55530
55573
  startedBy: Schema_exports.String,
55531
55574
  startedByName: Schema_exports.NullOr(Schema_exports.String),
55532
55575
  /** Absent from a service before it, as the item's own `waitsOn` is. */
@@ -55540,8 +55583,8 @@ var inboxLiveRowSchema = Schema_exports.Struct({
55540
55583
  openAskMessageId: Schema_exports.NullOr(Schema_exports.String),
55541
55584
  settledAt: Schema_exports.NullOr(countedNumber),
55542
55585
  unread: Schema_exports.Boolean,
55543
- /** Null where the reader did not snooze the item; absent from a service before snoozing. */
55544
- snoozedUntil: Schema_exports.optionalKey(Schema_exports.NullOr(countedNumber))
55586
+ /** Null where the reader set no reminder on the item; absent from a service before reminders. */
55587
+ remindAt: Schema_exports.optionalKey(Schema_exports.NullOr(countedNumber))
55545
55588
  });
55546
55589
  var scopeInboxLiveRowsSchema = Schema_exports.Struct({
55547
55590
  items: Schema_exports.Array(inboxLiveRowSchema),
@@ -55571,8 +55614,8 @@ var inboxItemStampRowSchema = Schema_exports.Struct({
55571
55614
  status: inboxItemSchema.fields.status,
55572
55615
  updatedAt: countedNumber,
55573
55616
  unread: Schema_exports.Boolean,
55574
- /** Until when the reader snoozed the item, which a snooze moves without moving `updatedAt`; null where they did not, absent from a service before snoozing. */
55575
- snoozedUntil: Schema_exports.optionalKey(Schema_exports.NullOr(countedNumber)),
55617
+ /** When the reader's reminder on the item comes due, which a reminder moves without moving `updatedAt`; null where they set none, absent from a service before reminders. */
55618
+ remindAt: Schema_exports.optionalKey(Schema_exports.NullOr(countedNumber)),
55576
55619
  waitsOn: Schema_exports.String,
55577
55620
  messages: countedNumber
55578
55621
  });
@@ -55606,15 +55649,15 @@ var taskHistoryLiveAnswerSchema = Schema_exports.Struct({
55606
55649
  queries: Schema_exports.Struct({ revisions: sealedLiveQuerySchema })
55607
55650
  });
55608
55651
  var taskHistoryLiveRowSchema = Schema_exports.Struct({
55609
- seq: planRevisionSeqSchema,
55610
- actor: Schema_exports.Literals(Object.values(PLAN_ACTOR)),
55652
+ seq: descriptionRevisionSeqSchema,
55653
+ actor: Schema_exports.Literals(Object.values(DESCRIPTION_ACTOR)),
55611
55654
  editorId: Schema_exports.NullOr(Schema_exports.String),
55612
55655
  editorName: Schema_exports.NullOr(Schema_exports.String),
55613
55656
  agentId: Schema_exports.NullOr(Schema_exports.String),
55614
55657
  agentModel: Schema_exports.NullOr(Schema_exports.String),
55615
55658
  agentTitle: Schema_exports.NullOr(Schema_exports.String),
55616
55659
  changes: countedNumber,
55617
- restoredFrom: Schema_exports.NullOr(planRevisionSeqSchema),
55660
+ restoredFrom: Schema_exports.NullOr(descriptionRevisionSeqSchema),
55618
55661
  at: countedNumber,
55619
55662
  startedAt: countedNumber,
55620
55663
  restoredAt: Schema_exports.NullOr(countedNumber)
@@ -58904,12 +58947,13 @@ var installedSkillSummarySchema = Schema_exports.Struct({
58904
58947
  description: Schema_exports.String,
58905
58948
  userInvocable: Schema_exports.Boolean,
58906
58949
  source: installedSkillSourceSchema,
58907
- enabled: Schema_exports.Boolean,
58950
+ /** Always true, since every installed skill is on; kept for desktops released before this, which require it. */
58951
+ enabled: Schema_exports.Literal(true),
58908
58952
  /** The workspace a workspace skill is; absent for a personal one. */
58909
58953
  workspaceId: Schema_exports.optionalKey(Schema_exports.String),
58910
58954
  /** Who installed it; null once their account is gone. */
58911
58955
  installedBy: Schema_exports.NullOr(Schema_exports.String),
58912
- /** Whether the account may update, toggle, and remove it: its own personal skill, or its workspace's as an owner or admin. */
58956
+ /** Whether the account may remove it: its own personal skill, or its workspace's as its installer or an owner or admin. */
58913
58957
  manageable: Schema_exports.Boolean,
58914
58958
  createdAt: Schema_exports.Number,
58915
58959
  updatedAt: Schema_exports.Number
@@ -58941,24 +58985,6 @@ var installedSkillInstallAnswerSchema = Schema_exports.Struct({
58941
58985
  skills: Schema_exports.Array(installedSkillSummarySchema),
58942
58986
  txid
58943
58987
  });
58944
- var installedSkillToggleRequestSchema = Schema_exports.Struct({
58945
- enabled: Schema_exports.Boolean
58946
- });
58947
- var installedSkillAnswerSchema = Schema_exports.Struct({
58948
- skill: installedSkillSummarySchema,
58949
- txid
58950
- });
58951
- var installedSkillUpdateRequestSchema = Schema_exports.Struct({
58952
- workspaceId: Schema_exports.NonEmptyString
58953
- });
58954
- var installedSkillUpdatedAnswerSchema = Schema_exports.Struct({
58955
- skill: installedSkillSummarySchema,
58956
- changed: Schema_exports.Boolean,
58957
- txid
58958
- });
58959
- var installedSkillShareRequestSchema = Schema_exports.Struct({
58960
- workspaceId: Schema_exports.NonEmptyString
58961
- });
58962
58988
  var installedSkillRemovedAnswerSchema = Schema_exports.Struct({
58963
58989
  id: Schema_exports.String,
58964
58990
  txid
@@ -59104,7 +59130,6 @@ var HOSTED_ERRORS = {
59104
59130
  [HOSTED_API_ERROR.MESSAGE_TOO_LONG]: {},
59105
59131
  [HOSTED_API_ERROR.AGENT_NOT_READY]: {},
59106
59132
  [HOSTED_API_ERROR.AGENT_RETIRED]: {},
59107
- [HOSTED_API_ERROR.AGENT_IMAGE_PREPARING]: {},
59108
59133
  [HOSTED_API_ERROR.NATIVE_AGENT_NOT_HERE]: {},
59109
59134
  [HOSTED_API_ERROR.OPENAI_KEY_MISSING]: {},
59110
59135
  [HOSTED_API_ERROR.OPENAI_KEY_REFUSED]: {},
@@ -59118,6 +59143,7 @@ var HOSTED_ERRORS = {
59118
59143
  [HOSTED_API_ERROR.NOT_PERMITTED]: {},
59119
59144
  [HOSTED_API_ERROR.ALREADY_INVITED]: {},
59120
59145
  [HOSTED_API_ERROR.SANDBOX_STOPPED]: {},
59146
+ [HOSTED_API_ERROR.SANDBOX_SNAPSHOT_GONE]: {},
59121
59147
  [HOSTED_API_ERROR.SKILL_NAME_TAKEN]: { data: installedSkillRefusedData },
59122
59148
  [HOSTED_API_ERROR.SKILL_FILES_REFUSED]: { data: installedSkillRefusedData },
59123
59149
  [HOSTED_API_ERROR.WORKSPACE_SLUG_MALFORMED]: {},
@@ -59243,10 +59269,9 @@ var PROVIDER_KEY_KIND = {
59243
59269
  /** A Claude subscription's long-lived token, as `claude setup-token` prints it; Anthropic's alone. */
59244
59270
  CLAUDE_SETUP_TOKEN: "claude_setup_token",
59245
59271
  /**
59246
- * A ChatGPT plan's renewable sign-in, as OpenAI's open-source Sign in with
59247
- * ChatGPT issues it to the desktop for our hosted runtime; OpenAI's
59248
- * alone. It is saved through its own route (`chatGptCredentialsSaveRequestSchema`),
59249
- * never as a pasted key.
59272
+ * A ChatGPT plan's renewable sign-in, as Codex's device-code login issues
59273
+ * it to the service for our hosted runtime; OpenAI's alone. The service
59274
+ * keeps it as the login connects, never as a pasted key.
59250
59275
  */
59251
59276
  CHATGPT_OAUTH: "chatgpt_oauth"
59252
59277
  };
@@ -59278,14 +59303,7 @@ var PROVIDER_KEY_REJECTION = {
59278
59303
  /** The provider could not be asked, or did not answer; the same key may be tried again. */
59279
59304
  UNREACHABLE: "unreachable",
59280
59305
  /** The account saved too many keys in too short a time; nothing was sent to the provider. */
59281
- TOO_MANY_TRIES: "too_many_tries",
59282
- /**
59283
- * A ChatGPT sign-in whose ID token is not one OpenAI signed for its issued
59284
- * client, has expired, or names another account than the one handed over,
59285
- * or whose access token names another client, audience or issuer; nothing
59286
- * was kept.
59287
- */
59288
- UNVERIFIED_SIGN_IN: "unverified_sign_in"
59306
+ TOO_MANY_TRIES: "too_many_tries"
59289
59307
  };
59290
59308
  var PROVIDER_KEY_BOUNDS = {
59291
59309
  /** No provider key is shorter; a paste this short is no key. */
@@ -59358,42 +59376,41 @@ var providerKeyForAgentsRequestSchema = Schema_exports.Struct({
59358
59376
  kind: subscriptionKindSchema,
59359
59377
  forAgents: Schema_exports.Boolean
59360
59378
  });
59361
- var CHATGPT_CREDENTIAL_BOUNDS = {
59362
- MAX_TOKEN_CHARS: 16384,
59363
- MAX_ID_CHARS: 512,
59364
- MAX_SCOPES: 32,
59365
- /** OpenAI's access tokens last an hour; an expiry past a day is no token of this flow. */
59366
- MAX_EXPIRES_IN_SECONDS: 86400
59379
+ var CHATGPT_DEVICE_LOGIN = {
59380
+ /** The code has not been entered yet; poll again after the interval. */
59381
+ PENDING: "pending",
59382
+ /** The plan is connected, replacing whichever ChatGPT sign-in the account held. */
59383
+ CONNECTED: "connected",
59384
+ /** The code was not entered before it lapsed. */
59385
+ EXPIRED: "expired",
59386
+ /** OpenAI refused the login, or answered nothing a sign-in could be kept from. */
59387
+ REFUSED: "refused",
59388
+ /** The login was canceled, replaced by a newer one, or is none of the account's. */
59389
+ CANCELED: "canceled"
59367
59390
  };
59368
- var credentialToken = Schema_exports.String.check(
59369
- Schema_exports.isMinLength(1),
59370
- Schema_exports.isMaxLength(CHATGPT_CREDENTIAL_BOUNDS.MAX_TOKEN_CHARS),
59371
- Schema_exports.isPattern(/^\S+$/u)
59372
- );
59373
- var credentialId = Schema_exports.String.check(
59374
- Schema_exports.isMinLength(1),
59375
- Schema_exports.isMaxLength(CHATGPT_CREDENTIAL_BOUNDS.MAX_ID_CHARS),
59376
- Schema_exports.isPattern(/^\S+$/u)
59377
- );
59378
- var chatGptCredentialsSaveRequestSchema = Schema_exports.Struct({
59379
- /** The `client_id` OpenAI issued at registration, never `dynamic_agent_client`. */
59380
- clientId: credentialId,
59381
- /** The validated ID token's subject: which ChatGPT account the sign-in is. */
59382
- accountId: credentialId,
59383
- accessToken: credentialToken,
59384
- refreshToken: credentialToken,
59385
- /** The ID token retained for a later sign-in's `id_token_hint`. */
59386
- idToken: credentialToken,
59387
- expiresInSeconds: Schema_exports.Int.check(
59388
- Schema_exports.isGreaterThan(0),
59389
- Schema_exports.isLessThanOrEqualTo(CHATGPT_CREDENTIAL_BOUNDS.MAX_EXPIRES_IN_SECONDS)
59390
- ),
59391
- scopes: Schema_exports.Array(credentialId).check(
59392
- Schema_exports.isMaxLength(CHATGPT_CREDENTIAL_BOUNDS.MAX_SCOPES)
59391
+ var CHATGPT_DEVICE_FAILURE_MESSAGE = {
59392
+ [CHATGPT_DEVICE_LOGIN.EXPIRED]: "The code expired before it was entered. Start again for a new one.",
59393
+ [CHATGPT_DEVICE_LOGIN.REFUSED]: "ChatGPT did not connect this account. Start again to try once more.",
59394
+ [CHATGPT_DEVICE_LOGIN.CANCELED]: "This connection was canceled. Start again for a new code."
59395
+ };
59396
+ var CHATGPT_DEVICE_LOGIN_ID_MAX_CHARS = 64;
59397
+ var chatGptDeviceStartAnswerSchema = Schema_exports.Struct({
59398
+ loginId: Schema_exports.String,
59399
+ userCode: Schema_exports.String,
59400
+ verificationUrl: Schema_exports.String,
59401
+ intervalSeconds: countedNumber,
59402
+ expiresAt: countedNumber
59403
+ });
59404
+ var chatGptDeviceLoginRequestSchema = Schema_exports.Struct({
59405
+ loginId: Schema_exports.String.check(
59406
+ Schema_exports.isMinLength(1),
59407
+ Schema_exports.isMaxLength(CHATGPT_DEVICE_LOGIN_ID_MAX_CHARS)
59393
59408
  )
59394
59409
  });
59395
- var chatGptHostAnswerSchema = Schema_exports.Struct({
59396
- extAgentHostId: Schema_exports.String
59410
+ var chatGptDevicePollAnswerSchema = Schema_exports.Struct({
59411
+ outcome: Schema_exports.Literals(Object.values(CHATGPT_DEVICE_LOGIN)),
59412
+ message: Schema_exports.optionalKey(Schema_exports.String),
59413
+ keys: Schema_exports.optionalKey(providerKeysAnswerSchema)
59397
59414
  });
59398
59415
 
59399
59416
  // ../../packages/features/src/service-paths.ts
@@ -59417,14 +59434,12 @@ var HOSTED_SERVICE_PATH = {
59417
59434
  * `provider-key-wire.ts` declares every body.
59418
59435
  */
59419
59436
  ACCOUNT_PROVIDER_KEYS: "/api/account/provider-keys",
59420
- /**
59421
- * The account's ChatGPT sign-in for our hosted runtime, as the desktop
59422
- * hands it over (PUT); its removal is `ACCOUNT_PROVIDER_KEYS`'s DELETE with
59423
- * its kind. The answer is the provider keys' and never carries a token.
59424
- */
59425
- ACCOUNT_CHATGPT_CREDENTIALS: "/api/account/chatgpt/credentials",
59426
- /** The `ext_agent_host_id` the desktop signs in to ChatGPT for our hosted runtime under (GET). */
59427
- ACCOUNT_CHATGPT_HOST: "/api/account/chatgpt/host",
59437
+ /** A ChatGPT plan's connection through Codex's device-code login begun (POST): the code to enter, and the login to poll. */
59438
+ ACCOUNT_CHATGPT_DEVICE: "/api/account/chatgpt/device",
59439
+ /** One check of a device-code connection (POST), by its login. */
59440
+ ACCOUNT_CHATGPT_DEVICE_POLL: "/api/account/chatgpt/device/poll",
59441
+ /** A device-code connection dropped (POST), by its login. */
59442
+ ACCOUNT_CHATGPT_DEVICE_CANCEL: "/api/account/chatgpt/device/cancel",
59428
59443
  /**
59429
59444
  * The memories our agents kept in a workspace the account is a member
59430
59445
  * of, named in the query: read them (GET), or forget one by its id
@@ -59504,9 +59519,9 @@ var HOSTED_SERVICE_PATH = {
59504
59519
  LIVE_AGENT_PAGES: "/api/live/agent-pages",
59505
59520
  /** The run of an automation that started one coding agent under `?id=`, sealed for following over Neon Realtime (GET), or with `?poll=true` its row inline, none for an agent no run started; or `not-found`. `agent-origin-live.ts` declares the answer. */
59506
59521
  LIVE_AGENT_ORIGIN: "/api/live/agent-origin",
59507
- /** One task's newest page of plan history under `?id=`, sealed for following over Neon Realtime (GET), or with `?poll=true` its rows inline; or `not-found`. */
59522
+ /** One task's newest page of description history under `?id=`, sealed for following over Neon Realtime (GET), or with `?poll=true` its rows inline; or `not-found`. */
59508
59523
  LIVE_TASK_HISTORY: "/api/live/task-history",
59509
- /** One task's comments under `?id=`, its plan's own threads, or with `&page=` one page's on every version, sealed for following over Neon Realtime (GET), or with `?poll=true` their rows inline; or `not-found`. `plan-comment-live.ts` declares the answer. */
59524
+ /** One task's comments under `?id=`, its description's own threads, or with `&page=` one page's on every version, sealed for following over Neon Realtime (GET), or with `?poll=true` their rows inline; or `not-found`. `description-comment-live.ts` declares the answer. */
59510
59525
  LIVE_TASK_COMMENTS: "/api/live/task-comments",
59511
59526
  /** One task's Browser tabs under `?id=`, the agent's pointer on each among them, sealed for following over Neon Realtime (GET), or with `?poll=true` their rows inline; or `not-found`. */
59512
59527
  LIVE_TASK_BROWSER_TABS: "/api/live/task-browser-tabs",
@@ -59580,6 +59595,8 @@ var HOSTED_SERVICE_PATH = {
59580
59595
  DEVICE_AGENT_LIVE_AGENTS: "/api/device-agents/live-agents",
59581
59596
  /** One of the account's own registered devices enrolled on its signed-in session, traded for a device secret answered once (POST). `host-wire.ts` declares the bodies. */
59582
59597
  DEVICE_AGENT_ENROLL_OWN: "/api/device-agents/devices/enroll",
59598
+ /** A host removing itself from its account, on its own device secret, as Settings › Hosts' Remove does (POST): `vespin-host uninstall` calls it before it deletes the secret. */
59599
+ DEVICE_AGENT_LEAVE: "/api/device-agents/devices/leave",
59583
59600
  /** A box's pairing started with no credential: its poll secret, the code it shows and the link that opens it, how long the code lasts, and how often to poll (POST). `host-wire.ts` declares the bodies. */
59584
59601
  HOST_PAIRING_START: "/api/device-agents/pairing",
59585
59602
  /** A pairing box's poll on its poll secret: pending, slow down, denied, expired, or approved with its device secret, answered once (POST). */
@@ -59662,7 +59679,7 @@ var HOSTED_SERVICE_PATH = {
59662
59679
  * GitHub holds it now (GET), named by the workspace and the repository
59663
59680
  * (`GITHUB_REPOSITORIES_QUERY`), for a place with no plan to name it by,
59664
59681
  * such as an agent an automation started; the answer is a plan's tree's
59665
- * (`plan-wire.ts`).
59682
+ * (`description-wire.ts`).
59666
59683
  */
59667
59684
  GITHUB_REPOSITORY_TREE: "/api/github/repositories/tree",
59668
59685
  /**
@@ -59675,7 +59692,7 @@ var HOSTED_SERVICE_PATH = {
59675
59692
  /**
59676
59693
  * The skills a developer may choose of a repository a workspace's
59677
59694
  * installation reaches (GET), named as `GITHUB_REPOSITORY_TREE` names it;
59678
- * the answer is a plan's skills' (`plan-wire.ts`).
59695
+ * the answer is a plan's skills' (`description-wire.ts`).
59679
59696
  */
59680
59697
  GITHUB_REPOSITORY_SKILLS: "/api/github/repositories/skills",
59681
59698
  /**
@@ -59871,7 +59888,7 @@ function exactBodyInput(params, body) {
59871
59888
  // ../../packages/features/src/contract/account.ts
59872
59889
  var PROVIDER_KEY_BODY_BYTES = 2048;
59873
59890
  var MEMORY_SAVE_BODY_BYTES = 4096;
59874
- var CHATGPT_CREDENTIALS_BODY_BYTES = 64 * 1024;
59891
+ var CHATGPT_DEVICE_LOGIN_BODY_BYTES = 512;
59875
59892
  var accountContract = {
59876
59893
  delete: hostedProcedure.meta(openapi({ method: HTTP_METHOD.POST, path: HOSTED_SERVICE_PATH.ACCOUNT_DELETE })).output(Schema_exports.flip(accountDeleteAnswerSchema)),
59877
59894
  preferences: hostedProcedure.meta(openapi({ method: HTTP_METHOD.GET, path: HOSTED_SERVICE_PATH.ACCOUNT_PREFERENCES })).output(Schema_exports.flip(accountPreferencesAnswerSchema)),
@@ -59918,10 +59935,16 @@ var accountContract = {
59918
59935
  [MEMORY_QUERY.QUERY]: memorySearchQuerySchema
59919
59936
  })
59920
59937
  ).output(Schema_exports.flip(memorySearchAnswerSchema)),
59921
- chatGptHost: hostedProcedure.meta(openapi({ method: HTTP_METHOD.GET, path: HOSTED_SERVICE_PATH.ACCOUNT_CHATGPT_HOST })).output(Schema_exports.flip(chatGptHostAnswerSchema)),
59922
- saveChatGptCredentials: hostedProcedure.meta(bodyCap(CHATGPT_CREDENTIALS_BODY_BYTES)).meta(
59923
- openapi({ method: HTTP_METHOD.PUT, path: HOSTED_SERVICE_PATH.ACCOUNT_CHATGPT_CREDENTIALS })
59924
- ).input(exactInput(chatGptCredentialsSaveRequestSchema)).output(Schema_exports.flip(providerKeysAnswerSchema))
59938
+ startChatGptDeviceLogin: hostedProcedure.meta(openapi({ method: HTTP_METHOD.POST, path: HOSTED_SERVICE_PATH.ACCOUNT_CHATGPT_DEVICE })).output(Schema_exports.flip(chatGptDeviceStartAnswerSchema)),
59939
+ pollChatGptDeviceLogin: hostedProcedure.meta(bodyCap(CHATGPT_DEVICE_LOGIN_BODY_BYTES)).meta(
59940
+ openapi({ method: HTTP_METHOD.POST, path: HOSTED_SERVICE_PATH.ACCOUNT_CHATGPT_DEVICE_POLL })
59941
+ ).input(exactInput(chatGptDeviceLoginRequestSchema)).output(Schema_exports.flip(chatGptDevicePollAnswerSchema)),
59942
+ cancelChatGptDeviceLogin: hostedProcedure.meta(bodyCap(CHATGPT_DEVICE_LOGIN_BODY_BYTES)).meta(
59943
+ openapi({
59944
+ method: HTTP_METHOD.POST,
59945
+ path: HOSTED_SERVICE_PATH.ACCOUNT_CHATGPT_DEVICE_CANCEL
59946
+ })
59947
+ ).input(exactInput(chatGptDeviceLoginRequestSchema)).output(Schema_exports.flip(chatGptDevicePollAnswerSchema))
59925
59948
  };
59926
59949
 
59927
59950
  // ../../packages/features/src/contract/admin.ts
@@ -60028,7 +60051,7 @@ var agentPagesContract = {
60028
60051
  /** The agent's own pages, each by its newest version, the most recently written first. */
60029
60052
  list: hostedProcedure.meta(openapi({ method: HTTP_METHOD.GET, path: PAGES_PATH })).input(agentParamsSchema).output(Schema_exports.flip(taskPagesAnswerSchema)),
60030
60053
  /** One version of one of the agent's own pages, with its HTML. */
60031
- version: hostedProcedure.meta(openapi({ method: HTTP_METHOD.GET, path: `${PAGES_PATH}/{page}/versions/{version}` })).input(agentPageVersionSchema).output(Schema_exports.flip(planPageVersionAnswerSchema)),
60054
+ version: hostedProcedure.meta(openapi({ method: HTTP_METHOD.GET, path: `${PAGES_PATH}/{page}/versions/{version}` })).input(agentPageVersionSchema).output(Schema_exports.flip(taskPageVersionAnswerSchema)),
60032
60055
  /** One version of one of the agent's own pages as a browser's frame loads it, answered as a plan's page frame is (`task-files.ts`). */
60033
60056
  frame: hostedProcedure.meta(
60034
60057
  openapi({
@@ -60039,6 +60062,19 @@ var agentPagesContract = {
60039
60062
  ).input(agentPageVersionSchema).output(Schema_exports.flip(pageFrameAnswerSchema))
60040
60063
  };
60041
60064
 
60065
+ // ../../packages/features/src/listening-ports-wire.ts
60066
+ var listeningPortsAnswerSchema = Schema_exports.Struct({
60067
+ running: Schema_exports.Boolean,
60068
+ ports: Schema_exports.Array(Schema_exports.Int)
60069
+ });
60070
+
60071
+ // ../../packages/features/src/contract/agent-ports.ts
60072
+ var agentParamsSchema2 = Schema_exports.Struct({ id: Schema_exports.String });
60073
+ var agentPortsContract = {
60074
+ /** The ports listened on in the agent's sandbox, and whether it is running. */
60075
+ list: hostedProcedure.meta(openapi({ method: HTTP_METHOD.GET, path: `${HOSTED_SERVICE_PATH.AGENTS}/{id}/ports` })).input(agentParamsSchema2).output(Schema_exports.flip(listeningPortsAnswerSchema))
60076
+ };
60077
+
60042
60078
  // ../../packages/features/src/contract/agent-pull-requests.ts
60043
60079
  var PULL_REQUEST_ACTION_BODY_BYTES = PULL_REQUEST_WRITE_BOUNDS.MAX_BODY_CHARS * 2 * 6 + 4096;
60044
60080
  var AGENT_PULL_REQUEST_PATH = {
@@ -60157,19 +60193,13 @@ var terminalRelayServiceFrameSchema = Schema_exports.Union([
60157
60193
 
60158
60194
  // ../../packages/features/src/workspace-tools-wire.ts
60159
60195
  var RUN_ON_MAC_OFF = {
60160
- /** No Mac of the agent's starter listened for commands lately. */
60161
- MAC_AWAY: "mac-away",
60162
- /** Someone other than the starter put words into the agent's conversation. */
60163
- OUTSIDE_WORDS: "outside-words"
60196
+ /** No Mac of the member the agent's commands run on, its task's assignee, listened for commands lately. */
60197
+ MAC_AWAY: "mac-away"
60164
60198
  };
60165
60199
  var runOnMacOnSchema = Schema_exports.Struct({ on: Schema_exports.Literal(true) });
60166
60200
  var runOnMacOffSchema = Schema_exports.Struct({
60167
60201
  on: Schema_exports.Literal(false),
60168
- reason: Schema_exports.Literals(Object.values(RUN_ON_MAC_OFF)),
60169
- /** What kind of sender put the first outside words in; absent for a line kept before senders were, and for every other reason. */
60170
- from: Schema_exports.optionalKey(Schema_exports.Literals(Object.values(MESSAGE_SENDER))),
60171
- /** Epoch milliseconds the first outside words were put in; absent for every other reason. */
60172
- at: Schema_exports.optionalKey(countedNumber)
60202
+ reason: Schema_exports.Literals(Object.values(RUN_ON_MAC_OFF))
60173
60203
  });
60174
60204
  var runOnMacStandingSchema = Schema_exports.Union([runOnMacOnSchema, runOnMacOffSchema]);
60175
60205
  var workspaceToolsAnswerSchema = Schema_exports.Struct({
@@ -60188,6 +60218,9 @@ var terminalParams = Schema_exports.Struct({
60188
60218
  id: Schema_exports.String,
60189
60219
  terminal: Schema_exports.String
60190
60220
  });
60221
+ var offsetQuery = Schema_exports.NumberFromString.pipe(
60222
+ Schema_exports.decodeTo(Schema_exports.Int.check(Schema_exports.isGreaterThanOrEqualTo(0)))
60223
+ );
60191
60224
  var archivedQuery = Schema_exports.optionalKey(Schema_exports.String);
60192
60225
  var agentChangeRequestSchema = Schema_exports.Union([
60193
60226
  agentRenameRequestSchema,
@@ -60203,15 +60236,16 @@ var startAnswerSchema = Schema_exports.Struct({
60203
60236
  body: agentAnswerSchema
60204
60237
  });
60205
60238
  var agentsContract = {
60206
- /** A workspace's agents, newest started first, narrowed as the query asks. */
60239
+ /** A page of a workspace's agents, newest started first, narrowed as the query asks, from its `offset`. */
60207
60240
  listOfWorkspace: hostedProcedure.meta(openapi({ method: HTTP_METHOD.GET, path: HOSTED_SERVICE_PATH.AGENTS })).input(
60208
60241
  Schema_exports.Struct({
60209
60242
  [AGENT_WORKSPACE_QUERY.WORKSPACE_ID]: Schema_exports.optionalKey(Schema_exports.String),
60210
60243
  [AGENT_WORKSPACE_QUERY.REPOSITORY]: Schema_exports.optionalKey(Schema_exports.String),
60211
60244
  [AGENT_WORKSPACE_QUERY.WORDS]: Schema_exports.optionalKey(Schema_exports.String),
60212
- [AGENT_WORKSPACE_QUERY.ARCHIVED]: archivedQuery
60245
+ [AGENT_WORKSPACE_QUERY.ARCHIVED]: archivedQuery,
60246
+ [AGENT_WORKSPACE_QUERY.OFFSET]: Schema_exports.optionalKey(offsetQuery)
60213
60247
  })
60214
- ).output(Schema_exports.flip(agentListAnswerSchema)),
60248
+ ).output(Schema_exports.flip(agentWorkspaceListAnswerSchema)),
60215
60249
  /** One task's agents with their status. */
60216
60250
  listOfTask: hostedProcedure.meta(openapi({ method: HTTP_METHOD.GET, path: `${HOSTED_SERVICE_PATH.TASKS}/{id}/agents` })).input(
60217
60251
  Schema_exports.Struct({
@@ -60339,6 +60373,7 @@ var deviceAgentsContract = {
60339
60373
  startPairing: hostedProcedure.meta(bodyCap(SMALL_BODY_BYTES)).meta(openapi({ method: HTTP_METHOD.POST, path: HOSTED_SERVICE_PATH.HOST_PAIRING_START })).input(exactInput(hostPairingStartRequestSchema)).output(Schema_exports.flip(hostPairingStartAnswerSchema)),
60340
60374
  pollPairing: hostedProcedure.meta(openapi({ method: HTTP_METHOD.POST, path: HOSTED_SERVICE_PATH.HOST_PAIRING_POLL })).output(Schema_exports.flip(hostPairingPollAnswerSchema)),
60341
60375
  enrollOwn: hostedProcedure.meta(bodyCap(SMALL_BODY_BYTES)).meta(openapi({ method: HTTP_METHOD.POST, path: HOSTED_SERVICE_PATH.DEVICE_AGENT_ENROLL_OWN })).input(exactInput(ownDeviceEnrollRequestSchema)).output(Schema_exports.flip(hostEnrollAnswerSchema)),
60376
+ leave: hostedProcedure.meta(bodyCap(SMALL_BODY_BYTES)).meta(openapi({ method: HTTP_METHOD.POST, path: HOSTED_SERVICE_PATH.DEVICE_AGENT_LEAVE })).input(exactInput(deviceAgentDeviceRequestSchema)).output(Schema_exports.flip(deviceAgentDoneAnswerSchema)),
60342
60377
  register: hostedProcedure.meta(bodyCap(SMALL_BODY_BYTES)).meta(openapi({ method: HTTP_METHOD.POST, path: HOSTED_SERVICE_PATH.DEVICE_AGENT_DEVICES })).input(exactInput(deviceAgentRegisterRequestSchema)).output(Schema_exports.flip(deviceAgentDoneAnswerSchema)),
60343
60378
  beat: hostedProcedure.meta(bodyCap(SMALL_BODY_BYTES)).meta(openapi({ method: HTTP_METHOD.POST, path: HOSTED_SERVICE_PATH.DEVICE_AGENT_PRESENCE })).input(exactInput(deviceAgentBeatRequestSchema)).output(Schema_exports.flip(deviceAgentBeatAnswerSchema)),
60344
60379
  liveAgents: hostedProcedure.meta(openapi({ method: HTTP_METHOD.GET, path: HOSTED_SERVICE_PATH.DEVICE_AGENT_LIVE_AGENTS })).input(deviceAgentDeviceRequestSchema).output(Schema_exports.flip(deviceAgentLiveAgentsAnswerSchema)),
@@ -60533,6 +60568,7 @@ var PRODUCT_SETTINGS_VIEW = {
60533
60568
  HOSTS: "hosts",
60534
60569
  INTEGRATIONS: "integrations",
60535
60570
  MCP: "mcp",
60571
+ CLI: "cli",
60536
60572
  SKILLS: "skills",
60537
60573
  API_KEYS: "api_keys",
60538
60574
  /** No page since Settings › Plan template was removed; an older build still counts a visit to it. */
@@ -60614,6 +60650,9 @@ var PRODUCT_EXPERIMENT = {
60614
60650
  SKILLS: "skills",
60615
60651
  BRING_YOUR_OWN_HOST: "bring-your-own-host",
60616
60652
  SEVERAL_REPOSITORIES: "several-repositories",
60653
+ DESCRIPTIONS: "descriptions",
60654
+ /** Renamed to Task descriptions, so no build sends it now; kept because a web tab served before the rename still may, and one unread value refuses the batch. */
60655
+ PLANS: "plans",
60617
60656
  /** Removed with Chat on the right, so no build sends it now; kept because an older build's batch still may, and one unread value refuses the batch. */
60618
60657
  CHAT_ON_THE_RIGHT: "chat-on-the-right"
60619
60658
  };
@@ -60872,8 +60911,6 @@ var AGENT_CALL_FAILURE = {
60872
60911
  DEVICE_REMOVED: "device-removed",
60873
60912
  /** The agent runs on its starter's own GitHub token, so only its starter messages it or starts an agent from it. */
60874
60913
  NOT_PERMITTED: "not-permitted",
60875
- /** The agent's sandbox image is still being prepared; the same call under its key, a little later, is taken. */
60876
- AGENT_IMAGE_PREPARING: "agent-image-preparing",
60877
60914
  /** The agent runs on Claude Code or Codex, which this part of the app cannot reach yet. */
60878
60915
  NATIVE_AGENT_NOT_HERE: "native-agent-not-here",
60879
60916
  /** The agent runs on its starter's plan, whose sign-in cannot launch it until the starter signs in again. */
@@ -60924,11 +60961,25 @@ var devicePresenceAnswerViewSchema = Schema_exports.Union([
60924
60961
  failed2
60925
60962
  ]);
60926
60963
  var hostDoneAnswerViewSchema = Schema_exports.Union([hostDoneAnswerSchema, failed2]);
60964
+ var thisMacHostSetParamsSchema = Schema_exports.Struct({
60965
+ on: Schema_exports.Boolean,
60966
+ deleteFolders: Schema_exports.optionalKey(Schema_exports.Boolean)
60967
+ });
60927
60968
  var providerKeysAnswerViewSchema = Schema_exports.Union([providerKeysAnswerSchema, failed2]);
60928
- var chatGptSignInAnswerViewSchema = Schema_exports.Union([
60929
- providerKeysAnswerSchema,
60930
- Schema_exports.Struct({ refused: Schema_exports.String }),
60931
- Schema_exports.Struct({ cancelled: Schema_exports.Literal(true) }),
60969
+ var chatGptDeviceStartAnswerViewSchema = Schema_exports.Union([
60970
+ chatGptDeviceStartAnswerSchema,
60971
+ failed2
60972
+ ]);
60973
+ var CHATGPT_DEVICE_INTERVAL_MAX_SECONDS = 60;
60974
+ var chatGptDeviceWaitParamsSchema = Schema_exports.Struct({
60975
+ ...chatGptDeviceLoginRequestSchema.fields,
60976
+ intervalSeconds: Schema_exports.Int.check(
60977
+ Schema_exports.isGreaterThan(0),
60978
+ Schema_exports.isLessThanOrEqualTo(CHATGPT_DEVICE_INTERVAL_MAX_SECONDS)
60979
+ )
60980
+ });
60981
+ var chatGptDevicePollAnswerViewSchema = Schema_exports.Union([
60982
+ chatGptDevicePollAnswerSchema,
60932
60983
  failed2
60933
60984
  ]);
60934
60985
  var providerKeyRemoveParamsSchema = Schema_exports.Struct({
@@ -61159,7 +61210,7 @@ var agentInboxReadStateParamsSchema = Schema_exports.Struct({
61159
61210
  itemId: Schema_exports.NonEmptyString,
61160
61211
  unread: Schema_exports.Boolean
61161
61212
  });
61162
- var agentInboxSnoozeParamsSchema = Schema_exports.Struct({
61213
+ var agentInboxRemindParamsSchema = Schema_exports.Struct({
61163
61214
  itemId: Schema_exports.NonEmptyString,
61164
61215
  until: Schema_exports.NullOr(countedNumber)
61165
61216
  });
@@ -61352,40 +61403,42 @@ var pictureDataUrlSchema = Schema_exports.String.check(
61352
61403
  })
61353
61404
  );
61354
61405
 
61355
- // ../../packages/features/src/plan-attachment-wire.ts
61356
- var PLAN_ATTACHMENT_TYPE = {
61406
+ // ../../packages/features/src/description-attachment-wire.ts
61407
+ var DESCRIPTION_ATTACHMENT_TYPE = {
61357
61408
  ...AGENT_ATTACHMENT_TYPE,
61358
61409
  WEBM: WEBM_TYPE
61359
61410
  };
61360
- var planAttachmentTypeSchema = Schema_exports.Literals(Object.values(PLAN_ATTACHMENT_TYPE));
61361
- var planAttachmentRequestSchema = Schema_exports.Struct({
61411
+ var descriptionAttachmentTypeSchema = Schema_exports.Literals(
61412
+ Object.values(DESCRIPTION_ATTACHMENT_TYPE)
61413
+ );
61414
+ var descriptionAttachmentRequestSchema = Schema_exports.Struct({
61362
61415
  picture: pictureDataUrlSchema
61363
61416
  });
61364
- var PLAN_ATTACHMENT_REFUSAL = {
61365
- /** The plan already holds `PLAN_ATTACHMENT_BOUNDS.MAX_PER_PLAN` pictures. */
61417
+ var DESCRIPTION_ATTACHMENT_REFUSAL = {
61418
+ /** The description already holds `DESCRIPTION_ATTACHMENT_BOUNDS.MAX_PER_DESCRIPTION` pictures. */
61366
61419
  TOO_MANY: "too-many",
61367
- /** The upload is a video, and the plan already holds `PLAN_ATTACHMENT_BOUNDS.MAX_VIDEOS_PER_PLAN` videos. */
61420
+ /** The upload is a video, and the description already holds `DESCRIPTION_ATTACHMENT_BOUNDS.MAX_VIDEOS_PER_DESCRIPTION` videos. */
61368
61421
  TOO_MANY_VIDEOS: "too-many-videos"
61369
61422
  };
61370
- var PLAN_ATTACHMENT_STATUS = {
61423
+ var DESCRIPTION_ATTACHMENT_STATUS = {
61371
61424
  KEPT: 201,
61372
61425
  REFUSED: 200
61373
61426
  };
61374
- var planAttachmentAnswerSchema = Schema_exports.Union([
61427
+ var descriptionAttachmentAnswerSchema = Schema_exports.Union([
61375
61428
  Schema_exports.Struct({ id: wireUuidSchema }),
61376
61429
  Schema_exports.Struct({
61377
- refused: Schema_exports.Literals(Object.values(PLAN_ATTACHMENT_REFUSAL))
61430
+ refused: Schema_exports.Literals(Object.values(DESCRIPTION_ATTACHMENT_REFUSAL))
61378
61431
  })
61379
61432
  ]);
61380
61433
 
61381
- // ../../packages/features/src/plan-comment-wire.ts
61382
- var PLAN_COMMENT_BOUNDS = {
61434
+ // ../../packages/features/src/description-comment-wire.ts
61435
+ var DESCRIPTION_COMMENT_BOUNDS = {
61383
61436
  /** The longest one comment may be. */
61384
61437
  MAX_WORDS_CHARS: 8e3,
61385
61438
  /** The longest quote a thread keeps of the words it was anchored to. */
61386
61439
  MAX_QUOTE_CHARS: 2e3,
61387
- /** The most threads one plan may hold, resolved ones among them. */
61388
- MAX_THREADS_PER_PLAN: 500,
61440
+ /** The most threads one description may hold, resolved ones among them. */
61441
+ MAX_THREADS_PER_DESCRIPTION: 500,
61389
61442
  /** The most comments one thread may hold, and the most lines of what happened to it it says. */
61390
61443
  MAX_ENTRIES_PER_THREAD: 200,
61391
61444
  /** The longest key a client sends a write under. */
@@ -61397,222 +61450,238 @@ var PLAN_COMMENT_BOUNDS = {
61397
61450
  /** The longest heading a page thread keeps of the section its element stands in. */
61398
61451
  MAX_SECTION_CHARS: 200
61399
61452
  };
61400
- var PLAN_COMMENT_SCOPE = {
61453
+ var DESCRIPTION_COMMENT_SCOPE = {
61401
61454
  WORDS: "words",
61402
61455
  BLOCK: "block",
61403
61456
  ELEMENT: "element",
61404
61457
  PAGE: "page"
61405
61458
  };
61406
- var PLAN_COMMENT_STATUS = {
61459
+ var DESCRIPTION_COMMENT_STATUS = {
61407
61460
  OPEN: "open",
61408
61461
  RESOLVED: "resolved"
61409
61462
  };
61410
- var PLAN_COMMENT_ACTOR = {
61463
+ var DESCRIPTION_COMMENT_ACTOR = {
61411
61464
  MEMBER: "member",
61412
61465
  APP: "app",
61413
61466
  AGENT: "agent"
61414
61467
  };
61415
- var planCommentActorSchema = literalsReadingLegacy(
61416
- Object.values(PLAN_COMMENT_ACTOR),
61468
+ var descriptionCommentActorSchema = literalsReadingLegacy(
61469
+ Object.values(DESCRIPTION_COMMENT_ACTOR),
61417
61470
  LEGACY_APP_WORD,
61418
- PLAN_COMMENT_ACTOR.APP
61471
+ DESCRIPTION_COMMENT_ACTOR.APP
61419
61472
  );
61420
- var PLAN_COMMENT_ENTRY = {
61473
+ var DESCRIPTION_COMMENT_ENTRY = {
61421
61474
  COMMENT: "comment",
61422
61475
  /** Someone sent the thread to the app or a coding agent to read and answer. */
61423
61476
  ASKED: "asked",
61424
61477
  RESOLVED: "resolved",
61425
61478
  REOPENED: "reopened"
61426
61479
  };
61427
- var planCommentWordsSchema = Schema_exports.String.check(
61428
- Schema_exports.isMaxLength(PLAN_COMMENT_BOUNDS.MAX_WORDS_CHARS),
61480
+ var descriptionCommentWordsSchema = Schema_exports.String.check(
61481
+ Schema_exports.isMaxLength(DESCRIPTION_COMMENT_BOUNDS.MAX_WORDS_CHARS),
61429
61482
  Schema_exports.isPattern(/\S/u)
61430
61483
  );
61431
- var planCommentClientKeySchema = filledText(PLAN_COMMENT_BOUNDS.MAX_CLIENT_KEY_CHARS);
61432
- var planCommentSpanSchema = Schema_exports.Struct({
61484
+ var descriptionCommentClientKeySchema = filledText(
61485
+ DESCRIPTION_COMMENT_BOUNDS.MAX_CLIENT_KEY_CHARS
61486
+ );
61487
+ var descriptionCommentSpanSchema = Schema_exports.Struct({
61433
61488
  from: countedNumber,
61434
61489
  to: countedNumber
61435
61490
  });
61436
- var planCommentWriterSchema = Schema_exports.Struct({
61437
- actor: planCommentActorSchema,
61491
+ var descriptionCommentWriterSchema = Schema_exports.Struct({
61492
+ actor: descriptionCommentActorSchema,
61438
61493
  by: Schema_exports.optionalKey(memberRefSchema),
61439
61494
  agentId: Schema_exports.optionalKey(wireUuidSchema)
61440
61495
  });
61441
- var planCommentAskedSchema = Schema_exports.Struct({
61496
+ var descriptionCommentAskedSchema = Schema_exports.Struct({
61442
61497
  actor: literalsReadingLegacy(
61443
- [PLAN_COMMENT_ACTOR.APP, PLAN_COMMENT_ACTOR.AGENT],
61498
+ [DESCRIPTION_COMMENT_ACTOR.APP, DESCRIPTION_COMMENT_ACTOR.AGENT],
61444
61499
  LEGACY_APP_WORD,
61445
- PLAN_COMMENT_ACTOR.APP
61500
+ DESCRIPTION_COMMENT_ACTOR.APP
61446
61501
  ),
61447
61502
  agentId: Schema_exports.optionalKey(wireUuidSchema)
61448
61503
  });
61449
- var planCommentFileSchema = Schema_exports.Struct({
61504
+ var descriptionCommentFileSchema = Schema_exports.Struct({
61450
61505
  attachmentId: wireUuidSchema,
61451
61506
  name: Schema_exports.String,
61452
61507
  mediaType: Schema_exports.String
61453
61508
  });
61454
- var planCommentFilesSchema = agentMessageRequestSchema.fields.attachments;
61455
- var planCommentEntrySchema = Schema_exports.Struct({
61509
+ var descriptionCommentFilesSchema = agentMessageRequestSchema.fields.attachments;
61510
+ var descriptionCommentEntrySchema = Schema_exports.Struct({
61456
61511
  id: wireUuidSchema,
61457
- kind: Schema_exports.Literals(Object.values(PLAN_COMMENT_ENTRY)),
61458
- writer: planCommentWriterSchema,
61512
+ kind: Schema_exports.Literals(Object.values(DESCRIPTION_COMMENT_ENTRY)),
61513
+ writer: descriptionCommentWriterSchema,
61459
61514
  /** A comment's words. */
61460
61515
  words: Schema_exports.optionalKey(Schema_exports.String),
61461
61516
  /** The files a comment carries, in the order they were attached; absent where it carries none. */
61462
- files: Schema_exports.optionalKey(Schema_exports.Array(planCommentFileSchema)),
61517
+ files: Schema_exports.optionalKey(Schema_exports.Array(descriptionCommentFileSchema)),
61463
61518
  /** Who an ask sent the thread to. */
61464
- asked: Schema_exports.optionalKey(planCommentAskedSchema),
61519
+ asked: Schema_exports.optionalKey(descriptionCommentAskedSchema),
61465
61520
  /** When the entry was written. */
61466
61521
  at: countedNumber,
61467
61522
  /** When a comment's words were last edited, where they were. */
61468
61523
  editedAt: Schema_exports.optionalKey(countedNumber)
61469
61524
  });
61470
- var planCommentElementPathSchema = filledText(PLAN_COMMENT_BOUNDS.MAX_ELEMENT_PATH_CHARS);
61471
- var planCommentPageSchema = Schema_exports.Struct({
61525
+ var descriptionCommentElementPathSchema = filledText(
61526
+ DESCRIPTION_COMMENT_BOUNDS.MAX_ELEMENT_PATH_CHARS
61527
+ );
61528
+ var descriptionCommentPageSchema = Schema_exports.Struct({
61472
61529
  id: wireUuidSchema,
61473
61530
  version: pageVersionNumberSchema,
61474
61531
  element: Schema_exports.optionalKey(Schema_exports.String)
61475
61532
  });
61476
- var planCommentThreadSchema = Schema_exports.Struct({
61533
+ var descriptionCommentThreadSchema = Schema_exports.Struct({
61477
61534
  id: wireUuidSchema,
61478
- scope: Schema_exports.Literals(Object.values(PLAN_COMMENT_SCOPE)),
61535
+ scope: Schema_exports.Literals(Object.values(DESCRIPTION_COMMENT_SCOPE)),
61479
61536
  /** The words the thread was anchored to, as they stood when it was started or last moved; on a page, its element's words, or the version's title for the whole page. */
61480
61537
  quote: Schema_exports.String,
61481
- /** Where the words stand in the plan's text now; absent once every one of them was deleted, and on a page. */
61482
- anchor: Schema_exports.optionalKey(planCommentSpanSchema),
61483
- /** The page the thread is on; absent for a thread on the plan. */
61484
- page: Schema_exports.optionalKey(planCommentPageSchema),
61538
+ /** Where the words stand in the description's text now; absent once every one of them was deleted, and on a page. */
61539
+ anchor: Schema_exports.optionalKey(descriptionCommentSpanSchema),
61540
+ /** The page the thread is on; absent for a thread on the description. */
61541
+ page: Schema_exports.optionalKey(descriptionCommentPageSchema),
61485
61542
  /** The heading of the section the words stand, or last stood, in; empty before the first heading. */
61486
61543
  section: Schema_exports.String,
61487
- status: Schema_exports.Literals(Object.values(PLAN_COMMENT_STATUS)),
61488
- entries: Schema_exports.Array(planCommentEntrySchema),
61544
+ status: Schema_exports.Literals(Object.values(DESCRIPTION_COMMENT_STATUS)),
61545
+ entries: Schema_exports.Array(descriptionCommentEntrySchema),
61489
61546
  createdAt: countedNumber,
61490
61547
  /** When anything about the thread last changed. */
61491
61548
  updatedAt: countedNumber,
61492
61549
  /** Moved on by every change of the thread. */
61493
61550
  revision: countedNumber
61494
61551
  });
61495
- var planCommentsCursorSchema = filledText(PLAN_COMMENT_BOUNDS.MAX_CURSOR_CHARS);
61496
- var planCommentsAnswerSchema = Schema_exports.Struct({
61497
- threads: Schema_exports.Array(planCommentThreadSchema),
61552
+ var descriptionCommentsCursorSchema = filledText(
61553
+ DESCRIPTION_COMMENT_BOUNDS.MAX_CURSOR_CHARS
61554
+ );
61555
+ var descriptionCommentsAnswerSchema = Schema_exports.Struct({
61556
+ threads: Schema_exports.Array(descriptionCommentThreadSchema),
61498
61557
  cursor: Schema_exports.String
61499
61558
  });
61500
61559
  var ANCHOR_TEXT = Schema_exports.String.check(Schema_exports.isMaxLength(TASK_BOUNDS.MAX_BODY_CHARS));
61501
- var planCommentPlanStartSchema = Schema_exports.Struct({
61560
+ var descriptionCommentDescriptionStartSchema = Schema_exports.Struct({
61502
61561
  id: Schema_exports.optionalKey(chosenIdSchema),
61503
- clientKey: planCommentClientKeySchema,
61504
- scope: Schema_exports.Literals([PLAN_COMMENT_SCOPE.WORDS, PLAN_COMMENT_SCOPE.BLOCK]),
61505
- quote: filledText(PLAN_COMMENT_BOUNDS.MAX_QUOTE_CHARS),
61506
- anchor: planCommentSpanSchema,
61562
+ clientKey: descriptionCommentClientKeySchema,
61563
+ scope: Schema_exports.Literals([DESCRIPTION_COMMENT_SCOPE.WORDS, DESCRIPTION_COMMENT_SCOPE.BLOCK]),
61564
+ quote: filledText(DESCRIPTION_COMMENT_BOUNDS.MAX_QUOTE_CHARS),
61565
+ anchor: descriptionCommentSpanSchema,
61507
61566
  text: ANCHOR_TEXT,
61508
- words: planCommentWordsSchema,
61509
- attachments: planCommentFilesSchema
61567
+ words: descriptionCommentWordsSchema,
61568
+ attachments: descriptionCommentFilesSchema
61510
61569
  });
61511
- var planCommentPageStartSchema = Schema_exports.Struct({
61570
+ var descriptionCommentPageStartSchema = Schema_exports.Struct({
61512
61571
  id: Schema_exports.optionalKey(chosenIdSchema),
61513
- clientKey: planCommentClientKeySchema,
61572
+ clientKey: descriptionCommentClientKeySchema,
61514
61573
  page: Schema_exports.Struct({ id: wireUuidSchema, version: pageVersionNumberSchema }),
61515
61574
  element: Schema_exports.optionalKey(
61516
61575
  Schema_exports.Struct({
61517
- path: planCommentElementPathSchema,
61518
- quote: filledText(PLAN_COMMENT_BOUNDS.MAX_QUOTE_CHARS),
61576
+ path: descriptionCommentElementPathSchema,
61577
+ quote: filledText(DESCRIPTION_COMMENT_BOUNDS.MAX_QUOTE_CHARS),
61519
61578
  section: Schema_exports.String.check(
61520
- Schema_exports.isMaxLength(PLAN_COMMENT_BOUNDS.MAX_SECTION_CHARS)
61579
+ Schema_exports.isMaxLength(DESCRIPTION_COMMENT_BOUNDS.MAX_SECTION_CHARS)
61521
61580
  ),
61522
61581
  /** Whether the quote is words selected in the element, which the page tints, rather than the element as a whole. */
61523
61582
  words: Schema_exports.optionalKey(Schema_exports.Literal(true))
61524
61583
  })
61525
61584
  ),
61526
- words: planCommentWordsSchema,
61527
- attachments: planCommentFilesSchema
61585
+ words: descriptionCommentWordsSchema,
61586
+ attachments: descriptionCommentFilesSchema,
61587
+ /** Whether the thread is held in a review: posted, but handed to no agent until the start that sends the review names it along. */
61588
+ held: Schema_exports.optionalKey(Schema_exports.Literal(true)),
61589
+ /** The threads of the same page this member started held in the review this start sends, by their ids, handed over together with this one; no more than a page holds. */
61590
+ along: Schema_exports.optionalKey(
61591
+ Schema_exports.Array(wireUuidSchema).check(
61592
+ Schema_exports.isMaxLength(DESCRIPTION_COMMENT_BOUNDS.MAX_THREADS_PER_DESCRIPTION)
61593
+ )
61594
+ )
61528
61595
  });
61529
- var planCommentStartRequestSchema = Schema_exports.Union([
61530
- planCommentPlanStartSchema,
61531
- planCommentPageStartSchema
61596
+ var descriptionCommentStartRequestSchema = Schema_exports.Union([
61597
+ descriptionCommentDescriptionStartSchema,
61598
+ descriptionCommentPageStartSchema
61532
61599
  ]);
61533
- var PLAN_COMMENT_ACTION = {
61600
+ var DESCRIPTION_COMMENT_ACTION = {
61534
61601
  REPLY: "reply",
61535
61602
  EDIT: "edit",
61536
61603
  DELETE: "delete",
61537
61604
  RESOLVE: "resolve",
61538
61605
  REOPEN: "reopen",
61539
61606
  DELETE_THREAD: "delete-thread",
61540
- /** Sends the thread to the app or one of the task's coding agents, to read with the plan and answer in the thread. */
61607
+ /** Sends the thread to the app or one of the task's coding agents, to read with the description and answer in the thread. */
61541
61608
  ASK: "ask"
61542
61609
  };
61543
- var planCommentActionRequestSchema = Schema_exports.Union([
61610
+ var descriptionCommentActionRequestSchema = Schema_exports.Union([
61544
61611
  Schema_exports.Struct({
61545
- action: Schema_exports.Literal(PLAN_COMMENT_ACTION.REPLY),
61546
- clientKey: planCommentClientKeySchema,
61547
- words: planCommentWordsSchema,
61548
- attachments: planCommentFilesSchema
61612
+ action: Schema_exports.Literal(DESCRIPTION_COMMENT_ACTION.REPLY),
61613
+ clientKey: descriptionCommentClientKeySchema,
61614
+ words: descriptionCommentWordsSchema,
61615
+ attachments: descriptionCommentFilesSchema
61549
61616
  }),
61550
61617
  Schema_exports.Struct({
61551
- action: Schema_exports.Literal(PLAN_COMMENT_ACTION.EDIT),
61618
+ action: Schema_exports.Literal(DESCRIPTION_COMMENT_ACTION.EDIT),
61552
61619
  entry: wireUuidSchema,
61553
- words: planCommentWordsSchema
61620
+ words: descriptionCommentWordsSchema
61554
61621
  }),
61555
61622
  Schema_exports.Struct({
61556
- action: Schema_exports.Literal(PLAN_COMMENT_ACTION.DELETE),
61623
+ action: Schema_exports.Literal(DESCRIPTION_COMMENT_ACTION.DELETE),
61557
61624
  entry: wireUuidSchema
61558
61625
  }),
61559
- Schema_exports.Struct({ action: Schema_exports.Literal(PLAN_COMMENT_ACTION.RESOLVE) }),
61560
- Schema_exports.Struct({ action: Schema_exports.Literal(PLAN_COMMENT_ACTION.REOPEN) }),
61561
- Schema_exports.Struct({ action: Schema_exports.Literal(PLAN_COMMENT_ACTION.DELETE_THREAD) })
61626
+ Schema_exports.Struct({ action: Schema_exports.Literal(DESCRIPTION_COMMENT_ACTION.RESOLVE) }),
61627
+ Schema_exports.Struct({ action: Schema_exports.Literal(DESCRIPTION_COMMENT_ACTION.REOPEN) }),
61628
+ Schema_exports.Struct({ action: Schema_exports.Literal(DESCRIPTION_COMMENT_ACTION.DELETE_THREAD) })
61562
61629
  ]);
61563
- var PLAN_COMMENT_REFUSAL = {
61564
- /** The plan already holds `PLAN_COMMENT_BOUNDS.MAX_THREADS_PER_PLAN` threads, or the thread its bound of comments. */
61630
+ var DESCRIPTION_COMMENT_REFUSAL = {
61631
+ /** The description already holds `DESCRIPTION_COMMENT_BOUNDS.MAX_THREADS_PER_DESCRIPTION` threads, or the thread its bound of comments. */
61565
61632
  TOO_MANY: "too-many",
61566
- /** The anchor names no words of the text it was measured in, or none of them stand in the plan now. */
61633
+ /** The anchor names no words of the text it was measured in, or none of them stand in the description now. */
61567
61634
  NO_WORDS: "no-words",
61568
61635
  /** The comment is someone else's, which only its writer edits or deletes. */
61569
61636
  NOT_YOURS: "not-yours",
61570
61637
  /** The comment named is not one of the thread's. */
61571
61638
  NO_ENTRY: "no-entry",
61572
- /** The key the reply was sent under already wrote to another thread of the plan. */
61639
+ /** The key the reply was sent under already wrote to another thread of the description. */
61573
61640
  KEY_TAKEN: "key-taken"
61574
61641
  };
61575
61642
  var writtenTxidSchema = Schema_exports.optionalKey(Schema_exports.String);
61576
- var planCommentThreadAnswerSchema = Schema_exports.Union([
61643
+ var descriptionCommentThreadAnswerSchema = Schema_exports.Union([
61577
61644
  Schema_exports.Struct({
61578
- thread: planCommentThreadSchema,
61645
+ thread: descriptionCommentThreadSchema,
61579
61646
  /** The ones a comment's mentions asked who could not take the thread, an agent whose session is not running say; absent where every one did. */
61580
- unsent: Schema_exports.optionalKey(Schema_exports.Array(planCommentAskedSchema)),
61647
+ unsent: Schema_exports.optionalKey(Schema_exports.Array(descriptionCommentAskedSchema)),
61581
61648
  txid: writtenTxidSchema
61582
61649
  }),
61583
61650
  Schema_exports.Struct({ deleted: wireUuidSchema, txid: writtenTxidSchema }),
61584
- Schema_exports.Struct({ refused: Schema_exports.Literals(Object.values(PLAN_COMMENT_REFUSAL)) })
61651
+ Schema_exports.Struct({
61652
+ refused: Schema_exports.Literals(Object.values(DESCRIPTION_COMMENT_REFUSAL))
61653
+ })
61585
61654
  ]);
61586
- var planCommentAnchorsSchema = Schema_exports.Struct({
61655
+ var descriptionCommentAnchorsSchema = Schema_exports.Struct({
61587
61656
  anchors: Schema_exports.Array(
61588
- Schema_exports.Struct({ thread: wireUuidSchema, ...planCommentSpanSchema.fields })
61589
- ).check(Schema_exports.isMaxLength(PLAN_COMMENT_BOUNDS.MAX_THREADS_PER_PLAN)),
61657
+ Schema_exports.Struct({ thread: wireUuidSchema, ...descriptionCommentSpanSchema.fields })
61658
+ ).check(Schema_exports.isMaxLength(DESCRIPTION_COMMENT_BOUNDS.MAX_THREADS_PER_DESCRIPTION)),
61590
61659
  carried: Schema_exports.Array(wireUuidSchema).check(
61591
- Schema_exports.isMaxLength(PLAN_COMMENT_BOUNDS.MAX_THREADS_PER_PLAN)
61660
+ Schema_exports.isMaxLength(DESCRIPTION_COMMENT_BOUNDS.MAX_THREADS_PER_DESCRIPTION)
61592
61661
  )
61593
61662
  });
61594
61663
 
61595
- // ../../packages/features/src/plan-edit.ts
61664
+ // ../../packages/features/src/description-edit.ts
61596
61665
  var DOCUMENT_TEXT = Schema_exports.String.check(
61597
61666
  Schema_exports.isMaxLength(TASK_BOUNDS.MAX_BODY_CHARS)
61598
61667
  );
61599
- var planEditRequestSchema = Schema_exports.Struct({
61668
+ var descriptionEditRequestSchema = Schema_exports.Struct({
61600
61669
  document: Schema_exports.Struct({ base: DOCUMENT_TEXT, value: DOCUMENT_TEXT }),
61601
- comments: Schema_exports.optionalKey(planCommentAnchorsSchema)
61670
+ comments: Schema_exports.optionalKey(descriptionCommentAnchorsSchema)
61602
61671
  });
61603
- var planEditValueSchema = DOCUMENT_TEXT;
61604
- var planEditConflictSchema = Schema_exports.Struct({
61605
- current: planEditValueSchema,
61606
- by: Schema_exports.optionalKey(planLastEditSchema)
61672
+ var descriptionEditValueSchema = DOCUMENT_TEXT;
61673
+ var descriptionEditConflictSchema = Schema_exports.Struct({
61674
+ current: descriptionEditValueSchema,
61675
+ by: Schema_exports.optionalKey(descriptionLastEditSchema)
61607
61676
  });
61608
- var PLAN_EDIT_REFUSAL = {
61609
- /** The plan with the edit would be longer than a plan may be. */
61677
+ var DESCRIPTION_EDIT_REFUSAL = {
61678
+ /** The description with the edit would be longer than a description may be. */
61610
61679
  TOO_LONG: "too-long"
61611
61680
  };
61612
- var planEditAnswerSchema = Schema_exports.Union([
61681
+ var descriptionEditAnswerSchema = Schema_exports.Union([
61613
61682
  Schema_exports.Struct({ plan: taskSchema, txid: Schema_exports.optionalKey(taskTxidSchema) }),
61614
- Schema_exports.Struct({ conflict: planEditConflictSchema }),
61615
- Schema_exports.Struct({ refused: Schema_exports.Literals(Object.values(PLAN_EDIT_REFUSAL)) })
61683
+ Schema_exports.Struct({ conflict: descriptionEditConflictSchema }),
61684
+ Schema_exports.Struct({ refused: Schema_exports.Literals(Object.values(DESCRIPTION_EDIT_REFUSAL)) })
61616
61685
  ]);
61617
61686
 
61618
61687
  // ../../packages/features/src/sentry-install-wire.ts
@@ -62147,7 +62216,7 @@ var tasksViewSchema = Schema_exports.Struct({
62147
62216
  repositoryPins: Schema_exports.optionalKey(Schema_exports.Array(repositoryPinSchema)),
62148
62217
  /** The sections the account made in its sidebars and the tasks it keeps in them, as last read or written; absent before the first read lands. */
62149
62218
  taskSections: Schema_exports.optionalKey(taskSectionsAnswerSchema),
62150
- /** The one active task, absent while the window has none open; its plan is held apart (`LIVE_READ.PLAN_DOCUMENT`). */
62219
+ /** The one active task, absent while the window has none open; its plan is held apart (`LIVE_READ.DESCRIPTION_DOCUMENT`). */
62151
62220
  activeTaskId: Schema_exports.optionalKey(Schema_exports.String)
62152
62221
  });
62153
62222
  var IDLE_TASKS_VIEW = {
@@ -62293,16 +62362,16 @@ var tasksChangeRelationAnswerSchema = Schema_exports.Union([
62293
62362
  ]);
62294
62363
  var tasksEditParamsSchema = Schema_exports.Struct({
62295
62364
  taskId: Schema_exports.NonEmptyString,
62296
- edit: planEditRequestSchema
62365
+ edit: descriptionEditRequestSchema
62297
62366
  });
62298
62367
  var EDIT_FAILURES = [
62299
62368
  TASK_CALL_FAILURE.UNANSWERED,
62300
62369
  TASK_CALL_FAILURE.NOT_FOUND,
62301
- PLAN_EDIT_REFUSAL.TOO_LONG
62370
+ DESCRIPTION_EDIT_REFUSAL.TOO_LONG
62302
62371
  ];
62303
62372
  var tasksEditAnswerSchema = Schema_exports.Union([
62304
62373
  Schema_exports.Struct({ saved: Schema_exports.Literal(true) }),
62305
- Schema_exports.Struct({ conflict: planEditConflictSchema }),
62374
+ Schema_exports.Struct({ conflict: descriptionEditConflictSchema }),
62306
62375
  Schema_exports.Struct({ failure: Schema_exports.Literals(EDIT_FAILURES) })
62307
62376
  ]);
62308
62377
  var repositoryPlaceFields = {
@@ -62377,10 +62446,10 @@ var tasksFindAnswerSchema = Schema_exports.Union([
62377
62446
  ]);
62378
62447
  var tasksRevisionsParamsSchema = Schema_exports.Struct({
62379
62448
  taskId: Schema_exports.NonEmptyString,
62380
- before: Schema_exports.optionalKey(planRevisionSeqSchema)
62449
+ before: Schema_exports.optionalKey(descriptionRevisionSeqSchema)
62381
62450
  });
62382
62451
  var tasksRevisionsAnswerSchema = Schema_exports.Union([
62383
- planRevisionsAnswerSchema,
62452
+ descriptionRevisionsAnswerSchema,
62384
62453
  Schema_exports.Struct({ failure: Schema_exports.Literal(TASK_CALL_FAILURE.UNANSWERED) })
62385
62454
  ]);
62386
62455
  var taskDocumentFollowSchema = Schema_exports.Struct({
@@ -62389,10 +62458,10 @@ var taskDocumentFollowSchema = Schema_exports.Struct({
62389
62458
  var taskHistoryFollowSchema = Schema_exports.Struct({ taskId: Schema_exports.NonEmptyString });
62390
62459
  var tasksRevisionParamsSchema = Schema_exports.Struct({
62391
62460
  taskId: Schema_exports.NonEmptyString,
62392
- seq: planRevisionSeqSchema
62461
+ seq: descriptionRevisionSeqSchema
62393
62462
  });
62394
62463
  var tasksRevisionAnswerSchema = Schema_exports.Union([
62395
- planRevisionAnswerSchema,
62464
+ descriptionRevisionAnswerSchema,
62396
62465
  Schema_exports.Struct({ failure: Schema_exports.Literal(TASK_CALL_FAILURE.UNANSWERED) })
62397
62466
  ]);
62398
62467
  var tasksPictureParamsSchema = Schema_exports.Struct({
@@ -62401,7 +62470,7 @@ var tasksPictureParamsSchema = Schema_exports.Struct({
62401
62470
  });
62402
62471
  var tasksPictureAnswerSchema = Schema_exports.Union([
62403
62472
  Schema_exports.Struct({
62404
- contentType: planAttachmentTypeSchema,
62473
+ contentType: descriptionAttachmentTypeSchema,
62405
62474
  base64: Schema_exports.String
62406
62475
  }),
62407
62476
  Schema_exports.Struct({
@@ -62435,7 +62504,7 @@ var tasksPageParamsSchema = Schema_exports.Union([
62435
62504
  })
62436
62505
  ]);
62437
62506
  var tasksPageAnswerSchema = Schema_exports.Union([
62438
- planPageVersionAnswerSchema,
62507
+ taskPageVersionAnswerSchema,
62439
62508
  Schema_exports.Struct({ failure: Schema_exports.Literal(TASK_CALL_FAILURE.UNANSWERED) })
62440
62509
  ]);
62441
62510
  var tasksPageSourceAnswerSchema = Schema_exports.Union([
@@ -62500,12 +62569,12 @@ var tasksGitHubDisconnectAnswerSchema = Schema_exports.Union([
62500
62569
  failure: Schema_exports.Literals(Object.values(GITHUB_DISCONNECT_FAILURE))
62501
62570
  })
62502
62571
  ]);
62503
- var PLAN_COMMENT_CALL_FAILURE = {
62572
+ var DESCRIPTION_COMMENT_CALL_FAILURE = {
62504
62573
  UNANSWERED: TASK_CALL_FAILURE.UNANSWERED,
62505
62574
  NOT_FOUND: TASK_CALL_FAILURE.NOT_FOUND
62506
62575
  };
62507
- var planCommentFailedSchema = Schema_exports.Struct({
62508
- failure: Schema_exports.Literals(Object.values(PLAN_COMMENT_CALL_FAILURE))
62576
+ var descriptionCommentFailedSchema = Schema_exports.Struct({
62577
+ failure: Schema_exports.Literals(Object.values(DESCRIPTION_COMMENT_CALL_FAILURE))
62509
62578
  });
62510
62579
  var tasksCommentsFollowSchema = Schema_exports.Struct({
62511
62580
  taskId: Schema_exports.NonEmptyString,
@@ -62513,16 +62582,16 @@ var tasksCommentsFollowSchema = Schema_exports.Struct({
62513
62582
  });
62514
62583
  var tasksCommentStartParamsSchema = Schema_exports.Struct({
62515
62584
  planId: Schema_exports.NonEmptyString,
62516
- start: planCommentStartRequestSchema
62585
+ start: descriptionCommentStartRequestSchema
62517
62586
  });
62518
62587
  var tasksCommentActParamsSchema = Schema_exports.Struct({
62519
62588
  planId: Schema_exports.NonEmptyString,
62520
62589
  threadId: Schema_exports.NonEmptyString,
62521
- action: planCommentActionRequestSchema
62590
+ action: descriptionCommentActionRequestSchema
62522
62591
  });
62523
62592
  var tasksCommentAnswerSchema = Schema_exports.Union([
62524
- planCommentThreadAnswerSchema,
62525
- planCommentFailedSchema
62593
+ descriptionCommentThreadAnswerSchema,
62594
+ descriptionCommentFailedSchema
62526
62595
  ]);
62527
62596
 
62528
62597
  // ../../packages/features/src/github-connection-wire.ts
@@ -62569,8 +62638,8 @@ var taskPageVersionSchema = Schema_exports.Struct({
62569
62638
  version: Schema_exports.String
62570
62639
  });
62571
62640
  var pictureKeptSchema = Schema_exports.Struct({
62572
- status: Schema_exports.Literals(Object.values(PLAN_ATTACHMENT_STATUS)),
62573
- body: planAttachmentAnswerSchema
62641
+ status: Schema_exports.Literals(Object.values(DESCRIPTION_ATTACHMENT_STATUS)),
62642
+ body: descriptionAttachmentAnswerSchema
62574
62643
  });
62575
62644
  var TASK_PATH = `${HOSTED_SERVICE_PATH.TASKS}/{id}`;
62576
62645
  var taskFilesContract = {
@@ -62584,14 +62653,14 @@ var taskFilesContract = {
62584
62653
  inputStructure: "detailed",
62585
62654
  outputStructure: "detailed"
62586
62655
  })
62587
- ).input(exactBodyInput(taskInputSchema, planAttachmentRequestSchema)).output(Schema_exports.flip(pictureKeptSchema)),
62656
+ ).input(exactBodyInput(taskInputSchema, descriptionAttachmentRequestSchema)).output(Schema_exports.flip(pictureKeptSchema)),
62588
62657
  pages: hostedProcedure.meta(openapi({ method: HTTP_METHOD.GET, path: `${TASK_PATH}/pages` })).input(taskInputSchema).output(Schema_exports.flip(taskPagesAnswerSchema)),
62589
62658
  page: hostedProcedure.meta(
62590
62659
  openapi({
62591
62660
  method: HTTP_METHOD.GET,
62592
62661
  path: `${TASK_PATH}/pages/{page}/versions/{version}`
62593
62662
  })
62594
- ).input(taskPageVersionSchema).output(Schema_exports.flip(planPageVersionAnswerSchema)),
62663
+ ).input(taskPageVersionSchema).output(Schema_exports.flip(taskPageVersionAnswerSchema)),
62595
62664
  /** One version of one page as a browser's frame loads it: sent on to its short-lived link on the sandbox's own site, or to the page saying pages open in the Mac app where the deployment has no sandbox. */
62596
62665
  pageFrame: hostedProcedure.meta(
62597
62666
  openapi({
@@ -62691,7 +62760,7 @@ var CLOSE_BODY_BYTES = 6 * INBOX_BOUNDS.MAX_MESSAGE_CHARS + MAXIMUM_ATTACHMENTS_
62691
62760
  var MESSAGE_BODY_BYTES = 6 * (INBOX_BOUNDS.MAX_MESSAGE_CHARS + INBOX_BOUNDS.MAX_FIELDS * (INBOX_BOUNDS.MAX_LABEL_CHARS + INBOX_BOUNDS.MAX_FIELD_VALUE_CHARS) + INBOX_BOUNDS.MAX_OPTIONS * INBOX_BOUNDS.MAX_LABEL_CHARS) + MAXIMUM_ATTACHMENTS_BODY_BYTES + 2048;
62692
62761
  var START_BODY_BYTES = 6 * (INBOX_BOUNDS.MAX_TITLE_CHARS + INBOX_BOUNDS.MAX_MESSAGE_CHARS) + MAXIMUM_ATTACHMENTS_BODY_BYTES + 2048;
62693
62762
  var READ_ALL_BODY_BYTES = 1024;
62694
- var SNOOZE_BODY_BYTES = 1024;
62763
+ var REMIND_BODY_BYTES = 1024;
62695
62764
  var INBOX_PROCEDURE_PATH = {
62696
62765
  TASK: "/api/plans/{id}/inbox",
62697
62766
  AGENT: "/api/agents/{id}/inbox",
@@ -62699,6 +62768,7 @@ var INBOX_PROCEDURE_PATH = {
62699
62768
  ITEM_CLOSE: "/api/inbox/{id}/close",
62700
62769
  ITEM_MESSAGES: "/api/inbox/{id}/messages",
62701
62770
  ITEM_READ: "/api/inbox/{id}/read",
62771
+ ITEM_REMIND: "/api/inbox/{id}/remind",
62702
62772
  ITEM_SNOOZE: "/api/inbox/{id}/snooze"
62703
62773
  };
62704
62774
  var pathIdSchema = Schema_exports.Struct({ id: Schema_exports.String });
@@ -62743,13 +62813,21 @@ var inboxContract = {
62743
62813
  start: hostedProcedure.meta(bodyCap(START_BODY_BYTES)).meta(openapi({ method: HTTP_METHOD.POST, path: HOSTED_SERVICE_PATH.INBOX })).input(exactInput(inboxStartRequestSchema)).output(Schema_exports.flip(inboxMessagedSchema)),
62744
62814
  markItemRead: hostedProcedure.meta(openapi({ method: HTTP_METHOD.PUT, path: INBOX_PROCEDURE_PATH.ITEM_READ })).input(pathIdSchema).output(Schema_exports.flip(inboxReadStateSchema)),
62745
62815
  markItemUnread: hostedProcedure.meta(openapi({ method: HTTP_METHOD.DELETE, path: INBOX_PROCEDURE_PATH.ITEM_READ })).input(pathIdSchema).output(Schema_exports.flip(inboxReadStateSchema)),
62746
- snoozeItem: hostedProcedure.meta(bodyCap(SNOOZE_BODY_BYTES)).meta(
62816
+ remindItem: hostedProcedure.meta(bodyCap(REMIND_BODY_BYTES)).meta(
62817
+ openapi({
62818
+ method: HTTP_METHOD.PUT,
62819
+ path: INBOX_PROCEDURE_PATH.ITEM_REMIND,
62820
+ inputStructure: "detailed"
62821
+ })
62822
+ ).input(exactBodyInput(pathIdSchema, inboxRemindRequestSchema)).output(Schema_exports.flip(inboxReadStateSchema)),
62823
+ /** `remindItem` under the path a desktop built before the rename still calls; goes once the releases after it are out. */
62824
+ snoozeItem: hostedProcedure.meta(bodyCap(REMIND_BODY_BYTES)).meta(
62747
62825
  openapi({
62748
62826
  method: HTTP_METHOD.PUT,
62749
62827
  path: INBOX_PROCEDURE_PATH.ITEM_SNOOZE,
62750
62828
  inputStructure: "detailed"
62751
62829
  })
62752
- ).input(exactBodyInput(pathIdSchema, inboxSnoozeRequestSchema)).output(Schema_exports.flip(inboxReadStateSchema)),
62830
+ ).input(exactBodyInput(pathIdSchema, inboxRemindRequestSchema)).output(Schema_exports.flip(inboxReadStateSchema)),
62753
62831
  markAllRead: hostedProcedure.meta(bodyCap(READ_ALL_BODY_BYTES)).meta(openapi({ method: HTTP_METHOD.PUT, path: HOSTED_SERVICE_PATH.INBOX_READ })).input(exactInput(inboxReadAllRequestSchema)).output(Schema_exports.flip(inboxReadAllSchema))
62754
62832
  };
62755
62833
 
@@ -62757,8 +62835,6 @@ var inboxContract = {
62757
62835
  var PASTE_BODY_BYTES = INSTALLED_SKILL_PASTE_MAX_CHARS * 6 + 16384;
62758
62836
  var SMALL_BODY_BYTES2 = 1024;
62759
62837
  var INSTALLED_SKILL_PATH = `${HOSTED_SERVICE_PATH.INSTALLED_SKILLS}/{id}`;
62760
- var INSTALLED_SKILL_UPDATE_PATH = `${INSTALLED_SKILL_PATH}/update`;
62761
- var INSTALLED_SKILL_SHARE_PATH = `${INSTALLED_SKILL_PATH}/share`;
62762
62838
  var pathId2 = { id: Schema_exports.String };
62763
62839
  var CREATED_STATUS = 201;
62764
62840
  var installedSkillsContract = {
@@ -62781,27 +62857,6 @@ var installedSkillsContract = {
62781
62857
  successStatus: CREATED_STATUS
62782
62858
  })
62783
62859
  ).input(exactInput(installedSkillInstallRequestSchema)).output(Schema_exports.flip(installedSkillInstallAnswerSchema)),
62784
- setEnabled: hostedProcedure.meta(bodyCap(SMALL_BODY_BYTES2)).meta(
62785
- openapi({
62786
- method: HTTP_METHOD.PATCH,
62787
- path: INSTALLED_SKILL_PATH,
62788
- inputStructure: "detailed"
62789
- })
62790
- ).input(exactBodyInput(Schema_exports.Struct(pathId2), installedSkillToggleRequestSchema)).output(Schema_exports.flip(installedSkillAnswerSchema)),
62791
- update: hostedProcedure.meta(bodyCap(SMALL_BODY_BYTES2)).meta(
62792
- openapi({
62793
- method: HTTP_METHOD.POST,
62794
- path: INSTALLED_SKILL_UPDATE_PATH,
62795
- inputStructure: "detailed"
62796
- })
62797
- ).input(exactBodyInput(Schema_exports.Struct(pathId2), installedSkillUpdateRequestSchema)).output(Schema_exports.flip(installedSkillUpdatedAnswerSchema)),
62798
- share: hostedProcedure.meta(bodyCap(SMALL_BODY_BYTES2)).meta(
62799
- openapi({
62800
- method: HTTP_METHOD.POST,
62801
- path: INSTALLED_SKILL_SHARE_PATH,
62802
- inputStructure: "detailed"
62803
- })
62804
- ).input(exactBodyInput(Schema_exports.Struct(pathId2), installedSkillShareRequestSchema)).output(Schema_exports.flip(installedSkillAnswerSchema)),
62805
62860
  remove: hostedProcedure.meta(bodyCap(SMALL_BODY_BYTES2)).meta(openapi({ method: HTTP_METHOD.DELETE, path: INSTALLED_SKILL_PATH })).input(Schema_exports.Struct(pathId2)).output(Schema_exports.flip(installedSkillRemovedAnswerSchema))
62806
62861
  };
62807
62862
 
@@ -63039,7 +63094,8 @@ var installedSkillLiveRowSchema = Schema_exports.Struct({
63039
63094
  description: Schema_exports.String,
63040
63095
  userInvocable: Schema_exports.Boolean,
63041
63096
  source: installedSkillSourceSchema,
63042
- enabled: Schema_exports.Boolean,
63097
+ /** Always true, since every installed skill is on. */
63098
+ enabled: Schema_exports.Literal(true),
63043
63099
  workspaceId: Schema_exports.NullOr(Schema_exports.String),
63044
63100
  installedBy: Schema_exports.NullOr(Schema_exports.String),
63045
63101
  manageable: Schema_exports.Boolean,
@@ -63091,7 +63147,7 @@ var workspaceMemoriesLiveRowsSchema = Schema_exports.Struct({
63091
63147
  memories: Schema_exports.Array(memoryLiveRowSchema)
63092
63148
  });
63093
63149
 
63094
- // ../../packages/features/src/plan-comment-live.ts
63150
+ // ../../packages/features/src/description-comment-live.ts
63095
63151
  var taskCommentsLiveAnswerSchema = Schema_exports.Struct({
63096
63152
  url: Schema_exports.String,
63097
63153
  queries: Schema_exports.Struct({
@@ -63102,7 +63158,7 @@ var taskCommentsLiveAnswerSchema = Schema_exports.Struct({
63102
63158
  });
63103
63159
  var threadLiveRowSchema = Schema_exports.Struct({
63104
63160
  id: Schema_exports.String,
63105
- scope: Schema_exports.Literals(Object.values(PLAN_COMMENT_SCOPE)),
63161
+ scope: Schema_exports.Literals(Object.values(DESCRIPTION_COMMENT_SCOPE)),
63106
63162
  quote: Schema_exports.String,
63107
63163
  anchorFrom: Schema_exports.NullOr(countedNumber),
63108
63164
  anchorTo: Schema_exports.NullOr(countedNumber),
@@ -63110,7 +63166,7 @@ var threadLiveRowSchema = Schema_exports.Struct({
63110
63166
  pageId: Schema_exports.NullOr(Schema_exports.String),
63111
63167
  pageVersion: Schema_exports.NullOr(pageVersionNumberSchema),
63112
63168
  pageElement: Schema_exports.NullOr(Schema_exports.String),
63113
- status: Schema_exports.Literals(Object.values(PLAN_COMMENT_STATUS)),
63169
+ status: Schema_exports.Literals(Object.values(DESCRIPTION_COMMENT_STATUS)),
63114
63170
  revision: countedNumber,
63115
63171
  createdAt: countedNumber,
63116
63172
  updatedAt: countedNumber
@@ -63119,13 +63175,13 @@ var entryLiveRowSchema = Schema_exports.Struct({
63119
63175
  id: Schema_exports.String,
63120
63176
  threadId: Schema_exports.String,
63121
63177
  seq: countedNumber,
63122
- kind: Schema_exports.Literals(Object.values(PLAN_COMMENT_ENTRY)),
63123
- actor: planCommentActorSchema,
63178
+ kind: Schema_exports.Literals(Object.values(DESCRIPTION_COMMENT_ENTRY)),
63179
+ actor: descriptionCommentActorSchema,
63124
63180
  userId: Schema_exports.NullOr(Schema_exports.String),
63125
63181
  userName: Schema_exports.NullOr(Schema_exports.String),
63126
63182
  agentId: Schema_exports.NullOr(Schema_exports.String),
63127
63183
  words: Schema_exports.NullOr(Schema_exports.String),
63128
- askedActor: Schema_exports.NullOr(planCommentActorSchema),
63184
+ askedActor: Schema_exports.NullOr(descriptionCommentActorSchema),
63129
63185
  askedAgentId: Schema_exports.NullOr(Schema_exports.String),
63130
63186
  createdAt: countedNumber,
63131
63187
  editedAt: Schema_exports.NullOr(countedNumber)
@@ -63329,16 +63385,6 @@ var pullRequestChaptersAnswerViewSchema = Schema_exports.Union([
63329
63385
  failure: Schema_exports.Literals(Object.values(PULL_REQUEST_CHAPTERS_CALL_FAILURE))
63330
63386
  })
63331
63387
  ]);
63332
- var chaptersModelWriteParamsSchema = Schema_exports.Struct({ model: chaptersModelSchema });
63333
- var chaptersModelAnswerViewSchema = Schema_exports.Union([
63334
- Schema_exports.Struct({
63335
- model: chaptersModelSchema,
63336
- txid: Schema_exports.optionalKey(Schema_exports.String)
63337
- }),
63338
- Schema_exports.Struct({
63339
- failure: Schema_exports.Literals(Object.values(PULL_REQUEST_CHAPTERS_CALL_FAILURE))
63340
- })
63341
- ]);
63342
63388
 
63343
63389
  // ../../packages/features/src/pull-request-chapters-live.ts
63344
63390
  var pullRequestChaptersLiveAnswerSchema = Schema_exports.Struct({
@@ -63441,9 +63487,13 @@ var taskLiveRowSchema = Schema_exports.Struct({
63441
63487
  priority: taskPrioritySchema,
63442
63488
  /** The task's number in its workspace, from 1, as the list says it; absent from a row the host draws for a task it started before the service numbered it. */
63443
63489
  number: Schema_exports.optionalKey(Schema_exports.Int.check(Schema_exports.isGreaterThanOrEqualTo(1))),
63444
- /** Who made the task for its owner (`PLAN_ACTOR`); absent from a service before it was sent, read as made by hand. */
63490
+ /** Who made the task for its owner (`DESCRIPTION_ACTOR`); absent from a service before it was sent, read as made by hand. */
63445
63491
  creatorActor: Schema_exports.optionalKey(
63446
- Schema_exports.Literals([PLAN_ACTOR.DEVELOPER, PLAN_ACTOR.NOTETAKER, PLAN_ACTOR.AGENT])
63492
+ Schema_exports.Literals([
63493
+ DESCRIPTION_ACTOR.DEVELOPER,
63494
+ DESCRIPTION_ACTOR.NOTETAKER,
63495
+ DESCRIPTION_ACTOR.AGENT
63496
+ ])
63447
63497
  ),
63448
63498
  /** The coding agent that made the task; null for any other maker and once its row is gone. */
63449
63499
  creatorAgentId: Schema_exports.optionalKey(Schema_exports.NullOr(Schema_exports.String)),
@@ -63474,8 +63524,8 @@ var agentLiveRowSchema = Schema_exports.Struct({
63474
63524
  title: Schema_exports.NullOr(Schema_exports.String),
63475
63525
  /** Whether the agent is its task's pilot; absent from a statement before pilots. */
63476
63526
  pilot: Schema_exports.optionalKey(Schema_exports.Boolean),
63477
- /** Whether the agent was handed a prompt rather than its plan. */
63478
- /** What the agent was handed as its first message: the plan, the developer's prompt, or nothing, for one started blank. */
63527
+ /** Whether the agent was handed a prompt rather than its description. */
63528
+ /** What the agent was handed as its first message: the description, the developer's prompt, or nothing, for one started blank. */
63479
63529
  brief: Schema_exports.Literals(Object.values(AGENT_BRIEF)),
63480
63530
  /** The repository the agent works in; null for one that works in none. */
63481
63531
  repository: Schema_exports.NullOr(Schema_exports.String),
@@ -63925,26 +63975,26 @@ var modelsContract = {
63925
63975
  list: hostedProcedure.meta(openapi({ method: HTTP_METHOD.GET, path: HOSTED_SERVICE_PATH.MODELS })).output(Schema_exports.flip(modelsAnswerSchema))
63926
63976
  };
63927
63977
 
63928
- // ../../packages/features/src/contract/plan-comments.ts
63929
- var START_BODY_BYTES2 = (TASK_BOUNDS.MAX_BODY_CHARS + PLAN_COMMENT_BOUNDS.MAX_WORDS_CHARS + PLAN_COMMENT_BOUNDS.MAX_QUOTE_CHARS) * 6 + MAXIMUM_ATTACHMENTS_BODY_BYTES + 1024;
63930
- var ACTION_BODY_BYTES = PLAN_COMMENT_BOUNDS.MAX_WORDS_CHARS * 6 + MAXIMUM_ATTACHMENTS_BODY_BYTES + 1024;
63978
+ // ../../packages/features/src/contract/description-comments.ts
63979
+ var START_BODY_BYTES2 = (TASK_BOUNDS.MAX_BODY_CHARS + DESCRIPTION_COMMENT_BOUNDS.MAX_WORDS_CHARS + DESCRIPTION_COMMENT_BOUNDS.MAX_QUOTE_CHARS) * 6 + MAXIMUM_ATTACHMENTS_BODY_BYTES + 1024;
63980
+ var ACTION_BODY_BYTES = DESCRIPTION_COMMENT_BOUNDS.MAX_WORDS_CHARS * 6 + MAXIMUM_ATTACHMENTS_BODY_BYTES + 1024;
63931
63981
  var COMMENTS_PATH = `${HOSTED_SERVICE_PATH.TASKS}/{id}/comments`;
63932
63982
  var taskIdField = { id: Schema_exports.String };
63933
63983
  var threadParamsSchema = Schema_exports.Struct({ ...taskIdField, thread: Schema_exports.String });
63934
63984
  var START_STATUSES = [201, 200];
63935
- var planCommentStartAnswerSchema = Schema_exports.Struct({
63985
+ var descriptionCommentStartAnswerSchema = Schema_exports.Struct({
63936
63986
  status: Schema_exports.Literals(START_STATUSES),
63937
- body: planCommentThreadAnswerSchema
63987
+ body: descriptionCommentThreadAnswerSchema
63938
63988
  });
63939
- var planCommentsContract = {
63989
+ var descriptionCommentsContract = {
63940
63990
  /** The plan's threads, or the threads of the task's page `page` names, past the cursor `after` names, held while nothing moved; the start where it names none. */
63941
63991
  read: hostedProcedure.meta(openapi({ method: HTTP_METHOD.GET, path: COMMENTS_PATH })).input(
63942
63992
  Schema_exports.Struct({
63943
63993
  ...taskIdField,
63944
63994
  page: Schema_exports.optionalKey(Schema_exports.String),
63945
- after: Schema_exports.optionalKey(planCommentsCursorSchema)
63995
+ after: Schema_exports.optionalKey(descriptionCommentsCursorSchema)
63946
63996
  })
63947
- ).output(Schema_exports.flip(planCommentsAnswerSchema)),
63997
+ ).output(Schema_exports.flip(descriptionCommentsAnswerSchema)),
63948
63998
  /** A thread started with its first comment. */
63949
63999
  start: hostedProcedure.meta(bodyCap(START_BODY_BYTES2)).meta(
63950
64000
  openapi({
@@ -63953,7 +64003,7 @@ var planCommentsContract = {
63953
64003
  inputStructure: "detailed",
63954
64004
  outputStructure: "detailed"
63955
64005
  })
63956
- ).input(exactBodyInput(Schema_exports.Struct(taskIdField), planCommentStartRequestSchema)).output(Schema_exports.flip(planCommentStartAnswerSchema)),
64006
+ ).input(exactBodyInput(Schema_exports.Struct(taskIdField), descriptionCommentStartRequestSchema)).output(Schema_exports.flip(descriptionCommentStartAnswerSchema)),
63957
64007
  /** One thing done to one thread of the plan. */
63958
64008
  act: hostedProcedure.meta(bodyCap(ACTION_BODY_BYTES)).meta(
63959
64009
  openapi({
@@ -63961,7 +64011,7 @@ var planCommentsContract = {
63961
64011
  path: `${COMMENTS_PATH}/{thread}`,
63962
64012
  inputStructure: "detailed"
63963
64013
  })
63964
- ).input(exactBodyInput(threadParamsSchema, planCommentActionRequestSchema)).output(Schema_exports.flip(planCommentThreadAnswerSchema))
64014
+ ).input(exactBodyInput(threadParamsSchema, descriptionCommentActionRequestSchema)).output(Schema_exports.flip(descriptionCommentThreadAnswerSchema))
63965
64015
  };
63966
64016
 
63967
64017
  // ../../packages/features/src/contract/pull-request-chapters.ts
@@ -64101,11 +64151,12 @@ var BRIEF_BYTES = TASK_BOUNDS.MAX_BRIEF_CHARS * 6;
64101
64151
  var START_BODY_BYTES3 = NAME_BODY_BYTES + BRIEF_BYTES + MAXIMUM_START_BODY_BYTES;
64102
64152
  var EDIT_BODY_BYTES = TASK_BOUNDS.MAX_BODY_CHARS * 2 * 6 + 1024;
64103
64153
  var PLAN = `${HOSTED_SERVICE_PATH.TASKS}/{id}`;
64104
- var REVISIONS = `${PLAN}/revisions`;
64154
+ var DESCRIPTION = `${PLAN}/description`;
64155
+ var REVISIONS = `${DESCRIPTION}/revisions`;
64105
64156
  var REVISION = `${REVISIONS}/{seq}`;
64106
64157
  var taskParams = { id: Schema_exports.String };
64107
64158
  var revisionSeqText = Schema_exports.NumberFromString.pipe(
64108
- Schema_exports.decodeTo(planRevisionSeqSchema)
64159
+ Schema_exports.decodeTo(descriptionRevisionSeqSchema)
64109
64160
  );
64110
64161
  var MAX_TASK_NUMBER = 2147483647;
64111
64162
  var taskNumberText = Schema_exports.NumberFromString.pipe(
@@ -64158,15 +64209,15 @@ var tasksContract = {
64158
64209
  openapi({ method: HTTP_METHOD.POST, path: `${PLAN}/relation`, inputStructure: "detailed" })
64159
64210
  ).input(exactBodyInput(Schema_exports.Struct(taskParams), taskRelationChangeRequestSchema)).output(Schema_exports.flip(taskAnswerSchema)),
64160
64211
  delete: hostedProcedure.meta(openapi({ method: HTTP_METHOD.DELETE, path: PLAN })).input(Schema_exports.Struct(taskParams)).output(Schema_exports.flip(taskDeleteAnswerSchema)),
64161
- /** The developer's edit of the document. */
64162
- edit: hostedProcedure.meta(bodyCap(EDIT_BODY_BYTES)).meta(openapi({ method: HTTP_METHOD.POST, path: `${PLAN}/edit`, inputStructure: "detailed" })).input(exactBodyInput(Schema_exports.Struct(taskParams), planEditRequestSchema)).output(Schema_exports.flip(planEditAnswerSchema)),
64163
- /** A page of the plan's history, before the revision `before` names where it names one. */
64164
- revisions: hostedProcedure.meta(openapi({ method: HTTP_METHOD.GET, path: REVISIONS })).input(
64212
+ /** The developer's edit of the description. */
64213
+ editDescription: hostedProcedure.meta(bodyCap(EDIT_BODY_BYTES)).meta(openapi({ method: HTTP_METHOD.POST, path: DESCRIPTION, inputStructure: "detailed" })).input(exactBodyInput(Schema_exports.Struct(taskParams), descriptionEditRequestSchema)).output(Schema_exports.flip(descriptionEditAnswerSchema)),
64214
+ /** A page of the description's history, before the revision `before` names where it names one. */
64215
+ descriptionRevisions: hostedProcedure.meta(openapi({ method: HTTP_METHOD.GET, path: REVISIONS })).input(
64165
64216
  Schema_exports.Struct({ ...taskParams, before: Schema_exports.optionalKey(revisionSeqText) })
64166
- ).output(Schema_exports.flip(planRevisionsAnswerSchema)),
64167
- revision: hostedProcedure.meta(openapi({ method: HTTP_METHOD.GET, path: REVISION })).input(Schema_exports.Struct({ ...taskParams, seq: revisionSeqText })).output(Schema_exports.flip(planRevisionAnswerSchema)),
64168
- /** One revision put back as the plan's content. */
64169
- restore: hostedProcedure.meta(openapi({ method: HTTP_METHOD.POST, path: `${REVISION}/restore` })).input(Schema_exports.Struct({ ...taskParams, seq: revisionSeqText })).output(Schema_exports.flip(taskRestoreAnswerSchema))
64217
+ ).output(Schema_exports.flip(descriptionRevisionsAnswerSchema)),
64218
+ descriptionRevision: hostedProcedure.meta(openapi({ method: HTTP_METHOD.GET, path: REVISION })).input(Schema_exports.Struct({ ...taskParams, seq: revisionSeqText })).output(Schema_exports.flip(descriptionRevisionAnswerSchema)),
64219
+ /** One revision put back as the description's content. */
64220
+ restoreDescription: hostedProcedure.meta(openapi({ method: HTTP_METHOD.POST, path: `${REVISION}/restore` })).input(Schema_exports.Struct({ ...taskParams, seq: revisionSeqText })).output(Schema_exports.flip(taskRestoreAnswerSchema))
64170
64221
  };
64171
64222
 
64172
64223
  // ../../packages/features/src/contract/workspace-github.ts
@@ -64291,6 +64342,7 @@ var hostedContract = {
64291
64342
  admin: adminContract,
64292
64343
  agentBrowserTabs: agentBrowserTabsContract,
64293
64344
  agentPages: agentPagesContract,
64345
+ agentPorts: agentPortsContract,
64294
64346
  agentPullRequests: agentPullRequestsContract,
64295
64347
  agents: agentsContract,
64296
64348
  automations: automationsContract,
@@ -64308,7 +64360,7 @@ var hostedContract = {
64308
64360
  mcpClients: mcpClientsContract,
64309
64361
  messages: messagesContract,
64310
64362
  models: modelsContract,
64311
- planComments: planCommentsContract,
64363
+ descriptionComments: descriptionCommentsContract,
64312
64364
  plans: tasksContract,
64313
64365
  pullRequestChapters: pullRequestChaptersContract,
64314
64366
  pullRequests: pullRequestsContract,
@@ -64560,7 +64612,6 @@ var START_REFUSALS = {
64560
64612
  [HOSTED_API_ERROR.GITHUB_UNANSWERED]: AGENT_CALL_FAILURE.GITHUB_UNANSWERED,
64561
64613
  [HOSTED_API_ERROR.INVALID_REQUEST]: AGENT_CALL_FAILURE.INVALID_CHOICE,
64562
64614
  [HOSTED_API_ERROR.NOT_PERMITTED]: AGENT_CALL_FAILURE.NOT_PERMITTED,
64563
- [HOSTED_API_ERROR.AGENT_IMAGE_PREPARING]: AGENT_CALL_FAILURE.AGENT_IMAGE_PREPARING,
64564
64615
  [HOSTED_API_ERROR.NATIVE_AGENT_NOT_HERE]: AGENT_CALL_FAILURE.NATIVE_AGENT_NOT_HERE,
64565
64616
  [HOSTED_API_ERROR.AGENT_PLAN_SIGNED_OUT]: AGENT_CALL_FAILURE.AGENT_PLAN_SIGNED_OUT,
64566
64617
  [HOSTED_API_ERROR.AGENT_PLAN_UNREACHABLE]: AGENT_CALL_FAILURE.AGENT_PLAN_UNREACHABLE,
@@ -64599,7 +64650,6 @@ var MESSAGE_REFUSALS = {
64599
64650
  [HOSTED_API_ERROR.REPOSITORY_NOT_REACHABLE]: AGENT_CALL_FAILURE.REPOSITORY_NOT_REACHABLE,
64600
64651
  [HOSTED_API_ERROR.GITHUB_UNANSWERED]: AGENT_CALL_FAILURE.GITHUB_UNANSWERED,
64601
64652
  [HOSTED_API_ERROR.NOT_PERMITTED]: AGENT_CALL_FAILURE.NOT_PERMITTED,
64602
- [HOSTED_API_ERROR.AGENT_IMAGE_PREPARING]: AGENT_CALL_FAILURE.AGENT_IMAGE_PREPARING,
64603
64653
  [HOSTED_API_ERROR.NATIVE_AGENT_NOT_HERE]: AGENT_CALL_FAILURE.NATIVE_AGENT_NOT_HERE,
64604
64654
  [HOSTED_API_ERROR.AGENT_PLAN_SIGNED_OUT]: AGENT_CALL_FAILURE.AGENT_PLAN_SIGNED_OUT,
64605
64655
  [HOSTED_API_ERROR.AGENT_PLAN_UNREACHABLE]: AGENT_CALL_FAILURE.AGENT_PLAN_UNREACHABLE,
@@ -64631,9 +64681,33 @@ var CHAPTERS_REFUSALS = {
64631
64681
  [HOSTED_API_ERROR.UNAVAILABLE]: PULL_REQUEST_CHAPTERS_CALL_FAILURE.UNAVAILABLE
64632
64682
  };
64633
64683
  var inboxFileTypeSchema = Schema_exports.Literals(Object.values(INBOX_FILE_TYPE));
64634
- var CHAPTERS_MODEL_UNANSWERED = {
64635
- failure: PULL_REQUEST_CHAPTERS_CALL_FAILURE.UNANSWERED
64684
+
64685
+ // ../../packages/features/src/sandbox-tunnel-wire.ts
64686
+ var TUNNEL_FRAME = {
64687
+ OPEN: "open",
64688
+ DATA: "data",
64689
+ CLOSE: "close"
64690
+ };
64691
+ var TUNNEL_CLOSE_REASON = {
64692
+ /** Nothing listened on the port the bridge connects to. */
64693
+ REFUSED: "refused"
64636
64694
  };
64695
+ var channel = Schema_exports.Int.check(
64696
+ Schema_exports.isBetween({ minimum: 0, maximum: 2 ** 31 - 1 })
64697
+ );
64698
+ var tunnelFrameSchema = Schema_exports.Union([
64699
+ Schema_exports.Struct({ type: Schema_exports.Literal(TUNNEL_FRAME.OPEN), channel }),
64700
+ Schema_exports.Struct({
64701
+ type: Schema_exports.Literal(TUNNEL_FRAME.DATA),
64702
+ channel,
64703
+ data: Schema_exports.Uint8ArrayFromBase64
64704
+ }),
64705
+ Schema_exports.Struct({
64706
+ type: Schema_exports.Literal(TUNNEL_FRAME.CLOSE),
64707
+ channel,
64708
+ reason: Schema_exports.optional(Schema_exports.Literals(Object.values(TUNNEL_CLOSE_REASON)))
64709
+ })
64710
+ ]);
64637
64711
 
64638
64712
  // ../../packages/features/src/automation-view.ts
64639
64713
  var AUTOMATION_CALL_FAILURE = {
@@ -64822,11 +64896,11 @@ var WRITE_UNTAKEN = {
64822
64896
  // ../../packages/features/src/task-client.ts
64823
64897
  var UNANSWERED6 = { ok: false, failure: TASK_CALL_FAILURE.UNANSWERED };
64824
64898
  var KEEP_REFUSED = {
64825
- [PLAN_ATTACHMENT_REFUSAL.TOO_MANY]: PICTURE_KEEP_FAILURE.TOO_MANY,
64826
- [PLAN_ATTACHMENT_REFUSAL.TOO_MANY_VIDEOS]: PICTURE_KEEP_FAILURE.TOO_MANY_VIDEOS
64899
+ [DESCRIPTION_ATTACHMENT_REFUSAL.TOO_MANY]: PICTURE_KEEP_FAILURE.TOO_MANY,
64900
+ [DESCRIPTION_ATTACHMENT_REFUSAL.TOO_MANY_VIDEOS]: PICTURE_KEEP_FAILURE.TOO_MANY_VIDEOS
64827
64901
  };
64828
- var COMMENT_UNANSWERED = { failure: PLAN_COMMENT_CALL_FAILURE.UNANSWERED };
64829
- var COMMENT_NOT_FOUND = { failure: PLAN_COMMENT_CALL_FAILURE.NOT_FOUND };
64902
+ var COMMENT_UNANSWERED = { failure: DESCRIPTION_COMMENT_CALL_FAILURE.UNANSWERED };
64903
+ var COMMENT_NOT_FOUND = { failure: DESCRIPTION_COMMENT_CALL_FAILURE.NOT_FOUND };
64830
64904
  var REPOSITORY_REFUSALS = {
64831
64905
  [HOSTED_API_ERROR.REPOSITORY_NOT_REACHABLE]: TASK_CALL_FAILURE.REPOSITORY_NOT_REACHABLE
64832
64906
  };
@@ -64873,6 +64947,8 @@ var UNTRAVELED = { ok: false, failure: WRITE_UNTAKEN.REFUSED };
64873
64947
  var TERMINAL_REFUSAL = {
64874
64948
  /** The sandbox is stopped, so no shell starts until the developer resumes it. */
64875
64949
  SANDBOX_STOPPED: "sandbox-stopped",
64950
+ /** The sandbox can never resume: its snapshot is gone, its saved files with it, until the agent's next turn starts a fresh one. */
64951
+ SANDBOX_SNAPSHOT_GONE: "sandbox-snapshot-gone",
64876
64952
  /** The agent has not opened its sandbox yet. */
64877
64953
  AGENT_NOT_READY: "agent-not-ready",
64878
64954
  /** No such agent or shell, or another workspace's. */
@@ -64975,6 +65051,7 @@ var TERMINAL_REFUSALS = /* @__PURE__ */ new Map([
64975
65051
  [HOSTED_API_ERROR.AGENT_RETIRED, TERMINAL_REFUSAL.GONE],
64976
65052
  [HOSTED_API_ERROR.AGENT_NOT_READY, TERMINAL_REFUSAL.AGENT_NOT_READY],
64977
65053
  [HOSTED_API_ERROR.SANDBOX_STOPPED, TERMINAL_REFUSAL.SANDBOX_STOPPED],
65054
+ [HOSTED_API_ERROR.SANDBOX_SNAPSHOT_GONE, TERMINAL_REFUSAL.SANDBOX_SNAPSHOT_GONE],
64978
65055
  // The terminal routes' upstream is the agent's sandbox alone, Vercel Sandbox's API or tmux in it, so its failure is the sandbox's.
64979
65056
  [HOSTED_API_ERROR.UPSTREAM_ERROR, TERMINAL_REFUSAL.SANDBOX_UNANSWERED]
64980
65057
  ]);
@@ -65645,30 +65722,6 @@ var SignInFailed = class extends Data_exports.TaggedError("SignInFailed") {
65645
65722
  var NoStoredAccount = class extends Data_exports.TaggedError("NoStoredAccount") {
65646
65723
  };
65647
65724
 
65648
- // ../../packages/credentials/src/chatgpt-sign-in.ts
65649
- var CHATGPT_SIGN_IN_REASON = {
65650
- REFUSED: "ChatGPT sign-in was not completed.",
65651
- TIMED_OUT: "ChatGPT sign-in timed out.",
65652
- UNREACHABLE: "Couldn't reach ChatGPT. Try again.",
65653
- NOT_REGISTERED: `ChatGPT didn't finish connecting ${PRODUCT_NAME}. Try again.`,
65654
- USAGE_NOT_ENABLED: `ChatGPT plan use wasn't enabled for ${PRODUCT_NAME}. Try again and allow it in the browser.`,
65655
- NOT_VERIFIED: "Couldn't verify the ChatGPT sign-in. Try again."
65656
- };
65657
- var PAGES = {
65658
- granted: {
65659
- badge: "Connected",
65660
- title: `${PRODUCT_NAME} is connected to ChatGPT`,
65661
- body: `You can close this tab and return to ${PRODUCT_NAME}.`
65662
- },
65663
- notGranted: {
65664
- badge: "Not connected",
65665
- title: `${PRODUCT_NAME} isn't connected to ChatGPT`,
65666
- body: `Return to ${PRODUCT_NAME} to see why and try again.`
65667
- }
65668
- };
65669
- var WAIT = Duration_exports.minutes(10);
65670
- var CALL_TIMEOUT = Duration_exports.seconds(10);
65671
-
65672
65725
  // ../../packages/credentials/src/pkce.ts
65673
65726
  var VERIFIER_BYTES = 32;
65674
65727
  function createCodeVerifier() {
@@ -66464,7 +66517,13 @@ function failureWords(failed6) {
66464
66517
  const exit3 = cliExitOfHostedFailure(failed6);
66465
66518
  if (exit3 === CLI_EXIT.AUTH) return `Not signed in, or the sign-in lapsed. ${SIGN_IN_HINT}`;
66466
66519
  if (failed6._tag === "HostedRefused") {
66467
- return failed6.refusal === HOSTED_API_ERROR.UNAVAILABLE ? `${PRODUCT_NAME} is unavailable right now.` : `${PRODUCT_NAME} refused: ${failed6.refusal}.`;
66520
+ if (failed6.refusal === HOSTED_API_ERROR.UNAVAILABLE) {
66521
+ return `${PRODUCT_NAME} is unavailable right now.`;
66522
+ }
66523
+ if (failed6.refusal === HOSTED_API_ERROR.HOST_UPGRADE_NEEDED) {
66524
+ return `This vespin is older than ${PRODUCT_NAME}: update it with vespin update, then run the command again.`;
66525
+ }
66526
+ return `${PRODUCT_NAME} refused: ${failed6.refusal}.`;
66468
66527
  }
66469
66528
  if (failed6.status !== void 0) return `${PRODUCT_NAME} failed (${failed6.status}).`;
66470
66529
  return `Could not reach ${PRODUCT_NAME}.`;
@@ -67070,7 +67129,7 @@ var taskArgument = Argument_exports.String("task").pipe(
67070
67129
  var promptFlag = Flag_exports.String("file").pipe(
67071
67130
  Flag_exports.withAlias("F"),
67072
67131
  Flag_exports.optional,
67073
- Flag_exports.withDescription("The prompt, from a file or - for stdin (default: the task's plan)")
67132
+ Flag_exports.withDescription("The prompt, from a file or - for stdin (default: the task's description)")
67074
67133
  );
67075
67134
  var startCommand = Command_exports.make(
67076
67135
  "start",
@@ -67140,9 +67199,12 @@ var startCommand = Command_exports.make(
67140
67199
  if (wait) yield* endedWith(exit3);
67141
67200
  })
67142
67201
  ).pipe(
67143
- Command_exports.withDescription("Start an agent on a task, handed its plan or a prompt"),
67202
+ Command_exports.withDescription("Start an agent on a task, handed its description or a prompt"),
67144
67203
  Command_exports.withExamples([
67145
- { command: "vespin agent start ACME-42", description: "An agent working the task's plan" },
67204
+ {
67205
+ command: "vespin agent start ACME-42",
67206
+ description: "An agent working the task's description"
67207
+ },
67146
67208
  {
67147
67209
  command: "vespin agent start ACME-42 --branch fix/login --cloud",
67148
67210
  description: "An agent in the cloud, on a branch already on GitHub"
@@ -67159,23 +67221,60 @@ var startCommand = Command_exports.make(
67159
67221
  );
67160
67222
  var listCommand = Command_exports.make(
67161
67223
  "list",
67162
- { task: taskArgument.pipe(Argument_exports.optional) },
67163
- ({ task }) => Effect_exports.gen(function* () {
67224
+ {
67225
+ task: taskArgument.pipe(Argument_exports.optional),
67226
+ offset: Flag_exports.Int("offset").pipe(
67227
+ Flag_exports.filter(
67228
+ (offset) => offset >= 0,
67229
+ () => "--offset is a whole number from 0"
67230
+ ),
67231
+ Flag_exports.optional,
67232
+ Flag_exports.withDescription(
67233
+ "How many of the workspace's agents to pass over: the nextOffset an earlier list printed"
67234
+ )
67235
+ )
67236
+ },
67237
+ ({ task, offset }) => Effect_exports.gen(function* () {
67238
+ if (Option_exports.isSome(task) && Option_exports.isSome(offset)) {
67239
+ return yield* new CommandFailed({
67240
+ exit: CLI_EXIT.USAGE,
67241
+ message: "A task's agents come on one page; --offset pages the workspace's."
67242
+ });
67243
+ }
67164
67244
  const { hosted } = yield* session;
67165
- const { agents } = Option_exports.isSome(task) ? yield* askService(hosted.agents.listOfTask, { id: yield* resolveTaskId(task.value) }) : yield* askService(hosted.agents.listOfWorkspace, {
67166
- workspaceId: (yield* resolveWorkspace).workspace.id
67245
+ const workspace = Option_exports.isSome(task) ? void 0 : (yield* resolveWorkspace).workspace;
67246
+ const listed2 = workspace === void 0 ? yield* askService(hosted.agents.listOfTask, {
67247
+ id: yield* resolveTaskId(Option_exports.getOrThrow(task))
67248
+ }) : yield* askService(hosted.agents.listOfWorkspace, {
67249
+ workspaceId: workspace.id,
67250
+ ...Option_exports.isSome(offset) ? { offset: String(offset.value) } : void 0
67167
67251
  });
67252
+ const { agents } = listed2;
67253
+ const nextOffset = listed2.nextOffset ?? null;
67168
67254
  yield* answer({
67169
- json: agents,
67170
- lines: agents.length === 0 ? ["No agents."] : agentLines(agents),
67255
+ json: { agents, nextOffset },
67256
+ lines: [
67257
+ ...agents.length === 0 ? ["No agents."] : agentLines(agents),
67258
+ ...nextOffset === null ? [] : [
67259
+ "",
67260
+ // The next page names its workspace, so it pages the same list whatever the default.
67261
+ `More agents stand: vespin agent list -w ${workspace?.slug ?? workspace?.id} --offset ${nextOffset}`
67262
+ ]
67263
+ ],
67171
67264
  ids: agents.map((agent) => agent.id)
67172
67265
  });
67173
67266
  })
67174
67267
  ).pipe(
67175
- Command_exports.withDescription("List a task's agents, or the workspace's, newest first"),
67268
+ Command_exports.withDescription(
67269
+ "List a task's agents, or the workspace's a page at a time, newest first"
67270
+ ),
67176
67271
  Command_exports.withExamples([
67177
67272
  { command: "vespin agent list ACME-42", description: "One task's agents" },
67178
- { command: "vespin agent list -q", description: "The workspace's agents' ids" }
67273
+ { command: "vespin agent list -q", description: "The workspace's agents' ids" },
67274
+ {
67275
+ command: "vespin agent list --offset 50",
67276
+ description: "The workspace's next page, from the nextOffset a list printed"
67277
+ }
67179
67278
  ])
67180
67279
  );
67181
67280
  var viewCommand = Command_exports.make(
@@ -67510,6 +67609,90 @@ var apiCommand = Command_exports.make(
67510
67609
  ])
67511
67610
  );
67512
67611
 
67612
+ // src/commands/description.ts
67613
+ function writeDescription(taskId, base, value4) {
67614
+ return Effect_exports.gen(function* () {
67615
+ const { hosted } = yield* session;
67616
+ const saved = yield* askService(hosted.plans.editDescription, {
67617
+ params: { id: taskId },
67618
+ body: { document: { base, value: value4 } }
67619
+ });
67620
+ if ("plan" in saved) return saved.plan;
67621
+ return yield* new CommandFailed({
67622
+ exit: CLI_EXIT.REFUSED,
67623
+ message: "conflict" in saved ? "The description changed in the same lines while it was written, so nothing was saved. Run vespin description show, and write it again." : saved.refused === DESCRIPTION_EDIT_REFUSAL.TOO_LONG ? `The description is longer than a description may be (${TASK_BOUNDS.MAX_BODY_CHARS} characters), so nothing was saved.` : "The description was refused, so nothing was saved."
67624
+ });
67625
+ });
67626
+ }
67627
+ var taskArgument2 = Argument_exports.String("task").pipe(
67628
+ Argument_exports.withDescription("The task, by its id, its number, or its key such as ACME-42")
67629
+ );
67630
+ var showCommand = Command_exports.make(
67631
+ "show",
67632
+ { task: taskArgument2 },
67633
+ ({ task }) => Effect_exports.gen(function* () {
67634
+ const id3 = yield* resolveTaskId(task);
67635
+ const { hosted } = yield* session;
67636
+ const { plan: plan2 } = yield* askService(hosted.plans.open, { id: id3 });
67637
+ yield* answer({
67638
+ json: { id: plan2.id, name: plan2.name, body: plan2.document.body },
67639
+ // Note that the closing line break is dropped, since each line printed ends in one.
67640
+ lines: [plan2.document.body.replace(/\n+$/u, "")],
67641
+ ids: [plan2.id]
67642
+ });
67643
+ })
67644
+ ).pipe(
67645
+ Command_exports.withDescription("Print a task's description as Markdown"),
67646
+ Command_exports.withExamples([
67647
+ { command: "vespin description show ACME-42", description: "Print the description" },
67648
+ {
67649
+ command: "vespin description show ACME-42 | jq -r .body > description.md",
67650
+ description: "Save it to edit"
67651
+ }
67652
+ ])
67653
+ );
67654
+ var editCommand = Command_exports.make(
67655
+ "edit",
67656
+ {
67657
+ task: taskArgument2,
67658
+ file: Flag_exports.String("file").pipe(
67659
+ Flag_exports.withAlias("F"),
67660
+ Flag_exports.withDescription("The whole description, as Markdown, from a file or - for stdin")
67661
+ )
67662
+ },
67663
+ ({ task, file: file2 }) => Effect_exports.gen(function* () {
67664
+ const value4 = yield* readInput2(file2);
67665
+ const id3 = yield* resolveTaskId(task);
67666
+ const { hosted } = yield* session;
67667
+ const { plan: plan2 } = yield* askService(hosted.plans.open, { id: id3 });
67668
+ const saved = yield* writeDescription(id3, plan2.document.body, value4);
67669
+ yield* answer({
67670
+ json: { id: saved.id, name: saved.name, body: saved.document.body },
67671
+ lines: [`Saved the description of ${saved.name}.`],
67672
+ ids: [saved.id]
67673
+ });
67674
+ })
67675
+ ).pipe(
67676
+ Command_exports.withDescription("Replace a task's description with Markdown from a file or stdin"),
67677
+ Command_exports.withExamples([
67678
+ {
67679
+ command: "vespin description edit ACME-42 -F description.md",
67680
+ description: "Write the description from a file"
67681
+ },
67682
+ {
67683
+ command: "vespin description show ACME-42 | jq -r .body | sed 's/TODO/Done/' | vespin description edit ACME-42 -F -",
67684
+ description: "Edit it in a pipe"
67685
+ }
67686
+ ])
67687
+ );
67688
+ var descriptionCommand = Command_exports.make("description").pipe(
67689
+ Command_exports.withDescription("Print or write a task's description"),
67690
+ Command_exports.withSubcommands([showCommand, editCommand]),
67691
+ Command_exports.withExamples([
67692
+ { command: "vespin description show ACME-42", description: "Print the description" }
67693
+ ])
67694
+ );
67695
+
67513
67696
  // src/commands/inbox.ts
67514
67697
  import { randomUUID } from "node:crypto";
67515
67698
 
@@ -68110,82 +68293,6 @@ var modelsCommand = Command_exports.make(
68110
68293
  ])
68111
68294
  );
68112
68295
 
68113
- // src/commands/plan.ts
68114
- function writePlan(taskId, base, value4) {
68115
- return Effect_exports.gen(function* () {
68116
- const { hosted } = yield* session;
68117
- const saved = yield* askService(hosted.plans.edit, {
68118
- params: { id: taskId },
68119
- body: { document: { base, value: value4 } }
68120
- });
68121
- if ("plan" in saved) return saved.plan;
68122
- return yield* new CommandFailed({
68123
- exit: CLI_EXIT.REFUSED,
68124
- message: "conflict" in saved ? "The plan changed in the same lines while it was written, so nothing was saved. Run vespin plan show, and write it again." : saved.refused === PLAN_EDIT_REFUSAL.TOO_LONG ? `The plan is longer than a plan may be (${TASK_BOUNDS.MAX_BODY_CHARS} characters), so nothing was saved.` : "The plan was refused, so nothing was saved."
68125
- });
68126
- });
68127
- }
68128
- var taskArgument2 = Argument_exports.String("task").pipe(
68129
- Argument_exports.withDescription("The task, by its id, its number, or its key such as ACME-42")
68130
- );
68131
- var showCommand = Command_exports.make(
68132
- "show",
68133
- { task: taskArgument2 },
68134
- ({ task }) => Effect_exports.gen(function* () {
68135
- const id3 = yield* resolveTaskId(task);
68136
- const { hosted } = yield* session;
68137
- const { plan: plan2 } = yield* askService(hosted.plans.open, { id: id3 });
68138
- yield* answer({
68139
- json: { id: plan2.id, name: plan2.name, body: plan2.document.body },
68140
- // Note that the closing line break is dropped, since each line printed ends in one.
68141
- lines: [plan2.document.body.replace(/\n+$/u, "")],
68142
- ids: [plan2.id]
68143
- });
68144
- })
68145
- ).pipe(
68146
- Command_exports.withDescription("Print a task's plan as Markdown"),
68147
- Command_exports.withExamples([
68148
- { command: "vespin plan show ACME-42", description: "Print the plan" },
68149
- { command: "vespin plan show ACME-42 > plan.md", description: "Save it to edit" }
68150
- ])
68151
- );
68152
- var editCommand = Command_exports.make(
68153
- "edit",
68154
- {
68155
- task: taskArgument2,
68156
- file: Flag_exports.String("file").pipe(
68157
- Flag_exports.withAlias("F"),
68158
- Flag_exports.withDescription("The whole plan, as Markdown, from a file or - for stdin")
68159
- )
68160
- },
68161
- ({ task, file: file2 }) => Effect_exports.gen(function* () {
68162
- const value4 = yield* readInput2(file2);
68163
- const id3 = yield* resolveTaskId(task);
68164
- const { hosted } = yield* session;
68165
- const { plan: plan2 } = yield* askService(hosted.plans.open, { id: id3 });
68166
- const saved = yield* writePlan(id3, plan2.document.body, value4);
68167
- yield* answer({
68168
- json: { id: saved.id, name: saved.name, body: saved.document.body },
68169
- lines: [`Saved the plan of ${saved.name}.`],
68170
- ids: [saved.id]
68171
- });
68172
- })
68173
- ).pipe(
68174
- Command_exports.withDescription("Replace a task's plan with Markdown from a file or stdin"),
68175
- Command_exports.withExamples([
68176
- { command: "vespin plan edit ACME-42 -F plan.md", description: "Write the plan from a file" },
68177
- {
68178
- command: "vespin plan show ACME-42 | sed 's/TODO/Done/' | vespin plan edit ACME-42 -F -",
68179
- description: "Edit it in a pipe"
68180
- }
68181
- ])
68182
- );
68183
- var planCommand = Command_exports.make("plan").pipe(
68184
- Command_exports.withDescription("Print or write a task's plan"),
68185
- Command_exports.withSubcommands([showCommand, editCommand]),
68186
- Command_exports.withExamples([{ command: "vespin plan show ACME-42", description: "Print the plan" }])
68187
- );
68188
-
68189
68296
  // ../../packages/features/src/workspace-key.ts
68190
68297
  var TASK_FALLBACK_PREFIX = "TASK";
68191
68298
  var MAX_PREFIX_CHARS = 4;
@@ -68363,16 +68470,16 @@ var createCommand = Command_exports.make(
68363
68470
  file: Flag_exports.String("file").pipe(
68364
68471
  Flag_exports.withAlias("F"),
68365
68472
  Flag_exports.optional,
68366
- Flag_exports.withDescription("The plan, as Markdown, from a file or - for stdin")
68473
+ Flag_exports.withDescription("The description, as Markdown, from a file or - for stdin")
68367
68474
  ),
68368
68475
  start: Flag_exports.Boolean("start").pipe(
68369
68476
  Flag_exports.withDefault(false),
68370
- Flag_exports.withDescription("Start an agent on the new task, handed its plan")
68477
+ Flag_exports.withDescription("Start an agent on the new task, handed its description")
68371
68478
  ),
68372
68479
  prompt: Flag_exports.String("prompt").pipe(
68373
68480
  Flag_exports.optional,
68374
68481
  Flag_exports.withDescription(
68375
- "Start an agent with this prompt in the plan's place, from a file or - for stdin"
68482
+ "Start an agent with this prompt in the description's place, from a file or - for stdin"
68376
68483
  )
68377
68484
  )
68378
68485
  },
@@ -68385,19 +68492,19 @@ var createCommand = Command_exports.make(
68385
68492
  message: "Only one of -F and --prompt may read stdin."
68386
68493
  });
68387
68494
  }
68388
- const planText = fileSource === void 0 ? void 0 : yield* readInput2(fileSource);
68495
+ const descriptionText = fileSource === void 0 ? void 0 : yield* readInput2(fileSource);
68389
68496
  const promptText = promptSource === void 0 ? void 0 : yield* readInput2(promptSource);
68390
68497
  const starting = start || promptText !== void 0;
68391
- if (starting && planText === void 0 && promptText === void 0) {
68498
+ if (starting && descriptionText === void 0 && promptText === void 0) {
68392
68499
  return yield* new CommandFailed({
68393
68500
  exit: CLI_EXIT.USAGE,
68394
- message: "An agent needs something to work from: give the task a plan with -F, or the agent a prompt with --prompt."
68501
+ message: "An agent needs something to work from: give the task a description with -F, or the agent a prompt with --prompt."
68395
68502
  });
68396
68503
  }
68397
68504
  const repository = Option_exports.isSome(repo) ? repo.value : yield* originRepository;
68398
68505
  const { workspace } = yield* resolveWorkspace;
68399
68506
  const { hosted } = yield* session;
68400
- const together = starting && planText === void 0;
68507
+ const together = starting && descriptionText === void 0;
68401
68508
  const created = yield* askService(
68402
68509
  hosted.plans.create,
68403
68510
  {
@@ -68414,8 +68521,8 @@ var createCommand = Command_exports.make(
68414
68521
  together ? HOSTED_DEADLINE.START : HOSTED_DEADLINE.USUAL
68415
68522
  );
68416
68523
  const task = taskJson(created.body.plan, workspace.name);
68417
- if (planText !== void 0) {
68418
- yield* writePlan(task.id, created.body.plan.document.body, planText);
68524
+ if (descriptionText !== void 0) {
68525
+ yield* writeDescription(task.id, created.body.plan.document.body, descriptionText);
68419
68526
  }
68420
68527
  const agent = starting && !together ? yield* startAgent(task.id, {
68421
68528
  ...promptText === void 0 ? void 0 : { prompt: promptText }
@@ -68443,8 +68550,8 @@ var createCommand = Command_exports.make(
68443
68550
  Command_exports.withExamples([
68444
68551
  { command: 'vespin task create "Fix the login redirect"', description: "A new task, no agent" },
68445
68552
  {
68446
- command: 'vespin task create "Fix the login redirect" -F plan.md --start',
68447
- description: "A task with a plan, and an agent working it"
68553
+ command: 'vespin task create "Fix the login redirect" -F description.md --start',
68554
+ description: "A task with a description, and an agent working it"
68448
68555
  },
68449
68556
  {
68450
68557
  command: 'echo "Fix the flaky test in auth.test.ts" | vespin task create "Flaky test" --prompt -',
@@ -68546,6 +68653,22 @@ var taskCommand = Command_exports.make("task").pipe(
68546
68653
  ])
68547
68654
  );
68548
68655
 
68656
+ // ../../packages/features/src/cli-release.ts
68657
+ var CLI_PACKAGE = "vespin";
68658
+ var CLI_INSTALL_MODE = "cli";
68659
+ var CLI_COMMAND = {
68660
+ NPM_INSTALL: `npm i -g ${CLI_PACKAGE}`,
68661
+ LOGIN: `${CLI_PACKAGE} login`
68662
+ };
68663
+ var CLI_RELEASE = {
68664
+ VERSION: "0.1.0",
68665
+ SHA256: {
68666
+ [HOST_TARGET.LINUX_X64]: "6538a6d8df7f93a40743592c0643de38f13ad393291532d5c3ac7d7da73b887f",
68667
+ [HOST_TARGET.LINUX_ARM64]: "2b5d4789023f8c50abba34822c7b242d272b596dcd4e886fa850bc87e49e3104",
68668
+ [HOST_TARGET.DARWIN_ARM64]: "df384d3f11aa3c3ad674f7ab824f4a0e74cd5e754064c0aa9fe317bf5d500ca2"
68669
+ }
68670
+ };
68671
+
68549
68672
  // src/install.ts
68550
68673
  import { realpathSync } from "node:fs";
68551
68674
  import { homedir } from "node:os";
@@ -68607,7 +68730,7 @@ function installKind() {
68607
68730
  }
68608
68731
 
68609
68732
  // src/commands/version.ts
68610
- var VERSION = "0.1.0";
68733
+ var VERSION = "0.2.0";
68611
68734
  var versionCommand = Command_exports.make("version", {}, () => {
68612
68735
  const install = installKind();
68613
68736
  return answer({
@@ -68621,8 +68744,8 @@ var versionCommand = Command_exports.make("version", {}, () => {
68621
68744
  );
68622
68745
 
68623
68746
  // src/commands/update.ts
68624
- var CLI_MODE = "cli";
68625
68747
  var SCRIPT_PROTOCOL = "https:";
68748
+ var DOWNLOAD_WITHIN = Duration_exports.seconds(30);
68626
68749
  var encoder6 = new TextEncoder();
68627
68750
  var installScript = Effect_exports.fnUntraced(function* (origin) {
68628
68751
  const url = `${origin}${HOST_WIRE.INSTALL_SCRIPT_PATH}`;
@@ -68636,9 +68759,14 @@ var installScript = Effect_exports.fnUntraced(function* (origin) {
68636
68759
  exit: CLI_EXIT.UNAVAILABLE,
68637
68760
  message: `Could not fetch ${url}.`
68638
68761
  });
68639
- const response = yield* Effect_exports.mapError(HttpClient_exports.get(url), () => unreachable);
68640
- if (response.status !== 200) return yield* unreachable;
68641
- return yield* Effect_exports.mapError(response.text, () => unreachable);
68762
+ return yield* Effect_exports.gen(function* () {
68763
+ const response = yield* HttpClient_exports.get(url);
68764
+ if (response.status !== 200) return yield* unreachable;
68765
+ return yield* response.text;
68766
+ }).pipe(
68767
+ Effect_exports.timeout(DOWNLOAD_WITHIN),
68768
+ Effect_exports.mapError((error2) => error2 instanceof CommandFailed ? error2 : unreachable)
68769
+ );
68642
68770
  });
68643
68771
  var runInstallScript = Effect_exports.fnUntraced(function* (script) {
68644
68772
  const spawner = yield* ChildProcessSpawner_exports.ChildProcessSpawner;
@@ -68650,7 +68778,7 @@ var runInstallScript = Effect_exports.fnUntraced(function* (script) {
68650
68778
  const code = yield* Effect_exports.scoped(
68651
68779
  Effect_exports.gen(function* () {
68652
68780
  const handle = yield* spawner.spawn(
68653
- ChildProcess_exports.make("sh", ["-s", CLI_MODE], {
68781
+ ChildProcess_exports.make("sh", ["-s", CLI_INSTALL_MODE], {
68654
68782
  stdin: { stream: Stream_exports.make(encoder6.encode(script)) },
68655
68783
  stdout: "pipe",
68656
68784
  stderr: "inherit"
@@ -68787,7 +68915,7 @@ var workspaceCommand = Command_exports.make("workspace").pipe(
68787
68915
  var COMMANDS = [
68788
68916
  ...ACCOUNT_COMMANDS,
68789
68917
  taskCommand,
68790
- planCommand,
68918
+ descriptionCommand,
68791
68919
  agentCommand,
68792
68920
  workspaceCommand,
68793
68921
  inboxCommand,
@@ -68810,7 +68938,7 @@ var EXIT_CODES_HELP = [
68810
68938
  ].join(", ");
68811
68939
  var vespin = Command_exports.make("vespin").pipe(
68812
68940
  Command_exports.withDescription(
68813
- `${PRODUCT_NAME} from your terminal: sign in, work tasks, plans, and agents, call the hosted API, and print JSON for scripts and coding agents. Exit codes: ${EXIT_CODES_HELP}.`
68941
+ `${PRODUCT_NAME} from your terminal: sign in, work tasks, their descriptions, and agents, call the hosted API, and print JSON for scripts and coding agents. Exit codes: ${EXIT_CODES_HELP}.`
68814
68942
  ),
68815
68943
  Command_exports.withSubcommands(COMMANDS),
68816
68944
  Command_exports.withGlobalFlags(GLOBAL_FLAGS),
@@ -68840,7 +68968,8 @@ function ended(failure) {
68840
68968
  );
68841
68969
  }
68842
68970
  NodeRuntime_exports.runMain(
68843
- Command_exports.run(vespin, { version: VERSION }).pipe(
68971
+ Effect_exports.flatMap(Stdio_exports.Stdio, ({ args: args2 }) => args2).pipe(
68972
+ Effect_exports.flatMap(Command_exports.runWith(vespin, { version: VERSION })),
68844
68973
  Effect_exports.as(CLI_EXIT.OK),
68845
68974
  Effect_exports.catch(ended),
68846
68975
  Effect_exports.provide(services)