vgxness 1.17.2 → 1.19.0

package/dist/mcp/schema.js

@@ -30,7 +30,20 @@ export const SUPPORTED_VGX_MCP_TOOL_NAMES = [
     'vgxness_manager_profile_get',
     'vgxness_manager_profile_set',
     'vgxness_skill_index',
+    'vgxness_skill_search',
+    'vgxness_skill_get',
+    'vgxness_skill_status',
     'vgxness_skill_payload',
+    'vgxness_skill_activate',
+    'vgxness_skill_record_usage',
+    'vgxness_skill_propose_improvement',
+    'vgxness_skill_list_improvement_proposals',
+    'vgxness_skill_request_evaluation',
+    'vgxness_skill_list_evaluations',
+    'vgxness_skill_get_evaluation',
+    'vgxness_skill_create_draft',
+    'vgxness_skill_update_draft',
+    'vgxness_skill_publish_version',
     'vgxness_opencode_manager_payload',
     'vgxness_opencode_handoff_preview',
     'vgxness_run_list',
@@ -74,7 +87,20 @@ export const EXPOSED_VGX_MCP_TOOL_NAMES = [
     'manager_profile_get',
     'manager_profile_set',
     'skill_index',
+    'skill_search',
+    'skill_get',
+    'skill_status',
     'skill_payload',
+    'skill_activate',
+    'skill_record_usage',
+    'skill_propose_improvement',
+    'skill_list_improvement_proposals',
+    'skill_request_evaluation',
+    'skill_list_evaluations',
+    'skill_get_evaluation',
+    'skill_create_draft',
+    'skill_update_draft',
+    'skill_publish_version',
     'opencode_manager_payload',
     'opencode_handoff_preview',
     'run_list',
@@ -107,6 +133,28 @@ const runStatuses = ['created', 'planned', 'running', 'needs-human', 'completed'
 const finalRunStatuses = ['completed', 'failed', 'blocked', 'cancelled'];
 const runOutcomes = ['success', 'partial', 'failure', 'blocked', 'cancelled'];
 const payloadModes = ['compact', 'verbose'];
+const skillVersionStatuses = ['draft', 'active', 'deprecated', 'archived'];
+const skillImprovementProposalStatuses = ['draft', 'pending-approval', 'approved', 'rejected', 'cancelled', 'applied'];
+const skillEvaluationRequestStatuses = ['requested', 'planned', 'running', 'completed', 'failed', 'cancelled', 'skipped'];
+const skillSourceKinds = ['path', 'url', 'inline'];
+const skillUsageOutcomes = ['selected', 'injected', 'helped', 'failed', 'neutral'];
+const skillAttachmentTargetTypes = ['agent', 'subagent', 'workflow-phase', 'provider-adapter', 'intent-signal'];
+const jsonRecordSchema = z.record(z.string(), z.unknown());
+const skillLifecycleActorSchema = z
+    .object({
+    type: z.enum(['human', 'agent', 'system']),
+    id: z.string().min(1),
+    displayName: z.string().min(1).optional(),
+})
+    .passthrough();
+const skillSourceSchema = z
+    .object({
+    kind: z.enum(skillSourceKinds),
+    path: z.string().min(1).optional(),
+    url: z.string().min(1).optional(),
+    inlineMetadata: jsonRecordSchema.optional(),
+})
+    .passthrough();
 const contextCockpitLevels = ['compact', 'expanded', 'verbose'];
 const providerChangePlanProviders = ['opencode', 'claude', 'antigravity', 'custom'];
 const providerChangePlanTypes = ['opencode-mcp-install', 'claude-mcp-install', 'setup', 'install', 'config-preparation'];
@@ -483,6 +531,34 @@ export const VGX_MCP_TOOL_INPUT_SCHEMAS = {
         scope: z.enum(scopes),
     })
         .strict(),
+    vgxness_skill_search: z
+        .object({
+        project: z.string().min(1),
+        scope: z.enum(scopes).optional(),
+        query: z.string().min(1).optional(),
+        status: z.enum(skillVersionStatuses).optional(),
+        sourceKind: z.enum(skillSourceKinds).optional(),
+        limit: z.number().int().min(1).max(100).optional(),
+    })
+        .passthrough(),
+    vgxness_skill_get: z
+        .object({
+        project: z.string().min(1),
+        scope: z.enum(scopes).optional(),
+        id: z.string().min(1).optional(),
+        name: z.string().min(1).optional(),
+        includeUsage: z.boolean().optional(),
+    })
+        .passthrough(),
+    vgxness_skill_status: z
+        .object({
+        project: z.string().min(1),
+        scope: z.enum(scopes).optional(),
+        provider: z.string().min(1).optional(),
+        mode: z.enum(agentModes).optional(),
+        agent: z.string().min(1).optional(),
+    })
+        .passthrough(),
     vgxness_skill_payload: z
         .object({
         workspaceRoot: z.string().min(1),
@@ -499,6 +575,183 @@ export const VGX_MCP_TOOL_INPUT_SCHEMAS = {
         mode: z.enum(payloadModes).optional(),
     })
         .passthrough(),
+    vgxness_skill_activate: z
+        .object({
+        project: z.string().min(1),
+        scope: z.enum(scopes).optional(),
+        skillId: z.string().min(1).optional(),
+        name: z.string().min(1).optional(),
+        versionId: z.string().min(1).optional(),
+        version: z.string().min(1).optional(),
+        runId: z.string().min(1).optional(),
+        agentId: z.string().min(1).optional(),
+        workflow: z.string().min(1).optional(),
+        phase: z.string().min(1).optional(),
+        providerAdapter: z.string().min(1).optional(),
+        intent: jsonRecordSchema.optional(),
+        reason: z.string().min(1).optional(),
+        workspaceRoot: z.string().min(1).optional(),
+        maxSourceBytes: z.number().int().positive().optional(),
+        mode: z.enum(payloadModes).optional(),
+    })
+        .passthrough(),
+    vgxness_skill_record_usage: z
+        .object({
+        skillId: z.string().min(1),
+        versionId: z.string().min(1).optional(),
+        runId: z.string().min(1).optional(),
+        targetType: z.enum(skillAttachmentTargetTypes).optional(),
+        targetKey: z.string().min(1).optional(),
+        outcome: z.enum(skillUsageOutcomes),
+        notes: z.string().min(1).optional(),
+        workflow: z.string().min(1).optional(),
+        phase: z.string().min(1).optional(),
+        providerAdapter: z.string().min(1).optional(),
+        agentId: z.string().min(1).optional(),
+        intent: jsonRecordSchema.optional(),
+        evidence: jsonRecordSchema.optional(),
+    })
+        .passthrough(),
+    vgxness_skill_propose_improvement: z
+        .object({
+        project: z.string().min(1),
+        scope: z.enum(scopes).optional(),
+        skillId: z.string().min(1).optional(),
+        name: z.string().min(1).optional(),
+        baseVersionId: z.string().min(1).optional(),
+        baseVersion: z.string().min(1).optional(),
+        proposedVersion: z.string().min(1),
+        proposedSource: z
+            .object({
+            kind: z.enum(skillSourceKinds),
+            path: z.string().min(1).optional(),
+            url: z.string().min(1).optional(),
+            inlineMetadata: jsonRecordSchema.optional(),
+        })
+            .passthrough(),
+        proposedCompatibility: jsonRecordSchema.optional(),
+        title: z.string().min(1),
+        problem: z.string().min(1),
+        suggestedChange: z.string().min(1),
+        sourceContext: jsonRecordSchema.optional(),
+        runId: z.string().min(1).optional(),
+        agentId: z.string().min(1).optional(),
+        workflow: z.string().min(1).optional(),
+        phase: z.string().min(1).optional(),
+        providerAdapter: z.string().min(1).optional(),
+        evidenceRefs: z.array(z.string().min(1)).optional(),
+        evidence: jsonRecordSchema.optional(),
+        actor: z.string().min(1).optional(),
+    })
+        .passthrough(),
+    vgxness_skill_list_improvement_proposals: z
+        .object({
+        project: z.string().min(1),
+        scope: z.enum(scopes).optional(),
+        skillId: z.string().min(1).optional(),
+        name: z.string().min(1).optional(),
+        baseVersionId: z.string().min(1).optional(),
+        status: z.enum(skillImprovementProposalStatuses).optional(),
+        runId: z.string().min(1).optional(),
+        agentId: z.string().min(1).optional(),
+        limit: z.number().int().min(1).max(100).optional(),
+    })
+        .passthrough(),
+    vgxness_skill_request_evaluation: z
+        .object({
+        project: z.string().min(1),
+        scope: z.enum(scopes).optional(),
+        skillId: z.string().min(1).optional(),
+        name: z.string().min(1).optional(),
+        versionId: z.string().min(1).optional(),
+        version: z.string().min(1).optional(),
+        scenarioId: z.string().min(1).optional(),
+        proposalId: z.string().min(1).optional(),
+        requestedBy: z.string().min(1),
+        runId: z.string().min(1).optional(),
+        agentId: z.string().min(1).optional(),
+        workflow: z.string().min(1).optional(),
+        phase: z.string().min(1).optional(),
+        providerAdapter: z.string().min(1).optional(),
+        risk: jsonRecordSchema.optional(),
+        preflight: jsonRecordSchema.optional(),
+    })
+        .passthrough(),
+    vgxness_skill_list_evaluations: z
+        .object({
+        project: z.string().min(1),
+        scope: z.enum(scopes).optional(),
+        skillId: z.string().min(1).optional(),
+        name: z.string().min(1).optional(),
+        versionId: z.string().min(1).optional(),
+        scenarioId: z.string().min(1).optional(),
+        proposalId: z.string().min(1).optional(),
+        status: z.enum(skillEvaluationRequestStatuses).optional(),
+        runId: z.string().min(1).optional(),
+        agentId: z.string().min(1).optional(),
+        limit: z.number().int().min(1).max(100).optional(),
+    })
+        .passthrough(),
+    vgxness_skill_get_evaluation: z
+        .object({
+        project: z.string().min(1),
+        scope: z.enum(scopes).optional(),
+        id: z.string().min(1),
+    })
+        .passthrough(),
+    vgxness_skill_create_draft: z
+        .object({
+        project: z.string().min(1),
+        scope: z.enum(scopes).optional(),
+        name: z.string().min(1),
+        description: z.string().min(1),
+        version: z.string().min(1),
+        source: skillSourceSchema,
+        compatibility: jsonRecordSchema.optional(),
+        draftParentVersionId: z.string().min(1).optional(),
+        actor: skillLifecycleActorSchema,
+        reason: z.string().min(1).optional(),
+        runId: z.string().min(1).optional(),
+        agentId: z.string().min(1).optional(),
+        evidence: jsonRecordSchema.optional(),
+        governance: jsonRecordSchema.optional(),
+    })
+        .passthrough(),
+    vgxness_skill_update_draft: z
+        .object({
+        project: z.string().min(1),
+        scope: z.enum(scopes).optional(),
+        skillId: z.string().min(1).optional(),
+        name: z.string().min(1).optional(),
+        versionId: z.string().min(1).optional(),
+        version: z.string().min(1).optional(),
+        source: skillSourceSchema.optional(),
+        compatibility: jsonRecordSchema.optional(),
+        expectedDraftRevision: z.number().int().positive().optional(),
+        actor: skillLifecycleActorSchema,
+        reason: z.string().min(1).optional(),
+        runId: z.string().min(1).optional(),
+        agentId: z.string().min(1).optional(),
+        evidence: jsonRecordSchema.optional(),
+        governance: jsonRecordSchema.optional(),
+    })
+        .passthrough(),
+    vgxness_skill_publish_version: z
+        .object({
+        project: z.string().min(1),
+        scope: z.enum(scopes).optional(),
+        skillId: z.string().min(1).optional(),
+        name: z.string().min(1).optional(),
+        versionId: z.string().min(1).optional(),
+        version: z.string().min(1).optional(),
+        actor: skillLifecycleActorSchema,
+        reason: z.string().min(1),
+        runId: z.string().min(1).optional(),
+        agentId: z.string().min(1).optional(),
+        evidence: jsonRecordSchema.optional(),
+        governance: jsonRecordSchema.optional(),
+    })
+        .passthrough(),
     vgxness_opencode_manager_payload: z
         .object({
         project: z.string().min(1),

package/dist/mcp/stdio-server.js

@@ -69,6 +69,12 @@ function descriptionForTool(publicToolName) {
         return 'Read-only context cockpit for start/resume/recovery; returns latest restorable session plus bounded memory previews without traces, provider config writes, repository writes, runs, artifacts, or session mutations.';
     if (publicToolName === 'skill_index')
         return 'Read-only skill registry index for a project and scope; returns SkillIndexOutput without provider config writes, native skill file writes, URL fetches, usage records, startup refresh, or plugin refresh.';
+    if (publicToolName === 'skill_create_draft')
+        return 'Creates a draft skill version and lifecycle event without publishing, activation, provider config writes, or native skill installation.';
+    if (publicToolName === 'skill_update_draft')
+        return 'Updates only draft skill versions with optional optimistic revision checking; rejects active, deprecated, or archived version mutation.';
+    if (publicToolName === 'skill_publish_version')
+        return 'Publishes a draft skill version as active/current with explicit actor and reason; publication is not activation, SDD acceptance, or correctness proof.';
     if (publicToolName === 'sdd_cockpit')
         return 'Agent-callable read-only SDD cockpit summary; returns phase metadata/readModel without artifact bodies or state changes and preserves explicit human acceptance semantics. Use it to decide the next safe SDD action or blocker.';
     if (publicToolName === 'sdd_continue')