Function createCtxNoteTool

packages/pi-plugin/src/tools/ctx-note.ts:181–340

(
	deps: CtxNoteToolDeps,
)

}

export function createCtxNoteTool(
	deps: CtxNoteToolDeps,
): ToolDefinition<typeof ParamsSchema> {
	return {
		name: "ctx_note",
		label: "Magic Context: Notes",
		description: CTX_NOTE_DESCRIPTION,
		parameters: ParamsSchema,
		async execute(_toolCallId, params: CtxNoteParams, _signal, _onUpdate, ctx) {
			const sessionId = ctx.sessionManager.getSessionId();
			// Infer write only on NON-EMPTY content. GPT-family models fill every
			// optional param (content:"" for a read), so a bare `typeof === "string"`
			// check would mis-infer `write` and then reject the empty content.
			const action =
				params.action ?? (params.content?.trim() ? "write" : "read");

			if (action === "write") {
				const content = params.content?.trim();
				if (!content)
					return err("Error: 'content' is required when action is 'write'.");

				// Anchor the note to the live conversation tail so it can be
				// traced back later via ctx_expand. Best-effort — null when
				// there's no indexed tail yet.
				const anchorOrdinal = captureAnchorOrdinal(deps.db, sessionId);

				const surfaceCondition = params.surface_condition?.trim();
				if (surfaceCondition) {
					if (deps.dreamerEnabled !== true) {
						return err(
							"Error: Smart notes require dreamer to be enabled. Enable dreamer in magic-context.jsonc to use surface_condition.",
						);
					}
					const projectIdentity = resolveProjectIdentity(ctx.cwd);
					if (!projectIdentity) {
						return err(
							"Error: Could not resolve project identity for smart note.",
						);
					}
					const note = addNote(deps.db, "smart", {
						content,
						projectPath: projectIdentity,
						surfaceCondition,
						anchorOrdinal,
					});
					return ok(
						`Created smart note #${note.id}. Dreamer will evaluate the condition during nightly runs:\n- Content: ${content}\n- Condition: ${surfaceCondition}`,
					);
				}

				const note = addNote(deps.db, "session", {
					sessionId,
					content,
					anchorOrdinal,
				});
				return ok(`Saved session note #${note.id}.`);
			}