pulseed 0.5.2 → 0.5.3

package/dist/tools/kaggle/KaggleWorkspacePrepareTool.d.ts

@@ -0,0 +1,105 @@
+import { z } from "zod";
+import type { ITool, PermissionCheckResult, ToolCallContext, ToolDescriptionContext, ToolMetadata, ToolResult } from "../types.js";
+import { metricThresholdHintForDirection } from "./metrics.js";
+export declare const KaggleWorkspacePrepareInputSchema: z.ZodObject<{
+    workspace: z.ZodString;
+    competition: z.ZodString;
+    metric_name: z.ZodString;
+    metric_direction: z.ZodEnum<["maximize", "minimize"]>;
+    target_column: z.ZodOptional<z.ZodString>;
+    submission_format_hint: z.ZodOptional<z.ZodString>;
+    notes: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    workspace: string;
+    competition: string;
+    metric_name: string;
+    metric_direction: "maximize" | "minimize";
+    notes?: string | undefined;
+    target_column?: string | undefined;
+    submission_format_hint?: string | undefined;
+}, {
+    workspace: string;
+    competition: string;
+    metric_name: string;
+    metric_direction: "maximize" | "minimize";
+    notes?: string | undefined;
+    target_column?: string | undefined;
+    submission_format_hint?: string | undefined;
+}>;
+export type KaggleWorkspacePrepareInput = z.infer<typeof KaggleWorkspacePrepareInputSchema>;
+export interface KaggleWorkspacePrepareOutput {
+    workspace: {
+        path: string;
+        state_relative_path: string;
+    };
+    metadata: {
+        path: string;
+        state_relative_path: string;
+    };
+    directories: Array<{
+        name: string;
+        path: string;
+        state_relative_path: string;
+    }>;
+    artifacts: {
+        metrics_template: {
+            path: string;
+            workspace_relative_path: string;
+            state_relative_path: string;
+        };
+        train_log: {
+            path: string;
+            workspace_relative_path: string;
+            state_relative_path: string;
+        };
+        submissions_dir: {
+            path: string;
+            state_relative_path: string;
+        };
+    };
+    wait_condition_hints: {
+        file_exists: {
+            type: "file_exists";
+            path: string;
+            absolute_path: string;
+            hint: string;
+        };
+    };
+    metric_threshold_guidance: ReturnType<typeof metricThresholdHintForDirection> & {
+        metrics_artifact_path: string;
+        metrics_artifact_state_relative_path: string;
+    };
+}
+export declare class KaggleWorkspacePrepareTool implements ITool<KaggleWorkspacePrepareInput, KaggleWorkspacePrepareOutput> {
+    readonly metadata: ToolMetadata;
+    readonly inputSchema: z.ZodObject<{
+        workspace: z.ZodString;
+        competition: z.ZodString;
+        metric_name: z.ZodString;
+        metric_direction: z.ZodEnum<["maximize", "minimize"]>;
+        target_column: z.ZodOptional<z.ZodString>;
+        submission_format_hint: z.ZodOptional<z.ZodString>;
+        notes: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        workspace: string;
+        competition: string;
+        metric_name: string;
+        metric_direction: "maximize" | "minimize";
+        notes?: string | undefined;
+        target_column?: string | undefined;
+        submission_format_hint?: string | undefined;
+    }, {
+        workspace: string;
+        competition: string;
+        metric_name: string;
+        metric_direction: "maximize" | "minimize";
+        notes?: string | undefined;
+        target_column?: string | undefined;
+        submission_format_hint?: string | undefined;
+    }>;
+    description(_context?: ToolDescriptionContext): string;
+    call(input: KaggleWorkspacePrepareInput, _context: ToolCallContext): Promise<ToolResult>;
+    checkPermissions(input: KaggleWorkspacePrepareInput, _context: ToolCallContext): Promise<PermissionCheckResult>;
+    isConcurrencySafe(_input: KaggleWorkspacePrepareInput): boolean;
+}
+//# sourceMappingURL=KaggleWorkspacePrepareTool.d.ts.map

