pulseed 0.5.4 → 0.6.1

package/dist/runtime/run-spec/confirmation.js

@@ -0,0 +1,176 @@
+import { classifyConfirmationDecision, } from "../confirmation-decision.js";
+import { RunSpecSchema } from "./types.js";
+export function formatRunSpecSetupProposal(spec) {
+    const lines = [
+        `Proposed long-running run: ${spec.id}`,
+        `Profile: ${spec.profile}`,
+        `Objective: ${spec.objective}`,
+        `Workspace: ${spec.workspace?.path ?? "unresolved"}`,
+        `Execution: ${spec.execution_target.kind}${spec.execution_target.remote_host ? ` (${spec.execution_target.remote_host})` : ""}`,
+        `Progress: ${spec.progress_contract.semantics}`,
+    ];
+    if (spec.metric) {
+        lines.push(`Metric: ${spec.metric.name} (${spec.metric.direction})`);
+    }
+    if (spec.deadline) {
+        lines.push(`Deadline: ${spec.deadline.raw}${spec.deadline.iso_at ? ` (${spec.deadline.iso_at})` : ""}`);
+    }
+    lines.push(`Submit policy: ${spec.approval_policy.submit}`);
+    lines.push(`Publish policy: ${spec.approval_policy.publish}`);
+    lines.push(`External actions: ${spec.approval_policy.external_action}`);
+    lines.push(`Secret policy: ${spec.approval_policy.secret}`);
+    lines.push(`Irreversible actions: ${spec.approval_policy.irreversible_action}`);
+    if (spec.missing_fields.length > 0) {
+        lines.push("Questions:", ...spec.missing_fields.map((field) => `- ${field.question}`));
+    }
+    return lines.join("\n");
+}
+export async function handleRunSpecConfirmationInput(spec, input, context = {}) {
+    const now = context.now ?? new Date();
+    const decision = await classifyConfirmationDecision(input, {
+        kind: "run_spec_confirmation",
+        llmClient: context.llmClient,
+        allowedDecisions: ["approve", "cancel", "revise", "unknown"],
+        subject: formatRunSpecConfirmationContext(spec),
+    });
+    if (decision.decision === "cancel") {
+        const cancelled = updateSpec(spec, { status: "cancelled", updated_at: now.toISOString() });
+        return { kind: "cancelled", spec: cancelled, message: `RunSpec cancelled: ${cancelled.id}` };
+    }
+    if (decision.decision === "approve") {
+        const required = requiredMissingFields(spec);
+        if (required.length > 0) {
+            return {
+                kind: "blocked",
+                spec,
+                message: formatMissingFieldsMessage(required),
+            };
+        }
+        const confirmed = updateSpec(spec, { status: "confirmed", updated_at: now.toISOString() });
+        return { kind: "confirmed", spec: confirmed, message: `RunSpec confirmed: ${confirmed.id}` };
+    }
+    if (decision.decision === "revise") {
+        const revised = applyRunSpecRevision(spec, decision, {
+            now,
+            timezone: context.timezone,
+        });
+        if (!revised) {
+            return {
+                kind: "unrecognized",
+                spec,
+                message: [
+                    "RunSpec revision needs structured workspace, deadline, or metric direction details.",
+                    formatMissingFieldsMessage(requiredMissingFields(spec)),
+                ].filter(Boolean).join("\n"),
+            };
+        }
+        return {
+            kind: "revised",
+            spec: revised,
+            message: formatRunSpecSetupProposal(revised),
+        };
+    }
+    return {
+        kind: "unrecognized",
+        spec,
+        message: [
+            "RunSpec is awaiting confirmation.",
+            decision.clarification ?? "Please approve, cancel, or revise the pending RunSpec.",
+            formatMissingFieldsMessage(requiredMissingFields(spec)),
+        ].filter(Boolean).join("\n"),
+    };
+}
+export function requiredMissingFields(spec) {
+    return spec.missing_fields.filter((field) => field.severity === "required");
+}
+export function applyRunSpecRevision(spec, decision, context = {}) {
+    const now = context.now ?? new Date();
+    const revision = decision.revision;
+    if (!revision)
+        return null;
+    const updates = {
+        updated_at: now.toISOString(),
+    };
+    let changed = false;
+    let missingFields = [...spec.missing_fields];
+    if (revision.workspace_path) {
+        updates.workspace = {
+            path: revision.workspace_path,
+            source: "user",
+            confidence: "high",
+        };
+        missingFields = removeMissing(missingFields, "workspace");
+        changed = true;
+    }
+    if (revision.deadline) {
+        updates.deadline = {
+            raw: revision.deadline.raw,
+            iso_at: revision.deadline.iso_at ?? null,
+            timezone: revision.deadline.timezone ?? context.timezone ?? null,
+            finalization_buffer_minutes: revision.deadline.finalization_buffer_minutes ?? null,
+            confidence: revision.deadline.confidence ?? "medium",
+        };
+        updates.budget = {
+            ...spec.budget,
+            max_wall_clock_minutes: updates.deadline.iso_at ? minutesUntil(now, new Date(updates.deadline.iso_at)) : spec.budget.max_wall_clock_minutes,
+            resident_policy: "until_deadline",
+        };
+        missingFields = removeMissing(missingFields, "deadline");
+        changed = true;
+    }
+    if (revision.metric_direction && spec.metric) {
+        updates.metric = {
+            ...spec.metric,
+            direction: revision.metric_direction,
+            confidence: "high",
+        };
+        missingFields = removeMissing(missingFields, "metric.direction");
+        changed = true;
+    }
+    if (!changed)
+        return null;
+    return updateSpec(spec, {
+        ...updates,
+        missing_fields: missingFields,
+    });
+}
+function formatRunSpecConfirmationContext(spec) {
+    const required = requiredMissingFields(spec);
+    return [
+        `RunSpec ID: ${spec.id}`,
+        `Status: ${spec.status}`,
+        `Profile: ${spec.profile}`,
+        `Objective: ${spec.objective}`,
+        `Workspace: ${spec.workspace?.path ?? "unresolved"}`,
+        `Deadline: ${spec.deadline?.raw ?? "unresolved"}`,
+        `Metric: ${spec.metric ? `${spec.metric.name} (${spec.metric.direction})` : "unresolved"}`,
+        `Progress: ${spec.progress_contract.semantics}`,
+        `Submit policy: ${spec.approval_policy.submit}`,
+        `Publish policy: ${spec.approval_policy.publish}`,
+        `External actions: ${spec.approval_policy.external_action}`,
+        `Secret policy: ${spec.approval_policy.secret}`,
+        `Irreversible actions: ${spec.approval_policy.irreversible_action}`,
+        required.length > 0 ? `Required missing fields: ${required.map((field) => field.field).join(", ")}` : "Required missing fields: none",
+    ].join("\n");
+}
+function updateSpec(spec, updates) {
+    return RunSpecSchema.parse({
+        ...spec,
+        ...updates,
+    });
+}
+function removeMissing(fields, field) {
+    return fields.filter((entry) => entry.field !== field);
+}
+function formatMissingFieldsMessage(fields) {
+    if (fields.length === 0)
+        return "";
+    return [
+        "Run cannot start until required fields are resolved:",
+        ...fields.map((field) => `- ${field.question}`),
+    ].join("\n");
+}
+function minutesUntil(from, to) {
+    return Math.max(0, Math.round((to.getTime() - from.getTime()) / 60_000));
+}
+//# sourceMappingURL=confirmation.js.map

