@vinaverse/server 0.1.0-alpha.1 → 0.1.0-alpha.11

package/dist/{provider-Miaa9V7I.d.cts → provider-CLoSmI29.d.cts}

@@ -1,4 +1,4 @@
-import { c as components$1, w as webhooks } from './vinaverse-v1.d-BVc4uyUd.cjs';
+import { c as components$1, w as webhooks } from './vinaverse-v1.d-DiulmRgx.cjs';
 import { c as NonceStore, a as IdempotencyStore } from './nonces-scwljZwl.cjs';
 
 /**
@@ -265,6 +265,18 @@ declare const TOOL_OPERATIONS: {
         readonly pathParams: {};
         readonly queryParams: {};
     };
+    readonly get_setup_state: {
+        readonly id: "get_setup_state";
+        readonly method: "GET";
+        readonly path: "/business/setup";
+        readonly effect: "read";
+        readonly maxResultBytes: 16384;
+        readonly successStatus: 200;
+        readonly idempotencyKey: false;
+        readonly body: false;
+        readonly pathParams: {};
+        readonly queryParams: {};
+    };
     readonly get_workspace: {
         readonly id: "get_workspace";
         readonly method: "GET";
@@ -366,6 +378,31 @@ declare const TOOL_OPERATIONS: {
             };
         };
     };
+    readonly list_services_in_area: {
+        readonly id: "list_services_in_area";
+        readonly method: "GET";
+        readonly path: "/areas/services";
+        readonly effect: "read";
+        readonly maxResultBytes: 16384;
+        readonly successStatus: 200;
+        readonly idempotencyKey: false;
+        readonly body: false;
+        readonly pathParams: {};
+        readonly queryParams: {
+            readonly lat: {
+                readonly type: "number";
+                readonly required: false;
+            };
+            readonly lng: {
+                readonly type: "number";
+                readonly required: false;
+            };
+            readonly radius_miles: {
+                readonly type: "integer";
+                readonly required: false;
+            };
+        };
+    };
     readonly resolve_place: {
         readonly id: "resolve_place";
         readonly method: "GET";
@@ -578,6 +615,55 @@ interface components {
             price_is_from?: boolean;
             duration_minutes: number;
         };
+        /**
+         * @description `estimate`: the tenant did not count exactly (a cached or sampled figure); the agent says "about"
+         * @enum {string}
+         */
+        CountStatus: "exact" | "estimate";
+        InventoryService: {
+            id: string;
+            name: string;
+            count: number;
+            count_status: components["schemas"]["CountStatus"];
+        };
+        InventoryCategory: {
+            id: string;
+            name: string;
+            count: number;
+            count_status: components["schemas"]["CountStatus"];
+            services?: components["schemas"]["InventoryService"][];
+        };
+        NearbyArea: {
+            area: components["schemas"]["Area"];
+            lat?: number;
+            lng?: number;
+            count: number;
+            count_status: components["schemas"]["CountStatus"];
+        };
+        /** @description v1-draft.15, `list_services_in_area`'s result: what is represented around the place, and where else there is supply. Empty `categories` means nothing is offered within the radius; `nearest_areas` then says where there is. */
+        AreaInventory: {
+            /** @constant */
+            type: "area_inventory";
+            /**
+             * Format: date-time
+             * @description when the tenant counted
+             */
+            as_of: string;
+            categories: components["schemas"]["InventoryCategory"][];
+            /** @description the nearest areas outside the radius that have supply, nearest first */
+            nearest_areas: components["schemas"]["NearbyArea"][];
+        };
+        /** @description v1-draft.15: one approved photo. `id` and `version` name the asset as the tenant's media store does: a new version is a new photo, and approval binds to the version, never to a mutable URL. The URL is https and starts with a prefix the manifest registers (`image_url_prefixes`), compared after the runtime parses and normalizes it: a URL with user info, a backslash, a fragment, or a `.` or `..` path segment (also percent-encoded, as `%2e`) is dropped, never resolved, so no path can step outside the approved one. `expires_at` is set only when the URL expires (a signed URL), and then the runtime drops it from a card it records after that time. */
+        ImageAsset: {
+            id: string;
+            version: string;
+            /** Format: uri */
+            url: string;
+            width?: number;
+            height?: number;
+            /** Format: date-time */
+            expires_at?: string;
+        };
         ProfessionalSummary: {
             /** @constant */
             type: "professional";
@@ -586,8 +672,12 @@ interface components {
             headline?: string;
             /** Format: uri */
             photo_url?: string;
+            /** @description v1-draft.15, approved photos, the first the hero (`photo_url` is its URL) */
+            images?: components["schemas"]["ImageAsset"][];
             rating?: components["schemas"]["Rating"];
             area?: components["schemas"]["Area"];
+            /** @description v1-draft.15: the lowest price the professional asks for a service, as the tenant knows it; left out when it does not */
+            price_from?: components["schemas"]["Money"];
             top_services?: components["schemas"]["ServiceOffer"][];
             /** Format: date-time */
             next_available?: string | null;
@@ -609,6 +699,8 @@ interface components {
             category?: string;
             /** Format: uri */
             photo_url?: string;
+            /** @description v1-draft.15, approved photos, the first the hero (`photo_url` is its URL) */
+            images?: components["schemas"]["ImageAsset"][];
             rating?: components["schemas"]["Rating"];
             area?: components["schemas"]["Area"];
             price_from?: components["schemas"]["Money"];
@@ -760,6 +852,35 @@ interface components {
             country: string;
         };
         TextList: string[];
+        /** @description A business's setup steps, in the order the business should do them. The steps and their state are the tenant's own record; a business with nothing left to set up has every step `done`. */
+        SetupState: {
+            steps: components["schemas"]["SetupStep"][];
+        };
+        /** @description One step of a business's setup. `title`, `body` and `label` are the tenant's own words for it, shown on the `next_step` card when the step has a `deep_link`. A `blocked` step says why in `reason`. */
+        SetupStep: {
+            /**
+             * @description the tenant's id for the step, stable across reads; the agent names a step by it
+             * @example business_name
+             * @example opening_hours
+             * @example payouts
+             */
+            id: string;
+            /** @description the step, as the person knows it */
+            title: string;
+            /**
+             * @description `not_started` and `in_progress` are still to do, `done` is finished, and `blocked` waits on something the person cannot do in this conversation (a review, another step), named in `reason`.
+             * @enum {string}
+             */
+            status: "not_started" | "in_progress" | "done" | "blocked";
+            /** @description what the step is for, in one or two sentences */
+            body?: string;
+            /** @description why a `blocked` step is blocked; only a `blocked` step has one */
+            reason?: string;
+            /** @description the action's words on its `next_step` card */
+            label?: string;
+            /** @description For a step finished on the tenant's own screen, a link into the tenant's app. It must start with a prefix registered for the environment and pass the link checks (`admin-v1.yaml`, `Connector.deep_link_prefixes`). The runtime removes one that fails, and the step is then shown without a card. */
+            deep_link?: string;
+        } & unknown;
         /** @description One of the signed-in customer's kits: items a styling-kit retailer sends to try at home, each kept or returned, the kept ones charged. `status` is where the kit is in its life: `preparing` (being put together), `shipped` (on its way), `delivered` (arrived, deciding not open yet), `feedback_open` (the customer decides keep or return for each item, until `feedback_closes_at`), `feedback_closed` (the decisions are in; the items to return are due back by `return_by`), `returned` (the returned items arrived), `billed` (the kept items were charged: `order_id`), `cancelled`. A retailer whose kits skip a state (feedback opens on delivery) never sends it. "What do I still need to do" is answered by `undecided_count` and each item's `decision` before `feedback_closes_at`, and by the items to return and `return_by` after it. */
         Kit: {
             /** @constant */
@@ -1218,6 +1339,36 @@ interface operations {
             default: components["responses"]["Problem"];
         };
     };
+    list_services_in_area: {
+        parameters: {
+            query?: {
+                lat?: components["parameters"]["Lat"];
+                lng?: components["parameters"]["Lng"];
+                radius_miles?: components["parameters"]["RadiusMiles"];
+            };
+            header?: {
+                /** @description on every tool call in a session, a channel session's included (never on the catalogue sweep), the session's id; informational and not signed */
+                "Vinaverse-Session"?: components["parameters"]["VinaverseSession"];
+                /** @description on every tool call of a session that belongs to a conversation (never on the catalogue sweep), its id; informational and not signed */
+                "Vinaverse-Conversation"?: components["parameters"]["VinaverseConversation"];
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AreaInventory"];
+                };
+            };
+            default: components["responses"]["Problem"];
+        };
+    };
     search_workspaces: {
         parameters: {
             query?: {
@@ -1605,6 +1756,32 @@ interface operations {
             default: components["responses"]["Problem"];
         };
     };
+    get_setup_state: {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description on every tool call in a session, a channel session's included (never on the catalogue sweep), the session's id; informational and not signed */
+                "Vinaverse-Session"?: components["parameters"]["VinaverseSession"];
+                /** @description on every tool call of a session that belongs to a conversation (never on the catalogue sweep), its id; informational and not signed */
+                "Vinaverse-Conversation"?: components["parameters"]["VinaverseConversation"];
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SetupState"];
+                };
+            };
+            default: components["responses"]["Problem"];
+        };
+    };
     create_handoff: {
         parameters: {
             query?: never;

package/dist/{provider-BqfTvF3g.d.ts → provider-ClyzwMQx.d.ts}

@@ -1,4 +1,4 @@
-import { c as components$1, w as webhooks } from './vinaverse-v1.d-BVc4uyUd.js';
+import { c as components$1, w as webhooks } from './vinaverse-v1.d-DiulmRgx.js';
 import { c as NonceStore, a as IdempotencyStore } from './nonces-scwljZwl.js';
 
 /**
@@ -265,6 +265,18 @@ declare const TOOL_OPERATIONS: {
         readonly pathParams: {};
         readonly queryParams: {};
     };
+    readonly get_setup_state: {
+        readonly id: "get_setup_state";
+        readonly method: "GET";
+        readonly path: "/business/setup";
+        readonly effect: "read";
+        readonly maxResultBytes: 16384;
+        readonly successStatus: 200;
+        readonly idempotencyKey: false;
+        readonly body: false;
+        readonly pathParams: {};
+        readonly queryParams: {};
+    };
     readonly get_workspace: {
         readonly id: "get_workspace";
         readonly method: "GET";
@@ -366,6 +378,31 @@ declare const TOOL_OPERATIONS: {
             };
         };
     };
+    readonly list_services_in_area: {
+        readonly id: "list_services_in_area";
+        readonly method: "GET";
+        readonly path: "/areas/services";
+        readonly effect: "read";
+        readonly maxResultBytes: 16384;
+        readonly successStatus: 200;
+        readonly idempotencyKey: false;
+        readonly body: false;
+        readonly pathParams: {};
+        readonly queryParams: {
+            readonly lat: {
+                readonly type: "number";
+                readonly required: false;
+            };
+            readonly lng: {
+                readonly type: "number";
+                readonly required: false;
+            };
+            readonly radius_miles: {
+                readonly type: "integer";
+                readonly required: false;
+            };
+        };
+    };
     readonly resolve_place: {
         readonly id: "resolve_place";
         readonly method: "GET";
@@ -578,6 +615,55 @@ interface components {
             price_is_from?: boolean;
             duration_minutes: number;
         };
+        /**
+         * @description `estimate`: the tenant did not count exactly (a cached or sampled figure); the agent says "about"
+         * @enum {string}
+         */
+        CountStatus: "exact" | "estimate";
+        InventoryService: {
+            id: string;
+            name: string;
+            count: number;
+            count_status: components["schemas"]["CountStatus"];
+        };
+        InventoryCategory: {
+            id: string;
+            name: string;
+            count: number;
+            count_status: components["schemas"]["CountStatus"];
+            services?: components["schemas"]["InventoryService"][];
+        };
+        NearbyArea: {
+            area: components["schemas"]["Area"];
+            lat?: number;
+            lng?: number;
+            count: number;
+            count_status: components["schemas"]["CountStatus"];
+        };
+        /** @description v1-draft.15, `list_services_in_area`'s result: what is represented around the place, and where else there is supply. Empty `categories` means nothing is offered within the radius; `nearest_areas` then says where there is. */
+        AreaInventory: {
+            /** @constant */
+            type: "area_inventory";
+            /**
+             * Format: date-time
+             * @description when the tenant counted
+             */
+            as_of: string;
+            categories: components["schemas"]["InventoryCategory"][];
+            /** @description the nearest areas outside the radius that have supply, nearest first */
+            nearest_areas: components["schemas"]["NearbyArea"][];
+        };
+        /** @description v1-draft.15: one approved photo. `id` and `version` name the asset as the tenant's media store does: a new version is a new photo, and approval binds to the version, never to a mutable URL. The URL is https and starts with a prefix the manifest registers (`image_url_prefixes`), compared after the runtime parses and normalizes it: a URL with user info, a backslash, a fragment, or a `.` or `..` path segment (also percent-encoded, as `%2e`) is dropped, never resolved, so no path can step outside the approved one. `expires_at` is set only when the URL expires (a signed URL), and then the runtime drops it from a card it records after that time. */
+        ImageAsset: {
+            id: string;
+            version: string;
+            /** Format: uri */
+            url: string;
+            width?: number;
+            height?: number;
+            /** Format: date-time */
+            expires_at?: string;
+        };
         ProfessionalSummary: {
             /** @constant */
             type: "professional";
@@ -586,8 +672,12 @@ interface components {
             headline?: string;
             /** Format: uri */
             photo_url?: string;
+            /** @description v1-draft.15, approved photos, the first the hero (`photo_url` is its URL) */
+            images?: components["schemas"]["ImageAsset"][];
             rating?: components["schemas"]["Rating"];
             area?: components["schemas"]["Area"];
+            /** @description v1-draft.15: the lowest price the professional asks for a service, as the tenant knows it; left out when it does not */
+            price_from?: components["schemas"]["Money"];
             top_services?: components["schemas"]["ServiceOffer"][];
             /** Format: date-time */
             next_available?: string | null;
@@ -609,6 +699,8 @@ interface components {
             category?: string;
             /** Format: uri */
             photo_url?: string;
+            /** @description v1-draft.15, approved photos, the first the hero (`photo_url` is its URL) */
+            images?: components["schemas"]["ImageAsset"][];
             rating?: components["schemas"]["Rating"];
             area?: components["schemas"]["Area"];
             price_from?: components["schemas"]["Money"];
@@ -760,6 +852,35 @@ interface components {
             country: string;
         };
         TextList: string[];
+        /** @description A business's setup steps, in the order the business should do them. The steps and their state are the tenant's own record; a business with nothing left to set up has every step `done`. */
+        SetupState: {
+            steps: components["schemas"]["SetupStep"][];
+        };
+        /** @description One step of a business's setup. `title`, `body` and `label` are the tenant's own words for it, shown on the `next_step` card when the step has a `deep_link`. A `blocked` step says why in `reason`. */
+        SetupStep: {
+            /**
+             * @description the tenant's id for the step, stable across reads; the agent names a step by it
+             * @example business_name
+             * @example opening_hours
+             * @example payouts
+             */
+            id: string;
+            /** @description the step, as the person knows it */
+            title: string;
+            /**
+             * @description `not_started` and `in_progress` are still to do, `done` is finished, and `blocked` waits on something the person cannot do in this conversation (a review, another step), named in `reason`.
+             * @enum {string}
+             */
+            status: "not_started" | "in_progress" | "done" | "blocked";
+            /** @description what the step is for, in one or two sentences */
+            body?: string;
+            /** @description why a `blocked` step is blocked; only a `blocked` step has one */
+            reason?: string;
+            /** @description the action's words on its `next_step` card */
+            label?: string;
+            /** @description For a step finished on the tenant's own screen, a link into the tenant's app. It must start with a prefix registered for the environment and pass the link checks (`admin-v1.yaml`, `Connector.deep_link_prefixes`). The runtime removes one that fails, and the step is then shown without a card. */
+            deep_link?: string;
+        } & unknown;
         /** @description One of the signed-in customer's kits: items a styling-kit retailer sends to try at home, each kept or returned, the kept ones charged. `status` is where the kit is in its life: `preparing` (being put together), `shipped` (on its way), `delivered` (arrived, deciding not open yet), `feedback_open` (the customer decides keep or return for each item, until `feedback_closes_at`), `feedback_closed` (the decisions are in; the items to return are due back by `return_by`), `returned` (the returned items arrived), `billed` (the kept items were charged: `order_id`), `cancelled`. A retailer whose kits skip a state (feedback opens on delivery) never sends it. "What do I still need to do" is answered by `undecided_count` and each item's `decision` before `feedback_closes_at`, and by the items to return and `return_by` after it. */
         Kit: {
             /** @constant */
@@ -1218,6 +1339,36 @@ interface operations {
             default: components["responses"]["Problem"];
         };
     };
+    list_services_in_area: {
+        parameters: {
+            query?: {
+                lat?: components["parameters"]["Lat"];
+                lng?: components["parameters"]["Lng"];
+                radius_miles?: components["parameters"]["RadiusMiles"];
+            };
+            header?: {
+                /** @description on every tool call in a session, a channel session's included (never on the catalogue sweep), the session's id; informational and not signed */
+                "Vinaverse-Session"?: components["parameters"]["VinaverseSession"];
+                /** @description on every tool call of a session that belongs to a conversation (never on the catalogue sweep), its id; informational and not signed */
+                "Vinaverse-Conversation"?: components["parameters"]["VinaverseConversation"];
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AreaInventory"];
+                };
+            };
+            default: components["responses"]["Problem"];
+        };
+    };
     search_workspaces: {
         parameters: {
             query?: {
@@ -1605,6 +1756,32 @@ interface operations {
             default: components["responses"]["Problem"];
         };
     };
+    get_setup_state: {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description on every tool call in a session, a channel session's included (never on the catalogue sweep), the session's id; informational and not signed */
+                "Vinaverse-Session"?: components["parameters"]["VinaverseSession"];
+                /** @description on every tool call of a session that belongs to a conversation (never on the catalogue sweep), its id; informational and not signed */
+                "Vinaverse-Conversation"?: components["parameters"]["VinaverseConversation"];
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SetupState"];
+                };
+            };
+            default: components["responses"]["Problem"];
+        };
+    };
     create_handoff: {
         parameters: {
             query?: never;