@aexol/opencode-wizard 0.3.3 → 0.3.4

package/dist/graphql-operations.d.ts

@@ -0,0 +1,4 @@
+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_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 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";

package/dist/graphql-operations.js

@@ -0,0 +1,225 @@
+export const PUBLISHED_SKILLS_CATALOG_QUERY = `
+  query PluginPublishedSkills($input: PublishedSkillsDeliveryInput!) {
+    pluginPublishedSkills(input: $input) {
+      workspace {
+        id
+        slug
+        name
+        repositoryUrl
+        defaultBranch
+        status
+      }
+      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
+        }
+      }
+      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
+        }
+      }
+      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
+          }
+        }
+      }
+    }
+  }
+`;
+export const SET_PUBLISHED_SKILL_PREFERENCE_MUTATION = `
+  mutation SetPublishedSkillPreference($input: SetPublishedSkillPreferenceInput!) {
+    setPublishedSkillPreference(input: $input) {
+      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
+        }
+      }
+    }
+  }
+`;
+export const PUBLISHED_SKILL_DETAIL_QUERY = `
+  query PluginPublishedSkillVersionArtifact($input: PublishedSkillArtifactDetailInput!) {
+    pluginPublishedSkillVersionArtifact(input: $input) {
+      id
+      frontmatterName
+      frontmatterDescription
+      markdownBody
+      renderedContent
+      checksum
+      publishedAt
+      fileCount
+      files {
+        id
+        relativePath
+        contentType
+        content
+        checksum
+        size
+        sortOrder
+      }
+    }
+  }
+`;
+export const CREATE_OR_UPDATE_SKILL_FROM_MARKDOWN_MUTATION = `
+  mutation CreateOrUpdateSkillFromMarkdown($markdownContent: String!) {
+    createOrUpdateSkillFromMarkdown(markdownContent: $markdownContent) {
+      success
+      skillSlug
+      skillVersionId
+      errors
+    }
+  }
+`;
+//# sourceMappingURL=graphql-operations.js.map

package/dist/graphql-operations.js.map

@@ -0,0 +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":[]}

package/dist/plugin-tools.d.ts

@@ -0,0 +1,64 @@
+export type PublishedSkillFetchArgs = {
+    skill?: string;
+    skills?: string;
+    directory?: string;
+    refresh?: boolean;
+};
+export type PluginStatusArgs = {
+    directory?: string;
+};
+export type PublishedSkillPreferenceArgs = {
+    skill: string;
+    action: string;
+    preferenceScope?: string;
+    directory?: string;
+};
+export type EditorPublishSkillArgs = {
+    skillSlug: string;
+    directory?: string;
+};
+type ToolSchemaValue<TSelf> = {
+    optional: () => TSelf;
+    describe: (description: string) => TSelf;
+};
+type ToolSchema = {
+    string: () => ToolSchemaValue<ToolSchemaValue<unknown>>;
+    boolean: () => ToolSchemaValue<ToolSchemaValue<unknown>>;
+};
+export type ToolExecuteContext = {
+    directory: string;
+    abort: AbortSignal;
+    metadata: (payload: {
+        title: string;
+        metadata: Record<string, string>;
+    }) => void;
+};
+type ToolDefinition<TArgs extends object> = {
+    description: string;
+    args: {
+        [K in keyof TArgs]-?: unknown;
+    };
+    execute: (args: TArgs, context: ToolExecuteContext) => Promise<unknown>;
+};
+export type ToolFactory = (<TArgs extends object>(definition: ToolDefinition<TArgs>) => unknown) & {
+    schema: ToolSchema;
+};
+type PublishedSkillToolHandlers = {
+    fetchPublishedSkills: (args: PublishedSkillFetchArgs, context: ToolExecuteContext) => Promise<unknown>;
+    updatePublishedSkillPreference: (args: PublishedSkillPreferenceArgs, context: ToolExecuteContext) => Promise<unknown>;
+    getStatus: (args: PluginStatusArgs, context: ToolExecuteContext) => Promise<unknown>;
+    publishEditorSkill: (args: EditorPublishSkillArgs, 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_published_skills_fetch: unknown;
+        opencode_wizard_published_skill_preference_set: unknown;
+        opencode_wizard_status: unknown;
+    };
+    editorOnlyTools: {
+        opencode_wizard_editor_publish_skill: unknown;
+    };
+};
+export {};