package/dist/runtime/run-spec/confirmation.js.map

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

package/dist/runtime/run-spec/derive.d.ts

@@ -0,0 +1,284 @@
+import { z } from "zod";
+import type { RunSpec, RunSpecDerivationContext } from "./types.js";
+declare const RunSpecDraftSchema: z.ZodObject<{
+    decision: z.ZodEnum<["run_spec_request", "not_run_spec_request"]>;
+    confidence: z.ZodNumber;
+    profile: z.ZodOptional<z.ZodEnum<["generic", "kaggle"]>>;
+    objective: z.ZodOptional<z.ZodString>;
+    workspace: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        path: z.ZodString;
+        source: z.ZodOptional<z.ZodEnum<["user", "context"]>>;
+        confidence: z.ZodOptional<z.ZodEnum<["high", "medium", "low"]>>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        source?: "context" | "user" | undefined;
+        confidence?: "low" | "high" | "medium" | undefined;
+    }, {
+        path: string;
+        source?: "context" | "user" | undefined;
+        confidence?: "low" | "high" | "medium" | undefined;
+    }>>>;
+    execution_target: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodEnum<["local", "daemon", "remote"]>;
+        remote_host: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        confidence: z.ZodOptional<z.ZodEnum<["high", "medium", "low"]>>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "local" | "remote" | "daemon";
+        confidence?: "low" | "high" | "medium" | undefined;
+        remote_host?: string | null | undefined;
+    }, {
+        kind: "local" | "remote" | "daemon";
+        confidence?: "low" | "high" | "medium" | undefined;
+        remote_host?: string | null | undefined;
+    }>>;
+    metric: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        name: z.ZodString;
+        direction: z.ZodEnum<["maximize", "minimize", "unknown"]>;
+        target: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        target_rank_percent: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        datasource: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        confidence: z.ZodOptional<z.ZodEnum<["high", "medium", "low"]>>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        direction: "unknown" | "maximize" | "minimize";
+        confidence?: "low" | "high" | "medium" | undefined;
+        target?: number | null | undefined;
+        target_rank_percent?: number | null | undefined;
+        datasource?: string | null | undefined;
+    }, {
+        name: string;
+        direction: "unknown" | "maximize" | "minimize";
+        confidence?: "low" | "high" | "medium" | undefined;
+        target?: number | null | undefined;
+        target_rank_percent?: number | null | undefined;
+        datasource?: string | null | undefined;
+    }>>>;
+    progress_contract: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodEnum<["metric_target", "rank_percentile", "deadline_only", "open_ended", "unknown"]>;
+        dimension: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        threshold: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        semantics: z.ZodString;
+        confidence: z.ZodOptional<z.ZodEnum<["high", "medium", "low"]>>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "unknown" | "metric_target" | "rank_percentile" | "deadline_only" | "open_ended";
+        semantics: string;
+        confidence?: "low" | "high" | "medium" | undefined;
+        threshold?: number | null | undefined;
+        dimension?: string | null | undefined;
+    }, {
+        kind: "unknown" | "metric_target" | "rank_percentile" | "deadline_only" | "open_ended";
+        semantics: string;
+        confidence?: "low" | "high" | "medium" | undefined;
+        threshold?: number | null | undefined;
+        dimension?: string | null | undefined;
+    }>>;
+    deadline: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        raw: z.ZodString;
+        iso_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        timezone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        finalization_buffer_minutes: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        confidence: z.ZodOptional<z.ZodEnum<["high", "medium", "low"]>>;
+    }, "strip", z.ZodTypeAny, {
+        raw: string;
+        confidence?: "low" | "high" | "medium" | undefined;
+        timezone?: string | null | undefined;
+        iso_at?: string | null | undefined;
+        finalization_buffer_minutes?: number | null | undefined;
+    }, {
+        raw: string;
+        confidence?: "low" | "high" | "medium" | undefined;
+        timezone?: string | null | undefined;
+        iso_at?: string | null | undefined;
+        finalization_buffer_minutes?: number | null | undefined;
+    }>>>;
+    budget: z.ZodOptional<z.ZodObject<{
+        max_trials: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        max_wall_clock_minutes: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        resident_policy: z.ZodOptional<z.ZodEnum<["until_deadline", "best_effort", "unknown"]>>;
+    }, "strip", z.ZodTypeAny, {
+        max_trials?: number | null | undefined;
+        max_wall_clock_minutes?: number | null | undefined;
+        resident_policy?: "unknown" | "until_deadline" | "best_effort" | undefined;
+    }, {
+        max_trials?: number | null | undefined;
+        max_wall_clock_minutes?: number | null | undefined;
+        resident_policy?: "unknown" | "until_deadline" | "best_effort" | undefined;
+    }>>;
+    approval_policy: z.ZodOptional<z.ZodObject<{
+        submit: z.ZodOptional<z.ZodEnum<["approval_required", "allowed", "disallowed", "unspecified"]>>;
+        publish: z.ZodOptional<z.ZodEnum<["approval_required", "allowed", "disallowed", "unspecified"]>>;
+        secret: z.ZodOptional<z.ZodEnum<["approval_required", "disallowed", "unspecified"]>>;
+        external_action: z.ZodOptional<z.ZodEnum<["approval_required", "allowed", "disallowed", "unspecified"]>>;
+        irreversible_action: z.ZodOptional<z.ZodEnum<["approval_required", "disallowed", "unspecified"]>>;
+    }, "strip", z.ZodTypeAny, {
+        secret?: "approval_required" | "unspecified" | "disallowed" | undefined;
+        external_action?: "approval_required" | "allowed" | "unspecified" | "disallowed" | undefined;
+        irreversible_action?: "approval_required" | "unspecified" | "disallowed" | undefined;
+        submit?: "approval_required" | "allowed" | "unspecified" | "disallowed" | undefined;
+        publish?: "approval_required" | "allowed" | "unspecified" | "disallowed" | undefined;
+    }, {
+        secret?: "approval_required" | "unspecified" | "disallowed" | undefined;
+        external_action?: "approval_required" | "allowed" | "unspecified" | "disallowed" | undefined;
+        irreversible_action?: "approval_required" | "unspecified" | "disallowed" | undefined;
+        submit?: "approval_required" | "allowed" | "unspecified" | "disallowed" | undefined;
+        publish?: "approval_required" | "allowed" | "unspecified" | "disallowed" | undefined;
+    }>>;
+    artifact_contract: z.ZodOptional<z.ZodObject<{
+        expected_artifacts: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        discovery_globs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        primary_outputs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        expected_artifacts?: string[] | undefined;
+        discovery_globs?: string[] | undefined;
+        primary_outputs?: string[] | undefined;
+    }, {
+        expected_artifacts?: string[] | undefined;
+        discovery_globs?: string[] | undefined;
+        primary_outputs?: string[] | undefined;
+    }>>;
+    missing_fields: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        field: z.ZodString;
+        question: z.ZodString;
+        severity: z.ZodEnum<["required", "confirmation"]>;
+    }, "strip", z.ZodTypeAny, {
+        question: string;
+        severity: "required" | "confirmation";
+        field: string;
+    }, {
+        question: string;
+        severity: "required" | "confirmation";
+        field: string;
+    }>, "many">>;
+    reason: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    confidence: number;
+    decision: "run_spec_request" | "not_run_spec_request";
+    missing_fields: {
+        question: string;
+        severity: "required" | "confirmation";
+        field: string;
+    }[];
+    deadline?: {
+        raw: string;
+        confidence?: "low" | "high" | "medium" | undefined;
+        timezone?: string | null | undefined;
+        iso_at?: string | null | undefined;
+        finalization_buffer_minutes?: number | null | undefined;
+    } | null | undefined;
+    reason?: string | undefined;
+    metric?: {
+        name: string;
+        direction: "unknown" | "maximize" | "minimize";
+        confidence?: "low" | "high" | "medium" | undefined;
+        target?: number | null | undefined;
+        target_rank_percent?: number | null | undefined;
+        datasource?: string | null | undefined;
+    } | null | undefined;
+    approval_policy?: {
+        secret?: "approval_required" | "unspecified" | "disallowed" | undefined;
+        external_action?: "approval_required" | "allowed" | "unspecified" | "disallowed" | undefined;
+        irreversible_action?: "approval_required" | "unspecified" | "disallowed" | undefined;
+        submit?: "approval_required" | "allowed" | "unspecified" | "disallowed" | undefined;
+        publish?: "approval_required" | "allowed" | "unspecified" | "disallowed" | undefined;
+    } | undefined;
+    workspace?: {
+        path: string;
+        source?: "context" | "user" | undefined;
+        confidence?: "low" | "high" | "medium" | undefined;
+    } | null | undefined;
+    budget?: {
+        max_trials?: number | null | undefined;
+        max_wall_clock_minutes?: number | null | undefined;
+        resident_policy?: "unknown" | "until_deadline" | "best_effort" | undefined;
+    } | undefined;
+    objective?: string | undefined;
+    profile?: "generic" | "kaggle" | undefined;
+    execution_target?: {
+        kind: "local" | "remote" | "daemon";
+        confidence?: "low" | "high" | "medium" | undefined;
+        remote_host?: string | null | undefined;
+    } | undefined;
+    progress_contract?: {
+        kind: "unknown" | "metric_target" | "rank_percentile" | "deadline_only" | "open_ended";
+        semantics: string;
+        confidence?: "low" | "high" | "medium" | undefined;
+        threshold?: number | null | undefined;
+        dimension?: string | null | undefined;
+    } | undefined;
+    artifact_contract?: {
+        expected_artifacts?: string[] | undefined;
+        discovery_globs?: string[] | undefined;
+        primary_outputs?: string[] | undefined;
+    } | undefined;
+}, {
+    confidence: number;
+    decision: "run_spec_request" | "not_run_spec_request";
+    deadline?: {
+        raw: string;
+        confidence?: "low" | "high" | "medium" | undefined;
+        timezone?: string | null | undefined;
+        iso_at?: string | null | undefined;
+        finalization_buffer_minutes?: number | null | undefined;
+    } | null | undefined;
+    reason?: string | undefined;
+    metric?: {
+        name: string;
+        direction: "unknown" | "maximize" | "minimize";
+        confidence?: "low" | "high" | "medium" | undefined;
+        target?: number | null | undefined;
+        target_rank_percent?: number | null | undefined;
+        datasource?: string | null | undefined;
+    } | null | undefined;
+    approval_policy?: {
+        secret?: "approval_required" | "unspecified" | "disallowed" | undefined;
+        external_action?: "approval_required" | "allowed" | "unspecified" | "disallowed" | undefined;
+        irreversible_action?: "approval_required" | "unspecified" | "disallowed" | undefined;
+        submit?: "approval_required" | "allowed" | "unspecified" | "disallowed" | undefined;
+        publish?: "approval_required" | "allowed" | "unspecified" | "disallowed" | undefined;
+    } | undefined;
+    workspace?: {
+        path: string;
+        source?: "context" | "user" | undefined;
+        confidence?: "low" | "high" | "medium" | undefined;
+    } | null | undefined;
+    budget?: {
+        max_trials?: number | null | undefined;
+        max_wall_clock_minutes?: number | null | undefined;
+        resident_policy?: "unknown" | "until_deadline" | "best_effort" | undefined;
+    } | undefined;
+    objective?: string | undefined;
+    profile?: "generic" | "kaggle" | undefined;
+    execution_target?: {
+        kind: "local" | "remote" | "daemon";
+        confidence?: "low" | "high" | "medium" | undefined;
+        remote_host?: string | null | undefined;
+    } | undefined;
+    progress_contract?: {
+        kind: "unknown" | "metric_target" | "rank_percentile" | "deadline_only" | "open_ended";
+        semantics: string;
+        confidence?: "low" | "high" | "medium" | undefined;
+        threshold?: number | null | undefined;
+        dimension?: string | null | undefined;
+    } | undefined;
+    artifact_contract?: {
+        expected_artifacts?: string[] | undefined;
+        discovery_globs?: string[] | undefined;
+        primary_outputs?: string[] | undefined;
+    } | undefined;
+    missing_fields?: {
+        question: string;
+        severity: "required" | "confirmation";
+        field: string;
+    }[] | undefined;
+}>;
+type RunSpecDraft = z.infer<typeof RunSpecDraftSchema>;
+export interface RunSpecIntent {
+    needsRunSpec: true;
+    profile: "generic" | "kaggle";
+    reason: string;
+    confidence: number;
+}
+export declare function understandRunSpecDraft(text: string, context?: RunSpecDerivationContext): Promise<RunSpecDraft | null>;
+export declare function deriveRunSpecFromText(text: string, context?: RunSpecDerivationContext): Promise<RunSpec | null>;
+export {};
+//# sourceMappingURL=derive.d.ts.map

package/dist/runtime/run-spec/derive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive.d.ts","sourceRoot":"","sources":["../../../src/runtime/run-spec/derive.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EACV,OAAO,EAKP,wBAAwB,EAIzB,MAAM,YAAY,CAAC;AA+DpB,QAAA,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmBtB,CAAC;AAEH,KAAK,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEvD,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,IAAI,CAAC;IACnB,OAAO,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AA6CD,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAoB9B;AAED,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CA6CzB"}