sf-agentpmd 0.1.0 → 0.1.2

package/vendor/agentscript-parser-javascript/dist/recovery.js

@@ -1,199 +0,0 @@
-/*
- * Copyright (c) 2026, Salesforce, Inc.
- * All rights reserved.
- * SPDX-License-Identifier: Apache-2.0
- * For full license text, see the LICENSE file in the repo root or https://www.apache.org/licenses/LICENSE-2.0
- */
-/**
- * Recovery and utility functions extracted from parser.ts.
- *
- * All functions take a ParserContext as their first argument,
- * following the free-function pattern established by expressions.ts.
- */
-import { TokenKind } from './token.js';
-import { CSTNode } from './cst-node.js';
-import { makeErrorNode, tokenToAutoLeaf } from './errors.js';
-// --- Error recovery ---
-/** Create an empty ERROR node at the current position. */
-export function makeEmptyError(ctx) {
-    const offset = ctx.peekOffset();
-    const pos = ctx.peek().start;
-    return new CSTNode('ERROR', ctx.source, offset, offset, pos, pos, true, true);
-}
-/** Insert a missing target: `target: (expression (atom (ERROR)))` */
-export function addMissingTarget(ctx, node) {
-    const errAtom = makeEmptyError(ctx);
-    const atom = new CSTNode('atom', ctx.source, errAtom.startOffset, errAtom.endOffset, errAtom.startPosition, errAtom.endPosition);
-    atom.appendChild(errAtom);
-    const expr = new CSTNode('expression', ctx.source, atom.startOffset, atom.endOffset, atom.startPosition, atom.endPosition);
-    expr.appendChild(atom);
-    node.appendChild(expr, 'target');
-}
-/** Create a MISSING node — an expected token/node that wasn't found in source. */
-export function makeMissing(ctx, type) {
-    const offset = ctx.peekOffset();
-    const pos = ctx.peek().start;
-    return new CSTNode(type, ctx.source, offset, offset, pos, pos, true, false, true);
-}
-/**
- * Parse a standalone else/elif/for (without a preceding if, or unsupported).
- * Wraps the entire block in an ERROR node, preserving parsed statements inside.
- *
- * @param parseProcedure - callback to parse procedure bodies, avoiding circular
- *   dependency with parse-statements.ts
- */
-export function parseOrphanBlock(ctx, parseProcedure) {
-    const startOffset = ctx.peekOffset();
-    const startPos = ctx.peek().start;
-    const children = [];
-    // Consume keyword and any tokens up to colon/newline.
-    // Capture consumed tokens as children of the ERROR for dialect recovery.
-    const keywordTok = ctx.consume();
-    const kwOffset = ctx.currentOffset();
-    children.push(new CSTNode(keywordTok.text, ctx.source, kwOffset, kwOffset + keywordTok.text.length, keywordTok.start, keywordTok.end, false));
-    while (!ctx.isAtSyncPoint() &&
-        !isAtEnd(ctx) &&
-        ctx.peekKind() !== TokenKind.COLON) {
-        ctx.consume(); // consume but don't add as named children — they're noise
-    }
-    // Consume colon if present
-    if (ctx.peekKind() === TokenKind.COLON)
-        ctx.consume();
-    // Consume the body block
-    if (ctx.peekKind() === TokenKind.INDENT) {
-        ctx.consume();
-        const proc = parseProcedure(ctx);
-        if (proc) {
-            for (const child of proc.namedChildren) {
-                children.push(child);
-            }
-        }
-        // Consume trailing comments left by parseProcedure's isTrailingCommentOnly guard
-        while (ctx.peekKind() === TokenKind.COMMENT ||
-            ctx.peekKind() === TokenKind.NEWLINE) {
-            if (ctx.peekKind() === TokenKind.COMMENT) {
-                children.push(ctx.consumeNamed('comment'));
-            }
-            else {
-                ctx.consume();
-            }
-        }
-        if (ctx.peekKind() === TokenKind.DEDENT)
-            ctx.consume();
-    }
-    if (ctx.peekKind() === TokenKind.NEWLINE)
-        ctx.consume();
-    const endOffset = children.length > 0
-        ? children[children.length - 1].endOffset
-        : ctx.peekOffset();
-    const endPos = children.length > 0
-        ? children[children.length - 1].endPosition
-        : ctx.peek().start;
-    return makeErrorNode(ctx.source, children, startOffset, endOffset, startPos, endPos);
-}
-/**
- * Consume any leftover tokens in an indented block (before DEDENT) as ERROR
- * nodes. Prevents cascading failures when parseBlockValue() only partially
- * consumes the block content (e.g., unquoted multi-word text).
- */
-export function recoverToBlockEnd(ctx, parent) {
-    while (!isAtEnd(ctx) && ctx.peekKind() !== TokenKind.DEDENT) {
-        if (ctx.peekKind() === TokenKind.NEWLINE) {
-            ctx.consume();
-            continue;
-        }
-        // Skip over nested indented blocks within the error zone
-        if (ctx.peekKind() === TokenKind.INDENT) {
-            ctx.consume();
-            recoverToBlockEnd(ctx, parent);
-            if (ctx.peekKind() === TokenKind.DEDENT)
-                ctx.consume();
-            continue;
-        }
-        const err = synchronize(ctx);
-        if (err) {
-            parent.appendChild(err);
-        }
-        else {
-            break;
-        }
-    }
-}
-/**
- * Synchronize: skip tokens until a stopping condition is met.
- * Returns an ERROR node wrapping the skipped content, or null if
- * nothing was consumed.
- *
- * @param extraStop - optional predicate for additional stop conditions
- *   beyond the default sync points (NEWLINE/DEDENT/EOF)
- */
-export function synchronizeUntil(ctx, extraStop) {
-    if (ctx.isAtSyncPoint() || isAtEnd(ctx))
-        return null;
-    if (extraStop && extraStop(ctx.peekKind(), ctx.peek().start.row))
-        return null;
-    const startOffset = ctx.peekOffset();
-    const startPos = ctx.peek().start;
-    const children = [];
-    while (!ctx.isAtSyncPoint() &&
-        !isAtEnd(ctx) &&
-        !(extraStop && extraStop(ctx.peekKind(), ctx.peek().start.row))) {
-        const tok = ctx.consume();
-        children.push(tokenToAutoLeaf(tok, ctx.source, ctx.currentOffset()));
-    }
-    if (children.length === 0)
-        return null;
-    const last = children[children.length - 1];
-    return makeErrorNode(ctx.source, children, startOffset, last.endOffset, startPos, last.endPosition);
-}
-/** Skip tokens on the given row until a sync point, INDENT, or COLON. */
-export function synchronizeRowUntilColon(ctx, row) {
-    return synchronizeUntil(ctx, (kind, r) => kind === TokenKind.INDENT || kind === TokenKind.COLON || r !== row);
-}
-/** Skip tokens on the given row until a sync point or INDENT. */
-export function synchronizeRow(ctx, row) {
-    return synchronizeUntil(ctx, (kind, r) => kind === TokenKind.INDENT || r !== row);
-}
-/** Skip tokens until the next sync point (NEWLINE/DEDENT/EOF). */
-export function synchronize(ctx) {
-    return synchronizeUntil(ctx);
-}
-// --- Utility ---
-export function skipNewlines(ctx) {
-    while (ctx.peekKind() === TokenKind.NEWLINE) {
-        ctx.consume();
-    }
-}
-/** Consume comment and newline tokens and attach to parent node. */
-export function consumeCommentsAndSkipNewlines(ctx, parent) {
-    while (true) {
-        if (ctx.peekKind() === TokenKind.COMMENT) {
-            parent.appendChild(ctx.consumeNamed('comment'));
-        }
-        else if (ctx.peekKind() === TokenKind.NEWLINE) {
-            ctx.consume();
-        }
-        else {
-            break;
-        }
-    }
-}
-export function isAtEnd(ctx) {
-    return ctx.peekKind() === TokenKind.EOF;
-}
-/** Check if from current position, there are only comments, newlines, and then EOF/DEDENT. */
-export function isTrailingCommentOnly(ctx) {
-    let i = 0;
-    while (i < 50) {
-        const tok = ctx.peekAt(i);
-        if (tok.kind === TokenKind.EOF || tok.kind === TokenKind.DEDENT)
-            return true;
-        if (tok.kind === TokenKind.COMMENT || tok.kind === TokenKind.NEWLINE) {
-            i++;
-            continue;
-        }
-        return false;
-    }
-    return false; // Exceeded lookahead limit
-}
-//# sourceMappingURL=recovery.js.map

