@makaio/framework 1.0.0-dev-1789056466138 → 1.0.0-dev-1789138982585

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (78) hide show
  1. package/dist/.makaio-build.json +2 -2
  2. package/dist/{account-identity-CNdiLYaM.mjs → account-identity-BdGGjBuZ.mjs} +1 -1
  3. package/dist/{adapter-BdMny6vw.mjs → adapter-BLivHuUi.mjs} +1 -1
  4. package/dist/artifact-BPK_ywFP.mjs +1 -0
  5. package/dist/bus/index.mjs +4 -4
  6. package/dist/{canonical-model-BMnzRhG_.mjs → canonical-model-yXnm9QTn.mjs} +1 -1
  7. package/dist/{client-C0HcPzvw.mjs → client-BsY0rMlE.mjs} +1 -1
  8. package/dist/{compression-DvPXSBWS.mjs → compression-odwEUBWb.mjs} +1 -1
  9. package/dist/contracts/adapter/index.mjs +1 -1
  10. package/dist/contracts/artifact/index.d.mts +3 -3
  11. package/dist/contracts/artifact/index.mjs +1 -1
  12. package/dist/contracts/auth/index.d.mts +2 -2
  13. package/dist/contracts/automation-trigger/index.d.mts +2 -2
  14. package/dist/contracts/canonical-model/index.mjs +1 -1
  15. package/dist/contracts/capabilities/index.d.mts +1 -1
  16. package/dist/contracts/client/index.d.mts +1 -1
  17. package/dist/contracts/client/index.mjs +1 -1
  18. package/dist/contracts/code-execution/index.d.mts +1 -1
  19. package/dist/contracts/config/index.mjs +1 -1
  20. package/dist/contracts/extension/index.d.mts +3 -3
  21. package/dist/contracts/extension/index.mjs +1 -1
  22. package/dist/contracts/facet/index.d.mts +1 -1
  23. package/dist/contracts/harness/index.d.mts +1 -1
  24. package/dist/contracts/index.d.mts +25 -25
  25. package/dist/contracts/index.mjs +1 -1
  26. package/dist/contracts/materialization/index.d.mts +2 -2
  27. package/dist/contracts/materialization/index.mjs +1 -1
  28. package/dist/contracts/session/index.d.mts +2 -2
  29. package/dist/contracts/session/index.mjs +1 -1
  30. package/dist/contracts/shared/index.d.mts +3 -3
  31. package/dist/contracts/shared/index.mjs +1 -1
  32. package/dist/contracts/worker/index.d.mts +1 -1
  33. package/dist/contracts/worker/index.mjs +1 -1
  34. package/dist/contracts/workflow/index.d.mts +2 -2
  35. package/dist/contracts/workflow/index.mjs +1 -1
  36. package/dist/{contribution-BWanQHUz.d.mts → contribution-Cdz5WTYk.d.mts} +1 -1
  37. package/dist/{definition-DSOXLpQj.d.mts → definition-DQNFO-Qz.d.mts} +1 -1
  38. package/dist/{extension-GQEL-NCV.mjs → extension-DYBu49NH.mjs} +1 -1
  39. package/dist/{index-C1PsT7hg.d.mts → index-BGg5g9cK.d.mts} +997 -68
  40. package/dist/{index-CAURP-Tl2.d.mts → index-BUoIGZmF2.d.mts} +2 -2
  41. package/dist/{index-BFzxlzEo.d.mts → index-BXPMLk9W.d.mts} +38 -38
  42. package/dist/{index-CgYGg-Ne2.d.mts → index-BZrlHkpM2.d.mts} +41 -2
  43. package/dist/{index-CEHu8n-p.d.mts → index-CIl66QhT.d.mts} +6 -6
  44. package/dist/{index-CLmjrH8K.d.mts → index-D6_5slJp.d.mts} +1 -1
  45. package/dist/{index-Dp3UZQv_.d.mts → index-DS1mI9GP.d.mts} +1 -1
  46. package/dist/{index-WhgPewY4.d.mts → index-DcfuHw2O.d.mts} +6 -6
  47. package/dist/{index-D__FyAg62.d.mts → index-H2NL2OwF2.d.mts} +7 -7
  48. package/dist/{index-CHs__lq_.d.mts → index-it0mr4vE.d.mts} +8 -8
  49. package/dist/{index-DCVMDEhl.d.mts → index-ohUp4w1P.d.mts} +48 -48
  50. package/dist/{index-CaOJpuAX.d.mts → index-tCFckLG6.d.mts} +8 -8
  51. package/dist/kind-registration-CyMf-vey.mjs +1 -0
  52. package/dist/{materialization--bg6ZwQd.mjs → materialization-DRr6CSXV.mjs} +1 -1
  53. package/dist/package.json +1 -1
  54. package/dist/runtime-node/workflow-execution-bus-access.mjs +1 -1
  55. package/dist/schemas-BhkprYU1.mjs +1 -0
  56. package/dist/{schemas-_NrySTmN.d.mts → schemas-CXCdmM5K.d.mts} +13 -1
  57. package/dist/{schemas-pHboaOxJ.mjs → schemas-D9_OPuLB.mjs} +1 -1
  58. package/dist/{schemas-QEr2LI43.mjs → schemas-pBrUJEN6.mjs} +1 -1
  59. package/dist/services/filesystem/namespace.d.mts +6 -6
  60. package/dist/services/filesystem/schemas.d.mts +3 -3
  61. package/dist/services/index.d.mts +3 -3
  62. package/dist/services/settings/storage/extension-configs/namespace.d.mts +3 -3
  63. package/dist/{session-CODDwsGa.mjs → session-BsQst2fC.mjs} +1 -1
  64. package/dist/shared-m6jgT2a3.mjs +1 -0
  65. package/dist/{transition-D2VKNtv6.d.mts → transition-B8XDvfD7.d.mts} +2 -2
  66. package/dist/{types-DyXXIK4c.d.mts → types-HFQQoeAz.d.mts} +2 -2
  67. package/dist/{view-builder-kbgjREYq.d.mts → view-builder-ADC1ng2t.d.mts} +5 -5
  68. package/dist/{worker-L8vWpbYa.mjs → worker-CaRR3V7o.mjs} +1 -1
  69. package/dist/{workflow-DNks09Ip.mjs → workflow-BD7Pw5JY.mjs} +1 -1
  70. package/dist/workflow-engine/index.d.mts +39 -39
  71. package/package.json +1 -1
  72. package/dist/artifact--nbPrvm5.mjs +0 -1
  73. package/dist/kind-registration-BanX_UAF.mjs +0 -1
  74. package/dist/schemas-NKlV5jqJ.mjs +0 -1
  75. package/dist/shared-CkCrHz66.mjs +0 -1
  76. /package/dist/{adapter-binding-CTssGlH_.d.mts → adapter-binding-CZTWlcp9.d.mts} +0 -0
  77. /package/dist/{index-CrvTRZqh.d.mts → index-BNgNBDuW2.d.mts} +0 -0
  78. /package/dist/{json-value-Bjl8jzom.d.mts → json-value-DyMQrwGz.d.mts} +0 -0
@@ -1,4 +1,5 @@
1
- import { B as ArtifactCategory, C as ArtifactScope, G as ArtifactKindRegistration$1, Y as ArtifactLifecycleState, _ as ArtifactRelationTarget, p as ArtifactRelation, rt as ArtifactRef$1, s as ArtifactObservation$1, t as ArtifactActor, x as ArtifactRevision$1, y as ArtifactRepresentations } from "./schemas-_NrySTmN.mjs";
1
+ import { C as ArtifactScope, K as ArtifactKindRegistration$1, V as ArtifactCategory, X as ArtifactLifecycleState, _ as ArtifactRelationTarget, it as ArtifactRef$1, p as ArtifactRelation, s as ArtifactObservation$1, t as ArtifactActor, x as ArtifactRevision$1, y as ArtifactRepresentations } from "./schemas-CXCdmM5K.mjs";
2
+ import { l as JsonValue$1 } from "./json-value-DyMQrwGz.mjs";
2
3
  import { z } from "zod";
3
4
  import * as _$_makaio_core0 from "@makaio/framework/core";
4
5
  import { MakaioBusLike } from "@makaio/framework/core";
@@ -536,16 +537,51 @@ declare function defineArtifactKind<TData extends Record<string, unknown>, const
536
537
  //#region core/contracts/src/artifact/data-schema-validator.d.ts
537
538
  /** Validates one artifact payload against its registered JSON Schema. */
538
539
  type ArtifactDataValidator = (data: unknown) => boolean;
540
+ /** One rejected location within an artifact payload, with what the schema expected there. */
541
+ interface ArtifactDataIssue {
542
+ /** Dot-separated data-relative path of the rejected value; empty for the payload root. */
543
+ readonly path: string;
544
+ /** What the schema expected at that path. */
545
+ readonly reason: string;
546
+ /** Declared type at that path, when the rejection names one. */
547
+ readonly expectedType?: string;
548
+ /** Declared value set at that path, when the rejection names one. */
549
+ readonly allowedValues?: readonly JsonValue$1[];
550
+ }
551
+ /** Complete outcome of checking one artifact payload. */
552
+ type ArtifactDataCheck = {
553
+ readonly valid: true;
554
+ } | {
555
+ readonly valid: false;
556
+ readonly issues: readonly ArtifactDataIssue[];
557
+ };
558
+ /** Checks one artifact payload and reports every rejected location. */
559
+ type ArtifactDataChecker = (data: unknown) => ArtifactDataCheck;
539
560
  /**
540
- * Compile the JSON Schema declared by one artifact kind.
561
+ * Compile a predicate for complete artifact payload validation.
541
562
  *
542
- * Each invocation creates an isolated compiler so local schema identifiers
543
- * cannot satisfy references belonging to another kind.
563
+ * The predicate hides the compiled function's mutable `errors`, so a caller
564
+ * cannot read error state left behind by an unrelated call. Use
565
+ * {@link compileArtifactDataChecker} when the rejections themselves are needed.
544
566
  * @param registration - Structurally validated artifact kind registration.
545
567
  * @returns A predicate for complete artifact payload validation.
546
568
  * @throws When the declared data schema cannot be compiled by its supported dialect.
547
569
  */
548
570
  declare function compileArtifactDataSchema(registration: ArtifactKindRegistration$1): ArtifactDataValidator;
571
+ /**
572
+ * Compile a checker that reports why an artifact payload was rejected.
573
+ *
574
+ * Use this where the caller has to repair the payload rather than merely learn
575
+ * that it is invalid: each issue names a path and, where the schema declares
576
+ * one, the expected type or the allowed values.
577
+ *
578
+ * The returned checker owns its compiled function and reads that function's
579
+ * errors before returning, so concurrent callers each need their own checker.
580
+ * @param registration - Structurally validated artifact kind registration.
581
+ * @returns A checker producing one issue per rejected location.
582
+ * @throws When the declared data schema cannot be compiled by its supported dialect.
583
+ */
584
+ declare function compileArtifactDataChecker(registration: ArtifactKindRegistration$1): ArtifactDataChecker;
549
585
  //#endregion
550
586
  //#region core/contracts/src/artifact/context-selectors.d.ts
551
587
  /** Known render hints for artifact context resolution. */
