qlogicagent 2.2.0 → 2.4.0

package/dist/types/protocol/wire/gateway.d.ts

@@ -0,0 +1,62 @@
+export interface AgentAuthPayload {
+    gatewayId: string;
+    token: string;
+    version: string;
+    subscriptionKey?: string;
+    deviceId?: string;
+    deviceName?: string;
+}
+export interface AgentAuthOkPayload {
+    gatewayId: string;
+    boundUsers: string[];
+    planActive?: boolean;
+    principalId?: string;
+    entitlementId?: string;
+}
+export interface AgentAuthFailPayload {
+    reason: string;
+}
+export interface AgentAuthMsg {
+    type: "agent.auth";
+    id: string;
+    payload: AgentAuthPayload;
+}
+export interface AgentAuthOkMsg {
+    type: "agent.auth.ok";
+    id: string;
+    payload: AgentAuthOkPayload;
+}
+export interface AgentAuthFailMsg {
+    type: "agent.auth.fail";
+    id: string;
+    payload: AgentAuthFailPayload;
+}
+export interface AgentHeartbeatPayload {
+    timestamp: string;
+    subscriptionKey?: string;
+    consumed?: Record<string, number>;
+}
+export interface AgentHeartbeatMsg {
+    type: "agent.heartbeat";
+    id: string;
+    payload: AgentHeartbeatPayload;
+}
+export interface AgentHeartbeatResponsePayload {
+    timestamp: string;
+    quotaRemaining?: Record<string, number>;
+}
+export interface AgentHeartbeatResponseMsg {
+    type: "agent.heartbeat.response";
+    id: string;
+    payload: AgentHeartbeatResponsePayload;
+}
+export interface AgentStatusPayload {
+    alertType: string;
+    description: string;
+    detail?: string;
+}
+export interface AgentStatusMsg {
+    type: "agent.status";
+    id: string;
+    payload: AgentStatusPayload;
+}

package/dist/types/protocol/wire/hook-protocol.d.ts

@@ -0,0 +1,37 @@
+import type { AgentExecutionRefs } from "./transport.js";
+export interface HookInvokePayload extends AgentExecutionRefs {
+    sessionId: string;
+    turnId?: string;
+    hookPoint: string;
+    context: Record<string, unknown>;
+    correlationId: string;
+    timeoutMs?: number;
+}
+export interface HookInvokeMsg {
+    type: "hook.invoke";
+    id: string;
+    payload: HookInvokePayload;
+}
+export type HookResponseAction = "continue" | "abort" | "skip";
+export interface HookResponsePayload {
+    correlationId: string;
+    action: HookResponseAction;
+    context?: Record<string, unknown>;
+    reason?: string;
+}
+export interface HookResponseMsg {
+    type: "hook.response";
+    id: string;
+    payload: HookResponsePayload;
+}
+export interface HookNotifyPayload extends AgentExecutionRefs {
+    sessionId: string;
+    turnId?: string;
+    hookPoint: string;
+    context: Record<string, unknown>;
+}
+export interface HookNotifyMsg {
+    type: "hook.notify";
+    id: string;
+    payload: HookNotifyPayload;
+}

package/dist/types/protocol/wire/index.d.ts