package/dist/plugin-tools.js

@@ -0,0 +1,57 @@
+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 resolveAvailableTools = role => {
+  if (role === 'ADMIN') return [...SHARED_PUBLISHED_SKILL_TOOLS];
+  if (role === 'EDITOR') return [...AVAILABLE_PUBLISHED_SKILL_TOOLS];
+  return [];
+};
+export const createPublishedSkillToolDefinitions = (tool, handlers) => ({
+  sharedTools: {
+    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',
+      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'),
+        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.fetchPublishedSkills(args, context);
+      }
+    }),
+    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',
+      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'),
+        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.updatePublishedSkillPreference(args, context);
+      }
+    }),
+    opencode_wizard_status: tool({
+      description: 'Report opencode-wizard plugin status, bootstrap auth when missing, and return a safe auth summary without exposing tokens',
+      args: {
+        directory: tool.schema.string().optional().describe('Optional absolute or relative directory override')
+      },
+      async execute(args, context) {
+        return handlers.getStatus(args, context);
+      }
+    })
+  },
+  editorOnlyTools: {
+    opencode_wizard_editor_publish_skill: tool({
+      description: 'Read skill markdown files from .opencode/skills/ and publish them to the backend via the createOrUpdateSkillFromMarkdown mutation. Requires EDITOR role.',
+      args: {
+        skillSlug: tool.schema.string().describe('Skill slug matching a directory under .opencode/skills/'),
+        directory: tool.schema.string().optional().describe('Optional absolute or relative directory override')
+      },
+      async execute(args, context) {
+        return handlers.publishEditorSkill(args, context);
+      }
+    })
+  }
+});
+//# sourceMappingURL=plugin-tools.js.map