package/dist/tools/kaggle/KaggleWorkspacePrepareTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KaggleWorkspacePrepareTool.d.ts","sourceRoot":"","sources":["../../../src/tools/kaggle/KaggleWorkspacePrepareTool.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EACV,KAAK,EACL,qBAAqB,EACrB,eAAe,EACf,sBAAsB,EACtB,YAAY,EACZ,UAAU,EACX,MAAM,aAAa,CAAC;AACrB,OAAO,EAA+B,+BAA+B,EAAE,MAAM,cAAc,CAAC;AAO5F,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;EAQnC,CAAC;AAEZ,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAE5F,MAAM,WAAW,4BAA4B;IAC3C,SAAS,EAAE;QACT,IAAI,EAAE,MAAM,CAAC;QACb,mBAAmB,EAAE,MAAM,CAAC;KAC7B,CAAC;IACF,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,mBAAmB,EAAE,MAAM,CAAC;KAC7B,CAAC;IACF,WAAW,EAAE,KAAK,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,mBAAmB,EAAE,MAAM,CAAC;KAC7B,CAAC,CAAC;IACH,SAAS,EAAE;QACT,gBAAgB,EAAE;YAChB,IAAI,EAAE,MAAM,CAAC;YACb,uBAAuB,EAAE,MAAM,CAAC;YAChC,mBAAmB,EAAE,MAAM,CAAC;SAC7B,CAAC;QACF,SAAS,EAAE;YACT,IAAI,EAAE,MAAM,CAAC;YACb,uBAAuB,EAAE,MAAM,CAAC;YAChC,mBAAmB,EAAE,MAAM,CAAC;SAC7B,CAAC;QACF,eAAe,EAAE;YACf,IAAI,EAAE,MAAM,CAAC;YACb,mBAAmB,EAAE,MAAM,CAAC;SAC7B,CAAC;KACH,CAAC;IACF,oBAAoB,EAAE;QACpB,WAAW,EAAE;YACX,IAAI,EAAE,aAAa,CAAC;YACpB,IAAI,EAAE,MAAM,CAAC;YACb,aAAa,EAAE,MAAM,CAAC;YACtB,IAAI,EAAE,MAAM,CAAC;SACd,CAAC;KACH,CAAC;IACF,yBAAyB,EAAE,UAAU,CAAC,OAAO,+BAA+B,CAAC,GAAG;QAC9E,qBAAqB,EAAE,MAAM,CAAC;QAC9B,oCAAoC,EAAE,MAAM,CAAC;KAC9C,CAAC;CACH;AAED,qBAAa,0BAA2B,YAAW,KAAK,CAAC,2BAA2B,EAAE,4BAA4B,CAAC;IACjH,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAW7B;IAEF,QAAQ,CAAC,WAAW;;;;;;;;;;;;;;;;;;;;;;;;OAAqC;IAEzD,WAAW,CAAC,QAAQ,CAAC,EAAE,sBAAsB,GAAG,MAAM;IAQhD,IAAI,CAAC,KAAK,EAAE,2BAA2B,EAAE,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC;IA+FxF,gBAAgB,CAAC,KAAK,EAAE,2BAA2B,EAAE,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAOrH,iBAAiB,CAAC,MAAM,EAAE,2BAA2B,GAAG,OAAO;CAGhE"}

package/dist/tools/kaggle/KaggleWorkspacePrepareTool.js

