pulseed 0.4.18 → 0.4.20

package/dist/runtime/schedule/presets.js

@@ -0,0 +1,190 @@
+import { z } from "zod";
+import { ScheduleTriggerSchema, } from "../types/schedule.js";
+const RecordSchema = z.record(z.string(), z.unknown());
+const SchedulePresetBaseSchema = z.object({
+    name: z.string().min(1).optional(),
+    enabled: z.boolean().default(true),
+    trigger: ScheduleTriggerSchema.optional(),
+});
+export const DailyBriefPresetInputSchema = SchedulePresetBaseSchema.extend({
+    preset: z.literal("daily_brief"),
+    context_sources: z.array(z.string()).default([]),
+});
+export const WeeklyReviewPresetInputSchema = SchedulePresetBaseSchema.extend({
+    preset: z.literal("weekly_review"),
+    context_sources: z.array(z.string()).default([]),
+});
+export const DreamConsolidationPresetInputSchema = SchedulePresetBaseSchema.extend({
+    preset: z.literal("dream_consolidation"),
+    context_sources: z.array(z.string()).default([]),
+});
+export const SoilPublishPresetInputSchema = SchedulePresetBaseSchema.extend({
+    preset: z.literal("soil_publish"),
+});
+export const GoalProbePresetInputSchema = SchedulePresetBaseSchema.extend({
+    preset: z.literal("goal_probe"),
+    data_source_id: z.string().min(1),
+    probe_dimension: z.string().optional(),
+    query_params: RecordSchema.default({}),
+    detector_mode: z.enum(["threshold", "diff", "presence"]).default("diff"),
+    threshold_value: z.number().optional(),
+    baseline_window: z.number().int().min(1).default(5),
+    llm_on_change: z.boolean().default(true),
+    llm_prompt_template: z.string().optional(),
+});
+export const SchedulePresetInputSchema = z.discriminatedUnion("preset", [
+    DailyBriefPresetInputSchema,
+    WeeklyReviewPresetInputSchema,
+    DreamConsolidationPresetInputSchema,
+    SoilPublishPresetInputSchema,
+    GoalProbePresetInputSchema,
+]);
+const PRESET_DEFINITIONS = {
+    daily_brief: {
+        key: "daily_brief",
+        title: "Daily brief",
+        description: "Runs the morning planning reflection and delivers a concise daily briefing.",
+        defaultTrigger: { type: "cron", expression: "0 9 * * *", timezone: "UTC" },
+        dependencyHints: ["llm_client", "notification_dispatcher"],
+    },
+    weekly_review: {
+        key: "weekly_review",
+        title: "Weekly review",
+        description: "Runs the weekly reflection review and emits a report plus notification.",
+        defaultTrigger: { type: "cron", expression: "0 9 * * 1", timezone: "UTC" },
+        dependencyHints: ["llm_client", "notification_dispatcher"],
+    },
+    dream_consolidation: {
+        key: "dream_consolidation",
+        title: "Dream consolidation",
+        description: "Runs overnight consolidation for memory and stale knowledge cleanup.",
+        defaultTrigger: { type: "cron", expression: "0 2 * * *", timezone: "UTC" },
+        dependencyHints: ["memory_lifecycle", "knowledge_manager"],
+    },
+    soil_publish: {
+        key: "soil_publish",
+        title: "Soil snapshot publish",
+        description: "Publishes configured read-only Soil snapshots to external viewers.",
+        defaultTrigger: { type: "interval", seconds: 24 * 60 * 60, jitter_factor: 0 },
+        dependencyHints: ["soil_publish_config"],
+    },
+    goal_probe: {
+        key: "goal_probe",
+        title: "Goal probe",
+        description: "Polls a data source and triggers change detection for goal-relevant signals.",
+        defaultTrigger: { type: "interval", seconds: 3600, jitter_factor: 0 },
+        dependencyHints: ["data_source_registry"],
+    },
+};
+function cloneTrigger(trigger) {
+    return trigger.type === "cron"
+        ? { type: "cron", expression: trigger.expression, timezone: trigger.timezone ?? "UTC" }
+        : { type: "interval", seconds: trigger.seconds, jitter_factor: trigger.jitter_factor ?? 0 };
+}
+export function listSchedulePresetDefinitions() {
+    return Object.values(PRESET_DEFINITIONS).map((definition) => ({
+        ...definition,
+        defaultTrigger: cloneTrigger(definition.defaultTrigger),
+        dependencyHints: [...definition.dependencyHints],
+    }));
+}
+export function getSchedulePresetDefinition(key) {
+    const definition = PRESET_DEFINITIONS[key];
+    return {
+        ...definition,
+        defaultTrigger: cloneTrigger(definition.defaultTrigger),
+        dependencyHints: [...definition.dependencyHints],
+    };
+}
+function resolveTrigger(input) {
+    return input.trigger ? input.trigger : cloneTrigger(PRESET_DEFINITIONS[input.preset].defaultTrigger);
+}
+export function buildSchedulePresetEntry(input) {
+    const parsed = SchedulePresetInputSchema.parse(input);
+    const definition = PRESET_DEFINITIONS[parsed.preset];
+    const base = {
+        name: parsed.name ?? definition.title,
+        enabled: parsed.enabled,
+        trigger: resolveTrigger(parsed),
+        metadata: {
+            source: "preset",
+            preset_key: parsed.preset,
+            dependency_hints: [...definition.dependencyHints],
+        },
+    };
+    switch (parsed.preset) {
+        case "daily_brief":
+            return {
+                ...base,
+                layer: "cron",
+                cron: {
+                    job_kind: "reflection",
+                    reflection_kind: "morning_planning",
+                    prompt_template: "Run the daily brief reflection workflow.",
+                    context_sources: parsed.context_sources,
+                    output_format: "notification",
+                    report_type: "daily_brief",
+                    max_tokens: 1200,
+                },
+            };
+        case "weekly_review":
+            return {
+                ...base,
+                layer: "cron",
+                cron: {
+                    job_kind: "reflection",
+                    reflection_kind: "weekly_review",
+                    prompt_template: "Run the weekly review reflection workflow.",
+                    context_sources: parsed.context_sources,
+                    output_format: "both",
+                    report_type: "weekly_review",
+                    max_tokens: 2000,
+                },
+            };
+        case "dream_consolidation":
+            return {
+                ...base,
+                layer: "cron",
+                cron: {
+                    job_kind: "reflection",
+                    reflection_kind: "dream_consolidation",
+                    prompt_template: "Run the dream consolidation workflow.",
+                    context_sources: parsed.context_sources,
+                    output_format: "report",
+                    report_type: "dream_consolidation",
+                    max_tokens: 1200,
+                },
+            };
+        case "soil_publish":
+            return {
+                ...base,
+                layer: "cron",
+                cron: {
+                    job_kind: "soil_publish",
+                    prompt_template: "Publish configured Soil snapshots.",
+                    context_sources: [],
+                    output_format: "report",
+                    report_type: "soil_publish",
+                    max_tokens: 0,
+                },
+            };
+        case "goal_probe":
+            return {
+                ...base,
+                layer: "probe",
+                probe: {
+                    data_source_id: parsed.data_source_id,
+                    probe_dimension: parsed.probe_dimension,
+                    query_params: parsed.query_params,
+                    change_detector: {
+                        mode: parsed.detector_mode,
+                        threshold_value: parsed.threshold_value,
+                        baseline_window: parsed.baseline_window,
+                    },
+                    llm_on_change: parsed.llm_on_change,
+                    llm_prompt_template: parsed.llm_prompt_template,
+                },
+            };
+    }
+}
+//# sourceMappingURL=presets.js.map

