@manta-eu/client 0.1.0

package/dist/shared/stakeholder-iri.d.ts

@@ -0,0 +1,7 @@
+export declare const userIriPrefix: string;
+export declare const teamIriPrefix: string;
+export declare function getUserIri(userId: string): string;
+export declare function parseUserIdFromIri(iri: string): string | null;
+export declare function getTeamIri(path: string): string;
+export declare function parseTeamPathFromIri(iri: string): string | null;
+//# sourceMappingURL=stakeholder-iri.d.ts.map

package/dist/shared/stakeholder-iri.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stakeholder-iri.d.ts","sourceRoot":"","sources":["../../src/shared/stakeholder-iri.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,aAAa,QAAyB,CAAC;AACpD,eAAO,MAAM,aAAa,QAAyB,CAAC;AAEpD,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG7D;AAGD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG/D"}

package/dist/shared/stakeholder-iri.js

@@ -0,0 +1,20 @@
+import { decodeIriLocalName, encodeIriLocalName, expandPrefix } from "./rdf-namespaces.js";
+export const userIriPrefix = expandPrefix(":User_");
+export const teamIriPrefix = expandPrefix(":Team_");
+export function getUserIri(userId) {
+    return `${userIriPrefix}${encodeIriLocalName(userId)}`;
+}
+export function parseUserIdFromIri(iri) {
+    if (!iri.startsWith(userIriPrefix))
+        return null;
+    return decodeIriLocalName(iri.slice(userIriPrefix.length));
+}
+// Team paths are stored encodeURIComponent'd, so re-encoding them here would orphan existing nodes
+export function getTeamIri(path) {
+    return `${teamIriPrefix}${encodeURIComponent(path)}`;
+}
+export function parseTeamPathFromIri(iri) {
+    if (!iri.startsWith(teamIriPrefix))
+        return null;
+    return decodeIriLocalName(iri.slice(teamIriPrefix.length));
+}

package/dist/shared/team-activation.d.ts

@@ -0,0 +1,7 @@
+export type ActivationAccessArgs = {
+    realmAllows: boolean;
+    flagEnabled: boolean | undefined;
+    wholeOrg: boolean;
+};
+export declare function canManageActivation({ realmAllows, flagEnabled, wholeOrg }: ActivationAccessArgs): boolean;
+//# sourceMappingURL=team-activation.d.ts.map

package/dist/shared/team-activation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-activation.d.ts","sourceRoot":"","sources":["../../src/shared/team-activation.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,oBAAoB,GAAG;IACjC,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,GAAG,SAAS,CAAC;IACjC,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,EAAE,oBAAoB,GAAG,OAAO,CAEzG"}

package/dist/shared/team-activation.js

@@ -0,0 +1,3 @@
+export function canManageActivation({ realmAllows, flagEnabled, wholeOrg }) {
+    return realmAllows && flagEnabled === true && wholeOrg;
+}

package/dist/shared/team.d.ts

