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

package/dist/types/sdk/tenant-runtime.d.ts

@@ -0,0 +1,174 @@
+/** 明确Provider20；仅此新client采用新registry，旧client默认保持原版本。 */
+import { type TenantRuntimeInput } from '../serving-contracts/index.js';
+import { KnowledgeTenantProjectClient } from './tenant-project.js';
+export declare class KnowledgeTenantRuntimeClient extends KnowledgeTenantProjectClient {
+    protected protocolVersion(): 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25;
+    runtimeStatus(raw?: TenantRuntimeInput, options?: {
+        signal?: AbortSignal;
+    }): Promise<{
+        schemaVersion: 2;
+        tenantId: string;
+        tool: "tenant_runtime_status";
+        data: {
+            nodeId: string;
+            kind: "REQUESTS" | "RESOURCES" | "PROJECTIONS" | "PROJECTS";
+            observedAt: string;
+            coverage: "OWN_TENANT_METADATA_SAMPLE";
+            metadataOnly: true;
+            pageState: "UNAVAILABLE" | "READY";
+            items: ({
+                kind: "REQUESTS";
+                requestRef: string;
+                batchRef: string;
+                admission: "COMPLETED" | "PENDING" | "FAILED" | "STOPPED";
+                stopReason: "GRANT_REVOKED" | "DELEGATION_SUPERSEDED" | null;
+                executionAuthority: "UNAVAILABLE" | "CURRENT" | "BLOCKED" | "NOT_CONFIGURED" | "NOT_PENDING";
+                budgetReason: "READY" | "PAUSED" | "TENANT_UNCONFIGURED" | "HOST_IN_FLIGHT" | "TENANT_IN_FLIGHT" | "WORK_BUDGET" | "TIME_BUDGET" | "WORK_ACTIVE" | null;
+                captureRecord: "MISSING" | "UNAVAILABLE" | "PRESENT";
+                raw: {
+                    ref: string;
+                    contentHash: string | null;
+                    recordedBytes: number | null;
+                    manifest: "MISSING" | "UNAVAILABLE" | "INTEGRITY_MISMATCH" | "PRESENT";
+                    blob: "MISSING" | "UNAVAILABLE" | "INTEGRITY_MISMATCH" | "PRESENT_UNVERIFIED";
+                    contentHashReverified: false;
+                    catalog: "MISSING" | "UNAVAILABLE" | "INTEGRITY_MISMATCH" | "NOT_REGISTERED" | "MATCH";
+                    directory: "MISSING" | "UNAVAILABLE" | "INTEGRITY_MISMATCH" | "NOT_REGISTERED" | "MATCH";
+                    search: "MISSING" | "UNAVAILABLE" | "INTEGRITY_MISMATCH" | "NOT_REGISTERED" | "MATCH";
+                };
+                derivation: "REGISTERED" | "UNAVAILABLE" | "PENDING" | "NOT_REQUIRED";
+                completedPhase: "RAW_REGISTERED" | "DERIVED_REGISTERED" | null;
+                process: {
+                    runtimeNodeId: string;
+                    workloadId: string;
+                    runId: string;
+                    attribution: "COMPLETION_RUN" | "FAILURE_RUN" | "SOURCE_WORKLOAD_LATEST" | "PROJECT_WORKLOAD_LATEST";
+                    batchMatches: boolean | null;
+                    outcome: "FAILED" | "SUCCEEDED" | "TIMED_OUT" | "OUTPUT_LIMIT" | "SPAWN_FAILED" | "RECEIPT_MISSING" | null;
+                    receiptStatus: "BLOCKED" | "PARTIAL" | "FAILED" | "SUCCEEDED" | "SKIPPED" | null;
+                    durationMs: number | null;
+                    finishedAt: string;
+                    category: "NONE" | "OUTPUT_LIMIT" | "TIMEOUT" | "SPAWN_FAILURE" | "V8_HEAP_EXHAUSTED" | "NATIVE_ASSERTION_FAILURE" | "UNCAUGHT_EXCEPTION" | "PROCESS_SIGNAL" | "UNKNOWN_FAILURE" | null;
+                    peakRssBytes: number | null;
+                    sampleCount: number | null;
+                } | null;
+                failureCode?: "TENANT_SOURCE_HTTP_TERMINAL" | null | undefined;
+            } | {
+                ref: string;
+                contentHash: string | null;
+                recordedBytes: number | null;
+                manifest: "MISSING" | "UNAVAILABLE" | "INTEGRITY_MISMATCH" | "PRESENT";
+                blob: "MISSING" | "UNAVAILABLE" | "INTEGRITY_MISMATCH" | "PRESENT_UNVERIFIED";
+                contentHashReverified: false;
+                catalog: "MISSING" | "UNAVAILABLE" | "INTEGRITY_MISMATCH" | "NOT_REGISTERED" | "MATCH";
+                directory: "MISSING" | "UNAVAILABLE" | "INTEGRITY_MISMATCH" | "NOT_REGISTERED" | "MATCH";
+                search: "MISSING" | "UNAVAILABLE" | "INTEGRITY_MISMATCH" | "NOT_REGISTERED" | "MATCH";
+                kind: "RESOURCES";
+            } | {
+                ref: string;
+                contentHash: string | null;
+                recordedBytes: number | null;
+                manifest: "MISSING" | "UNAVAILABLE" | "INTEGRITY_MISMATCH" | "PRESENT";
+                blob: "MISSING" | "UNAVAILABLE" | "INTEGRITY_MISMATCH" | "PRESENT_UNVERIFIED";
+                contentHashReverified: false;
+                catalog: "MISSING" | "UNAVAILABLE" | "INTEGRITY_MISMATCH" | "NOT_REGISTERED" | "MATCH";
+                directory: "MISSING" | "UNAVAILABLE" | "INTEGRITY_MISMATCH" | "NOT_REGISTERED" | "MATCH";
+                search: "MISSING" | "UNAVAILABLE" | "INTEGRITY_MISMATCH" | "NOT_REGISTERED" | "MATCH";
+                kind: "PROJECTIONS";
+                expectedManifestRevision: string;
+                preparedAt: string;
+            } | {
+                kind: "PROJECTS";
+                projectKey: string;
+                lifecycle: "ACTIVE" | "ARCHIVED";
+                runtimeState: "UNAVAILABLE" | "AVAILABLE";
+                projection: {
+                    requestedGeneration: number;
+                    completedGeneration: number;
+                    pendingGenerationDelta: number;
+                } | null;
+                checkpointState: "UNAVAILABLE" | "READY" | "EPOCH_MISMATCH";
+                directoryThroughSeq: number | null;
+                searchThroughSeq: number | null;
+                searchObservedMaxSeq: number | null;
+                searchSequenceDelta: number | null;
+                process: {
+                    runtimeNodeId: string;
+                    workloadId: string;
+                    runId: string;
+                    attribution: "COMPLETION_RUN" | "FAILURE_RUN" | "SOURCE_WORKLOAD_LATEST" | "PROJECT_WORKLOAD_LATEST";
+                    batchMatches: boolean | null;
+                    outcome: "FAILED" | "SUCCEEDED" | "TIMED_OUT" | "OUTPUT_LIMIT" | "SPAWN_FAILED" | "RECEIPT_MISSING" | null;
+                    receiptStatus: "BLOCKED" | "PARTIAL" | "FAILED" | "SUCCEEDED" | "SKIPPED" | null;
+                    durationMs: number | null;
+                    finishedAt: string;
+                    category: "NONE" | "OUTPUT_LIMIT" | "TIMEOUT" | "SPAWN_FAILURE" | "V8_HEAP_EXHAUSTED" | "NATIVE_ASSERTION_FAILURE" | "UNCAUGHT_EXCEPTION" | "PROCESS_SIGNAL" | "UNKNOWN_FAILURE" | null;
+                    peakRssBytes: number | null;
+                    sampleCount: number | null;
+                } | null;
+            })[];
+            nextAfter: string | null;
+            sampleCount: number;
+            total: null;
+            budget: {
+                state: "READY";
+                scope: "RUNTIME_OWNER_DATA_ROOT";
+                windowStart: string;
+                windowEnd: string;
+                usage: {
+                    inFlight: number;
+                    workUnits: number;
+                    runtimeMs: number;
+                };
+                limits: {
+                    tenantId: string;
+                    maxInFlight: number;
+                    maxWorkUnits: number;
+                    maxRuntimeMs: number;
+                    weight: number;
+                    paused: boolean;
+                };
+                maxWaitRounds: number;
+            } | {
+                state: "UNAVAILABLE" | "NOT_CONFIGURED";
+                reason: "CONFIGURATION_REQUIRED" | "TENANT_NOT_CONFIGURED" | "BINDING_MISMATCH" | "STATE_UNAVAILABLE";
+            };
+            delivery: {
+                headSeq: number;
+                retainedThroughSeq: number;
+                businessOutcome: "NOT_ASSERTED";
+            };
+        };
+    }>;
+    runtimeProvider(): Promise<{
+        schemaVersion: 20;
+        tools: string[];
+        capabilities: ["TENANT_MANAGEMENT_V1", "TENANT_WORKFLOW_V1", "TENANT_CURRENTNESS_V2", "TENANT_SOURCE_V1", "TENANT_WORKSPACE_METADATA_V1", "TENANT_PROJECT_CONTEXT_V1", "TENANT_RUNTIME_STATUS_V1"];
+        provider: "knowledge-v2";
+        codeRevision: string;
+        authorityVersion: 2;
+        context: "TENANT_EXPLICIT_MANAGEMENT_V1";
+        managementConfigured: boolean;
+        resource: string;
+        issuer: string;
+        authorizationEndpoint: string;
+        tokenEndpoint: string;
+        revocationEndpoint: string;
+        mcpEndpoint: string;
+        callEndpoint: string;
+        contentEndpoint: string;
+        contentContextHeader: "x-knowledge-tenant-id";
+        legacyProviderEndpoint: string;
+        protocols: ("2026-07-28" | "2025-06-18")[];
+        requestMaxBytes: 131072;
+        resultMaxBytes: 524288;
+        submissionMaxBytes: 65536;
+        inlineContentMaxBytes: 32768;
+        contentReadMaxBytes: 16777216;
+        collectionMode: "MANUAL_ONLY_OAUTH";
+        projectContentEndpoint: string;
+        projectContentPolicyHeader: "x-knowledge-authority-policy";
+        projectContentProjectHeader: "x-knowledge-project-key";
+        projectControlIdentitySchemaVersion: 19;
+    }>;
+}

