@vibesdotdev/session 0.0.0-stage → 1.0.0-rc.2

package/dist/tools/lifecycle/init/workspace.consumer.js

@@ -0,0 +1,58 @@
+import { getPathRoots, getRuntimePath } from '@vibesdotdev/paths';
+import { requireRuntimeCwd } from '@vibesdotdev/kernel';
+function normalizeWorkspacePath(value) {
+    if (!value) {
+        return null;
+    }
+    const trimmed = value.trim();
+    if (trimmed.length === 0) {
+        return null;
+    }
+    return trimmed;
+}
+/** A caller's path, absolute; a relative one resolves against where the command ran. */
+async function absoluteFromCaller(runtime, path) {
+    const paths = await getRuntimePath(runtime);
+    return paths.isAbsolute(path) ? paths.resolve(path) : paths.resolve(requireRuntimeCwd(runtime), path);
+}
+/** `/` or a drive/UNC root — never a real workspace. */
+function isRootish(paths, path) {
+    const n = paths.resolve(path).replaceAll('\\', '/');
+    return n === '/' || /^[A-Za-z]:\/?$/.test(n) || /^\/\/[^/]+\/[^/]+$/.test(n);
+}
+/**
+ * Resolve the session's workspace: an explicit `workspacePath` argument, else
+ * the call's workspace (`ToolCallContext.workspace`), else the one reader,
+ * `runtime/workspace-path` (rc02-rc03 §2.4). An unbound host fails there with
+ * `workspace-unbound`, whose hint names `--workspace-root`; nothing falls back
+ * to the process cwd, an environment variable or a walk. A bound root that is
+ * `/` or the user's home carries a warning, so the operator sees the injury
+ * instead of silently mis-anchoring.
+ */
+export async function resolveWorkspaceContext(args, runtime, invokeWorkspace) {
+    const explicitWorkspace = normalizeWorkspacePath(args.workspacePath);
+    if (explicitWorkspace) {
+        return { path: await absoluteFromCaller(runtime, explicitWorkspace), source: 'arguments' };
+    }
+    const invokeRoot = normalizeWorkspacePath(invokeWorkspace?.root);
+    if (invokeRoot) {
+        return { path: await absoluteFromCaller(runtime, invokeRoot), source: 'arguments' };
+    }
+    const contextPath = await runtime.context('runtime/workspace-path');
+    const warning = buildWorkspaceWarning(runtime, await getRuntimePath(runtime), contextPath);
+    return warning
+        ? { path: contextPath, source: 'context', warning }
+        : { path: contextPath, source: 'context' };
+}
+/** A warning when the bound workspace is not a real project root: `/` or the user's home. */
+function buildWorkspaceWarning(runtime, paths, resolved) {
+    const normalized = resolved.replaceAll('\\', '/');
+    if (isRootish(paths, normalized)) {
+        return `Workspace resolved to a root path ("${normalized}"). No project root was found — atlas, knowledge, and workspace tools will misbehave. Launch the server with --workspace-root <dir> or with its cwd inside the repository.`;
+    }
+    if (normalized === getPathRoots(runtime).userHome.replaceAll('\\', '/')) {
+        return `Workspace resolved to the user's home ("${normalized}") — no repository was found above the launch cwd. Launch the server with --workspace-root <dir> (a GUI-launched server starts with cwd "/").`;
+    }
+    return undefined;
+}
+//# sourceMappingURL=workspace.consumer.js.map

package/dist/tools/lifecycle/init/workspace.consumer.js.map

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