@@ -0,0 +1,150 @@
+export type TeamRole = string;
+export type TeamMember = {
+    id: string;
+    email?: string;
+    name?: string;
+    roles: string[];
+    pending: boolean;
+    inviteUrl?: string;
+    teams: string[];
+    federated?: boolean;
+    enabled: boolean;
+};
+export type TeamOrganization = {
+    alias?: string;
+    name?: string;
+    managed: boolean;
+    mirrored: boolean;
+    inviteCarriesGrants?: true;
+};
+export type TeamRoster = {
+    members: TeamMember[];
+    truncated: boolean;
+    organization?: TeamOrganization;
+};
+export type TeamGroup = {
+    name: string;
+    path: string;
+    depth: number;
+    selectable?: boolean;
+};
+export type UserLabelSource = {
+    id: string;
+    name?: string;
+    email?: string;
+    username?: string;
+};
+export declare function userLabel(user: UserLabelSource): string;
+export type DirectoryMembership = {
+    org: string;
+    name?: string;
+    groups: string[];
+};
+export type DirectoryUser = {
+    id: string;
+    username?: string;
+    email?: string;
+    name?: string;
+    memberships: DirectoryMembership[];
+    pending?: boolean;
+    inviteUrl?: string;
+    federated?: boolean;
+    enabled: boolean;
+};
+export type DirectoryScanCursor = {
+    offset: number;
+    matched: number;
+};
+export type TeamDirectory = {
+    users: DirectoryUser[];
+    truncated: boolean;
+    /** Rows matching the query across the realm, or undefined when the filter can only be counted by scanning. */
+    total?: number;
+    hasMore: boolean;
+    scanCursor?: DirectoryScanCursor;
+};
+export declare const directoryPageSize = 20;
+export declare const maxDirectoryPageSize = 100;
+export type AssignableGroup = {
+    path: string;
+    name: string;
+    depth: number;
+    selectable?: boolean;
+};
+export type AssignableOrganization = {
+    alias: string;
+    name?: string;
+    wholeOrg?: boolean;
+    groups?: AssignableGroup[];
+};
+export type AssignTarget = {
+    org: string;
+    group?: string;
+};
+export type BulkMutationFailure = {
+    id: string;
+    message: string;
+};
+export type AssignmentOutcome = "assigned" | "already" | "failed";
+export type AssignmentResult = AssignTarget & {
+    userId: string;
+    outcome: AssignmentOutcome;
+    message?: string;
+};
+export type AssignmentSummary = {
+    results: AssignmentResult[];
+    assigned: number;
+    skipped: number;
+    failed: number;
+    roleFailures: BulkMutationFailure[];
+};
+export type AssignmentRole = {
+    userId: string;
+    role: string;
+};
+export type BulkMutationResult = {
+    attempted: number;
+    changed: number;
+    failures: BulkMutationFailure[];
+};
+export type BulkUserOrgPair = {
+    userId: string;
+    org?: string;
+};
+export declare function bulkPairId(pair: BulkUserOrgPair): string;
+export declare function pathSegments(path: string): string[];
+/** Mirrors manta-clj's normalization, so client-side comparisons match its replies. */
+export declare function normalizeGroupPath(path: string): string;
+export declare function namesAGroup(path: string | undefined): boolean;
+export declare function ancestorPaths(path: string): string[];
+export declare function groupNameFromPath(path: string): string;
+export declare function groupDepthFromPath(path: string): number;
+export declare function chunk<T>(items: T[], size: number): T[][];
+export declare const waveSize = 8;
+export declare function mapInWaves<T, R>(items: T[], fn: (item: T) => Promise<R>, size?: number): Promise<R[]>;
+export declare const maxAssignmentPairs = 200;
+export declare const maxBulkMembers = 300;
+export declare function assignTargetKey(target: AssignTarget): string;
+export type InviteOutcome = "invited" | "already" | "failed";
+export type InviteGrantOutcome = "applied" | "recorded" | "dropped";
+export type InviteResult = {
+    email: string;
+    id?: string;
+    outcome: InviteOutcome;
+    message?: string;
+    grant?: InviteGrantOutcome;
+};
+export type InviteSummary = {
+    results: InviteResult[];
+    invited: number;
+    skipped: number;
+    failed: number;
+};
+export declare function isEmailAddress(value: string): boolean;
+export type EmailListParse = {
+    emails: string[];
+    invalid: string[];
+};
+/** Folds like manta-clj's distinct-emails: case-insensitively, first spelling wins. */
+export declare function parseEmailList(raw: string): EmailListParse;
+//# sourceMappingURL=team.d.ts.map

package/dist/shared/team.d.ts.map

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

package/dist/shared/team.js

