@pptb/types 1.2.7 → 1.2.8-beta.0

package/README.md

@@ -157,7 +157,7 @@ In addition to `package.json`, the validator automatically checks a `pptb.config
 | `agents.defaultMode`                | ❌       | Default mode when the agent does not request one explicitly                                                                                                                                                                        |
 | `agents.timeoutMS`                  | ❌       | Optional timeout hint in milliseconds for two-way calls                                                                                                                                                                            |
 | `agents.executionModes`             | ❌       | Array of supported execution modes (`"windowed"`, `"headless"`)                                                                                                                                                                    |
-| `agents.defaultExecutionMode`       | ❌       | Default execution mode when the agent does not request one explicitly                                                                                                                                                              |
+| `agents.defaultExecutionMode`       | ❌       | Currently ignored: headless is used whenever supported and windowed is the backup. May be removed in a future release                                                                                                              |
 | `agents.headlessEntry`              | ❌       | Path to the compiled automated runtime entry point                                                                                                                                                                                 |
 
 > \*\* Required only when the `invocation` object is present.

package/dataverseAPI.d.ts

@@ -23,6 +23,8 @@ declare namespace DataverseAPI {
         status: number;
         statusText?: string;
         headers: Record<string, string>;
+        /** Selected headers from the outer HTTP batch response, shared by every operation result. */
+        batchHeaders?: Record<string, string>;
         body?: unknown;
     }
     /**
@@ -49,10 +51,7 @@ declare namespace DataverseAPI {
     export type EntityRelatedMetadataBasePath = "Attributes" | "Keys" | "ManyToOneRelationships" | "OneToManyRelationships" | "ManyToManyRelationships" | "Privileges";
 
     export type EntityRelatedMetadataPath =
-        | EntityRelatedMetadataBasePath
-        | `${EntityRelatedMetadataBasePath}/${string}`
-        | `${EntityRelatedMetadataBasePath}(${string})`
-        | `${EntityRelatedMetadataBasePath}(${string})/${string}`;
+        EntityRelatedMetadataBasePath | `${EntityRelatedMetadataBasePath}/${string}` | `${EntityRelatedMetadataBasePath}(${string})` | `${EntityRelatedMetadataBasePath}(${string})/${string}`;
 
     type EntityRelatedMetadataRecordPath = `${EntityRelatedMetadataBasePath}/${string}` | `${EntityRelatedMetadataBasePath}(${string})` | `${EntityRelatedMetadataBasePath}(${string})/${string}`;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pptb/types",
-  "version": "1.2.7",
+  "version": "1.2.8-beta.0",
   "description": "Type definitions for Power Platform ToolBox APIs and validity checks for tool packages",
   "main": "index.d.ts",
   "types": "index.d.ts",

package/pptbConfig.d.ts

@@ -86,6 +86,12 @@ export interface JsonSchemaProperty {
     enum?: string[];
     /** Describes the items of an array property. */
     items?: JsonSchemaProperty;
+    /** Short human-readable label. Shown to the user when an agent must ask for this value. */
+    title?: string;
+    /** Explains the value. Shown to the user when an agent must ask for this value. */
+    description?: string;
+    /** Marks the property as required. Missing required values are requested from the user via the MCP agent. */
+    required?: boolean;
 }
 
 /** A JSON-schema-style object definition: a map of named property descriptors. */
@@ -117,8 +123,8 @@ export type AgentExecutionMode = "windowed" | "headless";
  * - `modes`: supported MCP invocation modes for this tool.
  * - `defaultMode`: fallback mode when the caller does not specify one.
  * - `timeoutMS`: optional timeout hint, in milliseconds, for two-way calls.
- * - `executionModes`: supported execution modes for this tool.
- * - `defaultExecutionMode`: fallback execution mode when the caller does not specify one.
+ * - `executionModes`: supported execution modes for this tool. When both are listed, `headless` is used by default and `windowed` is a backup.
+ * - `defaultExecutionMode`: currently ignored by the MCP server (headless is preferred whenever supported); may be removed in a future release.
  * - `headlessEntry`: path to the compiled automated runtime entry point.
  */
 export interface AgentsConfig {
@@ -136,7 +142,7 @@ export interface AgentsConfig {
     timeoutMS?: number;
     /** Execution modes supported by the tool. */
     executionModes?: AgentExecutionMode[];
-    /** Default execution mode when an agent does not request one explicitly. */
+    /** Currently ignored: headless is preferred whenever supported. May be removed in a future release. */
     defaultExecutionMode?: AgentExecutionMode;
     /** Path to the compiled automated runtime entry point. */
     headlessEntry?: string;