apps 0.0.1-beta.102 → 0.0.1-beta.105

package/js/{chunk-5C6RAGAS.js → chunk-2B7FHH7S.js}

@@ -1,18 +1,18 @@
 import {
   appInvocationFetch
-} from "./chunk-VCYWAA4N.js";
+} from "./chunk-HLMJBE4T.js";
 import {
   fromPromise,
   method,
   toPromise
-} from "./chunk-7STIP5CS.js";
+} from "./chunk-R3O32PQV.js";
 import {
   CacheAcquired,
   CacheEntry,
   CacheError,
   cacheLimits,
   scopedSlots
-} from "./chunk-4UPC36ZL.js";
+} from "./chunk-2RGJMA7N.js";
 import {
   decoderOf
 } from "./chunk-VAI3EVCS.js";

package/js/{chunk-4UPC36ZL.js → chunk-2RGJMA7N.js}

@@ -4530,6 +4530,7 @@ var HostedTool3 = Schema_exports.Struct({
   description: Schema_exports.String,
   inputSchema: JsonObject2,
   readOnly: Schema_exports.optionalKey(Schema_exports.Boolean),
+  kindConfirmed: Schema_exports.optionalKey(Schema_exports.Boolean),
   title: Schema_exports.optionalKey(Schema_exports.String),
   outputSchema: Schema_exports.optionalKey(JsonObject2),
   annotations: Schema_exports.optionalKey(ToolAnnotations2),

package/js/{chunk-RN4YB4JT.js → chunk-3UWLQMMK.js}

@@ -1,7 +1,7 @@
 import {
   authorCache,
   unavailableCache
-} from "./chunk-5C6RAGAS.js";
+} from "./chunk-2B7FHH7S.js";
 import {
   accountSecrets,
   boundFailureMessage,
@@ -12,10 +12,10 @@ import {
   parseSkillLoadFailed,
   readCatalog,
   routerSkills
-} from "./chunk-QI66R4FP.js";
+} from "./chunk-OTDKCYMH.js";
 import {
   appInvocationFetch
-} from "./chunk-VCYWAA4N.js";
+} from "./chunk-HLMJBE4T.js";
 import {
   folderSkillsEffect
 } from "./chunk-PBGPES67.js";
@@ -26,12 +26,12 @@ import {
   makeEmitter,
   toEffectApp,
   withPlacements
-} from "./chunk-ILYCJ3HV.js";
+} from "./chunk-QN5BMAG7.js";
 import {
   declaredOperations,
   locate,
   nativeOperation
-} from "./chunk-2CURR5Y7.js";
+} from "./chunk-PILIRGJA.js";
 import {
   accountProviderError,
   appCode,
@@ -39,7 +39,7 @@ import {
   httpProviderError,
   parseProviderError,
   toPromise
-} from "./chunk-7STIP5CS.js";
+} from "./chunk-R3O32PQV.js";
 import {
   AccountCheckResult,
   DeclaredProvider,
@@ -93,7 +93,7 @@ import {
   shareCatalog,
   sqlBindingsLimit,
   workflowDurationMillis
-} from "./chunk-4UPC36ZL.js";
+} from "./chunk-2RGJMA7N.js";
 import {
   AppSkills,
   SkillFile

package/js/{chunk-YWVISRZD.js → chunk-EDXNAZLI.js}

@@ -1,14 +1,14 @@
 import {
   getWithReads
-} from "./chunk-5C6RAGAS.js";
+} from "./chunk-2B7FHH7S.js";
 import {
   fromPromise,
   method,
   toPromise
-} from "./chunk-7STIP5CS.js";
+} from "./chunk-R3O32PQV.js";
 import {
   CacheError
-} from "./chunk-4UPC36ZL.js";
+} from "./chunk-2RGJMA7N.js";
 import {
   wrap
 } from "./chunk-VAI3EVCS.js";

package/js/{chunk-VCYWAA4N.js → chunk-HLMJBE4T.js}

@@ -5,7 +5,7 @@ import {
   networkRefusalHeader,
   networkRefusalStatus,
   supportedFetchOptions
-} from "./chunk-4UPC36ZL.js";
+} from "./chunk-2RGJMA7N.js";
 import {
   invocationFetch
 } from "./chunk-URKOTNDA.js";

