@aexol/opencode-wizard 0.3.4 → 0.3.6

package/README.md

@@ -9,7 +9,7 @@
 - `./tui` → `dist/tui.js`
 - no generated runtime skill directory is published; the plugin stays fetch-only at runtime
 - native OpenCode `skills.urls` is treated as a public/static registry complement, not as the private wizard delivery authority
-- the TUI shows loaded plugins, current paths, backend/auth status without tokens, available tools, `skills.urls` guidance, the backend-published GLOBAL/PROJECT delivery model, policy labels, and catalog counts/names when passive fetch succeeds
+- the TUI is a minimalist information-only panel showing backend/auth/catalog status without exposing install, ignore, import, publish, or preference actions
 
 ## Local development
 
@@ -42,21 +42,25 @@ For repo-local development, continue using the local path-based config already d
 
 OpenCode's native `skills.urls` support downloads public/static skill registries from base URLs that expose an `index.json` and file paths under that base URL. Current support has no plugin session/header integration, so it must not be pointed at private opencode-wizard skill delivery.
 
-Use `skills.urls` only for public registries that are intentionally cacheable by OpenCode. Private workspace-scoped wizard skills remain authenticated and directory-scoped through `opencode_wizard_published_skills_fetch`.
+Use `skills.urls` only for public registries that are intentionally cacheable by OpenCode. Private workspace-scoped wizard artifacts remain authenticated and directory-scoped through `opencode_wizard_artifact_fetch` or compatibility `opencode_wizard_published_skills_fetch`; same-named native/local seed skill bodies are not authoritative for wizard-listed skills.
 
 ## Catalog discovery and auth bootstrap
 
-Catalog discovery uses the backend-issued plugin session token stored at `~/.config/opencode/opencode-wizard.json` (`auth` field); the plugin does not persist or send Microsoft/Entra tokens to GraphQL. If no valid plugin session exists, no-arg `opencode_wizard_published_skills_fetch`, explicit `opencode_wizard_status`, TUI status, and chat/system-context startup may start the browser Entra PKCE flow and exchange the callback for a fresh backend-issued plugin session.
+Catalog discovery uses the backend-issued plugin session token stored at `~/.config/opencode/opencode-wizard.json` (`auth` field); the plugin does not persist or send Microsoft/Entra tokens to GraphQL. If no valid plugin session exists, no-arg `opencode_wizard_catalog_fetch`, compatibility no-arg `opencode_wizard_published_skills_fetch`, explicit `opencode_wizard_status`, and chat/system-context startup may start the browser Entra PKCE flow and exchange the callback for a fresh backend-issued plugin session. The TUI status panel only displays the resulting auth/catalog state.
 
-Call `opencode_wizard_published_skills_fetch` without `skill` or `skills` to manually bootstrap plugin login if needed and return catalog-only discovery output for the current directory scope.
+The shared plugin tools `opencode_wizard_catalog_fetch`, `opencode_wizard_artifact_fetch`, `opencode_wizard_artifact_preference_set`, compatibility published-skill tools, and `opencode_wizard_status` are always exposed by the plugin. Missing auth, forbidden role, backend, or catalog problems are reported by tool output/status metadata instead of hiding these shared tools; only `opencode_wizard_editor_publish_skill` and `opencode_wizard_artifact_import` stay editor-only.
 
-No-arg discovery returns published skill summaries, assignment counts split into `global`, `project`, `user`, and `other`, policy metadata, and no markdown bodies. Existing `skill` and `skills` calls still fetch one or more full skill body/detail payloads by slug, artifact name, or skill name.
+Call `opencode_wizard_catalog_fetch` with `artifactKind: SKILL` or compatibility `opencode_wizard_published_skills_fetch` without `skill` or `skills` to manually bootstrap plugin login if needed and return catalog-only discovery output for the current directory scope.
+
+No-arg discovery returns published skill summaries, assignment counts split into `global`, `project`, `user`, and `other`, policy metadata, and no markdown bodies. Canonical `opencode_wizard_artifact_fetch` with `artifactKind: SKILL` and compatibility `skill`/`skills` calls fetch one or more full skill body/detail payloads by slug, artifact name, or skill name. `DESIGN_DOC` uses generic wizard artifact persistence and returns metadata-only catalogs plus explicit `DESIGN.md` body/files detail fetches for effective assignments. Use the fetched `markdownDocument`/`markdownBody` as the authoritative wizard skill body before applying a wizard-listed skill.
 
 Workspace delivery still follows the backend contract: the plugin sends `workspaceSlug` when it has one, otherwise falls back to `repositoryUrl`. The plugin now prefers configured or learned workspace slug mappings over a repo-basename fallback, and learns durable slug-to-repo mappings from successful backend catalog responses so worktrees and nontrivial repo roots stay aligned.
 
-Published skill fetches still support `refresh: true`, but normal cache entries now self-expire after 30 seconds and fetch/status payloads surface `source`, `workspaceSlug`, and `workspaceSlugSource` so stale-vs-refreshed behavior is visible without relying on manual cache deletion.
+Published skill fetches still support `refresh: true`, but normal cache entries now self-expire after 30 seconds and fetch/status payloads surface `source`, `workspaceSlug`, and `workspaceSlugSource` so stale-vs-refreshed behavior is visible without relying on manual cache deletion. Try `refresh: true` and report the tool-output auth/catalog/source/cache/workspace-resolution state before deleting `~/.cache/opencode/*`.
+
+Use `opencode_wizard_artifact_preference_set` or compatibility `opencode_wizard_published_skill_preference_set` for preference actions (`install`, `uninstall`, `ignore`, `unignore`); the TUI panel stays information-only and does not expose those mutations.
 
-Use `opencode_wizard_published_skill_preference_set` for non-TUI preference actions (`install`, `uninstall`, `ignore`, `unignore`) against the same server-backed preference API used by the TUI overlay.
+Editors can import external artifacts without writing project files via `opencode_wizard_artifact_import`: use `source: "npx getdesign@latest add bmw-m"` for a `DESIGN_DOC`, or `source: "https://github.com/vercel-labs/skills --skill find-skills"` for a `SKILL`. The plugin fetches raw markdown, sends it to the backend import mutation, records the importing editor in existing created/published actor fields plus source metadata, and the imported backend artifact becomes the runtime authority.
 
 `GLOBAL_CONTEXT` skills are active context skills and are not meant to be installed per project. `PROJECT_INSTALLABLE` skills are gallery/installable skills that may be attached globally or to a workspace/path through assignment records; those assignments remain the source of truth for what is active in a catalog response.
 