@@ -926,7 +962,7 @@ declare function hydrateArtifactContextTree(wire: ResolvedArtifactContextWire$1)
926
962
  *
927
963
  * - Shared lifecycle get / history / transition RPCs and committed / rejected events
928
964
  * - Kind and relation-type registration RPCs
929
- * - Revision create / revise / resolve / query / compare RPCs
965
+ * - Revision create / revise / patch / resolve / query / compare RPCs
930
966
  * - `created`, `revised`, `relation.added`, `observation.added`,
931
967
  * `status.changed`, and `kind.changed` revision and registry events
932
968
  *
@@ -1137,6 +1173,16 @@ declare const ArtifactSchemas$1: {
1137
1173
  excerpt: z.ZodOptional<z.ZodString>;
1138
1174
  }, z.core.$strict>]>>>;
1139
1175
  createdAt: z.ZodOptional<z.ZodNumber>;
1176
+ schemaVersion: z.ZodNumber;
1177
+ scope: z.ZodObject<{
1178
+ level: z.ZodString;
1179
+ ids: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
1180
+ }, z.core.$strip>;
1181
+ actor: z.ZodObject<{
1182
+ kind: z.ZodString;
1183
+ id: z.ZodString;
1184
+ displayName: z.ZodOptional<z.ZodString>;
1185
+ }, z.core.$strip>;
1140
1186
  relations: z.ZodArray<z.ZodObject<{
1141
1187
  type: z.ZodString;
1142
1188
  target: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -1165,16 +1211,6 @@ declare const ArtifactSchemas$1: {
1165
1211
  id: z.ZodString;
1166
1212
  }, z.core.$strict>], "refClass">>;
1167
1213
  }, z.core.$strip>>;
1168
- schemaVersion: z.ZodNumber;
1169
- scope: z.ZodObject<{
1170
- level: z.ZodString;
1171
- ids: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
1172
- }, z.core.$strip>;
1173
- actor: z.ZodObject<{
1174
- kind: z.ZodString;
1175
- id: z.ZodString;
1176
- displayName: z.ZodOptional<z.ZodString>;
1177
- }, z.core.$strip>;
1178
1214
  confidence: z.ZodOptional<z.ZodObject<{
1179
1215
  level: z.ZodEnum<{
1180
1216
  inferred: "inferred";
@@ -1431,6 +1467,16 @@ declare const ArtifactSchemas$1: {
1431
1467
  excerpt: z.ZodOptional<z.ZodString>;
1432
1468
  }, z.core.$strict>]>>>;
1433
1469
  createdAt: z.ZodOptional<z.ZodNumber>;
1470
+ schemaVersion: z.ZodNumber;
1471
+ scope: z.ZodObject<{
1472
+ level: z.ZodString;
1473
+ ids: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
1474
+ }, z.core.$strip>;
1475
+ actor: z.ZodObject<{
1476
+ kind: z.ZodString;
1477
+ id: z.ZodString;
1478
+ displayName: z.ZodOptional<z.ZodString>;
1479
+ }, z.core.$strip>;
1434
1480
  relations: z.ZodArray<z.ZodObject<{
1435
1481
  type: z.ZodString;
1436
1482
  target: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -1459,16 +1505,6 @@ declare const ArtifactSchemas$1: {
1459
1505
  id: z.ZodString;
1460
1506
  }, z.core.$strict>], "refClass">>;
1461
1507
  }, z.core.$strip>>;
1462
- schemaVersion: z.ZodNumber;
1463
- scope: z.ZodObject<{
1464
- level: z.ZodString;
1465
- ids: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
1466
- }, z.core.$strip>;
1467
- actor: z.ZodObject<{
1468
- kind: z.ZodString;
1469
- id: z.ZodString;
1470
- displayName: z.ZodOptional<z.ZodString>;
1471
- }, z.core.$strip>;
1472
1508
  confidence: z.ZodOptional<z.ZodObject<{
1473
1509
  level: z.ZodEnum<{
1474
1510
  inferred: "inferred";
@@ -1664,6 +1700,126 @@ declare const ArtifactSchemas$1: {
1664
1700
  createdAt: z.ZodOptional<z.ZodNumber>;
1665
1701
  }, z.core.$strip>;
1666
1702
  }, z.core.$strip>;
1703
+ };
1704
+ /**
1705
+ * Revise an existing artifact by patching the revision named by `baseRevision` (RPC).
1706
+ *
1707
+ * The request carries the change rather than the payload, so its cost follows
1708
+ * the size of the change. Rejections are returned in band with the failing
1709
+ * path and a repair hint; a stale `baseRevision` reports the current revision
1710
+ * along with the repair the caller must follow — only an append at a fixed
1711
+ * path can be resent without re-reading the payload.
1712
+ */
1713
+ patch: {
1714
+ request: z.ZodObject<{
1715
+ ref: z.ZodObject<{
1716
+ kind: z.ZodString;
1717
+ id: z.ZodString;
1718
+ }, z.core.$strict>;
1719
+ baseRevision: z.ZodString;
1720
+ patch: z.ZodObject<{
1721
+ $set: z.ZodOptional<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>;
1722
+ $unset: z.ZodOptional<z.ZodType<Record<string, true>, Record<string, true>, z.core.$ZodTypeInternals<Record<string, true>, Record<string, true>>>>;
1723
+ $push: z.ZodOptional<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>;
1724
+ $pull: z.ZodOptional<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>;
1725
+ arrayFilters: z.ZodOptional<z.ZodArray<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>>;
1726
+ }, z.core.$strict>;
1727
+ dryRun: z.ZodOptional<z.ZodBoolean>;
1728
+ schemaVersion: z.ZodOptional<z.ZodNumber>;
1729
+ statusPath: z.ZodOptional<z.ZodString>;
1730
+ representations: z.ZodOptional<z.ZodNullable<z.ZodObject<{
1731
+ markdown: z.ZodOptional<z.ZodString>;
1732
+ summary: z.ZodOptional<z.ZodString>;
1733
+ plaintext: z.ZodOptional<z.ZodString>;
1734
+ }, z.core.$strict>>>;
1735
+ }, z.core.$strict>;
1736
+ response: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
1737
+ ok: z.ZodLiteral<true>;
1738
+ base: z.ZodObject<{
1739
+ refClass: z.ZodLiteral<"artifact">;
1740
+ kind: z.ZodString;
1741
+ id: z.ZodString;
1742
+ revision: z.ZodString;
1743
+ }, z.core.$strict>;
1744
+ operations: z.ZodArray<z.ZodObject<{
1745
+ operator: z.ZodEnum<{
1746
+ $set: "$set";
1747
+ $unset: "$unset";
1748
+ $push: "$push";
1749
+ $pull: "$pull";
1750
+ }>;
1751
+ path: z.ZodString;
1752
+ matched: z.ZodNumber;
1753
+ }, z.core.$strict>>;
1754
+ migration: z.ZodOptional<z.ZodObject<{
1755
+ from: z.ZodNumber;
1756
+ to: z.ZodNumber;
1757
+ }, z.core.$strict>>;
1758
+ dryRun: z.ZodLiteral<true>;
1759
+ }, z.core.$strict>, z.ZodObject<{
1760
+ ok: z.ZodLiteral<true>;
1761
+ base: z.ZodObject<{
1762
+ refClass: z.ZodLiteral<"artifact">;
1763
+ kind: z.ZodString;
1764
+ id: z.ZodString;
1765
+ revision: z.ZodString;
1766
+ }, z.core.$strict>;
1767
+ operations: z.ZodArray<z.ZodObject<{
1768
+ operator: z.ZodEnum<{
1769
+ $set: "$set";
1770
+ $unset: "$unset";
1771
+ $push: "$push";
1772
+ $pull: "$pull";
1773
+ }>;
1774
+ path: z.ZodString;
1775
+ matched: z.ZodNumber;
1776
+ }, z.core.$strict>>;
1777
+ migration: z.ZodOptional<z.ZodObject<{
1778
+ from: z.ZodNumber;
1779
+ to: z.ZodNumber;
1780
+ }, z.core.$strict>>;
1781
+ dryRun: z.ZodLiteral<false>;
1782
+ artifact: z.ZodObject<{
1783
+ refClass: z.ZodLiteral<"artifact">;
1784
+ kind: z.ZodString;
1785
+ id: z.ZodString;
1786
+ revision: z.ZodString;
1787
+ }, z.core.$strict>;
1788
+ }, z.core.$strict>], "dryRun">, z.ZodObject<{
1789
+ ok: z.ZodLiteral<false>;
1790
+ error: z.ZodObject<{
1791
+ code: z.ZodEnum<{
1792
+ ARTIFACT_NOT_FOUND: "ARTIFACT_NOT_FOUND";
1793
+ BASE_REVISION_CONFLICT: "BASE_REVISION_CONFLICT";
1794
+ KIND_NOT_REGISTERED: "KIND_NOT_REGISTERED";
1795
+ SCHEMA_VERSION_MISMATCH: "SCHEMA_VERSION_MISMATCH";
1796
+ PATH_NOT_DECLARED: "PATH_NOT_DECLARED";
1797
+ PATH_NOT_RESOLVABLE: "PATH_NOT_RESOLVABLE";
1798
+ TARGET_NOT_A_COLLECTION: "TARGET_NOT_A_COLLECTION";
1799
+ UNSUPPORTED_TARGET: "UNSUPPORTED_TARGET";
1800
+ NO_MATCH: "NO_MATCH";
1801
+ SCHEMA_VALIDATION_FAILED: "SCHEMA_VALIDATION_FAILED";
1802
+ NO_CHANGE: "NO_CHANGE";
1803
+ HOST_FAILED: "HOST_FAILED";
1804
+ }>;
1805
+ message: z.ZodString;
1806
+ operator: z.ZodOptional<z.ZodEnum<{
1807
+ $set: "$set";
1808
+ $unset: "$unset";
1809
+ $push: "$push";
1810
+ $pull: "$pull";
1811
+ }>>;
1812
+ path: z.ZodOptional<z.ZodString>;
1813
+ currentRevision: z.ZodOptional<z.ZodString>;
1814
+ issues: z.ZodOptional<z.ZodArray<z.ZodObject<{
1815
+ path: z.ZodString;
1816
+ reason: z.ZodString;
1817
+ expectedType: z.ZodOptional<z.ZodString>;
1818
+ allowedValues: z.ZodOptional<z.ZodArray<z.ZodType<_$_makaio_contracts0.JsonValue, _$_makaio_contracts0.JsonValue, z.core.$ZodTypeInternals<_$_makaio_contracts0.JsonValue, _$_makaio_contracts0.JsonValue>>>>;
1819
+ }, z.core.$strict>>>;
1820
+ repair: z.ZodString;
1821
+ }, z.core.$strict>;
1822
+ }, z.core.$strict>]>;
1667
1823
  }; /** Resolve a specific artifact revision by reference (RPC). */
1668
1824
  resolve: {
1669
1825
  request: z.ZodObject<{
@@ -3733,6 +3889,16 @@ declare const ArtifactNamespace: _$_makaio_core0.BusNamespaceDefinition<"artifac
3733
3889
  excerpt: z.ZodOptional<z.ZodString>;
3734
3890
  }, z.core.$strict>]>>>;
3735
3891
  createdAt: z.ZodOptional<z.ZodNumber>;
