@pellux/goodvibes-contracts 1.7.1 → 1.8.0

package/artifacts/python/homeassistant_operator_client.py

@@ -5,7 +5,7 @@ emitted from the operator contract by scripts/generate-homeassistant-client.ts.
 Covers only the REST subset HA consumes; the webhook, conversation stream,
 and surface health probe are not operator methods and stay hand-written.
 
-Contract product version: 1.7.1
+Contract product version: 1.8.0
 Consumed operator methods: 33
 """
 from __future__ import annotations
@@ -13,7 +13,7 @@ from __future__ import annotations
 from typing import Any, Literal, Mapping, NamedTuple, NotRequired, TypedDict
 
 #: Daemon contract version these types were generated against (the version pin).
-CONTRACT_VERSION: str = "1.7.1"
+CONTRACT_VERSION: str = "1.8.0"
 
 
 class OperatorRoute(NamedTuple):
@@ -133,11 +133,13 @@ class ChannelsToolsSurfaceListOutput(TypedDict, total=True):
     tools: list[Mapping[str, Any]]
 
 # control.status
-ControlStatusInput = Mapping[str, Any]
+class ControlStatusInput(TypedDict, total=True):
+    receipts: NotRequired[Literal["consume"]]
 
 class ControlStatusOutput(TypedDict, total=True):
     status: str
     version: str
+    receipts: NotRequired[list[Mapping[str, Any]]]
 
 # homeassistant.homeGraph.askHomeGraph
 class HomeassistantHomeGraphAskHomeGraphInput(TypedDict, total=True):

package/dist/generated/foundation-client-types.d.ts

@@ -48,6 +48,10 @@ export interface OperatorMethodInputMap {
         approvalId: string;
         note?: string;
         remember?: boolean;
+        selectedHunks?: readonly number[];
+        rememberTier?: "command-class" | "exact" | "path" | "session" | "tool";
+        reason?: string;
+        modifiedArgs?: {};
     };
     "approvals.cancel": {
         approvalId: string;
@@ -61,6 +65,8 @@ export interface OperatorMethodInputMap {
         approvalId: string;
         note?: string;
         remember?: boolean;
+        rememberTier?: "command-class" | "exact" | "path" | "session" | "tool";
+        reason?: string;
     };
     "approvals.list": {};
     "artifacts.content.get": {
@@ -690,7 +696,9 @@ export interface OperatorMethodInputMap {
         source?: string;
     };
     "control.snapshot": {};
-    "control.status": {};
+    "control.status": {
+        receipts?: "consume";
+    };
     "control.web": {};
     "deliveries.get": {
         deliveryId: string;
@@ -1246,6 +1254,10 @@ export interface OperatorMethodInputMap {
     } & {
         readonly [key: string]: unknown;
     });
+    "permissions.rules.list": {};
+    "permissions.rules.delete": {
+        ruleId: string;
+    };
     "principals.create": {
         name: string;
         kind: "bot" | "service" | "token" | "user";
@@ -2048,6 +2060,8 @@ export interface OperatorMethodInputMap {
     "workspaces.registrations.add": {
         root: string;
         label?: string;
+        origin?: string;
+        checkpointEligible?: boolean;
     };
     "workspaces.registrations.remove": {
         root: string;
@@ -2110,11 +2124,7 @@ export interface OperatorMethodOutputMap {
             request: {
                 callId: string;
                 tool: string;
-                args: ({} & {
-                    readonly [key: string]: ({} & {
-                        readonly [key: string]: JsonValue;
-                    }) | boolean | null | number | readonly JsonValue[] | string;
-                });
+                args: {};
                 category: "delegate" | "execute" | "read" | "write";
                 analysis: {
                     classification: string;
@@ -2129,6 +2139,23 @@ export interface OperatorMethodOutputMap {
                     host?: string;
                 };
                 workingDirectory?: string;
+                attribution?: {
+                    kind: "background-agent";
+                    agentId: string;
+                    template?: string;
+                } | {
+                    kind: "mcp-server";
+                    serverName: string;
+                } | {
+                    kind: "sandbox-escalation";
+                    sandbox: string;
+                    escalations: readonly string[];
+                };
+                rememberOptions?: readonly ({
+                    tier: "command-class" | "exact" | "path" | "session" | "tool";
+                    label: string;
+                    detail: string;
+                })[];
             };
             createdAt: number;
             updatedAt: number;
@@ -2139,7 +2166,12 @@ export interface OperatorMethodOutputMap {
             decision?: {
                 approved: boolean;
                 remember?: boolean;
+                rememberTier?: "command-class" | "exact" | "path" | "session" | "tool";
+                reason?: string;
+                modifiedArgs?: {};
             };
+            fixSessionId?: string;
+            fixSessionError?: string;
             metadata: ({} & {
                 readonly [key: string]: ({} & {
                     readonly [key: string]: JsonValue;
@@ -2154,6 +2186,12 @@ export interface OperatorMethodOutputMap {
                 note?: string;
             })[];
         };
+        recorded?: {
+            approved: boolean;
+            rememberTier: null | "command-class" | "exact" | "path" | "session" | "tool";
+            reasonStored: boolean;
+            modifiedArgsDelivered: boolean;
+        };
     };
     "approvals.cancel": {
         approval: {
@@ -2165,11 +2203,7 @@ export interface OperatorMethodOutputMap {
             request: {
                 callId: string;
                 tool: string;
-                args: ({} & {
-                    readonly [key: string]: ({} & {
-                        readonly [key: string]: JsonValue;
-                    }) | boolean | null | number | readonly JsonValue[] | string;
-                });
+                args: {};
                 category: "delegate" | "execute" | "read" | "write";
                 analysis: {
                     classification: string;
@@ -2184,6 +2218,23 @@ export interface OperatorMethodOutputMap {
                     host?: string;
                 };
                 workingDirectory?: string;
+                attribution?: {
+                    kind: "background-agent";
+                    agentId: string;
+                    template?: string;
+                } | {
+                    kind: "mcp-server";
+                    serverName: string;
+                } | {
+                    kind: "sandbox-escalation";
+                    sandbox: string;
+                    escalations: readonly string[];
+                };
+                rememberOptions?: readonly ({
+                    tier: "command-class" | "exact" | "path" | "session" | "tool";
+                    label: string;
+                    detail: string;
+                })[];
             };
             createdAt: number;
             updatedAt: number;
@@ -2194,7 +2245,12 @@ export interface OperatorMethodOutputMap {
             decision?: {
                 approved: boolean;
                 remember?: boolean;
+                rememberTier?: "command-class" | "exact" | "path" | "session" | "tool";
+                reason?: string;
+                modifiedArgs?: {};
             };
+            fixSessionId?: string;
+            fixSessionError?: string;
             metadata: ({} & {
                 readonly [key: string]: ({} & {
                     readonly [key: string]: JsonValue;
@@ -2209,6 +2265,12 @@ export interface OperatorMethodOutputMap {
                 note?: string;
             })[];
         };
+        recorded?: {
+            approved: boolean;
+            rememberTier: null | "command-class" | "exact" | "path" | "session" | "tool";
+            reasonStored: boolean;
+            modifiedArgsDelivered: boolean;
+        };
     };
     "approvals.claim": {
         approval: {
@@ -2220,11 +2282,7 @@ export interface OperatorMethodOutputMap {
             request: {
                 callId: string;
                 tool: string;
-                args: ({} & {
-                    readonly [key: string]: ({} & {
-                        readonly [key: string]: JsonValue;
-                    }) | boolean | null | number | readonly JsonValue[] | string;
-                });
+                args: {};
                 category: "delegate" | "execute" | "read" | "write";
                 analysis: {
                     classification: string;
@@ -2239,6 +2297,23 @@ export interface OperatorMethodOutputMap {
                     host?: string;
                 };
                 workingDirectory?: string;
+                attribution?: {
+                    kind: "background-agent";
+                    agentId: string;
+                    template?: string;
+                } | {
+                    kind: "mcp-server";
+                    serverName: string;
+                } | {
+                    kind: "sandbox-escalation";
+                    sandbox: string;
+                    escalations: readonly string[];
+                };
+                rememberOptions?: readonly ({
+                    tier: "command-class" | "exact" | "path" | "session" | "tool";
+                    label: string;
+                    detail: string;
+                })[];
             };
             createdAt: number;
             updatedAt: number;
@@ -2249,7 +2324,12 @@ export interface OperatorMethodOutputMap {
             decision?: {
                 approved: boolean;
                 remember?: boolean;
+                rememberTier?: "command-class" | "exact" | "path" | "session" | "tool";
+                reason?: string;
+                modifiedArgs?: {};
             };
+            fixSessionId?: string;
+            fixSessionError?: string;
             metadata: ({} & {
                 readonly [key: string]: ({} & {
                     readonly [key: string]: JsonValue;
@@ -2264,6 +2344,12 @@ export interface OperatorMethodOutputMap {
                 note?: string;
             })[];
         };
+        recorded?: {
+            approved: boolean;
+            rememberTier: null | "command-class" | "exact" | "path" | "session" | "tool";
+            reasonStored: boolean;
+            modifiedArgsDelivered: boolean;
+        };
     };
     "approvals.deny": {
         approval: {
@@ -2275,11 +2361,7 @@ export interface OperatorMethodOutputMap {
             request: {
                 callId: string;
                 tool: string;
-                args: ({} & {
-                    readonly [key: string]: ({} & {
-                        readonly [key: string]: JsonValue;
-                    }) | boolean | null | number | readonly JsonValue[] | string;
-                });
+                args: {};
                 category: "delegate" | "execute" | "read" | "write";
                 analysis: {
                     classification: string;
@@ -2294,6 +2376,23 @@ export interface OperatorMethodOutputMap {
                     host?: string;
                 };
                 workingDirectory?: string;
+                attribution?: {
+                    kind: "background-agent";
+                    agentId: string;
+                    template?: string;
+                } | {
+                    kind: "mcp-server";
+                    serverName: string;
+                } | {
+                    kind: "sandbox-escalation";
+                    sandbox: string;
+                    escalations: readonly string[];
+                };
+                rememberOptions?: readonly ({
+                    tier: "command-class" | "exact" | "path" | "session" | "tool";
+                    label: string;
+                    detail: string;
+                })[];
             };
             createdAt: number;
             updatedAt: number;
@@ -2304,7 +2403,12 @@ export interface OperatorMethodOutputMap {
             decision?: {
                 approved: boolean;
                 remember?: boolean;
+                rememberTier?: "command-class" | "exact" | "path" | "session" | "tool";
+                reason?: string;
+                modifiedArgs?: {};
             };
+            fixSessionId?: string;
+            fixSessionError?: string;
             metadata: ({} & {
                 readonly [key: string]: ({} & {
                     readonly [key: string]: JsonValue;
@@ -2319,6 +2423,12 @@ export interface OperatorMethodOutputMap {
                 note?: string;
             })[];
         };
+        recorded?: {
+            approved: boolean;
+            rememberTier: null | "command-class" | "exact" | "path" | "session" | "tool";
+            reasonStored: boolean;
+            modifiedArgsDelivered: boolean;
+        };
     };
     "approvals.list": ({
         awaitingDecision: boolean;
@@ -4989,6 +5099,9 @@ export interface OperatorMethodOutputMap {
         notificationId?: string;
         fixSessionTriggered: boolean;
         fixSessionId?: string;
+        fixSessionError?: string;
+        fixSessionOffered?: boolean;
+        retired?: boolean;
     };
     "companion.chat.events.stream": {};
     "companion.chat.messages.create": {
@@ -5138,6 +5251,8 @@ export interface OperatorMethodOutputMap {
         dimension: "agent" | "hook" | "mcp" | "model" | "provider" | "session" | "tool";
         totalCostUsd: null | number;
         costState: "estimated" | "priced" | "unpriced";
+        costSource: null | "catalog" | "mixed" | "provider" | "user";
+        pricingAsOf: null | string;
         pricedRecordCount: number;
         unpricedRecordCount: number;
         tokens: {
@@ -5150,6 +5265,8 @@ export interface OperatorMethodOutputMap {
             key: string;
             costUsd: null | number;
             costState: "estimated" | "priced" | "unpriced";
+            costSource: null | "catalog" | "mixed" | "provider" | "user";
+            pricingAsOf: null | string;
             pricedRecordCount: number;
             unpricedRecordCount: number;
             tokens: {
@@ -5531,6 +5648,11 @@ export interface OperatorMethodOutputMap {
     "control.status": {
         status: string;
         version: string;
+        receipts?: readonly ({
+            id: string;
+            text: string;
+            at: number;
+        })[];
     };
     "control.web": {
         html: string;
@@ -5652,6 +5774,8 @@ export interface OperatorMethodOutputMap {
             provider?: string;
             costUsd?: null | number;
             costState: "estimated" | "priced" | "unpriced";
+            costSource?: "catalog" | "mixed" | "provider" | "user";
+            pricingAsOf?: string;
             currentActivity?: {
                 kind: "output-line" | "phase" | "tool";
                 text: string;
@@ -5707,6 +5831,8 @@ export interface OperatorMethodOutputMap {
                     toolCallCount: number;
                     costUsd: null | number;
                     costState: "estimated" | "priced" | "unpriced";
+                    costSource?: "catalog" | "mixed" | "provider" | "user";
+                    pricingAsOf?: string;
                 };
                 failureReason: null | string;
                 diff: null | {
@@ -5755,6 +5881,8 @@ export interface OperatorMethodOutputMap {
             provider?: string;
             costUsd?: null | number;
             costState: "estimated" | "priced" | "unpriced";
+            costSource?: "catalog" | "mixed" | "provider" | "user";
+            pricingAsOf?: string;
             currentActivity?: {
                 kind: "output-line" | "phase" | "tool";
                 text: string;
@@ -5809,6 +5937,8 @@ export interface OperatorMethodOutputMap {
             provider?: string;
             costUsd?: null | number;
             costState: "estimated" | "priced" | "unpriced";
+            costSource?: "catalog" | "mixed" | "provider" | "user";
+            pricingAsOf?: string;
             currentActivity?: {
                 kind: "output-line" | "phase" | "tool";
                 text: string;
@@ -7661,6 +7791,19 @@ export interface OperatorMethodOutputMap {
         id: string;
         pane: "bottom" | "top";
     };
+    "permissions.rules.list": {
+        rules: readonly ({
+            id: string;
+            effect: "allow" | "deny";
+            tier: "command-class" | "exact" | "path" | "tool";
+            tool: string;
+            description?: string;
+            createdAt: number;
+        })[];
+    };
+    "permissions.rules.delete": {
+        deleted: boolean;
+    };
     "principals.create": {
         principal: {
             id: string;
@@ -7838,6 +7981,8 @@ export interface OperatorMethodOutputMap {
                 inputPerMillionTokens: number;
                 outputPerMillionTokens: number;
                 currency: "USD";
+                source: "catalog" | "provider" | "user";
+                asOf?: string;
             };
         } & {
             readonly [key: string]: unknown;
@@ -7926,6 +8071,8 @@ export interface OperatorMethodOutputMap {
                     inputPerMillionTokens: number;
                     outputPerMillionTokens: number;
                     currency: "USD";
+                    source: "catalog" | "provider" | "user";
+                    asOf?: string;
                 };
             } & {
                 readonly [key: string]: unknown;
@@ -7936,7 +8083,8 @@ export interface OperatorMethodOutputMap {
         providerId: string;
         active: boolean;
         currentModelRegistryKey?: string;
-        pricingSource: "catalog" | "none" | "provider";
+        pricingSource: "catalog" | "mixed" | "none" | "provider" | "user";
+        pricingAsOf?: string;
         models: readonly (({
             id: string;
             registryKey: string;
@@ -7948,6 +8096,8 @@ export interface OperatorMethodOutputMap {
                 inputPerMillionTokens: number;
                 outputPerMillionTokens: number;
                 currency: "USD";
+                source: "catalog" | "provider" | "user";
+                asOf?: string;
             };
         } & {
             readonly [key: string]: unknown;
@@ -11785,6 +11935,8 @@ export interface OperatorMethodOutputMap {
             root: string;
             registeredAt: string;
             label?: string;
+            origin?: string;
+            checkpointEligible?: boolean;
         })[];
         declines: readonly ({
             root: string;
@@ -11796,6 +11948,8 @@ export interface OperatorMethodOutputMap {
             root: string;
             registeredAt: string;
             label?: string;
+            origin?: string;
+            checkpointEligible?: boolean;
         };
         alreadyRegistered: boolean;
     };