package/dist/graphql-operations.d.ts

@@ -1,4 +1,8 @@
-export declare const PUBLISHED_SKILLS_CATALOG_QUERY = "\n  query PluginPublishedSkills($input: PublishedSkillsDeliveryInput!) {\n    pluginPublishedSkills(input: $input) {\n      workspace {\n        id\n        slug\n        name\n        repositoryUrl\n        defaultBranch\n        status\n      }\n      directoryPath\n      skills {\n        assignmentSource\n        assignmentType\n        scopePath\n        includeChildren\n        skill {\n          id\n          slug\n          name\n          summary\n          whenToUse\n          status\n          installPolicy\n          tags {\n            id\n            slug\n            label\n            description\n            facet {\n              id\n              slug\n              label\n              description\n            }\n          }\n        }\n        skillVersion {\n          id\n          version\n          title\n          summary\n          status\n        }\n        publishedArtifact {\n          id\n          frontmatterName\n          frontmatterDescription\n          checksum\n          publishedAt\n          fileCount\n        }\n      }\n      catalogSkills {\n        skill {\n          id\n          slug\n          name\n          summary\n          whenToUse\n          status\n          installPolicy\n          tags {\n            id\n            slug\n            label\n            description\n            facet {\n              id\n              slug\n              label\n              description\n            }\n          }\n        }\n        skillVersion {\n          id\n          version\n          title\n          summary\n          status\n        }\n        publishedArtifact {\n          id\n          frontmatterName\n          frontmatterDescription\n          checksum\n          publishedAt\n          fileCount\n        }\n      }\n      userPreferences {\n        scopeKey\n        userKey\n        ignoredSkills {\n          assignmentSource\n          assignmentType\n          scopePath\n          includeChildren\n          skill {\n            id\n            slug\n            name\n            summary\n            whenToUse\n            status\n            installPolicy\n            tags {\n              id\n              slug\n              label\n              description\n              facet {\n                id\n                slug\n                label\n                description\n              }\n            }\n          }\n          skillVersion {\n            id\n            version\n            title\n            summary\n            status\n          }\n          publishedArtifact {\n            id\n            frontmatterName\n            frontmatterDescription\n            checksum\n            publishedAt\n            fileCount\n          }\n        }\n      }\n    }\n  }\n";
-export declare const SET_PUBLISHED_SKILL_PREFERENCE_MUTATION = "\n  mutation SetPublishedSkillPreference($input: SetPublishedSkillPreferenceInput!) {\n    setPublishedSkillPreference(input: $input) {\n      scopeKey\n      userKey\n      ignoredSkills {\n        assignmentSource\n        assignmentType\n        scopePath\n        includeChildren\n        skill {\n          id\n          slug\n          name\n          summary\n          whenToUse\n          status\n          installPolicy\n          tags {\n            id\n            slug\n            label\n            description\n            facet {\n              id\n              slug\n              label\n              description\n            }\n          }\n        }\n        skillVersion {\n          id\n          version\n          title\n          summary\n          status\n        }\n        publishedArtifact {\n          id\n          frontmatterName\n          frontmatterDescription\n          checksum\n          publishedAt\n          fileCount\n        }\n      }\n    }\n  }\n";
+export declare const PUBLISHED_SKILLS_CATALOG_QUERY = "\n  query PluginPublishedSkills($input: PublishedSkillsDeliveryInput!) {\n    pluginPublishedSkills(input: $input) {\n      workspace {\n        id\n        slug\n        name\n        repositoryUrl\n        defaultBranch\n        status\n      }\n      directoryPath\n      skills {\n        \n  assignmentSource\n  assignmentType\n  scopePath\n  includeChildren\n  \n  skill {\n    id\n    slug\n    name\n    summary\n    whenToUse\n    status\n    installPolicy\n    tags {\n      id\n      slug\n      label\n      description\n      facet {\n        id\n        slug\n        label\n        description\n      }\n    }\n  }\n  skillVersion {\n    id\n    version\n    title\n    summary\n    status\n  }\n  publishedArtifact {\n    id\n    frontmatterName\n    frontmatterDescription\n    checksum\n    publishedAt\n    fileCount\n  }\n\n\n      }\n      catalogSkills {\n        \n  skill {\n    id\n    slug\n    name\n    summary\n    whenToUse\n    status\n    installPolicy\n    tags {\n      id\n      slug\n      label\n      description\n      facet {\n        id\n        slug\n        label\n        description\n      }\n    }\n  }\n  skillVersion {\n    id\n    version\n    title\n    summary\n    status\n  }\n  publishedArtifact {\n    id\n    frontmatterName\n    frontmatterDescription\n    checksum\n    publishedAt\n    fileCount\n  }\n\n      }\n      userPreferences {\n        scopeKey\n        userKey\n        ignoredSkills {\n          \n  assignmentSource\n  assignmentType\n  scopePath\n  includeChildren\n  \n  skill {\n    id\n    slug\n    name\n    summary\n    whenToUse\n    status\n    installPolicy\n    tags {\n      id\n      slug\n      label\n      description\n      facet {\n        id\n        slug\n        label\n        description\n      }\n    }\n  }\n  skillVersion {\n    id\n    version\n    title\n    summary\n    status\n  }\n  publishedArtifact {\n    id\n    frontmatterName\n    frontmatterDescription\n    checksum\n    publishedAt\n    fileCount\n  }\n\n\n        }\n      }\n    }\n  }\n";
+export declare const SET_PUBLISHED_SKILL_PREFERENCE_MUTATION = "\n  mutation SetPublishedSkillPreference($input: SetPublishedSkillPreferenceInput!) {\n    setPublishedSkillPreference(input: $input) {\n      scopeKey\n      userKey\n      ignoredSkills {\n        \n  assignmentSource\n  assignmentType\n  scopePath\n  includeChildren\n  \n  skill {\n    id\n    slug\n    name\n    summary\n    whenToUse\n    status\n    installPolicy\n    tags {\n      id\n      slug\n      label\n      description\n      facet {\n        id\n        slug\n        label\n        description\n      }\n    }\n  }\n  skillVersion {\n    id\n    version\n    title\n    summary\n    status\n  }\n  publishedArtifact {\n    id\n    frontmatterName\n    frontmatterDescription\n    checksum\n    publishedAt\n    fileCount\n  }\n\n\n      }\n    }\n  }\n";
 export declare const PUBLISHED_SKILL_DETAIL_QUERY = "\n  query PluginPublishedSkillVersionArtifact($input: PublishedSkillArtifactDetailInput!) {\n    pluginPublishedSkillVersionArtifact(input: $input) {\n      id\n      frontmatterName\n      frontmatterDescription\n      markdownBody\n      renderedContent\n      checksum\n      publishedAt\n      fileCount\n      files {\n        id\n        relativePath\n        contentType\n        content\n        checksum\n        size\n        sortOrder\n      }\n    }\n  }\n";
