@clinebot/core 0.0.11 → 0.0.13

package/src/tools/schemas.ts

@@ -7,6 +7,8 @@
 
 import { z } from "zod";
 
+export const INPUT_ARG_CHAR_LIMIT = 6000;
+
 /**
  * Schema for read tool input
  */
@@ -20,20 +22,24 @@ export const ReadFileLineRangeSchema = z
 			.number()
 			.int()
 			.positive()
+			.nullable()
 			.optional()
-			.describe("Optional one-based starting line number to read from"),
+			.describe(
+				"Optional one-based starting line number to read from; use null or omit for the start of the file",
+			),
 		end_line: z
 			.number()
 			.int()
 			.positive()
+			.nullable()
 			.optional()
-			.describe("Optional one-based ending line number to read through"),
+			.describe(
+				"Optional one-based ending line number to read through; use null or omit for the end of the file",
+			),
 	})
 	.refine(
 		({ start_line, end_line }) =>
-			start_line === undefined ||
-			end_line === undefined ||
-			start_line <= end_line,
+			start_line == null || end_line == null || start_line <= end_line,
 		{
 			message: "start_line must be less than or equal to end_line",
 			path: ["end_line"],
@@ -48,9 +54,7 @@ export const ReadFileRequestSchema = z
 	})
 	.refine(
 		({ start_line, end_line }) =>
-			start_line === undefined ||
-			end_line === undefined ||
-			start_line <= end_line,
+			start_line == null || end_line == null || start_line <= end_line,
 		{
 			message: "start_line must be less than or equal to end_line",
 			path: ["end_line"],
@@ -64,7 +68,7 @@ export const ReadFilesInputSchema = z.object({
 	files: z
 		.array(ReadFileRequestSchema)
 		.describe(
-			"Array of file read requests. Omit start_line and end_line to return the full file content; provide them to return only that inclusive one-based line range. Prefer this tool over running terminal command to get file content for better performance and reliability.",
+			"Array of file read requests. Omit start_line/end_line or set them to null to return the full file content boundaries; provide integers to return only that inclusive one-based line range. Prefer this tool over running terminal command to get file content for better performance and reliability.",
 		),
 });
 
@@ -103,9 +107,8 @@ export const SearchCodebaseUnionInputSchema = z.union([
 
 const CommandInputSchema = z
 	.string()
-	.max(2000)
 	.describe(
-		"The non-interactive shell command to execute - MUST keep input short and concise to avoid timeouts",
+		`The non-interactive shell command to execute - MUST keep input short and concise (within ${INPUT_ARG_CHAR_LIMIT * 2} characters) to avoid timeouts.`,
 	);
 /**
  * Schema for run_commands tool input
@@ -154,17 +157,15 @@ export const EditFileInputSchema = z
 			.describe("The absolute file path for the action to be performed on"),
 		old_text: z
 			.string()
-			.max(3000)
 			.nullable()
 			.optional()
 			.describe(
-				"Exact text to replace (must match exactly once). Omit this when creating a missing file or inserting via insert_line.",
+				`Exact text to replace (must match exactly once). Omit this when creating a missing file or inserting via insert_line. Keep this at or below ${INPUT_ARG_CHAR_LIMIT} characters when possible; larger payloads should be split across multiple tool calls to avoid timeouts.`,
 			),
 		new_text: z
 			.string()
-			.max(3000)
 			.describe(
-				"The new content to write when creating a missing file, the replacement text for edits, or the inserted text when insert_line is provided - IMPORTANT: keep this as small as possible to avoid timeouts. For large edits, use multiple calls with small chunks of new_text and precise old_text to iteratively edit the file.",
+				`The new content to write when creating a missing file, the replacement text for edits, or the inserted text when insert_line is provided. Keep this at or below ${INPUT_ARG_CHAR_LIMIT} characters when possible; for large edits, use multiple calls with small chunks of old_text and new_text to iteratively edit the file.`,
 			),
 		insert_line: z
 			.number()
@@ -176,18 +177,22 @@ export const EditFileInputSchema = z
 			),
 	})
 	.describe(
-		"Edit a text file by replacing old_text with new_text, create the file with new_text if it does not exist, or insert new_text at insert_line when insert_line is provided. IMPORTANT: large edits can time out, so use small chunks and multiple calls when possible.",
+		"Edit a text file by replacing old_text with new_text, create the file with new_text if it does not exist, or insert new_text at insert_line when insert_line is provided. Prefer using this tool for file edits over shell commands. IMPORTANT: large edits can time out, so use small chunks and multiple calls when possible.",
 	);
 
 /**
  * Schema for apply_patch tool input
  */
-export const ApplyPatchInputSchema = z.object({
-	input: z
-		.string()
-		.min(1)
-		.describe("The apply_patch text payload, including patch instructions"),
-});
+export const ApplyPatchInputSchema = z
+	.object({
+		input: z
+			.string()
+			.min(1)
+			.describe("The apply_patch text payload, including patch instructions"),
+	})
+	.describe(
+		"Modify or create a text file by applying patches. Prefer using this tool for file edits over shell commands. IMPORTANT: large patches can time out, so use small chunks and multiple calls when possible.",
+	);
 export const ApplyPatchInputUnionSchema = z.union([
 	ApplyPatchInputSchema,
 	z.string(),
@@ -197,12 +202,7 @@ export const ApplyPatchInputUnionSchema = z.union([
  * Schema for skills tool input
  */
 export const SkillsInputSchema = z.object({
-	skill: z
-		.string()
-		.min(1)
-		.describe(
-			'The skill name. E.g., "commit", "review-pr", "pdf", or "ms-office-suite:pdf"',
-		),
+	skill: z.string().min(1).describe("Name of the skill to execute."),
 	args: z
 		.string()
 		.nullable()

package/src/types/config.ts

@@ -76,4 +76,9 @@ export interface CoreSessionConfig
 		| Promise<ConsecutiveMistakeLimitDecision>
 		| ConsecutiveMistakeLimitDecision;
 	toolRoutingRules?: ToolRoutingRule[];
+	/**
+	 * Optional skill allowlist for the `skills` tool. When provided, only these
+	 * skills are surfaced in tool metadata and invocable by name.
+	 */
+	skills?: string[];
 }

package/src/types/events.ts

@@ -36,6 +36,24 @@ export interface SessionTeamProgressEvent {
 	summary: import("@clinebot/shared").TeamProgressSummary;
 }
 
+export interface SessionPendingPromptsEvent {
+	sessionId: string;
+	prompts: Array<{
+		id: string;
+		prompt: string;
+		delivery: "queue" | "steer";
+		attachmentCount: number;
+	}>;
+}
+
+export interface SessionPendingPromptSubmittedEvent {
+	sessionId: string;
+	id: string;
+	prompt: string;
+	delivery: "queue" | "steer";
+	attachmentCount: number;
+}
+
 export type CoreSessionEvent =
 	| { type: "chunk"; payload: SessionChunkEvent }
 	| {
@@ -46,6 +64,11 @@ export type CoreSessionEvent =
 			};
 	  }
 	| { type: "team_progress"; payload: SessionTeamProgressEvent }
+	| { type: "pending_prompts"; payload: SessionPendingPromptsEvent }
+	| {
+			type: "pending_prompt_submitted";
+			payload: SessionPendingPromptSubmittedEvent;
+	  }
 	| { type: "ended"; payload: SessionEndedEvent }
 	| { type: "hook"; payload: SessionToolEvent }
 	| { type: "status"; payload: { sessionId: string; status: string } };