import type { ActivityId, AdvisoryCallId, AdvisoryId, AgentId, AuditEventId, CheckpointId, ChunkId, ConnectorId, ConnectorInstanceId, CredentialId, DeliverableId, DocumentId, EnvironmentId, ExecutionContextId, GoalId, HandoffId, KnowledgeBaseId, KnowledgeBaseRef, LockId, MCPClientId, MCPServerId, MCPSessionId, MemoryId, MemoryStoreRef, MessageId, PlanId, PluginId, ProjectId, RecordId, SandboxId, SessionId, SubSessionId, SummaryId, TaskId, TenantId, ToolCallId, TopicId, TurnId, UserId, VaultRef, WorkspaceId } from '../types/ids/index.js';
export declare function generateProjectId(): ProjectId;
export declare function generateTopicId(): TopicId;
export declare function generateTurnId(): TurnId;
/** The id of one session-log record (its `id` field). */
export declare function generateRecordId(): RecordId;
export declare function generateMessageId(): MessageId;
export declare function generateSessionId(): SessionId;
export declare function generateGoalId(): GoalId;
export declare function generateToolCallId(): ToolCallId;
export declare function generateActivityId(): ActivityId;
export declare function generateTaskId(): TaskId;
export declare function generatePlanId(): PlanId;
export declare function generateKnowledgeBaseId(): KnowledgeBaseId;
export declare function generateDocumentId(): DocumentId;
export declare function generateChunkId(): ChunkId;
export declare function generateConnectorId(): ConnectorId;
export declare function generateConnectorInstanceId(): ConnectorInstanceId;
export declare function generateTenantId(): TenantId;
export declare function generateCredentialId(): CredentialId;
export declare function generateExecutionContextId(): ExecutionContextId;
export declare function generateMCPServerId(): MCPServerId;
export declare function generateMCPClientId(): MCPClientId;
export declare function generateMCPSessionId(): MCPSessionId;
export declare function generateEnvironmentId(): EnvironmentId;
export declare function generateCheckpointId(): CheckpointId;
export declare function generateAdvisoryId(): AdvisoryId;
export declare function generateAdvisoryCallId(): AdvisoryCallId;
export declare function generateAuditEventId(): AuditEventId;
export declare function generateMemoryId(): MemoryId;
export declare function generatePluginId(): PluginId;
export declare function generateSandboxId(): SandboxId;
export declare function generateWorkspaceId(): WorkspaceId;
export declare function generateSubSessionId(): SubSessionId;
export declare function generateSummaryId(): SummaryId;
export declare function generateHandoffId(): HandoffId;
export declare function generateDeliverableId(): DeliverableId;
/** Entity kinds are supplied by a typed field or storage collection. */
export interface EntityIdByKind {
    turn: TurnId;
    record: RecordId;
    message: MessageId;
    session: SessionId;
    goal: GoalId;
    toolCall: ToolCallId;
    activity: ActivityId;
    task: TaskId;
    plan: PlanId;
    knowledgeBase: KnowledgeBaseId;
    document: DocumentId;
    chunk: ChunkId;
    connector: ConnectorId;
    connectorInstance: ConnectorInstanceId;
    tenant: TenantId;
    credential: CredentialId;
    executionContext: ExecutionContextId;
    mcpServer: MCPServerId;
    mcpClient: MCPClientId;
    mcpSession: MCPSessionId;
    environment: EnvironmentId;
    checkpoint: CheckpointId;
    lock: LockId;
    advisory: AdvisoryId;
    advisoryCall: AdvisoryCallId;
    memory: MemoryId;
    plugin: PluginId;
    sandbox: SandboxId;
    auditEvent: AuditEventId;
    user: UserId;
    agent: AgentId;
    memoryStoreRef: MemoryStoreRef;
    vaultRef: VaultRef;
    knowledgeBaseRef: KnowledgeBaseRef;
    project: ProjectId;
    topic: TopicId;
    subSession: SubSessionId;
    handoff: HandoffId;
    workspace: WorkspaceId;
    summary: SummaryId;
    deliverable: DeliverableId;
}
export type EntityIdKind = keyof EntityIdByKind;
/**
 * Checks an id without throwing or rewriting it. UUIDs identify opaque
 * entities; the kind comes from the caller's field or collection.
 * This validates spelling, not existence, ownership, or access permission.
 */