+export declare const WIZARD_ARTIFACTS_CATALOG_QUERY = "\n  query PluginWizardArtifacts($input: WizardArtifactsDeliveryInput!) {\n    pluginWizardArtifacts(input: $input) {\n      artifactKind\n      workspace {\n        id\n        slug\n        name\n        repositoryUrl\n        defaultBranch\n        status\n      }\n      directoryPath\n      artifacts {\n        \n  assignmentSource\n  assignmentType\n  scopePath\n  includeChildren\n  \n  artifact {\n    id\n    kind\n    slug\n    name\n    summary\n    whenToUse\n    status\n    installPolicy\n  }\n  artifactVersion {\n    id\n    version\n    title\n    summary\n    status\n    frontmatterName\n    frontmatterDescription\n    checksum\n    canonicalFilePath\n    publishedAt\n    fileCount\n  }\n\n\n      }\n      catalogArtifacts {\n        \n  artifact {\n    id\n    kind\n    slug\n    name\n    summary\n    whenToUse\n    status\n    installPolicy\n  }\n  artifactVersion {\n    id\n    version\n    title\n    summary\n    status\n    frontmatterName\n    frontmatterDescription\n    checksum\n    canonicalFilePath\n    publishedAt\n    fileCount\n  }\n\n      }\n      artifactPreferences {\n        scopeKey\n        userKey\n        ignoredArtifacts {\n          \n  assignmentSource\n  assignmentType\n  scopePath\n  includeChildren\n  \n  artifact {\n    id\n    kind\n    slug\n    name\n    summary\n    whenToUse\n    status\n    installPolicy\n  }\n  artifactVersion {\n    id\n    version\n    title\n    summary\n    status\n    frontmatterName\n    frontmatterDescription\n    checksum\n    canonicalFilePath\n    publishedAt\n    fileCount\n  }\n\n\n        }\n      }\n      unsupportedReason\n      message\n    }\n  }\n";
+export declare const WIZARD_ARTIFACT_DETAIL_QUERY = "\n  query PluginWizardArtifactVersion($input: WizardArtifactDetailInput!) {\n    pluginWizardArtifactVersion(input: $input) {\n      id\n      artifact {\n        id\n        kind\n        slug\n        name\n        summary\n        whenToUse\n        status\n        installPolicy\n      }\n      version\n      title\n      summary\n      status\n      frontmatterName\n      frontmatterDescription\n      markdownBody\n      renderedContent\n      checksum\n      canonicalFilePath\n      publishedAt\n      fileCount\n      files {\n        id\n        relativePath\n        contentType\n        content\n        checksum\n        size\n        sortOrder\n      }\n    }\n  }\n";
+export declare const SET_WIZARD_ARTIFACT_PREFERENCE_MUTATION = "\n  mutation SetWizardArtifactPreference($input: SetWizardArtifactPreferenceInput!) {\n    setWizardArtifactPreference(input: $input) {\n      scopeKey\n      userKey\n      ignoredArtifacts {\n        \n  assignmentSource\n  assignmentType\n  scopePath\n  includeChildren\n  \n  artifact {\n    id\n    kind\n    slug\n    name\n    summary\n    whenToUse\n    status\n    installPolicy\n  }\n  artifactVersion {\n    id\n    version\n    title\n    summary\n    status\n    frontmatterName\n    frontmatterDescription\n    checksum\n    canonicalFilePath\n    publishedAt\n    fileCount\n  }\n\n\n      }\n    }\n  }\n";
 export declare const CREATE_OR_UPDATE_SKILL_FROM_MARKDOWN_MUTATION = "\n  mutation CreateOrUpdateSkillFromMarkdown($markdownContent: String!) {\n    createOrUpdateSkillFromMarkdown(markdownContent: $markdownContent) {\n      success\n      skillSlug\n      skillVersionId\n      errors\n    }\n  }\n";
+export declare const IMPORT_WIZARD_ARTIFACT_SNAPSHOT_MUTATION = "\n  mutation ImportWizardArtifactSnapshot($input: ImportWizardArtifactSnapshotInput!) {\n    importWizardArtifactSnapshot(input: $input) {\n      success\n      skillSlug\n      skillVersionId\n      artifactSlug\n      artifactVersionId\n      errors\n    }\n  }\n";

package/dist/graphql-operations.js

