@k2b/cloud 0.27.0 → 0.28.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@k2b/cloud",
-  "version": "0.27.0",
+  "version": "0.28.0",
   "description": "Application platform library for independently deployed Hono and SolidJS services behind a dynamic gateway.",
   "license": "AGPL-3.0-or-later",
   "repository": {
@@ -100,7 +100,7 @@
     "@tailwindcss/typography": "0.5.20",
     "@k2b/nessi": "0.15.0",
     "@k2b/ssr": "0.14.0",
-    "@k2b/ui": "0.17.0",
+    "@k2b/ui": "0.18.0",
     "@k2b/stdlib": "0.27.0",
     "@k2b/sync": "7.0.0",
     "@nats-io/jetstream": "3.4.0",

package/src/ai/browser-code-contracts.ts

@@ -10,20 +10,20 @@ export const CODE_RUNTIME_TOOL_NAMES = [
   "code_run",
   "code_action",
   "code_inspect",
-  "code_interact",
   "code_stop",
   "code_open",
   "code_export",
   "code_present",
+  "code_check",
   "code_secret",
 ] as const;
 export const CodeRunInput = z
   .object({
-    id: id.optional(),
+    id: id.optional().describe("Saved script resource to run; an app with an index.html interface opens with code_open instead."),
     resourceId: id
       .optional()
       .describe(
-        "Optional data context for one-off code. Requires Manage; uses this resource database and shared files/KV without changing its source. Test runs use real shared and personal data; writes and capability effects keep normal permissions and approvals.",
+        "Optional data context for one-off code. Requires Manage; uses this resource database and shared files/KV without changing its source. Runs use real shared and personal data; writes and capability effects keep normal permissions and approvals.",
       ),
     version: z
       .number()
@@ -36,14 +36,12 @@ export const CodeRunInput = z
       .min(1)
       .max(1024 * 1024)
       .optional()
-      .describe("One-off JavaScript/TypeScript entry exporting one function. Use code OR a saved resource id; no title or icon needed."),
+      .describe("One-off JavaScript/TypeScript script exporting one function. Use code OR a saved resource id; no title or icon needed."),
     inputPaths: z
       .array(z.string().min(1).max(500))
       .max(64)
       .default([])
-      .describe(
-        "Explicit current-chat input files. Scripts can read them; app test runs expose them only through the simulated picker. User apps never receive chat files.",
-      ),
+      .describe("Explicit current-chat input files; the script reads them from its context files. Apps never receive chat files."),
   })
   .strict()
   .refine((input) => Number(input.id !== undefined) + Number(input.code !== undefined) === 1, "Provide exactly one of id or code")
@@ -91,66 +89,38 @@ export const CodeInspectInput = z
       .max(30000)
       .default(0)
       .describe("Wait up to this duration for background work to finish before returning its real state; never restarts work."),
-    nodeId: z.string().min(1).max(80).optional(),
-    offset: z.number().int().min(0).default(0),
-    limit: z.number().int().min(1).max(100).default(20),
   })
   .strict();
-const CodeInteraction = z
+export const CodeStopInput = z.object({ runId }).strict();
+export const CodeOpenInput = z.object({ id }).strict();
+const AppFilePath = z
+  .string()
+  .min(1)
+  .max(180)
+  .regex(/^[a-zA-Z0-9_.-]+(?:\/[a-zA-Z0-9_.-]+)*$/)
+  .refine((path) => path.split("/").every((part) => part !== "." && part !== ".."), "Expected a relative path without . or ..");
+export const CodePresentInput = z
   .object({
-    id: z.string().min(1).max(80).describe("Control ID or pending modal ID returned by the snapshot."),
-    event: z
-      .discriminatedUnion("type", [
-        z
-          .object({
-            type: z.literal("change"),
-            value: z.union([
-              z.string(),
-              z.number().finite(),
-              z.boolean(),
-              z.null(),
-              z.array(z.string()),
-              z.object({ start: z.iso.date().nullable(), end: z.iso.date().nullable() }).strict(),
-            ]),
-          })
-          .strict(),
-        z.object({ type: z.literal("select"), key: z.string().nullable() }).strict(),
-        z.object({ type: z.literal("view"), value: z.enum(["chart", "table"]) }).strict(),
-        z.object({ type: z.literal("refresh") }).strict(),
-        z.object({ type: z.literal("request"), request: z.record(z.string(), z.json()) }).strict(),
-      ])
+    id: id
       .optional()
-      .describe(
-        "An event object, never a JSON-encoded string. Omit to activate a button. Example: {type:'change',value:['Sued']} or {type:'view',value:'table'}.",
-      ),
-    answer: z.json().optional().describe("Only for the pending modal ID: the modal answer, or null to cancel. Do not use for controls."),
-  })
-  .strict();
-const validInteraction = (input: z.infer<typeof CodeInteraction>) => input.event === undefined || input.answer === undefined;
-export const CodeInteractInput = CodeInteraction.partial({ id: true })
-  .extend({
-    runId,
-    // Three normal 15-second callback budgets share the existing 45-second call budget.
-    steps: z
-      .array(CodeInteraction.refine(validInteraction, "Supply event OR answer"))
+      .describe("Saved app with an index.html interface; the card runs it live with its data. Omit title to use the app title."),
+    files: z
+      .array(z.object({ path: AppFilePath, content: z.string().max(1024 * 1024) }).strict())
       .min(1)
-      .max(3)
+      .max(64)
       .optional()
-      .describe(
-        "Up to three sequential interactions in one call. Use steps OR the top-level id/event/answer. Stops on an error, pending modal or background work; returns completedSteps and nextStep.",
-      ),
+      .describe("One-off app for this chat: index.html plus optional style.css, app.js and other modules. It has no saved data."),
+    title: z.string().trim().min(1).max(120).optional().describe("Card title; required with files."),
   })
   .strict()
