kurumera 0.1.0__py3-none-any.whl

kurumera/__init__.py

@@ -0,0 +1,66 @@
+"""
+kurumera - drive a Kurumera store from Python.
+
+    pip install kurumera
+
+    from kurumera import Kurumera
+    km = Kurumera()                       # KURUMERA_API_KEY from the environment
+    km.create_product(title="Badam 500g")
+
+Every method is one of the platform's MCP tools, under the same name, reaching
+the same authenticated endpoint. Nothing here decides what you are allowed to
+do: the store, the capabilities and the limits all come from your credential,
+checked server-side exactly as they are for any other client.
+"""
+from __future__ import annotations
+
+from ._version import __version__
+from .client import Kurumera
+from .credentials import DEFAULT_MCP_URL
+from .errors import (
+    AccountError,
+    AuthError,
+    AuthFailed,
+    AuthRequired,
+    ConfirmationRequired,
+    DestructiveBlockedError,
+    InvalidArguments,
+    KurumeraConfigError,
+    KurumeraConnectionError,
+    KurumeraError,
+    KurumeraProtocolError,
+    NoTenant,
+    PermissionDenied,
+    RateLimited,
+    ReadOnlyModeError,
+    ServerError,
+    SubscriptionInactive,
+    TenantCancelled,
+    TenantInactive,
+    TenantMismatch,
+    TenantPendingApproval,
+    ToolCallError,
+    ToolNotFound,
+    UserInactive,
+    UserNotFound,
+)
+from .registry import registry_hash as _registry_hash
+from .registry import tool_count as _tool_count
+from .types import UNSET, Annotations, ToolImage, ToolInfo, ToolResult
+
+#: Which tool registry this package was generated from. Report it in a bug.
+REGISTRY_HASH = _registry_hash()
+REGISTRY_TOOL_COUNT = _tool_count()
+
+__all__ = [
+    "Kurumera",
+    "ToolResult", "ToolImage", "ToolInfo", "Annotations", "UNSET",
+    "DEFAULT_MCP_URL", "REGISTRY_HASH", "REGISTRY_TOOL_COUNT", "__version__",
+    "KurumeraError", "KurumeraConfigError", "KurumeraConnectionError",
+    "KurumeraProtocolError", "AuthError", "AuthRequired", "AuthFailed",
+    "UserNotFound", "TenantMismatch", "AccountError", "UserInactive", "NoTenant",
+    "TenantInactive", "TenantPendingApproval", "TenantCancelled",
+    "SubscriptionInactive", "ServerError", "ReadOnlyModeError",
+    "DestructiveBlockedError", "ToolCallError", "ToolNotFound",
+    "InvalidArguments", "PermissionDenied", "RateLimited", "ConfirmationRequired",
+]

kurumera/_generated/__init__.py