package/dist/types/sdk/tenant-web-content.d.ts

@@ -0,0 +1,44 @@
+/** 显式 Provider24；继承旧入口但不改变其默认发现版本。 */
+import { type TenantWebToolName, type TenantWebContentToolInput, type TenantWebContentToolResponse } from '../serving-contracts/index.js';
+import { KnowledgeTenantRuntimeClient } from './tenant-runtime.js';
+import { TenantManagementSdkError } from './tenant-management.js';
+import { type MaterialStreamOptions } from './material-stream.js';
+export declare class KnowledgeTenantWebContentClient extends KnowledgeTenantRuntimeClient {
+    protected protocolVersion(): 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25;
+    protected failure(raw: unknown, status: number): TenantManagementSdkError<string> | null;
+    webTool<K extends TenantWebToolName>(name: K, raw: TenantWebContentToolInput<K>, options?: {
+        signal?: AbortSignal;
+    }): Promise<TenantWebContentToolResponse<K>>;
+    stream(ref: string, options?: MaterialStreamOptions): Promise<import("./material-stream.js").MaterialStreamResponse>;
+    webProvider(): Promise<{
+        schemaVersion: 24;
+        capabilities: ["TENANT_MANAGEMENT_V1", "TENANT_WORKFLOW_V1", "TENANT_CURRENTNESS_V2", "TENANT_SOURCE_V1", "TENANT_WORKSPACE_METADATA_V1", "TENANT_PROJECT_CONTEXT_V1", "TENANT_RUNTIME_STATUS_V1", "TENANT_WEB_COLLECTION_SPEC_V1", "TENANT_WEB_CRAWL_V1", "TENANT_WEB_DYNAMIC_V1", "TENANT_WEB_CONTENT_V1"];
+        tools: string[];
+        provider: "knowledge-v2";
+        codeRevision: string;
+        authorityVersion: 2;
+        context: "TENANT_EXPLICIT_MANAGEMENT_V1";
+        managementConfigured: boolean;
+        resource: string;
+        issuer: string;
+        authorizationEndpoint: string;
+        tokenEndpoint: string;
+        revocationEndpoint: string;
+        mcpEndpoint: string;
+        callEndpoint: string;
+        contentEndpoint: string;
+        contentContextHeader: "x-knowledge-tenant-id";
+        legacyProviderEndpoint: string;
+        protocols: ("2026-07-28" | "2025-06-18")[];
+        requestMaxBytes: 131072;
+        resultMaxBytes: 524288;
+        submissionMaxBytes: 65536;
+        inlineContentMaxBytes: 32768;
+        contentReadMaxBytes: 16777216;
+        collectionMode: "MANUAL_ONLY_OAUTH";
+        projectContentEndpoint: string;
+        projectContentPolicyHeader: "x-knowledge-authority-policy";
+        projectContentProjectHeader: "x-knowledge-project-key";
+        projectControlIdentitySchemaVersion: 19;
+    }>;
+}

