@jay-framework/aiditor 0.19.7 → 0.21.0

package/dist/actions/cancel-agent-task.jay-action

@@ -4,6 +4,7 @@ description: Cancel the in-flight AI agent task for a page route
 inputSchema:
   pageRoute?: string
   renderedUrl?: string
+  cancelKey?: string
 
 outputSchema:
   cancelled: boolean

package/dist/actions/cancel-agent-task.jay-action.d.ts

@@ -1,6 +1,7 @@
 export interface CancelAgentTaskActionInput {
   pageRoute?: string;
   renderedUrl?: string;
+  cancelKey?: string;
 }
 
 export interface CancelAgentTaskActionOutput {

package/dist/actions/get-contract-inspector-tags.jay-action

@@ -0,0 +1,9 @@
+name: getContractInspectorTagsAction
+description: Resolve contract tags for Page Info component explorer
+
+inputSchema:
+  pluginName: string
+  contractName: string
+
+outputSchema:
+  tags: array

package/dist/actions/get-contract-inspector-tags.jay-action.d.ts

@@ -0,0 +1,6 @@
+export interface GetContractInspectorTagsActionInput {
+  pluginName: string;
+  contractName: string;
+}
+
+export type GetContractInspectorTagsActionOutput = Record<string, unknown>;

package/dist/actions/get-page-assets.jay-action

@@ -0,0 +1,10 @@
+name: getPageAssetsAction
+description: Load page assets registry for an agent context key
+
+inputSchema:
+  contextKey: string
+  pageRoute: string
+  renderedUrl: string
+
+outputSchema:
+  file: object

package/dist/actions/get-page-assets.jay-action.d.ts

@@ -0,0 +1,7 @@
+export interface GetPageAssetsActionInput {
+  contextKey: string;
+  pageRoute: string;
+  renderedUrl: string;
+}
+
+export type GetPageAssetsActionOutput = Record<string, unknown>;

package/dist/actions/get-page-meta.jay-action

@@ -0,0 +1,9 @@
+name: getPageMetaAction
+description: Load page meta (route migration) for an agent context key
+
+inputSchema:
+  contextKey: string
+  pageRoute: string
+
+outputSchema:
+  file: object

package/dist/actions/get-page-meta.jay-action.d.ts

@@ -0,0 +1,6 @@
+export interface GetPageMetaActionInput {
+  contextKey: string;
+  pageRoute: string;
+}
+
+export type GetPageMetaActionOutput = Record<string, unknown>;

package/dist/actions/save-page-assets.jay-action

@@ -0,0 +1,8 @@
+name: savePageAssetsAction
+description: Persist page assets registry for an agent context key
+
+inputSchema:
+  file: object
+
+outputSchema:
+  ok: boolean

package/dist/actions/save-page-assets.jay-action.d.ts

@@ -0,0 +1,5 @@
+export interface SavePageAssetsActionInput {}
+
+export interface SavePageAssetsActionOutput {
+  ok: boolean;
+}

package/dist/actions/save-page-meta.jay-action

@@ -0,0 +1,8 @@
+name: savePageMetaAction
+description: Save page meta (route migration) for an agent context key
+
+inputSchema:
+  file: object
+
+outputSchema:
+  ok: boolean

package/dist/actions/save-page-meta.jay-action.d.ts

@@ -0,0 +1,5 @@
+export interface SavePageMetaActionInput {}
+
+export interface SavePageMetaActionOutput {
+  ok: boolean;
+}

package/dist/actions/sync-detected-page-assets.jay-action

@@ -0,0 +1,12 @@
+name: syncDetectedPageAssetsAction
+description: Merge auto-detected page components into page assets registry
+
+inputSchema:
+  contextKey: string
+  pageRoute: string
+  renderedUrl: string
+  jayHtmlPath: string
+
+outputSchema:
+  file: object
+  detectedCount: number

package/dist/actions/sync-detected-page-assets.jay-action.d.ts

@@ -0,0 +1,10 @@
+export interface SyncDetectedPageAssetsActionInput {
+  contextKey: string;
+  pageRoute: string;
+  renderedUrl: string;
+  jayHtmlPath: string;
+}
+
+export interface SyncDetectedPageAssetsActionOutput {
+  detectedCount: number;
+}

package/dist/agent-kit-template/plugin/aiditor-add-menu.md

@@ -36,8 +36,32 @@ items:
     packageName: "@jay-framework/wix-stores"
     subCategory: Components # optional navigation
     thumbnail: thumbnails/... # optional UI hint
+    interaction: # optional — Design Log #25
+      mode: reference | stage-place
+      persistOnPage: true # deprecated DL #26 — accepted but ignored
+      stagePromptTemplate: | # stage-place only — prefilled marker instruction
+        Add spring effect at this location.
 ```
 
+**`interaction` (optional, DL #25):**
+
+| Field                 | Values                                                                        | Default     |
+| --------------------- | ----------------------------------------------------------------------------- | ----------- |
+| `mode`                | `reference` — `@` mention in markers; click in + Add dock when marker focused | `reference` |
+|                       | `stage-place` — click or drag onto preview creates a marker                   |             |
+| `persistOnPage`       | **Deprecated (DL #26)** — ignored; no disk registry                           | n/a         |
+| `stagePromptTemplate` | Prefilled marker instruction for `stage-place`                                | item title  |
+
+## AIditor surfaces (DL #26)
+
+| Surface              | Purpose                                               | Plugin guidance                                                                                                                    |
+| -------------------- | ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
+| **Page Info**        | Route + components from `jay-html`; contract explorer | Headless contracts appear automatically when in template; no catalog entry required for detection                                  |
+| **+ Add dock**       | Visual placement                                      | `interaction.mode: stage-place` + `stagePromptTemplate` for effects/media that land on canvas                                      |
+| **`@` autocomplete** | Full catalog reference                                | `mode: reference` (default); categories / high-cardinality → rely on `@` only (`subCategory: Categories` filtered from + Add grid) |
+
+Do **not** rely on page Assets registry or `persistOnPage` for disk persistence — request-level `addMenuAttachments` and `pageComponents` (from `jay-html`) are submitted instead.
+
 **Required:** `id`, `title`, `category`, `prompt`
 
 **Rejected (anti-patterns):** `kind`, `parameters`, `component`, `allowedScopes`, `{{parameters.*}}`