@scotthuang/agent-knock-knock 0.13.3 → 0.13.5

package/dist/src/semantic-tool-command-helpers.d.ts

@@ -0,0 +1,145 @@
+import { type TerminalApprovalDecision } from "./terminal-agent-adapter.js";
+export { isAkkModelFacingDiagnosticField, isAkkModelFacingPrivateAuthorityField, normalizeAkkModelFacingFieldName } from "./semantic-tool-model-facing-field-policy.js";
+/**
+ * Remove only AKK-generated pre-v18 authority instructions from callback/event
+ * text.  Exact authority-looking text outside one of these fixed machine-owned
+ * forms is business content and must remain byte-for-byte visible.
+ */
+export declare function sanitizeAkkModelFacingLegacyAuthorityInstructionText(value: string): string;
+/** Remove only the exact legacy approval instruction appended by AKK. */
+export declare function stripAkkLegacyApprovalInstructionTail(value: string): string;
+export declare function sanitizeAkkModelFacingDiagnosticText(message: string): string;
+export declare const AKK_CALLBACK_METHOD = "agent-knock-knock.callback";
+export type AkkResumeSelection = {
+    kind: "exact";
+    nativeThreadId: string;
+} | {
+    kind: "previous";
+} | {
+    kind: "number";
+    selectionNumber: number;
+} | {
+    kind: "short-id";
+    shortId: string;
+};
+type AkkCloseCommand = {
+    action: "close";
+    turnId: string;
+    reason: string;
+} & ({
+    expectedMessageId?: undefined;
+    expectedTransitionId?: undefined;
+} | {
+    expectedMessageId: string;
+    expectedTransitionId?: never;
+} | {
+    expectedMessageId?: never;
+    expectedTransitionId: string;
+});
+export type AkkCommand = {
+    action: "help";
+} | {
+    action: "doctor";
+} | {
+    action: "list";
+} | {
+    action: "watch";
+    terminalId: string;
+} | {
+    action: "unwatch";
+    watchId: string;
+} | {
+    action: "list-resumable-threads";
+    terminalId: string;
+} | {
+    action: "model-options";
+    terminalId: string;
+} | {
+    action: "repair-model-control";
+    terminalId: string;
+} | {
+    action: "set-model";
+    terminalId: string;
+    model: string;
+    reasoningEffort: string;
+} | {
+    action: "new-thread";
+    terminalId: string;
+} | {
+    action: "resume-thread";
+    terminalId: string;
+    selection?: AkkResumeSelection;
+} | {
+    action: "status";
+    turnId?: string;
+    watchId?: never;
+} | {
+    action: "status";
+    watchId: string;
+    turnId?: never;
+} | {
+    action: "send";
+    selector: string;
+    message: string;
+} | {
+    action: "respond";
+    turnId: string;
+    message: string;
+} | {
+    action: "approve";
+    turnId: string;
+    decision?: TerminalApprovalDecision;
+} | {
+    action: "cancel";
+    turnId: string;
+} | {
+    action: "renew";
+    turnId: string;
+    minutes?: string;
+} | {
+    action: "retry-callback";
+    turnId: string;
+} | AkkCloseCommand | {
+    action: "delegate";
+    request: string;
+};
+export declare function parseAkkCommand(args: unknown): AkkCommand;
+export declare function akkUsageText(): string;
+export declare function formatAkkListCommandResult(result: Record<string, unknown>): string;
+/**
+ * Keep every structured controller-Host List result below its model-output
+ * budget without weakening the private action-authority path.
+ *
+ * The CLI remains the complete operator/debug contract.  The controller receives a
+ * terminal-first projection: current resource identities and state, action
+ * names, and only the dynamic semantic inputs needed to invoke those actions.
+ * Static explanations live in the bundled agent-knock-knock skill.
+ */
+export { compactAkkListModelProjection } from "./semantic-tool-list-projection.js";
+export declare function formatAkkWatchCommandResult(result: Record<string, unknown>): string;
+export declare function formatAkkUnwatchCommandResult(result: Record<string, unknown>): string;
+export declare function formatAkkWatchStatusCommandResult(result: Record<string, unknown>): string;
+export declare function formatAkkTerminalWatchHint(result: Record<string, unknown>): string[];
+export declare function formatAkkRespondCommandResult(result: Record<string, unknown>): {
+    text: string;
+    isError: boolean;
+};
+export declare function isAkkNativeSubmissionAccepted(result: Record<string, unknown>): boolean;
+export declare function formatAkkThreadsCommandResult(result: Record<string, unknown>): string;
+export declare function formatAkkModelOptionsCommandResult(result: Record<string, unknown>): string;
+export declare function formatAkkSetModelCommandResult(result: Record<string, unknown>): string;
+export declare function formatAkkRepairModelControlCommandResult(result: Record<string, unknown>): string;
+export declare function isAkkRepairModelControlSuccess(result: unknown): boolean;
+export declare function isAkkSetModelSuccess(result: unknown): boolean;
+export declare function formatAkkThreadTransitionCommandResult(result: Record<string, unknown>): string;
+export declare function isAkkThreadTransitionSuccess(result: unknown): boolean;
+export declare function buildAkkCommandCliArgs(command: AkkCommand, config: Record<string, unknown>, context?: {
+    sessionKey?: unknown;
+    expectedBindingToken?: unknown;
+    candidateToken?: unknown;
+    expectedCatalogFingerprint?: unknown;
+    messageId?: unknown;
+    selectionScope?: unknown;
+    selectionSnapshotId?: unknown;
+}): string[] | undefined;
+export declare function resolvePluginStoreDir(config: Record<string, unknown>, gatewayCwd?: string): string | undefined;