@native-knowledge/knowledge-sdk 0.0.0-stage → 0.1.0-rc.1

package/dist/types/contracts/tenant-collection-request.d.ts

@@ -0,0 +1,209 @@
+import { z } from 'zod';
+import type { RunReceipt } from './runtime.js';
+export declare const tenantCollectionRequestAuthoritySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"HOST">;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"OAUTH">;
+    authorityVersion: z.ZodLiteral<2>;
+    clientId: z.ZodString;
+    grantId: z.ZodString;
+    resource: z.ZodString;
+}, z.core.$strict>], "type">;
+export declare function tenantCollectionRequestKey(requestId: string): string;
+export declare function tenantCollectionRequestRef(tenantId: string, requestId: string): string;
+export declare const tenantCollectionRequestSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<2>;
+    tenantId: z.ZodString;
+    requestId: z.ZodString;
+    requestRef: z.ZodString;
+    context: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"TENANT">;
+        tenantId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"PROJECT">;
+        tenantId: z.ZodString;
+        projectKey: z.ZodString;
+    }, z.core.$strict>], "type">;
+    actor: z.ZodObject<{
+        tenantId: z.ZodString;
+        userId: z.ZodString;
+        agentId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>;
+    authority: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"HOST">;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"OAUTH">;
+        authorityVersion: z.ZodLiteral<2>;
+        clientId: z.ZodString;
+        grantId: z.ZodString;
+        resource: z.ZodString;
+    }, z.core.$strict>], "type">;
+    plan: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<1>;
+        tenantId: z.ZodString;
+        source: z.ZodObject<{
+            schemaVersion: z.ZodLiteral<1>;
+            tenantId: z.ZodString;
+            sourceId: z.ZodString;
+            title: z.ZodString;
+            semantics: z.ZodObject<{
+                target: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"URL">;
+                    locator: z.ZodURL;
+                }, z.core.$strict>, z.ZodObject<{
+                    kind: z.ZodLiteral<"FILE">;
+                    rootBinding: z.ZodString;
+                    relativePath: z.ZodString;
+                }, z.core.$strict>, z.ZodObject<{
+                    kind: z.ZodLiteral<"EXECUTOR">;
+                    executorId: z.ZodString;
+                    bindingRef: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+                    parameters: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>]>>>;
+                }, z.core.$strict>], "kind">;
+                credential: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    type: z.ZodLiteral<"PUBLIC">;
+                }, z.core.$strict>, z.ZodObject<{
+                    type: z.ZodLiteral<"BOUND">;
+                    bindingRef: z.ZodString;
+                    revision: z.ZodString;
+                }, z.core.$strict>], "type">;
+                executionBinding: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+                    bindingRef: z.ZodString;
+                    revision: z.ZodString;
+                }, z.core.$strict>>>;
+                access: z.ZodEnum<{
+                    PUBLIC: "PUBLIC";
+                    PUBLIC_METADATA: "PUBLIC_METADATA";
+                    TENANT: "TENANT";
+                    INTERNAL: "INTERNAL";
+                    FDE_INTERNAL: "FDE_INTERNAL";
+                    ACCESS_CONTROLLED: "ACCESS_CONTROLLED";
+                    UNKNOWN: "UNKNOWN";
+                }>;
+                sourcePolicy: z.ZodObject<{
+                    ref: z.ZodString;
+                    revision: z.ZodString;
+                    acquisition: z.ZodEnum<{
+                        ALLOW: "ALLOW";
+                        DENY: "DENY";
+                    }>;
+                    propagation: z.ZodEnum<{
+                        TENANT_ONLY: "TENANT_ONLY";
+                        SHARE_ALLOWED: "SHARE_ALLOWED";
+                        PUBLIC_ALLOWED: "PUBLIC_ALLOWED";
+                    }>;
+                }, z.core.$strict>;
+                region: z.ZodNullable<z.ZodString>;
+                representation: z.ZodObject<{
+                    format: z.ZodEnum<{
+                        RICH_DOCUMENT_V1: "RICH_DOCUMENT_V1";
+                        RAW: "RAW";
+                    }>;
+                    extractor: z.ZodNullable<z.ZodObject<{
+                        id: z.ZodString;
+                        version: z.ZodString;
+                    }, z.core.$strict>>;
+                }, z.core.$strict>;
+            }, z.core.$strict>;
+            sourceRef: z.ZodString;
+            revision: z.ZodString;
+            revisionRef: z.ZodString;
+            semanticKey: z.ZodString;
+            targetId: z.ZodString;
+        }, z.core.$strict>;
+        maxResourceBytes: z.ZodNumber;
+        revision: z.ZodString;
+        planRef: z.ZodString;
+        workloadId: z.ZodString;
+    }, z.core.$strict>;
+    trigger: z.ZodEnum<{
+        MANUAL: "MANUAL";
+        DUE: "DUE";
+    }>;
+    cycleId: z.ZodString;
+    batchId: z.ZodString;
+    batchRef: z.ZodString;
+    requestedAt: z.ZodISODateTime;
+}, z.core.$strict>;
+export declare const tenantCollectionCompletionSchema: z.ZodUnion<readonly [z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    tenantId: z.ZodString;
+    requestRef: z.ZodString;
+    batchRef: z.ZodString;
+    phase: z.ZodEnum<{
+        RAW_REGISTERED: "RAW_REGISTERED";
+        DERIVED_REGISTERED: "DERIVED_REGISTERED";
+    }>;
+    evidenceRef: z.ZodString;
+    contentHash: z.ZodString;
+    runId: z.ZodString;
+    runtimeNodeId: z.ZodString;
+    completedAt: z.ZodISODateTime;
+}, z.core.$strict>, z.ZodObject<{
+    tenantId: z.ZodString;
+    requestRef: z.ZodString;
+    batchRef: z.ZodString;
+    evidenceRef: z.ZodString;
+    contentHash: z.ZodString;
+    runId: z.ZodString;
+    runtimeNodeId: z.ZodString;
+    completedAt: z.ZodISODateTime;
+    schemaVersion: z.ZodLiteral<2>;
+    phase: z.ZodLiteral<"DERIVED_REGISTERED">;
+    documentRef: z.ZodString;
+}, z.core.$strict>]>;
+export declare function assertTenantCollectionCompletion(request: TenantCollectionRequest, raw: unknown): {
+    schemaVersion: 1;
+    tenantId: string;
+    requestRef: string;
+    batchRef: string;
+    phase: "RAW_REGISTERED" | "DERIVED_REGISTERED";
+    evidenceRef: string;
+    contentHash: string;
+    runId: string;
+    runtimeNodeId: string;
+    completedAt: string;
+} | {
+    tenantId: string;
+    requestRef: string;
+    batchRef: string;
+    evidenceRef: string;
+    contentHash: string;
+    runId: string;
+    runtimeNodeId: string;
+    completedAt: string;
+    schemaVersion: 2;
+    phase: "DERIVED_REGISTERED";
+    documentRef: string;
+};
+export type TenantCollectionRequest = z.infer<typeof tenantCollectionRequestSchema>;
+export type TenantCollectionCompletion = z.infer<typeof tenantCollectionCompletionSchema>;
+/** Admission retirement is not acquisition failure or business completion. */
+export declare const TENANT_REQUEST_ADMISSION_STOP_CAPABILITY = "TENANT_REQUEST_ADMISSION_STOP_V1";
+export declare const tenantCollectionAdmissionStopSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    tenantId: z.ZodString;
+    requestRef: z.ZodString;
+    requestHash: z.ZodString;
+    reason: z.ZodEnum<{
+        GRANT_REVOKED: "GRANT_REVOKED";
+        DELEGATION_SUPERSEDED: "DELEGATION_SUPERSEDED";
+    }>;
+    stoppedAt: z.ZodISODateTime;
+}, z.core.$strict>;
+export type TenantCollectionAdmissionStop = z.infer<typeof tenantCollectionAdmissionStopSchema>;
+/** Acquisition outcome only: a failed request is neither completed nor delegation-retired. */
+export declare const tenantCollectionFailureSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    tenantId: z.ZodString;
+    requestRef: z.ZodString;
+    requestHash: z.ZodString;
+    batchRef: z.ZodString;
+    runId: z.ZodString;
+    runtimeNodeId: z.ZodString;
+    receiptHash: z.ZodString;
+    failedAt: z.ZodISODateTime;
+    errorCode: z.ZodLiteral<"TENANT_SOURCE_HTTP_TERMINAL">;
+}, z.core.$strict>;
+export type TenantCollectionFailure = z.infer<typeof tenantCollectionFailureSchema>;
+export declare function isTenantCollectionTerminalFailure(request: Pick<TenantCollectionRequest, 'plan' | 'batchRef'>, receipt: RunReceipt): boolean;