package/dist/tools/lifecycle/list/handler.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Session List - Universal Tool Handler
+ */
+import type { VibesRuntime } from '@vibesdotdev/kernel';
+type SessionStatus = 'active' | 'paused' | 'archived';
+export interface SessionListInput {
+    status: SessionStatus | 'all';
+    limit: number;
+    offset: number;
+}
+export declare function sessionListHandler(args: SessionListInput, _mcpSessionId?: string | null, runtime?: VibesRuntime): Promise<{
+    sessions: {
+        id: string;
+        title: string;
+        status: "active" | "paused" | "archived";
+        ownerParticipant: string;
+        ownerParticipantId: string;
+        ownerParticipantSlug: string | undefined;
+        ownerParticipantName: string | undefined;
+        assignedParticipantId: string | undefined;
+        assignedParticipantSlug: string | undefined;
+        assignedParticipantName: string | undefined;
+        workItemId: string | undefined;
+        workItemTitle: string | undefined;
+        workspaceRoot: string | undefined;
+        gitBranch: string | undefined;
+        worktree: string | undefined;
+        tags: string[];
+        createdAt: string;
+        lastActivityAt: string;
+    }[];
+    total: number;
+    filters: {
+        status?: "active" | "paused" | "archived" | undefined;
+        scope?: "local" | "global" | "project" | undefined;
+        ownerParticipant?: string | undefined;
+        assignedParticipant?: string | undefined;
+        projectId?: string | undefined;
+        workItemId?: string | undefined;
+        tags?: string[] | undefined;
+        search?: string | undefined;
+        limit?: number | undefined;
+        offset?: number | undefined;
+    };
+}>;
+export {};
+//# sourceMappingURL=handler.d.ts.map

package/dist/tools/lifecycle/list/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../../src/tools/lifecycle/list/handler.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAIxD,KAAK,aAAa,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEtD,MAAM,WAAW,gBAAgB;IAChC,MAAM,EAAE,aAAa,GAAG,KAAK,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,kBAAkB,CACvC,IAAI,EAAE,gBAAgB,EACtB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,EAC7B,OAAO,CAAC,EAAE,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDtB"}

package/dist/tools/lifecycle/list/handler.js

@@ -0,0 +1,48 @@
+/**
+ * Session List - Universal Tool Handler
+ */
+import { getSessionManagerAsync } from "../../../mcp/utils/participant.js";
+export async function sessionListHandler(args, _mcpSessionId, runtime) {
+    const session = await getSessionManagerAsync(runtime);
+    const filters = {
+        limit: args.limit,
+        offset: args.offset
+    };
+    if (args.status !== 'all') {
+        filters.status = args.status;
+    }
+    // total = true matching-row count, never the returned page length — the
+    // default page is 100 and a workspace past it silently looked "complete"
+    // (ledger L-11; same fix as scratchpad/todo list).
+    const [sessions, total] = await Promise.all([
+        session.listSessions(filters),
+        session.countSessions(filters.status ? { status: filters.status } : {})
+    ]);
+    return {
+        sessions: sessions.map((s) => ({
+            id: s.id,
+            title: s.title,
+            status: s.status,
+            // Prefer the copy-safe slug returned by the session owner projection;
+            // retain the durable id separately for joins and migrations.
+            ownerParticipant: s.ownerParticipantSlug ?? s.ownerParticipant,
+            ownerParticipantId: s.ownerParticipantId ?? s.ownerParticipant,
+            ownerParticipantSlug: s.ownerParticipantSlug,
+            ownerParticipantName: s.ownerParticipantName,
+            assignedParticipantId: s.assignedParticipantId,
+            assignedParticipantSlug: s.assignedParticipantSlug,
+            assignedParticipantName: s.assignedParticipantName,
+            workItemId: s.workItemId,
+            workItemTitle: s.workItemTitle,
+            workspaceRoot: s.workspaceRoot,
+            gitBranch: s.gitBranch,
+            worktree: s.worktree,
+            tags: s.tags,
+            createdAt: s.createdAt instanceof Date ? s.createdAt.toISOString() : s.createdAt,
+            lastActivityAt: s.lastActivityAt instanceof Date ? s.lastActivityAt.toISOString() : s.lastActivityAt
+        })),
+        total,
+        filters
+    };
+}
+//# sourceMappingURL=handler.js.map