@@ -0,0 +1,122 @@
+"""
+GENERATED by `python manage.py generate_python_sdk`. Do not edit.
+
+Every method is one MCP tool, under the tool's own name, with the tool's own
+documentation. Optional arguments default to UNSET rather than None because the
+server rejects an explicit null for them - see the generator's module docstring.
+"""
+from __future__ import annotations
+
+from typing import Any, Generic, TypeVar
+
+from ..types import UNSET, _Unset
+
+R = TypeVar("R")
+
+
+class _ToolBase(Generic[R]):
+    """Supplies `_invoke`. The client decides whether R is a result or a future."""
+
+    def _invoke(self, name: str, args: dict[str, Any]) -> R:      # pragma: no cover
+        raise NotImplementedError
+
+
+from .alias_tools import AliasTools  # noqa: E402
+from .analytics_tools import AnalyticsTools  # noqa: E402
+from .blog_tools import BlogTools  # noqa: E402
+from .branch_tools import BranchTools  # noqa: E402
+from .branding_tools import BrandingTools  # noqa: E402
+from .campaign_tools import CampaignTools  # noqa: E402
+from .cart_tools import CartTools  # noqa: E402
+from .collection_tools import CollectionTools  # noqa: E402
+from .commercial_tools import CommercialTools  # noqa: E402
+from .content_access import ContentAccessTools  # noqa: E402
+from .content_delete import ContentDeleteTools  # noqa: E402
+from .crm_file_tools import CrmFileTools  # noqa: E402
+from .crm_tools import CrmTools  # noqa: E402
+from .currency_tools import CurrencyTools  # noqa: E402
+from .customer_tools import CustomerTools  # noqa: E402
+from .discount_tools import DiscountTools  # noqa: E402
+from .doc_tools import DocTools  # noqa: E402
+from .email_tools import EmailTools  # noqa: E402
+from .faq_tools import FaqTools  # noqa: E402
+from .finance_tools import FinanceTools  # noqa: E402
+from .forecast_tools import ForecastTools  # noqa: E402
+from .form_tools import FormTools  # noqa: E402
+from .gift_card_tools import GiftCardTools  # noqa: E402
+from .inbox_tools import InboxTools  # noqa: E402
+from .inventory_tools import InventoryTools  # noqa: E402
+from .invoice_tools import InvoiceTools  # noqa: E402
+from .media_library_tools import MediaLibraryTools  # noqa: E402
+from .media_tools import MediaTools  # noqa: E402
+from .merge_tools import MergeTools  # noqa: E402
+from .merged_tools import MergedTools  # noqa: E402
+from .migration_tools import MigrationTools  # noqa: E402
+from .nav_tools import NavTools  # noqa: E402
+from .notification_tools import NotificationTools  # noqa: E402
+from .order_tools import OrderTools  # noqa: E402
+from .page_locale_tools import PageLocaleTools  # noqa: E402
+from .page_tools import PageTools  # noqa: E402
+from .pagebuilder_authoring_tools import PagebuilderAuthoringTools  # noqa: E402
+from .pagebuilder_component_tools import PagebuilderComponentTools  # noqa: E402
+from .pagebuilder_visual_tools import PagebuilderVisualTools  # noqa: E402
+from .pos_tools import PosTools  # noqa: E402
+from .product_tools import ProductTools  # noqa: E402
+from .review_tools import ReviewTools  # noqa: E402
+from .site_gen_tools import SiteGenTools  # noqa: E402
+from .social_tools import SocialTools  # noqa: E402
+from .store_tools import StoreTools  # noqa: E402
+from .translation_tools import TranslationTools  # noqa: E402
+from .webhook_tools import WebhookTools  # noqa: E402
+
+
+class GeneratedTools(
+    AliasTools[R],
+    AnalyticsTools[R],
+    BlogTools[R],
+    BranchTools[R],
+    BrandingTools[R],
+    CampaignTools[R],
+    CartTools[R],
+    CollectionTools[R],
+    CommercialTools[R],
+    ContentAccessTools[R],
+    ContentDeleteTools[R],
+    CrmFileTools[R],
+    CrmTools[R],
+    CurrencyTools[R],
+    CustomerTools[R],
+    DiscountTools[R],
+    DocTools[R],
+    EmailTools[R],
+    FaqTools[R],
+    FinanceTools[R],
+    ForecastTools[R],
+    FormTools[R],
+    GiftCardTools[R],
+    InboxTools[R],
+    InventoryTools[R],
+    InvoiceTools[R],
+    MediaLibraryTools[R],
+    MediaTools[R],
+    MergeTools[R],
+    MergedTools[R],
+    MigrationTools[R],
+    NavTools[R],
+    NotificationTools[R],
+    OrderTools[R],
+    PageLocaleTools[R],
+    PageTools[R],
+    PagebuilderAuthoringTools[R],
+    PagebuilderComponentTools[R],
+    PagebuilderVisualTools[R],
+    PosTools[R],
+    ProductTools[R],
+    ReviewTools[R],
+    SiteGenTools[R],
+    SocialTools[R],
+    StoreTools[R],
+    TranslationTools[R],
+    WebhookTools[R],
+):
+    """Every tool the platform exposed when this package was built."""