@@ -0,0 +1,135 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { z } from "zod";
+import { KaggleMetricDirectionSchema, metricThresholdHintForDirection } from "./metrics.js";
+import { ensureKaggleWorkspaceDirectories, resolveKaggleWorkspaceInput, stateRelativePath, } from "./paths.js";
+export const KaggleWorkspacePrepareInputSchema = z.object({
+    workspace: z.string().min(1, "workspace is required"),
+    competition: z.string().min(1, "competition is required"),
+    metric_name: z.string().min(1, "metric_name is required"),
+    metric_direction: KaggleMetricDirectionSchema,
+    target_column: z.string().min(1).optional(),
+    submission_format_hint: z.string().min(1).optional(),
+    notes: z.string().min(1).optional(),
+}).strict();
+export class KaggleWorkspacePrepareTool {
+    metadata = {
+        name: "kaggle_workspace_prepare",
+        aliases: ["kaggle_prepare_workspace"],
+        permissionLevel: "write_local",
+        isReadOnly: false,
+        isDestructive: false,
+        shouldDefer: false,
+        alwaysLoad: false,
+        maxConcurrency: 1,
+        maxOutputChars: 8000,
+        tags: ["kaggle", "workspace", "ml", "filesystem"],
+    };
+    inputSchema = KaggleWorkspacePrepareInputSchema;
+    description(_context) {
+        return [
+            "Prepare a local Kaggle training workspace under PulSeed state.",
+            "Creates data, notebooks, src, experiments, and submissions directories, writes workspace metadata, and returns artifact and wait-condition path hints.",
+            "This tool does not call Kaggle APIs or read credentials.",
+        ].join(" ");
+    }
+    async call(input, _context) {
+        const startTime = Date.now();
+        try {
+            const workspaceRoot = resolveKaggleWorkspaceInput(input.workspace, input.competition);
+            const directories = await ensureKaggleWorkspaceDirectories(workspaceRoot);
+            const metadataPath = path.join(workspaceRoot, "workspace.json");
+            const metricsPath = path.join(workspaceRoot, "experiments", "metrics.json");
+            const logPath = path.join(workspaceRoot, "experiments", "train.log");
+            const now = new Date().toISOString();
+            const metadata = {
+                schema_version: "kaggle-workspace-v1",
+                created_at: now,
+                competition: input.competition,
+                workspace_root: workspaceRoot,
+                workspace_state_relative_path: stateRelativePath(workspaceRoot),
+                metric: {
+                    name: input.metric_name,
+                    direction: input.metric_direction,
+                },
+                target_column: input.target_column ?? null,
+                submission_format_hint: input.submission_format_hint ?? null,
+                notes: input.notes ?? null,
+                directories: Object.fromEntries(Object.entries(directories).map(([name, fullPath]) => [name, stateRelativePath(fullPath)])),
+                metrics_schema_version: "kaggle-metrics-v1",
+            };
+            await fs.writeFile(metadataPath, `${JSON.stringify(metadata, null, 2)}\n`, "utf-8");
+            const thresholdHint = metricThresholdHintForDirection(input.metric_name, input.metric_direction);
+            const output = {
+                workspace: {
+                    path: workspaceRoot,
+                    state_relative_path: stateRelativePath(workspaceRoot),
+                },
+                metadata: {
+                    path: metadataPath,
+                    state_relative_path: stateRelativePath(metadataPath),
+                },
+                directories: Object.entries(directories).map(([name, fullPath]) => ({
+                    name,
+                    path: fullPath,
+                    state_relative_path: stateRelativePath(fullPath),
+                })),
+                artifacts: {
+                    metrics_template: {
+                        path: metricsPath,
+                        workspace_relative_path: "experiments/metrics.json",
+                        state_relative_path: stateRelativePath(metricsPath),
+                    },
+                    train_log: {
+                        path: logPath,
+                        workspace_relative_path: "experiments/train.log",
+                        state_relative_path: stateRelativePath(logPath),
+                    },
+                    submissions_dir: {
+                        path: directories.submissions,
+                        state_relative_path: stateRelativePath(directories.submissions),
+                    },
+                },
+                wait_condition_hints: {
+                    file_exists: {
+                        type: "file_exists",
+                        path: stateRelativePath(metricsPath),
+                        absolute_path: metricsPath,
+                        hint: "Wait for the training command to write metrics.json.",
+                    },
+                },
+                metric_threshold_guidance: {
+                    ...thresholdHint,
+                    metrics_artifact_path: metricsPath,
+                    metrics_artifact_state_relative_path: stateRelativePath(metricsPath),
+                },
+            };
+            return {
+                success: true,
+                data: output,
+                summary: `Prepared Kaggle workspace for ${input.competition} at ${output.workspace.state_relative_path}`,
+                durationMs: Date.now() - startTime,
+                artifacts: [metadataPath, ...Object.values(directories)],
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                data: null,
+                summary: `Failed to prepare Kaggle workspace for ${input.competition}`,
+                error: err.message,
+                durationMs: Date.now() - startTime,
+            };
+        }
+    }
+    async checkPermissions(input, _context) {
+        return {
+            status: "needs_approval",
+            reason: `Create Kaggle workspace directories and metadata for ${input.competition}`,
+        };
+    }
+    isConcurrencySafe(_input) {
+        return false;
+    }
+}
+//# sourceMappingURL=KaggleWorkspacePrepareTool.js.map

package/dist/tools/kaggle/KaggleWorkspacePrepareTool.js.map

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

package/dist/tools/kaggle/index.d.ts

