@levelcode/sdk 0.0.4 → 0.1.0

package/dist/common/src/util/string.d.ts

@@ -0,0 +1,82 @@
+export declare const truncateString: (str: string, maxLength: number) => string;
+export declare const truncateStringWithMessage: ({ str, maxLength, message, remove, }: {
+    str: string;
+    maxLength: number;
+    message?: string;
+    remove?: "END" | "START" | "MIDDLE";
+}) => string;
+/**
+ * Check if a character is a whitespace character according
+ * to the XML spec (space, carriage return, line feed or tab)
+ *
+ * @param character Character to check
+ * @return Whether the character is whitespace or not
+ */
+export declare const isWhitespace: (character: string) => boolean;
+export declare const replaceNonStandardPlaceholderComments: (content: string, replacement: string) => string;
+export declare const randBoolFromStr: (str: string) => boolean;
+export declare const pluralize: (count: number, word: string, { includeCount }?: {
+    includeCount?: boolean;
+}) => string;
+/**
+ * Safely replaces all occurrences of a search string with a replacement string,
+ * escaping special replacement patterns (like $) in the replacement string.
+ */
+export declare const capitalize: (str: string) => string;
+/**
+ * Converts a snake_case string to Title Case
+ * Example: "add_subgoal" -> "Add Subgoal"
+ */
+export declare const snakeToTitleCase: (str: string) => string;
+/**
+ * Ensures a URL has the appropriate protocol (http:// or https://)
+ * Uses http:// for localhost and local IPs, https:// for all other domains
+ */
+export declare const ensureUrlProtocol: (url: string) => string;
+export declare const safeReplace: (content: string, searchStr: string, replaceStr: string) => string;
+export declare const hasLazyEdit: (content: string) => boolean;
+/**
+ * Extracts a JSON field from a string, transforms it, and puts it back.
+ * Handles both array and object JSON values.
+ * @param content The string containing JSON-like content
+ * @param field The field name to find and transform
+ * @param transform Function to transform the parsed JSON value
+ * @param fallback String to use if parsing fails
+ * @returns The content string with the transformed JSON field
+ */
+export declare function transformJsonInString<T = unknown>(content: string, field: string, transform: (json: T) => unknown, fallback: string): string;
+/**
+ * Generates a compact unique identifier by combining timestamp bits with random bits.
+ * Uses 40 bits of timestamp (enough for ~34 years) and 24 random bits for exactly 64 total bits.
+ * Encodes in base64url for compact, URL-safe strings (~11 chars).
+ * @param prefix Optional prefix to add to the ID
+ * @returns A unique string ID
+ * @example
+ * generateCompactId()      // => "1a2b3c4d5e6"
+ * generateCompactId('msg-') // => "msg-1a2b3c4d5e6"
+ */
+export declare const generateCompactId: (prefix?: string) => string;
+/**
+ * Removes null characters from a string
+ */
+export declare const stripNullChars: (str: string) => string;
+export declare function stripColors(str: string): string;
+export declare function stripAnsi(str: string): string;
+export declare function includesMatch(array: (string | RegExp)[], value: string): boolean;
+/**
+ * Finds the longest substring that is **both** a suffix of `source`
+ * **and** a prefix of `next`.
+ * Useful when concatenating strings while avoiding duplicate overlap.
+ *
+ * @example
+ * ```ts
+ * suffixPrefixOverlap('foobar', 'barbaz'); // ➜ 'bar'
+ * suffixPrefixOverlap('abc', 'def');       // ➜ ''
+ * ```
+ *
+ * @param source  The string whose **suffix** is inspected.
+ * @param next    The string whose **prefix** is inspected.
+ * @returns       The longest overlapping edge, or an empty string if none exists.
+ */
+export declare function suffixPrefixOverlap(source: string, next: string): string;
+export declare const escapeString: (str: string) => string;

package/dist/common/src/util/xml.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Generate a closing XML tag for a single tool name
+ * @param toolName Single tool name to generate closing tag for
+ * @returns Closing XML tag string
+ */
+export declare function closeXml(toolName: string): string;
+/**
+ * Generate stop sequences (closing XML tags) for a list of tool names
+ * @param toolNames Array of tool names to generate closing tags for
+ * @returns Array of closing XML tag strings
+ */
+export declare function getStopSequences(toolNames: readonly string[]): string[];

package/dist/common/src/util/zod-schema.d.ts

@@ -0,0 +1,5 @@
+import z from 'zod/v4';
+/**
+ * Convert a Zod4 schema to JSON string representation.
+ */
+export declare function schemaToJsonStr(schema: z.ZodTypeAny | undefined | Record<string, any>, options?: Parameters<typeof z.toJSONSchema>[1]): string;

package/dist/common/src/utils/team-fs.d.ts

@@ -0,0 +1,17 @@
+import type { TeamConfig, TeamMember, TeamTask } from '../types/team-config';
+import type { TeamProtocolMessage } from '../types/team-protocol';
+export declare function getTeamsDir(): string;
+export declare function getTasksDir(teamName: string): string;
+export declare function createTeam(config: TeamConfig): void;
+export declare function loadTeamConfig(teamName: string): TeamConfig | null;
+export declare function saveTeamConfig(teamName: string, config: TeamConfig): void;
+export declare function deleteTeam(teamName: string): void;
+export declare function addTeamMember(teamName: string, member: TeamMember): void;
+export declare function removeTeamMember(teamName: string, agentId: string): void;
+export declare function createTask(teamName: string, task: TeamTask): void;
+export declare function updateTask(teamName: string, taskId: string, updates: Partial<TeamTask>): void;
+export declare function listTasks(teamName: string): TeamTask[];
+export declare function getTask(teamName: string, taskId: string): TeamTask | null;
+export declare function sendMessage(teamName: string, to: string, message: TeamProtocolMessage): void;
+export declare function readInbox(teamName: string, agentName: string): TeamProtocolMessage[];
+export declare function clearInbox(teamName: string, agentName: string): void;