ankhorage · artiphishle · Aug 11, 2026 · Aug 10, 2026 · Aug 10, 2026 · Aug 10, 2026
diff --git a/.changeset/adm-6-binding-authoring.md b/.changeset/adm-6-binding-authoring.md
@@ -0,0 +1,5 @@
+---
+'@ankhorage/studio': minor
+---
+
+Restore contextual component binding authoring with ZORA-owned bindable metadata, canonical manifest data bindings, uniform external/generated operation selection, schema-aware response paths, event payload input mapping, and binding diagnostics while keeping execution in Runtime.
diff --git a/README.md b/README.md
@@ -3,7 +3,7 @@
 
 # @ankhorage/studio
 
-![license: MIT](././paradox/badges/license.svg) ![npm: v0.12.0](././paradox/badges/npm.svg) ![runtime: bun](././paradox/badges/runtime.svg) ![typescript: strict](././paradox/badges/typescript.svg) ![eslint: checked](././paradox/badges/eslint.svg) ![prettier: checked](././paradox/badges/prettier.svg) ![build: checked](././paradox/badges/build.svg) ![tests: checked](././paradox/badges/tests.svg) ![docs: paradox](././paradox/badges/docs.svg)
+![license: MIT](././paradox/badges/license.svg) ![npm: v0.13.0](././paradox/badges/npm.svg) ![runtime: bun](././paradox/badges/runtime.svg) ![typescript: strict](././paradox/badges/typescript.svg) ![eslint: checked](././paradox/badges/eslint.svg) ![prettier: checked](././paradox/badges/prettier.svg) ![build: checked](././paradox/badges/build.svg) ![tests: checked](././paradox/badges/tests.svg) ![docs: paradox](././paradox/badges/docs.svg)
 
 Standalone Studio authoring package for Ankhorage apps.
 
@@ -30,12 +30,20 @@ Manage Studio development and projects through the Ankh CLI.
 - [Module relationships](././paradox/diagrams/module-relationships.mmd)
 - [Export graph](././paradox/diagrams/export-graph.mmd)
 - [addNodeToTree sequence](././paradox/diagrams/sequences/add-node-to-tree.mmd)
+- [appendStudioEventBinding sequence](././paradox/diagrams/sequences/append-studio-event-binding.mmd)
+- [assessStudioBindingCompatibility sequence](././paradox/diagrams/sequences/assess-studio-binding-compatibility.mmd)
 - [buildInsertCatalogEntries sequence](././paradox/diagrams/sequences/build-insert-catalog-entries.mmd)
 - [cloneWithNewIds sequence](././paradox/diagrams/sequences/clone-with-new-ids.mmd)
+- [collectStudioResponsePaths sequence](././paradox/diagrams/sequences/collect-studio-response-paths.mmd)
 - [createNodeFromCatalogEntry sequence](././paradox/diagrams/sequences/create-node-from-catalog-entry.mmd)
+- [diagnoseStudioComponentBindings sequence](././paradox/diagrams/sequences/diagnose-studio-component-bindings.mmd)
 - [findNodeById sequence](././paradox/diagrams/sequences/find-node-by-id.mmd)
+- [removeStudioEventBinding sequence](././paradox/diagrams/sequences/remove-studio-event-binding.mmd)
+- [removeStudioPropBinding sequence](././paradox/diagrams/sequences/remove-studio-prop-binding.mmd)
 - [resolveStudioInstancePropertyGroups sequence](././paradox/diagrams/sequences/resolve-studio-instance-property-groups.mmd)
+- [resolveStudioSchemaValueMeta sequence](././paradox/diagrams/sequences/resolve-studio-schema-value-meta.mmd)
 - [updateNodeInTree sequence](././paradox/diagrams/sequences/update-node-in-tree.mmd)
+- [upsertStudioPropBinding sequence](././paradox/diagrams/sequences/upsert-studio-prop-binding.mmd)
 - [validateInsertRecipe sequence](././paradox/diagrams/sequences/validate-insert-recipe.mmd)
 - [validateNodePlacement sequence](././paradox/diagrams/sequences/validate-node-placement.mmd)
 - [validateProjectCreationInput sequence](././paradox/diagrams/sequences/validate-project-creation-input.mmd)
