@opengeni/api-router 0.30.1 → 1.0.0

package/dist/mcp/company-profile-agent-admin.d.ts

@@ -0,0 +1,44 @@
+import { type CompanyProfileAgentAttempt, type CompanyProfileEntry } from "@opengeni/contracts";
+import { createCompanyProfileAgentAdminRouter } from "@opengeni/core";
+import type { Database } from "@opengeni/db";
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import * as z from "zod/v4";
+type JsonResult = (value: unknown) => {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+export type RegisterCompanyProfileAgentAdminToolsInput = {
+    server: McpServer;
+    db: Database;
+    attempt: CompanyProfileAgentAttempt;
+    authorize: () => Promise<void>;
+    json: JsonResult;
+    router?: Pick<ReturnType<typeof createCompanyProfileAgentAdminRouter>, "propose" | "confirm">;
+};
+declare const entry: z.ZodObject<{
+    key: z.ZodOptional<z.ZodString>;
+    content: z.ZodString;
+}, z.core.$strip>;
+type EntryInput = z.infer<typeof entry>;
+/**
+ * Derive a stable key from entry content: the first few words, normalized into
+ * the company-profile key alphabet and bounded to the stable-key length.
+ */
+export declare function deriveCompanyProfileStableKey(content: string): string;
+/**
+ * Resolve explicit or derived keys for one list and de-duplicate by suffixing
+ * `-2`, `-3`, ... so the profile passes the unique-key contract.
+ */
+export declare function resolveCompanyProfileEntries(input: readonly EntryInput[]): CompanyProfileEntry[];
+/**
+ * Register the organization profile administration path. This is not derived
+ * workspace learning: the initiating human must be the organization's active
+ * owner (the same authority as the manual `account:admin` route). The separate
+ * organization policy either blocks the proposal, keeps the exact bound
+ * human-confirmation path, or permits immediate activation through the native
+ * company-profile lifecycle.
+ */
+export declare function registerCompanyProfileAgentAdminTools(input: RegisterCompanyProfileAgentAdminToolsInput): void;
+export {};

package/dist/mcp/contract-input.d.ts

@@ -0,0 +1,11 @@
+import * as z from "zod/v4";
+/**
+ * Publish the input side of a contract, validate it, and retain the exact call.
+ * MCP parsing must not insert defaults, trim text, or erase omitted fields before
+ * the application applies presence-sensitive inheritance and authority rules.
+ * A narrower projection may hide host-only fields; validation retains the full
+ * contract's preprocessors and cross-field checks.
+ */
+export declare function contractToolInput<T extends z.ZodObject>(projection: T, validation?: z.ZodType): z.ZodType<z.input<T>, z.input<T>>;
+/** Every named input and array element needs a schema. Dictionary values may be arbitrary JSON. */
+export declare function assertDescribedToolInput(schema: unknown, tool?: string): void;

package/dist/mcp/documents.d.ts

@@ -1,8 +1,10 @@
-import { type DocumentServices } from "@opengeni/documents";
-import { type Database } from "@opengeni/db";
+import type { Settings } from "@opengeni/config";
+import type { DocumentServices } from "@opengeni/documents";
+import { type KnowledgeContext, type Database } from "@opengeni/db";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/** The docs endpoint is a transport for canonical Knowledge retrieval. Legacy
+ * chunk/base retrieval is retired: it cannot bypass pending Knowledge review. */
 export declare function buildDocumentsMcpServer(db: Database, accountId: string, workspaceId: string, documentServices: DocumentServices, options: {
-    createdBySessionId?: string | undefined;
-    /** Immutable human subject whose agent is making this retrieval request. */
-    initiatingSubjectId: string;
+    knowledge: KnowledgeContext;
+    settings?: Settings;
 }): McpServer;

package/dist/mcp/files.d.ts

@@ -1,5 +1,5 @@
 import type { AccessGrant } from "@opengeni/contracts";
-import { type ApiRouteDeps } from "@opengeni/core";
+import { type AccessGrantAuthorization, type ApiRouteDeps } from "@opengeni/core";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 /** Dedicated file MCP surface. The broad `opengeni` server never registers it. */
-export declare function buildFilesMcpServer(deps: ApiRouteDeps, grant: AccessGrant): McpServer;
+export declare function buildFilesMcpServer(deps: ApiRouteDeps, authority: AccessGrant | AccessGrantAuthorization): McpServer;