3892
+ schemaVersion: z.ZodNumber;
3893
+ scope: z.ZodObject<{
3894
+ level: z.ZodString;
3895
+ ids: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
3896
+ }, z.core.$strip>;
3897
+ actor: z.ZodObject<{
3898
+ kind: z.ZodString;
3899
+ id: z.ZodString;
3900
+ displayName: z.ZodOptional<z.ZodString>;
3901
+ }, z.core.$strip>;
3736
3902
  relations: z.ZodArray<z.ZodObject<{
3737
3903
  type: z.ZodString;
3738
3904
  target: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -3761,16 +3927,6 @@ declare const ArtifactNamespace: _$_makaio_core0.BusNamespaceDefinition<"artifac
3761
3927
  id: z.ZodString;
3762
3928
  }, z.core.$strict>], "refClass">>;
3763
3929
  }, z.core.$strip>>;
3764
- schemaVersion: z.ZodNumber;
3765
- scope: z.ZodObject<{
3766
- level: z.ZodString;
3767
- ids: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
3768
- }, z.core.$strip>;
3769
- actor: z.ZodObject<{
3770
- kind: z.ZodString;
3771
- id: z.ZodString;
3772
- displayName: z.ZodOptional<z.ZodString>;
3773
- }, z.core.$strip>;
3774
3930
  confidence: z.ZodOptional<z.ZodObject<{
3775
3931
  level: z.ZodEnum<{
3776
3932
  inferred: "inferred";
@@ -4027,6 +4183,16 @@ declare const ArtifactNamespace: _$_makaio_core0.BusNamespaceDefinition<"artifac
4027
4183
  excerpt: z.ZodOptional<z.ZodString>;
4028
4184
  }, z.core.$strict>]>>>;
4029
4185
  createdAt: z.ZodOptional<z.ZodNumber>;
4186
+ schemaVersion: z.ZodNumber;
4187
+ scope: z.ZodObject<{
4188
+ level: z.ZodString;
4189
+ ids: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
4190
+ }, z.core.$strip>;
4191
+ actor: z.ZodObject<{
4192
+ kind: z.ZodString;
4193
+ id: z.ZodString;
4194
+ displayName: z.ZodOptional<z.ZodString>;
4195
+ }, z.core.$strip>;
4030
4196
  relations: z.ZodArray<z.ZodObject<{
4031
4197
  type: z.ZodString;
4032
4198
  target: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -4055,16 +4221,6 @@ declare const ArtifactNamespace: _$_makaio_core0.BusNamespaceDefinition<"artifac
4055
4221
  id: z.ZodString;
4056
4222
  }, z.core.$strict>], "refClass">>;
4057
4223
  }, z.core.$strip>>;
4058
- schemaVersion: z.ZodNumber;
4059
- scope: z.ZodObject<{
4060
- level: z.ZodString;
4061
- ids: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
4062
- }, z.core.$strip>;
4063
- actor: z.ZodObject<{
4064
- kind: z.ZodString;
4065
- id: z.ZodString;
4066
- displayName: z.ZodOptional<z.ZodString>;
4067
- }, z.core.$strip>;
4068
4224
  confidence: z.ZodOptional<z.ZodObject<{
4069
4225
  level: z.ZodEnum<{
4070
4226
  inferred: "inferred";
@@ -4260,6 +4416,126 @@ declare const ArtifactNamespace: _$_makaio_core0.BusNamespaceDefinition<"artifac
4260
4416
  createdAt: z.ZodOptional<z.ZodNumber>;
4261
4417
  }, z.core.$strip>;
4262
4418
  }, z.core.$strip>;
4419
+ };
4420
+ /**
4421
+ * Revise an existing artifact by patching the revision named by `baseRevision` (RPC).
4422
+ *
4423
+ * The request carries the change rather than the payload, so its cost follows
4424
+ * the size of the change. Rejections are returned in band with the failing
4425
+ * path and a repair hint; a stale `baseRevision` reports the current revision
4426
+ * along with the repair the caller must follow — only an append at a fixed
4427
+ * path can be resent without re-reading the payload.
4428
+ */
4429
+ patch: {
4430
+ request: z.ZodObject<{
4431
+ ref: z.ZodObject<{
4432
+ kind: z.ZodString;
4433
+ id: z.ZodString;
4434
+ }, z.core.$strict>;
4435
+ baseRevision: z.ZodString;
4436
+ patch: z.ZodObject<{
4437
+ $set: z.ZodOptional<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>;
4438
+ $unset: z.ZodOptional<z.ZodType<Record<string, true>, Record<string, true>, z.core.$ZodTypeInternals<Record<string, true>, Record<string, true>>>>;
4439
+ $push: z.ZodOptional<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>;
4440
+ $pull: z.ZodOptional<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>;
4441
+ arrayFilters: z.ZodOptional<z.ZodArray<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>>;
4442
+ }, z.core.$strict>;
4443
+ dryRun: z.ZodOptional<z.ZodBoolean>;
4444
+ schemaVersion: z.ZodOptional<z.ZodNumber>;
4445
+ statusPath: z.ZodOptional<z.ZodString>;
4446
+ representations: z.ZodOptional<z.ZodNullable<z.ZodObject<{
4447
+ markdown: z.ZodOptional<z.ZodString>;
4448
+ summary: z.ZodOptional<z.ZodString>;
4449
+ plaintext: z.ZodOptional<z.ZodString>;
4450
+ }, z.core.$strict>>>;
4451
+ }, z.core.$strict>;
4452
+ response: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
4453
+ ok: z.ZodLiteral<true>;
4454
+ base: z.ZodObject<{
4455
+ refClass: z.ZodLiteral<"artifact">;
4456
+ kind: z.ZodString;
4457
+ id: z.ZodString;
4458
+ revision: z.ZodString;
4459
+ }, z.core.$strict>;
4460
+ operations: z.ZodArray<z.ZodObject<{
4461
+ operator: z.ZodEnum<{
4462
+ $set: "$set";
4463
+ $unset: "$unset";
4464
+ $push: "$push";
4465
+ $pull: "$pull";
4466
+ }>;
4467
+ path: z.ZodString;
4468
+ matched: z.ZodNumber;
4469
+ }, z.core.$strict>>;
4470
+ migration: z.ZodOptional<z.ZodObject<{
4471
+ from: z.ZodNumber;
4472
+ to: z.ZodNumber;
4473
+ }, z.core.$strict>>;
4474
+ dryRun: z.ZodLiteral<true>;
4475
+ }, z.core.$strict>, z.ZodObject<{
4476
+ ok: z.ZodLiteral<true>;
4477
+ base: z.ZodObject<{
4478
+ refClass: z.ZodLiteral<"artifact">;
4479
+ kind: z.ZodString;
4480
+ id: z.ZodString;
4481
+ revision: z.ZodString;
4482
+ }, z.core.$strict>;
4483
+ operations: z.ZodArray<z.ZodObject<{
4484
+ operator: z.ZodEnum<{
4485
+ $set: "$set";
4486
+ $unset: "$unset";
4487
+ $push: "$push";
4488
+ $pull: "$pull";
4489
+ }>;
4490
+ path: z.ZodString;
4491
+ matched: z.ZodNumber;
4492
+ }, z.core.$strict>>;
4493
+ migration: z.ZodOptional<z.ZodObject<{
4494
+ from: z.ZodNumber;
4495
+ to: z.ZodNumber;
4496
+ }, z.core.$strict>>;
4497
+ dryRun: z.ZodLiteral<false>;
4498
+ artifact: z.ZodObject<{
4499
+ refClass: z.ZodLiteral<"artifact">;
4500
+ kind: z.ZodString;
4501
+ id: z.ZodString;
4502
+ revision: z.ZodString;
4503
+ }, z.core.$strict>;
4504
+ }, z.core.$strict>], "dryRun">, z.ZodObject<{
4505
+ ok: z.ZodLiteral<false>;
4506
+ error: z.ZodObject<{
4507
+ code: z.ZodEnum<{
4508
+ ARTIFACT_NOT_FOUND: "ARTIFACT_NOT_FOUND";
4509
+ BASE_REVISION_CONFLICT: "BASE_REVISION_CONFLICT";
4510
+ KIND_NOT_REGISTERED: "KIND_NOT_REGISTERED";
4511
+ SCHEMA_VERSION_MISMATCH: "SCHEMA_VERSION_MISMATCH";
4512
+ PATH_NOT_DECLARED: "PATH_NOT_DECLARED";
4513
+ PATH_NOT_RESOLVABLE: "PATH_NOT_RESOLVABLE";
4514
+ TARGET_NOT_A_COLLECTION: "TARGET_NOT_A_COLLECTION";
4515
+ UNSUPPORTED_TARGET: "UNSUPPORTED_TARGET";
4516
+ NO_MATCH: "NO_MATCH";
4517
+ SCHEMA_VALIDATION_FAILED: "SCHEMA_VALIDATION_FAILED";
4518
+ NO_CHANGE: "NO_CHANGE";
4519
+ HOST_FAILED: "HOST_FAILED";
4520
+ }>;
4521
+ message: z.ZodString;
4522
+ operator: z.ZodOptional<z.ZodEnum<{
4523
+ $set: "$set";
4524
+ $unset: "$unset";
4525
+ $push: "$push";
4526
+ $pull: "$pull";
4527
+ }>>;
4528
+ path: z.ZodOptional<z.ZodString>;
4529
+ currentRevision: z.ZodOptional<z.ZodString>;
4530
+ issues: z.ZodOptional<z.ZodArray<z.ZodObject<{
4531
+ path: z.ZodString;
4532
+ reason: z.ZodString;
4533
+ expectedType: z.ZodOptional<z.ZodString>;
4534
+ allowedValues: z.ZodOptional<z.ZodArray<z.ZodType<_$_makaio_contracts0.JsonValue, _$_makaio_contracts0.JsonValue, z.core.$ZodTypeInternals<_$_makaio_contracts0.JsonValue, _$_makaio_contracts0.JsonValue>>>>;
4535
+ }, z.core.$strict>>>;
4536
+ repair: z.ZodString;
4537
+ }, z.core.$strict>;
4538
+ }, z.core.$strict>]>;
4263
4539
  }; /** Resolve a specific artifact revision by reference (RPC). */
4264
4540
  resolve: {
4265
4541
  request: z.ZodObject<{
@@ -6134,6 +6410,7 @@ declare const ArtifactNamespace: _$_makaio_core0.BusNamespaceDefinition<"artifac
6134
6410
  * - `ArtifactSubjects.lifecycle.rejected` — supplemental rejected transition event
6135
6411
  * - `ArtifactSubjects.create` — create artifact (RPC)
6136
6412
  * - `ArtifactSubjects.revise` — revise artifact (RPC)
6413
+ * - `ArtifactSubjects.patch` — revise artifact by patch (RPC)
6137
6414
  * - `ArtifactSubjects.resolve` — resolve artifact by ref (RPC)
6138
6415
  * - `ArtifactSubjects.query` — query artifacts (RPC)
6139
6416
  * - `ArtifactSubjects.compare` — compare two revisions (RPC)
@@ -6349,6 +6626,16 @@ declare const ArtifactSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fl
6349
6626
  excerpt: z.ZodOptional<z.ZodString>;
6350
6627
  }, z.core.$strict>]>>>;
