apps 0.0.1-beta.1 → 0.0.1-beta.11

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

@@ -63,6 +63,22 @@ export declare const McpToolMetadata: Schema.Struct<{
     readonly _meta: Schema.optional<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
 }>;
 export type McpToolMetadata = typeof McpToolMetadata.Type;
+/** What a server reports about itself when a session initializes. Icons are for display only. */
+export declare const McpServerHeader: Schema.Struct<{
+    readonly name: Schema.optionalKey<Schema.String>;
+    readonly title: Schema.optionalKey<Schema.String>;
+    readonly version: Schema.optionalKey<Schema.String>;
+    readonly description: Schema.optionalKey<Schema.String>;
+    readonly websiteUrl: Schema.optionalKey<Schema.String>;
+    readonly icons: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+        readonly src: Schema.NonEmptyString;
+        readonly mimeType: Schema.optionalKey<Schema.String>;
+        readonly sizes: Schema.optionalKey<Schema.$Array<Schema.String>>;
+        readonly theme: Schema.optionalKey<Schema.Literals<readonly ["light", "dark"]>>;
+    }>>>;
+    readonly instructions: Schema.optionalKey<Schema.String>;
+}>;
+export type McpServerHeader = typeof McpServerHeader.Type;
 /** Direct callers can omit interaction capabilities. A server that asks for input then fails explicitly. */
 export interface McpToolContext {
     readonly elicit?: Elicit;

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

@@ -40,7 +40,10 @@ export declare const OpenapiRequestBody: Schema.Struct<{
 }>;
 /** Credential-free operation data emitted by the OpenAPI importer. */
 export declare const OpenapiOperation: Schema.Struct<{
+    /** The tool name after `queries.` or `mutations.`, grouped as `<group>.<leaf>`. */
     readonly name: Schema.NonEmptyString;
+    /** The document's operationId, when it declares one. `kinds` overrides are keyed by it. */
+    readonly operationId: Schema.optionalKey<Schema.String>;
     readonly description: Schema.String;
     readonly method: Schema.Literals<readonly ["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]>;
     readonly path: Schema.String;
@@ -72,6 +75,8 @@ export declare const OpenapiOperation: Schema.Struct<{
     }>;
     /** Streams remain in the metadata but cannot run through a single-result tool call. */
     readonly streaming: Schema.optionalKey<Schema.Literal<true>>;
+    /** The operation's OpenAPI tags, shown to agents as labels within its router. */
+    readonly tags: Schema.optionalKey<Schema.$Array<Schema.NonEmptyString>>;
     readonly input: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
     readonly outputSchema: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
     readonly errorResponses: Schema.optionalKey<Schema.$Array<Schema.Struct<{
@@ -115,7 +120,10 @@ export type OpenapiParameterDefaults = typeof OpenapiParameterDefaults.Type;
 /** Parsed options for one account's evaluation. */
 export declare const OpenapiToolsOptions: Schema.Struct<{
     readonly operations: Schema.$Array<Schema.Struct<{
+        /** The tool name after `queries.` or `mutations.`, grouped as `<group>.<leaf>`. */
         readonly name: Schema.NonEmptyString;
+        /** The document's operationId, when it declares one. `kinds` overrides are keyed by it. */
+        readonly operationId: Schema.optionalKey<Schema.String>;
         readonly description: Schema.String;
         readonly method: Schema.Literals<readonly ["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]>;
         readonly path: Schema.String;
@@ -147,6 +155,8 @@ export declare const OpenapiToolsOptions: Schema.Struct<{
         }>;
         /** Streams remain in the metadata but cannot run through a single-result tool call. */
         readonly streaming: Schema.optionalKey<Schema.Literal<true>>;
+        /** The operation's OpenAPI tags, shown to agents as labels within its router. */
+        readonly tags: Schema.optionalKey<Schema.$Array<Schema.NonEmptyString>>;
         readonly input: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
         readonly outputSchema: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
         readonly errorResponses: Schema.optionalKey<Schema.$Array<Schema.Struct<{
@@ -221,5 +231,5 @@ export declare const isOpenapiFileSchema: (shape: Readonly<Record<string, unknow
 /** JSON-safe binary result, independent of the host's file storage. */
 export declare const openapiBinaryResultSchema: JsonObject;
 /** Classify request media for JSON-safe tool arguments; Swagger owns wire serialization. */
-export declare const openapiMediaKind: (type: string) => "form" | "text" | "binary" | "json" | "multipart";
+export declare const openapiMediaKind: (type: string) => "form" | "binary" | "json" | "multipart" | "text";
 export {};

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

@@ -23,8 +23,3 @@ export interface AppOperation<Input = unknown, Output = unknown> {
     readonly approval?: Approval<Input>;
     readonly run: (context: OperationContext, input: Input) => Effect.Effect<Output, unknown>;
 }
-/** Agent tool names carry the operation kind; catalogs may reuse the same local name. */
-export declare const OperationToolPrefixes: {
-    readonly query: "queries.";
-    readonly mutate: "mutations.";
-};

package/types/apps/src/contracts/protocol-version.d.ts

@@ -0,0 +1,6 @@
+/**
+ * The host protocol this framework speaks. It is written into `runtime.json` and every host
+ * snapshot. Released protocols are frozen: see `protocols/4.ts` and notes/apps-publishing.md.
+ * This file has no imports so the package build script can read it directly.
+ */
+export declare const frameworkProtocol = 5;