thinkwell 0.4.5 → 0.5.0-alpha.2

package/dist/cli/workspace.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Workspace detection for `thinkwell check`.
+ *
+ * Detects pnpm workspaces (pnpm-workspace.yaml) and npm workspaces
+ * (package.json "workspaces"), enumerates member packages, and resolves
+ * package names with short-name fallback for scoped packages.
+ */
+/** A workspace member package with its metadata. */
+export interface WorkspaceMember {
+    /** Full package name from package.json (e.g., "@thinkwell/acp") */
+    name: string;
+    /** Absolute path to the package directory */
+    dir: string;
+    /** Whether the package has a tsconfig.json */
+    hasTsConfig: boolean;
+}
+/** A detected workspace with its members. */
+export interface Workspace {
+    /** Absolute path to the workspace root */
+    rootDir: string;
+    /** Workspace type that was detected */
+    type: "pnpm" | "npm";
+    /** All workspace member packages */
+    members: WorkspaceMember[];
+}
+/**
+ * Parse the `packages` array from a pnpm-workspace.yaml file.
+ *
+ * Handles the simple list format used by pnpm:
+ * ```yaml
+ * packages:
+ *   - "packages/*"
+ *   - "examples"
+ * ```
+ *
+ * This is intentionally minimal — it only extracts the `packages` array
+ * entries without pulling in a full YAML parser dependency.
+ */
+export declare function parsePnpmWorkspaceYaml(content: string): string[];
+/**
+ * Expand workspace glob patterns into concrete directory paths.
+ *
+ * Supports the common patterns used by pnpm and npm workspaces:
+ * - `packages/*` — all immediate subdirectories of `packages/`
+ * - `examples` — a single directory
+ * - `apps/**` — recursively find directories (not commonly used but supported)
+ *
+ * Only returns directories that actually exist.
+ */
+export declare function expandWorkspaceGlobs(rootDir: string, patterns: string[]): string[];
+/**
+ * Detect a workspace in the given directory.
+ *
+ * Detection priority: pnpm-workspace.yaml takes precedence over
+ * package.json "workspaces" (pnpm ignores the npm workspaces field).
+ *
+ * Returns undefined if no workspace is detected (single-package project).
+ */
+export declare function detectWorkspace(rootDir: string): Workspace | undefined;
+/** Result of resolving a package name. */
+export type ResolveResult = {
+    kind: "found";
+    member: WorkspaceMember;
+} | {
+    kind: "ambiguous";
+    name: string;
+    matches: WorkspaceMember[];
+} | {
+    kind: "not-found";
+    name: string;
+    available: string[];
+};
+/**
+ * Resolve a package name (full or short) against workspace members.
+ *
+ * Resolution order:
+ * 1. Exact match on full package name (e.g., "@thinkwell/acp")
+ * 2. Short-name fallback: match last segment of scoped names (e.g., "acp" → "@thinkwell/acp")
+ * 3. Ambiguity detection if short name matches multiple packages
+ */
+export declare function resolvePackageName(name: string, members: readonly WorkspaceMember[]): ResolveResult;
+//# sourceMappingURL=workspace.d.ts.map

package/dist/cli/workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/cli/workspace.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,oDAAoD;AACpD,MAAM,WAAW,eAAe;IAC9B,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,8CAA8C;IAC9C,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,6CAA6C;AAC7C,MAAM,WAAW,SAAS;IACxB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;IACrB,oCAAoC;IACpC,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CA6BhE;AAMD;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CA2ClF;AAgED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAyCtE;AAMD,0CAA0C;AAC1C,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,eAAe,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,eAAe,EAAE,CAAA;CAAE,GAC/D;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAE7D;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,SAAS,eAAe,EAAE,GAClC,aAAa,CA+Bf"}

package/dist/cli/workspace.js

