skillscript-runtime 0.4.4 → 0.7.0

package/examples/cut-release-tag.skill.md

@@ -5,36 +5,36 @@
 # Output: text
 
 last_tag:
-    @ git describe --tags --abbrev=0 -> PREV_TAG
+    shell(command="git describe --tags --abbrev=0") -> PREV_TAG
 else:
     $set PREV_TAG = "(no prior tags)"
-    ! no previous tag found; treating this as the first release
+    emit(text="no previous tag found; treating this as the first release")
 
 commits_since:
     needs: last_tag
-    @ git log --oneline $(PREV_TAG)..HEAD -> COMMITS
+    shell(command="git log --oneline ${PREV_TAG}..HEAD") -> COMMITS
 else:
     $set COMMITS = "(unable to read commit log; proceeding without preview)"
 
 propose:
     needs: commits_since
-    ~ prompt="Propose the next semver tag given prev tag '$(PREV_TAG)', bump kind '$(BUMP_KIND)', and commits below. Return ONLY the new tag string (e.g. v1.4.3). No commentary.\n\nCommits:\n$(COMMITS)" model=qwen maxTokens=30 -> PROPOSED_TAG
+    $ llm prompt="Propose the next semver tag given prev tag '${PREV_TAG}', bump kind '${BUMP_KIND}', and commits below. Return ONLY the new tag string (e.g. v1.4.3). No commentary.\n\nCommits:\n${COMMITS}" model=qwen maxTokens=30 -> PROPOSED_TAG
 
 confirm:
     needs: propose
-    ! Previous tag: $(PREV_TAG)
-    ! Commits since:
-    ! $(COMMITS)
-    ! Proposed new tag: $(PROPOSED_TAG|trim)
-    ?? "Cut tag $(PROPOSED_TAG|trim)?" -> APPROVED
+    emit(text="Previous tag: ${PREV_TAG}")
+    emit(text="Commits since:")
+    emit(text="${COMMITS}")
+    emit(text="Proposed new tag: ${PROPOSED_TAG|trim}")
+    ask(prompt="Cut tag ${PROPOSED_TAG|trim}?") -> APPROVED
 
 apply:
     needs: confirm
-    @ git tag $(PROPOSED_TAG|trim) -> TAG_OUT
-    @ git push origin $(PROPOSED_TAG|trim) -> PUSH_OUT
-    ! Tagged and pushed $(PROPOSED_TAG|trim)
+    shell(command="git tag ${PROPOSED_TAG|trim}") -> TAG_OUT
+    shell(command="git push origin ${PROPOSED_TAG|trim}") -> PUSH_OUT
+    emit(text="Tagged and pushed ${PROPOSED_TAG|trim}")
 else:
-    ! Tag/push failed; rolling back local tag
-    @ git tag -d $(PROPOSED_TAG|trim) -> ROLLBACK
+    emit(text="Tag/push failed; rolling back local tag")
+    shell(command="git tag -d ${PROPOSED_TAG|trim}") -> ROLLBACK
 
 default: apply

package/examples/doc-qa-with-citations.skill.md

@@ -5,8 +5,8 @@
 # Output: text
 
 answer:
-    > mode=rerank query="$(QUESTION)" limit=$(K) -> HITS (fallback: [])
-    ~ prompt="Answer the question using ONLY the supplied passages. Cite each claim inline as [id:<memory-id>]. Question: $(QUESTION). Passages: $(HITS|json)" maxTokens=900 -> RESPONSE
-    ! $(RESPONSE)
+    $ memory mode=rerank query="${QUESTION}" limit=${K} -> HITS (fallback: [])
+    $ llm prompt="Answer the question using ONLY the supplied passages. Cite each claim inline as [id:<memory-id>]. Question: ${QUESTION}. Passages: ${HITS|json}" maxTokens=900 -> RESPONSE
+    emit(text="${RESPONSE}")
 
 default: answer

package/examples/feedback-sentiment-scan.skill.md

@@ -7,23 +7,23 @@
 # Output: prompt-context: support-lead
 
 fetch_new:
-    > mode=fts query="customer feedback" limit=$(SCAN_LIMIT) created_after=$(EVENT.fired_at_unix) -> FEEDBACK
+    $ memory mode=fts query="customer feedback" limit=${SCAN_LIMIT} created_after=${EVENT.fired_at_unix} -> FEEDBACK
 
 fetch_seen:
-    > mode=fts query="sentiment-scan seen marker" limit=200 domain_tags=["sentiment-scan-seen"] -> SEEN_MARKERS
+    $ memory mode=fts query="sentiment-scan seen marker" limit=200 domain_tags=["sentiment-scan-seen"] -> SEEN_MARKERS
 
 classify_and_emit:
     needs: fetch_new, fetch_seen
-    ! Sentiment scan results for $(NOW):
-    foreach F in $(FEEDBACK):
-        if $(F.id|trim) in $(SEEN_MARKERS):
-            ! - skipped (already classified): $(F.id|trim)
-        elif $(F.id|trim) not in $(SEEN_MARKERS):
-            ~ prompt="Classify the sentiment of this customer feedback. Respond with ONE word: 'frustrated', 'blocking', 'satisfied', 'neutral'. No explanation.\n\nFeedback: $(F.summary)\nDetail: $(F.detail)" model=gemma2 maxTokens=10 -> VERDICT
-            if $(VERDICT|trim) == "frustrated":
-                ! - FRUSTRATED [$(F.id|trim)] $(F.summary)
-            elif $(VERDICT|trim) == "blocking":
-                ! - BLOCKING [$(F.id|trim)] $(F.summary)
-            $ memorystore.write summary="sentiment-scan seen $(F.id|trim)" detail="verdict=$(VERDICT|trim) on $(EVENT.fired_at_unix)" knowledge_type=common vault=private domain_tags=["sentiment-scan-seen"] expires_at=$(EVENT.fired_at_plus_7d_unix)
+    emit(text="Sentiment scan results for ${NOW}:")
+    foreach F in ${FEEDBACK}:
+        if ${F.id|trim} in ${SEEN_MARKERS}:
+            emit(text="- skipped (already classified): ${F.id|trim}")
+        elif ${F.id|trim} not in ${SEEN_MARKERS}:
+            $ llm prompt="Classify the sentiment of this customer feedback. Respond with ONE word: 'frustrated', 'blocking', 'satisfied', 'neutral'. No explanation.\n\nFeedback: ${F.summary}\nDetail: ${F.detail}" model=gemma2 maxTokens=10 -> VERDICT
+            if ${VERDICT|trim} == "frustrated":
+                emit(text="- FRUSTRATED [${F.id|trim}] ${F.summary}")
+            elif ${VERDICT|trim} == "blocking":
+                emit(text="- BLOCKING [${F.id|trim}] ${F.summary}")
+            $ memorystore.write summary="sentiment-scan seen ${F.id|trim}" detail="verdict=${VERDICT|trim} on ${EVENT.fired_at_unix}" knowledge_type=common vault=private domain_tags=["sentiment-scan-seen"] expires_at=${EVENT.fired_at_plus_7d_unix}
 
 default: classify_and_emit

package/examples/hello.skill.md

@@ -3,7 +3,7 @@
 # Vars: WHO=world
 
 greet:
-    ! Hello, $(WHO)!
-    ! Welcome to Skillscript. You ran a skill end-to-end with three commands.
+    emit(text="Hello, ${WHO}!")
+    emit(text="Welcome to Skillscript. You ran a skill end-to-end with three commands.")
 
 default: greet

package/examples/hello.skill.provenance.json

@@ -2,7 +2,7 @@
   "provenance_version": "1.0",
   "language_version": "1.0",
   "compiler_version": "0.1.0-dev",
-  "compiled_at": "2026-05-24T22:16:05.624Z",
+  "compiled_at": "2026-05-25T17:20:14.209Z",
   "source_skill": {
     "name": "hello"
   },

package/examples/morning-brief.skill.md

@@ -5,20 +5,20 @@
 # Requires: user-var:morning-brief-channel -> CHANNEL (fallback: dev-null)
 # Triggers: cron: 0 7 * * *
 # OnError: morning-brief-degraded
-# Output: slack: $(CHANNEL)
+# Output: slack: ${CHANNEL}
 # Output: prompt-context: perry
 
 calendar:
-    $ calendar.list_events horizon_hours=$(BRIEF_HORIZON_HOURS) -> EVENTS
+    $ calendar.list_events horizon_hours=${BRIEF_HORIZON_HOURS} -> EVENTS
 
 mailbox:
-    > mode=fts query="addressed:$(AGENT) created_after:$(EVENT.fired_at_unix)" limit=10 -> MAIL
+    $ memory mode=fts query="addressed:${AGENT} created_after:${EVENT.fired_at_unix}" limit=10 -> MAIL
 
 overnight:
-    > mode=rerank query="overnight writes since:$(EVENT.fired_at_plus_1d_unix)" limit=15 -> NOTES
+    $ memory mode=rerank query="overnight writes since:${EVENT.fired_at_plus_1d_unix}" limit=15 -> NOTES
 
 compose: needs: calendar, mailbox, overnight
-    ~ prompt="Compose a concise morning brief. Calendar: $(EVENTS|json). Mailbox: $(MAIL|json). Overnight notes: $(NOTES|json). Three sections, six bullets max each." model=qwen maxTokens=1200 -> BRIEF
-    ! $(BRIEF)
+    $ llm prompt="Compose a concise morning brief. Calendar: ${EVENTS|json}. Mailbox: ${MAIL|json}. Overnight notes: ${NOTES|json}. Three sections, six bullets max each." model=qwen maxTokens=1200 -> BRIEF
+    emit(text="${BRIEF}")
 
 default: compose

package/examples/queue-length-monitor.skill.md

@@ -10,13 +10,13 @@
 # needed for the count — the filter is deterministic + free.
 
 fetch:
-    @ cat $(QUEUE_PATH) -> ITEMS (fallback: "[]")
+    shell(command="cat ${QUEUE_PATH}") -> ITEMS (fallback: "[]")
 
 evaluate:
     needs: fetch
-    if $(ITEMS|length) > $(THRESHOLD):
-        ! Queue backlog: $(ITEMS|length) items pending (threshold $(THRESHOLD)). Action required.
+    if ${ITEMS|length} > ${THRESHOLD}:
+        emit(text="Queue backlog: ${ITEMS|length} items pending (threshold ${THRESHOLD}). Action required.")
     else:
-        ! Queue healthy: $(ITEMS|length) items pending (under $(THRESHOLD)).
+        emit(text="Queue healthy: ${ITEMS|length} items pending (under ${THRESHOLD}).")
 
 default: evaluate

package/examples/service-health-watch.skill.md

@@ -6,13 +6,13 @@
 # Output: none
 
 probe:
-    foreach SVC in $(SERVICES):
-        @ curl -s -o /dev/null -w "%{http_code} %{time_total}" https://status.internal/$(SVC|url) -> RAW
-        ~ prompt="From the line '$(RAW|trim)' (http_code time_seconds), and budget $(LATENCY_BUDGET_MS) ms, answer ok or degraded only." -> STATUS
-        if $(STATUS|trim) == "degraded":
-            $ memorystore.write summary="service degradation: $(SVC)" detail="probe at $(NOW): $(RAW|trim)" domain_tags=[ops, service-health, degraded:$(SVC)] vault=private knowledge_type=common expires_at=$(EVENT.fired_at_plus_1d_unix) -> ACK
-            ! $(SVC) degraded — wrote signal
+    foreach SVC in ${SERVICES}:
+        shell(command="curl -s -o /dev/null -w \"%{http_code} %{time_total}\" https://status.internal/${SVC|url}") -> RAW
+        $ llm prompt="From the line '${RAW|trim}' (http_code time_seconds), and budget ${LATENCY_BUDGET_MS} ms, answer ok or degraded only." -> STATUS
+        if ${STATUS|trim} == "degraded":
+            $ memorystore.write summary="service degradation: ${SVC}" detail="probe at ${NOW}: ${RAW|trim}" domain_tags=[ops, service-health, degraded:${SVC}] vault=private knowledge_type=common expires_at=${EVENT.fired_at_plus_1d_unix} -> ACK
+            emit(text="${SVC} degraded — wrote signal")
         else:
-            ! $(SVC) ok
+            emit(text="${SVC} ok")
 
 default: probe

package/examples/youtrack-morning-sweep.skill.md

@@ -9,9 +9,9 @@ fetch_issues: fetch_me
     $ youtrack.search_issues query="for: me" limit=5 -> RAW
 
 report: fetch_issues
-    ! Morning sweep for $(ME.login):
-    ! Open issues assigned: $(RAW.issuesPage|length)
-    foreach I in $(RAW.issuesPage):
-        ! - $(I.id): $(I.summary)
+    emit(text="Morning sweep for ${ME.login}:")
+    emit(text="Open issues assigned: ${RAW.issuesPage|length}")
+    foreach I in ${RAW.issuesPage}:
+        emit(text="- ${I.id}: ${I.summary}")
 
 default: report

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skillscript-runtime",
-  "version": "0.4.4",
+  "version": "0.7.0",
   "description": "Runtime, compiler, lint, CLI, and dashboard for Skillscript — a small declarative language for authoring agent workflows.",
   "license": "MIT",
   "author": "Scott Shwarts <scotts@pobox.com>",