forge-openclaw-plugin 0.2.117 → 0.3.0

package/dist/openclaw/tools.js

@@ -613,7 +613,7 @@ export function registerForgePluginTools(api, config) {
     });
     registerReadTool(api, config, {
         name: "forge_get_wiki_settings",
-        label: "Forge Wiki Settings",
+        label: "KarpaWiki Settings",
         description: "Read the current wiki spaces plus enabled LLM and embedding profiles before search, ingest, or page writes.",
         path: () => "/api/v1/wiki/settings"
     });
@@ -643,7 +643,7 @@ export function registerForgePluginTools(api, config) {
     });
     registerReadTool(api, config, {
         name: "forge_get_wiki_health",
-        label: "Forge Wiki Health",
+        label: "KarpaWiki Health",
         description: "Read unresolved links, orphan pages, missing summaries, raw-source counts, and index-path state for one wiki space.",
         parameters: Type.Object({
             spaceId: optionalString()

package/dist/server/server/src/app.js

@@ -4766,7 +4766,7 @@ function buildAgentOnboardingPayload(request) {
             task: "A concrete actionable work item. Task status is board state, not proof of live work.",
             taskRun: "A live work session attached to a task. Start, heartbeat, focus, complete, and release runs instead of faking work with status alone.",
             note: "A Markdown work note that can link to one or many entities. Use notes for progress evidence, context, and close-out summaries.",
-            wiki: "Forge Wiki is the SQLite-backed memory layer: Markdown content in notes rows plus media, backlinks, optional embeddings, explicit spaces, and structured links back to Forge entities.",
+            wiki: "KarpaWiki is the SQLite-backed memory layer: Markdown content in notes rows plus media, backlinks, optional embeddings, explicit spaces, and structured links back to Forge entities.",
             sleepSession: "A sleep session is a first-class health record with timing, sleep and bed duration, stage breakdown, recovery metrics, annotations, and Forge links back to planning or Psyche context.",
             workoutSession: "A workout session is a first-class sports record imported from HealthKit or generated from a habit. It holds workout type, timing, energy or distance when available, subjective effort, narrative context, and Forge links.",
             preferences: "Forge Preferences is the explicit taste-modeling domain. It has workspaces, contexts, concept libraries, direct items, pairwise judgments, direct signals, and inferred scores.",
@@ -8029,7 +8029,9 @@ export async function buildServer(options = {}) {
         const pairingTransport = await buildCompanionPairingTransport({
             requestedMode: parsed.transportMode,
             requestApiBaseUrl,
-            requestUiBaseUrl: buildUiBaseUrlFromApiBaseUrl(requestApiBaseUrl)
+            requestUiBaseUrl: buildUiBaseUrlFromApiBaseUrl(requestApiBaseUrl),
+            fallbackMode: parsed.fallbackMode,
+            publicUrl: parsed.publicUrl
         });
         reply.code(201);
         return createCompanionPairingSession(pairingTransport, parsed);

package/dist/server/server/src/health.js

@@ -115,6 +115,8 @@ const companionSourceStatesSchema = z.object({
 export const createCompanionPairingSessionSchema = z.object({
     label: z.string().trim().default("Forge Companion"),
     userId: z.string().trim().nullable().optional(),
+    publicUrl: z.string().trim().optional(),
+    fallbackMode: z.enum(["none", "tailscale", "fixed-ip"]).default("none"),
     expiresInMinutes: z.coerce
         .number()
         .int()

package/dist/server/server/src/repositories/wiki-memory.js

@@ -10,6 +10,7 @@ import { createNoteLinkSchema, crudEntityTypeSchema, noteKindSchema, noteSchema
 import { deleteEncryptedSecret, readEncryptedSecret, storeEncryptedSecret } from "./calendar.js";
 import { isEntityDeleted } from "./deleted-entities.js";
 import { recordDiagnosticLog } from "./diagnostic-logs.js";
+import { getUserById } from "./users.js";
 const MAX_WIKI_INGEST_TEXT_CHUNK_CHARS = 220_000;
 const WIKI_INGEST_TEXT_CHUNK_OVERLAP_CHARS = 2_000;
 const wikiSpaceSchema = z.object({
@@ -34,6 +35,15 @@ const wikiLinkEdgeSchema = z.object({
     createdAt: z.string(),
     updatedAt: z.string()
 });
+function normalizeWikiLinkTargetType(value) {
+    if (value === "note") {
+        return "page";
+    }
+    if (value === "page" || value === "entity" || value === "unresolved") {
+        return value;
+    }
+    return "unresolved";
+}
 const wikiMediaAssetSchema = z.object({
     id: z.string(),
     spaceId: z.string(),
@@ -1228,20 +1238,45 @@ function ensureSharedWikiSpace() {
 function ensurePersonalWikiSpace(userId) {
     const existing = findExistingSpaceByOwner(userId);
     if (existing) {
+        repairAutoGeneratedPersonalWikiSpace(existing, userId);
         ensureWikiSpaceSeedPages(existing.id);
-        return existing;
+        return getWikiSpaceById(existing.id) ?? existing;
     }
     const now = nowIso();
+    const presentation = resolvePersonalWikiSpacePresentation(userId);
     const id = `wiki_space_user_${slugify(userId)}`;
-    const slug = `user-${slugify(userId)}`;
     getDatabase()
         .prepare(`INSERT INTO wiki_spaces (id, slug, label, description, owner_user_id, visibility, created_at, updated_at)
        VALUES (?, ?, ?, ?, ?, ?, ?, ?)`)
-        .run(id, slug, `${userId} Wiki`, "Personal Forge wiki space.", userId, "personal", now, now);
+        .run(id, presentation.slug, presentation.label, "Personal Forge wiki space.", userId, "personal", now, now);
     const space = getWikiSpaceById(id);
     ensureWikiSpaceSeedPages(space.id);
     return space;
 }
+function resolvePersonalWikiSpacePresentation(userId) {
+    const user = getUserById(userId);
+    const displayName = user?.displayName?.trim() || user?.handle?.trim() || userId;
+    const slugSource = user?.handle?.trim() || displayName || userId;
+    return {
+        label: `${displayName} Wiki`,
+        slug: slugify(slugSource) || `user-${slugify(userId)}`
+    };
+}
+function repairAutoGeneratedPersonalWikiSpace(space, userId) {
+    const presentation = resolvePersonalWikiSpacePresentation(userId);
+    const oldLabel = `${userId} Wiki`;
+    const oldSlug = `user-${slugify(userId)}`;
+    const nextLabel = space.label === oldLabel ? presentation.label : space.label;
+    const nextSlug = space.slug === oldSlug ? presentation.slug : space.slug;
+    if (nextLabel === space.label && nextSlug === space.slug) {
+        return;
+    }
+    getDatabase()
+        .prepare(`UPDATE wiki_spaces
+       SET label = ?, slug = ?, updated_at = ?
+       WHERE id = ?`)
+        .run(nextLabel, nextSlug, nowIso(), space.id);
+}
 function buildStarterPageMarkdown(page, space) {
     if (page.slug === "index") {
         return [
@@ -1581,7 +1616,7 @@ export function getWikiPageDetail(noteId) {
         page: note,
         backlinks: backlinkRows.map((row) => wikiLinkEdgeSchema.parse({
             sourceNoteId: row.source_note_id,
-            targetType: row.target_type,
+            targetType: normalizeWikiLinkTargetType(row.target_type),
             targetNoteId: row.target_note_id,
             targetEntityType: row.target_entity_type,
             targetEntityId: row.target_entity_id,

package/dist/server/server/src/services/companion-iroh.js

@@ -14,8 +14,12 @@ export async function buildCompanionPairingTransport(input) {
     const requestApiBaseUrl = normalizeApiBaseUrl(input.requestApiBaseUrl);
     const requestUiBaseUrl = normalizeUiBaseUrl(input.requestUiBaseUrl) ??
         deriveUiBaseUrlFromApiBaseUrl(requestApiBaseUrl);
+    const selectedFallback = normalizeSelectedFallback(input.publicUrl) ??
+        normalizeRequestFallback(requestApiBaseUrl, requestUiBaseUrl);
     if (input.requestedMode === "manual-http") {
-        return manualHttpTransport(requestApiBaseUrl, requestUiBaseUrl, [
+        const manualApiBaseUrl = selectedFallback?.apiBaseUrl ?? requestApiBaseUrl;
+        const manualUiBaseUrl = selectedFallback?.uiBaseUrl ?? requestUiBaseUrl;
+        return manualHttpTransport(manualApiBaseUrl, manualUiBaseUrl, [
             "Manual HTTP/TCP pairing was explicitly requested."
         ]);
     }
@@ -30,13 +34,18 @@ export async function buildCompanionPairingTransport(input) {
             pairPayload: snapshot.pairPayload,
             alpn: snapshot.alpn ?? COMPANION_IROH_ALPN,
             localBaseUrl: snapshot.localBaseUrl,
-            fallbackApiBaseUrl: requestApiBaseUrl,
-            fallbackUiBaseUrl: requestUiBaseUrl,
+            fallbackApiBaseUrl: selectedFallback?.apiBaseUrl ?? null,
+            fallbackUiBaseUrl: selectedFallback?.uiBaseUrl ?? null,
+            fallbackMode: selectedFallback
+                ? fallbackModeFor(selectedFallback.apiBaseUrl, input.fallbackMode)
+                : "none",
             recreateCommand: snapshot.recreateCommand ?? undefined,
             startedAt: snapshot.startedAt ?? undefined,
             notes: [
                 "Default pairing uses Forge's Rust Iroh transport over QUIC first.",
-                "The QR keeps the request API/UI URL as a direct fallback when Iroh cannot complete a request.",
+                selectedFallback
+                    ? "The QR includes the selected direct URL only as an explicit fallback/direct path."
+                    : "No direct HTTP fallback was selected for this QR.",
                 "The QR payload carries the Iroh node id, host token, optional relay, and ALPN forge-companion/1.",
                 "Manual HTTP/TCP pairing remains available with --manual-http for advanced local setups."
             ]
@@ -201,21 +210,24 @@ function isIrohPairPayload(value) {
 }
 function irohTransport(input) {
     const nodeId = input.pairPayload.node_id;
+    const irohApiBaseUrl = companionIrohApiBaseUrlFromNodeId(nodeId);
+    const irohUiBaseUrl = companionIrohUiBaseUrlFromNodeId(nodeId);
     return {
         transportMode: "iroh",
-        apiBaseUrl: input.fallbackApiBaseUrl,
-        uiBaseUrl: input.fallbackUiBaseUrl,
+        apiBaseUrl: input.fallbackApiBaseUrl ?? irohApiBaseUrl,
+        uiBaseUrl: input.fallbackUiBaseUrl ?? irohUiBaseUrl,
         transport: {
             protocol: "iroh",
             provider: "forge-companion-iroh",
             status: "ready",
-            publicBaseUrl: input.fallbackApiBaseUrl,
+            publicBaseUrl: input.fallbackApiBaseUrl ?? undefined,
             localBaseUrl: input.localBaseUrl,
             nodeId,
             relay: input.pairPayload.relay,
             alpn: input.alpn,
             agent: FORGE_IROH_AGENT,
             pairPayload: input.pairPayload,
+            fallbackMode: input.fallbackMode,
             recreateCommand: input.recreateCommand,
             startedAt: input.startedAt,
             notes: input.notes
@@ -383,6 +395,65 @@ function normalizeUiBaseUrl(value) {
         return null;
     }
 }
+function normalizeSelectedFallback(value) {
+    if (!value?.trim()) {
+        return null;
+    }
+    const apiBaseUrl = normalizeFallbackApiBaseUrl(value);
+    if (isLoopbackUrl(apiBaseUrl)) {
+        return null;
+    }
+    return {
+        apiBaseUrl,
+        uiBaseUrl: normalizeUiBaseUrl(value) ?? deriveUiBaseUrlFromApiBaseUrl(apiBaseUrl)
+    };
+}
+function normalizeRequestFallback(apiBaseUrl, uiBaseUrl) {
+    if (isLoopbackUrl(apiBaseUrl)) {
+        return null;
+    }
+    return {
+        apiBaseUrl,
+        uiBaseUrl
+    };
+}
+function fallbackModeFor(apiBaseUrl, requestedMode) {
+    if (requestedMode === "fixed-ip" || requestedMode === "tailscale") {
+        return requestedMode;
+    }
+    try {
+        const hostname = new URL(apiBaseUrl).hostname.toLowerCase();
+        return hostname.endsWith(".ts.net") ? "tailscale" : "fixed-ip";
+    }
+    catch {
+        return "fixed-ip";
+    }
+}
+function normalizeFallbackApiBaseUrl(value) {
+    try {
+        const url = new URL(value.trim());
+        if (url.pathname.includes("/api/v1")) {
+            return normalizeApiBaseUrl(url.toString());
+        }
+        url.pathname = "/api/v1";
+        url.search = "";
+        url.hash = "";
+        return url.toString().replace(/\/$/u, "");
+    }
+    catch {
+        return normalizeApiBaseUrl(value);
+    }
+}
+function isLoopbackUrl(value) {
+    try {
+        const url = new URL(value);
+        const host = url.hostname.toLowerCase();
+        return host === "127.0.0.1" || host === "localhost" || host === "::1";
+    }
+    catch {
+        return false;
+    }
+}
 function deriveUiBaseUrlFromApiBaseUrl(apiBaseUrl) {
     try {
         const url = new URL(apiBaseUrl);

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "forge-openclaw-plugin",
   "name": "Forge",
   "description": "Curated OpenClaw adapter for the Forge collaboration API, UI entrypoint, and localhost auto-start runtime.",
-  "version": "0.2.117",
+  "version": "0.3.0",
   "activation": {
     "onStartup": true,
     "onCapabilities": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "forge-openclaw-plugin",
-  "version": "0.2.117",
+  "version": "0.3.0",
   "description": "Curated OpenClaw adapter for the Forge collaboration API, UI entrypoint, and localhost auto-start runtime.",
   "type": "module",
   "license": "Apache-2.0",