causly-server 0.0.0-stage → 1.5.0

package/packs/git.js

@@ -0,0 +1,211 @@
+import { z } from "zod";
+import * as gitOps from "../tools/gitOps.js";
+import { wrap } from "../tools/toolWrapper.js";
+
+export default function register(server) {
+// ---------------- Git tools ----------------
+
+server.registerTool(
+  "git_init",
+  {
+    description: "Initialize a new git repository in the given directory.",
+    inputSchema: { repo_path: z.string() },
+  },
+  wrap("git_init", gitOps.gitInit)
+);
+
+server.registerTool(
+  "git_status",
+  {
+    description: "Show the working tree status of a git repository.",
+    inputSchema: { repo_path: z.string() },
+  },
+  wrap("git_status", gitOps.gitStatus)
+);
+
+server.registerTool(
+  "git_add",
+  {
+    description: "Stage files for commit. Defaults to staging everything ('.').",
+    inputSchema: { repo_path: z.string(), files: z.union([z.string(), z.array(z.string())]).optional() },
+  },
+  wrap("git_add", gitOps.gitAdd)
+);
+
+server.registerTool(
+  "git_commit",
+  {
+    description: "Commit staged changes with a message.",
+    inputSchema: { repo_path: z.string(), message: z.string() },
+  },
+  wrap("git_commit", gitOps.gitCommit)
+);
+
+server.registerTool(
+  "git_push",
+  {
+    description: "Push commits to a remote.",
+    inputSchema: { repo_path: z.string(), remote: z.string().optional(), branch: z.string().optional() },
+  },
+  wrap("git_push", gitOps.gitPush)
+);
+
+server.registerTool(
+  "git_pull",
+  {
+    description: "Pull changes from a remote.",
+    inputSchema: { repo_path: z.string(), remote: z.string().optional(), branch: z.string().optional() },
+  },
+  wrap("git_pull", gitOps.gitPull)
+);
+
+server.registerTool(
+  "git_log",
+  {
+    description: "Show recent commit history.",
+    inputSchema: { repo_path: z.string(), max_count: z.number().optional() },
+  },
+  wrap("git_log", gitOps.gitLog)
+);
+
+server.registerTool(
+  "git_diff",
+  {
+    description: "Show uncommitted changes, optionally scoped to one file.",
+    inputSchema: { repo_path: z.string(), file: z.string().optional() },
+  },
+  wrap("git_diff", gitOps.gitDiff)
+);
+
+server.registerTool(
+  "git_branch",
+  {
+    description: "List local branches and show the current branch.",
+    inputSchema: { repo_path: z.string() },
+  },
+  wrap("git_branch", gitOps.gitBranch)
+);
+
+server.registerTool(
+  "git_create_branch",
+  {
+    description: "Create a new local branch, optionally checking it out immediately (default: yes).",
+    inputSchema: {
+      repo_path: z.string(),
+      branch_name: z.string(),
+      checkout: z.boolean().optional().describe("Defaults to true"),
+    },
+  },
+  wrap("git_create_branch", gitOps.gitCreateBranch)
+);
+
+server.registerTool(
+  "git_checkout",
+  {
+    description: "Checkout an existing local branch.",
+    inputSchema: { repo_path: z.string(), branch: z.string() },
+  },
+  wrap("git_checkout", gitOps.gitCheckout)
+);
+
+server.registerTool(
+  "git_merge",
+  {
+    description: "Merge the given branch into the current branch.",
+    inputSchema: { repo_path: z.string(), branch: z.string() },
+  },
+  wrap("git_merge", gitOps.gitMerge)
+);
+
+server.registerTool(
+  "git_reset",
+  {
+    description: "Reset the current branch to a ref. mode: 'soft' | 'mixed' | 'hard' (defaults to mixed). HIGH risk (can lose uncommitted work with --hard) — requires confirm: true.",
+    inputSchema: {
+      repo_path: z.string(),
+      mode: z.string().optional().describe("soft, mixed, or hard"),
+      ref: z.string().optional().describe("Defaults to HEAD"),
+      confirm: z.boolean().optional().describe("Must be true to proceed"),
+    },
+  },
+  wrap("git_reset", gitOps.gitReset)
+);
+
+server.registerTool(
+  "git_stash",
+  {
+    description: "Stash working changes. action: 'save' | 'pop' | 'apply' | 'list' | 'drop' (defaults to save).",
+    inputSchema: {
+      repo_path: z.string(),
+      action: z.string().optional().describe("save, pop, apply, list, or drop"),
+      message: z.string().optional().describe("Stash message, only used with save"),
+      stash_id: z.string().optional().describe("e.g. stash@{0}, used with pop/apply/drop"),
+    },
+  },
+  wrap("git_stash", gitOps.gitStash)
+);
+
+server.registerTool(
+  "git_show",
+  {
+    description: "Show details of a commit or object. Defaults to HEAD.",
+    inputSchema: { repo_path: z.string(), ref: z.string().optional() },
+  },
+  wrap("git_show", gitOps.gitShow)
+);
+
+server.registerTool(
+  "git_remote",
+  {
+    description: "Manage git remotes. action: 'list' | 'add' | 'remove' (defaults to list).",
+    inputSchema: {
+      repo_path: z.string(),
+      action: z.string().optional().describe("list, add, or remove"),
+      name: z.string().optional().describe("Remote name, required for add/remove"),
+      url: z.string().optional().describe("Remote URL, required for add"),
+    },
+  },
+  wrap("git_remote", gitOps.gitRemote)
+);
+
+server.registerTool(
+  "git_tag",
+  {
+    description: "Manage git tags. action: 'list' | 'create' | 'delete' (defaults to list).",
+    inputSchema: {
+      repo_path: z.string(),
+      action: z.string().optional().describe("list, create, or delete"),
+      tag_name: z.string().optional().describe("Required for create/delete"),
+      message: z.string().optional().describe("Annotation message, optional for create"),
+    },
+  },
+  wrap("git_tag", gitOps.gitTag)
+);
+
+server.registerTool(
+  "git_changed_files",
+  {
+    description: "List changed files in the working tree with their change type (modified/untracked/created/deleted/renamed).",
+    inputSchema: { repo_path: z.string() },
+  },
+  wrap("git_changed_files", gitOps.gitChangedFiles)
+);
+
+server.registerTool(
+  "git_diff_stat",
+  {
+    description: "Show a summary of changes (files changed, insertions, deletions) rather than the full diff.",
+    inputSchema: { repo_path: z.string(), file: z.string().optional() },
+  },
+  wrap("git_diff_stat", gitOps.gitDiffStat)
+);
+
+server.registerTool(
+  "git_check_clean",
+  {
+    description: "Check whether the working tree is clean (no uncommitted changes).",
+    inputSchema: { repo_path: z.string() },
+  },
+  wrap("git_check_clean", gitOps.gitCheckClean)
+);
+}

