apps 0.0.1-beta.105 → 0.0.1-beta.108

package/types/apps/src/contracts/graphql.d.ts

@@ -23,12 +23,49 @@ export declare const GraphqlToolsOptions: Schema.Struct<{
     readonly timeoutMs: Schema.optional<Schema.Int>;
 }>;
 export type GraphqlToolsOptions = typeof GraphqlToolsOptions.Type;
+/** Most errors of one GraphQL response that a failure carries. */
+export declare const maxGraphqlStatedErrors = 5;
+/** Most `extensions` entries carried for one stated error. */
+export declare const maxGraphqlStatedExtensions = 4;
+/** Longest path, path segment or `extensions` value carried for one stated error. */
+export declare const maxGraphqlStatedFieldLength = 256;
+/**
+ * One error a GraphQL server stated in its response's `errors` list, in the format the GraphQL
+ * specification documents: its message, the response path it names, and the scalar entries of its
+ * `extensions`, such as `code`. Text is bounded where it is read. The path keeps the server's
+ * segments, so account secrets are replaced in them before they are written as a path when the
+ * failure leaves the app.
+ */
+export declare const GraphqlStatedError: Schema.Struct<{
+    readonly message: Schema.String;
+    /** The first segments of the path, as many as a path of the longest carried length shows. */
+    readonly path: Schema.optional<Schema.$Array<Schema.Union<readonly [Schema.String, Schema.Int]>>>;
+    readonly extensions: Schema.optional<Schema.$Record<Schema.String, Schema.Union<readonly [Schema.String, Schema.Finite, Schema.Boolean]>>>;
+}>;
+export type GraphqlStatedError = typeof GraphqlStatedError.Type;
 declare const GraphqlError_base: Schema.Class<GraphqlError, Schema.TaggedStruct<"GraphqlError", {
     readonly phase: Schema.Literals<readonly ["discover", "call"]>;
     readonly reason: Schema.Literals<readonly ["request", "unauthorized", "invalid_response", "invalid_input", "timeout", "execution"]>;
     readonly status: Schema.optional<Schema.Number>;
+    /** The first errors the server stated, in its order. */
+    readonly errors: Schema.optional<Schema.$Array<Schema.Struct<{
+        readonly message: Schema.String;
+        /** The first segments of the path, as many as a path of the longest carried length shows. */
+        readonly path: Schema.optional<Schema.$Array<Schema.Union<readonly [Schema.String, Schema.Int]>>>;
+        readonly extensions: Schema.optional<Schema.$Record<Schema.String, Schema.Union<readonly [Schema.String, Schema.Finite, Schema.Boolean]>>>;
+    }>>>;
+    /** How many errors the server stated in all, when it stated more than `errors` carries. */
+    readonly stated: Schema.optional<Schema.Int>;
+    /**
+     * Why Executor did not read the JSON body of a refused request: it was larger than error bodies
+     * may be, or it did not arrive in time. The status is still the server's answer.
+     */
+    readonly unreadBody: Schema.optional<Schema.Literals<readonly ["too_large", "incomplete"]>>;
 }>, import("effect/Cause").YieldableError>;
-/** Safe failures omit upstream bodies. Execution means a valid GraphQL error response, not malformed data. */
+/**
+ * Safe failures omit upstream bodies other than the errors a GraphQL server stated in its
+ * documented `errors` list. Execution means a valid GraphQL error response, not malformed data.
+ */
 export declare class GraphqlError extends GraphqlError_base {
 }
 /** The introspection subset used by tools; unknown upstream fields are omitted. */

package/types/apps/src/implementation/failure-detail.d.ts

@@ -41,7 +41,7 @@ export declare const parseSkillLoadFailed: (error: unknown) => Option.Option<Hos
 export declare const describeFailure: (error: unknown) => string;
 /**
  * Describe what an operation raised for the app's own caller. App data failures keep their
- * reason as a code, as do app cache failures and OpenAPI and MCP service failures, such as an
+ * reason as a code, as do app cache failures and OpenAPI, GraphQL and MCP service failures, such as an
  * `mcpHealth` check that cannot reach its server or cannot verify the credentials; any other thrown
  * value is the app's own error, with its own code and scalar fields. Account secrets are replaced.
  */

package/types/apps/src/implementation/upstream-error.d.ts

@@ -1,5 +1,13 @@
 import { UpstreamError } from "../contracts/failure.js";
-/** Whether `bounded` shortened this message, so it may end partway through a secret. */
+/**
+ * A stated message is bounded where it is read, before the invocation's account secrets are known,
+ * so a cut can split a secret. Leaving the bundle replaces the part of one a shortened message
+ * ends with; see `isShortenedStated`.
+ */
+export declare const boundStated: (text: string, maximum: number) => string;
+/** Whether `boundStated` shortened this text, so it may end partway through a secret. */
+export declare const isShortenedStated: (text: string, maximum: number) => boolean;
+/** Whether a stated message was shortened where it was read. */
 export declare const isShortenedUpstream: (message: string) => boolean;
 /** The error a JSON error body states, if it uses a nested error object or OAuth's format. */
 export declare const bodyUpstreamError: (json: unknown) => UpstreamError | undefined;