package/dist/types/sdk/tenant-web-crawl.d.ts

@@ -0,0 +1,42 @@
+/** 显式 Provider22；继承旧入口但不改变其默认发现版本。 */
+import { type TenantWebToolName, type TenantWebToolInput, type TenantWebCrawlToolResponse } from '../serving-contracts/index.js';
+import { KnowledgeTenantRuntimeClient } from './tenant-runtime.js';
+import { TenantManagementSdkError } from './tenant-management.js';
+export declare class KnowledgeTenantWebCrawlClient extends KnowledgeTenantRuntimeClient {
+    protected protocolVersion(): 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25;
+    protected failure(raw: unknown, status: number): TenantManagementSdkError<string> | null;
+    webTool<K extends TenantWebToolName>(name: K, raw: TenantWebToolInput<K>, options?: {
+        signal?: AbortSignal;
+    }): Promise<TenantWebCrawlToolResponse<K>>;
+    webProvider(): Promise<{
+        schemaVersion: 22;
+        capabilities: ["TENANT_MANAGEMENT_V1", "TENANT_WORKFLOW_V1", "TENANT_CURRENTNESS_V2", "TENANT_SOURCE_V1", "TENANT_WORKSPACE_METADATA_V1", "TENANT_PROJECT_CONTEXT_V1", "TENANT_RUNTIME_STATUS_V1", "TENANT_WEB_COLLECTION_SPEC_V1", "TENANT_WEB_CRAWL_V1"];
+        tools: string[];
+        provider: "knowledge-v2";
+        codeRevision: string;
+        authorityVersion: 2;
+        context: "TENANT_EXPLICIT_MANAGEMENT_V1";
+        managementConfigured: boolean;
+        resource: string;
+        issuer: string;
+        authorizationEndpoint: string;
+        tokenEndpoint: string;
+        revocationEndpoint: string;
+        mcpEndpoint: string;
+        callEndpoint: string;
+        contentEndpoint: string;
+        contentContextHeader: "x-knowledge-tenant-id";
+        legacyProviderEndpoint: string;
+        protocols: ("2026-07-28" | "2025-06-18")[];
+        requestMaxBytes: 131072;
+        resultMaxBytes: 524288;
+        submissionMaxBytes: 65536;
+        inlineContentMaxBytes: 32768;
+        contentReadMaxBytes: 16777216;
+        collectionMode: "MANUAL_ONLY_OAUTH";
+        projectContentEndpoint: string;
+        projectContentPolicyHeader: "x-knowledge-authority-policy";
+        projectContentProjectHeader: "x-knowledge-project-key";
+        projectControlIdentitySchemaVersion: 19;
+    }>;
+}

