pulseed 0.4.14 → 0.4.16

package/dist/runtime/interactive-automation/providers/manus-browser.js

@@ -0,0 +1,88 @@
+const DEFAULT_BASE_URL = "https://api.manus.im";
+export class ManusBrowserProvider {
+    id = "manus_browser";
+    family = "browser";
+    capabilities = [
+        "browser_control",
+        "cloud_browser",
+        "local_browser_session",
+        "agentic_workflow",
+    ];
+    apiKey;
+    baseUrl;
+    fetchFn;
+    constructor(options = {}) {
+        this.apiKey = options.apiKey ?? process.env["MANUS_API_KEY"];
+        this.baseUrl = (options.baseUrl ?? process.env["MANUS_BASE_URL"] ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+        this.fetchFn = options.fetch ?? globalThis.fetch.bind(globalThis);
+    }
+    async isAvailable() {
+        if (!this.apiKey) {
+            return { available: false, reason: "MANUS_API_KEY is not configured" };
+        }
+        return { available: true };
+    }
+    async describeEnvironment() {
+        const availability = await this.isAvailable();
+        return {
+            providerId: this.id,
+            family: this.family,
+            capabilities: [...this.capabilities],
+            available: availability.available,
+            ...(availability.reason ? { reason: availability.reason } : {}),
+        };
+    }
+    async runBrowserWorkflow(input) {
+        this.assertAvailable();
+        const response = await this.fetchJson(`${this.baseUrl}/browser/workflows`, {
+            task: input.task,
+            start_url: input.startUrl,
+            session_id: input.sessionId,
+        });
+        return normalizeBrowserResult(response, "Manus browser workflow submitted");
+    }
+    async getBrowserState(input) {
+        this.assertAvailable();
+        const query = input.sessionId ? `?session_id=${encodeURIComponent(input.sessionId)}` : "";
+        const response = await this.fetchJson(`${this.baseUrl}/browser/state${query}`, undefined, "GET");
+        return normalizeBrowserResult(response, "Manus browser state fetched");
+    }
+    assertAvailable() {
+        if (!this.apiKey) {
+            throw new Error("MANUS_API_KEY is not configured");
+        }
+    }
+    async fetchJson(url, body, method = "POST") {
+        const response = await this.fetchFn(url, {
+            method,
+            headers: {
+                "authorization": `Bearer ${this.apiKey}`,
+                "content-type": "application/json",
+            },
+            ...(body === undefined ? {} : { body: JSON.stringify(body) }),
+        });
+        if (!response.ok) {
+            throw new Error(`Manus request failed with HTTP ${response.status}`);
+        }
+        return response.json();
+    }
+}
+function normalizeBrowserResult(raw, fallbackSummary) {
+    const source = raw;
+    const success = typeof source["success"] === "boolean" ? source["success"] : true;
+    const summary = typeof source["summary"] === "string" ? source["summary"] : fallbackSummary;
+    const sessionId = typeof source["session_id"] === "string"
+        ? source["session_id"]
+        : typeof source["sessionId"] === "string"
+            ? source["sessionId"]
+            : undefined;
+    const error = typeof source["error"] === "string" ? source["error"] : undefined;
+    return {
+        success,
+        summary,
+        ...(sessionId ? { sessionId } : {}),
+        data: raw,
+        ...(error ? { error } : {}),
+    };
+}
+//# sourceMappingURL=manus-browser.js.map

package/dist/runtime/interactive-automation/providers/manus-browser.js.map

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

package/dist/runtime/interactive-automation/providers/noop.d.ts

@@ -0,0 +1,21 @@
+import type { AppStateSnapshot, AutomationActionResult, AutomationEnvironment, BrowserStateInput, BrowserWorkflowInput, BrowserWorkflowResult, ClickInput, DesktopAppSummary, DragInput, GetAppStateInput, InteractiveAutomationCapability, InteractiveAutomationProvider, InteractiveAutomationProviderFamily, PressKeyInput, ProviderAvailability, ResearchAnswerInput, ResearchAnswerResult, ResearchWebInput, ResearchWebResult, ScrollInput, SetValueInput, TypeTextInput } from "../types.js";
+export declare class NoopInteractiveAutomationProvider implements InteractiveAutomationProvider {
+    readonly id = "noop";
+    readonly family: InteractiveAutomationProviderFamily;
+    readonly capabilities: readonly InteractiveAutomationCapability[];
+    isAvailable(): Promise<ProviderAvailability>;
+    describeEnvironment(): Promise<AutomationEnvironment>;
+    listApps(): Promise<DesktopAppSummary[]>;
+    getAppState(input: GetAppStateInput): Promise<AppStateSnapshot>;
+    click(_input: ClickInput): Promise<AutomationActionResult>;
+    typeText(_input: TypeTextInput): Promise<AutomationActionResult>;
+    pressKey(_input: PressKeyInput): Promise<AutomationActionResult>;
+    scroll(_input: ScrollInput): Promise<AutomationActionResult>;
+    drag(_input: DragInput): Promise<AutomationActionResult>;
+    setValue(_input: SetValueInput): Promise<AutomationActionResult>;
+    researchWeb(input: ResearchWebInput): Promise<ResearchWebResult>;
+    answerWithSources(_input: ResearchAnswerInput): Promise<ResearchAnswerResult>;
+    runBrowserWorkflow(_input: BrowserWorkflowInput): Promise<BrowserWorkflowResult>;
+    getBrowserState(_input: BrowserStateInput): Promise<BrowserWorkflowResult>;
+}
+//# sourceMappingURL=noop.d.ts.map

package/dist/runtime/interactive-automation/providers/noop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop.d.ts","sourceRoot":"","sources":["../../../../src/runtime/interactive-automation/providers/noop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,sBAAsB,EACtB,qBAAqB,EACrB,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACrB,UAAU,EACV,iBAAiB,EACjB,SAAS,EACT,gBAAgB,EAChB,+BAA+B,EAC/B,6BAA6B,EAC7B,mCAAmC,EACnC,aAAa,EACb,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,aAAa,EACb,aAAa,EACd,MAAM,aAAa,CAAC;AAKrB,qBAAa,iCAAkC,YAAW,6BAA6B;IACrF,QAAQ,CAAC,EAAE,UAAU;IACrB,QAAQ,CAAC,MAAM,EAAE,mCAAmC,CAAW;IAC/D,QAAQ,CAAC,YAAY,EAAE,SAAS,+BAA+B,EAAE,CAAM;IAEjE,WAAW,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAI5C,mBAAmB,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAUrD,QAAQ,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAIxC,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAO/D,KAAK,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAI1D,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAIhE,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAIhE,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAI5D,IAAI,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAIxD,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAIhE,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAIhE,iBAAiB,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAI7E,kBAAkB,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAIhF,eAAe,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAGjF"}

package/dist/runtime/interactive-automation/providers/noop.js

@@ -0,0 +1,59 @@
+import { unavailableAction } from "../types.js";
+const NOOP_REASON = "no interactive automation provider is configured";
+export class NoopInteractiveAutomationProvider {
+    id = "noop";
+    family = "agent";
+    capabilities = [];
+    async isAvailable() {
+        return { available: false, reason: NOOP_REASON };
+    }
+    async describeEnvironment() {
+        return {
+            providerId: this.id,
+            family: this.family,
+            capabilities: [...this.capabilities],
+            available: false,
+            reason: NOOP_REASON,
+        };
+    }
+    async listApps() {
+        return [];
+    }
+    async getAppState(input) {
+        return {
+            app: input.app,
+            metadata: { available: false, reason: NOOP_REASON },
+        };
+    }
+    async click(_input) {
+        return unavailableAction(this.id, NOOP_REASON);
+    }
+    async typeText(_input) {
+        return unavailableAction(this.id, NOOP_REASON);
+    }
+    async pressKey(_input) {
+        return unavailableAction(this.id, NOOP_REASON);
+    }
+    async scroll(_input) {
+        return unavailableAction(this.id, NOOP_REASON);
+    }
+    async drag(_input) {
+        return unavailableAction(this.id, NOOP_REASON);
+    }
+    async setValue(_input) {
+        return unavailableAction(this.id, NOOP_REASON);
+    }
+    async researchWeb(input) {
+        return { query: input.query, results: [], raw: { available: false, reason: NOOP_REASON } };
+    }
+    async answerWithSources(_input) {
+        return { answer: "", citations: [], raw: { available: false, reason: NOOP_REASON } };
+    }
+    async runBrowserWorkflow(_input) {
+        return unavailableAction(this.id, NOOP_REASON);
+    }
+    async getBrowserState(_input) {
+        return unavailableAction(this.id, NOOP_REASON);
+    }
+}
+//# sourceMappingURL=noop.js.map

package/dist/runtime/interactive-automation/providers/noop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop.js","sourceRoot":"","sources":["../../../../src/runtime/interactive-automation/providers/noop.ts"],"names":[],"mappings":"AAwBA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,WAAW,GAAG,kDAAkD,CAAC;AAEvE,MAAM,OAAO,iCAAiC;IACnC,EAAE,GAAG,MAAM,CAAC;IACZ,MAAM,GAAwC,OAAO,CAAC;IACtD,YAAY,GAA+C,EAAE,CAAC;IAEvE,KAAK,CAAC,WAAW;QACf,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,mBAAmB;QACvB,OAAO;YACL,UAAU,EAAE,IAAI,CAAC,EAAE;YACnB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,YAAY,EAAE,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC;YACpC,SAAS,EAAE,KAAK;YAChB,MAAM,EAAE,WAAW;SACpB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,KAAuB;QACvC,OAAO;YACL,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,QAAQ,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE;SACpD,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,MAAkB;QAC5B,OAAO,iBAAiB,CAAC,IAAI,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAqB;QAClC,OAAO,iBAAiB,CAAC,IAAI,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAqB;QAClC,OAAO,iBAAiB,CAAC,IAAI,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAAmB;QAC9B,OAAO,iBAAiB,CAAC,IAAI,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAAiB;QAC1B,OAAO,iBAAiB,CAAC,IAAI,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAqB;QAClC,OAAO,iBAAiB,CAAC,IAAI,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,KAAuB;QACvC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,CAAC;IAC7F,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,MAA2B;QACjD,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,CAAC;IACvF,CAAC;IAED,KAAK,CAAC,kBAAkB,CAAC,MAA4B;QACnD,OAAO,iBAAiB,CAAC,IAAI,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,MAAyB;QAC7C,OAAO,iBAAiB,CAAC,IAAI,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;IACjD,CAAC;CACF"}

package/dist/runtime/interactive-automation/providers/perplexity-research.d.ts

@@ -0,0 +1,25 @@
+import type { AutomationEnvironment, InteractiveAutomationCapability, InteractiveAutomationProvider, ProviderAvailability, ResearchAnswerInput, ResearchAnswerResult, ResearchWebInput, ResearchWebResult } from "../types.js";
+export type AutomationFetch = (input: string | URL, init?: RequestInit) => Promise<Response>;
+export interface PerplexityResearchProviderOptions {
+    apiKey?: string;
+    baseUrl?: string;
+    model?: string;
+    fetch?: AutomationFetch;
+}
+export declare class PerplexityResearchProvider implements InteractiveAutomationProvider {
+    readonly id = "perplexity_research";
+    readonly family: "research";
+    readonly capabilities: readonly InteractiveAutomationCapability[];
+    private readonly apiKey?;
+    private readonly baseUrl;
+    private readonly model;
+    private readonly fetchFn;
+    constructor(options?: PerplexityResearchProviderOptions);
+    isAvailable(): Promise<ProviderAvailability>;
+    describeEnvironment(): Promise<AutomationEnvironment>;
+    researchWeb(input: ResearchWebInput): Promise<ResearchWebResult>;
+    answerWithSources(input: ResearchAnswerInput): Promise<ResearchAnswerResult>;
+    private assertAvailable;
+    private fetchJson;
+}
+//# sourceMappingURL=perplexity-research.d.ts.map

package/dist/runtime/interactive-automation/providers/perplexity-research.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"perplexity-research.d.ts","sourceRoot":"","sources":["../../../../src/runtime/interactive-automation/providers/perplexity-research.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,+BAA+B,EAC/B,6BAA6B,EAC7B,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EAEpB,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAE7F,MAAM,WAAW,iCAAiC;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB;AAKD,qBAAa,0BAA2B,YAAW,6BAA6B;IAC9E,QAAQ,CAAC,EAAE,yBAAyB;IACpC,QAAQ,CAAC,MAAM,EAAG,UAAU,CAAU;IACtC,QAAQ,CAAC,YAAY,EAAE,SAAS,+BAA+B,EAAE,CAAoB;IAErF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;gBAE9B,OAAO,GAAE,iCAAsC;IAOrD,WAAW,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAO5C,mBAAmB,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAWrD,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAehE,iBAAiB,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAalF,OAAO,CAAC,eAAe;YAMT,SAAS;CAgBxB"}

package/dist/runtime/interactive-automation/providers/perplexity-research.js

@@ -0,0 +1,124 @@
+const DEFAULT_BASE_URL = "https://api.perplexity.ai";
+const DEFAULT_MODEL = "sonar";
+export class PerplexityResearchProvider {
+    id = "perplexity_research";
+    family = "research";
+    capabilities = ["web_research"];
+    apiKey;
+    baseUrl;
+    model;
+    fetchFn;
+    constructor(options = {}) {
+        this.apiKey = options.apiKey ?? process.env["PERPLEXITY_API_KEY"];
+        this.baseUrl = trimTrailingSlash(options.baseUrl ?? process.env["PERPLEXITY_BASE_URL"] ?? DEFAULT_BASE_URL);
+        this.model = options.model ?? process.env["PERPLEXITY_MODEL"] ?? DEFAULT_MODEL;
+        this.fetchFn = options.fetch ?? globalThis.fetch.bind(globalThis);
+    }
+    async isAvailable() {
+        if (!this.apiKey) {
+            return { available: false, reason: "PERPLEXITY_API_KEY is not configured" };
+        }
+        return { available: true };
+    }
+    async describeEnvironment() {
+        const availability = await this.isAvailable();
+        return {
+            providerId: this.id,
+            family: this.family,
+            capabilities: [...this.capabilities],
+            available: availability.available,
+            ...(availability.reason ? { reason: availability.reason } : {}),
+        };
+    }
+    async researchWeb(input) {
+        this.assertAvailable();
+        const response = await this.fetchJson(`${this.baseUrl}/search`, {
+            query: input.query,
+            max_results: input.maxResults,
+            domains: input.domains,
+        });
+        return {
+            query: input.query,
+            results: normalizeSearchResults(response),
+            citations: collectCitations(response),
+            raw: response,
+        };
+    }
+    async answerWithSources(input) {
+        this.assertAvailable();
+        const response = await this.fetchJson(`${this.baseUrl}/chat/completions`, {
+            model: input.model ?? this.model,
+            messages: [{ role: "user", content: input.question }],
+        });
+        return {
+            answer: extractAnswer(response),
+            citations: collectCitations(response),
+            raw: response,
+        };
+    }
+    assertAvailable() {
+        if (!this.apiKey) {
+            throw new Error("PERPLEXITY_API_KEY is not configured");
+        }
+    }
+    async fetchJson(url, body) {
+        const response = await this.fetchFn(url, {
+            method: "POST",
+            headers: {
+                "authorization": `Bearer ${this.apiKey}`,
+                "content-type": "application/json",
+            },
+            body: JSON.stringify(body),
+        });
+        if (!response.ok) {
+            throw new Error(`Perplexity request failed with HTTP ${response.status}`);
+        }
+        return response.json();
+    }
+}
+function trimTrailingSlash(value) {
+    return value.replace(/\/+$/, "");
+}
+function normalizeSearchResults(raw) {
+    const source = raw;
+    const candidates = Array.isArray(source["results"]) ? source["results"]
+        : Array.isArray(source["data"]) ? source["data"]
+            : [];
+    return candidates
+        .filter((item) => typeof item === "object" && item !== null)
+        .map((item) => ({
+        title: stringOrFallback(item["title"], stringOrFallback(item["name"], "Untitled")),
+        url: stringOrFallback(item["url"], ""),
+        snippet: optionalString(item["snippet"] ?? item["text"] ?? item["description"]),
+        source: optionalString(item["source"]),
+    }))
+        .filter((item) => item.url.length > 0);
+}
+function extractAnswer(raw) {
+    const source = raw;
+    const choices = source["choices"];
+    if (Array.isArray(choices)) {
+        const first = choices[0];
+        const message = first?.["message"];
+        const content = message?.["content"];
+        if (typeof content === "string")
+            return content;
+    }
+    const answer = source["answer"];
+    return typeof answer === "string" ? answer : "";
+}
+function collectCitations(raw) {
+    const source = raw;
+    const citations = source["citations"];
+    if (Array.isArray(citations)) {
+        return citations.filter((item) => typeof item === "string");
+    }
+    return normalizeSearchResults(raw).map((item) => item.url);
+}
+function optionalString(value) {
+    return typeof value === "string" ? value : undefined;
+}
+function stringOrFallback(value, fallback) {
+    return typeof value === "string" && value.length > 0 ? value : fallback;
+}
+//# sourceMappingURL=perplexity-research.js.map

package/dist/runtime/interactive-automation/providers/perplexity-research.js.map

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

package/dist/runtime/interactive-automation/registry.d.ts

@@ -0,0 +1,20 @@
+import type { InteractiveAutomationCapability, InteractiveAutomationProvider, InteractiveAutomationProviderFamily } from "./types.js";
+export interface ResolveAutomationProviderInput {
+    providerId?: string;
+    family?: InteractiveAutomationProviderFamily;
+    capability?: InteractiveAutomationCapability;
+}
+export interface InteractiveAutomationRegistryOptions {
+    defaultProviders?: Partial<Record<InteractiveAutomationProviderFamily, string>>;
+}
+export declare class InteractiveAutomationRegistry {
+    private readonly providers;
+    private readonly defaultProviders;
+    constructor(options?: InteractiveAutomationRegistryOptions);
+    register(provider: InteractiveAutomationProvider): void;
+    get(providerId: string): InteractiveAutomationProvider | undefined;
+    list(): InteractiveAutomationProvider[];
+    setDefaultProvider(family: InteractiveAutomationProviderFamily, providerId: string): void;
+    resolve(input: ResolveAutomationProviderInput): InteractiveAutomationProvider | undefined;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/runtime/interactive-automation/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/runtime/interactive-automation/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,+BAA+B,EAC/B,6BAA6B,EAC7B,mCAAmC,EACpC,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,8BAA8B;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,mCAAmC,CAAC;IAC7C,UAAU,CAAC,EAAE,+BAA+B,CAAC;CAC9C;AAED,MAAM,WAAW,oCAAoC;IACnD,gBAAgB,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,mCAAmC,EAAE,MAAM,CAAC,CAAC,CAAC;CACjF;AAED,qBAAa,6BAA6B;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoD;IAC9E,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA+D;gBAEpF,OAAO,GAAE,oCAAyC;IAI9D,QAAQ,CAAC,QAAQ,EAAE,6BAA6B,GAAG,IAAI;IAOvD,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,6BAA6B,GAAG,SAAS;IAIlE,IAAI,IAAI,6BAA6B,EAAE;IAIvC,kBAAkB,CAAC,MAAM,EAAE,mCAAmC,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAOzF,OAAO,CAAC,KAAK,EAAE,8BAA8B,GAAG,6BAA6B,GAAG,SAAS;CAqB1F"}

package/dist/runtime/interactive-automation/registry.js

@@ -0,0 +1,55 @@
+export class InteractiveAutomationRegistry {
+    providers = new Map();
+    defaultProviders;
+    constructor(options = {}) {
+        this.defaultProviders = { ...options.defaultProviders };
+    }
+    register(provider) {
+        if (this.providers.has(provider.id)) {
+            throw new Error(`Interactive automation provider "${provider.id}" is already registered`);
+        }
+        this.providers.set(provider.id, provider);
+    }
+    get(providerId) {
+        return this.providers.get(providerId);
+    }
+    list() {
+        return [...this.providers.values()];
+    }
+    setDefaultProvider(family, providerId) {
+        if (!this.providers.has(providerId)) {
+            throw new Error(`Interactive automation provider "${providerId}" is not registered`);
+        }
+        this.defaultProviders[family] = providerId;
+    }
+    resolve(input) {
+        if (input.providerId) {
+            return this.providers.get(input.providerId);
+        }
+        if (input.family) {
+            if (hasConfiguredDefault(this.defaultProviders, input.family)) {
+                const defaultId = this.defaultProviders[input.family];
+                const defaultProvider = defaultId ? this.providers.get(defaultId) : undefined;
+                if (!defaultProvider) {
+                    return undefined;
+                }
+                if (providerMatches(defaultProvider, input) || defaultProvider.id === "noop") {
+                    return defaultProvider;
+                }
+                return undefined;
+            }
+        }
+        return this.list().find((provider) => providerMatches(provider, input));
+    }
+}
+function hasConfiguredDefault(defaults, family) {
+    return Object.prototype.hasOwnProperty.call(defaults, family);
+}
+function providerMatches(provider, input) {
+    if (input.family && provider.family !== input.family)
+        return false;
+    if (input.capability && !provider.capabilities.includes(input.capability))
+        return false;
+    return true;
+}
+//# sourceMappingURL=registry.js.map

package/dist/runtime/interactive-automation/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/runtime/interactive-automation/registry.ts"],"names":[],"mappings":"AAgBA,MAAM,OAAO,6BAA6B;IACvB,SAAS,GAAG,IAAI,GAAG,EAAyC,CAAC;IAC7D,gBAAgB,CAA+D;IAEhG,YAAY,UAAgD,EAAE;QAC5D,IAAI,CAAC,gBAAgB,GAAG,EAAE,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAC1D,CAAC;IAED,QAAQ,CAAC,QAAuC;QAC9C,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,oCAAoC,QAAQ,CAAC,EAAE,yBAAyB,CAAC,CAAC;QAC5F,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IAC5C,CAAC;IAED,GAAG,CAAC,UAAkB;QACpB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACxC,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;IACtC,CAAC;IAED,kBAAkB,CAAC,MAA2C,EAAE,UAAkB;QAChF,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,oCAAoC,UAAU,qBAAqB,CAAC,CAAC;QACvF,CAAC;QACD,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,GAAG,UAAU,CAAC;IAC7C,CAAC;IAED,OAAO,CAAC,KAAqC;QAC3C,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;YACrB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC9C,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YACjB,IAAI,oBAAoB,CAAC,IAAI,CAAC,gBAAgB,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC9D,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;gBACtD,MAAM,eAAe,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;gBAC9E,IAAI,CAAC,eAAe,EAAE,CAAC;oBACrB,OAAO,SAAS,CAAC;gBACnB,CAAC;gBACD,IAAI,eAAe,CAAC,eAAe,EAAE,KAAK,CAAC,IAAI,eAAe,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;oBAC7E,OAAO,eAAe,CAAC;gBACzB,CAAC;gBACD,OAAO,SAAS,CAAC;YACnB,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,eAAe,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;IAC1E,CAAC;CACF;AAED,SAAS,oBAAoB,CAC3B,QAAsE,EACtE,MAA2C;IAE3C,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,eAAe,CACtB,QAAuC,EACvC,KAAqC;IAErC,IAAI,KAAK,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IACnE,IAAI,KAAK,CAAC,UAAU,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC;QAAE,OAAO,KAAK,CAAC;IACxF,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/runtime/interactive-automation/types.d.ts

@@ -0,0 +1,132 @@
+export type InteractiveAutomationProviderFamily = "desktop" | "browser" | "agent" | "research";
+export type InteractiveAutomationCapability = "desktop_state" | "desktop_input" | "browser_control" | "cloud_browser" | "local_browser_session" | "web_research" | "agentic_workflow" | "code_workspace";
+export interface ProviderAvailability {
+    available: boolean;
+    reason?: string;
+}
+export interface AutomationEnvironment {
+    providerId: string;
+    family: InteractiveAutomationProviderFamily;
+    capabilities: InteractiveAutomationCapability[];
+    available: boolean;
+    reason?: string;
+}
+export interface DesktopAppSummary {
+    name: string;
+    appId?: string;
+    title?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface GetAppStateInput {
+    app: string;
+}
+export interface AppStateSnapshot {
+    app: string;
+    title?: string;
+    screenshotPath?: string;
+    accessibilityTree?: unknown;
+    elements?: unknown[];
+    metadata?: Record<string, unknown>;
+}
+export interface ClickInput {
+    app: string;
+    elementId?: string;
+    x?: number;
+    y?: number;
+    button?: "left" | "right" | "middle";
+    clickCount?: number;
+}
+export interface TypeTextInput {
+    app: string;
+    text: string;
+}
+export interface PressKeyInput {
+    app: string;
+    key: string;
+}
+export interface ScrollInput {
+    app: string;
+    direction: "up" | "down" | "left" | "right";
+    elementId?: string;
+    pages?: number;
+}
+export interface DragInput {
+    app: string;
+    fromX: number;
+    fromY: number;
+    toX: number;
+    toY: number;
+}
+export interface SetValueInput {
+    app: string;
+    elementId: string;
+    value: string;
+}
+export interface AutomationActionResult {
+    success: boolean;
+    summary: string;
+    data?: unknown;
+    error?: string;
+}
+export interface ResearchWebInput {
+    query: string;
+    maxResults?: number;
+    domains?: string[];
+}
+export interface ResearchResultItem {
+    title: string;
+    url: string;
+    snippet?: string;
+    source?: string;
+}
+export interface ResearchWebResult {
+    query: string;
+    results: ResearchResultItem[];
+    citations?: string[];
+    raw?: unknown;
+}
+export interface ResearchAnswerInput {
+    question: string;
+    model?: string;
+}
+export interface ResearchAnswerResult {
+    answer: string;
+    citations: string[];
+    raw?: unknown;
+}
+export interface BrowserWorkflowInput {
+    task: string;
+    startUrl?: string;
+    sessionId?: string;
+}
+export interface BrowserStateInput {
+    sessionId?: string;
+}
+export interface BrowserWorkflowResult {
+    success: boolean;
+    summary: string;
+    sessionId?: string;
+    data?: unknown;
+    error?: string;
+}
+export interface InteractiveAutomationProvider {
+    readonly id: string;
+    readonly family: InteractiveAutomationProviderFamily;
+    readonly capabilities: readonly InteractiveAutomationCapability[];
+    isAvailable(): Promise<ProviderAvailability>;
+    describeEnvironment(): Promise<AutomationEnvironment>;
+    listApps?(): Promise<DesktopAppSummary[]>;
+    getAppState?(input: GetAppStateInput): Promise<AppStateSnapshot>;
+    click?(input: ClickInput): Promise<AutomationActionResult>;
+    typeText?(input: TypeTextInput): Promise<AutomationActionResult>;
+    pressKey?(input: PressKeyInput): Promise<AutomationActionResult>;
+    scroll?(input: ScrollInput): Promise<AutomationActionResult>;
+    drag?(input: DragInput): Promise<AutomationActionResult>;
+    setValue?(input: SetValueInput): Promise<AutomationActionResult>;
+    researchWeb?(input: ResearchWebInput): Promise<ResearchWebResult>;
+    answerWithSources?(input: ResearchAnswerInput): Promise<ResearchAnswerResult>;
+    runBrowserWorkflow?(input: BrowserWorkflowInput): Promise<BrowserWorkflowResult>;
+    getBrowserState?(input: BrowserStateInput): Promise<BrowserWorkflowResult>;
+}
+export declare function unavailableAction(providerId: string, reason: string): AutomationActionResult;
+//# sourceMappingURL=types.d.ts.map

package/dist/runtime/interactive-automation/types.d.ts.map

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

package/dist/runtime/interactive-automation/types.js

@@ -0,0 +1,8 @@
+export function unavailableAction(providerId, reason) {
+    return {
+        success: false,
+        summary: `${providerId} is unavailable: ${reason}`,
+        error: reason,
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/runtime/interactive-automation/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/runtime/interactive-automation/types.ts"],"names":[],"mappings":"AAyKA,MAAM,UAAU,iBAAiB,CAAC,UAAkB,EAAE,MAAc;IAClE,OAAO;QACL,OAAO,EAAE,KAAK;QACd,OAAO,EAAE,GAAG,UAAU,oBAAoB,MAAM,EAAE;QAClD,KAAK,EAAE,MAAM;KACd,CAAC;AACJ,CAAC"}

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

@@ -68,9 +68,20 @@ export declare class ScheduleEngine {
     private memoryLifecycle?;
     private knowledgeManager?;
     private historyStore;
+    private schedulesLockPath;
+    private scheduleLockDepth;
     constructor(deps: ScheduleEngineDeps);
     loadEntries(): Promise<ScheduleEntry[]>;
+    private readEntriesFromDisk;
     saveEntries(): Promise<void>;
+    private writeEntriesAndProject;
+    private refreshEntriesForMutation;
+    private captureExecutionSideEffects;
+    private applyExecutionSideEffects;
+    private withScheduleMutation;
+    private withScheduleFileLock;
+    private acquireScheduleFileLock;
+    private removeStaleScheduleLock;
     ensureSoilPublishSchedule(): Promise<ScheduleEntry | null>;
     private projectCurrentSchedulesToSoil;
     getEntries(): ScheduleEntry[];
@@ -86,6 +97,7 @@ export declare class ScheduleEngine {
         }>;
     }>;
     addEntry(input: Omit<ScheduleEntryInput, "id" | "created_at" | "updated_at" | "last_fired_at" | "next_fire_at" | "consecutive_failures" | "last_escalation_at" | "baseline_results" | "total_executions" | "total_tokens_used" | "max_tokens_per_day" | "tokens_used_today" | "budget_reset_at" | "escalation_timestamps">): Promise<ScheduleEntry>;
+    private addEntryInMemory;
     removeEntry(id: string): Promise<boolean>;
     updateEntry(id: string, patch: ScheduleEntryUpdateInput): Promise<ScheduleEntry | null>;
     getDueEntries(): Promise<ScheduleEntry[]>;