@scitrera/memorylayer-sdk 0.0.5 → 0.2.0

package/dist/mcp_servers.js.map

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

package/dist/rpg.d.ts

@@ -0,0 +1,178 @@
+import type { MemoryLayerClient } from "./client.js";
+import type { AuthorityContext } from "./types.js";
+export interface RpgNodeInput {
+    nodeId: string;
+    nodeType: string;
+    path: string;
+    name: string;
+    description?: string;
+    language?: string;
+    parentId?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface RpgEdgeInput {
+    sourceId: string;
+    targetId: string;
+    relationship: string;
+    strength?: number;
+    metadata?: Record<string, unknown>;
+}
+export interface RpgNode {
+    node_id: string;
+    node_type: string;
+    path: string;
+    name: string;
+    description: string;
+    language?: string;
+    parent_id?: string;
+    depth: number;
+    metadata: Record<string, unknown>;
+    memory_id?: string;
+    context_id?: string;
+}
+export interface RpgEdge {
+    source_id: string;
+    target_id: string;
+    relationship: string;
+    strength: number;
+    metadata: Record<string, unknown>;
+    association_id?: string;
+}
+export interface RpgSyncOptions {
+    fullSync?: boolean;
+    sourceCommit?: string;
+    contextId?: string;
+    taskId?: string;
+}
+export interface RpgSyncResult {
+    nodes_created: number;
+    nodes_updated: number;
+    nodes_deleted: number;
+    edges_created: number;
+    edges_updated: number;
+    edges_deleted: number;
+    sync_time_ms: number;
+    source_commit?: string;
+}
+export interface RpgSubgraph {
+    nodes: RpgNode[];
+    edges: RpgEdge[];
+    root_id?: string;
+    depth: number;
+    total_nodes: number;
+    total_edges: number;
+    truncated?: boolean;
+}
+export interface RpgSearchResult {
+    nodes: RpgNode[];
+    total_count: number;
+    query: string;
+}
+export interface RpgStatus {
+    workspace_id: string;
+    has_rpg: boolean;
+    node_count: number;
+    edge_count: number;
+    last_sync_commit?: string;
+    last_sync_at?: string;
+}
+export interface RpgOverlay {
+    context_id: string;
+    node_count: number;
+}
+export interface RpgOverlayList {
+    overlays: RpgOverlay[];
+    total: number;
+}
+export interface RpgDeleteResult {
+    deleted: number;
+    not_found: number;
+}
+export interface RpgOverlayDeleteResult {
+    context_id: string;
+    deleted: number;
+}
+export interface RpgNodeList {
+    nodes: RpgNode[];
+    total_count: number;
+}
+export interface RpgConflict {
+    file_path: string;
+    task_ids: string[];
+    severity: string;
+}
+export interface RpgConflictResult {
+    task_id: string;
+    conflicts: RpgConflict[];
+    total_conflicts: number;
+}
+export interface RpgSymbolConflict extends RpgConflict {
+    symbol_id: string;
+    description: string;
+}
+export interface RpgSymbolConflictResult {
+    task_ids: string[];
+    conflicts: RpgSymbolConflict[];
+    total_conflicts: number;
+}
+export type RpgMaintenanceOperation = "validate" | "cleanup" | "statistics" | "cleanup_intents" | "recompute_counts";
+export interface RpgMaintenanceResult {
+    operation: RpgMaintenanceOperation;
+    workspace_id: string;
+    result: Record<string, unknown>;
+}
+export interface RpgEnrichmentResult {
+    workspace_id: string;
+    context_id: string;
+    async_mode: boolean;
+    task_id?: string;
+    stats?: Record<string, unknown>;
+}
+export interface RpgSubgraphOptions {
+    path?: string;
+    nodeId?: string;
+    depth?: number;
+    nodeTypes?: string[];
+    relationshipTypes?: string[];
+    contextId?: string;
+    maxNodes?: number;
+}
+/** RPG namespace, available as `client.rpg`. */
+export declare class RpgNamespace {
+    private readonly client;
+    private readonly authority?;
+    constructor(client: MemoryLayerClient, authority?: AuthorityContext | undefined);
+    withAuthority(authority: AuthorityContext): RpgNamespace;
+    private req;
+    sync(nodes: RpgNodeInput[], edges: RpgEdgeInput[], options?: RpgSyncOptions): Promise<RpgSyncResult>;
+    getSubgraph(options: RpgSubgraphOptions): Promise<RpgSubgraph>;
+    search(query: string, options?: {
+        nodeTypes?: string[];
+        limit?: number;
+        contextId?: string;
+    }): Promise<RpgSearchResult>;
+    getStatus(contextId?: string): Promise<RpgStatus>;
+    listOverlays(): Promise<RpgOverlayList>;
+    deleteOverlay(contextId: string): Promise<RpgOverlayDeleteResult>;
+    deleteNodes(nodeIds: string[], contextId?: string): Promise<RpgDeleteResult>;
+    deleteEdges(associationIds: string[]): Promise<RpgDeleteResult>;
+    listNodes(options?: {
+        nodeType?: string;
+        contextId?: string;
+        limit?: number;
+    }): Promise<RpgNodeList>;
+    getMergedSubgraph(overlayContext: string, options?: {
+        baseContext?: string;
+        path?: string;
+        depth?: number;
+    }): Promise<RpgSubgraph>;
+    getConflicts(taskId: string): Promise<RpgConflictResult>;
+    getSymbolConflicts(taskIdA: string, taskIdB: string): Promise<RpgSymbolConflictResult>;
+    maintenance(operation: RpgMaintenanceOperation): Promise<RpgMaintenanceResult>;
+    enrich(options?: {
+        contextId?: string;
+        phases?: string[];
+        async?: boolean;
+    }): Promise<RpgEnrichmentResult>;
+}
+//# sourceMappingURL=rpg.d.ts.map

package/dist/rpg.d.ts.map

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

package/dist/rpg.js

@@ -0,0 +1,126 @@
+function nodeToApi(node) {
+    return {
+        node_id: node.nodeId,
+        node_type: node.nodeType,
+        path: node.path,
+        name: node.name,
+        description: node.description ?? "",
+        language: node.language,
+        parent_id: node.parentId,
+        metadata: node.metadata ?? {},
+    };
+}
+function edgeToApi(edge) {
+    return {
+        source_id: edge.sourceId,
+        target_id: edge.targetId,
+        relationship: edge.relationship,
+        strength: edge.strength ?? 1,
+        metadata: edge.metadata ?? {},
+    };
+}
+function queryPath(path, params) {
+    const q = new URLSearchParams();
+    for (const [key, value] of Object.entries(params)) {
+        if (value !== undefined && value !== "")
+            q.set(key, String(value));
+    }
+    const encoded = q.toString();
+    return `${path}${encoded ? `?${encoded}` : ""}`;
+}
+/** RPG namespace, available as `client.rpg`. */
+export class RpgNamespace {
+    client;
+    authority;
+    constructor(client, authority) {
+        this.client = client;
+        this.authority = authority;
+    }
+    withAuthority(authority) {
+        return new RpgNamespace(this.client, authority);
+    }
+    req(method, path, body) {
+        return this.client._rpgRequest(method, path, body, this.authority);
+    }
+    sync(nodes, edges, options = {}) {
+        return this.req("POST", "/v1/rpg/sync", {
+            nodes: nodes.map(nodeToApi),
+            edges: edges.map(edgeToApi),
+            full_sync: options.fullSync ?? false,
+            source_commit: options.sourceCommit,
+            context_id: options.contextId ?? "rpg",
+            task_id: options.taskId,
+        });
+    }
+    getSubgraph(options) {
+        if (!options.path && !options.nodeId)
+            throw new Error("path or nodeId is required");
+        return this.req("GET", queryPath("/v1/rpg/subgraph", {
+            path: options.path,
+            node_id: options.nodeId,
+            depth: options.depth ?? 3,
+            node_types: options.nodeTypes?.join(","),
+            relationship_types: options.relationshipTypes?.join(","),
+            context_id: options.contextId ?? "rpg",
+            max_nodes: options.maxNodes ?? 2000,
+        }));
+    }
+    search(query, options = {}) {
+        return this.req("GET", queryPath("/v1/rpg/search", {
+            query,
+            node_types: options.nodeTypes?.join(","),
+            limit: options.limit ?? 20,
+            context_id: options.contextId ?? "rpg",
+        }));
+    }
+    getStatus(contextId) {
+        return this.req("GET", queryPath("/v1/rpg/status", { context_id: contextId }));
+    }
+    listOverlays() {
+        return this.req("GET", "/v1/rpg/overlays");
+    }
+    deleteOverlay(contextId) {
+        return this.req("DELETE", `/v1/rpg/overlays/${encodeURIComponent(contextId)}`);
+    }
+    deleteNodes(nodeIds, contextId = "rpg") {
+        return this.req("DELETE", "/v1/rpg/nodes", { node_ids: nodeIds, context_id: contextId });
+    }
+    deleteEdges(associationIds) {
+        return this.req("DELETE", "/v1/rpg/edges", { association_ids: associationIds });
+    }
+    listNodes(options = {}) {
+        return this.req("GET", queryPath("/v1/rpg/nodes", {
+            node_type: options.nodeType,
+            context_id: options.contextId ?? "rpg",
+            limit: options.limit ?? 5000,
+        }));
+    }
+    getMergedSubgraph(overlayContext, options = {}) {
+        return this.req("GET", queryPath("/v1/rpg/merged-subgraph", {
+            base_context: options.baseContext ?? "rpg",
+            overlay_context: overlayContext,
+            path: options.path,
+            depth: options.depth ?? 3,
+        }));
+    }
+    getConflicts(taskId) {
+        return this.req("GET", queryPath("/v1/rpg/conflicts", { task_id: taskId }));
+    }
+    getSymbolConflicts(taskIdA, taskIdB) {
+        return this.req("GET", queryPath("/v1/rpg/conflicts/symbols", {
+            task_id_a: taskIdA,
+            task_id_b: taskIdB,
+        }));
+    }
+    maintenance(operation) {
+        return this.req("POST", `/v1/rpg/maintenance/${operation}`);
+    }
+    enrich(options = {}) {
+        return this.req("POST", "/v1/rpg/enrich", {
+            context_id: options.contextId ?? "rpg",
+            phases: options.phases,
+            async: options.async ?? true,
+        });
+    }
+}
+//# sourceMappingURL=rpg.js.map

package/dist/rpg.js.map

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

package/dist/skills.d.ts

@@ -0,0 +1,194 @@
+import type { MemoryLayerClient } from "./client.js";
+import type { AuthorityContext } from "./types.js";
+export interface Skill {
+    id: string;
+    tenant_id: string;
+    workspace_id: string;
+    user_id?: string;
+    name: string;
+    description: string;
+    version: string;
+    license?: string;
+    compatibility?: string;
+    allowed_tools?: string;
+    body: string;
+    metadata: Record<string, unknown>;
+    source_mode: "server" | "filesystem" | "mirrored";
+    manifest_hash: string;
+    bundle_hash: string;
+    enabled: boolean;
+    created_at: string;
+    updated_at: string;
+}
+export interface SkillFile {
+    id: string;
+    skill_id: string;
+    path: string;
+    kind: "script" | "reference" | "asset" | "other";
+    content: string;
+    content_hash: string;
+    size_bytes: number;
+    mime_type?: string;
+    created_at: string;
+    updated_at: string;
+}
+export interface SkillManifest {
+    name: string;
+    description: string;
+    version?: string;
+    license?: string;
+    compatibility?: string;
+    allowed_tools?: string;
+    body: string;
+    metadata?: Record<string, unknown>;
+    files?: Array<{
+        path: string;
+        content: string;
+    }>;
+    source_mode?: "server" | "filesystem" | "mirrored";
+}
+export interface SkillListOptions {
+    workspaceId?: string;
+    scope?: string;
+    name?: string;
+    tags?: string[];
+    enabled?: boolean;
+    includeShadowed?: boolean;
+    authority?: AuthorityContext;
+}
+export interface SkillResolveOptions {
+    name?: string;
+    query?: string;
+    scopeHint?: string;
+    authority?: AuthorityContext;
+}
+export interface SkillSyncResult {
+    action: "push" | "pull" | "conflict" | "in_sync";
+    manifest_hash?: string;
+    bundle_hash?: string;
+}
+export interface ParsedSkillFolder {
+    manifest: SkillManifest;
+    files: Array<{
+        path: string;
+        content: string;
+    }>;
+}
+export declare class SkillsNamespace {
+    private _client;
+    private _authority?;
+    private _workspaceId?;
+    constructor(client: MemoryLayerClient, authority?: AuthorityContext, workspaceId?: string);
+    /** Return a scoped proxy that injects OBO headers and workspace on every call. */
+    withAuthority(authority: AuthorityContext, workspaceId?: string): SkillsNamespace;
+    private _req;
+    list(options?: SkillListOptions): Promise<Skill[]>;
+    get(skillId: string): Promise<Skill>;
+    /**
+     * Render the full `SKILL.md` for a skill.
+     *
+     * The server returns raw markdown (`Content-Type: text/markdown`), not JSON,
+     * so this reads the body as text rather than parsing it.
+     */
+    getManifest(skillId: string): Promise<string>;
+    listFiles(skillId: string): Promise<SkillFile[]>;
+    /**
+     * Fetch only the raw content of a skill file (no metadata lookup).
+     *
+     * Used internally by `materialize()` to avoid the extra `listFiles()` call
+     * that `getFile()` performs. The caller already has the full `SkillFile`
+     * metadata from the single `listFiles()` done by `materialize()`, so we only
+     * need the raw bytes here.
+     */
+    private _fetchFileContent;
+    /**
+     * Fetch a single skill file with its content populated.
+     *
+     * `GET /v1/skills/{id}/files/{path}` streams the raw file bytes (e.g.
+     * `text/x-python`), NOT a JSON envelope — so we read the body as text and
+     * merge it onto the file's metadata from `listFiles()`. The metadata lookup
+     * is best-effort: if the path isn't in the listing we still return the
+     * fetched content with the path filled in.
+     */
+    getFile(skillId: string, filePath: string): Promise<SkillFile>;
+    /**
+     * Delete a single file from a skill bundle.
+     *
+     * Calls `DELETE /v1/skills/{id}/files/{path}` (per-segment encodeURIComponent
+     * so embedded `/` separators are preserved, matching `getFile`). The server
+     * responds 204 with an empty body and is idempotent — deleting an
+     * already-absent path still succeeds — so the request helper's 204 handling
+     * means no JSON parsing happens here.
+     */
+    deleteFile(skillId: string, filePath: string): Promise<void>;
+    /**
+     * Create or update a skill AND persist its bundle files.
+     *
+     * The server's create/update inputs (`POST /v1/skills`, `PUT /v1/skills/{id}`)
+     * carry NO `files` field — files are persisted out-of-band via
+     * `PUT /v1/skills/{id}/files/{path}` with base64 `content_b64`. A previous
+     * version sent `manifest.files` on the create body, where the server silently
+     * ignored it, so a skill saved with files lost them. This method now:
+     *
+     *  1. Detects create-vs-update by resolving the skill by name (the unique key
+     *     within a scope). Found → UPDATE (`PUT /v1/skills/{id}`); else CREATE
+     *     (`POST /v1/skills`). Neither create nor update bodies include `files`.
+     *  2. Upserts every manifest file via the dedicated file endpoint.
+     *  3. On UPDATE, performs a TRUE file reconcile: it lists the skill's current
+     *     server files and DELETEs (`DELETE /v1/skills/{id}/files/{path}`) any whose
+     *     path is no longer in the manifest, so the saved skill's bundle is an exact
+     *     mirror of the manifest. (CREATE has no pre-existing files to prune.)
+     *  4. If the skill create/update succeeds but ANY file PUT fails, this RAISES a
+     *     clear error rather than resolving — never silently dropping files. File
+     *     PUTs are idempotent upserts, so the failed save is safe to retry.
+     *
+     * Returns the fully-persisted skill (re-fetched for fresh manifest/bundle
+     * hashes). The public signature and return type are unchanged.
+     */
+    save(manifest: SkillManifest): Promise<Skill>;
+    delete(skillId: string): Promise<void>;
+    resolve(options?: SkillResolveOptions): Promise<Skill | null>;
+    pull(skillId: string): Promise<{
+        skill: Skill;
+        files: SkillFile[];
+    }>;
+    push(manifest: SkillManifest): Promise<Skill>;
+    /**
+     * Write every matching skill's `SKILL.md` + files into `targetDir`.
+     *
+     * The set of skills written is whatever the internal `list(...)` returns for
+     * the given `workspaceId`/`scope`. By default `enabled` is left unset, so
+     * both enabled and disabled server-visible skills are materialized (backwards
+     * compatible). Pass `enabled: true` to restrict the on-disk cache to the
+     * enabled subset (e.g. the OpenClaw skills-sync hook does this so disabled
+     * skills are never written into the agent's watched skills dir).
+     *
+     * By default materialize is purely additive: it writes/overwrites the desired
+     * skills but never removes anything already on disk. Pass `reconcile: true` to
+     * turn the sync into a true reconcile — after successfully listing AND writing
+     * the desired skills, any top-level entry in `targetDir` whose name is NOT in
+     * the desired skill-name set is removed. This is how a skill that was disabled,
+     * deleted, or renamed in MemoryLayer gets its stale on-disk copy pruned.
+     *
+     * CONTRACT (reconcile only): `targetDir` MUST be an exclusively
+     * MemoryLayer-managed directory (e.g. the OpenClaw plugin's dedicated
+     * `extraDir`). Reconcile will delete subdirectories it did not write. As a
+     * defensive guard it only removes a directory that *looks* like a materialized
+     * skill (i.e. contains a `SKILL.md`); unrelated files and non-skill directories
+     * are left untouched. Pruning runs ONLY after the list+materialize succeeded,
+     * so a transient server/list failure can never wipe the directory.
+     */
+    materialize(targetDir: string, options?: {
+        workspaceId?: string;
+        scope?: string;
+        enabled?: boolean;
+        reconcile?: boolean;
+    }): Promise<void>;
+}
+/**
+ * Parse a skill folder from the filesystem.
+ * Reads SKILL.md (frontmatter + body) and walks scripts/, references/, assets/.
+ * Requires Node.js (uses fs/promises). Not available in browser environments.
+ */
+export declare function parseSkillFolder(dir: string): Promise<ParsedSkillFolder>;
+//# sourceMappingURL=skills.d.ts.map

package/dist/skills.d.ts.map

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