package/dist/types/sdk/tenant-web-dynamic.d.ts

@@ -0,0 +1,42 @@
+/** 显式 Provider23；继承旧入口但不改变其默认发现版本。 */
+import { type TenantWebToolName, type TenantWebDynamicToolInput, type TenantWebDynamicToolResponse } from '../serving-contracts/index.js';
+import { KnowledgeTenantRuntimeClient } from './tenant-runtime.js';
+import { TenantManagementSdkError } from './tenant-management.js';
+export declare class KnowledgeTenantWebDynamicClient extends KnowledgeTenantRuntimeClient {
+    protected protocolVersion(): 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25;
+    protected failure(raw: unknown, status: number): TenantManagementSdkError<string> | null;
+    webTool<K extends TenantWebToolName>(name: K, raw: TenantWebDynamicToolInput<K>, options?: {
+        signal?: AbortSignal;
+    }): Promise<TenantWebDynamicToolResponse<K>>;
+    webProvider(): Promise<{
+        schemaVersion: 23;
+        capabilities: ["TENANT_MANAGEMENT_V1", "TENANT_WORKFLOW_V1", "TENANT_CURRENTNESS_V2", "TENANT_SOURCE_V1", "TENANT_WORKSPACE_METADATA_V1", "TENANT_PROJECT_CONTEXT_V1", "TENANT_RUNTIME_STATUS_V1", "TENANT_WEB_COLLECTION_SPEC_V1", "TENANT_WEB_CRAWL_V1", "TENANT_WEB_DYNAMIC_V1"];
+        tools: string[];
+        provider: "knowledge-v2";
+        codeRevision: string;
+        authorityVersion: 2;
+        context: "TENANT_EXPLICIT_MANAGEMENT_V1";
+        managementConfigured: boolean;
+        resource: string;
+        issuer: string;
+        authorizationEndpoint: string;
+        tokenEndpoint: string;
+        revocationEndpoint: string;
+        mcpEndpoint: string;
+        callEndpoint: string;
+        contentEndpoint: string;
+        contentContextHeader: "x-knowledge-tenant-id";
+        legacyProviderEndpoint: string;
+        protocols: ("2026-07-28" | "2025-06-18")[];
+        requestMaxBytes: 131072;
+        resultMaxBytes: 524288;
+        submissionMaxBytes: 65536;
+        inlineContentMaxBytes: 32768;
+        contentReadMaxBytes: 16777216;
+        collectionMode: "MANUAL_ONLY_OAUTH";
+        projectContentEndpoint: string;
+        projectContentPolicyHeader: "x-knowledge-authority-policy";
+        projectContentProjectHeader: "x-knowledge-project-key";
+        projectControlIdentitySchemaVersion: 19;
+    }>;
+}

