@lmctl-ai/lmctl 0.2.37 → 0.2.38

package/dist/providers/config/init-config.d.ts

@@ -1,3 +1,4 @@
+export { loadInitFile, parseInitDocument, resolveInitFilePath, InitFileError } from './init-file.js';
 export interface InitProviderSlot {
     provider: string;
     model1: string;
@@ -33,10 +34,25 @@ export declare function buildInitConfig(detectedProviders: string[]): InitConfig
 export declare function detectPresentProviders(): string[];
 export declare function renderInitConfig(config: InitConfig): string;
 export declare function parseInitConfigText(raw: string): InitConfig | null;
-/** Reads the init config, or null if it doesn't exist / doesn't parse into
- * all three complete slots. Never throws. */
 export declare function readInitConfig(filePath?: string): InitConfig | null;
 export declare function writeInitConfig(config: InitConfig, filePath?: string): void;
+export interface InitMergeChange {
+    section: string;
+    key: string;
+    oldValue: string;
+    newValue: string;
+    line: number;
+}
+export type InitMergeResult = {
+    ok: true;
+    text: string;
+    changes: InitMergeChange[];
+} | {
+    ok: false;
+    error: string;
+    line?: number;
+};
+export declare function mergeInitConfigText(raw: string, config: InitConfig): InitMergeResult;
 /** Substitutes ${Provider1..3} and ${Model1..3} in template text from a
  * resolved InitConfig. Unknown placeholders are left untouched (quickrun
  * surfaces them separately so a lint failure names the real cause). */

package/dist/providers/config/init-edit.d.ts

@@ -0,0 +1,3 @@
+import type { InitConfig, InitMergeResult } from './init-config.js';
+export declare function encodeInitString(value: string): string;
+export declare function mergeValidatedInitText(raw: string, config: InitConfig): InitMergeResult;

package/dist/providers/config/init-file.d.ts

@@ -0,0 +1,20 @@
+import { type TomlTable } from 'smol-toml';
+import type { InitConfig } from './init-config.js';
+export declare const INIT_SECTIONS: readonly ["Provider1", "Provider2", "Provider3"];
+export declare const INIT_KEYS: readonly ["provider", "model1", "model2", "model3"];
+export interface InitSnapshot {
+    raw: string;
+    document: TomlTable;
+    config: InitConfig;
+    path: string;
+}
+export declare function resolveInitFilePath(env?: NodeJS.ProcessEnv, explicit?: string): string;
+export declare class InitFileError extends Error {
+    readonly path: string;
+    readonly kind: 'missing' | 'read' | 'syntax' | 'schema';
+    readonly line: number;
+    readonly column: number;
+    constructor(path: string, kind: 'missing' | 'read' | 'syntax' | 'schema', problem: string, line?: number, column?: number);
+}
+export declare function parseInitDocument(raw: string, path?: string): InitSnapshot;
+export declare function loadInitFile(path?: string): InitSnapshot;

package/dist/providers/config/init-write.d.ts

@@ -0,0 +1,2 @@
+/** Same-directory replace; validate first, retain original backup, refuse stale snapshots. */
+export declare function replaceInitFile(path: string, text: string, original: string | null): void;

package/dist/script/adapter.d.ts

@@ -1,3 +1,4 @@
+import { type ScriptEnvironmentOptions } from './init-environment.js';
 import { LMScript, type FunctionDoc, type ScriptModule } from './lmscript.js';
 import { type ResolvedMember } from '../cli/target-resolver.js';
 import type { BundleSession } from '../providers/bundle.js';
@@ -97,8 +98,10 @@ export declare function registerLmctlModule(engine: LMScript, io: CliIo, registr
 /**
  * Creates and configures an LMScript engine instance pre-wired with the lmctl module.
  */
-export declare function createLmScriptEngine(io: CliIo, scriptArgs?: string[], registry?: ResourceRegistry, env?: NodeJS.ProcessEnv): LMScript;
+export declare function createLmScriptEngine(io: CliIo, scriptArgs?: string[], registry?: ResourceRegistry, env?: NodeJS.ProcessEnv, options?: ScriptEnvironmentOptions): LMScript;
+/** Documentation discovery composes functions without starting a profile-backed runtime. */
+export declare function createLmScriptDocumentationEngine(io: CliIo, scriptArgs?: string[], registry?: ResourceRegistry, env?: NodeJS.ProcessEnv): LMScript;
 /**
  * Executes an LMScript script source with full lifecycle and signal guarantees.
  */
-export declare function runScriptEngine(source: string, scriptArgs: string[], io?: CliIo, env?: NodeJS.ProcessEnv, scriptFile?: string, globals?: Record<string, unknown>): Promise<number>;
+export declare function runScriptEngine(source: string, scriptArgs: string[], io?: CliIo, env?: NodeJS.ProcessEnv, scriptFile?: string, globals?: Record<string, unknown>, options?: ScriptEnvironmentOptions): Promise<number>;

package/dist/script/init-environment.d.ts

@@ -0,0 +1,8 @@
+import { type CliIo } from '../cli/common.js';
+export interface ScriptEnvironmentOptions {
+    initConfigPath?: string;
+}
+export declare const SCRIPT_ENVIRONMENT_HINT = "Environment names (Provider1..3, Model1..3, Directory, NonInteractive) are supplied by ~/.lmctl/init.toml via lmctl init.";
+export declare function scriptDiagnosticMessage(message: string): string;
+/** Read one profile snapshot and initialize runtime and checker bindings together. */
+export declare function buildScriptEnvironment(io: CliIo, env: NodeJS.ProcessEnv, options?: ScriptEnvironmentOptions): Record<string, string | boolean>;

package/dist/script/lmscript.d.ts

@@ -97,15 +97,28 @@ export declare function promptHumanSync(question?: any): string | null;
 export declare function promptHumanAsync(question?: any, inStream?: any, outStream?: any): Promise<string | null>;
 export declare function parseCsv(text: string, hasHeader?: boolean, delimiter?: string): any[];
 export declare function stringifyCsv(data: any[], delimiter?: string): string;
-export type TokenType = "FN" | "LET" | "IF" | "ELSE" | "WHILE" | "FOR" | "RETURN" | "BREAK" | "CONTINUE" | "TRUE" | "FALSE" | "NULL" | "PARALLEL" | "SYNC" | "IMPORT" | "IDENTIFIER" | "NUMBER" | "STRING" | "PLUS" | "MINUS" | "STAR" | "SLASH" | "PERCENT" | "ASSIGN" | "EQUAL" | "NOT_EQUAL" | "LESS" | "LESS_EQUAL" | "GREATER" | "GREATER_EQUAL" | "AND" | "OR" | "NOT" | "DOT" | "COLON" | "LPAREN" | "RPAREN" | "LBRACE" | "RBRACE" | "LBRACKET" | "RBRACKET" | "COMMA" | "SEMICOLON" | "EOF";
+export type TokenType = "FN" | "LET" | "IF" | "ELSE" | "WHILE" | "FOR" | "RETURN" | "BREAK" | "CONTINUE" | "TRUE" | "FALSE" | "NULL" | "PARALLEL" | "SYNC" | "IMPORT" | "IDENTIFIER" | "NUMBER" | "STRING" | "FSTRING_START" | "FSTRING_TEXT" | "FSTRING_FIELD_START" | "FSTRING_FIELD_END" | "FSTRING_END" | "PLUS" | "MINUS" | "STAR" | "SLASH" | "PERCENT" | "ASSIGN" | "EQUAL" | "NOT_EQUAL" | "LESS" | "LESS_EQUAL" | "GREATER" | "GREATER_EQUAL" | "AND" | "OR" | "NOT" | "DOT" | "COLON" | "LPAREN" | "RPAREN" | "LBRACE" | "RBRACE" | "LBRACKET" | "RBRACKET" | "COMMA" | "SEMICOLON" | "EOF";
 export interface Token {
     type: TokenType;
     value: string;
     literal?: any;
     line: number;
     column: number;
+    offset?: number;
+    endOffset?: number;
+    endLine?: number;
+    endColumn?: number;
+    stringLiteral?: {
+        prefix: string;
+        raw: boolean;
+        triple: boolean;
+        formatted: boolean;
+    };
 }
 export declare class Lexer {
+    readonly diagnostics: Diagnostic[];
+    private formattedDepth;
+    private readonly modes;
     private readonly source;
     private readonly length;
     private readonly file?;
@@ -114,6 +127,10 @@ export declare class Lexer {
     private column;
     constructor(source: string, file?: string);
     tokenize(): Token[];
+    private position;
+    private spannedToken;
+    private scanTokens;
+    private readNextToken;
     private peek;
     private peekNext;
     private advance;
@@ -124,7 +141,9 @@ export declare class Lexer {
     private skipWhitespaceAndComments;
     private readNumber;
     private readString;
-    private tryReadHeredoc;
+    private consumeStringNewline;
+    private readModernEscape;
+    private readModernString;
     private readIdentifier;
 }
 export type BinaryOp = "+" | "-" | "*" | "/" | "%" | "==" | "!=" | "<" | "<=" | ">" | ">=" | "&&" | "||";
@@ -134,7 +153,7 @@ export interface NodeBase {
     column: number;
     file?: string;
 }
-export type Expr = LiteralExpr | IdentifierExpr | AssignExpr | IndexAssignExpr | TupleAssignExpr | UnaryExpr | BinaryExpr | CallExpr | ArrayExpr | IndexExpr | GroupingExpr | TupleExpr | ObjectExpr | ParallelExpr;
+export type Expr = LiteralExpr | InterpolatedStringExpr | IdentifierExpr | AssignExpr | IndexAssignExpr | TupleAssignExpr | UnaryExpr | BinaryExpr | CallExpr | ArrayExpr | IndexExpr | GroupingExpr | TupleExpr | ObjectExpr | ParallelExpr;
 export interface ParallelExpr extends NodeBase {
     kind: "ParallelExpr";
     tasks: CallExpr[];
@@ -143,6 +162,15 @@ export interface LiteralExpr extends NodeBase {
     kind: "LiteralExpr";
     value: any;
 }
+export interface InterpolationField extends NodeBase {
+    expression: Expr;
+    offset?: number;
+    endOffset?: number;
+}
+export interface InterpolatedStringExpr extends NodeBase {
+    kind: "InterpolatedStringExpr";
+    parts: (string | InterpolationField)[];
+}
 export interface IdentifierExpr extends NodeBase {
     kind: "IdentifierExpr";
     name: string;
@@ -312,6 +340,8 @@ export declare class Parser {
     private parseUnary;
     private parseCallAndIndex;
     private parsePrimary;
+    private parseFormattedString;
+    private validateFieldExpression;
     private match;
     private check;
     private advance;
@@ -346,6 +376,7 @@ export type CompileOptions = CheckOptions;
 export declare function compileProgram(source: string, options?: CompileOptions): {
     program: Program;
     loadedFiles: string[];
+    diagnostics: Diagnostic[];
 };
 export interface FunctionSignature {
     name: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lmctl-ai/lmctl",
-  "version": "0.2.37",
+  "version": "0.2.38",
   "description": "A provider-agnostic control plane for teams of AI coding agents — across providers, with independent review and durable memory.",
   "type": "module",
   "homepage": "https://lmctl.com",
@@ -27,6 +27,7 @@
     "bin/",
     "package.json",
     "LICENSE",
+    "THIRD_PARTY_NOTICES.md",
     "README.md",
     "CHANGELOG.md",
     "examples/"