@@ -0,0 +1,248 @@
+/**
+ * Workspace detection for `thinkwell check`.
+ *
+ * Detects pnpm workspaces (pnpm-workspace.yaml) and npm workspaces
+ * (package.json "workspaces"), enumerates member packages, and resolves
+ * package names with short-name fallback for scoped packages.
+ */
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { join, resolve } from "node:path";
+// ============================================================================
+// pnpm-workspace.yaml parsing
+// ============================================================================
+/**
+ * Parse the `packages` array from a pnpm-workspace.yaml file.
+ *
+ * Handles the simple list format used by pnpm:
+ * ```yaml
+ * packages:
+ *   - "packages/*"
+ *   - "examples"
+ * ```
+ *
+ * This is intentionally minimal — it only extracts the `packages` array
+ * entries without pulling in a full YAML parser dependency.
+ */
+export function parsePnpmWorkspaceYaml(content) {
+    const patterns = [];
+    const lines = content.split("\n");
+    let inPackages = false;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // Detect the start of the packages block
+        if (/^packages\s*:/.test(trimmed)) {
+            inPackages = true;
+            continue;
+        }
+        // A non-indented, non-empty line that isn't a list item ends the block
+        if (inPackages && trimmed.length > 0 && !trimmed.startsWith("-") && !line.startsWith(" ") && !line.startsWith("\t")) {
+            break;
+        }
+        if (inPackages && trimmed.startsWith("-")) {
+            // Strip leading "- ", then strip optional quotes
+            const value = trimmed.slice(1).trim().replace(/^["']|["']$/g, "");
+            if (value.length > 0) {
+                patterns.push(value);
+            }
+        }
+    }
+    return patterns;
+}
+// ============================================================================
+// Glob expansion
+// ============================================================================
+/**
+ * Expand workspace glob patterns into concrete directory paths.
+ *
+ * Supports the common patterns used by pnpm and npm workspaces:
+ * - `packages/*` — all immediate subdirectories of `packages/`
+ * - `examples` — a single directory
+ * - `apps/**` — recursively find directories (not commonly used but supported)
+ *
+ * Only returns directories that actually exist.
+ */
+export function expandWorkspaceGlobs(rootDir, patterns) {
+    const dirs = [];
+    for (const pattern of patterns) {
+        // Skip negation patterns (pnpm supports "!packages/internal")
+        if (pattern.startsWith("!"))
+            continue;
+        if (pattern.includes("*")) {
+            // Split at the first glob segment
+            const parts = pattern.split("/");
+            const globIndex = parts.findIndex((p) => p.includes("*"));
+            const prefix = parts.slice(0, globIndex).join("/");
+            const globPart = parts[globIndex];
+            const suffix = parts.slice(globIndex + 1).join("/");
+            const baseDir = resolve(rootDir, prefix);
+            if (!existsSync(baseDir))
+                continue;
+            if (globPart === "*") {
+                // Single-level wildcard: list immediate subdirectories
+                const entries = readdirSync(baseDir);
+                for (const entry of entries) {
+                    const fullPath = suffix
+                        ? resolve(baseDir, entry, suffix)
+                        : resolve(baseDir, entry);
+                    if (existsSync(fullPath) && isDirectory(fullPath)) {
+                        dirs.push(fullPath);
+                    }
+                }
+            }
+            else if (globPart === "**") {
+                // Recursive wildcard: find all directories recursively
+                collectDirectories(baseDir, suffix, dirs);
+            }
+        }
+        else {
+            // Literal path
+            const fullPath = resolve(rootDir, pattern);
+            if (existsSync(fullPath) && isDirectory(fullPath)) {
+                dirs.push(fullPath);
+            }
+        }
+    }
+    return dirs;
+}
+function isDirectory(path) {
+    try {
+        return statSync(path).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+function collectDirectories(baseDir, suffix, result) {
+    let entries;
+    try {
+        entries = readdirSync(baseDir);
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        if (entry.startsWith(".") || entry === "node_modules")
+            continue;
+        const fullPath = resolve(baseDir, entry);
+        if (!isDirectory(fullPath))
+            continue;
+        const candidate = suffix ? resolve(fullPath, suffix) : fullPath;
+        if (existsSync(candidate) && isDirectory(candidate)) {
+            result.push(candidate);
+        }
+        // Recurse
+        collectDirectories(fullPath, suffix, result);
+    }
+}
+// ============================================================================
+// Package metadata
+// ============================================================================
+/**
+ * Read workspace member metadata from a package directory.
+ * Returns undefined if the directory has no package.json or no "name" field.
+ */
+function readMember(dir) {
+    const pkgPath = join(dir, "package.json");
+    if (!existsSync(pkgPath))
+        return undefined;
+    try {
+        const content = readFileSync(pkgPath, "utf-8");
+        const pkg = JSON.parse(content);
+        if (!pkg.name || typeof pkg.name !== "string")
+            return undefined;
+        return {
+            name: pkg.name,
+            dir,
+            hasTsConfig: existsSync(join(dir, "tsconfig.json")),
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+// ============================================================================
+// Workspace detection
+// ============================================================================
+/**
+ * Detect a workspace in the given directory.
+ *
+ * Detection priority: pnpm-workspace.yaml takes precedence over
+ * package.json "workspaces" (pnpm ignores the npm workspaces field).
+ *
+ * Returns undefined if no workspace is detected (single-package project).
+ */
+export function detectWorkspace(rootDir) {
+    const absRoot = resolve(rootDir);
+    // Try pnpm workspace first
+    const pnpmPath = join(absRoot, "pnpm-workspace.yaml");
+    if (existsSync(pnpmPath)) {
+        const content = readFileSync(pnpmPath, "utf-8");
+        const patterns = parsePnpmWorkspaceYaml(content);
+        if (patterns.length > 0) {
+            const dirs = expandWorkspaceGlobs(absRoot, patterns);
+            const members = dirs
+                .map(readMember)
+                .filter((m) => m !== undefined);
+            return { rootDir: absRoot, type: "pnpm", members };
+        }
+    }
+    // Try npm workspaces
+    const pkgPath = join(absRoot, "package.json");
+    if (existsSync(pkgPath)) {
+        try {
+            const content = readFileSync(pkgPath, "utf-8");
+            const pkg = JSON.parse(content);
+            if (Array.isArray(pkg.workspaces)) {
+                const patterns = pkg.workspaces.filter((p) => typeof p === "string");
+                if (patterns.length > 0) {
+                    const dirs = expandWorkspaceGlobs(absRoot, patterns);
+                    const members = dirs
+                        .map(readMember)
+                        .filter((m) => m !== undefined);
+                    return { rootDir: absRoot, type: "npm", members };
+                }
+            }
+        }
+        catch {
+            // Invalid package.json — treat as no workspace
+        }
+    }
+    return undefined;
+}
+/**
+ * Resolve a package name (full or short) against workspace members.
+ *
+ * Resolution order:
+ * 1. Exact match on full package name (e.g., "@thinkwell/acp")
+ * 2. Short-name fallback: match last segment of scoped names (e.g., "acp" → "@thinkwell/acp")
+ * 3. Ambiguity detection if short name matches multiple packages
+ */
+export function resolvePackageName(name, members) {
+    // 1. Exact match
+    const exact = members.find((m) => m.name === name);
+    if (exact) {
+        return { kind: "found", member: exact };
+    }
+    // 2. Short-name fallback: match against the last segment of scoped names
+    //    e.g., "acp" matches "@thinkwell/acp", "@other/acp"
+    //    Also matches unscoped names exactly (e.g., "thinkwell" matches "thinkwell")
+    const shortMatches = members.filter((m) => {
+        const lastSegment = m.name.includes("/")
+            ? m.name.split("/").pop()
+            : m.name;
+        return lastSegment === name;
+    });
+    if (shortMatches.length === 1) {
+        return { kind: "found", member: shortMatches[0] };
+    }
+    if (shortMatches.length > 1) {
+        return { kind: "ambiguous", name, matches: shortMatches };
+    }
+    // 3. Not found
+    return {
+        kind: "not-found",
+        name,
+        available: members.map((m) => m.name),
+    };
+}
+//# sourceMappingURL=workspace.js.map

package/dist/cli/workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../../src/cli/workspace.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,8 +1,11 @@
-export { Agent } from "./agent.js";
-export type { ConnectOptions, SessionOptions } from "./agent.js";
+export { open } from "./agent.js";
+export type { Agent, AgentName, AgentOptions, CustomAgentOptions, SessionOptions } from "./agent.js";
 export { Session } from "./session.js";
 export { ThinkBuilder } from "./think-builder.js";
+export type { VirtualSkillDefinition } from "./think-builder.js";
+export { ThoughtStream } from "./thought-stream.js";
+export type { ThoughtEvent, ToolContent, ContentBlock, PlanEntry, ToolKind, } from "./thought-event.js";
 export { schemaOf } from "./schema.js";
 export type { JsonSchema, SchemaProvider, JsonValue, JsonObject } from "@thinkwell/acp";
-export * from "./connectors/index.js";
+export type { Skill, VirtualSkill, StoredSkill, SkillTool } from "@thinkwell/acp";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGvC,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAGxF,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAClC,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACrG,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAGjE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EACV,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,SAAS,EACT,QAAQ,GACT,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGvC,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACxF,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -1,10 +1,10 @@
 // New API
-export { Agent } from "./agent.js";
+export { open } from "./agent.js";
 export { Session } from "./session.js";
 // Think builder
 export { ThinkBuilder } from "./think-builder.js";
+// Thought streaming
+export { ThoughtStream } from "./thought-stream.js";
 // Schema helpers
 export { schemaOf } from "./schema.js";
-// Re-export connectors for convenient single-package import
-export * from "./connectors/index.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,gBAAgB;AAChB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,iBAAiB;AACjB,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAKvC,4DAA4D;AAC5D,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAElC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,gBAAgB;AAChB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,oBAAoB;AACpB,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AASpD,iBAAiB;AACjB,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC"}

package/dist/think-builder.d.ts

@@ -1,5 +1,15 @@
-import { type SchemaProvider } from "@thinkwell/acp";
+import { type SchemaProvider, type SkillTool } from "@thinkwell/acp";
 import type { AgentConnection } from "./agent.js";
+import { ThoughtStream } from "./thought-stream.js";
+/**
+ * Input for defining a virtual skill via the .skill() method.
+ */
+export interface VirtualSkillDefinition {
+    name: string;
+    description: string;
+    body: string;
+    tools?: SkillTool[];
+}
 /**
  * Fluent builder for composing prompts with tools.
  *
@@ -13,6 +23,7 @@ export declare class ThinkBuilder<Output> {
     private readonly _conn;
     private _promptParts;
     private _tools;
+    private _skills;
     private _schemaProvider;
     private _cwd;
     private _existingSessionId;
@@ -114,10 +125,39 @@ export declare class ThinkBuilder<Output> {
      * Register a tool without schemas (no prompt reference).
      */
     defineTool(name: string, description: string, handler: (input: unknown) => Promise<unknown>): this;
+    /**
+     * Attach a skill to this prompt.
+     *
+     * When called with a string, it is treated as a path to a SKILL.md file
+     * that will be parsed at run() time (deferred stored skill).
+     *
+     * When called with an object, it is treated as a virtual skill definition
+     * and validated eagerly.
+     *
+     * @param pathOrDef - Path to a SKILL.md file, or a virtual skill definition
+     */
+    skill(pathOrDef: string | VirtualSkillDefinition): this;
     /**
      * Set the working directory for the session
      */
     cwd(path: string): this;
+    /**
+     * Resolve all deferred skills into ResolvedSkill instances.
+     *
+     * - Virtual skills are passed through as-is.
+     * - Stored skills are loaded from disk: SKILL.md is parsed and basePath is
+     *   set to the directory containing the file.
+     *
+     * Skills are returned in attachment order.
+     */
+    private _resolveSkills;
+    /**
+     * Build the `<available_skills>` XML block and infrastructure instructions.
+     *
+     * Returns the string to prepend before the user's prompt parts, or an
+     * empty string when no skills are attached.
+     */
+    private _buildSkillsPrompt;
     /**
      * Execute the prompt and return the result.
      *
@@ -130,6 +170,14 @@ export declare class ThinkBuilder<Output> {
      * 6. Returns the typed result
      */
     run(): Promise<Output>;
-    private _executeRun;
+    /**
+     * Start executing the prompt, returning a stream handle that provides
+     * both an async iterable of intermediate `ThoughtEvent`s and a `.result`
+     * promise for the final typed output.
+     *
+     * Execution begins eagerly — the returned stream is already "hot".
+     */
+    stream(): ThoughtStream<Output>;
+    private _executeStream;
 }
 //# sourceMappingURL=think-builder.d.ts.map

package/dist/think-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"think-builder.d.ts","sourceRoot":"","sources":["../src/think-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EAEpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,eAAe,EAAkB,MAAM,YAAY,CAAC;AA2ElE;;;;;;;;GAQG;AACH,qBAAa,YAAY,CAAC,MAAM;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkB;IACxC,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,MAAM,CAA0C;IACxD,OAAO,CAAC,eAAe,CAAqC;IAC5D,OAAO,CAAC,IAAI,CAAqB;IACjC,OAAO,CAAC,kBAAkB,CAAqB;gBAG7C,IAAI,EAAE,eAAe,EACrB,MAAM,CAAC,EAAE,cAAc,CAAC,MAAM,CAAC,EAC/B,iBAAiB,CAAC,EAAE,MAAM;IAO5B;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAK3B;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAK7B;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,MAAgB,GAAG,IAAI;IAWnD;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAW,GAAG,IAAI;IAKlD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkDG;IACH,IAAI,CAAC,CAAC,EAAE,CAAC,EACP,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,cAAc,CAAC,CAAC,CAAC,EAC9B,YAAY,EAAE,cAAc,CAAC,CAAC,CAAC,EAC/B,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAChC,IAAI;IAEP;;OAEG;IACH,IAAI,CAAC,CAAC,EACJ,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,cAAc,CAAC,CAAC,CAAC,EAC9B,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,GACtC,IAAI;IAEP;;OAEG;IACH,IAAI,CACF,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,GAC5C,IAAI;IAyCP;;;;;;;;;;;OAWG;IACH,UAAU,CAAC,CAAC,EAAE,CAAC,EACb,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,cAAc,CAAC,CAAC,CAAC,EAC9B,YAAY,EAAE,cAAc,CAAC,CAAC,CAAC,EAC/B,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAChC,IAAI;IAEP;;OAEG;IACH,UAAU,CAAC,CAAC,EACV,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,cAAc,CAAC,CAAC,CAAC,EAC9B,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,GACtC,IAAI;IAEP;;OAEG;IACH,UAAU,CACR,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,GAC5C,IAAI;IAyCP;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKvB;;;;;;;;;;OAUG;IACG,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;YAMd,WAAW;CAyI1B"}
+{"version":3,"file":"think-builder.d.ts","sourceRoot":"","sources":["../src/think-builder.ts"],"names":[],"mappings":"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"}