kurumera/_generated/alias_tools.py

@@ -0,0 +1,65 @@
+"""
+GENERATED by `python manage.py generate_python_sdk`. Do not edit.
+
+Tools from mcp_server/tools/alias_tools.py.
+"""
+from __future__ import annotations
+
+from typing import Any, TypeVar
+
+from ..types import UNSET, _Unset
+from . import _ToolBase
+
+R = TypeVar("R")
+
+
+class AliasTools(_ToolBase[R]):
+    def add_search_aliases(self, content_type: str, item_id: str, terms: list[Any], *, confirm: bool | _Unset = UNSET) -> R:
+        """
+        Requires confirm=True.
+
+        Make a product findable by extra words shoppers actually type.
+
+            Good aliases: local names ("Motia" for jasmine), transliterations
+            ("موتیا"), spelling variants ("Motiya"), common phrases ("motia ka poda"),
+            and old names customers still use.
+
+            Bad aliases: generic words like "plant" or "gift" — they make the product
+            match searches it has no business appearing in, which pushes down results
+            that genuinely match.
+
+            Aliases are invisible on the storefront and take effect immediately. They
+            change what search finds, never what a shopper reads.
+
+        Omitted arguments are not sent; the store applies its own defaults: confirm=False.
+        """
+        return self._invoke("add_search_aliases", {"content_type": content_type, "item_id": item_id, "terms": terms, "confirm": confirm})
+
+    def list_search_aliases(self, *, content_type: str | _Unset = UNSET, item_id: str | _Unset = UNSET) -> R:
+        """
+        Read-only.
+
+        The extra search terms attached to a product (or the whole store).
+
+            Omit `item_id` for a store-wide view — useful for spotting which products
+            have no local-language terms yet and would therefore be invisible to a
+            shopper searching in Urdu or Roman Urdu.
+
+        Omitted arguments are not sent; the store applies its own defaults: content_type='product'.
+        """
+        return self._invoke("list_search_aliases", {"content_type": content_type, "item_id": item_id})
+
+    def remove_search_aliases(self, content_type: str, item_id: str, terms: list[Any], *, confirm: bool | _Unset = UNSET) -> R:
+        """
+        DESTRUCTIVE - removes, overwrites or makes something irreversibly live.
+        Requires confirm=True.
+
+        Remove search terms from a product.
+
+            Use when an alias is pulling the product into searches it shouldn't match.
+            Removing one only narrows what search finds — it never hides the product
+            itself.
+
+        Omitted arguments are not sent; the store applies its own defaults: confirm=False.
+        """
+        return self._invoke("remove_search_aliases", {"content_type": content_type, "item_id": item_id, "terms": terms, "confirm": confirm})

kurumera/_generated/analytics_tools.py

