@actwith-ai/mcp-server 0.1.0

package/dist/tools/artifacts.js

@@ -0,0 +1,462 @@
+/**
+ * Artifact Tools for MCP Server
+ *
+ * Tools for managing work products: documents, data, code, etc.
+ * Artifacts have stages (input → draft → review → final → approved).
+ */
+export const artifactTools = [
+    {
+        name: "artifacts",
+        description: "List work products (documents, data, code) in the workspace. " +
+            "Filter by type, stage, tag, or context.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                type: {
+                    type: "string",
+                    enum: ["document", "image", "data", "code", "binary"],
+                    description: "Filter by artifact type",
+                },
+                stage: {
+                    type: "string",
+                    enum: ["input", "draft", "review", "final", "approved"],
+                    description: "Filter by stage",
+                },
+                tag: {
+                    type: "string",
+                    description: "Filter by tag (returns artifacts with this tag)",
+                },
+                context_id: {
+                    type: "string",
+                    description: "Filter by work context ID",
+                },
+                space_level: {
+                    type: "boolean",
+                    description: "Only show space-level artifacts (not in any context)",
+                },
+            },
+        },
+    },
+    {
+        name: "artifact_details",
+        description: "Get details about a specific artifact including its metadata.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                artifact_id: {
+                    type: "string",
+                    description: "The artifact ID",
+                },
+            },
+            required: ["artifact_id"],
+        },
+    },
+    {
+        name: "artifact_content",
+        description: "Read the content of an artifact.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                artifact_id: {
+                    type: "string",
+                    description: "The artifact ID",
+                },
+            },
+            required: ["artifact_id"],
+        },
+    },
+    {
+        name: "create_artifact",
+        description: "Create a new artifact (document, data, code, etc). " +
+            "Useful for storing work products that should be tracked.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: {
+                    type: "string",
+                    description: 'Name of the artifact (e.g., "requirements.md")',
+                },
+                type: {
+                    type: "string",
+                    enum: ["document", "image", "data", "code", "binary"],
+                    description: "Type of artifact",
+                },
+                content_type: {
+                    type: "string",
+                    description: 'MIME type (e.g., "text/markdown", "application/json")',
+                },
+                content: {
+                    description: "The artifact content",
+                },
+                description: {
+                    type: "string",
+                    description: "Optional description",
+                },
+                stage: {
+                    type: "string",
+                    enum: ["input", "draft", "review", "final", "approved"],
+                    description: "Initial stage (default: draft)",
+                },
+                context_id: {
+                    type: "string",
+                    description: "Work context ID (if omitted, creates at space level)",
+                },
+                tags: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Tags for categorization (e.g., ['api', 'auth'])",
+                },
+                insight: {
+                    type: "string",
+                    description: "Why this artifact exists and what it's for (aids discovery)",
+                },
+                source_artifact_ids: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "IDs of artifacts this was created from (lineage)",
+                },
+            },
+            required: ["name", "type", "content_type"],
+        },
+    },
+    {
+        name: "update_artifact",
+        description: "Update an artifact's content (creates a new version).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                artifact_id: {
+                    type: "string",
+                    description: "The artifact ID",
+                },
+                content: {
+                    description: "The new content",
+                },
+            },
+            required: ["artifact_id", "content"],
+        },
+    },
+    {
+        name: "update_artifact_metadata",
+        description: "Update an artifact's metadata (name, description, tags, insight). " +
+            "Does not create a new version.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                artifact_id: {
+                    type: "string",
+                    description: "The artifact ID",
+                },
+                name: {
+                    type: "string",
+                    description: "New name for the artifact",
+                },
+                description: {
+                    type: "string",
+                    description: "New description",
+                },
+                tags: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "New tags (replaces existing)",
+                },
+                insight: {
+                    type: "string",
+                    description: "New insight (why this exists)",
+                },
+            },
+            required: ["artifact_id"],
+        },
+    },
+    {
+        name: "advance_artifact",
+        description: "Move an artifact to the next stage (e.g., draft → review → final).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                artifact_id: {
+                    type: "string",
+                    description: "The artifact ID",
+                },
+                stage: {
+                    type: "string",
+                    enum: ["input", "draft", "review", "final", "approved"],
+                    description: "New stage",
+                },
+            },
+            required: ["artifact_id", "stage"],
+        },
+    },
+    {
+        name: "promote_artifact",
+        description: "Promote a context-level artifact to space level. " +
+            "Makes it available across all contexts as accumulated knowledge.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                artifact_id: {
+                    type: "string",
+                    description: "The artifact ID to promote",
+                },
+            },
+            required: ["artifact_id"],
+        },
+    },
+    {
+        name: "artifact_versions",
+        description: "Get version history for an artifact. " +
+            "Shows all previous versions with timestamps and who made each change.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                artifact_id: {
+                    type: "string",
+                    description: "The artifact ID",
+                },
+                limit: {
+                    type: "number",
+                    description: "Max versions to return (default: 20)",
+                },
+            },
+            required: ["artifact_id"],
+        },
+    },
+    {
+        name: "artifact_version_content",
+        description: "Read the content of a specific version of an artifact. " +
+            "Use artifact_versions first to see available versions.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                artifact_id: {
+                    type: "string",
+                    description: "The artifact ID",
+                },
+                version: {
+                    type: "number",
+                    description: "Version number to retrieve",
+                },
+            },
+            required: ["artifact_id", "version"],
+        },
+    },
+    {
+        name: "artifact_restore",
+        description: "Restore an artifact to a previous version. " +
+            "Creates a new version with the content from the specified old version.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                artifact_id: {
+                    type: "string",
+                    description: "The artifact ID",
+                },
+                version: {
+                    type: "number",
+                    description: "Version number to restore to",
+                },
+            },
+            required: ["artifact_id", "version"],
+        },
+    },
+];
+// Tool name aliases for backwards compatibility
+const TOOL_ALIASES = {
+    actwith_artifact_list: "artifacts",
+    actwith_artifact_get: "artifact_details",
+    actwith_artifact_content: "artifact_content",
+    actwith_artifact_create: "create_artifact",
+    actwith_artifact_update: "update_artifact",
+    actwith_artifact_stage: "advance_artifact",
+    actwith_artifact_promote: "promote_artifact",
+};
+export function normalizeArtifactToolName(name) {
+    return TOOL_ALIASES[name] || name;
+}
+export async function handleArtifactTool(client, name, args) {
+    const normalizedName = normalizeArtifactToolName(name);
+    switch (normalizedName) {
+        case "artifacts": {
+            const { type, stage, tag, context_id, space_level } = args;
+            const artifacts = await client.artifactsList({
+                type,
+                stage,
+                tag,
+                contextId: context_id,
+                spaceLevel: space_level,
+            });
+            return {
+                success: true,
+                count: artifacts.length,
+                artifacts: artifacts.map((a) => ({
+                    id: a.id,
+                    name: a.name,
+                    type: a.type,
+                    stage: a.stage,
+                    contentType: a.contentType,
+                    sizeBytes: a.sizeBytes,
+                    version: a.version,
+                    tags: a.tags,
+                    insight: a.insight,
+                    updatedAt: new Date(a.updatedAt * 1000).toISOString(),
+                })),
+            };
+        }
+        case "artifact_details": {
+            const { artifact_id } = args;
+            const artifact = await client.artifactGet(artifact_id);
+            if (!artifact) {
+                return {
+                    success: false,
+                    message: `Artifact "${artifact_id}" not found`,
+                };
+            }
+            return {
+                success: true,
+                artifact: {
+                    id: artifact.id,
+                    name: artifact.name,
+                    description: artifact.description,
+                    type: artifact.type,
+                    stage: artifact.stage,
+                    contentType: artifact.contentType,
+                    sizeBytes: artifact.sizeBytes,
+                    version: artifact.version,
+                    createdBy: artifact.createdBy,
+                    tags: artifact.tags,
+                    insight: artifact.insight,
+                    sourceArtifactIds: artifact.sourceArtifactIds,
+                    createdAt: new Date(artifact.createdAt * 1000).toISOString(),
+                    updatedAt: new Date(artifact.updatedAt * 1000).toISOString(),
+                },
+            };
+        }
+        case "artifact_content": {
+            const { artifact_id } = args;
+            const result = await client.artifactGetContent(artifact_id);
+            if (!result) {
+                return {
+                    success: false,
+                    message: `Artifact "${artifact_id}" not found or has no content`,
+                };
+            }
+            return {
+                success: true,
+                contentType: result.contentType,
+                content: result.content,
+            };
+        }
+        case "create_artifact": {
+            const { name, type, content_type, content, description, stage, context_id, tags, insight, source_artifact_ids, } = args;
+            const artifact = await client.artifactCreate({
+                name,
+                type,
+                contentType: content_type,
+                content,
+                description,
+                stage,
+                contextId: context_id,
+                tags,
+                insight,
+                sourceArtifactIds: source_artifact_ids,
+            });
+            return {
+                success: true,
+                message: `Created artifact "${name}"`,
+                artifact: {
+                    id: artifact.id,
+                    name: artifact.name,
+                    version: artifact.version,
+                },
+            };
+        }
+        case "update_artifact": {
+            const { artifact_id, content } = args;
+            const result = await client.artifactUpdateContent(artifact_id, content);
+            return {
+                success: true,
+                message: `Updated artifact, now at version ${result.version}`,
+                version: result.version,
+            };
+        }
+        case "update_artifact_metadata": {
+            const { artifact_id, name, description, tags, insight } = args;
+            await client.artifactUpdateMetadata(artifact_id, {
+                name,
+                description,
+                tags,
+                insight,
+            });
+            const updates = [];
+            if (name)
+                updates.push("name");
+            if (description)
+                updates.push("description");
+            if (tags)
+                updates.push("tags");
+            if (insight)
+                updates.push("insight");
+            return {
+                success: true,
+                message: `Updated artifact metadata: ${updates.join(", ") || "no changes"}`,
+            };
+        }
+        case "advance_artifact": {
+            const { artifact_id, stage } = args;
+            await client.artifactUpdateStage(artifact_id, stage);
+            return {
+                success: true,
+                message: `Artifact advanced to "${stage}" stage`,
+            };
+        }
+        case "promote_artifact": {
+            const { artifact_id } = args;
+            await client.artifactPromote(artifact_id);
+            return {
+                success: true,
+                message: "Artifact promoted to space level (now available across all contexts)",
+            };
+        }
+        case "artifact_versions": {
+            const { artifact_id, limit = 20 } = args;
+            const result = await client.artifactVersions(artifact_id, { limit });
+            return {
+                success: true,
+                artifactName: result.artifactName,
+                currentVersion: result.currentVersion,
+                totalVersions: result.total,
+                versions: result.versions.map((v) => ({
+                    version: v.version,
+                    sizeBytes: v.sizeBytes,
+                    changeSummary: v.changeSummary,
+                    createdBy: v.createdBy,
+                    createdAt: new Date(v.createdAt * 1000).toISOString(),
+                })),
+            };
+        }
+        case "artifact_version_content": {
+            const { artifact_id, version } = args;
+            const result = await client.artifactVersionContent(artifact_id, version);
+            return {
+                success: true,
+                version: result.version,
+                contentType: result.contentType,
+                content: result.content,
+            };
+        }
+        case "artifact_restore": {
+            const { artifact_id, version } = args;
+            const result = await client.artifactRestore(artifact_id, version);
+            return {
+                success: true,
+                message: `Restored artifact to version ${version}`,
+                previousVersion: result.previousVersion,
+                newVersion: result.newVersion,
+                restoredFrom: result.restoredFrom,
+            };
+        }
+        default:
+            throw new Error(`Unknown artifact tool: ${name}`);
+    }
+}
+//# sourceMappingURL=artifacts.js.map