-  .refine(
-    (input) =>
-      input.steps
-        ? input.id === undefined && input.event === undefined && input.answer === undefined
-        : input.id !== undefined && (input.event === undefined || input.answer === undefined),
-    "Supply steps OR one id with event/answer.",
-  );
-export const CodeStopInput = z.object({ runId }).strict();
-export const CodeOpenInput = z.object({ id }).strict();
-export const CodePresentInput = z.object({ runId, title: z.string().trim().min(1).max(120) }).strict();
+  .refine((input) => Number(input.id !== undefined) + Number(input.files !== undefined) === 1, "Provide exactly one of id or files")
+  .refine((input) => input.id !== undefined || input.title !== undefined, "A one-off app needs a title")
+  .refine((input) => !input.files || input.files.some((file) => file.path === "index.html"), "files must contain index.html");
+export const CodeCheckInput = z
+  .object({ id: id.optional(), files: CodePresentInput.shape.files })
+  .strict()
+  .refine((input) => Number(input.id !== undefined) + Number(input.files !== undefined) === 1, "Provide exactly one of id or files")
+  .refine((input) => !input.files || input.files.some((file) => file.path === "index.html"), "files must contain index.html");
 export const CodeExportInput = z
   .object({ runId, name: z.string().min(1).max(180).describe("Captured output filename returned by the snapshot.") })
   .strict();
@@ -179,11 +149,11 @@ export const CodeRuntimeInput = z.discriminatedUnion("operation", [
   CodeRunInput.safeExtend({ operation: z.literal("run") }),
   CodeActionInput.safeExtend({ operation: z.literal("action") }),
   CodeInspectInput.extend({ operation: z.literal("inspect") }),
-  CodeInteractInput.safeExtend({ operation: z.literal("interact") }),
   CodeStopInput.extend({ operation: z.literal("stop") }),
   CodeOpenInput.extend({ operation: z.literal("open") }),
   CodeSecretInput.extend({ operation: z.literal("secret") }),
-  CodePresentInput.extend({ operation: z.literal("present") }),
+  CodePresentInput.safeExtend({ operation: z.literal("present") }),
+  CodeCheckInput.safeExtend({ operation: z.literal("check") }),
   CodeExportInput.extend({ operation: z.literal("export") }),
 ]);
 export type CodeRuntimeInput = z.infer<typeof CodeRuntimeInput>;
@@ -197,12 +167,12 @@ export function parseCodeToolInput(name: string, args: unknown): CodeRuntimeInpu
       return { operation: "run", ...CodeRunInput.parse(args) };
     case "code_inspect":
       return { operation: "inspect", ...CodeInspectInput.parse(args) };
-    case "code_interact":
-      return { operation: "interact", ...CodeInteractInput.parse(args) };
     case "code_stop":
       return { operation: "stop", ...CodeStopInput.parse(args) };
     case "code_open":
       return { operation: "open", ...CodeOpenInput.parse(args) };
+    case "code_check":
+      return { operation: "check", ...CodeCheckInput.parse(args) };
     case "code_present":
       return { operation: "present", ...CodePresentInput.parse(args) };
     case "code_export":

package/src/ai/browser.ts