@@ -0,0 +1,6 @@
+export { KaggleCompareExperimentsInputSchema, KaggleCompareExperimentsTool, KaggleExperimentListInputSchema, KaggleExperimentListTool, KaggleExperimentReadInputSchema, KaggleExperimentReadTool, KaggleExperimentStartInputSchema, KaggleExperimentStartTool, KaggleExperimentStopInputSchema, KaggleExperimentStopTool, KaggleMetricReportInputSchema, KaggleMetricReportTool, type KaggleCompareExperimentsInput, type KaggleExperimentListInput, type KaggleExperimentReadInput, type KaggleExperimentStartInput, type KaggleExperimentStopInput, type KaggleMetricReportInput, } from "./KaggleExperimentTools.js";
+export { KaggleLeaderboardSnapshotInputSchema, KaggleLeaderboardSnapshotTool, KaggleListSubmissionsInputSchema, KaggleListSubmissionsTool, KaggleSubmissionPrepareInputSchema, KaggleSubmissionPrepareTool, KaggleSubmitInputSchema, KaggleSubmitTool, defaultKaggleCommandRunner, type KaggleCommandResult, type KaggleCommandRunner, type KaggleLeaderboardSnapshotInput, type KaggleListSubmissionsInput, type KaggleSubmissionPrepareInput, type KaggleSubmitInput, } from "./KaggleSubmissionTools.js";
+export { KaggleWorkspacePrepareInputSchema, KaggleWorkspacePrepareTool, type KaggleWorkspacePrepareInput, type KaggleWorkspacePrepareOutput, } from "./KaggleWorkspacePrepareTool.js";
+export { KaggleMetricDirectionSchema, KaggleMetricsSchema, compareMetricScores, metricThresholdHintForDirection, normalizedMetricScore, parseKaggleMetrics, type KaggleMetricDirection, type KaggleMetricParseResult, type KaggleMetrics, type MetricThresholdHint, } from "./metrics.js";
+export { KAGGLE_RUNS_DIR, KAGGLE_WORKSPACE_DIRS, ensureDirectoryWithinStateRoot, ensureKaggleWorkspaceDirectories, getKaggleRunsRoot, getKaggleExperimentDir, getKaggleWorkspaceRoot, resolveKaggleWorkspaceInput, resolveWorkspaceRelativePath, stateRelativePath, validateKaggleCompetitionId, validateKaggleExperimentId, workspaceRelativePath, type KaggleWorkspaceDir, } from "./paths.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/kaggle/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/kaggle/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mCAAmC,EACnC,4BAA4B,EAC5B,+BAA+B,EAC/B,wBAAwB,EACxB,+BAA+B,EAC/B,wBAAwB,EACxB,gCAAgC,EAChC,yBAAyB,EACzB,+BAA+B,EAC/B,wBAAwB,EACxB,6BAA6B,EAC7B,sBAAsB,EACtB,KAAK,6BAA6B,EAClC,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,GAC7B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,oCAAoC,EACpC,6BAA6B,EAC7B,gCAAgC,EAChC,yBAAyB,EACzB,kCAAkC,EAClC,2BAA2B,EAC3B,uBAAuB,EACvB,gBAAgB,EAChB,0BAA0B,EAC1B,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,8BAA8B,EACnC,KAAK,0BAA0B,EAC/B,KAAK,4BAA4B,EACjC,KAAK,iBAAiB,GACvB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,iCAAiC,EACjC,0BAA0B,EAC1B,KAAK,2BAA2B,EAChC,KAAK,4BAA4B,GAClC,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,2BAA2B,EAC3B,mBAAmB,EACnB,mBAAmB,EACnB,+BAA+B,EAC/B,qBAAqB,EACrB,kBAAkB,EAClB,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,aAAa,EAClB,KAAK,mBAAmB,GACzB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,8BAA8B,EAC9B,gCAAgC,EAChC,iBAAiB,EACjB,sBAAsB,EACtB,sBAAsB,EACtB,2BAA2B,EAC3B,4BAA4B,EAC5B,iBAAiB,EACjB,2BAA2B,EAC3B,0BAA0B,EAC1B,qBAAqB,EACrB,KAAK,kBAAkB,GACxB,MAAM,YAAY,CAAC"}

package/dist/tools/kaggle/index.js

