Twelfth

Compare a supplier's latest two saved offer files: restocks, depletions, cost, availability, ETA and terms changes, new and missing lines. Use it for what-changed questions about a supplier's offers. It never proves a discontinuation from sparse snapshots; for past buying decisions use recall_decisions.

Find other lines in the open task in the same category as a named product. Use it for substitutes and alternatives among the lines in front of the buyer; to search the whole catalogue use search_catalogue with the category.

Resolve a supplier name, fragment or acronym to the workspace's suppliers, with catalogue-product and open-recommendation counts. Use it before filtering by supplier, or with no query and order_by open_recommendations to rank suppliers by what awaits action. For a supplier's products use search_catalogue.

Read competitor-match fields carried on the open task's lines. Use it only for a competitor question about those lines; for every measure on one line use get_entity_profile. For tracked competitor prices across the range use price_intel_lookup or twelfth_compare_pricing_skus when offered.

Read why Twelfth currently recommends what it does for a named product or supplier: the rationale, supporting facts, rule meaning and provenance. Use it for why-this-quantity or why-this-price questions. It reads current recommendations only and returns no raw measures: for those use get_entity_profile, and for past decisions use recall_decisions.

Read every measure the open task holds for one named product, brand, supplier or category (product rows, commercial measures and evidence) in one call. Use it first when a question names something. For one measure across all the open lines use get_sales_metrics (sales), get_inventory_position (stock) or get_product_master (price, cost, lifecycle); for why Twelfth recommends what it does use get_entity_context; for anything outside the open task use search_catalogue.

Read stock on hand and cover per product across the lines in the open task. No outlet split and no aggregation. Use it for stock and replenishment across those lines; for one named product use get_entity_profile, and for stock across the whole range use twelfth_list_products, sorted by stock or cover.

Retrieve category-management playbook principles for a situation such as supply disruption, slow sales, stock pressure, competitor moves, ranging or pricing. Use it to ground advice in the methodology after reading the data. It returns principles, not workspace figures; for those use get_entity_profile or twelfth_list_products.

Read trading, promotion or custom calendar entries for one remit in a date window, with each calendar's id, source and revision. Use it for key dates, promotions, holidays and trading periods, and to turn a named season into dates before calling recall_decisions.

Read price, cost, margin and lifecycle fields for the lines in the open task, filtered by name, category or supplier (filters combine with AND). Use it for product details on those lines; for sales use get_sales_metrics, for stock get_inventory_position, and for every measure on one named product get_entity_profile. A product not found here may still be stocked, so check search_catalogue before saying it is not.

Rank the open task's lines in one named category or supplier by revenue or units, highest first. Use it to compare rate of sale within that group. It refuses an unfiltered ranking, because the top of the open lines is not the top of the business; use twelfth_list_products sorted by units_l4w for that.

Read one project as it stands: workflow stage, scope, owner, open tasks, documents, artefacts and recent activity. Use it for where a piece of work is up to and who holds it; to find the project's id use twelfth_list_projects.

Read revenue, units and margin per product across the lines in the open task. One precomputed figure per product: no date series, period comparison or whole-business total. Use it to compare sales across those lines; for every measure on one named product, brand or supplier use get_entity_profile, and for products outside the open lines use twelfth_list_products.

Read a named supplier's lines in the open task (or every line) with the supply constraints and stock each carries: lead time, carton quantity, on order and stock on hand where the task holds them, plus cost and margin. A missing field means the task does not carry it, not that the supplier has none. Use it for lead-time, pack-size and inventory-capital questions about those lines. To resolve a supplier name use find_supplier; for changes in their offers use compare_supplier_offer_history.

Read one page (up to 24,000 characters) of a document shared with the workspace, with its page count. Use it when the answer is in a shared sheet or doc; get the document's id from list_documents (or a project's documents in get_project). To find how Twelfth itself works use search_docs instead.

Search every product in the workspace's readable catalogue by text, supplier or category, optionally only those with an open recommendation. Use it whenever a product, brand, barcode or supplier is named and you need to know whether and where it is stocked. Pass up to 100 exact identifiers in ids (SKU, PLU, supplier or manufacturer SKU, or the product's own store page URL) to resolve a list in one call; each comes back matched or in not_found. Overly broad identifier results fail explicitly; use fewer or more specific ids. For figures on the results use twelfth_list_products; to resolve a supplier's exact name first use find_supplier.

Search Twelfth's product documentation for how a page, control or setting works, returning matching sections with links. Use it before saying Twelfth cannot do something. An empty result means the docs do not describe it, not that the product lacks it. For documents the workspace shared use read_document.

Read stored preference values and the keys this connection may read at user, organization or membership scope. Use it for defaults such as cover targets and display choices. For Twelfth staff with workspace owner/admin access, organization scope also returns the managed chat runtime policy and available models. Those staff with Allow changes can use twelfth_update_agent_policy for runtime settings; settings that twelfth_update_settings can change carry updateWith, and twelfth_get_settings reads them with their revision. Integrations and category remits have their own tools (twelfth_list_integration_guides, twelfth_list_category_settings); personal and membership scopes need a person's OAuth connection.

Get the connected workspace's name, slug, timezone, currency, country, own store website domain and data rules: how this workspace's source data must be read (which field is the sales channel, which source fields mean something other than their name). Call it first so dates, money and data are read in the workspace's own terms, and follow its data rules in every query; for people use twelfth_list_workspace_members.

Read managed categories, their aliases and which remit owns each, narrowed to this connection's readable remits, 50 per page with total and hasMore. Use it to map category names and find category IDs for twelfth_list_products filters; pass query to find one category by name or alias. Changing categories is owner/admin-only in the app.

See which data and chat integrations this workspace has connected, what each provides, and the Twelfth page where a person can connect or configure it. Use it to answer what is connected or how to connect something. It never starts OAuth or changes a connection; for stored workspace defaults use twelfth_get_preferences.

List up to 100 open actions visible to this connection, soonest due first, with assignee, remit and the source each came from. Use it for what is due or overdue; for project-level progress use twelfth_list_projects.

Page through every product in this connection's readable remits with current stock, velocity, cover, sales, GP%, price, supplier, category and open finding count; an unmeasured figure is null. Use it for figures across the whole range, sorted or filtered. To find a product by name first, search_catalogue is lighter.

List the workspace's projects visible to this connection, with workflow, stage, owner, open and overdue task counts. Use it to find a project or see what is in flight; for one project's tasks, documents and activity use get_project with its id.

List the project workflows this workspace offers, with their stages, availability and how many projects run on each. Use it to explain what kinds of project exist; for actual projects use twelfth_list_projects.

List up to 100 people in the connected workspace with their email and role. Use it to resolve an owner or assignee by name; for what each person has open use twelfth_list_open_actions.