package/dist/tools/artifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.js","sourceRoot":"","sources":["../../src/tools/artifacts.ts"],"names":[],"mappings":"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"}

package/dist/tools/contexts.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Work Context Tools for MCP Server
+ *
+ * Tools for managing bounded work contexts within a space.
+ * Contexts are like projects or sprints - they have a lifecycle.
+ *
+ * Context IS the Goal - it defines WHAT we're trying to achieve.
+ * Tasks within the context define HOW we achieve it.
+ */
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+import { ActwithClient } from "../client.js";
+export declare const contextTools: Tool[];
+export declare function normalizeContextToolName(name: string): string;
+export declare function handleContextTool(client: ActwithClient, name: string, args: Record<string, unknown>): Promise<unknown>;
+//# sourceMappingURL=contexts.d.ts.map

package/dist/tools/contexts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contexts.d.ts","sourceRoot":"","sources":["../../src/tools/contexts.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,eAAO,MAAM,YAAY,EAAE,IAAI,EAkF9B,CAAC;AAcF,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,OAAO,CAAC,CA2GlB"}

package/dist/tools/contexts.js

@@ -0,0 +1,188 @@
+/**
+ * Work Context Tools for MCP Server
+ *
+ * Tools for managing bounded work contexts within a space.
+ * Contexts are like projects or sprints - they have a lifecycle.
+ *
+ * Context IS the Goal - it defines WHAT we're trying to achieve.
+ * Tasks within the context define HOW we achieve it.
+ */
+export const contextTools = [
+    {
+        name: "projects",
+        description: "List work contexts (projects/sprints) in your workspace. " +
+            "Filter by status: active, completed, or archived.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                status: {
+                    type: "string",
+                    enum: ["active", "completed", "archived"],
+                    description: "Filter by status (default: all)",
+                },
+            },
+        },
+    },
+    {
+        name: "project_details",
+        description: "Get details about a specific work context/project.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                context_id: {
+                    type: "string",
+                    description: "The context ID",
+                },
+            },
+            required: ["context_id"],
+        },
+    },
+    {
+        name: "start_project",
+        description: "Create a new work context (project/goal). " +
+            "The context defines WHAT you're trying to achieve. " +
+            "Tasks within it define HOW. Include success criteria for measurable outcomes.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: {
+                    type: "string",
+                    description: 'Name of the project/goal (e.g., "Reduce food waste by 50%")',
+                },
+                description: {
+                    type: "string",
+                    description: "What this project is about",
+                },
+                success_criteria: {
+                    type: "string",
+                    description: 'What does "done" look like? Measurable outcome (e.g., "Waste rate reduced from 40% to 20%, verified by Q4 audit")',
+                },
+                target_metric: {
+                    type: "string",
+                    description: 'Quantifiable target (e.g., "50% reduction", "100K users")',
+                },
+                due_at: {
+                    type: "number",
+                    description: "Optional deadline (Unix timestamp)",
+                },
+            },
+            required: ["name"],
+        },
+    },
+    {
+        name: "finish_project",
+        description: "Mark a work context as completed. " +
+            "Completed contexts remain accessible but are no longer active.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                context_id: {
+                    type: "string",
+                    description: "The context ID to complete",
+                },
+            },
+            required: ["context_id"],
+        },
+    },
+];
+// Tool name aliases for backwards compatibility
+const TOOL_ALIASES = {
+    actwith_context_list: "projects",
+    actwith_context_get: "project_details",
+    actwith_context_create: "start_project",
+    actwith_context_complete: "finish_project",
+    work_contexts: "projects",
+    context_details: "project_details",
+    create_context: "start_project",
+    complete_context: "finish_project",
+};
+export function normalizeContextToolName(name) {
+    return TOOL_ALIASES[name] || name;
+}
+export async function handleContextTool(client, name, args) {
+    const normalizedName = normalizeContextToolName(name);
+    switch (normalizedName) {
+        case "projects": {
+            const { status } = args;
+            const contexts = await client.contextsList(status);
+            return {
+                success: true,
+                count: contexts.length,
+                projects: contexts.map((ctx) => ({
+                    id: ctx.id,
+                    name: ctx.name,
+                    description: ctx.description,
+                    status: ctx.status,
+                    artifactCount: ctx.artifactCount,
+                    taskCount: ctx.taskCount,
+                    createdAt: new Date(ctx.createdAt * 1000).toISOString(),
+                })),
+            };
+        }
+        case "project_details": {
+            const { context_id } = args;
+            const context = await client.contextGet(context_id);
+            if (!context) {
+                return {
+                    success: false,
+                    message: `Project "${context_id}" not found`,
+                };
+            }
+            return {
+                success: true,
+                project: {
+                    id: context.id,
+                    name: context.name,
+                    description: context.description,
+                    status: context.status,
+                    // Goal fields
+                    successCriteria: context.successCriteria,
+                    targetMetric: context.targetMetric,
+                    progress: context.progress,
+                    // Dates
+                    dueAt: context.dueAt
+                        ? new Date(context.dueAt * 1000).toISOString()
+                        : null,
+                    // Stats
+                    artifactCount: context.artifactCount,
+                    taskCount: context.taskCount,
+                    createdAt: new Date(context.createdAt * 1000).toISOString(),
+                    completedAt: context.completedAt
+                        ? new Date(context.completedAt * 1000).toISOString()
+                        : null,
+                },
+            };
+        }
+        case "start_project": {
+            const { name, description, success_criteria, target_metric, due_at } = args;
+            const context = await client.contextCreate(name, description, due_at, {
+                successCriteria: success_criteria,
+                targetMetric: target_metric,
+            });
+            return {
+                success: true,
+                message: `Created project "${name}"`,
+                project: {
+                    id: context.id,
+                    name: context.name,
+                    successCriteria: success_criteria,
+                    targetMetric: target_metric,
+                },
+                tip: success_criteria
+                    ? undefined
+                    : "Tip: Add success_criteria to make your goal measurable!",
+            };
+        }
+        case "finish_project": {
+            const { context_id } = args;
+            await client.contextComplete(context_id);
+            return {
+                success: true,
+                message: "Project marked as completed",
+            };
+        }
+        default:
+            throw new Error(`Unknown context tool: ${name}`);
+    }
+}
+//# sourceMappingURL=contexts.js.map