scientify 1.9.0 → 1.10.1

package/dist/src/tools/scientify-literature-state.js

@@ -0,0 +1,312 @@
+import { Type } from "@sinclair/typebox";
+import { getIncrementalStateStatus, prepareIncrementalState, recordIncrementalPush, recordUserFeedback, } from "../literature/subscription-state.js";
+import { Result } from "./result.js";
+const PreferencesSchema = Type.Optional(Type.Object({
+    max_papers: Type.Optional(Type.Number({
+        description: "Maximum number of papers to push each run (1-20).",
+    })),
+    recency_days: Type.Optional(Type.Number({
+        description: "Optional recency preference in days for candidate retrieval.",
+    })),
+    sources: Type.Optional(Type.Array(Type.String({
+        description: "Preferred search sources, for example: arxiv, openalex.",
+    }))),
+}));
+const PaperSchema = Type.Object({
+    id: Type.Optional(Type.String({ description: "Stable paper id, such as arxiv:2501.12345 or doi:10.xxxx/..." })),
+    title: Type.Optional(Type.String({ description: "Paper title." })),
+    url: Type.Optional(Type.String({ description: "Source URL for traceability." })),
+    score: Type.Optional(Type.Number({
+        description: "Optional internal ranking score for backend logging (for example 0-100).",
+    })),
+    reason: Type.Optional(Type.String({
+        description: "Optional internal ranking rationale for backend logging.",
+    })),
+});
+export const ScientifyLiteratureStateToolSchema = Type.Object({
+    action: Type.String({
+        description: 'Action: "prepare" | "record" | "feedback" | "status".',
+    }),
+    scope: Type.String({
+        description: "Scope key used to isolate user/channel state.",
+    }),
+    topic: Type.String({
+        description: "Research topic text.",
+    }),
+    preferences: PreferencesSchema,
+    papers: Type.Optional(Type.Array(PaperSchema, {
+        description: "Papers to mark as pushed when action=record.",
+    })),
+    status: Type.Optional(Type.String({
+        description: "Run status for action=record, for example: ok, empty, error.",
+    })),
+    run_id: Type.Optional(Type.String({
+        description: "Optional cron run/session id for traceability.",
+    })),
+    note: Type.Optional(Type.String({
+        description: "Optional note for this record.",
+    })),
+    signal: Type.Optional(Type.String({
+        description: 'Feedback signal for action=feedback: "read" | "skip" | "star".',
+    })),
+    paper: Type.Optional(Type.Object({
+        id: Type.Optional(Type.String({ description: "Optional paper id for feedback context." })),
+        title: Type.Optional(Type.String({ description: "Optional paper title for feedback context." })),
+        url: Type.Optional(Type.String({ description: "Optional paper URL for feedback context." })),
+    })),
+    source: Type.Optional(Type.String({
+        description: "Optional source hint for feedback (e.g. arxiv/openalex/domain).",
+    })),
+    tags: Type.Optional(Type.Array(Type.String({
+        description: "Optional feedback tags, e.g. [\"physics simulation\", \"agent\"].",
+    }))),
+});
+function readStringParam(params, key) {
+    const value = params[key];
+    if (typeof value !== "string")
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+function readPreferences(params) {
+    const raw = params.preferences;
+    if (!raw || typeof raw !== "object" || Array.isArray(raw))
+        return undefined;
+    const record = raw;
+    const maxRaw = record.max_papers;
+    const recencyRaw = record.recency_days;
+    const sourcesRaw = record.sources;
+    const maxPapers = typeof maxRaw === "number" && Number.isFinite(maxRaw) ? maxRaw : undefined;
+    const recencyDays = typeof recencyRaw === "number" && Number.isFinite(recencyRaw) ? recencyRaw : undefined;
+    const sources = Array.isArray(sourcesRaw) && sourcesRaw.length > 0
+        ? sourcesRaw
+            .filter((item) => typeof item === "string")
+            .map((item) => item.trim())
+            .filter((item) => item.length > 0)
+        : undefined;
+    if (maxPapers === undefined && recencyDays === undefined && (!sources || sources.length === 0)) {
+        return undefined;
+    }
+    return {
+        ...(maxPapers !== undefined ? { maxPapers } : {}),
+        ...(recencyDays !== undefined ? { recencyDays } : {}),
+        ...(sources && sources.length > 0 ? { sources } : {}),
+    };
+}
+function readPapers(params) {
+    const raw = params.papers;
+    if (!Array.isArray(raw))
+        return [];
+    const papers = [];
+    for (const item of raw) {
+        if (!item || typeof item !== "object" || Array.isArray(item))
+            continue;
+        const record = item;
+        const id = typeof record.id === "string" ? record.id.trim() : undefined;
+        const title = typeof record.title === "string" ? record.title.trim() : undefined;
+        const url = typeof record.url === "string" ? record.url.trim() : undefined;
+        const score = typeof record.score === "number" && Number.isFinite(record.score)
+            ? record.score
+            : undefined;
+        const reason = typeof record.reason === "string" ? record.reason.trim() : undefined;
+        papers.push({
+            ...(id ? { id } : {}),
+            ...(title ? { title } : {}),
+            ...(url ? { url } : {}),
+            ...(score !== undefined ? { score } : {}),
+            ...(reason ? { reason } : {}),
+        });
+    }
+    return papers;
+}
+function readFeedbackSignal(params) {
+    const raw = readStringParam(params, "signal")?.toLowerCase();
+    if (raw === "read" || raw === "skip" || raw === "star")
+        return raw;
+    return undefined;
+}
+function readFeedbackPaper(params) {
+    const raw = params.paper;
+    if (!raw || typeof raw !== "object" || Array.isArray(raw))
+        return undefined;
+    const record = raw;
+    const id = typeof record.id === "string" ? record.id.trim() : undefined;
+    const title = typeof record.title === "string" ? record.title.trim() : undefined;
+    const url = typeof record.url === "string" ? record.url.trim() : undefined;
+    if (!id && !title && !url)
+        return undefined;
+    return {
+        ...(id ? { id } : {}),
+        ...(title ? { title } : {}),
+        ...(url ? { url } : {}),
+    };
+}
+function readStringList(params, key) {
+    const raw = params[key];
+    if (!Array.isArray(raw))
+        return undefined;
+    const values = raw
+        .filter((item) => typeof item === "string")
+        .map((item) => item.trim())
+        .filter((item) => item.length > 0);
+    return values.length > 0 ? values : undefined;
+}
+export function createScientifyLiteratureStateTool() {
+    return {
+        label: "Scientify Literature State",
+        name: "scientify_literature_state",
+        description: "Manage incremental literature state for subscriptions: prepare dedupe context, record pushed papers, persist lightweight feedback memory, and query status.",
+        parameters: ScientifyLiteratureStateToolSchema,
+        execute: async (_toolCallId, rawArgs) => {
+            const params = (rawArgs ?? {});
+            const action = (readStringParam(params, "action") ?? "").toLowerCase();
+            const scope = readStringParam(params, "scope");
+            const topic = readStringParam(params, "topic");
+            const preferences = readPreferences(params);
+            if (!scope || !topic) {
+                return Result.err("invalid_params", "Both `scope` and `topic` are required.");
+            }
+            try {
+                if (action === "prepare") {
+                    const prepared = await prepareIncrementalState({ scope, topic, preferences });
+                    return Result.ok({
+                        action,
+                        scope: prepared.scope,
+                        topic: prepared.topic,
+                        topic_key: prepared.topicKey,
+                        preferences: {
+                            max_papers: prepared.preferences.maxPapers,
+                            recency_days: prepared.preferences.recencyDays,
+                            sources: prepared.preferences.sources,
+                        },
+                        memory_hints: {
+                            preferred_keywords: prepared.memoryHints.preferredKeywords,
+                            avoided_keywords: prepared.memoryHints.avoidedKeywords,
+                            preferred_sources: prepared.memoryHints.preferredSources,
+                            avoided_sources: prepared.memoryHints.avoidedSources,
+                            feedback_counts: prepared.memoryHints.feedbackCounts,
+                            last_feedback_at_ms: prepared.memoryHints.lastFeedbackAtMs ?? null,
+                        },
+                        exclude_paper_ids: prepared.excludePaperIds,
+                        known_paper_count: prepared.knownPaperCount,
+                        last_pushed_at_ms: prepared.lastPushedAtMs ?? null,
+                    });
+                }
+                if (action === "record") {
+                    const papers = readPapers(params);
+                    const status = readStringParam(params, "status");
+                    const runId = readStringParam(params, "run_id");
+                    const note = readStringParam(params, "note");
+                    const recorded = await recordIncrementalPush({
+                        scope,
+                        topic,
+                        preferences,
+                        status,
+                        runId,
+                        note,
+                        papers,
+                    });
+                    return Result.ok({
+                        action,
+                        scope: recorded.scope,
+                        topic: recorded.topic,
+                        topic_key: recorded.topicKey,
+                        preferences: {
+                            max_papers: recorded.preferences.maxPapers,
+                            recency_days: recorded.preferences.recencyDays,
+                            sources: recorded.preferences.sources,
+                        },
+                        memory_hints: {
+                            preferred_keywords: recorded.memoryHints.preferredKeywords,
+                            avoided_keywords: recorded.memoryHints.avoidedKeywords,
+                            preferred_sources: recorded.memoryHints.preferredSources,
+                            avoided_sources: recorded.memoryHints.avoidedSources,
+                            feedback_counts: recorded.memoryHints.feedbackCounts,
+                            last_feedback_at_ms: recorded.memoryHints.lastFeedbackAtMs ?? null,
+                        },
+                        recorded_papers: recorded.recordedPapers,
+                        total_known_papers: recorded.totalKnownPapers,
+                        pushed_at_ms: recorded.pushedAtMs,
+                    });
+                }
+                if (action === "feedback") {
+                    const signal = readFeedbackSignal(params);
+                    if (!signal) {
+                        return Result.err("invalid_params", 'Action "feedback" requires `signal` as one of: read, skip, star.');
+                    }
+                    const runId = readStringParam(params, "run_id");
+                    const note = readStringParam(params, "note");
+                    const source = readStringParam(params, "source");
+                    const tags = readStringList(params, "tags");
+                    const paper = readFeedbackPaper(params);
+                    const feedback = await recordUserFeedback({
+                        scope,
+                        topic,
+                        preferences,
+                        feedback: {
+                            signal,
+                            ...(paper ? { paper } : {}),
+                            ...(source ? { source } : {}),
+                            ...(tags ? { tags } : {}),
+                            ...(note ? { note } : {}),
+                            ...(runId ? { runId } : {}),
+                        },
+                    });
+                    return Result.ok({
+                        action,
+                        scope: feedback.scope,
+                        topic: feedback.topic,
+                        topic_key: feedback.topicKey,
+                        signal: feedback.signal,
+                        preferences: {
+                            max_papers: feedback.preferences.maxPapers,
+                            recency_days: feedback.preferences.recencyDays,
+                            sources: feedback.preferences.sources,
+                        },
+                        memory_hints: {
+                            preferred_keywords: feedback.memoryHints.preferredKeywords,
+                            avoided_keywords: feedback.memoryHints.avoidedKeywords,
+                            preferred_sources: feedback.memoryHints.preferredSources,
+                            avoided_sources: feedback.memoryHints.avoidedSources,
+                            feedback_counts: feedback.memoryHints.feedbackCounts,
+                            last_feedback_at_ms: feedback.memoryHints.lastFeedbackAtMs ?? null,
+                        },
+                        updated_at_ms: feedback.updatedAtMs,
+                    });
+                }
+                if (action === "status") {
+                    const status = await getIncrementalStateStatus({ scope, topic });
+                    return Result.ok({
+                        action,
+                        scope: status.scope,
+                        topic: status.topic,
+                        topic_key: status.topicKey,
+                        preferences: {
+                            max_papers: status.preferences.maxPapers,
+                            recency_days: status.preferences.recencyDays,
+                            sources: status.preferences.sources,
+                        },
+                        memory_hints: {
+                            preferred_keywords: status.memoryHints.preferredKeywords,
+                            avoided_keywords: status.memoryHints.avoidedKeywords,
+                            preferred_sources: status.memoryHints.preferredSources,
+                            avoided_sources: status.memoryHints.avoidedSources,
+                            feedback_counts: status.memoryHints.feedbackCounts,
+                            last_feedback_at_ms: status.memoryHints.lastFeedbackAtMs ?? null,
+                        },
+                        exclude_paper_ids: status.excludePaperIds,
+                        known_paper_count: status.knownPaperCount,
+                        total_runs: status.totalRuns,
+                        last_status: status.lastStatus ?? null,
+                        last_pushed_at_ms: status.lastPushedAtMs ?? null,
+                    });
+                }
+                return Result.err("invalid_params", 'Invalid action. Use one of: "prepare", "record", "feedback", "status".');
+            }
+            catch (error) {
+                return Result.err("runtime_error", `scientify_literature_state failed: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        },
+    };
+}
+//# sourceMappingURL=scientify-literature-state.js.map

package/dist/src/tools/scientify-literature-state.js.map

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

package/openclaw.plugin.json

@@ -28,6 +28,7 @@
     "skills/research-review",
     "skills/research-experiment",
     "skills/literature-survey",
-    "skills/write-review-paper"
+    "skills/write-review-paper",
+    "skills/research-subscription"
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scientify",
-  "version": "1.9.0",
+  "version": "1.10.1",
   "description": "Scientify - AI-powered research workflow automation for OpenClaw. Includes idea generation, literature review, research pipeline skills, and arxiv tool.",
   "type": "module",
   "main": "dist/index.js",

package/skills/_shared/workspace-spec.md

@@ -124,6 +124,18 @@ echo "battery-rul-prediction" > ~/.openclaw/workspace/projects/.active
 WORKSPACE=~/.openclaw/workspace/projects/$(cat ~/.openclaw/workspace/projects/.active)
 ```
 
+### Scheduled Subscription Storage
+
+`research-subscription` does not write project files under the workspace tree.
+
+- Scheduled jobs are stored in OpenClaw cron storage.
+- Incremental dedupe state/logs are stored under `~/.openclaw/workspace/scientify/`:
+  - `literature-state.json`
+  - `literature-push-log.jsonl`
+- Use `openclaw cron list --all --json` for global inspection.
+- Use `/research-subscriptions` for scope-aware inspection within Scientify.
+- Use `/research-unsubscribe` to remove jobs for the current sender/channel scope.
+
 ## Skill Outputs Summary
 
 | Skill | Primary Outputs |
@@ -137,3 +149,4 @@ WORKSPACE=~/.openclaw/workspace/projects/$(cat ~/.openclaw/workspace/projects/.a
 | `/research-pipeline` | Orchestrator — spawns the above 5 skills in sequence |
 | `/idea-generation` | `ideas/` |
 | `/write-review-paper` | `review/` |
+| `research-subscription` | No project-tree output; creates OpenClaw cron jobs and updates `~/.openclaw/workspace/scientify/` incremental state logs (including lightweight preference-memory feedback) |

package/skills/research-subscription/SKILL.md

@@ -0,0 +1,102 @@
+---
+name: research-subscription
+description: "Use when the user asks for scheduled or recurring tasks: literature digests, delayed push notifications, or plain reminders."
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "⏰",
+      },
+  }
+---
+
+# Research Subscription (Scheduled Push)
+
+## When to use
+
+Use this skill when the user asks for:
+
+- Scheduled literature updates
+- A delayed report (for example, tomorrow morning)
+- Recurring tracking and push delivery
+- A normal reminder (for example, "remind me in 5 minutes to sleep")
+
+## Core rule
+
+Do not stop at explanation.
+Create a real cron job via `scientify_cron_job`.
+
+## Tool to call
+
+`scientify_cron_job`
+
+- `action: "upsert"`: create or update a schedule
+- `action: "list"`: show current schedules
+- `action: "remove"`: cancel schedules
+
+Routing rules:
+
+- Research digest / paper tracking request: pass `topic`, leave `message` unset.
+- Plain reminder request: pass `message`, do not set `topic`.
+- If request is ambiguous, ask one concise clarification question before tool call.
+- For recurring research subscriptions, prefer setting lightweight preferences:
+  - `max_papers` (default 3)
+  - `recency_days` (optional)
+  - `sources` (optional, e.g. `["arxiv","openalex"]`)
+  - `candidate_pool` (optional, default around 10)
+  - `score_weights` (optional object with `relevance`/`novelty`/`authority`/`actionability`)
+
+## Scheduling format
+
+For `action: "upsert"`, set `schedule` to one of:
+
+- `daily 08:00 Asia/Shanghai`
+- `weekly mon 09:30 Asia/Shanghai`
+- `every 6h`
+- `at 2m`
+- `at 2026-03-04T08:00:00+08:00`
+- `cron 0 9 * * * Asia/Shanghai`
+
+## Delivery fields
+
+- Optional `channel`: `feishu`, `telegram`, `slack`, `discord`, `last`, and others
+- Optional aliases: `webui`, `tui` (both map to `last`)
+- Optional `to`: channel-specific user or chat id (required only for concrete channels like `feishu`/`telegram`, not for `last`/`webui`/`tui`)
+- Optional `no_deliver: true`: run in background without push
+
+If the user does not specify destination, leave `channel` and `to` unset to use default routing.
+
+## Topic field
+
+If the user gives a clear topic, pass it as `topic` (for example, `"LLM alignment"`).
+This focuses scheduled research content on that topic.
+Recurring research jobs automatically use `scientify_literature_state` at runtime
+to prepare dedupe context and record pushed paper IDs for traceability.
+If an incremental pass returns no unseen papers, run one fallback representative pass before returning empty.
+If user gives explicit preference feedback during follow-up (read/skip/star style intent, source preference, direction preference),
+persist it via `scientify_literature_state` action=`feedback` (backend-only memory, not user-facing by default).
+
+## Message field (plain reminder)
+
+For non-research reminders, pass `message` with the exact reminder content.
+
+- Example: `message: "Today at noon, remember to drink coffee."`
+- Do not set `topic` for plain reminders.
+
+## Response requirements
+
+After tool success, reply with:
+
+1. Job created or updated
+2. Effective schedule (with timezone)
+3. Delivery target
+4. Next command for inspect or cancel
+
+For plain reminders, you may add one optional follow-up line:
+- "If you want, I can also set recurring literature tracking with Scientify on a topic."
+
+The final response must end with this exact footer:
+---
+🐍Scientify
+
+If the schedule is ambiguous, ask one concise clarification question before calling the tool.