@@ -0,0 +1,169 @@
+"""
+GENERATED by `python manage.py generate_python_sdk`. Do not edit.
+
+Tools from mcp_server/tools/analytics_tools.py.
+"""
+from __future__ import annotations
+
+from typing import Any, TypeVar
+
+from ..types import UNSET, _Unset
+from . import _ToolBase
+
+R = TypeVar("R")
+
+
+class AnalyticsTools(_ToolBase[R]):
+    def generate_business_report(self, report_type: str, *, baseline_from: str | _Unset = UNSET, baseline_label: str | _Unset = UNSET, baseline_to: str | _Unset = UNSET, compare: bool | _Unset = UNSET, date_from: str | _Unset = UNSET, date_to: str | _Unset = UNSET, days: int | _Unset = UNSET, theme: str | _Unset = UNSET) -> R:
+        """
+        Read-only.
+
+        A whole branded report in one call — ordered sections, each with its
+            numbers, its chart and the reference that traces it to the call behind it.
+
+            Enough to assemble a deck without asking a second question and without
+            reading a pixel.
+
+            report_type:
+              weekly_management    How the week went, sales, what sold, payment states.
+              merchant_performance Headline, gross-to-net, best sellers, customers.
+              agency_client        Results, visitors, sources, visit-to-purchase.
+              product_review       By product, by units, stock on hand, the funnel.
+              investor_evidence    Headline, gross-to-net, revenue, growth — as
+                                   EVIDENCE charts, provenance stamped on each image.
+              bank_evidence        Gross-to-net, payment states, tax, refunds — also
+                                   evidence charts.
+              enterprise_case_study Headline, growth, customers, what sells — as
+                                   evidence charts, because a prospect handed a
+                                   growth figure cannot check it otherwise.
+              migration            Before and after, against a baseline YOU state.
+                                   Needs baseline_from, baseline_to and
+                                   baseline_label; see below.
+
+            BEFORE/AFTER (migration)
+              baseline_from/_to  The window the store traded in BEFORE the change,
+                                 YYYY-MM-DD. Must end before the reported period
+                                 opens — an overlapping baseline counts the same
+                                 trading on both sides and is refused, not caveated.
+              baseline_label     What that window WAS, in your words: "trading on the
+                                 old platform", "the quarter before launch". Required,
+                                 because a reader shown two numbers and told nothing
+                                 about the first one has not been shown a comparison.
+
+              Every section runs TWICE, once per window, through this same tool — so
+              before and after are one definition, and each half carries its own
+              reference and its own stamped chart. Unequal window lengths are allowed
+              and stated; a baseline in which Kurumera recorded no orders at all is
+              called out, because rendering it as zero turns a migration date into
+              growth.
+
+            THIS COMPUTES NOTHING. Every figure comes from `get_report` and every
+            colour from the brand kit, so a section you could not read directly you
+            cannot read here either: the finance scope and the identity redaction apply
+            exactly as they do to a direct call.
+
+            A section that cannot be produced is MARKED, never filled. Check
+            `summary.complete` and `summary.warnings` before presenting the report, and
+            say plainly which parts are missing rather than working around the hole —
+            a gap filled with a plausible number is the one failure that makes a report
+            dangerous rather than merely incomplete.
+
+            Returns:
+                JSON: { report_type, brand: {...}, sections: [ { report, title,
+                        available, data, chart, reference, reason } ],
+                        summary: { sections_requested, sections_available, complete,
+                                   warnings } }
+
+        Omitted arguments are not sent; the store applies its own defaults: compare=True, days=30, theme='light'.
+        """
+        return self._invoke("generate_business_report", {"report_type": report_type, "baseline_from": baseline_from, "baseline_label": baseline_label, "baseline_to": baseline_to, "compare": compare, "date_from": date_from, "date_to": date_to, "days": days, "theme": theme})
+
+    def get_report(self, report: str, *, city: str | _Unset = UNSET, compare: bool | _Unset = UNSET, country: str | _Unset = UNSET, date_from: str | _Unset = UNSET, date_to: str | _Unset = UNSET, days: int | _Unset = UNSET, group_by: str | _Unset = UNSET, limit: int | _Unset = UNSET, location_id: str | _Unset = UNSET, max_cohorts: int | _Unset = UNSET, render: str | _Unset = UNSET, theme: str | _Unset = UNSET) -> R:
+        """
+        Read-only.
+
+        Every analytics and reporting read for this store, selected by `report`.
+
+            Window: `days` (default 30, inclusive of today) OR explicit `date_from` /
+            `date_to` (YYYY-MM-DD). The extra args apply only to the reports that name
+            them below; the rest are ignored.
+
+            Every response carries `_meta` alongside the report's own keys: the store,
+            its CURRENCY and TIMEZONE, the exact window, when it was generated, and a
+            "Generated from Kurumera" source line. Quote the currency whenever you
+            quote a figure — "16,084" on its own is not a fact anybody can check.
+
+            `compare=True` adds `_meta.comparison`: the same report over the span of
+            equal length immediately before, so a week can be read against the week
+            before it. Refused for inventory_valuation, live_snapshot and rfm, which
+            describe a moment rather than a span.
+
+            Reports that STATE MONEY — sales_breakdown, financial_summary, tax,
+            refunds, inventory_valuation, pos_till, branch_sales — need `read_orders`
+            as well as `read_analytics`. Trading reports (summary, sales,
+            revenue_by_day, top_products) need only the latter. Each money report
+            returns a `definitions` block saying what its figures mean; quote the
+            definition alongside the number.
+
+            Customer identities are REDACTED unless you also hold the `read_customers`
+            capability: names become "Customer 1", contact details are emptied, and
+            every aggregate — spend, order counts, segments, scores — is untouched.
+            `_meta.redaction` says which happened (`identities`, `none`, or
+            `not_applicable`). Do not present a redacted name as if it were real.
+
+            `render='evidence'` draws the same chart with the store, the exact window,
+            the timezone, the currency, the generation time and the traceable reference
+            stamped ON the image — for an audit or a file, where the chart is handed
+            over on its own and its context cannot live in a response somebody else is
+            holding.
+
+            `render='svg'` adds `chart`: the same numbers drawn as a 1920×1080 SVG,
+            sized and labelled for a 16:9 slide and carrying its own period and
+            currency caption. `theme='dark'` draws it for a dark deck. The SVG IS the
+            editable artefact — open it in any vector tool, or restyle it from the
+            structured data returned beside it. Only reports with a real chart form
+            render: sales, revenue_by_day, orders_by_day, product_performance,
+            top_products and summary. Anything else is refused rather than forced into
+            a shape it does not have.
+
+            report:
+              summary               Revenue, orders, AOV, new customers.
+              sales                 Revenue/orders over time. Set group_by=day|week|month.
+              orders_by_day         Daily order counts.
+              revenue_by_day        Daily revenue totals.
+              top_products          Best sellers by units. Set limit.
+              product_performance   Units/revenue/orders. Set limit, and
+                                    group_by=product|variant|category. `variant`
+                                    answers which SIZE sells, which the product row
+                                    averages away. No margin column: unit costs are
+                                    recorded on under 1% of line items, so one would
+                                    be null for almost every row.
+              sales_breakdown       Gross → discounts → refunds → NET SALES, plus tax,
+                                    shipping and total charged. Every definition is in
+                                    the response; tax and shipping are stated BESIDE
+                                    net sales, never inside it. Check `reconciles`
+                                    before quoting the figures.
+              financial_summary     Financial + fulfillment status breakdown.
+              tax                   Tax collected.
+              refunds               Refunds issued.
+              inventory_valuation   Stock valuation at cost and retail. No window.
+              live_snapshot         Active visitors, recent events, live orders. No window.
+              traffic               Sessions / pageviews / visitors trend.
+              acquisition           Referrers / channels / UTM sources.
+              geography             Sales + sessions by country/city. Filter country=, city=.
+              behavior              Top pages, entry/exit, engagement. Set limit.
+              product_behavior      Per-product view to cart to purchase funnel. Set limit.
+              conversion_funnel     Storewide visit to view to cart to purchase.
+              checkout_funnel       Checkout steps started through completed.
+              customer_acquisition  New vs returning customers.
+              cohorts               Retention by first-order month. Set max_cohorts.
+              rfm                   RFM segments. No window.
+              search                Top on-site searches + no-results. Set limit.
+              branch_sales          Sales per branch. Filter location_id (see list_locations).
+              pos_till              POS takings by tender. Filter location_id.
+
+            Returns: JSON for the chosen report.
+
+        Omitted arguments are not sent; the store applies its own defaults: compare=False, days=30, group_by='day', limit=20, max_cohorts=12, theme='light'.
+        """
+        return self._invoke("get_report", {"report": report, "city": city, "compare": compare, "country": country, "date_from": date_from, "date_to": date_to, "days": days, "group_by": group_by, "limit": limit, "location_id": location_id, "max_cohorts": max_cohorts, "render": render, "theme": theme})