package/dist/types/sdk/tenant-web-workflow.d.ts

@@ -0,0 +1,43 @@
+import { type TenantWebWorkflowToolName, type TenantWebWorkflowToolInput, type TenantWebWorkflowToolResponse } from '../serving-contracts/index.js';
+import { KnowledgeTenantWebContentClient } from './tenant-web-content.js';
+import { TenantManagementSdkError } from './tenant-management.js';
+import { type MaterialStreamOptions } from './material-stream.js';
+export declare class KnowledgeTenantWebWorkflowClient extends KnowledgeTenantWebContentClient {
+    protected protocolVersion(): 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25;
+    protected failure(raw: unknown, status: number): TenantManagementSdkError<string> | null;
+    workflowTool<K extends TenantWebWorkflowToolName>(name: K, raw: TenantWebWorkflowToolInput<K>, options?: {
+        signal?: AbortSignal;
+    }): Promise<TenantWebWorkflowToolResponse<K>>;
+    workflowProvider(): Promise<{
+        schemaVersion: 25;
+        collectionMode: "EXPLICIT_HOST_WITH_OPT_IN_DUE";
+        tools: string[];
+        capabilities: ["TENANT_MANAGEMENT_V1", "TENANT_WORKFLOW_V1", "TENANT_CURRENTNESS_V2", "TENANT_SOURCE_V1", "TENANT_WORKSPACE_METADATA_V1", "TENANT_PROJECT_CONTEXT_V1", "TENANT_RUNTIME_STATUS_V1", "TENANT_WEB_COLLECTION_SPEC_V1", "TENANT_WEB_CRAWL_V1", "TENANT_WEB_DYNAMIC_V1", "TENANT_WEB_CONTENT_V1", "TENANT_WEB_WORKFLOW_V1"];
+        provider: "knowledge-v2";
+        codeRevision: string;
+        authorityVersion: 2;
+        context: "TENANT_EXPLICIT_MANAGEMENT_V1";
+        managementConfigured: boolean;
+        resource: string;
+        issuer: string;
+        authorizationEndpoint: string;
+        tokenEndpoint: string;
+        revocationEndpoint: string;
+        mcpEndpoint: string;
+        callEndpoint: string;
+        contentEndpoint: string;
+        contentContextHeader: "x-knowledge-tenant-id";
+        legacyProviderEndpoint: string;
+        protocols: ("2026-07-28" | "2025-06-18")[];
+        requestMaxBytes: 131072;
+        resultMaxBytes: 524288;
+        submissionMaxBytes: 65536;
+        inlineContentMaxBytes: 32768;
+        contentReadMaxBytes: 16777216;
+        projectContentEndpoint: string;
+        projectContentPolicyHeader: "x-knowledge-authority-policy";
+        projectContentProjectHeader: "x-knowledge-project-key";
+        projectControlIdentitySchemaVersion: 19;
+    }>;
+    stream(ref: string, options?: MaterialStreamOptions): Promise<import("./material-stream.js").MaterialStreamResponse>;
+}