package/vendor/agentscript-parser-javascript/dist/token.d.ts

@@ -1,58 +0,0 @@
-/** Token kinds produced by the lexer. */
-export declare enum TokenKind {
-    NEWLINE = "NEWLINE",
-    INDENT = "INDENT",
-    DEDENT = "DEDENT",
-    EOF = "EOF",
-    ID = "ID",
-    NUMBER = "NUMBER",
-    STRING = "STRING",
-    STRING_CONTENT = "STRING_CONTENT",
-    ESCAPE_SEQUENCE = "ESCAPE_SEQUENCE",
-    DATETIME = "DATETIME",
-    TEMPLATE_CONTENT = "TEMPLATE_CONTENT",
-    PLUS = "PLUS",
-    MINUS = "MINUS",
-    STAR = "STAR",
-    SLASH = "SLASH",
-    DOT = "DOT",
-    COMMA = "COMMA",
-    COLON = "COLON",
-    EQ = "EQ",
-    EQEQ = "EQEQ",
-    NEQ = "NEQ",
-    LT = "LT",
-    GT = "GT",
-    LTE = "LTE",
-    GTE = "GTE",
-    ARROW = "ARROW",
-    ELLIPSIS = "ELLIPSIS",
-    PERCENT = "PERCENT",
-    PIPE = "PIPE",
-    AT = "AT",
-    LPAREN = "LPAREN",
-    RPAREN = "RPAREN",
-    LBRACKET = "LBRACKET",
-    RBRACKET = "RBRACKET",
-    LBRACE = "LBRACE",
-    RBRACE = "RBRACE",
-    TEMPLATE_EXPR_START = "TEMPLATE_EXPR_START",// {!
-    DASH_SPACE = "DASH_SPACE",// "- " at start of line
-    DQUOTE = "DQUOTE",
-    COMMENT = "COMMENT",
-    ERROR_TOKEN = "ERROR_TOKEN"
-}
-export interface Position {
-    row: number;
-    column: number;
-}
-export interface Token<K extends TokenKind = TokenKind> {
-    readonly kind: K;
-    text: string;
-    start: Position;
-    end: Position;
-    /** Byte offset into the source string where this token starts. */
-    startOffset: number;
-}
-export declare function isTokenKind<K extends TokenKind>(token: Token, kind: K): token is Token<K>;
-//# sourceMappingURL=token.d.ts.map