kurumera/_generated/blog_tools.py

@@ -0,0 +1,100 @@
+"""
+GENERATED by `python manage.py generate_python_sdk`. Do not edit.
+
+Tools from mcp_server/tools/blog_tools.py.
+"""
+from __future__ import annotations
+
+from typing import Any, TypeVar
+
+from ..types import UNSET, _Unset
+from . import _ToolBase
+
+R = TypeVar("R")
+
+
+class BlogTools(_ToolBase[R]):
+    def create_article(self, blog_id: str, title: str, *, author_name: str | _Unset = UNSET, body_html: str | _Unset = UNSET, canonical_url: str | _Unset = UNSET, handle: str | _Unset = UNSET, image_alt: str | _Unset = UNSET, image_url: str | _Unset = UNSET, noindex: bool | _Unset = UNSET, published: bool | _Unset = UNSET, seo_description: str | _Unset = UNSET, seo_title: str | _Unset = UNSET, summary_html: str | _Unset = UNSET, tags: list[Any] | _Unset = UNSET) -> R:
+        """
+        Not idempotent - repeating it may act twice.
+
+        Write a blog article and optionally publish it.
+
+            Args:
+                blog_id:      UUID or handle of the blog to post in (required).
+                title:        Article title (required).
+                body_html:    Full article body (HTML — sanitized on save).
+                summary_html: Optional excerpt/teaser HTML (auto-generated from the body
+                              if left blank).
+                author_name:  Display author name.
+                tags:         List of tag strings.
+                handle:       URL slug (`…/blog/<blog>/<handle>`). Auto-generated from the
+                              title + de-duplicated within the blog if omitted.
+                image_url / image_alt:     Featured / social-share image + alt text.
+                seo_title / seo_description: Meta title (≤ 70) + description (≤ 320).
+                canonical_url: Absolute canonical URL (leave blank normally).
+                noindex:       True to hide from search engines.
+                published:     True to publish now, False to save as a draft (default).
+
+            Returns:
+                The created article.
+
+        Omitted arguments are not sent; the store applies its own defaults: noindex=False, published=False.
+        """
+        return self._invoke("create_article", {"blog_id": blog_id, "title": title, "author_name": author_name, "body_html": body_html, "canonical_url": canonical_url, "handle": handle, "image_alt": image_alt, "image_url": image_url, "noindex": noindex, "published": published, "seo_description": seo_description, "seo_title": seo_title, "summary_html": summary_html, "tags": tags})
+
+    def create_blog(self, title: str, *, commentable: str | _Unset = UNSET, feedburner_url: str | _Unset = UNSET, handle: str | _Unset = UNSET, seo_description: str | _Unset = UNSET, seo_title: str | _Unset = UNSET, template_suffix: str | _Unset = UNSET) -> R:
+        """
+        Not idempotent - repeating it may act twice.
+
+        Create a new blog container.
+
+            Args:
+                title:           Blog name (required), e.g. 'Plant Care Guides'.
+                handle:          URL slug (`…/blog/<handle>`). Auto-generated from the
+                                 title and de-duplicated if omitted or already taken.
+                commentable:     'NO' (default) | 'MODERATE' | 'YES'.
+                seo_title:       Meta title (≤ 70 chars).
+                seo_description: Meta description (≤ 320 chars).
+                feedburner_url:  Optional RSS/FeedBurner URL.
+                template_suffix: Optional storefront template suffix.
+
+            Returns:
+                The created blog.
+
+        Omitted arguments are not sent; the store applies its own defaults: commentable='NO'.
+        """
+        return self._invoke("create_blog", {"title": title, "commentable": commentable, "feedburner_url": feedburner_url, "handle": handle, "seo_description": seo_description, "seo_title": seo_title, "template_suffix": template_suffix})
+
+    def update_article(self, article_id: str, *, author_name: str | _Unset = UNSET, blog_id: str | _Unset = UNSET, body_html: str | _Unset = UNSET, canonical_url: str | _Unset = UNSET, handle: str | _Unset = UNSET, image_alt: str | _Unset = UNSET, image_url: str | _Unset = UNSET, noindex: bool | _Unset = UNSET, published: bool | _Unset = UNSET, seo_description: str | _Unset = UNSET, seo_title: str | _Unset = UNSET, summary_html: str | _Unset = UNSET, tags: list[Any] | _Unset = UNSET, title: str | _Unset = UNSET) -> R:
+        """
+        Update an article. Any argument left as None is unchanged.
+
+            Args:
+                article_id: UUID of the article (must belong to your tenant).
+                blog_id:    Move the article to a different blog (UUID or handle).
+                handle:     New URL slug — slugified + de-duplicated within the blog.
+                published:  True to publish, False to revert to a draft.
+                (other args mirror create_article; body_html/summary_html are sanitized.)
+
+            Returns:
+                The updated article.
+        """
+        return self._invoke("update_article", {"article_id": article_id, "author_name": author_name, "blog_id": blog_id, "body_html": body_html, "canonical_url": canonical_url, "handle": handle, "image_alt": image_alt, "image_url": image_url, "noindex": noindex, "published": published, "seo_description": seo_description, "seo_title": seo_title, "summary_html": summary_html, "tags": tags, "title": title})
+
+    def update_blog(self, blog_id: str, *, commentable: str | _Unset = UNSET, feedburner_url: str | _Unset = UNSET, handle: str | _Unset = UNSET, seo_description: str | _Unset = UNSET, seo_title: str | _Unset = UNSET, template_suffix: str | _Unset = UNSET, title: str | _Unset = UNSET) -> R:
+        """
+        Update a blog. Any argument left as None is unchanged.
+
+            Args:
+                blog_id:     UUID or handle of the blog (must belong to your tenant).
+                handle:      New URL slug — slugified + de-duplicated. NOTE: changing a
+                             blog handle changes its public URL and does NOT auto-create
+                             a redirect, so only rename handles for blogs with no traffic.
+                commentable: 'NO' | 'MODERATE' | 'YES'.
+                (other args mirror create_blog.)
+
+            Returns:
+                The updated blog.
+        """
+        return self._invoke("update_blog", {"blog_id": blog_id, "commentable": commentable, "feedburner_url": feedburner_url, "handle": handle, "seo_description": seo_description, "seo_title": seo_title, "template_suffix": template_suffix, "title": title})