diff --git a/docs/binding-authoring.md b/docs/binding-authoring.md
@@ -0,0 +1,27 @@
+# Binding authoring
+
+Studio exposes one contextual binding surface at `/ankh/bindings/:nodeId`. It is opened from the selected component through the Studio AppBar and is intentionally separate from the Properties editor.
+
+## Ownership
+
+Studio owns authoring UX and manifest mutation only. Canonical binding shapes come from `@ankhorage/contracts`, bindable component props/events and event payload metadata come from ZORA, and binding execution remains in `@ankhorage/runtime`.
+
+Studio does not maintain a second endpoint registry, event schema registry, or binding executor.
+
+## Property/data bindings
+
+The editor only exposes properties declared in `ZORA_BINDABLE_COMPONENT_META`. Authored bindings persist in `manifest.dataBindings` and support the canonical literal, state, context, and operation-result sources.
+
+Operation-result bindings enumerate normalized `manifest.dataSources` uniformly, so external and generated APIs use the same authoring path. Response paths are derived from canonical operation response schemas and compared against ZORA bindable value metadata.
+
+## Event/action bindings
+
+The editor only exposes events declared by ZORA binding metadata. Events can target canonical actions or canonical data-source operations.
+
+Known event payload fields are surfaced from ZORA. Action payload fields come from Studio's existing action authoring metadata, while operation request inputs come from canonical operation request schemas. Inputs can use literal values or event payload paths, including nested paths beneath object/record payload fields.
+
+## Diagnostics
+
+Studio resolves operation references against the same normalized operation catalog used by the authoring selectors. Missing operation references, response paths, required operation inputs, incompatible response/input values, unknown bindable props/events, and unavailable actions are surfaced as authoring diagnostics.
+
+Diagnostics never execute operations and do not reproduce Runtime execution logic. Runtime remains the only execution owner.
diff --git a/package.json b/package.json
@@ -140,6 +140,10 @@
       "types": "./dist/manifestState.d.ts",
       "import": "./dist/manifestState.js"
     },