package/vendor/agentscript-parser-javascript/dist/token.js

@@ -1,62 +0,0 @@
-/*
- * Copyright (c) 2026, Salesforce, Inc.
- * All rights reserved.
- * SPDX-License-Identifier: Apache-2.0
- * For full license text, see the LICENSE file in the repo root or https://www.apache.org/licenses/LICENSE-2.0
- */
-/** Token kinds produced by the lexer. */
-export var TokenKind;
-(function (TokenKind) {
-    // Synthetic indentation tokens
-    TokenKind["NEWLINE"] = "NEWLINE";
-    TokenKind["INDENT"] = "INDENT";
-    TokenKind["DEDENT"] = "DEDENT";
-    TokenKind["EOF"] = "EOF";
-    // Identifiers & literals
-    TokenKind["ID"] = "ID";
-    TokenKind["NUMBER"] = "NUMBER";
-    TokenKind["STRING"] = "STRING";
-    TokenKind["STRING_CONTENT"] = "STRING_CONTENT";
-    TokenKind["ESCAPE_SEQUENCE"] = "ESCAPE_SEQUENCE";
-    TokenKind["DATETIME"] = "DATETIME";
-    TokenKind["TEMPLATE_CONTENT"] = "TEMPLATE_CONTENT";
-    // Operators
-    TokenKind["PLUS"] = "PLUS";
-    TokenKind["MINUS"] = "MINUS";
-    TokenKind["STAR"] = "STAR";
-    TokenKind["SLASH"] = "SLASH";
-    TokenKind["DOT"] = "DOT";
-    TokenKind["COMMA"] = "COMMA";
-    TokenKind["COLON"] = "COLON";
-    TokenKind["EQ"] = "EQ";
-    TokenKind["EQEQ"] = "EQEQ";
-    TokenKind["NEQ"] = "NEQ";
-    TokenKind["LT"] = "LT";
-    TokenKind["GT"] = "GT";
-    TokenKind["LTE"] = "LTE";
-    TokenKind["GTE"] = "GTE";
-    TokenKind["ARROW"] = "ARROW";
-    TokenKind["ELLIPSIS"] = "ELLIPSIS";
-    TokenKind["PERCENT"] = "PERCENT";
-    TokenKind["PIPE"] = "PIPE";
-    TokenKind["AT"] = "AT";
-    // Delimiters
-    TokenKind["LPAREN"] = "LPAREN";
-    TokenKind["RPAREN"] = "RPAREN";
-    TokenKind["LBRACKET"] = "LBRACKET";
-    TokenKind["RBRACKET"] = "RBRACKET";
-    TokenKind["LBRACE"] = "LBRACE";
-    TokenKind["RBRACE"] = "RBRACE";
-    TokenKind["TEMPLATE_EXPR_START"] = "TEMPLATE_EXPR_START";
-    // Sequence
-    TokenKind["DASH_SPACE"] = "DASH_SPACE";
-    // Quote characters (for CST fidelity)
-    TokenKind["DQUOTE"] = "DQUOTE";
-    // Special
-    TokenKind["COMMENT"] = "COMMENT";
-    TokenKind["ERROR_TOKEN"] = "ERROR_TOKEN";
-})(TokenKind || (TokenKind = {}));
-export function isTokenKind(token, kind) {
-    return token.kind === kind;
-}
-//# sourceMappingURL=token.js.map

