@ottocode/api 0.1.299 → 0.1.301

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.
@@ -182,7 +182,7 @@ export type ListSessionsResponses = {
182
182
  lastCompactedAt?: number | null;
183
183
  parentSessionId?: string | null;
184
184
  branchPointMessageId?: string | null;
185
- sessionType?: 'main' | 'branch' | 'handoff';
185
+ sessionType?: 'main' | 'branch' | 'handoff' | 'btw';
186
186
  toolCounts?: {
187
187
  [key: string]: number;
188
188
  };
@@ -193,7 +193,7 @@ export type ListSessionsResponses = {
193
193
  deletions: number;
194
194
  operations: number;
195
195
  };
196
- [key: string]: unknown | string | string | null | number | number | null | number | null | number | null | number | null | number | null | number | null | number | null | number | null | number | null | number | null | string | null | number | null | string | null | string | null | 'main' | 'branch' | 'handoff' | {
196
+ [key: string]: unknown | string | string | null | number | number | null | number | null | number | null | number | null | number | null | number | null | number | null | number | null | number | null | number | null | string | null | number | null | string | null | string | null | 'main' | 'branch' | 'handoff' | 'btw' | {
197
197
  [key: string]: number;
198
198
  } | boolean | {
199
199
  changedFiles: number;
@@ -210,9 +210,20 @@ export type ListSessionsResponse = ListSessionsResponses[keyof ListSessionsRespo
210
210
  export type CreateSessionData = {
211
211
  body?: {
212
212
  title?: string | null;
213
+ /**
214
+ * Agent name. Defaults to config. Agent provider/model overrides are used when provider/model are omitted.
215
+ */
213
216
  agent?: string;
217
+ /**
218
+ * Provider override. If omitted, selected agent provider override, then config default are used.
219
+ */
214
220
  provider?: string;
221
+ /**
222
+ * Model override. If omitted, selected agent model override, then config default are used.
223
+ */
215
224
  model?: string;
225
+ parentSessionId?: string | null;
226
+ sessionType?: 'main' | 'btw';
216
227
  };
217
228
  path?: never;
218
229
  query?: {
@@ -258,7 +269,7 @@ export type CreateSessionResponses = {
258
269
  lastCompactedAt?: number | null;
259
270
  parentSessionId?: string | null;
260
271
  branchPointMessageId?: string | null;
261
- sessionType?: 'main' | 'branch' | 'handoff';
272
+ sessionType?: 'main' | 'branch' | 'handoff' | 'btw';
262
273
  toolCounts?: {
263
274
  [key: string]: number;
264
275
  };
@@ -269,7 +280,7 @@ export type CreateSessionResponses = {
269
280
  deletions: number;
270
281
  operations: number;
271
282
  };
272
- [key: string]: unknown | string | string | null | number | number | null | number | null | number | null | number | null | number | null | number | null | number | null | number | null | number | null | number | null | string | null | number | null | string | null | string | null | 'main' | 'branch' | 'handoff' | {
283
+ [key: string]: unknown | string | string | null | number | number | null | number | null | number | null | number | null | number | null | number | null | number | null | number | null | number | null | number | null | string | null | number | null | string | null | string | null | 'main' | 'branch' | 'handoff' | 'btw' | {
273
284
  [key: string]: number;
274
285
  } | boolean | {
275
286
  changedFiles: number;
@@ -359,7 +370,7 @@ export type GetSessionResponses = {
359
370
  lastCompactedAt?: number | null;
360
371
  parentSessionId?: string | null;
361
372
  branchPointMessageId?: string | null;
362
- sessionType?: 'main' | 'branch' | 'handoff';
373
+ sessionType?: 'main' | 'branch' | 'handoff' | 'btw';
363
374
  toolCounts?: {
364
375
  [key: string]: number;
365
376
  };
@@ -370,7 +381,7 @@ export type GetSessionResponses = {
370
381
  deletions: number;
371
382
  operations: number;
372
383
  };
373
- [key: string]: unknown | string | string | null | number | number | null | number | null | number | null | number | null | number | null | number | null | number | null | number | null | number | null | number | null | string | null | number | null | string | null | string | null | 'main' | 'branch' | 'handoff' | {
384
+ [key: string]: unknown | string | string | null | number | number | null | number | null | number | null | number | null | number | null | number | null | number | null | number | null | number | null | number | null | string | null | number | null | string | null | string | null | 'main' | 'branch' | 'handoff' | 'btw' | {
374
385
  [key: string]: number;
375
386
  } | boolean | {
376
387
  changedFiles: number;
@@ -441,7 +452,7 @@ export type UpdateSessionResponses = {
441
452
  lastCompactedAt?: number | null;
442
453
  parentSessionId?: string | null;
443
454
  branchPointMessageId?: string | null;
444
- sessionType?: 'main' | 'branch' | 'handoff';
455
+ sessionType?: 'main' | 'branch' | 'handoff' | 'btw';
445
456
  toolCounts?: {
446
457
  [key: string]: number;
447
458
  };
@@ -452,7 +463,7 @@ export type UpdateSessionResponses = {
452
463
  deletions: number;
453
464
  operations: number;
454
465
  };
455
- [key: string]: unknown | string | string | null | number | number | null | number | null | number | null | number | null | number | null | number | null | number | null | number | null | number | null | number | null | string | null | number | null | string | null | string | null | 'main' | 'branch' | 'handoff' | {
466
+ [key: string]: unknown | string | string | null | number | number | null | number | null | number | null | number | null | number | null | number | null | number | null | number | null | number | null | number | null | string | null | number | null | string | null | string | null | 'main' | 'branch' | 'handoff' | 'btw' | {
456
467
  [key: string]: number;
457
468
  } | boolean | {
458
469
  changedFiles: number;
@@ -508,7 +519,7 @@ export type MarkSessionViewedResponses = {
508
519
  lastCompactedAt?: number | null;
509
520
  parentSessionId?: string | null;
510
521
  branchPointMessageId?: string | null;
511
- sessionType?: 'main' | 'branch' | 'handoff';
522
+ sessionType?: 'main' | 'branch' | 'handoff' | 'btw';
512
523
  toolCounts?: {
513
524
  [key: string]: number;
514
525
  };
@@ -519,7 +530,7 @@ export type MarkSessionViewedResponses = {
519
530
  deletions: number;
520
531
  operations: number;
521
532
  };
522
- [key: string]: unknown | string | string | null | number | number | null | number | null | number | null | number | null | number | null | number | null | number | null | number | null | number | null | number | null | string | null | number | null | string | null | string | null | 'main' | 'branch' | 'handoff' | {
533
+ [key: string]: unknown | string | string | null | number | number | null | number | null | number | null | number | null | number | null | number | null | number | null | number | null | number | null | number | null | string | null | number | null | string | null | string | null | 'main' | 'branch' | 'handoff' | 'btw' | {
523
534
  [key: string]: number;
524
535
  } | boolean | {
525
536
  changedFiles: number;
@@ -1159,15 +1170,21 @@ export type CreateMessageData = {
1159
1170
  body: {
1160
1171
  content: string;
1161
1172
  /**
1162
- * Agent name. Defaults to config if omitted.
1173
+ * Agent name. Defaults to the session agent, then config default. When explicitly changed and provider/model are omitted, the selected agent provider/model overrides are used before the session/default provider/model.
1163
1174
  */
1164
1175
  agent?: string;
1176
+ /**
1177
+ * Provider override for this message. If omitted, explicit agent provider override, session provider, then config default are used.
1178
+ */
1165
1179
  provider?: string;
1180
+ /**
1181
+ * Model override for this message. If omitted, explicit agent model override, session model, then config default are used.
1182
+ */
1166
1183
  model?: string;
1167
1184
  /**
1168
1185
  * Optional user-provided context to include in the system prompt.
1169
1186
  */
1170
- userContext?: string;
1187
+ userContext?: string | null;
1171
1188
  /**
1172
1189
  * Enable extended thinking / reasoning for models that support it.
1173
1190
  */
@@ -1327,6 +1344,17 @@ export type AskData = {
1327
1344
  * Request structured JSON output when supported by the agent.
1328
1345
  */
1329
1346
  jsonMode?: boolean;
1347
+ /**
1348
+ * Inline agent prompt for this request.
1349
+ */
1350
+ agentPrompt?: string;
1351
+ /**
1352
+ * Inline agent tool configuration split into first-class and loadable tools.
1353
+ */
1354
+ tools?: {
1355
+ firstClass?: Array<string>;
1356
+ loadable?: Array<string>;
1357
+ };
1330
1358
  };
1331
1359
  path?: never;
1332
1360
  query?: {
@@ -1460,6 +1488,247 @@ export type GetAgentsResponses = {
1460
1488
  };
1461
1489
  };
1462
1490
  export type GetAgentsResponse = GetAgentsResponses[keyof GetAgentsResponses];
1491
+ export type GetAgentDetailsData = {
1492
+ body?: never;
1493
+ path?: never;
1494
+ query?: {
1495
+ /**
1496
+ * Project root override (defaults to current working directory).
1497
+ */
1498
+ project?: string;
1499
+ };
1500
+ url: '/v1/config/agents/details';
1501
+ };
1502
+ export type GetAgentDetailsResponses = {
1503
+ /**
1504
+ * OK
1505
+ */
1506
+ 200: {
1507
+ agents: Array<{
1508
+ name: string;
1509
+ builtin: boolean;
1510
+ custom: boolean;
1511
+ source: 'builtin' | 'local' | 'global' | 'merged' | 'embedded';
1512
+ prompt: string;
1513
+ promptSource: string;
1514
+ toolConfig: {
1515
+ firstClass?: Array<string>;
1516
+ loadable?: Array<string>;
1517
+ };
1518
+ defaultToolConfig: {
1519
+ firstClass?: Array<string>;
1520
+ loadable?: Array<string>;
1521
+ };
1522
+ appendToolConfig: {
1523
+ firstClass?: Array<string>;
1524
+ loadable?: Array<string>;
1525
+ };
1526
+ provider?: string;
1527
+ model?: string;
1528
+ editable: boolean;
1529
+ hasLocalOverride: boolean;
1530
+ hasGlobalOverride: boolean;
1531
+ }>;
1532
+ default: string;
1533
+ };
1534
+ };
1535
+ export type GetAgentDetailsResponse = GetAgentDetailsResponses[keyof GetAgentDetailsResponses];
1536
+ export type DeleteAgentData = {
1537
+ body?: never;
1538
+ path: {
1539
+ /**
1540
+ * Agent name.
1541
+ */
1542
+ agent: string;
1543
+ };
1544
+ query?: {
1545
+ /**
1546
+ * Project root override (defaults to current working directory).
1547
+ */
1548
+ project?: string;
1549
+ /**
1550
+ * Configuration scope. Defaults to local.
1551
+ */
1552
+ scope?: 'local' | 'global';
1553
+ };
1554
+ url: '/v1/config/agents/{agent}';
1555
+ };
1556
+ export type DeleteAgentResponses = {
1557
+ /**
1558
+ * OK
1559
+ */
1560
+ 200: {
1561
+ deleted: boolean;
1562
+ builtin: boolean;
1563
+ agent?: {
1564
+ name: string;
1565
+ builtin: boolean;
1566
+ custom: boolean;
1567
+ source: 'builtin' | 'local' | 'global' | 'merged' | 'embedded';
1568
+ prompt: string;
1569
+ promptSource: string;
1570
+ toolConfig: {
1571
+ firstClass?: Array<string>;
1572
+ loadable?: Array<string>;
1573
+ };
1574
+ defaultToolConfig: {
1575
+ firstClass?: Array<string>;
1576
+ loadable?: Array<string>;
1577
+ };
1578
+ appendToolConfig: {
1579
+ firstClass?: Array<string>;
1580
+ loadable?: Array<string>;
1581
+ };
1582
+ provider?: string;
1583
+ model?: string;
1584
+ editable: boolean;
1585
+ hasLocalOverride: boolean;
1586
+ hasGlobalOverride: boolean;
1587
+ };
1588
+ };
1589
+ };
1590
+ export type DeleteAgentResponse = DeleteAgentResponses[keyof DeleteAgentResponses];
1591
+ export type GetAgentData = {
1592
+ body?: never;
1593
+ path: {
1594
+ /**
1595
+ * Agent name.
1596
+ */
1597
+ agent: string;
1598
+ };
1599
+ query?: {
1600
+ /**
1601
+ * Project root override (defaults to current working directory).
1602
+ */
1603
+ project?: string;
1604
+ };
1605
+ url: '/v1/config/agents/{agent}';
1606
+ };
1607
+ export type GetAgentResponses = {
1608
+ /**
1609
+ * OK
1610
+ */
1611
+ 200: {
1612
+ agent: {
1613
+ name: string;
1614
+ builtin: boolean;
1615
+ custom: boolean;
1616
+ source: 'builtin' | 'local' | 'global' | 'merged' | 'embedded';
1617
+ prompt: string;
1618
+ promptSource: string;
1619
+ toolConfig: {
1620
+ firstClass?: Array<string>;
1621
+ loadable?: Array<string>;
1622
+ };
1623
+ defaultToolConfig: {
1624
+ firstClass?: Array<string>;
1625
+ loadable?: Array<string>;
1626
+ };
1627
+ appendToolConfig: {
1628
+ firstClass?: Array<string>;
1629
+ loadable?: Array<string>;
1630
+ };
1631
+ provider?: string;
1632
+ model?: string;
1633
+ editable: boolean;
1634
+ hasLocalOverride: boolean;
1635
+ hasGlobalOverride: boolean;
1636
+ };
1637
+ };
1638
+ };
1639
+ export type GetAgentResponse = GetAgentResponses[keyof GetAgentResponses];
1640
+ export type UpsertAgentData = {
1641
+ body: {
1642
+ scope?: 'local' | 'global';
1643
+ prompt?: string;
1644
+ promptStorage?: 'file' | 'inline';
1645
+ tools?: {
1646
+ firstClass?: Array<string>;
1647
+ loadable?: Array<string>;
1648
+ };
1649
+ appendTools?: {
1650
+ firstClass?: Array<string>;
1651
+ loadable?: Array<string>;
1652
+ };
1653
+ provider?: string | null;
1654
+ model?: string | null;
1655
+ };
1656
+ path: {
1657
+ /**
1658
+ * Agent name.
1659
+ */
1660
+ agent: string;
1661
+ };
1662
+ query?: {
1663
+ /**
1664
+ * Project root override (defaults to current working directory).
1665
+ */
1666
+ project?: string;
1667
+ };
1668
+ url: '/v1/config/agents/{agent}';
1669
+ };
1670
+ export type UpsertAgentResponses = {
1671
+ /**
1672
+ * OK
1673
+ */
1674
+ 200: {
1675
+ agent: {
1676
+ name: string;
1677
+ builtin: boolean;
1678
+ custom: boolean;
1679
+ source: 'builtin' | 'local' | 'global' | 'merged' | 'embedded';
1680
+ prompt: string;
1681
+ promptSource: string;
1682
+ toolConfig: {
1683
+ firstClass?: Array<string>;
1684
+ loadable?: Array<string>;
1685
+ };
1686
+ defaultToolConfig: {
1687
+ firstClass?: Array<string>;
1688
+ loadable?: Array<string>;
1689
+ };
1690
+ appendToolConfig: {
1691
+ firstClass?: Array<string>;
1692
+ loadable?: Array<string>;
1693
+ };
1694
+ provider?: string;
1695
+ model?: string;
1696
+ editable: boolean;
1697
+ hasLocalOverride: boolean;
1698
+ hasGlobalOverride: boolean;
1699
+ };
1700
+ };
1701
+ };
1702
+ export type UpsertAgentResponse = UpsertAgentResponses[keyof UpsertAgentResponses];
1703
+ export type GetConfigToolsData = {
1704
+ body?: never;
1705
+ path?: never;
1706
+ query?: {
1707
+ /**
1708
+ * Project root override (defaults to current working directory).
1709
+ */
1710
+ project?: string;
1711
+ };
1712
+ url: '/v1/config/tools';
1713
+ };
1714
+ export type GetConfigToolsResponses = {
1715
+ /**
1716
+ * OK
1717
+ */
1718
+ 200: {
1719
+ tools: Array<{
1720
+ name: string;
1721
+ description?: string;
1722
+ category: 'first_class' | 'loadable' | 'core' | 'filesystem' | 'search' | 'editing' | 'shell' | 'git' | 'web' | 'mcp' | 'skill' | 'research' | 'custom' | 'other';
1723
+ source: 'builtin' | 'mcp' | 'skill' | 'custom';
1724
+ activation?: 'first_class' | 'loadable' | 'mcp';
1725
+ required?: boolean;
1726
+ risky?: boolean;
1727
+ available: boolean;
1728
+ }>;
1729
+ };
1730
+ };
1731
+ export type GetConfigToolsResponse = GetConfigToolsResponses[keyof GetConfigToolsResponses];
1463
1732
  export type GetProvidersData = {
1464
1733
  body?: never;
1465
1734
  path?: never;