package/dist/tools/lifecycle/list/handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../../../src/tools/lifecycle/list/handler.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAU3E,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACvC,IAAsB,EACtB,aAA6B,EAC7B,OAAsB;IAEtB,MAAM,OAAO,GAAG,MAAM,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAEtD,MAAM,OAAO,GAAmB;QAC/B,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,MAAM,EAAE,IAAI,CAAC,MAAM;KACnB,CAAC;IAEF,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;QAC3B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC9B,CAAC;IAED,wEAAwE;IACxE,yEAAyE;IACzE,mDAAmD;IACnD,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC3C,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC;QAC7B,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACvE,CAAC,CAAC;IAEH,OAAO;QACN,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC9B,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,sEAAsE;YACtE,6DAA6D;YAC7D,gBAAgB,EAAE,CAAC,CAAC,oBAAoB,IAAI,CAAC,CAAC,gBAAgB;YAC9D,kBAAkB,EAAE,CAAC,CAAC,kBAAkB,IAAI,CAAC,CAAC,gBAAgB;YAC9D,oBAAoB,EAAE,CAAC,CAAC,oBAAoB;YAC5C,oBAAoB,EAAE,CAAC,CAAC,oBAAoB;YAC5C,qBAAqB,EAAE,CAAC,CAAC,qBAAqB;YAC9C,uBAAuB,EAAE,CAAC,CAAC,uBAAuB;YAClD,uBAAuB,EAAE,CAAC,CAAC,uBAAuB;YAClD,UAAU,EAAE,CAAC,CAAC,UAAU;YACxB,aAAa,EAAE,CAAC,CAAC,aAAa;YAC9B,aAAa,EAAE,CAAC,CAAC,aAAa;YAC9B,SAAS,EAAE,CAAC,CAAC,SAAS;YACtB,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,SAAS,EAAE,CAAC,CAAC,SAAS,YAAY,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;YAChF,cAAc,EACb,CAAC,CAAC,cAAc,YAAY,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,cAAc;SACrF,CAAC,CAAC;QACH,KAAK;QACL,OAAO;KACP,CAAC;AACH,CAAC"}

package/dist/tools/lifecycle/list/schemas.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Session List Tool Schemas
+ */
+import z from 'zod/v4';
+/**
+ * Input schema for session-list tool
+ */
+export declare const SessionListInputSchema: z.ZodObject<{
+    status: z.ZodDefault<z.ZodEnum<{
+        all: "all";
+        active: "active";
+        paused: "paused";
+        archived: "archived";
+    }>>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type SessionListInput = z.infer<typeof SessionListInputSchema>;
+/**
+ * Output schema for session-list tool
+ */
+export declare const SessionListOutputSchema: z.ZodObject<{
+    sessions: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        status: z.ZodString;
+        ownerParticipant: z.ZodString;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        createdAt: z.ZodString;
+        lastActivityAt: z.ZodString;
+    }, z.core.$strip>>;
+    total: z.ZodNumber;
+    filters: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>;
+export type SessionListOutput = z.infer<typeof SessionListOutputSchema>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/tools/lifecycle/list/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../../src/tools/lifecycle/list/schemas.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,CAAC,MAAM,QAAQ,CAAC;AAEvB;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;iBAIjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;iBAelC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}

package/dist/tools/lifecycle/list/schemas.js

@@ -0,0 +1,30 @@
+/**
+ * Session List Tool Schemas
+ */
+import z from 'zod/v4';
+/**
+ * Input schema for session-list tool
+ */
+export const SessionListInputSchema = z.object({
+    status: z.enum(['active', 'paused', 'archived', 'all']).default('all'),
+    limit: z.number().int().positive().max(Number.MAX_SAFE_INTEGER).default(50),
+    offset: z.number().int().min(0).max(Number.MAX_SAFE_INTEGER).default(0)
+});
+/**
+ * Output schema for session-list tool
+ */
+export const SessionListOutputSchema = z.object({
+    sessions: z.array(z.object({
+        id: z.string(),
+        title: z.string(),
+        description: z.string().optional(),
+        status: z.string(),
+        ownerParticipant: z.string(),
+        tags: z.array(z.string()).optional(),
+        createdAt: z.string(),
+        lastActivityAt: z.string()
+    })),
+    total: z.number(),
+    filters: z.record(z.string(), z.unknown())
+});
+//# sourceMappingURL=schemas.js.map

package/dist/tools/lifecycle/list/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../../src/tools/lifecycle/list/schemas.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,CAAC,MAAM,QAAQ,CAAC;AAEvB;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IACtE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC3E,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;CACvE,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,QAAQ,EAAE,CAAC,CAAC,KAAK,CAChB,CAAC,CAAC,MAAM,CAAC;QACR,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;QACd,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAClC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;QAClB,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE;QAC5B,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;QACpC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;KAC1B,CAAC,CACF;IACD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;CAC1C,CAAC,CAAC"}