package/vendor/agentscript-parser-javascript/package.json

@@ -1,19 +0,0 @@
-{
-  "name": "@agentscript/parser-javascript",
-  "version": "2.4.0",
-  "license": "Apache-2.0",
-  "description": "Vendored from salesforce/agentscript packages/parser-javascript — hand-written TypeScript parser.",
-  "type": "module",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
-    }
-  },
-  "dependencies": {
-    "@agentscript/types": "file:../agentscript-types",
-    "tiny-invariant": "^1.3.3"
-  }
-}

package/vendor/agentscript-types/dist/comment.d.ts

@@ -1,11 +0,0 @@
-import type { Range } from './position.js';
-/** Where a comment is placed relative to its owning AST node. */
-export type CommentAttachment = 'leading' | 'inline' | 'trailing';
-/** A parsed source comment. Range is only present for parsed comments. */
-export interface Comment {
-    value: string;
-    attachment: CommentAttachment;
-    range?: Range;
-}
-export declare function comment(value: string, attachment?: CommentAttachment): Comment;
-//# sourceMappingURL=comment.d.ts.map

package/vendor/agentscript-types/dist/comment.js

@@ -1,10 +0,0 @@
-/*
- * Copyright (c) 2026, Salesforce, Inc.
- * All rights reserved.
- * SPDX-License-Identifier: Apache-2.0
- * For full license text, see the LICENSE file in the repo root or https://www.apache.org/licenses/LICENSE-2.0
- */
-export function comment(value, attachment = 'leading') {
-    return { value, attachment };
-}
-//# sourceMappingURL=comment.js.map