@@ -0,0 +1,6 @@
+export { KaggleCompareExperimentsInputSchema, KaggleCompareExperimentsTool, KaggleExperimentListInputSchema, KaggleExperimentListTool, KaggleExperimentReadInputSchema, KaggleExperimentReadTool, KaggleExperimentStartInputSchema, KaggleExperimentStartTool, KaggleExperimentStopInputSchema, KaggleExperimentStopTool, KaggleMetricReportInputSchema, KaggleMetricReportTool, } from "./KaggleExperimentTools.js";
+export { KaggleLeaderboardSnapshotInputSchema, KaggleLeaderboardSnapshotTool, KaggleListSubmissionsInputSchema, KaggleListSubmissionsTool, KaggleSubmissionPrepareInputSchema, KaggleSubmissionPrepareTool, KaggleSubmitInputSchema, KaggleSubmitTool, defaultKaggleCommandRunner, } from "./KaggleSubmissionTools.js";
+export { KaggleWorkspacePrepareInputSchema, KaggleWorkspacePrepareTool, } from "./KaggleWorkspacePrepareTool.js";
+export { KaggleMetricDirectionSchema, KaggleMetricsSchema, compareMetricScores, metricThresholdHintForDirection, normalizedMetricScore, parseKaggleMetrics, } from "./metrics.js";
+export { KAGGLE_RUNS_DIR, KAGGLE_WORKSPACE_DIRS, ensureDirectoryWithinStateRoot, ensureKaggleWorkspaceDirectories, getKaggleRunsRoot, getKaggleExperimentDir, getKaggleWorkspaceRoot, resolveKaggleWorkspaceInput, resolveWorkspaceRelativePath, stateRelativePath, validateKaggleCompetitionId, validateKaggleExperimentId, workspaceRelativePath, } from "./paths.js";
+//# sourceMappingURL=index.js.map

package/dist/tools/kaggle/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/kaggle/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mCAAmC,EACnC,4BAA4B,EAC5B,+BAA+B,EAC/B,wBAAwB,EACxB,+BAA+B,EAC/B,wBAAwB,EACxB,gCAAgC,EAChC,yBAAyB,EACzB,+BAA+B,EAC/B,wBAAwB,EACxB,6BAA6B,EAC7B,sBAAsB,GAOvB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,oCAAoC,EACpC,6BAA6B,EAC7B,gCAAgC,EAChC,yBAAyB,EACzB,kCAAkC,EAClC,2BAA2B,EAC3B,uBAAuB,EACvB,gBAAgB,EAChB,0BAA0B,GAO3B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,iCAAiC,EACjC,0BAA0B,GAG3B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,2BAA2B,EAC3B,mBAAmB,EACnB,mBAAmB,EACnB,+BAA+B,EAC/B,qBAAqB,EACrB,kBAAkB,GAKnB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,8BAA8B,EAC9B,gCAAgC,EAChC,iBAAiB,EACjB,sBAAsB,EACtB,sBAAsB,EACtB,2BAA2B,EAC3B,4BAA4B,EAC5B,iBAAiB,EACjB,2BAA2B,EAC3B,0BAA0B,EAC1B,qBAAqB,GAEtB,MAAM,YAAY,CAAC"}

package/dist/tools/kaggle/metrics.d.ts

@@ -0,0 +1,89 @@
+import { z } from "zod";
+export declare const KaggleMetricDirectionSchema: z.ZodEnum<["maximize", "minimize"]>;
+export type KaggleMetricDirection = z.infer<typeof KaggleMetricDirectionSchema>;
+export declare const KaggleMetricsSchema: z.ZodObject<{
+    experiment_id: z.ZodString;
+    competition: z.ZodString;
+    metric_name: z.ZodString;
+    direction: z.ZodEnum<["maximize", "minimize"]>;
+    cv_score: z.ZodNumber;
+    cv_std: z.ZodNullable<z.ZodNumber>;
+    holdout_score: z.ZodNullable<z.ZodNumber>;
+    train_rows: z.ZodNumber;
+    valid_rows: z.ZodNumber;
+    seed: z.ZodNumber;
+    created_at: z.ZodString;
+    status: z.ZodEnum<["running", "completed", "failed"]>;
+    artifacts: z.ZodObject<{
+        model: z.ZodOptional<z.ZodString>;
+        submission: z.ZodOptional<z.ZodString>;
+        log: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        log: string;
+        model?: string | undefined;
+        submission?: string | undefined;
+    }, {
+        log: string;
+        model?: string | undefined;
+        submission?: string | undefined;
+    }>;
+}, "strict", z.ZodTypeAny, {
+    status: "running" | "completed" | "failed";
+    created_at: string;
+    direction: "maximize" | "minimize";
+    artifacts: {
+        log: string;
+        model?: string | undefined;
+        submission?: string | undefined;
+    };
+    seed: number;
+    experiment_id: string;
+    competition: string;
+    metric_name: string;
+    cv_score: number;
+    cv_std: number | null;
+    holdout_score: number | null;
+    train_rows: number;
+    valid_rows: number;
+}, {
+    status: "running" | "completed" | "failed";
+    created_at: string;
+    direction: "maximize" | "minimize";
+    artifacts: {
+        log: string;
+        model?: string | undefined;
+        submission?: string | undefined;
+    };
+    seed: number;
+    experiment_id: string;
+    competition: string;
+    metric_name: string;
+    cv_score: number;
+    cv_std: number | null;
+    holdout_score: number | null;
+    train_rows: number;
+    valid_rows: number;
+}>;
+export type KaggleMetrics = z.infer<typeof KaggleMetricsSchema>;
+export type KaggleMetricParseResult = {
+    ok: true;
+    metrics: KaggleMetrics;
+} | {
+    ok: false;
+    reason: "missing" | "malformed";
+    message: string;
+    issues?: string[];
+};
+export interface MetricThresholdHint {
+    wait_condition_type: "metric_threshold";
+    metric: string;
+    operator: "gte" | "lte";
+    value_required: true;
+    metric_source: "wait_metadata.metrics";
+    hint: string;
+}
+export declare function metricThresholdHintForDirection(metricName: string, direction: KaggleMetricDirection): MetricThresholdHint;
+export declare function parseKaggleMetrics(value: unknown): KaggleMetricParseResult;
+export declare function normalizedMetricScore(metrics: KaggleMetrics): number;
+export declare function compareMetricScores(a: KaggleMetrics, b: KaggleMetrics): number;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/tools/kaggle/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../../src/tools/kaggle/metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,2BAA2B,qCAAmC,CAAC;AAC5E,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkBrB,CAAC;AAEZ,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,MAAM,MAAM,uBAAuB,GAAG;IACpC,EAAE,EAAE,IAAI,CAAC;IACT,OAAO,EAAE,aAAa,CAAC;CACxB,GAAG;IACF,EAAE,EAAE,KAAK,CAAC;IACV,MAAM,EAAE,SAAS,GAAG,WAAW,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC,mBAAmB,EAAE,kBAAkB,CAAC;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,KAAK,GAAG,KAAK,CAAC;IACxB,cAAc,EAAE,IAAI,CAAC;IACrB,aAAa,EAAE,uBAAuB,CAAC;IACvC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,+BAA+B,CAC7C,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,qBAAqB,GAC/B,mBAAmB,CAUrB;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,uBAAuB,CAW1E;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAEpE;AAED,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,aAAa,GAAG,MAAM,CAE9E"}