kurumera/_generated/branch_tools.py

@@ -0,0 +1,91 @@
+"""
+GENERATED by `python manage.py generate_python_sdk`. Do not edit.
+
+Tools from mcp_server/tools/branch_tools.py.
+"""
+from __future__ import annotations
+
+from typing import Any, TypeVar
+
+from ..types import UNSET, _Unset
+from . import _ToolBase
+
+R = TypeVar("R")
+
+
+class BranchTools(_ToolBase[R]):
+    def create_branch(self, name: str, *, address: dict[str, Any] | _Unset = UNSET, confirm: bool | _Unset = UNSET, fulfills_online_orders: bool | _Unset = UNSET, is_pos_branch: bool | _Unset = UNSET) -> R:
+        """
+        Requires confirm=True.
+        Not idempotent - repeating it may act twice.
+
+        Create a new branch/location (a shop or warehouse). is_pos_branch=True
+            makes it a physical sales branch that can run a POS counter; set
+            fulfills_online_orders=True if it should also ship web orders. Structural
+            change — requires confirm=True after the user approves.
+
+        Omitted arguments are not sent; the store applies its own defaults: confirm=False, fulfills_online_orders=False, is_pos_branch=True.
+        """
+        return self._invoke("create_branch", {"name": name, "address": address, "confirm": confirm, "fulfills_online_orders": fulfills_online_orders, "is_pos_branch": is_pos_branch})
+
+    def create_staff_member(self, email: str, *, branch_ids: list[Any] | _Unset = UNSET, confirm: bool | _Unset = UNSET, first_name: str | _Unset = UNSET, last_name: str | _Unset = UNSET, permissions: list[Any] | _Unset = UNSET, role_id: str | _Unset = UNSET) -> R:
+        """
+        Requires confirm=True.
+        Reaches outside the store (sends mail, calls a gateway, publishes).
+        Not idempotent - repeating it may act twice.
+
+        Invite a staff member (e.g. a branch manager): creates an inactive
+            account and emails them a set-password link (or promotes an existing
+            customer account in place). `branch_ids` scopes them to those branches
+            (empty = all branches); `permissions` grants capabilities such as
+            read_orders/write_orders/read_pos (see the store's roles for examples).
+            Grants access to the store — requires confirm=True after the user approves.
+
+        Omitted arguments are not sent; the store applies its own defaults: confirm=False.
+        """
+        return self._invoke("create_staff_member", {"email": email, "branch_ids": branch_ids, "confirm": confirm, "first_name": first_name, "last_name": last_name, "permissions": permissions, "role_id": role_id})
+
+    def list_staff(self) -> R:
+        """
+        Read-only.
+
+        List this store's staff members with their role, per-user capabilities and
+            assigned branches (empty branch list = all branches / head-office access).
+            Call this before set_staff_access to find the right user_id.
+        """
+        return self._invoke("list_staff", {})
+
+    def set_staff_access(self, user_id: str, *, branch_ids: list[Any] | _Unset = UNSET, confirm: bool | _Unset = UNSET, permissions: list[Any] | _Unset = UNSET, role_id: str | _Unset = UNSET) -> R:
+        """
+        DESTRUCTIVE - removes, overwrites or makes something irreversibly live.
+        Requires confirm=True.
+
+        Change a staff member's access: which branches they cover (empty list =
+            all branches), their per-user capabilities, and/or their role — e.g. make
+            someone the manager of a branch. Only the fields you pass change; the
+            others are left as they are. Changes what this person can do — requires
+            confirm=True after the user approves.
+
+        Omitted arguments are not sent; the store applies its own defaults: confirm=False.
+        """
+        return self._invoke("set_staff_access", {"user_id": user_id, "branch_ids": branch_ids, "confirm": confirm, "permissions": permissions, "role_id": role_id})
+
+    def transfer_stock(self, from_location_id: str, to_location_id: str, lines: list[Any], *, confirm: bool | _Unset = UNSET, note: str | _Unset = UNSET, reason: str | _Unset = UNSET, reference_document_uri: str | _Unset = UNSET) -> R:
+        """
+        Requires confirm=True.
+        Not idempotent - repeating it may act twice.
+
+        Move stock between branches. `lines` is a list of
+            {"variant_id": "<uuid>", "quantity": <int>} (max 100). All-or-nothing: any
+            under-stocked line rolls the whole transfer back. Physically relocates
+            inventory — requires confirm=True after the user approves the summary.
+            Use list_locations for branch ids and get_inventory_levels for stock.
+            `note` is free text kept on every line's ledger entry ("restocking Gulberg
+            before Eid"): the reason says what kind of movement this is, the note says
+            why this one happened. `reference_document_uri` is an optional http/https
+            link to the paperwork (a transfer note, a signed handover) kept on both
+            legs of every line.
+
+        Omitted arguments are not sent; the store applies its own defaults: confirm=False, reason='transfer'.
+        """
+        return self._invoke("transfer_stock", {"from_location_id": from_location_id, "to_location_id": to_location_id, "lines": lines, "confirm": confirm, "note": note, "reason": reason, "reference_document_uri": reference_document_uri})