@aparte/plugin-subagents 1.6.0 → 1.7.0

package/dist/custom-elements.json

@@ -82,6 +82,34 @@
               "privacy": "private",
               "default": "null"
             },
+            {
+              "kind": "field",
+              "name": "_head",
+              "type": {
+                "text": "HTMLElement | null"
+              },
+              "privacy": "private",
+              "default": "null",
+              "description": "A closable view's head: the sub-agent's name and Close."
+            },
+            {
+              "kind": "field",
+              "name": "_name",
+              "type": {
+                "text": "HTMLElement | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_close",
+              "type": {
+                "text": "HTMLButtonElement | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
             {
               "kind": "field",
               "name": "_drawing",
@@ -137,6 +165,15 @@
               "privacy": "private",
               "default": "null"
             },
+            {
+              "kind": "field",
+              "name": "_stopRenderers",
+              "type": {
+                "text": "(() => void) | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
             {
               "kind": "field",
               "name": "_queued",
@@ -170,6 +207,19 @@
               "privacy": "private",
               "readonly": true
             },
+            {
+              "kind": "field",
+              "name": "_onKeydown",
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "_onRenderers",
+              "privacy": "private",
+              "readonly": true,
+              "description": "A renderer registered or taken off on the config the rows were drawn with: the rows it changes are drawn again."
+            },
             {
               "kind": "field",
               "name": "_onWrite",
@@ -184,6 +234,16 @@
               },
               "description": "The chat, when it has no `id` for the `for` attribute: an element, or anything with `getMessages()`."
             },
+            {
+              "kind": "method",
+              "name": "focusTitle",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Put the focus on the sub-agent's name, in a `closable` view: where a pane that just opened starts."
+            },
             {
               "kind": "method",
               "name": "refresh",
@@ -285,6 +345,46 @@
                 }
               }
             },
+            {
+              "kind": "method",
+              "name": "_closable",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "description": "A pane of its own, never a line's detail."
+            },
+            {
+              "kind": "method",
+              "name": "_emitClose",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_relabelHead",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "config",
+                  "type": {
+                    "text": "AparteConfig"
+                  }
+                }
+              ],
+              "description": "The head's words, in the chat's language: the name, and Close."
+            },
             {
               "kind": "method",
               "name": "_build",
@@ -332,6 +432,15 @@
               "description": "Out of the page for good: every row's renderer cleans up, and the drawing goes."
             }
           ],
+          "events": [
+            {
+              "name": "aparte-subagent-view-close",
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "The Close button, or Escape inside a `closable` view. The view does not hide itself: the app owns the layout. Bubbles."
+            }
+          ],
           "attributes": [
             {
               "name": "for",
@@ -354,6 +463,13 @@
               },
               "description": "Which sub-agent (`aparte-subagent-start`'s `agentId`)."
             },
