npm - agim-cli - Versions diffs - 1.2.45 → 1.2.49 - Mend

agim-cli 1.2.45 → 1.2.49

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (434) hide show

package/dist/core/skills/builtin/agim-self/SKILL.md ADDED Viewed

@@ -0,0 +1,81 @@
+---
+name: agim-self
+description: Reference card for agim's built-in slash commands and MCP tools. Read this when the user asks about agim itself, reminders, memos, goals, heartbeat, or how to do something with the IM bridge.
+always: false
+---
+# agim self-reference
+You are running as an agim agent. The user reached you over an IM
+platform (WeChat / Feishu / DingTalk / Telegram / Discord / Web) routed
+through agim's bridge. This skill summarises the **agim-side**
+capabilities the user might ask you about.
+## Slash commands the user can type
+| command | purpose |
+|---|---|
+| `/new` | start a fresh conversation context |
+| `/agents` | list available agent backends |
+| `/<agent>` | switch agent (`/cc` claude-code, `/oc` opencode, `/cx` codex, `/co` opencode) |
+| `/remind <when> <text>` | one-shot or recurring reminder |
+| `/memo …` | 5W1H persistent memory (auto-extract via natural language) |
+| `/goal set <title>` | sustained multi-turn objective |
+| `/heartbeat bind <body>` | periodic agent self-check on this thread |
+| `/btw <q>` | bypass current thread for a quick parallel question |
+| `/abort` | stop the running agent |
+| `/help` | full command list |
+## MCP tools you can call
+You have access to these `mcp__imhub__*` tools when the operator has the
+sidecar wired:
+- **save_memo / search_memos / update_memo / delete_memo / request_location_capture**
+  — store and retrieve 5W1H facts about the user (preferences, holdings,
+  meeting venues, GPS pins). Use when the user mentions something worth
+  remembering, or when answering a question that needs context they've
+  told you before.
+- **create_reminder / list_reminders / cancel_reminder / snooze_reminder**
+  — manage reminders. Use when the user says "提醒我 X 时候做 Y" without
+  the explicit `/remind` slash.
+- **memory_query / memory_save / memory_list / memory_delete** — long-term
+  fact store. Different from memo: this is the system's structured memory
+  used to inject persona context into every prompt. Save when you learn a
+  durable fact (preference / project / role); query when the user asks
+  about themselves.
+- **push_message** — send a follow-up message to the user's IM thread
+  without waiting for them to ask. Use for monitoring alerts or
+  long-task progress updates only.
+- **ask_user** — present a 2-9 choice question and wait for the user to
+  pick one. Use for disambiguation, not free-form questions.
+- **call_agent** — hand off to a different agent backend for a sub-task.
+  Use sparingly; per-call cost includes subprocess spawn.
+- **read_skill** — fetch the full body of one of the skills listed in
+  your system prompt. Use when the user's question matches a skill
+  description.
+## Guardrails
+- Replies render in IM. Markdown tables work in Feishu / web; collapse
+  to plain text in WeChat. Long replies (>2000 chars or large code
+  blocks) auto-route to the viewer URL.
+- Tool calls go through the operator's approval flow on platforms that
+  support it; on the others the operator pre-approved the tool set.
+- `/heartbeat` and `mcp__imhub__push_message` go through the optional
+  notification evaluator — if you produce a "no-news" update, it gets
+  silently dropped.
+- The user's IM platform may have a per-minute rate limit; if the cap
+  fires you'll see an error back from push_message.
+## When in doubt
+If the user asks something agim-specific that isn't in this card, call
+`mcp__imhub__read_skill('agim-self')` (you're already reading it!) and
+answer from what's here, or admit you don't know and suggest `/help`.

package/dist/core/skills/loader.d.ts ADDED Viewed

@@ -0,0 +1,120 @@
+/** Hard cap on the SKILL.md size we'll read. Skills longer than this
+ *  almost always indicate a misconfigured doc dropped into the skills
+ *  dir; we ignore the body to keep injection cheap and audit-able. */
+export declare const MAX_SKILL_BODY_CHARS = 32000;
+/** Tier-1 description hard cap. Long descriptions inflate the system
+ *  prompt budget for every turn; truncate with "…" so the operator
+ *  immediately notices when the cap was hit. */
+export declare const MAX_DESCRIPTION_CHARS = 400;
+/** Maximum skills we'll inject into a single system prompt block.
+ *  Above this, the agent is better served by a `/skill list` overview
+ *  + on-demand `read_skill` than a wall of text. */
+export declare const MAX_INJECTED_SKILLS = 32;
+export interface SkillMeta {
+    name: string;
+    description: string;
+    /** Source: 'workspace' wins shadowing over 'builtin' with the same name. */
+    source: 'workspace' | 'builtin';
+    /** Absolute path of the skill's directory (parent of SKILL.md). */
+    dir: string;
+    /** When true, the body is auto-injected after the tier-1 summary
+     *  rather than waiting for a read_skill call. Use sparingly — every
+     *  `always: true` skill burns tokens on every turn. */
+    always: boolean;
+    /** Frontmatter `metadata.agim.requires.bins` declared dependencies
+     *  (CLI executables in PATH). */
+    requiresBins: string[];
+    /** Frontmatter `metadata.agim.requires.env` declared dependencies
+     *  (environment variables that must be non-empty). */
+    requiresEnv: string[];
+    /** True iff every `requires.bins` is on PATH AND every `requires.env`
+     *  is non-empty. Unavailable skills are still listed (with a marker)
+     *  so the agent can ask the operator to install the missing piece. */
+    available: boolean;
+    /** Operator-facing reason when `available=false`. */
+    unavailableReason?: string;
+}
+export type SkillsMode = 'auto' | 'agim-only' | 'custom';
+/**
+ * Resolve the ordered list of skill discovery roots (highest priority
+ * first). The agim-owned `workspaceSkillsDir()` is ALWAYS at index 0
+ * — it's the write target and must shadow same-named entries in
+ * inherited roots so operator-installed skills can override defaults.
+ *
+ * Modes:
+ *   - `auto`     (default): workspace + ~/.claude/skills + ~/.config/opencode/skills
+ *                + ~/.codex/skills. Reflects the typical "I installed all three
+ *                CLI agents and they share via symlink" layout — agim sees
+ *                100+ shared skills out of the box without extra config.
+ *                Honors IMHUB_SKILLS_EXTRA_ROOTS for adding more.
+ *   - `agim-only`: only the workspace dir. For deployments that want
+ *                isolation from per-user CLI agent directories.
+ *   - `custom`:   workspace + IMHUB_SKILLS_ROOTS (explicit operator list).
+ *
+ * The builtin dir is NOT included here — it's tier-0 (bundled with agim)
+ * and scanned separately as a last resort in doScan().
+ */
+export declare function resolveSkillsRoots(): string[];
+/** Public describe-only API for the web admin / diagnostics. Returns
+ *  a snapshot of the active mode + the roots that will be scanned. */
+export declare function describeSkillsConfig(): {
+    mode: SkillsMode;
+    writeRoot: string;
+    readRoots: string[];
+    builtinRoot: string;
+};
+/** Force a fresh disk scan on next call. Returned by /skill refresh. */
+export declare function invalidateSkillsCache(): void;
+/**
+ * Write (create-or-overwrite) a workspace SKILL.md (P1 web editor).
+ *
+ *   - Lands at <workspaceSkillsDir>/<name>/SKILL.md (operator path,
+ *     not builtin) so subsequent scans pick it up and it shadows any
+ *     same-named builtin.
+ *   - name is sanitized to safe filesystem chars (no '..', no
+ *     leading dots, no slashes). Returns null on invalid name.
+ *   - Body MUST already include the YAML frontmatter; we validate
+ *     it parses + has a description before writing so the editor
+ *     can't ship a broken SKILL.md. Returns the parsed SkillMeta
+ *     on success.
+ *   - Invalidates the cache so listSkills() picks up the new file
+ *     on next call.
+ */
+export declare function writeSkillFile(name: string, body: string): SkillMeta | null;
+/**
+ * Delete a workspace skill. Builtin (bundled) skills can't be
+ * deleted — operators have to shadow them with a workspace entry
+ * (which writeSkillFile does for them). Returns true iff a file
+ * was actually unlinked.
+ */
+export declare function deleteSkill(name: string): boolean;
+/** Read-only access to the loaded skill list. Triggers a scan on first
+ *  call or when the cache has expired. Never throws — disk errors yield
+ *  the partial list discovered up to that point. */
+export declare function listSkills(): SkillMeta[];
+/** Look up one skill by name (case-insensitive). Returns null when
+ *  unknown; caller decides whether to surface "no such skill" to the
+ *  agent or the operator. */
+export declare function getSkillByName(name: string): SkillMeta | null;
+/** Read the full SKILL.md body for a known skill. Returns null on
+ *  unknown name OR read failure. Honors the MAX_SKILL_BODY_CHARS cap;
+ *  oversize files come back truncated with a `[truncated …]` footer. */
+export declare function readSkillBody(name: string): string | null;
+/**
+ * Build the tier-1 system-prompt block. Injected once per turn by the
+ * router. Returns '' when no skills are configured (router drops empty
+ * blocks). Bounded to MAX_INJECTED_SKILLS rows; above the cap we keep
+ * the first N alphabetically and append a one-line "+ N more (call
+ * /skill list to see)" note.
+ *
+ * Format (kept close to nanobot's so models trained on its docs feel
+ * at home):
+ *
+ *   [agim skills available — read full body with mcp__imhub__read_skill(name)]
+ *   - skill-a: one-line description
+ *   - skill-b: one-line description (unavailable: missing bin `foo`)
+ *   - skill-c: one-line description
+ *   …
+ */
+export declare function buildSkillsSummary(): string;
+//# sourceMappingURL=loader.d.ts.map

package/dist/core/skills/loader.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/core/skills/loader.ts"],"names":[],"mappings":"AAiDA;;sEAEsE;AACtE,eAAO,MAAM,oBAAoB,QAAS,CAAA;AAE1C;;gDAEgD;AAChD,eAAO,MAAM,qBAAqB,MAAM,CAAA;AAExC;;oDAEoD;AACpD,eAAO,MAAM,mBAAmB,KAAK,CAAA;AAErC,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,4EAA4E;IAC5E,MAAM,EAAE,WAAW,GAAG,SAAS,CAAA;IAC/B,mEAAmE;IACnE,GAAG,EAAE,MAAM,CAAA;IACX;;2DAEuD;IACvD,MAAM,EAAE,OAAO,CAAA;IACf;qCACiC;IACjC,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB;0DACsD;IACtD,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB;;0EAEsE;IACtE,SAAS,EAAE,OAAO,CAAA;IAClB,qDAAqD;IACrD,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAmCD,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAA;AA4BxD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAiB7C;AAED;sEACsE;AACtE,wBAAgB,oBAAoB,IAAI;IACtC,IAAI,EAAE,UAAU,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;CACpB,CAOA;AAuBD,wEAAwE;AACxE,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAmB3E;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAajD;AAYD;;oDAEoD;AACpD,wBAAgB,UAAU,IAAI,SAAS,EAAE,CAExC;AAED;;6BAE6B;AAC7B,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAE7D;AAED;;wEAEwE;AACxE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAYzD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAyB3C"}