@@ -0,0 +1,25 @@
+export { AGENT_RPC_APPROVAL_METHODS, AGENT_RPC_ERROR_CODES, AGENT_RPC_PROTOCOL_VERSION, isAgentRpcNotification, isAgentRpcRequest, isAgentRpcResponse, parseAgentRpcMessage, type AgentHelloParams, type AgentHelloResult, type AgentRpcError, type AgentRpcErrorCode, type AgentRpcMessage, type AgentRpcNotification, type AgentRpcRequest, type AgentRpcResponse, type ToolApprovalRequestParams, type ToolApprovalResponseParams, } from "./agent-rpc.js";
+export { GATEWAY_RPC_METHODS, type AgentCall, type GatewayRpcMethodMap, type ProjectInfo as RpcProjectInfo, type ProjectStatus as RpcProjectStatus, type ProjectType as RpcProjectType, } from "./gateway-rpc.js";
+export { type ChatMessage, type ChatMessageRole, type ThinkingBlock, type ToolCallMessage, type ToolDefinition, } from "./chat-types.js";
+export { type AgentCapabilities, type AgentCategory, type AgentConfig, type AgentDescriptor, type AgentProtocol, type AgentRpcMethodMap, type AgentStatus, type CustomAgentDef, type ProductInstanceDef, type ProductPhase, type ProductStatus, type ProductSummary, type ProductTaskDef, type ProductTaskStatus, type SoloAgentResult, type SoloAgentState, type SoloState, type SoloStatus, } from "./agent-methods.js";
+export { AGENT_TEAM_WS_EVENT_NAMES, AGENT_WS_EVENT_NAMES, ALL_AGENT_WS_EVENT_NAMES, type AgentTeamWsEventName, type AgentWsEventName, type AllAgentWsEventName, } from "./agent-events.js";
+export { type AgentSource, type AgentsErrorNotification, type AgentsStatusNotification, type ArtifactType, type MediaResultType, type MemoryDecayCompletedNotification, type MemoryUpdatedNotification, type NotificationMethod, type NotificationMethodMap, type NotificationThreadItem, type PermissionRuleUpdatedNotification, type PlanInterruptedNotification, type PongNotification, type ProductBudgetUpdateNotification, type ProductBudgetWarningNotification, type ProductCheckpointedNotification, type ProductCompletedNotification, type ProductDagTopologyNotification, type ProductTaskCompletedNotification, type ProductTaskFailedNotification, type ProductTaskOutputDeltaNotification, type ProductTaskStartedNotification, type ProjectArchivedNotification, type ProjectCreatedNotification, type ProjectDeletedNotification, type ProjectRenamedNotification, type ProjectSwitchedNotification, type ProjectUnarchivedNotification, type SessionInfoNotification, type SoloAgentDeltaNotification, type SoloAgentDiffNotification, type SoloAgentUsageNotification, type SoloEvaluationNotification, type SoloProgressNotification, type TeamMemberNotification, type ToolApprovalRequestNotification, type TurnAnnotationsNotification, type TurnArtifactNotification, type TurnAskUserNotification, type TurnDeltaNotification, type TurnEndNotification, type TurnErrorNotification, type TurnExecProgressNotification, type TurnHeartbeatNotification, type TurnMediaPersistedNotification, type TurnMediaProgressNotification, type TurnMediaResultNotification, type TurnPlanUpdateNotification, type TurnReasoningDeltaNotification, type TurnRecoveryNotification, type TurnSidechainCompletedNotification, type TurnSidechainStartedNotification, type TurnSkillInstructionNotification, type TurnStartNotification, type TurnSubagentDeltaNotification, type TurnSuggestionsNotification, type TurnTaskUpdatedNotification, type TurnTodosUpdatedNotification, type TurnToolBlockedNotification, type TurnToolCallNotification, type TurnToolResultNotification, type TurnToolUseSummaryNotification, type TurnUsageUpdateNotification, type WireTokenUsage, } from "./notification-payloads.js";
+export { ACP_EXTENDED_METHODS, ACP_EXTENDED_SESSION_UPDATE_TYPES, ACP_METHODS, ACP_PROTOCOL_VERSION, ACP_SESSION_UPDATE_TYPES, isAcpJsonRpcNotification, isAcpJsonRpcRequest, isAcpJsonRpcResponse, isExtendedSessionUpdateType, isStandardSessionUpdateType, parseAcpMessage, type AcpAgentCapabilities, type AcpAgentMessageChunkPayload, type AcpAgentThoughtChunkPayload, type AcpAvailableCommandsUpdatePayload, type AcpConfigOptionDescriptor, type AcpConfigOptionUpdatePayload, type AcpContentBlock, type AcpContextItem, type AcpEndTurnPayload, type AcpExtendedMethod, type AcpExtendedSessionUpdateType, type AcpFsReadTextFileParams, type AcpFsReadTextFileResult, type AcpFsWriteTextFileParams, type AcpFsWriteTextFileResult, type AcpHostCapabilities, type AcpInitializeParams, type AcpInitializeResult, type AcpJsonRpcError, type AcpJsonRpcMessage, type AcpJsonRpcNotification, type AcpJsonRpcRequest, type AcpJsonRpcResponse, type AcpPermissionOption, type AcpPermissionRequestParams, type AcpPermissionRequestResult, type AcpPlanPayload, type AcpSessionEndParams, type AcpSessionNewParams, type AcpSessionNewResult, type AcpSessionPromptParams, type AcpSessionPromptResult, type AcpSessionSetConfigParams, type AcpSessionUpdateNotification, type AcpSessionUpdateType, type AcpStandardMethod, type AcpStandardSessionUpdateType, type AcpStopReason, type AcpToolCallPayload, type AcpToolCallUpdatePayload, type AcpUsage, type AcpUsageUpdatePayload, type AcpXAskUserPayload, type AcpXMediaProgressPayload, type AcpXMediaResultPayload, type AcpXMemoryUpdatedPayload, type AcpXProductCheckpointPayload, type AcpXProductTaskCompletedPayload, type AcpXProductTaskStartedPayload, type AcpXRecoveryPayload, type AcpXSessionInfoPayload, type AcpXSidechainCompletedPayload, type AcpXSidechainStartedPayload, type AcpXSkillInstructionPayload, type AcpXSoloAgentFinishedPayload, type AcpXSoloSelectedPayload, type AcpXSoloStartedPayload, type AcpXSubagentDeltaPayload, type AcpXSubagentEndedPayload, type AcpXSubagentStartedPayload, type AcpXSuggestionsPayload, type AcpXTeamMemberUpdatePayload, } from "./acp-protocol.js";
+export { type ApprovalRequiredToolContract, type ModelSelectionReason, type PendingPromptContract, type RuntimeCapabilitySummaryContract, type RuntimeSessionContract, type SessionIdentityContract, } from "./session.js";
+export { type GatewayChannelExecutionEgressContract, type GatewayChannelExecutionEgressKind, type GatewayChannelExecutionIngressBindingContract, type GatewayChannelExecutionIngressSource, } from "./channel-ingress.js";
+export { CAPABILITY_MANIFEST_DIFF_SECTIONS, cloneCapabilityManifestSnapshot, createCapabilityManifestDiffPayload, deriveCapabilityToolNamespaces, deriveCapabilityWorkspaceIds, mergeCapabilityManifestSnapshot, type CapabilityManifestApprovalMode, type CapabilityManifestApprovalPolicyContract, type CapabilityManifestDiffSection, type CapabilityMcpManifestContract, type CapabilityManifestSnapshotContract, type HostCapabilitySnapshotContract, type CapabilityPluginManifestContract, type RuntimeCapabilityViewContract, type RuntimeToolEligibilityContract, type CapabilitySkillManifestContract, type CapabilityToolManifestContract, type CapabilityWorkspaceSummaryContract, type ToolEligibilityResolvedSource, type ToolEligibilityReasonCode, type ToolEligibilityStatus, } from "./capability-manifest.js";
+export { WEB_ACTION_SCOPE_VALUES, WEB_APPROVAL_DEFAULT_VALUES, WEB_CAPABILITY_FAMILY_VALUES, WEB_CAPABILITY_ID_VALUES, WEB_DEGRADATION_TARGET_VALUES, WEB_ESCALATION_REASON_VALUES, WEB_EXECUTION_MODE_VALUES, WEB_POLICY_RISK_CLASS_VALUES, WEB_RETRY_POLICY_VALUES, WEB_STATEFULNESS_VALUES, WEB_TASK_MODE_VALUES, type WebActionScope, type WebApprovalDefault, type WebCapabilityDescriptorContract, type WebCapabilityFamily, type WebCapabilityId, type WebDegradationTarget, type WebEscalationReason, type WebExecutionMode, type WebPolicyRiskClass, type WebRetryPolicy, type WebStatefulness, type WebTaskMode, } from "./web-capability.js";
+export { MEMORY_OBSERVATION_HOOK_VALUES, MEMORY_OBSERVATION_SOURCE_VALUES, MEMORY_WRITE_ACCESS_VALUES, type MemoryContextBlock, type MemoryIngestMessage, type MemoryIngestOptions, type MemoryLlmConfig, type MemoryObservedMsg, type MemoryObservedPayload, type MemoryObservationEnvelope, type MemoryObservationHook, type MemoryObservationSource, type MemoryObserveRequestMsg, type MemoryProvider, type MemorySearchOptions, type MemorySearchResult, type MemoryWriteAccess, } from "./memory-provider-lifecycle.js";
+export { RESOURCE_MANIFEST_SCHEMA_VERSION, RUNTIME_ASSET_IDS, RUNTIME_PROFILE_IDS, createDefaultRuntimeResourceProfiles, getManifestShortcutEntry, getRuntimeResourceAsset, getRuntimeResourceProfile, getRuntimeResourceProfileAssets, normalizeRuntimeResourceManifest, upsertRuntimeResourceAsset, type RuntimeManifestShortcutEntry, type RuntimeResourceArtifact, type RuntimeResourceAsset, type RuntimeResourceAssetDelivery, type RuntimeResourceAssetKind, type RuntimeResourceAssetMap, type RuntimeResourceManifest, type RuntimeResourcePlatform, type RuntimeResourceProfile, type RuntimeResourceProfileMap, } from "./resource-manifest.js";
+export { MUTATION_CHECKPOINT_ENTRY_KIND_VALUES, MUTATION_CHECKPOINT_BACKEND_VALUES, MUTATION_CHECKPOINT_PHASE_VALUES, type MutationCheckpointBackend, type MutationCheckpointContract, type MutationCheckpointEntryKind, type MutationCheckpointPhase, type MutationCheckpointRestoreAckContract, type MutationCheckpointRollbackResultContract, type MutationCheckpointRestoreContract, type MutationCheckpointSnapshotEntryContract, } from "./checkpoint.js";
+export { type MutationCheckpointRuntimeManager, type MutationCheckpointRuntimeManagerDeps, } from "./checkpoint-runtime.js";
+export { PROVIDER_RUNTIME_AUTH_MODE_VALUES, PROVIDER_RUNTIME_COMPAT_FLAG_VALUES, PROVIDER_RUNTIME_VAULT_ERROR_TYPE_VALUES, readProviderRuntimeCompatFlag, type ProviderRuntimeAdapterContract, type ProviderRuntimeAuthMode, type ProviderRuntimeCompatFlag, type ProviderRuntimeCompatModelContract, type ProviderRuntimeProfileRecordContract, type ProviderRuntimeProfileStoreContract, type ProviderRuntimeResolvedAuthContract, type ProviderRuntimeVaultErrorType, } from "./provider-runtime-contract.js";
+export { PROVIDER_RUNTIME_OPENAI_CODEX_PROVIDER_ID, PROVIDER_RUNTIME_ENV_API_KEY_CANDIDATES, isAnthropicProviderRuntimeFamily, isOpenAiProviderRuntimeFamily, listProviderRuntimeEnvApiKeyNames, normalizeProviderRuntimeId, normalizeProviderRuntimeIdForAuth, preservesProviderRuntimeAnthropicThinkingSignatures, requiresOpenAiCompatibleAnthropicToolPayloadForProviderRuntime, resolveProviderRuntimeCapabilities, resolveProviderRuntimeEnvApiKey, resolveProviderRuntimeKeyFamily, resolveProviderRuntimeTranscriptToolCallIdMode, shouldDropThinkingBlocksForProviderRuntimeModel, shouldSanitizeProviderRuntimeThoughtSignaturesForModel, supportsOpenAiCompatTurnValidationForProviderRuntime, usesOpenAiFunctionAnthropicToolSchemaForProviderRuntime, usesOpenAiStringModeAnthropicToolChoiceForProviderRuntime, type ProviderRuntimeAuthCoreDeps, type ProviderRuntimeAuthProfileDeps, type ProviderRuntimeCapabilities, type ProviderRuntimeCredentialMap, type ProviderRuntimeCredentialRecord, type ProviderRuntimeEnvApiKeyResult, type ProviderRuntimePlatformKey, type ProviderRuntimeResolvedAuth, type ProviderRuntimeResolvedAuthMode, } from "./provider-runtime-core.js";
+export * from "./transport.js";
+export * from "./channel.js";
+export * from "./capability-transport.js";
+export * from "./execution.js";
+export * from "./turn.js";
+export * from "./gateway.js";
+export * from "./hook-protocol.js";
+export * from "./thread-protocol.js";