+            {
+              "name": "closable",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "A pane of its own: the sub-agent's name and a Close button above its conversation, and Escape inside it closes too. Both only say so (`aparte-subagent-view-close`): the app, or `connectSubagentView`, folds the pane."
+            },
             {
               "type": {
                 "text": "boolean"
@@ -460,6 +576,40 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/connect.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "connectSubagentView",
+          "return": {
+            "type": {
+              "text": "() => void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "options",
+              "type": {
+                "text": "ConnectSubagentViewOptions"
+              }
+            }
+          ],
+          "description": "Wire a chat's sub-agent lines to a view. Returns a function that undoes all of it.\n\nThe lines need `setupSubagents({ open: 'event' })` for their Open button: that is the setup's\noption, not this function's, since a line drawn before the wiring exists is drawn already.\nA sub-agent's own sub-agents, drawn as lines inside the view, open in the same view."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "connectSubagentView",
+          "declaration": {
+            "name": "connectSubagentView",
+            "module": "src/connect.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/drawing.ts",
@@ -636,6 +786,31 @@
               ],
               "description": "The row for `id` among the container's own children — never a decoy in a row's prose."
             },
+            {
+              "kind": "method",
+              "name": "inPlaceOf",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "HTMLElement | null"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "next",
+                  "type": {
+                    "text": "ChildNode | null"
+                  }
+                },
+                {
+                  "name": "id",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "The element standing where a row stood (before `next`) when it is no row's: what a\nrenderer put in place of its own without the id (`outerHTML`, `replaceWith`), stamped so\nthe loop finds it. A renderer that took its element away left another row there, or\nnothing: the row keeps its element, and the loop puts it back."
+            },
             {
               "kind": "method",
               "name": "release",
@@ -735,6 +910,30 @@
             "module": "./transcript.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "connectSubagentView",
+          "declaration": {
+            "name": "connectSubagentView",
+            "module": "./connect.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ConnectSubagentViewOptions",
+          "declaration": {
+            "name": "ConnectSubagentViewOptions",
+            "module": "./connect.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "SubagentViewSplit",
+          "declaration": {
+            "name": "SubagentViewSplit",
+            "module": "./connect.js"
+          }
+        },
         {
           "kind": "js",
           "name": "AparteSubagentView",
@@ -806,6 +1005,14 @@
             "name": "AparteSubagentEndEventDetail",
             "module": "./types.js"
           }
+        },
+        {
+          "kind": "js",
+          "name": "AparteSubagentOpenEventDetail",
+          "declaration": {
+            "name": "AparteSubagentOpenEventDetail",
+            "module": "./types.js"
+          }
         }
       ]
     },
@@ -846,6 +1053,30 @@
             "module": "./transcript.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "connectSubagentView",
+          "declaration": {
+            "name": "connectSubagentView",
+            "module": "./connect.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ConnectSubagentViewOptions",
+          "declaration": {
+            "name": "ConnectSubagentViewOptions",
+            "module": "./connect.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "SubagentViewSplit",
+          "declaration": {
+            "name": "SubagentViewSplit",
+            "module": "./connect.js"
+          }
+        },
         {
           "kind": "js",
           "name": "AparteSubagentView",
@@ -917,6 +1148,14 @@
             "name": "AparteSubagentEndEventDetail",
             "module": "./types.js"
           }
+        },
+        {
+          "kind": "js",
+          "name": "AparteSubagentOpenEventDetail",
+          "declaration": {
+            "name": "AparteSubagentOpenEventDetail",
+            "module": "./types.js"
+          }
         }
       ]
     },
