aimeat 1.30.2 → 1.32.0

package/dist/src/services/discovery/run.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @file run.ts
+ * @description The discovery orchestrator — the domain-agnostic core of `/v1/discover`. It iterates a
+ *   `DiscoveryRegistry`, fans `enumerate()` across every registered source, maps rows to
+ *   `DiscoveryEntry` via each source's `toEntry()`, applies the gating pass (§6 — Phase 1 covers
+ *   scope=own/public; cross-member `workspace`/`consent` gating arrives in Phase 3), then filters,
+ *   ranks and returns the unified set. Contains NO domain-specific logic — that all lives in adapters.
+ * @structure
+ *   - runDiscovery() — registry + context → ranked DiscoveryEntry[]
+ *   - rankEntries() — relevance (score) then recency
+ * @usage const entries = await runDiscovery(registry, ctx);
+ * @version-history
+ *   v0.1.0 — 2026-06-23 — Phase 1: fan-out + filter + rank (design doc 2026-06-23). Phase-3 gating TODO.
+ */
+import type { DiscoveryContext, DiscoveryEntry } from './types.js';
+import type { DiscoveryRegistry } from './registry.js';
+/**
+ * Fan across all registered sources and return the gated, filtered, ranked entry set.
+ * Phase 1: gating is satisfied at the source (own = caller-owned; public = visibility-filtered).
+ * Phase 3 will insert a per-hit `canReadWorkspace`/consent pass here for scope=shared.
+ */
+export declare function runDiscovery(registry: DiscoveryRegistry, ctx: DiscoveryContext): Promise<DiscoveryEntry[]>;
+//# sourceMappingURL=run.d.ts.map

package/dist/src/services/discovery/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../../src/services/discovery/run.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAQvD;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,iBAAiB,EAC3B,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,cAAc,EAAE,CAAC,CAU3B"}

package/dist/src/services/discovery/run.js

@@ -0,0 +1,20 @@
+import { applyFilters } from './facets.js';
+/** Rank by relevance (FTS score desc) then recency (updatedAt desc). */
+function rankEntries(entries) {
+    return entries.sort((a, b) => b.score - a.score || (a.updatedAt < b.updatedAt ? 1 : a.updatedAt > b.updatedAt ? -1 : 0));
+}
+/**
+ * Fan across all registered sources and return the gated, filtered, ranked entry set.
+ * Phase 1: gating is satisfied at the source (own = caller-owned; public = visibility-filtered).
+ * Phase 3 will insert a per-hit `canReadWorkspace`/consent pass here for scope=shared.
+ */
+export async function runDiscovery(registry, ctx) {
+    const sources = registry.all();
+    const perSource = await Promise.all(sources.map(async (src) => {
+        const raws = await src.enumerate(ctx);
+        return raws.map(raw => src.toEntry(raw, ctx));
+    }));
+    const all = perSource.flat();
+    return rankEntries(applyFilters(all, ctx.filters));
+}
+//# sourceMappingURL=run.js.map

package/dist/src/services/discovery/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../../../src/services/discovery/run.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,wEAAwE;AACxE,SAAS,WAAW,CAAC,OAAyB;IAC5C,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC3H,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,QAA2B,EAC3B,GAAqB;IAErB,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC;IAC/B,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,GAAG,CACjC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAC,GAAG,EAAC,EAAE;QACtB,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACtC,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IAChD,CAAC,CAAC,CACH,CAAC;IACF,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC;IAC7B,OAAO,WAAW,CAAC,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;AACrD,CAAC"}