@@ -0,0 +1,88 @@
+import { isPresent } from "@manta-eu/lib/present";
+import { splitEvery } from "ramda";
+export function userLabel(user) {
+    return user.name ?? user.email ?? user.username ?? user.id;
+}
+export const directoryPageSize = 20;
+export const maxDirectoryPageSize = 100;
+export function bulkPairId(pair) {
+    return `${pair.userId}:${pair.org}`;
+}
+export function pathSegments(path) {
+    return path.split("/").filter(isPresent);
+}
+/** Mirrors manta-clj's normalization, so client-side comparisons match its replies. */
+export function normalizeGroupPath(path) {
+    return `/${pathSegments(path).join("/")}`;
+}
+export function namesAGroup(path) {
+    return path !== undefined && isPresent(pathSegments(path));
+}
+export function ancestorPaths(path) {
+    const segments = pathSegments(path);
+    return segments.slice(0, -1).map((_, index) => normalizeGroupPath(segments.slice(0, index + 1).join("/")));
+}
+// Keycloak forbids "/" in group names, so the last segment is unambiguously the group's own name.
+export function groupNameFromPath(path) {
+    return pathSegments(path).at(-1) ?? path;
+}
+export function groupDepthFromPath(path) {
+    return pathSegments(path).length;
+}
+export function chunk(items, size) {
+    return splitEvery(size, items);
+}
+export const waveSize = 8;
+export async function mapInWaves(items, fn, size = waveSize) {
+    const results = [];
+    for (const wave of chunk(items, size)) {
+        results.push(...(await Promise.all(wave.map(fn))));
+    }
+    return results;
+}
+export const maxAssignmentPairs = 200;
+export const maxBulkMembers = 300;
+export function assignTargetKey(target) {
+    return namesAGroup(target.group) ? `${target.org}${normalizeGroupPath(target.group ?? "")}` : target.org;
+}
+// Same shape as metric.spec.core/email-regex, so client and server reject the same addresses.
+const emailPattern = /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,63}$/;
+export function isEmailAddress(value) {
+    return emailPattern.test(value);
+}
+const pastedContact = /([^,;<]*)<([^>]*)>/g;
+function extractContacts(raw) {
+    const entries = [];
+    const rest = raw.replace(pastedContact, (match, _label, address) => {
+        const trimmed = address.trim();
+        entries.push(isEmailAddress(trimmed) ? trimmed : match.trim());
+        return " ";
+    });
+    return { entries, rest };
+}
+/** Folds like manta-clj's distinct-emails: case-insensitively, first spelling wins. */
+export function parseEmailList(raw) {
+    const seen = new Set();
+    const emails = [];
+    const invalid = [];
+    function take(entry) {
+        if (!isPresent(entry))
+            return;
+        if (!isEmailAddress(entry)) {
+            if (!invalid.includes(entry))
+                invalid.push(entry);
+            return;
+        }
+        const key = entry.toLowerCase();
+        if (seen.has(key))
+            return;
+        seen.add(key);
+        emails.push(entry);
+    }
+    const { entries, rest } = extractContacts(raw);
+    for (const entry of entries)
+        take(entry);
+    for (const entry of rest.split(/[,;\s]+/))
+        take(entry.trim());
+    return { emails, invalid };
+}

package/dist/shared/tools/coercers.d.ts

@@ -0,0 +1,6 @@
+import type { ShowEntitiesOutput, SparqlJsonResults, ToolErrorResult, ToolName, ToolOutputType } from "./types.js";
+export declare function isErrorToolResult(data: unknown): data is ToolErrorResult;
+export declare function isSparqlJsonResults(data: unknown): data is SparqlJsonResults;
+export declare function isShowEntitiesResult(data: unknown): data is Exclude<ShowEntitiesOutput, ToolErrorResult>;
+export declare function coerceToolOutput<T extends ToolName>(toolName: T, raw: unknown): ToolOutputType<T>;
+//# sourceMappingURL=coercers.d.ts.map

package/dist/shared/tools/coercers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coercers.d.ts","sourceRoot":"","sources":["../../../src/shared/tools/coercers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,QAAQ,EAER,cAAc,EACf,MAAM,SAAS,CAAC;AAEjB,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,eAAe,CAExE;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,iBAAiB,CAS5E;AAyBD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,OAAO,CAAC,kBAAkB,EAAE,eAAe,CAAC,CAQxG;AAWD,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,QAAQ,EAAE,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,OAAO,GAAG,cAAc,CAAC,CAAC,CAAC,CAajG"}