package/dist/types/contracts/tenant-collection.d.ts

@@ -0,0 +1,199 @@
+import { z } from 'zod';
+import { type TenantSourceSnapshot } from './tenant-source.js';
+export declare const tenantCollectionCycleSchema: z.ZodString;
+export declare const tenantCollectionMaxBytesSchema: z.ZodNumber;
+export declare const tenantCollectionPlanSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    tenantId: z.ZodString;
+    source: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<1>;
+        tenantId: z.ZodString;
+        sourceId: z.ZodString;
+        title: z.ZodString;
+        semantics: z.ZodObject<{
+            target: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"URL">;
+                locator: z.ZodURL;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"FILE">;
+                rootBinding: z.ZodString;
+                relativePath: z.ZodString;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"EXECUTOR">;
+                executorId: z.ZodString;
+                bindingRef: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+                parameters: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>]>>>;
+            }, z.core.$strict>], "kind">;
+            credential: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"PUBLIC">;
+            }, z.core.$strict>, z.ZodObject<{
+                type: z.ZodLiteral<"BOUND">;
+                bindingRef: z.ZodString;
+                revision: z.ZodString;
+            }, z.core.$strict>], "type">;
+            executionBinding: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+                bindingRef: z.ZodString;
+                revision: z.ZodString;
+            }, z.core.$strict>>>;
+            access: z.ZodEnum<{
+                PUBLIC: "PUBLIC";
+                PUBLIC_METADATA: "PUBLIC_METADATA";
+                TENANT: "TENANT";
+                INTERNAL: "INTERNAL";
+                FDE_INTERNAL: "FDE_INTERNAL";
+                ACCESS_CONTROLLED: "ACCESS_CONTROLLED";
+                UNKNOWN: "UNKNOWN";
+            }>;
+            sourcePolicy: z.ZodObject<{
+                ref: z.ZodString;
+                revision: z.ZodString;
+                acquisition: z.ZodEnum<{
+                    ALLOW: "ALLOW";
+                    DENY: "DENY";
+                }>;
+                propagation: z.ZodEnum<{
+                    TENANT_ONLY: "TENANT_ONLY";
+                    SHARE_ALLOWED: "SHARE_ALLOWED";
+                    PUBLIC_ALLOWED: "PUBLIC_ALLOWED";
+                }>;
+            }, z.core.$strict>;
+            region: z.ZodNullable<z.ZodString>;
+            representation: z.ZodObject<{
+                format: z.ZodEnum<{
+                    RICH_DOCUMENT_V1: "RICH_DOCUMENT_V1";
+                    RAW: "RAW";
+                }>;
+                extractor: z.ZodNullable<z.ZodObject<{
+                    id: z.ZodString;
+                    version: z.ZodString;
+                }, z.core.$strict>>;
+            }, z.core.$strict>;
+        }, z.core.$strict>;
+        sourceRef: z.ZodString;
+        revision: z.ZodString;
+        revisionRef: z.ZodString;
+        semanticKey: z.ZodString;
+        targetId: z.ZodString;
+    }, z.core.$strict>;
+    maxResourceBytes: z.ZodNumber;
+    revision: z.ZodString;
+    planRef: z.ZodString;
+    workloadId: z.ZodString;
+}, z.core.$strict>;
+export declare function createTenantCollectionPlan(raw: TenantSourceSnapshot, maxBytes?: number): {
+    schemaVersion: 1;
+    tenantId: string;
+    source: {
+        schemaVersion: 1;
+        tenantId: string;
+        sourceId: string;
+        title: string;
+        semantics: {
+            target: {
+                kind: "EXECUTOR";
+                executorId: string;
+                bindingRef: string | null;
+                parameters: Record<string, string | number | boolean | (string | number | boolean | null)[] | null>;
+            } | {
+                kind: "URL";
+                locator: string;
+            } | {
+                kind: "FILE";
+                rootBinding: string;
+                relativePath: string;
+            };
+            credential: {
+                type: "PUBLIC";
+            } | {
+                type: "BOUND";
+                bindingRef: string;
+                revision: string;
+            };
+            executionBinding: {
+                bindingRef: string;
+                revision: string;
+            } | null;
+            access: "PUBLIC" | "PUBLIC_METADATA" | "TENANT" | "INTERNAL" | "FDE_INTERNAL" | "ACCESS_CONTROLLED" | "UNKNOWN";
+            sourcePolicy: {
+                ref: string;
+                revision: string;
+                acquisition: "ALLOW" | "DENY";
+                propagation: "TENANT_ONLY" | "SHARE_ALLOWED" | "PUBLIC_ALLOWED";
+            };
+            region: string | null;
+            representation: {
+                format: "RICH_DOCUMENT_V1" | "RAW";
+                extractor: {
+                    id: string;
+                    version: string;
+                } | null;
+            };
+        };
+        sourceRef: string;
+        revision: string;
+        revisionRef: string;
+        semanticKey: string;
+        targetId: string;
+    };
+    maxResourceBytes: number;
+    revision: string;
+    planRef: string;
+    workloadId: string;
+};
+export declare function parseTenantCollectionPlanRef(ref: string): {
+    storageKey: string;
+    revision: string;
+} | null;
+export declare function tenantCollectionBatchIdentity(tenantId: string, planRevision: string, trigger: 'MANUAL' | 'DUE', cycleId: string): {
+    batchId: string;
+    batchRef: string;
+};
+export declare function parseTenantCollectionBatchRef(ref: string): {
+    storageKey: string;
+    batchId: string;
+} | null;
+export declare function tenantCapturedEvidenceIdentity(input: {
+    tenantId: string;
+    batchRef: string;
+    sourceRevisionRef: string;
+}): {
+    identityRef: string;
+    ref: string;
+    resourceId: string;
+};
+export declare const tenantCollectionBatchSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<2>;
+    tenantId: z.ZodString;
+    sourceId: z.ZodString;
+    sourceRevisionRef: z.ZodString;
+    planRef: z.ZodString;
+    planRevision: z.ZodString;
+    cycleId: z.ZodString;
+    trigger: z.ZodEnum<{
+        MANUAL: "MANUAL";
+        DUE: "DUE";
+    }>;
+    createdAt: z.ZodISODateTime;
+    batchId: z.ZodString;
+    batchRef: z.ZodString;
+}, z.core.$strict>;
+export type TenantCollectionPlan = z.infer<typeof tenantCollectionPlanSchema>;
+export type TenantCollectionBatch = z.infer<typeof tenantCollectionBatchSchema>;
+/** ACQUIRED 是原件事实；Catalog、登记和派生状态由各自阶段回执报告。 */
+export declare const tenantCollectionCaptureSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    tenantId: z.ZodString;
+    batchRef: z.ZodString;
+    sourceRevisionRef: z.ZodString;
+    taskId: z.ZodString;
+    evidenceRef: z.ZodString;
+    contentHash: z.ZodString;
+    byteLength: z.ZodNumber;
+    mediaType: z.ZodString;
+    observedAt: z.ZodISODateTime;
+    finalLocator: z.ZodString;
+    httpStatus: z.ZodNullable<z.ZodNumber>;
+    acquisitionRevision: z.ZodNullable<z.ZodString>;
+    headersRecorded: z.ZodBoolean;
+}, z.core.$strict>;
+export type TenantCollectionCapture = z.infer<typeof tenantCollectionCaptureSchema>;