package/dist/runtime/schedule/presets.js.map

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

package/dist/runtime/schedule/source.d.ts

@@ -0,0 +1,80 @@
+import { z } from "zod";
+export declare const ExternalScheduleEntrySchema: z.ZodObject<{
+    external_id: z.ZodString;
+    source_id: z.ZodString;
+    name: z.ZodString;
+    layer: z.ZodEnum<["heartbeat", "probe", "cron", "goal_trigger"]>;
+    trigger: z.ZodEffects<z.ZodObject<{
+        type: z.ZodEnum<["cron", "interval"]>;
+        expression: z.ZodOptional<z.ZodString>;
+        seconds: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        type: "cron" | "interval";
+        expression?: string | undefined;
+        seconds?: number | undefined;
+    }, {
+        type: "cron" | "interval";
+        expression?: string | undefined;
+        seconds?: number | undefined;
+    }>, {
+        type: "cron" | "interval";
+        expression?: string | undefined;
+        seconds?: number | undefined;
+    }, {
+        type: "cron" | "interval";
+        expression?: string | undefined;
+        seconds?: number | undefined;
+    }>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    heartbeat: z.ZodOptional<z.ZodUnknown>;
+    probe: z.ZodOptional<z.ZodUnknown>;
+    cron: z.ZodOptional<z.ZodUnknown>;
+    goal_trigger: z.ZodOptional<z.ZodUnknown>;
+    metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    synced_at: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    trigger: {
+        type: "cron" | "interval";
+        expression?: string | undefined;
+        seconds?: number | undefined;
+    };
+    layer: "probe" | "cron" | "goal_trigger" | "heartbeat";
+    metadata: Record<string, unknown>;
+    enabled: boolean;
+    source_id: string;
+    external_id: string;
+    synced_at: string;
+    probe?: unknown;
+    cron?: unknown;
+    goal_trigger?: unknown;
+    heartbeat?: unknown;
+}, {
+    name: string;
+    trigger: {
+        type: "cron" | "interval";
+        expression?: string | undefined;
+        seconds?: number | undefined;
+    };
+    layer: "probe" | "cron" | "goal_trigger" | "heartbeat";
+    source_id: string;
+    external_id: string;
+    synced_at: string;
+    metadata?: Record<string, unknown> | undefined;
+    enabled?: boolean | undefined;
+    probe?: unknown;
+    cron?: unknown;
+    goal_trigger?: unknown;
+    heartbeat?: unknown;
+}>;
+export type ExternalScheduleEntry = z.infer<typeof ExternalScheduleEntrySchema>;
+export interface IScheduleSource {
+    readonly id: string;
+    readonly name: string;
+    fetchEntries(): Promise<ExternalScheduleEntry[]>;
+    healthCheck(): Promise<{
+        healthy: boolean;
+        error?: string;
+    }>;
+}
+//# sourceMappingURL=source.d.ts.map