package/packs/github.js

@@ -0,0 +1,321 @@
+import { z } from "zod";
+import * as githubOps from "../tools/githubOps.js";
+import { wrap } from "../tools/toolWrapper.js";
+
+export default function register(server) {
+// ---------------- GitHub tools ----------------
+
+server.registerTool(
+  "github_get_authenticated_user",
+  {
+    description: "Get the authenticated GitHub user's profile. Useful as a connectivity/auth check.",
+    inputSchema: {},
+  },
+  wrap("github_get_authenticated_user", githubOps.githubGetAuthenticatedUser)
+);
+
+server.registerTool(
+  "github_create_repo",
+  {
+    description: "Create a new GitHub repository for the authenticated user.",
+    inputSchema: {
+      name: z.string(),
+      description: z.string().optional(),
+      private: z.boolean().optional().describe("Defaults to false (public)"),
+      auto_init: z.boolean().optional().describe("Initialize with a README, defaults to true"),
+    },
+  },
+  wrap("github_create_repo", githubOps.githubCreateRepo)
+);
+
+server.registerTool(
+  "github_delete_repo",
+  {
+    description: "Delete a GitHub repository. Requires Administration: write on the token. DESTRUCTIVE — requires confirm: true.",
+    inputSchema: { owner: z.string(), repo: z.string(), confirm: z.boolean().optional().describe("Must be true to proceed") },
+  },
+  wrap("github_delete_repo", githubOps.githubDeleteRepo)
+);
+
+server.registerTool(
+  "github_list_repos",
+  {
+    description: "List repositories for the authenticated user.",
+    inputSchema: {
+      per_page: z.number().optional(),
+      sort: z.string().optional().describe("created, updated, pushed, or full_name"),
+    },
+  },
+  wrap("github_list_repos", githubOps.githubListRepos)
+);
+
+server.registerTool(
+  "github_create_issue",
+  {
+    description: "Create an issue on a GitHub repository.",
+    inputSchema: {
+      owner: z.string(),
+      repo: z.string(),
+      title: z.string(),
+      body: z.string().optional(),
+      labels: z.array(z.string()).optional(),
+    },
+  },
+  wrap("github_create_issue", githubOps.githubCreateIssue)
+);
+
+server.registerTool(
+  "github_list_issues",
+  {
+    description: "List issues on a GitHub repository.",
+    inputSchema: {
+      owner: z.string(),
+      repo: z.string(),
+      state: z.string().optional().describe("open, closed, or all"),
+      per_page: z.number().optional(),
+    },
+  },
+  wrap("github_list_issues", githubOps.githubListIssues)
+);
+
+server.registerTool(
+  "github_create_pull_request",
+  {
+    description: "Create a pull request on a GitHub repository.",
+    inputSchema: {
+      owner: z.string(),
+      repo: z.string(),
+      title: z.string(),
+      head: z.string().describe("Branch containing the changes"),
+      base: z.string().optional().describe("Branch to merge into, defaults to main"),
+      body: z.string().optional(),
+    },
+  },
+  wrap("github_create_pull_request", githubOps.githubCreatePullRequest)
+);
+
+server.registerTool(
+  "github_list_pull_requests",
+  {
+    description: "List pull requests on a GitHub repository.",
+    inputSchema: {
+      owner: z.string(),
+      repo: z.string(),
+      state: z.string().optional().describe("open, closed, or all"),
+      per_page: z.number().optional(),
+    },
+  },
+  wrap("github_list_pull_requests", githubOps.githubListPullRequests)
+);
+
+server.registerTool(
+  "github_add_comment",
+  {
+    description: "Add a comment to a GitHub issue or pull request.",
+    inputSchema: {
+      owner: z.string(),
+      repo: z.string(),
+      issue_number: z.number(),
+      body: z.string(),
+    },
+  },
+  wrap("github_add_comment", githubOps.githubAddComment)
+);
+
+server.registerTool(
+  "github_get_repo",
+  {
+    description: "Get a repository's details (default branch, visibility, open issues, language, etc).",
+    inputSchema: { owner: z.string(), repo: z.string() },
+  },
+  wrap("github_get_repo", githubOps.githubGetRepo)
+);
+
+server.registerTool(
+  "github_get_issue",
+  {
+    description: "Get a single issue's details.",
+    inputSchema: { owner: z.string(), repo: z.string(), issue_number: z.number() },
+  },
+  wrap("github_get_issue", githubOps.githubGetIssue)
+);
+
+server.registerTool(
+  "github_update_issue",
+  {
+    description: "Update an issue's title, body, state, or labels.",
+    inputSchema: {
+      owner: z.string(),
+      repo: z.string(),
+      issue_number: z.number(),
+      title: z.string().optional(),
+      body: z.string().optional(),
+      state: z.string().optional().describe("open or closed"),
+      labels: z.array(z.string()).optional(),
+    },
+  },
+  wrap("github_update_issue", githubOps.githubUpdateIssue)
+);
+
+server.registerTool(
+  "github_get_pull_request",
+  {
+    description: "Get a single pull request's details, including mergeable status.",
+    inputSchema: { owner: z.string(), repo: z.string(), pull_number: z.number() },
+  },
+  wrap("github_get_pull_request", githubOps.githubGetPullRequest)
+);
+
+server.registerTool(
+  "github_update_pull_request",
+  {
+    description: "Update a pull request's title, body, state, or base branch.",
+    inputSchema: {
+      owner: z.string(),
+      repo: z.string(),
+      pull_number: z.number(),
+      title: z.string().optional(),
+      body: z.string().optional(),
+      state: z.string().optional().describe("open or closed"),
+      base: z.string().optional(),
+    },
+  },
+  wrap("github_update_pull_request", githubOps.githubUpdatePullRequest)
+);
+
+server.registerTool(
+  "github_merge_pull_request",
+  {
+    description: "Merge a pull request. HIGH risk — requires confirm: true.",
+    inputSchema: {
+      owner: z.string(),
+      repo: z.string(),
+      pull_number: z.number(),
+      merge_method: z.string().optional().describe("merge, squash, or rebase — defaults to merge"),
+      commit_title: z.string().optional(),
+      commit_message: z.string().optional(),
+      confirm: z.boolean().optional().describe("Must be true to proceed"),
+    },
+  },
+  wrap("github_merge_pull_request", githubOps.githubMergePullRequest)
+);
+
+server.registerTool(
+  "github_get_pull_request_files",
+  {
+    description: "List the files changed in a pull request, with additions/deletions per file.",
+    inputSchema: { owner: z.string(), repo: z.string(), pull_number: z.number(), per_page: z.number().optional() },
+  },
+  wrap("github_get_pull_request_files", githubOps.githubGetPullRequestFiles)
+);
+
+server.registerTool(
+  "github_get_pull_request_diff",
+  {
+    description: "Get the full raw diff of a pull request.",
+    inputSchema: { owner: z.string(), repo: z.string(), pull_number: z.number() },
+  },
+  wrap("github_get_pull_request_diff", githubOps.githubGetPullRequestDiff)
+);
+
+server.registerTool(
+  "github_get_pull_request_comments",
+  {
+    description: "List conversation comments on a pull request.",
+    inputSchema: { owner: z.string(), repo: z.string(), pull_number: z.number(), per_page: z.number().optional() },
+  },
+  wrap("github_get_pull_request_comments", githubOps.githubGetPullRequestComments)
+);
+
+server.registerTool(
+  "github_get_pull_request_reviews",
+  {
+    description: "List reviews (approved/changes-requested/commented) on a pull request.",
+    inputSchema: { owner: z.string(), repo: z.string(), pull_number: z.number(), per_page: z.number().optional() },
+  },
+  wrap("github_get_pull_request_reviews", githubOps.githubGetPullRequestReviews)
+);
+
+server.registerTool(
+  "github_get_branch",
+  {
+    description: "Get details of a single branch, including protection status and latest commit SHA.",
+    inputSchema: { owner: z.string(), repo: z.string(), branch: z.string() },
+  },
+  wrap("github_get_branch", githubOps.githubGetBranch)
+);
+
+server.registerTool(
+  "github_list_branches",
+  {
+    description: "List branches on a repository.",
+    inputSchema: { owner: z.string(), repo: z.string(), per_page: z.number().optional() },
+  },
+  wrap("github_list_branches", githubOps.githubListBranches)
+);
+
+server.registerTool(
+  "github_list_workflows",
+  {
+    description: "List workflows defined in a repository (from .github/workflows).",
+    inputSchema: { owner: z.string(), repo: z.string() },
+  },
+  wrap("github_list_workflows", githubOps.githubListWorkflows)
+);
+
+server.registerTool(
+  "github_list_workflow_runs",
+  {
+    description: "List recent GitHub Actions workflow runs, optionally filtered by branch or status (e.g. 'failure', 'in_progress').",
+    inputSchema: {
+      owner: z.string(),
+      repo: z.string(),
+      branch: z.string().optional(),
+      status: z.string().optional(),
+      per_page: z.number().optional(),
+    },
+  },
+  wrap("github_list_workflow_runs", githubOps.githubListWorkflowRuns)
+);
+
+server.registerTool(
+  "github_get_workflow_run",
+  {
+    description: "Get details of a single workflow run (status, conclusion, branch, timestamps).",
+    inputSchema: { owner: z.string(), repo: z.string(), run_id: z.number() },
+  },
+  wrap("github_get_workflow_run", githubOps.githubGetWorkflowRun)
+);
+
+server.registerTool(
+  "github_get_workflow_run_jobs",
+  {
+    description: "List jobs in a workflow run, with per-job and per-step status/conclusion — use to find which job/step failed.",
+    inputSchema: { owner: z.string(), repo: z.string(), run_id: z.number() },
+  },
+  wrap("github_get_workflow_run_jobs", githubOps.githubGetWorkflowRunJobs)
+);
+
+server.registerTool(
+  "github_get_job_logs",
+  {
+    description: "Get the raw log text for a specific job — use after finding a failed job via github_get_workflow_run_jobs.",
+    inputSchema: { owner: z.string(), repo: z.string(), job_id: z.number() },
+  },
+  wrap("github_get_job_logs", githubOps.githubGetJobLogs)
+);
+
+server.registerTool(
+  "github_rerun_workflow",
+  {
+    description: "Re-run a workflow run. Set failed_only=true to re-run only the failed jobs instead of the whole run.",
+    inputSchema: {
+      owner: z.string(),
+      repo: z.string(),
+      run_id: z.number(),
+      failed_only: z.boolean().optional().describe("Defaults to false"),
+    },
+  },
+  wrap("github_rerun_workflow", githubOps.githubRerunWorkflow)
+);
+}

