@rudderhq/server 0.2.0-canary.21 → 0.2.0-canary.23

package/dist/routes/onboarding.js

@@ -0,0 +1,428 @@
+import { Router } from "express";
+import { issueService, logActivity, projectService } from "../services/index.js";
+import { assertBoard, assertCompanyAccess, getActorInfo } from "./authz.js";
+const ONBOARDING_PROJECT_NAME = "Getting Started";
+const ONBOARDING_PROJECT_DESCRIPTION = `Learn how Rudder works by completing one guided collaboration loop.
+
+This project is not a generic product tour. It teaches the core Rudder workflow:
+
+chat → issue → agent execution → activity → review → context → real work.
+
+Complete the first four issues to experience the basic loop. Then use the next issues to bring real work and reusable context into Rudder.`;
+const WELCOME_DESCRIPTION = `Welcome to Rudder.
+
+Rudder is where you collaborate with agents the way you would work with a human team.
+
+You are not just prompting a bot here. You are setting up a working relationship.
+
+In Rudder:
+
+- Chat is for quick questions, clarification, and routing.
+- Issues are where durable work happens.
+- Projects group related work.
+- Agents have roles, responsibilities, and execution boundaries.
+- Agents can build durable memory through shared context and instructions.
+- Activity makes agent work visible.
+- Reviews and comments keep feedback attached to the work.
+- Reusable workflows help agents improve how they work with you over time.
+- Goals explain why the work exists, but you do not need to define every goal on day one.
+
+Start with the Getting Started project in the sidebar.
+
+It will guide you through your first collaboration loop:
+
+1. Understand how Rudder work happens.
+2. Ask your agent one quick question.
+3. Create and run your first agent issue.
+4. Review the result and close the loop.
+5. Add shared context.
+6. Bring one real task into Rudder.
+
+No action is required on this welcome issue. Keep it as a quick reference while you learn how Rudder works.`;
+const ONBOARDING_ISSUES = [
+    {
+        title: "👋 Welcome to Rudder — work with agents like a team",
+        status: "done",
+        priority: "high",
+        group: "welcome",
+        description: WELCOME_DESCRIPTION,
+    },
+    {
+        title: "1. Understand how Rudder work happens",
+        status: "todo",
+        priority: "high",
+        group: "core",
+        description: `Rudder works best when each kind of work happens in the right place.
+
+The main surfaces are Chat, Issues, Projects, and Activity.
+
+Chat is for quick questions, clarification, and routing. Use it when you are still figuring out what you want, or when the request is too small to become durable work.
+
+Issues are for work that should be tracked. Use an issue when something needs an owner, status, context, execution, review, or a durable result.
+
+Projects group related issues. Use a project when several pieces of work belong together and you want to see their progress in one place.
+
+Activity shows what happened. Use it to understand progress, failures, status changes, comments, and agent actions.
+
+Try it now:
+
+1. Open Chat from the sidebar.
+2. Open Issues from the sidebar.
+3. Open this Getting Started project.
+4. Open the Activity section on this issue or another issue.
+5. Mark this issue as Done when you understand where each kind of work belongs.
+
+You’ll know it worked when:
+
+- You know when to use chat.
+- You know why durable work should live on an issue.
+- You know where project-level work is grouped.
+- You know where to look when you want to understand what changed.
+
+Next step: open “Ask your agent one quick question.”`,
+    },
+    {
+        title: "2. Ask your agent one quick question",
+        status: "todo",
+        priority: "high",
+        group: "core",
+        description: `Start by talking to your agent before giving it durable work.
+
+In human teams, you often ask a teammate a quick question before assigning them a full task. Rudder works the same way. Chat is the lightweight place to ask, clarify, and get oriented.
+
+Try it now:
+
+1. Open Chat from the sidebar.
+2. Ask your first agent one simple question.
+
+Good examples:
+
+- “What can you help me with in this workspace?”
+- “How should I give you a task in Rudder?”
+- “What is a good first issue for us to try?”
+- “What information do you need from me before you can work well?”
+
+3. Read the agent’s reply.
+4. Come back and mark this issue as Done.
+
+If you do not have an active agent yet, create or activate your first agent before continuing.
+
+You’ll know it worked when:
+
+- Your agent replies in chat.
+- You understand something about the agent’s role or how to work with it.
+- You have experienced the difference between a quick chat and tracked work.
+
+Next step: open “Create and run your first agent issue.”`,
+    },
+    {
+        title: "3. Create and run your first agent issue",
+        status: "todo",
+        priority: "high",
+        group: "core",
+        description: `Chat is useful for figuring things out. Issues are where work becomes durable.
+
+A request should usually become an issue when it needs:
+
+- an owner
+- a status
+- context that should not be lost
+- agent execution
+- review
+- a clear result
+- a follow-up path
+
+Now create your first small agent issue.
+
+Use your own request, or use this safe example:
+
+“Summarize how Rudder works in 5 bullets and suggest one useful next step for a new user.”
+
+Try it now:
+
+1. Create a new issue.
+2. Give it a clear title.
+3. Add a short description.
+4. Include the expected result.
+5. Assign it to your first agent.
+6. Move it to Todo or another runnable state.
+7. Open the issue Activity section and watch what happens.
+
+Use a low-risk task for this first run. Avoid tasks that need secrets, production access, irreversible actions, or external spending.
+
+If you do not have an active agent yet, create or activate your first agent before continuing.
+
+You’ll know it worked when:
+
+- A new issue exists.
+- It is assigned to your agent.
+- The agent starts working or leaves activity.
+- You can see the work happening on the issue.
+
+Next step: open “Review the result and close the loop.”`,
+    },
+    {
+        title: "4. Review the result and close the loop",
+        status: "todo",
+        priority: "high",
+        group: "core",
+        description: `Agent collaboration improves when feedback stays attached to the work.
+
+In a human team, you rarely just receive work and walk away. You review it, ask for revisions, approve it, or create a follow-up. Rudder keeps that feedback loop on the issue so the context does not disappear.
+
+Try it now:
+
+1. Open the issue your agent worked on.
+2. Read the result.
+3. Check the Activity section to understand what happened.
+4. Decide what to do next.
+
+If the result is useful:
+
+- Leave a short comment explaining what was useful.
+- Move the issue to Done.
+
+If the result needs revision:
+
+- Leave a comment with specific feedback.
+- Ask the agent to revise.
+- Keep the issue open until the next result is reviewed.
+
+If the work needs another step:
+
+- Create a follow-up issue.
+- Link it from the current issue.
+
+You’ll know it worked when:
+
+- The agent’s result has been reviewed.
+- Your feedback is attached to the issue.
+- The next step is clear.
+- The issue is either Done or has a clear follow-up.
+
+Next step: continue with “Add shared context your agent should remember.”`,
+    },
+    {
+        title: "5. Add shared context your agent should remember",
+        status: "backlog",
+        priority: "medium",
+        group: "recommended",
+        description: `Good teammates remember the context they need to work well.
+
+Agents should not need you to repeat the same background every time. Rudder should accumulate shared context across work, so future issues become easier to start and easier to review.
+
+Use this issue to write down the basic information your agent should know about this workspace.
+
+Try it now:
+
+1. Think about what your agent needed during the first issue.
+2. Identify one piece of context you do not want to repeat again.
+3. Add it to shared workspace context, knowledge, or an appropriate document.
+4. Mention or link that context from one future issue.
+
+Useful context may include:
+
+- what this workspace is for
+- what product, company, or project you are working on
+- what your agent should optimize for
+- your preferred output style
+- links, repos, files, or docs that matter
+- constraints the agent should respect
+- what “done” usually means
+- things the agent should not do without approval
+
+Keep it short and real. Do not try to document the whole workspace on day one.
+
+You’ll know it worked when:
+
+- There is at least one reusable context note.
+- The context came from something you actually needed.
+- You can point an agent to this context instead of re-explaining it.
+
+Next step: open “Bring one real task into Rudder.”`,
+    },
+    {
+        title: "6. Bring one real task into Rudder",
+        status: "backlog",
+        priority: "high",
+        group: "recommended",
+        description: `Now bring one real task into Rudder.
+
+Choose something real, but keep it small. The goal is not to migrate your entire workflow at once. The goal is to let Rudder take responsibility for one piece of work and leave a result you can review.
+
+Pick a task that is useful, safe for an agent to attempt, easy for you to review, and small enough to finish or make progress on today.
+
+Try it now:
+
+1. Choose one real task from your current work.
+2. Create a new issue for it.
+3. Include what you want done, why it matters, relevant context, what a good result looks like, and what the agent should avoid.
+4. Attach or mention any relevant files, links, or context.
+5. Assign the issue to your agent when it is ready.
+6. Move it to Todo to start the work.
+
+Good first real tasks:
+
+- “Summarize this project and identify the next 3 issues.”
+- “Review this document and suggest improvements.”
+- “Turn these notes into an implementation plan.”
+- “Inspect this bug report and propose likely causes.”
+- “Draft a checklist for repeating this workflow.”
+
+You’ll know it worked when:
+
+- One real task exists as a Rudder issue.
+- The issue has enough context for an agent to start.
+- The task is assigned or ready to assign.
+- You know what result you expect to review.
+
+Next step: continue with the Advanced Getting Started issues when you are ready.`,
+    },
+    {
+        title: "7. Link this work to a goal",
+        status: "backlog",
+        priority: "medium",
+        group: "advanced",
+        description: `Rudder work should eventually answer one question: why does this task exist?
+
+You do not need to define a perfect company goal on day one. It is normal for goals to become clearer after you have run a few issues. But once real work starts moving, it should connect back to a larger direction.
+
+Try it now:
+
+1. Open the real task you created.
+2. Ask: “What larger outcome does this support?”
+3. Create a simple goal, or choose an existing one.
+4. Link the issue or project to that goal.
+5. Leave a short note explaining why this work matters.
+
+You’ll know it worked when at least one real issue is linked to a goal and the goal explains why the work matters.`,
+    },
+    {
+        title: "8. Capture one reusable workflow",
+        status: "backlog",
+        priority: "medium",
+        group: "advanced",
+        description: `The best Rudder workflows compound over time.
+
+After an agent completes a useful task, do not let the process disappear into a single comment thread. Capture the repeatable parts so future work can start faster and with better instructions.
+
+Try it now:
+
+1. Pick one issue where the agent produced something useful.
+2. Look for the repeatable pattern: what input the agent needed, what steps it followed, what you reviewed, what should repeat, and what it should avoid.
+3. Write a short reusable workflow or checklist.
+4. Link it back to the original issue.
+5. Use it on one future issue.
+
+This is one way agents self-iterate in Rudder: their future work improves because your feedback and reusable workflow context become part of the operating system.`,
+    },
+    {
+        title: "9. Add a second agent with a different role",
+        status: "backlog",
+        priority: "low",
+        group: "advanced",
+        description: `Human teams work better when responsibilities are clear. Agent teams work the same way.
+
+After your first agent has completed useful work, consider adding a second agent with a different role. Do not create another agent just to have more agents. Create one when the work would benefit from a separate responsibility.
+
+Good second-agent roles include reviewer, researcher, planner, QA assistant, documentation assistant, release coordinator, or support triage agent.
+
+You’ll know it worked when the second agent has a distinct role and at least one issue clearly belongs to that agent.`,
+    },
+    {
+        title: "10. Set up a recurring loop or automation",
+        status: "backlog",
+        priority: "low",
+        group: "advanced",
+        description: `Some work should not wait for you to remember it.
+
+Once you have run a few issues manually, look for a recurring pattern. Rudder can help turn repeated work into a regular loop, heartbeat, or automation, while still keeping the result visible and reviewable.
+
+Good recurring loops include weekly project summaries, daily issue triage, release readiness checks, inbox or blocker review, documentation freshness checks, and cost or activity summaries.
+
+You’ll know it worked when one recurring loop exists, the cadence is clear, the expected output is clear, and the agent knows when to ask for review instead of acting silently.`,
+    },
+];
+export function onboardingRoutes(db) {
+    const router = Router();
+    const projects = projectService(db);
+    const issues = issueService(db);
+    router.post("/orgs/:orgId/onboarding/getting-started", async (req, res) => {
+        const orgId = req.params.orgId;
+        assertCompanyAccess(req, orgId);
+        assertBoard(req);
+        const actor = getActorInfo(req);
+        const operatorUserId = req.actor.userId ?? "local-board";
+        const existingProjects = await projects.list(orgId);
+        let project = existingProjects.find((entry) => !entry.archivedAt && entry.name === ONBOARDING_PROJECT_NAME);
+        let createdProject = false;
+        if (!project) {
+            project = await projects.create(orgId, {
+                name: ONBOARDING_PROJECT_NAME,
+                status: "planned",
+                description: ONBOARDING_PROJECT_DESCRIPTION,
+            });
+            createdProject = true;
+            await logActivity(db, {
+                orgId,
+                actorType: actor.actorType,
+                actorId: actor.actorId,
+                agentId: actor.agentId,
+                runId: actor.runId,
+                action: "project.created",
+                entityType: "project",
+                entityId: project.id,
+                details: { name: project.name },
+            });
+        }
+        const existingIssues = await issues.list(orgId, { projectId: project.id });
+        const issueByTitle = new Map(existingIssues.map((issue) => [issue.title, issue]));
+        const seededIssues = [];
+        let createdIssueCount = 0;
+        for (const [index, template] of ONBOARDING_ISSUES.entries()) {
+            let issue = issueByTitle.get(template.title);
+            if (!issue) {
+                issue = await issues.create(orgId, {
+                    projectId: project.id,
+                    title: template.title,
+                    description: template.description,
+                    status: template.status,
+                    priority: template.priority,
+                    assigneeUserId: operatorUserId,
+                    createdByAgentId: actor.agentId,
+                    createdByUserId: actor.actorType === "user" ? actor.actorId : null,
+                    boardOrder: (index + 1) * 1000,
+                });
+                createdIssueCount += 1;
+                issueByTitle.set(template.title, issue);
+                await logActivity(db, {
+                    orgId,
+                    actorType: actor.actorType,
+                    actorId: actor.actorId,
+                    agentId: actor.agentId,
+                    runId: actor.runId,
+                    action: "issue.created",
+                    entityType: "issue",
+                    entityId: issue.id,
+                    details: {
+                        title: issue.title,
+                        identifier: issue.identifier,
+                        onboardingGroup: template.group,
+                    },
+                });
+            }
+            if (template.group === "welcome") {
+                await issues.followIssue(orgId, issue.id, operatorUserId);
+            }
+            seededIssues.push(issue);
+        }
+        res.status(createdProject || createdIssueCount > 0 ? 201 : 200).json({
+            project,
+            issues: seededIssues,
+            createdProject,
+            createdIssueCount,
+        });
+    });
+    return router;
+}
+//# sourceMappingURL=onboarding.js.map

