apps 0.0.1-beta.43 → 0.0.1-beta.46

package/js/{chunk-XSD3RZFX.js → chunk-3B2JAOSE.js}

@@ -1,12 +1,15 @@
 import {
   declaredOperations,
-  fromPromise,
   nativeOperation,
   nativeRouter
-} from "./chunk-ILYK7BQG.js";
+} from "./chunk-LHCGND3R.js";
+import {
+  fromPromise,
+  method
+} from "./chunk-LTDHQJ2Z.js";
 import {
   ScheduleTiming
-} from "./chunk-OBXHQNWC.js";
+} from "./chunk-CVAJ4F6O.js";
 import {
   decoderOf,
   isSchema,
@@ -45,11 +48,8 @@ var workflow = (options, run) => ({
     input: decoderOf(schemaArgument(options.input, "The workflow input")),
     ...options.output === void 0 ? {} : { output: decoderOf(schemaArgument(options.output, "The workflow output")) },
     ...options.description === void 0 ? {} : { description: options.description },
-    run: (context, input) => Effect_exports.tryPromise({
-      // SAFETY: defineApp checks required context; the host supplies the pinned run's capabilities.
-      try: () => run(context, input),
-      catch: (error) => error
-    })
+    // SAFETY: defineApp checks required context; the host supplies the pinned run's capabilities.
+    run: (context, input) => fromPromise(run, "workflow")(context, input)
   }
 });
 var nativeWorkflow = (value) => {
@@ -68,14 +68,25 @@ function rejectCatalogs(definition) {
 function adaptDefinition(definition) {
   rejectCatalogs(definition);
   const webhooks = definition.webhooks === void 0 ? {} : {
+    // SAFETY: `Required` only where the optional method was just checked to be present.
     webhooks: Object.fromEntries(
       Object.entries(definition.webhooks).map(([name, webhook]) => [
         name,
         {
           ...webhook,
-          ...webhook.register === void 0 ? {} : { register: fromPromise(webhook.register) },
-          handle: fromPromise(webhook.handle),
-          ...webhook.unregister === void 0 ? {} : { unregister: fromPromise(webhook.unregister) },
+          ...webhook.register === void 0 ? {} : {
+            register: fromPromise(
+              method(webhook, "register"),
+              "webhook"
+            )
+          },
+          handle: fromPromise(method(webhook, "handle"), "webhook"),
+          ...webhook.unregister === void 0 ? {} : {
+            unregister: fromPromise(
+              method(webhook, "unregister"),
+              "webhook"
+            )
+          },
           ..."config" in webhook && isSchema(webhook.config) ? { config: decoderOf(webhook.config) } : {},
           ..."state" in webhook && isSchema(webhook.state) ? { state: decoderOf(webhook.state) } : {}
         }
@@ -134,7 +145,7 @@ function adaptDefinition(definition) {
 var defineApp = (requirements, definition) => {
   if (typeof definition !== "function") rejectCatalogs(definition);
   const evaluate = typeof definition === "function" ? definition : async () => definition;
-  const factory = fromPromise(evaluate);
+  const factory = fromPromise(evaluate, "factory");
   const native = {
     accounts: requirements.accounts,
     evaluate: (context) => factory(context).pipe(Effect_exports.map((value) => adaptDefinition(value)))

package/js/{chunk-KTPKTBKZ.js → chunk-3UGDI2UI.js}

@@ -1,15 +1,15 @@
 import {
   skillFromFiles
-} from "./chunk-IN2WIN7I.js";
+} from "./chunk-XBG7HHXC.js";
 import {
   joinPath,
   mergeMeta
-} from "./chunk-ILYK7BQG.js";
+} from "./chunk-LHCGND3R.js";
 import {
   isShortenedUpstream,
   parseProviderError,
   providerError
-} from "./chunk-EMHFXFTJ.js";
+} from "./chunk-LTDHQJ2Z.js";
 import {
   ApiErrorResponse,
   HostDeclarationInvalid,
@@ -21,7 +21,7 @@ import {
   McpError,
   McpError2,
   SkillLoadFailed as SkillLoadFailed2
-} from "./chunk-OBXHQNWC.js";
+} from "./chunk-CVAJ4F6O.js";
 import {
   CacheError,
   FailureCode,
@@ -36,7 +36,7 @@ import {
 import {
   SkillLoadFailed,
   skillFormatLimits
-} from "./chunk-KBIKBWSS.js";
+} from "./chunk-H72MEDMN.js";
 import {
   jsonSchemaDocument
 } from "./chunk-KGCTYL2S.js";

package/js/chunk-5FHWNLCI.js

@@ -0,0 +1,88 @@
+import {
+  Predicate_exports
+} from "./chunk-IFJU5SYQ.js";
+
+// ../utils/src/recorded-message.ts
+var RecordedMessage = /* @__PURE__ */ Symbol.for("@executor-js/utils/RecordedMessage");
+var recordedMessage = (error) => {
+  if (Predicate_exports.hasProperty(error, RecordedMessage)) {
+    const message = error[RecordedMessage];
+    return typeof message === "string" ? message : void 0;
+  }
+  return protocolErrorMessage(error) ?? sqlErrorMessage(error);
+};
+var jsonRpcMeanings = {
+  [-32700]: "Parse error",
+  [-32600]: "Invalid request",
+  [-32601]: "Method not found",
+  [-32602]: "Invalid params",
+  [-32603]: "Internal error",
+  [-32002]: "Resource not found"
+};
+var protocolErrorMessage = (error) => {
+  if (!Predicate_exports.isTagged(error, "ProtocolError") || !Predicate_exports.hasProperty(error, "code") || typeof error.code !== "number" || !Predicate_exports.hasProperty(error, "message") || !Predicate_exports.isString(error.message))
+    return void 0;
+  const code = error.code;
+  const refusal = /^Tool '.*' not found$/s.test(error.message) ? ": the requested tool does not exist" : error.message.startsWith("Invalid parameters for tool '") ? ": the tool's arguments failed validation" : "";
+  const meaning = jsonRpcMeanings[code];
+  const kind = meaning === void 0 ? "JSON-RPC error with an unlisted code" : `${meaning} (${code})`;
+  return kind + refusal;
+};
+var sqlReasons = /* @__PURE__ */ new Set([
+  "ConnectionError",
+  "AuthenticationError",
+  "AuthorizationError",
+  "SqlSyntaxError",
+  "UniqueViolation",
+  "ConstraintError",
+  "DeadlockError",
+  "SerializationError",
+  "LockTimeoutError",
+  "StatementTimeoutError",
+  "UnknownError"
+]);
+var sqlMessages = new Set(
+  [
+    "A pipelined query completed out of order",
+    "Connection closed",
+    "Connection closed during startup",
+    "Connection is closed",
+    "Connection timed out",
+    "Failed to connect",
+    "Failed to decode row",
+    "Failed to encode query",
+    "Failed to negotiate TLS",
+    "Failed to parse SSLRequest error response",
+    "Failed to parse server messages",
+    "Failed to parse server response",
+    "Failed to write query",
+    "Failed to write query batch",
+    "Invalid SSLRequest response",
+    "MD5 authentication failed",
+    "No password configured",
+    "Protocol desync",
+    "Query cancellation timed out",
+    "Query failed",
+    "SCRAM authentication failed",
+    "SCRAM exchange did not complete",
+    "SCRAM server verification failed",
+    "Server refused TLS",
+    "Socket error",
+    "Stream cancellation timed out",
+    "The server reported an error",
+    "Unsupported authentication method"
+  ].map((message) => `PgConnection: ${message}`)
+);
+var sqlErrorMessage = (error) => {
+  if (!Predicate_exports.isTagged(error, "SqlError") || !Predicate_exports.hasProperty(error, "reason"))
+    return void 0;
+  const reason = error.reason;
+  const kind = Predicate_exports.hasProperty(reason, "_tag") && Predicate_exports.isString(reason._tag) && sqlReasons.has(reason._tag) ? reason._tag : "an unlisted kind";
+  const message = Predicate_exports.hasProperty(reason, "message") && Predicate_exports.isString(reason.message) && sqlMessages.has(reason.message) ? `: ${reason.message}` : "";
+  return `The database failed (${kind})${message}`;
+};
+
+export {
+  RecordedMessage,
+  recordedMessage
+};

package/js/{chunk-MSDGZ7FA.js → chunk-6QXPBJ5T.js}

@@ -3,16 +3,16 @@ import {
   answeredError,
   mcpClient,
   mcpJsonSchemaValidator
-} from "./chunk-RIKH5H2X.js";
+} from "./chunk-XK5I2XOI.js";
 import {
   failOnNetworkRefusal
-} from "./chunk-T65AFHU3.js";
+} from "./chunk-7UUHJR2Q.js";
 import {
   accountProviderError,
   bodyUpstreamError,
   httpProviderError,
   providerErrorDetail
-} from "./chunk-EMHFXFTJ.js";
+} from "./chunk-LTDHQJ2Z.js";
 import {
   McpCredentialsUnverified,
   McpError,
@@ -20,21 +20,22 @@ import {
   McpToolsOptions,
   defaultMcpClientLimits,
   mcpHealthReserveMs
-} from "./chunk-OBXHQNWC.js";
+} from "./chunk-CVAJ4F6O.js";
 import {
   NetworkRefused,
   ProviderError
 } from "./chunk-MWKHKOTL.js";
 import {
-  captureTelemetry
-} from "./chunk-VU6GQ2SH.js";
+  captureTelemetry,
+  owned
+} from "./chunk-JM7LOD2W.js";
 import {
   FetchHttpClient_exports
-} from "./chunk-MZH4J2PO.js";
+} from "./chunk-PD6I2SDG.js";
 import {
   HttpClientRequest_exports,
   HttpClient_exports
-} from "./chunk-LNSVJS2Q.js";
+} from "./chunk-EOPQ727L.js";
 import {
   Clock_exports,
   Deferred_exports,
@@ -236,7 +237,7 @@ function withClient(connection, mode, use, changed) {
             Effect_exports.timeout(defaultMcpClientLimits.cleanupTimeoutMs),
             Effect_exports.ignore
           );
-        }).pipe(Effect_exports.withSpan("provider.mcp.close"))
+        }).pipe(owned("upstream", "provider.mcp.close"))
       );
       const wire = transport;
       yield* Effect_exports.tryPromise({
@@ -246,7 +247,7 @@ function withClient(connection, mode, use, changed) {
         Effect_exports.raceFirst(Deferred_exports.await(rejected)),
         Effect_exports.catch(explained("connect", answered)),
         Effect_exports.timeout(connection.timeoutMs),
-        Effect_exports.withSpan("provider.mcp.connect")
+        owned("upstream", "provider.mcp.connect")
       );
       return yield* use(client).pipe(
         Effect_exports.raceFirst(Deferred_exports.await(rejected)),
@@ -254,7 +255,7 @@ function withClient(connection, mode, use, changed) {
       );
     })
   ).pipe(
-    Effect_exports.withSpan("provider.mcp.session", {
+    owned("upstream", "provider.mcp.session", {
       attributes: {
         "mcp.transport": kind,
         "mcp.operation": mode,
@@ -327,9 +328,9 @@ var mcpHealthEffect = (check, options) => Effect_exports.gen(function* () {
       // Executor's network refused the attempt, so the server never answered it.
       onFailure: (error) => Schema_exports.is(NetworkRefused)(error) ? Effect_exports.fail(error) : refusesCredentials(error) ? Effect_exports.void : Effect_exports.fail(new McpCredentialsUnverified({ anonymous: error }))
     }),
-    Effect_exports.withSpan("provider.mcp.anonymous")
+    owned("upstream", "provider.mcp.anonymous")
   );
-}).pipe(Effect_exports.withSpan("provider.mcp.health"));
+}).pipe(owned("upstream", "provider.mcp.health"));
 var mcpToolsEffect = (input) => mcpClientEffect(input).pipe(Effect_exports.flatMap(adaptMcpTools));
 
 export {

package/js/{chunk-Z3S2IVI3.js → chunk-7LGRK7TP.js}

@@ -1,11 +1,11 @@
 import {
   fixedRouter
-} from "./chunk-KTPKTBKZ.js";
+} from "./chunk-3UGDI2UI.js";
 import {
   nativeOperation,
   operationDeclaration,
   routerDeclaration
-} from "./chunk-ILYK7BQG.js";
+} from "./chunk-LHCGND3R.js";
 
 // src/implementation/protocol-operations.ts
 var protocolOperations = (operations, kinds = {}) => {

package/js/{chunk-T65AFHU3.js → chunk-7UUHJR2Q.js}

@@ -8,7 +8,7 @@ import {
 } from "./chunk-MWKHKOTL.js";
 import {
   invocationFetch
-} from "./chunk-VU6GQ2SH.js";
+} from "./chunk-JM7LOD2W.js";
 import {
   Effect_exports,
   Schema_exports

package/js/{chunk-4ZTVLEN6.js → chunk-CDXQDN7W.js}

@@ -6,7 +6,7 @@ import {
   HttpApiGroup_exports,
   HttpApiSchema_exports,
   HttpApi_exports
-} from "./chunk-KSGYJV46.js";
+} from "./chunk-TUMGL2OC.js";
 import {
   Schema_exports
 } from "./chunk-IFJU5SYQ.js";