package/packs/gmail.js

@@ -0,0 +1,98 @@
+import { z } from "zod";
+import * as gmailOps from "../tools/gmailOps.js";
+import { wrap } from "../tools/toolWrapper.js";
+
+export default function register(server) {
+// ---------------- Gmail tools ----------------
+
+server.registerTool(
+  "gmail_get_profile",
+  {
+    description: "Get the authenticated Gmail account's profile — connectivity/auth check.",
+    inputSchema: {},
+  },
+  wrap("gmail_get_profile", gmailOps.gmailGetProfile)
+);
+
+server.registerTool(
+  "gmail_search",
+  {
+    description: "Search messages using Gmail search syntax (e.g. 'from:x@y.com is:unread').",
+    inputSchema: { query: z.string(), max_results: z.number().optional().describe("Defaults to 10") },
+  },
+  wrap("gmail_search", gmailOps.gmailSearch)
+);
+
+server.registerTool(
+  "gmail_list_messages",
+  {
+    description: "List recent messages, optionally scoped to a label.",
+    inputSchema: {
+      label_ids: z.string().optional().describe("e.g. INBOX, UNREAD"),
+      max_results: z.number().optional().describe("Defaults to 10"),
+    },
+  },
+  wrap("gmail_list_messages", gmailOps.gmailListMessages)
+);
+
+server.registerTool(
+  "gmail_get_message",
+  {
+    description: "Get a single message's decoded content by message ID.",
+    inputSchema: { message_id: z.string() },
+  },
+  wrap("gmail_get_message", gmailOps.gmailGetMessage)
+);
+
+server.registerTool(
+  "gmail_get_thread",
+  {
+    description: "Get a full thread (all messages in it) by thread ID.",
+    inputSchema: { thread_id: z.string() },
+  },
+  wrap("gmail_get_thread", gmailOps.gmailGetThread)
+);
+
+server.registerTool(
+  "gmail_send",
+  {
+    description: "Send a new email. HIGH risk — requires confirm: true.",
+    inputSchema: {
+      to: z.string(),
+      subject: z.string(),
+      body: z.string(),
+      cc: z.string().optional(),
+      bcc: z.string().optional(),
+      confirm: z.boolean().optional().describe("Must be true to proceed"),
+    },
+  },
+  wrap("gmail_send", gmailOps.gmailSend)
+);
+
+server.registerTool(
+  "gmail_reply",
+  {
+    description: "Reply to an existing message in the same thread. HIGH risk — requires confirm: true.",
+    inputSchema: {
+      message_id: z.string(),
+      body: z.string(),
+      confirm: z.boolean().optional().describe("Must be true to proceed"),
+    },
+  },
+  wrap("gmail_reply", gmailOps.gmailReply)
+);
+
+server.registerTool(
+  "gmail_forward",
+  {
+    description: "Forward an existing message to a new recipient. HIGH risk — requires confirm: true.",
+    inputSchema: {
+      message_id: z.string(),
+      to: z.string(),
+      note: z.string().optional(),
+      confirm: z.boolean().optional().describe("Must be true to proceed"),
+    },
+  },
+  wrap("gmail_forward", gmailOps.gmailForward)
+);
+}