package/dist/src/services/discovery/setup.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @file setup.ts
+ * @description Builds the canonical `DiscoveryRegistry` with every production source registered, so
+ *   the REST route (`/v1/discover`) and the MCP tool (`aimeat_discover`) share ONE source list and
+ *   can never drift. Adding a content type = add one `register()` here (design §7) and both surfaces
+ *   pick it up.
+ * @structure buildDiscoveryRegistry(storage, config) → DiscoveryRegistry (memory + capabilities + apps + agent-tasks)
+ * @usage const registry = buildDiscoveryRegistry(storage, config);
+ * @version-history
+ *   v0.1.0 — 2026-06-23 — Phase 4: shared registry builder for REST + MCP surfaces (design doc 2026-06-23).
+ */
+import type { AimeatConfig } from '../../config.js';
+import type { Storage } from '../../storage/interface.js';
+import { type DiscoveryRegistry } from './registry.js';
+export declare function buildDiscoveryRegistry(storage: Storage, config: AimeatConfig): DiscoveryRegistry;
+//# sourceMappingURL=setup.d.ts.map

package/dist/src/services/discovery/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../../src/services/discovery/setup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAkB,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAIvE,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,GAAG,iBAAiB,CAOhG"}

package/dist/src/services/discovery/setup.js

@@ -0,0 +1,12 @@
+import { createRegistry } from './registry.js';
+import { createMemorySource } from './sources/memory-source.js';
+import { createCapabilitiesSource, createAppsSource, createAgentTasksSource } from './sources/table-sources.js';
+export function buildDiscoveryRegistry(storage, config) {
+    const registry = createRegistry();
+    registry.register(createMemorySource(storage, config)); // all memory-backed domains
+    registry.register(createCapabilitiesSource(storage, config)); // capabilities table
+    registry.register(createAppsSource(storage, config)); // apps table
+    registry.register(createAgentTasksSource(storage, config)); // agent_tasks table
+    return registry;
+}
+//# sourceMappingURL=setup.js.map

package/dist/src/services/discovery/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../../../src/services/discovery/setup.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,cAAc,EAA0B,MAAM,eAAe,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAEhH,MAAM,UAAU,sBAAsB,CAAC,OAAgB,EAAE,MAAoB;IAC3E,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAC;IAClC,QAAQ,CAAC,QAAQ,CAAC,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,CAAQ,4BAA4B;IAC3F,QAAQ,CAAC,QAAQ,CAAC,wBAAwB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,CAAE,qBAAqB;IACpF,QAAQ,CAAC,QAAQ,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,CAAU,aAAa;IAC5E,QAAQ,CAAC,QAAQ,CAAC,sBAAsB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,CAAI,oBAAoB;IACnF,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/src/services/discovery/sources/memory-source.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @file memory-source.ts
+ * @description The FTS/memory `DiscoverySource` adapter — the Phase 1 workhorse that surfaces every
+ *   memory-backed domain (knowledge, documents, decisions, workflows, companies, offerings, research,
+ *   material, plain memory) in one place. Query path uses the `storage.searchText()` FTS primitive;
+ *   no-query path (map/browse mode) lists memory. Identity resolution implements the ratified agent
+ *   scope rule (§11.3): an agent sees the FULL owner identity set, but only if it holds `memory:read`
+ *   — otherwise it is restricted to its own GAII. Each row is classified + normalized into a
+ *   `DiscoveryEntry` via the shared pure helpers.
+ * @structure
+ *   - createMemorySource(storage, config) → DiscoverySource
+ *   - resolveOwnerSet() — identity set per scope + agent read-scope (§11.3)
+ *   - enumerate() — searchText (q) or listing (no-q) → MemHit[]
+ *   - toEntry() — classify + normalize → DiscoveryEntry
+ * @usage registry.register(createMemorySource(storage, config));
+ * @version-history
+ *   v0.1.0 — 2026-06-23 — Phase 1: memory/FTS source over searchText + listing (design doc 2026-06-23).
+ */
+import type { AimeatConfig } from '../../../config.js';
+import type { Storage } from '../../../storage/interface.js';
+import type { DiscoverySource } from '../types.js';
+export declare const MEMORY_SOURCE_ID = "memory-fts";
+export declare function createMemorySource(storage: Storage, config: AimeatConfig): DiscoverySource;
+//# sourceMappingURL=memory-source.d.ts.map

