stitchkit 0.100.2 → 0.101.0

package/llms.txt

@@ -9,19 +9,20 @@ Build with stitchkit: define a contract once, then `implement` it and serve it (
 Load the slice for each entrypoint your code imports — `import … from 'stitchkit/server'` → `llms/server.txt`; the root `stitchkit` import → `llms/stitchkit.txt`. A slice holds that entrypoint's API reference section and the guide pages whose home it is; every guide lives in exactly one slice, and a slice that needs another's guide names it under "Also read". Each file is at most 50.0 KB; a longer one continues in numbered parts, each naming the next at its top. Moving across versions: load `llms/upgrading.txt` and the range slices it lists between your version and the target. `llms-full.txt` inlines everything; it is far larger than a context window, so do not read it whole.
 
 ## Entrypoint slices
-- **stitchkit**: [llms/stitchkit.txt](llms/stitchkit.txt) 15.6 KB → [llms/stitchkit.2.txt](llms/stitchkit.2.txt) 37.2 KB → [llms/stitchkit.3.txt](llms/stitchkit.3.txt) 16.1 KB
+- **stitchkit**: [llms/stitchkit.txt](llms/stitchkit.txt) 16.5 KB → [llms/stitchkit.2.txt](llms/stitchkit.2.txt) 37.2 KB → [llms/stitchkit.3.txt](llms/stitchkit.3.txt) 16.1 KB
 - **stitchkit/live**: [llms/live.txt](llms/live.txt) 21.6 KB
 - **stitchkit/react**: [llms/react.txt](llms/react.txt) 9.0 KB
+- **stitchkit/react/keyboard**: [llms/react-keyboard.txt](llms/react-keyboard.txt) 9.4 KB
 - **stitchkit/tools**: [llms/tools.txt](llms/tools.txt) 45.0 KB → [llms/tools.2.txt](llms/tools.2.txt) 26.3 KB → [llms/tools.3.txt](llms/tools.3.txt) 25.4 KB
 - **stitchkit/tools/contract**: [llms/tools-contract.txt](llms/tools-contract.txt) 0.2 KB
 - **stitchkit/tools/invoker**: [llms/tools-invoker.txt](llms/tools-invoker.txt) 0.2 KB
 - **stitchkit/tools/connections**: [llms/tools-connections.txt](llms/tools-connections.txt) 3.1 KB
-- **stitchkit/cli**: [llms/cli.txt](llms/cli.txt) 42.3 KB → [llms/cli.2.txt](llms/cli.2.txt) 8.1 KB
+- **stitchkit/cli**: [llms/cli.txt](llms/cli.txt) 42.7 KB → [llms/cli.2.txt](llms/cli.2.txt) 8.1 KB
 - **stitchkit/remote**: [llms/remote.txt](llms/remote.txt) 1.0 KB
 - **stitchkit/contract**: [llms/contract.txt](llms/contract.txt) 31.9 KB
 - **stitchkit/primitives**: [llms/primitives.txt](llms/primitives.txt) 9.3 KB
-- **stitchkit/server**: [llms/server.txt](llms/server.txt) 45.3 KB → [llms/server.2.txt](llms/server.2.txt) 14.6 KB → [llms/server.3.txt](llms/server.3.txt) 45.6 KB → [llms/server.4.txt](llms/server.4.txt) 37.5 KB → [llms/server.5.txt](llms/server.5.txt) 21.8 KB
-- **stitchkit/observability**: [llms/observability.txt](llms/observability.txt) 43.4 KB
+- **stitchkit/server**: [llms/server.txt](llms/server.txt) 45.3 KB → [llms/server.2.txt](llms/server.2.txt) 14.6 KB → [llms/server.3.txt](llms/server.3.txt) 45.6 KB → [llms/server.4.txt](llms/server.4.txt) 38.1 KB → [llms/server.5.txt](llms/server.5.txt) 21.8 KB
+- **stitchkit/observability**: [llms/observability.txt](llms/observability.txt) 44.8 KB
 - **stitchkit/agent-runtime**: [llms/agent-runtime.txt](llms/agent-runtime.txt) 36.8 KB → [llms/agent-runtime.2.txt](llms/agent-runtime.2.txt) 46.7 KB → [llms/agent-runtime.3.txt](llms/agent-runtime.3.txt) 34.3 KB
 - **stitchkit/agent-runtime/testing**: [llms/agent-runtime-testing.txt](llms/agent-runtime-testing.txt) 2.2 KB
 - **stitchkit/agent-runtime/harness**: [llms/agent-runtime-harness.txt](llms/agent-runtime-harness.txt) 4.1 KB
@@ -39,7 +40,9 @@ Load the slice for each entrypoint your code imports — `import … from 'stitc
 - **stitchkit/testing**: [llms/testing.txt](llms/testing.txt) 30.8 KB
 - **stitchkit/agent-runtime/sandbox**: [llms/agent-runtime-sandbox.txt](llms/agent-runtime-sandbox.txt) 8.1 KB
 - **stitchkit/files**: [llms/files.txt](llms/files.txt) 2.9 KB
-- **stitchkit/telegram**: [llms/telegram.txt](llms/telegram.txt) 12.0 KB
+- **stitchkit/telegram**: [llms/telegram.txt](llms/telegram.txt) 26.9 KB
+- **stitchkit/telegram/html**: [llms/telegram-html.txt](llms/telegram-html.txt) 2.7 KB
+- **stitchkit/telegram/screens**: [llms/telegram-screens.txt](llms/telegram-screens.txt) 21.2 KB
 - **stitchkit/tracking**: [llms/tracking.txt](llms/tracking.txt) 16.8 KB
 - **stitchkit/release**: [llms/release.txt](llms/release.txt) 8.9 KB
 - **stitchkit/tracking/server**: [llms/tracking-server.txt](llms/tracking-server.txt) 2.5 KB
@@ -52,7 +55,7 @@ Load the slice for each entrypoint your code imports — `import … from 'stitc
 
 ## Upgrading slices
 - **Upgrading — how to move across versions**: [llms/upgrading.txt](llms/upgrading.txt) 10.3 KB
-- **Upgrading 0.74.0 → 0.100.0**: [llms/upgrading-0.74.0-0.100.0.txt](llms/upgrading-0.74.0-0.100.0.txt) 45.1 KB
+- **Upgrading 0.74.0 → 0.101.0**: [llms/upgrading-0.74.0-0.101.0.txt](llms/upgrading-0.74.0-0.101.0.txt) 46.3 KB
 - **Upgrading 0.61.0 → 0.73.0**: [llms/upgrading-0.61.0-0.73.0.txt](llms/upgrading-0.61.0-0.73.0.txt) 41.2 KB
 - **Upgrading 0.44.0 → 0.60.0**: [llms/upgrading-0.44.0-0.60.0.txt](llms/upgrading-0.44.0-0.60.0.txt) 43.9 KB
 - **Upgrading 0.37.0 → 0.37.0**: [llms/upgrading-0.37.0.txt](llms/upgrading-0.37.0.txt) 6.2 KB
@@ -80,8 +83,10 @@ Load the slice for each entrypoint your code imports — `import … from 'stitc
 - [Multi-tenant](https://github.com/max-listov/stitchkit/blob/master/docs/guide/multi-tenant.md): a /tenants/:id/… scenario end-to-end — scopePrefixes, scoped client, extend
 - [Frontend integrations](https://github.com/max-listov/stitchkit/blob/master/docs/guide/frontend-integrations.md): React Router resource routes and a separate Vite development proxy
 - [React Query policy](https://github.com/max-listov/stitchkit/blob/master/docs/guide/react.md): request-local SSR clients, a browser singleton and ApiError retry rules
+- [Keyboard layers and list zones](https://github.com/max-listov/stitchkit/blob/master/docs/guide/keyboard.md): stitchkit/react/keyboard — which part of a screen gets a key: ordered layers, one Escape per level, list zones that move real focus
 - [Voice](https://github.com/max-listov/stitchkit/blob/master/docs/guide/voice.md): stitchkit/voice — sentences cut while a reply streams, the text a voice reads, a speech queue that synthesises ahead and stops on interruption
-- [Telegram bots](https://github.com/max-listov/stitchkit/blob/master/docs/guide/telegram.md): stitchkit/telegram — the journal, the operator channel, resumable broadcasts, local Bot API files; the bot as application resources
+- [Telegram bots](https://github.com/max-listov/stitchkit/blob/master/docs/guide/telegram.md): stitchkit/telegram — the journal, the operator channel, resumable broadcasts, local Bot API files, webhook ownership and durable update intake, message markup (stitchkit/telegram/html); the bot as application resources
+- [Telegram screens](https://github.com/max-listov/stitchkit/blob/master/docs/guide/telegram-screens.md): stitchkit/telegram/screens — a bot menu as declared screens: typed paths, actions and input, messages reconciled in place, state in a StorageAdapter, a test chat
 - [GeoIP](https://github.com/max-listov/stitchkit/blob/master/docs/guide/geo.md): stitchkit/geo — a server-only managed reader, three observable states and last-known-good generation reloads
 - [Upgrading](https://github.com/max-listov/stitchkit/blob/master/docs/guide/upgrading.md): moving a project across stitchkit versions; how breaking changes are marked
 - [Project declaration](https://github.com/max-listov/stitchkit/blob/master/docs/guide/declaration.md): the optional machine-readable statement a repository makes about itself — identity, roles, build, requirements, release steps and the names of the values a deployment supplies

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stitchkit",
-  "version": "0.100.2",
+  "version": "0.101.0",
   "description": "Contract-first backend framework — one defineContract() into an HTTP API, MCP tools, AI-agent tools and a typed client. Bun and Node.",
   "keywords": [
     "bun",
@@ -62,6 +62,10 @@
       "types": "./dist/entrypoints/react.d.ts",
       "import": "./dist/entrypoints/react.js"
     },
+    "./react/keyboard": {
+      "types": "./dist/entrypoints/react/keyboard.d.ts",
+      "import": "./dist/entrypoints/react/keyboard.js"
+    },
     "./tools": {
       "types": "./dist/entrypoints/tools.d.ts",
       "import": "./dist/entrypoints/tools.js"
@@ -174,6 +178,14 @@
       "types": "./dist/entrypoints/telegram.d.ts",
       "import": "./dist/entrypoints/telegram.js"
     },
+    "./telegram/html": {
+      "types": "./dist/entrypoints/telegram/html.d.ts",
+      "import": "./dist/entrypoints/telegram/html.js"
+    },
+    "./telegram/screens": {
+      "types": "./dist/entrypoints/telegram/screens.d.ts",
+      "import": "./dist/entrypoints/telegram/screens.js"
+    },
     "./tracking": {
       "types": "./dist/entrypoints/tracking.d.ts",
       "import": "./dist/entrypoints/tracking.js"
@@ -308,6 +320,7 @@
     "ky": "^2.1.0"
   },
   "devDependencies": {
+    "@happy-dom/global-registrator": "^20.14.5",
     "@modelcontextprotocol/client": "^2.0.0",
     "@modelcontextprotocol/ext-apps": "^2.0.0",
     "@modelcontextprotocol/server": "^2.0.0",
@@ -319,12 +332,14 @@
     "@types/bun": "^1.4.2",
     "@types/json-schema": "^7.0.15",
     "@types/react": "^19.3.0",
+    "@types/react-dom": "^19.3.0",
     "@typescript/typescript6": "^6.0.2",
     "ai": "^7.0.111",
     "fake-indexeddb": "^6.2.5",
-    "grammy": "^1.46.0",
     "google-auth-library": "^11.1.0",
+    "grammy": "^1.46.0",
     "react": "^19.3.0",
+    "react-dom": "^19.3.0",
     "react-query-kit": "^3.3.4",
     "socket.io": "^4.8.3",
     "socket.io-client": "^4.8.3",

package/dist/index-2k4yrqkc.js

@@ -1,9 +0,0 @@
-// src/application/resource.ts
-function managedResourceDependencyId(dependency) {
-  return typeof dependency === "string" ? dependency : dependency.id;
-}
-function defineManagedResource(resource) {
-  return resource;
-}
-
-export { managedResourceDependencyId, defineManagedResource };

package/dist/index-crykmqkr.js

@@ -1,26 +0,0 @@
-import {
-  AgentMessageSchema,
-  AgentRecordIdSchema,
-  AgentRecordVersionSchema
-} from "./index-gtj3zc53.js";
-
-// src/agent-runtime/conversations.ts
-import { z } from "zod";
-var AgentConversationSummarySchema = z.object({
-  conversationId: AgentRecordIdSchema,
-  version: AgentRecordVersionSchema,
-  updatedAt: z.iso.datetime({ offset: true }),
-  preview: z.string(),
-  activeRuns: z.int().nonnegative()
-}).strict();
-var AgentConversationPageSchema = z.object({
-  items: z.array(AgentConversationSummarySchema),
-  nextCursor: z.string().min(1).optional()
-}).strict();
-var AgentConversationMessagePageSchema = z.object({
-  items: z.array(AgentMessageSchema),
-  compacted: z.array(z.string().min(1)),
-  nextCursor: z.string().min(1).optional()
-}).strict();
-
-export { AgentConversationSummarySchema, AgentConversationPageSchema, AgentConversationMessagePageSchema };

package/dist/index-y64k3s0h.js

@@ -1,150 +0,0 @@
-import {
-  AgentAssistantPlaceholderSchema,
-  AgentMessageSchema,
-  AgentProviderEnvelopeSchema,
-  AgentRecordIdSchema,
-  AgentRecordVersionSchema,
-  AgentRunMetricsSchema,
-  AgentRunOperationSchema,
-  AgentRunSchema,
-  AgentRunStateSchema,
-  AgentTerminalReasonSchema,
-  AgentTimestampSchema
-} from "./index-gtj3zc53.js";
-
-// src/agent-runtime/event-schema.ts
-import { z } from "zod";
-var AgentAdmissionEventSchema = z.object({
-  type: z.literal("admission"),
-  eventId: AgentRecordIdSchema,
-  conversationId: AgentRecordIdSchema,
-  runId: AgentRecordIdSchema,
-  snapshotVersion: AgentRecordVersionSchema,
-  input: AgentMessageSchema,
-  run: AgentRunSchema,
-  assistant: z.union([AgentAssistantPlaceholderSchema, AgentMessageSchema]),
-  emittedAt: AgentTimestampSchema
-});
-var EventIdentitySchema = z.object({
-  conversationId: AgentRecordIdSchema,
-  runId: AgentRecordIdSchema,
-  emittedAt: AgentTimestampSchema
-});
-var AgentTransientDeltaEventSchema = EventIdentitySchema.extend({
-  type: z.literal("assistant-delta"),
-  runtimeEpoch: z.string().min(1),
-  sequence: z.int().nonnegative(),
-  textDelta: z.string()
-});
-var AgentTransientReasoningIdentitySchema = EventIdentitySchema.extend({
-  runtimeEpoch: z.string().min(1),
-  sequence: z.int().nonnegative(),
-  provider: AgentProviderEnvelopeSchema.optional()
-});
-var AgentReasoningStartEventSchema = AgentTransientReasoningIdentitySchema.extend({
-  type: z.literal("reasoning-start")
-});
-var AgentReasoningDeltaEventSchema = AgentTransientReasoningIdentitySchema.extend({
-  type: z.literal("reasoning-delta"),
-  textDelta: z.string()
-});
-var AgentReasoningEndEventSchema = AgentTransientReasoningIdentitySchema.extend({
-  type: z.literal("reasoning-end")
-});
-var AgentAttemptResetEventSchema = EventIdentitySchema.extend({
-  type: z.literal("attempt-reset"),
-  runtimeEpoch: z.string().min(1),
-  sequence: z.int().nonnegative(),
-  attempt: z.int().positive()
-});
-var AgentCheckpointEventSchema = EventIdentitySchema.extend({
-  type: z.literal("assistant-checkpoint"),
-  eventId: AgentRecordIdSchema,
-  snapshotVersion: AgentRecordVersionSchema,
-  message: AgentMessageSchema,
-  metrics: AgentRunMetricsSchema.optional()
-});
-var AgentRunStateEventSchema = EventIdentitySchema.extend({
-  type: z.literal("run-state"),
-  eventId: AgentRecordIdSchema,
-  snapshotVersion: AgentRecordVersionSchema,
-  state: AgentRunStateSchema
-});
-var AgentRunOperationEventSchema = EventIdentitySchema.extend({
-  type: z.literal("run-operation"),
-  eventId: AgentRecordIdSchema,
-  snapshotVersion: AgentRecordVersionSchema,
-  operation: AgentRunOperationSchema
-});
-var AgentToolStatusEventSchema = EventIdentitySchema.extend({
-  type: z.literal("tool-status"),
-  runtimeEpoch: z.string().min(1),
-  sequence: z.int().nonnegative(),
-  callId: AgentRecordIdSchema,
-  toolName: z.string().min(1),
-  status: z.enum(["started", "completed", "failed", "interrupted"]),
-  input: z.json().optional(),
-  output: z.json().optional()
-});
-var AgentTerminalEventSchema = EventIdentitySchema.extend({
-  type: z.literal("terminal"),
-  eventId: AgentRecordIdSchema,
-  snapshotVersion: AgentRecordVersionSchema,
-  reason: AgentTerminalReasonSchema,
-  policyName: z.string().min(1).optional(),
-  message: AgentMessageSchema,
-  metrics: AgentRunMetricsSchema.optional()
-});
-var AgentRuntimeEventSchema = z.discriminatedUnion("type", [
-  AgentAdmissionEventSchema,
-  AgentTransientDeltaEventSchema,
-  AgentReasoningStartEventSchema,
-  AgentReasoningDeltaEventSchema,
-  AgentReasoningEndEventSchema,
-  AgentAttemptResetEventSchema,
-  AgentCheckpointEventSchema,
-  AgentRunStateEventSchema,
-  AgentRunOperationEventSchema,
-  AgentToolStatusEventSchema,
-  AgentTerminalEventSchema
-]);
-var AgentRuntimeEventCursorSchema = z.object({
-  snapshotVersion: AgentRecordVersionSchema.optional(),
-  durableEventIds: z.array(AgentRecordIdSchema).optional(),
-  runtimeEpoch: z.string().min(1).optional(),
-  sequence: z.int().nonnegative().optional()
-});
-function isDurableEvent(event) {
-  return event.type === "admission" || event.type === "assistant-checkpoint" || event.type === "run-state" || event.type === "run-operation" || event.type === "terminal";
-}
-function advanceAgentRuntimeEventCursor(rawCursor, event) {
-  const cursor = AgentRuntimeEventCursorSchema.parse(rawCursor);
-  if (isDurableEvent(event)) {
-    const previous = cursor.snapshotVersion;
-    const durableEventIds = previous === event.snapshotVersion ? cursor.durableEventIds ?? [] : [];
-    if (previous !== undefined && event.snapshotVersion < previous || durableEventIds.includes(event.eventId)) {
-      return { status: "duplicate", cursor };
-    }
-    return {
-      status: "accepted",
-      cursor: {
-        ...cursor,
-        snapshotVersion: event.snapshotVersion,
-        durableEventIds: [...durableEventIds, event.eventId]
-      }
-    };
-  }
-  const previousSequence = cursor.runtimeEpoch === event.runtimeEpoch ? cursor.sequence : undefined;
-  if (previousSequence !== undefined && event.sequence <= previousSequence) {
-    return { status: "duplicate", cursor };
-  }
-  return {
-    status: previousSequence !== undefined && event.sequence > previousSequence + 1 ? "gap" : "accepted",
-    cursor: { ...cursor, runtimeEpoch: event.runtimeEpoch, sequence: event.sequence }
-  };
-}
-function agentDurableEventId(type, runId, snapshotVersion) {
-  return `${runId}:${type}:${snapshotVersion}`;
-}
-
-export { AgentAdmissionEventSchema, AgentTransientDeltaEventSchema, AgentReasoningStartEventSchema, AgentReasoningDeltaEventSchema, AgentReasoningEndEventSchema, AgentAttemptResetEventSchema, AgentCheckpointEventSchema, AgentRunStateEventSchema, AgentRunOperationEventSchema, AgentToolStatusEventSchema, AgentTerminalEventSchema, AgentRuntimeEventSchema, AgentRuntimeEventCursorSchema, advanceAgentRuntimeEventCursor, agentDurableEventId };

package/dist/index-y91ry9h2.js

@@ -1,4 +0,0 @@
-// src/release/header.ts
-var RELEASE_HEADER = "X-Build-Id";
-
-export { RELEASE_HEADER };