package/dist/tools/kaggle/metrics.js

@@ -0,0 +1,51 @@
+import { z } from "zod";
+export const KaggleMetricDirectionSchema = z.enum(["maximize", "minimize"]);
+export const KaggleMetricsSchema = z.object({
+    experiment_id: z.string().min(1),
+    competition: z.string().min(1),
+    metric_name: z.string().min(1),
+    direction: KaggleMetricDirectionSchema,
+    cv_score: z.number().finite(),
+    cv_std: z.number().finite().nullable(),
+    holdout_score: z.number().finite().nullable(),
+    train_rows: z.number().int().nonnegative(),
+    valid_rows: z.number().int().nonnegative(),
+    seed: z.number().int(),
+    created_at: z.string().datetime(),
+    status: z.enum(["running", "completed", "failed"]),
+    artifacts: z.object({
+        model: z.string().min(1).optional(),
+        submission: z.string().min(1).optional(),
+        log: z.string().min(1),
+    }).strict(),
+}).strict();
+export function metricThresholdHintForDirection(metricName, direction) {
+    const operator = direction === "maximize" ? "gte" : "lte";
+    return {
+        wait_condition_type: "metric_threshold",
+        metric: metricName,
+        operator,
+        value_required: true,
+        metric_source: "wait_metadata.metrics",
+        hint: `${direction} ${metricName}: use metric_threshold operator ${operator} with a caller-supplied numeric threshold.`,
+    };
+}
+export function parseKaggleMetrics(value) {
+    const parsed = KaggleMetricsSchema.safeParse(value);
+    if (parsed.success) {
+        return { ok: true, metrics: parsed.data };
+    }
+    return {
+        ok: false,
+        reason: "malformed",
+        message: "metrics.json does not match the strict Kaggle metrics schema",
+        issues: parsed.error.issues.map((issue) => `${issue.path.join(".") || "(root)"}: ${issue.message}`),
+    };
+}
+export function normalizedMetricScore(metrics) {
+    return metrics.direction === "maximize" ? metrics.cv_score : -metrics.cv_score;
+}
+export function compareMetricScores(a, b) {
+    return normalizedMetricScore(b) - normalizedMetricScore(a);
+}
+//# sourceMappingURL=metrics.js.map

package/dist/tools/kaggle/metrics.js.map

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

package/dist/tools/kaggle/paths.d.ts