package/dist/plugin-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["AVAILABLE_PUBLISHED_SKILL_TOOLS","SHARED_PUBLISHED_SKILL_TOOLS","slice","resolveAvailableTools","role","createPublishedSkillToolDefinitions","tool","handlers","sharedTools","opencode_wizard_published_skills_fetch","description","args","skill","schema","string","optional","describe","skills","directory","refresh","boolean","execute","context","fetchPublishedSkills","opencode_wizard_published_skill_preference_set","action","preferenceScope","updatePublishedSkillPreference","opencode_wizard_status","getStatus","editorOnlyTools","opencode_wizard_editor_publish_skill","skillSlug","publishEditorSkill"],"sources":["../src/plugin-tools.ts"],"sourcesContent":["export type PublishedSkillFetchArgs = {\n  skill?: string;\n  skills?: string;\n  directory?: string;\n  refresh?: boolean;\n};\n\nexport type PluginStatusArgs = {\n  directory?: string;\n};\n\nexport type PublishedSkillPreferenceArgs = {\n  skill: string;\n  action: string;\n  preferenceScope?: string;\n  directory?: string;\n};\n\nexport type EditorPublishSkillArgs = {\n  skillSlug: string;\n  directory?: string;\n};\n\ntype ToolSchemaValue<TSelf> = {\n  optional: () => TSelf;\n  describe: (description: string) => TSelf;\n};\n\ntype ToolSchema = {\n  string: () => ToolSchemaValue<ToolSchemaValue<unknown>>;\n  boolean: () => ToolSchemaValue<ToolSchemaValue<unknown>>;\n};\n\nexport type ToolExecuteContext = {\n  directory: string;\n  abort: AbortSignal;\n  metadata: (payload: { title: string; metadata: Record<string, string> }) => void;\n};\n\ntype ToolDefinition<TArgs extends object> = {\n  description: string;\n  args: { [K in keyof TArgs]-?: unknown };\n  execute: (args: TArgs, context: ToolExecuteContext) => Promise<unknown>;\n};\n\nexport type ToolFactory = (<TArgs extends object>(definition: ToolDefinition<TArgs>) => unknown) & {\n  schema: ToolSchema;\n};\n\ntype PublishedSkillToolHandlers = {\n  fetchPublishedSkills: (args: PublishedSkillFetchArgs, context: ToolExecuteContext) => Promise<unknown>;\n  updatePublishedSkillPreference: (args: PublishedSkillPreferenceArgs, context: ToolExecuteContext) => Promise<unknown>;\n  getStatus: (args: PluginStatusArgs, context: ToolExecuteContext) => Promise<unknown>;\n  publishEditorSkill: (args: EditorPublishSkillArgs, context: ToolExecuteContext) => Promise<unknown>;\n};\n\nexport const AVAILABLE_PUBLISHED_SKILL_TOOLS = [\n  'opencode_wizard_published_skills_fetch',\n  'opencode_wizard_published_skill_preference_set',\n  'opencode_wizard_status',\n  'opencode_wizard_editor_publish_skill',\n];\n\nconst SHARED_PUBLISHED_SKILL_TOOLS = AVAILABLE_PUBLISHED_SKILL_TOOLS.slice(0, 3);\n\nexport const resolveAvailableTools = (role: string | null | undefined): string[] => {\n  if (role === 'ADMIN') return [...SHARED_PUBLISHED_SKILL_TOOLS];\n  if (role === 'EDITOR') return [...AVAILABLE_PUBLISHED_SKILL_TOOLS];\n  return [];\n};\n\nexport const createPublishedSkillToolDefinitions = (\n  tool: ToolFactory,\n  handlers: PublishedSkillToolHandlers,\n) => ({\n  sharedTools: {\n    opencode_wizard_published_skills_fetch: tool<PublishedSkillFetchArgs>({\n      description:\n        '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',\n      args: {\n        skill: tool.schema\n          .string()\n          .optional()\n          .describe(\n            'Single skill slug, artifact name, or skill name; backward-compatible with comma/newline-delimited lists',\n          ),\n        skills: tool.schema\n          .string()\n          .optional()\n          .describe('One or more comma-separated or newline-separated skill slugs, artifact names, or skill names'),\n        directory: tool.schema.string().optional().describe('Optional absolute or relative directory override'),\n        refresh: tool.schema.boolean().optional().describe('Bypass the local plugin cache for this request'),\n      },\n      async execute(args, context) {\n        return handlers.fetchPublishedSkills(args, context);\n      },\n    }),\n    opencode_wizard_published_skill_preference_set: tool<PublishedSkillPreferenceArgs>({\n      description:\n        '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',\n      args: {\n        skill: tool.schema.string().describe('Published skill slug, artifact name, or skill name to update'),\n        action: tool.schema\n          .string()\n          .describe('Preference action: install, uninstall, ignore, or unignore'),\n        preferenceScope: tool.schema\n          .string()\n          .optional()\n          .describe('Preference scope for the action: project or global; defaults to project'),\n        directory: tool.schema.string().optional().describe('Optional absolute or relative directory override'),\n      },\n      async execute(args, context) {\n        return handlers.updatePublishedSkillPreference(args, context);\n      },\n    }),\n    opencode_wizard_status: tool<PluginStatusArgs>({\n      description:\n        'Report opencode-wizard plugin status, bootstrap auth when missing, and return a safe auth summary without exposing tokens',\n      args: {\n        directory: tool.schema.string().optional().describe('Optional absolute or relative directory override'),\n      },\n      async execute(args, context) {\n        return handlers.getStatus(args, context);\n      },\n    }),\n  },\n  editorOnlyTools: {\n    opencode_wizard_editor_publish_skill: tool<EditorPublishSkillArgs>({\n      description:\n        'Read skill markdown files from .opencode/skills/ and publish them to the backend via the createOrUpdateSkillFromMarkdown mutation. Requires EDITOR role.',\n      args: {\n        skillSlug: tool.schema\n          .string()\n          .describe('Skill slug matching a directory under .opencode/skills/'),\n        directory: tool.schema.string().optional().describe('Optional absolute or relative directory override'),\n      },\n      async execute(args, context) {\n        return handlers.publishEditorSkill(args, context);\n      },\n    }),\n  },\n});\n"],"mappings":"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","ignoreList":[]}