package/dist/src/services/discovery/sources/memory-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-source.d.ts","sourceRoot":"","sources":["../../../../../src/services/discovery/sources/memory-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,OAAO,EAAgC,MAAM,+BAA+B,CAAC;AAE3F,OAAO,KAAK,EAAoC,eAAe,EAAU,MAAM,aAAa,CAAC;AAI7F,eAAO,MAAM,gBAAgB,eAAe,CAAC;AA6I7C,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,GAAG,eAAe,CA4D1F"}

package/dist/src/services/discovery/sources/memory-source.js

@@ -0,0 +1,183 @@
+import { canReadWorkspace } from '../../workspace-access.js';
+import { classifyMemoryKey } from '../classify.js';
+import { bestTitle, bestDescription, normalizeTags, normalizeVisibility, toFullOwner } from '../normalize.js';
+export const MEMORY_SOURCE_ID = 'memory-fts';
+const MAX_LIMIT = 100;
+/** Plain searchable text of a value (string leaves joined) — for a fallback description. */
+function flattenText(value) {
+    if (value == null)
+        return '';
+    if (typeof value === 'string')
+        return value;
+    if (typeof value === 'number' || typeof value === 'boolean')
+        return String(value);
+    if (Array.isArray(value))
+        return value.map(flattenText).join(' ');
+    if (typeof value === 'object') {
+        const v = value;
+        if (typeof v.markdown === 'string')
+            return v.markdown;
+        return Object.values(v).map(flattenText).join(' ');
+    }
+    return '';
+}
+function clip(s, max) {
+    const one = s.replace(/\s+/g, ' ').trim();
+    return one.length > max ? one.slice(0, max - 1) + '…' : one;
+}
+function contentTypeOf(key, value) {
+    if (!key.endsWith('/manifest'))
+        return undefined;
+    if (value && typeof value === 'object' && !Array.isArray(value)) {
+        const ct = value.content_type;
+        if (typeof ct === 'string')
+            return ct;
+    }
+    return undefined;
+}
+function toMemHit(rec, score) {
+    return {
+        key: rec.key,
+        ownerGaii: rec.ownerGaii,
+        value: rec.value,
+        visibility: rec.visibility,
+        tags: rec.tags ?? [],
+        updatedAt: rec.updatedAt,
+        score,
+        flagCount: rec.flagCount ?? 0,
+        contentType: contentTypeOf(rec.key, rec.value),
+    };
+}
+/**
+ * Resolve which owner identities to search for the `own` scope, honoring the agent read-scope rule.
+ * Returns null for the public scope (caller wants whole-node public content, not an owner set).
+ */
+async function resolveOwnerSet(storage, config, ctx) {
+    if (ctx.scope === 'public')
+        return null;
+    const ghii = `${ctx.caller.ownerName}@${config.nodeId}`;
+    const fullSet = ctx.caller.isOwnerSession || ctx.caller.scopes.includes('memory:read');
+    if (!fullSet)
+        return [ctx.caller.gaii]; // agent without memory:read → its own content only (§11.3)
+    const [agents, ecoApps] = await Promise.all([
+        storage.getAgentsByOwner(ctx.caller.ownerName),
+        storage.getEcosystemAppsByOwner(ctx.caller.ownerName),
+    ]);
+    return [ghii, ...agents.map(a => a.gaii), ...ecoApps.map(a => a.geai)];
+}
+const WS_KEY = /^organism\.([^.]+)\.w\.([^.]+)\.([^.]+)/; // organism.{id}.w.{ws}.{space}…
+/**
+ * Shared scope (design §6, the security-critical path): surface content in organisms the caller is an
+ * ACTIVE member of, but only the workspaces they are actually allowed to read. Every candidate hit is
+ * gated by `canReadWorkspace()` — the SAME gate as the REST workspace read — so nothing leaks. The
+ * decision is memoized per `(organism, workspace)` so a workspace with N hits costs ONE gate check.
+ */
+async function enumerateShared(storage, config, ctx) {
+    if (!ctx.caller.ownerName)
+        return [];
+    const limit = Math.min(ctx.filters.limit ?? 50, MAX_LIMIT);
+    const q = ctx.filters.q?.trim();
+    const memberships = (await storage.listMembershipsByGhii(ctx.caller.ownerName)).filter(m => m.status === 'active');
+    if (memberships.length === 0)
+        return [];
+    const orgCache = new Map();
+    const gateCache = new Map();
+    const out = [];
+    for (const mem of memberships) {
+        const orgId = mem.organismId;
+        const prefix = `organism.${orgId}.w.`;
+        let pairs;
+        if (q) {
+            const raw = await storage.searchText(q, { keyPrefix: prefix, limit, maxFlags: 0 });
+            pairs = raw.map(r => ({ rec: r.record, score: r.score }));
+        }
+        else {
+            const { items } = await storage.listAllMemory({ prefix, limit });
+            pairs = items.filter(r => (r.flagCount ?? 0) === 0).map(rec => ({ rec, score: 0 }));
+        }
+        for (const { rec, score } of pairs) {
+            const m = WS_KEY.exec(rec.key);
+            if (!m)
+                continue;
+            const ws = m[2];
+            const space = m[3];
+            if (space === 'meta')
+                continue; // skip manifests / workspace meta / comments
+            if (rec.key.includes('.history.'))
+                continue; // skip version history
+            const gk = `${orgId}|${ws}`;
+            let allowed = gateCache.get(gk);
+            if (allowed === undefined) {
+                let org = orgCache.get(orgId);
+                if (org === undefined) {
+                    org = await storage.getOrganism(orgId);
+                    orgCache.set(orgId, org);
+                }
+                allowed = org
+                    ? await canReadWorkspace(storage, config, org, ctx.caller.sub, ctx.caller.ownerName, ctx.caller.gaii, ws)
+                    : false;
+                gateCache.set(gk, allowed);
+            }
+            if (allowed)
+                out.push(toMemHit(rec, score));
+        }
+    }
+    return out;
+}
+export function createMemorySource(storage, config) {
+    return {
+        id: MEMORY_SOURCE_ID,
+        gating: 'visibility',
+        async enumerate(ctx) {
+            if (ctx.scope === 'shared') {
+                const shared = await enumerateShared(storage, config, ctx);
+                return shared.map(h => ({ sourceId: MEMORY_SOURCE_ID, record: h, score: h.score }));
+            }
+            const limit = Math.min(ctx.filters.limit ?? 50, MAX_LIMIT);
+            const q = ctx.filters.q?.trim();
+            const ownerGaiis = await resolveOwnerSet(storage, config, ctx);
+            let hits;
+            if (q) {
+                // Query path: ranked FTS. Public scope restricts to public visibility node-wide.
+                const raw = await storage.searchText(q, {
+                    ownerGaiis: ownerGaiis ?? undefined,
+                    visibility: ownerGaiis ? undefined : 'public',
+                    limit,
+                    maxFlags: 0,
+                });
+                hits = raw.map(({ record, score }) => toMemHit(record, score));
+            }
+            else if (ownerGaiis) {
+                // No-query own scope: list each identity's memory, merge, slice.
+                const lists = await Promise.all(ownerGaiis.map(gaii => storage.listMemory(gaii, { maxFlags: 0 })));
+                hits = lists.flat().map(rec => toMemHit(rec, 0));
+            }
+            else {
+                // No-query public scope: list public memory node-wide.
+                const { items } = await storage.listAllMemory({ visibility: 'public', limit });
+                hits = items.filter(r => (r.flagCount ?? 0) === 0).map(rec => toMemHit(rec, 0));
+            }
+            return hits.map(h => ({ sourceId: MEMORY_SOURCE_ID, record: h, score: h.score }));
+        },
+        toEntry(raw, _ctx) {
+            const h = raw.record;
+            const { type, segment } = classifyMemoryKey(h.key, { tags: h.tags, contentType: h.contentType });
+            const description = bestDescription(h.value) || clip(flattenText(h.value), 240);
+            return {
+                type,
+                segment,
+                id: h.key,
+                title: bestTitle(h.value, h.key.split('.').pop() || h.key),
+                description,
+                tags: normalizeTags({ tags: h.tags }),
+                visibility: normalizeVisibility(h.visibility),
+                owner: toFullOwner(h.ownerGaii, config.nodeId),
+                node: config.nodeId,
+                score: h.score,
+                updatedAt: h.updatedAt,
+                href: `/v1/memory/${encodeURIComponent(h.key)}`,
+            };
+        },
+    };
+}
+//# sourceMappingURL=memory-source.js.map