export declare function isEntityId<K extends EntityIdKind>(value: unknown, kind: K): value is EntityIdByKind[K];
/** @deprecated Use the `as*Id` constructor of the same type; this family throws a plain Error and is removed in the next major. */
export declare function parseProjectId(raw: string): ProjectId;
/** @deprecated Use the `as*Id` constructor of the same type; this family throws a plain Error and is removed in the next major. */
export declare function parseTurnId(raw: string): TurnId;
/** @deprecated Use the `as*Id` constructor of the same type; this family throws a plain Error and is removed in the next major. */
export declare function parseConnectorInstanceId(raw: string): ConnectorInstanceId;
/** @deprecated Use the `as*Id` constructor of the same type; this family throws a plain Error and is removed in the next major. */
export declare function parsePluginId(raw: string): PluginId;
/** @deprecated Use the `as*Id` constructor of the same type; this family throws a plain Error and is removed in the next major. */
export declare function parseSandboxId(raw: string): SandboxId;
/** A value that cannot represent an entity id because it is not a UUID. */
export declare class InvalidIdError extends Error {
    readonly value: string;
    /** The typed field or collection that required an identity. */
    readonly expectedKind: EntityIdKind;
    constructor(value: string, 
    /** The typed field or collection that required an identity. */
    expectedKind: EntityIdKind);
}
type IdParser<T extends string> = (value: string) => T;
export declare const asTurnId: IdParser<TurnId>;
export declare const asRecordId: IdParser<RecordId>;
export declare const asMessageId: IdParser<MessageId>;
export declare const asSessionId: IdParser<SessionId>;
export declare const asGoalId: IdParser<GoalId>;
export declare const asToolCallId: IdParser<ToolCallId>;
export declare const asActivityId: IdParser<ActivityId>;
export declare const asTaskId: IdParser<TaskId>;
export declare const asPlanId: IdParser<PlanId>;
export declare const asKnowledgeBaseId: IdParser<KnowledgeBaseId>;
export declare const asDocumentId: IdParser<DocumentId>;
export declare const asChunkId: IdParser<ChunkId>;
export declare const asConnectorId: IdParser<ConnectorId>;
export declare const asConnectorInstanceId: IdParser<ConnectorInstanceId>;
export declare const asTenantId: IdParser<TenantId>;
export declare const asCredentialId: IdParser<CredentialId>;
export declare const asExecutionContextId: IdParser<ExecutionContextId>;
export declare const asMCPServerId: IdParser<MCPServerId>;
export declare const asMCPClientId: IdParser<MCPClientId>;
export declare const asMCPSessionId: IdParser<MCPSessionId>;
export declare const asEnvironmentId: IdParser<EnvironmentId>;
export declare const asCheckpointId: IdParser<CheckpointId>;
export declare const asLockId: IdParser<LockId>;
export declare const asAdvisoryId: IdParser<AdvisoryId>;
export declare const asAdvisoryCallId: IdParser<AdvisoryCallId>;
export declare const asMemoryId: IdParser<MemoryId>;
export declare const asPluginId: IdParser<PluginId>;
export declare const asSandboxId: IdParser<SandboxId>;
export declare const asAuditEventId: IdParser<AuditEventId>;
export declare const asUserId: IdParser<UserId>;
/**
 * @deprecated Agents are named by their registry keys, which have no entity-id
 * spelling contract. Use the registry key as a string. See {@link AgentId}.
 * Removal is a later major.
 */
export declare const asAgentId: IdParser<AgentId>;
export declare const asMemoryStoreRef: IdParser<MemoryStoreRef>;
export declare const asVaultRef: IdParser<VaultRef>;
export declare const asKnowledgeBaseRef: IdParser<KnowledgeBaseRef>;
export declare const asProjectId: IdParser<ProjectId>;
export declare const asTopicId: IdParser<TopicId>;
export declare const asSubSessionId: IdParser<SubSessionId>;
export declare const asHandoffId: IdParser<HandoffId>;
export declare const asWorkspaceId: IdParser<WorkspaceId>;
export declare const asSummaryId: IdParser<SummaryId>;
export declare const asDeliverableId: IdParser<DeliverableId>;
export {};
//# sourceMappingURL=id.d.ts.map