6351
6628
  createdAt: z.ZodOptional<z.ZodNumber>;
6629
+ schemaVersion: z.ZodNumber;
6630
+ scope: z.ZodObject<{
6631
+ level: z.ZodString;
6632
+ ids: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
6633
+ }, z.core.$strip>;
6634
+ actor: z.ZodObject<{
6635
+ kind: z.ZodString;
6636
+ id: z.ZodString;
6637
+ displayName: z.ZodOptional<z.ZodString>;
6638
+ }, z.core.$strip>;
6352
6639
  relations: z.ZodArray<z.ZodObject<{
6353
6640
  type: z.ZodString;
6354
6641
  target: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -6377,16 +6664,6 @@ declare const ArtifactSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fl
6377
6664
  id: z.ZodString;
6378
6665
  }, z.core.$strict>], "refClass">>;
6379
6666
  }, z.core.$strip>>;
6380
- schemaVersion: z.ZodNumber;
6381
- scope: z.ZodObject<{
6382
- level: z.ZodString;
6383
- ids: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
6384
- }, z.core.$strip>;
6385
- actor: z.ZodObject<{
6386
- kind: z.ZodString;
6387
- id: z.ZodString;
6388
- displayName: z.ZodOptional<z.ZodString>;
6389
- }, z.core.$strip>;
6390
6667
  confidence: z.ZodOptional<z.ZodObject<{
6391
6668
  level: z.ZodEnum<{
6392
6669
  inferred: "inferred";
@@ -6643,6 +6920,16 @@ declare const ArtifactSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fl
6643
6920
  excerpt: z.ZodOptional<z.ZodString>;
6644
6921
  }, z.core.$strict>]>>>;
6645
6922
  createdAt: z.ZodOptional<z.ZodNumber>;
6923
+ schemaVersion: z.ZodNumber;
6924
+ scope: z.ZodObject<{
6925
+ level: z.ZodString;
6926
+ ids: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
6927
+ }, z.core.$strip>;
6928
+ actor: z.ZodObject<{
6929
+ kind: z.ZodString;
6930
+ id: z.ZodString;
6931
+ displayName: z.ZodOptional<z.ZodString>;
6932
+ }, z.core.$strip>;
6646
6933
  relations: z.ZodArray<z.ZodObject<{
6647
6934
  type: z.ZodString;
6648
6935
  target: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -6671,16 +6958,6 @@ declare const ArtifactSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fl
6671
6958
  id: z.ZodString;
6672
6959
  }, z.core.$strict>], "refClass">>;
6673
6960
  }, z.core.$strip>>;
6674
- schemaVersion: z.ZodNumber;
6675
- scope: z.ZodObject<{
6676
- level: z.ZodString;
6677
- ids: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
6678
- }, z.core.$strip>;
6679
- actor: z.ZodObject<{
6680
- kind: z.ZodString;
6681
- id: z.ZodString;
6682
- displayName: z.ZodOptional<z.ZodString>;
6683
- }, z.core.$strip>;
6684
6961
  confidence: z.ZodOptional<z.ZodObject<{
6685
6962
  level: z.ZodEnum<{
6686
6963
  inferred: "inferred";
@@ -6876,6 +7153,126 @@ declare const ArtifactSubjects$1: _$_makaio_core0.BusSubjects<_$_makaio_core0.Fl
6876
7153
  createdAt: z.ZodOptional<z.ZodNumber>;
6877
7154
  }, z.core.$strip>;
6878
7155
  }, z.core.$strip>;
7156
+ };
7157
+ /**
7158
+ * Revise an existing artifact by patching the revision named by `baseRevision` (RPC).
7159
+ *
7160
+ * The request carries the change rather than the payload, so its cost follows
7161
+ * the size of the change. Rejections are returned in band with the failing
7162
+ * path and a repair hint; a stale `baseRevision` reports the current revision
7163
+ * along with the repair the caller must follow — only an append at a fixed
7164
+ * path can be resent without re-reading the payload.
7165
+ */
7166
+ patch: {
7167
+ request: z.ZodObject<{
7168
+ ref: z.ZodObject<{
7169
+ kind: z.ZodString;
7170
+ id: z.ZodString;
7171
+ }, z.core.$strict>;
7172
+ baseRevision: z.ZodString;
7173
+ patch: z.ZodObject<{
7174
+ $set: z.ZodOptional<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>;
7175
+ $unset: z.ZodOptional<z.ZodType<Record<string, true>, Record<string, true>, z.core.$ZodTypeInternals<Record<string, true>, Record<string, true>>>>;
7176
+ $push: z.ZodOptional<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>;
7177
+ $pull: z.ZodOptional<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>;
7178
+ arrayFilters: z.ZodOptional<z.ZodArray<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>>;
7179
+ }, z.core.$strict>;
7180
+ dryRun: z.ZodOptional<z.ZodBoolean>;
7181
+ schemaVersion: z.ZodOptional<z.ZodNumber>;
7182
+ statusPath: z.ZodOptional<z.ZodString>;
7183
+ representations: z.ZodOptional<z.ZodNullable<z.ZodObject<{
7184
+ markdown: z.ZodOptional<z.ZodString>;
7185
+ summary: z.ZodOptional<z.ZodString>;
7186
+ plaintext: z.ZodOptional<z.ZodString>;
7187
+ }, z.core.$strict>>>;
7188
+ }, z.core.$strict>;
7189
+ response: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
7190
+ ok: z.ZodLiteral<true>;
7191
+ base: z.ZodObject<{
7192
+ refClass: z.ZodLiteral<"artifact">;
7193
+ kind: z.ZodString;
7194
+ id: z.ZodString;
7195
+ revision: z.ZodString;
7196
+ }, z.core.$strict>;
7197
+ operations: z.ZodArray<z.ZodObject<{
7198
+ operator: z.ZodEnum<{
7199
+ $set: "$set";
7200
+ $unset: "$unset";
7201
+ $push: "$push";
7202
+ $pull: "$pull";
7203
+ }>;
7204
+ path: z.ZodString;
7205
+ matched: z.ZodNumber;
7206
+ }, z.core.$strict>>;
7207
+ migration: z.ZodOptional<z.ZodObject<{
7208
+ from: z.ZodNumber;
7209
+ to: z.ZodNumber;
7210
+ }, z.core.$strict>>;
7211
+ dryRun: z.ZodLiteral<true>;
7212
+ }, z.core.$strict>, z.ZodObject<{
7213
+ ok: z.ZodLiteral<true>;
7214
+ base: z.ZodObject<{
7215
+ refClass: z.ZodLiteral<"artifact">;
7216
+ kind: z.ZodString;
7217
+ id: z.ZodString;
7218
+ revision: z.ZodString;
7219
+ }, z.core.$strict>;
7220
+ operations: z.ZodArray<z.ZodObject<{
7221
+ operator: z.ZodEnum<{
7222
+ $set: "$set";
7223
+ $unset: "$unset";
7224
+ $push: "$push";
7225
+ $pull: "$pull";
7226
+ }>;
7227
+ path: z.ZodString;
7228
+ matched: z.ZodNumber;
7229
+ }, z.core.$strict>>;
7230
+ migration: z.ZodOptional<z.ZodObject<{
7231
+ from: z.ZodNumber;
7232
+ to: z.ZodNumber;
7233
+ }, z.core.$strict>>;
7234
+ dryRun: z.ZodLiteral<false>;
7235
+ artifact: z.ZodObject<{
7236
+ refClass: z.ZodLiteral<"artifact">;
7237
+ kind: z.ZodString;
7238
+ id: z.ZodString;
7239
+ revision: z.ZodString;
7240
+ }, z.core.$strict>;
7241
+ }, z.core.$strict>], "dryRun">, z.ZodObject<{
7242
+ ok: z.ZodLiteral<false>;
7243
+ error: z.ZodObject<{
7244
+ code: z.ZodEnum<{
7245
+ ARTIFACT_NOT_FOUND: "ARTIFACT_NOT_FOUND";
7246
+ BASE_REVISION_CONFLICT: "BASE_REVISION_CONFLICT";
7247
+ KIND_NOT_REGISTERED: "KIND_NOT_REGISTERED";
7248
+ SCHEMA_VERSION_MISMATCH: "SCHEMA_VERSION_MISMATCH";
7249
+ PATH_NOT_DECLARED: "PATH_NOT_DECLARED";
7250
+ PATH_NOT_RESOLVABLE: "PATH_NOT_RESOLVABLE";
7251
+ TARGET_NOT_A_COLLECTION: "TARGET_NOT_A_COLLECTION";
7252
+ UNSUPPORTED_TARGET: "UNSUPPORTED_TARGET";
7253
+ NO_MATCH: "NO_MATCH";
7254
+ SCHEMA_VALIDATION_FAILED: "SCHEMA_VALIDATION_FAILED";
7255
+ NO_CHANGE: "NO_CHANGE";
7256
+ HOST_FAILED: "HOST_FAILED";
7257
+ }>;
7258
+ message: z.ZodString;
7259
+ operator: z.ZodOptional<z.ZodEnum<{
7260
+ $set: "$set";
7261
+ $unset: "$unset";
7262
+ $push: "$push";
7263
+ $pull: "$pull";
7264
+ }>>;
7265
+ path: z.ZodOptional<z.ZodString>;
7266
+ currentRevision: z.ZodOptional<z.ZodString>;
7267
+ issues: z.ZodOptional<z.ZodArray<z.ZodObject<{
7268
+ path: z.ZodString;
7269
+ reason: z.ZodString;
7270
+ expectedType: z.ZodOptional<z.ZodString>;
7271
+ allowedValues: z.ZodOptional<z.ZodArray<z.ZodType<_$_makaio_contracts0.JsonValue, _$_makaio_contracts0.JsonValue, z.core.$ZodTypeInternals<_$_makaio_contracts0.JsonValue, _$_makaio_contracts0.JsonValue>>>>;
7272
+ }, z.core.$strict>>>;
7273
+ repair: z.ZodString;
7274
+ }, z.core.$strict>;
7275
+ }, z.core.$strict>]>;
6879
7276
  }; /** Resolve a specific artifact revision by reference (RPC). */