+    "./bindingAuthoringModel": {
+      "types": "./dist/bindingAuthoringModel.d.ts",
+      "import": "./dist/bindingAuthoringModel.js"
+    },
     "./propertiesAuthoringModel": {
       "types": "./dist/propertiesAuthoringModel.d.ts",
       "import": "./dist/propertiesAuthoringModel.js"

diff --git a/paradox/badges/npm.svg b/paradox/badges/npm.svg
diff --git a/paradox/diagrams/architecture-overview.mmd b/paradox/diagrams/architecture-overview.mmd
@@ -75,6 +75,38 @@ graph TD
   module_src_authSettings_test_ts --> module_src_authSettings_ts
   module_src_authSettings_ts["src/authSettings.ts"]
   package__ankhorage_studio -.-> module_src_authSettings_ts
+  module_src_bindingAuthoringContracts_ts["src/bindingAuthoringContracts.ts"]
+  package__ankhorage_studio -.-> module_src_bindingAuthoringContracts_ts
+  module_src_bindingAuthoringModel_test_ts["src/bindingAuthoringModel.test.ts"]
+  package__ankhorage_studio -.-> module_src_bindingAuthoringModel_test_ts
+  module_src_bindingAuthoringModel_test_ts --> module_src_bindingAuthoringModel_ts
+  module_src_bindingAuthoringModel_ts["src/bindingAuthoringModel.ts"]
+  package__ankhorage_studio -.-> module_src_bindingAuthoringModel_ts
+  module_src_bindingDiagnosticsModel_ts["src/bindingDiagnosticsModel.ts"]
+  package__ankhorage_studio -.-> module_src_bindingDiagnosticsModel_ts
+  module_src_bindingDiagnosticsModel_ts --> module_src_bindingAuthoringContracts_ts
+  module_src_bindingDiagnosticsModel_ts --> module_src_bindingOperationModel_ts
+  module_src_bindingDiagnosticsModel_ts --> module_src_bindingSchemaModel_ts
+  module_src_bindingManifestPersistence_test_ts["src/bindingManifestPersistence.test.ts"]
+  package__ankhorage_studio -.-> module_src_bindingManifestPersistence_test_ts
+  module_src_bindingManifestPersistence_test_ts --> module_src_core_studioManifestDraftModel_ts
+  module_src_bindingManifestPersistence_test_ts --> module_src_index_ts
+  module_src_bindingManifestPersistence_test_ts --> module_src_manifestSync_ts
+  module_src_bindingMetadataModel_ts["src/bindingMetadataModel.ts"]
+  package__ankhorage_studio -.-> module_src_bindingMetadataModel_ts
+  module_src_bindingMetadataModel_ts --> module_src_bindingAuthoringContracts_ts
+  module_src_bindingMutationAcceptance_test_ts["src/bindingMutationAcceptance.test.ts"]
+  package__ankhorage_studio -.-> module_src_bindingMutationAcceptance_test_ts
+  module_src_bindingMutationAcceptance_test_ts --> module_src_bindingAuthoringModel_ts
+  module_src_bindingMutationModel_ts["src/bindingMutationModel.ts"]
+  package__ankhorage_studio -.-> module_src_bindingMutationModel_ts
+  module_src_bindingOperationModel_ts["src/bindingOperationModel.ts"]
+  package__ankhorage_studio -.-> module_src_bindingOperationModel_ts
+  module_src_bindingOperationModel_ts --> module_src_bindingAuthoringContracts_ts
+  module_src_bindingOperationModel_ts --> module_src_bindingSchemaModel_ts
+  module_src_bindingSchemaModel_ts["src/bindingSchemaModel.ts"]
+  package__ankhorage_studio -.-> module_src_bindingSchemaModel_ts
+  module_src_bindingSchemaModel_ts --> module_src_bindingAuthoringContracts_ts
   module_src_canvasDragModel_public_test_ts["src/canvasDragModel.public.test.ts"]
   package__ankhorage_studio -.-> module_src_canvasDragModel_public_test_ts
   module_src_canvasDragModel_public_test_ts --> module_src_canvasDragModel_ts
@@ -847,6 +879,7 @@ graph TD
   module_src_ui_admin_AnkhAdminPage_tsx --> module_src_studioAdminRouteModel_ts
   module_src_ui_admin_AnkhAdminPage_tsx --> module_src_ui_admin_pages_ApisAdminPage_tsx
   module_src_ui_admin_AnkhAdminPage_tsx --> module_src_ui_admin_pages_AuthAdminPage_tsx
+  module_src_ui_admin_AnkhAdminPage_tsx --> module_src_ui_admin_pages_BindingsAdminPage_tsx
   module_src_ui_admin_AnkhAdminPage_tsx --> module_src_ui_admin_pages_OverviewAdminPage_tsx
   module_src_ui_admin_AnkhAdminPage_tsx --> module_src_ui_admin_pages_PropertiesAdminPage_tsx
   module_src_ui_admin_AnkhAdminPage_tsx --> module_src_ui_admin_pages_SecretsAdminPage_tsx
@@ -926,6 +959,48 @@ graph TD
   module_src_ui_admin_pages_AuthAdminPage_tsx --> module_src_ui_admin_pages_adminAuthCredentialFlow_ts
   module_src_ui_admin_pages_AuthAdminPage_tsx --> module_src_ui_admin_pages_adminAuthHealthFlow_ts
   module_src_ui_admin_pages_AuthAdminPage_tsx --> module_src_ui_admin_pages_adminAuthSessionModel_ts
+  module_src_ui_admin_pages_bindings_bindingAdminStyles_ts["src/ui/admin/pages/bindings/bindingAdminStyles.ts"]
+  package__ankhorage_studio -.-> module_src_ui_admin_pages_bindings_bindingAdminStyles_ts
+  module_src_ui_admin_pages_bindings_BindingDiagnosticsCard_tsx["src/ui/admin/pages/bindings/BindingDiagnosticsCard.tsx"]
+  package__ankhorage_studio -.-> module_src_ui_admin_pages_bindings_BindingDiagnosticsCard_tsx
+  module_src_ui_admin_pages_bindings_BindingDiagnosticsCard_tsx --> module_src_bindingAuthoringModel_ts
+  module_src_ui_admin_pages_bindings_BindingDiagnosticsCard_tsx --> module_src_ui_admin_pages_bindings_bindingAdminStyles_ts
+  module_src_ui_admin_pages_bindings_bindingEditorModel_ts["src/ui/admin/pages/bindings/bindingEditorModel.ts"]
+  package__ankhorage_studio -.-> module_src_ui_admin_pages_bindings_bindingEditorModel_ts
+  module_src_ui_admin_pages_bindings_bindingEditorModel_ts --> module_src_bindingAuthoringModel_ts
+  module_src_ui_admin_pages_bindings_EventBindingComposer_tsx["src/ui/admin/pages/bindings/EventBindingComposer.tsx"]
+  package__ankhorage_studio -.-> module_src_ui_admin_pages_bindings_EventBindingComposer_tsx
+  module_src_ui_admin_pages_bindings_EventBindingComposer_tsx --> module_src_bindingAuthoringModel_ts
+  module_src_ui_admin_pages_bindings_EventBindingComposer_tsx --> module_src_index_ts
+  module_src_ui_admin_pages_bindings_EventBindingComposer_tsx --> module_src_ui_admin_adminPagePrimitives_tsx
+  module_src_ui_admin_pages_bindings_EventBindingComposer_tsx --> module_src_ui_admin_pages_bindings_bindingAdminStyles_ts
+  module_src_ui_admin_pages_bindings_EventBindingComposer_tsx --> module_src_ui_admin_pages_bindings_bindingEditorModel_ts
+  module_src_ui_admin_pages_bindings_EventBindingsCard_tsx["src/ui/admin/pages/bindings/EventBindingsCard.tsx"]
+  package__ankhorage_studio -.-> module_src_ui_admin_pages_bindings_EventBindingsCard_tsx
+  module_src_ui_admin_pages_bindings_EventBindingsCard_tsx --> module_src_bindingAuthoringModel_ts
+  module_src_ui_admin_pages_bindings_EventBindingsCard_tsx --> module_src_ui_admin_pages_bindings_bindingAdminStyles_ts
+  module_src_ui_admin_pages_bindings_EventBindingsCard_tsx --> module_src_ui_admin_pages_bindings_EventBindingComposer_tsx
+  module_src_ui_admin_pages_bindings_PropertyBindingEditor_tsx["src/ui/admin/pages/bindings/PropertyBindingEditor.tsx"]
+  package__ankhorage_studio -.-> module_src_ui_admin_pages_bindings_PropertyBindingEditor_tsx
+  module_src_ui_admin_pages_bindings_PropertyBindingEditor_tsx --> module_src_bindingAuthoringModel_ts
+  module_src_ui_admin_pages_bindings_PropertyBindingEditor_tsx --> module_src_ui_admin_adminPagePrimitives_tsx
+  module_src_ui_admin_pages_bindings_PropertyBindingEditor_tsx --> module_src_ui_admin_pages_bindings_bindingAdminStyles_ts
+  module_src_ui_admin_pages_bindings_PropertyBindingEditor_tsx --> module_src_ui_admin_pages_bindings_bindingEditorModel_ts
+  module_src_ui_admin_pages_bindings_PropertyBindingsCard_tsx["src/ui/admin/pages/bindings/PropertyBindingsCard.tsx"]
+  package__ankhorage_studio -.-> module_src_ui_admin_pages_bindings_PropertyBindingsCard_tsx
+  module_src_ui_admin_pages_bindings_PropertyBindingsCard_tsx --> module_src_bindingAuthoringModel_ts
+  module_src_ui_admin_pages_bindings_PropertyBindingsCard_tsx --> module_src_ui_admin_pages_bindings_bindingAdminStyles_ts
+  module_src_ui_admin_pages_bindings_PropertyBindingsCard_tsx --> module_src_ui_admin_pages_bindings_PropertyBindingEditor_tsx
+  module_src_ui_admin_pages_BindingsAdminPage_tsx["src/ui/admin/pages/BindingsAdminPage.tsx"]
+  package__ankhorage_studio -.-> module_src_ui_admin_pages_BindingsAdminPage_tsx
+  module_src_ui_admin_pages_BindingsAdminPage_tsx --> module_src_bindingAuthoringModel_ts
+  module_src_ui_admin_pages_BindingsAdminPage_tsx --> module_src_core_StudioContext_ts
+  module_src_ui_admin_pages_BindingsAdminPage_tsx --> module_src_index_ts
+  module_src_ui_admin_pages_BindingsAdminPage_tsx --> module_src_manifestState_ts
+  module_src_ui_admin_pages_BindingsAdminPage_tsx --> module_src_ui_admin_adminPagePrimitives_tsx
+  module_src_ui_admin_pages_BindingsAdminPage_tsx --> module_src_ui_admin_pages_bindings_BindingDiagnosticsCard_tsx
+  module_src_ui_admin_pages_BindingsAdminPage_tsx --> module_src_ui_admin_pages_bindings_EventBindingsCard_tsx
+  module_src_ui_admin_pages_BindingsAdminPage_tsx --> module_src_ui_admin_pages_bindings_PropertyBindingsCard_tsx
   module_src_ui_admin_pages_DataSourceCatalogCard_tsx["src/ui/admin/pages/DataSourceCatalogCard.tsx"]
   package__ankhorage_studio -.-> module_src_ui_admin_pages_DataSourceCatalogCard_tsx
   module_src_ui_admin_pages_DataSourceCatalogCard_tsx --> module_src_ui_admin_pages_ExternalApiAdminPrimitives_tsx