@xfey/tutti 0.1.13 → 0.1.15

package/dist/control-plane/workflows/openai.d.ts

@@ -17,6 +17,7 @@ export type OpenAiProcedureWorkflowRunnerOptions = {
         turnTimeoutMs?: number;
         baseEnv?: NodeJS.ProcessEnv;
         tuttiHome?: string;
+        userSkillsRoot?: string;
         builtInSkillsRoot?: string;
         agentContext?: CodexAppServerAgentContextRuntime;
     };

package/dist/control-plane/workflows/openai.js

@@ -7,6 +7,7 @@ import { readOpenAiApiKeyCredential } from "../../providers/openai/credential-st
 import { resolveOpenAiProviderConfig, } from "../../providers/openai/provider-config.js";
 import { SCRATCHPAD_REFRESH_OUTPUT_SCHEMA, TASK_COMPILE_OUTPUT_SCHEMA, PROJECT_CONTEXT_BOOTSTRAP_OUTPUT_SCHEMA, CONTEXT_SYNC_OUTPUT_SCHEMA, PROJECT_BRIEF_REFRESH_OUTPUT_SCHEMA, FOLLOW_UP_CHECK_OUTPUT_SCHEMA, REFERENCE_FILE_SUMMARY_OUTPUT_SCHEMA, isContextSyncWorkflowOutput, isFollowUpCheckStructuredOutput, isProjectBriefRefreshWorkflowOutput, isProjectContextBootstrapWorkflowOutput, isReferenceFileSummaryStructuredOutput, isScratchpadRefreshStructuredOutput, isTaskCompileStructuredOutput, } from "./structured-output.js";
 import { runCodexAppServerReadOnlyProcedure } from "../../providers/openai/app-server/read-only-procedure.js";
+import { getProjectUserSkillsRoot } from "../../skills/index.js";
 function readOnlyAppServerOptions(options, prompt, outputSchema, skillSelectionName) {
     if (options.readOnlyAppServer === undefined) {
         throw new Error("Codex app-server read-only Procedure adapter is not configured");
@@ -36,6 +37,9 @@ function readOnlyAppServerOptions(options, prompt, outputSchema, skillSelectionN
         ...(options.readOnlyAppServer.tuttiHome === undefined
             ? {}
             : { tuttiHome: options.readOnlyAppServer.tuttiHome }),
+        ...(options.readOnlyAppServer.userSkillsRoot === undefined
+            ? {}
+            : { userSkillsRoot: options.readOnlyAppServer.userSkillsRoot }),
         ...(options.readOnlyAppServer.builtInSkillsRoot === undefined
             ? {}
             : { builtInSkillsRoot: options.readOnlyAppServer.builtInSkillsRoot }),
@@ -421,6 +425,7 @@ export function resolveProjectOpenAiProcedureWorkflowRunner(options) {
                 apiKey: credential.secret,
                 workspaceRoot: options.workspaceRoot,
                 tuttiHome: options.tuttiHome,
+                userSkillsRoot: getProjectUserSkillsRoot(options.tuttiHome, options.projectId),
                 ...(options.agentContext === undefined ? {} : { agentContext: options.agentContext }),
             },
             ...(options.recordUsage === undefined ? {} : { recordUsage: options.recordUsage }),

package/dist/providers/openai/app-server/read-only-procedure.d.ts

@@ -16,6 +16,7 @@ export type CodexAppServerReadOnlyProcedureInput<TOutput> = {
     webSearchMode?: CodexAppServerWebSearchMode;
     skillSelectionName?: CodexAppServerSkillSelectionName;
     tuttiHome?: string;
+    userSkillsRoot?: string;
     builtInSkillsRoot?: string;
     agentContext?: CodexAppServerAgentContextRuntime;
     strictLeakCheck?: boolean;

package/dist/providers/openai/app-server/read-only-procedure.js

@@ -81,7 +81,7 @@ export async function runCodexAppServerReadOnlyProcedure(options) {
     try {
         skillInputs = resolveCodexAppServerSkillInputs({
             ...(options.skillSelectionName === undefined ? {} : { selectionName: options.skillSelectionName }),
-            ...(options.tuttiHome === undefined ? {} : { tuttiHome: options.tuttiHome }),
+            ...(options.userSkillsRoot === undefined ? {} : { userSkillsRoot: options.userSkillsRoot }),
             ...(options.builtInSkillsRoot === undefined
                 ? {}
                 : { builtInSkillsRoot: options.builtInSkillsRoot }),
@@ -100,6 +100,7 @@ export async function runCodexAppServerReadOnlyProcedure(options) {
             options.workspaceRoot,
             options.appServerCwd ?? "",
             options.tuttiHome ?? "",
+            options.userSkillsRoot ?? "",
             options.builtInSkillsRoot ?? "",
         ]));
     }
@@ -145,6 +146,7 @@ export async function runCodexAppServerReadOnlyProcedure(options) {
         appServerCwd,
         ...readablePaths,
         options.tuttiHome ?? "",
+        options.userSkillsRoot ?? "",
         options.builtInSkillsRoot ?? "",
         ...(contextRuntimeHint?.sensitiveValues ?? []),
         ...skillInputs.map((skill) => skill.path),

package/dist/providers/openai/app-server/runtime-telemetry.js

@@ -20,10 +20,12 @@ function actionFromNotification(notification) {
     if (combined.includes("commandexecution") || combined.includes("command_execution")) {
         return "running_command";
     }
-    if (combined.includes("filechange") || combined.includes("file_change")) {
+    if (method === "turn/diff/updated" ||
+        combined.includes("filechange") ||
+        combined.includes("file_change")) {
         return "editing_files";
     }
-    if (combined.includes("plan")) {
+    if (method === "turn/plan/updated" || combined.includes("plan")) {
         return "planning";
     }
     if (combined.includes("mcptoolcall") ||
@@ -37,9 +39,6 @@ function actionFromNotification(notification) {
     if (combined.includes("reasoning")) {
         return "reading_context";
     }
-    if (method === "item/agentMessage/delta" || method === "item/completed") {
-        return "finalizing";
-    }
     return undefined;
 }
 function runtimeTokenUsage(usage) {

package/dist/providers/openai/app-server/skills.d.ts

@@ -56,13 +56,13 @@ export declare function resolveCodexAppServerSkillInputs(options: {
     selectionName?: CodexAppServerSkillSelectionName;
     selection?: CodexAppServerSkillSelection;
     builtInSkillsRoot?: string;
-    tuttiHome?: string;
+    userSkillsRoot?: string;
 }): CodexAppServerSkillInput[];
 export declare function resolveCodexAppServerSkillsListWarmup(options: {
     cwd: string;
     selectionName?: CodexAppServerSkillSelectionName;
     selection?: CodexAppServerSkillSelection;
-    tuttiHome?: string;
+    userSkillsRoot?: string;
 }): CodexAppServerSkillsListWarmup | undefined;
 export declare function buildCodexAppServerTurnInput(options: {
     prompt: string;

package/dist/providers/openai/app-server/skills.js

@@ -1,7 +1,7 @@
 import { existsSync, statSync } from "node:fs";
 import { join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
-import { getUserSkillsRoot, listUserSkills } from "../../../skills/index.js";
+import { listUserSkills } from "../../../skills/index.js";
 export class CodexAppServerSkillSelectionError extends Error {
     code;
     constructor(code, message) {
@@ -117,7 +117,7 @@ function resolveBuiltInSkill(options) {
 function resolveUserSkill(options) {
     return {
         name: options.name,
-        path: join(getUserSkillsRoot(options.tuttiHome), options.name),
+        path: join(options.userSkillsRoot, options.name),
     };
 }
 export function resolveCodexAppServerSkillSelection(selectionName) {
@@ -134,8 +134,9 @@ export function resolveCodexAppServerSkillInputs(options) {
             : resolveCodexAppServerSkillSelection(options.selectionName));
     const builtInSkillsRoot = options.builtInSkillsRoot ?? DEFAULT_BUILT_IN_SKILLS_ROOT;
     const builtInSkills = selection.builtInSkillNames.map((name) => resolveBuiltInSkill({ builtInSkillsRoot, name }));
-    const userSkills = selection.userSkillMode === "all_enabled" && options.tuttiHome !== undefined
-        ? listUserSkills(options.tuttiHome).map((skill) => resolveUserSkill({ tuttiHome: options.tuttiHome, name: skill.name }))
+    const userSkillsRoot = options.userSkillsRoot;
+    const userSkills = selection.userSkillMode === "all_enabled" && userSkillsRoot !== undefined
+        ? listUserSkills(userSkillsRoot).map((skill) => resolveUserSkill({ userSkillsRoot, name: skill.name }))
         : [];
     return [...builtInSkills, ...userSkills];
 }
@@ -148,10 +149,10 @@ export function resolveCodexAppServerSkillsListWarmup(options) {
                 contextApiScopes: [],
             }
             : resolveCodexAppServerSkillSelection(options.selectionName));
-    if (selection.userSkillMode !== "all_enabled" || options.tuttiHome === undefined) {
+    if (selection.userSkillMode !== "all_enabled" || options.userSkillsRoot === undefined) {
         return undefined;
     }
-    if (listUserSkills(options.tuttiHome).length === 0) {
+    if (listUserSkills(options.userSkillsRoot).length === 0) {
         return undefined;
     }
     return {
@@ -160,7 +161,7 @@ export function resolveCodexAppServerSkillsListWarmup(options) {
         perCwdExtraUserRoots: [
             {
                 cwd: options.cwd,
-                extraUserRoots: [getUserSkillsRoot(options.tuttiHome)],
+                extraUserRoots: [options.userSkillsRoot],
             },
         ],
     };

package/dist/providers/openai/app-server/workspace-write-run.d.ts

@@ -40,6 +40,7 @@ export type CodexAppServerWorkspaceWriteRunInput<TOutput> = {
     approvalsReviewer?: CodexAppServerApprovalsReviewer;
     skillSelectionName?: CodexAppServerSkillSelectionName;
     tuttiHome?: string;
+    userSkillsRoot?: string;
     builtInSkillsRoot?: string;
     agentContext?: CodexAppServerAgentContextRuntime;
     approvalHandler?: CodexAppServerApprovalHandler;

package/dist/providers/openai/app-server/workspace-write-run.js

@@ -153,7 +153,7 @@ export async function runCodexAppServerWorkspaceWriteRun(options) {
     try {
         skillInputs = resolveCodexAppServerSkillInputs({
             ...(options.skillSelectionName === undefined ? {} : { selectionName: options.skillSelectionName }),
-            ...(options.tuttiHome === undefined ? {} : { tuttiHome: options.tuttiHome }),
+            ...(options.userSkillsRoot === undefined ? {} : { userSkillsRoot: options.userSkillsRoot }),
             ...(options.builtInSkillsRoot === undefined
                 ? {}
                 : { builtInSkillsRoot: options.builtInSkillsRoot }),
@@ -161,7 +161,7 @@ export async function runCodexAppServerWorkspaceWriteRun(options) {
         skillsListWarmup = resolveCodexAppServerSkillsListWarmup({
             cwd: options.workspaceRoot,
             ...(options.skillSelectionName === undefined ? {} : { selectionName: options.skillSelectionName }),
-            ...(options.tuttiHome === undefined ? {} : { tuttiHome: options.tuttiHome }),
+            ...(options.userSkillsRoot === undefined ? {} : { userSkillsRoot: options.userSkillsRoot }),
         });
         contextRuntimeHint = resolveCodexAppServerContextRuntimeHint({
             ...(options.skillSelectionName === undefined ? {} : { selectionName: options.skillSelectionName }),
@@ -176,6 +176,7 @@ export async function runCodexAppServerWorkspaceWriteRun(options) {
             options.apiKey,
             options.workspaceRoot,
             options.tuttiHome ?? "",
+            options.userSkillsRoot ?? "",
             options.builtInSkillsRoot ?? "",
         ]));
     }
@@ -219,6 +220,7 @@ export async function runCodexAppServerWorkspaceWriteRun(options) {
         codexHome,
         options.workspaceRoot,
         options.tuttiHome ?? "",
+        options.userSkillsRoot ?? "",
         options.builtInSkillsRoot ?? "",
         ...(contextRuntimeHint?.sensitiveValues ?? []),
         ...skillInputs.map((skill) => skill.path),

package/dist/providers/openai/chat-assistant.d.ts

@@ -8,6 +8,7 @@ export type OpenAiReadOnlyChatAssistantModelOptions = {
     apiKey: string;
     workspaceRoot: string;
     tuttiHome?: string;
+    userSkillsRoot?: string;
     builtInSkillsRoot?: string;
     agentContext?: CodexAppServerAgentContextRuntime;
     codexCommand?: string;

package/dist/providers/openai/chat-assistant.js

@@ -2,6 +2,7 @@ import { CHAT_ASSISTANT_OUTPUT_SCHEMA, isChatAssistantOutput, } from "../../chat
 import { readOpenAiApiKeyCredential } from "./credential-store.js";
 import { resolveOpenAiProviderConfig, } from "./provider-config.js";
 import { runCodexAppServerReadOnlyProcedure } from "./app-server/read-only-procedure.js";
+import { getProjectUserSkillsRoot } from "../../skills/index.js";
 export function createOpenAiReadOnlyChatAssistantModel(options) {
     return {
         async answer(input) {
@@ -19,6 +20,7 @@ export function createOpenAiReadOnlyChatAssistantModel(options) {
                 webSearchMode: "live",
                 skillSelectionName: "chat_assistant",
                 ...(options.tuttiHome === undefined ? {} : { tuttiHome: options.tuttiHome }),
+                ...(options.userSkillsRoot === undefined ? {} : { userSkillsRoot: options.userSkillsRoot }),
                 ...(options.builtInSkillsRoot === undefined
                     ? {}
                     : { builtInSkillsRoot: options.builtInSkillsRoot }),
@@ -60,6 +62,7 @@ export function resolveProjectOpenAiReadOnlyChatAssistantModel(options) {
                 apiKey: credential.secret,
                 workspaceRoot: options.workspaceRoot,
                 tuttiHome: options.tuttiHome,
+                userSkillsRoot: getProjectUserSkillsRoot(options.tuttiHome, options.projectId),
                 ...(options.agentContext === undefined ? {} : { agentContext: options.agentContext }),
                 ...(options.recordUsage === undefined ? {} : { recordUsage: options.recordUsage }),
             }),

package/dist/run-pipeline/openai.d.ts

@@ -13,6 +13,7 @@ export type OpenAiRunPipelineRunnerOptions = {
     mergeWorkspaceRoot?: string;
     promptsRoot?: string;
     tuttiHome?: string;
+    userSkillsRoot?: string;
     builtInSkillsRoot?: string;
     agentContext?: CodexAppServerAgentContextRuntime;
     approvalManager?: ApprovalRequestManager;

package/dist/run-pipeline/openai.js

@@ -7,6 +7,7 @@ import { runWorkspaceWriteTask } from "./task-run-invocation.js";
 import { readOpenAiApiKeyCredential } from "../providers/openai/credential-store.js";
 import { resolveOpenAiProviderConfig, } from "../providers/openai/provider-config.js";
 import { CodexAppServerWorkspaceWriteRunError } from "../providers/openai/app-server/workspace-write-run.js";
+import { getProjectUserSkillsRoot } from "../skills/index.js";
 import { cleanupRunWorkspace, collectRunDiff, createResultCommit, prepareRunWorkspace, promoteRunResult, WorkspaceOpsError, } from "../workspace-ops/index.js";
 export { TASK_RUN_OUTPUT_SCHEMA } from "./task-run-output.js";
 function isRecord(value) {
@@ -535,6 +536,7 @@ export function resolveProjectOpenAiRunPipelineRunner(options) {
             runWorkspaceRoot: join(options.runWorkspaceRoot, "run-workspaces"),
             mergeWorkspaceRoot: join(options.mergeWorkspaceRoot ?? options.runWorkspaceRoot, "merge-workspaces"),
             tuttiHome: options.tuttiHome,
+            userSkillsRoot: getProjectUserSkillsRoot(options.tuttiHome, options.projectId),
             ...(options.agentContext === undefined ? {} : { agentContext: options.agentContext }),
             ...(options.approvalManager === undefined
                 ? {}

package/dist/run-pipeline/task-run-invocation.js

@@ -99,6 +99,7 @@ export async function runWorkspaceWriteTask(options, input, handle) {
                 ? {}
                 : { apiBaseUrl: options.config.api_base_url }),
             ...(options.tuttiHome === undefined ? {} : { tuttiHome: options.tuttiHome }),
+            ...(options.userSkillsRoot === undefined ? {} : { userSkillsRoot: options.userSkillsRoot }),
             ...(options.builtInSkillsRoot === undefined
                 ? {}
                 : { builtInSkillsRoot: options.builtInSkillsRoot }),

package/dist/server-shell/cli/host-server-runtime.js

@@ -21,7 +21,7 @@ import { createTrustedRelaySessionMetadataStore, } from "../session/relay-sessio
 import { LaunchError } from "./errors.js";
 import { relayStateFromLaunchStatus } from "./host-relay-status.js";
 import { appendHostLogLine, readHostRegistrationSecret, createMachineRuntimeEndpointToken, deleteMachineRuntimeEndpoint, ensureHostLogFile, getHostLogFilePath, writeMachineRuntimeEndpoint, } from "./machine-local.js";
-import { readProjectDisplayName, writeProjectDisplayName } from "./project-identity.js";
+import { readProjectDescription, readProjectDisplayName, writeProjectDescription, writeProjectDisplayName, } from "./project-identity.js";
 export const HOST_SERVER_VERSION = "0.0.0";
 function createHostRuntimeLogger(options) {
     return {
@@ -163,6 +163,7 @@ export async function startForegroundHostServer(options) {
     };
     let projectDisplayName = readProjectDisplayName(options.preparation.workspace_root) ??
         (basename(options.preparation.workspace_root) || options.preparation.project_id);
+    let projectDescription = readProjectDescription(options.preparation.workspace_root) ?? "";
     const projectContext = {
         workspaceRoot: options.preparation.workspace_root,
         projectName: projectDisplayName,
@@ -174,6 +175,7 @@ export async function startForegroundHostServer(options) {
     const projectApiProject = {
         project_id: options.preparation.project_id,
         display_name: projectDisplayName,
+        ...(projectDescription.length === 0 ? {} : { description: projectDescription }),
         identity_source: "git_config",
     };
     const updateRuntimeProjectDisplayName = (displayName) => {
@@ -183,6 +185,16 @@ export async function startForegroundHostServer(options) {
         chatAssistantProject.display_name = displayName;
         projectApiProject.display_name = displayName;
     };
+    const updateRuntimeProjectDescription = (description) => {
+        writeProjectDescription(options.preparation.workspace_root, description);
+        projectDescription = description;
+        if (description.length === 0) {
+            delete projectApiProject.description;
+        }
+        else {
+            projectApiProject.description = description;
+        }
+    };
     const controlPlaneLogger = createHostRuntimeLogger({
         component: "control-plane",
         logFilePath,
@@ -353,6 +365,9 @@ export async function startForegroundHostServer(options) {
                 updateProjectDisplayName: (displayName) => {
                     updateRuntimeProjectDisplayName(displayName);
                 },
+                updateProjectDescription: (description) => {
+                    updateRuntimeProjectDescription(description);
+                },
                 ...(resolveStagedUpload === undefined ? {} : { resolveStagedUpload }),
                 capabilities: {
                     clarification: true,

package/dist/server-shell/cli/project-identity.d.ts

@@ -1,6 +1,7 @@
 import { type ProjectId } from "@tutti/shared/ids";
 export declare const PROJECT_ID_GIT_CONFIG_KEY = "tutti.project-id";
 export declare const PROJECT_DISPLAY_NAME_GIT_CONFIG_KEY = "tutti.project-display-name";
+export declare const PROJECT_DESCRIPTION_GIT_CONFIG_KEY = "tutti.project-description";
 export type ProjectIdentityReadResult = {
     kind: "missing";
 } | {
@@ -12,6 +13,8 @@ export declare function readProjectIdentity(workspaceRoot: string): ProjectIdent
 export declare function writeProjectIdentity(workspaceRoot: string, projectId: ProjectId): void;
 export declare function readProjectDisplayName(workspaceRoot: string): string | null;
 export declare function writeProjectDisplayName(workspaceRoot: string, displayName: string): void;
+export declare function readProjectDescription(workspaceRoot: string): string | null;
+export declare function writeProjectDescription(workspaceRoot: string, description: string): void;
 export declare function ensureProjectIdentity(workspaceRoot: string, projectId?: ProjectId): {
     project_id: ProjectId;
     created: boolean;

package/dist/server-shell/cli/project-identity.js

@@ -5,6 +5,7 @@ import { createProjectId, ID_PREFIXES, isPrefixedId } from "@tutti/shared/ids";
 import { LaunchError } from "./errors.js";
 export const PROJECT_ID_GIT_CONFIG_KEY = "tutti.project-id";
 export const PROJECT_DISPLAY_NAME_GIT_CONFIG_KEY = "tutti.project-display-name";
+export const PROJECT_DESCRIPTION_GIT_CONFIG_KEY = "tutti.project-description";
 function runGitRaw(args, cwd) {
     const result = spawnSync("git", [...args], {
         cwd,
@@ -76,6 +77,29 @@ export function readProjectDisplayName(workspaceRoot) {
 export function writeProjectDisplayName(workspaceRoot, displayName) {
     runGit(["config", "--local", PROJECT_DISPLAY_NAME_GIT_CONFIG_KEY, displayName], resolve(workspaceRoot));
 }
+export function readProjectDescription(workspaceRoot) {
+    const result = runGitRaw(["config", "--local", "--get", PROJECT_DESCRIPTION_GIT_CONFIG_KEY], resolve(workspaceRoot));
+    if (result.status !== 0) {
+        return null;
+    }
+    const description = result.stdout.trim();
+    return description.length === 0 ? null : description;
+}
+export function writeProjectDescription(workspaceRoot, description) {
+    const workspace = resolve(workspaceRoot);
+    const trimmedDescription = description.trim();
+    if (trimmedDescription.length === 0) {
+        const result = runGitRaw(["config", "--local", "--unset", PROJECT_DESCRIPTION_GIT_CONFIG_KEY], workspace);
+        if (result.status === 0 || result.status === 5) {
+            return;
+        }
+        const stderr = result.stderr.trim();
+        throw new LaunchError("git_bootstrap_failed", stderr.length > 0
+            ? stderr
+            : `git config --local --unset ${PROJECT_DESCRIPTION_GIT_CONFIG_KEY} failed`, "Resolve the Git error and run `tutti launch` again.");
+    }
+    runGit(["config", "--local", PROJECT_DESCRIPTION_GIT_CONFIG_KEY, trimmedDescription], workspace);
+}
 export function ensureProjectIdentity(workspaceRoot, projectId = createProjectId()) {
     const existing = readProjectIdentity(workspaceRoot);
     if (existing.kind === "present") {

package/dist/server-shell/http/routes/agent-context-shared.d.ts

@@ -31,4 +31,5 @@ export type AgentContextRouteOptions = Pick<HostProjectApiRouteOptions, "project
 export declare function requireProjectStore(options: AgentContextRouteOptions): HostProjectStore;
 export declare function requireWorkspaceRoot(options: AgentContextRouteOptions): string;
 export declare function requireTuttiHome(options: AgentContextRouteOptions): string;
+export declare function requireProjectUserSkillsRoot(options: AgentContextRouteOptions): string;
 //# sourceMappingURL=agent-context-shared.d.ts.map

package/dist/server-shell/http/routes/agent-context-shared.js

@@ -1,3 +1,4 @@
+import { getProjectUserSkillsRoot } from "../../../skills/index.js";
 import { AgentContextBadRequestError } from "./agent-context-errors.js";
 export const AGENT_CONTEXT_BASE_PATH = "/internal/agent-context";
 export const MESSAGE_LIMIT_DEFAULT = 50;
@@ -41,4 +42,7 @@ export function requireTuttiHome(options) {
     }
     return options.tuttiHome;
 }
+export function requireProjectUserSkillsRoot(options) {
+    return getProjectUserSkillsRoot(requireTuttiHome(options), options.project.project_id);
+}
 //# sourceMappingURL=agent-context-shared.js.map

package/dist/server-shell/http/routes/agent-context-skills-routes.js

@@ -3,7 +3,7 @@ import { listUserSkills, readUserSkill, SkillServiceError, } from "../../../skil
 import { authorizeAgentContextRequest } from "./agent-context-auth.js";
 import { AgentContextBadRequestError } from "./agent-context-errors.js";
 import { boundedLimit, pageByOffset, queryString, truncateText } from "./agent-context-query.js";
-import { AGENT_CONTEXT_BASE_PATH, USER_SKILLS_LIMIT_DEFAULT, USER_SKILLS_LIMIT_MAX, USER_SKILL_MD_DEFAULT_MAX_CHARS, USER_SKILL_MD_MAX_CHARS, requireTuttiHome, } from "./agent-context-shared.js";
+import { AGENT_CONTEXT_BASE_PATH, USER_SKILLS_LIMIT_DEFAULT, USER_SKILLS_LIMIT_MAX, USER_SKILL_MD_DEFAULT_MAX_CHARS, USER_SKILL_MD_MAX_CHARS, requireProjectUserSkillsRoot, } from "./agent-context-shared.js";
 function skillUnavailable(input) {
     return {
         kind: "unavailable",
@@ -37,7 +37,7 @@ export function registerAgentContextSkillRoutes(app, options) {
             max: USER_SKILLS_LIMIT_MAX,
         });
         const cursor = queryString(request.query.cursor);
-        const page = pageByOffset(listUserSkills(requireTuttiHome(options)), {
+        const page = pageByOffset(listUserSkills(requireProjectUserSkillsRoot(options)), {
             endpoint: "skills",
             ...(cursor === undefined ? {} : { cursor }),
             limit,
@@ -59,7 +59,7 @@ export function registerAgentContextSkillRoutes(app, options) {
         });
         const skillName = request.params.skillName;
         try {
-            const skill = readUserSkill(requireTuttiHome(options), skillName);
+            const skill = readUserSkill(requireProjectUserSkillsRoot(options), skillName);
             const skillMd = truncateText(redactText(skill.skill_md), maxChars);
             return {
                 kind: "skill",

package/dist/server-shell/http/routes/project-api/invalidations.d.ts

@@ -6,5 +6,6 @@ export declare function schedulerRunNowInvalidates(disposition: RunSchedulerNowD
 export declare function clarificationRoundInvalidates(roundId: ClarificationRoundRef): QueryInvalidationHint[];
 export declare function approvalInvalidates(): QueryInvalidationHint[];
 export declare function readStateInvalidates(): QueryInvalidationHint[];
+export declare function projectMetadataInvalidates(): QueryInvalidationHint[];
 export declare function projectDisplayNameInvalidates(): QueryInvalidationHint[];
 //# sourceMappingURL=invalidations.d.ts.map

package/dist/server-shell/http/routes/project-api/invalidations.js

@@ -51,7 +51,10 @@ export function approvalInvalidates() {
 export function readStateInvalidates() {
     return [{ kind: "read_state" }, { kind: "bootstrap" }];
 }
-export function projectDisplayNameInvalidates() {
+export function projectMetadataInvalidates() {
     return [{ kind: "workspace" }, { kind: "bootstrap" }];
 }
+export function projectDisplayNameInvalidates() {
+    return projectMetadataInvalidates();
+}
 //# sourceMappingURL=invalidations.js.map

package/dist/server-shell/http/routes/project-api/openapi-workspace-routes.d.ts

@@ -435,6 +435,10 @@ export declare const HOST_PROJECT_WORKSPACE_OPENAPI_ROUTES: ({
                                 readonly type: "string";
                                 readonly minLength: 1;
                             };
+                            readonly description: {
+                                readonly type: "string";
+                                readonly maxLength: 160;
+                            };
                             readonly identity_source: {
                                 readonly type: "string";
                                 readonly enum: readonly ["git_config"];
@@ -631,6 +635,10 @@ export declare const HOST_PROJECT_WORKSPACE_OPENAPI_ROUTES: ({
                                         readonly type: "string";
                                         readonly minLength: 1;
                                     };
+                                    readonly description: {
+                                        readonly type: "string";
+                                        readonly maxLength: 160;
+                                    };
                                     readonly identity_source: {
                                         readonly type: "string";
                                         readonly enum: readonly ["git_config"];

package/dist/server-shell/http/routes/project-api/openapi-workspace-routes.js

@@ -1,4 +1,4 @@
-import { MarkReadBodySchema, MarkReadResponseSchema, ReadStateSummaryProjectionSchema, UpdateProjectDisplayNameBodySchema, UpdateProjectDisplayNameResponseSchema, } from "@tutti/shared/schemas/api";
+import { MarkReadBodySchema, MarkReadResponseSchema, ReadStateSummaryProjectionSchema, UpdateProjectDescriptionBodySchema, UpdateProjectDescriptionResponseSchema, UpdateProjectDisplayNameBodySchema, UpdateProjectDisplayNameResponseSchema, } from "@tutti/shared/schemas/api";
 import { HOST_PROJECT_API_BASE_PATH } from "./constants.js";
 import { BootstrapResponseSchema, ProviderConfigProjectionSchema, ProviderUsageProjectionSchema, SessionResponseSchema, WorkspaceResponseSchema, } from "./schemas.js";
 export const HOST_PROJECT_WORKSPACE_OPENAPI_ROUTES = [
@@ -57,6 +57,19 @@ export const HOST_PROJECT_WORKSPACE_OPENAPI_ROUTES = [
             },
         },
     },
+    {
+        method: "post",
+        path: `${HOST_PROJECT_API_BASE_PATH}/workspace/project-description`,
+        summary: "Update the current project description.",
+        tags: ["workspace"],
+        requestBody: UpdateProjectDescriptionBodySchema,
+        responses: {
+            200: {
+                description: "Project description update command response.",
+                schema: UpdateProjectDescriptionResponseSchema,
+            },
+        },
+    },
     {
         method: "get",
         path: `${HOST_PROJECT_API_BASE_PATH}/bootstrap`,

package/dist/server-shell/http/routes/project-api/openapi.d.ts

@@ -1600,6 +1600,10 @@ export declare const HOST_PROJECT_OPENAPI_ROUTES: ({
                                 readonly type: "string";
                                 readonly minLength: 1;
                             };
+                            readonly description: {
+                                readonly type: "string";
+                                readonly maxLength: 160;
+                            };
                             readonly identity_source: {
                                 readonly type: "string";
                                 readonly enum: readonly ["git_config"];
@@ -1784,6 +1788,10 @@ export declare const HOST_PROJECT_OPENAPI_ROUTES: ({
                                         readonly type: "string";
                                         readonly minLength: 1;
                                     };
+                                    readonly description: {
+                                        readonly type: "string";
+                                        readonly maxLength: 160;
+                                    };
                                     readonly identity_source: {
                                         readonly type: "string";
                                         readonly enum: readonly ["git_config"];

package/dist/server-shell/http/routes/project-api/payload-validation.d.ts

@@ -1,6 +1,7 @@
-import type { GetMessagesRequest, SendClarificationRoundMessagePayload, SendMainChatMessagePayload, UpdateProjectDisplayNamePayload } from "@tutti/shared/schemas/api";
+import type { GetMessagesRequest, SendClarificationRoundMessagePayload, SendMainChatMessagePayload, UpdateProjectDescriptionPayload, UpdateProjectDisplayNamePayload } from "@tutti/shared/schemas/api";
 export declare function requireValidMessageWindowRequest(query: GetMessagesRequest): GetMessagesRequest;
 export declare function requireValidSendMainChatPayload(payload: SendMainChatMessagePayload): SendMainChatMessagePayload;
 export declare function requireValidRoundMessagePayload(payload: SendClarificationRoundMessagePayload): SendClarificationRoundMessagePayload;
 export declare function requireValidProjectDisplayNamePayload(payload: UpdateProjectDisplayNamePayload): UpdateProjectDisplayNamePayload;
+export declare function requireValidProjectDescriptionPayload(payload: UpdateProjectDescriptionPayload): UpdateProjectDescriptionPayload;
 //# sourceMappingURL=payload-validation.d.ts.map

package/dist/server-shell/http/routes/project-api/payload-validation.js

@@ -33,4 +33,11 @@ export function requireValidProjectDisplayNamePayload(payload) {
     }
     return { display_name: displayName };
 }
+export function requireValidProjectDescriptionPayload(payload) {
+    const description = payload.description.trim();
+    if (description.length > 160) {
+        throw new HostProjectValidationError("Project description cannot exceed 160 characters");
+    }
+    return { description };
+}
 //# sourceMappingURL=payload-validation.js.map

package/dist/server-shell/http/routes/project-api/schemas.d.ts

@@ -440,6 +440,10 @@ export declare const WorkspaceResponseSchema: {
                     readonly type: "string";
                     readonly minLength: 1;
                 };
+                readonly description: {
+                    readonly type: "string";
+                    readonly maxLength: 160;
+                };
                 readonly identity_source: {
                     readonly type: "string";
                     readonly enum: readonly ["git_config"];
@@ -613,6 +617,10 @@ export declare const BootstrapResponseSchema: {
                             readonly type: "string";
                             readonly minLength: 1;
                         };
+                        readonly description: {
+                            readonly type: "string";
+                            readonly maxLength: 160;
+                        };
                         readonly identity_source: {
                             readonly type: "string";
                             readonly enum: readonly ["git_config"];

package/dist/server-shell/http/routes/project-api/schemas.js

@@ -231,6 +231,7 @@ export const WorkspaceResponseSchema = {
             properties: {
                 project_id: ProjectIdSchema,
                 display_name: { type: "string", minLength: 1 },
+                description: { type: "string", maxLength: 160 },
                 identity_source: { type: "string", enum: ["git_config"] },
             },
         },

package/dist/server-shell/http/routes/project-api/skills-helpers.d.ts

@@ -2,6 +2,7 @@ import type { QueryInvalidationHint } from "@tutti/shared/schemas/api";
 import type { HostProjectApiRouteOptions } from "./types.js";
 export declare function skillsChangedInvalidates(): QueryInvalidationHint[];
 export declare function requireTuttiHome(options: HostProjectApiRouteOptions): string;
+export declare function requireProjectUserSkillsRoot(options: HostProjectApiRouteOptions): string;
 export declare function withAsyncSkillServiceErrorMapping<T>(fn: () => Promise<T>): Promise<T>;
 export declare function withSkillServiceErrorMapping<T>(fn: () => T): T;
 //# sourceMappingURL=skills-helpers.d.ts.map

package/dist/server-shell/http/routes/project-api/skills-helpers.js

@@ -1,4 +1,4 @@
-import { SkillServiceError } from "../../../../skills/index.js";
+import { getProjectUserSkillsRoot, SkillServiceError } from "../../../../skills/index.js";
 import { HostProjectBadRequestError, HostProjectNotFoundError, HostProjectStoreUnavailableError, HostProjectValidationError, } from "./errors.js";
 export function skillsChangedInvalidates() {
     return [{ kind: "skills" }, { kind: "read_state" }, { kind: "bootstrap" }];
@@ -9,6 +9,9 @@ export function requireTuttiHome(options) {
     }
     return options.tuttiHome;
 }
+export function requireProjectUserSkillsRoot(options) {
+    return getProjectUserSkillsRoot(requireTuttiHome(options), options.project.project_id);
+}
 function toHostProjectSkillError(error) {
     switch (error.code) {
         case "invalid_skill_name":