package/js/{chunk-2LSGC7XY.js → chunk-KY7C6BWO.js}

@@ -1,11 +1,11 @@
 import {
   fixedRouter
-} from "./chunk-QI66R4FP.js";
+} from "./chunk-OTDKCYMH.js";
 import {
   nativeOperation,
   operationDeclaration,
   routerDeclaration
-} from "./chunk-2CURR5Y7.js";
+} from "./chunk-PILIRGJA.js";
 
 // src/implementation/protocol-operations.ts
 var protocolOperations = (operations, kinds = {}) => {

package/js/{chunk-QI66R4FP.js → chunk-OTDKCYMH.js}

@@ -4,12 +4,12 @@ import {
 import {
   joinPath,
   mergeMeta
-} from "./chunk-2CURR5Y7.js";
+} from "./chunk-PILIRGJA.js";
 import {
   isShortenedUpstream,
   parseProviderError,
   providerError
-} from "./chunk-7STIP5CS.js";
+} from "./chunk-R3O32PQV.js";
 import {
   ApiErrorResponse,
   CacheError,
@@ -31,7 +31,7 @@ import {
   maxFailureFields,
   maxFailureMessageLength,
   maxUpstreamMessageLength
-} from "./chunk-4UPC36ZL.js";
+} from "./chunk-2RGJMA7N.js";
 import {
   SkillLoadFailed,
   skillFormatLimits
@@ -572,6 +572,8 @@ var summaryFields = (name, router, operation, schedules) => {
     description: operation.description ?? `${readOnly ? "Query" : "Mutate"} ${name}`,
     ...operation.title === void 0 ? {} : { title: operation.title },
     readOnly,
+    // A declared operation's kind is the app's own, or its protocol's, such as an HTTP method.
+    kindConfirmed: true,
     annotations: { ...operation.annotations, readOnlyHint: readOnly }
   };
 };

package/js/{chunk-2CURR5Y7.js → chunk-PILIRGJA.js}

@@ -1,12 +1,12 @@
 import {
   fromPromise
-} from "./chunk-7STIP5CS.js";
+} from "./chunk-R3O32PQV.js";
 import {
   HostedTool,
   RouterKey,
   RouterMeta,
   reservedRouterKeys
-} from "./chunk-4UPC36ZL.js";
+} from "./chunk-2RGJMA7N.js";
 import {
   decoderOf,
   schemaArgument

package/js/{chunk-ILYCJ3HV.js → chunk-QN5BMAG7.js}

@@ -2,11 +2,11 @@ import {
   declaredOperations,
   nativeOperation,
   nativeRouter
-} from "./chunk-2CURR5Y7.js";
+} from "./chunk-PILIRGJA.js";
 import {
   fromPromise,
   method
-} from "./chunk-7STIP5CS.js";
+} from "./chunk-R3O32PQV.js";
 import {
   EmittedEvent,
   EventName,
@@ -17,7 +17,7 @@ import {
   normalizePlacements,
   placementFields,
   renderPlacement
-} from "./chunk-4UPC36ZL.js";
+} from "./chunk-2RGJMA7N.js";
 import {
   decoderOf,
   isSchema,

package/js/{chunk-7STIP5CS.js → chunk-R3O32PQV.js}

@@ -1,7 +1,7 @@
 import {
   ProviderError,
   maxUpstreamMessageLength
-} from "./chunk-4UPC36ZL.js";
+} from "./chunk-2RGJMA7N.js";
 import {
   owned
 } from "./chunk-URKOTNDA.js";

package/js/{chunk-6GAHIQ6X.js → chunk-X45GWW4A.js}