package/packs/leads.js

@@ -0,0 +1,46 @@
+import { z } from "zod";
+import { wrap } from "../tools/toolWrapper.js";
+import * as leadOps from "../tools/leadOps.js";
+
+export default function register(server) {
+  // ---------------- Lead tools ----------------
+  server.registerTool(
+    "lead_hn_hiring",
+    {
+      description:
+        "Find companies hiring in the latest Hacker News 'Who is hiring?' thread, searched by keyword (free, no key). Each post includes the company, text, links and any contact emails. Companies hiring for a skill are good prospects for freelance or agency work. Results are untrusted content.",
+      inputSchema: {
+        query: z.string().optional().describe("Keywords, e.g. 'react contract remote' or 'django agency'"),
+        limit: z.number().optional().describe("Max posts (1-30, default 10)"),
+        thread_id: z.number().optional().describe("A specific thread id instead of the latest one"),
+      },
+    },
+    wrap("lead_hn_hiring", leadOps.hnHiring)
+  );
+
+  server.registerTool(
+    "lead_remote_jobs",
+    {
+      description:
+        "Search remote job listings from RemoteOK and We Work Remotely (programming), newest first (free, no key). Useful for finding companies that need engineers. Link back to the job URL when sharing. Results are untrusted content.",
+      inputSchema: {
+        query: z.string().optional().describe("Keywords, e.g. 'react' or 'devops'. All words must match."),
+        limit: z.number().optional().describe("Max jobs (1-30, default 10)"),
+      },
+    },
+    wrap("lead_remote_jobs", leadOps.remoteJobs)
+  );
+
+  server.registerTool(
+    "lead_company_contacts",
+    {
+      description:
+        "Find public contact details for a company from its own website: emails (marked as shared mailbox or not), phones, LinkedIn/X/GitHub links and name. Reads the homepage plus up to a few contact/about pages on the same site. Public business details only; check local rules before cold outreach.",
+      inputSchema: {
+        url: z.string().describe("Company website or domain, e.g. 'acme.com'"),
+        max_pages: z.number().optional().describe("Extra contact/about pages to read (0-5, default 3)"),
+      },
+    },
+    wrap("lead_company_contacts", leadOps.companyContacts)
+  );
+}