@@ -1,6 +1,7 @@
 export {
   CODE_RUNTIME_TOOL_NAMES,
   CodeActionInput,
+  CodeCheckInput,
   CodeResourceId,
   CodeRuntimeInput,
   CodeToolFailure,

package/src/ai/chat/blocks.tsx

@@ -283,7 +283,7 @@ export function ApprovalBlockView(props: { turnId: string; block: ToolBlock }) {
             <div class="mt-4 flex flex-col gap-4 text-xs leading-5 text-secondary">
               <p class="whitespace-pre-wrap">{description()}</p>
               <Show when={inlineReviewDetails().length > 0}>
-                <dl class="grid gap-x-5 gap-y-1.5 border-t border-[var(--k2b-border)] pt-3 sm:grid-cols-[max-content_minmax(0,1fr)]">
+                <dl class="grid gap-x-5 gap-y-1.5 sm:grid-cols-[max-content_minmax(0,1fr)]">
                   <For each={inlineReviewDetails()}>
                     {(detail) => (
                       <>
@@ -313,7 +313,12 @@ export function ApprovalBlockView(props: { turnId: string; block: ToolBlock }) {
                         </pre>
                       }
                     >
-                      <div class="max-h-72 overflow-auto text-xs text-secondary" role="region" tabIndex={0} aria-label={detail.label}>
+                      <div
+                        class="-mx-2 max-h-72 overflow-auto px-2 text-xs text-secondary"
+                        role="region"
+                        tabIndex={0}
+                        aria-label={detail.label}
+                      >
                         <MarkdownView class="cloud-ai-approval-detail" markdown={detail.value} headingScale="compact" allowImages={false} />
                       </div>
                     </Show>
@@ -323,10 +328,12 @@ export function ApprovalBlockView(props: { turnId: string; block: ToolBlock }) {
             </div>
           </Show>
         </div>
-        <footer
-          class="flex min-h-12 flex-wrap items-center gap-2 border-t border-[var(--k2b-border)] bg-[var(--k2b-surface-subtle)] px-4 py-2.5"
-          data-ai-approval-footer
-        >
+        {/* The decision continues the card below its content: spacing, not a line or a band, sets it apart. */}
+        <footer class="flex min-h-12 flex-wrap items-center gap-2 px-4 pb-3" data-ai-approval-footer>
+          {/* Present from the start, so screen readers announce progress after the decision buttons leave. */}
+          <span class="k2b-sr-only" role="status" aria-live="polite">
+            {approval.loading() ? t().submitting : submitted() ? t().submitted : ""}
+          </span>
           <Show when={reviewLinks().length > 0}>
             <nav class="flex flex-wrap gap-1" aria-label={t().linksFor({ title: title() })}>
               <For each={reviewLinks()}>
@@ -339,7 +346,9 @@ export function ApprovalBlockView(props: { turnId: string; block: ToolBlock }) {
             </nav>
           </Show>
           <Show when={approval.error()}>
-            <p class="text-xs text-red-700 dark:text-red-300">{t().approvalFailed}</p>
+            <p class="text-xs text-red-700 dark:text-red-300" role="alert">
+              {t().approvalFailed}
+            </p>
           </Show>
           <div class="ml-auto shrink-0">
             <Show

package/src/ai/chat/live-turn.browser-harness.tsx

@@ -9,12 +9,15 @@ import { AiChatActionsProvider, createAiChatTimeline } from "./presentation";
 /**
  * The live chat timeline for a browser test, folded from wire events like the
  * controller does. `window.emit(event)` applies one event,
- * `window.steer(text)` appends a pending steer as the controller does, and
- * `window.reconnect(on)` sets whether the stream reconnects.
+ * `window.steer(text)` appends a pending steer as the controller does,
+ * `window.reconnect(on)` sets whether the stream reconnects, and
+ * `window.continued` lists the messages that **Continue** sent.
  */
 const [state, setState] = createStore(emptyProjection());
 const [reconnecting, setReconnecting] = createSignal(false);
+const continued: string[] = [];
 Object.assign(window, {
+  continued,
   reconnect: (on: boolean) => setReconnecting(on),
   emit: (event: AiWireEvent) => setState(reconcile(reduceProjection(state, event), { key: "id", merge: true })),
   steer: (text: string) =>
@@ -29,7 +32,7 @@ root.style.cssText = "display: flex; flex-direction: column; height: 100dvh; max
 document.body.append(root);
 render(
   () => (
-    <AiChatActionsProvider actions={{}}>
+    <AiChatActionsProvider actions={{ onContinueTurn: (message) => void continued.push(message) }}>
       {(() => {
         const items = createAiChatTimeline({
           messages: createMemo(() => visibleMessages(state)),