package/dist/runtime/schedule/source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../../src/runtime/schedule/source.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoBtC,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAGhF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAGtB,YAAY,IAAI,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAAC;IAGjD,WAAW,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC9D"}

package/dist/runtime/schedule/source.js

@@ -0,0 +1,21 @@
+import { z } from "zod";
+// External schedule entry from a plugin source (e.g., Google Calendar, Jira)
+export const ExternalScheduleEntrySchema = z.object({
+    external_id: z.string(), // ID in the external system
+    source_id: z.string(), // which IScheduleSource provided this
+    name: z.string(),
+    layer: z.enum(['heartbeat', 'probe', 'cron', 'goal_trigger']),
+    trigger: z.object({
+        type: z.enum(['cron', 'interval']),
+        expression: z.string().optional(), // for cron type
+        seconds: z.number().optional(), // for interval type
+    }).refine((t) => (t.type === 'cron' ? !!t.expression : !!t.seconds), { message: 'cron trigger requires expression, interval trigger requires seconds' }),
+    enabled: z.boolean().default(true),
+    heartbeat: z.unknown().optional(),
+    probe: z.unknown().optional(),
+    cron: z.unknown().optional(),
+    goal_trigger: z.unknown().optional(),
+    metadata: z.record(z.unknown()).default({}), // source-specific data
+    synced_at: z.string().datetime(),
+});
+//# sourceMappingURL=source.js.map

package/dist/runtime/schedule/source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.js","sourceRoot":"","sources":["../../../src/runtime/schedule/source.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,6EAA6E;AAC7E,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,EAAY,4BAA4B;IAC/D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAc,sCAAsC;IACzE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC;IAC7D,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;QAChB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAClC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAG,gBAAgB;QACpD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAM,oBAAoB;KACzD,CAAC,CAAC,MAAM,CACP,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EACzD,EAAE,OAAO,EAAE,qEAAqE,EAAE,CACnF;IACD,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAClC,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACjC,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC7B,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC5B,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACpC,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,uBAAuB;IACpE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC"}

package/dist/runtime/schedule-engine.d.ts

@@ -0,0 +1,2 @@
+export * from "./schedule/engine.js";
+//# sourceMappingURL=schedule-engine.d.ts.map

package/dist/runtime/schedule-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-engine.d.ts","sourceRoot":"","sources":["../../src/runtime/schedule-engine.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC"}

package/dist/runtime/schedule-engine.js