package/dist/src/services/discovery/sources/memory-source.js.map

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

package/dist/src/services/discovery/sources/table-sources.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @file table-sources.ts
+ * @description The Phase 2 table-backed `DiscoverySource` adapters — capabilities, apps, and agent
+ *   tasks. These domains live in dedicated SQL tables (outside the memory FTS index), so each adapter
+ *   enumerates via the domain's existing list method and maps rows into the shared `DiscoveryEntry`
+ *   shape. Registering them alongside the memory source (Phase 1) proves the registry pattern with
+ *   heterogeneous sources — the `/v1/discover` handler does not change. Scope handling: `own` lists
+ *   the caller's own records; `public` lists publicly-visible records node-wide (agent tasks are
+ *   owner-only and never appear in the public scope).
+ * @structure
+ *   - createCapabilitiesSource() — capabilities table → type 'capability'
+ *   - createAppsSource() — apps table (latest version per app) → type 'app'
+ *   - createAgentTasksSource() — agent_tasks table → type 'material'
+ * @usage registry.register(createCapabilitiesSource(storage, config)); …
+ * @version-history
+ *   v0.1.0 — 2026-06-23 — Phase 2: capabilities / apps / agent-task adapters (design doc 2026-06-23).
+ */
+import type { AimeatConfig } from '../../../config.js';
+import type { Storage } from '../../../storage/interface.js';
+import type { DiscoverySource } from '../types.js';
+export declare const CAPABILITIES_SOURCE_ID = "capabilities";
+export declare const APPS_SOURCE_ID = "apps";
+export declare const AGENT_TASKS_SOURCE_ID = "agent-tasks";
+export declare function createCapabilitiesSource(storage: Storage, config: AimeatConfig): DiscoverySource;
+export declare function createAppsSource(storage: Storage, config: AimeatConfig): DiscoverySource;
+export declare function createAgentTasksSource(storage: Storage, config: AimeatConfig): DiscoverySource;
+//# sourceMappingURL=table-sources.d.ts.map

