Skip to content
FoundationResearchPublic

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

Repository files navigation

JevaScript

在 Python 中写判断意图,用 jevac 调用 Claude Code,把它展开成可检查的 Jev API 调用。

import jevascript as j

def classify(email):
    category = j.choose("Classify the email.", candidates=["work", "personal", "other"])
    needs_reply = j.judge("Does this email ask for a reply?", threshold=0.7)
    priority = j.score("How urgently does this email require action?")
    return category, needs_reply, priority

开发者必须写清判断目标。编译 agent 从调用位置已有的变量中选择 context,补全 state、问题和评分标准。位置参数、结构化数据、自定义关键字参数都可以作为编译材料。 显式约束优先于自动推断。

使用

需要 Python 3.10+,以及已安装并登录的 Claude Code。

python -m pip install -e .
jevac examples/email_classifier.py -o build/email_classifier.py --report build/email_classifier.json

检查生成的 Python 后运行它;运行阶段需要 TypeSafe API key:

export TYPESAFE_API_KEY='your-key'
python build/email_classifier.py

jevac 本身不会执行输入文件、生成代码或 Jev 请求。编译会把输入文件源码交给 Claude Code。 生成文件仅依赖普通 Python 和 typesafe-sdk,不需要 JevaScript 或 Claude Code。 邮箱示例使用虚构邮件,输出类别、是否需要回复和处理优先级。

两个例子都已实际通过 Claude Code 编译,源码与编译快照可对照阅读:

Claude Code 默认使用自己的已配置模型。可用 --model 指定模型,--claude 指定可执行文件, --timeout 设置编译超时。现有输出文件在生成结果通过校验后原子替换;输入源文件不会被覆盖。

原语

原语 默认返回值 规则
j.judge(...) bool P(true) >= threshold,默认阈值 0.5
j.choose(...) 候选值 字典候选返回 key,序列候选返回原始 item
j.score(...) float 默认 0–1;可提供 rubric 和 scale=(low, high)

没有显式 rubric 时,agent 根据判断维度补出量表,量表会直接呈现在生成代码中。 高级用法保持上述返回类型;输入中的自定义信息由编译 agent 解释:

j.judge("是否需要回复", email, threshold=0.8, 注意="自动回执不算回复请求")
j.choose("最合适的邮件分类", candidates=categories, 优先考虑="邮件实际要求的行动")
j.score("处理优先级", rubric=priority_levels, scale=(0, 100))

编译方式与边界

compiler/ 包含 Python 前端、Claude Code 适配层和展开器。前端找到直接的 j.judge()、 j.choose()、j.score() 调用,并保守地列出调用处可用的绑定。Claude 为每个调用生成一个 helper;展开器传入选中的运行时变量以及原调用的参数,保持原来的控制流与求值位置。 首版每个原语独立调用 Jev,不跨调用做自动批处理。

原文件保持不变,生成文件通过 AST 输出,所以格式和注释可能与源文件不同。 编译检查包括 Python 语法、调用点覆盖、context 绑定及残留 JevaScript 依赖;这不能证明 agent 推断的 context、量表或判断语义正确,仍需要检查生成代码并用自己的样本验证。 再次编译相同源码可能得到不同的展开实现;示例保留实际生成快照供对照。 普通 API 错误直接抛出,不被转换成判断结果。

首版支持直接模块导入 import jevascript as j,不支持原语别名、动态导入和 import alias 被重新绑定。隐式 context 分析是保守的:复杂作用域中未列入的值可直接作为参数传给原语。 不要直接运行含有原语的源文件;未编译的调用会报 CompilationRequired。

官方接口资料:Python SDK、 Advanced 输入。本地调研见 compiler/jev-api-notes.md。

验证

python -m unittest discover -s tests -v

这些测试不调用模型,包括用真实 TypeSafe SDK 和模拟 HTTP transport 验证生成快照的请求与返回值。 实际编译需要 Claude Code,实际分类还需要 TypeSafe API key。当前验证环境没有配置这个 key, 尚未验证真实 Jev 分类质量。

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages