@xfey/tutti 0.1.14 → 0.1.16

package/dist/collaboration-state/index.d.ts

@@ -1,7 +1,7 @@
 export { CollaborationStateCursorError } from "./serialization.js";
 export { createIdleExecutionStatusProjection } from "./execution-status.js";
 export { createMainChatAgentMessage, createMainChatMessage, createMainChatSystemMessage, hasMainChatWorklistFeedbackMessage, readCompletedWorklistFeedbackTaskIds, readMessageProjectionById, readMainChatMessageWindow, readMainChatMessagesAfter, readMainChatMessagesAfterCursor, readMainChatMessagesBeforeCursor, } from "./messages.js";
-export { clearScratchpadProjection, createEmptyScratchpadProjection, readScratchpadProjection, upsertScratchpadProjection, } from "./scratchpad.js";
+export { createEmptyScratchpadProjection, readScratchpadProjection, submitScratchpadProjection, upsertScratchpadProjection, } from "./scratchpad.js";
 export { advanceScratchpadTaskCompileSourceCursor, markScratchpadRefreshFailed, markScratchpadRefreshStarted, markScratchpadRefreshSucceeded, markScratchpadSourceDirty, readScratchpadSourceState, } from "./scratchpad-source-state.js";
 export { deleteStaleClarificationSubmitReplayHints, readActiveClarificationProjection, readClarificationRoundProjection, readClarificationRoundsForThread, readClarificationThreadResponse, readSealedClarificationRoundsWithoutSuccessor, readSubmittedTaskCompileClarificationRounds, readSubmittedTaskCompileClarificationRoundsAfterCursor, } from "./clarification-records.js";
 export { createClarificationRoundAgentMessage, createClarificationRoundMessage, readClarificationRoundMessagesWindow, } from "./clarification-messages.js";
@@ -13,5 +13,5 @@ export { recoverStaleRunningTasksAsFailed } from "./recovery.js";
 export { markReadStateScope, readReadStateSummary, recordReadNotificationEvent, } from "./read-state.js";
 export { readTaskDetailProjection } from "./task-details.js";
 export { applyTaskCompileProposal, markTaskRunStarted, readNextRunnableTask, readRecoverableScheduledRun, readTaskProjection, readWorklistProjection, } from "./worklist.js";
-export type { ApplyTaskCompileProposalResult, CloseTaskBoundClarificationRetaskingRequiredInput, CloseTaskBoundClarificationRetaskingRequiredResult, CreateClarificationRoundAgentMessageInput, CreateClarificationRoundMessageInput, CreateMainChatAgentMessageInput, CreateMainChatMessageInput, CreateMainChatSystemMessageInput, CursorPageOptions, MarkReadStateScopeInput, MarkReadStateScopeResult, MarkTaskRunStartedInput, MarkTaskRunStartedResult, MaterializeClarificationSuccessorInput, MaterializeTaskBoundRunSuccessorInput, MaterializeTaskBoundRunSuccessorResult, MessageAuthorInput, NextRunnableTaskResult, OpenNextTaskBoundClarificationRoundInput, OpenNextTaskBoundClarificationRoundResult, OpenNextTaskCompileClarificationRoundInput, OpenNextTaskCompileClarificationRoundResult, OpenTaskCompileClarificationRoundInput, OpenTaskCompileClarificationRoundResult, ReadMainChatMessagesAfterOptions, ReadMessageWindowOptions, ReadReadStateSummaryInput, RecoverStaleRunningTasksResult, RecoverableScheduledRun, RecordReadNotificationEventInput, RecordRecoverySummaryInput, RecordRecoverySummaryResult, RecordRunNeedsHumanResultInput, RecordRunNeedsHumanResultResult, RecordRunResultInput, RecordRunResultResult, RunResultPromotionProjection, ScratchpadSnapshotInput, SealedClarificationRoundWithoutSuccessor, SubmitClarificationRoundInput, TaskCompileProposalInput, TaskCompileProposalModuleInput, TaskCompileProposalTaskInput, } from "./types.js";
+export type { ApplyTaskCompileProposalResult, CloseTaskBoundClarificationRetaskingRequiredInput, CloseTaskBoundClarificationRetaskingRequiredResult, CreateClarificationRoundAgentMessageInput, CreateClarificationRoundMessageInput, CreateMainChatAgentMessageInput, CreateMainChatMessageInput, CreateMainChatSystemMessageInput, CursorPageOptions, MarkReadStateScopeInput, MarkReadStateScopeResult, MarkTaskRunStartedInput, MarkTaskRunStartedResult, MaterializeClarificationSuccessorInput, MaterializeTaskBoundRunSuccessorInput, MaterializeTaskBoundRunSuccessorResult, MessageAuthorInput, NextRunnableTaskResult, OpenNextTaskBoundClarificationRoundInput, OpenNextTaskBoundClarificationRoundResult, OpenNextTaskCompileClarificationRoundInput, OpenNextTaskCompileClarificationRoundResult, OpenTaskCompileClarificationRoundInput, OpenTaskCompileClarificationRoundResult, ReadMainChatMessagesAfterOptions, ReadMessageWindowOptions, ReadReadStateSummaryInput, RecoverStaleRunningTasksResult, RecoverableScheduledRun, RecordReadNotificationEventInput, RecordRecoverySummaryInput, RecordRecoverySummaryResult, RecordRunNeedsHumanResultInput, RecordRunNeedsHumanResultResult, RecordRunResultInput, RecordRunResultResult, RunResultPromotionProjection, ScratchpadSnapshotInput, SubmitScratchpadInput, SubmitScratchpadResult, SealedClarificationRoundWithoutSuccessor, SubmitClarificationRoundInput, TaskCompileProposalInput, TaskCompileProposalModuleInput, TaskCompileProposalTaskInput, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/collaboration-state/index.js

@@ -1,7 +1,7 @@
 export { CollaborationStateCursorError } from "./serialization.js";
 export { createIdleExecutionStatusProjection } from "./execution-status.js";
 export { createMainChatAgentMessage, createMainChatMessage, createMainChatSystemMessage, hasMainChatWorklistFeedbackMessage, readCompletedWorklistFeedbackTaskIds, readMessageProjectionById, readMainChatMessageWindow, readMainChatMessagesAfter, readMainChatMessagesAfterCursor, readMainChatMessagesBeforeCursor, } from "./messages.js";
-export { clearScratchpadProjection, createEmptyScratchpadProjection, readScratchpadProjection, upsertScratchpadProjection, } from "./scratchpad.js";
+export { createEmptyScratchpadProjection, readScratchpadProjection, submitScratchpadProjection, upsertScratchpadProjection, } from "./scratchpad.js";
 export { advanceScratchpadTaskCompileSourceCursor, markScratchpadRefreshFailed, markScratchpadRefreshStarted, markScratchpadRefreshSucceeded, markScratchpadSourceDirty, readScratchpadSourceState, } from "./scratchpad-source-state.js";
 export { deleteStaleClarificationSubmitReplayHints, readActiveClarificationProjection, readClarificationRoundProjection, readClarificationRoundsForThread, readClarificationThreadResponse, readSealedClarificationRoundsWithoutSuccessor, readSubmittedTaskCompileClarificationRounds, readSubmittedTaskCompileClarificationRoundsAfterCursor, } from "./clarification-records.js";
 export { createClarificationRoundAgentMessage, createClarificationRoundMessage, readClarificationRoundMessagesWindow, } from "./clarification-messages.js";

package/dist/collaboration-state/scratchpad.d.ts

@@ -1,8 +1,8 @@
 import type { ScratchpadProjection } from "@tutti/shared/schemas/api";
 import type { SqliteDatabase } from "../store/index.js";
-import type { ScratchpadSnapshotInput } from "./types.js";
+import type { ScratchpadSnapshotInput, SubmitScratchpadInput } from "./types.js";
 export declare function createEmptyScratchpadProjection(): ScratchpadProjection;
 export declare function upsertScratchpadProjection(db: SqliteDatabase, input: ScratchpadSnapshotInput): ScratchpadProjection;
-export declare function clearScratchpadProjection(db: SqliteDatabase): ScratchpadProjection;
+export declare function submitScratchpadProjection(db: SqliteDatabase, input: SubmitScratchpadInput): ScratchpadProjection;
 export declare function readScratchpadProjection(db: SqliteDatabase): ScratchpadProjection;
 //# sourceMappingURL=scratchpad.d.ts.map

package/dist/collaboration-state/scratchpad.js

@@ -1,4 +1,5 @@
 import { nowIso, parseJson, stringifyJson } from "./serialization.js";
+const SCRATCHPAD_RECEIPT_LIMIT = 100;
 export function createEmptyScratchpadProjection() {
     return {
         id: "current",
@@ -8,8 +9,37 @@ export function createEmptyScratchpadProjection() {
         current_consensus: [],
         open_questions: [],
         task_changes: [],
+        receipts: [],
     };
 }
+function readScratchpadReceipts(db) {
+    const rows = db
+        .prepare(`
+        SELECT
+          workflow_ref,
+          activity_ref,
+          topic,
+          background_summary,
+          current_consensus_json,
+          open_questions_json,
+          task_changes_json,
+          submitted_at
+        FROM scratchpad_receipts
+        ORDER BY submitted_at DESC, workflow_ref DESC
+        LIMIT ${SCRATCHPAD_RECEIPT_LIMIT}
+      `)
+        .all();
+    return rows.map((row) => ({
+        workflow_ref: row.workflow_ref,
+        activity_ref: row.activity_ref,
+        topic: row.topic,
+        background_summary: row.background_summary,
+        current_consensus: parseJson(row.current_consensus_json, []),
+        open_questions: parseJson(row.open_questions_json, []),
+        task_changes: parseJson(row.task_changes_json, []),
+        submitted_at: row.submitted_at,
+    }));
+}
 export function upsertScratchpadProjection(db, input) {
     const updatedAt = nowIso(input.now);
     db.prepare(`
@@ -34,51 +64,108 @@ export function upsertScratchpadProjection(db, input) {
         ?
       )
       ON CONFLICT(id) DO UPDATE SET
+        state = 'ready',
         topic = excluded.topic,
         background_summary = excluded.background_summary,
         current_consensus_json = excluded.current_consensus_json,
         open_questions_json = excluded.open_questions_json,
         task_changes_json = excluded.task_changes_json,
         updated_by_activity_ref = excluded.updated_by_activity_ref,
-        updated_at = excluded.updated_at
+        updated_at = excluded.updated_at,
+        submitted_by_activity_ref = NULL,
+        submitted_by_workflow_ref = NULL,
+        submitted_at = NULL
     `).run(input.topic, input.background_summary, stringifyJson(input.current_consensus), stringifyJson(input.open_questions), stringifyJson(input.task_changes), input.updated_by_activity_ref ?? null, updatedAt);
     return readScratchpadProjection(db);
 }
-export function clearScratchpadProjection(db) {
-    db.prepare("DELETE FROM scratchpad WHERE id = 'current'").run();
-    return createEmptyScratchpadProjection();
+export function submitScratchpadProjection(db, input) {
+    const submittedAt = nowIso(input.now);
+    const scratchpad = readScratchpadProjection(db);
+    if (scratchpad.state === "empty") {
+        return scratchpad;
+    }
+    db.prepare(`
+      INSERT INTO scratchpad_receipts (
+        workflow_ref,
+        activity_ref,
+        topic,
+        background_summary,
+        current_consensus_json,
+        open_questions_json,
+        task_changes_json,
+        submitted_at
+      )
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+      ON CONFLICT(workflow_ref) DO UPDATE SET
+        activity_ref = excluded.activity_ref,
+        topic = excluded.topic,
+        background_summary = excluded.background_summary,
+        current_consensus_json = excluded.current_consensus_json,
+        open_questions_json = excluded.open_questions_json,
+        task_changes_json = excluded.task_changes_json,
+        submitted_at = excluded.submitted_at
+    `).run(input.workflow_ref, input.activity_ref, scratchpad.topic, scratchpad.background_summary, stringifyJson(scratchpad.current_consensus), stringifyJson(scratchpad.open_questions), stringifyJson(scratchpad.task_changes), submittedAt);
+    db.prepare(`
+      UPDATE scratchpad
+      SET
+        state = 'submitted',
+        submitted_by_activity_ref = ?,
+        submitted_by_workflow_ref = ?,
+        submitted_at = ?,
+        updated_at = ?
+      WHERE id = 'current'
+    `).run(input.activity_ref, input.workflow_ref, submittedAt, submittedAt);
+    return readScratchpadProjection(db);
 }
 export function readScratchpadProjection(db) {
+    const receipts = readScratchpadReceipts(db);
     const row = db
         .prepare(`
         SELECT
+          state,
           topic,
           background_summary,
           current_consensus_json,
           open_questions_json,
           task_changes_json,
           updated_by_activity_ref,
-          updated_at
+          updated_at,
+          submitted_by_activity_ref,
+          submitted_by_workflow_ref,
+          submitted_at
         FROM scratchpad
         WHERE id = 'current'
       `)
         .get();
     if (row === undefined) {
-        return createEmptyScratchpadProjection();
+        return {
+            ...createEmptyScratchpadProjection(),
+            receipts,
+        };
     }
     const scratchpad = {
         id: "current",
-        state: "ready",
+        state: row.state,
         topic: row.topic,
         background_summary: row.background_summary,
         current_consensus: parseJson(row.current_consensus_json, []),
         open_questions: parseJson(row.open_questions_json, []),
         task_changes: parseJson(row.task_changes_json, []),
         updated_at: row.updated_at,
+        receipts,
     };
     if (row.updated_by_activity_ref !== null) {
         scratchpad.updated_by_activity_ref = row.updated_by_activity_ref;
     }
+    if (row.submitted_by_activity_ref !== null) {
+        scratchpad.submitted_by_activity_ref = row.submitted_by_activity_ref;
+    }
+    if (row.submitted_by_workflow_ref !== null) {
+        scratchpad.submitted_by_workflow_ref = row.submitted_by_workflow_ref;
+    }
+    if (row.submitted_at !== null) {
+        scratchpad.submitted_at = row.submitted_at;
+    }
     return scratchpad;
 }
 //# sourceMappingURL=scratchpad.js.map

package/dist/collaboration-state/storage-types.d.ts

@@ -13,6 +13,7 @@ export type MessageRow = {
     created_at: string;
 };
 export type ScratchpadRow = {
+    state: "ready" | "submitted";
     topic: string;
     background_summary: string;
     current_consensus_json: string;
@@ -20,6 +21,19 @@ export type ScratchpadRow = {
     task_changes_json: string;
     updated_by_activity_ref: string | null;
     updated_at: string;
+    submitted_by_activity_ref: string | null;
+    submitted_by_workflow_ref: string | null;
+    submitted_at: string | null;
+};
+export type ScratchpadReceiptRow = {
+    workflow_ref: string;
+    activity_ref: string;
+    topic: string;
+    background_summary: string;
+    current_consensus_json: string;
+    open_questions_json: string;
+    task_changes_json: string;
+    submitted_at: string;
 };
 export type ScratchpadSourceStateRow = {
     main_chat_cursor_created_at: string | null;

package/dist/collaboration-state/types.d.ts

@@ -1,7 +1,7 @@
 import type { RunLineage } from "@tutti/shared/domain";
 import type { AccountAvatarProjection } from "@tutti/shared/domain";
 import type { ActivityRef, ClarificationRoundRef, TaskId, TaskModuleId, WorkflowInvocationRef } from "@tutti/shared/ids";
-import type { ClarificationRequestPayload, ClarificationRoundProjection, ClarificationSuccessorRef, ClarificationThreadProjection, MessageProjection, ReadStateScope, ReadStateSummaryProjection, RecoverySummaryProjection, RunResultProjection, TaskContractProjection, TaskDetailProjection, TaskDetailResultProjection, TaskProjection, WorklistProjection } from "@tutti/shared/schemas/api";
+import type { ClarificationRequestPayload, ClarificationRoundProjection, ClarificationSuccessorRef, ClarificationThreadProjection, MessageProjection, ReadStateScope, ReadStateSummaryProjection, RecoverySummaryProjection, RunResultProjection, ScratchpadProjection, TaskContractProjection, TaskDetailProjection, TaskDetailResultProjection, TaskProjection, WorklistProjection } from "@tutti/shared/schemas/api";
 export type MessageAuthorInput = {
     kind: "human" | "system" | "agent";
     ref?: string;
@@ -56,6 +56,14 @@ export type ScratchpadSnapshotInput = {
     updated_by_activity_ref?: ActivityRef;
     now?: () => Date;
 };
+export type SubmitScratchpadInput = {
+    workflow_ref: WorkflowInvocationRef;
+    activity_ref: ActivityRef;
+    now?: () => Date;
+};
+export type SubmitScratchpadResult = {
+    scratchpad: ScratchpadProjection;
+};
 export type TaskCompileProposalInput = {
     workflow_ref: WorkflowInvocationRef;
     proposal: {

package/dist/control-plane/task-compile-output.js

@@ -1,4 +1,4 @@
-import { applyTaskCompileProposal, clearScratchpadProjection, openNextTaskCompileClarificationRound, openTaskCompileClarificationRound, readWorklistProjection, } from "../collaboration-state/index.js";
+import { applyTaskCompileProposal, openNextTaskCompileClarificationRound, openTaskCompileClarificationRound, readWorklistProjection, submitScratchpadProjection, } from "../collaboration-state/index.js";
 import { clarificationInvalidates, taskCompileInvalidates, } from "./invalidations.js";
 import { normalizeTaskCompileProposal } from "./task-proposal.js";
 const EMPTY_INITIAL_WORKLIST_CLARIFICATION = {
@@ -86,7 +86,11 @@ export function applyTaskCompileProcedureOutput(input) {
     if (applied.changed_task_ids.length > 0) {
         input.onTasksAdded?.();
     }
-    const clearedScratchpad = clearScratchpadProjection(input.store.db);
+    const submittedScratchpad = submitScratchpadProjection(input.store.db, {
+        workflow_ref: input.workflowRef,
+        activity_ref: input.activityRef,
+        now: input.now,
+    });
     input.events.publish({
         event_type: "worklist.changed",
         payload: {
@@ -101,7 +105,7 @@ export function applyTaskCompileProcedureOutput(input) {
     input.events.publish({
         event_type: "scratchpad.updated",
         payload: {
-            scratchpad: clearedScratchpad,
+            scratchpad: submittedScratchpad,
             activity_ref: input.activityRef,
         },
         invalidates: taskCompileInvalidates(),

package/dist/control-plane/task-compile-start.js

@@ -51,7 +51,7 @@ export function startControlPlaneTaskCompile(options) {
             sourceBatch,
         });
     }
-    if (scratchpad.state === "empty") {
+    if (scratchpad.state !== "ready") {
         return { disposition: { kind: "scratchpad_empty" } };
     }
     if (shouldInitializeProjectContext) {

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/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;