package/dist/types/sdk/tenant-web.d.ts

@@ -0,0 +1,42 @@
+/** 显式 Provider21；继承旧入口但不改变其默认发现版本。 */
+import { type TenantWebToolName, type TenantWebToolInput, type TenantWebToolResponse } from '../serving-contracts/index.js';
+import { KnowledgeTenantRuntimeClient } from './tenant-runtime.js';
+import { TenantManagementSdkError } from './tenant-management.js';
+export declare class KnowledgeTenantWebCollectionClient extends KnowledgeTenantRuntimeClient {
+    protected protocolVersion(): 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25;
+    protected failure(raw: unknown, status: number): TenantManagementSdkError<string> | null;
+    webTool<K extends TenantWebToolName>(name: K, raw: TenantWebToolInput<K>, options?: {
+        signal?: AbortSignal;
+    }): Promise<TenantWebToolResponse<K>>;
+    webProvider(): Promise<{
+        schemaVersion: 21;
+        tools: string[];
+        capabilities: ["TENANT_MANAGEMENT_V1", "TENANT_WORKFLOW_V1", "TENANT_CURRENTNESS_V2", "TENANT_SOURCE_V1", "TENANT_WORKSPACE_METADATA_V1", "TENANT_PROJECT_CONTEXT_V1", "TENANT_RUNTIME_STATUS_V1", "TENANT_WEB_COLLECTION_SPEC_V1"];
+        provider: "knowledge-v2";
+        codeRevision: string;
+        authorityVersion: 2;
+        context: "TENANT_EXPLICIT_MANAGEMENT_V1";
+        managementConfigured: boolean;
+        resource: string;
+        issuer: string;
+        authorizationEndpoint: string;
+        tokenEndpoint: string;
+        revocationEndpoint: string;
+        mcpEndpoint: string;
+        callEndpoint: string;
+        contentEndpoint: string;
+        contentContextHeader: "x-knowledge-tenant-id";
+        legacyProviderEndpoint: string;
+        protocols: ("2026-07-28" | "2025-06-18")[];
+        requestMaxBytes: 131072;
+        resultMaxBytes: 524288;
+        submissionMaxBytes: 65536;
+        inlineContentMaxBytes: 32768;
+        contentReadMaxBytes: 16777216;
+        collectionMode: "MANUAL_ONLY_OAUTH";
+        projectContentEndpoint: string;
+        projectContentPolicyHeader: "x-knowledge-authority-policy";
+        projectContentProjectHeader: "x-knowledge-project-key";
+        projectControlIdentitySchemaVersion: 19;
+    }>;
+}