package/dist/types/contracts/tenant-currentness.d.ts

@@ -0,0 +1,117 @@
+/** 原生资料的快照时效不把 raw carrier 冒充 Evidence，也不证明外部业务事实。 */
+import { z } from 'zod';
+export declare function tenantSnapshotDeclarationRef(tenantId: string, subjectRef: string): string;
+export declare const tenantSnapshotDeclarationSchema: z.ZodObject<{
+    basis: z.ZodLiteral<"RETAINED_SNAPSHOT">;
+    snapshotAt: z.ZodISODateTime;
+    sourceRevisionRef: z.ZodOptional<z.ZodString>;
+    policy: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<1>;
+        dueAfterSeconds: z.ZodNumber;
+        staleAfterSeconds: z.ZodNumber;
+        staleAction: z.ZodDefault<z.ZodEnum<{
+            ALLOW: "ALLOW";
+            REVIEW_REQUIRED: "REVIEW_REQUIRED";
+            DENY: "DENY";
+        }>>;
+        unknownAction: z.ZodDefault<z.ZodEnum<{
+            ALLOW: "ALLOW";
+            REVIEW_REQUIRED: "REVIEW_REQUIRED";
+            DENY: "DENY";
+        }>>;
+        blockedAction: z.ZodDefault<z.ZodEnum<{
+            ALLOW: "ALLOW";
+            REVIEW_REQUIRED: "REVIEW_REQUIRED";
+            DENY: "DENY";
+        }>>;
+    }, z.core.$strict>;
+    declaredAt: z.ZodISODateTime;
+    actor: z.ZodObject<{
+        tenantId: z.ZodString;
+        userId: z.ZodString;
+        agentId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>;
+    authority: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"HOST">;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"OAUTH">;
+        authorityVersion: z.ZodLiteral<2>;
+        clientId: z.ZodString;
+        grantId: z.ZodString;
+        resource: z.ZodString;
+    }, z.core.$strict>], "type">;
+    tenantId: z.ZodString;
+    subjectRef: z.ZodString;
+    resourceType: z.ZodString;
+    contentHash: z.ZodString;
+    schemaVersion: z.ZodLiteral<1>;
+    ref: z.ZodString;
+}, z.core.$strict>;
+export declare const tenantMaterialCurrentnessSchema: z.ZodObject<{
+    observedAt: z.ZodDefault<z.ZodNullable<z.ZodISODateTime>>;
+    sourceRevisionRef: z.ZodOptional<z.ZodString>;
+    lastAttemptAt: z.ZodDefault<z.ZodNullable<z.ZodISODateTime>>;
+    assessedAt: z.ZodISODateTime;
+    state: z.ZodEnum<{
+        UNKNOWN: "UNKNOWN";
+        DUE: "DUE";
+        CURRENT: "CURRENT";
+        STALE: "STALE";
+        BLOCKED: "BLOCKED";
+    }>;
+    action: z.ZodEnum<{
+        ALLOW: "ALLOW";
+        REVIEW_REQUIRED: "REVIEW_REQUIRED";
+        DENY: "DENY";
+    }>;
+    reasonCode: z.ZodEnum<{
+        CURRENT_WITHIN_CADENCE: "CURRENT_WITHIN_CADENCE";
+        REFRESH_DUE: "REFRESH_DUE";
+        STALE_AFTER_THRESHOLD: "STALE_AFTER_THRESHOLD";
+        SOURCE_BLOCKED: "SOURCE_BLOCKED";
+        SOURCE_CONTENT_CHANGED: "SOURCE_CONTENT_CHANGED";
+        NO_SUCCESSFUL_OBSERVATION: "NO_SUCCESSFUL_OBSERVATION";
+    }>;
+    policy: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<1>;
+        dueAfterSeconds: z.ZodNumber;
+        staleAfterSeconds: z.ZodNumber;
+        staleAction: z.ZodDefault<z.ZodEnum<{
+            ALLOW: "ALLOW";
+            REVIEW_REQUIRED: "REVIEW_REQUIRED";
+            DENY: "DENY";
+        }>>;
+        unknownAction: z.ZodDefault<z.ZodEnum<{
+            ALLOW: "ALLOW";
+            REVIEW_REQUIRED: "REVIEW_REQUIRED";
+            DENY: "DENY";
+        }>>;
+        blockedAction: z.ZodDefault<z.ZodEnum<{
+            ALLOW: "ALLOW";
+            REVIEW_REQUIRED: "REVIEW_REQUIRED";
+            DENY: "DENY";
+        }>>;
+    }, z.core.$strict>;
+    lastSuccessAt: z.ZodDefault<z.ZodNullable<z.ZodISODateTime>>;
+    dueAt: z.ZodDefault<z.ZodNullable<z.ZodISODateTime>>;
+    staleAt: z.ZodDefault<z.ZodNullable<z.ZodISODateTime>>;
+    ageSeconds: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    basis: z.ZodLiteral<"RETAINED_SNAPSHOT">;
+    basisRef: z.ZodString;
+    declarationRef: z.ZodString;
+    tenantId: z.ZodString;
+    subjectRef: z.ZodString;
+    resourceType: z.ZodString;
+    contentHash: z.ZodString;
+    schemaVersion: z.ZodLiteral<2>;
+    subjectKind: z.ZodLiteral<"MATERIAL">;
+}, z.core.$strict>;
+export declare const tenantSnapshotInputSchema: z.ZodObject<{
+    requestId: z.ZodString;
+    subjectRef: z.ZodString;
+    expectedContentHash: z.ZodString;
+    freshnessSeconds: z.ZodNumber;
+}, z.core.$strict>;
+export type TenantSnapshotDeclaration = z.infer<typeof tenantSnapshotDeclarationSchema>;
+export type TenantMaterialCurrentness = z.infer<typeof tenantMaterialCurrentnessSchema>;
+export declare function tenantMaterialCurrentnessRevision(raw: TenantMaterialCurrentness): string;