package/dist/src/services/discovery/sources/table-sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-sources.d.ts","sourceRoot":"","sources":["../../../../../src/services/discovery/sources/table-sources.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,OAAO,EAAgD,MAAM,+BAA+B,CAAC;AAE3G,OAAO,KAAK,EAAoC,eAAe,EAAU,MAAM,aAAa,CAAC;AAG7F,eAAO,MAAM,sBAAsB,iBAAiB,CAAC;AACrD,eAAO,MAAM,cAAc,SAAS,CAAC;AACrC,eAAO,MAAM,qBAAqB,gBAAgB,CAAC;AAOnD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,GAAG,eAAe,CAiChG;AAcD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,GAAG,eAAe,CAgCxF;AAGD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,GAAG,eAAe,CAkC9F"}

package/dist/src/services/discovery/sources/table-sources.js

@@ -0,0 +1,128 @@
+import { parseGaiiLoose } from '../../../utils/gaii.js';
+import { normalizeTags, normalizeVisibility, parkedToVisibility, toFullOwner } from '../normalize.js';
+export const CAPABILITIES_SOURCE_ID = 'capabilities';
+export const APPS_SOURCE_ID = 'apps';
+export const AGENT_TASKS_SOURCE_ID = 'agent-tasks';
+const MAX = 100;
+const limitOf = (ctx) => Math.min(ctx.filters.limit ?? 50, MAX);
+const ghiiOf = (ctx, config) => `${ctx.caller.ownerName}@${config.nodeId}`;
+// ── Capabilities ──────────────────────────────────────────────────────────────
+export function createCapabilitiesSource(storage, config) {
+    return {
+        id: CAPABILITIES_SOURCE_ID,
+        gating: 'visibility',
+        async enumerate(ctx) {
+            // No per-member capability sharing model — shared scope adds nothing here.
+            if (ctx.scope === 'shared')
+                return [];
+            const perPage = limitOf(ctx);
+            const search = ctx.filters.q?.trim() || undefined; // honor free-text query (native FTS-ish filter)
+            const filter = ctx.scope === 'public'
+                ? { visibility: 'public', status: 'active', search, perPage }
+                : { ownerGhii: ghiiOf(ctx, config), search, perPage };
+            const { capabilities } = await storage.listCapabilities(filter);
+            return capabilities.map(c => ({ sourceId: CAPABILITIES_SOURCE_ID, record: c, score: 0 }));
+        },
+        toEntry(raw) {
+            const c = raw.record;
+            return {
+                type: 'capability',
+                segment: c.source?.type ?? null,
+                id: c.id,
+                title: c.name,
+                description: c.summary ?? '',
+                tags: normalizeTags({ tags: c.tags }),
+                visibility: normalizeVisibility(c.visibility),
+                owner: toFullOwner(c.ownerGhii, config.nodeId),
+                node: config.nodeId,
+                score: 0,
+                updatedAt: c.updatedAt,
+                href: `/v1/capabilities/${encodeURIComponent(c.id)}`,
+            };
+        },
+    };
+}
+// ── Apps ───────────────────────────────────────────────────────────────────────
+/** Keep one row per app (owner+filename), preferring the highest version number. */
+function latestApps(apps) {
+    const best = new Map();
+    for (const a of apps) {
+        const key = `${a.ownerGaii}/${a.filename}`;
+        const cur = best.get(key);
+        if (!cur || a.versionNumber > cur.versionNumber)
+            best.set(key, a);
+    }
+    return [...best.values()];
+}
+export function createAppsSource(storage, config) {
+    return {
+        id: APPS_SOURCE_ID,
+        gating: 'visibility',
+        async enumerate(ctx) {
+            if (ctx.scope === 'shared')
+                return [];
+            const limit = limitOf(ctx);
+            const q = ctx.filters.q?.trim() || undefined; // honor free-text query
+            const opts = ctx.scope === 'public'
+                ? { q, limit }
+                : { ownerGaii: ghiiOf(ctx, config), viewerGhii: ghiiOf(ctx, config), q, limit };
+            const { apps } = await storage.listApps(opts);
+            return latestApps(apps).map(a => ({ sourceId: APPS_SOURCE_ID, record: a, score: 0 }));
+        },
+        toEntry(raw) {
+            const a = raw.record;
+            return {
+                type: 'app',
+                segment: a.manifest.category || null,
+                id: `${a.ownerGaii}/${a.filename}`,
+                title: a.manifest.name || a.filename,
+                description: a.manifest.description ?? '',
+                tags: normalizeTags({ tags: a.manifest.tags }),
+                visibility: parkedToVisibility(a.parked),
+                owner: toFullOwner(a.ownerGaii, config.nodeId),
+                node: config.nodeId,
+                score: 0,
+                updatedAt: a.createdAt,
+                href: `/v1/apps/${encodeURIComponent(a.ownerName)}/${encodeURIComponent(a.filename)}`,
+            };
+        },
+    };
+}
+// ── Agent tasks (produced material) ──────────────────────────────────────────────
+export function createAgentTasksSource(storage, config) {
+    return {
+        id: AGENT_TASKS_SOURCE_ID,
+        gating: 'none', // owner-scoped records; never surfaced in the public scope
+        async enumerate(ctx) {
+            // Owner-only records: present in the owner's own scope, never in public or shared.
+            if (ctx.scope !== 'own' || !ctx.caller.ownerName)
+                return [];
+            const { tasks } = await storage.listAgentTasksByOwner(ghiiOf(ctx, config), { perPage: limitOf(ctx) });
+            // No native text search on tasks — apply the free-text query client-side over title/description.
+            const q = ctx.filters.q?.trim().toLowerCase();
+            const matched = q
+                ? tasks.filter(t => `${t.title} ${t.description}`.toLowerCase().includes(q))
+                : tasks;
+            return matched.map(t => ({ sourceId: AGENT_TASKS_SOURCE_ID, record: t, score: 0 }));
+        },
+        toEntry(raw) {
+            const t = raw.record;
+            const agentName = parseGaiiLoose(t.agentGaii).agent || 'agent';
+            return {
+                type: 'material',
+                segment: t.rating?.context ?? t.status ?? null,
+                id: t.id,
+                title: t.title,
+                description: t.description ?? '',
+                tags: [],
+                visibility: 'owner',
+                owner: toFullOwner(t.ownerGaii, config.nodeId),
+                node: config.nodeId,
+                score: 0,
+                updatedAt: t.updatedAt,
+                href: `/v1/agents/${encodeURIComponent(agentName)}/tasks/${encodeURIComponent(t.id)}`,
+            };
+        },
+    };
+}
+//# sourceMappingURL=table-sources.js.map