package/dist/routes/onboarding.js.map

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

package/dist/services/agents.d.ts

@@ -26,8 +26,8 @@ export declare function agentService(db: Db): {
         includeHidden?: boolean;
     }) => Promise<Omit<{
         permissions: import("./agent-permissions.js").NormalizedAgentPermissions;
-        id: string;
         title: string | null;
+        id: string;
         status: string;
         updatedAt: Date;
         orgId: string;
@@ -52,8 +52,8 @@ export declare function agentService(db: Db): {
     }, "workspaceKey">[]>;
     getById: (id: string) => Promise<Omit<{
         permissions: import("./agent-permissions.js").NormalizedAgentPermissions;
-        id: string;
         title: string | null;
+        id: string;
         status: string;
         updatedAt: Date;
         orgId: string;
@@ -78,8 +78,8 @@ export declare function agentService(db: Db): {
     }, "workspaceKey"> | null>;
     getInternalById: (id: string) => Promise<({
         permissions: import("./agent-permissions.js").NormalizedAgentPermissions;
-        id: string;
         title: string | null;
+        id: string;
         status: string;
         updatedAt: Date;
         orgId: string;
@@ -107,8 +107,8 @@ export declare function agentService(db: Db): {
         name?: string | null;
     }) => Promise<Omit<{
         permissions: import("./agent-permissions.js").NormalizedAgentPermissions;
-        id: string;
         title: string | null;
+        id: string;
         status: string;
         updatedAt: Date;
         orgId: string;
@@ -133,8 +133,8 @@ export declare function agentService(db: Db): {
     }, "workspaceKey">>;
     update: (id: string, data: Partial<typeof agents.$inferInsert>, options?: UpdateAgentOptions) => Promise<Omit<{
         permissions: import("./agent-permissions.js").NormalizedAgentPermissions;
-        id: string;
         title: string | null;
+        id: string;
         status: string;
         updatedAt: Date;
         orgId: string;
@@ -159,8 +159,8 @@ export declare function agentService(db: Db): {
     }, "workspaceKey"> | null>;
     pause: (id: string, reason?: "manual" | "budget" | "system") => Promise<Omit<{
         permissions: import("./agent-permissions.js").NormalizedAgentPermissions;
-        id: string;
         title: string | null;
+        id: string;
         status: string;
         updatedAt: Date;
         orgId: string;
@@ -185,8 +185,8 @@ export declare function agentService(db: Db): {
     }, "workspaceKey"> | null>;
     resume: (id: string) => Promise<Omit<{
         permissions: import("./agent-permissions.js").NormalizedAgentPermissions;
-        id: string;
         title: string | null;
+        id: string;
         status: string;
         updatedAt: Date;
         orgId: string;
@@ -211,8 +211,8 @@ export declare function agentService(db: Db): {
     }, "workspaceKey"> | null>;
     terminate: (id: string) => Promise<Omit<{
         permissions: import("./agent-permissions.js").NormalizedAgentPermissions;
-        id: string;
         title: string | null;
+        id: string;
         status: string;
         updatedAt: Date;
         orgId: string;
@@ -237,8 +237,8 @@ export declare function agentService(db: Db): {
     }, "workspaceKey"> | null>;
     remove: (id: string) => Promise<Omit<{
         permissions: import("./agent-permissions.js").NormalizedAgentPermissions;
-        id: string;
         title: string | null;
+        id: string;
         status: string;
         updatedAt: Date;
         orgId: string;
@@ -263,8 +263,8 @@ export declare function agentService(db: Db): {
     }, "workspaceKey"> | null>;
     activatePendingApproval: (id: string) => Promise<Omit<{
         permissions: import("./agent-permissions.js").NormalizedAgentPermissions;
-        id: string;
         title: string | null;
+        id: string;
         status: string;
         updatedAt: Date;
         orgId: string;
@@ -291,8 +291,8 @@ export declare function agentService(db: Db): {
         canCreateAgents: boolean;
     }) => Promise<Omit<{
         permissions: import("./agent-permissions.js").NormalizedAgentPermissions;
-        id: string;
         title: string | null;
+        id: string;
         status: string;
         updatedAt: Date;
         orgId: string;
@@ -346,8 +346,8 @@ export declare function agentService(db: Db): {
         userId?: string | null;
     }) => Promise<Omit<{
         permissions: import("./agent-permissions.js").NormalizedAgentPermissions;
-        id: string;
         title: string | null;
+        id: string;
         status: string;
         updatedAt: Date;
         orgId: string;
@@ -1679,8 +1679,8 @@ export declare function agentService(db: Db): {
     } | {
         readonly agent: Omit<{
             permissions: import("./agent-permissions.js").NormalizedAgentPermissions;
-            id: string;
             title: string | null;
+            id: string;
             status: string;
             updatedAt: Date;
             orgId: string;

package/dist/services/automations.d.ts

@@ -9,8 +9,9 @@ export declare function automationService(db: Db, deps?: {
     heartbeat?: IssueAssignmentWakeupDeps;
 }): {
     get: (id: string) => Promise<{
-        id: string;
         title: string;
+        description: string | null;
+        id: string;
         status: string;
         priority: string;
         assigneeAgentId: string;
@@ -19,7 +20,6 @@ export declare function automationService(db: Db, deps?: {
         orgId: string;
         projectId: string;
         goalId: string | null;
-        description: string | null;
         createdByAgentId: string | null;
         createdAt: Date;
         updatedByAgentId: string | null;

package/dist/services/calendar.d.ts

@@ -34,14 +34,14 @@ export declare function calendarService(db: Db): {
     createEvent(orgId: string, input: CreateCalendarEvent, actor?: Actor): Promise<CalendarEvent | null>;
     updateEvent(orgId: string, eventId: string, input: UpdateCalendarEvent, actor?: Actor): Promise<{
         previous: {
-            id: string;
             title: string;
+            description: string | null;
+            id: string;
             createdByUserId: string | null;
             updatedAt: Date;
             orgId: string;
             projectId: string | null;
             goalId: string | null;
-            description: string | null;
             createdAt: Date;
             timezone: string;
             updatedByUserId: string | null;
@@ -70,14 +70,14 @@ export declare function calendarService(db: Db): {
         event: CalendarEvent | null;
     }>;
     deleteEvent(orgId: string, eventId: string, actor?: Actor): Promise<{
-        id: string;
         title: string;
+        description: string | null;
+        id: string;
         createdByUserId: string | null;
         updatedAt: Date;
         orgId: string;
         projectId: string | null;
         goalId: string | null;
-        description: string | null;
         createdAt: Date;
         timezone: string;
         updatedByUserId: string | null;