@@ -0,0 +1,15 @@
+export declare const KAGGLE_RUNS_DIR = "kaggle-runs";
+export declare const KAGGLE_WORKSPACE_DIRS: readonly ["data", "notebooks", "src", "experiments", "submissions"];
+export type KaggleWorkspaceDir = typeof KAGGLE_WORKSPACE_DIRS[number];
+export declare function validateKaggleCompetitionId(competition: string): string;
+export declare function validateKaggleExperimentId(experimentId: string): string;
+export declare function getKaggleRunsRoot(): string;
+export declare function getKaggleWorkspaceRoot(competition: string): string;
+export declare function stateRelativePath(absolutePath: string): string;
+export declare function workspaceRelativePath(workspaceRoot: string, absolutePath: string): string;
+export declare function resolveKaggleWorkspaceInput(workspace: string, competition: string): string;
+export declare function resolveWorkspaceRelativePath(workspaceRoot: string, candidate: string, label: string): string;
+export declare function getKaggleExperimentDir(workspaceRoot: string, experimentId: string): string;
+export declare function ensureDirectoryWithinStateRoot(dirPath: string): Promise<void>;
+export declare function ensureKaggleWorkspaceDirectories(workspaceRoot: string): Promise<Record<KaggleWorkspaceDir, string>>;
+//# sourceMappingURL=paths.d.ts.map

package/dist/tools/kaggle/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../src/tools/kaggle/paths.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,eAAe,gBAAgB,CAAC;AAC7C,eAAO,MAAM,qBAAqB,qEAAsE,CAAC;AAEzG,MAAM,MAAM,kBAAkB,GAAG,OAAO,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAKtE,wBAAgB,2BAA2B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAKvE;AAED,wBAAgB,0BAA0B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAKvE;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAGlE;AAED,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAO9D;AAED,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAMzF;AAUD,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAwB1F;AAED,wBAAgB,4BAA4B,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAU5G;AAED,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAE1F;AAaD,wBAAsB,8BAA8B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA0BnF;AAED,wBAAsB,gCAAgC,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC,CASzH"}

package/dist/tools/kaggle/paths.js