@@ -0,0 +1,2 @@
+export * from "./schedule/engine.js";
+//# sourceMappingURL=schedule-engine.js.map

package/dist/runtime/schedule-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-engine.js","sourceRoot":"","sources":["../../src/runtime/schedule-engine.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC"}

package/dist/runtime/schedule-presets.d.ts

@@ -0,0 +1,2 @@
+export * from "./schedule/presets.js";
+//# sourceMappingURL=schedule-presets.d.ts.map

package/dist/runtime/schedule-presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-presets.d.ts","sourceRoot":"","sources":["../../src/runtime/schedule-presets.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC"}

package/dist/runtime/schedule-presets.js

@@ -0,0 +1,2 @@
+export * from "./schedule/presets.js";
+//# sourceMappingURL=schedule-presets.js.map

package/dist/runtime/schedule-presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-presets.js","sourceRoot":"","sources":["../../src/runtime/schedule-presets.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC"}

package/dist/runtime/skills/skill-parser.d.ts

@@ -0,0 +1,13 @@
+export type SkillSource = "home" | "workspace";
+export interface ParsedSkillFile {
+    id: string;
+    name: string;
+    description: string;
+    path: string;
+    relativePath: string;
+    source: SkillSource;
+}
+export declare function parseSkillFile(content: string, filePath: string, source: SkillSource, root: string): ParsedSkillFile;
+export declare function toSafeSkillId(value: string): string;
+export declare function isPathInside(root: string, candidate: string): boolean;
+//# sourceMappingURL=skill-parser.d.ts.map

package/dist/runtime/skills/skill-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-parser.d.ts","sourceRoot":"","sources":["../../../src/runtime/skills/skill-parser.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,WAAW,CAAC;AAE/C,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,MAAM,GACX,eAAe,CAejB;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CASnD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAKrE"}

package/dist/runtime/skills/skill-parser.js

