@ornexus/neocortex 4.60.18 → 4.60.19

package/packages/shared/dist/invocation/index.d.ts

@@ -0,0 +1,175 @@
+export declare const EXACT_INVOCATION_POLICY: "p205-exact-invocation-v1";
+export declare const INVOCATION_SCHEMA_VERSION: "p205-invocation-schema-v1";
+export declare const INVOCATION_LIMITS: Readonly<{
+    inputBytes: number;
+    tokens: 512;
+    tokenBytes: number;
+    briefBytes: number;
+    receiptBytes: 2048;
+    suggestions: 5;
+}>;
+export type InvocationAdmissionOutcome = 'resolved' | 'ambiguous_command' | 'unknown_command' | 'malformed_input' | 'invalid_arguments';
+export type InvocationAdmissionReason = 'accepted' | 'policy_mismatch' | 'registry_mismatch' | 'schema_mismatch' | 'input_limit' | 'token_limit' | 'token_size_limit' | 'invalid_control' | 'invalid_surrogate' | 'unsupported_escape' | 'unterminated_quote' | 'trailing_escape' | 'suggestions_available' | 'identity_unknown' | 'unknown_option' | 'duplicate_option' | 'missing_option_value' | 'unexpected_option_value' | 'invalid_option_value' | 'positional_required' | 'invalid_positional_value' | 'positional_overflow' | 'operation_required' | 'operation_unknown' | 'operation_quoted' | 'argument_conflict' | 'brief_limit';
+export interface InvocationTokenSegment {
+    readonly quoted: false | 'single' | 'double';
+    readonly start: number;
+    readonly end: number;
+}
+export interface InvocationToken {
+    readonly value: string;
+    readonly start: number;
+    readonly end: number;
+    readonly whollyUnquoted: boolean;
+    readonly segments: readonly InvocationTokenSegment[];
+}
+export interface NormalizedUiUxReviewBriefV1 {
+    readonly architectureDir?: string;
+    readonly url?: string;
+    readonly surface?: readonly string[];
+    readonly brand?: string;
+    readonly designSystem?: string;
+    readonly evidenceOut?: string;
+    readonly reviewBrief?: string;
+    readonly json: boolean;
+    readonly screenshots: boolean;
+    readonly projectEvidence: boolean;
+    readonly fingerprint: string;
+}
+export interface ResolvedInvocationSelectionV1 {
+    readonly commandId: string;
+    readonly commandNumber: number;
+    readonly operationId?: string;
+    readonly inputShape: string;
+    readonly positionals: readonly string[];
+    readonly options: Readonly<Record<string, boolean | string | readonly string[]>>;
+    readonly uiUxReview?: NormalizedUiUxReviewBriefV1;
+    readonly capability: {
+        readonly policy: typeof EXACT_INVOCATION_POLICY;
+        readonly registryChecksum: string;
+        readonly commandId: string;
+        readonly operationId?: string;
+    };
+}
+interface AdmissionBase {
+    readonly policy: typeof EXACT_INVOCATION_POLICY;
+    readonly schemaVersion: typeof INVOCATION_SCHEMA_VERSION;
+    readonly registryVersion: string;
+    readonly registryChecksum: string;
+    readonly schemaChecksum: string;
+    readonly executable: boolean;
+    readonly reason: InvocationAdmissionReason;
+    readonly tokenCount: number;
+    readonly inputBytesBucket: string;
+    readonly candidates: readonly string[];
+}
+export interface ResolvedInvocationAdmissionV1 extends AdmissionBase {
+    readonly outcome: 'resolved';
+    readonly executable: true;
+    readonly reason: 'accepted';
+    readonly selection: ResolvedInvocationSelectionV1;
+}
+export interface RejectedInvocationAdmissionV1 extends AdmissionBase {
+    readonly outcome: Exclude<InvocationAdmissionOutcome, 'resolved'>;
+    readonly executable: false;
+    readonly mutationAttempts: 0;
+}
+export type InvocationAdmissionResultV1 = ResolvedInvocationAdmissionV1 | RejectedInvocationAdmissionV1;
+export interface InvocationAdmissionOptions {
+    readonly policy?: string;
+    readonly registryVersion?: string;
+    readonly registryChecksum?: string;
+    readonly schemaChecksum?: string;
+}
+export type InvocationOptionKindV1 = 'boolean' | 'string' | 'string-list' | 'url' | 'path';
+export type InvocationPositionalKindV1 = 'string' | 'story-ref' | 'epic-ref' | 'target-ref' | 'uiux-part';
+export interface InvocationOptionSchemaV1 {
+    readonly id: string;
+    readonly aliases: readonly string[];
+    readonly kind: InvocationOptionKindV1;
+    readonly cardinality: 'one' | 'many';
+    readonly required: boolean;
+    readonly default: boolean | string | null;
+    readonly syntax: readonly ('bare' | 'split' | 'inline')[];
+    /** Anchored generated validation for bounded string domains. */
+    readonly valuePattern: string | null;
+}
+export interface InvocationPositionalSchemaV1 {
+    readonly id: string;
+    readonly kind: InvocationPositionalKindV1;
+    readonly cardinality: 'one' | 'many';
+    readonly required: boolean;
+    readonly order: number;
+}
+export interface InvocationCommandSchemaV1 {
+    readonly commandId: string;
+    readonly inputShape: string;
+    readonly operation: {
+        readonly required: boolean;
+        readonly unknownAsPositional: boolean;
+        readonly operations: readonly {
+            readonly id: string;
+            readonly aliases: readonly string[];
+        }[];
+    };
+    readonly options: readonly InvocationOptionSchemaV1[];
+    readonly positionals: readonly InvocationPositionalSchemaV1[];
+    readonly terminator: true;
+}
+export declare const INVOCATION_SCHEMA_CHECKSUM: "667c67ed7a55553d74eab12ec46c2e0f12b0529ad01303d4ca9cae14d49270bd";
+export interface InvocationSchemaManifestV1 {
+    readonly schemaVersion: typeof INVOCATION_SCHEMA_VERSION;
+    readonly registryVersion: string;
+    readonly registryChecksum: string;
+    readonly schemaChecksum: string;
+    readonly commandCount: number;
+    readonly optionCount: number;
+    readonly positionalCount: number;
+    readonly operationCount: number;
+    readonly projectionSha256: string;
+    readonly commands: readonly InvocationCommandSchemaV1[];
+}
+export declare const INVOCATION_SCHEMA_MANIFEST: InvocationSchemaManifestV1;
+export declare function assertInvocationSchemaAdmission(value: unknown): asserts value is InvocationSchemaManifestV1;
+type LexResult = {
+    readonly ok: true;
+    readonly tokens: readonly InvocationToken[];
+} | {
+    readonly ok: false;
+    readonly reason: InvocationAdmissionReason;
+    readonly tokenCount: number;
+};
+export declare function lexInvocationEnvelope(input: string): LexResult;
+export declare function admitInvocation(input: string, options?: InvocationAdmissionOptions): InvocationAdmissionResultV1;
+export interface InvocationAdmissionReceiptV1 {
+    readonly schemaVersion: 1;
+    readonly policy: typeof EXACT_INVOCATION_POLICY;
+    readonly registryVersion: string;
+    readonly registryChecksumPrefix: string;
+    readonly schemaChecksumPrefix: string;
+    readonly outcome: InvocationAdmissionOutcome;
+    readonly reason: InvocationAdmissionReason;
+    readonly commandId?: string;
+    readonly operationId?: string;
+    readonly candidates: readonly string[];
+    readonly tokenCount: number;
+    readonly inputBytesBucket: string;
+    readonly fingerprintPrefix?: string;
+    readonly driver: 'shared' | 'client' | 'graph' | 'server' | 'route' | 'native' | 'inline' | 'headless' | 'runner';
+    readonly mutationAttempts: number;
+    readonly publicSafe: true;
+}
+export declare function createInvocationAdmissionReceipt(result: InvocationAdmissionResultV1, driver: InvocationAdmissionReceiptV1['driver']): InvocationAdmissionReceiptV1;
+export declare function serializeInvocationAdmission(result: InvocationAdmissionResultV1): string;
+export declare function strictRollbackAdmitInvocation(input: string): InvocationAdmissionResultV1;
+export interface InvocationDeprecationCountV1 {
+    readonly schemaVersion: 1;
+    readonly policy: typeof EXACT_INVOCATION_POLICY;
+    readonly outcome: Exclude<InvocationAdmissionOutcome, 'resolved'>;
+    readonly reason: InvocationAdmissionReason;
+    readonly count: 1;
+    readonly expiresAfter: 'p205-exact-invocation-v1-rollout';
+    readonly publicSafe: true;
+}
+/** Count-only migration telemetry; raw input is intentionally not accepted. */
+export declare function createInvocationDeprecationCount(result: RejectedInvocationAdmissionV1): InvocationDeprecationCountV1;
+export {};