@@ -0,0 +1,136 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { getPulseedDirPath } from "../../base/utils/paths.js";
+export const KAGGLE_RUNS_DIR = "kaggle-runs";
+export const KAGGLE_WORKSPACE_DIRS = ["data", "notebooks", "src", "experiments", "submissions"];
+const COMPETITION_ID_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/;
+const EXPERIMENT_ID_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/;
+export function validateKaggleCompetitionId(competition) {
+    if (!COMPETITION_ID_PATTERN.test(competition) || competition === "." || competition === "..") {
+        throw new Error("competition must be a safe Kaggle competition id");
+    }
+    return competition;
+}
+export function validateKaggleExperimentId(experimentId) {
+    if (!EXPERIMENT_ID_PATTERN.test(experimentId) || experimentId === "." || experimentId === "..") {
+        throw new Error("experiment_id must be a safe Kaggle experiment id");
+    }
+    return experimentId;
+}
+export function getKaggleRunsRoot() {
+    return path.resolve(getPulseedDirPath(), KAGGLE_RUNS_DIR);
+}
+export function getKaggleWorkspaceRoot(competition) {
+    const safeCompetition = validateKaggleCompetitionId(competition);
+    return path.resolve(getKaggleRunsRoot(), safeCompetition);
+}
+export function stateRelativePath(absolutePath) {
+    const stateRoot = path.resolve(getPulseedDirPath());
+    const relativePath = path.relative(stateRoot, path.resolve(absolutePath));
+    if (relativePath === "" || relativePath.startsWith("..") || path.isAbsolute(relativePath)) {
+        throw new Error("path must stay within the PulSeed state root");
+    }
+    return relativePath.split(path.sep).join("/");
+}
+export function workspaceRelativePath(workspaceRoot, absolutePath) {
+    const relativePath = path.relative(path.resolve(workspaceRoot), path.resolve(absolutePath));
+    if (relativePath === "" || relativePath.startsWith("..") || path.isAbsolute(relativePath)) {
+        throw new Error("path must stay within the Kaggle workspace");
+    }
+    return relativePath.split(path.sep).join("/");
+}
+function assertWithin(parent, candidate, label) {
+    const relativePath = path.relative(path.resolve(parent), path.resolve(candidate));
+    if (relativePath === "" || (!relativePath.startsWith("..") && !path.isAbsolute(relativePath))) {
+        return;
+    }
+    throw new Error(`${label} must stay within ${parent}`);
+}
+export function resolveKaggleWorkspaceInput(workspace, competition) {
+    const expected = getKaggleWorkspaceRoot(competition);
+    const runsRoot = getKaggleRunsRoot();
+    const requested = workspace.trim();
+    if (!requested) {
+        throw new Error("workspace is required");
+    }
+    let resolved;
+    if (path.isAbsolute(requested)) {
+        resolved = path.resolve(requested);
+    }
+    else if (requested === competition) {
+        resolved = expected;
+    }
+    else if (requested === path.join(KAGGLE_RUNS_DIR, competition)) {
+        resolved = path.resolve(getPulseedDirPath(), requested);
+    }
+    else {
+        resolved = path.resolve(runsRoot, requested);
+    }
+    if (resolved !== expected) {
+        throw new Error(`workspace must resolve to ${stateRelativePath(expected)}`);
+    }
+    assertWithin(path.resolve(getPulseedDirPath()), resolved, "workspace");
+    return resolved;
+}
+export function resolveWorkspaceRelativePath(workspaceRoot, candidate, label) {
+    const requested = candidate.trim();
+    if (!requested) {
+        throw new Error(`${label} is required`);
+    }
+    const resolved = path.isAbsolute(requested)
+        ? path.resolve(requested)
+        : path.resolve(workspaceRoot, requested);
+    assertWithin(workspaceRoot, resolved, label);
+    return resolved;
+}
+export function getKaggleExperimentDir(workspaceRoot, experimentId) {
+    return path.join(workspaceRoot, "experiments", validateKaggleExperimentId(experimentId));
+}
+async function realpathIfExists(candidate) {
+    try {
+        return await fs.realpath(candidate);
+    }
+    catch (err) {
+        if (err.code === "ENOENT") {
+            return null;
+        }
+        throw err;
+    }
+}
+export async function ensureDirectoryWithinStateRoot(dirPath) {
+    const stateRoot = path.resolve(getPulseedDirPath());
+    await fs.mkdir(stateRoot, { recursive: true });
+    const realStateRoot = await fs.realpath(stateRoot);
+    assertWithin(stateRoot, dirPath, "directory");
+    const relativeParts = path.relative(stateRoot, path.resolve(dirPath)).split(path.sep).filter(Boolean);
+    let current = stateRoot;
+    for (const part of relativeParts) {
+        current = path.join(current, part);
+        const existingRealPath = await realpathIfExists(current);
+        if (existingRealPath) {
+            const stat = await fs.lstat(current);
+            if (stat.isSymbolicLink()) {
+                throw new Error(`workspace path component must not be a symlink: ${stateRelativePath(current)}`);
+            }
+            assertWithin(realStateRoot, existingRealPath, "directory realpath");
+            if (!stat.isDirectory()) {
+                throw new Error(`workspace path component is not a directory: ${stateRelativePath(current)}`);
+            }
+            continue;
+        }
+        await fs.mkdir(current);
+        const createdRealPath = await fs.realpath(current);
+        assertWithin(realStateRoot, createdRealPath, "created directory");
+    }
+}
+export async function ensureKaggleWorkspaceDirectories(workspaceRoot) {
+    await ensureDirectoryWithinStateRoot(workspaceRoot);
+    const directories = {};
+    for (const dirname of KAGGLE_WORKSPACE_DIRS) {
+        const fullPath = path.join(workspaceRoot, dirname);
+        await ensureDirectoryWithinStateRoot(fullPath);
+        directories[dirname] = fullPath;
+    }
+    return directories;
+}
+//# sourceMappingURL=paths.js.map

package/dist/tools/kaggle/paths.js.map

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

package/dist/tools/network/GitHubCliTool/GitHubCliTool.d.ts

@@ -28,8 +28,8 @@ export declare const GitHubReadInputSchema: z.ZodObject<{
     run_id?: string | number | undefined;
     limit?: number | undefined;
     issue?: number | undefined;
-    pr?: number | undefined;
     maxChars?: number | undefined;
+    pr?: number | undefined;
 }>;
 export type GitHubReadInput = z.infer<typeof GitHubReadInputSchema>;
 export declare const GitHubPrCreateInputSchema: z.ZodObject<{
@@ -98,8 +98,8 @@ export declare class GitHubReadTool implements ITool<GitHubReadInput, GitHubCliO
         run_id?: string | number | undefined;
         limit?: number | undefined;
         issue?: number | undefined;
-        pr?: number | undefined;
         maxChars?: number | undefined;
+        pr?: number | undefined;
     }>;
     description(): string;
     call(input: GitHubReadInput, context: ToolCallContext): Promise<ToolResult>;