@@ -1,16 +1,16 @@
 import {
   prepareElicitation
-} from "./chunk-RN4YB4JT.js";
+} from "./chunk-3UWLQMMK.js";
 import {
   failOnNetworkRefusal
-} from "./chunk-VCYWAA4N.js";
+} from "./chunk-HLMJBE4T.js";
 import {
   accountProviderError,
   bodyUpstreamError,
   fromPromise,
   httpProviderError,
   providerErrorDetail
-} from "./chunk-7STIP5CS.js";
+} from "./chunk-R3O32PQV.js";
 import {
   ElicitationFailed,
   McpCredentialsUnverified,
@@ -28,7 +28,7 @@ import {
   defaultMcpClientLimits,
   mcpHealthReserveMs,
   mcpSdkTimerCeilingMs
-} from "./chunk-4UPC36ZL.js";
+} from "./chunk-2RGJMA7N.js";
 import {
   jsonSchemaDecoder,
   nestJsonSchema,

package/js/contracts.js

@@ -182,7 +182,7 @@ import {
   skillCatalog,
   skillsCommand,
   workflowDurationMillis
-} from "./chunk-4UPC36ZL.js";
+} from "./chunk-2RGJMA7N.js";
 import {
   AppSkillMetadata,
   AppSkillName,

package/js/effect.js

@@ -3,17 +3,17 @@ import {
   ApprovalDecision,
   createAppHandler,
   prepareElicitation
-} from "./chunk-RN4YB4JT.js";
-import "./chunk-5C6RAGAS.js";
-import "./chunk-QI66R4FP.js";
-import "./chunk-VCYWAA4N.js";
+} from "./chunk-3UWLQMMK.js";
+import "./chunk-2B7FHH7S.js";
+import "./chunk-OTDKCYMH.js";
+import "./chunk-HLMJBE4T.js";
 import "./chunk-PBGPES67.js";
-import "./chunk-ILYCJ3HV.js";
-import "./chunk-2CURR5Y7.js";
-import "./chunk-7STIP5CS.js";
+import "./chunk-QN5BMAG7.js";
+import "./chunk-PILIRGJA.js";
+import "./chunk-R3O32PQV.js";
 import {
   ToolAnnotations
-} from "./chunk-4UPC36ZL.js";
+} from "./chunk-2RGJMA7N.js";
 import "./chunk-4PIQKACY.js";
 import {
   compileJsonSchemaDecoder,

package/js/graphql.js

@@ -1,34 +1,34 @@
 import {
   catalogCache,
   catalogScope
-} from "./chunk-YWVISRZD.js";
+} from "./chunk-EDXNAZLI.js";
 import {
   protocolOperations
-} from "./chunk-2LSGC7XY.js";
+} from "./chunk-KY7C6BWO.js";
 import "./chunk-BCSNKUAC.js";
-import "./chunk-RN4YB4JT.js";
+import "./chunk-3UWLQMMK.js";
 import {
   cacheKey
-} from "./chunk-5C6RAGAS.js";
-import "./chunk-QI66R4FP.js";
+} from "./chunk-2B7FHH7S.js";
+import "./chunk-OTDKCYMH.js";
 import {
   failOnNetworkRefusal
-} from "./chunk-VCYWAA4N.js";
+} from "./chunk-HLMJBE4T.js";
 import "./chunk-PBGPES67.js";