package/js/{chunk-OBXHQNWC.js → chunk-CVAJ4F6O.js}

@@ -12,10 +12,10 @@ import {
 import {
   AppSkillName,
   AppSkills
-} from "./chunk-KBIKBWSS.js";
+} from "./chunk-H72MEDMN.js";
 import {
   RecordedMessage
-} from "./chunk-EG72MSVK.js";
+} from "./chunk-5FHWNLCI.js";
 import {
   AccountId,
   HttpUrl,
@@ -3253,6 +3253,17 @@ var ToolResultObservation = Context_exports.Reference(
   { defaultValue: () => ({ failed: () => {
   } }) }
 );
+var InvocationTiming = Schema_exports.Struct({
+  elapsedMs: Schema_exports.Finite,
+  upstreamMs: Schema_exports.Finite,
+  elicitationMs: Schema_exports.Finite,
+  authoredMs: Schema_exports.Finite
+});
+var InvocationTimingSink = Context_exports.Reference(
+  "apps/InvocationTimingSink",
+  { defaultValue: () => () => {
+  } }
+);
 
 export {
   SecretsMethod,
@@ -3395,5 +3406,7 @@ export {
   HostCallError,
   HostAccountCheckError,
   HostDataError,
-  ToolResultObservation
+  ToolResultObservation,
+  InvocationTiming,
+  InvocationTimingSink
 };

package/js/{chunk-KBIKBWSS.js → chunk-H72MEDMN.js}

@@ -1,6 +1,6 @@
 import {
   RecordedMessage
-} from "./chunk-EG72MSVK.js";
+} from "./chunk-5FHWNLCI.js";
 import {
   SchemaGetter_exports,
   Schema_exports
@@ -23,7 +23,7 @@ function withFields(definition) {
     ),
     { httpApiStatus: definition.status, ...documentation }
   );
-  const recorded = definition.recorded;
+  const recorded = definition.recorded ?? (typeof message === "string" ? () => message : void 0);
   Object.defineProperties(DefinedError.prototype, {
     message: {
       get() {
@@ -110,7 +110,8 @@ var SkillDefinitionInvalid = ApiError.define({
       "name-mismatch"
     ])
   },
-  message: ({ file, reason }) => skillDefinitionFailures[reason](file)
+  message: ({ file, reason }) => skillDefinitionFailures[reason](file),
+  recorded: ({ reason }) => `The app's skill definition is invalid (${reason})`
 });
 var AppSkills = Schema_exports.Array(AppSkillSource).check(
   Schema_exports.makeFilter((skills) => new Set(skills.map((skill) => skill.name)).size === skills.length)