package/dist/shared/tools/coercers.js

@@ -0,0 +1,63 @@
+import { isJsonLdGraphDocument } from "#types/jsonld";
+export function isErrorToolResult(data) {
+    return typeof data === "object" && data !== null && "is_error" in data && data.is_error === true;
+}
+export function isSparqlJsonResults(data) {
+    return (typeof data === "object" &&
+        data !== null &&
+        "head" in data &&
+        "results" in data &&
+        typeof data.head === "object" &&
+        typeof data.results === "object");
+}
+function coerceWith(toolName, raw, guards) {
+    if (typeof raw === "string") {
+        try {
+            raw = JSON.parse(raw);
+        }
+        catch {
+            return { is_error: true, content: `Failed to parse tool output: ${raw}` };
+        }
+    }
+    if (isErrorToolResult(raw))
+        return raw;
+    for (const guard of guards) {
+        if (guard(raw))
+            return raw;
+    }
+    return { is_error: true, content: `Unexpected ${toolName} output format` };
+}
+function coerceRDFoxFactsOutput(raw) {
+    return coerceWith("getRDFoxFacts", raw, [isSparqlJsonResults, isJsonLdGraphDocument]);
+}
+export function isShowEntitiesResult(data) {
+    if (typeof data !== "object" || data === null)
+        return false;
+    if (!("entityIris" in data) || !("graph" in data))
+        return false;
+    return (Array.isArray(data.entityIris) &&
+        data.entityIris.every((iri) => typeof iri === "string") &&
+        isJsonLdGraphDocument(data.graph));
+}
+function coerceShowEntitiesOutput(raw) {
+    return coerceWith("showEntities", raw, [isShowEntitiesResult]);
+}
+const coercers = {
+    getRDFoxFacts: coerceRDFoxFactsOutput,
+    showEntities: coerceShowEntitiesOutput,
+};
+export function coerceToolOutput(toolName, raw) {
+    const coercer = coercers[toolName];
+    if (coercer) {
+        return coercer(raw);
+    }
+    if (typeof raw === "string") {
+        try {
+            return JSON.parse(raw);
+        }
+        catch {
+            return raw;
+        }
+    }
+    return raw;
+}

package/dist/shared/tools/index.d.ts