-import "./chunk-ILYCJ3HV.js";
+import "./chunk-QN5BMAG7.js";
 import {
   nativeOperation,
   routerDeclaration
-} from "./chunk-2CURR5Y7.js";
+} from "./chunk-PILIRGJA.js";
 import {
   accountProviderError,
   graphqlProviderError,
   httpProviderError
-} from "./chunk-7STIP5CS.js";
+} from "./chunk-R3O32PQV.js";
 import {
   NetworkRefused,
   ProviderError
-} from "./chunk-4UPC36ZL.js";
+} from "./chunk-2RGJMA7N.js";
 import "./chunk-4PIQKACY.js";
 import {
   jsonSchemaDecoder
@@ -465,7 +465,9 @@ var graphqlCatalog = (options, kinds) => Effect_exports.gen(function* () {
   const summarize = (tool) => ({
     name: tool.name,
     description: tool.description,
-    readOnly: kindOf(tool) === "query"
+    readOnly: kindOf(tool) === "query",
+    // The app's `kinds`, or the GraphQL operation type Executor sends.
+    kindConfirmed: true
   });
   const describe = (tool) => ({
     ...summarize(tool),

package/js/host.js

@@ -1,13 +1,13 @@
 import {
   createAppHandler
-} from "./chunk-RN4YB4JT.js";
-import "./chunk-5C6RAGAS.js";
-import "./chunk-QI66R4FP.js";
-import "./chunk-VCYWAA4N.js";
+} from "./chunk-3UWLQMMK.js";
+import "./chunk-2B7FHH7S.js";
+import "./chunk-OTDKCYMH.js";
+import "./chunk-HLMJBE4T.js";
 import "./chunk-PBGPES67.js";
-import "./chunk-ILYCJ3HV.js";
-import "./chunk-2CURR5Y7.js";
-import "./chunk-7STIP5CS.js";
+import "./chunk-QN5BMAG7.js";
+import "./chunk-PILIRGJA.js";
+import "./chunk-R3O32PQV.js";
 import {
   CacheCommand,
   CacheError,
@@ -25,7 +25,7 @@ import {
   WorkflowRun,
   WorkflowRunId,
   WorkflowRunPage
-} from "./chunk-4UPC36ZL.js";
+} from "./chunk-2RGJMA7N.js";
 import "./chunk-4PIQKACY.js";
 import "./chunk-VAI3EVCS.js";
 import {

package/js/index.js

@@ -11,7 +11,7 @@ import {
   query,
   t,
   workflow
-} from "./chunk-ILYCJ3HV.js";
+} from "./chunk-QN5BMAG7.js";
 import {
   dynamicRouter,
   mutation,
@@ -25,11 +25,11 @@ import {
   toolAnnotations,
   withApproval,
   withApprovals
-} from "./chunk-2CURR5Y7.js";
+} from "./chunk-PILIRGJA.js";
 import {
   accountProviderError,
   fromPromise
-} from "./chunk-7STIP5CS.js";
+} from "./chunk-R3O32PQV.js";
 import {
   CacheError,
   CalendarSchedule,
@@ -48,7 +48,7 @@ import {
   ScheduleTiming,
   SecretsMethod,
   WorkflowFailure
-} from "./chunk-4UPC36ZL.js";
+} from "./chunk-2RGJMA7N.js";
 import "./chunk-4PIQKACY.js";
 import {
   array,
@@ -252,6 +252,7 @@ var mergeSummary = (name, variants) => {
     description: first.description,
     ...first.title === void 0 ? {} : { title: first.title },
     readOnly: variants.every(([, tool]) => tool.readOnly === true),
+    ...variants.every(([, tool]) => tool.kindConfirmed === true) ? { kindConfirmed: true } : {},
     ...sameAcross("annotations", variants)
   });
 };

package/js/mcp/effect.js

@@ -2,17 +2,17 @@ import {
   mcpClientEffect,
   mcpHealthEffect,
   mcpToolsEffect
-} from "../chunk-6GAHIQ6X.js";
+} from "../chunk-X45GWW4A.js";
 import "../chunk-BCSNKUAC.js";
-import "../chunk-RN4YB4JT.js";
-import "../chunk-5C6RAGAS.js";
-import "../chunk-QI66R4FP.js";
-import "../chunk-VCYWAA4N.js";
+import "../chunk-3UWLQMMK.js";
+import "../chunk-2B7FHH7S.js";
+import "../chunk-OTDKCYMH.js";
+import "../chunk-HLMJBE4T.js";
 import "../chunk-PBGPES67.js";
-import "../chunk-ILYCJ3HV.js";
-import "../chunk-2CURR5Y7.js";
-import "../chunk-7STIP5CS.js";
-import "../chunk-4UPC36ZL.js";
+import "../chunk-QN5BMAG7.js";
+import "../chunk-PILIRGJA.js";
+import "../chunk-R3O32PQV.js";
+import "../chunk-2RGJMA7N.js";
 import "../chunk-4PIQKACY.js";
 import "../chunk-VAI3EVCS.js";
 import "../chunk-URKOTNDA.js";

package/js/mcp.js

@@ -1,41 +1,41 @@
 import {
   catalogCache,
   catalogScope
-} from "./chunk-YWVISRZD.js";
+} from "./chunk-EDXNAZLI.js";
 import {
   protocolOperations
-} from "./chunk-2LSGC7XY.js";
+} from "./chunk-KY7C6BWO.js";
 import {
   adaptMcpTool,
   mcpClientEffect,
   mcpHealthEffect
-} from "./chunk-6GAHIQ6X.js";
+} from "./chunk-X45GWW4A.js";
 import "./chunk-BCSNKUAC.js";
