@receiz/mcp-server
Version:
MCP server for agents building and verifying Receiz proof-native applications through the canonical Receiz SDK rails.
429 lines • 12.9 kB
TypeScript
import { createReceizNodeOfflineSealer } from "@receiz/sdk/offline/node";
import { verifyReceizOfflineSealedFile } from "@receiz/sdk/offline";
import { type ReceizKksV1ProofCoordinate } from "@receiz/sdk";
type OfflineVerification = Awaited<ReturnType<typeof verifyReceizOfflineSealedFile>>;
type SealedSourceResult = {
outputPath: string;
artifactReference: string;
artifactSha256: string;
suggestedFilename: string;
mimeType: string;
byteLength: number;
verification: OfflineVerification;
mcpAuthority: boolean;
strongerTruth: "sealed-receiz-proof-object";
};
type OfflineSealResult = Awaited<ReturnType<typeof sealUploadedArtifact>> | Awaited<ReturnType<typeof sealSuppliedText>> | {
coordinate: ReceizKksV1ProofCoordinate;
mcpAuthority: boolean;
networkRequired: boolean;
} | {
verification: OfflineVerification;
mcpAuthority: boolean;
} | {
ready: boolean;
networkRequiredForSealing: boolean;
mcpAuthority: boolean;
} | {
ready: boolean;
privateKeyExposed: boolean;
mcpAuthority: boolean;
} | (Omit<SealedSourceResult, "strongerTruth"> & {
strongerTruth: string;
});
/** Host-owned custody coordinates. Never accepted from MCP tool arguments. */
export type ReceizMcpLocalCustody = Readonly<{
directory: string;
workspace: string;
identity: Readonly<{
artifactPath: string;
passphrase?: string;
}> | null;
/** Host-only fact established after same-runtime canonical identity admission. */
identityAdmitted?: true;
}>;
export declare const RECEIZ_OFFLINE_SEAL_TOOLS: ({
name: string;
description: string;
inputSchema: {
type: string;
properties: {
previousCoordinate: {
type: string;
};
confirmEnrollment?: undefined;
inputPath?: undefined;
outputPath?: undefined;
mimeType?: undefined;
file?: undefined;
text?: undefined;
filename?: undefined;
contentKind?: undefined;
transferToken?: undefined;
artifactReference?: undefined;
artifactSha256?: undefined;
offset?: undefined;
prepareDownload?: undefined;
attemptIds?: undefined;
prepareCarrier?: undefined;
byteLength?: undefined;
};
additionalProperties: boolean;
required?: undefined;
};
outputSchema?: undefined;
_meta?: undefined;
} | {
name: string;
description: string;
inputSchema: {
type: string;
properties: {
previousCoordinate?: undefined;
confirmEnrollment?: undefined;
inputPath?: undefined;
outputPath?: undefined;
mimeType?: undefined;
file?: undefined;
text?: undefined;
filename?: undefined;
contentKind?: undefined;
transferToken?: undefined;
artifactReference?: undefined;
artifactSha256?: undefined;
offset?: undefined;
prepareDownload?: undefined;
attemptIds?: undefined;
prepareCarrier?: undefined;
byteLength?: undefined;
};
additionalProperties: boolean;
required?: undefined;
};
outputSchema?: undefined;
_meta?: undefined;
} | {
name: string;
description: string;
inputSchema: {
type: string;
properties: {
confirmEnrollment: {
type: string;
const: boolean;
};
previousCoordinate?: undefined;
inputPath?: undefined;
outputPath?: undefined;
mimeType?: undefined;
file?: undefined;
text?: undefined;
filename?: undefined;
contentKind?: undefined;
transferToken?: undefined;
artifactReference?: undefined;
artifactSha256?: undefined;
offset?: undefined;
prepareDownload?: undefined;
attemptIds?: undefined;
prepareCarrier?: undefined;
byteLength?: undefined;
};
required: string[];
additionalProperties: boolean;
};
outputSchema?: undefined;
_meta?: undefined;
} | {
name: string;
description: string;
inputSchema: {
type: string;
properties: {
inputPath: {
type: string;
};
outputPath: {
type: string;
};
mimeType: {
type: string;
};
file: {
type: string[];
description: string;
properties: {
download_url: {
type: string;
};
file_id: {
type: string;
};
mime_type: {
type: string;
};
file_name: {
type: string;
};
};
required: string[];
additionalProperties: boolean;
};
text: {
type: string;
};
filename: {
type: string;
};
contentKind: {
type: string;
enum: string[];
};
previousCoordinate?: undefined;
confirmEnrollment?: undefined;
transferToken?: undefined;
artifactReference?: undefined;
artifactSha256?: undefined;
offset?: undefined;
prepareDownload?: undefined;
attemptIds?: undefined;
prepareCarrier?: undefined;
byteLength?: undefined;
};
additionalProperties: boolean;
required?: undefined;
};
outputSchema: {
type: string;
properties: {
artifactReference: {
type: string;
};
artifactSha256: {
type: string;
};
suggestedFilename: {
type: string;
};
mimeType: {
type: string;
};
byteLength: {
type: string;
};
offset?: undefined;
nextOffset?: undefined;
filename?: undefined;
mcpAuthority?: undefined;
bytesBase64?: undefined;
receizTransportAttemptId?: undefined;
downloadUrl?: undefined;
};
required: string[];
};
_meta: {
"openai/fileParams": string[];
ui: {
resourceUri: string;
visibility?: undefined;
};
"openai/outputTemplate": string;
"openai/visibility"?: undefined;
"openai/widgetAccessible"?: undefined;
};
} | {
name: string;
description: string;
inputSchema: {
type: string;
properties: {
transferToken: {
type: string;
};
artifactReference: {
type: string;
};
artifactSha256: {
type: string;
};
offset: {
type: string;
minimum: number;
};
prepareDownload: {
type: string;
};
attemptIds: {
type: string;
items: {
type: string;
};
};
prepareCarrier: {
type: string;
description: string;
};
byteLength: {
type: string;
minimum: number;
};
previousCoordinate?: undefined;
confirmEnrollment?: undefined;
inputPath?: undefined;
outputPath?: undefined;
mimeType?: undefined;
file?: undefined;
text?: undefined;
filename?: undefined;
contentKind?: undefined;
};
additionalProperties: boolean;
required?: undefined;
};
outputSchema: {
type: string;
properties: {
offset: {
type: string;
};
nextOffset: {
type: string;
};
byteLength: {
type: string;
};
artifactSha256: {
type: string;
};
filename: {
type: string;
};
mimeType: {
type: string;
};
mcpAuthority: {
type: string;
};
bytesBase64: {
type: string;
};
receizTransportAttemptId: {
type: string;
};
downloadUrl: {
type: string;
};
artifactReference?: undefined;
suggestedFilename?: undefined;
};
required: string[];
};
_meta: {
ui: {
visibility: string[];
resourceUri?: undefined;
};
"openai/visibility": string;
"openai/widgetAccessible": boolean;
"openai/fileParams"?: undefined;
"openai/outputTemplate"?: undefined;
};
} | {
name: string;
description: string;
inputSchema: {
type: string;
properties: {
inputPath: {
type: string;
};
previousCoordinate?: undefined;
confirmEnrollment?: undefined;
outputPath?: undefined;
mimeType?: undefined;
file?: undefined;
text?: undefined;
filename?: undefined;
contentKind?: undefined;
transferToken?: undefined;
artifactReference?: undefined;
artifactSha256?: undefined;
offset?: undefined;
prepareDownload?: undefined;
attemptIds?: undefined;
prepareCarrier?: undefined;
byteLength?: undefined;
};
required: string[];
additionalProperties: boolean;
};
outputSchema?: undefined;
_meta?: undefined;
})[];
/** A reusable application boundary: only exact source bytes enter the SDK sealer.
* The sealed file is authoritative; this result is a locator and projection. */
export declare function sealReceizSourceBytes(input: Readonly<{
bytes: Uint8Array;
filename: string;
mimeType?: string;
}>, options?: {
directory?: string;
workspace?: string;
fetch?: typeof globalThis.fetch;
identity?: ReceizMcpLocalCustody["identity"];
identityAdmitted?: true;
sealer?: Pick<Awaited<ReturnType<typeof createReceizNodeOfflineSealer>>, "ready" | "enroll" | "seal">;
}): Promise<SealedSourceResult>;
export declare function sealUploadedArtifact(raw: unknown, options?: Parameters<typeof sealReceizSourceBytes>[1] & {
allowedOrigins?: readonly string[];
}): Promise<{
sourceTransport: {
byteLength: number;
sha256: string;
authority: boolean;
} | {
byteLength: number;
sha256: string;
authority: boolean;
};
sourceKind: "authorized-upload";
outputPath: string;
artifactReference: string;
artifactSha256: string;
suggestedFilename: string;
mimeType: string;
byteLength: number;
verification: OfflineVerification;
mcpAuthority: boolean;
strongerTruth: "sealed-receiz-proof-object";
}>;
export declare function sealSuppliedText(raw: unknown, options?: Parameters<typeof sealReceizSourceBytes>[1]): Promise<{
sourceKind: "caller-supplied-text";
contentKind: unknown;
sourceTransport: {
byteLength: number;
sha256: string;
authority: boolean;
};
authorshipVerified: boolean;
conversationCompletenessVerified: boolean;
outputPath: string;
artifactReference: string;
artifactSha256: string;
suggestedFilename: string;
mimeType: string;
byteLength: number;
verification: OfflineVerification;
mcpAuthority: boolean;
strongerTruth: "sealed-receiz-proof-object";
}>;
export declare function callReceizOfflineSealTool(name: string, raw: unknown, options?: {
directory?: string;
workspace?: string;
fetch?: typeof globalThis.fetch;
allowedOrigins?: readonly string[];
identity?: ReceizMcpLocalCustody["identity"];
sealer?: Pick<Awaited<ReturnType<typeof createReceizNodeOfflineSealer>>, "ready" | "enroll" | "seal">;
}): Promise<OfflineSealResult>;
export {};
//# sourceMappingURL=offlineSealing.d.ts.map