@@ -0,0 +1,4 @@
+export { coerceToolOutput, isErrorToolResult, isShowEntitiesResult, isSparqlJsonResults } from "./coercers.js";
+export { allToolNames, assertValidToolName, getHumanToolName, getSkillToolLabel, getToolMetadata, getToolUIPartLabel, isValidToolName, toolMetadata, } from "./metadata.js";
+export type { ActionPlanShowcaseInput, ActionPlanShowcaseOutput, ActionPlanStatus, AddRDFoxFactsInput, AddRDFoxFactsOutput, CancelScheduleInput, CancelScheduleOutput, ExecuteActionPlanInput, ExecuteActionPlanOutput, ExplainRDFoxRulesInput, ExplainRDFoxRulesOutput, GenerateChartInput, GenerateChartOutput, GetRDFoxRulesInput, GetRDFoxRulesOutput, ListScheduledTasksInput, ListScheduledTasksOutput, RDFoxFactsInput, RDFoxFactsOutput, ScheduleTaskInput, ScheduleTaskOutput, ShowEntitiesInput, ShowEntitiesOutput, SparqlJsonBinding, SparqlJsonResults, SparqlValue, ToolCategory, ToolDefinition, ToolDefinitions, ToolErrorResult, ToolInputSchema, ToolMetadata, ToolName, ToolOutput, ToolOutputCoercer, ToolOutputType, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAC5G,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,uBAAuB,EACvB,wBAAwB,EACxB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACvB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,EACxB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,EACX,YAAY,EACZ,cAAc,EACd,eAAe,EACf,eAAe,EACf,eAAe,EACf,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,iBAAiB,EACjB,cAAc,GACf,MAAM,SAAS,CAAC"}

package/dist/shared/tools/index.js

@@ -0,0 +1,2 @@
+export { coerceToolOutput, isErrorToolResult, isShowEntitiesResult, isSparqlJsonResults } from "./coercers.js";
+export { allToolNames, assertValidToolName, getHumanToolName, getSkillToolLabel, getToolMetadata, getToolUIPartLabel, isValidToolName, toolMetadata, } from "./metadata.js";

package/dist/shared/tools/metadata.d.ts

@@ -0,0 +1,12 @@
+import type { ToolUIPart } from "ai";
+import type { ToolMetadata, ToolName } from "./types.js";
+export declare const toolMetadata: ToolMetadata;
+export declare function getToolMetadata<T extends ToolName>(toolName: T): ToolMetadata[T];
+export type GetHumanToolNameInput<T extends ToolName> = Parameters<ToolMetadata[T]["getHumanName"]>[0];
+export declare function getHumanToolName<T extends ToolName>(toolName: T, input?: Record<string, unknown>): string;
+export declare function isValidToolName(toolName: string): toolName is ToolName;
+export declare function getSkillToolLabel(toolUIPart: ToolUIPart): string | undefined;
+export declare function getToolUIPartLabel(toolUIPart: ToolUIPart): string;
+export declare function assertValidToolName(toolName: string): asserts toolName is ToolName;
+export declare const allToolNames: readonly ToolName[];
+//# sourceMappingURL=metadata.d.ts.map

package/dist/shared/tools/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../../src/shared/tools/metadata.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAErC,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEtD,eAAO,MAAM,YAAY,EAAE,YA6KH,CAAC;AAEzB,wBAAgB,eAAe,CAAC,CAAC,SAAS,QAAQ,EAAE,QAAQ,EAAE,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAEhF;AAED,MAAM,MAAM,qBAAqB,CAAC,CAAC,SAAS,QAAQ,IAAI,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAEvG,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,QAAQ,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAGzG;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,IAAI,QAAQ,CAEtE;AAED,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAU5E;AAED,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAQjE;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,IAAI,QAAQ,CAIlF;AAED,eAAO,MAAM,YAAY,EAAE,SAAS,QAAQ,EAA4C,CAAC"}

package/dist/shared/tools/metadata.js

@@ -0,0 +1,215 @@
+import { iriLocalName } from "../rdf-namespaces.js";
+import { humanCount } from "@manta-eu/lib/humanize";
+import { isPresent } from "@manta-eu/lib/present";
+import { match, P } from "ts-pattern";
+export const toolMetadata = {
+    getRDFoxFacts: {
+        name: "getRDFoxFacts",
+        category: "rdfox",
+        humanName: "Query knowledge base",
+        description: "Retrieve facts from RDFox knowledge base using SPARQL",
+        getHumanName: (input) => {
+            return input?.humanIntent || "Querying...";
+        },
+    },
+    addRDFoxFacts: {
+        name: "addRDFoxFacts",
+        category: "rdfox",
+        humanName: "Add facts",
+        description: "Add facts to RDFox knowledge base as Turtle",
+        getHumanName: (input) => {
+            return input?.humanIntent || "Adding facts...";
+        },
+    },
+    getRDFoxRules: {
+        name: "getRDFoxRules",
+        category: "rdfox",
+        humanName: "Check rules",
+        description: "Retrieve Datalog rules from RDFox with optional filters (named graph, rdf:type, limit) to avoid context overflow",
+        getHumanName: (input) => {
+            const parts = [];
+            if (input?.namedGraphIri)
+                parts.push(`plan: ${input.namedGraphIri}`);
+            if (isPresent(input?.rdfTypes))
+                parts.push(`types: ${input.rdfTypes.join(", ")}`);
+            if (!isPresent(parts))
+                return "Checking rules...";
+            return `Checking rules ${parts.join(" + ")}`;
+        },
+    },
+    explainRDFoxRules: {
+        name: "explainRDFoxRules",
+        category: "rdfox",
+        humanName: "Explain reasoning",
+        description: "Explain how facts are derived using rules",
+        getHumanName: () => "Explaining reasoning...",
+    },
+    scheduleTask: {
+        name: "scheduleTask",
+        category: "scheduler",
+        humanName: "Schedule task",
+        description: "Schedule a task for future execution",
+        getHumanName: (input) => {
+            return input?.description ? `Schedule: ${input.description}` : "Scheduling...";
+        },
+    },
+    listScheduledTasks: {
+        name: "listScheduledTasks",
+        category: "scheduler",
+        humanName: "List scheduled tasks",
+        description: "List all scheduled tasks",
+        getHumanName: () => "List scheduled tasks",
+    },
+    cancelSchedule: {
+        name: "cancelSchedule",
+        category: "scheduler",
+        humanName: "Cancel task",
+        description: "Cancel a scheduled task",
+        getHumanName: (input) => {
+            return input?.id ? `Cancel task: ${input.id}` : "Canceling task...";
+        },
+    },
+    generateChart: {
+        name: "generateChart",
+        category: "charts",
+        humanName: "Generate chart",
+        description: "Create interactive charts for data visualization",
+        getHumanName: (input) => {
+            return input?.title ? `Chart: ${input.title}` : "Charting...";
+        },
+    },
+    executeActionPlan: {
+        name: "executeActionPlan",
+        category: "action",
+        humanName: "Execute action plan",
+        description: "Execute semantic action plans with SHACL validation and multi-platform orchestration",
+        getHumanName: (input) => {
+            return input?.namedGraphIri ? `Execute plan: ${input.namedGraphIri}` : "Executing action plan...";
+        },
+    },
+    manageRDFoxRules: {
+        name: "manageRDFoxRules",
+        category: "rdfox",
+        humanName: "Manage rules",
+        description: "Add, change, or remove Datalog rules in RDFox knowledge base",
+        getHumanName: (input) => {
+            return input?.humanIntent || "Managing rules...";
+        },
+    },
+    manageRDFoxFacts: {
+        name: "manageRDFoxFacts",
+        category: "rdfox",
+        humanName: "Manage facts",
+        description: "Add, change facts in RDFox knowledge",
+        getHumanName: (input) => {
+            return input?.humanIntent || "Managing facts...";
+        },
+    },
+    actionPlanShowcase: {
+        name: "actionPlanShowcase",
+        category: "action",
+        humanName: "Show action plan",
+        description: "Display a summary card for an action plan with steps and navigation CTA",
+        getHumanName: (input) => {
+            if (input?.actionPlanIRI) {
+                const fragment = iriLocalName(input.actionPlanIRI);
+                return fragment ? `Showcasing plan: ${fragment}` : "Showing action plan...";
+            }
+            return "Showing action plan...";
+        },
+    },
+    showEntities: {
+        name: "showEntities",
+        category: "action",
+        humanName: "Show entities",
+        description: "Display one or several knowledge-graph entities inline in one call",
+        getHumanName: (input) => {
+            if (!isPresent(input?.entityIris))
+                return "Showing entities...";
+            return `Showing: ${humanCount(input.entityIris.length, "entity")}`;
+        },
+    },
+    enableAutoPilot: {
+        name: "enableAutoPilot",
+        category: "auto-pilot",
+        humanName: "Enable auto-pilot",
+        description: "Enable automatic scheduled execution of an action plan",
+        getHumanName: (input) => input?.humanIntent || "Enabling auto-pilot...",
+    },
+    enableAutoPilotCron: {
+        name: "enableAutoPilotCron",
+        category: "auto-pilot",
+        humanName: "Enable auto-pilot (cron)",
+        description: "Enable automatic scheduled execution of an action plan on a cron schedule",
+        getHumanName: (input) => input?.humanIntent || "Enabling auto-pilot...",
+    },
+    disableAutoPilot: {
+        name: "disableAutoPilot",
+        category: "auto-pilot",
+        humanName: "Disable auto-pilot",
+        description: "Disable automatic scheduled execution of an action plan",
+        getHumanName: (input) => input?.humanIntent || "Disabling auto-pilot...",
+    },
+    checkAutoPilotStatus: {
+        name: "checkAutoPilotStatus",
+        category: "auto-pilot",
+        humanName: "Check auto-pilot status",
+        description: "Check whether auto-pilot is enabled and review cadence and execution history",
+        getHumanName: (input) => input?.humanIntent || "Checking auto-pilot status...",
+    },
+    setAutoPilotCadence: {
+        name: "setAutoPilotCadence",
+        category: "auto-pilot",
+        humanName: "Update auto-pilot cadence",
+        description: "Change the recurrence cadence for an already-enabled auto-pilot plan",
+        getHumanName: (input) => input?.humanIntent || "Updating auto-pilot cadence...",
+    },
+    markAsLowRisk: {
+        name: "markAsLowRisk",
+        category: "auto-pilot",
+        humanName: "Mark as low-risk",
+        description: "Mark an action plan as low-risk, making it immediately eligible for auto-pilot",
+        getHumanName: (input) => input?.humanIntent || "Marking plan as low-risk...",
+    },
+    readUploadedFile: {
+        name: "readUploadedFile",
+        category: "action",
+        humanName: "Read attachment",
+        description: "Read the contents of a file the user uploaded to this conversation",
+        getHumanName: () => "Reading attachment...",
+    },
+};
+export function getToolMetadata(toolName) {
+    return toolMetadata[toolName];
+}
+export function getHumanToolName(toolName, input) {
+    const metadata = getToolMetadata(toolName);
+    return metadata.getHumanName(input);
+}
+export function isValidToolName(toolName) {
+    return Object.prototype.hasOwnProperty.call(toolMetadata, toolName);
+}
+export function getSkillToolLabel(toolUIPart) {
+    return match(toolUIPart)
+        .with({ type: "tool-activate_skill", input: { name: P.string } }, ({ input }) => `Reading skill: ${input.name}`)
+        .with({ type: "tool-activate_skill" }, () => "Reading skill...")
+        .with({ type: "tool-read_skill_resource", input: { path: P.string } }, ({ input }) => `Reading resource: ${input.path}`)
+        .with({ type: "tool-read_skill_resource" }, () => "Reading resource...")
+        .otherwise(() => undefined);
+}
+export function getToolUIPartLabel(toolUIPart) {
+    const skillLabel = getSkillToolLabel(toolUIPart);
+    if (skillLabel)
+        return skillLabel;
+    const toolName = toolUIPart.type.replace("tool-", "");
+    if (!isValidToolName(toolName))
+        return toolName;
+    const input = toolUIPart.input;
+    return input ? getHumanToolName(toolName, input) : getToolMetadata(toolName).humanName;
+}
+export function assertValidToolName(toolName) {
+    if (!isValidToolName(toolName)) {
+        throw new Error(`Unknown tool: ${toolName}. Add it to shared/tools/types.ts and metadata.ts`);
+    }
+}
+export const allToolNames = Object.keys(toolMetadata);

package/dist/shared/tools/test-triple.d.ts

@@ -0,0 +1,16 @@
+import { z } from "zod/v4";
+export declare const testTripleInputSchema: z.ZodObject<{
+    subject: z.ZodString;
+    predicate: z.ZodString;
+    object: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"iri">;
+        value: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"literal">;
+        value: z.ZodString;
+        datatype: z.ZodOptional<z.ZodString>;
+        language: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "type">;
+}, z.core.$strip>;
+export type TestTripleInput = z.infer<typeof testTripleInputSchema>;
+//# sourceMappingURL=test-triple.d.ts.map

package/dist/shared/tools/test-triple.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-triple.d.ts","sourceRoot":"","sources":["../../../src/shared/tools/test-triple.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AA0B3B,eAAO,MAAM,qBAAqB;;;;;;;;;;;;iBAIhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}