-import "./chunk-RN4YB4JT.js";
+import "./chunk-3UWLQMMK.js";
 import {
   cacheKey
-} from "./chunk-5C6RAGAS.js";
+} from "./chunk-2B7FHH7S.js";
 import {
   operationDescription
-} from "./chunk-QI66R4FP.js";
-import "./chunk-VCYWAA4N.js";
+} from "./chunk-OTDKCYMH.js";
+import "./chunk-HLMJBE4T.js";
 import "./chunk-PBGPES67.js";
-import "./chunk-ILYCJ3HV.js";
+import "./chunk-QN5BMAG7.js";
 import {
   nativeOperation,
   routerDeclaration
-} from "./chunk-2CURR5Y7.js";
+} from "./chunk-PILIRGJA.js";
 import {
   fromPromise,
   method
-} from "./chunk-7STIP5CS.js";
+} from "./chunk-R3O32PQV.js";
 import {
   McpCredentialsUnverified,
   McpError,
   McpServerHeader,
   McpToolMetadata,
   McpToolsOptions
-} from "./chunk-4UPC36ZL.js";
+} from "./chunk-2RGJMA7N.js";
 import "./chunk-4PIQKACY.js";
 import "./chunk-VAI3EVCS.js";
 import "./chunk-URKOTNDA.js";
@@ -102,10 +102,12 @@ var mcpCatalog = (options, kinds) => Effect_exports.gen(function* () {
     ...tool.annotations,
     readOnlyHint: kindOf(tool) === "query"
   });
+  const confirmed = (tool) => Object.hasOwn(kinds, tool.name) ? { kindConfirmed: true } : {};
   const summarize = (tool) => ({
     name: tool.name,
     description: tool.description ?? tool.title ?? tool.name,
     readOnly: kindOf(tool) === "query",
+    ...confirmed(tool),
     ...tool.title === void 0 ? {} : { title: tool.title },
     annotations: annotationsOf(tool)
   });
@@ -121,7 +123,12 @@ var mcpCatalog = (options, kinds) => Effect_exports.gen(function* () {
   );
   const describe = (tool) => operation(tool).pipe(
     Effect_exports.flatMap(
-      (selected) => selected === void 0 ? Effect_exports.succeed(void 0) : operationDescription(tool.name, "", selected)
+      (selected) => selected === void 0 ? Effect_exports.succeed(void 0) : operationDescription(tool.name, "", selected).pipe(
+        Effect_exports.map(({ kindConfirmed: _declared, ...described }) => ({
+          ...described,
+          ...confirmed(tool)
+        }))
+      )
     )
   );
   const router = {

package/js/openapi.js

@@ -8,7 +8,7 @@ import {
 import {
   protocolOperations,
   protocolRouter
-} from "./chunk-2LSGC7XY.js";
+} from "./chunk-KY7C6BWO.js";
 import {
   OpenapiCompileError,
   OpenapiCompileErrorCode,
@@ -29,15 +29,15 @@ import {
   isOpenapiTextMedia,
   openapiBinaryResultSchema,
   openapiMediaKind
-} from "./chunk-QI66R4FP.js";
+} from "./chunk-OTDKCYMH.js";
 import {
   failOnNetworkRefusal
-} from "./chunk-VCYWAA4N.js";
+} from "./chunk-HLMJBE4T.js";
 import "./chunk-PBGPES67.js";
 import {
   nativeOperation,
   routerDeclaration
-} from "./chunk-2CURR5Y7.js";
+} from "./chunk-PILIRGJA.js";
 import {
   accountProviderError,
   bodyUpstreamError,
@@ -46,7 +46,7 @@ import {
   method,
   providerErrorDetail,
   toPromise
-} from "./chunk-7STIP5CS.js";
+} from "./chunk-R3O32PQV.js";
 import {
   ApiErrorRecovery,
   ApiErrorResponse,
@@ -57,7 +57,7 @@ import {
   RouterMeta,
   cacheLimits,
   defaultOpenapiErrorLimits
-} from "./chunk-4UPC36ZL.js";
+} from "./chunk-2RGJMA7N.js";
 import "./chunk-4PIQKACY.js";
 import {
   jsonSchema,
@@ -2078,6 +2078,10 @@ var binaryInput = {
   description: "File bytes encoded as base64.",
   contentEncoding: "base64"
 };
+var parameterDocumentation = (parameter) => ({
+  ...typeof parameter.description === "string" && parameter.description.trim() !== "" ? { description: parameter.description } : {},
+  ...parameter.deprecated === true ? { deprecated: true } : {}
+});
 var declaredAt = (document, value, inline) => document.origin(value) ?? inline;
 var mediaSchemaAt = (document, at, type, media) => `${declaredAt(document, media, `${at}/content/${pointerToken(type)}`)}/schema`;
 var responsesOf = (operation) => operation.responses === void 0 ? {} : record2(operation.responses);
@@ -2455,7 +2459,11 @@ var compileOpenApiDocument = (entry, inputDocument, options = {}) => {
                   `The querystring parameter at ${parameterAt} must declare one form, JSON or text media type in content.`
                 );
             }