@@ -924,6 +1163,30 @@
       "kind": "javascript-module",
       "path": "src/lanes.ts",
       "declarations": [
+        {
+          "kind": "function",
+          "name": "lastLaneWrite",
+          "return": {
+            "type": {
+              "text": "LaneWrite | undefined"
+            }
+          },
+          "parameters": [
+            {
+              "name": "messageId",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "agentId",
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "The last anchor written for this sub-agent while its run goes on, if any."
+        },
         {
           "kind": "function",
           "name": "watchLaneWrites",
@@ -954,6 +1217,14 @@
         }
       ],
       "exports": [
+        {
+          "kind": "js",
+          "name": "lastLaneWrite",
+          "declaration": {
+            "name": "lastLaneWrite",
+            "module": "src/lanes.ts"
+          }
+        },
         {
           "kind": "js",
           "name": "watchLaneWrites",
@@ -1033,6 +1304,206 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/open.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "isShown",
+          "return": {
+            "type": {
+              "text": "boolean"
+            }
+          },
+          "parameters": [
+            {
+              "name": "messageId",
+              "type": {
+                "text": "string | undefined"
+              }
+            },
+            {
+              "name": "agentId",
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "Whether some view shows this sub-agent now."
+        },
+        {
+          "kind": "function",
+          "name": "setShown",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "owner",
+              "type": {
+                "text": "object"
+              }
+            },
+            {
+              "name": "at",
+              "type": {
+                "text": "{ messageId: string; agentId: string } | null"
+              }
+            }
+          ],
+          "description": "`owner` shows this sub-agent now, or nothing (`null`)."
+        },
+        {
+          "kind": "function",
+          "name": "openButtonOf",
+          "return": {
+            "type": {
+              "text": "HTMLElement | null"
+            }
+          },
+          "parameters": [
+            {
+              "name": "row",
+              "type": {
+                "text": "Element"
+              }
+            }
+          ],
+          "description": "The row's Open button: core's, in its own line, or — a row with a detail — in the slot\nbeside its disclosure (never in a summary, never a nested row's)."
+        },
+        {
+          "kind": "function",
+          "name": "markRow",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "row",
+              "type": {
+                "text": "Element"
+              }
+            },
+            {
+              "name": "on",
+              "type": {
+                "text": "boolean"
+              }
+            }
+          ],
+          "description": "Mark a row as the one shown, or not: the two marks core writes from `open.current` when it\ndraws the row, written here on a row already drawn so it does not wait for its next draw."
+        },
+        {
+          "kind": "function",
+          "name": "unmarkAll",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "root",
+              "type": {
+                "text": "ParentNode"
+              }
+            }
+          ],
+          "description": "Every row marked as shown under `root`, unmarked."
+        },
+        {
+          "kind": "function",
+          "name": "dispatchOpen",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "row",
+              "type": {
+                "text": "HTMLElement"
+              }
+            },
+            {
+              "name": "segment",
+              "type": {
+                "text": "AparteToolCallSegment"
+              }
+            },
+            {
+              "name": "sub",
+              "type": {
+                "text": "AparteSubagent"
+              }
+            },
+            {
+              "name": "standIn",
+              "type": {
+                "text": "boolean"
+              }
+            }
+          ],
+          "description": "Dispatch `aparte-subagent-open` from the row of `sub`, drawn for `segment`."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "isShown",
+          "declaration": {
+            "name": "isShown",
+            "module": "src/open.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "setShown",
+          "declaration": {
+            "name": "setShown",
+            "module": "src/open.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "openButtonOf",
+          "declaration": {
+            "name": "openButtonOf",
+            "module": "src/open.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "markRow",
+          "declaration": {
+            "name": "markRow",
+            "module": "src/open.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "unmarkAll",
+          "declaration": {
+            "name": "unmarkAll",
+            "module": "src/open.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "dispatchOpen",
+          "declaration": {
+            "name": "dispatchOpen",
+            "module": "src/open.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/segment.ts",
@@ -1254,6 +1725,154 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/steps.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "stepStarted",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "messageId",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "agentId",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "name",
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "A step of the sub-agent `agentId` of the reply `messageId` begins."
+        },
+        {
+          "kind": "function",
+          "name": "stepEnded",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "messageId",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "agentId",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "name",
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "The latest open step of that name ends."
+        },
+        {
+          "kind": "function",
+          "name": "stepsEnded",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "messageId",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "agentId",
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "Every step of the sub-agent ends: it ended, or its reply did."
+        },
+        {
+          "kind": "function",
+          "name": "currentStep",
+          "return": {
+            "type": {
+              "text": "string | undefined"
+            }
+          },
+          "parameters": [
+            {
+              "name": "messageId",
+              "type": {
+                "text": "string | undefined"
+              }
+            },
+            {
+              "name": "agentId",
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "The step the sub-agent is on, if any. Without the reply's id (a segment that does not carry\none), the first sub-agent of that id with a step open."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "stepStarted",
+          "declaration": {
+            "name": "stepStarted",
+            "module": "src/steps.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "stepEnded",
+          "declaration": {
+            "name": "stepEnded",
+            "module": "src/steps.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "stepsEnded",
+          "declaration": {
+            "name": "stepsEnded",
+            "module": "src/steps.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "currentStep",
+          "declaration": {
+            "name": "currentStep",
+            "module": "src/steps.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/styles.ts",
@@ -1356,7 +1975,7 @@
         {
           "kind": "variable",
           "name": "WORDS",
-          "default": "{ /** How many tool calls a sub-agent made, on its line: \"3 tools\". */ subagentsTools: { en: 'one:{n} tool|other:{n} tools', fr: 'one:{n} outil|other:{n} outils', de: 'one:{n} Tool|other:{n} Tools', es: 'one:{n} herramienta|other:{n} herramientas', it: 'one:{n} strumento|other:{n} strumenti', ja: 'other:{n} 個のツール', ko: 'other:도구 {n}개', pt: 'one:{n} ferramenta|other:{n} ferramentas', ru: 'one:{n} инструмент|few:{n} инструмента|many:{n} инструментов|other:{n} инструмента', zh: 'other:{n} 个工具', }, /** What a sub-agent's second line says before its first call. */ subagentsStarting: { en: 'Starting…', fr: 'Démarrage…', de: 'Wird gestartet…', es: 'Iniciando…', it: 'Avvio…', ja: '開始しています…', ko: '시작하는 중…', pt: 'Iniciando…', ru: 'Запуск…', zh: '正在启动…', }, /** The name of a sub-agent that was given none, when no call names its line either. */ subagentsUnnamed: { en: 'Sub-agent', fr: 'Sous-agent', de: 'Subagent', es: 'Subagente', it: 'Sottoagente', ja: 'サブエージェント', ko: '하위 에이전트', pt: 'Subagente', ru: 'Субагент', zh: '子智能体', }, } satisfies Record<string, Word>"
+          "default": "{ /** How many tool calls a sub-agent made, on its line: \"3 tools\". */ subagentsTools: { en: 'one:{n} tool|other:{n} tools', fr: 'one:{n} outil|other:{n} outils', de: 'one:{n} Tool|other:{n} Tools', es: 'one:{n} herramienta|other:{n} herramientas', it: 'one:{n} strumento|other:{n} strumenti', ja: 'other:{n} 個のツール', ko: 'other:도구 {n}개', pt: 'one:{n} ferramenta|other:{n} ferramentas', ru: 'one:{n} инструмент|few:{n} инструмента|many:{n} инструментов|other:{n} инструмента', zh: 'other:{n} 个工具', }, /** What a sub-agent's second line says before its first call. */ subagentsStarting: { en: 'Starting…', fr: 'Démarrage…', de: 'Wird gestartet…', es: 'Iniciando…', it: 'Avvio…', ja: '開始しています…', ko: '시작하는 중…', pt: 'Iniciando…', ru: 'Запуск…', zh: '正在启动…', }, /** The name of a sub-agent that was given none, when no call names its line either. */ subagentsUnnamed: { en: 'Sub-agent', fr: 'Sous-agent', de: 'Subagent', es: 'Subagente', it: 'Sottoagente', ja: 'サブエージェント', ko: '하위 에이전트', pt: 'Subagente', ru: 'Субагент', zh: '子智能体', }, /** The Open button on a sub-agent's line (`setupSubagents({ open: 'event' })`): its name and tooltip. */ subagentsOpen: { en: 'Open {name}', fr: 'Ouvrir {name}', de: '{name} öffnen', es: 'Abrir {name}', it: 'Apri {name}', ja: '{name} を開く', ko: '{name} 열기', pt: 'Abrir {name}', ru: 'Открыть: {name}', zh: '打开 {name}', }, /** The Close button of a `<aparte-subagent-view closable>`. */ subagentsClose: { en: 'Close', fr: 'Fermer', de: 'Schließen', es: 'Cerrar', it: 'Chiudi', ja: '閉じる', ko: '닫기', pt: 'Fechar', ru: 'Закрыть', zh: '关闭', }, } satisfies Record<string, Word>"
         },
         {
           "kind": "function",