6880
7277
  resolve: {
6881
7278
  request: z.ZodObject<{
@@ -8759,6 +9156,10 @@ type ArtifactCreateResponse = z.infer<(typeof ArtifactSchemas$1)['create']['resp
8759
9156
  type ArtifactReviseRequest = z.infer<(typeof ArtifactSchemas$1)['revise']['request']>;
8760
9157
  /** Response payload for creating a new artifact revision. */
8761
9158
  type ArtifactReviseResponse = z.infer<(typeof ArtifactSchemas$1)['revise']['response']>;
9159
+ /** Request payload for revising an artifact by patch. */
9160
+ type ArtifactPatchSubjectRequest = z.infer<(typeof ArtifactSchemas$1)['patch']['request']>;
9161
+ /** Response payload for revising an artifact by patch. */
9162
+ type ArtifactPatchSubjectResponse = z.infer<(typeof ArtifactSchemas$1)['patch']['response']>;
8762
9163
  /** Request payload for resolving an artifact by reference. */
8763
9164
  type ArtifactResolveRequest = z.infer<(typeof ArtifactSchemas$1)['resolve']['request']>;
8764
9165
  /** Response payload for resolving an artifact by reference. */
@@ -8787,12 +9188,39 @@ type ArtifactStatusChangedPayload = z.infer<(typeof ArtifactSchemas$1)['status.c
8787
9188
  type ArtifactKindChangedPayload = z.infer<(typeof ArtifactSchemas$1)['kind.changed']>;
8788
9189
  //#endregion
8789
9190
  //#region core/contracts/src/artifact/kind-paths.d.ts
9191
+ /** One schema declaration reachable at an inspected location. */
9192
+ type ArtifactSchemaFragment = boolean | Record<string, unknown>;
9193
+ /**
9194
+ * Location segment selecting one element of a declared array.
9195
+ *
9196
+ * Named-property paths cannot express it, so callers that address list entries
9197
+ * — a write addressing one collection entry, for instance — substitute this
9198
+ * token for the concrete position or match that selects the element. Schema
9199
+ * inspection is identical for either, because both resolve to the array's
9200
+ * declared item schema.
9201
+ *
9202
+ * The brackets are what make the token unambiguous: {@link ArtifactDataPathSchema}
9203
+ * admits no bracket in a property name, so no real property can be mistaken for
9204
+ * an element selector when a dotted path is split into segments.
9205
+ */
9206
+ declare const ARTIFACT_COLLECTION_ELEMENT_SEGMENT = "[]";
9207
+ /**
9208
+ * Inspect the serialized schema fragments selected by one data-relative location.
9209
+ *
9210
+ * Segments name object properties, or select one element of a declared array
9211
+ * through {@link ARTIFACT_COLLECTION_ELEMENT_SEGMENT}. Multiple fragments
9212
+ * represent the location's coverage across all schema variants.
9213
+ * @param dataSchema - Serialized artifact data schema.
9214
+ * @param segments - Data-relative location segments.
9215
+ * @returns Covered schema fragments, or undefined when the location is not declared in every variant.
9216
+ */
9217
+ declare function inspectArtifactDataLocation(dataSchema: Record<string, unknown>, segments: readonly string[]): readonly ArtifactSchemaFragment[] | undefined;
8790
9218
  /**
8791
9219
  * Determine whether a data-relative path is declared in every schema variant.
8792
9220
  *
8793
9221
  * Paths traverse named object properties only. A terminal array is valid and
8794
- * represents the complete original array; selecting its elements is outside
8795
- * this contract.
9222
+ * represents the complete original array; selecting its elements uses
9223
+ * {@link inspectArtifactDataLocation} with {@link ARTIFACT_COLLECTION_ELEMENT_SEGMENT}.
8796
9224
  * @param dataSchema - Serialized artifact data schema.
8797
9225
  * @param path - Data-relative object-property path.
8798
9226
  * @returns Whether the path is declared in every schema variant.
@@ -8806,6 +9234,507 @@ declare function isArtifactDataPathDeclared(dataSchema: Record<string, unknown>,
8806
9234
  */
8807
9235
  declare function readArtifactTitle(data: Record<string, unknown>, titlePath: string): string;
8808
9236
  //#endregion
9237
+ //#region core/contracts/src/artifact/patch.d.ts
9238
+ /**
9239
+ * Update operators this contract declares.
9240
+ *
9241
+ * The set is a deliberately narrow subset of Mongo update semantics. It is
9242
+ * closed: an operator outside this list is rejected by the request schema
9243
+ * rather than ignored, so a caller never believes an unsupported instruction
9244
+ * was carried out.
9245
+ */
9246
+ declare const ARTIFACT_PATCH_OPERATORS: readonly ["$set", "$unset", "$push", "$pull"];
9247
+ /** One declared update operator. */
9248
+ type ArtifactPatchOperator = (typeof ARTIFACT_PATCH_OPERATORS)[number];
9249
+ /**
9250
+ * A dot-separated location inside artifact `data`.
9251
+ *
9252
+ * The first segment is always an object property of `data`. Later segments are
9253
+ * an object property, a canonical array position (`tasks.3.title`), or an array
9254
+ * filter placeholder (`tasks.$[entry].title`) bound by `arrayFilters`. Filter
9255
+ * addressing is what keeps a write independent of the list order a caller read
9256
+ * earlier, so a concurrent insertion does not silently move the target.
9257
+ */
9258
+ declare const ArtifactPatchPathSchema: z.ZodString;
9259
+ /** What one segment of a patch path addresses. */
9260
+ type ArtifactPatchSegment = {
9261
+ readonly kind: 'property';
9262
+ readonly name: string;
9263
+ } | {
9264
+ readonly kind: 'index';
9265
+ readonly index: number;
9266
+ } | {
9267
+ readonly kind: 'filter';
9268
+ readonly placeholder: string;
9269
+ };
9270
+ /**
9271
+ * Classify one segment of a patch path.
9272
+ *
9273
+ * The grammar lives here alongside the pattern that admits it, so a caller
9274
+ * walking a path can never disagree with the schema that accepted it.
9275
+ * @param segment - One segment of a path already accepted by {@link ArtifactPatchPathSchema}.
9276
+ * @returns What the segment addresses.
9277
+ */
9278
+ declare function artifactPatchSegment(segment: string): ArtifactPatchSegment;
9279
+ /**
9280
+ * Split a patch path into its classified segments.
9281
+ * @param path - Path already accepted by {@link ArtifactPatchPathSchema}.
9282
+ * @returns One classified segment per path element, in order.
9283
+ */
9284
+ declare function artifactPatchSegments(path: string): ArtifactPatchSegment[];
9285
+ /**
9286
+ * List the array filter placeholders a patch path refers to.
9287
+ * @param path - Path already accepted by {@link ArtifactPatchPathSchema}.
9288
+ * @returns Placeholder names in order of appearance, with duplicates retained.
9289
+ */
9290
+ declare function artifactPatchPathFilterNames(path: string): string[];
9291
+ /**
9292
+ * One `arrayFilters` entry, restricted to equality on the matched element.
9293
+ *
9294
+ * Every key starts with the placeholder name this entry binds. The bare name
9295
+ * compares the whole element; `name.field.path` compares one property of it.
9296
+ * Comparison operators are outside the declared subset.
9297
+ */
9298
+ declare const ArtifactPatchArrayFilterSchema: z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>;
9299
+ /**
9300
+ * Read the placeholder name an array filter binds.
9301
+ * @param filter - One array filter entry.
9302
+ * @returns The single bound placeholder name, or undefined when the entry binds none or several.
9303
+ */
9304
+ declare function artifactPatchFilterName(filter: Record<string, unknown>): string | undefined;
9305
+ /** One instruction of a patch document: an operator, where it applies, and its operand. */
9306
+ interface ArtifactPatchInstruction {
9307
+ /** Operator to apply. */
9308
+ readonly operator: ArtifactPatchOperator;
9309
+ /** Path the operator applies to. */
9310
+ readonly path: string;
9311
+ /** Value or condition the caller wrote for this path. */
9312
+ readonly value: unknown;
9313
+ }
9314
+ /**
9315
+ * List every instruction of a patch document in application order.
9316
+ *
9317
+ * Operators run in the order {@link ARTIFACT_PATCH_OPERATORS} declares and,
9318
+ * within one operator, in the order the caller wrote its paths, so the same
9319
+ * document always produces the same result.
9320
+ *
9321
+ * The parameter is spelled structurally rather than as the document type,
9322
+ * because the document's own schema calls this while refining itself.
9323
+ * @param patch - Structurally valid patch operations.
9324
+ * @returns Operator, path and operand for each declared instruction.
9325
+ */
9326
+ declare function artifactPatchInstructions(patch: Readonly<Partial<Record<ArtifactPatchOperator, Readonly<Record<string, unknown>>>>>): ArtifactPatchInstruction[];
9327
+ /**
9328
+ * A complete patch document.
9329
+ *
9330
+ * Cross-field rules — at least one instruction, and placeholders matching their
9331
+ * filters exactly — are refinements. A JSON Schema rendering of this subject
9332
+ * therefore describes the operator set and the path grammar but not those
9333
+ * rules, exactly as for the other refined artifact contracts; the server
9334
+ * rejects a document that only the refinements catch.
9335
+ */
9336
+ declare const ArtifactPatchDocumentSchema: z.ZodObject<{
9337
+ $set: z.ZodOptional<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>;
9338
+ $unset: z.ZodOptional<z.ZodType<Record<string, true>, Record<string, true>, z.core.$ZodTypeInternals<Record<string, true>, Record<string, true>>>>;
9339
+ $push: z.ZodOptional<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>;
9340
+ $pull: z.ZodOptional<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>;
9341
+ arrayFilters: z.ZodOptional<z.ZodArray<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>>;
9342
+ }, z.core.$strict>;
9343
+ /** Identity of the artifact being revised; the revision travels as `baseRevision`. */
9344
+ declare const ArtifactPatchTargetSchema: z.ZodObject<{
9345
+ kind: z.ZodString;
9346
+ id: z.ZodString;
9347
+ }, z.core.$strict>;
9348
+ /**
9349
+ * Request one patch-based artifact revision.
9350
+ *
9351
+ * `baseRevision` is mandatory: the write applies to that exact revision or is
9352
+ * rejected, so a caller never overwrites a concurrent revision it never saw.
9353
+ * `statusPath` is the same caller-owned observation metadata a full `revise`
9354
+ * carries, so patching an artifact does not silently lose the status change a
9355
+ * host would otherwise emit. `schemaVersion` names the registration the
9356
+ * patched result is validated against and stored at; it defaults to the base
9357
+ * revision's, so a patch never changes an artifact's schema version unless the
9358
+ * caller asks for the migration.
9359
+ */
9360
+ declare const ArtifactPatchRequestSchema: z.ZodObject<{
9361
+ ref: z.ZodObject<{
9362
+ kind: z.ZodString;
9363
+ id: z.ZodString;
9364
+ }, z.core.$strict>;
9365
+ baseRevision: z.ZodString;
9366
+ patch: z.ZodObject<{
9367
+ $set: z.ZodOptional<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>;
9368
+ $unset: z.ZodOptional<z.ZodType<Record<string, true>, Record<string, true>, z.core.$ZodTypeInternals<Record<string, true>, Record<string, true>>>>;
9369
+ $push: z.ZodOptional<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>;
9370
+ $pull: z.ZodOptional<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>;
9371
+ arrayFilters: z.ZodOptional<z.ZodArray<z.ZodType<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>, z.core.$ZodTypeInternals<Record<string, _$_makaio_contracts0.JsonValue>, Record<string, _$_makaio_contracts0.JsonValue>>>>>;
9372
+ }, z.core.$strict>;
9373
+ dryRun: z.ZodOptional<z.ZodBoolean>;
9374
+ schemaVersion: z.ZodOptional<z.ZodNumber>;
9375
+ statusPath: z.ZodOptional<z.ZodString>;
9376
+ representations: z.ZodOptional<z.ZodNullable<z.ZodObject<{
9377
+ markdown: z.ZodOptional<z.ZodString>;
9378
+ summary: z.ZodOptional<z.ZodString>;
9379
+ plaintext: z.ZodOptional<z.ZodString>;
9380
+ }, z.core.$strict>>>;
9381
+ }, z.core.$strict>;
9382
+ /** Stable failure classifications for a patch request. */
9383
+ declare const ARTIFACT_PATCH_ERROR_CODES: readonly ["ARTIFACT_NOT_FOUND", "BASE_REVISION_CONFLICT", "KIND_NOT_REGISTERED", "SCHEMA_VERSION_MISMATCH", "PATH_NOT_DECLARED", "PATH_NOT_RESOLVABLE", "TARGET_NOT_A_COLLECTION", "UNSUPPORTED_TARGET", "NO_MATCH", "SCHEMA_VALIDATION_FAILED", "NO_CHANGE", "HOST_FAILED"];
9384
+ /** One reason the patched result was rejected, addressed within `data`. */
9385
+ declare const ArtifactPatchIssueSchema: z.ZodObject<{
9386
+ path: z.ZodString;
9387
+ reason: z.ZodString;
9388
+ expectedType: z.ZodOptional<z.ZodString>;
9389
+ allowedValues: z.ZodOptional<z.ZodArray<z.ZodType<_$_makaio_contracts0.JsonValue, _$_makaio_contracts0.JsonValue, z.core.$ZodTypeInternals<_$_makaio_contracts0.JsonValue, _$_makaio_contracts0.JsonValue>>>>;
9390
+ }, z.core.$strict>;
9391
+ /**
9392
+ * A rejected patch request.
9393
+ *
9394
+ * Every rejection names the failing location and carries a repair hint, so a
9395
+ * caller learns the next step from the rejection itself. The hint is what
9396
+ * distinguishes a correctable request from an outcome that is unknown, so it is
9397
+ * required rather than optional.
9398
+ *
9399
+ * A `BASE_REVISION_CONFLICT` additionally names the revision the artifact
9400
+ * carries: recovery from a conflict is rebasing onto that revision, so a
9401
+ * conflict without it would be unactionable. The schema enforces the pairing
9402
+ * rather than trusting each producer to remember it.
9403
+ */
9404
+ declare const ArtifactPatchErrorSchema: z.ZodObject<{
9405
+ code: z.ZodEnum<{
9406
+ ARTIFACT_NOT_FOUND: "ARTIFACT_NOT_FOUND";
9407
+ BASE_REVISION_CONFLICT: "BASE_REVISION_CONFLICT";
9408
+ KIND_NOT_REGISTERED: "KIND_NOT_REGISTERED";
9409
+ SCHEMA_VERSION_MISMATCH: "SCHEMA_VERSION_MISMATCH";
9410
+ PATH_NOT_DECLARED: "PATH_NOT_DECLARED";
9411
+ PATH_NOT_RESOLVABLE: "PATH_NOT_RESOLVABLE";
9412
+ TARGET_NOT_A_COLLECTION: "TARGET_NOT_A_COLLECTION";
9413
+ UNSUPPORTED_TARGET: "UNSUPPORTED_TARGET";
9414
+ NO_MATCH: "NO_MATCH";
9415
+ SCHEMA_VALIDATION_FAILED: "SCHEMA_VALIDATION_FAILED";
9416
+ NO_CHANGE: "NO_CHANGE";
9417
+ HOST_FAILED: "HOST_FAILED";
9418
+ }>;
9419
+ message: z.ZodString;
9420
+ operator: z.ZodOptional<z.ZodEnum<{
9421
+ $set: "$set";
9422
+ $unset: "$unset";
9423
+ $push: "$push";
9424
+ $pull: "$pull";
9425
+ }>>;
9426
+ path: z.ZodOptional<z.ZodString>;
9427
+ currentRevision: z.ZodOptional<z.ZodString>;
9428
+ issues: z.ZodOptional<z.ZodArray<z.ZodObject<{
9429
+ path: z.ZodString;
9430
+ reason: z.ZodString;
9431
+ expectedType: z.ZodOptional<z.ZodString>;
9432
+ allowedValues: z.ZodOptional<z.ZodArray<z.ZodType<_$_makaio_contracts0.JsonValue, _$_makaio_contracts0.JsonValue, z.core.$ZodTypeInternals<_$_makaio_contracts0.JsonValue, _$_makaio_contracts0.JsonValue>>>>;
9433
+ }, z.core.$strict>>>;
9434
+ repair: z.ZodString;
9435
+ }, z.core.$strict>;
9436
+ /** What one applied instruction did. */
9437
+ declare const ArtifactPatchOperationResultSchema: z.ZodObject<{
9438
+ operator: z.ZodEnum<{
9439
+ $set: "$set";
9440
+ $unset: "$unset";
9441
+ $push: "$push";
9442
+ $pull: "$pull";
9443
+ }>;
9444
+ path: z.ZodString;
9445
+ matched: z.ZodNumber;
9446
+ }, z.core.$strict>;
9447
+ /**
9448
+ * The schema versions a migrating patch moved the artifact between.
9449
+ *
9450
+ * The marker moves forward by construction, as every migration does: equal
9451
+ * versions would describe no transition and let an instructionless ordinary
9452
+ * success pass for a migration, and a lower target is a downgrade the tool
9453
+ * never performs.
9454
+ */
9455
+ declare const ArtifactPatchMigrationSchema: z.ZodObject<{
9456
+ from: z.ZodNumber;
9457
+ to: z.ZodNumber;
9458
+ }, z.core.$strict>;
9459
+ /** A patch that was applied, validated and discarded without producing history. */
9460
+ declare const ArtifactPatchDryRunSchema: z.ZodObject<{
9461
+ ok: z.ZodLiteral<true>;
9462
+ base: z.ZodObject<{
9463
+ refClass: z.ZodLiteral<"artifact">;
9464
+ kind: z.ZodString;
9465
+ id: z.ZodString;
9466
+ revision: z.ZodString;
9467
+ }, z.core.$strict>;
9468
+ operations: z.ZodArray<z.ZodObject<{
9469
+ operator: z.ZodEnum<{
9470
+ $set: "$set";
9471
+ $unset: "$unset";
9472
+ $push: "$push";
9473
+ $pull: "$pull";
9474
+ }>;
9475
+ path: z.ZodString;
9476
+ matched: z.ZodNumber;
9477
+ }, z.core.$strict>>;
9478
+ migration: z.ZodOptional<z.ZodObject<{
9479
+ from: z.ZodNumber;
9480
+ to: z.ZodNumber;
9481
+ }, z.core.$strict>>;
9482
+ dryRun: z.ZodLiteral<true>;
9483
+ }, z.core.$strict>;
9484
+ /** A patch that was applied, validated and persisted as a new revision. */
9485
+ declare const ArtifactPatchPersistedSchema: z.ZodObject<{
9486
+ ok: z.ZodLiteral<true>;
9487
+ base: z.ZodObject<{
9488
+ refClass: z.ZodLiteral<"artifact">;
9489
+ kind: z.ZodString;
9490
+ id: z.ZodString;
9491
+ revision: z.ZodString;
9492
+ }, z.core.$strict>;
9493
+ operations: z.ZodArray<z.ZodObject<{
9494
+ operator: z.ZodEnum<{
9495
+ $set: "$set";
9496
+ $unset: "$unset";
9497
+ $push: "$push";
9498
+ $pull: "$pull";
9499
+ }>;
9500
+ path: z.ZodString;
9501
+ matched: z.ZodNumber;
9502
+ }, z.core.$strict>>;
9503
+ migration: z.ZodOptional<z.ZodObject<{
9504
+ from: z.ZodNumber;
9505
+ to: z.ZodNumber;
9506
+ }, z.core.$strict>>;
9507
+ dryRun: z.ZodLiteral<false>;
9508
+ artifact: z.ZodObject<{
9509
+ refClass: z.ZodLiteral<"artifact">;
9510
+ kind: z.ZodString;
9511
+ id: z.ZodString;
9512
+ revision: z.ZodString;
9513
+ }, z.core.$strict>;
9514
+ }, z.core.$strict>;
9515
+ /**
9516
+ * An applied patch.
9517
+ *
9518
+ * The two variants keep `dryRun` and the new reference in step: a persisted
9519
+ * result always names its revision, and a dry run can never appear to have
9520
+ * produced one.
9521
+ */
9522
+ declare const ArtifactPatchSuccessSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
9523
+ ok: z.ZodLiteral<true>;
9524
+ base: z.ZodObject<{
9525
+ refClass: z.ZodLiteral<"artifact">;
9526
+ kind: z.ZodString;
9527
+ id: z.ZodString;
9528
+ revision: z.ZodString;
9529
+ }, z.core.$strict>;
9530
+ operations: z.ZodArray<z.ZodObject<{
9531
+ operator: z.ZodEnum<{
9532
+ $set: "$set";
9533
+ $unset: "$unset";
9534
+ $push: "$push";
9535
+ $pull: "$pull";
9536
+ }>;
9537
+ path: z.ZodString;
9538
+ matched: z.ZodNumber;
9539
+ }, z.core.$strict>>;
9540
+ migration: z.ZodOptional<z.ZodObject<{
9541
+ from: z.ZodNumber;
9542
+ to: z.ZodNumber;
9543
+ }, z.core.$strict>>;
9544
+ dryRun: z.ZodLiteral<true>;
9545
+ }, z.core.$strict>, z.ZodObject<{
9546
+ ok: z.ZodLiteral<true>;
9547
+ base: z.ZodObject<{
9548
+ refClass: z.ZodLiteral<"artifact">;
9549
+ kind: z.ZodString;
9550
+ id: z.ZodString;
9551
+ revision: z.ZodString;
9552
+ }, z.core.$strict>;
9553
+ operations: z.ZodArray<z.ZodObject<{
9554
+ operator: z.ZodEnum<{
9555
+ $set: "$set";
9556
+ $unset: "$unset";
9557
+ $push: "$push";
9558
+ $pull: "$pull";
9559
+ }>;
9560
+ path: z.ZodString;
9561
+ matched: z.ZodNumber;
9562
+ }, z.core.$strict>>;
9563
+ migration: z.ZodOptional<z.ZodObject<{
9564
+ from: z.ZodNumber;
9565
+ to: z.ZodNumber;
9566
+ }, z.core.$strict>>;
9567
+ dryRun: z.ZodLiteral<false>;
9568
+ artifact: z.ZodObject<{
9569
+ refClass: z.ZodLiteral<"artifact">;
9570
+ kind: z.ZodString;
9571
+ id: z.ZodString;
9572
+ revision: z.ZodString;
9573
+ }, z.core.$strict>;
9574
+ }, z.core.$strict>], "dryRun">;
9575
+ /**
9576
+ * A rejected patch.
9577
+ *
9578
+ * A rejection by the engine — an undeclared path, an unmatched filter, a result
9579
+ * the kind schema refuses — and a `BASE_REVISION_CONFLICT`, whether the stale
9580
+ * base revision was caught before the write or the store refused it, all
9581
+ * guarantee that nothing was persisted. `HOST_FAILED` does not: a host that
9582
+ * failed while persisting may have committed the write before the failure
9583
+ * surfaced, so the outcome is unknown and the caller must re-read before
9584
+ * retrying. The error's `repair` says which case this is.
9585
+ */
9586
+ declare const ArtifactPatchFailureSchema: z.ZodObject<{
9587
+ ok: z.ZodLiteral<false>;
9588
+ error: z.ZodObject<{
9589
+ code: z.ZodEnum<{
9590
+ ARTIFACT_NOT_FOUND: "ARTIFACT_NOT_FOUND";
9591
+ BASE_REVISION_CONFLICT: "BASE_REVISION_CONFLICT";
9592
+ KIND_NOT_REGISTERED: "KIND_NOT_REGISTERED";
9593
+ SCHEMA_VERSION_MISMATCH: "SCHEMA_VERSION_MISMATCH";
9594
+ PATH_NOT_DECLARED: "PATH_NOT_DECLARED";
9595
+ PATH_NOT_RESOLVABLE: "PATH_NOT_RESOLVABLE";
9596
+ TARGET_NOT_A_COLLECTION: "TARGET_NOT_A_COLLECTION";
9597
+ UNSUPPORTED_TARGET: "UNSUPPORTED_TARGET";
9598
+ NO_MATCH: "NO_MATCH";
9599
+ SCHEMA_VALIDATION_FAILED: "SCHEMA_VALIDATION_FAILED";
9600
+ NO_CHANGE: "NO_CHANGE";
9601
+ HOST_FAILED: "HOST_FAILED";
9602
+ }>;
9603
+ message: z.ZodString;
9604
+ operator: z.ZodOptional<z.ZodEnum<{
9605
+ $set: "$set";
9606
+ $unset: "$unset";
9607
+ $push: "$push";
9608
+ $pull: "$pull";
9609
+ }>>;
9610
+ path: z.ZodOptional<z.ZodString>;
9611
+ currentRevision: z.ZodOptional<z.ZodString>;
9612
+ issues: z.ZodOptional<z.ZodArray<z.ZodObject<{
9613
+ path: z.ZodString;
9614
+ reason: z.ZodString;
9615
+ expectedType: z.ZodOptional<z.ZodString>;
9616
+ allowedValues: z.ZodOptional<z.ZodArray<z.ZodType<_$_makaio_contracts0.JsonValue, _$_makaio_contracts0.JsonValue, z.core.$ZodTypeInternals<_$_makaio_contracts0.JsonValue, _$_makaio_contracts0.JsonValue>>>>;
9617
+ }, z.core.$strict>>>;
9618
+ repair: z.ZodString;
9619
+ }, z.core.$strict>;
9620
+ }, z.core.$strict>;
9621
+ /**
9622
+ * Outcome of a patch request.
9623
+ *
9624
+ * Rejections are in-band results rather than transport errors: they are the
9625
+ * expected way an agent learns which path to correct, and they must survive the
9626
+ * MCP facade unchanged.
9627
+ */
9628
+ declare const ArtifactPatchResponseSchema: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
9629
+ ok: z.ZodLiteral<true>;
9630
+ base: z.ZodObject<{
9631
+ refClass: z.ZodLiteral<"artifact">;
9632
+ kind: z.ZodString;
9633
+ id: z.ZodString;
9634
+ revision: z.ZodString;
9635
+ }, z.core.$strict>;
9636
+ operations: z.ZodArray<z.ZodObject<{
9637
+ operator: z.ZodEnum<{
9638
+ $set: "$set";
9639
+ $unset: "$unset";
9640
+ $push: "$push";
9641
+ $pull: "$pull";
9642
+ }>;
9643
+ path: z.ZodString;
9644
+ matched: z.ZodNumber;
9645
+ }, z.core.$strict>>;
9646
+ migration: z.ZodOptional<z.ZodObject<{
9647
+ from: z.ZodNumber;
9648
+ to: z.ZodNumber;
9649
+ }, z.core.$strict>>;
9650
+ dryRun: z.ZodLiteral<true>;
9651
+ }, z.core.$strict>, z.ZodObject<{
9652
+ ok: z.ZodLiteral<true>;
9653
+ base: z.ZodObject<{
9654
+ refClass: z.ZodLiteral<"artifact">;
9655
+ kind: z.ZodString;
9656
+ id: z.ZodString;
9657
+ revision: z.ZodString;
9658
+ }, z.core.$strict>;
9659
+ operations: z.ZodArray<z.ZodObject<{
9660
+ operator: z.ZodEnum<{
9661
+ $set: "$set";
9662
+ $unset: "$unset";
9663
+ $push: "$push";
9664
+ $pull: "$pull";
9665
+ }>;
9666
+ path: z.ZodString;
9667
+ matched: z.ZodNumber;
9668
+ }, z.core.$strict>>;
9669
+ migration: z.ZodOptional<z.ZodObject<{
9670
+ from: z.ZodNumber;
9671
+ to: z.ZodNumber;
9672
+ }, z.core.$strict>>;
9673
+ dryRun: z.ZodLiteral<false>;
9674
+ artifact: z.ZodObject<{
9675
+ refClass: z.ZodLiteral<"artifact">;
9676
+ kind: z.ZodString;
9677
+ id: z.ZodString;
9678
+ revision: z.ZodString;
9679
+ }, z.core.$strict>;
9680
+ }, z.core.$strict>], "dryRun">, z.ZodObject<{
9681
+ ok: z.ZodLiteral<false>;
9682
+ error: z.ZodObject<{
9683
+ code: z.ZodEnum<{
9684
+ ARTIFACT_NOT_FOUND: "ARTIFACT_NOT_FOUND";
9685
+ BASE_REVISION_CONFLICT: "BASE_REVISION_CONFLICT";
9686
+ KIND_NOT_REGISTERED: "KIND_NOT_REGISTERED";
9687
+ SCHEMA_VERSION_MISMATCH: "SCHEMA_VERSION_MISMATCH";
9688
+ PATH_NOT_DECLARED: "PATH_NOT_DECLARED";
9689
+ PATH_NOT_RESOLVABLE: "PATH_NOT_RESOLVABLE";
9690
+ TARGET_NOT_A_COLLECTION: "TARGET_NOT_A_COLLECTION";
9691
+ UNSUPPORTED_TARGET: "UNSUPPORTED_TARGET";
9692
+ NO_MATCH: "NO_MATCH";
9693
+ SCHEMA_VALIDATION_FAILED: "SCHEMA_VALIDATION_FAILED";
9694
+ NO_CHANGE: "NO_CHANGE";
9695
+ HOST_FAILED: "HOST_FAILED";
9696
+ }>;
9697
+ message: z.ZodString;
9698
+ operator: z.ZodOptional<z.ZodEnum<{
9699
+ $set: "$set";
9700
+ $unset: "$unset";
9701
+ $push: "$push";
9702
+ $pull: "$pull";
9703
+ }>>;
9704
+ path: z.ZodOptional<z.ZodString>;
9705
+ currentRevision: z.ZodOptional<z.ZodString>;
9706
+ issues: z.ZodOptional<z.ZodArray<z.ZodObject<{
9707
+ path: z.ZodString;
9708
+ reason: z.ZodString;
9709
+ expectedType: z.ZodOptional<z.ZodString>;
9710
+ allowedValues: z.ZodOptional<z.ZodArray<z.ZodType<_$_makaio_contracts0.JsonValue, _$_makaio_contracts0.JsonValue, z.core.$ZodTypeInternals<_$_makaio_contracts0.JsonValue, _$_makaio_contracts0.JsonValue>>>>;
9711
+ }, z.core.$strict>>>;
9712
+ repair: z.ZodString;
9713
+ }, z.core.$strict>;
9714
+ }, z.core.$strict>]>;
9715
+ /** One array filter entry restricted to equality matching. */
9716
+ type ArtifactPatchArrayFilter = z.infer<typeof ArtifactPatchArrayFilterSchema>;
9717
+ /** A complete patch document. */
9718
+ type ArtifactPatchDocument = z.infer<typeof ArtifactPatchDocumentSchema>;
9719
+ /** Artifact identity addressed by a patch request. */
9720
+ type ArtifactPatchTarget = z.infer<typeof ArtifactPatchTargetSchema>;
9721
+ /** Request payload for one patch-based artifact revision. */
9722
+ type ArtifactPatchRequest = z.infer<typeof ArtifactPatchRequestSchema>;
9723
+ /** Stable failure classification for a patch request. */
9724
+ type ArtifactPatchErrorCode = (typeof ARTIFACT_PATCH_ERROR_CODES)[number];
9725
+ /** One schema rejection of a patched result. */
9726
+ type ArtifactPatchIssue = z.infer<typeof ArtifactPatchIssueSchema>;
9727
+ /** A rejected patch request. */
9728
+ type ArtifactPatchError = z.infer<typeof ArtifactPatchErrorSchema>;
9729
+ /** What one applied instruction did. */
9730
+ type ArtifactPatchOperationResult = z.infer<typeof ArtifactPatchOperationResultSchema>;
9731
+ /** The schema versions a migrating patch moved the artifact between. */
9732
+ type ArtifactPatchMigration = z.infer<typeof ArtifactPatchMigrationSchema>;
9733
+ /** An applied patch outcome. */
9734
+ type ArtifactPatchSuccess = z.infer<typeof ArtifactPatchSuccessSchema>;
9735
+ /** Outcome of a patch request. */
9736
+ type ArtifactPatchResponse = z.infer<typeof ArtifactPatchResponseSchema>;
9737
+ //#endregion
8809
9738
  //#region core/contracts/src/artifact/lifecycle.d.ts
