@ego-z/contracts 0.15.24 → 0.15.26

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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ego-z/contracts",
3
- "version": "0.15.24",
3
+ "version": "0.15.26",
4
4
  "description": "Wire-format type contracts shared between EgoZ backend, SDK, MCP and console. Type-only — no runtime artifacts.",
5
5
  "types": "./src/index.d.ts",
6
6
  "exports": {
package/src/agents.d.ts CHANGED
@@ -69,15 +69,17 @@
69
69
  * started, queue time included, so a run still waiting at `deadlineAt` ends
70
70
  * `failed: timeout` without having run.
71
71
  *
72
- * ── The note on the main agent's conversation ───────────────────────────
72
+ * ── What the main agent is told ──────────────────────────────────────────
73
73
  *
74
- * When a run ends, EgoZ adds a short note to the conversation that started
75
- * it, so the main agent's next turn knows — e.g.
76
- * `[translator finished. It reported: «…»]`, `[translator failed: budget]`,
77
- * `[translator needs your input: «…» — ask the user]`. The reported text is
78
- * cut to 500 characters and quoted as data, never as instructions: a
79
- * sub-agent may have read pages written by anyone. The full result is on the
80
- * run. EgoZ starts no turn by itself: to have the main agent tell the user
74
+ * The main agent's next turn on the conversation that started a run is told
75
+ * how it went, in a "Sub-agent runs" block of that turn's prompt — e.g.
76
+ * `translator (run …): finished. It reported: «…»`, `…: failed (budget): …`,
77
+ * `…: needs the user's input: «…» — ask the user …` — and runs still going are
78
+ * listed too, so it doesn't start them again. An ended run is shown once. The
79
+ * reported text is cut to 500 characters and quoted as data, never as
80
+ * instructions: a sub-agent may have read pages written by anyone. The full
81
+ * result is on the run. Nothing is added to the conversation's messages.
82
+ * EgoZ starts no turn by itself: to have the main agent tell the user
81
83
  * unprompted, send the next /ask yourself when the webhook arrives.
82
84
  */
83
85
 
package/src/ask.d.ts CHANGED
@@ -699,6 +699,10 @@ export interface AskResponseData {
699
699
  * that ignores this field still gets a coherent `answer`, because the
700
700
  * questions are also stated in the reply text.
701
701
  *
702
+ * With the project setting `choiceListToCard`, a turn whose reply ENDS on
703
+ * a question and a list of 2–6 short items, and which made no set itself,
704
+ * gets that question as its set. The reply text keeps the list.
705
+ *
702
706
  * The answer comes back as an ordinary `AskRequestBody.message`; there is
703
707
  * no structured answer channel. See `questions.d.ts` for why.
704
708
  */
@@ -169,12 +169,22 @@ export interface ProjectFileConfig {
169
169
  /** `generate_image` calls one answer may make, 1..4. Default 2. */
170
170
  imageMaxCallsPerTurn: number;
171
171
 
172
- /** Where EgoZ POSTs `agent_run.finished` when a sub-agent run ends. `null` = no webhook. */
173
- agentWebhookUrl: string | null;
172
+ /**
173
+ * Read a reply that ends on a question and a short list as that
174
+ * question's card (`questionSet`), when the agent made none. Default false.
175
+ */
176
+ choiceListToCard: boolean;
177
+
178
+ /**
179
+ * Where EgoZ POSTs `agent_run.finished` when a sub-agent run ends. `null` = no webhook.
180
+ * The three sub-agent settings are absent from files made before sub-agents
181
+ * existed; an import then keeps the project's own.
182
+ */
183
+ agentWebhookUrl?: string | null;
174
184
  /** Sub-agent runs the project runs at once, 1..500. Default 50. More wait in the queue. */
175
- agentMaxConcurrentRuns: number;
185
+ agentMaxConcurrentRuns?: number;
176
186
  /** Sub-agent runs one end user runs at once, 1..50. Default 3. More wait in the queue. */
177
- agentMaxConcurrentRunsPerUser: number;
187
+ agentMaxConcurrentRunsPerUser?: number;
178
188
 
179
189
  voiceEnabled: boolean;
180
190
  voiceModel: string | null;
@@ -349,7 +359,8 @@ export interface ProjectFileImportSections {
349
359
  pricing: ProjectFileSectionChanges;
350
360
  extensions: ProjectFileSectionChanges;
351
361
  webSearchSites: ProjectFileSectionChanges;
352
- agentProfiles: ProjectFileSectionChanges;
362
+ /** Absent from a server that predates sub-agent profiles. */
363
+ agentProfiles?: ProjectFileSectionChanges;
353
364
  }
354
365
 
355
366
  export interface ProjectFileConfigChanges {