package/dist/types/sdk/tenant-workspace.d.ts

@@ -0,0 +1,36 @@
+/** Explicit v18 client; the original management client keeps its v17 default contract. */
+import { type TenantWorkspaceExtraToolName, type TenantWorkspaceExtraInput, type TenantWorkspaceResponse } from '../serving-contracts/index.js';
+import { KnowledgeTenantManagementClient } from './tenant-management.js';
+export declare class KnowledgeTenantWorkspaceClient extends KnowledgeTenantManagementClient {
+    protected protocolVersion(): 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25;
+    workspaceTool<K extends TenantWorkspaceExtraToolName>(name: K, raw: TenantWorkspaceExtraInput<K>, options?: {
+        signal?: AbortSignal;
+    }): Promise<TenantWorkspaceResponse<K>>;
+    workspaceProvider(): Promise<{
+        provider: "knowledge-v2";
+        codeRevision: string;
+        authorityVersion: 2;
+        context: "TENANT_EXPLICIT_MANAGEMENT_V1";
+        managementConfigured: boolean;
+        resource: string;
+        issuer: string;
+        authorizationEndpoint: string;
+        tokenEndpoint: string;
+        revocationEndpoint: string;
+        mcpEndpoint: string;
+        callEndpoint: string;
+        contentEndpoint: string;
+        contentContextHeader: "x-knowledge-tenant-id";
+        legacyProviderEndpoint: string;
+        protocols: ("2026-07-28" | "2025-06-18")[];
+        requestMaxBytes: 131072;
+        resultMaxBytes: 524288;
+        submissionMaxBytes: 65536;
+        inlineContentMaxBytes: 32768;
+        contentReadMaxBytes: 16777216;
+        collectionMode: "MANUAL_ONLY_OAUTH";
+        schemaVersion: 18;
+        tools: string[];
+        capabilities: ["TENANT_MANAGEMENT_V1", "TENANT_WORKFLOW_V1", "TENANT_CURRENTNESS_V2", "TENANT_SOURCE_V1", "TENANT_WORKSPACE_METADATA_V1"];
+    }>;
+}

package/dist/types/sdk/transport.d.ts

@@ -0,0 +1,16 @@
+/** A single attempt with a deadline covering headers and body; never retries writes. */
+export interface SdkTransportOptions {
+    timeoutMs?: number;
+    maxJsonBytes?: number;
+    maxContentBytes?: number;
+}
+/** Default logging/JSON must not enumerate credentials or connection configuration. */
+export declare function concealClientState(client: object, publicKeys?: string[]): void;
+export declare function transportLimits(options?: SdkTransportOptions): {
+    timeoutMs: number;
+    maxJsonBytes: number;
+    maxContentBytes: number;
+};
+export declare function deadlineFetch(fetchImpl: typeof fetch, timeoutMs: number): typeof fetch;
+export declare function boundedBytes(response: Response, maxBytes: number, prefix: string): Promise<Buffer>;
+export declare function boundedJson(response: Response, maxBytes: number, prefix: string): Promise<unknown>;

package/dist/types/serving-contracts/agent-catalog.d.ts

