aimeat 2.1.0 → 2.3.0

package/dist/src/models/app-tool-schemas.js

@@ -11,6 +11,18 @@
  *   const rec = await storage.getMemory(sellerGhii, appToolsKey(appId));
  *   const doc = AppToolsDocSchema.parse(rec.value);
  * @version-history
+ *   v1.6.0 — 2026-07-28 — `lockedInput` + applyLockedInput: a tool fixes the parameter that tells it
+ *     apart from its neighbour, so two products stop being one call the caller can steer.
+ *   v1.5.0 — 2026-07-28 — `isToolPriced`: one definition of whether a tool carries a price. There were
+ *     two and they disagreed about `pricesMoney`, which let a USD-only tool invoke free.
+ *   v1.4.0 — 2026-07-25 — `tollMorsels`: a tool declares its own pacing burn, so a node default of 0
+ *     means "paced only where a provider asked for it" instead of "never paced".
+ *   v1.4.0 — 2026-07-25 — ODPS: per-tool `provenance` + `odps` (the authoring block projected into the
+ *     tool's ODPS v4.1 document) and APP-LEVEL defaults of both on the manifest root, inherited by every
+ *     tool. Additive; existing manifests validate unchanged.
+ *   v1.3.0 — 2026-07-25 — TARGET-050: the manifest becomes the SOURCE OF TRUTH for the EXCHANGE listing —
+ *     `exchange` (list publicly), `pricesMoney` (EUR *and* USD on one tool) and `usageTerms` (the licence,
+ *     so listing needs no second authoring step). All additive; existing manifests validate unchanged.
  *   v1.2.0 — 2026-07-21 — EXCHANGE cross-app selling (Gap 1): optional `outputSchema` (mandatory to LIST an
  *     app-tool offering — the legibility gate) + `plans` (per_call/bundle/subscription volume pricing).
  *   v1.1.0 — 2026-07-14 — Task path (phase B): optional `agent` (task assignee); tools without an
@@ -19,6 +31,7 @@
  */
 import { z } from 'zod';
 import { MONEY_CURRENCIES } from '../commerce/money.js';
+import { ProvenanceSchema, OdpsExtrasSchema } from './odps-schemas.js';
 /** A provider pricing plan on a sellable tool — mirrors exchange-market OfferingPlan so a tool can carry
  *  per-call / volume-bundle / subscription pricing surfaced on its EXCHANGE offering. */
 export const AppToolPlanSchema = z.discriminatedUnion('model', [
@@ -49,11 +62,30 @@ export const AppToolSchema = z.object({
      * TASK (phase B) — assigned to `agent`, or to the app owner's GHII when no agent is named.
      */
     action_id: z.string().max(200).optional(),
+    /**
+     * Input this tool FIXES, which the caller cannot override. Merged over whatever they send.
+     *
+     * One capability often serves several products, told apart by a parameter. Measured on production:
+     * `search` (0.01 EUR) and `budget-leads` (0.05 EUR) both bind `ext:kaiku-signals:search`, and the
+     * only thing between them is a `category` field the manifest DOCUMENTS as "Set to budget." while
+     * the caller supplies it. So a buyer of the cheap product could send `category: budget` and receive
+     * the expensive one, and a buyer of the expensive one who forgot it paid 5x for the cheap answer.
+     * A price gate cannot catch that: it charges correctly for the contract taken and the extension
+     * decides what comes back. Pinning the discriminator is what makes two products two calls.
+     */
+    lockedInput: z.record(z.string(), z.unknown()).optional(),
     /**
      * Task-path assignee (phase B): the bare name of the app owner's agent that receives the
      * fulfillment TASK when the tool has no action_id binding. Ignored for callable tools.
      */
     agent: z.string().max(100).optional(),
+    /**
+     * Morsels burned per call to bound the RATE this tool can be consumed at — a brake, never revenue
+     * (invariant M1: the burn is not credited to anyone). Independent of `price`/`priceMoney`: a tool sold
+     * for money is still paced when this is set, which is the only way a money-priced capability gets a
+     * ceiling that a budget alone cannot give it. Absent = the node's default (shipped at 0).
+     */
+    tollMorsels: z.number().int().min(0).max(100).optional(),
     /** Morsel price per call. Absent/0 = not for sale cross-owner in morsels. */
     price: z.object({
         morsels: z.number().int().nonnegative(),
@@ -64,13 +96,77 @@ export const AppToolSchema = z.object({
         amount: z.number().int().positive(),
         currency: z.enum(MONEY_CURRENCIES),
     }).nullable().optional(),
+    /**
+     * Additional money prices, one per currency (TARGET-050) — lets one tool be bought in EUR *and* USD.
+     * `priceMoney` stays the primary (every existing reader keeps working unchanged); `pricesMoney` is the
+     * full set the EXCHANGE projection lists from. Writers keep `priceMoney` equal to the first entry.
+     */
+    pricesMoney: z.array(z.object({
+        amount: z.number().int().positive(),
+        currency: z.enum(MONEY_CURRENCIES),
+    })).max(MONEY_CURRENCIES.length).optional(),
+    /**
+     * List this tool publicly on EXCHANGE (TARGET-050). The manifest is the SOURCE OF TRUTH for the
+     * marketplace listing: flag on + a price → the tool is projected onto the market and its price/labels
+     * track this manifest; flag off → the projected listing is delisted. Existing CONTRACTS are never
+     * affected — they stay pinned to the interface version and price they were signed at.
+     */
+    exchange: z.boolean().optional(),
+    /** Usage licence surfaced on the projected offering (mandatory to list — the legibility gate). */
+    usageTerms: z.object({
+        derivatives: z.boolean().optional(),
+        resale: z.boolean().optional(),
+        attribution: z.boolean().optional(),
+        note: z.string().max(500).optional(),
+    }).optional(),
+    /** Provenance attestation carried onto the projected offering + its ODPS document. */
+    provenance: ProvenanceSchema.optional(),
+    /** ODPS v4.1 fields the node cannot derive (value proposition, SLA/quality commitments, data holder…). */
+    odps: OdpsExtrasSchema.optional(),
 });
-/** The `apps.{appId}.tools` record body. */
+/**
+ * The `apps.{appId}.tools` record body. `odps`/`provenance` at THIS level are the app's defaults —
+ * the company-and-brand half of an ODPS descriptor (data holder, logo, governance profile, jurisdiction,
+ * provenance of the app's data) that is the same for every tool the app sells. A tool inherits them and
+ * overrides field by field, so a Y-tunnus is typed once per app rather than once per capability.
+ */
 export const AppToolsDocSchema = z.object({
     version: z.number().int().nonnegative().optional(),
     updatedAt: z.string().max(40).optional(),
+    /** App-level ODPS defaults inherited by every tool (overridable per tool). */
+    odps: OdpsExtrasSchema.optional(),
+    /** App-level provenance attestation inherited by every tool (overridable per tool). */
+    provenance: ProvenanceSchema.optional(),
     tools: z.array(AppToolSchema).max(40),
 });
 /** The memory key an app's tool manifest lives under (PUBLIC record, app owner's GHII). */
 export const appToolsKey = (appId) => `apps.${appId}.tools`;
+/** The app id back out of that key, or null when the key is not a tool manifest. */
+export const appIdFromToolsKey = (key) => {
+    const m = /^apps\.(.+)\.tools$/.exec(key);
+    return m ? m[1] : null;
+};
+/**
+ * Does this tool carry a price, in ANY of the three places a manifest may state one?
+ *
+ * One definition, because there were two and they disagreed: the app-tool route ignored `pricesMoney`,
+ * so a tool sold only in USD reached the free invoke path and was then billed in morsels against an
+ * unrelated contract. "Is this priced" is a property of the manifest, so it belongs beside the schema
+ * rather than in each route that happens to ask.
+ */
+/**
+ * The input a tool actually runs with: what the caller sent, with the tool's own fixed fields laid
+ * over the top. Locked LAST on purpose — a caller must not be able to talk their way into a
+ * neighbouring product by sending the field themselves.
+ */
+export function applyLockedInput(tool, input) {
+    return tool.lockedInput ? { ...input, ...tool.lockedInput } : input;
+}
+export function isToolPriced(t) {
+    if (t.price && typeof t.price.morsels === 'number' && t.price.morsels > 0)
+        return true;
+    if (t.priceMoney && typeof t.priceMoney.amount === 'number' && t.priceMoney.amount > 0)
+        return true;
+    return (t.pricesMoney ?? []).some(m => typeof m?.amount === 'number' && m.amount > 0);
+}
 //# sourceMappingURL=app-tool-schemas.js.map

package/dist/src/models/app-tool-schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-tool-schemas.js","sourceRoot":"","sources":["../../../src/models/app-tool-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD;yFACyF;AACzF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,kBAAkB,CAAC,OAAO,EAAE;IAC7D,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;IACzE,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC;IACxJ,CAAC,CAAC,MAAM,CAAC;QACP,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC;QAC/D,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;QACpF,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;KACxF,CAAC;CACH,CAAC,CAAC;AAEH,oDAAoD;AACpD,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,sFAAsF;IACtF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,yBAAyB,EAAE,wCAAwC,CAAC;IAC1G,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IAC3C,oFAAoF;IACpF,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;IACzD;6GACyG;IACzG,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC1D;2GACuG;IACvG,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpD;;;;OAIG;IACH,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IACzC;;;OAGG;IACH,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IACrC,6EAA6E;IAC7E,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;QACvC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;KACpC,CAAC,CAAC,QAAQ,EAAE;IACb,4FAA4F;IAC5F,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;QACnB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;QACnC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC;KACnC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CACzB,CAAC,CAAC;AAEH,4CAA4C;AAC5C,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IAClD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IACxC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;CACtC,CAAC,CAAC;AAKH,2FAA2F;AAC3F,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC,QAAQ,KAAK,QAAQ,CAAC"}
+{"version":3,"file":"app-tool-schemas.js","sourceRoot":"","sources":["../../../src/models/app-tool-schemas.ts"],"names":[],"mappings":"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"}

package/dist/src/models/odps-schemas.d.ts

@@ -0,0 +1,305 @@
+/**
+ * @file src/models/odps-schemas.ts
+ * @description The ODPS (Open Data Product Specification, Linux Foundation) authoring contract for an
+ *   EXCHANGE offering. AIMEAT derives most of an ODPS v4.1 document from what the node already knows
+ *   (title, price, plans, licence, provider, observed usage — see services/exchange-odps.ts); these are the
+ *   fields ODPS defines that the node CANNOT derive and a provider may therefore declare on the listing:
+ *   the product framing (value proposition, categories, standards, use cases, sample), the SLA + data-quality
+ *   COMMITMENTS (objectives, which are promises no observation can substitute for), and the legal data holder.
+ *   Everything here is optional — an offering without it still projects a valid ODPS v4.1 document.
+ *   PROVENANCE lives here too: the provider's attestation about where the data came from, on what legal
+ *   basis, how long it is kept, and (for derived data) the upstream lineage it was built from.
+ * @structure ODPS enums (product type · SLA/DQ dimensions + units) · ProvenanceSchema · OdpsExtrasSchema ·
+ *   inferred types (Provenance · OdpsExtras · OdpsSlaDimension · OdpsQualityDimension · OdpsDataHolder)
+ * @usage
+ *   const parsed = OdpsExtrasSchema.safeParse(req.body.odps);
+ *   if (!parsed.success) return res.status(400).json(error(nodeId, 'INVALID_ODPS', parsed.error.message));
+ * @version-history
+ *   v1.1.0 — 2026-07-25 — Pinned to ODPS v4.1 (the version the addendum's Q2 named): `language` (v4.1
+ *     keys details + pricing by ISO 639-1 code), `governanceProfile`, `portfolioPriority`, TOON format.
+ *   v1.0.0 — 2026-07-25 — Initial ODPS authoring contract + provenance attestation (TARGET-045 §4,
+ *     addendum Q2/Q3): closes the drift where `odpsVersion` was declared but never written.
+ */
+import { z } from 'zod';
+/** ODPS v4.1 `product.details.type` — what KIND of data product this is. */
+export declare const ODPS_PRODUCT_TYPES: readonly ["raw data", "derived data", "dataset", "reports", "analytic view", "3D visualisation", "algorithm", "decision support", "automated decision-making", "data-enhanced product", "data-driven service", "data-enabled performance", "bi-directional"];
+/** ODPS v4.1 SLA dimensions (`product.SLA.declarative[].dimensions[].dimension`). */
+export declare const ODPS_SLA_DIMENSIONS: readonly ["latency", "uptime", "responseTime", "errorRate", "endOfSupport", "endOfLife", "updateFrequency", "timeToDetect", "timeToNotify", "timeToRepair", "emailResponseTime"];
+/** ODPS v4.1 SLA objective units. */
+export declare const ODPS_SLA_UNITS: readonly ["percent", "milliseconds", "seconds", "minutes", "days", "weeks", "months", "years", "never", "date", "null"];
+/** ODPS v4.1 data-quality dimensions. */
+export declare const ODPS_QUALITY_DIMENSIONS: readonly ["accuracy", "completeness", "conformity", "consistency", "coverage", "timeliness", "validity", "uniqueness"];
+/** ODPS v4.1 output file formats a data product can be delivered in (v4.1 adds TOON). */
+export declare const ODPS_OUTPUT_FORMATS: readonly ["TOON", "JSON", "XML", "CSV", "Excel", "zip", "plain text", "GraphQL", "MCP"];
+/** ODPS v4.1 `details.governanceProfile` — how strictly the product is governed. */
+export declare const ODPS_GOVERNANCE_PROFILES: readonly ["structured", "enforced", "automated", "audit_ready"];
+/** ODPS v4.1 `details.portfolioPriority` — how important the product is in its owner's portfolio. */
+export declare const ODPS_PORTFOLIO_PRIORITIES: readonly ["critical", "high", "medium", "low"];
+/** One hop of upstream lineage for DERIVED data — where a component came from and what was done to it. */
+export declare const ProvenanceLineageHopSchema: z.ZodObject<{
+    source: z.ZodString;
+    transform: z.ZodOptional<z.ZodString>;
+    at: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * The provider's provenance attestation. A PROMISE by the provider, not a platform guarantee — but a
+ * structured, attributed one (the provider is a GHII/GAII/GEAI) that a buyer can hold them to. Maps onto
+ * ODPS `license.governance` + the AIMEAT extension block; absent provenance is legal, it just reads as
+ * "unstated" to every buyer looking at the listing.
+ */
+export declare const ProvenanceSchema: z.ZodObject<{
+    source: z.ZodOptional<z.ZodString>;
+    legalBasis: z.ZodOptional<z.ZodString>;
+    consentStatus: z.ZodOptional<z.ZodString>;
+    retention: z.ZodOptional<z.ZodString>;
+    transformations: z.ZodOptional<z.ZodString>;
+    snapshotHash: z.ZodOptional<z.ZodString>;
+    lineage: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        source: z.ZodString;
+        transform: z.ZodOptional<z.ZodString>;
+        at: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    odpsVersion: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** An SLA COMMITMENT on the offering (what the provider promises, as opposed to what the node observed). */
+export declare const OdpsSlaDimensionSchema: z.ZodObject<{
+    dimension: z.ZodEnum<{
+        latency: "latency";
+        uptime: "uptime";
+        responseTime: "responseTime";
+        errorRate: "errorRate";
+        endOfSupport: "endOfSupport";
+        endOfLife: "endOfLife";
+        updateFrequency: "updateFrequency";
+        timeToDetect: "timeToDetect";
+        timeToNotify: "timeToNotify";
+        timeToRepair: "timeToRepair";
+        emailResponseTime: "emailResponseTime";
+    }>;
+    objective: z.ZodNumber;
+    unit: z.ZodEnum<{
+        percent: "percent";
+        milliseconds: "milliseconds";
+        seconds: "seconds";
+        minutes: "minutes";
+        days: "days";
+        weeks: "weeks";
+        months: "months";
+        years: "years";
+        never: "never";
+        date: "date";
+        null: "null";
+    }>;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** A data-quality COMMITMENT on the offering. */
+export declare const OdpsQualityDimensionSchema: z.ZodObject<{
+    dimension: z.ZodEnum<{
+        accuracy: "accuracy";
+        completeness: "completeness";
+        conformity: "conformity";
+        consistency: "consistency";
+        coverage: "coverage";
+        timeliness: "timeliness";
+        validity: "validity";
+        uniqueness: "uniqueness";
+    }>;
+    objective: z.ZodNumber;
+    unit: z.ZodEnum<{
+        number: "number";
+        percentage: "percentage";
+    }>;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** The legal entity behind the offering. AIMEAT knows the ACCOUNT (a GHII); only the provider knows the company. */
+export declare const OdpsDataHolderSchema: z.ZodObject<{
+    legalName: z.ZodString;
+    businessID: z.ZodOptional<z.ZodString>;
+    taxID: z.ZodOptional<z.ZodString>;
+    vatID: z.ZodOptional<z.ZodString>;
+    email: z.ZodOptional<z.ZodString>;
+    URL: z.ZodOptional<z.ZodString>;
+    telephone: z.ZodOptional<z.ZodString>;
+    contactName: z.ZodOptional<z.ZodString>;
+    addressRegion: z.ZodOptional<z.ZodString>;
+    businessDomain: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    addressCountry: z.ZodOptional<z.ZodString>;
+    addressLocality: z.ZodOptional<z.ZodString>;
+    postalCode: z.ZodOptional<z.ZodString>;
+    streetAddress: z.ZodOptional<z.ZodString>;
+    logoURL: z.ZodOptional<z.ZodString>;
+    slogan: z.ZodOptional<z.ZodString>;
+    parentOrganization: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Licence terms ODPS carries that AIMEAT's three-flag `usageTerms` does not (jurisdiction, exclusivity, exit). */
+export declare const OdpsLicenseExtrasSchema: z.ZodObject<{
+    geographicalArea: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    permanent: z.ZodOptional<z.ZodBoolean>;
+    exclusive: z.ZodOptional<z.ZodBoolean>;
+    restrictions: z.ZodOptional<z.ZodString>;
+    applicableLaws: z.ZodOptional<z.ZodString>;
+    warranties: z.ZodOptional<z.ZodString>;
+    damages: z.ZodOptional<z.ZodString>;
+    confidentiality: z.ZodOptional<z.ZodString>;
+    forceMajeure: z.ZodOptional<z.ZodString>;
+    terminationNoticePeriodDays: z.ZodOptional<z.ZodNumber>;
+    terminationConditions: z.ZodOptional<z.ZodString>;
+    continuityConditions: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Everything ODPS defines that the node cannot derive from the offering itself. All optional: a listing
+ * without any of it still projects a schema-valid ODPS v4.1 document, just a thinner one.
+ */
+export declare const OdpsExtrasSchema: z.ZodObject<{
+    language: z.ZodOptional<z.ZodString>;
+    productType: z.ZodOptional<z.ZodEnum<{
+        "raw data": "raw data";
+        "derived data": "derived data";
+        dataset: "dataset";
+        reports: "reports";
+        "analytic view": "analytic view";
+        "3D visualisation": "3D visualisation";
+        algorithm: "algorithm";
+        "decision support": "decision support";
+        "automated decision-making": "automated decision-making";
+        "data-enhanced product": "data-enhanced product";
+        "data-driven service": "data-driven service";
+        "data-enabled performance": "data-enabled performance";
+        "bi-directional": "bi-directional";
+    }>>;
+    governanceProfile: z.ZodOptional<z.ZodEnum<{
+        structured: "structured";
+        enforced: "enforced";
+        automated: "automated";
+        audit_ready: "audit_ready";
+    }>>;
+    portfolioPriority: z.ZodOptional<z.ZodEnum<{
+        critical: "critical";
+        high: "high";
+        medium: "medium";
+        low: "low";
+    }>>;
+    valueProposition: z.ZodOptional<z.ZodString>;
+    productSeries: z.ZodOptional<z.ZodString>;
+    categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    standards: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    useCases: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    outputFileFormats: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        TOON: "TOON";
+        JSON: "JSON";
+        XML: "XML";
+        CSV: "CSV";
+        Excel: "Excel";
+        zip: "zip";
+        "plain text": "plain text";
+        GraphQL: "GraphQL";
+        MCP: "MCP";
+    }>>>;
+    contentSample: z.ZodOptional<z.ZodString>;
+    logoURL: z.ZodOptional<z.ZodString>;
+    brandSlogan: z.ZodOptional<z.ZodString>;
+    productVersion: z.ZodOptional<z.ZodString>;
+    versionNotes: z.ZodOptional<z.ZodString>;
+    issues: z.ZodOptional<z.ZodString>;
+    documentationURL: z.ZodOptional<z.ZodString>;
+    supportEmail: z.ZodOptional<z.ZodString>;
+    supportHours: z.ZodOptional<z.ZodString>;
+    valueAddedTaxIncluded: z.ZodOptional<z.ZodBoolean>;
+    valueAddedTaxPercentage: z.ZodOptional<z.ZodNumber>;
+    recommendedDataProducts: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    sla: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        dimension: z.ZodEnum<{
+            latency: "latency";
+            uptime: "uptime";
+            responseTime: "responseTime";
+            errorRate: "errorRate";
+            endOfSupport: "endOfSupport";
+            endOfLife: "endOfLife";
+            updateFrequency: "updateFrequency";
+            timeToDetect: "timeToDetect";
+            timeToNotify: "timeToNotify";
+            timeToRepair: "timeToRepair";
+            emailResponseTime: "emailResponseTime";
+        }>;
+        objective: z.ZodNumber;
+        unit: z.ZodEnum<{
+            percent: "percent";
+            milliseconds: "milliseconds";
+            seconds: "seconds";
+            minutes: "minutes";
+            days: "days";
+            weeks: "weeks";
+            months: "months";
+            years: "years";
+            never: "never";
+            date: "date";
+            null: "null";
+        }>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    dataQuality: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        dimension: z.ZodEnum<{
+            accuracy: "accuracy";
+            completeness: "completeness";
+            conformity: "conformity";
+            consistency: "consistency";
+            coverage: "coverage";
+            timeliness: "timeliness";
+            validity: "validity";
+            uniqueness: "uniqueness";
+        }>;
+        objective: z.ZodNumber;
+        unit: z.ZodEnum<{
+            number: "number";
+            percentage: "percentage";
+        }>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    dataHolder: z.ZodOptional<z.ZodObject<{
+        legalName: z.ZodString;
+        businessID: z.ZodOptional<z.ZodString>;
+        taxID: z.ZodOptional<z.ZodString>;
+        vatID: z.ZodOptional<z.ZodString>;
+        email: z.ZodOptional<z.ZodString>;
+        URL: z.ZodOptional<z.ZodString>;
+        telephone: z.ZodOptional<z.ZodString>;
+        contactName: z.ZodOptional<z.ZodString>;
+        addressRegion: z.ZodOptional<z.ZodString>;
+        businessDomain: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        addressCountry: z.ZodOptional<z.ZodString>;
+        addressLocality: z.ZodOptional<z.ZodString>;
+        postalCode: z.ZodOptional<z.ZodString>;
+        streetAddress: z.ZodOptional<z.ZodString>;
+        logoURL: z.ZodOptional<z.ZodString>;
+        slogan: z.ZodOptional<z.ZodString>;
+        parentOrganization: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    license: z.ZodOptional<z.ZodObject<{
+        geographicalArea: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        permanent: z.ZodOptional<z.ZodBoolean>;
+        exclusive: z.ZodOptional<z.ZodBoolean>;
+        restrictions: z.ZodOptional<z.ZodString>;
+        applicableLaws: z.ZodOptional<z.ZodString>;
+        warranties: z.ZodOptional<z.ZodString>;
+        damages: z.ZodOptional<z.ZodString>;
+        confidentiality: z.ZodOptional<z.ZodString>;
+        forceMajeure: z.ZodOptional<z.ZodString>;
+        terminationNoticePeriodDays: z.ZodOptional<z.ZodNumber>;
+        terminationConditions: z.ZodOptional<z.ZodString>;
+        continuityConditions: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ProvenanceLineageHop = z.infer<typeof ProvenanceLineageHopSchema>;
+export type Provenance = z.infer<typeof ProvenanceSchema>;
+export type OdpsSlaDimension = z.infer<typeof OdpsSlaDimensionSchema>;
+export type OdpsQualityDimension = z.infer<typeof OdpsQualityDimensionSchema>;
+export type OdpsDataHolder = z.infer<typeof OdpsDataHolderSchema>;
+export type OdpsLicenseExtras = z.infer<typeof OdpsLicenseExtrasSchema>;
+export type OdpsExtras = z.infer<typeof OdpsExtrasSchema>;
+//# sourceMappingURL=odps-schemas.d.ts.map

package/dist/src/models/odps-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"odps-schemas.d.ts","sourceRoot":"","sources":["../../../src/models/odps-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB,8PAIrB,CAAC;AAEX,qFAAqF;AACrF,eAAO,MAAM,mBAAmB,kLAGtB,CAAC;AAEX,qCAAqC;AACrC,eAAO,MAAM,cAAc,yHAEjB,CAAC;AAEX,yCAAyC;AACzC,eAAO,MAAM,uBAAuB,wHAE1B,CAAC;AAEX,yFAAyF;AACzF,eAAO,MAAM,mBAAmB,yFAA0F,CAAC;AAE3H,oFAAoF;AACpF,eAAO,MAAM,wBAAwB,iEAAkE,CAAC;AAExG,qGAAqG;AACrG,eAAO,MAAM,yBAAyB,gDAAiD,CAAC;AAMxF,0GAA0G;AAC1G,eAAO,MAAM,0BAA0B;;;;iBAIrC,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;iBAiB3B,CAAC;AAEH,4GAA4G;AAC5G,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAKjC,CAAC;AAEH,iDAAiD;AACjD,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;iBAKrC,CAAC;AAEH,oHAAoH;AACpH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;iBAmB/B,CAAC;AAEH,mHAAmH;AACnH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;iBAalC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA6C3B,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC"}

package/dist/src/models/odps-schemas.js

@@ -0,0 +1,182 @@
+/**
+ * @file src/models/odps-schemas.ts
+ * @description The ODPS (Open Data Product Specification, Linux Foundation) authoring contract for an
+ *   EXCHANGE offering. AIMEAT derives most of an ODPS v4.1 document from what the node already knows
+ *   (title, price, plans, licence, provider, observed usage — see services/exchange-odps.ts); these are the
+ *   fields ODPS defines that the node CANNOT derive and a provider may therefore declare on the listing:
+ *   the product framing (value proposition, categories, standards, use cases, sample), the SLA + data-quality
+ *   COMMITMENTS (objectives, which are promises no observation can substitute for), and the legal data holder.
+ *   Everything here is optional — an offering without it still projects a valid ODPS v4.1 document.
+ *   PROVENANCE lives here too: the provider's attestation about where the data came from, on what legal
+ *   basis, how long it is kept, and (for derived data) the upstream lineage it was built from.
+ * @structure ODPS enums (product type · SLA/DQ dimensions + units) · ProvenanceSchema · OdpsExtrasSchema ·
+ *   inferred types (Provenance · OdpsExtras · OdpsSlaDimension · OdpsQualityDimension · OdpsDataHolder)
+ * @usage
+ *   const parsed = OdpsExtrasSchema.safeParse(req.body.odps);
+ *   if (!parsed.success) return res.status(400).json(error(nodeId, 'INVALID_ODPS', parsed.error.message));
+ * @version-history
+ *   v1.1.0 — 2026-07-25 — Pinned to ODPS v4.1 (the version the addendum's Q2 named): `language` (v4.1
+ *     keys details + pricing by ISO 639-1 code), `governanceProfile`, `portfolioPriority`, TOON format.
+ *   v1.0.0 — 2026-07-25 — Initial ODPS authoring contract + provenance attestation (TARGET-045 §4,
+ *     addendum Q2/Q3): closes the drift where `odpsVersion` was declared but never written.
+ */
+import { z } from 'zod';
+/** ODPS v4.1 `product.details.type` — what KIND of data product this is. */
+export const ODPS_PRODUCT_TYPES = [
+    'raw data', 'derived data', 'dataset', 'reports', 'analytic view', '3D visualisation', 'algorithm',
+    'decision support', 'automated decision-making', 'data-enhanced product', 'data-driven service',
+    'data-enabled performance', 'bi-directional',
+];
+/** ODPS v4.1 SLA dimensions (`product.SLA.declarative[].dimensions[].dimension`). */
+export const ODPS_SLA_DIMENSIONS = [
+    'latency', 'uptime', 'responseTime', 'errorRate', 'endOfSupport', 'endOfLife', 'updateFrequency',
+    'timeToDetect', 'timeToNotify', 'timeToRepair', 'emailResponseTime',
+];
+/** ODPS v4.1 SLA objective units. */
+export const ODPS_SLA_UNITS = [
+    'percent', 'milliseconds', 'seconds', 'minutes', 'days', 'weeks', 'months', 'years', 'never', 'date', 'null',
+];
+/** ODPS v4.1 data-quality dimensions. */
+export const ODPS_QUALITY_DIMENSIONS = [
+    'accuracy', 'completeness', 'conformity', 'consistency', 'coverage', 'timeliness', 'validity', 'uniqueness',
+];
+/** ODPS v4.1 output file formats a data product can be delivered in (v4.1 adds TOON). */
+export const ODPS_OUTPUT_FORMATS = ['TOON', 'JSON', 'XML', 'CSV', 'Excel', 'zip', 'plain text', 'GraphQL', 'MCP'];
+/** ODPS v4.1 `details.governanceProfile` — how strictly the product is governed. */
+export const ODPS_GOVERNANCE_PROFILES = ['structured', 'enforced', 'automated', 'audit_ready'];
+/** ODPS v4.1 `details.portfolioPriority` — how important the product is in its owner's portfolio. */
+export const ODPS_PORTFOLIO_PRIORITIES = ['critical', 'high', 'medium', 'low'];
+const shortText = z.string().trim().min(1).max(400);
+const longText = z.string().trim().min(1).max(4000);
+const shortList = z.array(z.string().trim().min(1).max(120)).max(30);
+/** One hop of upstream lineage for DERIVED data — where a component came from and what was done to it. */
+export const ProvenanceLineageHopSchema = z.object({
+    source: shortText,
+    transform: shortText.optional(),
+    at: z.string().trim().max(40).optional(),
+});
+/**
+ * The provider's provenance attestation. A PROMISE by the provider, not a platform guarantee — but a
+ * structured, attributed one (the provider is a GHII/GAII/GEAI) that a buyer can hold them to. Maps onto
+ * ODPS `license.governance` + the AIMEAT extension block; absent provenance is legal, it just reads as
+ * "unstated" to every buyer looking at the listing.
+ */
+export const ProvenanceSchema = z.object({
+    /** Where the data comes from (system, register, API, collection method). */
+    source: shortText.optional(),
+    /** The lawful basis for holding + reselling it (e.g. "GDPR Art. 6(1)(f) legitimate interest", "public register"). */
+    legalBasis: shortText.optional(),
+    /** Consent state of the underlying subjects, when the data is personal. */
+    consentStatus: shortText.optional(),
+    /** How long the provider retains it. */
+    retention: shortText.optional(),
+    /** What was done to the raw material to make this product (cleaning, joining, enrichment, model inference). */
+    transformations: longText.optional(),
+    /** SHA-256 content identity of the snapshot this promise is about (hex or `sha256:` prefixed). */
+    snapshotHash: z.string().trim().regex(/^(sha256:)?[a-fA-F0-9]{64}$/, 'snapshotHash must be a SHA-256 hex digest').optional(),
+    /** Upstream chain for derived data (OpenLineage-style, kept deliberately small + human-readable). */
+    lineage: z.array(ProvenanceLineageHopSchema).max(20).optional(),
+    /** Which ODPS version this listing's descriptor follows. Defaulted by the node on write. */
+    odpsVersion: z.string().trim().max(10).optional(),
+});
+/** An SLA COMMITMENT on the offering (what the provider promises, as opposed to what the node observed). */
+export const OdpsSlaDimensionSchema = z.object({
+    dimension: z.enum(ODPS_SLA_DIMENSIONS),
+    objective: z.number(),
+    unit: z.enum(ODPS_SLA_UNITS),
+    description: shortText.optional(),
+});
+/** A data-quality COMMITMENT on the offering. */
+export const OdpsQualityDimensionSchema = z.object({
+    dimension: z.enum(ODPS_QUALITY_DIMENSIONS),
+    objective: z.number(),
+    unit: z.enum(['percentage', 'number']),
+    description: shortText.optional(),
+});
+/** The legal entity behind the offering. AIMEAT knows the ACCOUNT (a GHII); only the provider knows the company. */
+export const OdpsDataHolderSchema = z.object({
+    legalName: shortText,
+    businessID: z.string().trim().max(60).optional(),
+    taxID: z.string().trim().max(60).optional(),
+    vatID: z.string().trim().max(60).optional(),
+    email: z.string().trim().email().max(200).optional(),
+    URL: z.string().trim().url().max(400).optional(),
+    telephone: z.string().trim().max(60).optional(),
+    contactName: shortText.optional(),
+    addressRegion: z.string().trim().max(120).optional(),
+    businessDomain: shortText.optional(),
+    description: longText.optional(),
+    addressCountry: z.string().trim().max(60).optional(),
+    addressLocality: z.string().trim().max(120).optional(),
+    postalCode: z.string().trim().max(20).optional(),
+    streetAddress: shortText.optional(),
+    logoURL: z.string().trim().url().max(400).optional(),
+    slogan: shortText.optional(),
+    parentOrganization: shortText.optional(),
+});
+/** Licence terms ODPS carries that AIMEAT's three-flag `usageTerms` does not (jurisdiction, exclusivity, exit). */
+export const OdpsLicenseExtrasSchema = z.object({
+    geographicalArea: shortList.optional(),
+    permanent: z.boolean().optional(),
+    exclusive: z.boolean().optional(),
+    restrictions: longText.optional(),
+    applicableLaws: shortText.optional(),
+    warranties: longText.optional(),
+    damages: longText.optional(),
+    confidentiality: longText.optional(),
+    forceMajeure: longText.optional(),
+    terminationNoticePeriodDays: z.number().int().min(0).max(3650).optional(),
+    terminationConditions: longText.optional(),
+    continuityConditions: longText.optional(),
+});
+/**
+ * Everything ODPS defines that the node cannot derive from the offering itself. All optional: a listing
+ * without any of it still projects a schema-valid ODPS v4.1 document, just a thinner one.
+ */
+export const OdpsExtrasSchema = z.object({
+    /**
+     * ISO 639-1 code for the language the listing text is written in. ODPS v4.1 keys `details` and
+     * `pricingPlans.declarative` by language; AIMEAT carries one free-text title/description, so this says
+     * which key it belongs under. Defaults to `en`. The same string is never duplicated under a second
+     * language — a claimed translation that does not exist is worse than none.
+     */
+    language: z.string().trim().regex(/^[a-z]{2}$/, 'language must be an ISO 639-1 two-letter code').optional(),
+    /** Overrides the node's default product type (derived from the offering kind). */
+    productType: z.enum(ODPS_PRODUCT_TYPES).optional(),
+    /** v4.1: governance maturity applied to this product. */
+    governanceProfile: z.enum(ODPS_GOVERNANCE_PROFILES).optional(),
+    /** v4.1: importance of this product in the provider's portfolio. */
+    portfolioPriority: z.enum(ODPS_PORTFOLIO_PRIORITIES).optional(),
+    /** ODPS caps the value proposition at 512 characters. */
+    valueProposition: z.string().trim().min(1).max(512).optional(),
+    productSeries: shortText.optional(),
+    categories: shortList.optional(),
+    standards: shortList.optional(),
+    /** Use cases as ODPS models them: a title, an optional description and an optional link. */
+    useCases: z.array(z.object({
+        title: shortText,
+        description: longText.optional(),
+        url: z.string().trim().url().max(400).optional(),
+    })).max(20).optional(),
+    outputFileFormats: z.array(z.enum(ODPS_OUTPUT_FORMATS)).max(8).optional(),
+    /** URL of a real output sample, so a buyer sees the goods before contracting (ODPS requires a URI here). */
+    contentSample: z.string().trim().url().max(400).optional(),
+    logoURL: z.string().trim().url().max(400).optional(),
+    brandSlogan: shortText.optional(),
+    productVersion: z.string().trim().max(40).optional(),
+    versionNotes: longText.optional(),
+    issues: longText.optional(),
+    documentationURL: z.string().trim().url().max(400).optional(),
+    supportEmail: z.string().trim().email().max(200).optional(),
+    supportHours: shortText.optional(),
+    /** VAT treatment of the listed price — applied to every pricing plan in the projected document. */
+    valueAddedTaxIncluded: z.boolean().optional(),
+    valueAddedTaxPercentage: z.number().int().min(0).max(100).optional(),
+    /** Related products a buyer may also want (ODPS cross-sell hook): offering ids or URLs. */
+    recommendedDataProducts: shortList.optional(),
+    sla: z.array(OdpsSlaDimensionSchema).max(11).optional(),
+    dataQuality: z.array(OdpsQualityDimensionSchema).max(8).optional(),
+    dataHolder: OdpsDataHolderSchema.optional(),
+    license: OdpsLicenseExtrasSchema.optional(),
+});
+//# sourceMappingURL=odps-schemas.js.map