package/dist/types/protocol/wire/memory-provider-lifecycle.d.ts

@@ -0,0 +1,80 @@
+import type { AgentExecutionRefs } from "./transport.js";
+export declare const MEMORY_OBSERVATION_HOOK_VALUES: readonly ["prefetch", "sync_turn", "on_pre_compress", "on_session_end", "on_delegation", "on_memory_write"];
+export type MemoryObservationHook = (typeof MEMORY_OBSERVATION_HOOK_VALUES)[number];
+export declare const MEMORY_OBSERVATION_SOURCE_VALUES: readonly ["turn", "sidechain", "compress", "session-end"];
+export type MemoryObservationSource = (typeof MEMORY_OBSERVATION_SOURCE_VALUES)[number];
+export declare const MEMORY_WRITE_ACCESS_VALUES: readonly ["observe-only", "parent-write", "deny"];
+export type MemoryWriteAccess = (typeof MEMORY_WRITE_ACCESS_VALUES)[number];
+export interface MemoryContextBlock {
+    blockId?: string;
+    providerId: string;
+    kind: "informational-background";
+    title?: string;
+    text: string;
+    citations?: string[];
+}
+export interface MemoryObservationEnvelope extends AgentExecutionRefs {
+    sessionId: string;
+    turnId?: string;
+    hook: MemoryObservationHook;
+    source: MemoryObservationSource;
+    writeAccess: MemoryWriteAccess;
+    summary?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface MemoryObservedPayload extends MemoryObservationEnvelope {
+    providerId: string;
+    observedAtMs: number;
+    status: "observed" | "failed";
+    blocks?: MemoryContextBlock[];
+    error?: string;
+}
+export interface MemoryObservedMsg {
+    type: "memory.observed";
+    id: string;
+    payload: MemoryObservedPayload;
+}
+export interface MemoryObserveRequestMsg {
+    type: "memory.observe";
+    id: string;
+    payload: MemoryObservationEnvelope;
+}
+export interface MemoryLlmConfig {
+    provider: string;
+    baseUrl: string;
+    apiKey: string;
+    model: string;
+}
+export interface MemorySearchResult {
+    blockId: string;
+    text: string;
+    score: number;
+    source?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface MemorySearchOptions {
+    limit?: number;
+    minScore?: number;
+    llmConfig?: MemoryLlmConfig;
+}
+export interface MemoryIngestOptions {
+    llmConfig?: MemoryLlmConfig;
+    source?: MemoryObservationSource;
+    sessionId?: string;
+}
+export interface MemoryProvider {
+    readonly providerId: string;
+    search(query: string, userId: string, options?: MemorySearchOptions): Promise<MemorySearchResult[]>;
+    ingest(messages: MemoryIngestMessage[], userId: string, options?: MemoryIngestOptions): Promise<void>;
+    /** Store a plain text memory entry (no LLM extraction — agent decides content). */
+    addText?(text: string, userId: string, options?: MemoryIngestOptions): Promise<{
+        memoriesAdded: number;
+    }>;
+    /** Remove a memory entry by ID. */
+    remove?(memoryId: string): Promise<boolean>;
+}
+export interface MemoryIngestMessage {
+    role: string;
+    content: string;
+    timestamp?: number;
+}