-            parameters.set(`${p.in}:${p.name}`, { parameter: p, at: parameterAt });
+            parameters.set(`${p.in}:${p.name}`, {
+              parameter: p,
+              documentation: parameterDocumentation(declaration),
+              at: parameterAt
+            });
           }
           for (const name2 of prefix) {
             const key = `path:${name2}`;
@@ -2467,17 +2475,18 @@ var compileOpenApiDocument = (entry, inputDocument, options = {}) => {
             if (!parameters.has(key))
               parameters.set(key, {
                 parameter: { name: name2, in: "path", required: true, schema: { type: "string" } },
+                documentation: {},
                 at: void 0
               });
           }
           const groups = /* @__PURE__ */ new Map();
-          for (const { parameter: p, at: parameterAt } of parameters.values()) {
+          for (const { parameter: p, documentation, at: parameterAt } of parameters.values()) {
             const key = p.in === "header" ? "headers" : p.in;
             const group = groups.get(key) ?? { properties: {}, required: [] };
             const [mediaType2, content] = p.content === void 0 ? [] : Object.entries(p.content)[0] ?? [];
             const schema2 = p.schema ?? (content === void 0 ? {} : record2(content).schema ?? {});
             const schemaAt = p.schema !== void 0 || mediaType2 === void 0 ? `${parameterAt}/schema` : mediaSchemaAt(document, `${parameterAt}`, mediaType2, content);
-            group.properties[p.name] = parameterAt === void 0 ? () => schema2 : (api) => api(schema2, schemaAt);
+            group.properties[p.name] = parameterAt === void 0 ? () => schema2 : (api) => ({ ...api(schema2, schemaAt), ...documentation });
             if (p.required || p.in === "path") group.required.push(p.name);
             groups.set(key, group);
           }
@@ -5887,6 +5896,8 @@ var liveOpenapiRouter = (options) => {
     name: operation.name,
     description: operation.description,
     readOnly: readOnly(operation),
+    // The app's `kinds`, or the HTTP method Executor sends.
+    kindConfirmed: true,
     ...operation.tags === void 0 ? {} : { tags: operation.tags }
   });
   const describe = (operation, bundle) => ({

package/js/skills.js

@@ -1,11 +1,11 @@
 import {
   catalogCache,
   catalogScope
-} from "./chunk-YWVISRZD.js";
-import "./chunk-5C6RAGAS.js";
+} from "./chunk-EDXNAZLI.js";
+import "./chunk-2B7FHH7S.js";
 import {
   failOnNetworkRefusal
-} from "./chunk-VCYWAA4N.js";
+} from "./chunk-HLMJBE4T.js";
 import {
   folderSkillsEffect,
   skillFromFiles
@@ -16,12 +16,12 @@ import {
   httpProviderError,
   method,
   toPromise
-} from "./chunk-7STIP5CS.js";
+} from "./chunk-R3O32PQV.js";
 import {
   NetworkRefused,
   ProviderError,
   networkRefusalStatus
-} from "./chunk-4UPC36ZL.js";
+} from "./chunk-2RGJMA7N.js";
 import {
   AppSkillMetadata,
   AppSkillSource,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "apps",
-  "version": "0.0.1-beta.102",
+  "version": "0.0.1-beta.105",
   "description": "TypeScript apps with typed tools, accounts, storage, and UI.",
   "type": "module",
   "sideEffects": false,