package/dist/published-skills-system-note.d.ts

@@ -0,0 +1,9 @@
+import { type PublishedSkillsSuccessState } from './published-skills-transform.js';
+export declare const buildPublishedSkillsSystemNote: ({ workspace, directoryPath, catalog, details: _details, }: {
+    workspace: {
+        slug: string;
+    } | null;
+    directoryPath: string;
+    catalog: PublishedSkillsSuccessState;
+    details: unknown[];
+}) => string;

package/dist/published-skills-system-note.js

@@ -0,0 +1,34 @@
+import { isUserPublishedSkillAssignment } from './published-skills-transform.js';
+const SYSTEM_NOTE_SKILL_NAME_LIMIT = 10;
+const SYSTEM_NOTE_SKILL_DESCRIPTION_LIMIT = 140;
+const truncateText = (value, maxLength) => {
+  const normalized = value.replace(/\s+/gu, ' ').trim();
+  if (normalized.length <= maxLength) return normalized;
+  return `${normalized.slice(0, Math.max(maxLength - 1, 0)).trimEnd()}…`;
+};
+const SCOPE_LABELS = {
+  global: 'GLOBAL SCOPE',
+  project: 'PROJECT SCOPE',
+  installable: 'INSTALLABLE'
+};
+const buildSkillCatalogLine = skill => {
+  const description = truncateText(skill.whenToUse || skill.artifactDescription || skill.skillName || skill.skillSlug, SYSTEM_NOTE_SKILL_DESCRIPTION_LIMIT);
+  const scopeLabel = isUserPublishedSkillAssignment(skill.assignmentSource) ? 'USER SCOPE' : SCOPE_LABELS[skill.contextKind] || 'PROJECT SCOPE';
+  return `- ${skill.artifactName || skill.skillName} (${skill.skillSlug}, ${scopeLabel}): ${description}`;
+};
+export const buildPublishedSkillsSystemNote = ({
+  workspace,
+  directoryPath,
+  catalog,
+  details: _details
+}) => {
+  const skillNames = catalog.skills.map(skill => skill.artifactName || skill.skillName || skill.skillSlug);
+  const renderedSkillNames = skillNames.length > 0 ? skillNames.slice(0, SYSTEM_NOTE_SKILL_NAME_LIMIT).join(', ') : 'none';
+  const remainingCount = Math.max(skillNames.length - SYSTEM_NOTE_SKILL_NAME_LIMIT, 0);
+  const renderedCountSuffix = remainingCount > 0 ? ` (+${remainingCount} more)` : '';
+  const globalSkills = catalog.skills.filter(skill => skill.contextKind === 'global' && !isUserPublishedSkillAssignment(skill.assignmentSource)).slice(0, 8).map(buildSkillCatalogLine);
+  const projectSkills = catalog.skills.filter(skill => skill.contextKind === 'project' && !isUserPublishedSkillAssignment(skill.assignmentSource)).slice(0, 5).map(buildSkillCatalogLine);
+  const userSkills = catalog.skills.filter(skill => isUserPublishedSkillAssignment(skill.assignmentSource)).slice(0, 5).map(buildSkillCatalogLine);
+  return [workspace ? `Workspace: ${workspace.slug}.` : 'Workspace not found; workspace-scoped wizard skills are unavailable.', `Current directory: ${directoryPath}.`, `Active wizard skills: ${renderedSkillNames}${renderedCountSuffix}.`, `Counts: ${catalog.assignmentCounts.global} global, ${catalog.assignmentCounts.project} project, ${catalog.assignmentCounts.user} user, ${catalog.assignmentCounts.other} other.`, 'Wizard-listed skills are backend-published; fetch body via `opencode_wizard_published_skills_fetch` before use (`skills`/`skill` for multiple/single). If native skill loading fails for a wizard name, fetch it. Fetched wizard bodies are authoritative over local seed/native sources.', globalSkills.length > 0 ? `Global skills:\n${globalSkills.join('\n')}` : 'Global skills: none.', projectSkills.length > 0 ? `Project skills:\n${projectSkills.join('\n')}` : 'Project skills: none.', userSkills.length > 0 ? `User skills:\n${userSkills.join('\n')}` : 'User skills: none.'].filter(Boolean).join(' ');
+};
+//# sourceMappingURL=published-skills-system-note.js.map