@@ -0,0 +1,64 @@
+import * as path from "node:path";
+export function parseSkillFile(content, filePath, source, root) {
+    const parsed = splitFrontmatter(content);
+    const firstHeading = parsed.body.match(/^#\s+(.+)$/m)?.[1]?.trim();
+    const description = parsed.attributes.description ?? firstBodyText(parsed.body);
+    const name = firstHeading ?? parsed.attributes.name ?? path.basename(path.dirname(filePath));
+    const relativePath = path.relative(root, filePath);
+    return {
+        id: toSafeSkillId(path.dirname(relativePath)),
+        name,
+        description,
+        path: filePath,
+        relativePath,
+        source,
+    };
+}
+export function toSafeSkillId(value) {
+    const normalized = value
+        .replace(/\\/g, "/")
+        .split("/")
+        .filter(Boolean)
+        .map((part) => part.toLowerCase().replace(/[^a-z0-9._-]+/g, "-").replace(/^-+|-+$/g, ""))
+        .filter((part) => part.length > 0 && part !== "." && part !== "..")
+        .join("/");
+    return normalized === "." ? "" : normalized;
+}
+export function isPathInside(root, candidate) {
+    const resolvedRoot = path.resolve(root);
+    const resolvedCandidate = path.resolve(candidate);
+    const relative = path.relative(resolvedRoot, resolvedCandidate);
+    return relative === "" || (!relative.startsWith("..") && !path.isAbsolute(relative));
+}
+function splitFrontmatter(content) {
+    const lines = content.split(/\r?\n/);
+    if (lines[0]?.trim() !== "---") {
+        return { attributes: {}, body: content };
+    }
+    const end = lines.findIndex((line, index) => index > 0 && line.trim() === "---");
+    if (end < 0) {
+        return { attributes: {}, body: content };
+    }
+    const attributes = {};
+    for (const line of lines.slice(1, end)) {
+        const match = /^([A-Za-z_][A-Za-z0-9_-]*)\s*:\s*(.*)$/.exec(line);
+        if (!match)
+            continue;
+        const key = match[1].toLowerCase();
+        const value = match[2].trim().replace(/^['"]|['"]$/g, "");
+        if ((key === "name" || key === "description") && value.length > 0) {
+            attributes[key] = value;
+        }
+    }
+    return {
+        attributes,
+        body: lines.slice(end + 1).join("\n"),
+    };
+}
+function firstBodyText(body) {
+    return body
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .find((line) => line.length > 0 && !line.startsWith("#") && !line.startsWith("---")) ?? "";
+}
+//# sourceMappingURL=skill-parser.js.map

package/dist/runtime/skills/skill-parser.js.map

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

package/dist/runtime/skills/skill-registry.d.ts

@@ -0,0 +1,31 @@
+import { type SkillSource } from "./skill-parser.js";
+export interface SkillRecord {
+    id: string;
+    name: string;
+    description: string;
+    path: string;
+    relativePath: string;
+    source: SkillSource;
+}
+export interface SkillRegistryOptions {
+    homeSkillsDir?: string;
+    workspaceRoot?: string;
+}
+export declare class SkillRegistry {
+    private readonly homeSkillsDir;
+    private readonly workspaceRoot;
+    constructor(options?: SkillRegistryOptions);
+    list(): Promise<SkillRecord[]>;
+    search(query: string): Promise<SkillRecord[]>;
+    get(idOrName: string): Promise<SkillRecord | null>;
+    read(idOrName: string): Promise<{
+        skill: SkillRecord;
+        body: string;
+    } | null>;
+    install(sourcePath: string, options?: {
+        namespace?: string;
+        force?: boolean;
+    }): Promise<SkillRecord>;
+    private scanRoot;
+}
+//# sourceMappingURL=skill-registry.d.ts.map

package/dist/runtime/skills/skill-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-registry.d.ts","sourceRoot":"","sources":["../../../src/runtime/skills/skill-registry.ts"],"names":[],"mappings":"AAIA,OAAO,EAIL,KAAK,WAAW,EACjB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqB;gBAEvC,OAAO,GAAE,oBAAyB;IAKxC,IAAI,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAW9B,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAY7C,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IASlD,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,WAAW,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAM5E,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO,CAAC,WAAW,CAAC;YA4BhG,QAAQ;CAavB"}

package/dist/runtime/skills/skill-registry.js

@@ -0,0 +1,108 @@
+import * as fsp from "node:fs/promises";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { getSkillsDir } from "../../base/utils/paths.js";
+import { isPathInside, parseSkillFile, toSafeSkillId, } from "./skill-parser.js";
+export class SkillRegistry {
+    homeSkillsDir;
+    workspaceRoot;
+    constructor(options = {}) {
+        this.homeSkillsDir = options.homeSkillsDir ?? getSkillsDir();
+        this.workspaceRoot = options.workspaceRoot;
+    }
+    async list() {
+        const home = await this.scanRoot(this.homeSkillsDir, "home");
+        const workspaceSkillsDir = this.workspaceRoot
+            ? path.join(this.workspaceRoot, "skills")
+            : undefined;
+        const workspace = workspaceSkillsDir
+            ? await this.scanRoot(workspaceSkillsDir, "workspace")
+            : [];
+        return [...home, ...workspace].sort((a, b) => a.id.localeCompare(b.id));
+    }
+    async search(query) {
+        const normalized = query.trim().toLowerCase();
+        if (!normalized)
+            return [];
+        const skills = await this.list();
+        return skills.filter((skill) => [
+            skill.id,
+            skill.name,
+            skill.description,
+            skill.relativePath,
+        ].some((value) => value.toLowerCase().includes(normalized)));
+    }
+    async get(idOrName) {
+        const normalized = idOrName.trim().toLowerCase();
+        const skills = await this.list();
+        return skills.find((skill) => skill.id.toLowerCase() === normalized ||
+            skill.name.toLowerCase() === normalized) ?? null;
+    }
+    async read(idOrName) {
+        const skill = await this.get(idOrName);
+        if (!skill)
+            return null;
+        return { skill, body: await fsp.readFile(skill.path, "utf-8") };
+    }
+    async install(sourcePath, options = {}) {
+        const stat = await fsp.stat(sourcePath);
+        const skillFile = stat.isDirectory() ? path.join(sourcePath, "SKILL.md") : sourcePath;
+        if (!skillFile.endsWith("SKILL.md")) {
+            throw new Error("skill install source must be a SKILL.md file or a directory containing SKILL.md");
+        }
+        const content = await fsp.readFile(skillFile, "utf-8");
+        const parsed = parseSkillFile(content, skillFile, "home", path.dirname(skillFile));
+        const namespace = toSafeSkillId(options.namespace?.trim() || "imported") || "imported";
+        const parsedId = parsed.id === "." ? "" : parsed.id;
+        const safeName = toSafeSkillId(parsedId || path.basename(path.dirname(skillFile)) || parsed.name);
+        const destDir = path.join(this.homeSkillsDir, namespace, safeName);
+        const destFile = path.join(destDir, "SKILL.md");
+        if (!isPathInside(this.homeSkillsDir, destFile)) {
+            throw new Error("skill install destination must stay inside the skills directory");
+        }
+        if (fs.existsSync(destFile) && !options.force) {
+            throw new Error(`skill "${namespace}/${safeName}" already exists; use --force to overwrite`);
+        }
+        await fsp.mkdir(destDir, { recursive: true });
+        await fsp.copyFile(skillFile, destFile);
+        return {
+            ...parseSkillFile(content, destFile, "home", this.homeSkillsDir),
+            id: `${namespace}/${safeName}`,
+            relativePath: path.relative(this.homeSkillsDir, destFile),
+        };
+    }
+    async scanRoot(root, source) {
+        const found = [];
+        await walk(root, async (file) => {
+            if (path.basename(file) !== "SKILL.md")
+                return;
+            try {
+                const content = await fsp.readFile(file, "utf-8");
+                found.push(parseSkillFile(content, file, source, root));
+            }
+            catch {
+                // Ignore unreadable skill files while keeping the registry usable.
+            }
+        });
+        return found;
+    }
+}
+async function walk(root, visit) {
+    let entries;
+    try {
+        entries = await fsp.readdir(root, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        const fullPath = path.join(root, entry.name);
+        if (entry.isDirectory()) {
+            await walk(fullPath, visit);
+        }
+        else if (entry.isFile()) {
+            await visit(fullPath);
+        }
+    }
+}
+//# sourceMappingURL=skill-registry.js.map

package/dist/runtime/skills/skill-registry.js.map

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

package/dist/runtime/store/approval-store.d.ts

@@ -0,0 +1,33 @@
+import { type ApprovalRecord, type ApprovalState } from "./runtime-schemas.js";
+import { type RuntimeStorePaths } from "./runtime-paths.js";
+export interface ApprovalResolutionInput {
+    state: Exclude<ApprovalState, "pending">;
+    resolved_at?: number;
+    response_channel?: string;
+    payload?: unknown;
+}
+export declare class ApprovalStore {
+    private readonly paths;
+    private readonly journal;
+    constructor(runtimeRootOrPaths?: string | RuntimeStorePaths);
+    private sleep;
+    private lockPath;
+    private withApprovalLock;
+    ensureReady(): Promise<void>;
+    load(approvalId: string): Promise<ApprovalRecord | null>;
+    loadPending(approvalId: string): Promise<ApprovalRecord | null>;
+    loadResolved(approvalId: string): Promise<ApprovalRecord | null>;
+    listPending(): Promise<ApprovalRecord[]>;
+    listResolved(): Promise<ApprovalRecord[]>;
+    removePending(approvalId: string): Promise<void>;
+    removeResolved(approvalId: string): Promise<void>;
+    savePending(record: ApprovalRecord): Promise<ApprovalRecord>;
+    saveResolved(record: ApprovalRecord): Promise<ApprovalRecord>;
+    resolvePending(approvalId: string, update: ApprovalResolutionInput): Promise<ApprovalRecord | null>;
+    reconcile(now?: number): Promise<{
+        removedPending: number;
+        expiredPending: number;
+    }>;
+    pruneResolved(olderThanMs: number, now?: number): Promise<number>;
+}
+//# sourceMappingURL=approval-store.d.ts.map

package/dist/runtime/store/approval-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-store.d.ts","sourceRoot":"","sources":["../../../src/runtime/store/approval-store.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,OAAO,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;gBAE7B,kBAAkB,CAAC,EAAE,MAAM,GAAG,iBAAiB;YAQ7C,KAAK;IAInB,OAAO,CAAC,QAAQ;YAIF,gBAAgB;IAkCxB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAIxD,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAI/D,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAIhE,WAAW,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAUxC,YAAY,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAIzC,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhD,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjD,WAAW,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAU5D,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAU7D,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAkBnG,SAAS,CAAC,GAAG,SAAa,GAAG,OAAO,CAAC;QACzC,cAAc,EAAE,MAAM,CAAC;QACvB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IA6BI,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,SAAa,GAAG,OAAO,CAAC,MAAM,CAAC;CAiB5E"}