@@ -1,3 +1,48 @@
+const PUBLISHED_SKILL_CORE_FIELDS = `
+  skill {
+    id
+    slug
+    name
+    summary
+    whenToUse
+    status
+    installPolicy
+    tags {
+      id
+      slug
+      label
+      description
+      facet {
+        id
+        slug
+        label
+        description
+      }
+    }
+  }
+  skillVersion {
+    id
+    version
+    title
+    summary
+    status
+  }
+  publishedArtifact {
+    id
+    frontmatterName
+    frontmatterDescription
+    checksum
+    publishedAt
+    fileCount
+  }
+`;
+const PUBLISHED_SKILL_ASSIGNMENT_FIELDS = `
+  assignmentSource
+  assignmentType
+  scopePath
+  includeChildren
+  ${PUBLISHED_SKILL_CORE_FIELDS}
+`;
 export const PUBLISHED_SKILLS_CATALOG_QUERY = `
   query PluginPublishedSkills($input: PublishedSkillsDeliveryInput!) {
     pluginPublishedSkills(input: $input) {
@@ -11,129 +56,16 @@ export const PUBLISHED_SKILLS_CATALOG_QUERY = `
       }
       directoryPath
       skills {
-        assignmentSource
-        assignmentType
-        scopePath
-        includeChildren
-        skill {
-          id
-          slug
-          name
-          summary
-          whenToUse
-          status
-          installPolicy
-          tags {
-            id
-            slug
-            label
-            description
-            facet {
-              id
-              slug
-              label
-              description
-            }
-          }
-        }
-        skillVersion {
-          id
-          version
-          title
-          summary
-          status
-        }
-        publishedArtifact {
-          id
-          frontmatterName
-          frontmatterDescription
-          checksum
-          publishedAt
-          fileCount
-        }
+        ${PUBLISHED_SKILL_ASSIGNMENT_FIELDS}
       }
       catalogSkills {
-        skill {
-          id
-          slug
-          name
-          summary
-          whenToUse
-          status
-          installPolicy
-          tags {
-            id
-            slug
-            label
-            description
-            facet {
-              id
-              slug
-              label
-              description
-            }
-          }
-        }
-        skillVersion {
-          id
-          version
-          title
-          summary
-          status
-        }
-        publishedArtifact {
-          id
-          frontmatterName
-          frontmatterDescription
-          checksum
-          publishedAt
-          fileCount
-        }
+        ${PUBLISHED_SKILL_CORE_FIELDS}
       }
       userPreferences {
         scopeKey
         userKey
         ignoredSkills {
-          assignmentSource
-          assignmentType
-          scopePath
-          includeChildren
-          skill {
-            id
-            slug
-            name
-            summary
-            whenToUse
-            status
-            installPolicy
-            tags {
-              id
-              slug
-              label
-              description
-              facet {
-                id
-                slug
-                label
-                description
-              }
-            }
-          }
-          skillVersion {
-            id
-            version
-            title
-            summary
-            status
-          }
-          publishedArtifact {
-            id
-            frontmatterName
-            frontmatterDescription
-            checksum
-            publishedAt
-            fileCount
-          }
+          ${PUBLISHED_SKILL_ASSIGNMENT_FIELDS}
         }
       }
     }
