@netnodeag/kraftwerk 0.73.0 → 0.74.0

package/dist/client/routes.d.ts

@@ -40,6 +40,7 @@ export declare const ROUTES: {
     readonly "chats.permission": readonly ["POST", "/api/chats/:id/permission"];
     readonly "chats.rename": readonly ["PATCH", "/api/chats/:id"];
     readonly "chats.resetSession": readonly ["POST", "/api/chats/:id/reset-session"];
+    readonly "chats.setProject": readonly ["POST", "/api/chats/:id/project"];
     readonly "chats.setVibeable": readonly ["POST", "/api/chats/:id/vibeable"];
     readonly "chats.steer": readonly ["POST", "/api/chats/:id/steer"];
     readonly "chats.stopTask": readonly ["POST", "/api/chats/:id/task-stop"];

package/dist/client/routes.js

@@ -41,6 +41,7 @@ export const ROUTES = {
     "chats.permission": ["POST", "/api/chats/:id/permission"],
     "chats.rename": ["PATCH", "/api/chats/:id"],
     "chats.resetSession": ["POST", "/api/chats/:id/reset-session"],
+    "chats.setProject": ["POST", "/api/chats/:id/project"],
     "chats.setVibeable": ["POST", "/api/chats/:id/vibeable"],
     "chats.steer": ["POST", "/api/chats/:id/steer"],
     "chats.stopTask": ["POST", "/api/chats/:id/task-stop"],

package/dist/core/chat/sessions.d.ts

@@ -16,6 +16,8 @@ export declare function createChat(opts: {
     title?: string;
     /** Continue one of the agent's own sessions (from listAgentSessionsFor) instead of starting fresh. */
     resume?: string;
+    /** The project an agent's chat works in (meta.project); the caller checks that it exists. */
+    project?: string;
 }): Promise<ChatMeta>;
 /** A permission request is waiting for a human in this chat (live state only — a restart drops it with the backend). */
 export declare function chatAwaitingApproval(id: string): boolean;
@@ -153,6 +155,17 @@ export declare function renameChat(id: string, title: unknown): Promise<{
     meta?: ChatMeta;
     error?: string;
 }>;
+/**
+ * File an agent's chat under a project, or under none (`null`). The chat is
+ * then listed with the project, and the agent reads the project's context
+ * with its next message. Project chats and channels belong where
+ * their scope says and cannot move; the caller checks that the project exists.
+ */
+export declare function setChatProject(id: string, project: string | null): Promise<{
+    meta?: ChatMeta;
+    error?: string;
+    status?: number;
+}>;
 export declare function deleteChat(id: string): Promise<{
     error?: string;
 }>;

package/dist/core/chat/sessions.js

@@ -43,6 +43,7 @@ export async function createChat(opts) {
         title: opts.title ?? "",
         cwd,
         scope: opts.scope,
+        ...(opts.project && opts.scope.kind === "agent" ? { project: opts.project } : {}),
         ...(opts.resume && opts.agent !== "pi" ? { sessions: { [MAIN]: opts.resume } } : {}),
         createdAt: now,
         updatedAt: now,
@@ -478,6 +479,27 @@ export async function renameChat(id, title) {
     await writeMeta(state.meta);
     return { meta: state.meta };
 }
+/**
+ * File an agent's chat under a project, or under none (`null`). The chat is
+ * then listed with the project, and the agent reads the project's context
+ * with its next message. Project chats and channels belong where
+ * their scope says and cannot move; the caller checks that the project exists.
+ */
+export async function setChatProject(id, project) {
+    const state = await loadState(id);
+    if (!state)
+        return { error: "not found", status: 404 };
+    if (state.meta.scope.kind !== "agent")
+        return { error: "only an agent's chat can be filed under a project", status: 409 };
+    if (project)
+        state.meta.project = project;
+    else
+        delete state.meta.project;
+    for (const seat of state.seats.values())
+        seat.needsContext = true;
+    await writeMeta(state.meta);
+    return { meta: state.meta };
+}
 export async function deleteChat(id) {
     const state = await loadState(id);
     if (!state)

package/dist/server/api/chats.d.ts

@@ -33,6 +33,7 @@ export declare const chatRoutes: (import("./router.js").Route<"agents.sessions",
         slug: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
     resume: z.ZodOptional<z.ZodString>;
+    project: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>> | import("./router.js").Route<"chats.delete", import("./router.js").Reply<{
     error?: string;
 }>, "/api/chats/:id", undefined> | import("./router.js").Route<"chats.elicitation", import("./router.js").Reply<{
@@ -80,7 +81,9 @@ export declare const chatRoutes: (import("./router.js").Route<"agents.sessions",
     error?: string;
 }>, "/api/chats/:id", z.ZodObject<{
     title: z.ZodString;
-}, z.core.$strip>> | import("./router.js").Route<"chats.resetSession", import("../../core/chat/types.js").ChatMeta, "/api/chats/:id/reset-session", undefined> | import("./router.js").Route<"chats.setVibeable", import("../../core/chat/types.js").ChatMeta, "/api/chats/:id/vibeable", z.ZodObject<{
+}, z.core.$strip>> | import("./router.js").Route<"chats.resetSession", import("../../core/chat/types.js").ChatMeta, "/api/chats/:id/reset-session", undefined> | import("./router.js").Route<"chats.setProject", import("../../core/chat/types.js").ChatMeta, "/api/chats/:id/project", z.ZodObject<{
+    project: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>> | import("./router.js").Route<"chats.setVibeable", import("../../core/chat/types.js").ChatMeta, "/api/chats/:id/vibeable", z.ZodObject<{
     slug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>> | import("./router.js").Route<"chats.steer", import("./router.js").Reply<{
     error: string;

package/dist/server/api/chats.js

@@ -2,7 +2,7 @@ import { promises as fs } from "node:fs";
 import path from "node:path";
 import * as z from "zod";
 import { getAgent } from "../../core/agents.js";
-import { answerElicitation, cancelChat, createChat, deleteChat, forkChat, getChat, listAgentSessionsFor, listChats, postMessage, renameChat, resetSession, resolvePermission, setChatConfig, setChatVibeable, steerChat, stopChatTask, subscribeChat, } from "../../core/chat/sessions.js";
+import { answerElicitation, cancelChat, createChat, deleteChat, forkChat, getChat, listAgentSessionsFor, listChats, postMessage, renameChat, resetSession, resolvePermission, setChatConfig, setChatProject, setChatVibeable, steerChat, stopChatTask, subscribeChat, } from "../../core/chat/sessions.js";
 import { attachmentPath, saveAttachment } from "../../core/chat/store.js";
 import { getProject } from "../../core/projects.js";
 import { MIME } from "./mime.js";
@@ -25,6 +25,8 @@ const NewChat = z.object({
     agent: z.string().optional(),
     scope: z.object({ kind: z.string(), runId: z.string().optional(), bundle: z.string().optional(), slug: z.string().optional() }).optional(),
     resume: z.string().optional(),
+    /** An agent's chat started in a project: listed with the project (meta.project). */
+    project: z.string().optional(),
 });
 /** An action on a running chat: `{ok}` when it went through, 409 with the reason when the chat refused. */
 const act = (name, path, summary, body, run) => route({ name, method: "POST", path, summary, errors: 400, body }, async (c) => {
@@ -64,17 +66,29 @@ async function scopeOf(body) {
         return { agent, scope: { kind: "knowledge", ...(s.bundle ? { bundle: s.bundle } : {}) } };
     return { agent, scope: { kind: "general" } };
 }
+/** The slug of an existing project, else a 404 (or the error reading it). */
+async function projectSlug(slug) {
+    const found = await getProject(slug).catch((err) => {
+        throw new ApiError(projectErrors(err.message), err.message);
+    });
+    if (!found)
+        fail(404, "project not found");
+    return found.slug;
+}
 /** Chats: ACP sessions with a coding agent, their event stream, and what a person does in them. */
 export const chatRoutes = [
     route({ name: "chats.list", method: "GET", path: "/api/chats", summary: "every chat with its live state" }, async () => ({ chats: await listChats() })),
-    route({ name: "chats.create", method: "POST", path: "/api/chats", summary: "start a chat {agent, scope, resume?}", body: NewChat }, async (c) => {
+    route({ name: "chats.create", method: "POST", path: "/api/chats", summary: "start a chat {agent, scope, resume?, project?}", body: NewChat }, async (c) => {
         // `resume` continues one of the agent's own sessions (see agents.sessions).
         const body = await c.body();
         const { agent, scope } = await scopeOf(body);
         if (!AGENTS.includes(agent))
             fail(400, "agent must be claude, codex, or pi");
+        if (body.project && scope.kind !== "agent")
+            fail(400, "only an agent's chat takes a project");
+        const project = body.project ? await projectSlug(body.project) : undefined;
         try {
-            return await createChat({ agent: agent, scope, ...(body.resume ? { resume: body.resume } : {}) });
+            return await createChat({ agent: agent, scope, ...(project ? { project } : {}), ...(body.resume ? { resume: body.resume } : {}) });
         }
         catch (err) {
             throw new ApiError(400, err.message);
@@ -96,6 +110,18 @@ export const chatRoutes = [
         const result = await validChat(renameChat(c.params.id, title), "invalid chat id or body");
         return reply(result.error ? (result.error === "not found" ? 404 : 400) : 200, result);
     }),
+    route({
+        name: "chats.setProject",
+        method: "POST",
+        path: "/api/chats/:id/project",
+        summary: "file an agent's chat under a project {project}, or under none {project: null}",
+        errors: 400,
+        body: z.object({ project: z.string().nullable() }),
+    }, async (c) => {
+        const { project } = await c.body();
+        const slug = project ? await projectSlug(project) : null;
+        return metaOf(await validChat(setChatProject(c.params.id, slug)));
+    }),
     // Replays from ?after=N, then streams new events as they happen.
     route({ name: "chats.events", method: "GET", path: "/api/chats/:id/events", summary: "SSE: the chat's events from ?after=N", raw: true }, async ({ req, res, params, query }) => {
         const afterSeq = Number(query.get("after") ?? "0") || 0;

package/dist/server/api/index.d.ts

@@ -218,6 +218,7 @@ export declare const routes: (Route<"agents.addJournal", {
         slug: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
     resume: z.ZodOptional<z.ZodString>;
+    project: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>> | Route<"chats.delete", import("./router.js").Reply<{
     error?: string;
 }>, "/api/chats/:id", undefined> | Route<"chats.elicitation", import("./router.js").Reply<{
@@ -265,7 +266,9 @@ export declare const routes: (Route<"agents.addJournal", {
     error?: string;
 }>, "/api/chats/:id", z.ZodObject<{
     title: z.ZodString;
-}, z.core.$strip>> | Route<"chats.resetSession", import("../../core/chat/types.js").ChatMeta, "/api/chats/:id/reset-session", undefined> | Route<"chats.setVibeable", import("../../core/chat/types.js").ChatMeta, "/api/chats/:id/vibeable", z.ZodObject<{
+}, z.core.$strip>> | Route<"chats.resetSession", import("../../core/chat/types.js").ChatMeta, "/api/chats/:id/reset-session", undefined> | Route<"chats.setProject", import("../../core/chat/types.js").ChatMeta, "/api/chats/:id/project", z.ZodObject<{
+    project: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>> | Route<"chats.setVibeable", import("../../core/chat/types.js").ChatMeta, "/api/chats/:id/vibeable", z.ZodObject<{
     slug: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>> | Route<"chats.steer", import("./router.js").Reply<{
     error: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@netnodeag/kraftwerk",
-  "version": "0.73.0",
+  "version": "0.74.0",
   "description": "Open-source agentic workspace for teams — where people and AI agents get work done together: agents (Claude Code, Codex, Pi), skills, shared knowledge, repeatable workflows, and deterministic verification",
   "keywords": [
     "agents",