package/dist/published-skills-system-note.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["isUserPublishedSkillAssignment","SYSTEM_NOTE_SKILL_NAME_LIMIT","SYSTEM_NOTE_SKILL_DESCRIPTION_LIMIT","truncateText","value","maxLength","normalized","replace","trim","length","slice","Math","max","trimEnd","SCOPE_LABELS","global","project","installable","buildSkillCatalogLine","skill","description","whenToUse","artifactDescription","skillName","skillSlug","scopeLabel","assignmentSource","contextKind","artifactName","buildPublishedSkillsSystemNote","workspace","directoryPath","catalog","details","_details","skillNames","skills","map","renderedSkillNames","join","remainingCount","renderedCountSuffix","globalSkills","filter","projectSkills","userSkills","slug","assignmentCounts","user","other","Boolean"],"sources":["../src/published-skills-system-note.ts"],"sourcesContent":["import {\n  isUserPublishedSkillAssignment,\n  type PublishedSkillsSuccessState,\n} from './published-skills-transform.js';\n\nconst SYSTEM_NOTE_SKILL_NAME_LIMIT = 10;\nconst SYSTEM_NOTE_SKILL_DESCRIPTION_LIMIT = 140;\n\nconst truncateText = (value: string, maxLength: number): string => {\n  const normalized = value.replace(/\\s+/gu, ' ').trim();\n  if (normalized.length <= maxLength) return normalized;\n  return `${normalized.slice(0, Math.max(maxLength - 1, 0)).trimEnd()}…`;\n};\n\nconst SCOPE_LABELS: Record<PublishedSkillsSuccessState['skills'][number]['contextKind'], string> = {\n  global: 'GLOBAL SCOPE',\n  project: 'PROJECT SCOPE',\n  installable: 'INSTALLABLE',\n};\n\nconst buildSkillCatalogLine = (skill: PublishedSkillsSuccessState['skills'][number]): string => {\n  const description = truncateText(\n    skill.whenToUse || skill.artifactDescription || skill.skillName || skill.skillSlug,\n    SYSTEM_NOTE_SKILL_DESCRIPTION_LIMIT,\n  );\n  const scopeLabel = isUserPublishedSkillAssignment(skill.assignmentSource)\n    ? 'USER SCOPE'\n    : (SCOPE_LABELS[skill.contextKind] || 'PROJECT SCOPE');\n  return `- ${skill.artifactName || skill.skillName} (${skill.skillSlug}, ${scopeLabel}): ${description}`;\n};\n\nexport const buildPublishedSkillsSystemNote = ({\n  workspace,\n  directoryPath,\n  catalog,\n  details: _details,\n}: {\n  workspace: { slug: string } | null;\n  directoryPath: string;\n  catalog: PublishedSkillsSuccessState;\n  details: unknown[];\n}): string => {\n  const skillNames = catalog.skills.map((skill) => skill.artifactName || skill.skillName || skill.skillSlug);\n  const renderedSkillNames =\n    skillNames.length > 0 ? skillNames.slice(0, SYSTEM_NOTE_SKILL_NAME_LIMIT).join(', ') : 'none';\n  const remainingCount = Math.max(skillNames.length - SYSTEM_NOTE_SKILL_NAME_LIMIT, 0);\n  const renderedCountSuffix = remainingCount > 0 ? ` (+${remainingCount} more)` : '';\n  const globalSkills = catalog.skills\n    .filter((skill) => skill.contextKind === 'global' && !isUserPublishedSkillAssignment(skill.assignmentSource))\n    .slice(0, 8)\n    .map(buildSkillCatalogLine);\n  const projectSkills = catalog.skills\n    .filter((skill) => skill.contextKind === 'project' && !isUserPublishedSkillAssignment(skill.assignmentSource))\n    .slice(0, 5)\n    .map(buildSkillCatalogLine);\n  const userSkills = catalog.skills\n    .filter((skill) => isUserPublishedSkillAssignment(skill.assignmentSource))\n    .slice(0, 5)\n    .map(buildSkillCatalogLine);\n\n  return [\n    workspace ? `Workspace: ${workspace.slug}.` : 'Workspace not found; workspace-scoped wizard skills are unavailable.',\n    `Current directory: ${directoryPath}.`,\n    `Active wizard skills: ${renderedSkillNames}${renderedCountSuffix}.`,\n    `Counts: ${catalog.assignmentCounts.global} global, ${catalog.assignmentCounts.project} project, ${catalog.assignmentCounts.user} user, ${catalog.assignmentCounts.other} other.`,\n    'Wizard-listed skills are backend-published; fetch body via `opencode_wizard_published_skills_fetch` before use (`skills`/`skill` for multiple/single). If native skill loading fails for a wizard name, fetch it. Fetched wizard bodies are authoritative over local seed/native sources.',\n    globalSkills.length > 0 ? `Global skills:\\n${globalSkills.join('\\n')}` : 'Global skills: none.',\n    projectSkills.length > 0 ? `Project skills:\\n${projectSkills.join('\\n')}` : 'Project skills: none.',\n    userSkills.length > 0 ? `User skills:\\n${userSkills.join('\\n')}` : 'User skills: none.',\n  ]\n    .filter(Boolean)\n    .join(' ');\n};\n"],"mappings":"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","ignoreList":[]}