package/dist/src/services/discovery/sources/table-sources.js.map

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

package/dist/src/services/discovery/types.d.ts

@@ -0,0 +1,117 @@
+/**
+ * @file types.ts
+ * @description Core types for the unified cross-domain "master directory" discovery system.
+ *   Defines the normalized `DiscoveryEntry` shape every domain maps into, the `DiscoverySource`
+ *   adapter interface (the extension seam — adding a content type = registering one adapter), the
+ *   per-call `DiscoveryContext`, query `DiscoveryFilters`, and the canonical type/visibility/gating
+ *   enums. Pure types + enums only — no runtime logic, no storage access.
+ * @structure
+ *   - DiscoveryType / CanonicalVisibility / GatingKind — the controlled vocabularies
+ *   - DiscoveryEntry — the one shape callers see
+ *   - DiscoveryFilters / DiscoveryContext — query inputs
+ *   - RawHit / DiscoverySource — the adapter contract (§7 of the design doc)
+ * @usage
+ *   import type { DiscoverySource, DiscoveryEntry } from '../discovery/types.js';
+ * @version-history
+ *   v0.1.0 — 2026-06-23 — Phase 0: initial contract (design doc 2026-06-23-master-directory-discovery).
+ */
+/** The taxonomy an LLM filters on. Extend here + add an llms.txt word when a new kind ships (§7.3). */
+export type DiscoveryType = 'capability' | 'workflow' | 'knowledge' | 'decision' | 'research' | 'material' | 'company' | 'offering' | 'document' | 'organism' | 'app' | 'memory';
+/** Canonical visibility ladder; every domain's native enum collapses into this (design §5). */
+export type CanonicalVisibility = 'private' | 'owner' | 'shared' | 'unlisted' | 'public';
+/** How a hit from a source must be access-checked before it can enter a result (design §6). */
+export type GatingKind = 'none' | 'visibility' | 'workspace' | 'consent';
+/** The single normalized shape returned by `/v1/discover` regardless of source domain. */
+export interface DiscoveryEntry {
+    type: DiscoveryType;
+    /** Coarse area within the type (e.g. knowledge content_type, app category); null when none. */
+    segment: string | null;
+    /** Stable id within the type. */
+    id: string;
+    title: string;
+    /** Best-available human text: description | summary | ask | snippet. */
+    description: string;
+    /** Normalized, deduped tags (sourced from native `tags[]` / `interests[]`). */
+    tags: string[];
+    visibility: CanonicalVisibility;
+    /** Always a full GHII `owner@node-id` (never a bare name). */
+    owner: string;
+    /** Origin node id (self in v1; federation later). */
+    node: string;
+    /** FTS rank for memory hits; recency-derived or 0 for table hits. */
+    score: number;
+    updatedAt: string;
+    /** Canonical fetch URL for the full record. */
+    href: string;
+    /** Set when an entry was deduped from another representation (e.g. a company-listed offer that
+     *  originates from a specific agent). Names the underlying producer. */
+    provenance?: string;
+}
+/** Filters parsed from the query string; all optional. */
+export interface DiscoveryFilters {
+    q?: string;
+    types?: DiscoveryType[];
+    segments?: string[];
+    /** ALL-match: an entry must carry every listed tag. */
+    tags?: string[];
+    owner?: string;
+    limit?: number;
+}
+/** Resolved caller identity + scope for one discovery call. */
+export interface DiscoveryContext {
+    caller: {
+        /** Bare owner name. */
+        ownerName: string;
+        /** Raw auth subject (`req.auth.sub`) — bare owner for owner sessions, full GAII for agents.
+         *  Needed by the workspace gate to match org agent membership. */
+        sub: string;
+        /** Full GAII (agent) or GHII (owner session) — `resolveIdentity` result. */
+        gaii: string;
+        isOwnerSession: boolean;
+        /** Granted read-scopes — used to filter an agent's view of the owner set (design §11.3). */
+        scopes: string[];
+    };
+    scope: 'own' | 'public' | 'shared';
+    filters: DiscoveryFilters;
+    nodeId: string;
+}
+/** A source-native candidate row, pre-normalization. `record` is the domain's own record. */
+export interface RawHit {
+    sourceId: string;
+    record: unknown;
+    /** FTS score if applicable; adapters without ranking set 0. */
+    score?: number;
+    /** Per-hit gating override (may be stricter than the source default). */
+    gating?: GatingKind;
+}
+/**
+ * A discovery source adapter — the extension seam. Adding a new content type to AIMEAT means
+ * implementing this interface and registering it (design §7). The `/v1/discover` handler contains
+ * no domain-specific logic; it iterates registered sources.
+ */
+export interface DiscoverySource {
+    /** Stable source id, e.g. "memory-fts", "capabilities", "apps". */
+    id: string;
+    /** Enumerate candidate rows for this caller + scope. Cheap; gating happens later. */
+    enumerate(ctx: DiscoveryContext): Promise<RawHit[]>;
+    /** Map one raw row → a normalized DiscoveryEntry. */
+    toEntry(raw: RawHit, ctx: DiscoveryContext): DiscoveryEntry;
+    /** Default gating requirement for hits from this source. */
+    gating: GatingKind;
+}
+/** A facet bucket for map mode (`/v1/discover/facets`). */
+export interface FacetCount {
+    value: string;
+    count: number;
+}
+/** The map-mode response shape (design §4.3). */
+export interface DiscoveryFacets {
+    types: FacetCount[];
+    segments: Array<{
+        type: DiscoveryType;
+        segment: string;
+        count: number;
+    }>;
+    tags: FacetCount[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/services/discovery/types.d.ts.map

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

package/dist/src/services/discovery/types.js

@@ -0,0 +1,19 @@
+/**
+ * @file types.ts
+ * @description Core types for the unified cross-domain "master directory" discovery system.
+ *   Defines the normalized `DiscoveryEntry` shape every domain maps into, the `DiscoverySource`
+ *   adapter interface (the extension seam — adding a content type = registering one adapter), the
+ *   per-call `DiscoveryContext`, query `DiscoveryFilters`, and the canonical type/visibility/gating
+ *   enums. Pure types + enums only — no runtime logic, no storage access.
+ * @structure
+ *   - DiscoveryType / CanonicalVisibility / GatingKind — the controlled vocabularies
+ *   - DiscoveryEntry — the one shape callers see
+ *   - DiscoveryFilters / DiscoveryContext — query inputs
+ *   - RawHit / DiscoverySource — the adapter contract (§7 of the design doc)
+ * @usage
+ *   import type { DiscoverySource, DiscoveryEntry } from '../discovery/types.js';
+ * @version-history
+ *   v0.1.0 — 2026-06-23 — Phase 0: initial contract (design doc 2026-06-23-master-directory-discovery).
+ */
+export {};
+//# sourceMappingURL=types.js.map