package/vendor/agentscript-types/dist/cst.d.ts

@@ -1,7 +0,0 @@
-import type { SyntaxNode } from './syntax-node.js';
-import type { Range } from './position.js';
-export interface CstMeta {
-    node: SyntaxNode;
-    range: Range;
-}
-//# sourceMappingURL=cst.d.ts.map

package/vendor/agentscript-types/dist/cst.js

@@ -1,8 +0,0 @@
-/*
- * Copyright (c) 2026, Salesforce, Inc.
- * All rights reserved.
- * SPDX-License-Identifier: Apache-2.0
- * For full license text, see the LICENSE file in the repo root or https://www.apache.org/licenses/LICENSE-2.0
- */
-export {};
-//# sourceMappingURL=cst.js.map

package/vendor/agentscript-types/dist/diagnostic.d.ts

@@ -1,34 +0,0 @@
-import type { Range } from './position.js';
-/**
- * LSP DiagnosticSeverity values. MUST NOT be changed -- LSP clients depend on these exact values.
- * @see https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification/#diagnosticSeverity
- */
-export declare enum DiagnosticSeverity {
-    Error = 1,
-    Warning = 2,
-    Information = 3,
-    Hint = 4
-}
-export declare enum DiagnosticTag {
-    Unnecessary = 1,
-    Deprecated = 2
-}
-export interface Diagnostic {
-    range: Range;
-    message: string;
-    severity: DiagnosticSeverity;
-    /** kebab-case, e.g., "syntax-error", "undefined-reference" */
-    code?: string;
-    /** "agentscript" (parser), "agentscript-schema", or "agentscript-lint" */
-    source?: string;
-    /** LSP DiagnosticTag values (Unnecessary=1, Deprecated=2) */
-    tags?: DiagnosticTag[];
-    /** Additional structured data for tooling (LSP-compatible) */
-    data?: {
-        context?: string;
-        expected?: string[];
-        found?: string;
-        [key: string]: unknown;
-    };
-}
-//# sourceMappingURL=diagnostic.d.ts.map

package/vendor/agentscript-types/dist/diagnostic.js

@@ -1,23 +0,0 @@
-/*
- * Copyright (c) 2026, Salesforce, Inc.
- * All rights reserved.
- * SPDX-License-Identifier: Apache-2.0
- * For full license text, see the LICENSE file in the repo root or https://www.apache.org/licenses/LICENSE-2.0
- */
-/**
- * LSP DiagnosticSeverity values. MUST NOT be changed -- LSP clients depend on these exact values.
- * @see https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification/#diagnosticSeverity
- */
-export var DiagnosticSeverity;
-(function (DiagnosticSeverity) {
-    DiagnosticSeverity[DiagnosticSeverity["Error"] = 1] = "Error";
-    DiagnosticSeverity[DiagnosticSeverity["Warning"] = 2] = "Warning";
-    DiagnosticSeverity[DiagnosticSeverity["Information"] = 3] = "Information";
-    DiagnosticSeverity[DiagnosticSeverity["Hint"] = 4] = "Hint";
-})(DiagnosticSeverity || (DiagnosticSeverity = {}));
-export var DiagnosticTag;
-(function (DiagnosticTag) {
-    DiagnosticTag[DiagnosticTag["Unnecessary"] = 1] = "Unnecessary";
-    DiagnosticTag[DiagnosticTag["Deprecated"] = 2] = "Deprecated";
-})(DiagnosticTag || (DiagnosticTag = {}));
-//# sourceMappingURL=diagnostic.js.map

package/vendor/agentscript-types/dist/index.d.ts

@@ -1,9 +0,0 @@
-export type { SyntaxNode } from './syntax-node.js';
-export type { Position, Range } from './position.js';
-export { toRange } from './position.js';
-export type { CstMeta } from './cst.js';
-export type { CommentAttachment, Comment } from './comment.js';
-export { comment } from './comment.js';
-export { DiagnosticSeverity, DiagnosticTag } from './diagnostic.js';
-export type { Diagnostic } from './diagnostic.js';
-//# sourceMappingURL=index.d.ts.map