@@ -0,0 +1,70 @@
+/** Bilingual intent recall is bounded, deterministic and independent of resource contents. */
+import type { AgentCapabilityName } from './agent-entry.js';
+type Card = {
+    category: 'materials' | 'sources' | 'collection' | 'governance' | 'sharing' | 'projects' | 'runtime';
+    title: string;
+    description: string;
+    readOnly: boolean;
+    terms: string[];
+};
+export declare const agentCatalog: {
+    knowledge_resource_search_body: Card;
+    knowledge_resource_read_passage: Card;
+    knowledge_resource_search: Card;
+    knowledge_resource_list: Card;
+    knowledge_resource_describe: Card;
+    knowledge_resource_read: Card;
+    knowledge_resource_capabilities: Card;
+    knowledge_resource_media: Card;
+    knowledge_resource_counts: Card;
+    knowledge_resource_window: Card;
+    knowledge_resource_changes: Card;
+    knowledge_resource_index_status: Card;
+    tenant_material_submit: Card;
+    tenant_artifact_draft: Card;
+    tenant_knowledge_compose: Card;
+    tenant_knowledge_review: Card;
+    tenant_artifact_promote: Card;
+    tenant_snapshot_declare: Card;
+    tenant_snapshot_status: Card;
+    tenant_workflow_plan: Card;
+    tenant_workflow_advance: Card;
+    tenant_knowledge_read: Card;
+    tenant_material_share: Card;
+    tenant_material_revoke: Card;
+    tenant_material_routes: Card;
+    tenant_source_define: Card;
+    tenant_source_configure: Card;
+    tenant_source_get: Card;
+    tenant_source_list: Card;
+    tenant_source_inventory: Card;
+    tenant_collection_request: Card;
+    tenant_collection_status: Card;
+    tenant_work_queue: Card;
+    tenant_project_list: Card;
+    tenant_project_get: Card;
+    tenant_project_materials: Card;
+    tenant_project_scope_set: Card;
+    tenant_project_lifecycle_set: Card;
+    tenant_runtime_status: Card;
+    tenant_web_collect_preview: Card;
+    tenant_web_collect_submit: Card;
+    tenant_web_collect_status: Card;
+    tenant_web_collect_results: Card;
+    tenant_web_collect_cycles: Card;
+    tenant_web_collect_control: Card;
+    tenant_web_collect_refresh: Card;
+    tenant_web_collect_read: Card;
+    tenant_web_collect_index_status: Card;
+};
+export declare const agentCategoryTitles: {
+    readonly materials: "Material discovery / 资料检索";
+    readonly sources: "Source management / 来源管理";
+    readonly collection: "Collection tasks / 采集任务";
+    readonly governance: "Knowledge workflow / 知识工作流";
+    readonly sharing: "Sharing / 共享";
+    readonly projects: "Project purpose / 项目用途";
+    readonly runtime: "Runtime diagnostics / 运行诊断";
+};
+export declare function recallAgentCapabilities(query: string, names: AgentCapabilityName[]): ("tenant_material_submit" | "tenant_artifact_draft" | "tenant_knowledge_compose" | "tenant_knowledge_review" | "tenant_artifact_promote" | "tenant_snapshot_declare" | "tenant_snapshot_status" | "tenant_material_share" | "tenant_material_revoke" | "tenant_material_routes" | "tenant_workflow_plan" | "tenant_workflow_advance" | "tenant_knowledge_read" | "tenant_source_define" | "tenant_source_configure" | "tenant_source_get" | "tenant_source_list" | "tenant_collection_request" | "tenant_collection_status" | "tenant_source_inventory" | "tenant_work_queue" | "tenant_project_list" | "tenant_project_get" | "tenant_project_materials" | "tenant_project_scope_set" | "tenant_project_lifecycle_set" | "tenant_runtime_status" | "tenant_web_collect_preview" | "tenant_web_collect_submit" | "tenant_web_collect_status" | "tenant_web_collect_results" | "tenant_web_collect_cycles" | "tenant_web_collect_control" | "tenant_web_collect_refresh" | "tenant_web_collect_read" | "tenant_web_collect_index_status" | "knowledge_resource_search_body" | "knowledge_resource_read_passage" | "knowledge_resource_list" | "knowledge_resource_describe" | "knowledge_resource_read" | "knowledge_resource_capabilities" | "knowledge_resource_search" | "knowledge_resource_window" | "knowledge_resource_changes" | "knowledge_resource_counts" | "knowledge_resource_index_status" | "knowledge_resource_media")[];
+export {};