package/dist/published-skills-transform.d.ts

@@ -0,0 +1,161 @@
+type PublishedSkillFacetLike = {
+    slug: string;
+    label: string;
+    description?: string | null;
+};
+type PublishedSkillTagLike = {
+    slug: string;
+    label: string;
+    description?: string | null;
+    facet?: PublishedSkillFacetLike | null;
+};
+type PublishedSkillInstallPolicy = 'GLOBAL_CONTEXT' | 'PROJECT_INSTALLABLE';
+type PublishedSkillCatalogItemLike = {
+    assignmentSource: string;
+    assignmentType: string;
+    scopePath: string;
+    includeChildren?: boolean | null;
+    skill: {
+        id: string;
+        slug: string;
+        name: string;
+        summary?: string | null;
+        whenToUse?: string | null;
+        status: string;
+        installPolicy: PublishedSkillInstallPolicy;
+        tags: PublishedSkillTagLike[];
+    };
+    skillVersion: {
+        id: string;
+        version: string;
+        title?: string | null;
+        summary?: string | null;
+        status: string;
+    };
+    publishedArtifact: {
+        id: string;
+        frontmatterName: string;
+        frontmatterDescription: string;
+        checksum: string;
+        publishedAt: string;
+        fileCount: number;
+    };
+};
+type PublishedSkillArtifactFileLike = {
+    id: string;
+    relativePath: string;
+    contentType: string;
+    content: string;
+    checksum: string;
+    size: number;
+    sortOrder: number;
+};
+type PublishedSkillDetailItemLike = PublishedSkillCatalogItemLike & {
+    publishedArtifact: PublishedSkillCatalogItemLike['publishedArtifact'] & {
+        markdownBody: string;
+        renderedContent: string;
+        files: PublishedSkillArtifactFileLike[];
+    };
+};
+type PublishedSkillInstallableCatalogItemLike = Pick<PublishedSkillCatalogItemLike, 'skill' | 'skillVersion' | 'publishedArtifact'>;
+type PublishedSkillCatalogPayloadLike<TItem extends PublishedSkillCatalogItemLike = PublishedSkillCatalogItemLike> = {
+    workspace: {
+        id: string;
+        slug: string;
+        name: string;
+        repositoryUrl?: string | null;
+        defaultBranch?: string | null;
+        status: string;
+    } | null;
+    directoryPath: string;
+    skills: TItem[];
+    catalogSkills: PublishedSkillInstallableCatalogItemLike[];
+    userPreferences: {
+        scopeKey: string;
+        userKey: string;
+        ignoredSkills: PublishedSkillCatalogItemLike[];
+    };
+};
+export type PublishedSkillFacetSummary = {
+    slug: string;
+    label: string;
+    description: string | null;
+};
+export type PublishedSkillTagSummary = {
+    slug: string;
+    label: string;
+    description: string | null;
+    facet: PublishedSkillFacetSummary | null;
+};
+export type PublishedSkillSummary = {
+    skillSlug: string;
+    skillName: string;
+    artifactName: string;
+    artifactDescription: string;
+    whenToUse: string | null;
+    version: string;
+    assignmentSource: string;
+    assignmentType: string;
+    scopePath: string;
+    includeChildren: boolean | null;
+    checksum: string;
+    publishedAt: string;
+    fileCount: number;
+    identifiers: string[];
+    tags: PublishedSkillTagSummary[];
+    contextKind: 'global' | 'project' | 'installable';
+    installPolicy: PublishedSkillInstallPolicy;
+    assignmentLabel: string;
+    policyLabel: string;
+};
+export type PublishedSkillDetail = PublishedSkillSummary & {
+    skillId: string;
+    skillVersionId: string;
+    artifactId: string;
+    markdownDocument: string;
+    markdownBody: string;
+    renderedContent: string;
+    files: PublishedSkillArtifactFileLike[];
+    resources: PublishedSkillArtifactFileLike[];
+};
+export type PublishedSkillsSuccessState = {
+    pluginId: string;
+    runtimeMode: 'tool_fetch_only';
+    deliveryModel: 'backend_published_installed_effective_skills';
+    workspace: PublishedSkillCatalogPayloadLike['workspace'];
+    directoryPath: string;
+    rootSkillSeedPath: string;
+    availableTools: string[];
+    publishedSkillCount: number;
+    assignmentCounts: {
+        global: number;
+        project: number;
+        user: number;
+        other: number;
+    };
+    facets: PublishedSkillFacetSummary[];
+    skills: PublishedSkillSummary[];
+};
+type PublishedSkillCatalogOptions = {
+    pluginId: string;
+    rootSkillSeedPath: string;
+    availableTools: string[];
+};
+export declare const formatSkillLabel: (item: PublishedSkillCatalogItemLike) => string;
+export declare const buildSkillMarkdown: (item: PublishedSkillDetailItemLike) => string;
+export declare const isUserPublishedSkillAssignment: (assignmentSource: string) => boolean;
+export declare const toPublishedSkillSummary: (item: PublishedSkillCatalogItemLike) => PublishedSkillSummary;
+export declare const toPublishedSkillDetail: (item: PublishedSkillDetailItemLike) => PublishedSkillDetail;
+export declare const toInstallableSkillSummary: (item: PublishedSkillInstallableCatalogItemLike) => PublishedSkillSummary;
+export declare const toPublishedSkillCatalog: (payload: PublishedSkillCatalogPayloadLike, options: PublishedSkillCatalogOptions) => PublishedSkillsSuccessState;
+export declare const parseRequestedSkillArgs: (args: {
+    skill?: string;
+    skills?: string;
+}) => string[];
+export declare const selectPublishedSkills: <TItem extends PublishedSkillCatalogItemLike>(payload: Omit<PublishedSkillCatalogPayloadLike<TItem>, "skills"> & {
+    skills: TItem[];
+}, identifiers: string[]) => {
+    selectedItems: TItem[];
+    missingIdentifiers: string[];
+};
+export {};