package/vendor/agentscript-types/dist/index.js

@@ -1,10 +0,0 @@
-/*
- * Copyright (c) 2026, Salesforce, Inc.
- * All rights reserved.
- * SPDX-License-Identifier: Apache-2.0
- * For full license text, see the LICENSE file in the repo root or https://www.apache.org/licenses/LICENSE-2.0
- */
-export { toRange } from './position.js';
-export { comment } from './comment.js';
-export { DiagnosticSeverity, DiagnosticTag } from './diagnostic.js';
-//# sourceMappingURL=index.js.map

package/vendor/agentscript-types/dist/position.d.ts

@@ -1,11 +0,0 @@
-import type { SyntaxNode } from './syntax-node.js';
-export interface Position {
-    line: number;
-    character: number;
-}
-export interface Range {
-    start: Position;
-    end: Position;
-}
-export declare function toRange(node: SyntaxNode): Range;
-//# sourceMappingURL=position.d.ts.map

package/vendor/agentscript-types/dist/position.js

@@ -1,16 +0,0 @@
-/*
- * Copyright (c) 2026, Salesforce, Inc.
- * All rights reserved.
- * SPDX-License-Identifier: Apache-2.0
- * For full license text, see the LICENSE file in the repo root or https://www.apache.org/licenses/LICENSE-2.0
- */
-export function toRange(node) {
-    return {
-        start: {
-            line: node.startRow,
-            character: node.startCol,
-        },
-        end: { line: node.endRow, character: node.endCol },
-    };
-}
-//# sourceMappingURL=position.js.map

package/vendor/agentscript-types/dist/syntax-node.d.ts

@@ -1,39 +0,0 @@
-export interface SyntaxNode {
-    type: string;
-    text: string;
-    startPosition: {
-        row: number;
-        column: number;
-    };
-    endPosition: {
-        row: number;
-        column: number;
-    };
-    startRow: number;
-    startCol: number;
-    endRow: number;
-    endCol: number;
-    namedChildren: SyntaxNode[];
-    children: SyntaxNode[];
-    childForFieldName(name: string): SyntaxNode | null;
-    childrenForFieldName(name: string): SyntaxNode[];
-    parent: SyntaxNode | null;
-    previousSibling: SyntaxNode | null;
-    /** Byte offset of the start of this node in the source text. */
-    startOffset?: number;
-    /** Byte offset of the end of this node in the source text. */
-    endOffset?: number;
-    /** Return the field name for the child at the given index, or null. */
-    fieldNameForChild?(index: number): string | null;
-    /** True if this node is an ERROR node (parse failure). */
-    isError?: boolean;
-    /** True if this node was inserted by the parser (expected but not found). */
-    isMissing?: boolean;
-    /** True if this is a "named" node (not anonymous punctuation/keyword). */
-    isNamed?: boolean;
-    /** True if this node or any descendant has an error. */
-    hasError?: boolean;
-    /** Return an s-expression string representation of this node (for debugging). */
-    toSExp?(): string;
-}
-//# sourceMappingURL=syntax-node.d.ts.map

package/vendor/agentscript-types/dist/syntax-node.js

@@ -1,8 +0,0 @@
-/*
- * Copyright (c) 2026, Salesforce, Inc.
- * All rights reserved.
- * SPDX-License-Identifier: Apache-2.0
- * For full license text, see the LICENSE file in the repo root or https://www.apache.org/licenses/LICENSE-2.0
- */
-export {};
-//# sourceMappingURL=syntax-node.js.map

package/vendor/agentscript-types/package.json

@@ -1,15 +0,0 @@
-{
-  "name": "@agentscript/types",
-  "version": "0.2.1",
-  "license": "Apache-2.0",
-  "description": "Vendored from salesforce/agentscript packages/types — shared foundational types.",
-  "type": "module",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
-    }
-  }
-}