@@ -145,46 +77,7 @@ export const SET_PUBLISHED_SKILL_PREFERENCE_MUTATION = `
       scopeKey
       userKey
       ignoredSkills {
-        assignmentSource
-        assignmentType
-        scopePath
-        includeChildren
-        skill {
-          id
-          slug
-          name
-          summary
-          whenToUse
-          status
-          installPolicy
-          tags {
-            id
-            slug
-            label
-            description
-            facet {
-              id
-              slug
-              label
-              description
-            }
-          }
-        }
-        skillVersion {
-          id
-          version
-          title
-          summary
-          status
-        }
-        publishedArtifact {
-          id
-          frontmatterName
-          frontmatterDescription
-          checksum
-          publishedAt
-          fileCount
-        }
+        ${PUBLISHED_SKILL_ASSIGNMENT_FIELDS}
       }
     }
   }
@@ -212,6 +105,118 @@ export const PUBLISHED_SKILL_DETAIL_QUERY = `
     }
   }
 `;
+const WIZARD_ARTIFACT_CORE_FIELDS = `
+  artifact {
+    id
+    kind
+    slug
+    name
+    summary
+    whenToUse
+    status
+    installPolicy
+  }
+  artifactVersion {
+    id
+    version
+    title
+    summary
+    status
+    frontmatterName
+    frontmatterDescription
+    checksum
+    canonicalFilePath
+    publishedAt
+    fileCount
+  }
+`;
+const WIZARD_ARTIFACT_ASSIGNMENT_FIELDS = `
+  assignmentSource
+  assignmentType
+  scopePath
+  includeChildren
+  ${WIZARD_ARTIFACT_CORE_FIELDS}
+`;
+export const WIZARD_ARTIFACTS_CATALOG_QUERY = `
+  query PluginWizardArtifacts($input: WizardArtifactsDeliveryInput!) {
+    pluginWizardArtifacts(input: $input) {
+      artifactKind
+      workspace {
+        id
+        slug
+        name
+        repositoryUrl
+        defaultBranch
+        status
+      }
+      directoryPath
+      artifacts {
+        ${WIZARD_ARTIFACT_ASSIGNMENT_FIELDS}
+      }
+      catalogArtifacts {
+        ${WIZARD_ARTIFACT_CORE_FIELDS}
+      }
+      artifactPreferences {
+        scopeKey
+        userKey
+        ignoredArtifacts {
+          ${WIZARD_ARTIFACT_ASSIGNMENT_FIELDS}
+        }
+      }
+      unsupportedReason
+      message
+    }
+  }
+`;
+export const WIZARD_ARTIFACT_DETAIL_QUERY = `
+  query PluginWizardArtifactVersion($input: WizardArtifactDetailInput!) {
+    pluginWizardArtifactVersion(input: $input) {
+      id
+      artifact {
+        id
+        kind
+        slug
+        name
+        summary
+        whenToUse
+        status
+        installPolicy
+      }
+      version
+      title
+      summary
+      status
+      frontmatterName
+      frontmatterDescription
+      markdownBody
+      renderedContent
+      checksum
+      canonicalFilePath
+      publishedAt
+      fileCount
+      files {
+        id
+        relativePath
+        contentType
+        content
+        checksum
+        size
+        sortOrder
+      }
+    }
+  }
+`;
+export const SET_WIZARD_ARTIFACT_PREFERENCE_MUTATION = `
+  mutation SetWizardArtifactPreference($input: SetWizardArtifactPreferenceInput!) {
+    setWizardArtifactPreference(input: $input) {
+      scopeKey
+      userKey
+      ignoredArtifacts {
+        ${WIZARD_ARTIFACT_ASSIGNMENT_FIELDS}
+      }
+    }
+  }
+`;
 export const CREATE_OR_UPDATE_SKILL_FROM_MARKDOWN_MUTATION = `
   mutation CreateOrUpdateSkillFromMarkdown($markdownContent: String!) {
     createOrUpdateSkillFromMarkdown(markdownContent: $markdownContent) {
@@ -222,4 +227,16 @@ export const CREATE_OR_UPDATE_SKILL_FROM_MARKDOWN_MUTATION = `
     }
   }
 `;
+export const IMPORT_WIZARD_ARTIFACT_SNAPSHOT_MUTATION = `
+  mutation ImportWizardArtifactSnapshot($input: ImportWizardArtifactSnapshotInput!) {
+    importWizardArtifactSnapshot(input: $input) {
+      success
+      skillSlug
+      skillVersionId
+      artifactSlug
+      artifactVersionId
+      errors
+    }
+  }
+`;
 //# sourceMappingURL=graphql-operations.js.map

package/dist/graphql-operations.js.map

@@ -1 +1 @@
-{"version":3,"names":["PUBLISHED_SKILLS_CATALOG_QUERY","SET_PUBLISHED_SKILL_PREFERENCE_MUTATION","PUBLISHED_SKILL_DETAIL_QUERY","CREATE_OR_UPDATE_SKILL_FROM_MARKDOWN_MUTATION"],"sources":["../src/graphql-operations.ts"],"sourcesContent":["export const PUBLISHED_SKILLS_CATALOG_QUERY = `\n  query PluginPublishedSkills($input: PublishedSkillsDeliveryInput!) {\n    pluginPublishedSkills(input: $input) {\n      workspace {\n        id\n        slug\n        name\n        repositoryUrl\n        defaultBranch\n        status\n      }\n      directoryPath\n      skills {\n        assignmentSource\n        assignmentType\n        scopePath\n        includeChildren\n        skill {\n          id\n          slug\n          name\n          summary\n          whenToUse\n          status\n          installPolicy\n          tags {\n            id\n            slug\n            label\n            description\n            facet {\n              id\n              slug\n              label\n              description\n            }\n          }\n        }\n        skillVersion {\n          id\n          version\n          title\n          summary\n          status\n        }\n        publishedArtifact {\n          id\n          frontmatterName\n          frontmatterDescription\n          checksum\n          publishedAt\n          fileCount\n        }\n      }\n      catalogSkills {\n        skill {\n          id\n          slug\n          name\n          summary\n          whenToUse\n          status\n          installPolicy\n          tags {\n            id\n            slug\n            label\n            description\n            facet {\n              id\n              slug\n              label\n              description\n            }\n          }\n        }\n        skillVersion {\n          id\n          version\n          title\n          summary\n          status\n        }\n        publishedArtifact {\n          id\n          frontmatterName\n          frontmatterDescription\n          checksum\n          publishedAt\n          fileCount\n        }\n      }\n      userPreferences {\n        scopeKey\n        userKey\n        ignoredSkills {\n          assignmentSource\n          assignmentType\n          scopePath\n          includeChildren\n          skill {\n            id\n            slug\n            name\n            summary\n            whenToUse\n            status\n            installPolicy\n            tags {\n              id\n              slug\n              label\n              description\n              facet {\n                id\n                slug\n                label\n                description\n              }\n            }\n          }\n          skillVersion {\n            id\n            version\n            title\n            summary\n            status\n          }\n          publishedArtifact {\n            id\n            frontmatterName\n            frontmatterDescription\n            checksum\n            publishedAt\n            fileCount\n          }\n        }\n      }\n    }\n  }\n`;\n\nexport const SET_PUBLISHED_SKILL_PREFERENCE_MUTATION = `\n  mutation SetPublishedSkillPreference($input: SetPublishedSkillPreferenceInput!) {\n    setPublishedSkillPreference(input: $input) {\n      scopeKey\n      userKey\n      ignoredSkills {\n        assignmentSource\n        assignmentType\n        scopePath\n        includeChildren\n        skill {\n          id\n          slug\n          name\n          summary\n          whenToUse\n          status\n          installPolicy\n          tags {\n            id\n            slug\n            label\n            description\n            facet {\n              id\n              slug\n              label\n              description\n            }\n          }\n        }\n        skillVersion {\n          id\n          version\n          title\n          summary\n          status\n        }\n        publishedArtifact {\n          id\n          frontmatterName\n          frontmatterDescription\n          checksum\n          publishedAt\n          fileCount\n        }\n      }\n    }\n  }\n`;\n\nexport const PUBLISHED_SKILL_DETAIL_QUERY = `\n  query PluginPublishedSkillVersionArtifact($input: PublishedSkillArtifactDetailInput!) {\n    pluginPublishedSkillVersionArtifact(input: $input) {\n      id\n      frontmatterName\n      frontmatterDescription\n      markdownBody\n      renderedContent\n      checksum\n      publishedAt\n      fileCount\n      files {\n        id\n        relativePath\n        contentType\n        content\n        checksum\n        size\n        sortOrder\n      }\n    }\n  }\n`;\n\nexport const CREATE_OR_UPDATE_SKILL_FROM_MARKDOWN_MUTATION = `\n  mutation CreateOrUpdateSkillFromMarkdown($markdownContent: String!) {\n    createOrUpdateSkillFromMarkdown(markdownContent: $markdownContent) {\n      success\n      skillSlug\n      skillVersionId\n      errors\n    }\n  }\n`;\n"],"mappings":"AAAA,OAAO,MAAMA,8BAA8B,GAAG;AAC9C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,CAAC;AAED,OAAO,MAAMC,uCAAuC,GAAG;AACvD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,CAAC;AAED,OAAO,MAAMC,4BAA4B,GAAG;AAC5C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,CAAC;AAED,OAAO,MAAMC,6CAA6C,GAAG;AAC7D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,CAAC","ignoreList":[]}
+{"version":3,"names":["PUBLISHED_SKILL_CORE_FIELDS","PUBLISHED_SKILL_ASSIGNMENT_FIELDS","PUBLISHED_SKILLS_CATALOG_QUERY","SET_PUBLISHED_SKILL_PREFERENCE_MUTATION","PUBLISHED_SKILL_DETAIL_QUERY","WIZARD_ARTIFACT_CORE_FIELDS","WIZARD_ARTIFACT_ASSIGNMENT_FIELDS","WIZARD_ARTIFACTS_CATALOG_QUERY","WIZARD_ARTIFACT_DETAIL_QUERY","SET_WIZARD_ARTIFACT_PREFERENCE_MUTATION","CREATE_OR_UPDATE_SKILL_FROM_MARKDOWN_MUTATION","IMPORT_WIZARD_ARTIFACT_SNAPSHOT_MUTATION"],"sources":["../src/graphql-operations.ts"],"sourcesContent":["const PUBLISHED_SKILL_CORE_FIELDS = `\n  skill {\n    id\n    slug\n    name\n    summary\n    whenToUse\n    status\n    installPolicy\n    tags {\n      id\n      slug\n      label\n      description\n      facet {\n        id\n        slug\n        label\n        description\n      }\n    }\n  }\n  skillVersion {\n    id\n    version\n    title\n    summary\n    status\n  }\n  publishedArtifact {\n    id\n    frontmatterName\n    frontmatterDescription\n    checksum\n    publishedAt\n    fileCount\n  }\n`;\n\nconst PUBLISHED_SKILL_ASSIGNMENT_FIELDS = `\n  assignmentSource\n  assignmentType\n  scopePath\n  includeChildren\n  ${PUBLISHED_SKILL_CORE_FIELDS}\n`;\n\nexport const PUBLISHED_SKILLS_CATALOG_QUERY = `\n  query PluginPublishedSkills($input: PublishedSkillsDeliveryInput!) {\n    pluginPublishedSkills(input: $input) {\n      workspace {\n        id\n        slug\n        name\n        repositoryUrl\n        defaultBranch\n        status\n      }\n      directoryPath\n      skills {\n        ${PUBLISHED_SKILL_ASSIGNMENT_FIELDS}\n      }\n      catalogSkills {\n        ${PUBLISHED_SKILL_CORE_FIELDS}\n      }\n      userPreferences {\n        scopeKey\n        userKey\n        ignoredSkills {\n          ${PUBLISHED_SKILL_ASSIGNMENT_FIELDS}\n        }\n      }\n    }\n  }\n`;\n\nexport const SET_PUBLISHED_SKILL_PREFERENCE_MUTATION = `\n  mutation SetPublishedSkillPreference($input: SetPublishedSkillPreferenceInput!) {\n    setPublishedSkillPreference(input: $input) {\n      scopeKey\n      userKey\n      ignoredSkills {\n        ${PUBLISHED_SKILL_ASSIGNMENT_FIELDS}\n      }\n    }\n  }\n`;\n\nexport const PUBLISHED_SKILL_DETAIL_QUERY = `\n  query PluginPublishedSkillVersionArtifact($input: PublishedSkillArtifactDetailInput!) {\n    pluginPublishedSkillVersionArtifact(input: $input) {\n      id\n      frontmatterName\n      frontmatterDescription\n      markdownBody\n      renderedContent\n      checksum\n      publishedAt\n      fileCount\n      files {\n        id\n        relativePath\n        contentType\n        content\n        checksum\n        size\n        sortOrder\n      }\n    }\n  }\n`;\n\nconst WIZARD_ARTIFACT_CORE_FIELDS = `\n  artifact {\n    id\n    kind\n    slug\n    name\n    summary\n    whenToUse\n    status\n    installPolicy\n  }\n  artifactVersion {\n    id\n    version\n    title\n    summary\n    status\n    frontmatterName\n    frontmatterDescription\n    checksum\n    canonicalFilePath\n    publishedAt\n    fileCount\n  }\n`;\n\nconst WIZARD_ARTIFACT_ASSIGNMENT_FIELDS = `\n  assignmentSource\n  assignmentType\n  scopePath\n  includeChildren\n  ${WIZARD_ARTIFACT_CORE_FIELDS}\n`;\n\nexport const WIZARD_ARTIFACTS_CATALOG_QUERY = `\n  query PluginWizardArtifacts($input: WizardArtifactsDeliveryInput!) {\n    pluginWizardArtifacts(input: $input) {\n      artifactKind\n      workspace {\n        id\n        slug\n        name\n        repositoryUrl\n        defaultBranch\n        status\n      }\n      directoryPath\n      artifacts {\n        ${WIZARD_ARTIFACT_ASSIGNMENT_FIELDS}\n      }\n      catalogArtifacts {\n        ${WIZARD_ARTIFACT_CORE_FIELDS}\n      }\n      artifactPreferences {\n        scopeKey\n        userKey\n        ignoredArtifacts {\n          ${WIZARD_ARTIFACT_ASSIGNMENT_FIELDS}\n        }\n      }\n      unsupportedReason\n      message\n    }\n  }\n`;\n\nexport const WIZARD_ARTIFACT_DETAIL_QUERY = `\n  query PluginWizardArtifactVersion($input: WizardArtifactDetailInput!) {\n    pluginWizardArtifactVersion(input: $input) {\n      id\n      artifact {\n        id\n        kind\n        slug\n        name\n        summary\n        whenToUse\n        status\n        installPolicy\n      }\n      version\n      title\n      summary\n      status\n      frontmatterName\n      frontmatterDescription\n      markdownBody\n      renderedContent\n      checksum\n      canonicalFilePath\n      publishedAt\n      fileCount\n      files {\n        id\n        relativePath\n        contentType\n        content\n        checksum\n        size\n        sortOrder\n      }\n    }\n  }\n`;\n\nexport const SET_WIZARD_ARTIFACT_PREFERENCE_MUTATION = `\n  mutation SetWizardArtifactPreference($input: SetWizardArtifactPreferenceInput!) {\n    setWizardArtifactPreference(input: $input) {\n      scopeKey\n      userKey\n      ignoredArtifacts {\n        ${WIZARD_ARTIFACT_ASSIGNMENT_FIELDS}\n      }\n    }\n  }\n`;\n\nexport const CREATE_OR_UPDATE_SKILL_FROM_MARKDOWN_MUTATION = `\n  mutation CreateOrUpdateSkillFromMarkdown($markdownContent: String!) {\n    createOrUpdateSkillFromMarkdown(markdownContent: $markdownContent) {\n      success\n      skillSlug\n      skillVersionId\n      errors\n    }\n  }\n`;\n\nexport const IMPORT_WIZARD_ARTIFACT_SNAPSHOT_MUTATION = `\n  mutation ImportWizardArtifactSnapshot($input: ImportWizardArtifactSnapshotInput!) {\n    importWizardArtifactSnapshot(input: $input) {\n      success\n      skillSlug\n      skillVersionId\n      artifactSlug\n      artifactVersionId\n      errors\n    }\n  }\n`;\n"],"mappings":"AAAA,MAAMA,2BAA2B,GAAG;AACpC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,CAAC;AAED,MAAMC,iCAAiC,GAAG;AAC1C;AACA;AACA;AACA;AACA,IAAID,2BAA2B;AAC/B,CAAC;AAED,OAAO,MAAME,8BAA8B,GAAG;AAC9C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,UAAUD,iCAAiC;AAC3C;AACA;AACA,UAAUD,2BAA2B;AACrC;AACA;AACA;AACA;AACA;AACA,YAAYC,iCAAiC;AAC7C;AACA;AACA;AACA;AACA,CAAC;AAED,OAAO,MAAME,uCAAuC,GAAG;AACvD;AACA;AACA;AACA;AACA;AACA,UAAUF,iCAAiC;AAC3C;AACA;AACA;AACA,CAAC;AAED,OAAO,MAAMG,4BAA4B,GAAG;AAC5C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,CAAC;AAED,MAAMC,2BAA2B,GAAG;AACpC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,CAAC;AAED,MAAMC,iCAAiC,GAAG;AAC1C;AACA;AACA;AACA;AACA,IAAID,2BAA2B;AAC/B,CAAC;AAED,OAAO,MAAME,8BAA8B,GAAG;AAC9C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,UAAUD,iCAAiC;AAC3C;AACA;AACA,UAAUD,2BAA2B;AACrC;AACA;AACA;AACA;AACA;AACA,YAAYC,iCAAiC;AAC7C;AACA;AACA;AACA;AACA;AACA;AACA,CAAC;AAED,OAAO,MAAME,4BAA4B,GAAG;AAC5C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,CAAC;AAED,OAAO,MAAMC,uCAAuC,GAAG;AACvD;AACA;AACA;AACA;AACA;AACA,UAAUH,iCAAiC;AAC3C;AACA;AACA;AACA,CAAC;AAED,OAAO,MAAMI,6CAA6C,GAAG;AAC7D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,CAAC;AAED,OAAO,MAAMC,wCAAwC,GAAG;AACxD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,CAAC","ignoreList":[]}

package/dist/plugin-tools.d.ts

@@ -4,6 +4,19 @@ export type PublishedSkillFetchArgs = {
     directory?: string;
     refresh?: boolean;
 };
+export type WizardArtifactKind = 'SKILL' | 'DESIGN_DOC';
+export type WizardArtifactCatalogFetchArgs = {
+    artifactKind?: string;
+    directory?: string;
+    refresh?: boolean;
+};
+export type WizardArtifactFetchArgs = {
+    artifactKind?: string;
+    artifact?: string;
+    artifacts?: string;
+    directory?: string;
+    refresh?: boolean;
+};
 export type PluginStatusArgs = {
     directory?: string;
 };
@@ -13,10 +26,26 @@ export type PublishedSkillPreferenceArgs = {
     preferenceScope?: string;
     directory?: string;
 };
+export type WizardArtifactPreferenceArgs = {
+    artifactKind?: string;
+    artifact: string;
+    action: string;
+    preferenceScope?: string;
+    directory?: string;
+};
 export type EditorPublishSkillArgs = {
     skillSlug: string;
     directory?: string;
 };
+export type WizardArtifactImportArgs = {
+    artifactKind?: string;
+    source: string;
+    slug?: string;
+    skill?: string;
+    name?: string;
+    summary?: string;
+    directory?: string;
+};
 type ToolSchemaValue<TSelf> = {
     optional: () => TSelf;
     describe: (description: string) => TSelf;
@@ -45,20 +74,28 @@ export type ToolFactory = (<TArgs extends object>(definition: ToolDefinition<TAr
 };
 type PublishedSkillToolHandlers = {
     fetchPublishedSkills: (args: PublishedSkillFetchArgs, context: ToolExecuteContext) => Promise<unknown>;
+    fetchWizardArtifactCatalog: (args: WizardArtifactCatalogFetchArgs, context: ToolExecuteContext) => Promise<unknown>;
+    fetchWizardArtifacts: (args: WizardArtifactFetchArgs, context: ToolExecuteContext) => Promise<unknown>;
     updatePublishedSkillPreference: (args: PublishedSkillPreferenceArgs, context: ToolExecuteContext) => Promise<unknown>;
+    updateWizardArtifactPreference: (args: WizardArtifactPreferenceArgs, context: ToolExecuteContext) => Promise<unknown>;
     getStatus: (args: PluginStatusArgs, context: ToolExecuteContext) => Promise<unknown>;
     publishEditorSkill: (args: EditorPublishSkillArgs, context: ToolExecuteContext) => Promise<unknown>;
+    importWizardArtifact: (args: WizardArtifactImportArgs, context: ToolExecuteContext) => Promise<unknown>;
 };
 export declare const AVAILABLE_PUBLISHED_SKILL_TOOLS: string[];
 export declare const resolveAvailableTools: (role: string | null | undefined) => string[];
 export declare const createPublishedSkillToolDefinitions: (tool: ToolFactory, handlers: PublishedSkillToolHandlers) => {
     sharedTools: {
+        opencode_wizard_catalog_fetch: unknown;
+        opencode_wizard_artifact_fetch: unknown;
+        opencode_wizard_artifact_preference_set: unknown;
         opencode_wizard_published_skills_fetch: unknown;
         opencode_wizard_published_skill_preference_set: unknown;
         opencode_wizard_status: unknown;
     };
     editorOnlyTools: {
         opencode_wizard_editor_publish_skill: unknown;
+        opencode_wizard_artifact_import: unknown;
     };
 };
 export {};

package/dist/plugin-tools.js

@@ -1,14 +1,50 @@
-export const AVAILABLE_PUBLISHED_SKILL_TOOLS = ['opencode_wizard_published_skills_fetch', 'opencode_wizard_published_skill_preference_set', 'opencode_wizard_status', 'opencode_wizard_editor_publish_skill'];
-const SHARED_PUBLISHED_SKILL_TOOLS = AVAILABLE_PUBLISHED_SKILL_TOOLS.slice(0, 3);
+export const AVAILABLE_PUBLISHED_SKILL_TOOLS = ['opencode_wizard_catalog_fetch', 'opencode_wizard_artifact_fetch', 'opencode_wizard_artifact_preference_set', 'opencode_wizard_published_skills_fetch', 'opencode_wizard_published_skill_preference_set', 'opencode_wizard_status', 'opencode_wizard_editor_publish_skill', 'opencode_wizard_artifact_import'];
+const SHARED_PUBLISHED_SKILL_TOOLS = AVAILABLE_PUBLISHED_SKILL_TOOLS.slice(0, 6);
 export const resolveAvailableTools = role => {
-  if (role === 'ADMIN') return [...SHARED_PUBLISHED_SKILL_TOOLS];
   if (role === 'EDITOR') return [...AVAILABLE_PUBLISHED_SKILL_TOOLS];
-  return [];
+  return [...SHARED_PUBLISHED_SKILL_TOOLS];
 };
 export const createPublishedSkillToolDefinitions = (tool, handlers) => ({
   sharedTools: {
+    opencode_wizard_catalog_fetch: tool({
+      description: 'Always-available canonical wizard artifact catalog tool. Supports artifactKind SKILL and DESIGN_DOC; catalogs are metadata-only and bodies/files require explicit artifact fetch.',
+      args: {
+        artifactKind: tool.schema.string().optional().describe('Wizard artifact kind to catalog: SKILL or DESIGN_DOC; defaults to SKILL'),
+        directory: tool.schema.string().optional().describe('Optional absolute or relative directory override'),
+        refresh: tool.schema.boolean().optional().describe('Bypass the local plugin cache for this request')
+      },
+      async execute(args, context) {
+        return handlers.fetchWizardArtifactCatalog(args, context);
+      }
+    }),
+    opencode_wizard_artifact_fetch: tool({
+      description: 'Always-available canonical wizard artifact detail tool. Supports artifactKind SKILL and DESIGN_DOC; fetches explicit backend-authorized bodies/files for effective artifacts.',
+      args: {
+        artifactKind: tool.schema.string().optional().describe('Wizard artifact kind to fetch: SKILL or DESIGN_DOC; defaults to SKILL'),
+        artifact: tool.schema.string().optional().describe('Single artifact identifier; for SKILL this is a skill slug, artifact name, or skill name'),
+        artifacts: tool.schema.string().optional().describe('One or more comma-separated or newline-separated artifact identifiers'),
+        directory: tool.schema.string().optional().describe('Optional absolute or relative directory override'),
+        refresh: tool.schema.boolean().optional().describe('Bypass the local plugin cache for this request')
+      },
+      async execute(args, context) {
+        return handlers.fetchWizardArtifacts(args, context);
+      }
+    }),
+    opencode_wizard_artifact_preference_set: tool({
+      description: 'Always-available canonical wizard artifact preference tool. Supports SKILL and DESIGN_DOC install/uninstall/ignore/unignore through server-backed artifact preference APIs.',
+      args: {
+        artifactKind: tool.schema.string().optional().describe('Wizard artifact kind to update: SKILL or DESIGN_DOC; defaults to SKILL'),
+        artifact: tool.schema.string().describe('Artifact identifier; for SKILL this is the published skill slug'),
+        action: tool.schema.string().describe('Preference action: install, uninstall, ignore, or unignore'),
+        preferenceScope: tool.schema.string().optional().describe('Preference scope for the action: project or global; defaults to project'),
+        directory: tool.schema.string().optional().describe('Optional absolute or relative directory override')
+      },
+      async execute(args, context) {
+        return handlers.updateWizardArtifactPreference(args, context);
+      }
+    }),
     opencode_wizard_published_skills_fetch: tool({
-      description: 'Fetch one or multiple wizard-published skill bodies/details for the current scope. Use this for wizard-listed/private/scoped/backend-published skill slugs instead of the native OpenCode skill tool, and after native errors like `Skill "..." not found`; prefer `skills` for multiple identifiers and call with no args to discover the catalog and bootstrap auth when needed',
+      description: 'Always-available tool to fetch one or multiple wizard-published skill bodies/details for the current scope. Use this for wizard-listed/private/scoped/backend-published skill slugs instead of the native OpenCode skill tool; auth/catalog failures are returned in tool output. Prefer `skills` for multiple identifiers, call with no args to discover/bootstrap auth, and pass `refresh: true` before clearing plugin/OpenCode caches',
       args: {
         skill: tool.schema.string().optional().describe('Single skill slug, artifact name, or skill name; backward-compatible with comma/newline-delimited lists'),
         skills: tool.schema.string().optional().describe('One or more comma-separated or newline-separated skill slugs, artifact names, or skill names'),
@@ -20,7 +56,7 @@ export const createPublishedSkillToolDefinitions = (tool, handlers) => ({
       }
     }),
     opencode_wizard_published_skill_preference_set: tool({
-      description: 'Install, uninstall, ignore, or unignore a backend-published wizard skill for non-TUI workflows using the same shared server-backed preference API as the TUI overlay',
+      description: 'Always-available tool to install, uninstall, ignore, or unignore a backend-published wizard skill for non-TUI workflows using the same shared server-backed preference API as the TUI overlay; auth/catalog failures are returned in tool output',
       args: {
         skill: tool.schema.string().describe('Published skill slug, artifact name, or skill name to update'),
         action: tool.schema.string().describe('Preference action: install, uninstall, ignore, or unignore'),
@@ -32,7 +68,7 @@ export const createPublishedSkillToolDefinitions = (tool, handlers) => ({
       }
     }),
     opencode_wizard_status: tool({
-      description: 'Report opencode-wizard plugin status, bootstrap auth when missing, and return a safe auth summary without exposing tokens',
+      description: 'Always-available tool to report opencode-wizard plugin status, bootstrap auth when missing, and return safe auth/catalog/source/cache/workspace guidance without exposing tokens',
       args: {
         directory: tool.schema.string().optional().describe('Optional absolute or relative directory override')
       },
@@ -51,6 +87,21 @@ export const createPublishedSkillToolDefinitions = (tool, handlers) => ({
       async execute(args, context) {
         return handlers.publishEditorSkill(args, context);
       }
+    }),
+    opencode_wizard_artifact_import: tool({
+      description: 'Editor-only import tool for external wizard artifacts. Supports SKILL from GitHub/raw SKILL.md sources and DESIGN_DOC from direct URLs or command-like inputs such as `npx getdesign@latest add bmw-m`. Imported backend artifacts become the plugin runtime authority; no project files are written.',
+      args: {
+        artifactKind: tool.schema.string().optional().describe('Wizard artifact kind to import: SKILL or DESIGN_DOC; inferred from source when omitted'),
+        source: tool.schema.string().describe('Direct URL or command-like input, e.g. `https://github.com/vercel-labs/skills --skill find-skills` or `npx getdesign@latest add bmw-m`'),
+        slug: tool.schema.string().optional().describe('Artifact slug; required for DESIGN_DOC unless inferable'),
+        skill: tool.schema.string().optional().describe('Skill directory/name for SKILL repo imports'),
+        name: tool.schema.string().optional().describe('Optional display name override'),
+        summary: tool.schema.string().optional().describe('Optional summary/description override'),
+        directory: tool.schema.string().optional().describe('Optional absolute or relative directory override')
+      },
+      async execute(args, context) {
+        return handlers.importWizardArtifact(args, context);
+      }
     })
   }
 });