8810
9739
  /**
8811
9740
  * An artifact identity independent of its immutable content revisions. The `refClass`
@@ -10468,4 +11397,4 @@ type ArtifactLifecycleFailure = z.infer<typeof ArtifactLifecycleFailureSchema>;
10468
11397
  /** Supplemental reaction input following a rejected valid transition request. */
10469
11398
  type ArtifactLifecycleRejectedPayload = z.infer<typeof ArtifactLifecycleRejectedPayloadSchema>;
10470
11399
  //#endregion
10471
- export { ArtifactKindListResponse as $, ArtifactLifecycleHookEvent as $t, ArtifactLifecycleSituation as A, ResolvedArtifactContextWire$1 as At, ArtifactLifecycleVersionSchema as B, ArtifactDataValidator as Bt, ArtifactLifecycleHistoryEntry as C, ArtifactContextTree as Ct, ArtifactLifecycleInitializedEntrySchema as D, ArtifactContextRefEntrySchema as Dt, ArtifactLifecycleInitializedEntry as E, ArtifactContextRefEntry as Et, ArtifactLifecycleTransitionCommandSchema as F, ArtifactContextRelationSelectorSchema as Ft, readArtifactTitle as G, ArtifactOf as Gt, initialArtifactLifecycle as H, AnyArtifactKindDefinition as Ht, ArtifactLifecycleTransitionIntent as I, ArtifactContextRenderHint as It, ArtifactCreatedPayload as J, AfterArtifactHookRegistration as Jt, ArtifactCreateRequest as K, defineArtifactKind as Kt, ArtifactLifecycleTransitionIntentSchema as L, ArtifactContextRenderHintSchema as Lt, ArtifactLifecycleSnapshot as M, ARTIFACT_CONTEXT_RENDER_HINTS as Mt, ArtifactLifecycleSnapshotSchema as N, ArtifactContextKnownRenderHint as Nt, ArtifactLifecycleRejection as O, ArtifactContextUnresolvedReason as Ot, ArtifactLifecycleTransitionCommand as P, ArtifactContextRelationSelector as Pt, ArtifactKindListRequest as Q, ArtifactLifecycleHookDefinition as Qt, ArtifactLifecycleTransitionedEntry as R, ArtifactContextSelector$1 as Rt, ArtifactLifecycleError as S, ArtifactContextRootNode as St, ArtifactLifecycleIdentitySchema as T, UnresolvedArtifactContextNode as Tt, isArtifactLifecycleTransitionAllowed as U, ArtifactDataOf as Ut, advanceArtifactLifecycle as V, compileArtifactDataSchema as Vt, isArtifactDataPathDeclared as W, ArtifactKindDefinition as Wt, ArtifactEvidenceResolveResponse$1 as X, ArtifactDraftPatch as Xt, ArtifactEvidenceResolveRequest as Y, ArtifactDraft as Yt, ArtifactKindChangedPayload as Z, ArtifactHookFilter as Zt, ArtifactLifecycleTransitionResponseSchema as _, ArtifactSchemas$1 as _t, ArtifactLifecycleGetRequest as a, EvidenceOccurrence as an, ArtifactRelationAddedPayload as at, ArtifactLifecycleCurrent as b, hydrateArtifactContextTree as bt, ArtifactLifecycleGetResponseSchema as c, EvidenceResolveRequest as cn, ArtifactRelationTypeRegisterRequest as ct, ArtifactLifecycleHistoryResponse as d, EvidenceResolveResponseSchema as dn, ArtifactResolveContextResponse as dt, ArtifactLifecycleHookRegistration$1 as en, ArtifactKindRegisterRequest as et, ArtifactLifecycleHistoryResponseSchema as f, ARTIFACT_VALUE_TYPE_KEYWORD as fn, ArtifactResolveRequest as ft, ArtifactLifecycleTransitionResponse as g, ArtifactRevisedPayload as gt, ArtifactLifecycleSchemas as h, EvidenceValueSchema$1 as hn, ArtifactReviseResponse as ht, ArtifactLifecycleFailureSchema as i, defineArtifactLifecycleHooks as in, ArtifactQueryResponse as it, ArtifactLifecycleSituationSchema as j, ResolvedArtifactContextWireSchema as jt, ArtifactLifecycleRejectionSchema as k, ArtifactContextUnresolvedReasonSchema as kt, ArtifactLifecycleHistoryRequest as l, EvidenceResolveRequestSchema as ln, ArtifactRelationTypeRegisterResponse as lt, ArtifactLifecycleRejectedPayloadSchema as m, EvidenceValue$1 as mn, ArtifactReviseRequest as mt, ArtifactLifecycleCommittedPayloadSchema as n, BeforeArtifactHookContext as nn, ArtifactNamespace as nt, ArtifactLifecycleGetRequestSchema as o, EvidenceOccurrenceExtractionOptions as on, ArtifactRelationTypeListRequest as ot, ArtifactLifecycleRejectedPayload as p, EVIDENCE_VALUE_TYPE as pn, ArtifactResolveResponse as pt, ArtifactCreateResponse as q, AfterArtifactHookContext as qt, ArtifactLifecycleFailure as r, BeforeArtifactHookRegistration as rn, ArtifactObservationAddedPayload as rt, ArtifactLifecycleGetResponse as s, extractEvidenceOccurrences as sn, ArtifactRelationTypeListResponse as st, ArtifactLifecycleCommittedPayload as t, ArtifactLifecycleSemanticEvent as tn, ArtifactKindRegisterResponse as tt, ArtifactLifecycleHistoryRequestSchema as u, EvidenceResolveResponse as un, ArtifactResolveContextRequest as ut, toArtifactLifecycleFailure as v, ArtifactStatusChangedPayload as vt, ArtifactLifecycleHistoryEntrySchema as w, ResolvedArtifactContextNode as wt, ArtifactLifecycleCurrentSchema as x, ArtifactContextNode as xt, ARTIFACT_LIFECYCLE_REJECTED_CODE as y, ArtifactSubjects$1 as yt, ArtifactLifecycleTransitionedEntrySchema as z, ArtifactContextSelectorSchema as zt };
11400
+ export { ArtifactPatchErrorSchema as $, EvidenceResolveRequestSchema as $n, ArtifactResolveResponse as $t, ArtifactLifecycleSituation as A, compileArtifactDataChecker as An, ArtifactCreateRequest as At, ArtifactLifecycleVersionSchema as B, ArtifactDraftPatch as Bn, ArtifactNamespace as Bt, ArtifactLifecycleHistoryEntry as C, ArtifactContextRenderHintSchema as Cn, artifactPatchSegment as Ct, ArtifactLifecycleInitializedEntrySchema as D, ArtifactDataChecker as Dn, inspectArtifactDataLocation as Dt, ArtifactLifecycleInitializedEntry as E, ArtifactDataCheck as En, ArtifactSchemaFragment as Et, ArtifactLifecycleTransitionCommandSchema as F, ArtifactOf as Fn, ArtifactKindChangedPayload as Ft, ARTIFACT_PATCH_OPERATORS as G, ArtifactLifecycleSemanticEvent as Gn, ArtifactRelationAddedPayload as Gt, initialArtifactLifecycle as H, ArtifactLifecycleHookDefinition as Hn, ArtifactPatchSubjectRequest as Ht, ArtifactLifecycleTransitionIntent as I, defineArtifactKind as In, ArtifactKindListRequest as It, ArtifactPatchDocument as J, defineArtifactLifecycleHooks as Jn, ArtifactRelationTypeRegisterRequest as Jt, ArtifactPatchArrayFilter as K, BeforeArtifactHookContext as Kn, ArtifactRelationTypeListRequest as Kt, ArtifactLifecycleTransitionIntentSchema as L, AfterArtifactHookContext as Ln, ArtifactKindListResponse as Lt, ArtifactLifecycleSnapshot as M, AnyArtifactKindDefinition as Mn, ArtifactCreatedPayload as Mt, ArtifactLifecycleSnapshotSchema as N, ArtifactDataOf as Nn, ArtifactEvidenceResolveRequest as Nt, ArtifactLifecycleRejection as O, ArtifactDataIssue as On, isArtifactDataPathDeclared as Ot, ArtifactLifecycleTransitionCommand as P, ArtifactKindDefinition as Pn, ArtifactEvidenceResolveResponse$1 as Pt, ArtifactPatchErrorCode as Q, EvidenceResolveRequest as Qn, ArtifactResolveRequest as Qt, ArtifactLifecycleTransitionedEntry as R, AfterArtifactHookRegistration as Rn, ArtifactKindRegisterRequest as Rt, ArtifactLifecycleError as S, ArtifactContextRenderHint as Sn, artifactPatchPathFilterNames as St, ArtifactLifecycleIdentitySchema as T, ArtifactContextSelectorSchema as Tn, ARTIFACT_COLLECTION_ELEMENT_SEGMENT as Tt, isArtifactLifecycleTransitionAllowed as U, ArtifactLifecycleHookEvent as Un, ArtifactPatchSubjectResponse as Ut, advanceArtifactLifecycle as V, ArtifactHookFilter as Vn, ArtifactObservationAddedPayload as Vt, ARTIFACT_PATCH_ERROR_CODES as W, ArtifactLifecycleHookRegistration$1 as Wn, ArtifactQueryResponse as Wt, ArtifactPatchDryRunSchema as X, EvidenceOccurrenceExtractionOptions as Xn, ArtifactResolveContextRequest as Xt, ArtifactPatchDocumentSchema as Y, EvidenceOccurrence as Yn, ArtifactRelationTypeRegisterResponse as Yt, ArtifactPatchError as Z, extractEvidenceOccurrences as Zn, ArtifactResolveContextResponse as Zt, ArtifactLifecycleTransitionResponseSchema as _, ResolvedArtifactContextWireSchema as _n, ArtifactPatchSuccessSchema as _t, ArtifactLifecycleGetRequest as a, ArtifactSubjects$1 as an, EvidenceValueSchema$1 as ar, ArtifactPatchMigrationSchema as at, ArtifactLifecycleCurrent as b, ArtifactContextRelationSelector as bn, artifactPatchFilterName as bt, ArtifactLifecycleGetResponseSchema as c, ArtifactContextRootNode as cn, ArtifactPatchOperator as ct, ArtifactLifecycleHistoryResponse as d, UnresolvedArtifactContextNode as dn, ArtifactPatchRequest as dt, ArtifactReviseRequest as en, EvidenceResolveResponse as er, ArtifactPatchFailureSchema as et, ArtifactLifecycleHistoryResponseSchema as f, ArtifactContextRefEntry as fn, ArtifactPatchRequestSchema as ft, ArtifactLifecycleTransitionResponse as g, ResolvedArtifactContextWire$1 as gn, ArtifactPatchSuccess as gt, ArtifactLifecycleSchemas as h, ArtifactContextUnresolvedReasonSchema as hn, ArtifactPatchSegment as ht, ArtifactLifecycleFailureSchema as i, ArtifactStatusChangedPayload as in, EvidenceValue$1 as ir, ArtifactPatchMigration as it, ArtifactLifecycleSituationSchema as j, compileArtifactDataSchema as jn, ArtifactCreateResponse as jt, ArtifactLifecycleRejectionSchema as k, ArtifactDataValidator as kn, readArtifactTitle as kt, ArtifactLifecycleHistoryRequest as l, ArtifactContextTree as ln, ArtifactPatchPathSchema as lt, ArtifactLifecycleRejectedPayloadSchema as m, ArtifactContextUnresolvedReason as mn, ArtifactPatchResponseSchema as mt, ArtifactLifecycleCommittedPayloadSchema as n, ArtifactRevisedPayload as nn, ARTIFACT_VALUE_TYPE_KEYWORD as nr, ArtifactPatchIssue as nt, ArtifactLifecycleGetRequestSchema as o, hydrateArtifactContextTree as on, ArtifactPatchOperationResult as ot, ArtifactLifecycleRejectedPayload as p, ArtifactContextRefEntrySchema as pn, ArtifactPatchResponse as pt, ArtifactPatchArrayFilterSchema as q, BeforeArtifactHookRegistration as qn, ArtifactRelationTypeListResponse as qt, ArtifactLifecycleFailure as r, ArtifactSchemas$1 as rn, EVIDENCE_VALUE_TYPE as rr, ArtifactPatchIssueSchema as rt, ArtifactLifecycleGetResponse as s, ArtifactContextNode as sn, ArtifactPatchOperationResultSchema as st, ArtifactLifecycleCommittedPayload as t, ArtifactReviseResponse as tn, EvidenceResolveResponseSchema as tr, ArtifactPatchInstruction as tt, ArtifactLifecycleHistoryRequestSchema as u, ResolvedArtifactContextNode as un, ArtifactPatchPersistedSchema as ut, toArtifactLifecycleFailure as v, ARTIFACT_CONTEXT_RENDER_HINTS as vn, ArtifactPatchTarget as vt, ArtifactLifecycleHistoryEntrySchema as w, ArtifactContextSelector$1 as wn, artifactPatchSegments as wt, ArtifactLifecycleCurrentSchema as x, ArtifactContextRelationSelectorSchema as xn, artifactPatchInstructions as xt, ARTIFACT_LIFECYCLE_REJECTED_CODE as y, ArtifactContextKnownRenderHint as yn, ArtifactPatchTargetSchema as yt, ArtifactLifecycleTransitionedEntrySchema as z, ArtifactDraft as zn, ArtifactKindRegisterResponse as zt };