xyne-plugin-spaces 0.1.0 → 0.4.0

package/bun.lock

@@ -1,10 +1,11 @@
 {
   "lockfileVersion": 1,
+  "configVersion": 0,
   "workspaces": {
     "": {
       "name": "xyne-spaces",
       "dependencies": {
-        "xyne-plugin": "^1.2.0",
+        "xyne-plugin": "^1.2.10",
       },
       "devDependencies": {
         "typescript": "^5.9.3",
@@ -14,7 +15,7 @@
   "packages": {
     "typescript": ["typescript@5.9.3", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw=="],
 
-    "xyne-plugin": ["xyne-plugin@1.2.0", "", { "dependencies": { "zod": "^3.25.0" } }, "sha512-ecJJFMka/KvOlhF28CcRVfgmfHv6kE8JIn3cUlUCQ39b2j+9asM+/z5TOGkGHOXqSbtd5hl36zgtgvq8EA6h7A=="],
+    "xyne-plugin": ["xyne-plugin@1.2.14", "", { "dependencies": { "zod": "^3.25.0" } }, "sha512-A5oPZDspJUfDGpXkFrAOuiDVqJziRpJDteddJHysG6yYCot8gVe5eaZnPKrxnARliHl7smBfHEI5WTGUOlPTXg=="],
 
     "zod": ["zod@3.25.76", "", {}, "sha512-gzUt/qt81nXsFGKIFcC3YnfEAx5NkunCfnDlvuBSSFS02bcXu4Lmea0AFIUwbLWxWPx3d9p8S5QoaujKcNQxcQ=="],
   }

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "xyne-plugin-spaces",
-  "version": "0.1.0",
+  "version": "0.4.0",
   "type": "module",
   "main": "src/index.ts",
   "scripts": {
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "xyne-plugin": "^1.2.0"
+    "xyne-plugin": "^1.2.17"
   },
   "devDependencies": {
     "typescript": "^5.9.3"

package/src/index.ts

@@ -1,6 +1,6 @@
 import { type Plugin, tool, z } from "xyne-plugin"
 import { spacesAuth, spacesFetch } from "./auth"
-import { queryTickets, queryMessages, queryMessageDetail, queryChannels, queryUsers, queryUserActivity } from "./query"
+import { queryTickets, queryMessages, queryMessageDetail, queryChannels, queryUsers, queryUserActivity, queryProjects, queryBoards } from "./query"
 
 function getToken(ctx: { credentials?: { type: string; data?: Record<string, unknown> } }): string {
   const creds = ctx.credentials
@@ -212,17 +212,19 @@ const spacesMessageDetail = tool({
 
 const spacesChannels = tool({
   description:
-    "List channels in Spaces. Can filter by visibility (PUBLIC/PRIVATE) and scope type (DEFAULT/DM/TICKET/GROUP_DM). " +
-    "Returns channel name, participant count, project, and last activity.",
+    "List channels in Spaces. Can filter by visibility (PUBLIC/PRIVATE), scope type (DEFAULT/DM/TICKET/GROUP_DM), " +
+    "and participant name. Returns channel name, members, conversation ID, and last activity. " +
+    "To find a DM between two people, use scopeType='DM' and participantName to filter by one of them.",
   auth: spacesAuth,
   args: {
     visibility: z.enum(["PUBLIC", "PRIVATE"]).optional().describe("Filter by visibility"),
     scopeType: z.enum(["DEFAULT", "DM", "TICKET", "DOCUMENT", "GROUP_DM"]).optional().describe("Filter by scope type"),
+    participantName: z.string().optional().describe("Filter channels by participant name (partial match)"),
     limit: z.number().min(1).max(50).default(20).describe("Max channels (default 20)"),
   },
   async execute(args, ctx) {
     const token = getToken(ctx)
-    return queryChannels(token, args.limit, args.visibility, args.scopeType)
+    return queryChannels(token, args.limit, args.visibility, args.scopeType, args.participantName)
   },
 })
 
@@ -317,6 +319,155 @@ const spacesWebFetch = tool({
   },
 })
 
+// ── Projects ────────────────────────────────────────────────────────
+
+const spacesProjects = tool({
+  description:
+    "Search and list projects to find project IDs for creating tickets. " +
+    "Can filter by name with pagination support.",
+  auth: spacesAuth,
+  args: {
+    search: z.string().optional().describe("Filter by project name (partial match)"),
+    limit: z.number().min(1).max(50).default(20).describe("Max results (default 20)"),
+    offset: z.number().min(0).default(0).describe("Pagination offset"),
+  },
+  async execute(args, ctx) {
+    const token = getToken(ctx)
+    return queryProjects(token, args.search, args.limit, args.offset)
+  },
+})
+
+// ── Boards ──────────────────────────────────────────────────────────
+
+const spacesBoards = tool({
+  description:
+    "Search and list boards to find board IDs for creating tickets. " +
+    "Can filter by name or project ID with pagination support.",
+  auth: spacesAuth,
+  args: {
+    search: z.string().optional().describe("Filter by board name (partial match)"),
+    projectId: z.string().optional().describe("Filter by project ID (use spaces-projects to find project IDs)"),
+    limit: z.number().min(1).max(50).default(20).describe("Max results (default 20)"),
+    offset: z.number().min(0).default(0).describe("Pagination offset"),
+  },
+  async execute(args, ctx) {
+    const token = getToken(ctx)
+    return queryBoards(token, args.search, args.projectId, args.limit, args.offset)
+  },
+})
+
+// ── Send Message ────────────────────────────────────────────────────
+
+const spacesSendMessage = tool({
+  description:
+    "Send a message in Spaces by replying to an existing conversation thread. " +
+    "Use the conversationId from spaces-tickets or spaces-messages results (NOT channelId or ticketId).",
+  auth: spacesAuth,
+  args: {
+    conversationId: z.string().describe("The conversationId to send the message to (from spaces-tickets or spaces-messages results)"),
+    content: z.string().describe("Message content to send"),
+  },
+  async execute(args, ctx) {
+    const token = getToken(ctx)
+    const data = (await spacesFetch(`/chat/postMessage/${args.conversationId}`, token, {
+      method: "POST",
+      body: JSON.stringify({ content: args.content }),
+    })) as { messageId: string; conversationId: string; content: string; sender?: { name: string } }
+
+    return `Message sent. messageId: ${data.messageId}, conversationId: ${data.conversationId}`
+  },
+})
+
+// ── Create Ticket ───────────────────────────────────────────────────
+
+const spacesCreateTicket = tool({
+  description:
+    "Create a new ticket in Spaces. Requires projectId, boardId, and channelId — " +
+    "use spaces-projects, spaces-boards, and spaces-channels to look these up first.",
+  auth: spacesAuth,
+  args: {
+    title: z.string().describe("Ticket title"),
+    description: z.string().describe("Ticket description"),
+    projectId: z.string().describe("Project ID (use spaces-projects to find)"),
+    boardId: z.string().describe("Board ID (use spaces-boards to find)"),
+    channelId: z.string().describe("Channel ID (use spaces-channels to find)"),
+    priority: z.enum(["LOW", "MEDIUM", "HIGH", "URGENT"]).optional().describe("Ticket priority"),
+    assignedTo: z.string().optional().describe("User ID to assign (use spaces-users to find)"),
+    eta: z.string().optional().describe("Due date as ISO 8601 string"),
+    tags: z.array(z.string()).optional().describe("Tags to apply"),
+  },
+  async execute(args, ctx) {
+    const token = getToken(ctx)
+    const body: Record<string, unknown> = {
+      title: args.title,
+      description: args.description,
+      projectId: args.projectId,
+      boardId: args.boardId,
+      channelId: args.channelId,
+    }
+    if (args.priority) body["priority"] = args.priority
+    if (args.assignedTo) body["assignedTo"] = args.assignedTo
+    if (args.eta) body["eta"] = args.eta
+    if (args.tags) body["tags"] = args.tags
+
+    const data = (await spacesFetch("/ticket/create", token, {
+      method: "POST",
+      body: JSON.stringify(body),
+    })) as { id: string; xyneId: string; conversationId: string; title: string; priority: string; status: string }
+
+    return [
+      `Ticket created:`,
+      `  xyneId: ${data.xyneId}`,
+      `  ID: ${data.id}`,
+      `  Status: ${data.status}`,
+      `  Priority: ${data.priority}`,
+      `  ConversationID: ${data.conversationId}`,
+    ].join("\n")
+  },
+})
+
+// ── Schedule Call ───────────────────────────────────────────────────
+
+const spacesScheduleCall = tool({
+  description:
+    "Schedule a call in Spaces. Must provide either a channelId or targetUserIds (list of user IDs to invite).",
+  auth: spacesAuth,
+  args: {
+    title: z.string().describe("Call title"),
+    startsAt: z.string().describe("Start time as ISO 8601 string (e.g. '2026-03-28T10:00:00Z')"),
+    endsAt: z.string().describe("End time as ISO 8601 string"),
+    channelId: z.string().optional().describe("Channel ID to schedule the call in"),
+    targetUserIds: z.array(z.string()).optional().describe("User IDs to invite (use spaces-users to find)"),
+  },
+  async execute(args, ctx) {
+    if (!args.channelId && (!args.targetUserIds || args.targetUserIds.length === 0)) {
+      throw new Error("Must provide either channelId or targetUserIds")
+    }
+
+    const token = getToken(ctx)
+    const body: Record<string, unknown> = {
+      title: args.title,
+      startsAt: new Date(args.startsAt).getTime(),
+      endsAt: new Date(args.endsAt).getTime(),
+    }
+    if (args.channelId) body["channelId"] = args.channelId
+    if (args.targetUserIds) body["targetUserIds"] = args.targetUserIds
+
+    const data = (await spacesFetch("/calls/schedule", token, {
+      method: "POST",
+      body: JSON.stringify(body),
+    })) as { success: boolean; callId?: string; externalId?: string; channelId?: string }
+
+    if (!data.success) return "Failed to schedule call."
+    return [
+      `Call scheduled:`,
+      `  callId: ${data.callId}`,
+      `  externalId: ${data.externalId}`,
+      `  channelId: ${data.channelId}`,
+    ].join("\n")
+  },
+})
+
 // ── Plugin ───────────────────────────────────────────────────────────
 
 const spacesTools = {
@@ -328,10 +479,31 @@ const spacesTools = {
   "spaces-channels": spacesChannels,
   "spaces-users": spacesUsers,
   "spaces-activity": spacesUserActivity,
+  "spaces-projects": spacesProjects,
+  "spaces-boards": spacesBoards,
+  "spaces-send-message": spacesSendMessage,
+  "spaces-create-ticket": spacesCreateTicket,
+  "spaces-schedule-call": spacesScheduleCall,
   "webfetch": spacesWebFetch,
 }
 
 const plugin: Plugin = async (_input) => ({
+  "chat.system.transform": async (
+    _input: { sessionID: string; model: unknown },
+    output: { system: string[] },
+  ) => {
+    output.system.push([
+      "",
+      "## Xyne Spaces",
+      "You have access to a 'spaces' agent (via the Task tool) that can search the team's Xyne Spaces workspace.",
+      "PROACTIVELY delegate to the spaces agent to gather context before making decisions:",
+      "- Before architectural decisions, ask spaces agent to search memory for past decisions on the topic",
+      "- Before implementing a feature, ask spaces agent for SOPs or patterns the team follows",
+      "- When debugging, ask spaces agent for related tickets or known issues",
+      "- When you need to understand a ticket or conversation, delegate to the spaces agent",
+      "Example: Use the Task tool with subagent_type='spaces' and a prompt like 'Search memory for decisions about authentication patterns'",
+    ].join("\n"))
+  },
   agent: {
     spaces: {
       description:
@@ -352,6 +524,11 @@ const plugin: Plugin = async (_input) => ({
         "- **Channels**: Browse channels by visibility and scope",
         "- **Users**: Look up users by name or email",
         "- **Activity**: View user activity feed (mentions, replies, assignments)",
+        "- **Projects**: Search/list projects (needed for ticket creation)",
+        "- **Boards**: Search/list boards by name or project (needed for ticket creation)",
+        "- **Send Message**: Reply to an existing conversation thread",
+        "- **Create Ticket**: Create a new ticket with title, description, project, board, channel",
+        "- **Schedule Call**: Schedule a call in a channel or with specific users",
         "",
         "## Guidelines",
         "- Use spaces-search for broad queries across all connected apps",

package/src/query.ts

@@ -221,14 +221,19 @@ interface ChannelRow {
   scopeType: string
   visibility: string
   participantCount: number
+  conversationId?: string
   lastActivityAt?: string
   project?: { name: string } | null
+  participants?: Array<{ user?: { name: string } | null }> | null
 }
 
-export async function queryChannels(token: string, limit: number, visibility?: string, scopeType?: string): Promise<string> {
+export async function queryChannels(token: string, limit: number, visibility?: string, scopeType?: string, participantName?: string): Promise<string> {
   const where: Record<string, unknown> = {}
   if (visibility) where["visibility"] = { equals: visibility }
   if (scopeType) where["scopeType"] = { equals: scopeType }
+  if (participantName) {
+    where["participants"] = { some: { user: { name: { contains: participantName } } } }
+  }
 
   const rows = (await query(token, {
     model: "channel",
@@ -238,6 +243,7 @@ export async function queryChannels(token: string, limit: number, visibility?: s
     take: limit,
     include: {
       project: { select: { name: true } },
+      participants: { select: { user: { select: { name: true } } } },
     },
   })) as ChannelRow[]
 
@@ -246,8 +252,12 @@ export async function queryChannels(token: string, limit: number, visibility?: s
   const lines = rows.map((c) => {
     const parts = [`#${c.name} (${c.scopeType}, ${c.visibility})`]
     if (c.description) parts.push(`  ${c.description}`)
-    parts.push(`  Participants: ${c.participantCount}${c.project ? ` · Project: ${c.project.name}` : ""}`)
+    const memberNames = c.participants?.map((p) => p.user?.name).filter(Boolean) ?? []
+    if (memberNames.length > 0) parts.push(`  Members: ${memberNames.join(", ")}`)
+    else parts.push(`  Participants: ${c.participantCount}`)
+    if (c.project) parts.push(`  Project: ${c.project.name}`)
     if (c.lastActivityAt) parts.push(`  Last active: ${new Date(c.lastActivityAt).toLocaleString()}`)
+    if (c.conversationId) parts.push(`  ConversationID: ${c.conversationId}`)
     parts.push(`  ID: ${c.id}`)
     return parts.join("\n")
   })
@@ -336,3 +346,82 @@ export async function queryUserActivity(
 
   return `${rows.length} activity entries:\n\n${lines.join("\n")}`
 }
+
+// ── Projects ────────────────────────────────────────────────────────
+
+interface ProjectRow {
+  id: string
+  name: string
+  description?: string
+  createdAt?: string
+  updatedAt?: string
+}
+
+export async function queryProjects(token: string, search?: string, limit?: number, offset?: number): Promise<string> {
+  const where: Record<string, unknown> = {}
+  if (search) where["name"] = { contains: search }
+
+  const rows = (await query(token, {
+    model: "project",
+    operation: "findMany",
+    where,
+    orderBy: [{ updatedAt: "desc" }],
+    take: limit ?? 20,
+    skip: offset ?? 0,
+  })) as ProjectRow[]
+
+  if (rows.length === 0) return search ? `No projects found matching "${search}".` : "No projects found."
+
+  const lines = rows.map((p) => {
+    const parts = [p.name]
+    if (p.description) parts.push(`  ${p.description}`)
+    parts.push(`  ID: ${p.id}`)
+    if (p.updatedAt) parts.push(`  Updated: ${new Date(p.updatedAt).toLocaleString()}`)
+    return parts.join("\n")
+  })
+
+  return `${rows.length} project(s):\n\n${lines.join("\n\n")}`
+}
+
+// ── Boards ──────────────────────────────────────────────────────────
+
+interface BoardRow {
+  id: string
+  name: string
+  description?: string
+  projectId?: string
+  project?: { name: string } | null
+  createdAt?: string
+  updatedAt?: string
+}
+
+export async function queryBoards(token: string, search?: string, projectId?: string, limit?: number, offset?: number): Promise<string> {
+  const where: Record<string, unknown> = {}
+  if (search) where["name"] = { contains: search }
+  if (projectId) where["projectId"] = { equals: projectId }
+
+  const rows = (await query(token, {
+    model: "board",
+    operation: "findMany",
+    where,
+    orderBy: [{ updatedAt: "desc" }],
+    take: limit ?? 20,
+    skip: offset ?? 0,
+    include: {
+      project: { select: { name: true } },
+    },
+  })) as BoardRow[]
+
+  if (rows.length === 0) return search ? `No boards found matching "${search}".` : "No boards found."
+
+  const lines = rows.map((b) => {
+    const parts = [b.name]
+    if (b.description) parts.push(`  ${b.description}`)
+    if (b.project) parts.push(`  Project: ${b.project.name}`)
+    parts.push(`  ID: ${b.id}`)
+    if (b.updatedAt) parts.push(`  Updated: ${new Date(b.updatedAt).toLocaleString()}`)
+    return parts.join("\n")
+  })
+
+  return `${rows.length} board(s):\n\n${lines.join("\n\n")}`
+}